From f6f3dab6724d72a60ebf0244843a82418f7d7740 Mon Sep 17 00:00:00 2001
From: Andrew Murray <radarhere@users.noreply.github.com>
Date: Wed, 27 Dec 2023 17:42:17 +1100
Subject: [PATCH 0001/1178] Import UnidentifiedImageError directly

---
 Tests/oss-fuzz/test_fuzzers.py | 4 ++--
 Tests/test_file_eps.py         | 4 ++--
 Tests/test_file_psd.py         | 6 +++---
 3 files changed, 7 insertions(+), 7 deletions(-)

diff --git a/Tests/oss-fuzz/test_fuzzers.py b/Tests/oss-fuzz/test_fuzzers.py
index 68834045a52..186a0efd3fe 100644
--- a/Tests/oss-fuzz/test_fuzzers.py
+++ b/Tests/oss-fuzz/test_fuzzers.py
@@ -6,7 +6,7 @@
 import packaging
 import pytest
 
-from PIL import Image, features
+from PIL import Image, UnidentifiedImageError, features
 from Tests.helper import skip_unless_feature
 
 if sys.platform.startswith("win32"):
@@ -42,7 +42,7 @@ def test_fuzz_images(path):
     except (
         Image.DecompressionBombError,
         Image.DecompressionBombWarning,
-        Image.UnidentifiedImageError,
+        UnidentifiedImageError,
     ):
         # Known Image.* exceptions
         assert True
diff --git a/Tests/test_file_eps.py b/Tests/test_file_eps.py
index c479c384a76..360ae11b515 100644
--- a/Tests/test_file_eps.py
+++ b/Tests/test_file_eps.py
@@ -3,7 +3,7 @@
 
 import pytest
 
-from PIL import EpsImagePlugin, Image, features
+from PIL import EpsImagePlugin, Image, UnidentifiedImageError, features
 
 from .helper import (
     assert_image_similar,
@@ -417,7 +417,7 @@ def test_emptyline():
 )
 def test_timeout(test_file):
     with open(test_file, "rb") as f:
-        with pytest.raises(Image.UnidentifiedImageError):
+        with pytest.raises(UnidentifiedImageError):
             with Image.open(f):
                 pass
 
diff --git a/Tests/test_file_psd.py b/Tests/test_file_psd.py
index 8b06ce2b163..d98f2335648 100644
--- a/Tests/test_file_psd.py
+++ b/Tests/test_file_psd.py
@@ -3,7 +3,7 @@
 
 import pytest
 
-from PIL import Image, PsdImagePlugin
+from PIL import Image, PsdImagePlugin, UnidentifiedImageError
 
 from .helper import assert_image_equal_tofile, assert_image_similar, hopper, is_pypy
 
@@ -146,11 +146,11 @@ def test_combined_larger_than_size():
     [
         (
             "Tests/images/timeout-1ee28a249896e05b83840ae8140622de8e648ba9.psd",
-            Image.UnidentifiedImageError,
+            UnidentifiedImageError,
         ),
         (
             "Tests/images/timeout-598843abc37fc080ec36a2699ebbd44f795d3a6f.psd",
-            Image.UnidentifiedImageError,
+            UnidentifiedImageError,
         ),
         ("Tests/images/timeout-c8efc3fded6426986ba867a399791bae544f59bc.psd", OSError),
         ("Tests/images/timeout-dedc7a4ebd856d79b4359bbcc79e8ef231ce38f6.psd", OSError),

From 30015f6236ee3165e06b78ff7dced956e21e24d5 Mon Sep 17 00:00:00 2001
From: Nulano <nulano@nulano.eu>
Date: Wed, 27 Dec 2023 16:16:25 +0100
Subject: [PATCH 0002/1178] simplify decompression bomb check in
 FreeTypeFont.render

---
 src/PIL/ImageFont.py | 17 +++--------------
 src/_imagingft.c     | 14 ++++----------
 2 files changed, 7 insertions(+), 24 deletions(-)

diff --git a/src/PIL/ImageFont.py b/src/PIL/ImageFont.py
index 6db7cc4eccb..c8d834f91d4 100644
--- a/src/PIL/ImageFont.py
+++ b/src/PIL/ImageFont.py
@@ -582,22 +582,13 @@ def getmask2(
         _string_length_check(text)
         if start is None:
             start = (0, 0)
-        im = None
-        size = None
 
         def fill(width, height):
-            nonlocal im, size
-
             size = (width, height)
-            if Image.MAX_IMAGE_PIXELS is not None:
-                pixels = max(1, width) * max(1, height)
-                if pixels > 2 * Image.MAX_IMAGE_PIXELS:
-                    return
-
-            im = Image.core.fill("RGBA" if mode == "RGBA" else "L", size)
-            return im
+            Image._decompression_bomb_check(size)
+            return Image.core.fill("RGBA" if mode == "RGBA" else "L", size)
 
-        offset = self.font.render(
+        return self.font.render(
             text,
             fill,
             mode,
@@ -610,8 +601,6 @@ def fill(width, height):
             start[0],
             start[1],
         )
-        Image._decompression_bomb_check(size)
-        return im, offset
 
     def font_variant(
         self, font=None, size=None, index=None, encoding=None, layout_engine=None
diff --git a/src/_imagingft.c b/src/_imagingft.c
index 68c66ac2c60..6e24fcf95ed 100644
--- a/src/_imagingft.c
+++ b/src/_imagingft.c
@@ -880,7 +880,7 @@ font_render(FontObject *self, PyObject *args) {
     image = PyObject_CallFunction(fill, "ii", width, height);
     if (image == Py_None) {
         PyMem_Del(glyph_info);
-        return Py_BuildValue("ii", 0, 0);
+        return Py_BuildValue("N(ii)", image, 0, 0);
     } else if (image == NULL) {
         PyMem_Del(glyph_info);
         return NULL;
@@ -894,7 +894,7 @@ font_render(FontObject *self, PyObject *args) {
     y_offset -= stroke_width;
     if (count == 0 || width == 0 || height == 0) {
         PyMem_Del(glyph_info);
-        return Py_BuildValue("ii", x_offset, y_offset);
+        return Py_BuildValue("N(ii)", image, x_offset, y_offset);
     }
 
     if (stroke_width) {
@@ -1130,18 +1130,12 @@ font_render(FontObject *self, PyObject *args) {
     if (bitmap_converted_ready) {
         FT_Bitmap_Done(library, &bitmap_converted);
     }
-    Py_DECREF(image);
     FT_Stroker_Done(stroker);
     PyMem_Del(glyph_info);
-    return Py_BuildValue("ii", x_offset, y_offset);
+    return Py_BuildValue("N(ii)", image, x_offset, y_offset);
 
 glyph_error:
-    if (im->destroy) {
-        im->destroy(im);
-    }
-    if (im->image) {
-        free(im->image);
-    }
+    Py_DECREF(image);
     if (stroker != NULL) {
         FT_Done_Glyph(glyph);
     }

From 90991428fa4ca39076efa6329792f30b962d7d49 Mon Sep 17 00:00:00 2001
From: Nulano <nulano@nulano.eu>
Date: Mon, 1 Jan 2024 20:05:16 +0100
Subject: [PATCH 0003/1178] add LCMS2 flags to ImageCms

---
 Tests/test_imagecms.py | 10 +++++++
 src/PIL/ImageCms.py    | 63 ++++++++++++++++++++++++++++++++++--------
 2 files changed, 61 insertions(+), 12 deletions(-)

diff --git a/Tests/test_imagecms.py b/Tests/test_imagecms.py
index 0dde82bd748..fec482f4393 100644
--- a/Tests/test_imagecms.py
+++ b/Tests/test_imagecms.py
@@ -90,6 +90,16 @@ def test_sanity():
     hopper().point(t)
 
 
+def test_flags():
+    assert ImageCms.Flags.NONE == 0
+    assert ImageCms.Flags.GRIDPOINTS(0) == ImageCms.Flags.NONE
+    assert ImageCms.Flags.GRIDPOINTS(256) == ImageCms.Flags.NONE
+
+    assert ImageCms.Flags.GRIDPOINTS(255) == (255 << 16)
+    assert ImageCms.Flags.GRIDPOINTS(-1) == ImageCms.Flags.GRIDPOINTS(255)
+    assert ImageCms.Flags.GRIDPOINTS(511) == ImageCms.Flags.GRIDPOINTS(255)
+
+
 def test_name():
     skip_missing()
     # get profile information for file
diff --git a/src/PIL/ImageCms.py b/src/PIL/ImageCms.py
index 643fce830ba..eafafd58333 100644
--- a/src/PIL/ImageCms.py
+++ b/src/PIL/ImageCms.py
@@ -16,8 +16,10 @@
 # below for the original description.
 from __future__ import annotations
 
+import operator
 import sys
-from enum import IntEnum
+from enum import IntEnum, IntFlag
+from functools import reduce
 
 from . import Image
 
@@ -119,6 +121,48 @@ class Direction(IntEnum):
 #
 # flags
 
+
+class Flags(IntFlag):
+    # These are taken from lcms2.h (including comments)
+    NONE = 0
+    NOCACHE = 0x0040  # Inhibit 1-pixel cache
+    NOOPTIMIZE = 0x0100  # Inhibit optimizations
+    NULLTRANSFORM = 0x0200  # Don't transform anyway
+    GAMUTCHECK = 0x1000  # Out of Gamut alarm
+    SOFTPROOFING = 0x4000  # Do softproofing
+    BLACKPOINTCOMPENSATION = 0x2000
+    NOWHITEONWHITEFIXUP = 0x0004  # Don't fix scum dot
+    HIGHRESPRECALC = 0x0400  # Use more memory to give better accuracy
+    LOWRESPRECALC = 0x0800  # Use less memory to minimize resources
+    # this should be 8BITS_DEVICELINK, but that is not a valid name in Python:
+    USE_8BITS_DEVICELINK = 0x0008  # Create 8 bits devicelinks
+    GUESSDEVICECLASS = 0x0020  # Guess device class (for transform2devicelink)
+    KEEP_SEQUENCE = 0x0080  # Keep profile sequence for devicelink creation
+    FORCE_CLUT = 0x0002  # Force CLUT optimization
+    CLUT_POST_LINEARIZATION = 0x0001  # create postlinearization tables if possible
+    CLUT_PRE_LINEARIZATION = 0x0010  # create prelinearization tables if possible
+    NONEGATIVES = 0x8000  # Prevent negative numbers in floating point transforms
+    COPY_ALPHA = 0x04000000  # Alpha channels are copied on cmsDoTransform()
+    NODEFAULTRESOURCEDEF = 0x01000000
+
+    _GRIDPOINTS_1 = 1 << 16
+    _GRIDPOINTS_2 = 2 << 16
+    _GRIDPOINTS_4 = 4 << 16
+    _GRIDPOINTS_8 = 8 << 16
+    _GRIDPOINTS_16 = 16 << 16
+    _GRIDPOINTS_32 = 32 << 16
+    _GRIDPOINTS_64 = 64 << 16
+    _GRIDPOINTS_128 = 128 << 16
+
+    @staticmethod
+    def GRIDPOINTS(n: int) -> Flags:
+        # Fine-tune control over number of gridpoints
+        return Flags.NONE | ((n & 0xFF) << 16)
+
+
+_MAX_FLAG = reduce(operator.or_, Flags)
+
+
 FLAGS = {
     "MATRIXINPUT": 1,
     "MATRIXOUTPUT": 2,
@@ -142,11 +186,6 @@ class Direction(IntEnum):
     "GRIDPOINTS": lambda n: (n & 0xFF) << 16,  # Gridpoints
 }
 
-_MAX_FLAG = 0
-for flag in FLAGS.values():
-    if isinstance(flag, int):
-        _MAX_FLAG = _MAX_FLAG | flag
-
 
 # --------------------------------------------------------------------.
 # Experimental PIL-level API
@@ -218,7 +257,7 @@ def __init__(
         intent=Intent.PERCEPTUAL,
         proof=None,
         proof_intent=Intent.ABSOLUTE_COLORIMETRIC,
-        flags=0,
+        flags=Flags.NONE,
     ):
         if proof is None:
             self.transform = core.buildTransform(
@@ -303,7 +342,7 @@ def profileToProfile(
     renderingIntent=Intent.PERCEPTUAL,
     outputMode=None,
     inPlace=False,
-    flags=0,
+    flags=Flags.NONE,
 ):
     """
     (pyCMS) Applies an ICC transformation to a given image, mapping from
@@ -420,7 +459,7 @@ def buildTransform(
     inMode,
     outMode,
     renderingIntent=Intent.PERCEPTUAL,
-    flags=0,
+    flags=Flags.NONE,
 ):
     """
     (pyCMS) Builds an ICC transform mapping from the ``inputProfile`` to the
@@ -482,7 +521,7 @@ def buildTransform(
         raise PyCMSError(msg)
 
     if not isinstance(flags, int) or not (0 <= flags <= _MAX_FLAG):
-        msg = "flags must be an integer between 0 and %s" + _MAX_FLAG
+        msg = f"flags must be an integer between 0 and {_MAX_FLAG}"
         raise PyCMSError(msg)
 
     try:
@@ -505,7 +544,7 @@ def buildProofTransform(
     outMode,
     renderingIntent=Intent.PERCEPTUAL,
     proofRenderingIntent=Intent.ABSOLUTE_COLORIMETRIC,
-    flags=FLAGS["SOFTPROOFING"],
+    flags=Flags.SOFTPROOFING,
 ):
     """
     (pyCMS) Builds an ICC transform mapping from the ``inputProfile`` to the
@@ -586,7 +625,7 @@ def buildProofTransform(
         raise PyCMSError(msg)
 
     if not isinstance(flags, int) or not (0 <= flags <= _MAX_FLAG):
-        msg = "flags must be an integer between 0 and %s" + _MAX_FLAG
+        msg = f"flags must be an integer between 0 and {_MAX_FLAG}"
         raise PyCMSError(msg)
 
     try:

From 26b2aa5165c62ee38664e291206f8ff28a30bb39 Mon Sep 17 00:00:00 2001
From: Nulano <nulano@nulano.eu>
Date: Mon, 1 Jan 2024 02:07:59 +0100
Subject: [PATCH 0004/1178] document
 ImageCms.{ImageCmsProfile,Intent,Direction}; fix ImageCms.core.CmsProfile
 references

(cherry picked from commit f2b1bbcf65b327c14646d4113302e3df59555110)
---
 docs/deprecations.rst       |  4 ++--
 docs/reference/ImageCms.rst | 21 ++++++++++++++++++++-
 docs/releasenotes/8.0.0.rst |  2 +-
 3 files changed, 23 insertions(+), 4 deletions(-)

diff --git a/docs/deprecations.rst b/docs/deprecations.rst
index a42dc555fea..0f9c75756ee 100644
--- a/docs/deprecations.rst
+++ b/docs/deprecations.rst
@@ -338,8 +338,8 @@ ImageCms.CmsProfile attributes
 .. deprecated:: 3.2.0
 .. versionremoved:: 8.0.0
 
-Some attributes in :py:class:`PIL.ImageCms.CmsProfile` have been removed. From 6.0.0,
-they issued a :py:exc:`DeprecationWarning`:
+Some attributes in :py:class:`PIL.ImageCms.core.CmsProfile` have been removed.
+From 6.0.0, they issued a :py:exc:`DeprecationWarning`:
 
 ========================  ===================================================
 Removed                   Use instead
diff --git a/docs/reference/ImageCms.rst b/docs/reference/ImageCms.rst
index 9b9b5e7b29e..9b6be40b106 100644
--- a/docs/reference/ImageCms.rst
+++ b/docs/reference/ImageCms.rst
@@ -8,9 +8,26 @@ The :py:mod:`~PIL.ImageCms` module provides color profile management
 support using the LittleCMS2 color management engine, based on Kevin
 Cazabon's PyCMS library.
 
+.. autoclass:: ImageCmsProfile
+    :members:
+    :special-members: __init__
 .. autoclass:: ImageCmsTransform
+    :members:
+    :undoc-members:
 .. autoexception:: PyCMSError
 
+Constants
+---------
+
+.. autoclass:: Intent
+    :members:
+    :member-order: bysource
+    :undoc-members:
+.. autoclass:: Direction
+    :members:
+    :member-order: bysource
+    :undoc-members:
+
 Functions
 ---------
 
@@ -37,13 +54,15 @@ CmsProfile
 ----------
 
 The ICC color profiles are wrapped in an instance of the class
-:py:class:`CmsProfile`.  The specification ICC.1:2010 contains more
+:py:class:`~core.CmsProfile`.  The specification ICC.1:2010 contains more
 information about the meaning of the values in ICC profiles.
 
 For convenience, all XYZ-values are also given as xyY-values (so they
 can be easily displayed in a chromaticity diagram, for example).
 
+.. py:currentmodule:: PIL.ImageCms.core
 .. py:class:: CmsProfile
+    :canonical: PIL._imagingcms.CmsProfile
 
     .. py:attribute:: creation_date
         :type: Optional[datetime.datetime]
diff --git a/docs/releasenotes/8.0.0.rst b/docs/releasenotes/8.0.0.rst
index 2bf299dd3d8..1fc245c9a3c 100644
--- a/docs/releasenotes/8.0.0.rst
+++ b/docs/releasenotes/8.0.0.rst
@@ -30,7 +30,7 @@ Image.fromstring, im.fromstring and im.tostring
 ImageCms.CmsProfile attributes
 ^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
 
-Some attributes in :py:class:`PIL.ImageCms.CmsProfile` have been removed:
+Some attributes in :py:class:`PIL.ImageCms.core.CmsProfile` have been removed:
 
 ========================  ===================================================
 Removed                   Use instead

From 0b2e2b224fe430c74995664c0d8eec9df789727e Mon Sep 17 00:00:00 2001
From: Nulano <nulano@nulano.eu>
Date: Mon, 1 Jan 2024 21:38:29 +0100
Subject: [PATCH 0005/1178] document ImageCms.Flags

---
 docs/reference/ImageCms.rst |  4 +++
 src/PIL/ImageCms.py         | 57 +++++++++++++++++++++++++------------
 2 files changed, 43 insertions(+), 18 deletions(-)

diff --git a/docs/reference/ImageCms.rst b/docs/reference/ImageCms.rst
index 9b6be40b106..4ef5ac77456 100644
--- a/docs/reference/ImageCms.rst
+++ b/docs/reference/ImageCms.rst
@@ -27,6 +27,10 @@ Constants
     :members:
     :member-order: bysource
     :undoc-members:
+.. autoclass:: Flags
+    :members:
+    :member-order: bysource
+    :undoc-members:
 
 Functions
 ---------
diff --git a/src/PIL/ImageCms.py b/src/PIL/ImageCms.py
index eafafd58333..9a7afe81f2b 100644
--- a/src/PIL/ImageCms.py
+++ b/src/PIL/ImageCms.py
@@ -123,26 +123,43 @@ class Direction(IntEnum):
 
 
 class Flags(IntFlag):
-    # These are taken from lcms2.h (including comments)
+    """Flags and documentation are taken from ``lcms2.h``."""
+
     NONE = 0
-    NOCACHE = 0x0040  # Inhibit 1-pixel cache
-    NOOPTIMIZE = 0x0100  # Inhibit optimizations
-    NULLTRANSFORM = 0x0200  # Don't transform anyway
-    GAMUTCHECK = 0x1000  # Out of Gamut alarm
-    SOFTPROOFING = 0x4000  # Do softproofing
+    NOCACHE = 0x0040
+    """Inhibit 1-pixel cache"""
+    NOOPTIMIZE = 0x0100
+    """Inhibit optimizations"""
+    NULLTRANSFORM = 0x0200
+    """Don't transform anyway"""
+    GAMUTCHECK = 0x1000
+    """Out of Gamut alarm"""
+    SOFTPROOFING = 0x4000
+    """Do softproofing"""
     BLACKPOINTCOMPENSATION = 0x2000
-    NOWHITEONWHITEFIXUP = 0x0004  # Don't fix scum dot
-    HIGHRESPRECALC = 0x0400  # Use more memory to give better accuracy
-    LOWRESPRECALC = 0x0800  # Use less memory to minimize resources
+    NOWHITEONWHITEFIXUP = 0x0004
+    """Don't fix scum dot"""
+    HIGHRESPRECALC = 0x0400
+    """Use more memory to give better accuracy"""
+    LOWRESPRECALC = 0x0800
+    """Use less memory to minimize resources"""
     # this should be 8BITS_DEVICELINK, but that is not a valid name in Python:
-    USE_8BITS_DEVICELINK = 0x0008  # Create 8 bits devicelinks
-    GUESSDEVICECLASS = 0x0020  # Guess device class (for transform2devicelink)
-    KEEP_SEQUENCE = 0x0080  # Keep profile sequence for devicelink creation
-    FORCE_CLUT = 0x0002  # Force CLUT optimization
-    CLUT_POST_LINEARIZATION = 0x0001  # create postlinearization tables if possible
-    CLUT_PRE_LINEARIZATION = 0x0010  # create prelinearization tables if possible
-    NONEGATIVES = 0x8000  # Prevent negative numbers in floating point transforms
-    COPY_ALPHA = 0x04000000  # Alpha channels are copied on cmsDoTransform()
+    USE_8BITS_DEVICELINK = 0x0008
+    """Create 8 bits devicelinks"""
+    GUESSDEVICECLASS = 0x0020
+    """Guess device class (for transform2devicelink)"""
+    KEEP_SEQUENCE = 0x0080
+    """Keep profile sequence for devicelink creation"""
+    FORCE_CLUT = 0x0002
+    """Force CLUT optimization"""
+    CLUT_POST_LINEARIZATION = 0x0001
+    """create postlinearization tables if possible"""
+    CLUT_PRE_LINEARIZATION = 0x0010
+    """create prelinearization tables if possible"""
+    NONEGATIVES = 0x8000
+    """Prevent negative numbers in floating point transforms"""
+    COPY_ALPHA = 0x04000000
+    """Alpha channels are copied on cmsDoTransform()"""
     NODEFAULTRESOURCEDEF = 0x01000000
 
     _GRIDPOINTS_1 = 1 << 16
@@ -156,7 +173,11 @@ class Flags(IntFlag):
 
     @staticmethod
     def GRIDPOINTS(n: int) -> Flags:
-        # Fine-tune control over number of gridpoints
+        """
+        Fine-tune control over number of gridpoints
+
+        :param n: :py:class:`int` in range ``0 <= n <= 255``
+        """
         return Flags.NONE | ((n & 0xFF) << 16)
 
 

From fd148246499bfd5c7d55f871e3f1f6e608a9bc3f Mon Sep 17 00:00:00 2001
From: Andrew Murray <radarhere@users.noreply.github.com>
Date: Tue, 2 Jan 2024 19:15:13 +1100
Subject: [PATCH 0006/1178] bbox on macOS is not 2x on retina screens

---
 docs/reference/ImageGrab.rst | 5 ++++-
 1 file changed, 4 insertions(+), 1 deletion(-)

diff --git a/docs/reference/ImageGrab.rst b/docs/reference/ImageGrab.rst
index 0b94032d5f8..5c365132f5e 100644
--- a/docs/reference/ImageGrab.rst
+++ b/docs/reference/ImageGrab.rst
@@ -22,7 +22,10 @@ or the clipboard to a PIL image memory.
     .. versionadded:: 1.1.3 (Windows), 3.0.0 (macOS), 7.1.0 (Linux)
 
     :param bbox: What region to copy. Default is the entire screen.
-                 Note that on Windows OS, the top-left point may be negative if ``all_screens=True`` is used.
+                 On macOS, this is not increased to 2x for retina screens, so the full
+                 width of a retina screen would be 1440, not 2880.
+                 On Windows OS, the top-left point may be negative if
+                 ``all_screens=True`` is used.
     :param include_layered_windows: Includes layered windows. Windows OS only.
 
         .. versionadded:: 6.1.0

From dacd92853094414ab6a4326e7f5805666b92996c Mon Sep 17 00:00:00 2001
From: Andrew Murray <radarhere@users.noreply.github.com>
Date: Tue, 2 Jan 2024 20:37:59 +1100
Subject: [PATCH 0007/1178] 10.3.0.dev0 version bump

---
 src/PIL/_version.py | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/src/PIL/_version.py b/src/PIL/_version.py
index 1018b96b525..0568943b52b 100644
--- a/src/PIL/_version.py
+++ b/src/PIL/_version.py
@@ -1,4 +1,4 @@
 # Master version for Pillow
 from __future__ import annotations
 
-__version__ = "10.2.0"
+__version__ = "10.3.0.dev0"

From ec6a57f69d45c0444d7e38df57af6761524463fa Mon Sep 17 00:00:00 2001
From: Andrew Murray <radarhere@users.noreply.github.com>
Date: Tue, 2 Jan 2024 21:27:12 +1100
Subject: [PATCH 0008/1178] Updated description

Co-authored-by: Hugo van Kemenade <hugovk@users.noreply.github.com>
---
 docs/reference/ImageGrab.rst | 8 ++++----
 1 file changed, 4 insertions(+), 4 deletions(-)

diff --git a/docs/reference/ImageGrab.rst b/docs/reference/ImageGrab.rst
index 5c365132f5e..e0e8d5a2f1b 100644
--- a/docs/reference/ImageGrab.rst
+++ b/docs/reference/ImageGrab.rst
@@ -22,10 +22,10 @@ or the clipboard to a PIL image memory.
     .. versionadded:: 1.1.3 (Windows), 3.0.0 (macOS), 7.1.0 (Linux)
 
     :param bbox: What region to copy. Default is the entire screen.
-                 On macOS, this is not increased to 2x for retina screens, so the full
-                 width of a retina screen would be 1440, not 2880.
-                 On Windows OS, the top-left point may be negative if
-                 ``all_screens=True`` is used.
+                 On macOS, this is not increased to 2x for Retina screens, so the full
+                 width of a Retina screen would be 1440, not 2880.
+                 On Windows, the top-left point may be negative if ``all_screens=True``
+                 is used.
     :param include_layered_windows: Includes layered windows. Windows OS only.
 
         .. versionadded:: 6.1.0

From 75015e9859183e426012aa59309473c479b59a59 Mon Sep 17 00:00:00 2001
From: Andrew Murray <radarhere@users.noreply.github.com>
Date: Tue, 2 Jan 2024 22:43:56 +1100
Subject: [PATCH 0009/1178] Skip PyPy3.8 Windows wheel

---
 .github/workflows/wheels.yml | 1 +
 1 file changed, 1 insertion(+)

diff --git a/.github/workflows/wheels.yml b/.github/workflows/wheels.yml
index 060fc497ea7..5adff7ec1c4 100644
--- a/.github/workflows/wheels.yml
+++ b/.github/workflows/wheels.yml
@@ -143,6 +143,7 @@ jobs:
           CIBW_ARCHS: ${{ matrix.cibw_arch }}
           CIBW_BEFORE_ALL: "{package}\\winbuild\\build\\build_dep_all.cmd"
           CIBW_CACHE_PATH: "C:\\cibw"
+          CIBW_SKIP: pp38-*
           CIBW_TEST_SKIP: "*-win_arm64"
           CIBW_TEST_COMMAND: 'docker run --rm
             -v {project}:C:\pillow

From 5ddcf4d11493524627dbf4b65ad0ed76b7625168 Mon Sep 17 00:00:00 2001
From: Andrew Murray <radarhere@users.noreply.github.com>
Date: Tue, 2 Jan 2024 20:33:48 +1100
Subject: [PATCH 0010/1178] Package name is now lowercase in wheel filenames

---
 RELEASING.md | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/RELEASING.md b/RELEASING.md
index b3fd72a520e..97f4f8dcd18 100644
--- a/RELEASING.md
+++ b/RELEASING.md
@@ -87,7 +87,7 @@ Released as needed privately to individual vendors for critical security-related
   and copy into `dist`. Check and upload them e.g.:
   ```bash
   python3 -m twine check --strict dist/*
-  python3 -m twine upload dist/Pillow-5.2.0*
+  python3 -m twine upload dist/pillow-5.2.0*
   ```
 
 ## Publicize Release

From 81ea98e4941af0940b4725a7cc187c689a3726e4 Mon Sep 17 00:00:00 2001
From: =?UTF-8?q?Ondrej=20Baranovi=C4=8D?= <nulano@nulano.eu>
Date: Tue, 2 Jan 2024 14:10:07 +0100
Subject: [PATCH 0011/1178] document ImageCmsTransform's base class

Co-authored-by: Andrew Murray <3112309+radarhere@users.noreply.github.com>
---
 docs/reference/ImageCms.rst | 1 +
 1 file changed, 1 insertion(+)

diff --git a/docs/reference/ImageCms.rst b/docs/reference/ImageCms.rst
index 4ef5ac77456..22ed516ce58 100644
--- a/docs/reference/ImageCms.rst
+++ b/docs/reference/ImageCms.rst
@@ -14,6 +14,7 @@ Cazabon's PyCMS library.
 .. autoclass:: ImageCmsTransform
     :members:
     :undoc-members:
+    :show-inheritance:
 .. autoexception:: PyCMSError
 
 Constants

From fc7088a561554aec8b6a4cf6517fdcc11554cb6b Mon Sep 17 00:00:00 2001
From: Nulano <nulano@nulano.eu>
Date: Tue, 2 Jan 2024 14:52:12 +0100
Subject: [PATCH 0012/1178] improve ImageTransform documentation

---
 docs/PIL.rst                      |  8 -------
 docs/reference/ImageTransform.rst | 35 +++++++++++++++++++++++++++++++
 docs/reference/index.rst          |  1 +
 src/PIL/Image.py                  |  4 ++++
 src/PIL/ImageTransform.py         | 13 +++++++-----
 5 files changed, 48 insertions(+), 13 deletions(-)
 create mode 100644 docs/reference/ImageTransform.rst

diff --git a/docs/PIL.rst b/docs/PIL.rst
index b6944e234a5..bdbf1373d88 100644
--- a/docs/PIL.rst
+++ b/docs/PIL.rst
@@ -77,14 +77,6 @@ can be found here.
     :undoc-members:
     :show-inheritance:
 
-:mod:`~PIL.ImageTransform` Module
----------------------------------
-
-.. automodule:: PIL.ImageTransform
-    :members:
-    :undoc-members:
-    :show-inheritance:
-
 :mod:`~PIL.PaletteFile` Module
 ------------------------------
 
diff --git a/docs/reference/ImageTransform.rst b/docs/reference/ImageTransform.rst
new file mode 100644
index 00000000000..1278801821d
--- /dev/null
+++ b/docs/reference/ImageTransform.rst
@@ -0,0 +1,35 @@
+
+.. py:module:: PIL.ImageTransform
+.. py:currentmodule:: PIL.ImageTransform
+
+:py:mod:`~PIL.ImageTransform` Module
+====================================
+
+The :py:mod:`~PIL.ImageTransform` module contains implementations of
+:py:class:`~PIL.Image.ImageTransformHandler` for some of the builtin
+:py:class:`.Image.Transform` methods.
+
+.. autoclass:: Transform
+    :members:
+    :undoc-members:
+    :show-inheritance:
+
+.. autoclass:: AffineTransform
+    :members:
+    :undoc-members:
+    :show-inheritance:
+
+.. autoclass:: ExtentTransform
+    :members:
+    :undoc-members:
+    :show-inheritance:
+
+.. autoclass:: QuadTransform
+    :members:
+    :undoc-members:
+    :show-inheritance:
+
+.. autoclass:: MeshTransform
+    :members:
+    :undoc-members:
+    :show-inheritance:
diff --git a/docs/reference/index.rst b/docs/reference/index.rst
index 5d6affa94ad..82c75e373ad 100644
--- a/docs/reference/index.rst
+++ b/docs/reference/index.rst
@@ -25,6 +25,7 @@ Reference
    ImageShow
    ImageStat
    ImageTk
+   ImageTransform
    ImageWin
    ExifTags
    TiffTags
diff --git a/src/PIL/Image.py b/src/PIL/Image.py
index 1bba9aad2c1..c56da545803 100644
--- a/src/PIL/Image.py
+++ b/src/PIL/Image.py
@@ -2666,6 +2666,10 @@ class Example(Image.ImageTransformHandler):
                 def transform(self, size, data, resample, fill=1):
                     # Return result
 
+          Implementations of :py:class:`~PIL.Image.ImageTransformHandler`
+          for some of the :py:class:`Transform` methods are provided
+          in :py:mod:`~PIL.ImageTransform`.
+
           It may also be an object with a ``method.getdata`` method
           that returns a tuple supplying new ``method`` and ``data`` values::
 
diff --git a/src/PIL/ImageTransform.py b/src/PIL/ImageTransform.py
index 84c81f1844f..4f79500e64e 100644
--- a/src/PIL/ImageTransform.py
+++ b/src/PIL/ImageTransform.py
@@ -20,12 +20,14 @@
 
 
 class Transform(Image.ImageTransformHandler):
+    """Base class for other transforms defined in :py:mod:`~PIL.ImageTransform`."""
+
     method: Image.Transform
 
     def __init__(self, data: Sequence[int]) -> None:
         self.data = data
 
-    def getdata(self) -> tuple[int, Sequence[int]]:
+    def getdata(self) -> tuple[Image.Transform, Sequence[int]]:
         return self.method, self.data
 
     def transform(
@@ -34,6 +36,7 @@ def transform(
         image: Image.Image,
         **options: dict[str, str | int | tuple[int, ...] | list[int]],
     ) -> Image.Image:
+        """Perform the transform. Called from :py:meth:`.Image.transform`."""
         # can be overridden
         method, data = self.getdata()
         return image.transform(size, method, data, **options)
@@ -51,7 +54,7 @@ class AffineTransform(Transform):
     This function can be used to scale, translate, rotate, and shear the
     original image.
 
-    See :py:meth:`~PIL.Image.Image.transform`
+    See :py:meth:`.Image.transform`
 
     :param matrix: A 6-tuple (a, b, c, d, e, f) containing the first two rows
         from an affine transform matrix.
@@ -73,7 +76,7 @@ class ExtentTransform(Transform):
     rectangle in the current image. It is slightly slower than crop, but about
     as fast as a corresponding resize operation.
 
-    See :py:meth:`~PIL.Image.Image.transform`
+    See :py:meth:`.Image.transform`
 
     :param bbox: A 4-tuple (x0, y0, x1, y1) which specifies two points in the
         input image's coordinate system. See :ref:`coordinate-system`.
@@ -89,7 +92,7 @@ class QuadTransform(Transform):
     Maps a quadrilateral (a region defined by four corners) from the image to a
     rectangle of the given size.
 
-    See :py:meth:`~PIL.Image.Image.transform`
+    See :py:meth:`.Image.transform`
 
     :param xy: An 8-tuple (x0, y0, x1, y1, x2, y2, x3, y3) which contain the
         upper left, lower left, lower right, and upper right corner of the
@@ -104,7 +107,7 @@ class MeshTransform(Transform):
     Define a mesh image transform.  A mesh transform consists of one or more
     individual quad transforms.
 
-    See :py:meth:`~PIL.Image.Image.transform`
+    See :py:meth:`.Image.transform`
 
     :param data: A list of (bbox, quad) tuples.
     """

From 8070fe10f1ccc346539f87c88fb65ea55d001b9a Mon Sep 17 00:00:00 2001
From: Nulano <nulano@nulano.eu>
Date: Sat, 23 Dec 2023 14:41:50 +0100
Subject: [PATCH 0013/1178] pass build config before setuptools command; add
 build_editable to custom build backend

---
 .github/workflows/wheels.yml |  2 ++
 _custom_build/backend.py     | 57 +++++++++++++-----------------------
 pyproject.toml               |  2 +-
 setup.py                     | 34 ++++++++++++++++++---
 4 files changed, 54 insertions(+), 41 deletions(-)

diff --git a/.github/workflows/wheels.yml b/.github/workflows/wheels.yml
index 5adff7ec1c4..0c8a941de30 100644
--- a/.github/workflows/wheels.yml
+++ b/.github/workflows/wheels.yml
@@ -5,6 +5,7 @@ on:
     paths:
       - ".ci/requirements-cibw.txt"
       - ".github/workflows/wheel*"
+      - "setup.py"
       - "wheels/*"
       - "winbuild/build_prepare.py"
       - "winbuild/fribidi.cmake"
@@ -14,6 +15,7 @@ on:
     paths:
       - ".ci/requirements-cibw.txt"
       - ".github/workflows/wheel*"
+      - "setup.py"
       - "wheels/*"
       - "winbuild/build_prepare.py"
       - "winbuild/fribidi.cmake"
diff --git a/_custom_build/backend.py b/_custom_build/backend.py
index d1537b80987..0b183a5870b 100644
--- a/_custom_build/backend.py
+++ b/_custom_build/backend.py
@@ -11,41 +11,16 @@
 class _CustomBuildMetaBackend(backend_class):
     def run_setup(self, setup_script="setup.py"):
         if self.config_settings:
-
-            def config_has(key, value):
-                settings = self.config_settings.get(key)
-                if settings:
-                    if not isinstance(settings, list):
-                        settings = [settings]
-                    return value in settings
-
-            flags = []
-            for dependency in (
-                "zlib",
-                "jpeg",
-                "tiff",
-                "freetype",
-                "raqm",
-                "lcms",
-                "webp",
-                "webpmux",
-                "jpeg2000",
-                "imagequant",
-                "xcb",
-            ):
-                if config_has(dependency, "enable"):
-                    flags.append("--enable-" + dependency)
-                elif config_has(dependency, "disable"):
-                    flags.append("--disable-" + dependency)
-            for dependency in ("raqm", "fribidi"):
-                if config_has(dependency, "vendor"):
-                    flags.append("--vendor-" + dependency)
-            if self.config_settings.get("platform-guessing") == "disable":
-                flags.append("--disable-platform-guessing")
-            if self.config_settings.get("debug") == "true":
-                flags.append("--debug")
-            if flags:
-                sys.argv = sys.argv[:1] + ["build_ext"] + flags + sys.argv[1:]
+            params = []
+            for k, v in self.config_settings.items():
+                if isinstance(v, list):
+                    msg = "Conflicting options: " + ", ".join(
+                        f"'--config-setting {k}={v_}'" for v_ in v
+                    )
+                    raise ValueError(msg)
+                params.append(f"--pillow-configuration={k}={v}")
+
+            sys.argv = sys.argv[:1] + params + sys.argv[1:]
         return super().run_setup(setup_script)
 
     def build_wheel(
@@ -54,5 +29,15 @@ def build_wheel(
         self.config_settings = config_settings
         return super().build_wheel(wheel_directory, config_settings, metadata_directory)
 
+    def build_editable(
+        self, wheel_directory, config_settings=None, metadata_directory=None
+    ):
+        self.config_settings = config_settings
+        return super().build_editable(
+            wheel_directory, config_settings, metadata_directory
+        )
+
 
-build_wheel = _CustomBuildMetaBackend().build_wheel
+_backend = _CustomBuildMetaBackend()
+build_wheel = _backend.build_wheel
+build_editable = _backend.build_editable
diff --git a/pyproject.toml b/pyproject.toml
index da2537b2137..d63e401af1e 100644
--- a/pyproject.toml
+++ b/pyproject.toml
@@ -92,7 +92,7 @@ version = {attr = "PIL.__version__"}
 [tool.cibuildwheel]
 before-all = ".github/workflows/wheels-dependencies.sh"
 build-verbosity = 1
-config-settings = "raqm=enable raqm=vendor fribidi=vendor imagequant=disable"
+config-settings = "raqm=vendor fribidi=vendor imagequant=disable"
 test-command = "cd {project} && .github/workflows/wheels-test.sh"
 test-extras = "tests"
 
diff --git a/setup.py b/setup.py
index 1bf0bcff558..c74165fb73a 100755
--- a/setup.py
+++ b/setup.py
@@ -28,6 +28,9 @@ def get_version():
     return locals()["__version__"]
 
 
+configuration = {}
+
+
 PILLOW_VERSION = get_version()
 FREETYPE_ROOT = None
 HARFBUZZ_ROOT = None
@@ -334,15 +337,24 @@ def __iter__(self):
         + [("add-imaging-libs=", None, "Add libs to _imaging build")]
     )
 
+    @staticmethod
+    def check_configuration(option, value):
+        return True if configuration.get(option) == value else None
+
     def initialize_options(self):
-        self.disable_platform_guessing = None
+        self.disable_platform_guessing = self.check_configuration(
+            "platform-guessing", "disable"
+        )
         self.add_imaging_libs = ""
         build_ext.initialize_options(self)
         for x in self.feature:
-            setattr(self, f"disable_{x}", None)
-            setattr(self, f"enable_{x}", None)
+            setattr(self, f"disable_{x}", self.check_configuration(x, "disable"))
+            setattr(self, f"enable_{x}", self.check_configuration(x, "enable"))
         for x in ("raqm", "fribidi"):
-            setattr(self, f"vendor_{x}", None)
+            setattr(self, f"vendor_{x}", self.check_configuration(x, "vendor"))
+        if self.check_configuration("debug", "true"):
+            self.debug = True
+        self.parallel = configuration.get("parallel")
 
     def finalize_options(self):
         build_ext.finalize_options(self)
@@ -390,6 +402,9 @@ def finalize_options(self):
                     raise ValueError(msg)
                 _dbg("Using vendored version of %s", x)
                 self.feature.vendor.add(x)
+                if x == "raqm":
+                    _dbg("--vendor-raqm implies --enable-raqm")
+                    self.feature.required.add(x)
 
     def _update_extension(self, name, libraries, define_macros=None, sources=None):
         for extension in self.extensions:
@@ -985,6 +1000,17 @@ def debug_build():
     Extension("PIL._imagingmorph", ["src/_imagingmorph.c"]),
 ]
 
+
+# parse configuration from _custom_build/backend.py
+while len(sys.argv[1]) >= 2 and sys.argv[1].startswith("--pillow-configuration="):
+    _, key, value = sys.argv[1].split("=", 2)
+    old = configuration.get(key)
+    if old is not None:
+        msg = f"Conflicting options: '-C {key}={old}' and '-C {key}={value}'"
+        raise ValueError(msg)
+    configuration[key] = value
+    del sys.argv[1]
+
 try:
     setup(
         cmdclass={"build_ext": pil_build_ext},

From b4e690049d81dc2569d6f02c5b0c1b9eb29a07b2 Mon Sep 17 00:00:00 2001
From: Nulano <nulano@nulano.eu>
Date: Sun, 31 Dec 2023 02:22:05 +0100
Subject: [PATCH 0014/1178] document config setting "-C parallel=n" for number
 of CPUs to use for compilation

---
 docs/installation.rst | 14 +++++++-------
 1 file changed, 7 insertions(+), 7 deletions(-)

diff --git a/docs/installation.rst b/docs/installation.rst
index fbcfbb90724..03011619ff7 100644
--- a/docs/installation.rst
+++ b/docs/installation.rst
@@ -390,9 +390,10 @@ After navigating to the Pillow directory, run::
 Build Options
 """""""""""""
 
-* Environment variable: ``MAX_CONCURRENCY=n``. Pillow can use
-  multiprocessing to build the extension. Setting ``MAX_CONCURRENCY``
-  sets the number of CPUs to use, or can disable parallel building by
+* Config setting: ``-C parallel=n``. Can also be given
+  with environment variable: ``MAX_CONCURRENCY=n``. Pillow can use
+  multiprocessing to build the extension. Setting ``-C parallel=n``
+  sets the number of CPUs to use to ``n``, or can disable parallel building by
   using a setting of 1. By default, it uses 4 CPUs, or if 4 are not
   available, as many as are present.
 
@@ -417,14 +418,13 @@ Build Options
   used to compile the standard Pillow wheels. Compiling libraqm requires
   a C99-compliant compiler.
 
-* Build flag: ``-C platform-guessing=disable``. Skips all of the
+* Config setting: ``-C platform-guessing=disable``. Skips all of the
   platform dependent guessing of include and library directories for
   automated build systems that configure the proper paths in the
   environment variables (e.g. Buildroot).
 
-* Build flag: ``-C debug=true``. Adds a debugging flag to the include and
-  library search process to dump all paths searched for and found to
-  stdout.
+* Config setting: ``-C debug=true``. Adds a debugging flag to the include and
+  library search process to dump all paths searched for and found to stdout.
 
 
 Sample usage::

From f27b838a451d0b20befea03da7b2d58dd1da7821 Mon Sep 17 00:00:00 2001
From: Nulano <nulano@nulano.eu>
Date: Tue, 2 Jan 2024 15:47:47 +0100
Subject: [PATCH 0015/1178] support multiple --config-settings

---
 _custom_build/backend.py | 12 +++++-------
 pyproject.toml           |  2 +-
 setup.py                 | 13 +++----------
 3 files changed, 9 insertions(+), 18 deletions(-)

diff --git a/_custom_build/backend.py b/_custom_build/backend.py
index 0b183a5870b..2c670ff0ac3 100644
--- a/_custom_build/backend.py
+++ b/_custom_build/backend.py
@@ -12,13 +12,11 @@ class _CustomBuildMetaBackend(backend_class):
     def run_setup(self, setup_script="setup.py"):
         if self.config_settings:
             params = []
-            for k, v in self.config_settings.items():
-                if isinstance(v, list):
-                    msg = "Conflicting options: " + ", ".join(
-                        f"'--config-setting {k}={v_}'" for v_ in v
-                    )
-                    raise ValueError(msg)
-                params.append(f"--pillow-configuration={k}={v}")
+            for key, values in self.config_settings.items():
+                if not isinstance(values, list):
+                    values = [values]
+                for value in values:
+                    params.append(f"--pillow-configuration={key}={value}")
 
             sys.argv = sys.argv[:1] + params + sys.argv[1:]
         return super().run_setup(setup_script)
diff --git a/pyproject.toml b/pyproject.toml
index d63e401af1e..da2537b2137 100644
--- a/pyproject.toml
+++ b/pyproject.toml
@@ -92,7 +92,7 @@ version = {attr = "PIL.__version__"}
 [tool.cibuildwheel]
 before-all = ".github/workflows/wheels-dependencies.sh"
 build-verbosity = 1
-config-settings = "raqm=vendor fribidi=vendor imagequant=disable"
+config-settings = "raqm=enable raqm=vendor fribidi=vendor imagequant=disable"
 test-command = "cd {project} && .github/workflows/wheels-test.sh"
 test-extras = "tests"
 
diff --git a/setup.py b/setup.py
index c74165fb73a..686e8889fd9 100755
--- a/setup.py
+++ b/setup.py
@@ -339,7 +339,7 @@ def __iter__(self):
 
     @staticmethod
     def check_configuration(option, value):
-        return True if configuration.get(option) == value else None
+        return True if value in configuration.get(option, []) else None
 
     def initialize_options(self):
         self.disable_platform_guessing = self.check_configuration(
@@ -354,7 +354,7 @@ def initialize_options(self):
             setattr(self, f"vendor_{x}", self.check_configuration(x, "vendor"))
         if self.check_configuration("debug", "true"):
             self.debug = True
-        self.parallel = configuration.get("parallel")
+        self.parallel = configuration.get("parallel", [None])[-1]
 
     def finalize_options(self):
         build_ext.finalize_options(self)
@@ -402,9 +402,6 @@ def finalize_options(self):
                     raise ValueError(msg)
                 _dbg("Using vendored version of %s", x)
                 self.feature.vendor.add(x)
-                if x == "raqm":
-                    _dbg("--vendor-raqm implies --enable-raqm")
-                    self.feature.required.add(x)
 
     def _update_extension(self, name, libraries, define_macros=None, sources=None):
         for extension in self.extensions:
@@ -1004,11 +1001,7 @@ def debug_build():
 # parse configuration from _custom_build/backend.py
 while len(sys.argv[1]) >= 2 and sys.argv[1].startswith("--pillow-configuration="):
     _, key, value = sys.argv[1].split("=", 2)
-    old = configuration.get(key)
-    if old is not None:
-        msg = f"Conflicting options: '-C {key}={old}' and '-C {key}={value}'"
-        raise ValueError(msg)
-    configuration[key] = value
+    configuration.setdefault(key, []).append(value)
     del sys.argv[1]
 
 try:

From 01e5f06da055490f70b1294f39a2718297ee8067 Mon Sep 17 00:00:00 2001
From: Nulano <nulano@nulano.eu>
Date: Tue, 2 Jan 2024 16:12:37 +0100
Subject: [PATCH 0016/1178] document editable mode installation in
 winbuild/build.rst

---
 winbuild/build.rst | 7 +++++++
 1 file changed, 7 insertions(+)

diff --git a/winbuild/build.rst b/winbuild/build.rst
index a8e4ebaa6cc..26d0da0a35a 100644
--- a/winbuild/build.rst
+++ b/winbuild/build.rst
@@ -87,11 +87,18 @@ are set by running ``winbuild\build\build_env.cmd`` and install Pillow with pip:
     winbuild\build\build_env.cmd
     python.exe -m pip install -v -C raqm=vendor -C fribidi=vendor .
 
+You can also install Pillow in `editable mode`_::
+
+    winbuild\build\build_env.cmd
+    python.exe -m pip install -v -C raqm=vendor -C fribidi=vendor -e .
+
 To build a wheel instead, run::
 
     winbuild\build\build_env.cmd
     python.exe -m pip wheel -v -C raqm=vendor -C fribidi=vendor .
 
+.. _editable mode: https://setuptools.pypa.io/en/latest/userguide/development_mode.html
+
 Testing Pillow
 --------------
 

From b4a82712887e14b7ff1fc6302fdd9b1a48ac2280 Mon Sep 17 00:00:00 2001
From: Nulano <nulano@nulano.eu>
Date: Tue, 2 Jan 2024 17:26:11 +0100
Subject: [PATCH 0017/1178] update Windows 11 tested versions

---
 docs/installation.rst | 4 ++--
 1 file changed, 2 insertions(+), 2 deletions(-)

diff --git a/docs/installation.rst b/docs/installation.rst
index fbcfbb90724..4c58b4ebb27 100644
--- a/docs/installation.rst
+++ b/docs/installation.rst
@@ -581,9 +581,9 @@ These platforms have been reported to work at the versions mentioned.
 +----------------------------------+----------------------------+------------------+--------------+
 | FreeBSD 10.2                     | 2.7, 3.4                   | 3.1.0            |x86-64        |
 +----------------------------------+----------------------------+------------------+--------------+
-| Windows 11                       | 3.9, 3.10, 3.11, 3.12      | 10.1.0           |arm64         |
+| Windows 11                       | 3.9, 3.10, 3.11, 3.12      | 10.2.0           |arm64         |
 +----------------------------------+----------------------------+------------------+--------------+
-| Windows 11 Pro                   | 3.11, 3.12                 | 10.1.0           |x86-64        |
+| Windows 11 Pro                   | 3.11, 3.12                 | 10.2.0           |x86-64        |
 +----------------------------------+----------------------------+------------------+--------------+
 | Windows 10                       | 3.7                        | 7.1.0            |x86-64        |
 +----------------------------------+----------------------------+------------------+--------------+

From d134110ace31194f5fab4a9c3a62563a5d2a91bd Mon Sep 17 00:00:00 2001
From: Andrew Murray <radarhere@users.noreply.github.com>
Date: Wed, 3 Jan 2024 09:01:35 +1100
Subject: [PATCH 0018/1178] If bbox is omitted, screenshot is taken at 2x on
 Retina screens

---
 docs/reference/ImageGrab.rst | 6 +++---
 1 file changed, 3 insertions(+), 3 deletions(-)

diff --git a/docs/reference/ImageGrab.rst b/docs/reference/ImageGrab.rst
index e0e8d5a2f1b..db2987eb081 100644
--- a/docs/reference/ImageGrab.rst
+++ b/docs/reference/ImageGrab.rst
@@ -11,9 +11,9 @@ or the clipboard to a PIL image memory.
 
 .. py:function:: grab(bbox=None, include_layered_windows=False, all_screens=False, xdisplay=None)
 
-    Take a snapshot of the screen. The pixels inside the bounding box are
-    returned as an "RGBA" on macOS, or an "RGB" image otherwise.
-    If the bounding box is omitted, the entire screen is copied.
+    Take a snapshot of the screen. The pixels inside the bounding box are returned as
+    an "RGBA" on macOS, or an "RGB" image otherwise. If the bounding box is omitted,
+    the entire screen is copied, and on macOS, it will be at 2x if on a Retina screen.
 
     On Linux, if ``xdisplay`` is ``None`` and the default X11 display does not return
     a snapshot of the screen, ``gnome-screenshot`` will be used as fallback if it is

From 424737ef4906b5005f53b1642e5b538cadf391ed Mon Sep 17 00:00:00 2001
From: Andrew Murray <radarhere@users.noreply.github.com>
Date: Wed, 3 Jan 2024 11:18:16 +1100
Subject: [PATCH 0019/1178] Updated macOS tested Pillow versions

---
 docs/installation.rst | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/docs/installation.rst b/docs/installation.rst
index 4c58b4ebb27..922720b9d05 100644
--- a/docs/installation.rst
+++ b/docs/installation.rst
@@ -510,7 +510,7 @@ These platforms have been reported to work at the versions mentioned.
 | Operating system                 | | Tested Python            | | Latest tested  | | Tested     |
 |                                  | | versions                 | | Pillow version | | processors |
 +==================================+============================+==================+==============+
-| macOS 14 Sonoma                  | 3.8, 3.9, 3.10, 3.11, 3.12 | 10.1.0           |arm           |
+| macOS 14 Sonoma                  | 3.8, 3.9, 3.10, 3.11, 3.12 | 10.2.0           |arm           |
 +----------------------------------+----------------------------+------------------+--------------+
 | macOS 13 Ventura                 | 3.8, 3.9, 3.10, 3.11       | 10.0.1           |arm           |
 |                                  +----------------------------+------------------+              |

From 05e73702f2651897efbdc0ad39551f1a99b371d4 Mon Sep 17 00:00:00 2001
From: Andrew Murray <radarhere@users.noreply.github.com>
Date: Thu, 4 Jan 2024 10:51:10 +1100
Subject: [PATCH 0020/1178] Updated matrix variable name on Linux and macOS to
 match Windows

---
 .github/workflows/wheels.yml | 12 ++++++------
 1 file changed, 6 insertions(+), 6 deletions(-)

diff --git a/.github/workflows/wheels.yml b/.github/workflows/wheels.yml
index 5adff7ec1c4..85d9eba1c3e 100644
--- a/.github/workflows/wheels.yml
+++ b/.github/workflows/wheels.yml
@@ -39,18 +39,18 @@ jobs:
         include:
           - name: "macOS x86_64"
             os: macos-latest
-            archs: x86_64
+            cibw_arch: x86_64
             macosx_deployment_target: "10.10"
           - name: "macOS arm64"
             os: macos-latest
-            archs: arm64
+            cibw_arch: arm64
             macosx_deployment_target: "11.0"
           - name: "manylinux2014 and musllinux x86_64"
             os: ubuntu-latest
-            archs: x86_64
+            cibw_arch: x86_64
           - name: "manylinux_2_28 x86_64"
             os: ubuntu-latest
-            archs: x86_64
+            cibw_arch: x86_64
             build: "*manylinux*"
             manylinux: "manylinux_2_28"
     steps:
@@ -67,7 +67,7 @@ jobs:
           python3 -m pip install -r .ci/requirements-cibw.txt
           python3 -m cibuildwheel --output-dir wheelhouse
         env:
-          CIBW_ARCHS: ${{ matrix.archs }}
+          CIBW_ARCHS: ${{ matrix.cibw_arch }}
           CIBW_BUILD: ${{ matrix.build }}
           CIBW_MANYLINUX_PYPY_X86_64_IMAGE: ${{ matrix.manylinux }}
           CIBW_MANYLINUX_X86_64_IMAGE: ${{ matrix.manylinux }}
@@ -77,7 +77,7 @@ jobs:
 
       - uses: actions/upload-artifact@v4
         with:
-          name: dist-${{ matrix.os }}-${{ matrix.archs }}${{ matrix.manylinux && format('-{0}', matrix.manylinux) }}
+          name: dist-${{ matrix.os }}-${{ matrix.cibw_arch }}${{ matrix.manylinux && format('-{0}', matrix.manylinux) }}
           path: ./wheelhouse/*.whl
 
   windows:

From 85c552934af5ed378b034560ace23107bb4ec497 Mon Sep 17 00:00:00 2001
From: Hugo van Kemenade <hugovk@users.noreply.github.com>
Date: Wed, 3 Jan 2024 17:45:41 +0200
Subject: [PATCH 0021/1178] Goodbye Travis CI

---
 .github/workflows/test-cygwin.yml  |  2 --
 .github/workflows/test-docker.yml  |  2 --
 .github/workflows/test-mingw.yml   |  2 --
 .github/workflows/test-windows.yml |  2 --
 .github/workflows/test.yml         |  2 --
 .travis.yml                        | 52 ------------------------------
 README.md                          |  3 --
 RELEASING.md                       |  8 +----
 docs/about.rst                     |  3 +-
 docs/index.rst                     |  4 ---
 10 files changed, 2 insertions(+), 78 deletions(-)
 delete mode 100644 .travis.yml

diff --git a/.github/workflows/test-cygwin.yml b/.github/workflows/test-cygwin.yml
index 32ac6f65e76..7244315ac15 100644
--- a/.github/workflows/test-cygwin.yml
+++ b/.github/workflows/test-cygwin.yml
@@ -8,7 +8,6 @@ on:
       - ".github/workflows/docs.yml"
       - ".github/workflows/wheels*"
       - ".gitmodules"
-      - ".travis.yml"
       - "docs/**"
       - "wheels/**"
   pull_request:
@@ -16,7 +15,6 @@ on:
       - ".github/workflows/docs.yml"
       - ".github/workflows/wheels*"
       - ".gitmodules"
-      - ".travis.yml"
       - "docs/**"
       - "wheels/**"
   workflow_dispatch:
diff --git a/.github/workflows/test-docker.yml b/.github/workflows/test-docker.yml
index eb27b4bf75b..3bb6856f6e8 100644
--- a/.github/workflows/test-docker.yml
+++ b/.github/workflows/test-docker.yml
@@ -8,7 +8,6 @@ on:
       - ".github/workflows/docs.yml"
       - ".github/workflows/wheels*"
       - ".gitmodules"
-      - ".travis.yml"
       - "docs/**"
       - "wheels/**"
   pull_request:
@@ -16,7 +15,6 @@ on:
       - ".github/workflows/docs.yml"
       - ".github/workflows/wheels*"
       - ".gitmodules"
-      - ".travis.yml"
       - "docs/**"
       - "wheels/**"
   workflow_dispatch:
diff --git a/.github/workflows/test-mingw.yml b/.github/workflows/test-mingw.yml
index 115c2e9bebc..cdd51e2bb3f 100644
--- a/.github/workflows/test-mingw.yml
+++ b/.github/workflows/test-mingw.yml
@@ -8,7 +8,6 @@ on:
       - ".github/workflows/docs.yml"
       - ".github/workflows/wheels*"
       - ".gitmodules"
-      - ".travis.yml"
       - "docs/**"
       - "wheels/**"
   pull_request:
@@ -16,7 +15,6 @@ on:
       - ".github/workflows/docs.yml"
       - ".github/workflows/wheels*"
       - ".gitmodules"
-      - ".travis.yml"
       - "docs/**"
       - "wheels/**"
   workflow_dispatch:
diff --git a/.github/workflows/test-windows.yml b/.github/workflows/test-windows.yml
index 86cd5b5fa1e..a0ef1c3f1ec 100644
--- a/.github/workflows/test-windows.yml
+++ b/.github/workflows/test-windows.yml
@@ -6,7 +6,6 @@ on:
       - ".github/workflows/docs.yml"
       - ".github/workflows/wheels*"
       - ".gitmodules"
-      - ".travis.yml"
       - "docs/**"
       - "wheels/**"
   pull_request:
@@ -14,7 +13,6 @@ on:
       - ".github/workflows/docs.yml"
       - ".github/workflows/wheels*"
       - ".gitmodules"
-      - ".travis.yml"
       - "docs/**"
       - "wheels/**"
   workflow_dispatch:
diff --git a/.github/workflows/test.yml b/.github/workflows/test.yml
index b7e112f4364..05f78704bcd 100644
--- a/.github/workflows/test.yml
+++ b/.github/workflows/test.yml
@@ -8,7 +8,6 @@ on:
       - ".github/workflows/docs.yml"
       - ".github/workflows/wheels*"
       - ".gitmodules"
-      - ".travis.yml"
       - "docs/**"
       - "wheels/**"
   pull_request:
@@ -16,7 +15,6 @@ on:
       - ".github/workflows/docs.yml"
       - ".github/workflows/wheels*"
       - ".gitmodules"
-      - ".travis.yml"
       - "docs/**"
       - "wheels/**"
   workflow_dispatch:
diff --git a/.travis.yml b/.travis.yml
deleted file mode 100644
index 8f8250809d7..00000000000
--- a/.travis.yml
+++ /dev/null
@@ -1,52 +0,0 @@
-if: tag IS present OR type = api
-
-env:
-  global:
-    - CIBW_ARCHS=aarch64
-    - CIBW_SKIP=pp38-*
-
-language: python
-# Default Python version is usually 3.6
-python: "3.12"
-dist: jammy
-services: docker
-
-jobs:
-  include:
-    - name: "manylinux2014 aarch64"
-      os: linux
-      arch: arm64
-      env:
-        - CIBW_BUILD="*manylinux*"
-        - CIBW_MANYLINUX_AARCH64_IMAGE=manylinux2014
-        - CIBW_MANYLINUX_PYPY_AARCH64_IMAGE=manylinux2014
-    - name: "manylinux_2_28 aarch64"
-      os: linux
-      arch: arm64
-      env:
-        - CIBW_BUILD="*manylinux*"
-        - CIBW_MANYLINUX_AARCH64_IMAGE=manylinux_2_28
-        - CIBW_MANYLINUX_PYPY_AARCH64_IMAGE=manylinux_2_28
-    - name: "musllinux aarch64"
-      os: linux
-      arch: arm64
-      env:
-        - CIBW_BUILD="*musllinux*"
-
-install:
-    - python3 -m pip install -r .ci/requirements-cibw.txt
-
-script:
-    - python3 -m cibuildwheel --output-dir wheelhouse
-    - ls -l "${TRAVIS_BUILD_DIR}/wheelhouse/"
-
-# Upload wheels to GitHub Releases
-deploy:
-  provider: releases
-  api_key: $GITHUB_RELEASE_TOKEN
-  file_glob: true
-  file: "${TRAVIS_BUILD_DIR}/wheelhouse/*.whl"
-  on:
-    repo: python-pillow/Pillow
-    tags: true
-  skip_cleanup: true
diff --git a/README.md b/README.md
index e11bd2faa1d..6982676f518 100644
--- a/README.md
+++ b/README.md
@@ -48,9 +48,6 @@ As of 2019, Pillow development is
             <a href="https://github.com/python-pillow/Pillow/actions/workflows/wheels.yml"><img
                 alt="GitHub Actions build status (Wheels)"
                 src="https://github.com/python-pillow/Pillow/workflows/Wheels/badge.svg"></a>
-            <a href="https://app.travis-ci.com/github/python-pillow/Pillow"><img
-                alt="Travis CI wheels build status (aarch64)"
-                src="https://img.shields.io/travis/com/python-pillow/Pillow/main.svg?label=aarch64%20wheels"></a>
             <a href="https://app.codecov.io/gh/python-pillow/Pillow"><img
                 alt="Code coverage"
                 src="https://codecov.io/gh/python-pillow/Pillow/branch/main/graph/badge.svg"></a>
diff --git a/RELEASING.md b/RELEASING.md
index 97f4f8dcd18..62f3627de19 100644
--- a/RELEASING.md
+++ b/RELEASING.md
@@ -10,7 +10,7 @@ Released quarterly on January 2nd, April 1st, July 1st and October 15th.
 * [ ] Open a release ticket e.g. https://github.com/python-pillow/Pillow/issues/3154
 * [ ] Develop and prepare release in `main` branch.
 * [ ] Check [GitHub Actions](https://github.com/python-pillow/Pillow/actions) and [AppVeyor](https://ci.appveyor.com/project/python-pillow/Pillow) to confirm passing tests in `main` branch.
-* [ ] Check that all of the wheel builds pass the tests in the [GitHub Actions "Wheels" workflow](https://github.com/python-pillow/Pillow/actions/workflows/wheels.yml) and [Travis CI](https://app.travis-ci.com/github/python-pillow/pillow) jobs by manually triggering them.
+* [ ] Check that all the wheel builds pass the tests in the [GitHub Actions "Wheels" workflow](https://github.com/python-pillow/Pillow/actions/workflows/wheels.yml) jobs by manually triggering them.
 * [ ] In compliance with [PEP 440](https://peps.python.org/pep-0440/), update version identifier in `src/PIL/_version.py`
 * [ ] Update `CHANGES.rst`.
 * [ ] Run pre-release check via `make release-test` in a freshly cloned repo.
@@ -83,12 +83,6 @@ Released as needed privately to individual vendors for critical security-related
 * [ ] Check the [GitHub Actions "Wheels" workflow](https://github.com/python-pillow/Pillow/actions/workflows/wheels.yml)
   has passed, including the "Upload release to PyPI" job. This will have been triggered
   by the new tag.
-* [ ] Download the Linux aarch64 wheels created by Travis CI from [GitHub releases](https://github.com/python-pillow/Pillow/releases)
-  and copy into `dist`. Check and upload them e.g.:
-  ```bash
-  python3 -m twine check --strict dist/*
-  python3 -m twine upload dist/pillow-5.2.0*
-  ```
 
 ## Publicize Release
 
diff --git a/docs/about.rst b/docs/about.rst
index 872ac0ea690..da351ce2c56 100644
--- a/docs/about.rst
+++ b/docs/about.rst
@@ -6,13 +6,12 @@ Goals
 
 The fork author's goal is to foster and support active development of PIL through:
 
-- Continuous integration testing via `GitHub Actions`_, `AppVeyor`_ and `Travis CI`_
+- Continuous integration testing via `GitHub Actions`_ and `AppVeyor`_
 - Publicized development activity on `GitHub`_
 - Regular releases to the `Python Package Index`_
 
 .. _GitHub Actions: https://github.com/python-pillow/Pillow/actions
 .. _AppVeyor: https://ci.appveyor.com/project/Python-pillow/pillow
-.. _Travis CI: https://app.travis-ci.com/github/python-pillow/Pillow
 .. _GitHub: https://github.com/python-pillow/Pillow
 .. _Python Package Index: https://pypi.org/project/Pillow/
 
diff --git a/docs/index.rst b/docs/index.rst
index 4f577fe9c22..053d55c3c39 100644
--- a/docs/index.rst
+++ b/docs/index.rst
@@ -41,10 +41,6 @@ Pillow for enterprise is available via the Tidelift Subscription. `Learn more <h
    :target: https://github.com/python-pillow/Pillow/actions/workflows/wheels.yml
    :alt: GitHub Actions build status (Wheels)
 
-.. image:: https://img.shields.io/travis/com/python-pillow/Pillow/main.svg?label=aarch64%20wheels
-   :target: https://app.travis-ci.com/github/python-pillow/Pillow
-   :alt: Travis CI wheels build status (aarch64)
-
 .. image:: https://codecov.io/gh/python-pillow/Pillow/branch/main/graph/badge.svg
    :target: https://app.codecov.io/gh/python-pillow/Pillow
    :alt: Code coverage

From df37b47fd87a5b2b7fe66cbc7c5e66bfbcbb4c78 Mon Sep 17 00:00:00 2001
From: Hugo van Kemenade <hugovk@users.noreply.github.com>
Date: Tue, 2 Jan 2024 18:11:52 +0200
Subject: [PATCH 0022/1178] Build QEMU-emulated Linux aarch64 wheels on GitHub
 Actions

---
 .github/workflows/wheels.yml | 77 +++++++++++++++++++++++++++++++++++-
 1 file changed, 75 insertions(+), 2 deletions(-)

diff --git a/.github/workflows/wheels.yml b/.github/workflows/wheels.yml
index 85d9eba1c3e..6ebf9a4c029 100644
--- a/.github/workflows/wheels.yml
+++ b/.github/workflows/wheels.yml
@@ -30,7 +30,80 @@ env:
   FORCE_COLOR: 1
 
 jobs:
-  build:
+  build-1-QEMU-emulated-wheels:
+    name: QEMU ${{ matrix.python-version }} ${{ matrix.spec }}
+    runs-on: ubuntu-latest
+    strategy:
+      fail-fast: false
+      matrix:
+        python-version:
+          - pp39
+          - pp310
+          - cp38
+          - cp39
+          - cp310
+          - cp311
+          - cp312
+        spec:
+          - manylinux2014
+          - manylinux_2_28
+          - musllinux
+        exclude:
+          - { python-version: pp39, spec: musllinux }
+          - { python-version: pp310, spec: musllinux }
+
+    steps:
+      - uses: actions/checkout@v4
+        with:
+          submodules: true
+
+      - uses: actions/setup-python@v5
+        with:
+          python-version: "3.x"
+
+      # https://github.com/docker/setup-qemu-action
+      - name: Set up QEMU
+        uses: docker/setup-qemu-action@v3
+
+      # https://github.com/docker/setup-buildx-action
+      - name: Set up Docker Buildx
+        uses: docker/setup-buildx-action@v3
+
+      - name: Install cibuildwheel
+        run: |
+          python3 -m pip install -r .ci/requirements-cibw.txt
+
+      - name: Build wheels (manylinux)
+        if: matrix.spec != 'musllinux'
+        run: |
+          python3 -m cibuildwheel --output-dir wheelhouse
+        env:
+          # Build only the currently selected Linux architecture (so we can
+          # parallelise for speed).
+          CIBW_ARCHS_LINUX: "aarch64"
+          # Likewise, select only one Python version per job to speed this up.
+          CIBW_BUILD: "${{ matrix.python-version }}-manylinux*"
+          # Extra options for manylinux.
+          CIBW_MANYLINUX_AARCH64_IMAGE: ${{ matrix.spec }}
+          CIBW_MANYLINUX_PYPY_AARCH64_IMAGE: ${{ matrix.spec }}
+
+      - name: Build wheels (musllinux)
+        if: matrix.spec == 'musllinux'
+        run: |
+          python3 -m cibuildwheel --output-dir wheelhouse
+        env:
+          # Build only the currently selected Linux architecture (so we can
+          # parallelise for speed).
+          CIBW_ARCHS_LINUX: "aarch64"
+          # Likewise, select only one Python version per job to speed this up.
+          CIBW_BUILD: "${{ matrix.python-version }}-${{ matrix.spec }}*"
+
+      - uses: actions/upload-artifact@v4
+        with:
+          name: dist-qemu-${{ matrix.python-version }}-${{ matrix.spec }}
+          path: ./wheelhouse/*.whl
+
+  build-2-native-wheels:
     name: ${{ matrix.name }}
     runs-on: ${{ matrix.os }}
     strategy:
@@ -187,7 +260,7 @@ jobs:
 
   pypi-publish:
     if: github.event_name == 'push' && startsWith(github.ref, 'refs/tags')
-    needs: [build, windows, sdist]
+    needs: [build-1-QEMU-emulated-wheels, build-2-native-wheels, windows, sdist]
     runs-on: ubuntu-latest
     name: Upload release to PyPI
     environment:

From 55944860a5dd4a38d786df035346b9d5ddf3aa1e Mon Sep 17 00:00:00 2001
From: Hugo van Kemenade <hugovk@users.noreply.github.com>
Date: Thu, 4 Jan 2024 12:50:06 +0200
Subject: [PATCH 0023/1178] Remove unused docker/setup-buildx-action

---
 .github/workflows/wheels.yml | 4 ----
 1 file changed, 4 deletions(-)

diff --git a/.github/workflows/wheels.yml b/.github/workflows/wheels.yml
index 6ebf9a4c029..4de599b810b 100644
--- a/.github/workflows/wheels.yml
+++ b/.github/workflows/wheels.yml
@@ -65,10 +65,6 @@ jobs:
       - name: Set up QEMU
         uses: docker/setup-qemu-action@v3
 
-      # https://github.com/docker/setup-buildx-action
-      - name: Set up Docker Buildx
-        uses: docker/setup-buildx-action@v3
-
       - name: Install cibuildwheel
         run: |
           python3 -m pip install -r .ci/requirements-cibw.txt

From 32ae1bd08a6e3d8b9d266a2e7c8b265ec3d5ad18 Mon Sep 17 00:00:00 2001
From: Hugo van Kemenade <hugovk@users.noreply.github.com>
Date: Thu, 4 Jan 2024 12:52:22 +0200
Subject: [PATCH 0024/1178] Use aarch64 instead of QEMU in job name

---
 .github/workflows/wheels.yml | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/.github/workflows/wheels.yml b/.github/workflows/wheels.yml
index 4de599b810b..d7a93c70ce6 100644
--- a/.github/workflows/wheels.yml
+++ b/.github/workflows/wheels.yml
@@ -31,7 +31,7 @@ env:
 
 jobs:
   build-1-QEMU-emulated-wheels:
-    name: QEMU ${{ matrix.python-version }} ${{ matrix.spec }}
+    name: aarch64 ${{ matrix.python-version }} ${{ matrix.spec }}
     runs-on: ubuntu-latest
     strategy:
       fail-fast: false

From fd37d86accff55d366950b3f9d286c7174ebe9b4 Mon Sep 17 00:00:00 2001
From: Hugo van Kemenade <hugovk@users.noreply.github.com>
Date: Thu, 4 Jan 2024 12:55:04 +0200
Subject: [PATCH 0025/1178] Skip non-wheel CI runs for tags

---
 .github/workflows/test-windows.yml | 2 ++
 1 file changed, 2 insertions(+)

diff --git a/.github/workflows/test-windows.yml b/.github/workflows/test-windows.yml
index 86cd5b5fa1e..94c2d4d70b8 100644
--- a/.github/workflows/test-windows.yml
+++ b/.github/workflows/test-windows.yml
@@ -2,6 +2,8 @@ name: Test Windows
 
 on:
   push:
+    branches:
+      - "**"
     paths-ignore:
       - ".github/workflows/docs.yml"
       - ".github/workflows/wheels*"

From bc3cf97649d76bc231ec99d41dfd6eb2be72b175 Mon Sep 17 00:00:00 2001
From: Andrew Murray <radarhere@users.noreply.github.com>
Date: Thu, 4 Jan 2024 11:00:11 +1100
Subject: [PATCH 0026/1178] Use general arch setting instead of
 platform-specific setting

---
 .github/workflows/wheels.yml | 4 ++--
 1 file changed, 2 insertions(+), 2 deletions(-)

diff --git a/.github/workflows/wheels.yml b/.github/workflows/wheels.yml
index d7a93c70ce6..8a9f81dfd09 100644
--- a/.github/workflows/wheels.yml
+++ b/.github/workflows/wheels.yml
@@ -76,7 +76,7 @@ jobs:
         env:
           # Build only the currently selected Linux architecture (so we can
           # parallelise for speed).
-          CIBW_ARCHS_LINUX: "aarch64"
+          CIBW_ARCHS: "aarch64"
           # Likewise, select only one Python version per job to speed this up.
           CIBW_BUILD: "${{ matrix.python-version }}-manylinux*"
           # Extra options for manylinux.
@@ -90,7 +90,7 @@ jobs:
         env:
           # Build only the currently selected Linux architecture (so we can
           # parallelise for speed).
-          CIBW_ARCHS_LINUX: "aarch64"
+          CIBW_ARCHS: "aarch64"
           # Likewise, select only one Python version per job to speed this up.
           CIBW_BUILD: "${{ matrix.python-version }}-${{ matrix.spec }}*"
 

From e84b0a401509325c7e5e553a9f1a4591256b4b45 Mon Sep 17 00:00:00 2001
From: Andrew Murray <radarhere@users.noreply.github.com>
Date: Thu, 4 Jan 2024 11:38:41 +1100
Subject: [PATCH 0027/1178] Combine build steps

---
 .github/workflows/wheels.yml | 16 ++--------------
 1 file changed, 2 insertions(+), 14 deletions(-)

diff --git a/.github/workflows/wheels.yml b/.github/workflows/wheels.yml
index 8a9f81dfd09..e2bc78b983c 100644
--- a/.github/workflows/wheels.yml
+++ b/.github/workflows/wheels.yml
@@ -69,8 +69,7 @@ jobs:
         run: |
           python3 -m pip install -r .ci/requirements-cibw.txt
 
-      - name: Build wheels (manylinux)
-        if: matrix.spec != 'musllinux'
+      - name: Build wheels
         run: |
           python3 -m cibuildwheel --output-dir wheelhouse
         env:
@@ -78,22 +77,11 @@ jobs:
           # parallelise for speed).
           CIBW_ARCHS: "aarch64"
           # Likewise, select only one Python version per job to speed this up.
-          CIBW_BUILD: "${{ matrix.python-version }}-manylinux*"
+          CIBW_BUILD: "${{ matrix.python-version }}-${{ matrix.spec == 'musllinux' && 'musllinux' || 'manylinux' }}*"
           # Extra options for manylinux.
           CIBW_MANYLINUX_AARCH64_IMAGE: ${{ matrix.spec }}
           CIBW_MANYLINUX_PYPY_AARCH64_IMAGE: ${{ matrix.spec }}
 
-      - name: Build wheels (musllinux)
-        if: matrix.spec == 'musllinux'
-        run: |
-          python3 -m cibuildwheel --output-dir wheelhouse
-        env:
-          # Build only the currently selected Linux architecture (so we can
-          # parallelise for speed).
-          CIBW_ARCHS: "aarch64"
-          # Likewise, select only one Python version per job to speed this up.
-          CIBW_BUILD: "${{ matrix.python-version }}-${{ matrix.spec }}*"
-
       - uses: actions/upload-artifact@v4
         with:
           name: dist-qemu-${{ matrix.python-version }}-${{ matrix.spec }}

From 60e82e5a3f21b25e1b54ebc1104e972290201a85 Mon Sep 17 00:00:00 2001
From: Andrew Murray <radarhere@users.noreply.github.com>
Date: Thu, 4 Jan 2024 17:24:09 +1100
Subject: [PATCH 0028/1178] Separate cibuildwheel install

---
 .github/workflows/wheels.yml | 10 +++++++---
 1 file changed, 7 insertions(+), 3 deletions(-)

diff --git a/.github/workflows/wheels.yml b/.github/workflows/wheels.yml
index e2bc78b983c..50e47f19853 100644
--- a/.github/workflows/wheels.yml
+++ b/.github/workflows/wheels.yml
@@ -119,9 +119,11 @@ jobs:
         with:
           python-version: "3.x"
 
-      - name: Build wheels
+      - name: Install cibuildwheel
         run: |
           python3 -m pip install -r .ci/requirements-cibw.txt
+
+      - name: Build wheels
           python3 -m cibuildwheel --output-dir wheelhouse
         env:
           CIBW_ARCHS: ${{ matrix.cibw_arch }}
@@ -163,6 +165,10 @@ jobs:
         with:
           python-version: "3.x"
 
+      - name: Install cibuildwheel
+        run: |
+          & python.exe -m pip install -r .ci/requirements-cibw.txt
+
       - name: Prepare for build
         run: |
           choco install nasm --no-progress
@@ -171,8 +177,6 @@ jobs:
           # Install extra test images
           xcopy /S /Y Tests\test-images\* Tests\images
 
-          & python.exe -m pip install -r .ci/requirements-cibw.txt
-
           & python.exe winbuild\build_prepare.py -v --no-imagequant --architecture=${{ matrix.arch }}
         shell: pwsh
 

From 46db79abe1b8ada6f980e01cee633f9c8f6fbbdf Mon Sep 17 00:00:00 2001
From: Hugo van Kemenade <hugovk@users.noreply.github.com>
Date: Thu, 4 Jan 2024 00:30:46 -0700
Subject: [PATCH 0029/1178] Fix syntax

---
 .github/workflows/wheels.yml | 1 +
 1 file changed, 1 insertion(+)

diff --git a/.github/workflows/wheels.yml b/.github/workflows/wheels.yml
index 50e47f19853..77c1489dfcd 100644
--- a/.github/workflows/wheels.yml
+++ b/.github/workflows/wheels.yml
@@ -124,6 +124,7 @@ jobs:
           python3 -m pip install -r .ci/requirements-cibw.txt
 
       - name: Build wheels
+        run: |
           python3 -m cibuildwheel --output-dir wheelhouse
         env:
           CIBW_ARCHS: ${{ matrix.cibw_arch }}

From f184775cd3a2410ad326572d2b1d9a75ac481790 Mon Sep 17 00:00:00 2001
From: Andrew Murray <3112309+radarhere@users.noreply.github.com>
Date: Thu, 4 Jan 2024 23:32:54 +1100
Subject: [PATCH 0030/1178] Removed leading ampersand

Co-authored-by: Hugo van Kemenade <hugovk@users.noreply.github.com>
---
 .github/workflows/wheels.yml | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/.github/workflows/wheels.yml b/.github/workflows/wheels.yml
index 77c1489dfcd..be8f652447c 100644
--- a/.github/workflows/wheels.yml
+++ b/.github/workflows/wheels.yml
@@ -168,7 +168,7 @@ jobs:
 
       - name: Install cibuildwheel
         run: |
-          & python.exe -m pip install -r .ci/requirements-cibw.txt
+          python.exe -m pip install -r .ci/requirements-cibw.txt
 
       - name: Prepare for build
         run: |

From 2dd00de1f36d0e5dfd15f28048c2e2b7550bb232 Mon Sep 17 00:00:00 2001
From: Nulano <nulano@nulano.eu>
Date: Thu, 4 Jan 2024 20:26:14 +0100
Subject: [PATCH 0031/1178] rename x64 to AMD64 in winbuild/build_prepare.py

---
 .appveyor.yml                |  2 +-
 .github/workflows/wheels.yml | 17 +++++++----------
 winbuild/build.rst           |  6 +++---
 winbuild/build_prepare.py    |  4 ++--
 4 files changed, 13 insertions(+), 16 deletions(-)

diff --git a/.appveyor.yml b/.appveyor.yml
index 0f5dea9c515..4c5a7f9ee47 100644
--- a/.appveyor.yml
+++ b/.appveyor.yml
@@ -14,7 +14,7 @@ environment:
     ARCHITECTURE: x86
     APPVEYOR_BUILD_WORKER_IMAGE: Visual Studio 2022
   - PYTHON: C:/Python38-x64
-    ARCHITECTURE: x64
+    ARCHITECTURE: AMD64
     APPVEYOR_BUILD_WORKER_IMAGE: Visual Studio 2017
 
 
diff --git a/.github/workflows/wheels.yml b/.github/workflows/wheels.yml
index 85d9eba1c3e..36e98aa554a 100644
--- a/.github/workflows/wheels.yml
+++ b/.github/workflows/wheels.yml
@@ -81,18 +81,15 @@ jobs:
           path: ./wheelhouse/*.whl
 
   windows:
-    name: Windows ${{ matrix.arch }}
+    name: Windows ${{ matrix.cibw_arch }}
     runs-on: windows-latest
     strategy:
       fail-fast: false
       matrix:
         include:
-          - arch: x86
-            cibw_arch: x86
-          - arch: x64
-            cibw_arch: AMD64
-          - arch: ARM64
-            cibw_arch: ARM64
+          - cibw_arch: x86
+          - cibw_arch: AMD64
+          - cibw_arch: ARM64
     steps:
       - uses: actions/checkout@v4
 
@@ -116,7 +113,7 @@ jobs:
 
           & python.exe -m pip install -r .ci/requirements-cibw.txt
 
-          & python.exe winbuild\build_prepare.py -v --no-imagequant --architecture=${{ matrix.arch }}
+          & python.exe winbuild\build_prepare.py -v --no-imagequant --architecture=${{ matrix.cibw_arch }}
         shell: pwsh
 
       - name: Build wheels
@@ -157,13 +154,13 @@ jobs:
       - name: Upload wheels
         uses: actions/upload-artifact@v4
         with:
-          name: dist-windows-${{ matrix.arch }}
+          name: dist-windows-${{ matrix.cibw_arch }}
           path: ./wheelhouse/*.whl
 
       - name: Upload fribidi.dll
         uses: actions/upload-artifact@v4
         with:
-          name: fribidi-windows-${{ matrix.arch }}
+          name: fribidi-windows-${{ matrix.cibw_arch }}
           path: winbuild\build\bin\fribidi*
 
   sdist:
diff --git a/winbuild/build.rst b/winbuild/build.rst
index a8e4ebaa6cc..cd3b559e7f0 100644
--- a/winbuild/build.rst
+++ b/winbuild/build.rst
@@ -27,7 +27,7 @@ Download and install:
 * `Ninja <https://ninja-build.org/>`_
   (optional, use ``--nmake`` if not available; bundled in Visual Studio CMake component)
 
-* x86/x64: `Netwide Assembler (NASM) <https://www.nasm.us/pub/nasm/releasebuilds/?C=M;O=D>`_
+* x86/AMD64: `Netwide Assembler (NASM) <https://www.nasm.us/pub/nasm/releasebuilds/?C=M;O=D>`_
 
 Any version of Visual Studio 2017 or newer should be supported,
 including Visual Studio 2017 Community, or Build Tools for Visual Studio 2019.
@@ -42,7 +42,7 @@ Run ``build_prepare.py`` to configure the build::
 
     usage: winbuild\build_prepare.py [-h] [-v] [-d PILLOW_BUILD]
                                      [--depends PILLOW_DEPS]
-                                     [--architecture {x86,x64,ARM64}] [--nmake]
+                                     [--architecture {x86,AMD64,ARM64}] [--nmake]
                                      [--no-imagequant] [--no-fribidi]
 
     Download and generate build scripts for Pillow dependencies.
@@ -55,7 +55,7 @@ Run ``build_prepare.py`` to configure the build::
       --depends PILLOW_DEPS
                             directory used to store cached dependencies (default:
                             'winbuild\depends')
-      --architecture {x86,x64,ARM64}
+      --architecture {x86,AMD64,ARM64}
                             build architecture (default: same as host Python)
       --nmake               build dependencies using NMake instead of Ninja
       --no-imagequant       skip GPL-licensed optional dependency libimagequant
diff --git a/winbuild/build_prepare.py b/winbuild/build_prepare.py
index 8e3757ca89e..440e64d9851 100644
--- a/winbuild/build_prepare.py
+++ b/winbuild/build_prepare.py
@@ -105,7 +105,7 @@ def cmd_msbuild(
 
 ARCHITECTURES = {
     "x86": {"vcvars_arch": "x86", "msbuild_arch": "Win32"},
-    "x64": {"vcvars_arch": "x86_amd64", "msbuild_arch": "x64"},
+    "AMD64": {"vcvars_arch": "x86_amd64", "msbuild_arch": "x64"},
     "ARM64": {"vcvars_arch": "x86_arm64", "msbuild_arch": "ARM64"},
 }
 
@@ -651,7 +651,7 @@ def build_dep_all() -> None:
             (
                 "ARM64"
                 if platform.machine() == "ARM64"
-                else ("x86" if struct.calcsize("P") == 4 else "x64")
+                else ("x86" if struct.calcsize("P") == 4 else "AMD64")
             ),
         ),
         help="build architecture (default: same as host Python)",

From 5e2ebaface37ff71e1b8e4e9b5708ff3eec3a909 Mon Sep 17 00:00:00 2001
From: Nulano <nulano@nulano.eu>
Date: Thu, 4 Jan 2024 21:00:06 +0100
Subject: [PATCH 0032/1178] winbuild: build libwebp using cmake

---
 winbuild/build_prepare.py | 20 +++++++-------------
 1 file changed, 7 insertions(+), 13 deletions(-)

diff --git a/winbuild/build_prepare.py b/winbuild/build_prepare.py
index 440e64d9851..1615abbdb82 100644
--- a/winbuild/build_prepare.py
+++ b/winbuild/build_prepare.py
@@ -175,22 +175,15 @@ def cmd_msbuild(
         "dir": "libwebp-1.3.2",
         "license": "COPYING",
         "build": [
-            cmd_rmdir(r"output\release-static"),  # clean
-            cmd_nmake(
-                "Makefile.vc",
-                "all",
-                [
-                    "CFG=release-static",
-                    "RTLIBCFG=dynamic",
-                    "OBJDIR=output",
-                    "ARCH={architecture}",
-                    "LIBWEBP_BASENAME=webp",
-                ],
+            *cmds_cmake(
+                "webp webpdemux webpmux",
+                "-DBUILD_SHARED_LIBS:BOOL=OFF",
+                "-DWEBP_LINK_STATIC:BOOL=OFF",
             ),
             cmd_mkdir(r"{inc_dir}\webp"),
             cmd_copy(r"src\webp\*.h", r"{inc_dir}\webp"),
         ],
-        "libs": [r"output\release-static\{architecture}\lib\*.lib"],
+        "libs": [r"libwebp*.lib"],
     },
     "libtiff": {
         "url": "https://download.osgeo.org/libtiff/tiff-4.6.0.tar.gz",
@@ -204,7 +197,7 @@ def cmd_msbuild(
             },
             r"libtiff\tif_webp.c": {
                 # link against webp.lib
-                "#ifdef WEBP_SUPPORT": '#ifdef WEBP_SUPPORT\n#pragma comment(lib, "webp.lib")',  # noqa: E501
+                "#ifdef WEBP_SUPPORT": '#ifdef WEBP_SUPPORT\n#pragma comment(lib, "libwebp.lib")',  # noqa: E501
             },
             r"test\CMakeLists.txt": {
                 "add_executable(test_write_read_tags ../placeholder.h)": "",
@@ -217,6 +210,7 @@ def cmd_msbuild(
             *cmds_cmake(
                 "tiff",
                 "-DBUILD_SHARED_LIBS:BOOL=OFF",
+                "-DWebP_LIBRARY=libwebp",
                 '-DCMAKE_C_FLAGS="-nologo -DLZMA_API_STATIC"',
             )
         ],

From 4094edd12f32a432309d279d7c7b90d068f3bdb1 Mon Sep 17 00:00:00 2001
From: Nulano <nulano@nulano.eu>
Date: Thu, 4 Jan 2024 21:26:47 +0100
Subject: [PATCH 0033/1178] winbuild: fix libwebp linking libsharpyuv

---
 winbuild/build_prepare.py | 7 ++++++-
 1 file changed, 6 insertions(+), 1 deletion(-)

diff --git a/winbuild/build_prepare.py b/winbuild/build_prepare.py
index 1615abbdb82..84284ae10f4 100644
--- a/winbuild/build_prepare.py
+++ b/winbuild/build_prepare.py
@@ -174,6 +174,11 @@ def cmd_msbuild(
         "filename": "libwebp-1.3.2.tar.gz",
         "dir": "libwebp-1.3.2",
         "license": "COPYING",
+        "patch": {
+            r"src\enc\picture_csp_enc.c": {
+                '#include "sharpyuv/sharpyuv.h"': '#include "sharpyuv/sharpyuv.h"\n#pragma comment(lib, "libsharpyuv.lib")',  # noqa: E501
+            }
+        },
         "build": [
             *cmds_cmake(
                 "webp webpdemux webpmux",
@@ -183,7 +188,7 @@ def cmd_msbuild(
             cmd_mkdir(r"{inc_dir}\webp"),
             cmd_copy(r"src\webp\*.h", r"{inc_dir}\webp"),
         ],
-        "libs": [r"libwebp*.lib"],
+        "libs": [r"libsharpyuv.lib", r"libwebp*.lib"],
     },
     "libtiff": {
         "url": "https://download.osgeo.org/libtiff/tiff-4.6.0.tar.gz",

From eff9f06f0dac6521d89938aa5a93ab03a77fd50d Mon Sep 17 00:00:00 2001
From: Nulano <nulano@nulano.eu>
Date: Thu, 4 Jan 2024 22:10:11 +0100
Subject: [PATCH 0034/1178] fix comments

---
 winbuild/build_prepare.py | 3 ++-
 1 file changed, 2 insertions(+), 1 deletion(-)

diff --git a/winbuild/build_prepare.py b/winbuild/build_prepare.py
index 84284ae10f4..df33ea493e6 100644
--- a/winbuild/build_prepare.py
+++ b/winbuild/build_prepare.py
@@ -176,6 +176,7 @@ def cmd_msbuild(
         "license": "COPYING",
         "patch": {
             r"src\enc\picture_csp_enc.c": {
+                # link against libsharpyuv.lib
                 '#include "sharpyuv/sharpyuv.h"': '#include "sharpyuv/sharpyuv.h"\n#pragma comment(lib, "libsharpyuv.lib")',  # noqa: E501
             }
         },
@@ -201,7 +202,7 @@ def cmd_msbuild(
                 "#ifdef LZMA_SUPPORT": '#ifdef LZMA_SUPPORT\n#pragma comment(lib, "liblzma.lib")',  # noqa: E501
             },
             r"libtiff\tif_webp.c": {
-                # link against webp.lib
+                # link against libwebp.lib
                 "#ifdef WEBP_SUPPORT": '#ifdef WEBP_SUPPORT\n#pragma comment(lib, "libwebp.lib")',  # noqa: E501
             },
             r"test\CMakeLists.txt": {

From d329207e62125ee3dcda0b2a82112757e9ef6fbd Mon Sep 17 00:00:00 2001
From: Andrew Murray <radarhere@users.noreply.github.com>
Date: Sat, 6 Jan 2024 07:03:40 +1100
Subject: [PATCH 0035/1178] Update CHANGES.rst [ci skip]

---
 CHANGES.rst | 6 ++++++
 1 file changed, 6 insertions(+)

diff --git a/CHANGES.rst b/CHANGES.rst
index 85036f6425b..ac961a680a3 100644
--- a/CHANGES.rst
+++ b/CHANGES.rst
@@ -2,6 +2,12 @@
 Changelog (Pillow)
 ==================
 
+10.3.0 (unreleased)
+-------------------
+
+- Rename x64 to AMD64 in winbuild #7693
+  [nulano]
+
 10.2.0 (2024-01-02)
 -------------------
 

From 2d6ad5868dac031a8b4eeda41116b3da3fd1be58 Mon Sep 17 00:00:00 2001
From: Andrew Murray <radarhere@users.noreply.github.com>
Date: Sat, 6 Jan 2024 12:07:55 +1100
Subject: [PATCH 0036/1178] Use "non-zero" consistently

---
 Tests/test_file_eps.py       | 4 ++--
 Tests/test_image_resample.py | 2 +-
 src/libImaging/GifEncode.c   | 2 +-
 src/libImaging/Jpeg.h        | 2 +-
 4 files changed, 5 insertions(+), 5 deletions(-)

diff --git a/Tests/test_file_eps.py b/Tests/test_file_eps.py
index c479c384a76..8b48e83ad2c 100644
--- a/Tests/test_file_eps.py
+++ b/Tests/test_file_eps.py
@@ -270,7 +270,7 @@ def test_render_scale1():
         image1_scale1_compare.load()
         assert_image_similar(image1_scale1, image1_scale1_compare, 5)
 
-    # Non-Zero bounding box
+    # Non-zero bounding box
     with Image.open(FILE2) as image2_scale1:
         image2_scale1.load()
         with Image.open(FILE2_COMPARE) as image2_scale1_compare:
@@ -292,7 +292,7 @@ def test_render_scale2():
         image1_scale2_compare.load()
         assert_image_similar(image1_scale2, image1_scale2_compare, 5)
 
-    # Non-Zero bounding box
+    # Non-zero bounding box
     with Image.open(FILE2) as image2_scale2:
         image2_scale2.load(scale=2)
         with Image.open(FILE2_COMPARE_SCALE2) as image2_scale2_compare:
diff --git a/Tests/test_image_resample.py b/Tests/test_image_resample.py
index b4bf6c8df3a..5a578dba5c4 100644
--- a/Tests/test_image_resample.py
+++ b/Tests/test_image_resample.py
@@ -403,7 +403,7 @@ def test_reduce(self):
             if px[2, 0] != test_color // 2:
                 assert test_color // 2 == px[2, 0]
 
-    def test_nonzero_coefficients(self):
+    def test_non_zero_coefficients(self):
         # regression test for the wrong coefficients calculation
         # due to bug https://github.com/python-pillow/Pillow/issues/2161
         im = Image.new("RGBA", (1280, 1280), (0x20, 0x40, 0x60, 0xFF))
diff --git a/src/libImaging/GifEncode.c b/src/libImaging/GifEncode.c
index f232454052a..e37301df765 100644
--- a/src/libImaging/GifEncode.c
+++ b/src/libImaging/GifEncode.c
@@ -105,7 +105,7 @@ static int glzwe(GIFENCODERSTATE *st, const UINT8 *in_ptr, UINT8 *out_ptr,
                 st->head = st->codes[st->probe] >> 20;
                 goto encode_loop;
             } else {
-        /* Reprobe decrement must be nonzero and relatively prime to table
+        /* Reprobe decrement must be non-zero and relatively prime to table
          * size. So, any odd positive number for power-of-2 size. */
                 if ((st->probe -= ((st->tail << 2) | 1)) < 0) {
                     st->probe += TABLE_SIZE;
diff --git a/src/libImaging/Jpeg.h b/src/libImaging/Jpeg.h
index 98eaac28dd6..7cdba902281 100644
--- a/src/libImaging/Jpeg.h
+++ b/src/libImaging/Jpeg.h
@@ -74,7 +74,7 @@ typedef struct {
     /* Optimize Huffman tables (slow) */
     int optimize;
 
-    /* Disable automatic conversion of RGB images to YCbCr if nonzero */
+    /* Disable automatic conversion of RGB images to YCbCr if non-zero */
     int keep_rgb;
 
     /* Stream type (0=full, 1=tables only, 2=image only) */

From 0d841aab9a51a0b9433bc5932dcd913c028301cf Mon Sep 17 00:00:00 2001
From: Nulano <nulano@nulano.eu>
Date: Sat, 6 Jan 2024 13:37:43 +0100
Subject: [PATCH 0037/1178] add support for grayscale pfm image format

---
 Tests/images/hopper.pfm              | Bin 0 -> 65552 bytes
 Tests/images/hopper_be.pfm           | Bin 0 -> 65551 bytes
 Tests/test_file_ppm.py               |  45 ++++++++++++++++++++++++++-
 docs/handbook/image-file-formats.rst |  18 +++++++++++
 src/PIL/PpmImagePlugin.py            |  26 +++++++++++++---
 5 files changed, 84 insertions(+), 5 deletions(-)
 create mode 100644 Tests/images/hopper.pfm
 create mode 100644 Tests/images/hopper_be.pfm

diff --git a/Tests/images/hopper.pfm b/Tests/images/hopper.pfm
new file mode 100644
index 0000000000000000000000000000000000000000..b576615640136f3229ab5a3d29ab7956fd194dd0
GIT binary patch
literal 65552
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
L`NZ}X?0@thg2ah6

literal 0
HcmV?d00001

diff --git a/Tests/images/hopper_be.pfm b/Tests/images/hopper_be.pfm
new file mode 100644
index 0000000000000000000000000000000000000000..93c75e26fda2cd69362a58f61373b0d88075e51c
GIT binary patch
literal 65551
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

literal 0
HcmV?d00001

diff --git a/Tests/test_file_ppm.py b/Tests/test_file_ppm.py
index bb49a46d376..efdb880de07 100644
--- a/Tests/test_file_ppm.py
+++ b/Tests/test_file_ppm.py
@@ -6,7 +6,12 @@
 
 from PIL import Image, PpmImagePlugin
 
-from .helper import assert_image_equal_tofile, assert_image_similar, hopper
+from .helper import (
+    assert_image_equal,
+    assert_image_equal_tofile,
+    assert_image_similar,
+    hopper,
+)
 
 # sample ppm stream
 TEST_FILE = "Tests/images/hopper.ppm"
@@ -100,6 +105,44 @@ def test_pnm(tmp_path):
         assert_image_equal_tofile(im, f)
 
 
+def test_pfm(tmp_path):
+    with Image.open("Tests/images/hopper.pfm") as im:
+        assert im.info["scale"] == 1.0
+        assert_image_equal(im, hopper("F"))
+
+        f = str(tmp_path / "tmp.pfm")
+        im.save(f)
+
+        assert_image_equal_tofile(im, f)
+
+
+def test_pfm_big_endian(tmp_path):
+    with Image.open("Tests/images/hopper_be.pfm") as im:
+        assert im.info["scale"] == 2.5
+        assert_image_equal(im, hopper("F"))
+
+        f = str(tmp_path / "tmp.pfm")
+        im.save(f)
+
+        assert_image_equal_tofile(im, f)
+
+
+@pytest.mark.parametrize(
+    "data",
+    [
+        b"Pf 1 1 NaN \0\0\0\0",
+        b"Pf 1 1 inf \0\0\0\0",
+        b"Pf 1 1 -inf \0\0\0\0",
+        b"Pf 1 1 0.0 \0\0\0\0",
+        b"Pf 1 1 -0.0 \0\0\0\0",
+    ],
+)
+def test_pfm_invalid(data):
+    with pytest.raises(ValueError):
+        with Image.open(BytesIO(data)):
+            pass
+
+
 @pytest.mark.parametrize(
     "plain_path, raw_path",
     (
diff --git a/docs/handbook/image-file-formats.rst b/docs/handbook/image-file-formats.rst
index 276838bed1b..02a6a3af729 100644
--- a/docs/handbook/image-file-formats.rst
+++ b/docs/handbook/image-file-formats.rst
@@ -696,6 +696,24 @@ PCX
 
 Pillow reads and writes PCX files containing ``1``, ``L``, ``P``, or ``RGB`` data.
 
+PFM
+^^^
+
+.. versionadded:: 10.3.0
+
+Pillow reads and writes grayscale (Pf format) PFM files containing ``F`` data.
+
+Color (PF format) PFM files are not supported.
+
+Opening
+~~~~~~~
+
+The :py:func:`~PIL.Image.open` function sets the following
+:py:attr:`~PIL.Image.Image.info` properties:
+
+**scale**
+    The absolute value of the number stored in the *Scale Factor / Endianness* line.
+
 PNG
 ^^^
 
diff --git a/src/PIL/PpmImagePlugin.py b/src/PIL/PpmImagePlugin.py
index 25dbfa5b0bc..6be1278eb2e 100644
--- a/src/PIL/PpmImagePlugin.py
+++ b/src/PIL/PpmImagePlugin.py
@@ -15,6 +15,8 @@
 #
 from __future__ import annotations
 
+import math
+
 from . import Image, ImageFile
 from ._binary import i16be as i16
 from ._binary import o8
@@ -35,6 +37,7 @@
     b"P6": "RGB",
     # extensions
     b"P0CMYK": "CMYK",
+    b"Pf": "F",
     # PIL extensions (for test purposes only)
     b"PyP": "P",
     b"PyRGBA": "RGBA",
@@ -43,7 +46,7 @@
 
 
 def _accept(prefix):
-    return prefix[0:1] == b"P" and prefix[1] in b"0123456y"
+    return prefix[0:1] == b"P" and prefix[1] in b"0123456fy"
 
 
 ##
@@ -110,6 +113,14 @@ def _open(self):
         if magic_number in (b"P1", b"P2", b"P3"):
             decoder_name = "ppm_plain"
         for ix in range(3):
+            if mode == "F" and ix == 2:
+                scale = float(self._read_token())
+                if not math.isfinite(scale) or scale == 0.0:
+                    msg = "scale must be finite and non-zero"
+                    raise ValueError(msg)
+                rawmode = "F;32F" if scale < 0 else "F;32BF"
+                self.info["scale"] = abs(scale)
+                continue
             token = int(self._read_token())
             if ix == 0:  # token is the x size
                 xsize = token
@@ -136,7 +147,8 @@ def _open(self):
                     elif maxval != 255:
                         decoder_name = "ppm"
 
-        args = (rawmode, 0, 1) if decoder_name == "raw" else (rawmode, maxval)
+        row_order = -1 if mode == "F" else 1
+        args = (rawmode, 0, row_order) if decoder_name == "raw" else (rawmode, maxval)
         self._size = xsize, ysize
         self.tile = [(decoder_name, (0, 0, xsize, ysize), self.fp.tell(), args)]
 
@@ -307,6 +319,7 @@ def decode(self, buffer):
 
 
 def _save(im, fp, filename):
+    row_order = 1
     if im.mode == "1":
         rawmode, head = "1;I", b"P4"
     elif im.mode == "L":
@@ -315,6 +328,9 @@ def _save(im, fp, filename):
         rawmode, head = "I;16B", b"P5"
     elif im.mode in ("RGB", "RGBA"):
         rawmode, head = "RGB", b"P6"
+    elif im.mode == "F":
+        rawmode, head = "F;32F", b"Pf"
+        row_order = -1
     else:
         msg = f"cannot write mode {im.mode} as PPM"
         raise OSError(msg)
@@ -326,7 +342,9 @@ def _save(im, fp, filename):
             fp.write(b"255\n")
         else:
             fp.write(b"65535\n")
-    ImageFile._save(im, fp, [("raw", (0, 0) + im.size, 0, (rawmode, 0, 1))])
+    elif head == b"Pf":
+        fp.write(b"-1.0\n")
+    ImageFile._save(im, fp, [("raw", (0, 0) + im.size, 0, (rawmode, 0, row_order))])
 
 
 #
@@ -339,6 +357,6 @@ def _save(im, fp, filename):
 Image.register_decoder("ppm", PpmDecoder)
 Image.register_decoder("ppm_plain", PpmPlainDecoder)
 
-Image.register_extensions(PpmImageFile.format, [".pbm", ".pgm", ".ppm", ".pnm"])
+Image.register_extensions(PpmImageFile.format, [".pbm", ".pgm", ".ppm", ".pnm", ".pfm"])
 
 Image.register_mime(PpmImageFile.format, "image/x-portable-anymap")

From d9ec2fd4bb4acb049d27cf0a66bd663bdb66274a Mon Sep 17 00:00:00 2001
From: =?UTF-8?q?Ondrej=20Baranovi=C4=8D?= <nulano@nulano.eu>
Date: Sat, 6 Jan 2024 14:33:11 +0100
Subject: [PATCH 0038/1178] Add code formatting to ImageCms.Flags docstrings

Co-authored-by: Hugo van Kemenade <1324225+hugovk@users.noreply.github.com>
---
 src/PIL/ImageCms.py | 4 ++--
 1 file changed, 2 insertions(+), 2 deletions(-)

diff --git a/src/PIL/ImageCms.py b/src/PIL/ImageCms.py
index 9a7afe81f2b..62b010f4512 100644
--- a/src/PIL/ImageCms.py
+++ b/src/PIL/ImageCms.py
@@ -147,7 +147,7 @@ class Flags(IntFlag):
     USE_8BITS_DEVICELINK = 0x0008
     """Create 8 bits devicelinks"""
     GUESSDEVICECLASS = 0x0020
-    """Guess device class (for transform2devicelink)"""
+    """Guess device class (for ``transform2devicelink``)"""
     KEEP_SEQUENCE = 0x0080
     """Keep profile sequence for devicelink creation"""
     FORCE_CLUT = 0x0002
@@ -159,7 +159,7 @@ class Flags(IntFlag):
     NONEGATIVES = 0x8000
     """Prevent negative numbers in floating point transforms"""
     COPY_ALPHA = 0x04000000
-    """Alpha channels are copied on cmsDoTransform()"""
+    """Alpha channels are copied on ``cmsDoTransform()``"""
     NODEFAULTRESOURCEDEF = 0x01000000
 
     _GRIDPOINTS_1 = 1 << 16

From a786a0551b75ab3e85da1bfad54226faa2336022 Mon Sep 17 00:00:00 2001
From: Andrew Murray <radarhere@users.noreply.github.com>
Date: Sun, 7 Jan 2024 16:17:57 +1100
Subject: [PATCH 0039/1178] Update CHANGES.rst [ci skip]

---
 CHANGES.rst | 3 +++
 1 file changed, 3 insertions(+)

diff --git a/CHANGES.rst b/CHANGES.rst
index ac961a680a3..ebf731c5659 100644
--- a/CHANGES.rst
+++ b/CHANGES.rst
@@ -5,6 +5,9 @@ Changelog (Pillow)
 10.3.0 (unreleased)
 -------------------
 
+- Add LCMS2 flags to ImageCms #7676
+  [nulano, radarhere, hugovk]
+
 - Rename x64 to AMD64 in winbuild #7693
   [nulano]
 

From bb5527484536f6c8e90ffffd95906c352fecca18 Mon Sep 17 00:00:00 2001
From: Andrew Murray <radarhere@users.noreply.github.com>
Date: Sun, 7 Jan 2024 18:49:01 +1100
Subject: [PATCH 0040/1178] Removed PPM loop to read header tokens

---
 src/PIL/PpmImagePlugin.py | 53 ++++++++++++++++-----------------------
 1 file changed, 22 insertions(+), 31 deletions(-)

diff --git a/src/PIL/PpmImagePlugin.py b/src/PIL/PpmImagePlugin.py
index 25dbfa5b0bc..82314214a7f 100644
--- a/src/PIL/PpmImagePlugin.py
+++ b/src/PIL/PpmImagePlugin.py
@@ -105,40 +105,31 @@ def _open(self):
         elif magic_number in (b"P3", b"P6"):
             self.custom_mimetype = "image/x-portable-pixmap"
 
-        maxval = None
+        self._size = int(self._read_token()), int(self._read_token())
+
         decoder_name = "raw"
         if magic_number in (b"P1", b"P2", b"P3"):
             decoder_name = "ppm_plain"
-        for ix in range(3):
-            token = int(self._read_token())
-            if ix == 0:  # token is the x size
-                xsize = token
-            elif ix == 1:  # token is the y size
-                ysize = token
-                if mode == "1":
-                    self._mode = "1"
-                    rawmode = "1;I"
-                    break
-                else:
-                    self._mode = rawmode = mode
-            elif ix == 2:  # token is maxval
-                maxval = token
-                if not 0 < maxval < 65536:
-                    msg = "maxval must be greater than 0 and less than 65536"
-                    raise ValueError(msg)
-                if maxval > 255 and mode == "L":
-                    self._mode = "I"
-
-                if decoder_name != "ppm_plain":
-                    # If maxval matches a bit depth, use the raw decoder directly
-                    if maxval == 65535 and mode == "L":
-                        rawmode = "I;16B"
-                    elif maxval != 255:
-                        decoder_name = "ppm"
-
-        args = (rawmode, 0, 1) if decoder_name == "raw" else (rawmode, maxval)
-        self._size = xsize, ysize
-        self.tile = [(decoder_name, (0, 0, xsize, ysize), self.fp.tell(), args)]
+        if mode == "1":
+            self._mode = "1"
+            args = "1;I"
+        else:
+            maxval = int(self._read_token())
+            if not 0 < maxval < 65536:
+                msg = "maxval must be greater than 0 and less than 65536"
+                raise ValueError(msg)
+            self._mode = "I" if maxval > 255 and mode == "L" else mode
+
+            rawmode = mode
+            if decoder_name != "ppm_plain":
+                # If maxval matches a bit depth, use the raw decoder directly
+                if maxval == 65535 and mode == "L":
+                    rawmode = "I;16B"
+                elif maxval != 255:
+                    decoder_name = "ppm"
+
+            args = (rawmode, 0, 1) if decoder_name == "raw" else (rawmode, maxval)
+        self.tile = [(decoder_name, (0, 0) + self.size, self.fp.tell(), args)]
 
 
 #

From ba6399cad14d816cafc44c25782d6a3153082ae4 Mon Sep 17 00:00:00 2001
From: Andrew Murray <radarhere@users.noreply.github.com>
Date: Sun, 7 Jan 2024 19:34:27 +1100
Subject: [PATCH 0041/1178] Added PerspectiveTransform

---
 Tests/test_image_transform.py     |  2 ++
 docs/reference/ImageTransform.rst |  5 +++++
 src/PIL/ImageTransform.py         | 20 ++++++++++++++++++++
 3 files changed, 27 insertions(+)

diff --git a/Tests/test_image_transform.py b/Tests/test_image_transform.py
index 15939ef647c..578a0a2967a 100644
--- a/Tests/test_image_transform.py
+++ b/Tests/test_image_transform.py
@@ -16,6 +16,8 @@ def test_sanity(self):
 
         transform = ImageTransform.AffineTransform(seq[:6])
         im.transform((100, 100), transform)
+        transform = ImageTransform.PerspectiveTransform(seq[:8])
+        im.transform((100, 100), transform)
         transform = ImageTransform.ExtentTransform(seq[:4])
         im.transform((100, 100), transform)
         transform = ImageTransform.QuadTransform(seq[:8])
diff --git a/docs/reference/ImageTransform.rst b/docs/reference/ImageTransform.rst
index 1278801821d..5b0a5ce49dc 100644
--- a/docs/reference/ImageTransform.rst
+++ b/docs/reference/ImageTransform.rst
@@ -19,6 +19,11 @@ The :py:mod:`~PIL.ImageTransform` module contains implementations of
     :undoc-members:
     :show-inheritance:
 
+.. autoclass:: PerspectiveTransform
+    :members:
+    :undoc-members:
+    :show-inheritance:
+
 .. autoclass:: ExtentTransform
     :members:
     :undoc-members:
diff --git a/src/PIL/ImageTransform.py b/src/PIL/ImageTransform.py
index 4f79500e64e..6aa82dadd9c 100644
--- a/src/PIL/ImageTransform.py
+++ b/src/PIL/ImageTransform.py
@@ -63,6 +63,26 @@ class AffineTransform(Transform):
     method = Image.Transform.AFFINE
 
 
+class PerspectiveTransform(Transform):
+    """
+    Define a perspective image transform.
+
+    This function takes an 8-tuple (a, b, c, d, e, f, g, h). For each pixel
+    (x, y) in the output image, the new value is taken from a position
+    ((a x + b y + c) / (g x + h y + 1), (d x + e y + f) / (g x + h y + 1)) in
+    the input image, rounded to nearest pixel.
+
+    This function can be used to scale, translate, rotate, and shear the
+    original image.
+
+    See :py:meth:`.Image.transform`
+
+    :param matrix: An 8-tuple (a, b, c, d, e, f, g, h).
+    """
+
+    method = Image.Transform.PERSPECTIVE
+
+
 class ExtentTransform(Transform):
     """
     Define a transform to extract a subregion from an image.

From 6d99f9193f0abe211e611f2d9909a4eb5881d270 Mon Sep 17 00:00:00 2001
From: Erik Soma <stillusingirc@gmail.com>
Date: Sun, 7 Jan 2024 16:00:58 -0500
Subject: [PATCH 0042/1178] Fix info for first frame of apng images getting
 clobbered when seeking to the first frame multiple times.

---
 src/PIL/PngImagePlugin.py | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/src/PIL/PngImagePlugin.py b/src/PIL/PngImagePlugin.py
index e4ed9388011..823f1249285 100644
--- a/src/PIL/PngImagePlugin.py
+++ b/src/PIL/PngImagePlugin.py
@@ -378,7 +378,7 @@ def save_rewind(self):
         }
 
     def rewind(self):
-        self.im_info = self.rewind_state["info"]
+        self.im_info = self.rewind_state["info"].copy()
         self.im_tile = self.rewind_state["tile"]
         self._seq_num = self.rewind_state["seq_num"]
 

From 08f11c57a131b402f405db76dfd411b441df1ab5 Mon Sep 17 00:00:00 2001
From: Nulano <nulano@nulano.eu>
Date: Mon, 1 Jan 2024 20:52:47 +0100
Subject: [PATCH 0043/1178] deprecate ImageCms members: DESCRIPTION, VERSION,
 FLAGS, versions()

---
 Tests/test_imagecms.py | 13 +++++++++++--
 src/PIL/ImageCms.py    | 30 ++++++++++++++++++++++++++----
 2 files changed, 37 insertions(+), 6 deletions(-)

diff --git a/Tests/test_imagecms.py b/Tests/test_imagecms.py
index fec482f4393..9575b026db2 100644
--- a/Tests/test_imagecms.py
+++ b/Tests/test_imagecms.py
@@ -49,8 +49,8 @@ def skip_missing():
 def test_sanity():
     # basic smoke test.
     # this mostly follows the cms_test outline.
-
-    v = ImageCms.versions()  # should return four strings
+    with pytest.warns(DeprecationWarning):
+        v = ImageCms.versions()  # should return four strings
     assert v[0] == "1.0.0 pil"
     assert list(map(type, v)) == [str, str, str, str]
 
@@ -637,3 +637,12 @@ def test_rgb_lab(mode):
     im = Image.new("LAB", (1, 1), (255, 0, 0))
     converted_im = im.convert(mode)
     assert converted_im.getpixel((0, 0))[:3] == (0, 255, 255)
+
+
+def test_deprecation():
+    with pytest.warns(DeprecationWarning):
+        assert ImageCms.DESCRIPTION.strip().startswith("pyCMS")
+    with pytest.warns(DeprecationWarning):
+        assert ImageCms.VERSION == "1.0.0 pil"
+    with pytest.warns(DeprecationWarning):
+        assert isinstance(ImageCms.FLAGS, dict)
diff --git a/src/PIL/ImageCms.py b/src/PIL/ImageCms.py
index 62b010f4512..827755bf672 100644
--- a/src/PIL/ImageCms.py
+++ b/src/PIL/ImageCms.py
@@ -20,8 +20,10 @@
 import sys
 from enum import IntEnum, IntFlag
 from functools import reduce
+from typing import Any
 
 from . import Image
+from ._deprecate import deprecate
 
 try:
     from . import _imagingcms
@@ -32,7 +34,7 @@
 
     _imagingcms = DeferredError.new(ex)
 
-DESCRIPTION = """
+_DESCRIPTION = """
 pyCMS
 
     a Python / PIL interface to the littleCMS ICC Color Management System
@@ -95,7 +97,22 @@
 
 """
 
-VERSION = "1.0.0 pil"
+_VERSION = "1.0.0 pil"
+
+
+def __getattr__(name: str) -> Any:
+    if name == "DESCRIPTION":
+        deprecate("PIL.ImageCms.DESCRIPTION", 12)
+        return _DESCRIPTION
+    elif name == "VERSION":
+        deprecate("PIL.ImageCms.VERSION", 12)
+        return _VERSION
+    elif name == "FLAGS":
+        deprecate("PIL.ImageCms.FLAGS", 12, "PIL.ImageCms.Flags")
+        return _FLAGS
+    msg = f"module '{__name__}' has no attribute '{name}'"
+    raise AttributeError(msg)
+
 
 # --------------------------------------------------------------------.
 
@@ -184,7 +201,7 @@ def GRIDPOINTS(n: int) -> Flags:
 _MAX_FLAG = reduce(operator.or_, Flags)
 
 
-FLAGS = {
+_FLAGS = {
     "MATRIXINPUT": 1,
     "MATRIXOUTPUT": 2,
     "MATRIXONLY": (1 | 2),
@@ -1064,4 +1081,9 @@ def versions():
     (pyCMS) Fetches versions.
     """
 
-    return VERSION, core.littlecms_version, sys.version.split()[0], Image.__version__
+    deprecate(
+        "PIL.ImageCms.versions()",
+        12,
+        '(PIL.features.version("littlecms2"), sys.version, PIL.__version__)',
+    )
+    return _VERSION, core.littlecms_version, sys.version.split()[0], Image.__version__

From ccdea48cf379fac585918001f304a7ab58448b96 Mon Sep 17 00:00:00 2001
From: Andrew Murray <radarhere@users.noreply.github.com>
Date: Mon, 8 Jan 2024 10:36:30 +1100
Subject: [PATCH 0044/1178] Added identity tests for Transform classes

---
 Tests/test_image_transform.py | 33 +++++++++++++++++++--------------
 1 file changed, 19 insertions(+), 14 deletions(-)

diff --git a/Tests/test_image_transform.py b/Tests/test_image_transform.py
index 578a0a2967a..f5d5ab70408 100644
--- a/Tests/test_image_transform.py
+++ b/Tests/test_image_transform.py
@@ -10,20 +10,25 @@
 
 class TestImageTransform:
     def test_sanity(self):
-        im = Image.new("L", (100, 100))
-
-        seq = tuple(range(10))
-
-        transform = ImageTransform.AffineTransform(seq[:6])
-        im.transform((100, 100), transform)
-        transform = ImageTransform.PerspectiveTransform(seq[:8])
-        im.transform((100, 100), transform)
-        transform = ImageTransform.ExtentTransform(seq[:4])
-        im.transform((100, 100), transform)
-        transform = ImageTransform.QuadTransform(seq[:8])
-        im.transform((100, 100), transform)
-        transform = ImageTransform.MeshTransform([(seq[:4], seq[:8])])
-        im.transform((100, 100), transform)
+        im = hopper()
+
+        for transform in (
+            ImageTransform.AffineTransform((1, 0, 0, 0, 1, 0)),
+            ImageTransform.PerspectiveTransform((1, 0, 0, 0, 1, 0, 0, 0)),
+            ImageTransform.ExtentTransform((0, 0) + im.size),
+            ImageTransform.QuadTransform(
+                (0, 0, 0, im.height, im.width, im.height, im.width, 0)
+            ),
+            ImageTransform.MeshTransform(
+                [
+                    (
+                        (0, 0) + im.size,
+                        (0, 0, 0, im.height, im.width, im.height, im.width, 0),
+                    )
+                ]
+            ),
+        ):
+            assert_image_equal(im, im.transform(im.size, transform))
 
     def test_info(self):
         comment = b"File written by Adobe Photoshop\xa8 4.0"

From edc46e223b1275f9b197c33011f305af2975afe3 Mon Sep 17 00:00:00 2001
From: Nulano <nulano@nulano.eu>
Date: Mon, 8 Jan 2024 01:27:41 +0100
Subject: [PATCH 0045/1178] document ImageCms deprecations

---
 docs/deprecations.rst        | 39 ++++++++++++++++-
 docs/reference/ImageCms.rst  |  3 ++
 docs/releasenotes/10.3.0.rst | 83 ++++++++++++++++++++++++++++++++++++
 docs/releasenotes/9.1.0.rst  |  2 +-
 docs/releasenotes/index.rst  |  1 +
 5 files changed, 126 insertions(+), 2 deletions(-)
 create mode 100644 docs/releasenotes/10.3.0.rst

diff --git a/docs/deprecations.rst b/docs/deprecations.rst
index 0f9c75756ee..7602f8b4e80 100644
--- a/docs/deprecations.rst
+++ b/docs/deprecations.rst
@@ -55,6 +55,43 @@ The functions ``IptcImageFile.dump`` and ``IptcImageFile.i``, and the constant
 for internal use, so there is no replacement. They can each be replaced
 by a single line of code using builtin functions in Python.
 
+ImageCms constants and versions() function
+~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
+
+.. deprecated:: 10.3.0
+
+A number of constants and a function in :py:mod:`.ImageCms` have been deprecated.
+This includes a table of flags based on LittleCMS version 1 which has been
+replaced with a new class :py:class:`.ImageCms.Flags` based on LittleCMS 2 flags.
+
+=====================================================  ============================================================
+Deprecated                                             Use instead
+=====================================================  ============================================================
+``ImageCms.DESCRIPTION``
+``ImageCms.VERSION``                                   ``PIL.__version__``
+``ImageCms.FLAGS["MATRIXINPUT"]``                      :py:attr:`.ImageCms.Flags.CLUT_POST_LINEARIZATION`
+``ImageCms.FLAGS["MATRIXOUTPUT"]``                     :py:attr:`.ImageCms.Flags.FORCE_CLUT`
+``ImageCms.FLAGS["MATRIXONLY"]``
+``ImageCms.FLAGS["NOWHITEONWHITEFIXUP"]``              :py:attr:`.ImageCms.Flags.NOWHITEONWHITEFIXUP`
+``ImageCms.FLAGS["NOPRELINEARIZATION"]``               :py:attr:`.ImageCms.Flags.CLUT_PRE_LINEARIZATION`
+``ImageCms.FLAGS["GUESSDEVICECLASS"]``                 :py:attr:`.ImageCms.Flags.GUESSDEVICECLASS`
+``ImageCms.FLAGS["NOTCACHE"]``                         :py:attr:`.ImageCms.Flags.NOCACHE`
+``ImageCms.FLAGS["NOTPRECALC"]``                       :py:attr:`.ImageCms.Flags.NOOPTIMIZE`
+``ImageCms.FLAGS["NULLTRANSFORM"]``                    :py:attr:`.ImageCms.Flags.NULLTRANSFORM`
+``ImageCms.FLAGS["HIGHRESPRECALC"]``                   :py:attr:`.ImageCms.Flags.HIGHRESPRECALC`
+``ImageCms.FLAGS["LOWRESPRECALC"]``                    :py:attr:`.ImageCms.Flags.LOWRESPRECALC`
+``ImageCms.FLAGS["GAMUTCHECK"]``                       :py:attr:`.ImageCms.Flags.GAMUTCHECK`
+``ImageCms.FLAGS["WHITEBLACKCOMPENSATION"]``           :py:attr:`.ImageCms.Flags.BLACKPOINTCOMPENSATION`
+``ImageCms.FLAGS["BLACKPOINTCOMPENSATION"]``           :py:attr:`.ImageCms.Flags.BLACKPOINTCOMPENSATION`
+``ImageCms.FLAGS["SOFTPROOFING"]``                     :py:attr:`.ImageCms.Flags.SOFTPROOFING`
+``ImageCms.FLAGS["PRESERVEBLACK"]``                    :py:attr:`.ImageCms.Flags.NONEGATIVES`
+``ImageCms.FLAGS["NODEFAULTRESOURCEDEF"]``             :py:attr:`.ImageCms.Flags.NODEFAULTRESOURCEDEF`
+``ImageCms.FLAGS["GRIDPOINTS"]``                       :py:attr:`.ImageCms.Flags.GRIDPOINTS()`
+``ImageCms.versions()``                                :py:func:`PIL.features.version_module` with
+                                                       ``feature="littlecms2"``, :py:data:`sys.version` or
+                                                       :py:data:`sys.version_info`, and ``PIL.__version__``
+=====================================================  ============================================================
+
 Removed features
 ----------------
 
@@ -118,7 +155,7 @@ Constants
 .. versionremoved:: 10.0.0
 
 A number of constants have been removed.
-Instead, ``enum.IntEnum`` classes have been added.
+Instead, :py:class:`enum.IntEnum` classes have been added.
 
 .. note::
 
diff --git a/docs/reference/ImageCms.rst b/docs/reference/ImageCms.rst
index 22ed516ce58..c4484cbe22a 100644
--- a/docs/reference/ImageCms.rst
+++ b/docs/reference/ImageCms.rst
@@ -24,14 +24,17 @@ Constants
     :members:
     :member-order: bysource
     :undoc-members:
+    :show-inheritance:
 .. autoclass:: Direction
     :members:
     :member-order: bysource
     :undoc-members:
+    :show-inheritance:
 .. autoclass:: Flags
     :members:
     :member-order: bysource
     :undoc-members:
+    :show-inheritance:
 
 Functions
 ---------
diff --git a/docs/releasenotes/10.3.0.rst b/docs/releasenotes/10.3.0.rst
new file mode 100644
index 00000000000..ddcb38aa161
--- /dev/null
+++ b/docs/releasenotes/10.3.0.rst
@@ -0,0 +1,83 @@
+10.3.0
+------
+
+Backwards Incompatible Changes
+==============================
+
+TODO
+^^^^
+
+Deprecations
+============
+
+ImageCms constants and versions() function
+^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
+
+A number of constants and a function in :py:mod:`.ImageCms` have been deprecated.
+This includes a table of flags based on LittleCMS version 1 which has been replaced
+with a new class :py:class:`.ImageCms.Flags` based on LittleCMS 2 flags.
+
+=====================================================  ============================================================
+Deprecated                                             Use instead
+=====================================================  ============================================================
+``ImageCms.DESCRIPTION``
+``ImageCms.VERSION``                                   ``PIL.__version__``
+``ImageCms.FLAGS["MATRIXINPUT"]``                      :py:attr:`.ImageCms.Flags.CLUT_POST_LINEARIZATION`
+``ImageCms.FLAGS["MATRIXOUTPUT"]``                     :py:attr:`.ImageCms.Flags.FORCE_CLUT`
+``ImageCms.FLAGS["MATRIXONLY"]``
+``ImageCms.FLAGS["NOWHITEONWHITEFIXUP"]``              :py:attr:`.ImageCms.Flags.NOWHITEONWHITEFIXUP`
+``ImageCms.FLAGS["NOPRELINEARIZATION"]``               :py:attr:`.ImageCms.Flags.CLUT_PRE_LINEARIZATION`
+``ImageCms.FLAGS["GUESSDEVICECLASS"]``                 :py:attr:`.ImageCms.Flags.GUESSDEVICECLASS`
+``ImageCms.FLAGS["NOTCACHE"]``                         :py:attr:`.ImageCms.Flags.NOCACHE`
+``ImageCms.FLAGS["NOTPRECALC"]``                       :py:attr:`.ImageCms.Flags.NOOPTIMIZE`
+``ImageCms.FLAGS["NULLTRANSFORM"]``                    :py:attr:`.ImageCms.Flags.NULLTRANSFORM`
+``ImageCms.FLAGS["HIGHRESPRECALC"]``                   :py:attr:`.ImageCms.Flags.HIGHRESPRECALC`
+``ImageCms.FLAGS["LOWRESPRECALC"]``                    :py:attr:`.ImageCms.Flags.LOWRESPRECALC`
+``ImageCms.FLAGS["GAMUTCHECK"]``                       :py:attr:`.ImageCms.Flags.GAMUTCHECK`
+``ImageCms.FLAGS["WHITEBLACKCOMPENSATION"]``           :py:attr:`.ImageCms.Flags.BLACKPOINTCOMPENSATION`
+``ImageCms.FLAGS["BLACKPOINTCOMPENSATION"]``           :py:attr:`.ImageCms.Flags.BLACKPOINTCOMPENSATION`
+``ImageCms.FLAGS["SOFTPROOFING"]``                     :py:attr:`.ImageCms.Flags.SOFTPROOFING`
+``ImageCms.FLAGS["PRESERVEBLACK"]``                    :py:attr:`.ImageCms.Flags.NONEGATIVES`
+``ImageCms.FLAGS["NODEFAULTRESOURCEDEF"]``             :py:attr:`.ImageCms.Flags.NODEFAULTRESOURCEDEF`
+``ImageCms.FLAGS["GRIDPOINTS"]``                       :py:attr:`.ImageCms.Flags.GRIDPOINTS()`
+``ImageCms.versions()``                                :py:func:`PIL.features.version_module` with
+                                                       ``feature="littlecms2"``, :py:data:`sys.version` or
+                                                       :py:data:`sys.version_info`, and ``PIL.__version__``
+=====================================================  ============================================================
+
+TODO
+^^^^
+
+TODO
+
+API Changes
+===========
+
+TODO
+^^^^
+
+TODO
+
+API Additions
+=============
+
+TODO
+^^^^
+
+TODO
+
+Security
+========
+
+TODO
+^^^^
+
+TODO
+
+Other Changes
+=============
+
+TODO
+^^^^
+
+TODO
diff --git a/docs/releasenotes/9.1.0.rst b/docs/releasenotes/9.1.0.rst
index 02da702a799..6400218f467 100644
--- a/docs/releasenotes/9.1.0.rst
+++ b/docs/releasenotes/9.1.0.rst
@@ -51,7 +51,7 @@ Constants
 ^^^^^^^^^
 
 A number of constants have been deprecated and will be removed in Pillow 10.0.0
-(2023-07-01). Instead, ``enum.IntEnum`` classes have been added.
+(2023-07-01). Instead, :py:class:`enum.IntEnum` classes have been added.
 
 .. note::
 
diff --git a/docs/releasenotes/index.rst b/docs/releasenotes/index.rst
index d8034853cc2..e86f8082b48 100644
--- a/docs/releasenotes/index.rst
+++ b/docs/releasenotes/index.rst
@@ -14,6 +14,7 @@ expected to be backported to earlier versions.
 .. toctree::
   :maxdepth: 2
 
+  10.3.0
   10.2.0
   10.1.0
   10.0.1

From bb855583ea3320b637e7f6511721a9e2655f2b99 Mon Sep 17 00:00:00 2001
From: Nulano <nulano@nulano.eu>
Date: Mon, 8 Jan 2024 01:55:32 +0100
Subject: [PATCH 0046/1178] Update PyPI links to use pillow (lowercase)

---
 README.md             | 4 ++--
 docs/about.rst        | 2 +-
 docs/index.rst        | 4 ++--
 docs/installation.rst | 6 +++---
 4 files changed, 8 insertions(+), 8 deletions(-)

diff --git a/README.md b/README.md
index 6982676f518..6ca870166a1 100644
--- a/README.md
+++ b/README.md
@@ -65,10 +65,10 @@ As of 2019, Pillow development is
             <a href="https://tidelift.com/subscription/pkg/pypi-pillow?utm_source=pypi-pillow&utm_medium=badge"><img
                 alt="Tidelift"
                 src="https://tidelift.com/badges/package/pypi/Pillow?style=flat"></a>
-            <a href="https://pypi.org/project/Pillow/"><img
+            <a href="https://pypi.org/project/pillow/"><img
                 alt="Newest PyPI version"
                 src="https://img.shields.io/pypi/v/pillow.svg"></a>
-            <a href="https://pypi.org/project/Pillow/"><img
+            <a href="https://pypi.org/project/pillow/"><img
                 alt="Number of PyPI downloads"
                 src="https://img.shields.io/pypi/dm/pillow.svg"></a>
             <a href="https://www.bestpractices.dev/projects/6331"><img
diff --git a/docs/about.rst b/docs/about.rst
index da351ce2c56..cdb32ca5d10 100644
--- a/docs/about.rst
+++ b/docs/about.rst
@@ -13,7 +13,7 @@ The fork author's goal is to foster and support active development of PIL throug
 .. _GitHub Actions: https://github.com/python-pillow/Pillow/actions
 .. _AppVeyor: https://ci.appveyor.com/project/Python-pillow/pillow
 .. _GitHub: https://github.com/python-pillow/Pillow
-.. _Python Package Index: https://pypi.org/project/Pillow/
+.. _Python Package Index: https://pypi.org/project/pillow/
 
 License
 -------
diff --git a/docs/index.rst b/docs/index.rst
index 053d55c3c39..5583699193c 100644
--- a/docs/index.rst
+++ b/docs/index.rst
@@ -58,11 +58,11 @@ Pillow for enterprise is available via the Tidelift Subscription. `Learn more <h
    :alt: Fuzzing Status
 
 .. image:: https://img.shields.io/pypi/v/pillow.svg
-   :target: https://pypi.org/project/Pillow/
+   :target: https://pypi.org/project/pillow/
    :alt: Latest PyPI version
 
 .. image:: https://img.shields.io/pypi/dm/pillow.svg
-   :target: https://pypi.org/project/Pillow/
+   :target: https://pypi.org/project/pillow/
    :alt: Number of PyPI downloads
 
 .. image:: https://www.bestpractices.dev/projects/6331/badge
diff --git a/docs/installation.rst b/docs/installation.rst
index 922720b9d05..116bdcf2fb1 100644
--- a/docs/installation.rst
+++ b/docs/installation.rst
@@ -385,7 +385,7 @@ After navigating to the Pillow directory, run::
     python3 -m pip install --upgrade pip
     python3 -m pip install .
 
-.. _compressed archive from PyPI: https://pypi.org/project/Pillow/#files
+.. _compressed archive from PyPI: https://pypi.org/project/pillow/#files
 
 Build Options
 """""""""""""
@@ -602,5 +602,5 @@ Old Versions
 ------------
 
 You can download old distributions from the `release history at PyPI
-<https://pypi.org/project/Pillow/#history>`_ and by direct URL access
-eg. https://pypi.org/project/Pillow/1.0/.
+<https://pypi.org/project/pillow/#history>`_ and by direct URL access
+eg. https://pypi.org/project/pillow/1.0/.

From 3515f997ce06664d8ec42cc21e39eef9897dbaeb Mon Sep 17 00:00:00 2001
From: Erik Soma <stillusingirc@gmail.com>
Date: Sun, 7 Jan 2024 20:42:52 -0500
Subject: [PATCH 0047/1178] Add test against info of apng images getting
 clobbered when seeking to the first frame multiple times.

---
 Tests/images/apng/issue_7700.png | Bin 0 -> 233 bytes
 Tests/test_file_apng.py          |  10 ++++++++++
 2 files changed, 10 insertions(+)
 create mode 100644 Tests/images/apng/issue_7700.png

diff --git a/Tests/images/apng/issue_7700.png b/Tests/images/apng/issue_7700.png
new file mode 100644
index 0000000000000000000000000000000000000000..984254b8e5632f9f1bf148485a77bb6a141dcb4b
GIT binary patch
literal 233
zcmeAS@N?(olHy`uVBq!ia0vp^0wB!61|;P_|4#%`9Er&xK0ulYh#5ZjPA&jaQfUw|
zkPuh{hyel)U@p%GyA42&x~Gd{NX4Aw6SvYo%ojStp!80BRioiiwh7HElNnUodZY}p
z4j33RFfd-v>sQUc#0b;^GZ@51GuQzr6w`P67?6@pOK}VV(o8_Z4dze!4m2ES)C$JM
dY&_!34DTjb$p7CmBOj=M!PC{xWt~$(698zJHUj_v

literal 0
HcmV?d00001

diff --git a/Tests/test_file_apng.py b/Tests/test_file_apng.py
index 60d951636e8..8069d4b08bb 100644
--- a/Tests/test_file_apng.py
+++ b/Tests/test_file_apng.py
@@ -689,3 +689,13 @@ def test_different_modes_in_later_frames(mode, default_image, duplicate, tmp_pat
     )
     with Image.open(test_file) as reloaded:
         assert reloaded.mode == mode
+
+
+def test_apng_issue_7700():
+    # https://github.com/python-pillow/Pillow/issues/7700
+    with Image.open("Tests/images/apng/issue_7700.png") as im:
+        for i in range(5):
+            im.seek(0)
+            assert im.info["duration"] == 4000.0
+            im.seek(1)
+            assert im.info["duration"] == 1000.0

From bddfebc3315d85bf822192c57a33646d79e738c3 Mon Sep 17 00:00:00 2001
From: Nulano <nulano@nulano.eu>
Date: Mon, 8 Jan 2024 12:57:23 +0100
Subject: [PATCH 0048/1178] add license comment to ImageCms; explicitly say "no
 replacement" for deprecations without a replacement

---
 docs/deprecations.rst        | 4 ++--
 docs/releasenotes/10.3.0.rst | 4 ++--
 src/PIL/ImageCms.py          | 3 +++
 3 files changed, 7 insertions(+), 4 deletions(-)

diff --git a/docs/deprecations.rst b/docs/deprecations.rst
index 7602f8b4e80..4c9abe19503 100644
--- a/docs/deprecations.rst
+++ b/docs/deprecations.rst
@@ -67,11 +67,11 @@ replaced with a new class :py:class:`.ImageCms.Flags` based on LittleCMS 2 flags
 =====================================================  ============================================================
 Deprecated                                             Use instead
 =====================================================  ============================================================
-``ImageCms.DESCRIPTION``
+``ImageCms.DESCRIPTION``                               No replacement
 ``ImageCms.VERSION``                                   ``PIL.__version__``
 ``ImageCms.FLAGS["MATRIXINPUT"]``                      :py:attr:`.ImageCms.Flags.CLUT_POST_LINEARIZATION`
 ``ImageCms.FLAGS["MATRIXOUTPUT"]``                     :py:attr:`.ImageCms.Flags.FORCE_CLUT`
-``ImageCms.FLAGS["MATRIXONLY"]``
+``ImageCms.FLAGS["MATRIXONLY"]``                       No replacement
 ``ImageCms.FLAGS["NOWHITEONWHITEFIXUP"]``              :py:attr:`.ImageCms.Flags.NOWHITEONWHITEFIXUP`
 ``ImageCms.FLAGS["NOPRELINEARIZATION"]``               :py:attr:`.ImageCms.Flags.CLUT_PRE_LINEARIZATION`
 ``ImageCms.FLAGS["GUESSDEVICECLASS"]``                 :py:attr:`.ImageCms.Flags.GUESSDEVICECLASS`
diff --git a/docs/releasenotes/10.3.0.rst b/docs/releasenotes/10.3.0.rst
index ddcb38aa161..8dfe34d95fa 100644
--- a/docs/releasenotes/10.3.0.rst
+++ b/docs/releasenotes/10.3.0.rst
@@ -20,11 +20,11 @@ with a new class :py:class:`.ImageCms.Flags` based on LittleCMS 2 flags.
 =====================================================  ============================================================
 Deprecated                                             Use instead
 =====================================================  ============================================================
-``ImageCms.DESCRIPTION``
+``ImageCms.DESCRIPTION``                               No replacement
 ``ImageCms.VERSION``                                   ``PIL.__version__``
 ``ImageCms.FLAGS["MATRIXINPUT"]``                      :py:attr:`.ImageCms.Flags.CLUT_POST_LINEARIZATION`
 ``ImageCms.FLAGS["MATRIXOUTPUT"]``                     :py:attr:`.ImageCms.Flags.FORCE_CLUT`
-``ImageCms.FLAGS["MATRIXONLY"]``
+``ImageCms.FLAGS["MATRIXONLY"]``                       No replacement
 ``ImageCms.FLAGS["NOWHITEONWHITEFIXUP"]``              :py:attr:`.ImageCms.Flags.NOWHITEONWHITEFIXUP`
 ``ImageCms.FLAGS["NOPRELINEARIZATION"]``               :py:attr:`.ImageCms.Flags.CLUT_PRE_LINEARIZATION`
 ``ImageCms.FLAGS["GUESSDEVICECLASS"]``                 :py:attr:`.ImageCms.Flags.GUESSDEVICECLASS`
diff --git a/src/PIL/ImageCms.py b/src/PIL/ImageCms.py
index 827755bf672..3e40105e46a 100644
--- a/src/PIL/ImageCms.py
+++ b/src/PIL/ImageCms.py
@@ -4,6 +4,9 @@
 # Optional color management support, based on Kevin Cazabon's PyCMS
 # library.
 
+# Originally released under LGPL.  Graciously donated to PIL in
+# March 2009, for distribution under the standard PIL license
+
 # History:
 
 # 2009-03-08 fl   Added to PIL.

From f044d53fd181446366ab78f570076a665933d4b7 Mon Sep 17 00:00:00 2001
From: =?UTF-8?q?Ondrej=20Baranovi=C4=8D?= <nulano@nulano.eu>
Date: Mon, 8 Jan 2024 17:17:17 +0100
Subject: [PATCH 0049/1178] swap conditions

Co-authored-by: Hugo van Kemenade <1324225+hugovk@users.noreply.github.com>
---
 src/PIL/PpmImagePlugin.py | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/src/PIL/PpmImagePlugin.py b/src/PIL/PpmImagePlugin.py
index 6be1278eb2e..d43e21e14db 100644
--- a/src/PIL/PpmImagePlugin.py
+++ b/src/PIL/PpmImagePlugin.py
@@ -115,7 +115,7 @@ def _open(self):
         for ix in range(3):
             if mode == "F" and ix == 2:
                 scale = float(self._read_token())
-                if not math.isfinite(scale) or scale == 0.0:
+                if scale == 0.0 or not math.isfinite(scale):
                     msg = "scale must be finite and non-zero"
                     raise ValueError(msg)
                 rawmode = "F;32F" if scale < 0 else "F;32BF"

From 5dd1652f2775bb916faa648fe48c7c6350d2c8a4 Mon Sep 17 00:00:00 2001
From: Nulano <nulano@nulano.eu>
Date: Mon, 8 Jan 2024 17:16:23 +0100
Subject: [PATCH 0050/1178] use filename instead of f

---
 Tests/test_file_ppm.py | 24 ++++++++++++------------
 1 file changed, 12 insertions(+), 12 deletions(-)

diff --git a/Tests/test_file_ppm.py b/Tests/test_file_ppm.py
index efdb880de07..d8e259b1cf8 100644
--- a/Tests/test_file_ppm.py
+++ b/Tests/test_file_ppm.py
@@ -89,20 +89,20 @@ def test_16bit_pgm():
 
 def test_16bit_pgm_write(tmp_path):
     with Image.open("Tests/images/16_bit_binary.pgm") as im:
-        f = str(tmp_path / "temp.pgm")
-        im.save(f, "PPM")
+        filename = str(tmp_path / "temp.pgm")
+        im.save(filename, "PPM")
 
-        assert_image_equal_tofile(im, f)
+        assert_image_equal_tofile(im, filename)
 
 
 def test_pnm(tmp_path):
     with Image.open("Tests/images/hopper.pnm") as im:
         assert_image_similar(im, hopper(), 0.0001)
 
-        f = str(tmp_path / "temp.pnm")
-        im.save(f)
+        filename = str(tmp_path / "temp.pnm")
+        im.save(filename)
 
-        assert_image_equal_tofile(im, f)
+        assert_image_equal_tofile(im, filename)
 
 
 def test_pfm(tmp_path):
@@ -110,10 +110,10 @@ def test_pfm(tmp_path):
         assert im.info["scale"] == 1.0
         assert_image_equal(im, hopper("F"))
 
-        f = str(tmp_path / "tmp.pfm")
-        im.save(f)
+        filename = str(tmp_path / "tmp.pfm")
+        im.save(filename)
 
-        assert_image_equal_tofile(im, f)
+        assert_image_equal_tofile(im, filename)
 
 
 def test_pfm_big_endian(tmp_path):
@@ -121,10 +121,10 @@ def test_pfm_big_endian(tmp_path):
         assert im.info["scale"] == 2.5
         assert_image_equal(im, hopper("F"))
 
-        f = str(tmp_path / "tmp.pfm")
-        im.save(f)
+        filename = str(tmp_path / "tmp.pfm")
+        im.save(filename)
 
-        assert_image_equal_tofile(im, f)
+        assert_image_equal_tofile(im, filename)
 
 
 @pytest.mark.parametrize(

From 586e7740947933454589f3c60b22387e01fa5701 Mon Sep 17 00:00:00 2001
From: Nulano <nulano@nulano.eu>
Date: Mon, 8 Jan 2024 17:35:01 +0100
Subject: [PATCH 0051/1178] add PFM support to release notes

---
 docs/handbook/image-file-formats.rst |  3 +-
 docs/releasenotes/10.3.0.rst         | 49 ++++++++++++++++++++++++++++
 docs/releasenotes/index.rst          |  1 +
 3 files changed, 52 insertions(+), 1 deletion(-)
 create mode 100644 docs/releasenotes/10.3.0.rst

diff --git a/docs/handbook/image-file-formats.rst b/docs/handbook/image-file-formats.rst
index 02a6a3af729..569ccb7691b 100644
--- a/docs/handbook/image-file-formats.rst
+++ b/docs/handbook/image-file-formats.rst
@@ -701,7 +701,8 @@ PFM
 
 .. versionadded:: 10.3.0
 
-Pillow reads and writes grayscale (Pf format) PFM files containing ``F`` data.
+Pillow reads and writes grayscale (Pf format) Portable FloatMap (PFM) files
+containing ``F`` data.
 
 Color (PF format) PFM files are not supported.
 
diff --git a/docs/releasenotes/10.3.0.rst b/docs/releasenotes/10.3.0.rst
new file mode 100644
index 00000000000..34afbe4b844
--- /dev/null
+++ b/docs/releasenotes/10.3.0.rst
@@ -0,0 +1,49 @@
+10.3.0
+------
+
+Backwards Incompatible Changes
+==============================
+
+TODO
+^^^^
+
+Deprecations
+============
+
+TODO
+^^^^
+
+TODO
+
+API Changes
+===========
+
+TODO
+^^^^
+
+TODO
+
+API Additions
+=============
+
+TODO
+^^^^
+
+TODO
+
+Security
+========
+
+TODO
+^^^^
+
+TODO
+
+Other Changes
+=============
+
+Portable FloatMap (PFM) images
+^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
+
+Support has been added for reading and writing grayscale (Pf format)
+Portable FloatMap (PFM) files containing ``F`` data.
diff --git a/docs/releasenotes/index.rst b/docs/releasenotes/index.rst
index d8034853cc2..e86f8082b48 100644
--- a/docs/releasenotes/index.rst
+++ b/docs/releasenotes/index.rst
@@ -14,6 +14,7 @@ expected to be backported to earlier versions.
 .. toctree::
   :maxdepth: 2
 
+  10.3.0
   10.2.0
   10.1.0
   10.0.1

From a844871c5eec479275af20ae0f06e4204174e9a6 Mon Sep 17 00:00:00 2001
From: Erik Soma <stillusingirc@gmail.com>
Date: Mon, 8 Jan 2024 15:18:49 -0500
Subject: [PATCH 0052/1178] Give apng repeated seeks test and image a more
 descriptive name.

---
 ...700.png => repeated_seeks_give_correct_info.png} | Bin
 Tests/test_file_apng.py                             |   4 ++--
 2 files changed, 2 insertions(+), 2 deletions(-)
 rename Tests/images/apng/{issue_7700.png => repeated_seeks_give_correct_info.png} (100%)

diff --git a/Tests/images/apng/issue_7700.png b/Tests/images/apng/repeated_seeks_give_correct_info.png
similarity index 100%
rename from Tests/images/apng/issue_7700.png
rename to Tests/images/apng/repeated_seeks_give_correct_info.png
diff --git a/Tests/test_file_apng.py b/Tests/test_file_apng.py
index 8069d4b08bb..47d425f8b74 100644
--- a/Tests/test_file_apng.py
+++ b/Tests/test_file_apng.py
@@ -691,9 +691,9 @@ def test_different_modes_in_later_frames(mode, default_image, duplicate, tmp_pat
         assert reloaded.mode == mode
 
 
-def test_apng_issue_7700():
+def test_apng_repeated_seeks_give_correct_info():
     # https://github.com/python-pillow/Pillow/issues/7700
-    with Image.open("Tests/images/apng/issue_7700.png") as im:
+    with Image.open("Tests/images/apng/repeated_seeks_give_correct_info.png") as im:
         for i in range(5):
             im.seek(0)
             assert im.info["duration"] == 4000.0

From a6051a4045354203d9fccafbe2ac620c505d9e00 Mon Sep 17 00:00:00 2001
From: Erik Soma <stillusingirc@gmail.com>
Date: Mon, 8 Jan 2024 15:20:24 -0500
Subject: [PATCH 0053/1178] Add type hints and fix some formatting for the apng
 repeated seeks test.

---
 Tests/test_file_apng.py | 6 +++---
 1 file changed, 3 insertions(+), 3 deletions(-)

diff --git a/Tests/test_file_apng.py b/Tests/test_file_apng.py
index 47d425f8b74..ea5ab41ec60 100644
--- a/Tests/test_file_apng.py
+++ b/Tests/test_file_apng.py
@@ -691,11 +691,11 @@ def test_different_modes_in_later_frames(mode, default_image, duplicate, tmp_pat
         assert reloaded.mode == mode
 
 
-def test_apng_repeated_seeks_give_correct_info():
+def test_apng_repeated_seeks_give_correct_info() -> None:
     # https://github.com/python-pillow/Pillow/issues/7700
     with Image.open("Tests/images/apng/repeated_seeks_give_correct_info.png") as im:
         for i in range(5):
             im.seek(0)
-            assert im.info["duration"] == 4000.0
+            assert im.info["duration"] == 4000
             im.seek(1)
-            assert im.info["duration"] == 1000.0
+            assert im.info["duration"] == 1000

From 931821688c0f9ef331097ac8b1358780eb82b21e Mon Sep 17 00:00:00 2001
From: Andrew Murray <radarhere@users.noreply.github.com>
Date: Tue, 9 Jan 2024 12:22:25 +1100
Subject: [PATCH 0054/1178] Added release notes

---
 docs/releasenotes/10.3.0.rst | 8 +++++---
 1 file changed, 5 insertions(+), 3 deletions(-)

diff --git a/docs/releasenotes/10.3.0.rst b/docs/releasenotes/10.3.0.rst
index 34afbe4b844..391068769fb 100644
--- a/docs/releasenotes/10.3.0.rst
+++ b/docs/releasenotes/10.3.0.rst
@@ -26,10 +26,12 @@ TODO
 API Additions
 =============
 
-TODO
-^^^^
+Added PerspectiveTransform
+^^^^^^^^^^^^^^^^^^^^^^^^^^
 
-TODO
+:py:class:`~PIL.ImageTransform.PerspectiveTransform` has been added, meaning
+that all of the :py:data:`~PIL.Image.Transform` values now have a corresponding
+subclass of :py:class:`~PIL.ImageTransform.Transform`.
 
 Security
 ========

From 6c320323b44df48a5162a2113ae2c34e7c9bf564 Mon Sep 17 00:00:00 2001
From: Andrew Murray <radarhere@users.noreply.github.com>
Date: Tue, 9 Jan 2024 12:47:27 +1100
Subject: [PATCH 0055/1178] Only set row order when needed

---
 src/PIL/PpmImagePlugin.py | 3 +--
 1 file changed, 1 insertion(+), 2 deletions(-)

diff --git a/src/PIL/PpmImagePlugin.py b/src/PIL/PpmImagePlugin.py
index 83e028718eb..9d37dcde099 100644
--- a/src/PIL/PpmImagePlugin.py
+++ b/src/PIL/PpmImagePlugin.py
@@ -311,7 +311,6 @@ def decode(self, buffer):
 
 
 def _save(im, fp, filename):
-    row_order = 1
     if im.mode == "1":
         rawmode, head = "1;I", b"P4"
     elif im.mode == "L":
@@ -322,7 +321,6 @@ def _save(im, fp, filename):
         rawmode, head = "RGB", b"P6"
     elif im.mode == "F":
         rawmode, head = "F;32F", b"Pf"
-        row_order = -1
     else:
         msg = f"cannot write mode {im.mode} as PPM"
         raise OSError(msg)
@@ -336,6 +334,7 @@ def _save(im, fp, filename):
             fp.write(b"65535\n")
     elif head == b"Pf":
         fp.write(b"-1.0\n")
+    row_order = -1 if im.mode == "F" else 1
     ImageFile._save(im, fp, [("raw", (0, 0) + im.size, 0, (rawmode, 0, row_order))])
 
 

From ab262dbfd5b8076fd8d530e27c8e4896f03025e9 Mon Sep 17 00:00:00 2001
From: Andrew Murray <radarhere@users.noreply.github.com>
Date: Tue, 9 Jan 2024 12:56:33 +1100
Subject: [PATCH 0056/1178] Update CHANGES.rst [ci skip]

---
 CHANGES.rst | 3 +++
 1 file changed, 3 insertions(+)

diff --git a/CHANGES.rst b/CHANGES.rst
index ebf731c5659..30bbaec3a64 100644
--- a/CHANGES.rst
+++ b/CHANGES.rst
@@ -5,6 +5,9 @@ Changelog (Pillow)
 10.3.0 (unreleased)
 -------------------
 
+- Add support for reading and writing grayscale PFM images #7696
+  [nulano, hugovk]
+
 - Add LCMS2 flags to ImageCms #7676
   [nulano, radarhere, hugovk]
 

From 1e8a03cd2d938d3773dfdbe9d477276e96527494 Mon Sep 17 00:00:00 2001
From: Andrew Murray <radarhere@users.noreply.github.com>
Date: Tue, 9 Jan 2024 18:08:40 +1100
Subject: [PATCH 0057/1178] Link to Python enum documentation

---
 docs/reference/ExifTags.rst  | 5 +++--
 docs/releasenotes/10.0.0.rst | 2 +-
 docs/releasenotes/9.3.0.rst  | 5 +++--
 3 files changed, 7 insertions(+), 5 deletions(-)

diff --git a/docs/reference/ExifTags.rst b/docs/reference/ExifTags.rst
index 464ab77ea35..06965ead3f0 100644
--- a/docs/reference/ExifTags.rst
+++ b/docs/reference/ExifTags.rst
@@ -4,8 +4,9 @@
 :py:mod:`~PIL.ExifTags` Module
 ==============================
 
-The :py:mod:`~PIL.ExifTags` module exposes several ``enum.IntEnum`` classes
-which provide constants and clear-text names for various well-known EXIF tags.
+The :py:mod:`~PIL.ExifTags` module exposes several :py:class:`enum.IntEnum`
+classes which provide constants and clear-text names for various well-known
+EXIF tags.
 
 .. py:data:: Base
 
diff --git a/docs/releasenotes/10.0.0.rst b/docs/releasenotes/10.0.0.rst
index a3f238119f0..705ca04152f 100644
--- a/docs/releasenotes/10.0.0.rst
+++ b/docs/releasenotes/10.0.0.rst
@@ -43,7 +43,7 @@ Constants
 ^^^^^^^^^
 
 A number of constants have been removed.
-Instead, ``enum.IntEnum`` classes have been added.
+Instead, :py:class:`enum.IntEnum` classes have been added.
 
 =====================================================  ============================================================
 Removed                                                Use instead
diff --git a/docs/releasenotes/9.3.0.rst b/docs/releasenotes/9.3.0.rst
index fde2faae3a7..16075ce95ec 100644
--- a/docs/releasenotes/9.3.0.rst
+++ b/docs/releasenotes/9.3.0.rst
@@ -33,8 +33,9 @@ Added ExifTags enums
 ^^^^^^^^^^^^^^^^^^^^
 
 The data from :py:data:`~PIL.ExifTags.TAGS` and
-:py:data:`~PIL.ExifTags.GPSTAGS` is now also exposed as ``enum.IntEnum``
-classes: :py:data:`~PIL.ExifTags.Base` and :py:data:`~PIL.ExifTags.GPS`.
+:py:data:`~PIL.ExifTags.GPSTAGS` is now also exposed as
+:py:class:`enum.IntEnum` classes: :py:data:`~PIL.ExifTags.Base` and
+:py:data:`~PIL.ExifTags.GPS`.
 
 
 Security

From 71ba20bb19899f55761dae1ccd0bc662766cdc65 Mon Sep 17 00:00:00 2001
From: Andrew Murray <radarhere@users.noreply.github.com>
Date: Tue, 9 Jan 2024 18:22:10 +1100
Subject: [PATCH 0058/1178] Shortened table description

---
 docs/deprecations.rst        | 54 ++++++++++++++++++------------------
 docs/releasenotes/10.3.0.rst | 54 ++++++++++++++++++------------------
 2 files changed, 54 insertions(+), 54 deletions(-)

diff --git a/docs/deprecations.rst b/docs/deprecations.rst
index 4c9abe19503..205fcb9abcd 100644
--- a/docs/deprecations.rst
+++ b/docs/deprecations.rst
@@ -64,33 +64,33 @@ A number of constants and a function in :py:mod:`.ImageCms` have been deprecated
 This includes a table of flags based on LittleCMS version 1 which has been
 replaced with a new class :py:class:`.ImageCms.Flags` based on LittleCMS 2 flags.
 
-=====================================================  ============================================================
-Deprecated                                             Use instead
-=====================================================  ============================================================
-``ImageCms.DESCRIPTION``                               No replacement
-``ImageCms.VERSION``                                   ``PIL.__version__``
-``ImageCms.FLAGS["MATRIXINPUT"]``                      :py:attr:`.ImageCms.Flags.CLUT_POST_LINEARIZATION`
-``ImageCms.FLAGS["MATRIXOUTPUT"]``                     :py:attr:`.ImageCms.Flags.FORCE_CLUT`
-``ImageCms.FLAGS["MATRIXONLY"]``                       No replacement
-``ImageCms.FLAGS["NOWHITEONWHITEFIXUP"]``              :py:attr:`.ImageCms.Flags.NOWHITEONWHITEFIXUP`
-``ImageCms.FLAGS["NOPRELINEARIZATION"]``               :py:attr:`.ImageCms.Flags.CLUT_PRE_LINEARIZATION`
-``ImageCms.FLAGS["GUESSDEVICECLASS"]``                 :py:attr:`.ImageCms.Flags.GUESSDEVICECLASS`
-``ImageCms.FLAGS["NOTCACHE"]``                         :py:attr:`.ImageCms.Flags.NOCACHE`
-``ImageCms.FLAGS["NOTPRECALC"]``                       :py:attr:`.ImageCms.Flags.NOOPTIMIZE`
-``ImageCms.FLAGS["NULLTRANSFORM"]``                    :py:attr:`.ImageCms.Flags.NULLTRANSFORM`
-``ImageCms.FLAGS["HIGHRESPRECALC"]``                   :py:attr:`.ImageCms.Flags.HIGHRESPRECALC`
-``ImageCms.FLAGS["LOWRESPRECALC"]``                    :py:attr:`.ImageCms.Flags.LOWRESPRECALC`
-``ImageCms.FLAGS["GAMUTCHECK"]``                       :py:attr:`.ImageCms.Flags.GAMUTCHECK`
-``ImageCms.FLAGS["WHITEBLACKCOMPENSATION"]``           :py:attr:`.ImageCms.Flags.BLACKPOINTCOMPENSATION`
-``ImageCms.FLAGS["BLACKPOINTCOMPENSATION"]``           :py:attr:`.ImageCms.Flags.BLACKPOINTCOMPENSATION`
-``ImageCms.FLAGS["SOFTPROOFING"]``                     :py:attr:`.ImageCms.Flags.SOFTPROOFING`
-``ImageCms.FLAGS["PRESERVEBLACK"]``                    :py:attr:`.ImageCms.Flags.NONEGATIVES`
-``ImageCms.FLAGS["NODEFAULTRESOURCEDEF"]``             :py:attr:`.ImageCms.Flags.NODEFAULTRESOURCEDEF`
-``ImageCms.FLAGS["GRIDPOINTS"]``                       :py:attr:`.ImageCms.Flags.GRIDPOINTS()`
-``ImageCms.versions()``                                :py:func:`PIL.features.version_module` with
-                                                       ``feature="littlecms2"``, :py:data:`sys.version` or
-                                                       :py:data:`sys.version_info`, and ``PIL.__version__``
-=====================================================  ============================================================
+============================================  ====================================================
+Deprecated                                    Use instead
+============================================  ====================================================
+``ImageCms.DESCRIPTION``                      No replacement
+``ImageCms.VERSION``                          ``PIL.__version__``
+``ImageCms.FLAGS["MATRIXINPUT"]``             :py:attr:`.ImageCms.Flags.CLUT_POST_LINEARIZATION`
+``ImageCms.FLAGS["MATRIXOUTPUT"]``            :py:attr:`.ImageCms.Flags.FORCE_CLUT`
+``ImageCms.FLAGS["MATRIXONLY"]``              No replacement
+``ImageCms.FLAGS["NOWHITEONWHITEFIXUP"]``     :py:attr:`.ImageCms.Flags.NOWHITEONWHITEFIXUP`
+``ImageCms.FLAGS["NOPRELINEARIZATION"]``      :py:attr:`.ImageCms.Flags.CLUT_PRE_LINEARIZATION`
+``ImageCms.FLAGS["GUESSDEVICECLASS"]``        :py:attr:`.ImageCms.Flags.GUESSDEVICECLASS`
+``ImageCms.FLAGS["NOTCACHE"]``                :py:attr:`.ImageCms.Flags.NOCACHE`
+``ImageCms.FLAGS["NOTPRECALC"]``              :py:attr:`.ImageCms.Flags.NOOPTIMIZE`
+``ImageCms.FLAGS["NULLTRANSFORM"]``           :py:attr:`.ImageCms.Flags.NULLTRANSFORM`
+``ImageCms.FLAGS["HIGHRESPRECALC"]``          :py:attr:`.ImageCms.Flags.HIGHRESPRECALC`
+``ImageCms.FLAGS["LOWRESPRECALC"]``           :py:attr:`.ImageCms.Flags.LOWRESPRECALC`
+``ImageCms.FLAGS["GAMUTCHECK"]``              :py:attr:`.ImageCms.Flags.GAMUTCHECK`
+``ImageCms.FLAGS["WHITEBLACKCOMPENSATION"]``  :py:attr:`.ImageCms.Flags.BLACKPOINTCOMPENSATION`
+``ImageCms.FLAGS["BLACKPOINTCOMPENSATION"]``  :py:attr:`.ImageCms.Flags.BLACKPOINTCOMPENSATION`
+``ImageCms.FLAGS["SOFTPROOFING"]``            :py:attr:`.ImageCms.Flags.SOFTPROOFING`
+``ImageCms.FLAGS["PRESERVEBLACK"]``           :py:attr:`.ImageCms.Flags.NONEGATIVES`
+``ImageCms.FLAGS["NODEFAULTRESOURCEDEF"]``    :py:attr:`.ImageCms.Flags.NODEFAULTRESOURCEDEF`
+``ImageCms.FLAGS["GRIDPOINTS"]``              :py:attr:`.ImageCms.Flags.GRIDPOINTS()`
+``ImageCms.versions()``                       :py:func:`PIL.features.version_module` with
+                                              ``feature="littlecms2"``, :py:data:`sys.version` or
+                                              :py:data:`sys.version_info`, and ``PIL.__version__``
+============================================  ====================================================
 
 Removed features
 ----------------
diff --git a/docs/releasenotes/10.3.0.rst b/docs/releasenotes/10.3.0.rst
index 8ce6f4b9c9f..548f95df95c 100644
--- a/docs/releasenotes/10.3.0.rst
+++ b/docs/releasenotes/10.3.0.rst
@@ -17,33 +17,33 @@ A number of constants and a function in :py:mod:`.ImageCms` have been deprecated
 This includes a table of flags based on LittleCMS version 1 which has been replaced
 with a new class :py:class:`.ImageCms.Flags` based on LittleCMS 2 flags.
 
-=====================================================  ============================================================
-Deprecated                                             Use instead
-=====================================================  ============================================================
-``ImageCms.DESCRIPTION``                               No replacement
-``ImageCms.VERSION``                                   ``PIL.__version__``
-``ImageCms.FLAGS["MATRIXINPUT"]``                      :py:attr:`.ImageCms.Flags.CLUT_POST_LINEARIZATION`
-``ImageCms.FLAGS["MATRIXOUTPUT"]``                     :py:attr:`.ImageCms.Flags.FORCE_CLUT`
-``ImageCms.FLAGS["MATRIXONLY"]``                       No replacement
-``ImageCms.FLAGS["NOWHITEONWHITEFIXUP"]``              :py:attr:`.ImageCms.Flags.NOWHITEONWHITEFIXUP`
-``ImageCms.FLAGS["NOPRELINEARIZATION"]``               :py:attr:`.ImageCms.Flags.CLUT_PRE_LINEARIZATION`
-``ImageCms.FLAGS["GUESSDEVICECLASS"]``                 :py:attr:`.ImageCms.Flags.GUESSDEVICECLASS`
-``ImageCms.FLAGS["NOTCACHE"]``                         :py:attr:`.ImageCms.Flags.NOCACHE`
-``ImageCms.FLAGS["NOTPRECALC"]``                       :py:attr:`.ImageCms.Flags.NOOPTIMIZE`
-``ImageCms.FLAGS["NULLTRANSFORM"]``                    :py:attr:`.ImageCms.Flags.NULLTRANSFORM`
-``ImageCms.FLAGS["HIGHRESPRECALC"]``                   :py:attr:`.ImageCms.Flags.HIGHRESPRECALC`
-``ImageCms.FLAGS["LOWRESPRECALC"]``                    :py:attr:`.ImageCms.Flags.LOWRESPRECALC`
-``ImageCms.FLAGS["GAMUTCHECK"]``                       :py:attr:`.ImageCms.Flags.GAMUTCHECK`
-``ImageCms.FLAGS["WHITEBLACKCOMPENSATION"]``           :py:attr:`.ImageCms.Flags.BLACKPOINTCOMPENSATION`
-``ImageCms.FLAGS["BLACKPOINTCOMPENSATION"]``           :py:attr:`.ImageCms.Flags.BLACKPOINTCOMPENSATION`
-``ImageCms.FLAGS["SOFTPROOFING"]``                     :py:attr:`.ImageCms.Flags.SOFTPROOFING`
-``ImageCms.FLAGS["PRESERVEBLACK"]``                    :py:attr:`.ImageCms.Flags.NONEGATIVES`
-``ImageCms.FLAGS["NODEFAULTRESOURCEDEF"]``             :py:attr:`.ImageCms.Flags.NODEFAULTRESOURCEDEF`
-``ImageCms.FLAGS["GRIDPOINTS"]``                       :py:attr:`.ImageCms.Flags.GRIDPOINTS()`
-``ImageCms.versions()``                                :py:func:`PIL.features.version_module` with
-                                                       ``feature="littlecms2"``, :py:data:`sys.version` or
-                                                       :py:data:`sys.version_info`, and ``PIL.__version__``
-=====================================================  ============================================================
+============================================  ====================================================
+Deprecated                                    Use instead
+============================================  ====================================================
+``ImageCms.DESCRIPTION``                      No replacement
+``ImageCms.VERSION``                          ``PIL.__version__``
+``ImageCms.FLAGS["MATRIXINPUT"]``             :py:attr:`.ImageCms.Flags.CLUT_POST_LINEARIZATION`
+``ImageCms.FLAGS["MATRIXOUTPUT"]``            :py:attr:`.ImageCms.Flags.FORCE_CLUT`
+``ImageCms.FLAGS["MATRIXONLY"]``              No replacement
+``ImageCms.FLAGS["NOWHITEONWHITEFIXUP"]``     :py:attr:`.ImageCms.Flags.NOWHITEONWHITEFIXUP`
+``ImageCms.FLAGS["NOPRELINEARIZATION"]``      :py:attr:`.ImageCms.Flags.CLUT_PRE_LINEARIZATION`
+``ImageCms.FLAGS["GUESSDEVICECLASS"]``        :py:attr:`.ImageCms.Flags.GUESSDEVICECLASS`
+``ImageCms.FLAGS["NOTCACHE"]``                :py:attr:`.ImageCms.Flags.NOCACHE`
+``ImageCms.FLAGS["NOTPRECALC"]``              :py:attr:`.ImageCms.Flags.NOOPTIMIZE`
+``ImageCms.FLAGS["NULLTRANSFORM"]``           :py:attr:`.ImageCms.Flags.NULLTRANSFORM`
+``ImageCms.FLAGS["HIGHRESPRECALC"]``          :py:attr:`.ImageCms.Flags.HIGHRESPRECALC`
+``ImageCms.FLAGS["LOWRESPRECALC"]``           :py:attr:`.ImageCms.Flags.LOWRESPRECALC`
+``ImageCms.FLAGS["GAMUTCHECK"]``              :py:attr:`.ImageCms.Flags.GAMUTCHECK`
+``ImageCms.FLAGS["WHITEBLACKCOMPENSATION"]``  :py:attr:`.ImageCms.Flags.BLACKPOINTCOMPENSATION`
+``ImageCms.FLAGS["BLACKPOINTCOMPENSATION"]``  :py:attr:`.ImageCms.Flags.BLACKPOINTCOMPENSATION`
+``ImageCms.FLAGS["SOFTPROOFING"]``            :py:attr:`.ImageCms.Flags.SOFTPROOFING`
+``ImageCms.FLAGS["PRESERVEBLACK"]``           :py:attr:`.ImageCms.Flags.NONEGATIVES`
+``ImageCms.FLAGS["NODEFAULTRESOURCEDEF"]``    :py:attr:`.ImageCms.Flags.NODEFAULTRESOURCEDEF`
+``ImageCms.FLAGS["GRIDPOINTS"]``              :py:attr:`.ImageCms.Flags.GRIDPOINTS()`
+``ImageCms.versions()``                       :py:func:`PIL.features.version_module` with
+                                              ``feature="littlecms2"``, :py:data:`sys.version` or
+                                              :py:data:`sys.version_info`, and ``PIL.__version__``
+============================================  ====================================================
 
 API Changes
 ===========

From dc6d7611e9196447aaa18305c79ee83f005f4ec3 Mon Sep 17 00:00:00 2001
From: Erik Soma <stillusingirc@gmail.com>
Date: Tue, 9 Jan 2024 08:55:49 -0500
Subject: [PATCH 0059/1178] Test apng repeated seeks 3 times instead of 5.

Co-authored-by: Andrew Murray <3112309+radarhere@users.noreply.github.com>
---
 Tests/test_file_apng.py | 3 +--
 1 file changed, 1 insertion(+), 2 deletions(-)

diff --git a/Tests/test_file_apng.py b/Tests/test_file_apng.py
index ea5ab41ec60..3403322585e 100644
--- a/Tests/test_file_apng.py
+++ b/Tests/test_file_apng.py
@@ -692,9 +692,8 @@ def test_different_modes_in_later_frames(mode, default_image, duplicate, tmp_pat
 
 
 def test_apng_repeated_seeks_give_correct_info() -> None:
-    # https://github.com/python-pillow/Pillow/issues/7700
     with Image.open("Tests/images/apng/repeated_seeks_give_correct_info.png") as im:
-        for i in range(5):
+        for i in range(3):
             im.seek(0)
             assert im.info["duration"] == 4000
             im.seek(1)

From d7874e8a03dbf57b01c0fe41290603ddfe2875c1 Mon Sep 17 00:00:00 2001
From: Andrew Murray <radarhere@users.noreply.github.com>
Date: Wed, 10 Jan 2024 09:07:10 +1100
Subject: [PATCH 0060/1178] Update CHANGES.rst [ci skip]

---
 CHANGES.rst | 3 +++
 1 file changed, 3 insertions(+)

diff --git a/CHANGES.rst b/CHANGES.rst
index 30bbaec3a64..c267ca472ce 100644
--- a/CHANGES.rst
+++ b/CHANGES.rst
@@ -5,6 +5,9 @@ Changelog (Pillow)
 10.3.0 (unreleased)
 -------------------
 
+- Added PerspectiveTransform #7699
+  [radarhere]
+
 - Add support for reading and writing grayscale PFM images #7696
   [nulano, hugovk]
 

From df99d48a0cb98cad2f6ee5ae65b0be5df8d84ef3 Mon Sep 17 00:00:00 2001
From: Andrew Murray <radarhere@users.noreply.github.com>
Date: Wed, 10 Jan 2024 09:26:56 +1100
Subject: [PATCH 0061/1178] Simplified code

---
 src/PIL/PsdImagePlugin.py | 7 +++----
 1 file changed, 3 insertions(+), 4 deletions(-)

diff --git a/src/PIL/PsdImagePlugin.py b/src/PIL/PsdImagePlugin.py
index 5cff564137d..9f7bf78290b 100644
--- a/src/PIL/PsdImagePlugin.py
+++ b/src/PIL/PsdImagePlugin.py
@@ -185,14 +185,13 @@ def read(size):
         # image info
         mode = []
         ct_types = i16(read(2))
-        types = list(range(ct_types))
-        if len(types) > 4:
-            fp.seek(len(types) * 6 + 12, io.SEEK_CUR)
+        if ct_types > 4:
+            fp.seek(ct_types * 6 + 12, io.SEEK_CUR)
             size = i32(read(4))
             fp.seek(size, io.SEEK_CUR)
             continue
 
-        for _ in types:
+        for _ in range(ct_types):
             type = i16(read(2))
 
             if type == 65535:

From 659098c6acc46ff353ba2a136805b463fb5cc97b Mon Sep 17 00:00:00 2001
From: Andrew Murray <radarhere@users.noreply.github.com>
Date: Wed, 10 Jan 2024 22:05:26 +1100
Subject: [PATCH 0062/1178] Added type hints

---
 pyproject.toml           |   1 -
 src/PIL/Image.py         |   4 +-
 src/PIL/ImageMath.py     | 136 +++++++++++++++++++++------------------
 src/PIL/_imagingmath.pyi |   5 ++
 4 files changed, 80 insertions(+), 66 deletions(-)
 create mode 100644 src/PIL/_imagingmath.pyi

diff --git a/pyproject.toml b/pyproject.toml
index da2537b2137..54a4bcaec0c 100644
--- a/pyproject.toml
+++ b/pyproject.toml
@@ -146,7 +146,6 @@ exclude = [
   '^src/PIL/DdsImagePlugin.py$',
   '^src/PIL/FpxImagePlugin.py$',
   '^src/PIL/Image.py$',
-  '^src/PIL/ImageMath.py$',
   '^src/PIL/ImageMorph.py$',
   '^src/PIL/ImageQt.py$',
   '^src/PIL/ImageShow.py$',
diff --git a/src/PIL/Image.py b/src/PIL/Image.py
index c56da545803..0fbbe5861a0 100644
--- a/src/PIL/Image.py
+++ b/src/PIL/Image.py
@@ -873,7 +873,7 @@ def verify(self):
 
     def convert(
         self, mode=None, matrix=None, dither=None, palette=Palette.WEB, colors=256
-    ):
+    ) -> Image:
         """
         Returns a converted copy of this image. For the "P" mode, this
         method translates pixels through the palette.  If mode is
@@ -1305,7 +1305,7 @@ def getbands(self):
         """
         return ImageMode.getmode(self.mode).bands
 
-    def getbbox(self, *, alpha_only=True):
+    def getbbox(self, *, alpha_only=True) -> tuple[int, int, int, int]:
         """
         Calculates the bounding box of the non-zero regions in the
         image.
diff --git a/src/PIL/ImageMath.py b/src/PIL/ImageMath.py
index b77f4bce567..949fa45bb45 100644
--- a/src/PIL/ImageMath.py
+++ b/src/PIL/ImageMath.py
@@ -17,6 +17,7 @@
 from __future__ import annotations
 
 import builtins
+from typing import Any
 
 from . import Image, _imagingmath
 
@@ -24,10 +25,10 @@
 class _Operand:
     """Wraps an image operand, providing standard operators"""
 
-    def __init__(self, im):
+    def __init__(self, im: Image.Image):
         self.im = im
 
-    def __fixup(self, im1):
+    def __fixup(self, im1: _Operand | float) -> Image.Image:
         # convert image to suitable mode
         if isinstance(im1, _Operand):
             # argument was an image.
@@ -45,122 +46,131 @@ def __fixup(self, im1):
             else:
                 return Image.new("F", self.im.size, im1)
 
-    def apply(self, op, im1, im2=None, mode=None):
-        im1 = self.__fixup(im1)
+    def apply(
+        self,
+        op: str,
+        im1: _Operand | float,
+        im2: _Operand | float | None = None,
+        mode: str | None = None,
+    ) -> _Operand:
+        im_1 = self.__fixup(im1)
         if im2 is None:
             # unary operation
-            out = Image.new(mode or im1.mode, im1.size, None)
-            im1.load()
+            out = Image.new(mode or im_1.mode, im_1.size, None)
+            im_1.load()
             try:
-                op = getattr(_imagingmath, op + "_" + im1.mode)
+                op = getattr(_imagingmath, op + "_" + im_1.mode)
             except AttributeError as e:
                 msg = f"bad operand type for '{op}'"
                 raise TypeError(msg) from e
-            _imagingmath.unop(op, out.im.id, im1.im.id)
+            _imagingmath.unop(op, out.im.id, im_1.im.id)
         else:
             # binary operation
-            im2 = self.__fixup(im2)
-            if im1.mode != im2.mode:
+            im_2 = self.__fixup(im2)
+            if im_1.mode != im_2.mode:
                 # convert both arguments to floating point
-                if im1.mode != "F":
-                    im1 = im1.convert("F")
-                if im2.mode != "F":
-                    im2 = im2.convert("F")
-            if im1.size != im2.size:
+                if im_1.mode != "F":
+                    im_1 = im_1.convert("F")
+                if im_2.mode != "F":
+                    im_2 = im_2.convert("F")
+            if im_1.size != im_2.size:
                 # crop both arguments to a common size
-                size = (min(im1.size[0], im2.size[0]), min(im1.size[1], im2.size[1]))
-                if im1.size != size:
-                    im1 = im1.crop((0, 0) + size)
-                if im2.size != size:
-                    im2 = im2.crop((0, 0) + size)
-            out = Image.new(mode or im1.mode, im1.size, None)
-            im1.load()
-            im2.load()
+                size = (
+                    min(im_1.size[0], im_2.size[0]),
+                    min(im_1.size[1], im_2.size[1]),
+                )
+                if im_1.size != size:
+                    im_1 = im_1.crop((0, 0) + size)
+                if im_2.size != size:
+                    im_2 = im_2.crop((0, 0) + size)
+            out = Image.new(mode or im_1.mode, im_1.size, None)
+            im_1.load()
+            im_2.load()
             try:
-                op = getattr(_imagingmath, op + "_" + im1.mode)
+                op = getattr(_imagingmath, op + "_" + im_1.mode)
             except AttributeError as e:
                 msg = f"bad operand type for '{op}'"
                 raise TypeError(msg) from e
-            _imagingmath.binop(op, out.im.id, im1.im.id, im2.im.id)
+            _imagingmath.binop(op, out.im.id, im_1.im.id, im_2.im.id)
         return _Operand(out)
 
     # unary operators
-    def __bool__(self):
+    def __bool__(self) -> bool:
         # an image is "true" if it contains at least one non-zero pixel
         return self.im.getbbox() is not None
 
-    def __abs__(self):
+    def __abs__(self) -> _Operand:
         return self.apply("abs", self)
 
-    def __pos__(self):
+    def __pos__(self) -> _Operand:
         return self
 
-    def __neg__(self):
+    def __neg__(self) -> _Operand:
         return self.apply("neg", self)
 
     # binary operators
-    def __add__(self, other):
+    def __add__(self, other: _Operand | float) -> _Operand:
         return self.apply("add", self, other)
 
-    def __radd__(self, other):
+    def __radd__(self, other: _Operand | float) -> _Operand:
         return self.apply("add", other, self)
 
-    def __sub__(self, other):
+    def __sub__(self, other: _Operand | float) -> _Operand:
         return self.apply("sub", self, other)
 
-    def __rsub__(self, other):
+    def __rsub__(self, other: _Operand | float) -> _Operand:
         return self.apply("sub", other, self)
 
-    def __mul__(self, other):
+    def __mul__(self, other: _Operand | float) -> _Operand:
         return self.apply("mul", self, other)
 
-    def __rmul__(self, other):
+    def __rmul__(self, other: _Operand | float) -> _Operand:
         return self.apply("mul", other, self)
 
-    def __truediv__(self, other):
+    def __truediv__(self, other: _Operand | float) -> _Operand:
         return self.apply("div", self, other)
 
-    def __rtruediv__(self, other):
+    def __rtruediv__(self, other: _Operand | float) -> _Operand:
         return self.apply("div", other, self)
 
-    def __mod__(self, other):
+    def __mod__(self, other: _Operand | float) -> _Operand:
         return self.apply("mod", self, other)
 
-    def __rmod__(self, other):
+    def __rmod__(self, other: _Operand | float) -> _Operand:
         return self.apply("mod", other, self)
 
-    def __pow__(self, other):
+    def __pow__(self, other: _Operand | float) -> _Operand:
         return self.apply("pow", self, other)
 
-    def __rpow__(self, other):
+    def __rpow__(self, other: _Operand | float) -> _Operand:
         return self.apply("pow", other, self)
 
     # bitwise
-    def __invert__(self):
+    def __invert__(self) -> _Operand:
         return self.apply("invert", self)
 
-    def __and__(self, other):
+    def __and__(self, other: _Operand | float) -> _Operand:
         return self.apply("and", self, other)
 
-    def __rand__(self, other):
+    def __rand__(self, other: _Operand | float) -> _Operand:
         return self.apply("and", other, self)
 
-    def __or__(self, other):
+    def __or__(self, other: _Operand | float) -> _Operand:
         return self.apply("or", self, other)
 
-    def __ror__(self, other):
+    def __ror__(self, other: _Operand | float) -> _Operand:
         return self.apply("or", other, self)
 
-    def __xor__(self, other):
+    def __xor__(self, other: _Operand | float) -> _Operand:
         return self.apply("xor", self, other)
 
-    def __rxor__(self, other):
+    def __rxor__(self, other: _Operand | float) -> _Operand:
         return self.apply("xor", other, self)
 
-    def __lshift__(self, other):
+    def __lshift__(self, other: _Operand | float) -> _Operand:
         return self.apply("lshift", self, other)
 
-    def __rshift__(self, other):
+    def __rshift__(self, other: _Operand | float) -> _Operand:
         return self.apply("rshift", self, other)
 
     # logical
@@ -170,46 +180,46 @@ def __eq__(self, other):
     def __ne__(self, other):
         return self.apply("ne", self, other)
 
-    def __lt__(self, other):
+    def __lt__(self, other: _Operand | float) -> _Operand:
         return self.apply("lt", self, other)
 
-    def __le__(self, other):
+    def __le__(self, other: _Operand | float) -> _Operand:
         return self.apply("le", self, other)
 
-    def __gt__(self, other):
+    def __gt__(self, other: _Operand | float) -> _Operand:
         return self.apply("gt", self, other)
 
-    def __ge__(self, other):
+    def __ge__(self, other: _Operand | float) -> _Operand:
         return self.apply("ge", self, other)
 
 
 # conversions
-def imagemath_int(self):
+def imagemath_int(self: _Operand) -> _Operand:
     return _Operand(self.im.convert("I"))
 
 
-def imagemath_float(self):
+def imagemath_float(self: _Operand) -> _Operand:
     return _Operand(self.im.convert("F"))
 
 
 # logical
-def imagemath_equal(self, other):
+def imagemath_equal(self: _Operand, other: _Operand | float | None) -> _Operand:
     return self.apply("eq", self, other, mode="I")
 
 
-def imagemath_notequal(self, other):
+def imagemath_notequal(self: _Operand, other: _Operand | float | None) -> _Operand:
     return self.apply("ne", self, other, mode="I")
 
 
-def imagemath_min(self, other):
+def imagemath_min(self: _Operand, other: _Operand | float | None) -> _Operand:
     return self.apply("min", self, other)
 
 
-def imagemath_max(self, other):
+def imagemath_max(self: _Operand, other: _Operand | float | None) -> _Operand:
     return self.apply("max", self, other)
 
 
-def imagemath_convert(self, mode):
+def imagemath_convert(self: _Operand, mode: str) -> _Operand:
     return _Operand(self.im.convert(mode))
 
 
@@ -219,7 +229,7 @@ def imagemath_convert(self, mode):
         ops[k[10:]] = v
 
 
-def eval(expression, _dict={}, **kw):
+def eval(expression: str, _dict: dict[str, Any] = {}, **kw: Any) -> Any:
     """
     Evaluates an image expression.
 
@@ -247,7 +257,7 @@ def eval(expression, _dict={}, **kw):
 
     compiled_code = compile(expression, "<string>", "eval")
 
-    def scan(code):
+    def scan(code) -> None:
         for const in code.co_consts:
             if type(const) is type(compiled_code):
                 scan(const)
diff --git a/src/PIL/_imagingmath.pyi b/src/PIL/_imagingmath.pyi
new file mode 100644
index 00000000000..b0235555dc5
--- /dev/null
+++ b/src/PIL/_imagingmath.pyi
@@ -0,0 +1,5 @@
+from __future__ import annotations
+
+from typing import Any
+
+def __getattr__(name: str) -> Any: ...

From 38bfe3cddf618bf5aaaf0d5c88011031fd0eaf45 Mon Sep 17 00:00:00 2001
From: Andrew Murray <3112309+radarhere@users.noreply.github.com>
Date: Wed, 10 Jan 2024 23:36:26 +1100
Subject: [PATCH 0063/1178] Added type hint

Co-authored-by: Hugo van Kemenade <1324225+hugovk@users.noreply.github.com>
---
 src/PIL/Image.py | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/src/PIL/Image.py b/src/PIL/Image.py
index 0fbbe5861a0..ac13c6c0c25 100644
--- a/src/PIL/Image.py
+++ b/src/PIL/Image.py
@@ -1305,7 +1305,7 @@ def getbands(self):
         """
         return ImageMode.getmode(self.mode).bands
 
-    def getbbox(self, *, alpha_only=True) -> tuple[int, int, int, int]:
+    def getbbox(self, *, alpha_only: bool = True) -> tuple[int, int, int, int]:
         """
         Calculates the bounding box of the non-zero regions in the
         image.

From 993bc6c2027926633321593d5c39a29cbe926e3b Mon Sep 17 00:00:00 2001
From: Andrew Murray <radarhere@users.noreply.github.com>
Date: Wed, 10 Jan 2024 23:41:09 +1100
Subject: [PATCH 0064/1178] Added type hint

---
 src/PIL/ImageMath.py | 3 ++-
 1 file changed, 2 insertions(+), 1 deletion(-)

diff --git a/src/PIL/ImageMath.py b/src/PIL/ImageMath.py
index 949fa45bb45..bc3318c04f4 100644
--- a/src/PIL/ImageMath.py
+++ b/src/PIL/ImageMath.py
@@ -17,6 +17,7 @@
 from __future__ import annotations
 
 import builtins
+from types import CodeType
 from typing import Any
 
 from . import Image, _imagingmath
@@ -257,7 +258,7 @@ def eval(expression: str, _dict: dict[str, Any] = {}, **kw: Any) -> Any:
 
     compiled_code = compile(expression, "<string>", "eval")
 
-    def scan(code) -> None:
+    def scan(code: CodeType) -> None:
         for const in code.co_consts:
             if type(const) is type(compiled_code):
                 scan(const)

From c2907dc04967109391a77eea00f7d583a0a0395f Mon Sep 17 00:00:00 2001
From: Andrew Murray <radarhere@users.noreply.github.com>
Date: Wed, 10 Jan 2024 23:53:45 +1100
Subject: [PATCH 0065/1178] Layer co-ordinates may be negative

---
 Tests/images/negative_top_left_layer.psd | Bin 0 -> 8220 bytes
 Tests/test_file_psd.py                   |   5 +++++
 src/PIL/PsdImagePlugin.py                |   9 +++++----
 src/PIL/_binary.py                       |  10 ++++++++++
 4 files changed, 20 insertions(+), 4 deletions(-)
 create mode 100644 Tests/images/negative_top_left_layer.psd

diff --git a/Tests/images/negative_top_left_layer.psd b/Tests/images/negative_top_left_layer.psd
new file mode 100644
index 0000000000000000000000000000000000000000..be9d9d6d03e357d4e3c31aecf0d3f90f9fc49974
GIT binary patch
literal 8220
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
L`ro%zxbyW->#0jd

literal 0
HcmV?d00001

diff --git a/Tests/test_file_psd.py b/Tests/test_file_psd.py
index 8b06ce2b163..e3c1f447af2 100644
--- a/Tests/test_file_psd.py
+++ b/Tests/test_file_psd.py
@@ -112,6 +112,11 @@ def test_rgba():
         assert_image_equal_tofile(im, "Tests/images/imagedraw_square.png")
 
 
+def test_negative_top_left_layer() -> None:
+    with Image.open("Tests/images/negative_top_left_layer.psd") as im:
+        assert im.layers[0][2] == (-50, -50, 50, 50)
+
+
 def test_layer_skip():
     with Image.open("Tests/images/five_channels.psd") as im:
         assert im.n_frames == 1
diff --git a/src/PIL/PsdImagePlugin.py b/src/PIL/PsdImagePlugin.py
index 9f7bf78290b..d29bcf9970c 100644
--- a/src/PIL/PsdImagePlugin.py
+++ b/src/PIL/PsdImagePlugin.py
@@ -24,6 +24,7 @@
 from ._binary import i16be as i16
 from ._binary import i32be as i32
 from ._binary import si16be as si16
+from ._binary import si32be as si32
 
 MODES = {
     # (photoshop mode, bits) -> (pil mode, required channels)
@@ -177,10 +178,10 @@ def read(size):
 
     for _ in range(abs(ct)):
         # bounding box
-        y0 = i32(read(4))
-        x0 = i32(read(4))
-        y1 = i32(read(4))
-        x1 = i32(read(4))
+        y0 = si32(read(4))
+        x0 = si32(read(4))
+        y1 = si32(read(4))
+        x1 = si32(read(4))
 
         # image info
         mode = []
diff --git a/src/PIL/_binary.py b/src/PIL/_binary.py
index 0a07e8d0e12..4594ccce361 100644
--- a/src/PIL/_binary.py
+++ b/src/PIL/_binary.py
@@ -77,6 +77,16 @@ def si32le(c: bytes, o: int = 0) -> int:
     return unpack_from("<i", c, o)[0]
 
 
+def si32be(c: bytes, o: int = 0) -> int:
+    """
+    Converts a 4-bytes (32 bits) string to a signed integer, big endian.
+
+    :param c: string containing bytes to convert
+    :param o: offset of bytes to convert in string
+    """
+    return unpack_from(">i", c, o)[0]
+
+
 def i16be(c: bytes, o: int = 0) -> int:
     return unpack_from(">H", c, o)[0]
 

From 6f144d45b98d6c331da9fcd437542e224793b893 Mon Sep 17 00:00:00 2001
From: Erik Soma <stillusingirc@gmail.com>
Date: Wed, 10 Jan 2024 16:03:42 -0500
Subject: [PATCH 0066/1178] Rename repeated seeks apng to reflect what it is
 rather than how it is used.

---
 ...ive_correct_info.png => different_durations.png} | Bin
 Tests/test_file_apng.py                             |   2 +-
 2 files changed, 1 insertion(+), 1 deletion(-)
 rename Tests/images/apng/{repeated_seeks_give_correct_info.png => different_durations.png} (100%)

diff --git a/Tests/images/apng/repeated_seeks_give_correct_info.png b/Tests/images/apng/different_durations.png
similarity index 100%
rename from Tests/images/apng/repeated_seeks_give_correct_info.png
rename to Tests/images/apng/different_durations.png
diff --git a/Tests/test_file_apng.py b/Tests/test_file_apng.py
index 3403322585e..e2c4569cee5 100644
--- a/Tests/test_file_apng.py
+++ b/Tests/test_file_apng.py
@@ -692,7 +692,7 @@ def test_different_modes_in_later_frames(mode, default_image, duplicate, tmp_pat
 
 
 def test_apng_repeated_seeks_give_correct_info() -> None:
-    with Image.open("Tests/images/apng/repeated_seeks_give_correct_info.png") as im:
+    with Image.open("Tests/images/apng/different_durations.png") as im:
         for i in range(3):
             im.seek(0)
             assert im.info["duration"] == 4000

From 5347b471c69c400c6199c8cd200b5844169f7988 Mon Sep 17 00:00:00 2001
From: =?UTF-8?q?Ondrej=20Baranovi=C4=8D?= <nulano@nulano.eu>
Date: Thu, 11 Jan 2024 02:08:46 +0100
Subject: [PATCH 0067/1178] Update Tests/test_imagecms.py

Co-authored-by: Andrew Murray <3112309+radarhere@users.noreply.github.com>
---
 Tests/test_imagecms.py | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/Tests/test_imagecms.py b/Tests/test_imagecms.py
index 9575b026db2..810394e6f5f 100644
--- a/Tests/test_imagecms.py
+++ b/Tests/test_imagecms.py
@@ -639,7 +639,7 @@ def test_rgb_lab(mode):
     assert converted_im.getpixel((0, 0))[:3] == (0, 255, 255)
 
 
-def test_deprecation():
+def test_deprecation() -> None:
     with pytest.warns(DeprecationWarning):
         assert ImageCms.DESCRIPTION.strip().startswith("pyCMS")
     with pytest.warns(DeprecationWarning):

From 08992cf6b18cc3ad1dc9e75088b505450c21388b Mon Sep 17 00:00:00 2001
From: Andrew Murray <radarhere@users.noreply.github.com>
Date: Thu, 11 Jan 2024 20:01:25 +1100
Subject: [PATCH 0068/1178] Update CHANGES.rst [ci skip]

---
 CHANGES.rst | 3 +++
 1 file changed, 3 insertions(+)

diff --git a/CHANGES.rst b/CHANGES.rst
index c267ca472ce..887319dabf8 100644
--- a/CHANGES.rst
+++ b/CHANGES.rst
@@ -5,6 +5,9 @@ Changelog (Pillow)
 10.3.0 (unreleased)
 -------------------
 
+- Deprecate ImageCms constants and versions() function #7702
+  [nulano, radarhere]
+
 - Added PerspectiveTransform #7699
   [radarhere]
 

From bc192557b8de105da5942108d33d643f83513976 Mon Sep 17 00:00:00 2001
From: Andrew Murray <radarhere@users.noreply.github.com>
Date: Thu, 11 Jan 2024 23:11:12 +1100
Subject: [PATCH 0069/1178] Added type hints

---
 pyproject.toml            |  1 -
 src/PIL/ImageMorph.py     | 50 +++++++++++++++++++++++----------------
 src/PIL/_imagingmorph.pyi |  5 ++++
 3 files changed, 35 insertions(+), 21 deletions(-)
 create mode 100644 src/PIL/_imagingmorph.pyi

diff --git a/pyproject.toml b/pyproject.toml
index 54a4bcaec0c..8acfc04204e 100644
--- a/pyproject.toml
+++ b/pyproject.toml
@@ -146,7 +146,6 @@ exclude = [
   '^src/PIL/DdsImagePlugin.py$',
   '^src/PIL/FpxImagePlugin.py$',
   '^src/PIL/Image.py$',
-  '^src/PIL/ImageMorph.py$',
   '^src/PIL/ImageQt.py$',
   '^src/PIL/ImageShow.py$',
   '^src/PIL/ImImagePlugin.py$',
diff --git a/src/PIL/ImageMorph.py b/src/PIL/ImageMorph.py
index 282e7d2a54e..534c6291a02 100644
--- a/src/PIL/ImageMorph.py
+++ b/src/PIL/ImageMorph.py
@@ -62,12 +62,14 @@ class LutBuilder:
 
     """
 
-    def __init__(self, patterns=None, op_name=None):
+    def __init__(
+        self, patterns: list[str] | None = None, op_name: str | None = None
+    ) -> None:
         if patterns is not None:
             self.patterns = patterns
         else:
             self.patterns = []
-        self.lut = None
+        self.lut: bytearray | None = None
         if op_name is not None:
             known_patterns = {
                 "corner": ["1:(... ... ...)->0", "4:(00. 01. ...)->1"],
@@ -87,25 +89,27 @@ def __init__(self, patterns=None, op_name=None):
 
             self.patterns = known_patterns[op_name]
 
-    def add_patterns(self, patterns):
+    def add_patterns(self, patterns: list[str]) -> None:
         self.patterns += patterns
 
-    def build_default_lut(self):
+    def build_default_lut(self) -> None:
         symbols = [0, 1]
         m = 1 << 4  # pos of current pixel
         self.lut = bytearray(symbols[(i & m) > 0] for i in range(LUT_SIZE))
 
-    def get_lut(self):
+    def get_lut(self) -> bytearray | None:
         return self.lut
 
-    def _string_permute(self, pattern, permutation):
+    def _string_permute(self, pattern: str, permutation: list[int]) -> str:
         """string_permute takes a pattern and a permutation and returns the
         string permuted according to the permutation list.
         """
         assert len(permutation) == 9
         return "".join(pattern[p] for p in permutation)
 
-    def _pattern_permute(self, basic_pattern, options, basic_result):
+    def _pattern_permute(
+        self, basic_pattern: str, options: str, basic_result: int
+    ) -> list[tuple[str, int]]:
         """pattern_permute takes a basic pattern and its result and clones
         the pattern according to the modifications described in the $options
         parameter. It returns a list of all cloned patterns."""
@@ -135,12 +139,13 @@ def _pattern_permute(self, basic_pattern, options, basic_result):
 
         return patterns
 
-    def build_lut(self):
+    def build_lut(self) -> bytearray:
         """Compile all patterns into a morphology lut.
 
         TBD :Build based on (file) morphlut:modify_lut
         """
         self.build_default_lut()
+        assert self.lut is not None
         patterns = []
 
         # Parse and create symmetries of the patterns strings
@@ -159,10 +164,10 @@ def build_lut(self):
             patterns += self._pattern_permute(pattern, options, result)
 
         # compile the patterns into regular expressions for speed
-        for i, pattern in enumerate(patterns):
+        compiled_patterns = []
+        for pattern in patterns:
             p = pattern[0].replace(".", "X").replace("X", "[01]")
-            p = re.compile(p)
-            patterns[i] = (p, pattern[1])
+            compiled_patterns.append((re.compile(p), pattern[1]))
 
         # Step through table and find patterns that match.
         # Note that all the patterns are searched. The last one
@@ -172,8 +177,8 @@ def build_lut(self):
             bitpattern = bin(i)[2:]
             bitpattern = ("0" * (9 - len(bitpattern)) + bitpattern)[::-1]
 
-            for p, r in patterns:
-                if p.match(bitpattern):
+            for pattern, r in compiled_patterns:
+                if pattern.match(bitpattern):
                     self.lut[i] = [0, 1][r]
 
         return self.lut
@@ -182,7 +187,12 @@ def build_lut(self):
 class MorphOp:
     """A class for binary morphological operators"""
 
-    def __init__(self, lut=None, op_name=None, patterns=None):
+    def __init__(
+        self,
+        lut: bytearray | None = None,
+        op_name: str | None = None,
+        patterns: list[str] | None = None,
+    ) -> None:
         """Create a binary morphological operator"""
         self.lut = lut
         if op_name is not None:
@@ -190,7 +200,7 @@ def __init__(self, lut=None, op_name=None, patterns=None):
         elif patterns is not None:
             self.lut = LutBuilder(patterns=patterns).build_lut()
 
-    def apply(self, image):
+    def apply(self, image: Image.Image):
         """Run a single morphological operation on an image
 
         Returns a tuple of the number of changed pixels and the
@@ -206,7 +216,7 @@ def apply(self, image):
         count = _imagingmorph.apply(bytes(self.lut), image.im.id, outimage.im.id)
         return count, outimage
 
-    def match(self, image):
+    def match(self, image: Image.Image):
         """Get a list of coordinates matching the morphological operation on
         an image.
 
@@ -221,7 +231,7 @@ def match(self, image):
             raise ValueError(msg)
         return _imagingmorph.match(bytes(self.lut), image.im.id)
 
-    def get_on_pixels(self, image):
+    def get_on_pixels(self, image: Image.Image):
         """Get a list of all turned on pixels in a binary image
 
         Returns a list of tuples of (x,y) coordinates
@@ -232,7 +242,7 @@ def get_on_pixels(self, image):
             raise ValueError(msg)
         return _imagingmorph.get_on_pixels(image.im.id)
 
-    def load_lut(self, filename):
+    def load_lut(self, filename: str) -> None:
         """Load an operator from an mrl file"""
         with open(filename, "rb") as f:
             self.lut = bytearray(f.read())
@@ -242,7 +252,7 @@ def load_lut(self, filename):
             msg = "Wrong size operator file!"
             raise Exception(msg)
 
-    def save_lut(self, filename):
+    def save_lut(self, filename: str) -> None:
         """Save an operator to an mrl file"""
         if self.lut is None:
             msg = "No operator loaded"
@@ -250,6 +260,6 @@ def save_lut(self, filename):
         with open(filename, "wb") as f:
             f.write(self.lut)
 
-    def set_lut(self, lut):
+    def set_lut(self, lut: bytearray | None) -> None:
         """Set the lut from an external source"""
         self.lut = lut
diff --git a/src/PIL/_imagingmorph.pyi b/src/PIL/_imagingmorph.pyi
new file mode 100644
index 00000000000..b0235555dc5
--- /dev/null
+++ b/src/PIL/_imagingmorph.pyi
@@ -0,0 +1,5 @@
+from __future__ import annotations
+
+from typing import Any
+
+def __getattr__(name: str) -> Any: ...

From 067c5f4123c7cab7507fca02605bfd9762861d1f Mon Sep 17 00:00:00 2001
From: Andrew Murray <radarhere@users.noreply.github.com>
Date: Thu, 11 Jan 2024 23:13:29 +1100
Subject: [PATCH 0070/1178] Update CHANGES.rst [ci skip]

---
 CHANGES.rst | 3 +++
 1 file changed, 3 insertions(+)

diff --git a/CHANGES.rst b/CHANGES.rst
index 887319dabf8..62ae2a68bbc 100644
--- a/CHANGES.rst
+++ b/CHANGES.rst
@@ -5,6 +5,9 @@ Changelog (Pillow)
 10.3.0 (unreleased)
 -------------------
 
+- Fix APNG info after seeking backwards more than twice #7701
+  [esoma, radarhere]
+
 - Deprecate ImageCms constants and versions() function #7702
   [nulano, radarhere]
 

From 10cf2f2651eee87c127bbb6d090138506c86fbc6 Mon Sep 17 00:00:00 2001
From: Andrew Murray <radarhere@users.noreply.github.com>
Date: Sat, 13 Jan 2024 14:40:59 +1100
Subject: [PATCH 0071/1178] Added type hints

---
 pyproject.toml       |  1 -
 src/PIL/Image.py     |  6 +++--
 src/PIL/ImageShow.py | 60 ++++++++++++++++++++++++++------------------
 tox.ini              |  1 +
 4 files changed, 40 insertions(+), 28 deletions(-)

diff --git a/pyproject.toml b/pyproject.toml
index 8acfc04204e..789df6f5e67 100644
--- a/pyproject.toml
+++ b/pyproject.toml
@@ -147,7 +147,6 @@ exclude = [
   '^src/PIL/FpxImagePlugin.py$',
   '^src/PIL/Image.py$',
   '^src/PIL/ImageQt.py$',
-  '^src/PIL/ImageShow.py$',
   '^src/PIL/ImImagePlugin.py$',
   '^src/PIL/MicImagePlugin.py$',
   '^src/PIL/PdfParser.py$',
diff --git a/src/PIL/Image.py b/src/PIL/Image.py
index ac13c6c0c25..5ab27c35954 100644
--- a/src/PIL/Image.py
+++ b/src/PIL/Image.py
@@ -242,7 +242,7 @@ def _conv_type_shape(im):
 _MAPMODES = ("L", "P", "RGBX", "RGBA", "CMYK", "I;16", "I;16L", "I;16B")
 
 
-def getmodebase(mode):
+def getmodebase(mode: str) -> str:
     """
     Gets the "base" mode for given mode.  This function returns "L" for
     images that contain grayscale data, and "RGB" for images that
@@ -583,7 +583,9 @@ def _ensure_mutable(self):
         else:
             self.load()
 
-    def _dump(self, file=None, format=None, **options):
+    def _dump(
+        self, file: str | None = None, format: str | None = None, **options
+    ) -> str:
         suffix = ""
         if format:
             suffix = "." + format
diff --git a/src/PIL/ImageShow.py b/src/PIL/ImageShow.py
index fad3e098003..d90545e92ec 100644
--- a/src/PIL/ImageShow.py
+++ b/src/PIL/ImageShow.py
@@ -13,18 +13,20 @@
 #
 from __future__ import annotations
 
+import abc
 import os
 import shutil
 import subprocess
 import sys
 from shlex import quote
+from typing import Any
 
 from . import Image
 
 _viewers = []
 
 
-def register(viewer, order=1):
+def register(viewer, order: int = 1) -> None:
     """
     The :py:func:`register` function is used to register additional viewers::
 
@@ -49,7 +51,7 @@ def register(viewer, order=1):
         _viewers.insert(0, viewer)
 
 
-def show(image, title=None, **options):
+def show(image: Image.Image, title: str | None = None, **options: Any) -> bool:
     r"""
     Display a given image.
 
@@ -69,7 +71,7 @@ class Viewer:
 
     # main api
 
-    def show(self, image, **options):
+    def show(self, image: Image.Image, **options: Any) -> int:
         """
         The main function for displaying an image.
         Converts the given image to the target format and displays it.
@@ -87,16 +89,16 @@ def show(self, image, **options):
 
     # hook methods
 
-    format = None
+    format: str | None = None
     """The format to convert the image into."""
-    options = {}
+    options: dict[str, Any] = {}
     """Additional options used to convert the image."""
 
-    def get_format(self, image):
+    def get_format(self, image: Image.Image) -> str | None:
         """Return format name, or ``None`` to save as PGM/PPM."""
         return self.format
 
-    def get_command(self, file, **options):
+    def get_command(self, file: str, **options: Any) -> str:
         """
         Returns the command used to display the file.
         Not implemented in the base class.
@@ -104,15 +106,15 @@ def get_command(self, file, **options):
         msg = "unavailable in base viewer"
         raise NotImplementedError(msg)
 
-    def save_image(self, image):
+    def save_image(self, image: Image.Image) -> str:
         """Save to temporary file and return filename."""
         return image._dump(format=self.get_format(image), **self.options)
 
-    def show_image(self, image, **options):
+    def show_image(self, image: Image.Image, **options: Any) -> int:
         """Display the given image."""
         return self.show_file(self.save_image(image), **options)
 
-    def show_file(self, path, **options):
+    def show_file(self, path: str, **options: Any) -> int:
         """
         Display given file.
         """
@@ -129,7 +131,7 @@ class WindowsViewer(Viewer):
     format = "PNG"
     options = {"compress_level": 1, "save_all": True}
 
-    def get_command(self, file, **options):
+    def get_command(self, file: str, **options: Any) -> str:
         return (
             f'start "Pillow" /WAIT "{file}" '
             "&& ping -n 4 127.0.0.1 >NUL "
@@ -147,14 +149,14 @@ class MacViewer(Viewer):
     format = "PNG"
     options = {"compress_level": 1, "save_all": True}
 
-    def get_command(self, file, **options):
+    def get_command(self, file: str, **options: Any) -> str:
         # on darwin open returns immediately resulting in the temp
         # file removal while app is opening
         command = "open -a Preview.app"
         command = f"({command} {quote(file)}; sleep 20; rm -f {quote(file)})&"
         return command
 
-    def show_file(self, path, **options):
+    def show_file(self, path: str, **options: Any) -> int:
         """
         Display given file.
         """
@@ -180,7 +182,11 @@ class UnixViewer(Viewer):
     format = "PNG"
     options = {"compress_level": 1, "save_all": True}
 
-    def get_command(self, file, **options):
+    @abc.abstractmethod
+    def get_command_ex(self, file: str, **options: Any) -> tuple[str, str]:
+        pass
+
+    def get_command(self, file: str, **options: Any) -> str:
         command = self.get_command_ex(file, **options)[0]
         return f"({command} {quote(file)}"
 
@@ -190,11 +196,11 @@ class XDGViewer(UnixViewer):
     The freedesktop.org ``xdg-open`` command.
     """
 
-    def get_command_ex(self, file, **options):
+    def get_command_ex(self, file: str, **options: Any) -> tuple[str, str]:
         command = executable = "xdg-open"
         return command, executable
 
-    def show_file(self, path, **options):
+    def show_file(self, path: str, **options: Any) -> int:
         """
         Display given file.
         """
@@ -208,13 +214,15 @@ class DisplayViewer(UnixViewer):
     This viewer supports the ``title`` parameter.
     """
 
-    def get_command_ex(self, file, title=None, **options):
+    def get_command_ex(
+        self, file: str, title: str | None = None, **options: Any
+    ) -> tuple[str, str]:
         command = executable = "display"
         if title:
             command += f" -title {quote(title)}"
         return command, executable
 
-    def show_file(self, path, **options):
+    def show_file(self, path: str, **options: Any) -> int:
         """
         Display given file.
         """
@@ -231,12 +239,12 @@ def show_file(self, path, **options):
 class GmDisplayViewer(UnixViewer):
     """The GraphicsMagick ``gm display`` command."""
 
-    def get_command_ex(self, file, **options):
+    def get_command_ex(self, file: str, **options: Any) -> tuple[str, str]:
         executable = "gm"
         command = "gm display"
         return command, executable
 
-    def show_file(self, path, **options):
+    def show_file(self, path: str, **options: Any) -> int:
         """
         Display given file.
         """
@@ -247,12 +255,12 @@ def show_file(self, path, **options):
 class EogViewer(UnixViewer):
     """The GNOME Image Viewer ``eog`` command."""
 
-    def get_command_ex(self, file, **options):
+    def get_command_ex(self, file: str, **options: Any) -> tuple[str, str]:
         executable = "eog"
         command = "eog -n"
         return command, executable
 
-    def show_file(self, path, **options):
+    def show_file(self, path: str, **options: Any) -> int:
         """
         Display given file.
         """
@@ -266,7 +274,9 @@ class XVViewer(UnixViewer):
     This viewer supports the ``title`` parameter.
     """
 
-    def get_command_ex(self, file, title=None, **options):
+    def get_command_ex(
+        self, file: str, title: str | None = None, **options: Any
+    ) -> tuple[str, str]:
         # note: xv is pretty outdated.  most modern systems have
         # imagemagick's display command instead.
         command = executable = "xv"
@@ -274,7 +284,7 @@ def get_command_ex(self, file, title=None, **options):
             command += f" -name {quote(title)}"
         return command, executable
 
-    def show_file(self, path, **options):
+    def show_file(self, path: str, **options: Any) -> int:
         """
         Display given file.
         """
@@ -304,7 +314,7 @@ def show_file(self, path, **options):
 class IPythonViewer(Viewer):
     """The viewer for IPython frontends."""
 
-    def show_image(self, image, **options):
+    def show_image(self, image: Image.Image, **options: Any) -> int:
         ipython_display(image)
         return 1
 
diff --git a/tox.ini b/tox.ini
index d89d017e45c..fb6746ce7bf 100644
--- a/tox.ini
+++ b/tox.ini
@@ -33,6 +33,7 @@ commands =
 [testenv:mypy]
 skip_install = true
 deps =
+    ipython
     mypy==1.7.1
     numpy
 extras =

From ffd0363b65ca05870f9306e8a6e999d58d9725ae Mon Sep 17 00:00:00 2001
From: Andrew Murray <radarhere@users.noreply.github.com>
Date: Sat, 13 Jan 2024 16:26:15 +1100
Subject: [PATCH 0072/1178] Added type hints

---
 src/PIL/FitsImagePlugin.py | 8 +++++---
 src/PIL/Image.py           | 2 +-
 2 files changed, 6 insertions(+), 4 deletions(-)

diff --git a/src/PIL/FitsImagePlugin.py b/src/PIL/FitsImagePlugin.py
index 7dce2d60f76..e69890babcc 100644
--- a/src/PIL/FitsImagePlugin.py
+++ b/src/PIL/FitsImagePlugin.py
@@ -15,7 +15,7 @@
 from . import Image, ImageFile
 
 
-def _accept(prefix):
+def _accept(prefix: bytes) -> bool:
     return prefix[:6] == b"SIMPLE"
 
 
@@ -23,8 +23,10 @@ class FitsImageFile(ImageFile.ImageFile):
     format = "FITS"
     format_description = "FITS"
 
-    def _open(self):
-        headers = {}
+    def _open(self) -> None:
+        assert self.fp is not None
+
+        headers: dict[bytes, bytes] = {}
         while True:
             header = self.fp.read(80)
             if not header:
diff --git a/src/PIL/Image.py b/src/PIL/Image.py
index ac13c6c0c25..b2520d57c5a 100644
--- a/src/PIL/Image.py
+++ b/src/PIL/Image.py
@@ -3484,7 +3484,7 @@ def register_extension(id, extension) -> None:
     EXTENSION[extension.lower()] = id.upper()
 
 
-def register_extensions(id, extensions):
+def register_extensions(id, extensions) -> None:
     """
     Registers image extensions.  This function should not be
     used in application code.

From 2fbd7dda839fb1cb4d9ba0a1e9abecf34e4786ec Mon Sep 17 00:00:00 2001
From: Andrew Murray <radarhere@users.noreply.github.com>
Date: Sat, 13 Jan 2024 21:10:02 +1100
Subject: [PATCH 0073/1178] Use consistent arguments for load_seek

---
 src/PIL/EpsImagePlugin.py | 2 +-
 src/PIL/IcoImagePlugin.py | 2 +-
 2 files changed, 2 insertions(+), 2 deletions(-)

diff --git a/src/PIL/EpsImagePlugin.py b/src/PIL/EpsImagePlugin.py
index d2e60aa0759..690fb3586a7 100644
--- a/src/PIL/EpsImagePlugin.py
+++ b/src/PIL/EpsImagePlugin.py
@@ -408,7 +408,7 @@ def load(self, scale=1, transparency=False):
             self.tile = []
         return Image.Image.load(self)
 
-    def load_seek(self, *args, **kwargs):
+    def load_seek(self, pos):
         # we can't incrementally load, so force ImageFile.parser to
         # use our custom load method by defining this method.
         pass
diff --git a/src/PIL/IcoImagePlugin.py b/src/PIL/IcoImagePlugin.py
index 1b22f8645dc..2b21d957fd2 100644
--- a/src/PIL/IcoImagePlugin.py
+++ b/src/PIL/IcoImagePlugin.py
@@ -339,7 +339,7 @@ def load(self):
 
             self.size = im.size
 
-    def load_seek(self):
+    def load_seek(self, pos):
         # Flag the ImageFile.Parser so that it
         # just does all the decode at the end.
         pass

From 543b5a674160c86d8b128e0af6c706a2e96c16d7 Mon Sep 17 00:00:00 2001
From: Andrew Murray <radarhere@users.noreply.github.com>
Date: Sat, 13 Jan 2024 21:11:16 +1100
Subject: [PATCH 0074/1178] Use consistent arguments for load_read

---
 src/PIL/ImageFile.py      | 2 +-
 src/PIL/XpmImagePlugin.py | 2 +-
 2 files changed, 2 insertions(+), 2 deletions(-)

diff --git a/src/PIL/ImageFile.py b/src/PIL/ImageFile.py
index 0923979af8b..17b1b3203e6 100644
--- a/src/PIL/ImageFile.py
+++ b/src/PIL/ImageFile.py
@@ -328,7 +328,7 @@ def load_end(self):
     #     pass
 
     # may be defined for blocked formats (e.g. PNG)
-    # def load_read(self, bytes):
+    # def load_read(self, read_bytes):
     #     pass
 
     def _seek_check(self, frame):
diff --git a/src/PIL/XpmImagePlugin.py b/src/PIL/XpmImagePlugin.py
index bf73c9bef06..3125f8d52c6 100644
--- a/src/PIL/XpmImagePlugin.py
+++ b/src/PIL/XpmImagePlugin.py
@@ -103,7 +103,7 @@ def _open(self):
 
         self.tile = [("raw", (0, 0) + self.size, self.fp.tell(), ("P", 0, 1))]
 
-    def load_read(self, bytes):
+    def load_read(self, read_bytes):
         #
         # load all image data in one chunk
 

From c97b5c6f7a221ed534d93e943992e44c2a7ec5fa Mon Sep 17 00:00:00 2001
From: Andrew Murray <radarhere@users.noreply.github.com>
Date: Sun, 14 Jan 2024 22:29:56 +1100
Subject: [PATCH 0075/1178] Exclude abstract method code from coverage

---
 src/PIL/ImageShow.py | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/src/PIL/ImageShow.py b/src/PIL/ImageShow.py
index d90545e92ec..c03122c11aa 100644
--- a/src/PIL/ImageShow.py
+++ b/src/PIL/ImageShow.py
@@ -184,7 +184,7 @@ class UnixViewer(Viewer):
 
     @abc.abstractmethod
     def get_command_ex(self, file: str, **options: Any) -> tuple[str, str]:
-        pass
+        pass  # pragma: no cover
 
     def get_command(self, file: str, **options: Any) -> str:
         command = self.get_command_ex(file, **options)[0]

From c75a93b9a35e0835cc44465d5a73a9a05be0d166 Mon Sep 17 00:00:00 2001
From: Andrew Murray <radarhere@users.noreply.github.com>
Date: Mon, 15 Jan 2024 16:11:48 +1100
Subject: [PATCH 0076/1178] Added type hints

---
 src/PIL/Image.py              |  4 ++--
 src/PIL/ImageFile.py          |  2 +-
 src/PIL/ImagePalette.py       |  2 +-
 src/PIL/McIdasImagePlugin.py  |  8 +++++---
 src/PIL/PcdImagePlugin.py     |  8 ++++++--
 src/PIL/PcxImagePlugin.py     | 10 +++++++---
 src/PIL/PixarImagePlugin.py   |  6 ++++--
 src/PIL/SunImagePlugin.py     |  6 ++++--
 src/PIL/XVThumbImagePlugin.py |  6 ++++--
 src/PIL/XbmImagePlugin.py     |  9 ++++++---
 10 files changed, 40 insertions(+), 21 deletions(-)

diff --git a/src/PIL/Image.py b/src/PIL/Image.py
index c1f89af4616..e32f254de8e 100644
--- a/src/PIL/Image.py
+++ b/src/PIL/Image.py
@@ -3437,7 +3437,7 @@ def register_open(id, factory, accept=None) -> None:
     OPEN[id] = factory, accept
 
 
-def register_mime(id, mimetype):
+def register_mime(id, mimetype) -> None:
     """
     Registers an image MIME type by populating ``Image.MIME``. This function
     should not be used in application code.
@@ -3452,7 +3452,7 @@ def register_mime(id, mimetype):
     MIME[id.upper()] = mimetype
 
 
-def register_save(id, driver):
+def register_save(id, driver) -> None:
     """
     Registers an image save function.  This function should not be
     used in application code.
diff --git a/src/PIL/ImageFile.py b/src/PIL/ImageFile.py
index 0923979af8b..72c3c03c51a 100644
--- a/src/PIL/ImageFile.py
+++ b/src/PIL/ImageFile.py
@@ -514,7 +514,7 @@ def close(self):
 # --------------------------------------------------------------------
 
 
-def _save(im, fp, tile, bufsize=0):
+def _save(im, fp, tile, bufsize=0) -> None:
     """Helper to save image based on tile list
 
     :param im: Image object.
diff --git a/src/PIL/ImagePalette.py b/src/PIL/ImagePalette.py
index fbcfa309d29..2b6cecc6105 100644
--- a/src/PIL/ImagePalette.py
+++ b/src/PIL/ImagePalette.py
@@ -192,7 +192,7 @@ def save(self, fp):
 # Internal
 
 
-def raw(rawmode, data):
+def raw(rawmode, data) -> ImagePalette:
     palette = ImagePalette()
     palette.rawmode = rawmode
     palette.palette = data
diff --git a/src/PIL/McIdasImagePlugin.py b/src/PIL/McIdasImagePlugin.py
index 9a85c0d15b0..27972236c0a 100644
--- a/src/PIL/McIdasImagePlugin.py
+++ b/src/PIL/McIdasImagePlugin.py
@@ -22,8 +22,8 @@
 from . import Image, ImageFile
 
 
-def _accept(s):
-    return s[:8] == b"\x00\x00\x00\x00\x00\x00\x00\x04"
+def _accept(prefix: bytes) -> bool:
+    return prefix[:8] == b"\x00\x00\x00\x00\x00\x00\x00\x04"
 
 
 ##
@@ -34,8 +34,10 @@ class McIdasImageFile(ImageFile.ImageFile):
     format = "MCIDAS"
     format_description = "McIdas area file"
 
-    def _open(self):
+    def _open(self) -> None:
         # parse area file directory
+        assert self.fp is not None
+
         s = self.fp.read(256)
         if not _accept(s) or len(s) != 256:
             msg = "not an McIdas area file"
diff --git a/src/PIL/PcdImagePlugin.py b/src/PIL/PcdImagePlugin.py
index a0515b302eb..1cd5c4a9dbe 100644
--- a/src/PIL/PcdImagePlugin.py
+++ b/src/PIL/PcdImagePlugin.py
@@ -27,8 +27,10 @@ class PcdImageFile(ImageFile.ImageFile):
     format = "PCD"
     format_description = "Kodak PhotoCD"
 
-    def _open(self):
+    def _open(self) -> None:
         # rough
+        assert self.fp is not None
+
         self.fp.seek(2048)
         s = self.fp.read(2048)
 
@@ -47,9 +49,11 @@ def _open(self):
         self._size = 768, 512  # FIXME: not correct for rotated images!
         self.tile = [("pcd", (0, 0) + self.size, 96 * 2048, None)]
 
-    def load_end(self):
+    def load_end(self) -> None:
         if self.tile_post_rotate:
             # Handle rotated PCDs
+            assert self.im is not None
+
             self.im = self.im.rotate(self.tile_post_rotate)
             self._size = self.im.size
 
diff --git a/src/PIL/PcxImagePlugin.py b/src/PIL/PcxImagePlugin.py
index 98ecefd0514..3e0968a8386 100644
--- a/src/PIL/PcxImagePlugin.py
+++ b/src/PIL/PcxImagePlugin.py
@@ -37,7 +37,7 @@
 logger = logging.getLogger(__name__)
 
 
-def _accept(prefix):
+def _accept(prefix: bytes) -> bool:
     return prefix[0] == 10 and prefix[1] in [0, 2, 3, 5]
 
 
@@ -49,8 +49,10 @@ class PcxImageFile(ImageFile.ImageFile):
     format = "PCX"
     format_description = "Paintbrush"
 
-    def _open(self):
+    def _open(self) -> None:
         # header
+        assert self.fp is not None
+
         s = self.fp.read(128)
         if not _accept(s):
             msg = "not a PCX file"
@@ -141,7 +143,7 @@ def _open(self):
 }
 
 
-def _save(im, fp, filename):
+def _save(im: Image.Image, fp: io.BytesIO, filename: str) -> None:
     try:
         version, bits, planes, rawmode = SAVE[im.mode]
     except KeyError as e:
@@ -199,6 +201,8 @@ def _save(im, fp, filename):
 
     if im.mode == "P":
         # colour palette
+        assert im.im is not None
+
         fp.write(o8(12))
         palette = im.im.getpalette("RGB", "RGB")
         palette += b"\x00" * (768 - len(palette))
diff --git a/src/PIL/PixarImagePlugin.py b/src/PIL/PixarImagePlugin.py
index af866feb362..887b6568bf7 100644
--- a/src/PIL/PixarImagePlugin.py
+++ b/src/PIL/PixarImagePlugin.py
@@ -27,7 +27,7 @@
 # helpers
 
 
-def _accept(prefix):
+def _accept(prefix: bytes) -> bool:
     return prefix[:4] == b"\200\350\000\000"
 
 
@@ -39,8 +39,10 @@ class PixarImageFile(ImageFile.ImageFile):
     format = "PIXAR"
     format_description = "PIXAR raster image"
 
-    def _open(self):
+    def _open(self) -> None:
         # assuming a 4-byte magic label
+        assert self.fp is not None
+
         s = self.fp.read(4)
         if not _accept(s):
             msg = "not a PIXAR file"
diff --git a/src/PIL/SunImagePlugin.py b/src/PIL/SunImagePlugin.py
index 11ce3dfefd0..4e098474ab9 100644
--- a/src/PIL/SunImagePlugin.py
+++ b/src/PIL/SunImagePlugin.py
@@ -21,7 +21,7 @@
 from ._binary import i32be as i32
 
 
-def _accept(prefix):
+def _accept(prefix: bytes) -> bool:
     return len(prefix) >= 4 and i32(prefix) == 0x59A66A95
 
 
@@ -33,7 +33,7 @@ class SunImageFile(ImageFile.ImageFile):
     format = "SUN"
     format_description = "Sun Raster File"
 
-    def _open(self):
+    def _open(self) -> None:
         # The Sun Raster file header is 32 bytes in length
         # and has the following format:
 
@@ -49,6 +49,8 @@ def _open(self):
         #         DWORD ColorMapLength;   /* Size of the color map in bytes */
         #     } SUNRASTER;
 
+        assert self.fp is not None
+
         # HEAD
         s = self.fp.read(32)
         if not _accept(s):
diff --git a/src/PIL/XVThumbImagePlugin.py b/src/PIL/XVThumbImagePlugin.py
index 47ba1c54803..c84adaca215 100644
--- a/src/PIL/XVThumbImagePlugin.py
+++ b/src/PIL/XVThumbImagePlugin.py
@@ -33,7 +33,7 @@
             )
 
 
-def _accept(prefix):
+def _accept(prefix: bytes) -> bool:
     return prefix[:6] == _MAGIC
 
 
@@ -45,8 +45,10 @@ class XVThumbImageFile(ImageFile.ImageFile):
     format = "XVThumb"
     format_description = "XV thumbnail image"
 
-    def _open(self):
+    def _open(self) -> None:
         # check magic
+        assert self.fp is not None
+
         if not _accept(self.fp.read(6)):
             msg = "not an XV thumbnail file"
             raise SyntaxError(msg)
diff --git a/src/PIL/XbmImagePlugin.py b/src/PIL/XbmImagePlugin.py
index 566acbfe5af..0291e2858ac 100644
--- a/src/PIL/XbmImagePlugin.py
+++ b/src/PIL/XbmImagePlugin.py
@@ -21,6 +21,7 @@
 from __future__ import annotations
 
 import re
+from io import BytesIO
 
 from . import Image, ImageFile
 
@@ -36,7 +37,7 @@
 )
 
 
-def _accept(prefix):
+def _accept(prefix: bytes) -> bool:
     return prefix.lstrip()[:7] == b"#define"
 
 
@@ -48,7 +49,9 @@ class XbmImageFile(ImageFile.ImageFile):
     format = "XBM"
     format_description = "X11 Bitmap"
 
-    def _open(self):
+    def _open(self) -> None:
+        assert self.fp is not None
+
         m = xbm_head.match(self.fp.read(512))
 
         if not m:
@@ -67,7 +70,7 @@ def _open(self):
         self.tile = [("xbm", (0, 0) + self.size, m.end(), None)]
 
 
-def _save(im, fp, filename):
+def _save(im: Image.Image, fp: BytesIO, filename: str) -> None:
     if im.mode != "1":
         msg = f"cannot write mode {im.mode} as XBM"
         raise OSError(msg)

From 575edbefe49641107b7315b3113e35c6b74f9bca Mon Sep 17 00:00:00 2001
From: Andrew Murray <3112309+radarhere@users.noreply.github.com>
Date: Mon, 15 Jan 2024 18:25:31 +1100
Subject: [PATCH 0077/1178] Added type hints

Co-authored-by: Hugo van Kemenade <1324225+hugovk@users.noreply.github.com>
---
 src/PIL/Image.py | 4 ++--
 1 file changed, 2 insertions(+), 2 deletions(-)

diff --git a/src/PIL/Image.py b/src/PIL/Image.py
index e32f254de8e..3f35bf50e1e 100644
--- a/src/PIL/Image.py
+++ b/src/PIL/Image.py
@@ -3437,7 +3437,7 @@ def register_open(id, factory, accept=None) -> None:
     OPEN[id] = factory, accept
 
 
-def register_mime(id, mimetype) -> None:
+def register_mime(id: str, mimetype: str) -> None:
     """
     Registers an image MIME type by populating ``Image.MIME``. This function
     should not be used in application code.
@@ -3452,7 +3452,7 @@ def register_mime(id, mimetype) -> None:
     MIME[id.upper()] = mimetype
 
 
-def register_save(id, driver) -> None:
+def register_save(id: str, driver) -> None:
     """
     Registers an image save function.  This function should not be
     used in application code.

From 4a6cb0f8447869ce886db1cde088723b55df32a2 Mon Sep 17 00:00:00 2001
From: Andrew Murray <radarhere@users.noreply.github.com>
Date: Mon, 15 Jan 2024 20:04:51 +1100
Subject: [PATCH 0078/1178] Added type hints

---
 src/PIL/ImtImagePlugin.py | 4 +++-
 1 file changed, 3 insertions(+), 1 deletion(-)

diff --git a/src/PIL/ImtImagePlugin.py b/src/PIL/ImtImagePlugin.py
index 7469c592dd2..abb3fb762e7 100644
--- a/src/PIL/ImtImagePlugin.py
+++ b/src/PIL/ImtImagePlugin.py
@@ -33,10 +33,12 @@ class ImtImageFile(ImageFile.ImageFile):
     format = "IMT"
     format_description = "IM Tools"
 
-    def _open(self):
+    def _open(self) -> None:
         # Quick rejection: if there's not a LF among the first
         # 100 bytes, this is (probably) not a text header.
 
+        assert self.fp is not None
+
         buffer = self.fp.read(100)
         if b"\n" not in buffer:
             msg = "not an IM file"

From 6a2bdb6feb921fae4160c26e63e2ff541c4a7738 Mon Sep 17 00:00:00 2001
From: Andrew Murray <radarhere@users.noreply.github.com>
Date: Tue, 16 Jan 2024 09:00:40 +1100
Subject: [PATCH 0079/1178] Added type hints

---
 src/PIL/Image.py          |  2 +-
 src/PIL/ImageFile.py      |  2 +-
 src/PIL/MspImagePlugin.py | 12 ++++++++----
 3 files changed, 10 insertions(+), 6 deletions(-)

diff --git a/src/PIL/Image.py b/src/PIL/Image.py
index 3f35bf50e1e..b7bb514acc5 100644
--- a/src/PIL/Image.py
+++ b/src/PIL/Image.py
@@ -3507,7 +3507,7 @@ def registered_extensions():
     return EXTENSION
 
 
-def register_decoder(name, decoder):
+def register_decoder(name: str, decoder) -> None:
     """
     Registers an image decoder.  This function should not be
     used in application code.
diff --git a/src/PIL/ImageFile.py b/src/PIL/ImageFile.py
index 72c3c03c51a..b79f2707b5a 100644
--- a/src/PIL/ImageFile.py
+++ b/src/PIL/ImageFile.py
@@ -713,7 +713,7 @@ def decode(self, buffer):
         msg = "unavailable in base decoder"
         raise NotImplementedError(msg)
 
-    def set_as_raw(self, data, rawmode=None):
+    def set_as_raw(self, data: bytes, rawmode = None) -> None:
         """
         Convenience method to set the internal image from a stream of raw data
 
diff --git a/src/PIL/MspImagePlugin.py b/src/PIL/MspImagePlugin.py
index 77dac65b6b3..bb7e466a790 100644
--- a/src/PIL/MspImagePlugin.py
+++ b/src/PIL/MspImagePlugin.py
@@ -35,7 +35,7 @@
 # read MSP files
 
 
-def _accept(prefix):
+def _accept(prefix: bytes) -> bool:
     return prefix[:4] in [b"DanM", b"LinS"]
 
 
@@ -48,8 +48,10 @@ class MspImageFile(ImageFile.ImageFile):
     format = "MSP"
     format_description = "Windows Paint"
 
-    def _open(self):
+    def _open(self) -> None:
         # Header
+        assert self.fp is not None
+
         s = self.fp.read(32)
         if not _accept(s):
             msg = "not an MSP file"
@@ -109,7 +111,9 @@ class MspDecoder(ImageFile.PyDecoder):
 
     _pulls_fd = True
 
-    def decode(self, buffer):
+    def decode(self, buffer: bytes) -> tuple[int, int]:
+        assert self.fd is not None
+
         img = io.BytesIO()
         blank_line = bytearray((0xFF,) * ((self.state.xsize + 7) // 8))
         try:
@@ -159,7 +163,7 @@ def decode(self, buffer):
 # write MSP files (uncompressed only)
 
 
-def _save(im, fp, filename):
+def _save(im: Image.Image, fp: io.BytesIO, filename: str) -> None:
     if im.mode != "1":
         msg = f"cannot write mode {im.mode} as MSP"
         raise OSError(msg)

From edaf7acdb3581e20cc7e77b631db736782cd8a15 Mon Sep 17 00:00:00 2001
From: "pre-commit-ci[bot]"
 <66853113+pre-commit-ci[bot]@users.noreply.github.com>
Date: Mon, 15 Jan 2024 22:01:17 +0000
Subject: [PATCH 0080/1178] [pre-commit.ci] auto fixes from pre-commit.com
 hooks

for more information, see https://pre-commit.ci
---
 src/PIL/ImageFile.py | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/src/PIL/ImageFile.py b/src/PIL/ImageFile.py
index b79f2707b5a..40353da677b 100644
--- a/src/PIL/ImageFile.py
+++ b/src/PIL/ImageFile.py
@@ -713,7 +713,7 @@ def decode(self, buffer):
         msg = "unavailable in base decoder"
         raise NotImplementedError(msg)
 
-    def set_as_raw(self, data: bytes, rawmode = None) -> None:
+    def set_as_raw(self, data: bytes, rawmode=None) -> None:
         """
         Convenience method to set the internal image from a stream of raw data
 

From 5a587193c7ed360cc0705ae81c4628e990420384 Mon Sep 17 00:00:00 2001
From: Andrew Murray <radarhere@users.noreply.github.com>
Date: Tue, 16 Jan 2024 12:22:59 +1100
Subject: [PATCH 0081/1178] Added type hints

---
 src/PIL/Image.py          |  8 ++++----
 src/PIL/SgiImagePlugin.py | 18 ++++++++++++------
 2 files changed, 16 insertions(+), 10 deletions(-)

diff --git a/src/PIL/Image.py b/src/PIL/Image.py
index b7bb514acc5..ec1cff89636 100644
--- a/src/PIL/Image.py
+++ b/src/PIL/Image.py
@@ -710,7 +710,7 @@ def __setstate__(self, state):
             self.putpalette(palette)
         self.frombytes(data)
 
-    def tobytes(self, encoder_name="raw", *args):
+    def tobytes(self, encoder_name: str = "raw", *args) -> bytes:
         """
         Return image as a bytes object.
 
@@ -788,7 +788,7 @@ def tobitmap(self, name="image"):
             ]
         )
 
-    def frombytes(self, data, decoder_name="raw", *args):
+    def frombytes(self, data: bytes, decoder_name: str = "raw", *args) -> None:
         """
         Loads this image with pixel data from a bytes object.
 
@@ -1297,7 +1297,7 @@ def filter(self, filter):
         ]
         return merge(self.mode, ims)
 
-    def getbands(self):
+    def getbands(self) -> tuple[str, ...]:
         """
         Returns a tuple containing the name of each band in this image.
         For example, ``getbands`` on an RGB image returns ("R", "G", "B").
@@ -2495,7 +2495,7 @@ def show(self, title=None):
 
         _show(self, title=title)
 
-    def split(self):
+    def split(self) -> tuple[Image, ...]:
         """
         Split this image into individual bands. This method returns a
         tuple of individual image bands from an image. For example,
diff --git a/src/PIL/SgiImagePlugin.py b/src/PIL/SgiImagePlugin.py
index f9a10f6109c..ccf661ff1f3 100644
--- a/src/PIL/SgiImagePlugin.py
+++ b/src/PIL/SgiImagePlugin.py
@@ -24,13 +24,14 @@
 
 import os
 import struct
+from io import BytesIO
 
 from . import Image, ImageFile
 from ._binary import i16be as i16
 from ._binary import o8
 
 
-def _accept(prefix):
+def _accept(prefix: bytes) -> bool:
     return len(prefix) >= 2 and i16(prefix) == 474
 
 
@@ -52,8 +53,10 @@ class SgiImageFile(ImageFile.ImageFile):
     format = "SGI"
     format_description = "SGI Image File Format"
 
-    def _open(self):
+    def _open(self) -> None:
         # HEAD
+        assert self.fp is not None
+
         headlen = 512
         s = self.fp.read(headlen)
 
@@ -122,7 +125,7 @@ def _open(self):
             ]
 
 
-def _save(im, fp, filename):
+def _save(im: Image.Image, fp: BytesIO, filename: str) -> None:
     if im.mode not in {"RGB", "RGBA", "L"}:
         msg = "Unsupported SGI image mode"
         raise ValueError(msg)
@@ -168,8 +171,8 @@ def _save(im, fp, filename):
     # Maximum Byte value (255 = 8bits per pixel)
     pinmax = 255
     # Image name (79 characters max, truncated below in write)
-    img_name = os.path.splitext(os.path.basename(filename))[0]
-    img_name = img_name.encode("ascii", "ignore")
+    filename = os.path.basename(filename)
+    img_name = os.path.splitext(filename)[0].encode("ascii", "ignore")
     # Standard representation of pixel in the file
     colormap = 0
     fp.write(struct.pack(">h", magic_number))
@@ -201,7 +204,10 @@ def _save(im, fp, filename):
 class SGI16Decoder(ImageFile.PyDecoder):
     _pulls_fd = True
 
-    def decode(self, buffer):
+    def decode(self, buffer: bytes) -> tuple[int, int]:
+        assert self.fd is not None
+        assert self.im is not None
+
         rawmode, stride, orientation = self.args
         pagesize = self.state.xsize * self.state.ysize
         zsize = len(self.mode)

From e2aa0fd4996b85334df3831c2df9bf2d5f68dadd Mon Sep 17 00:00:00 2001
From: Andrew Murray <radarhere@users.noreply.github.com>
Date: Tue, 16 Jan 2024 12:55:48 +1100
Subject: [PATCH 0082/1178] Changed ops to be static

---
 src/PIL/ImageMath.py | 15 ++++++++++-----
 1 file changed, 10 insertions(+), 5 deletions(-)

diff --git a/src/PIL/ImageMath.py b/src/PIL/ImageMath.py
index bc3318c04f4..a7652f237ed 100644
--- a/src/PIL/ImageMath.py
+++ b/src/PIL/ImageMath.py
@@ -224,10 +224,15 @@ def imagemath_convert(self: _Operand, mode: str) -> _Operand:
     return _Operand(self.im.convert(mode))
 
 
-ops = {}
-for k, v in list(globals().items()):
-    if k[:10] == "imagemath_":
-        ops[k[10:]] = v
+ops = {
+    "int": imagemath_int,
+    "float": imagemath_float,
+    "equal": imagemath_equal,
+    "notequal": imagemath_notequal,
+    "min": imagemath_min,
+    "max": imagemath_max,
+    "convert": imagemath_convert,
+}
 
 
 def eval(expression: str, _dict: dict[str, Any] = {}, **kw: Any) -> Any:
@@ -244,7 +249,7 @@ def eval(expression: str, _dict: dict[str, Any] = {}, **kw: Any) -> Any:
     """
 
     # build execution namespace
-    args = ops.copy()
+    args: dict[str, Any] = ops.copy()
     for k in list(_dict.keys()) + list(kw.keys()):
         if "__" in k or hasattr(builtins, k):
             msg = f"'{k}' not allowed"

From 44e77a22b572a3ffe158a8b4b63c218ae549b8ac Mon Sep 17 00:00:00 2001
From: FangFuxin <38530078+lajiyuan@users.noreply.github.com>
Date: Fri, 12 Jan 2024 15:46:49 +0800
Subject: [PATCH 0083/1178] Fix png image plugin load_end func handle truncated
 file.

---
 Tests/images/end_trunc_file.png | Bin 0 -> 30339 bytes
 Tests/test_file_png.py          |   9 +++++++++
 src/PIL/PngImagePlugin.py       |   8 +++++++-
 3 files changed, 16 insertions(+), 1 deletion(-)
 create mode 100644 Tests/images/end_trunc_file.png

diff --git a/Tests/images/end_trunc_file.png b/Tests/images/end_trunc_file.png
new file mode 100644
index 0000000000000000000000000000000000000000..5e88c5e4fa2a6ac010219a2469b83efa21102f0e
GIT binary patch
literal 30339
zcmV)=K!m@EP)<h;3K|Lk000e1NJLTq004jh004jp0ssI2OkDPy004GQNkl<Zc$|#=
zcbF#GRTzw)bMC#B-q^V(&+N?3hMCQ~$}25eNy|z?fF*;lKoSz443<r_F}AS52rvfQ
zqz_pZA_*aZBv3*^ah1d7ytA`2vy-Q%^P4K(d(Zj(QQbYgGb6s=efsIAy1L$atIj<+
z;^fqw-rJ%mnypAF1!&W(rzmN~yHTRN95|mxQ6S))b4Ev6cL`PHhDAB_Vi6I@gh7Ka
z7Uzp>&~Bj5&;P3*yX#kf<==esOCR0WmZibK&m8>J*Pi_IzxY(AI|I(y<)>b-WALl*
z`nliytIvM*;ge(CE8p-#KlWp<fBh9ZCz>7S?Futn#LCm-&zyVP&-`lC+_C@QOZ%zw
zT0nsbwfE96?aC?d!(ldTx3H`-VI4#XgE#;dbix2YU=edIMoHIT;IR;J-~|APv>+lX
zA!G(dU=S2Q77`!<5%I);2mpu(mn;#f|5Yyl5Dy|kC`w^yj4`B$5Cu^HfB{9sF^Y%)
zA)>Btgd_kYA^;*HBA(eJc#--?>Tdx;W`_zzSi}Rc2!IeXS2l}-*cjtn8OG7{)a?ED
zKlsHjd};d+y!1VP@_&!Ju^rdE?CPrzo;Yzn9}Xv@W~fVNfiO&>vBibn2S4=DqfZ{W
z^ZTB6`-`r;>YANek%%~uW*Dog>@Uo@;ZmX_)U?`P9c6<kio#?pGEFZ*+|btNkwO*4
zS>;RTgD65o^g<v(6ewa>ig#8Jm4@el3=s$cfCvPH5P$_y5C8-bg@{;WGpsM&j2dM1
zd993yfOrvMX77d8z6Sw-keHc>Hg5nU$@&HgGcY?s&)^ZP7t7!oJR%Apf?{^47|;QF
z07gVX5%5XUcBOOP2MV<c`lIv{pZe^%ljkbOLDXD6o}F5GI4`3p>};7GPv=&<ovA=I
zdn;}<fFz#L)cn?W9zXQdlOOtE^`7_qkG*@Z&{`YDE!~Nq{)r#^gFk-%p>O>Y1)=jr
zUW~TPOe_xit7PIvGq1QkHQkz;ZBFjaogM4WF7-!Y)F|^jBu(O=vI1TKP)J4_>zoLI
z0zd>H1Q1{WQA&vb00;r%8fw)$MTpG20qz=B8$hqm$oeL&?+pTo_rBggBH~S(hfp67
zB5IbZ{um+xT(~ciN7w)~01yZQkRT%gA|ncdM^u0)B1)-3DiHxxrFD-y{P^7ILpNSE
z86|O1m6avyAux%pd_ffn_If>~lvYind{qJg24SPB@`c4-I<j#x{{Hv9Z*_I`x`Q|T
z<KO?CvV$Zt*<g`<b^G&fx$%Yr-j<I(^6<jq5}{-(gTd;F(Nhoa+W!)<cDymxTV2*V
zAR-YEksu0!AgBr&3<hx{B4hv{L<9l=20<1Pf%?2KAOZ>~1ONd9ks4<=pbr4dyg>&W
zTLJ*y`!!q^5n$#u`q;RhfdFJ<J2kUkyQxr(0Eh|+5CK7u7)91UphQ4`*ICvDq!5wb
zU^Nb#8p5g?De=diJ(c!*>fqKvwlYk6%1k>4jX(u~uF9Oa+P!B>Sq;yeK1+HMDJpEy
zN<#0Y)#<jn6OTXs)Sv&^UoR~!<$2m}x1&H5rvK$#Ki?k>@44rmq!GU39q)YiZ~ofj
zAAkHu|J6?(xbgbG{qUb1KY4cX&=<qT_A9S_(eCcneqMPMuqKbnv2{gdAnvrAmNP*F
zAOHkZHM>AWV2>z(3<w|u1Z!_CT*G;t>8x>SQm_e*_1*vov1cLz0zhOCCrr)>;MxX|
z2JiqV05xCI0v<slA`xv68X^jK0FNj&p8+9Z6kcOEYYa|25ehOOD`k|zvhtqA7&RKD
zh}y9vNkj&95E+WSxT?sda$CBI(oTmIghq=_s~kyrU#4kqY`hURlVAJQUn@Oll~p<@
zU2(@tU-XB6^uHSu6F}izcfay;pZ{Vs(Z2P?w_S77!8g6}ZD{a^Ui19V|I_Dx?N|S|
z%IWkIU%%qOt=;z2N?v)?L8nbYnC338%D^Zz1R?+kh#)ohAOO$IfF2PAxd!E$P?Za;
zLpBKmrIc)1>pS6*2#`1SMg*L5o&^yF5gFE)`T8OfRwx=tA(9X>h+r*-fxU=dzfu7Z
zfJPt$1wtYUSk<gaMB+I1-dk&xLJ(pg)CN#xMMfI)ta28#){RCSgw!7_S9Vm{6oAug
z=(%XMwNN=e-E`=Voj&oJfAPAX`gcFAlZZ9F^{3war+@w4L9z6q55Bjze0s;e9sll^
zf3EWW`+nf=H@)@8!H=GO?7riN554q7FM8j5-xFwGW~Xkrw)NH@z4cWu+P-@dOwp4f
z3zQDy2#rD%L_ic+({u>dUJVEk1#lgh9>fb0(Pj=)??ioavjpB?P(-w`Nq{H-9>jWa
z3?c}C0ti5BKo-$!w?{$5n%yIN5%JywDR|EI5&$47B8})k2t*?*Bmhw9XrxtOj6&qB
z$U2E8(Pe2-DP!WwQqX7!t27;kN+oe~%a-YEG|aM0>m-VmwL=v5idWwCZ-4f!d-v_o
zD)`;s`CpdpfrD3huHN#NAKkZa>)hPgkNy2ewr$({;_tibg)e!rgZ#7K{Q3i5`bIwJ
zU2||xUby=oJa)^i*MISzd;a00ANZ+vyz#}iUzb<#z~jqb`OYIxKYM;;z0whacoY^T
z;sL1!3Lp|F003YV0s)TzLV{3pe`dZ^2Gr+kwsAqN5`YUT6A+OAV=Yw>1OT6_N@<ON
z1aJDWH+|+apY7+F7pIgG=aoTY!lFd)T(i+Ab0~bNlw#-OFtP<36;{4Nq^k0yeHex!
ztTdHHNr=|F$dDpU7?n8&y5l5a2T|0OD)SyjqeAOY0k#^+u;@)rj{o03dH?gCcWoGh
zbr}GhI(;+>@Y!dcJbCoNfA`Kezwr52-}1bh%OU*D-+cTB?s(ym<3}6a;J_6-@W6o|
zd&k=r&pcc>|K#C6{M2VZF+R1sH!SXd@Ud6i^)gcMqT42(f7_i8J<<E<-+yU-aRp3V
z3g#s=I^)aBX}ddSt#u9+X+R(V1`w<fTmixc^w&93Z9tIseuE%3Hh_rOc_Jb*wKiYN
zWFTY#@WS8#Y89qtDxg7JGiko*$NuH{^XKlr_uhr&l^{gxB#M$O&5JAxqKKJC=^zRl
zfE<RgwYDY&rIal#5{5>Rum`rb(pn`!LtM%%g>~Wqg@6%21MoW1Frh(ENPc<g%<Xr+
z@IC+UAI?rq7y~xznM8Y=_Lk0yEyB<!q2cNZx_tHQNu%0t`<b_cnY^*tf(8J?4L7~0
zJbR+q2&%!*XxOoJ=G@#8gwfF>hwr@WWs!kFRy337wu9ZhTi)>P`=0#lJ@@59mjo@b
zMXMQARaF*M(ukeSQK;5>K#+hKYMqE{UU8A`zgY#^q(-j&S(Al`2!enBOU;^4;G#vg
zDuk;>Vt)I#{!0>5BOzzgiScea8YpF&jdo~EHXO`Mb)6l0pBDMRRz(zOan_c37@Bso
zk!K@qFwlg+>@BlnX4Gp$Z4@YE1cxXhmeF}|tyW9G17xrJf!ja+_kX@)N83OK)yOF3
z{_^6fqpNeL#+r%C3iR~VFMnhEmYu`?D9^HVeqrh8skt-DPd|G6)U#*O<%NM8J@Dwm
z#+YomSM>VZr@ND_AP&3&Yb|$@NHIjfTPMmNxbv!?e#`52%`}bV0hNkekq^hm$FnpS
zMiH#l*7b#(`TKK)?FE$I_`N176%s*h`l2EtLR5lEP%)4o2@(LU^K&GlBrq@-EKE#<
z|MFkH=0z{O`On_}e_r&0TQm|1uoLgS3GiRM{<ZC{0U5>-1R)|hrJ32fDo=;KFi_6s
zp35LmNWLfv5kXMQOy~n6hy`GY!~zb<6G0F}qrq^;j;Z&*{|{}k2rvX54(5)3<rDw#
zwa<U9=r4=Q&z(K#z2uqet>*9fKYy0AyTiO_%x;~$;>s<1uD<%<ZL{0=H72K~c5d6g
zbK8CQfA{q1Q=`@X()qdG`7<Y<emq?|7n4<NZMq7O1B}9;y!qh7JKp@m?bvhC6PtHC
zjb49Mhk+ON!cG`G3$u7;X7OCBe4EYS4T896tzq=Kd=^}{57q_vMOW5KM<EqikNvRO
zgrEI)Z_lgz*t17hR~C#0TX_;tij0;Qz38S>r=R@V*T0!%i;bjR6uF3RHgyn~`Gv(+
zI966pYb_v=(UlZLR8_9Z3xym643G*B1ez=r5~G4VE2Aj-^Y{OWrcn?R4;DWCk&iE*
zUs*W6c;EfsK6(DcsIYO|isD99IScChf8bw;4)1^DySh2EbI&vc;1vd@1;vWb)B7I$
z_DgU7zL&iGj(fiJfX!7iXgvJQufP9)+wXh%%V)RmnAv|Vuyd85fhte0-re}&yI=aj
zzyCtPsw~l%hGkn5D?n|I5df1gK&}7RHWb(P?S}HR&T}@10|Af)xi-I85S3u<wpsfW
z0|9_S+}I5rC;IJg|H(ajw&d9Wm5n1lb>it`#}2XU8XXe_j#F=4cPx43T`&34J)dqi
z#{jEW-SyHi3_tzJPY(P2$;oz>7mZeX>$V+7o_U5)DWw4FZzb{)5VBOBD+JHXiU5GJ
z)L*s#`k5`$K+>B#{k}hbPygKVgWrAV_{noBgw#UNfZSHO?RVRggW>AE_usd)GIQh2
z*L2(A;{2(p?fc8z2Ab!NJdM1(fA8*oZ*eeODa*Xu-rDaioSz^3*`L1uLm&K$J6`_E
zSKRdj*WGgK?6y4^K#~xEfBr4|zx>VboFAH{QDFsxq-D#Bgx1Z`HFhlsBD`5?*;t!t
zV&ja65UC9$mre3{LoeFQz5sxJ_jlg?mY@7r?M~Ea=pf+I4jz5%fyKqSAT(O*EX%B|
z;w0#_qg!si`o%A~`T85K`qMxC!(aS`pI%x#C0ry8Q&uA+J3i6*7eD;EiHWYYRz%o~
z(IGI37mb>P00<!v)*wbCv@V*S+ykbQ5AxrB_wU~G`LBNLL;raC)PiH`m++d`-}#0g
z|Iy||H)zED!JyM=Ih(%rHFxaW*-clD-uu<R@1K1vQA6$ez4>zi$W7N?bM@XmVADoS
zdDUa(Ey1f_|3j9NuYc>IU;6o9{x84yE1&qwKYRS1e*!zmd*^Mj`uZP!_43kOr=5h6
zcCJDcAgLLK!nK21JHM3AY!(KWZV9cgb+JIC6$1*=W@DnhQU_7PRvsa;&TA8nkIlaD
z1uwntJ4cTk&Y~a+0@vxrVNm7i!p_}OzyEu`(dleSNA8PX_}YUHJ{ZPPnwLdUHj-9k
z_;s(n<Lh7k)T4trMIgY&w9~8*K|+lHgzAD(gTcT?*xFK#?EC)e1E2WBXVcZZ6GlJs
zFMl+(*>@iP<~P6fwV(eFzXX1G%~e--8{MOaA3cBe*~cDyz-VBvZoTQimp}KZuYK#j
zMx*h{m%LbfxZFz{t!Aqk1;$RzjGsEQwEw`a-TStcZgl6%?`X%ZkAL(dPe1zYs}EfJ
z!)M;~iXV7GL(yzIxoZ3P>6Q6VbreO`D_L`}(3+P81qES~3HJZFHuRs`!&)B`5GX`h
zv#Kxph<?XAeraZQ{8it7`+xm!|HWB)`q0tw@qOF2U322dql&6P53jlA%Aa`C8?L!>
zRydDBR(2)p7w>!T`!u!EvI^pOI9z0LlU*~@fgig2c}E_<XUDGXFS-4d|MdCqs-PgP
zbQn0Wh4V^E6R^v3(ZPa5-#mQo(Wf5!{Xcv!1BGL4^x+-f|B9Wv+CP!KDlbQej~@Q}
zzxiJ~cI;|5nu|;Gg#3XId|+XI`D<Uhud+e6JDZLyga7guzmPQ56??b5<*h&Q6K{Rf
zZ~WGkVXN`AFMd90n8zM_?5kh?s6zAf6VKfH-OpZk;NaoI$N%T={Q+b5wLkdAK{dL0
z_hh>CxYa&&5z$0uQAbHt6>(^6Rgf?M5vrQY0}CQ*TJt~<Y7qgc5g!q-MlPTWM6>2!
z1rkJKU=#WaAPWK@YL@8yeE-PN)6VJp?tSz({@ZUAg&X#A$2>jO{Drsu`@8Rc@%C-g
zWjP3<n4POi`<_4g!}+uGjw3{~w6wf+>vTGpkBtD2?!4n>l7D^6ZO{Mw7r)(KT~?9v
z-YSJi0_XuPp;O{2XTR{x?|$SnpKK+Dlq;&d({5+Z|LU**`cM4$-JOp4zz6>FSN_w#
z-?wMyqmMr1oV)SHn_HcUU-*Upq~eK3?tlD~pZMI7qbDDI<j~B_%x$+Fc+-#n$idrg
zvV$d~CCmCppM2zHFME+M^Fxn4dhW!DPG_v!N<Q|Hzgt*XdfQLE^W1#;JHP!uW@q*k
z79M}_8;{@r@M4D7KJOJlv#n6E2QT131VLEV9A}#p&<&NemZO_Q@j8#X;M-ppCP<sF
z+<Y-2>QP!vO?S&m(#(G4tKT?s^n?hy5+c)0N9FwwJhEfgG?CuEecIZbMdfMnvX{Q<
zp06I_)b$3#MiiF$Vk6-z_wH^cF;~%5`}Z!*Fa6`E|H)a1JE5~xXb8a}IAn`r9hc5$
zQ3%Z>1aOF`0+SboWO!~Ke&aX)-<g@_)~&Oj`~3aC`R+ejURnI3Kl+2yXGU}PA3JmQ
z{9}(keQs_k9lBO$VtiuD^wi9=N6!5I|M-(TUiRWnxA}tS-KY)T^H1OT@Bi(8?Ym+x
zBL4SZ|M$~V`lT;@`A_`#Tb7oVfAQ!4lQ+%Z``>@^AK&#Wr{|UiSyqbC-RUPDd*J35
zY&9yX&>?z2A_5{+M+J}o_<|f>*Fozo!HWRO@Ei-d#&<-x5MJ1{VE~}DPOQV#)%?_%
z`LBQNyNV)a&We%vDvrZXedeFO^_{O?b>+Tyz3V^Sdh-o}-09-&FP?tc%O3mqr#|0G
zl8Kr2O*d`5>G~`0e)(M}JU@4q2tM(NPoF+DConl2r0lHGAimOpN2#hR_dXMwuV#Zr
z!zjSYRfR3XFlaWrrSoxXYHp!-_WZHK#};<)+*-QqU;mr`Ohg_)k+D|NtW4rg<xW?n
z>kWp!9NDToa_mH!4qJ^#X=yd%B#B;p`(0rezWOz9{LSC|%};;kE1&qsuYCVqcVBt%
z;7303*UQ6xo-G%p594Gs$j}z2jvcw`U_a<2Btj^4un&=tYP)HTr$3hh)`BV*f%_tv
zy!p?~6mUTXgmFgztk>WC=7YzMp8?QbyfTqzSRD+FX)dn}4<9}2eVk_aTfg<YW3BN!
zUw-#n-}3)F@Zh22C!bYN*?ibaOjV}+-pb6(%*t}_!G|9uG6IIkv8%KK_PIt6KC{I@
zsuIODlF-^zkfJ1l5USFZ;z#|_*u;d@E%5BH@#x_*NfHaYG)==W^io7&;&cd6QjM~(
z)mq6%VQ56t$>n}vl(RBi>C?h$tJVDI=f1jo_wF~n=}o`$o<IGszxr#BKK9thzVPMz
zGymjRNJs2dWqklnY1La<(5<bjE9WPZ4pT%(-ZOYcBBfNVv2TJSfLul&t?dI5AVrtZ
z${M;~s!aiaUhSo0<IUC8^lv}>_f-W^6qGg-k*LuSa9VMc#KU2Qx^@49hd=wducw3T
zum1Xzw?6O1+qUm`=IEjM^ZoO4k3D$bH~ycuyzMP-ev_sojN322^RAD4?DNi3TI9}E
zai|Ccq^hj9E;Hf*T~QWs9F}F7_4CGf(^pb@o|xV;7>vR&_Gssq`^{!!m{uZwYGRv+
z<at_D9)RW-7YMZglx68ahUusgM~LeDa=+P1*ttROzj^P&nZ+M`!@pWuTFSD_gkdku
z!#F9$y0Qp$5+-q841=htg|vb!T~*)(L@5#krZvCsW<Sq5tS@Fq8)N|hwRXRGt!tdm
zVLlsspquS3X|>uP4$^FLdi!WJuzskFvfdhF7ME8iCdZo1NyOyCfA=?|On@Q^lJDI6
zFex?xrRgv*dSy91aq3LFGyeEvPonC){tZ9!<!?TG`0!$TOj~OkNurckTUyRpDs7at
z97RECs~`$pDQRiZ1WE<-OUunT$<tAiB+a<By1G0)HeszjcV;dK0<B4F9fqMeuQiG-
zv;tq*Mw}RhMNw!S2xD(`Xad#i^^ZS$Domm*%c3Ys2g9sj44H}0C>HeIS5@U?lr$%D
zn-g;sm_i7(_TY&$fk7YvzZu*B0BgoUeMlEMN;lZdMRL2oWIgi%Hnxh&vI>I8dt^^}
zR%snXQB+h_RTa)vjaEC$tqNLCA36Q`FMUH)SPG3wms=T(iptp_ioGLJt*zVktn|zO
z_4|MJj-UR8`yP7iHLrbbqti}{)HxSKMr-Y)vbIEIG769#`^q~20#u{}2DDz{X2XM5
zkscN!hkk5qe13Ha6rl-#uyQ^t@}-sK!d7`zj`FN5OV2jX^M1cy6h*(^UszZQg1}iu
zP+{B{4Ra)Aomdakv(uIJNI_9rQl_+3yWLKrxXe@WP7!EAsspY7h)NikpTjpU%R@HK
z)W+8)U*4MI_ab-R<^=#66=p?BN^4^rizafuG64pGcFtASHk&Ok^v8elUR1#-&!Q-H
z0-`j47B*#-6T}EIKDp;x-+t;_-+gSDXTS5m{%~SumdQJ|gLFu!EnDk7C?dkbTQb@~
z6@+nVy@2+PJ%czV0?UOC5EIO}KnHQVk@>=cb)b|{%pfFMD=Xd;Fp6HwTp$rK#sEN7
zIT2tKU%4QNyf`bM!)TCZ3?u?NNUUeA0&7d9gD?z76)O;hsE}B|I*wvv8KNk%uGq-x
zS+k~OlXGnozga`=HCQtMC_*AaSaZ*@FtY~$Btk%T^#+g!Fl($$sNOd3t+l1rL4X0G
z8jZ5Dg1m6rL=`ilA_PGaG=Kphi_l7+Kl-r`l|G6aQGc}3%T6Ihtw>i@rM0fZ7qw^u
z@d8j;AIE`!;;MAcYaIkyDI%pcqh)4UGbEMPx)~;ASt1G%h!E5sd+;J+t))89hoWj@
zNTCQg?=_MT3TwySIY+3KGL>bvjxaz4!t8vh0v(y4C<<UvN|Dx#wNvu~|F0pqj^Gz$
zz;k5-Y`W&3GoClg5{<$HB7g*{&J6?4z%0VG7tniet18PKB8PFaa25dp8AuQUgwSIS
zs6O?XuRnY2Osg|Fw{Y4DwmON3lvP^UqT6bE??E98FnAC|;AXRJt*weeDHVoFoVVG)
zil_*fD<X=602KMkaaFMMS_C$721M#)Dg@Mu*71&kSy(_AL_!mI@#0014o$!y0>nrW
zffX>QBTb&gdhflr-WEksvk_28Yf*Dp_XS-(7pMmK25+e^*oX;loLoz7;k8d~+8YJ{
z4d?}U?P5UWwSZ2bHH(yG83sn{z&Wo>zzB$XBQ=8o{TfliQ%^nH?oMR+PzQ0SLli0U
z;drdTa~uT#pa`rNMyT^#>K8VoK$we4yib&Bgds>_y|~h;$|*%P1QfgVC?FxCV_)MM
z0<gD;s6Y^f6e5B`L?r8-W#<K0ym!iqFrX;yk<hU~<wXPfK$9nBS*oh4V<~<uZ0Bk%
zRDjk3=Ffrq2JT;+FmaK1xCr+*(@njp8pR`f6hKB4g@`C?Q6BJX@i=1)d(>JXqe2A$
zz$JSx-mzFfhp3ZgLxA$qC2_mgUnH!QQp7?m$b!Noj4VWJ`(G4AD@u$e_Kr}L0;x(a
ziWWjU!lc~@O%Mb@6oy)B1z1&8Q50T~ne#knX40BP;<y2dqQHcqX(T}shhZ3Kt+ffV
zqU;aTrQUF9wci_zD(fqDSrCvR&055J=MXh21b{S6c`X>gqyUMP5aD`kYf}mYqQVQg
zavKBzHF8`+B5TLIP9huUYg*9&49Fl_xQ^Q+A`zggtkNb>y3S$p-Uq0eSz#S+RtO+a
z0oppDjKP*w-e`6Qg9ULMHxmNyN=G1NmXWY$3&<is1SrsIB)+WJ`alDLm5Mt7ZJi#w
zY44sLQ<Jl^(@Byjf*QL;#CxBnsR&ly_51y*sz@2{y$TGXM1hXusM&~HjW7tbQYtNS
zqySauh5Bi6<oL-)9)0}D<7e}dfs8T+kwCz)6YoU)C>=06P^=V!QtJZO)0$oN9JkLU
z%%nbfVV5pPF`MZ|HWVjKC<Mp?YiVIzb3o;s(<VSv>lzghk+Yr%(IbE+K}D9JU?4#8
zoK;n&R7a~g>4La48|BmOBniT*$c#eq9>4<vFo6J~Xaq#iEKz{7+s0mW<1H_{<(8?Y
zNsI~tjdd&^!Dv!SAxfHON-0EK?GLM}Qpz~z;vfX^ioh63qCjgx@ZS5%1*I43fKhGT
zHobf2_})F!*Pc56*?S*9yD}_BBV!CHBosz5MwQ-@LWhFLhztlQBw&g31}N+7whb@P
zMJ8Cy(-8?T;XD9PC*amOR2w3lh_s<fp<_T1WQ6($fJHpi8I3FiptLBZthL_TI)w(;
zBWolz+4>}joV9_8(sV^@j-qB+^n)nL(p+mID;hispl1|fYsZ_-IFiK3!GpVA^1_?<
z@7&W=I)KU*nJtTED`~eoq0yuO5gdCHsW=Wz6m~{!@7Wl`)@dYWPr$|~6(}Tdt}1Oc
z7z`p6FiTl@k2Ywj{rjfJW+rB@xbo}YedMu69?go}qs{;YSRs+tDlj7GnE@FA5gnjG
zk~&Iui92)65iQ~o>kt9~z`7w!B7Q?eZ*Y7-K)?-wjEMTSoA(@f=G?F{k%`i>Qko!8
z-irc<3IiPi23bBxT5ZeLfrN_LGcXb=ga~+qXcb!TsxWE0%9qy0jZU7fdSD98sIpO`
zm1P!HK~QO>0v(ZqE4FXHZr>j1uS|^vH$Csl*{z*U3nNXCb1RHB86wS2JRy-GrK3=*
zpixx?Skxv73?@kvJdcL`?${Url(rfcWp`>qlT<}M-kx1uT#S)yF=)i$C?CbKM0vS?
zdOW`Qz_sK0@Tt?^dGv&$01f3;6|@tfP!O&2u?~S5v|`TyRLA830BMbZtTFU@Q%FDr
z@IpStx@_3U^Q<}kCg!6QuIEzd|M*Mqc-z~5E)GJ*k>hgDj=kp>S4-OqNO@NjskAzY
zu#|b>2}r4mO9CR)i~yn#jDQ0GB2A>VVdq#xP%8o{y)C^PYql8y0OBZ02br^W|IR(P
zUU#q|R{P+Jt>as|aXX{{DqogSpb=0hZB!7L*qD&CLd3kP08p7Y2m)WZsw~T_^4`a-
zcEtkDD-1(J{gq+vJ&-7*@rf;~XU~Y^DlZU#OKVUxxS6J&zGjz#vhd;kPoJv5gR8XG
z%*==YgpA%IA`|ILwVDliAR<y{*%GYz7({R_-vny(uc=}49csmNBb2YNzi#g@|Hq&H
zt>1oMyA!_cU%%zbYxn=cFaFyq8@9V+VGxF>g^|P<os>Qo2Ios63f4_P0VSY80ube$
zAShD8Tq;FIdnv8bP*fQU1VO7TM{$&Fot?OH&n{OEhUH-QWP5sc0#KZDkwF0pqF5=V
zR7jx8ibuuBImaN4MvPi1L=o^_oCPJq3=1nOkqLC=t5GH*tNqob;b2tdVH}D0u||tf
ziq*n|S`<Y(POB=27#Q~L+qnuWN6#;vTUl;5T2T^)3IvTM9b#a~5*pOnd(Zfsq{IzG
z-oW<_VStDmcJHR0BUlelKKCZI9U$(tuX)vj4?XtQcl_+O?N|NEfBscpjY5S75A46`
zhFkvn&p)QM0aRS&q&$OTDG`idZ9LRpOaP>m5g|cRb<mC+C;)UyGm@YJ>mg0ciB=;H
zj4wuPRJ);Owv4NQ2BV=MYZnv1sfBs#oh@CFJ6|~>og_(=B-^%ci5sy(<Eqj-XOx7I
zDXMDJPbmf|eSdiwO1HeUn0u>3v$!(X?sTX%Mnt=I?O0e^Ov^$%f&w%u8x-1@?K`(!
zwVI9|$yV|_4wORBpqvAT9+B7shzIo?wf!P$*i07n#!#)MZ(19nn9KgwWma{^#((ek
z-rXPBC!cuWzI(q>=A$s6B;<Fz{YSs?r7y3nmcz8nvTAnwWLi2a4v_#HvuAd={vCw6
zPE=J21iW)4kqEgmAC7ltw9?LF((Hx?!Ig0!6WzGmFsP+)RU8LV*ifJ~%S6=7)4{N^
zU>zVSLybVip-OuTfg0BsIuYkw7(}G3=b|&#N&6$eG7#%DK!0WV?Bcu_Q?MKKhh=W3
zre|9%0o9n?GJEXIX(!xlwOd3_9X;WqX%j@Vle2!sHsT=A3NWzN3!w=j5p=GqdHrT^
zU#ewpxS&O(&Q;#*eS<Z>P|c$d0B}8j3lVj<JvJN-D;DqZ!+-NvMLL-1cIM~KOpP}h
zvHZ+W|Jd*R&L2cU`0Cfb`j+S4{Kx<2z1dO*B*0$4A+V}t65AphX@k~*MeC(xZ<#?8
zD20RmDgcCGD30UMT(xKSRlBAXWMM>BfTAR9HnWOtmWGH-c4c+2w760f6#x>EQbYt-
z?A>jQ_BM9Da?WwH8EQ@7guOzx=+iPCt@aoDtD~w?i2XD>cJgc(oT!}7s!GR6fe^M@
zp!N7zHxLV9OiFZ=h?Cd^<K2!nz@AWpD5Ai4?-7(>ZM<Kc{rOyt=%2HGH(w@vftc2W
z@MzEvlgJij5+$~*A`_fHKNo21_ZErr*T4Sd4?Xg&SKRr-H{JT;zxeA9t*$Hp1jqul
zWlJ74d#;#4si2i~i_#C$oS{%81OP1EW~<j*QAEP7%7#&=d&Q3FW*~#XsDOY>V?1aS
z5>}%@TY^d?1z5Ct*{i}503?C#hRs&9aq{$e=W%ut;xGaRtiZ6=p(0mUDF%a;K{^~1
zqs-9B<)u?+=4Ym7XJ@xgk57z>(xNQq*|FnC>|pT9SG;azapmEM?w{Va!xW7;9@7}K
zlW=^jMaY$}Sd;~JF89_MQu;!15^OGsA)-xA|BbMWtXl&$&};sqE*NoY?fhC|1b{Xn
zM~x_mTg$!tUGMrYZ+rVYoUKNK#i_||nfJS`;N8FR%L@y|k!K$J(1$)$W>!o9gd_l1
zS8`h597MXE$=R9qU|5!A-+3WYDC{e5OV^B=fmS}vrzV;^X2-{xT619(4Tkxt`BTTw
zt}OKySI(YmJ6K*=NeLiOVHg=w&ROuTn}p-d#@?M<Voh7e+tcG+0Pt+V5E=@36e%Hc
ztApi-A3J0P_a3<J2jBP;XHT7PCyhoJg>ii1+?ktqZTX*X{F8V8*6)7gqaU9dp8=<r
zm-|W3YPN88a<XK-Yi6>O7z<j0s8Ue+3Ybk4gY_3-w_H*ob1AYv_jpYRUnHE@;sN(R
z^o{4e@cWLR>?Muq>8UNh@C(26?|<oMuf67~pL*NdTFvHYu;Lg1)nEVhU;C1f8wz3&
zC0-&!!%_eCm)<x({|qz#_>aGBVq({Se%EgW<jbPeO0i|50$%~JYZ}uGp%cLk2lmX2
zHy6&X^!vl}%l$*g<|n4NgpB}nw74+$rXTx}SKa;UmDT>qlP6bJR)}EB>|_9Z|GnSH
zd&}Sc$`{;lzQ4TVz<~p#Xt2C$T{-Bj&d<*ud-hDy9{)E#{WFh0bL`y8@O^*&SLq-R
zm7eX4ce|ZyuD^QW)XA@W@*m#*rXP9o;Uj~7apMgK7gkoYDr@Q1Ro7g(GRmjg!NTI{
zu(7Wc2h35Rt*~>I21Ru}(}qa}2#Dg>EB!V~V(@~<eJ-FG0F>HLSe|o%e)iPK-TRh)
z<yU@l(3gEzAAJ7vpLfR{FF*e56M>0}yz)|l(E0iK`|rQE$QwkVcc6?0a3~xG3Ve3^
zi*KEpnmlmzp7*}@1Eb+WQE?JQo*l3VkpgX9uGn3*`-+{@;Y>FvN2_VS*I!vJavlwH
z%S(fFuxqya*0;VT26g{^4;_By=;6bMN9lmsI-5W5#_R8V=?l}|f-6UjQ2DZ$KYxyt
z@*s<g^S;Xai;J_}wvc)7+uvTv{FlFZ?~XnD9-DuBY^vMu_j=3o>2PU!+xXK@J^0Cw
zd}M2TvK#1grw%VJFFCEJ6P%gp-gwo4XvfwQY4GsbUeer(;0tR*r2`XHWqGM34C{jT
zB94ENY}l-%UPJ*Kl0#=1ojTn=dSnr(^VFxl_LZ;R>-`Eq`VXJ{)LY;DquuU=XWp_k
zdez-`ef;D1Y9@pr(4li&*%H{zpFeZe{_)<*`OkgsQ%^kpFd+wutSyyNK@drWicG6B
zuDlPuy<z{glZok_Sz1|GSe{>Ys&U||19@d>vAW~MFU|&i4&q0jIsW94V_BA2TPlU(
z@#zz%`~CjS2lhib>Uq0w@2>u0y3$)QQRrMDE*-3{T(##wS-`N@JM_@w*KXT+<k<0r
zewCQz060>ZEzh~owIem%Zcgu+J-@WFvXt$Z+!7}7Rr|KhG|iDGzTN6AZ@K!##|R6M
zG|i0GVIwIkyD7;29M(~vMqGz`eSX~#yND-kYzg8<(0Hx(RL?KCPk;Iw!&Dm+Cdp);
z57RtVlzr?UKKa_$zPj0LojboUy=BLbzVS_;`{KiMOUou4Q$dJIiG?T%+U<6dB!fZk
zi(mTc-1*hGF>OrT8xBxWpcDZ0hNJP;RH!H+x^C|k>Czc*%>Lb1cn*Tr_?h$lq!l8!
z%Hi@eN0xSN-+A=V6W;Pfw|Vm9Qjy8d9i6?qc22b$58r>^bi3Jz0>5p`YC76?_5Ll}
zwmGTh&mA9ccM{cbglEh7SKo2RVwz7(j32l<FN&OtBG%Fgb)>1?NjlSGV>>3N#-il<
z{Yy(L{oYEkc&eYSoPPSr)khz{qq#NFS7g>HFQ8D18Ww4k#C$ou<|0OaK@wb|^>41T
z+>jz0OF!}CLa$f0T3Z*EhNxB2Y$=xr+ukq}FdzBY7vB5c_r2)$mw*3jf9REWz2dL_
z`tO010FWYE`ZO&OjCVLWvGtCZz49+V@X@?*q^r1*Snn!pBN9fm)+*th(=+AD;Lrn)
zqIHwg(^v1?%PQD9H8nXqxx9F0Y3^({#MRTs_jTgR`7qM^4(^-Xx&?q0_}w$@8+W{{
z(~K0dGUmy{PaM4EIvj5slnGZn{nXPhzUitet!}%ixv<h>C42Yp9;9hm71e0u^E5GP
zVyqJcYG^Yz>UWa3JJw2j%V3meJJo5t?$vkx-N!!Pn>$mC%~;cEwOU!_%gRMbLr5;G
zS8m>b&2pI5asI*u8&p#J;?|MB{?UgH&-MBv<|t{kfRG_8ohN~2bDXI8r7zyQvPxh4
z{6qivxd$d^$1osa$;&L%CX5nrvGZ`|+~W4_+i$q>d9PlqzVM}QvnT>o#(3|ou!(}A
zD$A_w#ErRUPfBLDZ{220P-;la^!jVBiUQ>Z+}<*N?(k`4nbT}64tH$ZcFlDMX0~og
z^HG0!xe*yD@@+Fyjp@nNb7#G9Svj9)s?mtYCa*bob5_|-r@h)AVjwpixHhxpzP;O;
zjkp?Sy`{y4b7!}1+k!@~q&+dpA{M!22Ict5EA~Z6yu3WzIyIrhkyaJ3A!LPx_&9F3
zs{H3S;NmD4JcrS5oZkrG;QFf1>!syY9R#GstFp9}=Uf0#X=UQ?-uw91zy4Gs*(%%|
z43<X4Qfl*7yCX=R8Cbx<;b%@f_4LE7R_l4U^|x%@6UI*>sb01c#(`*H@hS{-0N%sg
zsWYZ)%3(g%><-gGS>|Dgkgtw)#%Ee&8cmuUD+h&YH>PH%W_NDCV$V(>Y&9kmt$Is~
z>1Y%OF~rTqh1D&y+q>gaDs1P2EDocnHTLvlPuzCPO}nn$E2mB#IeBRJ?wz5w*~*|C
zrY=hbTx!c8F&sugkgyZcrrnic%1PYWvU6KuPb#GwjTVNH2R*PAnt%y%b{gx5|8sT$
zzenT?0C25p{(>af5XBd5*qRVlQBYQuHabs-aU;<jIHg$BU|4<NZ$1_TZB$8C_&92p
zz)^r@RwhYHytlSeS`RBHj!IvC@t$u*$y1<=C?XXWl~r1ZsMlW^n`oO5R!4)I_FjE@
z{_I4jxqa)@xz&Xu&mQs<tztzwVc<%>>Z&XIOTEGB;_Q}*vdrh_=SD@j+V7>q(bUA)
z^I!1_$kP7Flc&y|yW*;A!mt6L<D`{mqls-h)sbV1{XruR_uO>D?8?&dV@DPj7graT
zT46jK4z&rZ-qN<oRtQmVX#ivjRWkEfd;IW|M_KDIX{n@1aZ<R-G)z@gT5E;knQ1dG
z`TxV>rM2@HVm0eRn*i2A^BcZA0MM0BNeAp9G7T+MIgdifI?MRz(KAF%;8ZkJu3~_I
zVg)L2kZ~yiXVzD!f}mAdHjG7DG8v7b6%0&-V#!MgtWZ)5bE`{ZQxnV0aC$t+vOzKI
zMPynOaq2tCc;AnLMw8QFu~JoRS?P02OBBXYcjD?BZ`rbQD~NM8ABlB_rnYZoAu<iH
zW!!25!LEJ#&z(Ab{ec5eV%(Ux_V!&c=#NH&mE|Ss_l=^lu`#VRS82mQ;WG3N#m}E!
zIC|(vqtl+;eZ}|{SDh~`#oB;pQogLhAO=myzOG!a*~@0!ui>~>$t`v5EmGY?LM~2M
zS*L@GbtDZ61&~CoUBw>QF*AD<CPqeZ44%cZATtH1Pymn_*%Po*07{W~OF<ar);V7^
zo6V}s6hc54M^O|7gB)hJkCouIY~LEjl;wVPc?kuo%8BJ9NjmNEg0Mh0xotY>G$v-Z
zcc->S?J<?KAT*GruFCby^unR1_Fi*U5GNi%mn9@IaB1^&%N2W9mwQW#tJBldsu4p!
zXVi_(I2#i*8wybgXM<rjN{u!o)%m$oS6y+nnSwLNPAx7hba!9T-m)Xb85M>Ih|GWj
z%)a!2ri(4z8q?QXYivMybN_-%31#iz5;KkJ<_L`7ff+1=WpwLt$P4AKb?qw<3Ic=F
znHwme1+}0S6$hbMM=T(oK&oOy;7LKAXO{g<H*9_9zx|n4-TnPr_Uufn!X%Lup58W_
zbQ)Pz_6B`sFXEe>=G@Zx^Ggezv2J7M4wWRJ35<a#(w$D#>z!MipWL!VMM2n1WL=e3
zNKo0WGqX=V_IPh;8Ad5omUMs&RhAdSw94{yILbz;wKgxS#pTsjXADSReeE^7_UvxA
zTT3fFOGzdscUXB8txXsOCe+$&!0S@~^F<s9*X!;80Dw2@%j($g+GPYt&tYGh8EDOE
z!~zb`A~Ds`9soooK!{94ii8B1JwRQFxmHO_sKs-jR9@Jq5mjt$nMI)zuCj7?=G^I*
zzUZc(c+<68x6VRjcJJRe8Ox!^AK$fa_uhT`72AcS`D}GX6mhKD?c};^5A;_0tII3R
z$svSI@Bj<TMK(%DtKa_4H-UXQ$_$1kND!dv4}wNWaSTAsMx!i>&wlzJZ@KB_@yRjN
z%6cm#t)!JSB5`iT!_v}Hmghn`3?r>gkc0<sIQY!T!wi^8kYnP|h%yMk0Ny+6U2N0_
zL%+z%-7JSM)`c#~qPVE#(<T-q8bApEgZE%PS_TUUjxAw;BFKy+Tzf!pJp--onIph;
z8v;gGIz^;OSuTaEMiONG{>)7G`kStIY~#p)c(0@+8J2l>YOE6`<1-V3{xXCbt#!66
zgxjhyGd5v+*}{p_SjhC2ol2SG$B!@0pFe%(gsY0%@3_5*VZ;ayAdUhj;5-zLORMAN
z9k<`{z<0lU?C>+Eo>eRT9xB|iYy0lKyTMsf2%fVvXB`+FSjX0}W8X{r)|F%J&d{2X
zN}P&G8D3}Z>JqaSFV2Lx;FDO}q;<0a*Nckrf^D#I6WBPTi4@fU24Hr~mc_2g3aLGL
z$gr083&J8&=T0a<kEn?dNSrW&GGuM3l`#9k>gr@G{P8#b@PTWz;>z`kBnmN55C_A4
zzdbhI&x*npXmqpNuAH!S9-MQbQfkZ0?AddRU;D~ey@O`64M52L?8y^%-+kBinQdvF
zxyq_EMHPyxYT|d!QBk?dUVY`&4?pz4^#`wSwHl?Zl2!v1EUzq<wh$2=7!0CeQM5Xp
zAWr((aA9d--@biw9#RNXh$~Sn0KyuTQbc4>{AORmW>{Z@%dqB?xL9Gm?3Ej5GzzV4
z5sMHDct%DbAp|5KCAAM*>SS0Halne1Yl;9O0Q3Y(qer%E0|Vl!hJo*U$@A}g=?fdx
z6TWaRA8C@(Rtw8ZZJUj^r&VdQA|*}A7(`^}!q_N<=av>`Cug_s+ufd;QWUlut)i&T
zoI06R>D1QQlV{JQW!{~f($+RXoR_>v%e;t`nLm3@Gl2EW3(H5IK78BrZkgzGg<zBo
zopV)H0YJ0aPAdyU;sF58FP`7EZ+D{++kuj(!_)){L5R6@;!&LU5{3pYSv7Ot+_mh&
z`AwAp>x(y2z^0D~0BG<I2v9&2)4CsHy}6&%yav#(W#tKj6#y3RMf;jaJhCS)eWi>c
z167r4u-6~F>UDR&vKsVrKZ+G-040oymintfpn9Xx<jiz$u$mTmR^-SK29Zeu4?Znz
zFB^qAo|u|!#vQHA+?lh-Po7v^UHQ^IU!7Z=H*vIm_ii1<-SG*dLnN_fb^6&8`Ec~q
zV~=m2-8y&TRFS7M)04AXw=hbYkHR1lfV|41Bq<<6Yn^is-gp1a2M>;S$BsRFDw;ho
z>OrPZG%AH*pf!P@a?V`}`se8No7mBsO6uXV>w8jwt@3ueTb1mpa(t>?EU$tG9Z+PV
z{%YFpbb}zQD$nAps*1x<DG7}BN@Z0B=(HvlDY*zt<hTe7DTOb(`L;K_<`t8TB*a{U
zI9nPW5Xx{gLL^qogwe5M$Go`vA9--k)}2#v0?sMGq}3WqR@y2ElDy1>vA5EH<iUql
zS65#9gReVr>f~cjKjlTvEi6RMR<qp!09#hBtj4=zD+`Nz_Uw7-OKyMcfd?MA_rcCs
zyR=o@Oo}RRjdimkQ;|jmO5<3k)f<eGBsu!*ksye+?z;Nf+_Q;LMF0rmMZC8R<Ta6F
zhp0B1_Q_guT%Epxb<?H|f$Y3rs~-k{=f;W=YdToZblh-9cUwVO^x5jkiSgdbd80H!
z(C?2_r`zdtsxq_Int;6XM7pY~K&U7x%Q+GQdSOpUjYd=yWfVn7{My&t^_rKxFy_jT
zCw3^F02MMY152ybBK9oUY`3y(^ol!Q*^Zk1lZ(B@^Ok+!{Mgu7Z@FiTa=Gn|mU}C`
z^K)l!yz%C-b|=2(nmt$SWrd~nN1r|R#N$sLId*Dhs(b4#x9r@xGY&#_K8m94yLTNr
zbm)PH9x`FLW$SDh2cyx*6Nfr-&N=6rt<K&n_Ajq21tBc04s~ZDo!4IK27Xd^+yi73
z1Qrs!tT%20=$EQP8-H%_s7)7K_;`JweYq6sq|xe5PK}rO%HqmWqix2=#)>RcNs=^L
ziVTZmCms+1LBM+t;89o;p;&KojhdutC9R+R`G32A?~cLT$(f0c@s)T7EG&+c26n*Q
zY_zMT#ZgwyPEICC(rUK@isJ3@Xf*PiX>9_fLldO^K}f;M+}zVo9o{iLyKmPXSCr1V
zM%+mAY`oFBVgEI|rnfBJyb^}t^z?L|=Ydg`_~q55t=qS~<c^np@t^+bsi&SQt0HbC
zor$sLSj&SDp$?RDE>DY2d;IkL@%HTYr6OFe#A~I5>t?E0doybnkX(S*W*d0(dM;;S
z0J+ff<KoZO97=6$7~OdNo^BI=;$Qvn%wz|}cRQUTE6XgOni$KoepL?2YFHE_r9{L#
z=NLR`(pnLFBhIi_Woc}=V`A*T{_-zfxqF8z^XaL{G#iPqa}|I%=MdMFR!wGcxp(IL
zJSsgsH4BVk9G9S+3c|PnM2w`2F3NJHzw+$K<L4LV4&HDO6)<2BM>;S;6e41))!MaV
z=QUScdHq$_hNR;lB!PCj-5%?jFxatc``#<}E-bFD_IgE8BuQkH9t;L)nwDj$!=RCL
zM#Ca*cUDUK%wjg+NDxVw0I4o800ozD?TY|<X*75<d)Z(z7dfskA|3s&f9hY3M!dAd
zk3D>^&2z^#(x&oNueaQ2HrZPd4<uRcwF-m4IPXC`DOAX0D|Go}5L~f)&ud@zx;9bh
zJ)?*(8;#ieG71A?<trA2Xi#~@mKT>-R@q;%bB9ry8Plx#)_o6l+DRvA^hf>KZDU1$
z5VhlHo;-D8?$pkGyPY8)C<=7a?iAKFn-i|Ak|c^d-LWhMpx9^znO|Pggkh(})&)Uu
z`|Y;_$Y?n1j<vHiRZ1m|C~miwN28_X)$P+dY_v`<obM5&dbUs<FNorqgrSbyG6*5y
z#fr}5@ftP&U1y4}<wij57g~>(ZCoZE0TC34(AE2An+czM_7Hjt-ZhihRi)N?`?i_e
zZn?4D(xiMNG1g^BAcRa<u|<?XQOJ^b-ZeJ%%3E*SH$BrrG~Tx3$lEF_(jbW`FhU4~
zOd^QJ81E%5tNG>SZ{2&}@e?Qez2O(X{MEny$Ui)K_{eg9Ffl#l95)&b5h=?&ilY7d
z_h;ECiXui}W@~K_1SlZRgCL*+ksu5W()9SmSf{JkdS+k{hd11CgE4B)uH91;lVjtZ
zR-@VP_eJE9hadm!XTNa##F_IeeMnj^9v@*t1c@10*o$Xy3{Jp{x(LeO3)452TyAYP
zgE#Xr0MNbOToTDc_kY8?yqP4cgMmW4{<?!N`@WYSK6<3AM#Iq%u-ixiXN$5ZRUC>Y
zL<Y|xNjr=>%5;d*b8|bd+LwFwc~KV$QD_GJ6v2TaR#-W!DMZ8|Y^>U)QI;Qi<}iu=
z)^{HqmM|>KtgO;BH$Y>pcFr>09glbFrVfcz-XEr=J^k#dtSBQB`?6?8;qL7_k}&8k
zFZV~o-e?fEo1j(cZ4d<Ab|)Pb)6>&CcI;@k+vD9a(ZC=IX`webzp%J;zUUR@OMd8O
zM^dvelmf$ulwxrJj0AuP1fT^8xb9+eX_JD>tCgGgN@Tt3^JNz@AnI1sO1VGY9h*Bd
z8jgB#6l7K2ZYRT0?`vQEDk(G89_x=rQQWHXveE3OMHvKyh((^a0%=464F=~A9qQbm
zeAY8z*CGU3TU(4qgLb1KtEj;!@z$n6s5D_C3Q4HfA8Hd_b@jDZR_1j2oyVU!_M%(&
z6Oj__t=qnJM}J|pX<}<_BM#=z%^f;?^xXORIBF0m0wDI!bjFe>Se!rag;`T2Zdi=M
zIQGI@w{D#n8=sw>z4?~wlO&#+9Y4FUurwS<5H&gzS?OlSTf6q}KQXs@rVMrSDsfs!
z11LgO#}frn2!KFpFU;jAU^62BGZrsg?&BLv@0vak^2%K=|Nf^By*~(4!Fk06i~Hs`
zzaB+Vma$`OHm7=nAsXeSiU|S%@4eE2b$LKIrS-z0#}4e@Ui25j$%YU{WU$151TDwD
zK|T*$5lT^|e&Os1U6rBG%F5uxV)~`W=O9dmx?{?fg{9T;P<0z^QKqoG_nK=SdGMh;
z%MKrTc4cv8I83+BZb{;{F=4CGs;X*radoAibtkv%+Ou=}?p=jVv%KGEM3(&^PX}qL
zA}HN(`{ejATUHHXZj=x$Ei5I?Noa&acAfUjbTBzLHweN;SsA8KiP0b^=m|WE7pK))
zRpCamTOG|+O7mJR=~^jdy^z#}{0Uxn9BnE~!n!wCZ6zS;&wTb9-SO$Y`w#5Ba{s*#
zJ`lB=tE1(uTel2GS+9384#z!XncFZ79XkZC0fa?JP%GsXF_X<hSN2Yy+_rxwvjbLA
zH*91f7A+`_5s?)1M#JTm1>=i-Te=S{o|ro`I+;Raa;z0KwF%Qv$t-16RAm+#3QaJ(
zZFYHK@#+Kny>&?#69!rb?bcYc*{(|Oy(CGbMEaw?j>A^a^i`5(y&^B;IP6SK%+Js5
z*t5;r+_UZVGt-{!53AK|=oRW#;)59D>AZ|dD`&k|k$@p)0uR6>;E`#~yKosX;Jx3h
z@56>Ae7Wes2G?3wjW&5hKlR10ed(UB{J`tpaKixzHuuSG&wt|RvDHz3YHIqHn{M$A
z9)0i$Adg<LErUknDvL@3Y0qrM>AIXuJg}g5=Z+sgklh-wcn~ihiO@T=RwVVRv}i`4
z1{J4OHf#J$qQ`I9nb1@EG!%X{@LsGvclzwUnK5kUokpmQ9i}~0g<v){GcoFqoGXLS
z0N8%I<jHrtV~(LWSP4*7t}JuA*h|yFB4Cv?8)FmQiV*;8<ywuTx3Gv5j`~?vRA(1X
zV#48A*O}&Orq3-~r`n2|Op3t^uoFvl7b8?qSB76m{d~>_Y$%#F?tia<%x2fcr5EUL
zKJtWWj(zg;UrLfBt9%efd6pkLcI?W%`zFT5i(C{+U^F=IU8Q5=*aI<&1y>SVW3)m+
zZ-<Ku%csul-G3#EDue-n7(6=%6>INHwALa@D~TIC0@uH4duP{{TVK3VeCfMS96C1e
z49n+NhJ&ixjPoL0Sza7#cR0|MD@#{4+VP;D_D3t;p$9y>aK0#gS=p*6t1LH0C!LlF
zaJ(ID**c>FlNEXCpf=slo}E)@2EDWh!(M-ox-#mHmpU5w(5|}Gk;YDp6et7%2E`~0
zQs=&2KKE@iQeW=R%R~h(+PuwwQoj-(HY}N((IHlzD`!9Sp${$2&$rucr4#@}QN-+w
zLQ>$#0eOua_$qN#gTyESWaa&-r=Nk9UQ#*DjKCz|ye}0MV8!O4&70sFMu4z#wkiuA
zEMGUR|J@J0=x5(>?SWZ1e`0mvd^#Ky;%IfLpJmnR%CM1iypz)M*yPm2)J%JP0<|8b
z*}}^5>S$1SYoZ`4v;MG`+oBRX$cKw7i;K(4s8zeuNpo8kZZs;Y(u1S<#a^Q`9Zhas
zsZ5WPo{LR;22|vn18_(l$crLWgs8MA#YFO)ikA&GqP5;|^=$M=ysW~y0rX3CQ)bp|
zqCxJ$pixw%Evq<Gfo|B!f8k5_lm!bw<rt0k!aCHIs~AKH$KEvoCW$&gikwFdv{^cJ
za_R7~X>*lMG-weGmVID^ONUMZ5yvb=$!xXO1_8y})p;hpwb6XhwO53$Z%0Kj3e4C<
znx^OH7W@7F?wz}|Qmd=0E6am8Zm^&tvuEGl@v%uA1Z7!DS!DT$3A18Uq^qm_)i6%l
z6XU40B30(uWT$)b<XMW^?A7`6z1E(srn%jh%_<nrB%~m&ycc3b54D302w0OK)hW36
z99+JDxkMY-y}3QXMcNTOSAShUzCbjZbX1M{T1m6nbVjn#YEkrCjmEL#&nC?=rCOF*
zoO6JL<ZMX_uqxUN+fBFw%$P7bhYA6N^YZuu56{fZ=*gxeiisFJaTy{<7-~mYvholS
zhKT7PCGSPEcyIGel~vOhQB_W~Czh56A`*1kvokHvq!i7}ZU>g4sI2p|TgInmw;-sZ
zDm8T#xT-2JG~PSsQbcyl9`xK|f7Bneg7Ea*Ley+8461M{LDMZ|IyBp(c+v&qxeHL(
zi#4J4;1S7#0Z~xrmVqD<vj@7&9&FZXHW-dlYbww>xG&GRU{j|#%Cn-~?f^?!6vO@i
z5!;=%5GL)8W${RCjIYDQ$Vfh57Zh2$Dz_TFH3(Z?&^sbv=R?HvhmS&UVDenC6Y(IH
zU77^a2ozdRm2a3JGTPh1xhe<((n<)EB-%1N)oCY#-bxThS!I<8i?RyhBu&#a&$4W^
zxHzvAhLN^aUKJxyE{e2H3~FtyuPUbklOzdgT{(6vMQJ_irPaaN`Ng#II!X$_T~{4c
z(X_*93}<p5Q_unxkXDFwYd8h~L6Ul+z@}jObHN9QSZhHWoM%JQUSy_i{A;soX!Ft<
zz*m(f1aG4-@SIy~fshDUo7{O&+Sd(8oQn~HBHs}u`@(PrsZr)&OQjs55Fj~@H9h{_
z`>y@Lm-~@-o<@V!C>&1C%q*T>9Tdh{gsNzchgk^(;L$SMAWVjti@KAm<?(Y1i?<fp
z<d&KFb7vb#ys)wu1$t#=X?(n!v_i(xdta1J^%(ou>5M5d{nZpnhbB-IAWM;thQqY-
zu)NwI4oBsnKQTVu&$E$pD)MaNB$=(SVL38E%aidUT9fy=)~Xce*%SJ@c!gQC!p)sJ
zF5QgH8qPZ6Z>j*;XypA|*|2$gv=UIl3Q&O8x>u6`K~YsvqahOJStaZO#fmugZrTL1
zq{aoBVk34eVg&7){Z0z-%!%XEXHPfxYz<VhH0beI9!03J7%tCMrHCs)l=rqd*_=On
zw9}4E9I{s<#xzd0T(@W2-Ye(NpBQF&S(e;si$sGg*I_VWOj%V$QCRjAgd$QowpOx{
zZ!|mF!QyI<q!e(Yv|Q>9dj0&^vE%I|JaPI=Yi#1cZ7-cG@$WzVk3aO2|DivsELhJT
z;>0LZW_=x)swx?TNC+I&s=p$jwOqD;egiIr>}JmM&q!tf&`MYd5Fi7S03!;aAd=Er
zYg>w9A1f7-koRq8_r$Gf&mH23J(5Ra&47%Wj8cXPm-@@co_Xfx9aF0E5rDHfkYgTY
zX;oxcRh9LImE<<<j<*1+xDl-`kDfSl`a5S9{^*Z>i|taBbQ<lc<42DiefCVZ)kNUI
zs00Y3DDoJ4@cp45rX!JISvaE`EoaCSMVW#t2z_tRpIclxGrv3-rl(G>b~>#CH{aHo
znmBxP;mE0DfBUh&eBt-KzS$Ztk-bA^YBr{_yblPZ9M%m}xB{vBT3jX|T(1i;vP%N=
zo7JI<JV=+>09wzUAlV2WtGaon%?n?t&~qZrxGbc6TV!TQjWH+e6jXp-2+0#m?Lb#K
zTN9eI$B$muzfQz=<4B3)Dq|@HS&&Lw6;&0)QJCQT{8D#p{CuwGitwZN9OALDgD-i>
zS3mrJr=!N?#O#^V=Z_ve@$}$yyB&;mTEo;$PE6}CC@MP`WxZZsX>ClL#9kH#)?4<a
z;sRWe75OMD=NDI3dc$rjyzRE<PfSf!jy*!|%45$yeP;PDzVEId-L?1Dv>aj3EOQry
z4eJE31hiQ506-Q3=F1ibTtopI8qW8EGF(g?n=D~jt8oG^$Ov_o93ldX1_?m|cFn44
zVKp7AD>}`_$R*wdWKo<a=S9RTMpX*1co8Rxi{;hq{P}LMojGf_k-(}rE+{W4EPYis
zQ!g!N9P4n$=^_2`-#xTgz}w&PBS%jjJ9GM6ch?pWb;X`5i`?FS|D%3TrNv-So^8wx
z^U`H`IT#hz`=rroG#W}Rr=!7WG$gjI7}~LEM4<}8Ac!W%^-ErO>(;GXQEMR_jD|$u
zxma90^$&mdXLo*o|JE1WT|!y19t}rvBM>me9?27tXvIQxisC=BE~gr8f;e8#h`!ey
zwBT9=f*^T77N~C$lGYvq??YR4!S8A%TUyw%g{qukQR0xC6Yl{%k^}Uly@)YX<wZNv
z{WEi0_Ut+{zqDmChA?imY?>~WDR`$)x0aR%4KOy@aqqG8?>_tRvW0@of$MKsT$np`
z`uI(Ix8>lQtz`F}oh!Xn=cRPsdRXk|XXh5O%9kFHjPxDgvH}tI&bm;6R`JYqr`u`+
zAY-v>&+gqj_7r*EZgn$eV~jDTpQR>jvF&~Nvwv3<`SV_Sw^6O>scxE=h)O{y;(&n(
z9Ft=o5Pq*csKI*KCUKiL=5oZbnF4@3Ab|JvaL9Vs7zMo8vZ)%A&DMm=XEcsixgD$`
zCP-w!1BfSZEEPaSSSbvR(jXz}2Gi=PISnuvrWkYpqGn{>Xy`Mx)|9Ssd{HKnsZV_Q
zn-3o?Ic`=MBf*ZXyI^$g{M@rq{F1Vget)1t-nnOMnwK6`UP@MR&sr|L&8_p8mZdAL
zLTJW8qt)y-!Ywmn+qX~0T4!mhqgFF%q{Cse(;W2&@s{q))O40*t@i97t+a81?(?7i
zvu95qdeslTC82GV)qzPgg&@j_0|y>}rJm?;89}@mxR*v<*8g>xT&{~L07(GW+OXGy
zY><S&8Kib2*gv~<SCr7)nIv6mp@$$yD+izrkf2y$4_u%tQ7mw%lPb+;;)WXzmzS3E
zys$zJTeb>3H40EA>b_M=oE#s8@Bi~Jrvf7tm8A)TD9?s*t2I8pV^rkUS3p8a8e!OO
zMCouaHa;CE&_PpLzp^^8<!b7k4o%#QsH&P#&`#pXb~4^>2HG%t=Ultp-ZDMqY~hi_
znElt?__a@bQ3s8zuyGWz<j!Z!Bs})?eSiMmxvLMp;CU~6g-*IEY9c5WCPbr@K?BZi
z0vFZ39sxj9>owUIiXf%V+yvN2KiT-Cz@~&DfsI-w4Uic!ih};Ij3Qn63WdelW=H?X
z54`H`+g>s_a`c|Rda4tV$!%5TMkj`l#DG`C2xv>~N_1Ll@mc77IZT^ToB<5-N>pQ5
zB_kf6x4oX3I&@<G#QF3uzI`}{pn%wGQ;G5no-)-2Z0I0q1>Lc;%PV88HiFi!3@bmK
zG^MgC2uf>bLT!v{O?C&)&D*@NRZ~$@`)**zjGbx*4TDQ718tzy3bl4=o+a_b%&z@r
zdgls9xo(nU=PD#rsF{5P!h>^9eETyGf9*3{c3yew^Im-2jW1}nCk9!LrHYcIBJdtP
zv(}nOdk}Ws2_vql|13^C1F%8>tf!vTIIUsLCSX7Y&mta$0T96;0*C@2t;E~P0YMOI
zW3(4=&hFkh`BQIx(@j@j1^vwVbnpIMy{DfB079J>xiNvEI3T4J89_}|DbD7liG##M
zP`Q=7DlzC=3C6ZQa%|;WhtE9t*faM%w78msQ;@L&lejwR5dq0*Bf<`Vl?puS`KA8W
zscl2IYSX+G#tLb9I50+4&MI5A!$30#a;XE;O(ugNaIO`aiEgVI1!XZ}S9IE)ZaW@~
z`t8Z7N}H>1eZkN)&M)^JkOmJR#2|>mqJWhY3al}~XzBPDK7IOYU;g~{x4iI0FTQhf
zVtRRXSw}4-)JR^ucMeb)qZ5;q&I&LI5NK9T{00N62iGb@T5EAC0KioDX=9Rlw%D4t
zl{7H2XE7oMbDKF|b{fHJUipfvue_quikFvHe54M(@V1BgEBWb@7#a?YQ>OAt7@T$D
zg#-;_BW|jaic*50p<0nO_@xIQJG^xI(8=?xAuFL`(2>HRsXRF#0u2Blo)C-&TUyF}
z)DGv*EzZv@W!us%6H_bJ_4-Sra@d||7p3#wdA4C3Rm>sDIMBr8SW|$DEDUrU$4V)w
zd=#i=BPwi_bjF;Cc3pKnBwb(Pu-_+dMSR^54mO+w42YhDvtcg?TN=s-zH!gDzVemp
zuD|&ucicI>B`leRAq+y$#xq!3WK}_0u?LHwlmb-s+y<qTEek{dtaHih!Ob9oinM@Z
zVBz(QBVZBHhO|ev!VZ1q^H57WiC*%&n<K@eVb7B<HH>ZBw)^@6C-adXWSnLQQ~?Mn
zYtSmP;4Slf;l|qCW+PlGiqrG+bCL}f&kT`0882Ew@+_GHVb(??X#`;JiM>K35aqBK
z7RmO;#N?Lq3%x)G;wtB>X1igvXA;dSG)fzzwb6k~NMbZwn~lIbHpGa=7;UJf8jzSM
z3NSDgP`5j?``|4rgPg<W`7@^tvRfO*u$FJNu9Tn#=_U~a*kMnBYU=Rh;fJ4n=JClb
zJ8pgci?6-*ps&he=!2vYhhbT95QLTU3`m5Ix$+{yilJ`nxi+FwYINU-P}T|O>!t$$
zqG*L$z?IH2c^&G+5c$%8ZRh|=@<{1U4DH5_8?P^iqbI)ht%L(3nv^LO^u;fdKkupm
zur!RV`gUL|$Av-{wN|()SSg56j4=icps-d50A-nLLSZHlO`1Rv>G|`kd{yu(?|S!t
z`^9&jIlXY@mWenHmj{a&Kwv^b5vHp2jw#|GWJ;8o3PKW9k$BWmU<jo0Hqb~!QLA;j
zm)~&UCLc6OnY?tz4nG|#^uj_UQu`{gRtc2|v9Bsiq~j>j%2cj!MMk81bM9jwc)U9~
z{j%?S`AxSzKa8L#Qv=Fo6(f-{qykMK3cZk03Vpq`Ak6jPQ~*F!o>>5e>o2YSt96l{
z^+ffw4i6~66#=8S>8Lk8IU$N#lan@%#`f&KIZBQ_dwMjt!j?z2Tq%oXu9n3viyr|y
zZ&*Mn&7?dLC|!^e(j*}Wd0=ZTvoirILKe$R3hSxu;+QMO#}7Sy(+$@heE#iszwQlB
zJ@N2lGxXk(f+z}x=_oO6r#K8lmzPl-prcM;VohaQKvk&#no;P$=7W@)F-6hI^UJ$$
zc>cupJ-tGLM)Sy%59MhV#!;<h!$z0Gb<IXRM_MUufUUI^h=j^eK!qKSw?i)bU;OmP
zzV_wM?b^Hly6bP+dBv4U(qRHXu)gq)k-_MCSZ+Ni7krK9Ys!y^pwuJDrH*mdNh_o)
z77R2IfGxrMlC!YYjH198VFVpU%vkAAwZ_Ie6K3z8@18uKu^qW;#4bmu0%cXeL`s>e
zbV`Vwc+22z7{<&{q&*XbQJ{65{0a_)qkzQMjj06zt@onn@afaN(oTc<;Wz%oZ~WZ1
z&aJHOm}$7tqU~p`q=`V{J%D(&N!+x)G8zayAp}OF(NU;N>qslnVaCXD>!z37QK^U_
z%Bt#1U;1(sMXsLFTTkq~kivriC?ei_L~D#ugx<4ADb^z+Igh9U0+;oUKKbDBXP!b6
zPE2jxvSa5J`>vju-PUNfF)+@%s?3#+crAGXJs=3yQ}x!WCz<Qk1tN6@o!6p?8N6rm
z5Gsux5G5`0neN0W&EsY_&sjHHg)+yUJ$lcfr=BUZQh_z#Rp=FY5YOPfghY;owAMz4
zh*edEL6D}yRx1?ow#os(Xkzb~S?e_wtseR<gi#V_t_s?X-0|4HtFF22`QN_(>#u(4
zO_Nhw`pXM0FOx=-+1Fiqqd@zd>p9HY1VrS4t0F60VI3EF)l28^{?VTd#-~dP1++qS
z|NZw{>roK`BalcvM;-vc11JC_3W69BE9;OX2m+~FXNNJfbKVkQWCBvgaZ#oDVpXin
zpMLEA?|Omm*yL5$Tyx;M>u0y@Ds06Vz}gHN^bEov%%~Ks<(v8q86YB>l(DunL<~qQ
zAjE<Na|NK{m_;$*@l$grpFR2K@B7pKs9%tF2p&O%#DNmg0w|<PHe^KDvvUAmL25G$
z1h4|JN(l&oX9Y;8*+LLSm9vVJ^ImI{6~!<ekkNypYIeGBdgnWT_AOsOHn(u)%y=j1
zt}d^*s_M2o>HKo2bvhg_F3wL)?q4lZa@v;ZShqn0S(cT6&z?U2vLF7@J=fo+o0D1Y
zg?(9+Pd@$xsi5+f*BrhGSo>V+VawW!<ds!QDW!qPG6J#+BN0&mWa?@;C*CPkArV3$
zzA~h}z+mpgcg`Mr<U3z&bS7VP$M;`z@FoWI&Lf(@1THVaAhF)n?S&9Ect+$kA<XRR
zF56mZ&93s0<`rm@7H)ie?D+Ay|NO3Zk5UV$mV1li6O+CyL5L6qxNbzRYCWqS_klp*
zxE5;wC|q|ihqVj?140CZB(`t@r~(rz%^*h6;=+6w8mL@eR*h{te)~P|`M<yMt1}%I
zk#>75cRq+ht@UU$YQ~B8{^Z%S#u&ELjFOeXaOZf}lR0|w)c)tc?3F+GM(RxGjvB3o
z>ka?$)1NHMqOzWhg0<$rY9m~Ts0D$@0HL5_Boq=v5F}t#4@#&rc98)Iz-drK;G7qW
zfi{65%O0vhzG6S~@xQ(23!i_*tG@r*>#r|t>B=e$!m`Rpg$!$5&JgP6af}EgTxs-d
z3&o(2lrp7t+9VT`TNW1w|M^#cBQIQD*uvV@_+(L9!#eU5FlkXr2tlzzuh63R!~l%K
z0dwp)wk~j9STlqIp-99M*2f5uR!N`|#iT_^X#=2@^XGh#CrQ(Rf@X7i&%R&z&EGw{
zlB%d3#N8lidI1yaFb--5j3+XURs}S-vf7#6vXYhON5#w)*S!7be+3$2rZwd$bPS&D
zNB{Q2w#)@VP^q=v&g+FPwa*d}2!)UV9DoC4L66F#VnHv+K#V{FBuv5t&WKmuDXz5G
zfNX%4e9pyy%3(2B_|j)T`iZ~$E1NFIfgqQmLJ&{uJ|z!Q&x&IZGUOFF@s;Pwu_LW2
z2aa)=mVfbAA6!`-AO+ToM=Gnz2}4c50vmHK1%L@Xf?IQD*G?=Z02D$r0s%k(7_cZ7
z@&a|<5DB4xcm@^_pY{j$e&@T{C`}rzys$Vn73{zE4R3wN6UWbriD$O$45Bz`HQQs|
z!d4cz-5Dz@ZxN%haoz4_I_!D<?|=Qj>&|r8on=yC9G7Kz`t<3io_b0MQ6qy#R0OIX
zCypdUgd|Af#4)q1=RhzL014w-SM80`+`3t=cwncAjY44SZ2_({C`m-^2((Yj!Qzoa
z5C8G+|Mmy|?Eef_<`ppt0}HaqdW2yuohwF%Tx!EWzGUYB*o!S}I>^5I)o*skCKgs#
zSYgtPNr5s{YA6+WjX*$9TNAiZ&A%qw5FAm7XcaLcfM%q6<c6RKiYF;-X}PSY9*1Fw
z9$o1^^5KuTs#siDh@+;k0SISqfB6gU{(*;2oF0@_)ND;mjgL)qlWu!_dS+&Ns|W(B
z12^8(^Z3N6rFZ}F`)T*J5OqKs#}I}Tgz@M8=?j*n?v<{Pkm`g7TEl&k^>j~0^n{`i
z2}MEuCIa>N1E6{U2P4$OIII^2VgLs50t^U*3K@OYO~61-cBp(lclzkpzx?@tK-Cz(
zuKS9J7hwcFJKjEX{yZrITD!bJ5T%SQ-KReBX<;}wzc4m6oflPa(2opir3&@{BrHk*
z1!%2&@<IwW3e^^$kO+`4Blw!?YaOQU?W+g?k->S9KxxlxOnl$H51u@JV(*pvhW#vV
zL^?>o6}SHQTb5Rqj-5TaZ`YRTsg7A)r67#r*2LJfEy1*+LfpC4(f@eQpV78GTrwqz
z0Mt2!MNxeGQ=e2iV0Pj?C@p}30-iTUW7PhBV-%u7sGDYhF#EOS5rrF7Vhn&Fg!Ryu
z+WjMhND4$M=Bg~nmSrm4vGGymoOJ+l=*dUs&Yc>Y*vW__=wYqqx4tFa`Qqn~H9`UF
z(2E9-008}!{-X~(5@;PK$#TEPN}?zX2#d7O;CYRSd19};$F&(5RR7eSj788RF@gd%
zSQ)GcbHrRQ6-+&57+NvbQdO}n#al!$QC8Wn-t#r1G%_l!3ntMap!)uw{+Z6y%-sA!
ze>iaL!bZ{_8v`rdMk@${)>!wKfBoGwz1>+wjRqh%2b#cFe9t}iJbV14NA!S7*U6q*
z&;Y7+ml@V9NE0aZC{DN%u0Wg;uhv5HR7WWVQGi&`13Cr==m0&V2l7Bx&^m54V*?d(
zZp#6<A~K|vJoLc5wYv#6eAM-~0_j)X`I7q{ym$G;DMr!2B3xNFH@|f1^qJH--R>lT
zan9A+Y#hg#fZ#^tf%rKU2^$m!u-3+rH30z#dL`nR0ff;DVV+y94TuIs_3etPjDql~
zrw?gT*(hsv8=9zeJ_=$WeD&M^&By=rJyq1%vS-WK#8jjr%%muafzJ+|K1Gc#go#F7
zF_3^U007MV$xnV#2LX$C<|r~%d7<w2LIRH<AlIqn;swCh3MvsGsXA7I>!wp3bo2r&
zOhf`GBF<VNL_`w=X+APhkfy0d-Rd^ydn+cMIP&ykue$4p>#8M&jY2*KKz!uWAARJB
zC*S?wf3Fg99z0+ehP!v~KK#rxo<NjdlS=~N8305R*X;qNe(YM6yO5&2@rHHzti}sN
zaMs0`tlhI71c3?w6%vtF2s7QWPk!PP;}a8cyQ#wfNE9J>53YhTb5)+_xh9ik+3}~3
zojX7G2Y>trr_P_-v;W$^{NRVT?AS#L0Kj{&)*U~7{N*oyc^wY)uBxgc3}ff(+#S4V
zCpIQ!hzQ8$(bsFuI&giMRh`qhImmTE2#RB=6rl#g2rSl#lx!Sy-ua8aWs+G(A%;O&
zjdY-@(ivkk`)d1^$rs#w{nx+sU1K5;WHxgPiw<i8-6O1dFc6dnM#gntifpdExis!v
z%V!2zQ}hslam`P7Nvw{g)&Oykj-Gh($vf}7Q#`w}3X{NAY>cuP{{H`Y&%NLNPE}Ql
z^9#LR&sVmx1tXwJ9)9BRtM0n{gCG9eg9i_qfB+zh^k4kNU)0vDA|N8IH2~Kxf%T;j
z*T%?i<p0#WgNSPqOP&M$jhEG0%cfPM76Sv27X(x&OadfcBZAmNk3V+Zt&?Hg92Kb!
zfY~B}Qi^PuHyiOwU;2_O_w5ztP#a^+V9<k05_<inG?>kKFKg=5dWP^t+prO^-h?lB
z*%)b!S>F5m9(-Vsju0_S0$Vr}khT2Fzx>O;|NFoH+0TFOu_vE+_Qdh!)s@oO!d695
zSZll8?$XlIo8SEA<HwJSKv`C&PtSe&)1M}yI>B2hRUcfG8MqmyxZY5E^MC1*Rp08O
z_m#D5XSm>T+lV(HBFUjcPc$150TT!!de26O-V1@)GE1+$>dL$CdS$4U(u923b_W+{
zNp7I<=7URLY4gd=JFzimar5;6P&s?_=ur^~q7Vd7tE%)r_j5n@!4H10D2j=R31&9N
zBuV0&^WHZajjE~^7Z=O291e$XeB&F>otrnteE7p3?)UrN`ydGFKF_e`roRk+h{y(5
zaXpu0^BBlWm-pU#zxkT=cU1tiP7?LM7(kYn&f98~XZ;}5;ynNv6I$yjG~{gFYQ)!E
zy>HvrSzw<RDb>TXp4+VJBKTf*8{iUNbkU!iQ3E!S#l|91k39C+-28lhII67I2H*M4
zcmB<XKIECBIJVaIdcDFHr7Nwknypq@mO&7;TCF5W(lkAO{P@rR{4XpmE&uJ`{+;(+
zgGr<=7FW!C5l&o65Eo%g4dt3NF9Q0;y7(sR4dd3{lo`a9MemV^ziX67@Z!Buni;e*
zglq$%A|IA{e&Fh>6_Km#X1J_7vM)gJQs~1bR&(jve8C10Y<}mBe=$gDZB`VY{>*2T
zQbDNR{<e2~@>8Fx!;PcSsGdy8%+5IxDT<<|gFMfzwRxV8kB@)h3txEio8LS)H&+xz
z9LF0#-^^Yv1^q=7x%t&D#jwq5qxJ}E>2aCP5`y9t`3LU(MiMFXl`+PUDf2Rl5@J^o
z`l`shEqCnP2Ebt$c)OvltvRBeTmE{n7yy8ai1B-&{AICh<6lJN*aP9WzVmG_{2%}0
zuYU4VpU(3<P173UCe+H1wU(JdQDG}mN@*QM5dch1PM$x1J`BSrpM0{eV9{DDr5J>?
z+E86Cizt^$HCazKxrp>PfWC44=KpT&;<{U=US6YJS~@d#_Jl&G)^Z*d08v1M;*q)A
zX+?n%XQLpnwiFRB|J=IlLvMacxCHArV^IB|8_7%?@-0b{m6era$Bw=0UGI9|``(9$
zVHnmoAtL9TwYKh9SXa$&Py=eUva&KYHC2CCp66j0rfDi7w(^K|k=g}Jzv!7a=wkzp
z>zv1Ka2|ijx>N>SAm(*z2?Y??R;eNT_#^i!V)2%pkK@=`CWRp02Z~%-XhV%gBg?Wl
zjyF)CKB%|79%Kg>g#OxYZ!VI$2)`~{JS8GEZf?%3uWwjcZ-S_D_Jbe#8$r;4DT*Qp
zf;f(YATUa6Qq5+Qnd3N|oE&epTI1v6lQXl3DhlIKnyrCDkz-#A!zhYCsGc^w@u-{m
z(pv9N=2~DNqSm@jWu&#aw%*rmGwN^xK|T4ic170bH}bRqpvGPRsCx}*f+$eH<*_4A
zDzKW?Xvl+TBrytE1OOD0brm!72DsKHp`(bfFl^#58>ILDDFa}WzJDp_+4$^Q)fKJ1
zE)i8#Rbv?urD>{^a@PIgFaF}S*Iv70$Bu5don={MqAbgnd;PO#&;Hu4|F_X-q?9Vl
z64%Du!nzst93SNR(+U6(YPdYR|L2PCHt>D(ZP)x<b*)8h+W@S)PYV&34Of=u&o#%d
zP@0%oDWmJxtE>|dAS`Sp^?eZ$Rc%eJCoYNrle*CB2A<3A;SxS`$!=ZdBNu(#S*rq5
zk0cAUiK2)Q@;q-fo6fn{zy3#F``Xv;+jm8?*<5=PCjc<a^5x~_FW>W(uYBbzS&_3a
zZHx<q^$h1aA8IWhr6z7bL;-)1TzxJ~FR!^?B<I%8J5(A#q%PRTI`#>IjO>s&8?7FH
z_Q-YJ-5MchtF$5SJ)){7UVHDI^{SpFT4&i^irN<(L6>=~?*-XQUk@*5^$0@E<*c>!
zHFZ6-_r55KFbway>#nh}v393JN>ybE05#vR){4lMEn8~H20?J?<6ZO^n;&5FLvC!(
zh6=k`jPa&*krY{9EaC;62utnNU<Hg?p#}!ACr=y=^t!bHevSGVK}ZcpnPU&iY<?6G
zsV5900RqXo&AxHLW&gYgN50pd!6xohFCwzeAxn}ZAik<9t!S*>Da-P;cfWea)@?ht
zZLdEZgduxRMuA`RG(7OY17%ri6*$WmJe`OjYm-b7vE~cw1$cF)Mm>b{!e*>NpPh*4
zb&9`e8)`-1Qk-LUfV|cxMfBR389+kuB9W$rbLWTv#1m;|M~LXxtNoUjmqoBP9r$uR
zOE0P#+`KlMk(=TBz1F1|R3Fz$j@H^*tF=y|*jF~s^If}k-G2M+larGw(BQqdwuYLo
z+;BK5isHWe?tAK~rw}oUqFRJ(mbaIEm(AB~XapO$e_2EQqUXQ(t&j!02ye{)1gOnf
z67j+np$rDSJR9Nq@E^@mlQ{{<^73lEAG{W}p*m^=ESJUi&B(j4HyfJe_j>y8MJ0$R
z07Rse(FjFR5DE&g=dD|}{N!8SdhozC+qP~6FQ9A34zu$rG}X{8E-wD%U;d?tD5bpj
zwOLS8fXIb3(9O@e>A{}E_c!Z8xUL`}VvY3|z0^er#KMU6Hmv7;tu>GHC_qG>S;Vd^
zF3q&I2zXMOgxyAW%)w{`sDKoaUYm|vx0_ze!(K}P#<k&=Yrk<*j2oWIi~e~cz)O}w
zQc4x+NJLt#Rv5<CyB)iB{q#@&%nM%h!fo5ODPusPD@$MoFJw&K&*zSxI(hWj2kyNu
z&?XGSvMkAHp*8-quF-J)^BkWK)w%|5RJovMVJ9LCb+bnz6tzJ{^qilKv`+*E@hoob
zee2j%P1E2#h!;c(w2Hv9Ce`n)DirXHpvV<@s0aX1o53ixf=KK6iijXy*wxPjYdzbY
zbCoeF%SLe=B1%2($hoSj3U)To%2lO8Pzb=@RW^y@dggZR3=52bbvxiv=AZ}^fib4$
z0w#!l=AHlc;EgxT%*>2WOt7l}KnEcJc~M;O`Dah&%e_DOpT8gLfQU+4fdWC+ff54d
zwcs5)%gzFO7MJED0C4Op=Y+)hs<H)xFRNU6&v_ok0V5lQ8U($o@(e_rbE1Jl#Yz}i
zNIZB(0AvDI$iSWmkTeh}3<#7WCK6D<nmk37Q;Gr&(qBGL;^L?!tVt6J_?mAF)69!7
z(mJix`R}}jL4bnLXf!~iD)Z^7snM|Steu{kaMluv(G+NHl+r{BQ4>W$U`P!HgPJMF
zaU93-U@&Mlo110Y=4GogilVY8s;csUakF)9ZcZsxRTU_tAOL0%0ED6_o_+TCefK}`
z>Cb%j^tp3+RatA5Qb4M1>y9kIg7REXEu#h_UXmb=f&iGKz$AguP8xz#RSBqKrJr~e
zI*2^BC<qwiI4rp;oK4FDSd;*G7U#uT5vgfKX+lMQJ^7ggL<ErQvLi1DqzO^jjfOpi
z3?f8YlQur9JPQN%27RdmCc2)}$8?b%%rfi`qQLxz|L`BeFeK6|D=TT5E-x<^MKKzU
zR+g4WqmlTv27BK7IF60?N-5{us6S}6TE>_x%hvTU*kGV*2VRUZgTcrILG5UJ@WBUP
z_=4wIYx7|m2L^%w09;X>I(GaU-}=^(BS*gS^{*{uDHtOFMhD6Pc|inVQfn1nvYx50
z#6mM{*`oB;F?vL{;Gw9RUNy)t1{9cZm?kC`kIb$brkzH#l8tmDz#t~aG|ZG>paTcu
z&?AC)w9Z*_tguc`So^l;+7L>qT8Cd<T~$hnc%uR>B3@VkthHH|q0%)ZnAhY9Vr|>4
z0cd7wYI$)XKy~X4H@)-~uL1y<Wq<mof2x!U!!QiPiLr651Eo~2*Bgw6^YinCt<Ib|
zGrzF#wXc0+Wo2c0dO9nMOH11710u540%8yZmZeCu#~*v_<na^jD4rVY#*GG8S7yce
zh4}~XyZ@0#9$xGXPA@HjF+?ODeC4$$5iddnycXF)2GDihva2Kx0;52LNt0)*4c>n9
z3xiWD;~0`w0<>0GAwZ;+4z}HR)qnr=pAW%v&JhM^t0+qHDicCMM?uJ-9J4Z{6xnLS
zjlk<AN`MHm)>MU=eXqYF>;#;U*Vc;&5~=>M?}drT)veL%9E?lW%F^nV=`BgrXv9sZ
zJSg?-(c?=C%d@ky;vr9qRqh2r)ai8E&CXb7d}eA|5Dr{@4Jeu%pZdh7KDoTStd!DW
z02k?YgaCk`%F+fwM5F^m5kDG@9(v$`E4FR#ulCwel;`RE{Ngvh{jEnId3<VO@>>r+
zQaG=*M#lzJk(Z$f6_9W}?G715fS5dk2xDu!Ga6)KD-%#+f_yai|CM!ZJ#t*fxvI{k
zyJx0nmrIIVu1HY}nvxMkRwO!+m52f;A(Djz0g@odZ^%!{i~N#2<S9UqAU0qi$i+77
zBo<{lW&&6tDN$UBB1MYJ<zBcuGrKd>mvgDg!<ku9%3Gs>0jBGmQ<v}i>J$h5gA1>Z
z{`K<HPD$e!0Xl_<WG!^MM+OaE`0Y3U=4XF5k~*WlVKjva(wc%I#MsmV(2%J>a*5y^
zqCp@y9Dj?c69HL5Qg|_AJ>4IVN7C)Y;D{Ln2^DQ^ZWC%$bQo_Box|Ke2mnZky-s&!
zWu>aByPx0Q-FWDl_M6W=&mk_9{gvgDCr+GL=#>hPeSpYD>EJv8TBU#QJFmU*`h|Y4
zG{zv$j_B7)(?lE+QQNl6Y_-v3u3Wjo%v+lqyE~6Y!{H|%-`LsQI=i}hq`$DSv4KFy
zfI$cm1r^WEEg}kHg!Jja0E{r2j?l=`Vi%*U>Pc>Fj%ukWfouyzw$P>^AuYxz>s&D1
zUH~b3Sw}**_1SQ|;^NZ5K|b8;G?ScMk%3j3m@KMHkpfKmm9OS^qLfk~+K|#1V;Bu~
zH3AW87F5baq5B&TK+#MPFw>3AM3`xRrVZO)SXf+KQp%h>`E=vjNB4H0Idx_-`7i`F
zCM(N@6krk2)vdKALd-iw2%&N9xpU{<efM3Z)Q^7hV`B`=8&qH>m6^rKM7bn4nBwZ@
z#={#QfBfdf3(mQFU);I(#TQSXTzT%fZ~o=?zK1?qLJh#o<hjrmX0k8<MS{Sy;p=G!
zIo(lQ@4Ew8$~&+9{#$Ro@#d$$`t{8lck7eOUyjDlf8+VV)=p1MJ)E3Ab?WB5yU(6K
z_n&)rUq1iRpPl`q>RxRhO*&f-Vl`^IMSga9bV3a=Tf2U6?dm7o4pBpc2!sTZ5`UiG
z8bn0E(HO%lLE_HN)>Er5T1^@Nk%$HM_J#lyK^RdHA<XOP<i+Mepmy!z(vcfCKS4#`
ze&u|(+x^i`e!Q`<QI_RkG#nl58)KAGoxEU{qR2%g1Q$4l5bCO3=#}rh^Uk$v*LHRv
zA&b!0E6fmrQp$(W>-A!kwyDcrPv!aL%a<=+_}%;W@2{_~E2Z{_!&|p*UH;$~*5-9n
zE0f0%7-OF2E_fDDq#@lyEQ}yp1XzRvOh-$~t}Y$>jdL&j;l+0@{_&r$>El29k4w+I
z_*);{y|Z%h^#{NF)v?af;LhEZ3%_%fC(pcn;a`6GgQE-mKYjg;wfdt4Q;#36FD)#t
zPsh(LFUOZxHlnH5*KWAjh_{&~L7BPy#}HElK@KPpK(la&Zg22NI3Px?O*U;BH2M7p
z>ycR*iy}S-1g3czhax=dDgh+g+}Zy8&fUT2;Dbw-0ifUSA3b&q5nJc1&4>jFTIa2`
zfnz<bl)~0K0B}Agq~VDibmrP*eh<IZCKa@GT_dXWpdntla%D6c1?Sh+)^6Ya;^M`N
z@4fdPGb?7J$om!%fv9B%3IPEvwZ7pHEuld|7ZpPXq3h+`(cZU?pE{i{y=)hup(8aF
zH5&&iaIeVoo`pqin!@Kb^|3N+dtJTbdF#<}k-Vuo7_;g0nGlQh2jLhUKe3YeV2pB<
zw<s_#U1uN22$Uwk0L=jmtJPqzD-Z}+2Vq1tt(vBGo@25#kxDr;&G3Tce+Uq3*L?cf
zXSY7TlgKHhRJYshcDq@Y<$2!g^vbgA_xoj8mSx$=vc-k6)9EOsNGnA~2oDYp0!K)U
zU0MlzOsmfF2Y{5zu`r>qaGquV@Q*)u_53RzeR5+ussH!dNB7q^be;!dMgc+=0h)`J
z5ZkswiH67^>NcQr8PEcS7moK|I<x##udAxvpZ?WfpZ=$RzqP*O%kJJ_`}}vleSPg(
z#m(k;`}8+XUHY$|o4mMw^}}{N!R^5ZKm6y;hCc(!jz`nUK$(2&=FNwXJ~!Vw|MB&!
zV>k6#BqENYfB=vPg%eznV2m_?hqYEgWPGr1NC|=tQ2=RgIGof?8Vn=CgvgN*C1Hmm
zEQl!xYipP#vPXqh+vJq0wwbAJ_%TyPL<&h00E;oETlTcFS*Iw9Vt;=h4&e%b1XRx8
z0g*Wq5&;Ax@fz$yc>jY-bu*nzYo*PlUtSI<EYYz<6hfNm{)s^mA`l`)A_nwc1@0@e
zTpl^KfPZrF?5nRl=XFu9Pj39}&!?M%qF0`K?KkTep3Tpm`uq2O_}%ZmeQx#HS6_VT
zFTVf%6U(RHy72Zm&ztE`eR^wos`I827Rn0ICWfGEc&fWN=8DS<V$ft<WD$WUSz-hL
z0s)c0%*N#2hv9HfYw{9xj3R`)gT1<G1T@Ytvg9I?7K;JWSPlVz7{feeIlM&#aX!&T
z5N6YVL}pnaN9SA=b_cPpT0ziS&;Qofxqg(CGBW~lYNCQ!yKNI(i0;=Pez>~2+O&RS
zYr8D_6W_KVfS^!F1Q`(tXJ|8u0K_Pf4XIwyJ+ipCw4{rpOTH|&8y{43g=WC1l`r?V
z7wB|m>FCqP*}#MC&DB#Y$5xh)96K6(+f2rl3)W<Aq1X~%38}oB>8!#i{mzsTJ6ZJO
zw)LTAtqr1rnTw^gyAmZtM2B=xJ*_mUHnI*ZkzsFdz${8DnS12Kh0^Q?Gt3YWwJ}Hn
zjE8(hLUct00SO)p|CkvB7+7c4SX(!ZGP*3wx~^;29_rK%tq)NmK%x>w1W<$@9}#PG
z2yQf;ZftHHOe)(g#!aO=IYFFj5ClOmG6JGt1QCwHq7@2I!{O2XaNP3t`=j#uXS<^V
zsxdy?v(On&Og-L%wX3e1uid@<{*_-C$LG$RzIW%gR`%ci=fB-}tOwhfYl%fEXl2SF
zl!{!-VwAdlXMHqvfLW(dT1PL3Ru*BI9ZeDmLZ}2dL;@uco3;YVH6nT!_XdMx$9NdE
zMV`PkW9k3{L||ZH0;RQ1t%S+v%-C&EPuf&O3}K8BiDHZZQdO0U;W4@Y)e`_9N$`6J
zRHnutBw_$k3W+u!?Kl^@Wk0yUffF2-ZavgM8VS)LLK{N@g_FFNgB#b4?0Y{HR>Gb;
zCRakpHDHj5Yp0`HLbTLYt%P{}<C`8?>mbvq_FNEl7W+GseasbO7eeflWokuae{+}0
zz6u^uy!Q$X3MC=uY)=9JAw&QmMDZb@%1B^mXXn_-Gn%w&tLEU~fQS$&B-DGpfRr+z
z)Q15A0@hmZTjv|*8MLcV6QHo9i=>~lzKA%Hwrv*|7j2O%Wya%iS~(xW|A(w`?)v}^
zAv6FILW&_+V_k5h2#v0Nn{_)?Q=?KOWPq%YC53>%Dgu*GAYp>Y48SdkRS00g<{@yW
zFrsPS`sjmgok7h;=Xs7kxN)V?cDnrv<LF>m7{w@nO3<+F`p7^k%j{@U8{09)keU#I
zK_6W!qEPD@p7sPAEh2;}MrVka88tHVgZp2eJhiG5gV8iiLIRi>m6aL3Pbh#$DG?GR
zM0Cy}!XfFJ%FRRDJ!#7HkaU?MQdL#ATUu-LJg@7T=I`YzY;AJ;vn8Lu2SH3CA4Q<8
z@wL-RAwy;hQh)+Bf<ZE@II?HoN^}(2C^Q5_PFPEd%qFlBR*tcbJOp2MGh_sj#<wD#
zSS^(ce(ERtlgeP$?SZRJZlr<1XhNM#DeZ$)6)0V>fcGLgtE&C1Fb+i->wR+93ev;~
mOz9jWq7NY<iHI0u+}YVtO8p-*+>mRv5v_Ot0CrAEL_t(ca^tlC

literal 0
HcmV?d00001

diff --git a/Tests/test_file_png.py b/Tests/test_file_png.py
index ff386211061..9b6a4c5e6ba 100644
--- a/Tests/test_file_png.py
+++ b/Tests/test_file_png.py
@@ -777,6 +777,15 @@ class MyStdOut:
             mystdout = mystdout.buffer
         with Image.open(mystdout) as reloaded:
             assert_image_equal_tofile(reloaded, TEST_PNG_FILE)
+    
+    def test_end_truncated_file(self):
+        ImageFile.LOAD_TRUNCATED_IMAGES = True
+        try:
+            with Image.open("Tests/images/end_trunc_file.png") as im:
+                assert_image_equal_tofile(im, "Tests/images/end_trunc_file.png")
+        finally:
+            ImageFile.LOAD_TRUNCATED_IMAGES = False
+
 
 
 @pytest.mark.skipif(is_win32(), reason="Requires Unix or macOS")
diff --git a/src/PIL/PngImagePlugin.py b/src/PIL/PngImagePlugin.py
index 823f1249285..1248fb78529 100644
--- a/src/PIL/PngImagePlugin.py
+++ b/src/PIL/PngImagePlugin.py
@@ -981,7 +981,13 @@ def load_end(self):
             except EOFError:
                 if cid == b"fdAT":
                     length -= 4
-                ImageFile._safe_read(self.fp, length)
+                try:
+                    ImageFile._safe_read(self.fp, length)
+                except OSError as e:
+                    if ImageFile.LOAD_TRUNCATED_IMAGES:
+                        break
+                    else:
+                        raise e
             except AttributeError:
                 logger.debug("%r %s %s (unknown)", cid, pos, length)
                 s = ImageFile._safe_read(self.fp, length)

From b2711c3e8b019d0d069d58069912abd4ecb99e61 Mon Sep 17 00:00:00 2001
From: "pre-commit-ci[bot]"
 <66853113+pre-commit-ci[bot]@users.noreply.github.com>
Date: Tue, 16 Jan 2024 07:36:57 +0000
Subject: [PATCH 0084/1178] [pre-commit.ci] auto fixes from pre-commit.com
 hooks

for more information, see https://pre-commit.ci
---
 Tests/test_file_png.py | 3 +--
 1 file changed, 1 insertion(+), 2 deletions(-)

diff --git a/Tests/test_file_png.py b/Tests/test_file_png.py
index 9b6a4c5e6ba..3c285b0779e 100644
--- a/Tests/test_file_png.py
+++ b/Tests/test_file_png.py
@@ -777,7 +777,7 @@ class MyStdOut:
             mystdout = mystdout.buffer
         with Image.open(mystdout) as reloaded:
             assert_image_equal_tofile(reloaded, TEST_PNG_FILE)
-    
+
     def test_end_truncated_file(self):
         ImageFile.LOAD_TRUNCATED_IMAGES = True
         try:
@@ -787,7 +787,6 @@ def test_end_truncated_file(self):
             ImageFile.LOAD_TRUNCATED_IMAGES = False
 
 
-
 @pytest.mark.skipif(is_win32(), reason="Requires Unix or macOS")
 @skip_unless_feature("zlib")
 class TestTruncatedPngPLeaks(PillowLeakTestCase):

From fe7b6d9e80ae8ee65d2b4e615971a00690b876fe Mon Sep 17 00:00:00 2001
From: Andrew Murray <radarhere@users.noreply.github.com>
Date: Tue, 16 Jan 2024 18:39:33 +1100
Subject: [PATCH 0085/1178] Corrected expected image path

---
 Tests/test_file_png.py | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/Tests/test_file_png.py b/Tests/test_file_png.py
index 3c285b0779e..aa2aac906f7 100644
--- a/Tests/test_file_png.py
+++ b/Tests/test_file_png.py
@@ -782,7 +782,7 @@ def test_end_truncated_file(self):
         ImageFile.LOAD_TRUNCATED_IMAGES = True
         try:
             with Image.open("Tests/images/end_trunc_file.png") as im:
-                assert_image_equal_tofile(im, "Tests/images/end_trunc_file.png")
+                assert_image_equal_tofile(im, "Tests/images/hopper.png")
         finally:
             ImageFile.LOAD_TRUNCATED_IMAGES = False
 

From 62e6d62518f21333fbde364d7b7a57e25d39061b Mon Sep 17 00:00:00 2001
From: Andrew Murray <radarhere@users.noreply.github.com>
Date: Tue, 16 Jan 2024 18:49:25 +1100
Subject: [PATCH 0086/1178] Test error is raised without LOAD_TRUNCATED_IMAGES

---
 .../{end_trunc_file.png => truncated_end_chunk.png} | Bin
 Tests/test_file_png.py                              |   8 ++++++--
 2 files changed, 6 insertions(+), 2 deletions(-)
 rename Tests/images/{end_trunc_file.png => truncated_end_chunk.png} (100%)

diff --git a/Tests/images/end_trunc_file.png b/Tests/images/truncated_end_chunk.png
similarity index 100%
rename from Tests/images/end_trunc_file.png
rename to Tests/images/truncated_end_chunk.png
diff --git a/Tests/test_file_png.py b/Tests/test_file_png.py
index aa2aac906f7..0884ddcc35d 100644
--- a/Tests/test_file_png.py
+++ b/Tests/test_file_png.py
@@ -778,10 +778,14 @@ class MyStdOut:
         with Image.open(mystdout) as reloaded:
             assert_image_equal_tofile(reloaded, TEST_PNG_FILE)
 
-    def test_end_truncated_file(self):
+    def test_truncated_end_chunk(self):
+        with Image.open("Tests/images/truncated_end_chunk.png") as im:
+            with pytest.raises(OSError):
+                im.load()
+
         ImageFile.LOAD_TRUNCATED_IMAGES = True
         try:
-            with Image.open("Tests/images/end_trunc_file.png") as im:
+            with Image.open("Tests/images/truncated_end_chunk.png") as im:
                 assert_image_equal_tofile(im, "Tests/images/hopper.png")
         finally:
             ImageFile.LOAD_TRUNCATED_IMAGES = False

From 54c96df9d6e370d16960ee8a2aee932b41f213f3 Mon Sep 17 00:00:00 2001
From: Andrew Murray <radarhere@users.noreply.github.com>
Date: Wed, 17 Jan 2024 08:03:09 +1100
Subject: [PATCH 0087/1178] Added type hints

---
 src/PIL/TgaImagePlugin.py | 11 ++++++++---
 1 file changed, 8 insertions(+), 3 deletions(-)

diff --git a/src/PIL/TgaImagePlugin.py b/src/PIL/TgaImagePlugin.py
index 65c7484f756..584932d2c7d 100644
--- a/src/PIL/TgaImagePlugin.py
+++ b/src/PIL/TgaImagePlugin.py
@@ -18,6 +18,7 @@
 from __future__ import annotations
 
 import warnings
+from io import BytesIO
 
 from . import Image, ImageFile, ImagePalette
 from ._binary import i16le as i16
@@ -49,8 +50,10 @@ class TgaImageFile(ImageFile.ImageFile):
     format = "TGA"
     format_description = "Targa"
 
-    def _open(self):
+    def _open(self) -> None:
         # process header
+        assert self.fp is not None
+
         s = self.fp.read(18)
 
         id_len = s[0]
@@ -151,8 +154,9 @@ def _open(self):
         except KeyError:
             pass  # cannot decode
 
-    def load_end(self):
+    def load_end(self) -> None:
         if self._flip_horizontally:
+            assert self.im is not None
             self.im = self.im.transpose(Image.Transpose.FLIP_LEFT_RIGHT)
 
 
@@ -171,7 +175,7 @@ def load_end(self):
 }
 
 
-def _save(im, fp, filename):
+def _save(im: Image.Image, fp: BytesIO, filename: str) -> None:
     try:
         rawmode, bits, colormaptype, imagetype = SAVE[im.mode]
     except KeyError as e:
@@ -194,6 +198,7 @@ def _save(im, fp, filename):
         warnings.warn("id_section has been trimmed to 255 characters")
 
     if colormaptype:
+        assert im.im is not None
         palette = im.im.getpalette("RGB", "BGR")
         colormaplength, colormapentry = len(palette) // 3, 24
     else:

From 7972332bc59800aa64c23664645fe9f8277cdbf4 Mon Sep 17 00:00:00 2001
From: Andrew Murray <radarhere@users.noreply.github.com>
Date: Wed, 17 Jan 2024 19:22:45 +1100
Subject: [PATCH 0088/1178] Added type hints

---
 src/PIL/Image.py          |  2 +-
 src/PIL/ImageFile.py      |  2 ++
 src/PIL/PpmImagePlugin.py | 46 +++++++++++++++++++++++++--------------
 3 files changed, 33 insertions(+), 17 deletions(-)

diff --git a/src/PIL/Image.py b/src/PIL/Image.py
index ec1cff89636..553f36703b3 100644
--- a/src/PIL/Image.py
+++ b/src/PIL/Image.py
@@ -282,7 +282,7 @@ def getmodebandnames(mode):
     return ImageMode.getmode(mode).bands
 
 
-def getmodebands(mode):
+def getmodebands(mode: str) -> int:
     """
     Gets the number of individual bands for this mode.
 
diff --git a/src/PIL/ImageFile.py b/src/PIL/ImageFile.py
index 40353da677b..5ba5a6f8277 100644
--- a/src/PIL/ImageFile.py
+++ b/src/PIL/ImageFile.py
@@ -616,6 +616,8 @@ def extents(self):
 
 
 class PyCodec:
+    fd: io.BytesIO | None
+
     def __init__(self, mode, *args):
         self.im = None
         self.state = PyCodecState()
diff --git a/src/PIL/PpmImagePlugin.py b/src/PIL/PpmImagePlugin.py
index 9d37dcde099..3e45ba95c84 100644
--- a/src/PIL/PpmImagePlugin.py
+++ b/src/PIL/PpmImagePlugin.py
@@ -16,6 +16,7 @@
 from __future__ import annotations
 
 import math
+from io import BytesIO
 
 from . import Image, ImageFile
 from ._binary import i16be as i16
@@ -45,7 +46,7 @@
 }
 
 
-def _accept(prefix):
+def _accept(prefix: bytes) -> bool:
     return prefix[0:1] == b"P" and prefix[1] in b"0123456fy"
 
 
@@ -57,7 +58,9 @@ class PpmImageFile(ImageFile.ImageFile):
     format = "PPM"
     format_description = "Pbmplus image"
 
-    def _read_magic(self):
+    def _read_magic(self) -> bytes:
+        assert self.fp is not None
+
         magic = b""
         # read until whitespace or longest available magic number
         for _ in range(6):
@@ -67,7 +70,9 @@ def _read_magic(self):
             magic += c
         return magic
 
-    def _read_token(self):
+    def _read_token(self) -> bytes:
+        assert self.fp is not None
+
         token = b""
         while len(token) <= 10:  # read until next whitespace or limit of 10 characters
             c = self.fp.read(1)
@@ -93,7 +98,9 @@ def _read_token(self):
             raise ValueError(msg)
         return token
 
-    def _open(self):
+    def _open(self) -> None:
+        assert self.fp is not None
+
         magic_number = self._read_magic()
         try:
             mode = MODES[magic_number]
@@ -114,6 +121,8 @@ def _open(self):
         decoder_name = "raw"
         if magic_number in (b"P1", b"P2", b"P3"):
             decoder_name = "ppm_plain"
+
+        args: str | tuple[str | int, ...]
         if mode == "1":
             args = "1;I"
         elif mode == "F":
@@ -151,16 +160,19 @@ def _open(self):
 
 class PpmPlainDecoder(ImageFile.PyDecoder):
     _pulls_fd = True
+    _comment_spans: bool
+
+    def _read_block(self) -> bytes:
+        assert self.fd is not None
 
-    def _read_block(self):
         return self.fd.read(ImageFile.SAFEBLOCK)
 
-    def _find_comment_end(self, block, start=0):
+    def _find_comment_end(self, block: bytes, start: int = 0) -> int:
         a = block.find(b"\n", start)
         b = block.find(b"\r", start)
         return min(a, b) if a * b > 0 else max(a, b)  # lowest nonnegative index (or -1)
 
-    def _ignore_comments(self, block):
+    def _ignore_comments(self, block: bytes) -> bytes:
         if self._comment_spans:
             # Finish current comment
             while block:
@@ -194,7 +206,7 @@ def _ignore_comments(self, block):
                 break
         return block
 
-    def _decode_bitonal(self):
+    def _decode_bitonal(self) -> bytearray:
         """
         This is a separate method because in the plain PBM format, all data tokens are
         exactly one byte, so the inter-token whitespace is optional.
@@ -219,7 +231,7 @@ def _decode_bitonal(self):
         invert = bytes.maketrans(b"01", b"\xFF\x00")
         return data.translate(invert)
 
-    def _decode_blocks(self, maxval):
+    def _decode_blocks(self, maxval: int) -> bytearray:
         data = bytearray()
         max_len = 10
         out_byte_count = 4 if self.mode == "I" else 1
@@ -227,7 +239,7 @@ def _decode_blocks(self, maxval):
         bands = Image.getmodebands(self.mode)
         total_bytes = self.state.xsize * self.state.ysize * bands * out_byte_count
 
-        half_token = False
+        half_token = b""
         while len(data) != total_bytes:
             block = self._read_block()  # read next block
             if not block:
@@ -241,7 +253,7 @@ def _decode_blocks(self, maxval):
 
             if half_token:
                 block = half_token + block  # stitch half_token to new block
-                half_token = False
+                half_token = b""
 
             tokens = block.split()
 
@@ -259,15 +271,15 @@ def _decode_blocks(self, maxval):
                     raise ValueError(msg)
                 value = int(token)
                 if value > maxval:
-                    msg = f"Channel value too large for this mode: {value}"
-                    raise ValueError(msg)
+                    msg_str = f"Channel value too large for this mode: {value}"
+                    raise ValueError(msg_str)
                 value = round(value / maxval * out_max)
                 data += o32(value) if self.mode == "I" else o8(value)
                 if len(data) == total_bytes:  # finished!
                     break
         return data
 
-    def decode(self, buffer):
+    def decode(self, buffer: bytes) -> tuple[int, int]:
         self._comment_spans = False
         if self.mode == "1":
             data = self._decode_bitonal()
@@ -283,7 +295,9 @@ def decode(self, buffer):
 class PpmDecoder(ImageFile.PyDecoder):
     _pulls_fd = True
 
-    def decode(self, buffer):
+    def decode(self, buffer: bytes) -> tuple[int, int]:
+        assert self.fd is not None
+
         data = bytearray()
         maxval = self.args[-1]
         in_byte_count = 1 if maxval < 256 else 2
@@ -310,7 +324,7 @@ def decode(self, buffer):
 # --------------------------------------------------------------------
 
 
-def _save(im, fp, filename):
+def _save(im: Image.Image, fp: BytesIO, filename: str) -> None:
     if im.mode == "1":
         rawmode, head = "1;I", b"P4"
     elif im.mode == "L":

From d8c7af0157269f82106216788e9073b4379f786d Mon Sep 17 00:00:00 2001
From: Andrew Murray <radarhere@users.noreply.github.com>
Date: Wed, 17 Jan 2024 23:10:37 +1100
Subject: [PATCH 0089/1178] Added type hints to GdImageFile

---
 src/PIL/GdImageFile.py | 8 ++++++--
 1 file changed, 6 insertions(+), 2 deletions(-)

diff --git a/src/PIL/GdImageFile.py b/src/PIL/GdImageFile.py
index d84876eb6b6..7bb4736af13 100644
--- a/src/PIL/GdImageFile.py
+++ b/src/PIL/GdImageFile.py
@@ -27,6 +27,8 @@ class is not registered for use with :py:func:`PIL.Image.open()`.  To open a
 """
 from __future__ import annotations
 
+from io import BytesIO
+
 from . import ImageFile, ImagePalette, UnidentifiedImageError
 from ._binary import i16be as i16
 from ._binary import i32be as i32
@@ -43,8 +45,10 @@ class GdImageFile(ImageFile.ImageFile):
     format = "GD"
     format_description = "GD uncompressed images"
 
-    def _open(self):
+    def _open(self) -> None:
         # Header
+        assert self.fp is not None
+
         s = self.fp.read(1037)
 
         if i16(s) not in [65534, 65535]:
@@ -76,7 +80,7 @@ def _open(self):
         ]
 
 
-def open(fp, mode="r"):
+def open(fp: BytesIO, mode: str = "r") -> GdImageFile:
     """
     Load texture from a GD image file.
 

From 6a85653cc373fd78fdf04e53d3fc38b6d83a7e1b Mon Sep 17 00:00:00 2001
From: Andrew Murray <radarhere@users.noreply.github.com>
Date: Thu, 18 Jan 2024 12:05:54 +1100
Subject: [PATCH 0090/1178] Added type hints

---
 src/PIL/MpegImagePlugin.py | 17 ++++++++++-------
 1 file changed, 10 insertions(+), 7 deletions(-)

diff --git a/src/PIL/MpegImagePlugin.py b/src/PIL/MpegImagePlugin.py
index f4e598ca3a0..b9e9243e59f 100644
--- a/src/PIL/MpegImagePlugin.py
+++ b/src/PIL/MpegImagePlugin.py
@@ -14,6 +14,8 @@
 #
 from __future__ import annotations
 
+from io import BytesIO
+
 from . import Image, ImageFile
 from ._binary import i8
 
@@ -22,15 +24,15 @@
 
 
 class BitStream:
-    def __init__(self, fp):
+    def __init__(self, fp: BytesIO) -> None:
         self.fp = fp
         self.bits = 0
         self.bitbuffer = 0
 
-    def next(self):
+    def next(self) -> int:
         return i8(self.fp.read(1))
 
-    def peek(self, bits):
+    def peek(self, bits: int) -> int:
         while self.bits < bits:
             c = self.next()
             if c < 0:
@@ -40,13 +42,13 @@ def peek(self, bits):
             self.bits += 8
         return self.bitbuffer >> (self.bits - bits) & (1 << bits) - 1
 
-    def skip(self, bits):
+    def skip(self, bits: int) -> None:
         while self.bits < bits:
             self.bitbuffer = (self.bitbuffer << 8) + i8(self.fp.read(1))
             self.bits += 8
         self.bits = self.bits - bits
 
-    def read(self, bits):
+    def read(self, bits: int) -> int:
         v = self.peek(bits)
         self.bits = self.bits - bits
         return v
@@ -61,9 +63,10 @@ class MpegImageFile(ImageFile.ImageFile):
     format = "MPEG"
     format_description = "MPEG"
 
-    def _open(self):
-        s = BitStream(self.fp)
+    def _open(self) -> None:
+        assert self.fp is not None
 
+        s = BitStream(self.fp)
         if s.read(32) != 0x1B3:
             msg = "not an MPEG file"
             raise SyntaxError(msg)

From 81b5c5dc68be449478442364a86e391906a61228 Mon Sep 17 00:00:00 2001
From: Andrew Murray <radarhere@users.noreply.github.com>
Date: Fri, 19 Jan 2024 08:37:58 +1100
Subject: [PATCH 0091/1178] Added type hints

---
 Tests/helper.py                | 2 +-
 Tests/oss-fuzz/fuzz_font.py    | 4 ++--
 Tests/oss-fuzz/fuzz_pillow.py  | 4 ++--
 Tests/oss-fuzz/fuzzers.py      | 8 ++++----
 Tests/oss-fuzz/test_fuzzers.py | 4 ++--
 5 files changed, 11 insertions(+), 11 deletions(-)

diff --git a/Tests/helper.py b/Tests/helper.py
index b333c2fd4ef..88c1f02a803 100644
--- a/Tests/helper.py
+++ b/Tests/helper.py
@@ -158,7 +158,7 @@ def assert_tuple_approx_equal(actuals, targets, threshold, msg):
     assert value, msg + ": " + repr(actuals) + " != " + repr(targets)
 
 
-def skip_unless_feature(feature):
+def skip_unless_feature(feature: str) -> pytest.MarkDecorator:
     reason = f"{feature} not available"
     return pytest.mark.skipif(not features.check(feature), reason=reason)
 
diff --git a/Tests/oss-fuzz/fuzz_font.py b/Tests/oss-fuzz/fuzz_font.py
index bc2ba9a7e27..8788d7021d3 100755
--- a/Tests/oss-fuzz/fuzz_font.py
+++ b/Tests/oss-fuzz/fuzz_font.py
@@ -23,7 +23,7 @@
     import fuzzers
 
 
-def TestOneInput(data):
+def TestOneInput(data: bytes) -> None:
     try:
         fuzzers.fuzz_font(data)
     except Exception:
@@ -32,7 +32,7 @@ def TestOneInput(data):
         pass
 
 
-def main():
+def main() -> None:
     fuzzers.enable_decompressionbomb_error()
     atheris.Setup(sys.argv, TestOneInput)
     atheris.Fuzz()
diff --git a/Tests/oss-fuzz/fuzz_pillow.py b/Tests/oss-fuzz/fuzz_pillow.py
index 545daccb680..e6e99d415a6 100644
--- a/Tests/oss-fuzz/fuzz_pillow.py
+++ b/Tests/oss-fuzz/fuzz_pillow.py
@@ -23,7 +23,7 @@
     import fuzzers
 
 
-def TestOneInput(data):
+def TestOneInput(data: bytes) -> None:
     try:
         fuzzers.fuzz_image(data)
     except Exception:
@@ -32,7 +32,7 @@ def TestOneInput(data):
         pass
 
 
-def main():
+def main() -> None:
     fuzzers.enable_decompressionbomb_error()
     atheris.Setup(sys.argv, TestOneInput)
     atheris.Fuzz()
diff --git a/Tests/oss-fuzz/fuzzers.py b/Tests/oss-fuzz/fuzzers.py
index 3f3c1e38833..3afa952157b 100644
--- a/Tests/oss-fuzz/fuzzers.py
+++ b/Tests/oss-fuzz/fuzzers.py
@@ -5,18 +5,18 @@
 from PIL import Image, ImageDraw, ImageFile, ImageFilter, ImageFont
 
 
-def enable_decompressionbomb_error():
+def enable_decompressionbomb_error() -> None:
     ImageFile.LOAD_TRUNCATED_IMAGES = True
     warnings.filterwarnings("ignore")
     warnings.simplefilter("error", Image.DecompressionBombWarning)
 
 
-def disable_decompressionbomb_error():
+def disable_decompressionbomb_error() -> None:
     ImageFile.LOAD_TRUNCATED_IMAGES = False
     warnings.resetwarnings()
 
 
-def fuzz_image(data):
+def fuzz_image(data: bytes) -> None:
     # This will fail on some images in the corpus, as we have many
     # invalid images in the test suite.
     with Image.open(io.BytesIO(data)) as im:
@@ -25,7 +25,7 @@ def fuzz_image(data):
         im.save(io.BytesIO(), "BMP")
 
 
-def fuzz_font(data):
+def fuzz_font(data: bytes) -> None:
     wrapper = io.BytesIO(data)
     try:
         font = ImageFont.truetype(wrapper)
diff --git a/Tests/oss-fuzz/test_fuzzers.py b/Tests/oss-fuzz/test_fuzzers.py
index 68834045a52..028ee71eec8 100644
--- a/Tests/oss-fuzz/test_fuzzers.py
+++ b/Tests/oss-fuzz/test_fuzzers.py
@@ -23,7 +23,7 @@
     "path",
     subprocess.check_output("find Tests/images -type f", shell=True).split(b"\n"),
 )
-def test_fuzz_images(path):
+def test_fuzz_images(path: str) -> None:
     fuzzers.enable_decompressionbomb_error()
     try:
         with open(path, "rb") as f:
@@ -54,7 +54,7 @@ def test_fuzz_images(path):
 @pytest.mark.parametrize(
     "path", subprocess.check_output("find Tests/fonts -type f", shell=True).split(b"\n")
 )
-def test_fuzz_fonts(path):
+def test_fuzz_fonts(path: str) -> None:
     if not path:
         return
     with open(path, "rb") as f:

From 1d63cffdadbf649442804dae288992cdd854a849 Mon Sep 17 00:00:00 2001
From: Andrew Murray <radarhere@users.noreply.github.com>
Date: Fri, 19 Jan 2024 21:50:27 +1100
Subject: [PATCH 0092/1178] Added type hints

---
 Tests/check_fli_overflow.py       |  2 +-
 Tests/check_imaging_leaks.py      | 15 ++++++++++-----
 Tests/check_j2k_leaks.py          |  4 ++--
 Tests/check_j2k_overflow.py       |  3 ++-
 Tests/check_jpeg_leaks.py         |  6 +++---
 Tests/check_large_memory.py       | 12 ++++++++----
 Tests/check_large_memory_numpy.py |  7 ++++---
 Tests/check_libtiff_segfault.py   |  2 +-
 Tests/check_png_dos.py            |  8 ++++----
 Tests/check_wheel.py              |  6 +++---
 Tests/helper.py                   |  4 ++--
 11 files changed, 40 insertions(+), 29 deletions(-)

diff --git a/Tests/check_fli_overflow.py b/Tests/check_fli_overflow.py
index 0fabcb5d35f..109f8fb5498 100644
--- a/Tests/check_fli_overflow.py
+++ b/Tests/check_fli_overflow.py
@@ -4,7 +4,7 @@
 TEST_FILE = "Tests/images/fli_overflow.fli"
 
 
-def test_fli_overflow():
+def test_fli_overflow() -> None:
     # this should not crash with a malloc error or access violation
     with Image.open(TEST_FILE) as im:
         im.load()
diff --git a/Tests/check_imaging_leaks.py b/Tests/check_imaging_leaks.py
index 8c17c051d4b..b0c4f620b93 100755
--- a/Tests/check_imaging_leaks.py
+++ b/Tests/check_imaging_leaks.py
@@ -2,6 +2,8 @@
 from __future__ import annotations
 import pytest
 
+from typing import Any, Callable
+
 from PIL import Image
 
 from .helper import is_win32
@@ -12,31 +14,34 @@
 pytestmark = pytest.mark.skipif(is_win32(), reason="requires Unix or macOS")
 
 
-def _get_mem_usage():
+def _get_mem_usage() -> float:
     from resource import RUSAGE_SELF, getpagesize, getrusage
 
     mem = getrusage(RUSAGE_SELF).ru_maxrss
     return mem * getpagesize() / 1024 / 1024
 
 
-def _test_leak(min_iterations, max_iterations, fn, *args, **kwargs):
+def _test_leak(
+    min_iterations: int, max_iterations: int, fn: Callable[..., None], *args: Any
+) -> None:
     mem_limit = None
     for i in range(max_iterations):
-        fn(*args, **kwargs)
+        fn(*args)
         mem = _get_mem_usage()
         if i < min_iterations:
             mem_limit = mem + 1
             continue
         msg = f"memory usage limit exceeded after {i + 1} iterations"
+        assert mem_limit is not None
         assert mem <= mem_limit, msg
 
 
-def test_leak_putdata():
+def test_leak_putdata() -> None:
     im = Image.new("RGB", (25, 25))
     _test_leak(min_iterations, max_iterations, im.putdata, im.getdata())
 
 
-def test_leak_getlist():
+def test_leak_getlist() -> None:
     im = Image.new("P", (25, 25))
     _test_leak(
         min_iterations,
diff --git a/Tests/check_j2k_leaks.py b/Tests/check_j2k_leaks.py
index 83a12e2c29f..0d0d3a57c2d 100644
--- a/Tests/check_j2k_leaks.py
+++ b/Tests/check_j2k_leaks.py
@@ -19,7 +19,7 @@
 ]
 
 
-def test_leak_load():
+def test_leak_load() -> None:
     from resource import RLIMIT_AS, RLIMIT_STACK, setrlimit
 
     setrlimit(RLIMIT_STACK, (stack_size, stack_size))
@@ -29,7 +29,7 @@ def test_leak_load():
             im.load()
 
 
-def test_leak_save():
+def test_leak_save() -> None:
     from resource import RLIMIT_AS, RLIMIT_STACK, setrlimit
 
     setrlimit(RLIMIT_STACK, (stack_size, stack_size))
diff --git a/Tests/check_j2k_overflow.py b/Tests/check_j2k_overflow.py
index 982f6ea74d2..ba14964b55f 100644
--- a/Tests/check_j2k_overflow.py
+++ b/Tests/check_j2k_overflow.py
@@ -1,10 +1,11 @@
 from __future__ import annotations
+from pathlib import PosixPath
 import pytest
 
 from PIL import Image
 
 
-def test_j2k_overflow(tmp_path):
+def test_j2k_overflow(tmp_path: PosixPath) -> None:
     im = Image.new("RGBA", (1024, 131584))
     target = str(tmp_path / "temp.jpc")
     with pytest.raises(OSError):
diff --git a/Tests/check_jpeg_leaks.py b/Tests/check_jpeg_leaks.py
index 3cd37c7af7b..e91709a9604 100644
--- a/Tests/check_jpeg_leaks.py
+++ b/Tests/check_jpeg_leaks.py
@@ -110,14 +110,14 @@
         [standard_l_qtable, standard_chrominance_qtable],
     ),
 )
-def test_qtables_leak(qtables):
+def test_qtables_leak(qtables: tuple[tuple[int, ...]] | list[tuple[int, ...]]) -> None:
     im = hopper("RGB")
     for _ in range(iterations):
         test_output = BytesIO()
         im.save(test_output, "JPEG", qtables=qtables)
 
 
-def test_exif_leak():
+def test_exif_leak() -> None:
     """
     pre patch:
 
@@ -180,7 +180,7 @@ def test_exif_leak():
         im.save(test_output, "JPEG", exif=exif)
 
 
-def test_base_save():
+def test_base_save() -> None:
     """
     base case:
         MB
diff --git a/Tests/check_large_memory.py b/Tests/check_large_memory.py
index 9b83798d5e7..4d67270765c 100644
--- a/Tests/check_large_memory.py
+++ b/Tests/check_large_memory.py
@@ -1,5 +1,7 @@
 from __future__ import annotations
+from pathlib import PosixPath
 import sys
+from types import ModuleType
 
 import pytest
 
@@ -15,6 +17,7 @@
 # 2.7 and 3.2.
 
 
+numpy: ModuleType | None
 try:
     import numpy
 except ImportError:
@@ -27,23 +30,24 @@
 pytestmark = pytest.mark.skipif(sys.maxsize <= 2**32, reason="requires 64-bit system")
 
 
-def _write_png(tmp_path, xdim, ydim):
+def _write_png(tmp_path: PosixPath, xdim: int, ydim: int) -> None:
     f = str(tmp_path / "temp.png")
     im = Image.new("L", (xdim, ydim), 0)
     im.save(f)
 
 
-def test_large(tmp_path):
+def test_large(tmp_path: PosixPath) -> None:
     """succeeded prepatch"""
     _write_png(tmp_path, XDIM, YDIM)
 
 
-def test_2gpx(tmp_path):
+def test_2gpx(tmp_path: PosixPath) -> None:
     """failed prepatch"""
     _write_png(tmp_path, XDIM, XDIM)
 
 
 @pytest.mark.skipif(numpy is None, reason="Numpy is not installed")
-def test_size_greater_than_int():
+def test_size_greater_than_int() -> None:
+    assert numpy is not None
     arr = numpy.ndarray(shape=(16394, 16394))
     Image.fromarray(arr)
diff --git a/Tests/check_large_memory_numpy.py b/Tests/check_large_memory_numpy.py
index 0ff3de8dcc7..d1cbad887aa 100644
--- a/Tests/check_large_memory_numpy.py
+++ b/Tests/check_large_memory_numpy.py
@@ -1,4 +1,5 @@
 from __future__ import annotations
+from pathlib import PosixPath
 import sys
 
 import pytest
@@ -23,7 +24,7 @@
 pytestmark = pytest.mark.skipif(sys.maxsize <= 2**32, reason="requires 64-bit system")
 
 
-def _write_png(tmp_path, xdim, ydim):
+def _write_png(tmp_path: PosixPath, xdim: int, ydim: int) -> None:
     dtype = np.uint8
     a = np.zeros((xdim, ydim), dtype=dtype)
     f = str(tmp_path / "temp.png")
@@ -31,11 +32,11 @@ def _write_png(tmp_path, xdim, ydim):
     im.save(f)
 
 
-def test_large(tmp_path):
+def test_large(tmp_path: PosixPath) -> None:
     """succeeded prepatch"""
     _write_png(tmp_path, XDIM, YDIM)
 
 
-def test_2gpx(tmp_path):
+def test_2gpx(tmp_path: PosixPath) -> None:
     """failed prepatch"""
     _write_png(tmp_path, XDIM, XDIM)
diff --git a/Tests/check_libtiff_segfault.py b/Tests/check_libtiff_segfault.py
index ee1d7d11f0c..f1c77efc16b 100644
--- a/Tests/check_libtiff_segfault.py
+++ b/Tests/check_libtiff_segfault.py
@@ -6,7 +6,7 @@
 TEST_FILE = "Tests/images/libtiff_segfault.tif"
 
 
-def test_libtiff_segfault():
+def test_libtiff_segfault() -> None:
     """This test should not segfault. It will on Pillow <= 3.1.0 and
     libtiff >= 4.0.0
     """
diff --git a/Tests/check_png_dos.py b/Tests/check_png_dos.py
index 292fe4b7f09..a3d50fa57e5 100644
--- a/Tests/check_png_dos.py
+++ b/Tests/check_png_dos.py
@@ -7,7 +7,7 @@
 TEST_FILE = "Tests/images/png_decompression_dos.png"
 
 
-def test_ignore_dos_text():
+def test_ignore_dos_text() -> None:
     ImageFile.LOAD_TRUNCATED_IMAGES = True
 
     try:
@@ -23,7 +23,7 @@ def test_ignore_dos_text():
         assert len(s) < 1024 * 1024, "Text chunk larger than 1M"
 
 
-def test_dos_text():
+def test_dos_text() -> None:
     try:
         im = Image.open(TEST_FILE)
         im.load()
@@ -35,7 +35,7 @@ def test_dos_text():
         assert len(s) < 1024 * 1024, "Text chunk larger than 1M"
 
 
-def test_dos_total_memory():
+def test_dos_total_memory() -> None:
     im = Image.new("L", (1, 1))
     compressed_data = zlib.compress(b"a" * 1024 * 1023)
 
@@ -52,7 +52,7 @@ def test_dos_total_memory():
     try:
         im2 = Image.open(b)
     except ValueError as msg:
-        assert "Too much memory" in msg
+        assert "Too much memory" in str(msg)
         return
 
     total_len = 0
diff --git a/Tests/check_wheel.py b/Tests/check_wheel.py
index afe4cc3eeaa..969e596b45a 100644
--- a/Tests/check_wheel.py
+++ b/Tests/check_wheel.py
@@ -4,7 +4,7 @@
 from PIL import features
 
 
-def test_wheel_modules():
+def test_wheel_modules() -> None:
     expected_modules = {"pil", "tkinter", "freetype2", "littlecms2", "webp"}
 
     # tkinter is not available in cibuildwheel installed CPython on Windows
@@ -18,13 +18,13 @@ def test_wheel_modules():
     assert set(features.get_supported_modules()) == expected_modules
 
 
-def test_wheel_codecs():
+def test_wheel_codecs() -> None:
     expected_codecs = {"jpg", "jpg_2000", "zlib", "libtiff"}
 
     assert set(features.get_supported_codecs()) == expected_codecs
 
 
-def test_wheel_features():
+def test_wheel_features() -> None:
     expected_features = {
         "webp_anim",
         "webp_mux",
diff --git a/Tests/helper.py b/Tests/helper.py
index 88c1f02a803..34839422e2f 100644
--- a/Tests/helper.py
+++ b/Tests/helper.py
@@ -238,7 +238,7 @@ def tostring(im, string_format, **options):
     return out.getvalue()
 
 
-def hopper(mode=None, cache={}):
+def hopper(mode: str | None = None, cache: dict[str, Image.Image] = {}) -> Image.Image:
     if mode is None:
         # Always return fresh not-yet-loaded version of image.
         # Operations on not-yet-loaded images is separate class of errors
@@ -323,7 +323,7 @@ def is_ppc64le():
     return platform.machine() == "ppc64le"
 
 
-def is_win32():
+def is_win32() -> bool:
     return sys.platform.startswith("win32")
 
 

From 9b6c1e3763000329e80173b99507e10aa0569b43 Mon Sep 17 00:00:00 2001
From: Andrew Murray <radarhere@users.noreply.github.com>
Date: Sat, 20 Jan 2024 11:13:06 +1100
Subject: [PATCH 0093/1178] Added type hints

---
 Tests/helper.py | 157 +++++++++++++++++++++++++++---------------------
 1 file changed, 89 insertions(+), 68 deletions(-)

diff --git a/Tests/helper.py b/Tests/helper.py
index 88c1f02a803..12a4fed3811 100644
--- a/Tests/helper.py
+++ b/Tests/helper.py
@@ -14,47 +14,46 @@
 
 import pytest
 from packaging.version import parse as parse_version
+from typing import Any, Callable, Sequence
 
 from PIL import Image, ImageMath, features
 
 logger = logging.getLogger(__name__)
 
-
-HAS_UPLOADER = False
-
+uploader = None
 if os.environ.get("SHOW_ERRORS"):
-    # local img.show for errors.
-    HAS_UPLOADER = True
-
-    class test_image_results:
-        @staticmethod
-        def upload(a, b):
-            a.show()
-            b.show()
-
+    uploader = "show"
 elif "GITHUB_ACTIONS" in os.environ:
-    HAS_UPLOADER = True
-
-    class test_image_results:
-        @staticmethod
-        def upload(a, b):
-            dir_errors = os.path.join(os.path.dirname(__file__), "errors")
-            os.makedirs(dir_errors, exist_ok=True)
-            tmpdir = tempfile.mkdtemp(dir=dir_errors)
-            a.save(os.path.join(tmpdir, "a.png"))
-            b.save(os.path.join(tmpdir, "b.png"))
-            return tmpdir
-
+    uploader = "github_actions"
 else:
     try:
         import test_image_results
 
-        HAS_UPLOADER = True
+        uploader = "aws"
     except ImportError:
         pass
 
 
-def convert_to_comparable(a, b):
+def upload(a: Image.Image, b: Image.Image) -> str | None:
+    if uploader == "show":
+        # local img.show for errors.
+        a.show()
+        b.show()
+    elif uploader == "github_actions":
+        dir_errors = os.path.join(os.path.dirname(__file__), "errors")
+        os.makedirs(dir_errors, exist_ok=True)
+        tmpdir = tempfile.mkdtemp(dir=dir_errors)
+        a.save(os.path.join(tmpdir, "a.png"))
+        b.save(os.path.join(tmpdir, "b.png"))
+        return tmpdir
+    elif uploader == "aws":
+        return test_image_results.upload(a, b)
+    return None
+
+
+def convert_to_comparable(
+    a: Image.Image, b: Image.Image
+) -> tuple[Image.Image, Image.Image]:
     new_a, new_b = a, b
     if a.mode == "P":
         new_a = Image.new("L", a.size)
@@ -67,14 +66,16 @@ def convert_to_comparable(a, b):
     return new_a, new_b
 
 
-def assert_deep_equal(a, b, msg=None):
+def assert_deep_equal(a: Any, b: Any, msg: str | None = None) -> None:
     try:
         assert len(a) == len(b), msg or f"got length {len(a)}, expected {len(b)}"
     except Exception:
         assert a == b, msg
 
 
-def assert_image(im, mode, size, msg=None):
+def assert_image(
+    im: Image.Image, mode: str, size: tuple[int, int], msg: str | None = None
+) -> None:
     if mode is not None:
         assert im.mode == mode, (
             msg or f"got mode {repr(im.mode)}, expected {repr(mode)}"
@@ -86,13 +87,13 @@ def assert_image(im, mode, size, msg=None):
         )
 
 
-def assert_image_equal(a, b, msg=None):
+def assert_image_equal(a: Image.Image, b: Image.Image, msg: str | None = None) -> None:
     assert a.mode == b.mode, msg or f"got mode {repr(a.mode)}, expected {repr(b.mode)}"
     assert a.size == b.size, msg or f"got size {repr(a.size)}, expected {repr(b.size)}"
     if a.tobytes() != b.tobytes():
-        if HAS_UPLOADER:
+        if uploader:
             try:
-                url = test_image_results.upload(a, b)
+                url = upload(a, b)
                 logger.error("URL for test images: %s", url)
             except Exception:
                 pass
@@ -100,14 +101,18 @@ def assert_image_equal(a, b, msg=None):
         pytest.fail(msg or "got different content")
 
 
-def assert_image_equal_tofile(a, filename, msg=None, mode=None):
+def assert_image_equal_tofile(
+    a: Image.Image, filename: str, msg: str | None = None, mode: str | None = None
+) -> None:
     with Image.open(filename) as img:
         if mode:
             img = img.convert(mode)
         assert_image_equal(a, img, msg)
 
 
-def assert_image_similar(a, b, epsilon, msg=None):
+def assert_image_similar(
+    a: Image.Image, b: Image.Image, epsilon: float, msg: str | None = None
+) -> None:
     assert a.mode == b.mode, msg or f"got mode {repr(a.mode)}, expected {repr(b.mode)}"
     assert a.size == b.size, msg or f"got size {repr(a.size)}, expected {repr(b.size)}"
 
@@ -125,37 +130,43 @@ def assert_image_similar(a, b, epsilon, msg=None):
             + f" average pixel value difference {ave_diff:.4f} > epsilon {epsilon:.4f}"
         )
     except Exception as e:
-        if HAS_UPLOADER:
+        if uploader:
             try:
-                url = test_image_results.upload(a, b)
+                url = upload(a, b)
                 logger.exception("URL for test images: %s", url)
             except Exception:
                 pass
         raise e
 
 
-def assert_image_similar_tofile(a, filename, epsilon, msg=None, mode=None):
+def assert_image_similar_tofile(
+    a: Image.Image,
+    filename: str,
+    epsilon: float,
+    msg: str | None = None,
+    mode: str | None = None,
+) -> None:
     with Image.open(filename) as img:
         if mode:
             img = img.convert(mode)
         assert_image_similar(a, img, epsilon, msg)
 
 
-def assert_all_same(items, msg=None):
+def assert_all_same(items: Sequence[Any], msg: str | None = None) -> None:
     assert items.count(items[0]) == len(items), msg
 
 
-def assert_not_all_same(items, msg=None):
+def assert_not_all_same(items: Sequence[Any], msg: str | None = None) -> None:
     assert items.count(items[0]) != len(items), msg
 
 
-def assert_tuple_approx_equal(actuals, targets, threshold, msg):
+def assert_tuple_approx_equal(
+    actuals: Sequence[int], targets: tuple[int, ...], threshold: int, msg: str
+) -> None:
     """Tests if actuals has values within threshold from targets"""
-    value = True
     for i, target in enumerate(targets):
-        value *= target - threshold <= actuals[i] <= target + threshold
-
-    assert value, msg + ": " + repr(actuals) + " != " + repr(targets)
+        if not (target - threshold <= actuals[i] <= target + threshold):
+            pytest.fail(msg + ": " + repr(actuals) + " != " + repr(targets))
 
 
 def skip_unless_feature(feature: str) -> pytest.MarkDecorator:
@@ -163,17 +174,24 @@ def skip_unless_feature(feature: str) -> pytest.MarkDecorator:
     return pytest.mark.skipif(not features.check(feature), reason=reason)
 
 
-def skip_unless_feature_version(feature, version_required, reason=None):
+def skip_unless_feature_version(
+    feature: str, required: str, reason: str | None = None
+) -> pytest.MarkDecorator:
     if not features.check(feature):
         return pytest.mark.skip(f"{feature} not available")
     if reason is None:
-        reason = f"{feature} is older than {version_required}"
-    version_required = parse_version(version_required)
+        reason = f"{feature} is older than {required}"
+    version_required = parse_version(required)
     version_available = parse_version(features.version(feature))
     return pytest.mark.skipif(version_available < version_required, reason=reason)
 
 
-def mark_if_feature_version(mark, feature, version_blacklist, reason=None):
+def mark_if_feature_version(
+    mark: pytest.MarkDecorator,
+    feature: str,
+    version_blacklist: str,
+    reason: str | None = None,
+) -> pytest.MarkDecorator:
     if not features.check(feature):
         return pytest.mark.pil_noop_mark()
     if reason is None:
@@ -194,7 +212,7 @@ class PillowLeakTestCase:
     iterations = 100  # count
     mem_limit = 512  # k
 
-    def _get_mem_usage(self):
+    def _get_mem_usage(self) -> float:
         """
         Gets the RUSAGE memory usage, returns in K. Encapsulates the difference
         between macOS and Linux rss reporting
@@ -216,7 +234,7 @@ def _get_mem_usage(self):
         #  This is the maximum resident set size used (in kilobytes).
         return mem  # Kb
 
-    def _test_leak(self, core):
+    def _test_leak(self, core: Callable[[], None]) -> None:
         start_mem = self._get_mem_usage()
         for cycle in range(self.iterations):
             core()
@@ -228,17 +246,17 @@ def _test_leak(self, core):
 # helpers
 
 
-def fromstring(data):
+def fromstring(data: bytes) -> Image.Image:
     return Image.open(BytesIO(data))
 
 
-def tostring(im, string_format, **options):
+def tostring(im: Image.Image, string_format: str, **options: dict[str, Any]) -> bytes:
     out = BytesIO()
     im.save(out, string_format, **options)
     return out.getvalue()
 
 
-def hopper(mode=None, cache={}):
+def hopper(mode: str | None = None, cache: dict[str, Image.Image] = {}) -> Image.Image:
     if mode is None:
         # Always return fresh not-yet-loaded version of image.
         # Operations on not-yet-loaded images is separate class of errors
@@ -259,29 +277,31 @@ def hopper(mode=None, cache={}):
     return im.copy()
 
 
-def djpeg_available():
+def djpeg_available() -> bool:
     if shutil.which("djpeg"):
         try:
             subprocess.check_call(["djpeg", "-version"])
             return True
         except subprocess.CalledProcessError:  # pragma: no cover
-            return False
+            pass
+    return False
 
 
-def cjpeg_available():
+def cjpeg_available() -> bool:
     if shutil.which("cjpeg"):
         try:
             subprocess.check_call(["cjpeg", "-version"])
             return True
         except subprocess.CalledProcessError:  # pragma: no cover
-            return False
+            pass
+    return False
 
 
-def netpbm_available():
+def netpbm_available() -> bool:
     return bool(shutil.which("ppmquant") and shutil.which("ppmtogif"))
 
 
-def magick_command():
+def magick_command() -> list[str] | None:
     if sys.platform == "win32":
         magickhome = os.environ.get("MAGICK_HOME")
         if magickhome:
@@ -298,47 +318,48 @@ def magick_command():
         return imagemagick
     if graphicsmagick and shutil.which(graphicsmagick[0]):
         return graphicsmagick
+    return None
 
 
-def on_appveyor():
+def on_appveyor() -> bool:
     return "APPVEYOR" in os.environ
 
 
-def on_github_actions():
+def on_github_actions() -> bool:
     return "GITHUB_ACTIONS" in os.environ
 
 
-def on_ci():
+def on_ci() -> bool:
     # GitHub Actions and AppVeyor have "CI"
     return "CI" in os.environ
 
 
-def is_big_endian():
+def is_big_endian() -> bool:
     return sys.byteorder == "big"
 
 
-def is_ppc64le():
+def is_ppc64le() -> bool:
     import platform
 
     return platform.machine() == "ppc64le"
 
 
-def is_win32():
+def is_win32() -> bool:
     return sys.platform.startswith("win32")
 
 
-def is_pypy():
+def is_pypy() -> bool:
     return hasattr(sys, "pypy_translation_info")
 
 
-def is_mingw():
+def is_mingw() -> bool:
     return sysconfig.get_platform() == "mingw"
 
 
 class CachedProperty:
-    def __init__(self, func):
+    def __init__(self, func: Callable[[Any], None]) -> None:
         self.func = func
 
-    def __get__(self, instance, cls=None):
+    def __get__(self, instance: Any, cls: type[Any] | None = None) -> Any:
         result = instance.__dict__[self.func.__name__] = self.func(instance)
         return result

From 5dc3de7974833bc8a0e2ecb389c6c183dd1a1d21 Mon Sep 17 00:00:00 2001
From: "renovate[bot]" <29139614+renovate[bot]@users.noreply.github.com>
Date: Sat, 20 Jan 2024 06:07:48 +0000
Subject: [PATCH 0094/1178] Update actions/cache action to v4

---
 .github/workflows/lint.yml         | 2 +-
 .github/workflows/test-cygwin.yml  | 2 +-
 .github/workflows/test-windows.yml | 2 +-
 3 files changed, 3 insertions(+), 3 deletions(-)

diff --git a/.github/workflows/lint.yml b/.github/workflows/lint.yml
index 9069fc615f3..cc4760288e5 100644
--- a/.github/workflows/lint.yml
+++ b/.github/workflows/lint.yml
@@ -23,7 +23,7 @@ jobs:
     - uses: actions/checkout@v4
 
     - name: pre-commit cache
-      uses: actions/cache@v3
+      uses: actions/cache@v4
       with:
         path: ~/.cache/pre-commit
         key: lint-pre-commit-${{ hashFiles('**/.pre-commit-config.yaml') }}
diff --git a/.github/workflows/test-cygwin.yml b/.github/workflows/test-cygwin.yml
index 7244315ac15..9c3eb092417 100644
--- a/.github/workflows/test-cygwin.yml
+++ b/.github/workflows/test-cygwin.yml
@@ -95,7 +95,7 @@ jobs:
           python3 -m pip list --outdated | grep numpy | sed -r 's/ +/ /g' | cut -d ' ' -f 3 | sed 's/^/version=/' >> $GITHUB_OUTPUT
 
       - name: pip cache
-        uses: actions/cache@v3
+        uses: actions/cache@v4
         with:
           path: 'C:\cygwin\home\runneradmin\.cache\pip'
           key: ${{ runner.os }}-cygwin-pip3.${{ matrix.python-minor-version }}-numpy${{ steps.latest-numpy.outputs.version }}-${{ hashFiles('.ci/install.sh') }}
diff --git a/.github/workflows/test-windows.yml b/.github/workflows/test-windows.yml
index 372f97fd667..8cad7a8b281 100644
--- a/.github/workflows/test-windows.yml
+++ b/.github/workflows/test-windows.yml
@@ -89,7 +89,7 @@ jobs:
 
     - name: Cache build
       id: build-cache
-      uses: actions/cache@v3
+      uses: actions/cache@v4
       with:
         path: winbuild\build
         key:

From 74af933a9f0441e1285c398675dc3eca1de5406c Mon Sep 17 00:00:00 2001
From: =?UTF-8?q?Ondrej=20Baranovi=C4=8D?= <nulano@nulano.eu>
Date: Sat, 20 Jan 2024 10:08:14 +0100
Subject: [PATCH 0095/1178] Link to stable setuptools documentation

Co-authored-by: Andrew Murray <3112309+radarhere@users.noreply.github.com>
---
 winbuild/build.rst | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/winbuild/build.rst b/winbuild/build.rst
index 26d0da0a35a..f40982cd546 100644
--- a/winbuild/build.rst
+++ b/winbuild/build.rst
@@ -97,7 +97,7 @@ To build a wheel instead, run::
     winbuild\build\build_env.cmd
     python.exe -m pip wheel -v -C raqm=vendor -C fribidi=vendor .
 
-.. _editable mode: https://setuptools.pypa.io/en/latest/userguide/development_mode.html
+.. _editable mode: https://setuptools.pypa.io/en/stable/userguide/development_mode.html
 
 Testing Pillow
 --------------

From f7701e6596c9a2e7c9ed886621f01b3861d70990 Mon Sep 17 00:00:00 2001
From: Andrew Murray <radarhere@users.noreply.github.com>
Date: Sat, 20 Jan 2024 21:04:57 +1100
Subject: [PATCH 0096/1178] Do not log URL of test images if there is no URL

---
 Tests/helper.py | 20 ++++++++++----------
 1 file changed, 10 insertions(+), 10 deletions(-)

diff --git a/Tests/helper.py b/Tests/helper.py
index 12a4fed3811..670c93633d7 100644
--- a/Tests/helper.py
+++ b/Tests/helper.py
@@ -91,12 +91,12 @@ def assert_image_equal(a: Image.Image, b: Image.Image, msg: str | None = None) -
     assert a.mode == b.mode, msg or f"got mode {repr(a.mode)}, expected {repr(b.mode)}"
     assert a.size == b.size, msg or f"got size {repr(a.size)}, expected {repr(b.size)}"
     if a.tobytes() != b.tobytes():
-        if uploader:
-            try:
-                url = upload(a, b)
+        try:
+            url = upload(a, b)
+            if url:
                 logger.error("URL for test images: %s", url)
-            except Exception:
-                pass
+        except Exception:
+            pass
 
         pytest.fail(msg or "got different content")
 
@@ -130,12 +130,12 @@ def assert_image_similar(
             + f" average pixel value difference {ave_diff:.4f} > epsilon {epsilon:.4f}"
         )
     except Exception as e:
-        if uploader:
-            try:
-                url = upload(a, b)
+        try:
+            url = upload(a, b)
+            if url:
                 logger.exception("URL for test images: %s", url)
-            except Exception:
-                pass
+        except Exception:
+            pass
         raise e
 
 

From 99d851957fec5394bbc9d61ceff57f534bd1b873 Mon Sep 17 00:00:00 2001
From: Andrew Murray <3112309+radarhere@users.noreply.github.com>
Date: Sat, 20 Jan 2024 21:23:08 +1100
Subject: [PATCH 0097/1178] Return early

Co-authored-by: Hugo van Kemenade <1324225+hugovk@users.noreply.github.com>
---
 Tests/helper.py | 4 ++--
 1 file changed, 2 insertions(+), 2 deletions(-)

diff --git a/Tests/helper.py b/Tests/helper.py
index 670c93633d7..e4ed9c551ae 100644
--- a/Tests/helper.py
+++ b/Tests/helper.py
@@ -283,7 +283,7 @@ def djpeg_available() -> bool:
             subprocess.check_call(["djpeg", "-version"])
             return True
         except subprocess.CalledProcessError:  # pragma: no cover
-            pass
+            return False
     return False
 
 
@@ -293,7 +293,7 @@ def cjpeg_available() -> bool:
             subprocess.check_call(["cjpeg", "-version"])
             return True
         except subprocess.CalledProcessError:  # pragma: no cover
-            pass
+            return False
     return False
 
 

From 970bd102ba0304adeb5351cc09c616ab23535d2c Mon Sep 17 00:00:00 2001
From: Andrew Murray <3112309+radarhere@users.noreply.github.com>
Date: Sat, 20 Jan 2024 21:24:34 +1100
Subject: [PATCH 0098/1178] Updated type hint

Co-authored-by: Hugo van Kemenade <1324225+hugovk@users.noreply.github.com>
---
 Tests/helper.py | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/Tests/helper.py b/Tests/helper.py
index e4ed9c551ae..4d2d27226ae 100644
--- a/Tests/helper.py
+++ b/Tests/helper.py
@@ -66,7 +66,7 @@ def convert_to_comparable(
     return new_a, new_b
 
 
-def assert_deep_equal(a: Any, b: Any, msg: str | None = None) -> None:
+def assert_deep_equal(a: Sequence[Any], b: Sequence[Any], msg: str | None = None) -> None:
     try:
         assert len(a) == len(b), msg or f"got length {len(a)}, expected {len(b)}"
     except Exception:

From 9454c28f0f8363d1316b1dfec0f23404f9e36082 Mon Sep 17 00:00:00 2001
From: "pre-commit-ci[bot]"
 <66853113+pre-commit-ci[bot]@users.noreply.github.com>
Date: Sat, 20 Jan 2024 10:24:54 +0000
Subject: [PATCH 0099/1178] [pre-commit.ci] auto fixes from pre-commit.com
 hooks

for more information, see https://pre-commit.ci
---
 Tests/helper.py | 4 +++-
 1 file changed, 3 insertions(+), 1 deletion(-)

diff --git a/Tests/helper.py b/Tests/helper.py
index 4d2d27226ae..203d20053c3 100644
--- a/Tests/helper.py
+++ b/Tests/helper.py
@@ -66,7 +66,9 @@ def convert_to_comparable(
     return new_a, new_b
 
 
-def assert_deep_equal(a: Sequence[Any], b: Sequence[Any], msg: str | None = None) -> None:
+def assert_deep_equal(
+    a: Sequence[Any], b: Sequence[Any], msg: str | None = None
+) -> None:
     try:
         assert len(a) == len(b), msg or f"got length {len(a)}, expected {len(b)}"
     except Exception:

From a18cee35ff4362c834d0fa43277ee5b02ab9c693 Mon Sep 17 00:00:00 2001
From: Andrew Murray <3112309+radarhere@users.noreply.github.com>
Date: Sat, 20 Jan 2024 21:26:31 +1100
Subject: [PATCH 0100/1178] Updated import order

Co-authored-by: Hugo van Kemenade <1324225+hugovk@users.noreply.github.com>
---
 Tests/helper.py | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/Tests/helper.py b/Tests/helper.py
index 203d20053c3..99170c765dd 100644
--- a/Tests/helper.py
+++ b/Tests/helper.py
@@ -11,10 +11,10 @@
 import sysconfig
 import tempfile
 from io import BytesIO
+from typing import Any, Callable, Sequence
 
 import pytest
 from packaging.version import parse as parse_version
-from typing import Any, Callable, Sequence
 
 from PIL import Image, ImageMath, features
 

From eba0be98ecea7150c691e05bf6faa3c73c121689 Mon Sep 17 00:00:00 2001
From: Hugo van Kemenade <1324225+hugovk@users.noreply.github.com>
Date: Sat, 20 Jan 2024 13:22:04 +0200
Subject: [PATCH 0101/1178] isort Tests

---
 pyproject.toml | 1 -
 1 file changed, 1 deletion(-)

diff --git a/pyproject.toml b/pyproject.toml
index 789df6f5e67..b1ce9cf1d07 100644
--- a/pyproject.toml
+++ b/pyproject.toml
@@ -119,7 +119,6 @@ extend-ignore = [
 ]
 
 [tool.ruff.per-file-ignores]
-"Tests/*.py" = ["I001"]
 "Tests/oss-fuzz/fuzz_font.py" = ["I002"]
 "Tests/oss-fuzz/fuzz_pillow.py" = ["I002"]
 

From 53c3cd9f8e91afc038b64b14cd63d1eb592f717a Mon Sep 17 00:00:00 2001
From: Hugo van Kemenade <1324225+hugovk@users.noreply.github.com>
Date: Sat, 20 Jan 2024 13:23:03 +0200
Subject: [PATCH 0102/1178] isort Tests

---
 Tests/bench_cffi_access.py          | 1 +
 Tests/check_fli_overflow.py         | 1 +
 Tests/check_imaging_leaks.py        | 1 +
 Tests/check_j2k_leaks.py            | 1 +
 Tests/check_j2k_overflow.py         | 1 +
 Tests/check_jp2_overflow.py         | 1 -
 Tests/check_jpeg_leaks.py           | 1 +
 Tests/check_large_memory.py         | 1 +
 Tests/check_large_memory_numpy.py   | 1 +
 Tests/check_libtiff_segfault.py     | 1 +
 Tests/check_png_dos.py              | 1 +
 Tests/check_release_notes.py        | 1 +
 Tests/check_wheel.py                | 1 +
 Tests/conftest.py                   | 1 +
 Tests/createfontdatachunk.py        | 1 +
 Tests/oss-fuzz/fuzzers.py           | 1 +
 Tests/oss-fuzz/test_fuzzers.py      | 1 +
 Tests/test_000_sanity.py            | 1 +
 Tests/test_binary.py                | 1 +
 Tests/test_bmp_reference.py         | 1 +
 Tests/test_box_blur.py              | 1 +
 Tests/test_color_lut.py             | 1 +
 Tests/test_core_resources.py        | 1 +
 Tests/test_decompression_bomb.py    | 1 +
 Tests/test_deprecate.py             | 1 +
 Tests/test_features.py              | 1 +
 Tests/test_file_apng.py             | 1 +
 Tests/test_file_blp.py              | 1 +
 Tests/test_file_bmp.py              | 1 +
 Tests/test_file_bufrstub.py         | 1 +
 Tests/test_file_container.py        | 1 +
 Tests/test_file_cur.py              | 1 +
 Tests/test_file_dcx.py              | 1 +
 Tests/test_file_dds.py              | 1 +
 Tests/test_file_eps.py              | 1 +
 Tests/test_file_fits.py             | 1 +
 Tests/test_file_fli.py              | 1 +
 Tests/test_file_fpx.py              | 1 +
 Tests/test_file_ftex.py             | 1 +
 Tests/test_file_gbr.py              | 1 +
 Tests/test_file_gd.py               | 1 +
 Tests/test_file_gif.py              | 1 +
 Tests/test_file_gimpgradient.py     | 1 +
 Tests/test_file_gimppalette.py      | 1 +
 Tests/test_file_gribstub.py         | 1 +
 Tests/test_file_hdf5stub.py         | 1 +
 Tests/test_file_icns.py             | 1 +
 Tests/test_file_ico.py              | 1 +
 Tests/test_file_im.py               | 1 +
 Tests/test_file_imt.py              | 1 +
 Tests/test_file_iptc.py             | 1 +
 Tests/test_file_jpeg.py             | 1 +
 Tests/test_file_jpeg2k.py           | 1 +
 Tests/test_file_libtiff.py          | 1 +
 Tests/test_file_libtiff_small.py    | 1 +
 Tests/test_file_mcidas.py           | 1 +
 Tests/test_file_mic.py              | 1 +
 Tests/test_file_mpo.py              | 1 +
 Tests/test_file_msp.py              | 1 +
 Tests/test_file_palm.py             | 1 +
 Tests/test_file_pcd.py              | 1 +
 Tests/test_file_pcx.py              | 1 +
 Tests/test_file_pdf.py              | 1 +
 Tests/test_file_pixar.py            | 1 +
 Tests/test_file_png.py              | 1 +
 Tests/test_file_ppm.py              | 1 +
 Tests/test_file_psd.py              | 1 +
 Tests/test_file_qoi.py              | 1 +
 Tests/test_file_sgi.py              | 1 +
 Tests/test_file_spider.py           | 1 +
 Tests/test_file_sun.py              | 1 +
 Tests/test_file_tar.py              | 1 +
 Tests/test_file_tga.py              | 1 +
 Tests/test_file_tiff.py             | 1 +
 Tests/test_file_tiff_metadata.py    | 1 +
 Tests/test_file_wal.py              | 1 +
 Tests/test_file_webp.py             | 1 +
 Tests/test_file_webp_alpha.py       | 1 +
 Tests/test_file_webp_animated.py    | 1 +
 Tests/test_file_webp_lossless.py    | 1 +
 Tests/test_file_webp_metadata.py    | 1 +
 Tests/test_file_wmf.py              | 1 +
 Tests/test_file_xbm.py              | 1 +
 Tests/test_file_xpm.py              | 1 +
 Tests/test_file_xvthumb.py          | 1 +
 Tests/test_font_bdf.py              | 1 +
 Tests/test_font_crash.py            | 1 +
 Tests/test_font_leaks.py            | 1 +
 Tests/test_font_pcf.py              | 1 +
 Tests/test_font_pcf_charsets.py     | 1 +
 Tests/test_fontfile.py              | 1 +
 Tests/test_format_hsv.py            | 1 +
 Tests/test_format_lab.py            | 1 +
 Tests/test_image.py                 | 1 +
 Tests/test_image_access.py          | 1 +
 Tests/test_image_array.py           | 1 +
 Tests/test_image_convert.py         | 1 +
 Tests/test_image_copy.py            | 1 +
 Tests/test_image_crop.py            | 1 +
 Tests/test_image_draft.py           | 1 +
 Tests/test_image_entropy.py         | 1 +
 Tests/test_image_filter.py          | 1 +
 Tests/test_image_frombytes.py       | 1 +
 Tests/test_image_fromqimage.py      | 1 +
 Tests/test_image_getbands.py        | 1 +
 Tests/test_image_getbbox.py         | 1 +
 Tests/test_image_getcolors.py       | 1 +
 Tests/test_image_getdata.py         | 1 +
 Tests/test_image_getextrema.py      | 1 +
 Tests/test_image_getim.py           | 1 +
 Tests/test_image_getpalette.py      | 1 +
 Tests/test_image_getprojection.py   | 1 +
 Tests/test_image_histogram.py       | 1 +
 Tests/test_image_load.py            | 1 +
 Tests/test_image_mode.py            | 1 +
 Tests/test_image_paste.py           | 1 +
 Tests/test_image_point.py           | 1 +
 Tests/test_image_putalpha.py        | 1 +
 Tests/test_image_putdata.py         | 1 +
 Tests/test_image_putpalette.py      | 1 +
 Tests/test_image_quantize.py        | 1 +
 Tests/test_image_reduce.py          | 1 +
 Tests/test_image_resample.py        | 1 +
 Tests/test_image_resize.py          | 1 +
 Tests/test_image_rotate.py          | 1 +
 Tests/test_image_split.py           | 1 +
 Tests/test_image_thumbnail.py       | 1 +
 Tests/test_image_tobitmap.py        | 1 +
 Tests/test_image_tobytes.py         | 1 +
 Tests/test_image_transform.py       | 1 +
 Tests/test_image_transpose.py       | 1 +
 Tests/test_imagechops.py            | 1 +
 Tests/test_imagecms.py              | 1 +
 Tests/test_imagecolor.py            | 1 +
 Tests/test_imagedraw.py             | 1 +
 Tests/test_imagedraw2.py            | 1 +
 Tests/test_imageenhance.py          | 1 +
 Tests/test_imagefile.py             | 1 +
 Tests/test_imagefont.py             | 1 +
 Tests/test_imagefontctl.py          | 1 +
 Tests/test_imagefontpil.py          | 6 ++++--
 Tests/test_imagegrab.py             | 1 +
 Tests/test_imagemath.py             | 1 +
 Tests/test_imagemorph.py            | 1 +
 Tests/test_imageops.py              | 1 +
 Tests/test_imageops_usm.py          | 1 +
 Tests/test_imagepalette.py          | 1 +
 Tests/test_imagepath.py             | 1 +
 Tests/test_imageqt.py               | 1 +
 Tests/test_imagesequence.py         | 1 +
 Tests/test_imageshow.py             | 1 +
 Tests/test_imagestat.py             | 1 +
 Tests/test_imagetk.py               | 1 +
 Tests/test_imagewin.py              | 1 +
 Tests/test_imagewin_pointers.py     | 1 +
 Tests/test_lib_image.py             | 1 +
 Tests/test_lib_pack.py              | 1 +
 Tests/test_locale.py                | 1 +
 Tests/test_main.py                  | 1 +
 Tests/test_map.py                   | 1 +
 Tests/test_mode_i16.py              | 1 +
 Tests/test_numpy.py                 | 1 +
 Tests/test_pdfparser.py             | 1 +
 Tests/test_pickle.py                | 1 +
 Tests/test_psdraw.py                | 1 +
 Tests/test_pyroma.py                | 1 +
 Tests/test_qt_image_qapplication.py | 1 +
 Tests/test_qt_image_toqimage.py     | 1 +
 Tests/test_sgi_crash.py             | 1 +
 Tests/test_shell_injection.py       | 1 +
 Tests/test_tiff_ifdrational.py      | 1 +
 Tests/test_uploader.py              | 1 +
 Tests/test_util.py                  | 1 +
 Tests/test_webp_leaks.py            | 1 +
 174 files changed, 176 insertions(+), 3 deletions(-)

diff --git a/Tests/bench_cffi_access.py b/Tests/bench_cffi_access.py
index 8a37c7d5157..ad15a9739b2 100644
--- a/Tests/bench_cffi_access.py
+++ b/Tests/bench_cffi_access.py
@@ -1,4 +1,5 @@
 from __future__ import annotations
+
 import time
 
 from PIL import PyAccess
diff --git a/Tests/check_fli_overflow.py b/Tests/check_fli_overflow.py
index 0fabcb5d35f..8cb6ac0a6a8 100644
--- a/Tests/check_fli_overflow.py
+++ b/Tests/check_fli_overflow.py
@@ -1,4 +1,5 @@
 from __future__ import annotations
+
 from PIL import Image
 
 TEST_FILE = "Tests/images/fli_overflow.fli"
diff --git a/Tests/check_imaging_leaks.py b/Tests/check_imaging_leaks.py
index 8c17c051d4b..eed326a4ca8 100755
--- a/Tests/check_imaging_leaks.py
+++ b/Tests/check_imaging_leaks.py
@@ -1,5 +1,6 @@
 #!/usr/bin/env python3
 from __future__ import annotations
+
 import pytest
 
 from PIL import Image
diff --git a/Tests/check_j2k_leaks.py b/Tests/check_j2k_leaks.py
index 83a12e2c29f..249c92cef86 100644
--- a/Tests/check_j2k_leaks.py
+++ b/Tests/check_j2k_leaks.py
@@ -1,4 +1,5 @@
 from __future__ import annotations
+
 from io import BytesIO
 
 import pytest
diff --git a/Tests/check_j2k_overflow.py b/Tests/check_j2k_overflow.py
index 982f6ea74d2..6f3aa437ea1 100644
--- a/Tests/check_j2k_overflow.py
+++ b/Tests/check_j2k_overflow.py
@@ -1,4 +1,5 @@
 from __future__ import annotations
+
 import pytest
 
 from PIL import Image
diff --git a/Tests/check_jp2_overflow.py b/Tests/check_jp2_overflow.py
index 9afbff112b0..5adbb84b69c 100755
--- a/Tests/check_jp2_overflow.py
+++ b/Tests/check_jp2_overflow.py
@@ -14,7 +14,6 @@
 # version.
 from __future__ import annotations
 
-
 from PIL import Image
 
 repro = ("00r0_gray_l.jp2", "00r1_graya_la.jp2")
diff --git a/Tests/check_jpeg_leaks.py b/Tests/check_jpeg_leaks.py
index 3cd37c7af7b..147deb28593 100644
--- a/Tests/check_jpeg_leaks.py
+++ b/Tests/check_jpeg_leaks.py
@@ -1,4 +1,5 @@
 from __future__ import annotations
+
 from io import BytesIO
 
 import pytest
diff --git a/Tests/check_large_memory.py b/Tests/check_large_memory.py
index 9b83798d5e7..fb336f6e142 100644
--- a/Tests/check_large_memory.py
+++ b/Tests/check_large_memory.py
@@ -1,4 +1,5 @@
 from __future__ import annotations
+
 import sys
 
 import pytest
diff --git a/Tests/check_large_memory_numpy.py b/Tests/check_large_memory_numpy.py
index 0ff3de8dcc7..d91d615f8f8 100644
--- a/Tests/check_large_memory_numpy.py
+++ b/Tests/check_large_memory_numpy.py
@@ -1,4 +1,5 @@
 from __future__ import annotations
+
 import sys
 
 import pytest
diff --git a/Tests/check_libtiff_segfault.py b/Tests/check_libtiff_segfault.py
index ee1d7d11f0c..17b5336286f 100644
--- a/Tests/check_libtiff_segfault.py
+++ b/Tests/check_libtiff_segfault.py
@@ -1,4 +1,5 @@
 from __future__ import annotations
+
 import pytest
 
 from PIL import Image
diff --git a/Tests/check_png_dos.py b/Tests/check_png_dos.py
index 292fe4b7f09..7b0ed242435 100644
--- a/Tests/check_png_dos.py
+++ b/Tests/check_png_dos.py
@@ -1,4 +1,5 @@
 from __future__ import annotations
+
 import zlib
 from io import BytesIO
 
diff --git a/Tests/check_release_notes.py b/Tests/check_release_notes.py
index ebfaffa47e1..cf414d7fff0 100644
--- a/Tests/check_release_notes.py
+++ b/Tests/check_release_notes.py
@@ -1,4 +1,5 @@
 from __future__ import annotations
+
 import sys
 from pathlib import Path
 
diff --git a/Tests/check_wheel.py b/Tests/check_wheel.py
index afe4cc3eeaa..daf9e621148 100644
--- a/Tests/check_wheel.py
+++ b/Tests/check_wheel.py
@@ -1,4 +1,5 @@
 from __future__ import annotations
+
 import sys
 
 from PIL import features
diff --git a/Tests/conftest.py b/Tests/conftest.py
index cd64bd755f0..ac618c5b945 100644
--- a/Tests/conftest.py
+++ b/Tests/conftest.py
@@ -1,4 +1,5 @@
 from __future__ import annotations
+
 import io
 
 
diff --git a/Tests/createfontdatachunk.py b/Tests/createfontdatachunk.py
index 2e990b70916..41c76f87eac 100755
--- a/Tests/createfontdatachunk.py
+++ b/Tests/createfontdatachunk.py
@@ -1,5 +1,6 @@
 #!/usr/bin/env python3
 from __future__ import annotations
+
 import base64
 import os
 
diff --git a/Tests/oss-fuzz/fuzzers.py b/Tests/oss-fuzz/fuzzers.py
index 3f3c1e38833..5c00e9716cb 100644
--- a/Tests/oss-fuzz/fuzzers.py
+++ b/Tests/oss-fuzz/fuzzers.py
@@ -1,4 +1,5 @@
 from __future__ import annotations
+
 import io
 import warnings
 
diff --git a/Tests/oss-fuzz/test_fuzzers.py b/Tests/oss-fuzz/test_fuzzers.py
index 68834045a52..bf4fb45ff98 100644
--- a/Tests/oss-fuzz/test_fuzzers.py
+++ b/Tests/oss-fuzz/test_fuzzers.py
@@ -1,4 +1,5 @@
 from __future__ import annotations
+
 import subprocess
 import sys
 
diff --git a/Tests/test_000_sanity.py b/Tests/test_000_sanity.py
index c582dfad3e4..f64216bca8e 100644
--- a/Tests/test_000_sanity.py
+++ b/Tests/test_000_sanity.py
@@ -1,4 +1,5 @@
 from __future__ import annotations
+
 from PIL import Image
 
 
diff --git a/Tests/test_binary.py b/Tests/test_binary.py
index 62da2663668..41fb93fcf48 100644
--- a/Tests/test_binary.py
+++ b/Tests/test_binary.py
@@ -1,4 +1,5 @@
 from __future__ import annotations
+
 from PIL import _binary
 
 
diff --git a/Tests/test_bmp_reference.py b/Tests/test_bmp_reference.py
index bed8dc3a899..0da41e85845 100644
--- a/Tests/test_bmp_reference.py
+++ b/Tests/test_bmp_reference.py
@@ -1,4 +1,5 @@
 from __future__ import annotations
+
 import os
 import warnings
 
diff --git a/Tests/test_box_blur.py b/Tests/test_box_blur.py
index e798cba3d4f..461e6aaacb3 100644
--- a/Tests/test_box_blur.py
+++ b/Tests/test_box_blur.py
@@ -1,4 +1,5 @@
 from __future__ import annotations
+
 import pytest
 
 from PIL import Image, ImageFilter
diff --git a/Tests/test_color_lut.py b/Tests/test_color_lut.py
index 448ba2fac80..fcd1169ef81 100644
--- a/Tests/test_color_lut.py
+++ b/Tests/test_color_lut.py
@@ -1,4 +1,5 @@
 from __future__ import annotations
+
 from array import array
 
 import pytest
diff --git a/Tests/test_core_resources.py b/Tests/test_core_resources.py
index 5275652f66a..d3f76fdb1b9 100644
--- a/Tests/test_core_resources.py
+++ b/Tests/test_core_resources.py
@@ -1,4 +1,5 @@
 from __future__ import annotations
+
 import sys
 
 import pytest
diff --git a/Tests/test_decompression_bomb.py b/Tests/test_decompression_bomb.py
index 391948d40c7..d3049eff124 100644
--- a/Tests/test_decompression_bomb.py
+++ b/Tests/test_decompression_bomb.py
@@ -1,4 +1,5 @@
 from __future__ import annotations
+
 import pytest
 
 from PIL import Image
diff --git a/Tests/test_deprecate.py b/Tests/test_deprecate.py
index d45a6603c54..6c7f509a795 100644
--- a/Tests/test_deprecate.py
+++ b/Tests/test_deprecate.py
@@ -1,4 +1,5 @@
 from __future__ import annotations
+
 import pytest
 
 from PIL import _deprecate
diff --git a/Tests/test_features.py b/Tests/test_features.py
index 8f0e4b4184a..b90c1d25f2b 100644
--- a/Tests/test_features.py
+++ b/Tests/test_features.py
@@ -1,4 +1,5 @@
 from __future__ import annotations
+
 import io
 import re
 
diff --git a/Tests/test_file_apng.py b/Tests/test_file_apng.py
index e2c4569cee5..23263b5d459 100644
--- a/Tests/test_file_apng.py
+++ b/Tests/test_file_apng.py
@@ -1,4 +1,5 @@
 from __future__ import annotations
+
 import pytest
 
 from PIL import Image, ImageSequence, PngImagePlugin
diff --git a/Tests/test_file_blp.py b/Tests/test_file_blp.py
index 4c1e38d1ddf..27ff7ab6640 100644
--- a/Tests/test_file_blp.py
+++ b/Tests/test_file_blp.py
@@ -1,4 +1,5 @@
 from __future__ import annotations
+
 import pytest
 
 from PIL import Image
diff --git a/Tests/test_file_bmp.py b/Tests/test_file_bmp.py
index 4cc92c5f684..225fb28ba51 100644
--- a/Tests/test_file_bmp.py
+++ b/Tests/test_file_bmp.py
@@ -1,4 +1,5 @@
 from __future__ import annotations
+
 import io
 
 import pytest
diff --git a/Tests/test_file_bufrstub.py b/Tests/test_file_bufrstub.py
index 5780232a2d6..45081832e68 100644
--- a/Tests/test_file_bufrstub.py
+++ b/Tests/test_file_bufrstub.py
@@ -1,4 +1,5 @@
 from __future__ import annotations
+
 import pytest
 
 from PIL import BufrStubImagePlugin, Image
diff --git a/Tests/test_file_container.py b/Tests/test_file_container.py
index 0da5d3824b0..95a5b2337d8 100644
--- a/Tests/test_file_container.py
+++ b/Tests/test_file_container.py
@@ -1,4 +1,5 @@
 from __future__ import annotations
+
 import pytest
 
 from PIL import ContainerIO, Image
diff --git a/Tests/test_file_cur.py b/Tests/test_file_cur.py
index 08c3257f9d1..27b2bc91489 100644
--- a/Tests/test_file_cur.py
+++ b/Tests/test_file_cur.py
@@ -1,4 +1,5 @@
 from __future__ import annotations
+
 import pytest
 
 from PIL import CurImagePlugin, Image
diff --git a/Tests/test_file_dcx.py b/Tests/test_file_dcx.py
index 25e4badbc92..cba7c10bf76 100644
--- a/Tests/test_file_dcx.py
+++ b/Tests/test_file_dcx.py
@@ -1,4 +1,5 @@
 from __future__ import annotations
+
 import warnings
 
 import pytest
diff --git a/Tests/test_file_dds.py b/Tests/test_file_dds.py
index a605c8399d8..7064b74c07b 100644
--- a/Tests/test_file_dds.py
+++ b/Tests/test_file_dds.py
@@ -1,5 +1,6 @@
 """Test DdsImagePlugin"""
 from __future__ import annotations
+
 from io import BytesIO
 
 import pytest
diff --git a/Tests/test_file_eps.py b/Tests/test_file_eps.py
index 8b48e83ad2c..8def9a43511 100644
--- a/Tests/test_file_eps.py
+++ b/Tests/test_file_eps.py
@@ -1,4 +1,5 @@
 from __future__ import annotations
+
 import io
 
 import pytest
diff --git a/Tests/test_file_fits.py b/Tests/test_file_fits.py
index 1383f9c5ca3..7444eb673cb 100644
--- a/Tests/test_file_fits.py
+++ b/Tests/test_file_fits.py
@@ -1,4 +1,5 @@
 from __future__ import annotations
+
 from io import BytesIO
 
 import pytest
diff --git a/Tests/test_file_fli.py b/Tests/test_file_fli.py
index 10bf36cc290..00377e0c92d 100644
--- a/Tests/test_file_fli.py
+++ b/Tests/test_file_fli.py
@@ -1,4 +1,5 @@
 from __future__ import annotations
+
 import warnings
 
 import pytest
diff --git a/Tests/test_file_fpx.py b/Tests/test_file_fpx.py
index af3b7981561..d710070c01b 100644
--- a/Tests/test_file_fpx.py
+++ b/Tests/test_file_fpx.py
@@ -1,4 +1,5 @@
 from __future__ import annotations
+
 import pytest
 
 from PIL import Image
diff --git a/Tests/test_file_ftex.py b/Tests/test_file_ftex.py
index a494c8029c9..0f9154e3d09 100644
--- a/Tests/test_file_ftex.py
+++ b/Tests/test_file_ftex.py
@@ -1,4 +1,5 @@
 from __future__ import annotations
+
 import pytest
 
 from PIL import FtexImagePlugin, Image
diff --git a/Tests/test_file_gbr.py b/Tests/test_file_gbr.py
index 7dfe0539673..d84004e1483 100644
--- a/Tests/test_file_gbr.py
+++ b/Tests/test_file_gbr.py
@@ -1,4 +1,5 @@
 from __future__ import annotations
+
 import pytest
 
 from PIL import GbrImagePlugin, Image
diff --git a/Tests/test_file_gd.py b/Tests/test_file_gd.py
index ec80c54a122..e7db54fb44c 100644
--- a/Tests/test_file_gd.py
+++ b/Tests/test_file_gd.py
@@ -1,4 +1,5 @@
 from __future__ import annotations
+
 import pytest
 
 from PIL import GdImageFile, UnidentifiedImageError
diff --git a/Tests/test_file_gif.py b/Tests/test_file_gif.py
index 78b77e9743a..3e19940aab9 100644
--- a/Tests/test_file_gif.py
+++ b/Tests/test_file_gif.py
@@ -1,4 +1,5 @@
 from __future__ import annotations
+
 import warnings
 from io import BytesIO
 
diff --git a/Tests/test_file_gimpgradient.py b/Tests/test_file_gimpgradient.py
index d5be46dc39e..ceea1edd34c 100644
--- a/Tests/test_file_gimpgradient.py
+++ b/Tests/test_file_gimpgradient.py
@@ -1,4 +1,5 @@
 from __future__ import annotations
+
 from PIL import GimpGradientFile, ImagePalette
 
 
diff --git a/Tests/test_file_gimppalette.py b/Tests/test_file_gimppalette.py
index 775d3b7cdae..28855c28acc 100644
--- a/Tests/test_file_gimppalette.py
+++ b/Tests/test_file_gimppalette.py
@@ -1,4 +1,5 @@
 from __future__ import annotations
+
 import pytest
 
 from PIL.GimpPaletteFile import GimpPaletteFile
diff --git a/Tests/test_file_gribstub.py b/Tests/test_file_gribstub.py
index d962e85a436..a4ce6dde674 100644
--- a/Tests/test_file_gribstub.py
+++ b/Tests/test_file_gribstub.py
@@ -1,4 +1,5 @@
 from __future__ import annotations
+
 import pytest
 
 from PIL import GribStubImagePlugin, Image
diff --git a/Tests/test_file_hdf5stub.py b/Tests/test_file_hdf5stub.py
index 9c776b712ee..72764461730 100644
--- a/Tests/test_file_hdf5stub.py
+++ b/Tests/test_file_hdf5stub.py
@@ -1,4 +1,5 @@
 from __future__ import annotations
+
 import pytest
 
 from PIL import Hdf5StubImagePlugin, Image
diff --git a/Tests/test_file_icns.py b/Tests/test_file_icns.py
index c62fffc5be8..314fa800868 100644
--- a/Tests/test_file_icns.py
+++ b/Tests/test_file_icns.py
@@ -1,4 +1,5 @@
 from __future__ import annotations
+
 import io
 import os
 import warnings
diff --git a/Tests/test_file_ico.py b/Tests/test_file_ico.py
index de9fa353adb..99b3048d1e0 100644
--- a/Tests/test_file_ico.py
+++ b/Tests/test_file_ico.py
@@ -1,4 +1,5 @@
 from __future__ import annotations
+
 import io
 import os
 
diff --git a/Tests/test_file_im.py b/Tests/test_file_im.py
index 0cb26d06a51..a031b3e887c 100644
--- a/Tests/test_file_im.py
+++ b/Tests/test_file_im.py
@@ -1,4 +1,5 @@
 from __future__ import annotations
+
 import filecmp
 import warnings
 
diff --git a/Tests/test_file_imt.py b/Tests/test_file_imt.py
index 3db4885586a..aa13d4407bc 100644
--- a/Tests/test_file_imt.py
+++ b/Tests/test_file_imt.py
@@ -1,4 +1,5 @@
 from __future__ import annotations
+
 import io
 
 import pytest
diff --git a/Tests/test_file_iptc.py b/Tests/test_file_iptc.py
index c44a08f526a..a2c50ecefdf 100644
--- a/Tests/test_file_iptc.py
+++ b/Tests/test_file_iptc.py
@@ -1,4 +1,5 @@
 from __future__ import annotations
+
 import sys
 from io import BytesIO, StringIO
 
diff --git a/Tests/test_file_jpeg.py b/Tests/test_file_jpeg.py
index 979c7e33d00..232e51f9126 100644
--- a/Tests/test_file_jpeg.py
+++ b/Tests/test_file_jpeg.py
@@ -1,4 +1,5 @@
 from __future__ import annotations
+
 import os
 import re
 import warnings
diff --git a/Tests/test_file_jpeg2k.py b/Tests/test_file_jpeg2k.py
index aaa4104e57c..94b02c9ff52 100644
--- a/Tests/test_file_jpeg2k.py
+++ b/Tests/test_file_jpeg2k.py
@@ -1,4 +1,5 @@
 from __future__ import annotations
+
 import os
 import re
 from io import BytesIO
diff --git a/Tests/test_file_libtiff.py b/Tests/test_file_libtiff.py
index 65adf449dcc..494253c87c1 100644
--- a/Tests/test_file_libtiff.py
+++ b/Tests/test_file_libtiff.py
@@ -1,4 +1,5 @@
 from __future__ import annotations
+
 import base64
 import io
 import itertools
diff --git a/Tests/test_file_libtiff_small.py b/Tests/test_file_libtiff_small.py
index 9501c55a6b8..171e4a3f866 100644
--- a/Tests/test_file_libtiff_small.py
+++ b/Tests/test_file_libtiff_small.py
@@ -1,4 +1,5 @@
 from __future__ import annotations
+
 from io import BytesIO
 
 from PIL import Image
diff --git a/Tests/test_file_mcidas.py b/Tests/test_file_mcidas.py
index 4b31aaa7857..73eba5cc861 100644
--- a/Tests/test_file_mcidas.py
+++ b/Tests/test_file_mcidas.py
@@ -1,4 +1,5 @@
 from __future__ import annotations
+
 import pytest
 
 from PIL import Image, McIdasImagePlugin
diff --git a/Tests/test_file_mic.py b/Tests/test_file_mic.py
index e7ea39ea918..8c43f7d7ab7 100644
--- a/Tests/test_file_mic.py
+++ b/Tests/test_file_mic.py
@@ -1,4 +1,5 @@
 from __future__ import annotations
+
 import pytest
 
 from PIL import Image, ImagePalette
diff --git a/Tests/test_file_mpo.py b/Tests/test_file_mpo.py
index da62bc6d429..c7121ea28c9 100644
--- a/Tests/test_file_mpo.py
+++ b/Tests/test_file_mpo.py
@@ -1,4 +1,5 @@
 from __future__ import annotations
+
 import warnings
 from io import BytesIO
 
diff --git a/Tests/test_file_msp.py b/Tests/test_file_msp.py
index f4e357ae0fd..9037ea33b54 100644
--- a/Tests/test_file_msp.py
+++ b/Tests/test_file_msp.py
@@ -1,4 +1,5 @@
 from __future__ import annotations
+
 import os
 
 import pytest
diff --git a/Tests/test_file_palm.py b/Tests/test_file_palm.py
index 735840de4cb..eba69415395 100644
--- a/Tests/test_file_palm.py
+++ b/Tests/test_file_palm.py
@@ -1,4 +1,5 @@
 from __future__ import annotations
+
 import os.path
 import subprocess
 
diff --git a/Tests/test_file_pcd.py b/Tests/test_file_pcd.py
index 596a3414f79..1a37c6ab31d 100644
--- a/Tests/test_file_pcd.py
+++ b/Tests/test_file_pcd.py
@@ -1,4 +1,5 @@
 from __future__ import annotations
+
 from PIL import Image
 
 
diff --git a/Tests/test_file_pcx.py b/Tests/test_file_pcx.py
index f42ec4a6894..2565e0b6ddc 100644
--- a/Tests/test_file_pcx.py
+++ b/Tests/test_file_pcx.py
@@ -1,4 +1,5 @@
 from __future__ import annotations
+
 import pytest
 
 from PIL import Image, ImageFile, PcxImagePlugin
diff --git a/Tests/test_file_pdf.py b/Tests/test_file_pdf.py
index 9e07d9ed014..30c54c963cb 100644
--- a/Tests/test_file_pdf.py
+++ b/Tests/test_file_pdf.py
@@ -1,4 +1,5 @@
 from __future__ import annotations
+
 import io
 import os
 import os.path
diff --git a/Tests/test_file_pixar.py b/Tests/test_file_pixar.py
index 63779f202cb..c6ddc54e714 100644
--- a/Tests/test_file_pixar.py
+++ b/Tests/test_file_pixar.py
@@ -1,4 +1,5 @@
 from __future__ import annotations
+
 import pytest
 
 from PIL import Image, PixarImagePlugin
diff --git a/Tests/test_file_png.py b/Tests/test_file_png.py
index ff386211061..ae2a4772b60 100644
--- a/Tests/test_file_png.py
+++ b/Tests/test_file_png.py
@@ -1,4 +1,5 @@
 from __future__ import annotations
+
 import re
 import sys
 import warnings
diff --git a/Tests/test_file_ppm.py b/Tests/test_file_ppm.py
index d8e259b1cf8..32de42ed45d 100644
--- a/Tests/test_file_ppm.py
+++ b/Tests/test_file_ppm.py
@@ -1,4 +1,5 @@
 from __future__ import annotations
+
 import sys
 from io import BytesIO
 
diff --git a/Tests/test_file_psd.py b/Tests/test_file_psd.py
index 8b06ce2b163..16f049602bc 100644
--- a/Tests/test_file_psd.py
+++ b/Tests/test_file_psd.py
@@ -1,4 +1,5 @@
 from __future__ import annotations
+
 import warnings
 
 import pytest
diff --git a/Tests/test_file_qoi.py b/Tests/test_file_qoi.py
index b7c9457294d..6dc468754ef 100644
--- a/Tests/test_file_qoi.py
+++ b/Tests/test_file_qoi.py
@@ -1,4 +1,5 @@
 from __future__ import annotations
+
 import pytest
 
 from PIL import Image, QoiImagePlugin
diff --git a/Tests/test_file_sgi.py b/Tests/test_file_sgi.py
index 13698276b8c..bc45bbfd34d 100644
--- a/Tests/test_file_sgi.py
+++ b/Tests/test_file_sgi.py
@@ -1,4 +1,5 @@
 from __future__ import annotations
+
 import pytest
 
 from PIL import Image, SgiImagePlugin
diff --git a/Tests/test_file_spider.py b/Tests/test_file_spider.py
index f2109875478..42d833fb25c 100644
--- a/Tests/test_file_spider.py
+++ b/Tests/test_file_spider.py
@@ -1,4 +1,5 @@
 from __future__ import annotations
+
 import tempfile
 import warnings
 from io import BytesIO
diff --git a/Tests/test_file_sun.py b/Tests/test_file_sun.py
index 874b37b5285..41f3b7d98f3 100644
--- a/Tests/test_file_sun.py
+++ b/Tests/test_file_sun.py
@@ -1,4 +1,5 @@
 from __future__ import annotations
+
 import os
 
 import pytest
diff --git a/Tests/test_file_tar.py b/Tests/test_file_tar.py
index 4470823cdbd..58226c33062 100644
--- a/Tests/test_file_tar.py
+++ b/Tests/test_file_tar.py
@@ -1,4 +1,5 @@
 from __future__ import annotations
+
 import warnings
 
 import pytest
diff --git a/Tests/test_file_tga.py b/Tests/test_file_tga.py
index d0f228573bb..eafb61d30af 100644
--- a/Tests/test_file_tga.py
+++ b/Tests/test_file_tga.py
@@ -1,4 +1,5 @@
 from __future__ import annotations
+
 import os
 from glob import glob
 from itertools import product
diff --git a/Tests/test_file_tiff.py b/Tests/test_file_tiff.py
index a50f50e5e96..f0995679b1f 100644
--- a/Tests/test_file_tiff.py
+++ b/Tests/test_file_tiff.py
@@ -1,4 +1,5 @@
 from __future__ import annotations
+
 import os
 import warnings
 from io import BytesIO
diff --git a/Tests/test_file_tiff_metadata.py b/Tests/test_file_tiff_metadata.py
index ee69681854e..06689bc9092 100644
--- a/Tests/test_file_tiff_metadata.py
+++ b/Tests/test_file_tiff_metadata.py
@@ -1,4 +1,5 @@
 from __future__ import annotations
+
 import io
 import struct
 
diff --git a/Tests/test_file_wal.py b/Tests/test_file_wal.py
index 0b84d0320aa..7acec975942 100644
--- a/Tests/test_file_wal.py
+++ b/Tests/test_file_wal.py
@@ -1,4 +1,5 @@
 from __future__ import annotations
+
 from PIL import WalImageFile
 
 from .helper import assert_image_equal_tofile
diff --git a/Tests/test_file_webp.py b/Tests/test_file_webp.py
index c91818ef64e..c49418ce3c5 100644
--- a/Tests/test_file_webp.py
+++ b/Tests/test_file_webp.py
@@ -1,4 +1,5 @@
 from __future__ import annotations
+
 import io
 import re
 import sys
diff --git a/Tests/test_file_webp_alpha.py b/Tests/test_file_webp_alpha.py
index 79d01a4446a..cfda35a0962 100644
--- a/Tests/test_file_webp_alpha.py
+++ b/Tests/test_file_webp_alpha.py
@@ -1,4 +1,5 @@
 from __future__ import annotations
+
 import pytest
 
 from PIL import Image
diff --git a/Tests/test_file_webp_animated.py b/Tests/test_file_webp_animated.py
index 22acb4be68f..426fe7a0293 100644
--- a/Tests/test_file_webp_animated.py
+++ b/Tests/test_file_webp_animated.py
@@ -1,4 +1,5 @@
 from __future__ import annotations
+
 import pytest
 from packaging.version import parse as parse_version
 
diff --git a/Tests/test_file_webp_lossless.py b/Tests/test_file_webp_lossless.py
index 6acf58ac3f5..08c80973a74 100644
--- a/Tests/test_file_webp_lossless.py
+++ b/Tests/test_file_webp_lossless.py
@@ -1,4 +1,5 @@
 from __future__ import annotations
+
 import pytest
 
 from PIL import Image
diff --git a/Tests/test_file_webp_metadata.py b/Tests/test_file_webp_metadata.py
index a7b7bbcf6ee..deaf5e380db 100644
--- a/Tests/test_file_webp_metadata.py
+++ b/Tests/test_file_webp_metadata.py
@@ -1,4 +1,5 @@
 from __future__ import annotations
+
 from io import BytesIO
 
 import pytest
diff --git a/Tests/test_file_wmf.py b/Tests/test_file_wmf.py
index 596dc8ba181..6e1d4c1361f 100644
--- a/Tests/test_file_wmf.py
+++ b/Tests/test_file_wmf.py
@@ -1,4 +1,5 @@
 from __future__ import annotations
+
 import pytest
 
 from PIL import Image, WmfImagePlugin
diff --git a/Tests/test_file_xbm.py b/Tests/test_file_xbm.py
index b086ffd683f..69a0a1b38d8 100644
--- a/Tests/test_file_xbm.py
+++ b/Tests/test_file_xbm.py
@@ -1,4 +1,5 @@
 from __future__ import annotations
+
 from io import BytesIO
 
 import pytest
diff --git a/Tests/test_file_xpm.py b/Tests/test_file_xpm.py
index 265feab4294..529a4558073 100644
--- a/Tests/test_file_xpm.py
+++ b/Tests/test_file_xpm.py
@@ -1,4 +1,5 @@
 from __future__ import annotations
+
 import pytest
 
 from PIL import Image, XpmImagePlugin
diff --git a/Tests/test_file_xvthumb.py b/Tests/test_file_xvthumb.py
index 5848995c1aa..b87494eba18 100644
--- a/Tests/test_file_xvthumb.py
+++ b/Tests/test_file_xvthumb.py
@@ -1,4 +1,5 @@
 from __future__ import annotations
+
 import pytest
 
 from PIL import Image, XVThumbImagePlugin
diff --git a/Tests/test_font_bdf.py b/Tests/test_font_bdf.py
index 1e5eff2f15d..e5e85618651 100644
--- a/Tests/test_font_bdf.py
+++ b/Tests/test_font_bdf.py
@@ -1,4 +1,5 @@
 from __future__ import annotations
+
 import pytest
 
 from PIL import BdfFontFile, FontFile
diff --git a/Tests/test_font_crash.py b/Tests/test_font_crash.py
index 388ee711861..e3c72c1aebd 100644
--- a/Tests/test_font_crash.py
+++ b/Tests/test_font_crash.py
@@ -1,4 +1,5 @@
 from __future__ import annotations
+
 import pytest
 
 from PIL import Image, ImageDraw, ImageFont
diff --git a/Tests/test_font_leaks.py b/Tests/test_font_leaks.py
index 6a038bb4038..4e29a856bc9 100644
--- a/Tests/test_font_leaks.py
+++ b/Tests/test_font_leaks.py
@@ -1,4 +1,5 @@
 from __future__ import annotations
+
 from PIL import Image, ImageDraw, ImageFont
 
 from .helper import PillowLeakTestCase, skip_unless_feature
diff --git a/Tests/test_font_pcf.py b/Tests/test_font_pcf.py
index 4365b931066..e6abede0787 100644
--- a/Tests/test_font_pcf.py
+++ b/Tests/test_font_pcf.py
@@ -1,4 +1,5 @@
 from __future__ import annotations
+
 import os
 
 import pytest
diff --git a/Tests/test_font_pcf_charsets.py b/Tests/test_font_pcf_charsets.py
index 950e5029ff5..4c2d7185e3c 100644
--- a/Tests/test_font_pcf_charsets.py
+++ b/Tests/test_font_pcf_charsets.py
@@ -1,4 +1,5 @@
 from __future__ import annotations
+
 import os
 
 import pytest
diff --git a/Tests/test_fontfile.py b/Tests/test_fontfile.py
index ce1e02f63e0..eda8fb81283 100644
--- a/Tests/test_fontfile.py
+++ b/Tests/test_fontfile.py
@@ -1,4 +1,5 @@
 from __future__ import annotations
+
 import pytest
 
 from PIL import FontFile
diff --git a/Tests/test_format_hsv.py b/Tests/test_format_hsv.py
index fd47fae39ba..6395ae4aad8 100644
--- a/Tests/test_format_hsv.py
+++ b/Tests/test_format_hsv.py
@@ -1,4 +1,5 @@
 from __future__ import annotations
+
 import colorsys
 import itertools
 
diff --git a/Tests/test_format_lab.py b/Tests/test_format_lab.py
index c7610ce8a6c..a55620e09ab 100644
--- a/Tests/test_format_lab.py
+++ b/Tests/test_format_lab.py
@@ -1,4 +1,5 @@
 from __future__ import annotations
+
 from PIL import Image
 
 
diff --git a/Tests/test_image.py b/Tests/test_image.py
index 80f6583d8d9..dd989ad99b5 100644
--- a/Tests/test_image.py
+++ b/Tests/test_image.py
@@ -1,4 +1,5 @@
 from __future__ import annotations
+
 import io
 import logging
 import os
diff --git a/Tests/test_image_access.py b/Tests/test_image_access.py
index 4a794371d67..4ae56fae0cc 100644
--- a/Tests/test_image_access.py
+++ b/Tests/test_image_access.py
@@ -1,4 +1,5 @@
 from __future__ import annotations
+
 import os
 import subprocess
 import sys
diff --git a/Tests/test_image_array.py b/Tests/test_image_array.py
index b3e5d9e3e08..0dacb3157a2 100644
--- a/Tests/test_image_array.py
+++ b/Tests/test_image_array.py
@@ -1,4 +1,5 @@
 from __future__ import annotations
+
 import pytest
 from packaging.version import parse as parse_version
 
diff --git a/Tests/test_image_convert.py b/Tests/test_image_convert.py
index 7c17040d30b..d4ddc2a31b2 100644
--- a/Tests/test_image_convert.py
+++ b/Tests/test_image_convert.py
@@ -1,4 +1,5 @@
 from __future__ import annotations
+
 import pytest
 
 from PIL import Image
diff --git a/Tests/test_image_copy.py b/Tests/test_image_copy.py
index abf5f846f89..3a26ef96e74 100644
--- a/Tests/test_image_copy.py
+++ b/Tests/test_image_copy.py
@@ -1,4 +1,5 @@
 from __future__ import annotations
+
 import copy
 
 import pytest
diff --git a/Tests/test_image_crop.py b/Tests/test_image_crop.py
index 0bb54e5d811..5e02a3b0dfc 100644
--- a/Tests/test_image_crop.py
+++ b/Tests/test_image_crop.py
@@ -1,4 +1,5 @@
 from __future__ import annotations
+
 import pytest
 
 from PIL import Image
diff --git a/Tests/test_image_draft.py b/Tests/test_image_draft.py
index 774272dd1f7..08c40af1f16 100644
--- a/Tests/test_image_draft.py
+++ b/Tests/test_image_draft.py
@@ -1,4 +1,5 @@
 from __future__ import annotations
+
 from PIL import Image
 
 from .helper import fromstring, skip_unless_feature, tostring
diff --git a/Tests/test_image_entropy.py b/Tests/test_image_entropy.py
index 031fceda3fa..fce16122409 100644
--- a/Tests/test_image_entropy.py
+++ b/Tests/test_image_entropy.py
@@ -1,4 +1,5 @@
 from __future__ import annotations
+
 from .helper import hopper
 
 
diff --git a/Tests/test_image_filter.py b/Tests/test_image_filter.py
index 5bd7ee0d273..3fa5dd2423a 100644
--- a/Tests/test_image_filter.py
+++ b/Tests/test_image_filter.py
@@ -1,4 +1,5 @@
 from __future__ import annotations
+
 import pytest
 
 from PIL import Image, ImageFilter
diff --git a/Tests/test_image_frombytes.py b/Tests/test_image_frombytes.py
index 017da499d2c..5d5e9f2dfc9 100644
--- a/Tests/test_image_frombytes.py
+++ b/Tests/test_image_frombytes.py
@@ -1,4 +1,5 @@
 from __future__ import annotations
+
 import pytest
 
 from PIL import Image
diff --git a/Tests/test_image_fromqimage.py b/Tests/test_image_fromqimage.py
index b3ca43bde6d..76b576da56b 100644
--- a/Tests/test_image_fromqimage.py
+++ b/Tests/test_image_fromqimage.py
@@ -1,4 +1,5 @@
 from __future__ import annotations
+
 import warnings
 
 import pytest
diff --git a/Tests/test_image_getbands.py b/Tests/test_image_getbands.py
index e7701dbc460..64339e2cd85 100644
--- a/Tests/test_image_getbands.py
+++ b/Tests/test_image_getbands.py
@@ -1,4 +1,5 @@
 from __future__ import annotations
+
 from PIL import Image
 
 
diff --git a/Tests/test_image_getbbox.py b/Tests/test_image_getbbox.py
index 9e792cfdf7c..b18a7202e38 100644
--- a/Tests/test_image_getbbox.py
+++ b/Tests/test_image_getbbox.py
@@ -1,4 +1,5 @@
 from __future__ import annotations
+
 import pytest
 
 from PIL import Image
diff --git a/Tests/test_image_getcolors.py b/Tests/test_image_getcolors.py
index dea3a60a112..17460fa93f5 100644
--- a/Tests/test_image_getcolors.py
+++ b/Tests/test_image_getcolors.py
@@ -1,4 +1,5 @@
 from __future__ import annotations
+
 from .helper import hopper
 
 
diff --git a/Tests/test_image_getdata.py b/Tests/test_image_getdata.py
index 873cc65bf91..ace64279b8c 100644
--- a/Tests/test_image_getdata.py
+++ b/Tests/test_image_getdata.py
@@ -1,4 +1,5 @@
 from __future__ import annotations
+
 from PIL import Image
 
 from .helper import hopper
diff --git a/Tests/test_image_getextrema.py b/Tests/test_image_getextrema.py
index b17c8a786dd..6bbc4da9a01 100644
--- a/Tests/test_image_getextrema.py
+++ b/Tests/test_image_getextrema.py
@@ -1,4 +1,5 @@
 from __future__ import annotations
+
 from PIL import Image
 
 from .helper import hopper
diff --git a/Tests/test_image_getim.py b/Tests/test_image_getim.py
index e969c8164a2..bc8a7485eb0 100644
--- a/Tests/test_image_getim.py
+++ b/Tests/test_image_getim.py
@@ -1,4 +1,5 @@
 from __future__ import annotations
+
 from .helper import hopper
 
 
diff --git a/Tests/test_image_getpalette.py b/Tests/test_image_getpalette.py
index a5be972d3ed..4340f46f619 100644
--- a/Tests/test_image_getpalette.py
+++ b/Tests/test_image_getpalette.py
@@ -1,4 +1,5 @@
 from __future__ import annotations
+
 from PIL import Image
 
 from .helper import hopper
diff --git a/Tests/test_image_getprojection.py b/Tests/test_image_getprojection.py
index aa47be3b2e0..e90f5f5056f 100644
--- a/Tests/test_image_getprojection.py
+++ b/Tests/test_image_getprojection.py
@@ -1,4 +1,5 @@
 from __future__ import annotations
+
 from PIL import Image
 
 from .helper import hopper
diff --git a/Tests/test_image_histogram.py b/Tests/test_image_histogram.py
index 7ba2f10b765..3ac6649e074 100644
--- a/Tests/test_image_histogram.py
+++ b/Tests/test_image_histogram.py
@@ -1,4 +1,5 @@
 from __future__ import annotations
+
 from .helper import hopper
 
 
diff --git a/Tests/test_image_load.py b/Tests/test_image_load.py
index 17847c4fd9c..36f8ba575d8 100644
--- a/Tests/test_image_load.py
+++ b/Tests/test_image_load.py
@@ -1,4 +1,5 @@
 from __future__ import annotations
+
 import logging
 import os
 
diff --git a/Tests/test_image_mode.py b/Tests/test_image_mode.py
index ad90d1250dc..3c1d494fab2 100644
--- a/Tests/test_image_mode.py
+++ b/Tests/test_image_mode.py
@@ -1,4 +1,5 @@
 from __future__ import annotations
+
 import pytest
 
 from PIL import Image, ImageMode
diff --git a/Tests/test_image_paste.py b/Tests/test_image_paste.py
index 0b87f607286..fd117f9dbc9 100644
--- a/Tests/test_image_paste.py
+++ b/Tests/test_image_paste.py
@@ -1,4 +1,5 @@
 from __future__ import annotations
+
 import pytest
 
 from PIL import Image
diff --git a/Tests/test_image_point.py b/Tests/test_image_point.py
index fce45ec4f0e..2232b94429d 100644
--- a/Tests/test_image_point.py
+++ b/Tests/test_image_point.py
@@ -1,4 +1,5 @@
 from __future__ import annotations
+
 import pytest
 
 from .helper import assert_image_equal, hopper
diff --git a/Tests/test_image_putalpha.py b/Tests/test_image_putalpha.py
index 0ba7e5919a5..c44b048d523 100644
--- a/Tests/test_image_putalpha.py
+++ b/Tests/test_image_putalpha.py
@@ -1,4 +1,5 @@
 from __future__ import annotations
+
 from PIL import Image
 
 
diff --git a/Tests/test_image_putdata.py b/Tests/test_image_putdata.py
index d3cb13e2e97..2648af8fa2e 100644
--- a/Tests/test_image_putdata.py
+++ b/Tests/test_image_putdata.py
@@ -1,4 +1,5 @@
 from __future__ import annotations
+
 import sys
 from array import array
 
diff --git a/Tests/test_image_putpalette.py b/Tests/test_image_putpalette.py
index de2d9024213..43b65be2b17 100644
--- a/Tests/test_image_putpalette.py
+++ b/Tests/test_image_putpalette.py
@@ -1,4 +1,5 @@
 from __future__ import annotations
+
 import pytest
 
 from PIL import Image, ImagePalette
diff --git a/Tests/test_image_quantize.py b/Tests/test_image_quantize.py
index 54c567aae6c..1475b027bd8 100644
--- a/Tests/test_image_quantize.py
+++ b/Tests/test_image_quantize.py
@@ -1,4 +1,5 @@
 from __future__ import annotations
+
 import pytest
 from packaging.version import parse as parse_version
 
diff --git a/Tests/test_image_reduce.py b/Tests/test_image_reduce.py
index a4d0f510761..ba9100415a2 100644
--- a/Tests/test_image_reduce.py
+++ b/Tests/test_image_reduce.py
@@ -1,4 +1,5 @@
 from __future__ import annotations
+
 import pytest
 
 from PIL import Image, ImageMath, ImageMode
diff --git a/Tests/test_image_resample.py b/Tests/test_image_resample.py
index 5a578dba5c4..af730dce13d 100644
--- a/Tests/test_image_resample.py
+++ b/Tests/test_image_resample.py
@@ -1,4 +1,5 @@
 from __future__ import annotations
+
 from contextlib import contextmanager
 
 import pytest
diff --git a/Tests/test_image_resize.py b/Tests/test_image_resize.py
index 0d3b43ee29f..aedcf4a09b5 100644
--- a/Tests/test_image_resize.py
+++ b/Tests/test_image_resize.py
@@ -2,6 +2,7 @@
 Tests for resize functionality.
 """
 from __future__ import annotations
+
 from itertools import permutations
 
 import pytest
diff --git a/Tests/test_image_rotate.py b/Tests/test_image_rotate.py
index 0931aa32d98..e63fef2c152 100644
--- a/Tests/test_image_rotate.py
+++ b/Tests/test_image_rotate.py
@@ -1,4 +1,5 @@
 from __future__ import annotations
+
 import pytest
 
 from PIL import Image
diff --git a/Tests/test_image_split.py b/Tests/test_image_split.py
index 707508250f6..c39a100e777 100644
--- a/Tests/test_image_split.py
+++ b/Tests/test_image_split.py
@@ -1,4 +1,5 @@
 from __future__ import annotations
+
 import pytest
 
 from PIL import Image, features
diff --git a/Tests/test_image_thumbnail.py b/Tests/test_image_thumbnail.py
index 9e6796ca299..7fa5692aa7d 100644
--- a/Tests/test_image_thumbnail.py
+++ b/Tests/test_image_thumbnail.py
@@ -1,4 +1,5 @@
 from __future__ import annotations
+
 import pytest
 
 from PIL import Image
diff --git a/Tests/test_image_tobitmap.py b/Tests/test_image_tobitmap.py
index 156b9919d27..89a41cf8ec2 100644
--- a/Tests/test_image_tobitmap.py
+++ b/Tests/test_image_tobitmap.py
@@ -1,4 +1,5 @@
 from __future__ import annotations
+
 import pytest
 
 from .helper import assert_image_equal, fromstring, hopper
diff --git a/Tests/test_image_tobytes.py b/Tests/test_image_tobytes.py
index f6042bca527..8f15adac065 100644
--- a/Tests/test_image_tobytes.py
+++ b/Tests/test_image_tobytes.py
@@ -1,4 +1,5 @@
 from __future__ import annotations
+
 from .helper import hopper
 
 
diff --git a/Tests/test_image_transform.py b/Tests/test_image_transform.py
index f5d5ab70408..0fe9fd1d5f5 100644
--- a/Tests/test_image_transform.py
+++ b/Tests/test_image_transform.py
@@ -1,4 +1,5 @@
 from __future__ import annotations
+
 import math
 
 import pytest
diff --git a/Tests/test_image_transpose.py b/Tests/test_image_transpose.py
index 66a2d9e2955..01bf5a83918 100644
--- a/Tests/test_image_transpose.py
+++ b/Tests/test_image_transpose.py
@@ -1,4 +1,5 @@
 from __future__ import annotations
+
 import pytest
 
 from PIL.Image import Transpose
diff --git a/Tests/test_imagechops.py b/Tests/test_imagechops.py
index 8e3a738d708..2f0614385aa 100644
--- a/Tests/test_imagechops.py
+++ b/Tests/test_imagechops.py
@@ -1,4 +1,5 @@
 from __future__ import annotations
+
 from PIL import Image, ImageChops
 
 from .helper import assert_image_equal, hopper
diff --git a/Tests/test_imagecms.py b/Tests/test_imagecms.py
index 810394e6f5f..03332699a1d 100644
--- a/Tests/test_imagecms.py
+++ b/Tests/test_imagecms.py
@@ -1,4 +1,5 @@
 from __future__ import annotations
+
 import datetime
 import os
 import re
diff --git a/Tests/test_imagecolor.py b/Tests/test_imagecolor.py
index c0ffd2ebf0b..b602172b642 100644
--- a/Tests/test_imagecolor.py
+++ b/Tests/test_imagecolor.py
@@ -1,4 +1,5 @@
 from __future__ import annotations
+
 import pytest
 
 from PIL import Image, ImageColor
diff --git a/Tests/test_imagedraw.py b/Tests/test_imagedraw.py
index 379fe78cd8a..69aab48912b 100644
--- a/Tests/test_imagedraw.py
+++ b/Tests/test_imagedraw.py
@@ -1,4 +1,5 @@
 from __future__ import annotations
+
 import contextlib
 import os.path
 
diff --git a/Tests/test_imagedraw2.py b/Tests/test_imagedraw2.py
index d729af14d3a..004c2d768fd 100644
--- a/Tests/test_imagedraw2.py
+++ b/Tests/test_imagedraw2.py
@@ -1,4 +1,5 @@
 from __future__ import annotations
+
 import os.path
 
 import pytest
diff --git a/Tests/test_imageenhance.py b/Tests/test_imageenhance.py
index f4e4d59be32..e3d8a7ab251 100644
--- a/Tests/test_imageenhance.py
+++ b/Tests/test_imageenhance.py
@@ -1,4 +1,5 @@
 from __future__ import annotations
+
 import pytest
 
 from PIL import Image, ImageEnhance
diff --git a/Tests/test_imagefile.py b/Tests/test_imagefile.py
index 4804a554f83..99731f35208 100644
--- a/Tests/test_imagefile.py
+++ b/Tests/test_imagefile.py
@@ -1,4 +1,5 @@
 from __future__ import annotations
+
 from io import BytesIO
 
 import pytest
diff --git a/Tests/test_imagefont.py b/Tests/test_imagefont.py
index 807d581edf0..d2c87d42aaa 100644
--- a/Tests/test_imagefont.py
+++ b/Tests/test_imagefont.py
@@ -1,4 +1,5 @@
 from __future__ import annotations
+
 import copy
 import os
 import re
diff --git a/Tests/test_imagefontctl.py b/Tests/test_imagefontctl.py
index bea532b051e..09e68ea488a 100644
--- a/Tests/test_imagefontctl.py
+++ b/Tests/test_imagefontctl.py
@@ -1,4 +1,5 @@
 from __future__ import annotations
+
 import pytest
 
 from PIL import Image, ImageDraw, ImageFont
diff --git a/Tests/test_imagefontpil.py b/Tests/test_imagefontpil.py
index 9e085510149..be4be1c546e 100644
--- a/Tests/test_imagefontpil.py
+++ b/Tests/test_imagefontpil.py
@@ -1,9 +1,11 @@
 from __future__ import annotations
+
 import struct
-import pytest
 from io import BytesIO
 
-from PIL import Image, ImageDraw, ImageFont, features, _util
+import pytest
+
+from PIL import Image, ImageDraw, ImageFont, _util, features
 
 from .helper import assert_image_equal_tofile
 
diff --git a/Tests/test_imagegrab.py b/Tests/test_imagegrab.py
index b7683ec1817..9d3d40398f6 100644
--- a/Tests/test_imagegrab.py
+++ b/Tests/test_imagegrab.py
@@ -1,4 +1,5 @@
 from __future__ import annotations
+
 import os
 import shutil
 import subprocess
diff --git a/Tests/test_imagemath.py b/Tests/test_imagemath.py
index 9281de6f66a..622ad27eacb 100644
--- a/Tests/test_imagemath.py
+++ b/Tests/test_imagemath.py
@@ -1,4 +1,5 @@
 from __future__ import annotations
+
 import pytest
 
 from PIL import Image, ImageMath
diff --git a/Tests/test_imagemorph.py b/Tests/test_imagemorph.py
index 64a1785ea97..0708ee63905 100644
--- a/Tests/test_imagemorph.py
+++ b/Tests/test_imagemorph.py
@@ -1,5 +1,6 @@
 # Test the ImageMorphology functionality
 from __future__ import annotations
+
 import pytest
 
 from PIL import Image, ImageMorph, _imagingmorph
diff --git a/Tests/test_imageops.py b/Tests/test_imageops.py
index 7980bead0a4..636b99dbe8f 100644
--- a/Tests/test_imageops.py
+++ b/Tests/test_imageops.py
@@ -1,4 +1,5 @@
 from __future__ import annotations
+
 import pytest
 
 from PIL import Image, ImageDraw, ImageOps, ImageStat, features
diff --git a/Tests/test_imageops_usm.py b/Tests/test_imageops_usm.py
index 84d3a69507a..8ffb9bff7a2 100644
--- a/Tests/test_imageops_usm.py
+++ b/Tests/test_imageops_usm.py
@@ -1,4 +1,5 @@
 from __future__ import annotations
+
 import pytest
 
 from PIL import Image, ImageFilter
diff --git a/Tests/test_imagepalette.py b/Tests/test_imagepalette.py
index e5b59b74a84..be21464b4ae 100644
--- a/Tests/test_imagepalette.py
+++ b/Tests/test_imagepalette.py
@@ -1,4 +1,5 @@
 from __future__ import annotations
+
 import pytest
 
 from PIL import Image, ImagePalette
diff --git a/Tests/test_imagepath.py b/Tests/test_imagepath.py
index ac3ea3281f5..5c6393e237f 100644
--- a/Tests/test_imagepath.py
+++ b/Tests/test_imagepath.py
@@ -1,4 +1,5 @@
 from __future__ import annotations
+
 import array
 import math
 import struct
diff --git a/Tests/test_imageqt.py b/Tests/test_imageqt.py
index 41d247f429f..d55d980d9be 100644
--- a/Tests/test_imageqt.py
+++ b/Tests/test_imageqt.py
@@ -1,4 +1,5 @@
 from __future__ import annotations
+
 import warnings
 
 import pytest
diff --git a/Tests/test_imagesequence.py b/Tests/test_imagesequence.py
index 6d71e4d87af..66d553bcbc7 100644
--- a/Tests/test_imagesequence.py
+++ b/Tests/test_imagesequence.py
@@ -1,4 +1,5 @@
 from __future__ import annotations
+
 import pytest
 
 from PIL import Image, ImageSequence, TiffImagePlugin
diff --git a/Tests/test_imageshow.py b/Tests/test_imageshow.py
index 761d28d3019..0996ad41d4d 100644
--- a/Tests/test_imageshow.py
+++ b/Tests/test_imageshow.py
@@ -1,4 +1,5 @@
 from __future__ import annotations
+
 import pytest
 
 from PIL import Image, ImageShow
diff --git a/Tests/test_imagestat.py b/Tests/test_imagestat.py
index 7b56b89cc4b..01687db353e 100644
--- a/Tests/test_imagestat.py
+++ b/Tests/test_imagestat.py
@@ -1,4 +1,5 @@
 from __future__ import annotations
+
 import pytest
 
 from PIL import Image, ImageStat
diff --git a/Tests/test_imagetk.py b/Tests/test_imagetk.py
index bb20fbb6f92..c06fc58235b 100644
--- a/Tests/test_imagetk.py
+++ b/Tests/test_imagetk.py
@@ -1,4 +1,5 @@
 from __future__ import annotations
+
 import pytest
 
 from PIL import Image
diff --git a/Tests/test_imagewin.py b/Tests/test_imagewin.py
index 6927eedcf86..f93eabcb4ff 100644
--- a/Tests/test_imagewin.py
+++ b/Tests/test_imagewin.py
@@ -1,4 +1,5 @@
 from __future__ import annotations
+
 import pytest
 
 from PIL import ImageWin
diff --git a/Tests/test_imagewin_pointers.py b/Tests/test_imagewin_pointers.py
index bd154335af7..63d6b903ca6 100644
--- a/Tests/test_imagewin_pointers.py
+++ b/Tests/test_imagewin_pointers.py
@@ -1,4 +1,5 @@
 from __future__ import annotations
+
 from io import BytesIO
 
 from PIL import Image, ImageWin
diff --git a/Tests/test_lib_image.py b/Tests/test_lib_image.py
index 92cad4ac1b1..1c642e4c981 100644
--- a/Tests/test_lib_image.py
+++ b/Tests/test_lib_image.py
@@ -1,4 +1,5 @@
 from __future__ import annotations
+
 import pytest
 
 from PIL import Image
diff --git a/Tests/test_lib_pack.py b/Tests/test_lib_pack.py
index 1293f7628be..e2024abbf2e 100644
--- a/Tests/test_lib_pack.py
+++ b/Tests/test_lib_pack.py
@@ -1,4 +1,5 @@
 from __future__ import annotations
+
 import sys
 
 import pytest
diff --git a/Tests/test_locale.py b/Tests/test_locale.py
index 49b052fa485..db9557d7ba2 100644
--- a/Tests/test_locale.py
+++ b/Tests/test_locale.py
@@ -1,4 +1,5 @@
 from __future__ import annotations
+
 import locale
 
 import pytest
diff --git a/Tests/test_main.py b/Tests/test_main.py
index a84e61a7b7d..9f61a0c8169 100644
--- a/Tests/test_main.py
+++ b/Tests/test_main.py
@@ -1,4 +1,5 @@
 from __future__ import annotations
+
 import os
 import subprocess
 import sys
diff --git a/Tests/test_map.py b/Tests/test_map.py
index 76444f33d1c..9c79fe35906 100644
--- a/Tests/test_map.py
+++ b/Tests/test_map.py
@@ -1,4 +1,5 @@
 from __future__ import annotations
+
 import sys
 
 import pytest
diff --git a/Tests/test_mode_i16.py b/Tests/test_mode_i16.py
index 3e17d8dccde..d3ee511b7c2 100644
--- a/Tests/test_mode_i16.py
+++ b/Tests/test_mode_i16.py
@@ -1,4 +1,5 @@
 from __future__ import annotations
+
 import pytest
 
 from PIL import Image
diff --git a/Tests/test_numpy.py b/Tests/test_numpy.py
index 6f0e99b3f93..24dff36a610 100644
--- a/Tests/test_numpy.py
+++ b/Tests/test_numpy.py
@@ -1,4 +1,5 @@
 from __future__ import annotations
+
 import warnings
 
 import pytest
diff --git a/Tests/test_pdfparser.py b/Tests/test_pdfparser.py
index aeeafb6f1df..a89d75b59d3 100644
--- a/Tests/test_pdfparser.py
+++ b/Tests/test_pdfparser.py
@@ -1,4 +1,5 @@
 from __future__ import annotations
+
 import time
 
 import pytest
diff --git a/Tests/test_pickle.py b/Tests/test_pickle.py
index eb687b57b62..c445e349447 100644
--- a/Tests/test_pickle.py
+++ b/Tests/test_pickle.py
@@ -1,4 +1,5 @@
 from __future__ import annotations
+
 import pickle
 
 import pytest
diff --git a/Tests/test_psdraw.py b/Tests/test_psdraw.py
index 77c7952e912..7f618d0f53b 100644
--- a/Tests/test_psdraw.py
+++ b/Tests/test_psdraw.py
@@ -1,4 +1,5 @@
 from __future__ import annotations
+
 import os
 import sys
 from io import BytesIO
diff --git a/Tests/test_pyroma.py b/Tests/test_pyroma.py
index 08133b6c30c..c2cea08ca61 100644
--- a/Tests/test_pyroma.py
+++ b/Tests/test_pyroma.py
@@ -1,4 +1,5 @@
 from __future__ import annotations
+
 import pytest
 
 from PIL import __version__
diff --git a/Tests/test_qt_image_qapplication.py b/Tests/test_qt_image_qapplication.py
index 49ca016771f..ad2b5ad9bf5 100644
--- a/Tests/test_qt_image_qapplication.py
+++ b/Tests/test_qt_image_qapplication.py
@@ -1,4 +1,5 @@
 from __future__ import annotations
+
 import pytest
 
 from PIL import ImageQt
diff --git a/Tests/test_qt_image_toqimage.py b/Tests/test_qt_image_toqimage.py
index 396bd9080ca..b26787ce668 100644
--- a/Tests/test_qt_image_toqimage.py
+++ b/Tests/test_qt_image_toqimage.py
@@ -1,4 +1,5 @@
 from __future__ import annotations
+
 import pytest
 
 from PIL import ImageQt
diff --git a/Tests/test_sgi_crash.py b/Tests/test_sgi_crash.py
index 37d72d451de..dee6258ecb5 100644
--- a/Tests/test_sgi_crash.py
+++ b/Tests/test_sgi_crash.py
@@ -1,4 +1,5 @@
 from __future__ import annotations
+
 import pytest
 
 from PIL import Image
diff --git a/Tests/test_shell_injection.py b/Tests/test_shell_injection.py
index d93b0390416..9f3e86a32a8 100644
--- a/Tests/test_shell_injection.py
+++ b/Tests/test_shell_injection.py
@@ -1,4 +1,5 @@
 from __future__ import annotations
+
 import shutil
 
 import pytest
diff --git a/Tests/test_tiff_ifdrational.py b/Tests/test_tiff_ifdrational.py
index e7b41fb4738..c07e7f7d395 100644
--- a/Tests/test_tiff_ifdrational.py
+++ b/Tests/test_tiff_ifdrational.py
@@ -1,4 +1,5 @@
 from __future__ import annotations
+
 from fractions import Fraction
 
 from PIL import Image, TiffImagePlugin, features
diff --git a/Tests/test_uploader.py b/Tests/test_uploader.py
index 6b693f7cd5d..75326288f97 100644
--- a/Tests/test_uploader.py
+++ b/Tests/test_uploader.py
@@ -1,4 +1,5 @@
 from __future__ import annotations
+
 from .helper import assert_image_equal, assert_image_similar, hopper
 
 
diff --git a/Tests/test_util.py b/Tests/test_util.py
index 4a312beb440..3395ef753d7 100644
--- a/Tests/test_util.py
+++ b/Tests/test_util.py
@@ -1,4 +1,5 @@
 from __future__ import annotations
+
 import pytest
 
 from PIL import _util
diff --git a/Tests/test_webp_leaks.py b/Tests/test_webp_leaks.py
index 28ebc7d79f1..0f51abc9574 100644
--- a/Tests/test_webp_leaks.py
+++ b/Tests/test_webp_leaks.py
@@ -1,4 +1,5 @@
 from __future__ import annotations
+
 from io import BytesIO
 
 from PIL import Image

From 420150f0e251c9519a5aea1c24546a44d489828c Mon Sep 17 00:00:00 2001
From: =?UTF-8?q?Ondrej=20Baranovi=C4=8D?= <nulano@nulano.eu>
Date: Sat, 20 Jan 2024 14:56:20 +0100
Subject: [PATCH 0103/1178] Update winbuild/build.rst

---
 winbuild/build.rst | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/winbuild/build.rst b/winbuild/build.rst
index f40982cd546..c980d9c7567 100644
--- a/winbuild/build.rst
+++ b/winbuild/build.rst
@@ -92,7 +92,7 @@ You can also install Pillow in `editable mode`_::
     winbuild\build\build_env.cmd
     python.exe -m pip install -v -C raqm=vendor -C fribidi=vendor -e .
 
-To build a wheel instead, run::
+To build a binary wheel instead, run::
 
     winbuild\build\build_env.cmd
     python.exe -m pip wheel -v -C raqm=vendor -C fribidi=vendor .

From 46741953215a764d18fb18fe4a16cadb82d40f9c Mon Sep 17 00:00:00 2001
From: Andrew Murray <radarhere@users.noreply.github.com>
Date: Sun, 21 Jan 2024 15:01:12 +1100
Subject: [PATCH 0104/1178] Removed support for test-image-results

---
 Tests/helper.py | 9 ---------
 1 file changed, 9 deletions(-)

diff --git a/Tests/helper.py b/Tests/helper.py
index 99170c765dd..b2e7d43dd67 100644
--- a/Tests/helper.py
+++ b/Tests/helper.py
@@ -25,13 +25,6 @@
     uploader = "show"
 elif "GITHUB_ACTIONS" in os.environ:
     uploader = "github_actions"
-else:
-    try:
-        import test_image_results
-
-        uploader = "aws"
-    except ImportError:
-        pass
 
 
 def upload(a: Image.Image, b: Image.Image) -> str | None:
@@ -46,8 +39,6 @@ def upload(a: Image.Image, b: Image.Image) -> str | None:
         a.save(os.path.join(tmpdir, "a.png"))
         b.save(os.path.join(tmpdir, "b.png"))
         return tmpdir
-    elif uploader == "aws":
-        return test_image_results.upload(a, b)
     return None
 
 

From d331eb9c528920bf6c10d56b5a5a8149b8a92801 Mon Sep 17 00:00:00 2001
From: Andrew Murray <radarhere@users.noreply.github.com>
Date: Sun, 21 Jan 2024 16:47:38 +1100
Subject: [PATCH 0105/1178] Added type hints

---
 Tests/conftest.py | 6 ++++--
 1 file changed, 4 insertions(+), 2 deletions(-)

diff --git a/Tests/conftest.py b/Tests/conftest.py
index ac618c5b945..e00d1f019f5 100644
--- a/Tests/conftest.py
+++ b/Tests/conftest.py
@@ -2,8 +2,10 @@
 
 import io
 
+import pytest
 
-def pytest_report_header(config):
+
+def pytest_report_header(config: pytest.Config) -> str:
     try:
         from PIL import features
 
@@ -14,7 +16,7 @@ def pytest_report_header(config):
         return f"pytest_report_header failed: {e}"
 
 
-def pytest_configure(config):
+def pytest_configure(config: pytest.Config) -> None:
     config.addinivalue_line(
         "markers",
         "pil_noop_mark: A conditional mark where nothing special happens",

From 16ea9bd102757faa7cd02ebfc74b5c9e3d1dac1f Mon Sep 17 00:00:00 2001
From: Hugo van Kemenade <1324225+hugovk@users.noreply.github.com>
Date: Sat, 20 Jan 2024 19:08:51 +0200
Subject: [PATCH 0106/1178] Include pyproject.toml in pip cache key

---
 .github/workflows/docs.yml | 4 +++-
 .github/workflows/test.yml | 7 ++++++-
 2 files changed, 9 insertions(+), 2 deletions(-)

diff --git a/.github/workflows/docs.yml b/.github/workflows/docs.yml
index 9fe345c8a3d..6853462255f 100644
--- a/.github/workflows/docs.yml
+++ b/.github/workflows/docs.yml
@@ -37,7 +37,9 @@ jobs:
       with:
         python-version: "3.x"
         cache: pip
-        cache-dependency-path: ".ci/*.sh"
+        cache-dependency-path: |
+          ".ci/*.sh"
+          "pyproject.toml"
 
     - name: Build system information
       run: python3 .github/workflows/system-info.py
diff --git a/.github/workflows/test.yml b/.github/workflows/test.yml
index 05f78704bcd..2044620aa8a 100644
--- a/.github/workflows/test.yml
+++ b/.github/workflows/test.yml
@@ -26,6 +26,9 @@ concurrency:
   group: ${{ github.workflow }}-${{ github.ref }}
   cancel-in-progress: true
 
+env:
+  FORCE_COLOR: 1
+
 jobs:
   build:
 
@@ -65,7 +68,9 @@ jobs:
         python-version: ${{ matrix.python-version }}
         allow-prereleases: true
         cache: pip
-        cache-dependency-path: ".ci/*.sh"
+        cache-dependency-path: |
+          ".ci/*.sh"
+          "pyproject.toml"
 
     - name: Build system information
       run: python3 .github/workflows/system-info.py

From 0b6c7ba49e80dbba02705e40274854b8b4b5b09b Mon Sep 17 00:00:00 2001
From: Hugo van Kemenade <1324225+hugovk@users.noreply.github.com>
Date: Sat, 20 Jan 2024 19:09:41 +0200
Subject: [PATCH 0107/1178] Disable wget progress bar but not all output

---
 depends/download-and-extract.sh | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/depends/download-and-extract.sh b/depends/download-and-extract.sh
index a318bfafd9f..04bfbc7556b 100755
--- a/depends/download-and-extract.sh
+++ b/depends/download-and-extract.sh
@@ -5,7 +5,7 @@ archive=$1
 url=$2
 
 if [ ! -f $archive.tar.gz ]; then
-    wget -O $archive.tar.gz $url
+    wget --no-verbose -O $archive.tar.gz $url
 fi
 
 rmdir $archive

From 97d24f14a539115c82ecdd0a9801e37dc83636b5 Mon Sep 17 00:00:00 2001
From: Hugo van Kemenade <1324225+hugovk@users.noreply.github.com>
Date: Sun, 21 Jan 2024 01:15:59 +0200
Subject: [PATCH 0108/1178] Cache libimagequant

---
 .github/workflows/docs.yml    |  8 ++++++++
 .github/workflows/test.yml    |  9 +++++++++
 depends/install_imagequant.sh | 38 +++++++++++++++++++++++++++--------
 3 files changed, 47 insertions(+), 8 deletions(-)

diff --git a/.github/workflows/docs.yml b/.github/workflows/docs.yml
index 6853462255f..4319cc8ff28 100644
--- a/.github/workflows/docs.yml
+++ b/.github/workflows/docs.yml
@@ -44,11 +44,19 @@ jobs:
     - name: Build system information
       run: python3 .github/workflows/system-info.py
 
+    - name: Cache libimagequant
+      uses: actions/cache@v4
+      id: cache-libimagequant
+      with:
+        path: ~/cache-libimagequant
+        key: ${{ runner.os }}-libimagequant-${{ hashFiles('depends/install_imagequant.sh') }}
+
     - name: Install Linux dependencies
       run: |
         .ci/install.sh
       env:
         GHA_PYTHON_VERSION: "3.x"
+        GHA_LIBIMAGEQUANT_CACHE_HIT: ${{ steps.cache-libimagequant.outputs.cache-hit }}
 
     - name: Build
       run: |
diff --git a/.github/workflows/test.yml b/.github/workflows/test.yml
index 2044620aa8a..4e23f5c5b12 100644
--- a/.github/workflows/test.yml
+++ b/.github/workflows/test.yml
@@ -75,12 +75,21 @@ jobs:
     - name: Build system information
       run: python3 .github/workflows/system-info.py
 
+    - name: Cache libimagequant
+      if: startsWith(matrix.os, 'ubuntu')
+      uses: actions/cache@v4
+      id: cache-libimagequant
+      with:
+        path: ~/cache-libimagequant
+        key: ${{ runner.os }}-libimagequant-${{ hashFiles('depends/install_imagequant.sh') }}
+
     - name: Install Linux dependencies
       if: startsWith(matrix.os, 'ubuntu')
       run: |
         .ci/install.sh
       env:
         GHA_PYTHON_VERSION: ${{ matrix.python-version }}
+        GHA_LIBIMAGEQUANT_CACHE_HIT: ${{ steps.cache-libimagequant.outputs.cache-hit }}
 
     - name: Install macOS dependencies
       if: startsWith(matrix.os, 'macOS')
diff --git a/depends/install_imagequant.sh b/depends/install_imagequant.sh
index b7cebbdbf60..0fe8cbdba8e 100755
--- a/depends/install_imagequant.sh
+++ b/depends/install_imagequant.sh
@@ -1,15 +1,37 @@
 #!/bin/bash
 # install libimagequant
 
-archive=libimagequant-4.2.2
+archive_name=libimagequant
+archive_version=4.2.2
 
-./download-and-extract.sh $archive https://raw.githubusercontent.com/python-pillow/pillow-depends/main/$archive.tar.gz
+archive=$archive_name-$archive_version
 
-pushd $archive/imagequant-sys
+if [[ "$GHA_LIBIMAGEQUANT_CACHE_HIT" == "true" ]]; then
 
-cargo install cargo-c
-cargo cinstall --prefix=/usr --destdir=.
-sudo cp usr/lib/libimagequant.so* /usr/lib/
-sudo cp usr/include/libimagequant.h /usr/include/
+    # Copy cached files into place
+    sudo cp ~/cache-$archive_name/libimagequant.so* /usr/lib/
+    sudo cp ~/cache-$archive_name/libimagequant.h /usr/include/
 
-popd
+else
+
+    # Build from source
+    ./download-and-extract.sh $archive https://raw.githubusercontent.com/python-pillow/pillow-depends/main/$archive.tar.gz
+
+    pushd $archive/imagequant-sys
+
+    time cargo install cargo-c
+    time cargo cinstall --prefix=/usr --destdir=.
+
+    # Copy into place
+    sudo cp usr/lib/libimagequant.so* /usr/lib/
+    sudo cp usr/include/libimagequant.h /usr/include/
+
+    # Copy to cache
+    rm -rf ~/cache-$archive_name
+    mkdir ~/cache-$archive_name
+    cp usr/lib/libimagequant.so* ~/cache-$archive_name/
+    cp usr/include/libimagequant.h ~/cache-$archive_name/
+
+    popd
+
+fi

From a09e056a4ca9ab5283b14bfd9ccec9aeb0757643 Mon Sep 17 00:00:00 2001
From: Andrew Murray <radarhere@users.noreply.github.com>
Date: Mon, 22 Jan 2024 18:42:43 +1100
Subject: [PATCH 0109/1178] Added type hints

---
 Tests/test_font_bdf.py          |  4 +--
 Tests/test_font_crash.py        |  4 +--
 Tests/test_font_leaks.py        |  6 ++--
 Tests/test_font_pcf.py          | 21 +++++++-----
 Tests/test_font_pcf_charsets.py | 59 +++++++++++++++++++--------------
 5 files changed, 53 insertions(+), 41 deletions(-)

diff --git a/Tests/test_font_bdf.py b/Tests/test_font_bdf.py
index e5e85618651..136070f9e7d 100644
--- a/Tests/test_font_bdf.py
+++ b/Tests/test_font_bdf.py
@@ -7,7 +7,7 @@
 filename = "Tests/images/courB08.bdf"
 
 
-def test_sanity():
+def test_sanity() -> None:
     with open(filename, "rb") as test_file:
         font = BdfFontFile.BdfFontFile(test_file)
 
@@ -15,7 +15,7 @@ def test_sanity():
     assert len([_f for _f in font.glyph if _f]) == 190
 
 
-def test_invalid_file():
+def test_invalid_file() -> None:
     with open("Tests/images/flower.jpg", "rb") as fp:
         with pytest.raises(SyntaxError):
             BdfFontFile.BdfFontFile(fp)
diff --git a/Tests/test_font_crash.py b/Tests/test_font_crash.py
index e3c72c1aebd..b82340ef70b 100644
--- a/Tests/test_font_crash.py
+++ b/Tests/test_font_crash.py
@@ -8,7 +8,7 @@
 
 
 class TestFontCrash:
-    def _fuzz_font(self, font):
+    def _fuzz_font(self, font: ImageFont.FreeTypeFont) -> None:
         # from fuzzers.fuzz_font
         font.getbbox("ABC")
         font.getmask("test text")
@@ -18,7 +18,7 @@ def _fuzz_font(self, font):
             draw.text((10, 10), "Test Text", font=font, fill="#000")
 
     @skip_unless_feature("freetype2")
-    def test_segfault(self):
+    def test_segfault(self) -> None:
         with pytest.raises(OSError):
             font = ImageFont.truetype("Tests/fonts/fuzz_font-5203009437302784")
             self._fuzz_font(font)
diff --git a/Tests/test_font_leaks.py b/Tests/test_font_leaks.py
index 4e29a856bc9..241f455b813 100644
--- a/Tests/test_font_leaks.py
+++ b/Tests/test_font_leaks.py
@@ -10,7 +10,7 @@ class TestTTypeFontLeak(PillowLeakTestCase):
     iterations = 10
     mem_limit = 4096  # k
 
-    def _test_font(self, font):
+    def _test_font(self, font: ImageFont.FreeTypeFont) -> None:
         im = Image.new("RGB", (255, 255), "white")
         draw = ImageDraw.ImageDraw(im)
         self._test_leak(
@@ -20,7 +20,7 @@ def _test_font(self, font):
         )
 
     @skip_unless_feature("freetype2")
-    def test_leak(self):
+    def test_leak(self) -> None:
         ttype = ImageFont.truetype("Tests/fonts/FreeMono.ttf", 20)
         self._test_font(ttype)
 
@@ -30,6 +30,6 @@ class TestDefaultFontLeak(TestTTypeFontLeak):
     iterations = 100
     mem_limit = 1024  # k
 
-    def test_leak(self):
+    def test_leak(self) -> None:
         default_font = ImageFont.load_default()
         self._test_font(default_font)
diff --git a/Tests/test_font_pcf.py b/Tests/test_font_pcf.py
index e6abede0787..0f1eabdce39 100644
--- a/Tests/test_font_pcf.py
+++ b/Tests/test_font_pcf.py
@@ -1,6 +1,7 @@
 from __future__ import annotations
 
 import os
+from pathlib import PosixPath
 
 import pytest
 
@@ -20,7 +21,7 @@
 pytestmark = skip_unless_feature("zlib")
 
 
-def save_font(request, tmp_path):
+def save_font(request: pytest.FixtureRequest, tmp_path: PosixPath) -> str:
     with open(fontname, "rb") as test_file:
         font = PcfFontFile.PcfFontFile(test_file)
     assert isinstance(font, FontFile.FontFile)
@@ -29,7 +30,7 @@ def save_font(request, tmp_path):
 
     tempname = str(tmp_path / "temp.pil")
 
-    def delete_tempfile():
+    def delete_tempfile() -> None:
         try:
             os.remove(tempname[:-4] + ".pbm")
         except OSError:
@@ -47,11 +48,11 @@ def delete_tempfile():
     return tempname
 
 
-def test_sanity(request, tmp_path):
+def test_sanity(request: pytest.FixtureRequest, tmp_path: PosixPath) -> None:
     save_font(request, tmp_path)
 
 
-def test_less_than_256_characters():
+def test_less_than_256_characters() -> None:
     with open("Tests/fonts/10x20-ISO8859-1-fewer-characters.pcf", "rb") as test_file:
         font = PcfFontFile.PcfFontFile(test_file)
     assert isinstance(font, FontFile.FontFile)
@@ -59,13 +60,13 @@ def test_less_than_256_characters():
     assert len([_f for _f in font.glyph if _f]) == 127
 
 
-def test_invalid_file():
+def test_invalid_file() -> None:
     with open("Tests/images/flower.jpg", "rb") as fp:
         with pytest.raises(SyntaxError):
             PcfFontFile.PcfFontFile(fp)
 
 
-def test_draw(request, tmp_path):
+def test_draw(request: pytest.FixtureRequest, tmp_path: PosixPath) -> None:
     tempname = save_font(request, tmp_path)
     font = ImageFont.load(tempname)
     im = Image.new("L", (130, 30), "white")
@@ -74,7 +75,7 @@ def test_draw(request, tmp_path):
     assert_image_similar_tofile(im, "Tests/images/test_draw_pbm_target.png", 0)
 
 
-def test_textsize(request, tmp_path):
+def test_textsize(request: pytest.FixtureRequest, tmp_path: PosixPath) -> None:
     tempname = save_font(request, tmp_path)
     font = ImageFont.load(tempname)
     for i in range(255):
@@ -90,7 +91,9 @@ def test_textsize(request, tmp_path):
         assert font.getbbox(msg) == (0, 0, len(msg) * 10, 20)
 
 
-def _test_high_characters(request, tmp_path, message):
+def _test_high_characters(
+    request: pytest.FixtureRequest, tmp_path: PosixPath, message: str | bytes
+) -> None:
     tempname = save_font(request, tmp_path)
     font = ImageFont.load(tempname)
     im = Image.new("L", (750, 30), "white")
@@ -99,7 +102,7 @@ def _test_high_characters(request, tmp_path, message):
     assert_image_similar_tofile(im, "Tests/images/high_ascii_chars.png", 0)
 
 
-def test_high_characters(request, tmp_path):
+def test_high_characters(request: pytest.FixtureRequest, tmp_path: PosixPath) -> None:
     message = "".join(chr(i + 1) for i in range(140, 232))
     _test_high_characters(request, tmp_path, message)
     # accept bytes instances.
diff --git a/Tests/test_font_pcf_charsets.py b/Tests/test_font_pcf_charsets.py
index 4c2d7185e3c..9dfaa404e28 100644
--- a/Tests/test_font_pcf_charsets.py
+++ b/Tests/test_font_pcf_charsets.py
@@ -1,6 +1,7 @@
 from __future__ import annotations
 
 import os
+from pathlib import PosixPath
 
 import pytest
 
@@ -14,38 +15,40 @@
 
 fontname = "Tests/fonts/ter-x20b.pcf"
 
-charsets = {
-    "iso8859-1": {
-        "glyph_count": 223,
-        "message": "hello, world",
-        "image1": "Tests/images/test_draw_pbm_ter_en_target.png",
-    },
-    "iso8859-2": {
-        "glyph_count": 223,
-        "message": "witaj świecie",
-        "image1": "Tests/images/test_draw_pbm_ter_pl_target.png",
-    },
-    "cp1250": {
-        "glyph_count": 250,
-        "message": "witaj świecie",
-        "image1": "Tests/images/test_draw_pbm_ter_pl_target.png",
-    },
+charsets: dict[str, tuple[int, str, str]] = {
+    "iso8859-1": (
+        223,
+        "hello, world",
+        "Tests/images/test_draw_pbm_ter_en_target.png",
+    ),
+    "iso8859-2": (
+        223,
+        "witaj świecie",
+        "Tests/images/test_draw_pbm_ter_pl_target.png",
+    ),
+    "cp1250": (
+        250,
+        "witaj świecie",
+        "Tests/images/test_draw_pbm_ter_pl_target.png",
+    ),
 }
 
 
 pytestmark = skip_unless_feature("zlib")
 
 
-def save_font(request, tmp_path, encoding):
+def save_font(
+    request: pytest.FixtureRequest, tmp_path: PosixPath, encoding: str
+) -> str:
     with open(fontname, "rb") as test_file:
         font = PcfFontFile.PcfFontFile(test_file, encoding)
     assert isinstance(font, FontFile.FontFile)
     # check the number of characters in the font
-    assert len([_f for _f in font.glyph if _f]) == charsets[encoding]["glyph_count"]
+    assert len([_f for _f in font.glyph if _f]) == charsets[encoding][0]
 
     tempname = str(tmp_path / "temp.pil")
 
-    def delete_tempfile():
+    def delete_tempfile() -> None:
         try:
             os.remove(tempname[:-4] + ".pbm")
         except OSError:
@@ -64,23 +67,29 @@ def delete_tempfile():
 
 
 @pytest.mark.parametrize("encoding", ("iso8859-1", "iso8859-2", "cp1250"))
-def test_sanity(request, tmp_path, encoding):
+def test_sanity(
+    request: pytest.FixtureRequest, tmp_path: PosixPath, encoding: str
+) -> None:
     save_font(request, tmp_path, encoding)
 
 
 @pytest.mark.parametrize("encoding", ("iso8859-1", "iso8859-2", "cp1250"))
-def test_draw(request, tmp_path, encoding):
+def test_draw(
+    request: pytest.FixtureRequest, tmp_path: PosixPath, encoding: str
+) -> None:
     tempname = save_font(request, tmp_path, encoding)
     font = ImageFont.load(tempname)
     im = Image.new("L", (150, 30), "white")
     draw = ImageDraw.Draw(im)
-    message = charsets[encoding]["message"].encode(encoding)
+    message = charsets[encoding][1].encode(encoding)
     draw.text((0, 0), message, "black", font=font)
-    assert_image_similar_tofile(im, charsets[encoding]["image1"], 0)
+    assert_image_similar_tofile(im, charsets[encoding][2], 0)
 
 
 @pytest.mark.parametrize("encoding", ("iso8859-1", "iso8859-2", "cp1250"))
-def test_textsize(request, tmp_path, encoding):
+def test_textsize(
+    request: pytest.FixtureRequest, tmp_path: PosixPath, encoding: str
+) -> None:
     tempname = save_font(request, tmp_path, encoding)
     font = ImageFont.load(tempname)
     for i in range(255):
@@ -90,7 +99,7 @@ def test_textsize(request, tmp_path, encoding):
         assert dy == 20
         assert dx in (0, 10)
         assert font.getlength(bytearray([i])) == dx
-    message = charsets[encoding]["message"].encode(encoding)
+    message = charsets[encoding][1].encode(encoding)
     for i in range(len(message)):
         msg = message[: i + 1]
         assert font.getlength(msg) == len(msg) * 10

From d96c196c48a27fc327eb1fcb7296ee47b7f25e0f Mon Sep 17 00:00:00 2001
From: Hugo van Kemenade <1324225+hugovk@users.noreply.github.com>
Date: Mon, 22 Jan 2024 12:42:03 +0200
Subject: [PATCH 0110/1178] Only cache on GHA, remove debugging
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit

Co-authored-by: Ondrej Baranovič <nulano@nulano.eu>
---
 depends/install_imagequant.sh | 16 +++++++++-------
 1 file changed, 9 insertions(+), 7 deletions(-)

diff --git a/depends/install_imagequant.sh b/depends/install_imagequant.sh
index 0fe8cbdba8e..3adae91a525 100755
--- a/depends/install_imagequant.sh
+++ b/depends/install_imagequant.sh
@@ -19,18 +19,20 @@ else
 
     pushd $archive/imagequant-sys
 
-    time cargo install cargo-c
-    time cargo cinstall --prefix=/usr --destdir=.
+    cargo install cargo-c
+    cargo cinstall --prefix=/usr --destdir=.
 
     # Copy into place
     sudo cp usr/lib/libimagequant.so* /usr/lib/
     sudo cp usr/include/libimagequant.h /usr/include/
 
-    # Copy to cache
-    rm -rf ~/cache-$archive_name
-    mkdir ~/cache-$archive_name
-    cp usr/lib/libimagequant.so* ~/cache-$archive_name/
-    cp usr/include/libimagequant.h ~/cache-$archive_name/
+    if [ -n "$GITHUB_ACTIONS" ]; then
+        # Copy to cache
+        rm -rf ~/cache-$archive_name
+        mkdir ~/cache-$archive_name
+        cp usr/lib/libimagequant.so* ~/cache-$archive_name/
+        cp usr/include/libimagequant.h ~/cache-$archive_name/
+    fi
 
     popd
 

From 2521ec4732311ffd85444253d755e3acee89c10f Mon Sep 17 00:00:00 2001
From: Andrew Murray <radarhere@users.noreply.github.com>
Date: Mon, 22 Jan 2024 22:08:45 +1100
Subject: [PATCH 0111/1178] Restored charsets dictionary

---
 Tests/test_font_pcf_charsets.py | 53 +++++++++++++++++++--------------
 1 file changed, 30 insertions(+), 23 deletions(-)

diff --git a/Tests/test_font_pcf_charsets.py b/Tests/test_font_pcf_charsets.py
index 9dfaa404e28..cb77128eff7 100644
--- a/Tests/test_font_pcf_charsets.py
+++ b/Tests/test_font_pcf_charsets.py
@@ -15,22 +15,22 @@
 
 fontname = "Tests/fonts/ter-x20b.pcf"
 
-charsets: dict[str, tuple[int, str, str]] = {
-    "iso8859-1": (
-        223,
-        "hello, world",
-        "Tests/images/test_draw_pbm_ter_en_target.png",
-    ),
-    "iso8859-2": (
-        223,
-        "witaj świecie",
-        "Tests/images/test_draw_pbm_ter_pl_target.png",
-    ),
-    "cp1250": (
-        250,
-        "witaj świecie",
-        "Tests/images/test_draw_pbm_ter_pl_target.png",
-    ),
+charsets: dict[str, dict[str, int | str]] = {
+    "iso8859-1": {
+        "glyph_count": 223,
+        "message": "hello, world",
+        "image1": "Tests/images/test_draw_pbm_ter_en_target.png",
+    },
+    "iso8859-2": {
+        "glyph_count": 223,
+        "message": "witaj świecie",
+        "image1": "Tests/images/test_draw_pbm_ter_pl_target.png",
+    },
+    "cp1250": {
+        "glyph_count": 250,
+        "message": "witaj świecie",
+        "image1": "Tests/images/test_draw_pbm_ter_pl_target.png",
+    },
 }
 
 
@@ -44,7 +44,7 @@ def save_font(
         font = PcfFontFile.PcfFontFile(test_file, encoding)
     assert isinstance(font, FontFile.FontFile)
     # check the number of characters in the font
-    assert len([_f for _f in font.glyph if _f]) == charsets[encoding][0]
+    assert len([_f for _f in font.glyph if _f]) == charsets[encoding]["glyph_count"]
 
     tempname = str(tmp_path / "temp.pil")
 
@@ -81,9 +81,14 @@ def test_draw(
     font = ImageFont.load(tempname)
     im = Image.new("L", (150, 30), "white")
     draw = ImageDraw.Draw(im)
-    message = charsets[encoding][1].encode(encoding)
-    draw.text((0, 0), message, "black", font=font)
-    assert_image_similar_tofile(im, charsets[encoding][2], 0)
+
+    message = charsets[encoding]["message"]
+    assert isinstance(message, str)
+    draw.text((0, 0), message.encode(encoding), "black", font=font)
+
+    expected_path = charsets[encoding]["image1"]
+    assert isinstance(expected_path, str)
+    assert_image_similar_tofile(im, expected_path, 0)
 
 
 @pytest.mark.parametrize("encoding", ("iso8859-1", "iso8859-2", "cp1250"))
@@ -99,8 +104,10 @@ def test_textsize(
         assert dy == 20
         assert dx in (0, 10)
         assert font.getlength(bytearray([i])) == dx
-    message = charsets[encoding][1].encode(encoding)
-    for i in range(len(message)):
-        msg = message[: i + 1]
+    message = charsets[encoding]["message"]
+    assert isinstance(message, str)
+    message_bytes = message.encode(encoding)
+    for i in range(len(message_bytes)):
+        msg = message_bytes[: i + 1]
         assert font.getlength(msg) == len(msg) * 10
         assert font.getbbox(msg) == (0, 0, len(msg) * 10, 20)

From 231d54b9df90dcce1cdbb9928f8d21899eed8153 Mon Sep 17 00:00:00 2001
From: Hugo van Kemenade <1324225+hugovk@users.noreply.github.com>
Date: Mon, 22 Jan 2024 21:37:37 +0200
Subject: [PATCH 0112/1178] Replace io.BytesIO in type hints

---
 docs/reference/internal_design.rst  |  4 ++--
 docs/reference/internal_modules.rst | 12 ++++++++++++
 src/PIL/GdImageFile.py              |  7 +++++--
 src/PIL/MpegImagePlugin.py          |  5 ++---
 src/PIL/_typing.py                  | 16 +++++++++++++++-
 src/PIL/_util.py                    |  4 ++--
 6 files changed, 38 insertions(+), 10 deletions(-)

diff --git a/docs/reference/internal_design.rst b/docs/reference/internal_design.rst
index 2e2d3322f75..99a18e9ea99 100644
--- a/docs/reference/internal_design.rst
+++ b/docs/reference/internal_design.rst
@@ -1,5 +1,5 @@
-Internal Reference Docs
-=======================
+Internal Reference
+==================
 
 .. toctree::
   :maxdepth: 2
diff --git a/docs/reference/internal_modules.rst b/docs/reference/internal_modules.rst
index f2932c32200..c3cc700607f 100644
--- a/docs/reference/internal_modules.rst
+++ b/docs/reference/internal_modules.rst
@@ -33,6 +33,18 @@ Internal Modules
 Provides a convenient way to import type hints that are not available
 on some Python versions.
 
+.. py:class:: FileDescriptor
+
+    Typing alias.
+
+.. py:class:: StrOrBytesPath
+
+    Typing alias.
+
+.. py:class:: SupportsRead
+
+    An object that supports the read method.
+
 .. py:data:: TypeGuard
     :value: typing.TypeGuard
 
diff --git a/src/PIL/GdImageFile.py b/src/PIL/GdImageFile.py
index 7bb4736af13..315ac6d6c1a 100644
--- a/src/PIL/GdImageFile.py
+++ b/src/PIL/GdImageFile.py
@@ -27,11 +27,12 @@ class is not registered for use with :py:func:`PIL.Image.open()`.  To open a
 """
 from __future__ import annotations
 
-from io import BytesIO
+from typing import IO
 
 from . import ImageFile, ImagePalette, UnidentifiedImageError
 from ._binary import i16be as i16
 from ._binary import i32be as i32
+from ._typing import FileDescriptor, StrOrBytesPath
 
 
 class GdImageFile(ImageFile.ImageFile):
@@ -80,7 +81,9 @@ def _open(self) -> None:
         ]
 
 
-def open(fp: BytesIO, mode: str = "r") -> GdImageFile:
+def open(
+    fp: StrOrBytesPath | FileDescriptor | IO[bytes], mode: str = "r"
+) -> GdImageFile:
     """
     Load texture from a GD image file.
 
diff --git a/src/PIL/MpegImagePlugin.py b/src/PIL/MpegImagePlugin.py
index b9e9243e59f..1565612f869 100644
--- a/src/PIL/MpegImagePlugin.py
+++ b/src/PIL/MpegImagePlugin.py
@@ -14,17 +14,16 @@
 #
 from __future__ import annotations
 
-from io import BytesIO
-
 from . import Image, ImageFile
 from ._binary import i8
+from ._typing import SupportsRead
 
 #
 # Bitstream parser
 
 
 class BitStream:
-    def __init__(self, fp: BytesIO) -> None:
+    def __init__(self, fp: SupportsRead[bytes]) -> None:
         self.fp = fp
         self.bits = 0
         self.bitbuffer = 0
diff --git a/src/PIL/_typing.py b/src/PIL/_typing.py
index 608b2b41fa8..6eb25c1c171 100644
--- a/src/PIL/_typing.py
+++ b/src/PIL/_typing.py
@@ -1,6 +1,8 @@
 from __future__ import annotations
 
+import os
 import sys
+from typing import Protocol, TypeVar, Union
 
 if sys.version_info >= (3, 10):
     from typing import TypeGuard
@@ -15,4 +17,16 @@ def __class_getitem__(cls, item: Any) -> type[bool]:
                 return bool
 
 
-__all__ = ["TypeGuard"]
+_T_co = TypeVar("_T_co", covariant=True)
+
+
+class SupportsRead(Protocol[_T_co]):
+    def read(self, __length: int = ...) -> _T_co:
+        ...
+
+
+FileDescriptor = int
+StrOrBytesPath = Union[str, bytes, "os.PathLike[str]", "os.PathLike[bytes]"]
+
+
+__all__ = ["FileDescriptor", "TypeGuard", "StrOrBytesPath", "SupportsRead"]
diff --git a/src/PIL/_util.py b/src/PIL/_util.py
index 13f369cca1d..4ecdc4bd307 100644
--- a/src/PIL/_util.py
+++ b/src/PIL/_util.py
@@ -4,10 +4,10 @@
 from pathlib import Path
 from typing import Any, NoReturn
 
-from ._typing import TypeGuard
+from ._typing import StrOrBytesPath, TypeGuard
 
 
-def is_path(f: Any) -> TypeGuard[bytes | str | Path]:
+def is_path(f: Any) -> TypeGuard[StrOrBytesPath]:
     return isinstance(f, (bytes, str, Path))
 
 

From 474411b52a3619f01bb626ce8e56100094886d1a Mon Sep 17 00:00:00 2001
From: Andrew Murray <radarhere@users.noreply.github.com>
Date: Tue, 23 Jan 2024 08:52:14 +1100
Subject: [PATCH 0113/1178] Updated zlib to 1.3.1

---
 .github/workflows/wheels-dependencies.sh | 2 +-
 winbuild/build_prepare.py                | 6 +++---
 2 files changed, 4 insertions(+), 4 deletions(-)

diff --git a/.github/workflows/wheels-dependencies.sh b/.github/workflows/wheels-dependencies.sh
index 3ec3148734f..a30d0468ccb 100755
--- a/.github/workflows/wheels-dependencies.sh
+++ b/.github/workflows/wheels-dependencies.sh
@@ -29,7 +29,7 @@ else
     GIFLIB_VERSION=5.2.1
 fi
 if [[ -n "$IS_MACOS" ]] || [[ "$MB_ML_VER" != 2014 ]]; then
-    ZLIB_VERSION=1.3
+    ZLIB_VERSION=1.3.1
 else
     ZLIB_VERSION=1.2.8
 fi
diff --git a/winbuild/build_prepare.py b/winbuild/build_prepare.py
index df33ea493e6..3117065e8f7 100644
--- a/winbuild/build_prepare.py
+++ b/winbuild/build_prepare.py
@@ -143,9 +143,9 @@ def cmd_msbuild(
         "bins": ["cjpeg.exe", "djpeg.exe"],
     },
     "zlib": {
-        "url": "https://zlib.net/zlib13.zip",
-        "filename": "zlib13.zip",
-        "dir": "zlib-1.3",
+        "url": "https://zlib.net/zlib131.zip",
+        "filename": "zlib131.zip",
+        "dir": "zlib-1.3.1",
         "license": "README",
         "license_pattern": "Copyright notice:\n\n(.+)$",
         "build": [

From 16fd934b007d7090fc32ff4a1ad13182a32bf612 Mon Sep 17 00:00:00 2001
From: Andrew Murray <radarhere@users.noreply.github.com>
Date: Tue, 23 Jan 2024 09:55:25 +1100
Subject: [PATCH 0114/1178] Use TypedDict

---
 Tests/test_font_pcf_charsets.py | 29 +++++++++++++++--------------
 1 file changed, 15 insertions(+), 14 deletions(-)

diff --git a/Tests/test_font_pcf_charsets.py b/Tests/test_font_pcf_charsets.py
index cb77128eff7..894d4eb56bf 100644
--- a/Tests/test_font_pcf_charsets.py
+++ b/Tests/test_font_pcf_charsets.py
@@ -2,6 +2,7 @@
 
 import os
 from pathlib import PosixPath
+from typing import TypedDict
 
 import pytest
 
@@ -15,7 +16,14 @@
 
 fontname = "Tests/fonts/ter-x20b.pcf"
 
-charsets: dict[str, dict[str, int | str]] = {
+
+class Charset(TypedDict):
+    glyph_count: int
+    message: str
+    image1: str
+
+
+charsets: dict[str, Charset] = {
     "iso8859-1": {
         "glyph_count": 223,
         "message": "hello, world",
@@ -81,14 +89,9 @@ def test_draw(
     font = ImageFont.load(tempname)
     im = Image.new("L", (150, 30), "white")
     draw = ImageDraw.Draw(im)
-
-    message = charsets[encoding]["message"]
-    assert isinstance(message, str)
-    draw.text((0, 0), message.encode(encoding), "black", font=font)
-
-    expected_path = charsets[encoding]["image1"]
-    assert isinstance(expected_path, str)
-    assert_image_similar_tofile(im, expected_path, 0)
+    message = charsets[encoding]["message"].encode(encoding)
+    draw.text((0, 0), message, "black", font=font)
+    assert_image_similar_tofile(im, charsets[encoding]["image1"], 0)
 
 
 @pytest.mark.parametrize("encoding", ("iso8859-1", "iso8859-2", "cp1250"))
@@ -104,10 +107,8 @@ def test_textsize(
         assert dy == 20
         assert dx in (0, 10)
         assert font.getlength(bytearray([i])) == dx
-    message = charsets[encoding]["message"]
-    assert isinstance(message, str)
-    message_bytes = message.encode(encoding)
-    for i in range(len(message_bytes)):
-        msg = message_bytes[: i + 1]
+    message = charsets[encoding]["message"].encode(encoding)
+    for i in range(len(message)):
+        msg = message[: i + 1]
         assert font.getlength(msg) == len(msg) * 10
         assert font.getbbox(msg) == (0, 0, len(msg) * 10, 20)

From 8caae8739f16cfddade0848ba686b1a40a0c10b4 Mon Sep 17 00:00:00 2001
From: Andrew Murray <radarhere@users.noreply.github.com>
Date: Tue, 23 Jan 2024 18:51:41 +1100
Subject: [PATCH 0115/1178] Restored testing of non-TrueType default font

---
 Tests/test_font_leaks.py | 10 ++++++++--
 1 file changed, 8 insertions(+), 2 deletions(-)

diff --git a/Tests/test_font_leaks.py b/Tests/test_font_leaks.py
index 4e29a856bc9..d29e9bcfc9a 100644
--- a/Tests/test_font_leaks.py
+++ b/Tests/test_font_leaks.py
@@ -1,8 +1,10 @@
 from __future__ import annotations
 
-from PIL import Image, ImageDraw, ImageFont
+from PIL import Image, ImageDraw, ImageFont, _util
 
-from .helper import PillowLeakTestCase, skip_unless_feature
+from .helper import PillowLeakTestCase, features, skip_unless_feature
+
+original_core = ImageFont.core
 
 
 class TestTTypeFontLeak(PillowLeakTestCase):
@@ -31,5 +33,9 @@ class TestDefaultFontLeak(TestTTypeFontLeak):
     mem_limit = 1024  # k
 
     def test_leak(self):
+        if features.check_module("freetype2"):
+            ImageFont.core = _util.DeferredError(ImportError)
         default_font = ImageFont.load_default()
+        ImageFont.core = original_core
+
         self._test_font(default_font)

From 4814bee6c0b99b4e00fa08a5d15663f8238f063a Mon Sep 17 00:00:00 2001
From: Andrew Murray <radarhere@users.noreply.github.com>
Date: Tue, 23 Jan 2024 21:42:36 +1100
Subject: [PATCH 0116/1178] Use Path instead of PosixPath

---
 Tests/check_j2k_overflow.py       |  4 ++--
 Tests/check_large_memory.py       |  8 ++++----
 Tests/check_large_memory_numpy.py |  8 ++++----
 Tests/test_font_pcf.py            | 14 +++++++-------
 Tests/test_font_pcf_charsets.py   | 16 +++++-----------
 5 files changed, 22 insertions(+), 28 deletions(-)

diff --git a/Tests/check_j2k_overflow.py b/Tests/check_j2k_overflow.py
index 8a85783fccb..dbdd5a4f557 100644
--- a/Tests/check_j2k_overflow.py
+++ b/Tests/check_j2k_overflow.py
@@ -1,13 +1,13 @@
 from __future__ import annotations
 
-from pathlib import PosixPath
+from pathlib import Path
 
 import pytest
 
 from PIL import Image
 
 
-def test_j2k_overflow(tmp_path: PosixPath) -> None:
+def test_j2k_overflow(tmp_path: Path) -> None:
     im = Image.new("RGBA", (1024, 131584))
     target = str(tmp_path / "temp.jpc")
     with pytest.raises(OSError):
diff --git a/Tests/check_large_memory.py b/Tests/check_large_memory.py
index 2c8c77800bb..a9ce79e57e6 100644
--- a/Tests/check_large_memory.py
+++ b/Tests/check_large_memory.py
@@ -1,7 +1,7 @@
 from __future__ import annotations
 
 import sys
-from pathlib import PosixPath
+from pathlib import Path
 from types import ModuleType
 
 import pytest
@@ -31,18 +31,18 @@
 pytestmark = pytest.mark.skipif(sys.maxsize <= 2**32, reason="requires 64-bit system")
 
 
-def _write_png(tmp_path: PosixPath, xdim: int, ydim: int) -> None:
+def _write_png(tmp_path: Path, xdim: int, ydim: int) -> None:
     f = str(tmp_path / "temp.png")
     im = Image.new("L", (xdim, ydim), 0)
     im.save(f)
 
 
-def test_large(tmp_path: PosixPath) -> None:
+def test_large(tmp_path: Path) -> None:
     """succeeded prepatch"""
     _write_png(tmp_path, XDIM, YDIM)
 
 
-def test_2gpx(tmp_path: PosixPath) -> None:
+def test_2gpx(tmp_path: Path) -> None:
     """failed prepatch"""
     _write_png(tmp_path, XDIM, XDIM)
 
diff --git a/Tests/check_large_memory_numpy.py b/Tests/check_large_memory_numpy.py
index 8609fe6d07b..f4ca8d0aa68 100644
--- a/Tests/check_large_memory_numpy.py
+++ b/Tests/check_large_memory_numpy.py
@@ -1,7 +1,7 @@
 from __future__ import annotations
 
 import sys
-from pathlib import PosixPath
+from pathlib import Path
 
 import pytest
 
@@ -25,7 +25,7 @@
 pytestmark = pytest.mark.skipif(sys.maxsize <= 2**32, reason="requires 64-bit system")
 
 
-def _write_png(tmp_path: PosixPath, xdim: int, ydim: int) -> None:
+def _write_png(tmp_path: Path, xdim: int, ydim: int) -> None:
     dtype = np.uint8
     a = np.zeros((xdim, ydim), dtype=dtype)
     f = str(tmp_path / "temp.png")
@@ -33,11 +33,11 @@ def _write_png(tmp_path: PosixPath, xdim: int, ydim: int) -> None:
     im.save(f)
 
 
-def test_large(tmp_path: PosixPath) -> None:
+def test_large(tmp_path: Path) -> None:
     """succeeded prepatch"""
     _write_png(tmp_path, XDIM, YDIM)
 
 
-def test_2gpx(tmp_path: PosixPath) -> None:
+def test_2gpx(tmp_path: Path) -> None:
     """failed prepatch"""
     _write_png(tmp_path, XDIM, XDIM)
diff --git a/Tests/test_font_pcf.py b/Tests/test_font_pcf.py
index 0f1eabdce39..997809e463b 100644
--- a/Tests/test_font_pcf.py
+++ b/Tests/test_font_pcf.py
@@ -1,7 +1,7 @@
 from __future__ import annotations
 
 import os
-from pathlib import PosixPath
+from pathlib import Path
 
 import pytest
 
@@ -21,7 +21,7 @@
 pytestmark = skip_unless_feature("zlib")
 
 
-def save_font(request: pytest.FixtureRequest, tmp_path: PosixPath) -> str:
+def save_font(request: pytest.FixtureRequest, tmp_path: Path) -> str:
     with open(fontname, "rb") as test_file:
         font = PcfFontFile.PcfFontFile(test_file)
     assert isinstance(font, FontFile.FontFile)
@@ -48,7 +48,7 @@ def delete_tempfile() -> None:
     return tempname
 
 
-def test_sanity(request: pytest.FixtureRequest, tmp_path: PosixPath) -> None:
+def test_sanity(request: pytest.FixtureRequest, tmp_path: Path) -> None:
     save_font(request, tmp_path)
 
 
@@ -66,7 +66,7 @@ def test_invalid_file() -> None:
             PcfFontFile.PcfFontFile(fp)
 
 
-def test_draw(request: pytest.FixtureRequest, tmp_path: PosixPath) -> None:
+def test_draw(request: pytest.FixtureRequest, tmp_path: Path) -> None:
     tempname = save_font(request, tmp_path)
     font = ImageFont.load(tempname)
     im = Image.new("L", (130, 30), "white")
@@ -75,7 +75,7 @@ def test_draw(request: pytest.FixtureRequest, tmp_path: PosixPath) -> None:
     assert_image_similar_tofile(im, "Tests/images/test_draw_pbm_target.png", 0)
 
 
-def test_textsize(request: pytest.FixtureRequest, tmp_path: PosixPath) -> None:
+def test_textsize(request: pytest.FixtureRequest, tmp_path: Path) -> None:
     tempname = save_font(request, tmp_path)
     font = ImageFont.load(tempname)
     for i in range(255):
@@ -92,7 +92,7 @@ def test_textsize(request: pytest.FixtureRequest, tmp_path: PosixPath) -> None:
 
 
 def _test_high_characters(
-    request: pytest.FixtureRequest, tmp_path: PosixPath, message: str | bytes
+    request: pytest.FixtureRequest, tmp_path: Path, message: str | bytes
 ) -> None:
     tempname = save_font(request, tmp_path)
     font = ImageFont.load(tempname)
@@ -102,7 +102,7 @@ def _test_high_characters(
     assert_image_similar_tofile(im, "Tests/images/high_ascii_chars.png", 0)
 
 
-def test_high_characters(request: pytest.FixtureRequest, tmp_path: PosixPath) -> None:
+def test_high_characters(request: pytest.FixtureRequest, tmp_path: Path) -> None:
     message = "".join(chr(i + 1) for i in range(140, 232))
     _test_high_characters(request, tmp_path, message)
     # accept bytes instances.
diff --git a/Tests/test_font_pcf_charsets.py b/Tests/test_font_pcf_charsets.py
index 894d4eb56bf..895458d9d82 100644
--- a/Tests/test_font_pcf_charsets.py
+++ b/Tests/test_font_pcf_charsets.py
@@ -1,7 +1,7 @@
 from __future__ import annotations
 
 import os
-from pathlib import PosixPath
+from pathlib import Path
 from typing import TypedDict
 
 import pytest
@@ -45,9 +45,7 @@ class Charset(TypedDict):
 pytestmark = skip_unless_feature("zlib")
 
 
-def save_font(
-    request: pytest.FixtureRequest, tmp_path: PosixPath, encoding: str
-) -> str:
+def save_font(request: pytest.FixtureRequest, tmp_path: Path, encoding: str) -> str:
     with open(fontname, "rb") as test_file:
         font = PcfFontFile.PcfFontFile(test_file, encoding)
     assert isinstance(font, FontFile.FontFile)
@@ -75,16 +73,12 @@ def delete_tempfile() -> None:
 
 
 @pytest.mark.parametrize("encoding", ("iso8859-1", "iso8859-2", "cp1250"))
-def test_sanity(
-    request: pytest.FixtureRequest, tmp_path: PosixPath, encoding: str
-) -> None:
+def test_sanity(request: pytest.FixtureRequest, tmp_path: Path, encoding: str) -> None:
     save_font(request, tmp_path, encoding)
 
 
 @pytest.mark.parametrize("encoding", ("iso8859-1", "iso8859-2", "cp1250"))
-def test_draw(
-    request: pytest.FixtureRequest, tmp_path: PosixPath, encoding: str
-) -> None:
+def test_draw(request: pytest.FixtureRequest, tmp_path: Path, encoding: str) -> None:
     tempname = save_font(request, tmp_path, encoding)
     font = ImageFont.load(tempname)
     im = Image.new("L", (150, 30), "white")
@@ -96,7 +90,7 @@ def test_draw(
 
 @pytest.mark.parametrize("encoding", ("iso8859-1", "iso8859-2", "cp1250"))
 def test_textsize(
-    request: pytest.FixtureRequest, tmp_path: PosixPath, encoding: str
+    request: pytest.FixtureRequest, tmp_path: Path, encoding: str
 ) -> None:
     tempname = save_font(request, tmp_path, encoding)
     font = ImageFont.load(tempname)

From e2d1b2663d2b392089bfe59c7a17d2afbf74ce7f Mon Sep 17 00:00:00 2001
From: Andrew Murray <3112309+radarhere@users.noreply.github.com>
Date: Wed, 24 Jan 2024 08:12:06 +1100
Subject: [PATCH 0117/1178] Restored original state using finally
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit

Co-authored-by: Ondrej Baranovič <nulano@nulano.eu>
---
 Tests/test_font_leaks.py | 6 ++++--
 1 file changed, 4 insertions(+), 2 deletions(-)

diff --git a/Tests/test_font_leaks.py b/Tests/test_font_leaks.py
index d29e9bcfc9a..5eea0c34d5f 100644
--- a/Tests/test_font_leaks.py
+++ b/Tests/test_font_leaks.py
@@ -35,7 +35,9 @@ class TestDefaultFontLeak(TestTTypeFontLeak):
     def test_leak(self):
         if features.check_module("freetype2"):
             ImageFont.core = _util.DeferredError(ImportError)
-        default_font = ImageFont.load_default()
-        ImageFont.core = original_core
+        try:
+            default_font = ImageFont.load_default()
+        finally:
+            ImageFont.core = original_core
 
         self._test_font(default_font)

From e3932b7dbaf6aff8ef4b7a24007f4de07477ec91 Mon Sep 17 00:00:00 2001
From: Hugo van Kemenade <1324225+hugovk@users.noreply.github.com>
Date: Tue, 23 Jan 2024 23:58:41 +0200
Subject: [PATCH 0118/1178] Exclude from coverage: empty bodies in protocols or
 abstract methods

---
 .coveragerc | 3 +++
 1 file changed, 3 insertions(+)

diff --git a/.coveragerc b/.coveragerc
index 46df3f90d27..5678e45661a 100644
--- a/.coveragerc
+++ b/.coveragerc
@@ -10,6 +10,9 @@ exclude_also =
     if DEBUG:
     # Don't complain about compatibility code for missing optional dependencies
     except ImportError
+    # Empty bodies in protocols or abstract methods
+    ^\s*def [a-zA-Z0-9_]+\(.*\)(\s*->.*)?:\s*\.\.\.(\s*#.*)?$
+    ^\s*\.\.\.(\s*#.*)?$
 
 [run]
 omit =

From b3a7ae065c4f34b345ecaa3b019bbd1d24e7922c Mon Sep 17 00:00:00 2001
From: Andrew Murray <radarhere@users.noreply.github.com>
Date: Thu, 25 Jan 2024 06:40:03 +1100
Subject: [PATCH 0119/1178] Update CHANGES.rst [ci skip]

---
 CHANGES.rst | 6 ++++++
 1 file changed, 6 insertions(+)

diff --git a/CHANGES.rst b/CHANGES.rst
index 62ae2a68bbc..7d80eec0345 100644
--- a/CHANGES.rst
+++ b/CHANGES.rst
@@ -5,6 +5,12 @@ Changelog (Pillow)
 10.3.0 (unreleased)
 -------------------
 
+- Do not support using test-image-results to upload images after test failures #7739
+  [radarhere]
+
+- Changed ImageMath.ops to be static #7721
+  [radarhere]
+
 - Fix APNG info after seeking backwards more than twice #7701
   [esoma, radarhere]
 

From cf9e6ff2563be6d0458856e2aa35e54973709752 Mon Sep 17 00:00:00 2001
From: Andrew Murray <radarhere@users.noreply.github.com>
Date: Thu, 25 Jan 2024 08:10:07 +1100
Subject: [PATCH 0120/1178] Updated libjpeg-turbo to 3.0.2

---
 .github/workflows/wheels-dependencies.sh | 2 +-
 winbuild/build_prepare.py                | 6 +++---
 2 files changed, 4 insertions(+), 4 deletions(-)

diff --git a/.github/workflows/wheels-dependencies.sh b/.github/workflows/wheels-dependencies.sh
index 3ec3148734f..9013e8ae2c8 100755
--- a/.github/workflows/wheels-dependencies.sh
+++ b/.github/workflows/wheels-dependencies.sh
@@ -18,7 +18,7 @@ ARCHIVE_SDIR=pillow-depends-main
 FREETYPE_VERSION=2.13.2
 HARFBUZZ_VERSION=8.3.0
 LIBPNG_VERSION=1.6.40
-JPEGTURBO_VERSION=3.0.1
+JPEGTURBO_VERSION=3.0.2
 OPENJPEG_VERSION=2.5.0
 XZ_VERSION=5.4.5
 TIFF_VERSION=4.6.0
diff --git a/winbuild/build_prepare.py b/winbuild/build_prepare.py
index df33ea493e6..92cbcdf7a99 100644
--- a/winbuild/build_prepare.py
+++ b/winbuild/build_prepare.py
@@ -113,9 +113,9 @@ def cmd_msbuild(
 DEPS = {
     "libjpeg": {
         "url": SF_PROJECTS
-        + "/libjpeg-turbo/files/3.0.1/libjpeg-turbo-3.0.1.tar.gz/download",
-        "filename": "libjpeg-turbo-3.0.1.tar.gz",
-        "dir": "libjpeg-turbo-3.0.1",
+        + "/libjpeg-turbo/files/3.0.2/libjpeg-turbo-3.0.2.tar.gz/download",
+        "filename": "libjpeg-turbo-3.0.2.tar.gz",
+        "dir": "libjpeg-turbo-3.0.2",
         "license": ["README.ijg", "LICENSE.md"],
         "license_pattern": (
             "(LEGAL ISSUES\n============\n\n.+?)\n\nREFERENCES\n=========="

From 5721577e4e6f5d64a5c50ab8732eea9e5a437120 Mon Sep 17 00:00:00 2001
From: Andrew Murray <radarhere@users.noreply.github.com>
Date: Thu, 25 Jan 2024 20:20:53 +1100
Subject: [PATCH 0121/1178] Stop reading EPS at EOF marker

---
 Tests/test_file_eps.py    | 8 ++++++++
 src/PIL/EpsImagePlugin.py | 8 ++------
 2 files changed, 10 insertions(+), 6 deletions(-)

diff --git a/Tests/test_file_eps.py b/Tests/test_file_eps.py
index 8def9a43511..5ba3a0c1449 100644
--- a/Tests/test_file_eps.py
+++ b/Tests/test_file_eps.py
@@ -436,3 +436,11 @@ def test_eof_before_bounding_box():
     with pytest.raises(OSError):
         with Image.open("Tests/images/zero_bb_eof_before_boundingbox.eps"):
             pass
+
+
+def test_invalid_data_after_eof() -> None:
+    with open("Tests/images/illuCS6_preview.eps", "rb") as f:
+        img_bytes = io.BytesIO(f.read() + b"\r\n%" + (b" " * 255))
+
+    with Image.open(img_bytes) as img:
+        assert img.mode == "RGB"
diff --git a/src/PIL/EpsImagePlugin.py b/src/PIL/EpsImagePlugin.py
index d2e60aa0759..94b163bc4d6 100644
--- a/src/PIL/EpsImagePlugin.py
+++ b/src/PIL/EpsImagePlugin.py
@@ -356,14 +356,10 @@ def _read_comment(s):
 
                 self._size = columns, rows
                 return
+            elif bytes_mv[:5] == b"%%EOF":
+                break
             elif trailer_reached and reading_trailer_comments:
                 # Load EPS trailer
-
-                # if this line starts with "%%EOF",
-                # then we've reached the end of the file
-                if bytes_mv[:5] == b"%%EOF":
-                    break
-
                 s = str(bytes_mv[:bytes_read], "latin-1")
                 _read_comment(s)
             elif bytes_mv[:9] == b"%%Trailer":

From ddb7df0ec6b5852e509dbf00675a3866ca00bd66 Mon Sep 17 00:00:00 2001
From: Andrew Murray <radarhere@users.noreply.github.com>
Date: Thu, 25 Jan 2024 22:18:46 +1100
Subject: [PATCH 0122/1178] Added type hints

---
 Tests/test_image_convert.py       | 50 +++++++++++-----------
 Tests/test_image_copy.py          |  6 +--
 Tests/test_image_crop.py          | 14 +++----
 Tests/test_image_frombytes.py     |  2 +-
 Tests/test_image_fromqimage.py    | 15 +++----
 Tests/test_image_getbands.py      |  2 +-
 Tests/test_image_getbbox.py       | 12 +++---
 Tests/test_image_getcolors.py     |  6 +--
 Tests/test_image_getdata.py       |  6 +--
 Tests/test_image_getim.py         |  2 +-
 Tests/test_image_getprojection.py |  2 +-
 Tests/test_image_histogram.py     |  4 +-
 Tests/test_image_point.py         |  8 ++--
 Tests/test_image_putalpha.py      |  6 +--
 Tests/test_image_quantize.py      | 24 +++++------
 Tests/test_image_resize.py        | 70 +++++++++++++++++++++----------
 Tests/test_image_split.py         | 12 +++---
 Tests/test_image_tobitmap.py      |  2 +-
 Tests/test_image_tobytes.py       |  2 +-
 Tests/test_image_transpose.py     | 19 +++++----
 20 files changed, 149 insertions(+), 115 deletions(-)

diff --git a/Tests/test_image_convert.py b/Tests/test_image_convert.py
index d4ddc2a31b2..f154de123bb 100644
--- a/Tests/test_image_convert.py
+++ b/Tests/test_image_convert.py
@@ -1,5 +1,7 @@
 from __future__ import annotations
 
+from pathlib import Path
+
 import pytest
 
 from PIL import Image
@@ -7,8 +9,8 @@
 from .helper import assert_image, assert_image_equal, assert_image_similar, hopper
 
 
-def test_sanity():
-    def convert(im, mode):
+def test_sanity() -> None:
+    def convert(im: Image.Image, mode: str) -> None:
         out = im.convert(mode)
         assert out.mode == mode
         assert out.size == im.size
@@ -40,13 +42,13 @@ def convert(im, mode):
             convert(im, output_mode)
 
 
-def test_unsupported_conversion():
+def test_unsupported_conversion() -> None:
     im = hopper()
     with pytest.raises(ValueError):
         im.convert("INVALID")
 
 
-def test_default():
+def test_default() -> None:
     im = hopper("P")
     assert im.mode == "P"
     converted_im = im.convert()
@@ -62,18 +64,18 @@ def test_default():
 # ref https://github.com/python-pillow/Pillow/issues/274
 
 
-def _test_float_conversion(im):
+def _test_float_conversion(im: Image.Image) -> None:
     orig = im.getpixel((5, 5))
     converted = im.convert("F").getpixel((5, 5))
     assert orig == converted
 
 
-def test_8bit():
+def test_8bit() -> None:
     with Image.open("Tests/images/hopper.jpg") as im:
         _test_float_conversion(im.convert("L"))
 
 
-def test_16bit():
+def test_16bit() -> None:
     with Image.open("Tests/images/16bit.cropped.tif") as im:
         _test_float_conversion(im)
 
@@ -83,19 +85,19 @@ def test_16bit():
         assert im_i16.getpixel((0, 0)) == 65535
 
 
-def test_16bit_workaround():
+def test_16bit_workaround() -> None:
     with Image.open("Tests/images/16bit.cropped.tif") as im:
         _test_float_conversion(im.convert("I"))
 
 
-def test_opaque():
+def test_opaque() -> None:
     alpha = hopper("P").convert("PA").getchannel("A")
 
     solid = Image.new("L", (128, 128), 255)
     assert_image_equal(alpha, solid)
 
 
-def test_rgba_p():
+def test_rgba_p() -> None:
     im = hopper("RGBA")
     im.putalpha(hopper("L"))
 
@@ -105,14 +107,14 @@ def test_rgba_p():
     assert_image_similar(im, comparable, 20)
 
 
-def test_rgba():
+def test_rgba() -> None:
     with Image.open("Tests/images/transparent.png") as im:
         assert im.mode == "RGBA"
 
         assert_image_similar(im.convert("RGBa").convert("RGB"), im.convert("RGB"), 1.5)
 
 
-def test_trns_p(tmp_path):
+def test_trns_p(tmp_path: Path) -> None:
     im = hopper("P")
     im.info["transparency"] = 0
 
@@ -131,7 +133,7 @@ def test_trns_p(tmp_path):
 
 
 @pytest.mark.parametrize("mode", ("LA", "PA", "RGBA"))
-def test_trns_p_transparency(mode):
+def test_trns_p_transparency(mode: str) -> None:
     # Arrange
     im = hopper("P")
     im.info["transparency"] = 128
@@ -148,7 +150,7 @@ def test_trns_p_transparency(mode):
         assert converted_im.palette is None
 
 
-def test_trns_l(tmp_path):
+def test_trns_l(tmp_path: Path) -> None:
     im = hopper("L")
     im.info["transparency"] = 128
 
@@ -171,7 +173,7 @@ def test_trns_l(tmp_path):
     im_p.save(f)
 
 
-def test_trns_RGB(tmp_path):
+def test_trns_RGB(tmp_path: Path) -> None:
     im = hopper("RGB")
     im.info["transparency"] = im.getpixel((0, 0))
 
@@ -201,7 +203,7 @@ def test_trns_RGB(tmp_path):
 
 
 @pytest.mark.parametrize("convert_mode", ("L", "LA", "I"))
-def test_l_macro_rounding(convert_mode):
+def test_l_macro_rounding(convert_mode: str) -> None:
     for mode in ("P", "PA"):
         im = Image.new(mode, (1, 1))
         im.palette.getcolor((0, 1, 2))
@@ -214,7 +216,7 @@ def test_l_macro_rounding(convert_mode):
         assert converted_color == 1
 
 
-def test_gif_with_rgba_palette_to_p():
+def test_gif_with_rgba_palette_to_p() -> None:
     # See https://github.com/python-pillow/Pillow/issues/2433
     with Image.open("Tests/images/hopper.gif") as im:
         im.info["transparency"] = 255
@@ -226,7 +228,7 @@ def test_gif_with_rgba_palette_to_p():
     im_p.load()
 
 
-def test_p_la():
+def test_p_la() -> None:
     im = hopper("RGBA")
     alpha = hopper("L")
     im.putalpha(alpha)
@@ -236,7 +238,7 @@ def test_p_la():
     assert_image_similar(alpha, comparable, 5)
 
 
-def test_p2pa_alpha():
+def test_p2pa_alpha() -> None:
     with Image.open("Tests/images/tiny.png") as im:
         assert im.mode == "P"
 
@@ -250,13 +252,13 @@ def test_p2pa_alpha():
             assert im_a.getpixel((x, y)) == alpha
 
 
-def test_p2pa_palette():
+def test_p2pa_palette() -> None:
     with Image.open("Tests/images/tiny.png") as im:
         im_pa = im.convert("PA")
     assert im_pa.getpalette() == im.getpalette()
 
 
-def test_matrix_illegal_conversion():
+def test_matrix_illegal_conversion() -> None:
     # Arrange
     im = hopper("CMYK")
     # fmt: off
@@ -272,7 +274,7 @@ def test_matrix_illegal_conversion():
         im.convert(mode="CMYK", matrix=matrix)
 
 
-def test_matrix_wrong_mode():
+def test_matrix_wrong_mode() -> None:
     # Arrange
     im = hopper("L")
     # fmt: off
@@ -289,7 +291,7 @@ def test_matrix_wrong_mode():
 
 
 @pytest.mark.parametrize("mode", ("RGB", "L"))
-def test_matrix_xyz(mode):
+def test_matrix_xyz(mode: str) -> None:
     # Arrange
     im = hopper("RGB")
     im.info["transparency"] = (255, 0, 0)
@@ -317,7 +319,7 @@ def test_matrix_xyz(mode):
             assert converted_im.info["transparency"] == 105
 
 
-def test_matrix_identity():
+def test_matrix_identity() -> None:
     # Arrange
     im = hopper("RGB")
     # fmt: off
diff --git a/Tests/test_image_copy.py b/Tests/test_image_copy.py
index 3a26ef96e74..027e5338b7a 100644
--- a/Tests/test_image_copy.py
+++ b/Tests/test_image_copy.py
@@ -10,7 +10,7 @@
 
 
 @pytest.mark.parametrize("mode", ("1", "P", "L", "RGB", "I", "F"))
-def test_copy(mode):
+def test_copy(mode: str) -> None:
     cropped_coordinates = (10, 10, 20, 20)
     cropped_size = (10, 10)
 
@@ -39,7 +39,7 @@ def test_copy(mode):
     assert out.size == cropped_size
 
 
-def test_copy_zero():
+def test_copy_zero() -> None:
     im = Image.new("RGB", (0, 0))
     out = im.copy()
     assert out.mode == im.mode
@@ -47,7 +47,7 @@ def test_copy_zero():
 
 
 @skip_unless_feature("libtiff")
-def test_deepcopy():
+def test_deepcopy() -> None:
     with Image.open("Tests/images/g4_orientation_5.tif") as im:
         out = copy.deepcopy(im)
     assert out.size == (590, 88)
diff --git a/Tests/test_image_crop.py b/Tests/test_image_crop.py
index 5e02a3b0dfc..d095364ba75 100644
--- a/Tests/test_image_crop.py
+++ b/Tests/test_image_crop.py
@@ -8,7 +8,7 @@
 
 
 @pytest.mark.parametrize("mode", ("1", "P", "L", "RGB", "I", "F"))
-def test_crop(mode):
+def test_crop(mode: str) -> None:
     im = hopper(mode)
     assert_image_equal(im.crop(), im)
 
@@ -17,8 +17,8 @@ def test_crop(mode):
     assert cropped.size == (50, 50)
 
 
-def test_wide_crop():
-    def crop(*bbox):
+def test_wide_crop() -> None:
+    def crop(*bbox: int) -> tuple[int, ...]:
         i = im.crop(bbox)
         h = i.histogram()
         while h and not h[-1]:
@@ -47,14 +47,14 @@ def crop(*bbox):
 
 
 @pytest.mark.parametrize("box", ((8, 2, 2, 8), (2, 8, 8, 2), (8, 8, 2, 2)))
-def test_negative_crop(box):
+def test_negative_crop(box: tuple[int, int, int, int]) -> None:
     im = Image.new("RGB", (10, 10))
 
     with pytest.raises(ValueError):
         im.crop(box)
 
 
-def test_crop_float():
+def test_crop_float() -> None:
     # Check cropping floats are rounded to nearest integer
     # https://github.com/python-pillow/Pillow/issues/1744
 
@@ -69,7 +69,7 @@ def test_crop_float():
     assert cropped.size == (3, 5)
 
 
-def test_crop_crash():
+def test_crop_crash() -> None:
     # Image.crop crashes prepatch with an access violation
     # apparently a use after free on Windows, see
     # https://github.com/python-pillow/Pillow/issues/1077
@@ -87,7 +87,7 @@ def test_crop_crash():
     img.load()
 
 
-def test_crop_zero():
+def test_crop_zero() -> None:
     im = Image.new("RGB", (0, 0), "white")
 
     cropped = im.crop((0, 0, 0, 0))
diff --git a/Tests/test_image_frombytes.py b/Tests/test_image_frombytes.py
index 5d5e9f2dfc9..6474daba108 100644
--- a/Tests/test_image_frombytes.py
+++ b/Tests/test_image_frombytes.py
@@ -8,7 +8,7 @@
 
 
 @pytest.mark.parametrize("data_type", ("bytes", "memoryview"))
-def test_sanity(data_type):
+def test_sanity(data_type) -> None:
     im1 = hopper()
 
     data = im1.tobytes()
diff --git a/Tests/test_image_fromqimage.py b/Tests/test_image_fromqimage.py
index 76b576da56b..ea31a9de913 100644
--- a/Tests/test_image_fromqimage.py
+++ b/Tests/test_image_fromqimage.py
@@ -1,6 +1,7 @@
 from __future__ import annotations
 
 import warnings
+from typing import Generator
 
 import pytest
 
@@ -18,7 +19,7 @@
 
 
 @pytest.fixture
-def test_images():
+def test_images() -> Generator[Image.Image, None, None]:
     ims = [
         hopper(),
         Image.open("Tests/images/transparent.png"),
@@ -31,7 +32,7 @@ def test_images():
             im.close()
 
 
-def roundtrip(expected):
+def roundtrip(expected: Image.Image) -> None:
     # PIL -> Qt
     intermediate = expected.toqimage()
     # Qt -> PIL
@@ -43,26 +44,26 @@ def roundtrip(expected):
         assert_image_equal(result, expected.convert("RGB"))
 
 
-def test_sanity_1(test_images):
+def test_sanity_1(test_images: Generator[Image.Image, None, None]) -> None:
     for im in test_images:
         roundtrip(im.convert("1"))
 
 
-def test_sanity_rgb(test_images):
+def test_sanity_rgb(test_images: Generator[Image.Image, None, None]) -> None:
     for im in test_images:
         roundtrip(im.convert("RGB"))
 
 
-def test_sanity_rgba(test_images):
+def test_sanity_rgba(test_images: Generator[Image.Image, None, None]) -> None:
     for im in test_images:
         roundtrip(im.convert("RGBA"))
 
 
-def test_sanity_l(test_images):
+def test_sanity_l(test_images: Generator[Image.Image, None, None]) -> None:
     for im in test_images:
         roundtrip(im.convert("L"))
 
 
-def test_sanity_p(test_images):
+def test_sanity_p(test_images: Generator[Image.Image, None, None]) -> None:
     for im in test_images:
         roundtrip(im.convert("P"))
diff --git a/Tests/test_image_getbands.py b/Tests/test_image_getbands.py
index 64339e2cd85..887553fc042 100644
--- a/Tests/test_image_getbands.py
+++ b/Tests/test_image_getbands.py
@@ -3,7 +3,7 @@
 from PIL import Image
 
 
-def test_getbands():
+def test_getbands() -> None:
     assert Image.new("1", (1, 1)).getbands() == ("1",)
     assert Image.new("L", (1, 1)).getbands() == ("L",)
     assert Image.new("I", (1, 1)).getbands() == ("I",)
diff --git a/Tests/test_image_getbbox.py b/Tests/test_image_getbbox.py
index b18a7202e38..18c6f657925 100644
--- a/Tests/test_image_getbbox.py
+++ b/Tests/test_image_getbbox.py
@@ -7,13 +7,13 @@
 from .helper import hopper
 
 
-def test_sanity():
+def test_sanity() -> None:
     bbox = hopper().getbbox()
     assert isinstance(bbox, tuple)
 
 
-def test_bbox():
-    def check(im, fill_color):
+def test_bbox() -> None:
+    def check(im: Image.Image, fill_color: int | tuple[int, ...]) -> None:
         assert im.getbbox() is None
 
         im.paste(fill_color, (10, 25, 90, 75))
@@ -34,8 +34,8 @@ def check(im, fill_color):
     check(im, 255)
 
     for mode in ("RGBA", "RGBa"):
-        for color in ((0, 0, 0, 0), (127, 127, 127, 0), (255, 255, 255, 0)):
-            im = Image.new(mode, (100, 100), color)
+        for rgba_color in ((0, 0, 0, 0), (127, 127, 127, 0), (255, 255, 255, 0)):
+            im = Image.new(mode, (100, 100), rgba_color)
             check(im, (255, 255, 255, 255))
 
     for mode in ("La", "LA", "PA"):
@@ -45,7 +45,7 @@ def check(im, fill_color):
 
 
 @pytest.mark.parametrize("mode", ("RGBA", "RGBa", "La", "LA", "PA"))
-def test_bbox_alpha_only_false(mode):
+def test_bbox_alpha_only_false(mode: str) -> None:
     im = Image.new(mode, (100, 100))
     assert im.getbbox(alpha_only=False) is None
 
diff --git a/Tests/test_image_getcolors.py b/Tests/test_image_getcolors.py
index 17460fa93f5..8f8870f4fec 100644
--- a/Tests/test_image_getcolors.py
+++ b/Tests/test_image_getcolors.py
@@ -3,8 +3,8 @@
 from .helper import hopper
 
 
-def test_getcolors():
-    def getcolors(mode, limit=None):
+def test_getcolors() -> None:
+    def getcolors(mode: str, limit: int | None = None) -> int | None:
         im = hopper(mode)
         if limit:
             colors = im.getcolors(limit)
@@ -39,7 +39,7 @@ def getcolors(mode, limit=None):
 # --------------------------------------------------------------------
 
 
-def test_pack():
+def test_pack() -> None:
     # Pack problems for small tables (@PIL209)
 
     im = hopper().quantize(3).convert("RGB")
diff --git a/Tests/test_image_getdata.py b/Tests/test_image_getdata.py
index ace64279b8c..ac27400be94 100644
--- a/Tests/test_image_getdata.py
+++ b/Tests/test_image_getdata.py
@@ -5,7 +5,7 @@
 from .helper import hopper
 
 
-def test_sanity():
+def test_sanity() -> None:
     data = hopper().getdata()
 
     len(data)
@@ -14,8 +14,8 @@ def test_sanity():
     assert data[0] == (20, 20, 70)
 
 
-def test_roundtrip():
-    def getdata(mode):
+def test_roundtrip() -> None:
+    def getdata(mode: str) -> tuple[float | tuple[int, ...], int, int]:
         im = hopper(mode).resize((32, 30), Image.Resampling.NEAREST)
         data = im.getdata()
         return data[0], len(data), len(list(data))
diff --git a/Tests/test_image_getim.py b/Tests/test_image_getim.py
index bc8a7485eb0..9afa02b0a8b 100644
--- a/Tests/test_image_getim.py
+++ b/Tests/test_image_getim.py
@@ -3,7 +3,7 @@
 from .helper import hopper
 
 
-def test_sanity():
+def test_sanity() -> None:
     im = hopper()
     type_repr = repr(type(im.getim()))
 
diff --git a/Tests/test_image_getprojection.py b/Tests/test_image_getprojection.py
index e90f5f5056f..2b5a758ed29 100644
--- a/Tests/test_image_getprojection.py
+++ b/Tests/test_image_getprojection.py
@@ -5,7 +5,7 @@
 from .helper import hopper
 
 
-def test_sanity():
+def test_sanity() -> None:
     im = hopper()
 
     projection = im.getprojection()
diff --git a/Tests/test_image_histogram.py b/Tests/test_image_histogram.py
index 3ac6649e074..dbd55d4c2d3 100644
--- a/Tests/test_image_histogram.py
+++ b/Tests/test_image_histogram.py
@@ -3,8 +3,8 @@
 from .helper import hopper
 
 
-def test_histogram():
-    def histogram(mode):
+def test_histogram() -> None:
+    def histogram(mode: str) -> tuple[int, int, int]:
         h = hopper(mode).histogram()
         return len(h), min(h), max(h)
 
diff --git a/Tests/test_image_point.py b/Tests/test_image_point.py
index 2232b94429d..05f209351d2 100644
--- a/Tests/test_image_point.py
+++ b/Tests/test_image_point.py
@@ -5,7 +5,7 @@
 from .helper import assert_image_equal, hopper
 
 
-def test_sanity():
+def test_sanity() -> None:
     im = hopper()
 
     with pytest.raises(ValueError):
@@ -39,7 +39,7 @@ def test_sanity():
         im.point(lambda x: x // 2)
 
 
-def test_16bit_lut():
+def test_16bit_lut() -> None:
     """Tests for 16 bit -> 8 bit lut for converting I->L images
     see https://github.com/python-pillow/Pillow/issues/440
     """
@@ -47,7 +47,7 @@ def test_16bit_lut():
     im.point(list(range(256)) * 256, "L")
 
 
-def test_f_lut():
+def test_f_lut() -> None:
     """Tests for floating point lut of 8bit gray image"""
     im = hopper("L")
     lut = [0.5 * float(x) for x in range(256)]
@@ -58,7 +58,7 @@ def test_f_lut():
     assert_image_equal(out.convert("L"), im.point(int_lut, "L"))
 
 
-def test_f_mode():
+def test_f_mode() -> None:
     im = hopper("F")
     with pytest.raises(ValueError):
         im.point(None)
diff --git a/Tests/test_image_putalpha.py b/Tests/test_image_putalpha.py
index c44b048d523..2c92911d1fb 100644
--- a/Tests/test_image_putalpha.py
+++ b/Tests/test_image_putalpha.py
@@ -3,7 +3,7 @@
 from PIL import Image
 
 
-def test_interface():
+def test_interface() -> None:
     im = Image.new("RGBA", (1, 1), (1, 2, 3, 0))
     assert im.getpixel((0, 0)) == (1, 2, 3, 0)
 
@@ -17,7 +17,7 @@ def test_interface():
     assert im.getpixel((0, 0)) == (1, 2, 3, 5)
 
 
-def test_promote():
+def test_promote() -> None:
     im = Image.new("L", (1, 1), 1)
     assert im.getpixel((0, 0)) == 1
 
@@ -40,7 +40,7 @@ def test_promote():
     assert im.getpixel((0, 0)) == (1, 2, 3, 4)
 
 
-def test_readonly():
+def test_readonly() -> None:
     im = Image.new("RGB", (1, 1), (1, 2, 3))
     im.readonly = 1
 
diff --git a/Tests/test_image_quantize.py b/Tests/test_image_quantize.py
index 1475b027bd8..873a9bb5dcb 100644
--- a/Tests/test_image_quantize.py
+++ b/Tests/test_image_quantize.py
@@ -8,7 +8,7 @@
 from .helper import assert_image_similar, hopper, is_ppc64le, skip_unless_feature
 
 
-def test_sanity():
+def test_sanity() -> None:
     image = hopper()
     converted = image.quantize()
     assert converted.mode == "P"
@@ -21,7 +21,7 @@ def test_sanity():
 
 
 @skip_unless_feature("libimagequant")
-def test_libimagequant_quantize():
+def test_libimagequant_quantize() -> None:
     image = hopper()
     if is_ppc64le():
         libimagequant = parse_version(features.version_feature("libimagequant"))
@@ -33,7 +33,7 @@ def test_libimagequant_quantize():
     assert len(converted.getcolors()) == 100
 
 
-def test_octree_quantize():
+def test_octree_quantize() -> None:
     image = hopper()
     converted = image.quantize(100, Image.Quantize.FASTOCTREE)
     assert converted.mode == "P"
@@ -41,7 +41,7 @@ def test_octree_quantize():
     assert len(converted.getcolors()) == 100
 
 
-def test_rgba_quantize():
+def test_rgba_quantize() -> None:
     image = hopper("RGBA")
     with pytest.raises(ValueError):
         image.quantize(method=0)
@@ -49,7 +49,7 @@ def test_rgba_quantize():
     assert image.quantize().convert().mode == "RGBA"
 
 
-def test_quantize():
+def test_quantize() -> None:
     with Image.open("Tests/images/caption_6_33_22.png") as image:
         image = image.convert("RGB")
     converted = image.quantize()
@@ -57,7 +57,7 @@ def test_quantize():
     assert_image_similar(converted.convert("RGB"), image, 1)
 
 
-def test_quantize_no_dither():
+def test_quantize_no_dither() -> None:
     image = hopper()
     with Image.open("Tests/images/caption_6_33_22.png") as palette:
         palette = palette.convert("P")
@@ -67,7 +67,7 @@ def test_quantize_no_dither():
     assert converted.palette.palette == palette.palette.palette
 
 
-def test_quantize_no_dither2():
+def test_quantize_no_dither2() -> None:
     im = Image.new("RGB", (9, 1))
     im.putdata([(p,) * 3 for p in range(0, 36, 4)])
 
@@ -83,7 +83,7 @@ def test_quantize_no_dither2():
         assert px[x, 0] == (0 if x < 5 else 1)
 
 
-def test_quantize_dither_diff():
+def test_quantize_dither_diff() -> None:
     image = hopper()
     with Image.open("Tests/images/caption_6_33_22.png") as palette:
         palette = palette.convert("P")
@@ -94,14 +94,14 @@ def test_quantize_dither_diff():
     assert dither.tobytes() != nodither.tobytes()
 
 
-def test_colors():
+def test_colors() -> None:
     im = hopper()
     colors = 2
     converted = im.quantize(colors)
     assert len(converted.palette.palette) == colors * len("RGB")
 
 
-def test_transparent_colors_equal():
+def test_transparent_colors_equal() -> None:
     im = Image.new("RGBA", (1, 2), (0, 0, 0, 0))
     px = im.load()
     px[0, 1] = (255, 255, 255, 0)
@@ -120,7 +120,7 @@ def test_transparent_colors_equal():
         (Image.Quantize.FASTOCTREE, (0, 0, 0, 0)),
     ),
 )
-def test_palette(method, color):
+def test_palette(method: Image.Quantize, color: tuple[int, ...]) -> None:
     im = Image.new("RGBA" if len(color) == 4 else "RGB", (1, 1), color)
 
     converted = im.quantize(method=method)
@@ -128,7 +128,7 @@ def test_palette(method, color):
     assert converted_px[0, 0] == converted.palette.colors[color]
 
 
-def test_small_palette():
+def test_small_palette() -> None:
     # Arrange
     im = hopper()
 
diff --git a/Tests/test_image_resize.py b/Tests/test_image_resize.py
index aedcf4a09b5..bd45ee893ad 100644
--- a/Tests/test_image_resize.py
+++ b/Tests/test_image_resize.py
@@ -4,6 +4,8 @@
 from __future__ import annotations
 
 from itertools import permutations
+from pathlib import Path
+from typing import Generator
 
 import pytest
 
@@ -19,7 +21,9 @@
 
 
 class TestImagingCoreResize:
-    def resize(self, im, size, f):
+    def resize(
+        self, im: Image.Image, size: tuple[int, int], f: Image.Resampling
+    ) -> Image.Image:
         # Image class independent version of resize.
         im.load()
         return im._new(im.im.resize(size, f))
@@ -27,14 +31,14 @@ def resize(self, im, size, f):
     @pytest.mark.parametrize(
         "mode", ("1", "P", "L", "I", "F", "RGB", "RGBA", "CMYK", "YCbCr", "I;16")
     )
-    def test_nearest_mode(self, mode):
+    def test_nearest_mode(self, mode: str) -> None:
         im = hopper(mode)
         r = self.resize(im, (15, 12), Image.Resampling.NEAREST)
         assert r.mode == mode
         assert r.size == (15, 12)
         assert r.im.bands == im.im.bands
 
-    def test_convolution_modes(self):
+    def test_convolution_modes(self) -> None:
         with pytest.raises(ValueError):
             self.resize(hopper("1"), (15, 12), Image.Resampling.BILINEAR)
         with pytest.raises(ValueError):
@@ -59,7 +63,7 @@ def test_convolution_modes(self):
             Image.Resampling.LANCZOS,
         ),
     )
-    def test_reduce_filters(self, resample):
+    def test_reduce_filters(self, resample: Image.Resampling) -> None:
         r = self.resize(hopper("RGB"), (15, 12), resample)
         assert r.mode == "RGB"
         assert r.size == (15, 12)
@@ -75,7 +79,7 @@ def test_reduce_filters(self, resample):
             Image.Resampling.LANCZOS,
         ),
     )
-    def test_enlarge_filters(self, resample):
+    def test_enlarge_filters(self, resample: Image.Resampling) -> None:
         r = self.resize(hopper("RGB"), (212, 195), resample)
         assert r.mode == "RGB"
         assert r.size == (212, 195)
@@ -99,7 +103,9 @@ def test_enlarge_filters(self, resample):
             ("LA", ("filled", "dirty")),
         ),
     )
-    def test_endianness(self, resample, mode, channels_set):
+    def test_endianness(
+        self, resample: Image.Resampling, mode: str, channels_set: tuple[str, ...]
+    ) -> None:
         # Make an image with one colored pixel, in one channel.
         # When resized, that channel should be the same as a GS image.
         # Other channels should be unaffected.
@@ -139,17 +145,17 @@ def test_endianness(self, resample, mode, channels_set):
             Image.Resampling.LANCZOS,
         ),
     )
-    def test_enlarge_zero(self, resample):
+    def test_enlarge_zero(self, resample: Image.Resampling) -> None:
         r = self.resize(Image.new("RGB", (0, 0), "white"), (212, 195), resample)
         assert r.mode == "RGB"
         assert r.size == (212, 195)
         assert r.getdata()[0] == (0, 0, 0)
 
-    def test_unknown_filter(self):
+    def test_unknown_filter(self) -> None:
         with pytest.raises(ValueError):
             self.resize(hopper(), (10, 10), 9)
 
-    def test_cross_platform(self, tmp_path):
+    def test_cross_platform(self, tmp_path: Path) -> None:
         # This test is intended for only check for consistent behaviour across
         # platforms. So if a future Pillow change requires that the test file
         # be updated, that is okay.
@@ -162,7 +168,7 @@ def test_cross_platform(self, tmp_path):
 
 
 @pytest.fixture
-def gradients_image():
+def gradients_image() -> Generator[Image.Image, None, None]:
     with Image.open("Tests/images/radial_gradients.png") as im:
         im.load()
     try:
@@ -172,7 +178,7 @@ def gradients_image():
 
 
 class TestReducingGapResize:
-    def test_reducing_gap_values(self, gradients_image):
+    def test_reducing_gap_values(self, gradients_image: Image.Image) -> None:
         ref = gradients_image.resize(
             (52, 34), Image.Resampling.BICUBIC, reducing_gap=None
         )
@@ -191,7 +197,12 @@ def test_reducing_gap_values(self, gradients_image):
         "box, epsilon",
         ((None, 4), ((1.1, 2.2, 510.8, 510.9), 4), ((3, 10, 410, 256), 10)),
     )
-    def test_reducing_gap_1(self, gradients_image, box, epsilon):
+    def test_reducing_gap_1(
+        self,
+        gradients_image: Image.Image,
+        box: tuple[float, float, float, float],
+        epsilon: float,
+    ) -> None:
         ref = gradients_image.resize((52, 34), Image.Resampling.BICUBIC, box=box)
         im = gradients_image.resize(
             (52, 34), Image.Resampling.BICUBIC, box=box, reducing_gap=1.0
@@ -206,7 +217,12 @@ def test_reducing_gap_1(self, gradients_image, box, epsilon):
         "box, epsilon",
         ((None, 1.5), ((1.1, 2.2, 510.8, 510.9), 1.5), ((3, 10, 410, 256), 1)),
     )
-    def test_reducing_gap_2(self, gradients_image, box, epsilon):
+    def test_reducing_gap_2(
+        self,
+        gradients_image: Image.Image,
+        box: tuple[float, float, float, float],
+        epsilon: float,
+    ) -> None:
         ref = gradients_image.resize((52, 34), Image.Resampling.BICUBIC, box=box)
         im = gradients_image.resize(
             (52, 34), Image.Resampling.BICUBIC, box=box, reducing_gap=2.0
@@ -221,7 +237,12 @@ def test_reducing_gap_2(self, gradients_image, box, epsilon):
         "box, epsilon",
         ((None, 1), ((1.1, 2.2, 510.8, 510.9), 1), ((3, 10, 410, 256), 0.5)),
     )
-    def test_reducing_gap_3(self, gradients_image, box, epsilon):
+    def test_reducing_gap_3(
+        self,
+        gradients_image: Image.Image,
+        box: tuple[float, float, float, float],
+        epsilon: float,
+    ) -> None:
         ref = gradients_image.resize((52, 34), Image.Resampling.BICUBIC, box=box)
         im = gradients_image.resize(
             (52, 34), Image.Resampling.BICUBIC, box=box, reducing_gap=3.0
@@ -233,7 +254,9 @@ def test_reducing_gap_3(self, gradients_image, box, epsilon):
         assert_image_similar(ref, im, epsilon)
 
     @pytest.mark.parametrize("box", (None, (1.1, 2.2, 510.8, 510.9), (3, 10, 410, 256)))
-    def test_reducing_gap_8(self, gradients_image, box):
+    def test_reducing_gap_8(
+        self, gradients_image: Image.Image, box: tuple[float, float, float, float]
+    ) -> None:
         ref = gradients_image.resize((52, 34), Image.Resampling.BICUBIC, box=box)
         im = gradients_image.resize(
             (52, 34), Image.Resampling.BICUBIC, box=box, reducing_gap=8.0
@@ -245,7 +268,12 @@ def test_reducing_gap_8(self, gradients_image, box):
         "box, epsilon",
         (((0, 0, 512, 512), 5.5), ((0.9, 1.7, 128, 128), 9.5)),
     )
-    def test_box_filter(self, gradients_image, box, epsilon):
+    def test_box_filter(
+        self,
+        gradients_image: Image.Image,
+        box: tuple[float, float, float, float],
+        epsilon: float,
+    ) -> None:
         ref = gradients_image.resize((52, 34), Image.Resampling.BOX, box=box)
         im = gradients_image.resize(
             (52, 34), Image.Resampling.BOX, box=box, reducing_gap=1.0
@@ -255,8 +283,8 @@ def test_box_filter(self, gradients_image, box, epsilon):
 
 
 class TestImageResize:
-    def test_resize(self):
-        def resize(mode, size):
+    def test_resize(self) -> None:
+        def resize(mode: str, size: tuple[int, int]) -> None:
             out = hopper(mode).resize(size)
             assert out.mode == mode
             assert out.size == size
@@ -271,7 +299,7 @@ def resize(mode, size):
                 im.resize((10, 10), "unknown")
 
     @skip_unless_feature("libtiff")
-    def test_load_first(self):
+    def test_load_first(self) -> None:
         # load() may change the size of the image
         # Test that resize() is calling it before getting the size
         with Image.open("Tests/images/g4_orientation_5.tif") as im:
@@ -279,13 +307,13 @@ def test_load_first(self):
             assert im.size == (64, 64)
 
     @pytest.mark.parametrize("mode", ("L", "RGB", "I", "F"))
-    def test_default_filter_bicubic(self, mode):
+    def test_default_filter_bicubic(self, mode: str) -> None:
         im = hopper(mode)
         assert im.resize((20, 20), Image.Resampling.BICUBIC) == im.resize((20, 20))
 
     @pytest.mark.parametrize(
         "mode", ("1", "P", "I;16", "I;16L", "I;16B", "BGR;15", "BGR;16")
     )
-    def test_default_filter_nearest(self, mode):
+    def test_default_filter_nearest(self, mode: str) -> None:
         im = hopper(mode)
         assert im.resize((20, 20), Image.Resampling.NEAREST) == im.resize((20, 20))
diff --git a/Tests/test_image_split.py b/Tests/test_image_split.py
index c39a100e777..3385f81f527 100644
--- a/Tests/test_image_split.py
+++ b/Tests/test_image_split.py
@@ -1,5 +1,7 @@
 from __future__ import annotations
 
+from pathlib import Path
+
 import pytest
 
 from PIL import Image, features
@@ -7,8 +9,8 @@
 from .helper import assert_image_equal, hopper
 
 
-def test_split():
-    def split(mode):
+def test_split() -> None:
+    def split(mode: str) -> list[tuple[str, int, int]]:
         layers = hopper(mode).split()
         return [(i.mode, i.size[0], i.size[1]) for i in layers]
 
@@ -36,18 +38,18 @@ def split(mode):
 @pytest.mark.parametrize(
     "mode", ("1", "L", "I", "F", "P", "RGB", "RGBA", "CMYK", "YCbCr")
 )
-def test_split_merge(mode):
+def test_split_merge(mode: str) -> None:
     expected = Image.merge(mode, hopper(mode).split())
     assert_image_equal(hopper(mode), expected)
 
 
-def test_split_open(tmp_path):
+def test_split_open(tmp_path: Path) -> None:
     if features.check("zlib"):
         test_file = str(tmp_path / "temp.png")
     else:
         test_file = str(tmp_path / "temp.pcx")
 
-    def split_open(mode):
+    def split_open(mode: str) -> int:
         hopper(mode).save(test_file)
         with Image.open(test_file) as im:
             return len(im.split())
diff --git a/Tests/test_image_tobitmap.py b/Tests/test_image_tobitmap.py
index 89a41cf8ec2..f7a3cc41d90 100644
--- a/Tests/test_image_tobitmap.py
+++ b/Tests/test_image_tobitmap.py
@@ -5,7 +5,7 @@
 from .helper import assert_image_equal, fromstring, hopper
 
 
-def test_sanity():
+def test_sanity() -> None:
     with pytest.raises(ValueError):
         hopper().tobitmap()
 
diff --git a/Tests/test_image_tobytes.py b/Tests/test_image_tobytes.py
index 8f15adac065..d32b6c09ba0 100644
--- a/Tests/test_image_tobytes.py
+++ b/Tests/test_image_tobytes.py
@@ -3,6 +3,6 @@
 from .helper import hopper
 
 
-def test_sanity():
+def test_sanity() -> None:
     data = hopper().tobytes()
     assert isinstance(data, bytes)
diff --git a/Tests/test_image_transpose.py b/Tests/test_image_transpose.py
index 01bf5a83918..d384d81414a 100644
--- a/Tests/test_image_transpose.py
+++ b/Tests/test_image_transpose.py
@@ -2,6 +2,7 @@
 
 import pytest
 
+from PIL import Image
 from PIL.Image import Transpose
 
 from . import helper
@@ -14,7 +15,7 @@
 
 
 @pytest.mark.parametrize("mode", HOPPER)
-def test_flip_left_right(mode):
+def test_flip_left_right(mode: str) -> None:
     im = HOPPER[mode]
     out = im.transpose(Transpose.FLIP_LEFT_RIGHT)
     assert out.mode == mode
@@ -28,7 +29,7 @@ def test_flip_left_right(mode):
 
 
 @pytest.mark.parametrize("mode", HOPPER)
-def test_flip_top_bottom(mode):
+def test_flip_top_bottom(mode: str) -> None:
     im = HOPPER[mode]
     out = im.transpose(Transpose.FLIP_TOP_BOTTOM)
     assert out.mode == mode
@@ -42,7 +43,7 @@ def test_flip_top_bottom(mode):
 
 
 @pytest.mark.parametrize("mode", HOPPER)
-def test_rotate_90(mode):
+def test_rotate_90(mode: str) -> None:
     im = HOPPER[mode]
     out = im.transpose(Transpose.ROTATE_90)
     assert out.mode == mode
@@ -56,7 +57,7 @@ def test_rotate_90(mode):
 
 
 @pytest.mark.parametrize("mode", HOPPER)
-def test_rotate_180(mode):
+def test_rotate_180(mode: str) -> None:
     im = HOPPER[mode]
     out = im.transpose(Transpose.ROTATE_180)
     assert out.mode == mode
@@ -70,7 +71,7 @@ def test_rotate_180(mode):
 
 
 @pytest.mark.parametrize("mode", HOPPER)
-def test_rotate_270(mode):
+def test_rotate_270(mode: str) -> None:
     im = HOPPER[mode]
     out = im.transpose(Transpose.ROTATE_270)
     assert out.mode == mode
@@ -84,7 +85,7 @@ def test_rotate_270(mode):
 
 
 @pytest.mark.parametrize("mode", HOPPER)
-def test_transpose(mode):
+def test_transpose(mode: str) -> None:
     im = HOPPER[mode]
     out = im.transpose(Transpose.TRANSPOSE)
     assert out.mode == mode
@@ -98,7 +99,7 @@ def test_transpose(mode):
 
 
 @pytest.mark.parametrize("mode", HOPPER)
-def test_tranverse(mode):
+def test_tranverse(mode: str) -> None:
     im = HOPPER[mode]
     out = im.transpose(Transpose.TRANSVERSE)
     assert out.mode == mode
@@ -112,10 +113,10 @@ def test_tranverse(mode):
 
 
 @pytest.mark.parametrize("mode", HOPPER)
-def test_roundtrip(mode):
+def test_roundtrip(mode: str) -> None:
     im = HOPPER[mode]
 
-    def transpose(first, second):
+    def transpose(first: Transpose, second: Transpose) -> Image.Image:
         return im.transpose(first).transpose(second)
 
     assert_image_equal(

From 945253672a74415807b5f685f54ebb1533ff468e Mon Sep 17 00:00:00 2001
From: Hugo van Kemenade <1324225+hugovk@users.noreply.github.com>
Date: Fri, 26 Jan 2024 19:11:18 +0200
Subject: [PATCH 0123/1178] Handle os.PathLike in is_path

---
 src/PIL/ImageFont.py | 2 +-
 src/PIL/_util.py     | 2 +-
 2 files changed, 2 insertions(+), 2 deletions(-)

diff --git a/src/PIL/ImageFont.py b/src/PIL/ImageFont.py
index a63b73b33f5..9eecad1ca3a 100644
--- a/src/PIL/ImageFont.py
+++ b/src/PIL/ImageFont.py
@@ -230,7 +230,7 @@ def load_from_bytes(f):
             )
 
         if is_path(font):
-            if isinstance(font, Path):
+            if isinstance(font, os.PathLike):
                 font = str(font)
             if sys.platform == "win32":
                 font_bytes_path = font if isinstance(font, bytes) else font.encode()
diff --git a/src/PIL/_util.py b/src/PIL/_util.py
index 4ecdc4bd307..b649500abb5 100644
--- a/src/PIL/_util.py
+++ b/src/PIL/_util.py
@@ -8,7 +8,7 @@
 
 
 def is_path(f: Any) -> TypeGuard[StrOrBytesPath]:
-    return isinstance(f, (bytes, str, Path))
+    return isinstance(f, (bytes, str, os.PathLike))
 
 
 def is_directory(f: Any) -> TypeGuard[bytes | str | Path]:

From f613a9213f4edc7b58ac84a4793223c8e4fd9191 Mon Sep 17 00:00:00 2001
From: Hugo van Kemenade <1324225+hugovk@users.noreply.github.com>
Date: Fri, 26 Jan 2024 19:15:19 +0200
Subject: [PATCH 0124/1178] Parameterise test

---
 Tests/test_util.py | 21 ++++-----------------
 1 file changed, 4 insertions(+), 17 deletions(-)

diff --git a/Tests/test_util.py b/Tests/test_util.py
index 3395ef753d7..71a862569b7 100644
--- a/Tests/test_util.py
+++ b/Tests/test_util.py
@@ -1,27 +1,14 @@
 from __future__ import annotations
 
+from pathlib import Path
+
 import pytest
 
 from PIL import _util
 
 
-def test_is_path():
-    # Arrange
-    fp = "filename.ext"
-
-    # Act
-    it_is = _util.is_path(fp)
-
-    # Assert
-    assert it_is
-
-
-def test_path_obj_is_path():
-    # Arrange
-    from pathlib import Path
-
-    test_path = Path("filename.ext")
-
+@pytest.mark.parametrize("test_path", ["filename.ext", Path("filename.ext")])
+def test_is_path(test_path):
     # Act
     it_is = _util.is_path(test_path)
 

From 16d4068b42f0a6069e14b2327302df713dabbfed Mon Sep 17 00:00:00 2001
From: Hugo van Kemenade <1324225+hugovk@users.noreply.github.com>
Date: Fri, 26 Jan 2024 19:17:13 +0200
Subject: [PATCH 0125/1178] Test os.PathLike that's not pathlib.Path

---
 Tests/test_util.py | 6 ++++--
 1 file changed, 4 insertions(+), 2 deletions(-)

diff --git a/Tests/test_util.py b/Tests/test_util.py
index 71a862569b7..617e5f7c6da 100644
--- a/Tests/test_util.py
+++ b/Tests/test_util.py
@@ -1,13 +1,15 @@
 from __future__ import annotations
 
-from pathlib import Path
+from pathlib import Path, PurePath
 
 import pytest
 
 from PIL import _util
 
 
-@pytest.mark.parametrize("test_path", ["filename.ext", Path("filename.ext")])
+@pytest.mark.parametrize(
+    "test_path", ["filename.ext", Path("filename.ext"), PurePath("filename.ext")]
+)
 def test_is_path(test_path):
     # Act
     it_is = _util.is_path(test_path)

From d631afc266c3c1214e12373d3ad0d16978867a7f Mon Sep 17 00:00:00 2001
From: Hugo van Kemenade <1324225+hugovk@users.noreply.github.com>
Date: Fri, 26 Jan 2024 20:46:58 +0200
Subject: [PATCH 0126/1178] Use os.fspath instead of isinstance and str

---
 src/PIL/ImageFont.py | 3 +--
 1 file changed, 1 insertion(+), 2 deletions(-)

diff --git a/src/PIL/ImageFont.py b/src/PIL/ImageFont.py
index 9eecad1ca3a..1feaf447a17 100644
--- a/src/PIL/ImageFont.py
+++ b/src/PIL/ImageFont.py
@@ -230,8 +230,7 @@ def load_from_bytes(f):
             )
 
         if is_path(font):
-            if isinstance(font, os.PathLike):
-                font = str(font)
+            font = os.fspath(font)
             if sys.platform == "win32":
                 font_bytes_path = font if isinstance(font, bytes) else font.encode()
                 try:

From 737314923fd1abe8cea2b1986626302215436481 Mon Sep 17 00:00:00 2001
From: Andrew Murray <radarhere@users.noreply.github.com>
Date: Sat, 27 Jan 2024 15:19:43 +1100
Subject: [PATCH 0127/1178] Added type hints

---
 Tests/test_000_sanity.py         |  2 +-
 Tests/test_binary.py             |  6 +++---
 Tests/test_file_cur.py           |  4 ++--
 Tests/test_file_ftex.py          |  6 +++---
 Tests/test_file_gbr.py           |  8 ++++----
 Tests/test_file_gd.py            |  6 +++---
 Tests/test_file_gimppalette.py   |  4 ++--
 Tests/test_file_imt.py           |  4 ++--
 Tests/test_file_mcidas.py        |  4 ++--
 Tests/test_file_pcd.py           |  2 +-
 Tests/test_file_pixar.py         |  4 ++--
 Tests/test_file_qoi.py           |  4 ++--
 Tests/test_file_wal.py           |  4 ++--
 Tests/test_file_webp_lossless.py |  4 +++-
 Tests/test_file_xpm.py           |  6 +++---
 Tests/test_file_xvthumb.py       |  6 +++---
 Tests/test_fontfile.py           |  4 +++-
 Tests/test_format_lab.py         |  6 +++---
 Tests/test_lib_image.py          |  2 +-
 Tests/test_locale.py             |  2 +-
 Tests/test_main.py               |  2 +-
 Tests/test_pyroma.py             |  2 +-
 Tests/test_uploader.py           |  4 ++--
 Tests/test_util.py               | 14 ++++++++------
 Tests/test_webp_leaks.py         |  4 ++--
 25 files changed, 60 insertions(+), 54 deletions(-)

diff --git a/Tests/test_000_sanity.py b/Tests/test_000_sanity.py
index f64216bca8e..c3926250f7b 100644
--- a/Tests/test_000_sanity.py
+++ b/Tests/test_000_sanity.py
@@ -3,7 +3,7 @@
 from PIL import Image
 
 
-def test_sanity():
+def test_sanity() -> None:
     # Make sure we have the binary extension
     Image.core.new("L", (100, 100))
 
diff --git a/Tests/test_binary.py b/Tests/test_binary.py
index 41fb93fcf48..d19799a095c 100644
--- a/Tests/test_binary.py
+++ b/Tests/test_binary.py
@@ -3,12 +3,12 @@
 from PIL import _binary
 
 
-def test_standard():
+def test_standard() -> None:
     assert _binary.i8(b"*") == 42
     assert _binary.o8(42) == b"*"
 
 
-def test_little_endian():
+def test_little_endian() -> None:
     assert _binary.i16le(b"\xff\xff\x00\x00") == 65535
     assert _binary.i32le(b"\xff\xff\x00\x00") == 65535
 
@@ -16,7 +16,7 @@ def test_little_endian():
     assert _binary.o32le(65535) == b"\xff\xff\x00\x00"
 
 
-def test_big_endian():
+def test_big_endian() -> None:
     assert _binary.i16be(b"\x00\x00\xff\xff") == 0
     assert _binary.i32be(b"\x00\x00\xff\xff") == 65535
 
diff --git a/Tests/test_file_cur.py b/Tests/test_file_cur.py
index 27b2bc91489..dbf1b866d7f 100644
--- a/Tests/test_file_cur.py
+++ b/Tests/test_file_cur.py
@@ -7,7 +7,7 @@
 TEST_FILE = "Tests/images/deerstalker.cur"
 
 
-def test_sanity():
+def test_sanity() -> None:
     with Image.open(TEST_FILE) as im:
         assert im.size == (32, 32)
         assert isinstance(im, CurImagePlugin.CurImageFile)
@@ -17,7 +17,7 @@ def test_sanity():
         assert im.getpixel((16, 16)) == (84, 87, 86, 255)
 
 
-def test_invalid_file():
+def test_invalid_file() -> None:
     invalid_file = "Tests/images/flower.jpg"
 
     with pytest.raises(SyntaxError):
diff --git a/Tests/test_file_ftex.py b/Tests/test_file_ftex.py
index 0f9154e3d09..0c544245a9f 100644
--- a/Tests/test_file_ftex.py
+++ b/Tests/test_file_ftex.py
@@ -7,18 +7,18 @@
 from .helper import assert_image_equal_tofile, assert_image_similar
 
 
-def test_load_raw():
+def test_load_raw() -> None:
     with Image.open("Tests/images/ftex_uncompressed.ftu") as im:
         assert_image_equal_tofile(im, "Tests/images/ftex_uncompressed.png")
 
 
-def test_load_dxt1():
+def test_load_dxt1() -> None:
     with Image.open("Tests/images/ftex_dxt1.ftc") as im:
         with Image.open("Tests/images/ftex_dxt1.png") as target:
             assert_image_similar(im, target.convert("RGBA"), 15)
 
 
-def test_invalid_file():
+def test_invalid_file() -> None:
     invalid_file = "Tests/images/flower.jpg"
 
     with pytest.raises(SyntaxError):
diff --git a/Tests/test_file_gbr.py b/Tests/test_file_gbr.py
index d84004e1483..be98b08f2ad 100644
--- a/Tests/test_file_gbr.py
+++ b/Tests/test_file_gbr.py
@@ -7,12 +7,12 @@
 from .helper import assert_image_equal_tofile
 
 
-def test_gbr_file():
+def test_gbr_file() -> None:
     with Image.open("Tests/images/gbr.gbr") as im:
         assert_image_equal_tofile(im, "Tests/images/gbr.png")
 
 
-def test_load():
+def test_load() -> None:
     with Image.open("Tests/images/gbr.gbr") as im:
         assert im.load()[0, 0] == (0, 0, 0, 0)
 
@@ -20,14 +20,14 @@ def test_load():
         assert im.load()[0, 0] == (0, 0, 0, 0)
 
 
-def test_multiple_load_operations():
+def test_multiple_load_operations() -> None:
     with Image.open("Tests/images/gbr.gbr") as im:
         im.load()
         im.load()
         assert_image_equal_tofile(im, "Tests/images/gbr.png")
 
 
-def test_invalid_file():
+def test_invalid_file() -> None:
     invalid_file = "Tests/images/flower.jpg"
 
     with pytest.raises(SyntaxError):
diff --git a/Tests/test_file_gd.py b/Tests/test_file_gd.py
index e7db54fb44c..d512df284e1 100644
--- a/Tests/test_file_gd.py
+++ b/Tests/test_file_gd.py
@@ -7,18 +7,18 @@
 TEST_GD_FILE = "Tests/images/hopper.gd"
 
 
-def test_sanity():
+def test_sanity() -> None:
     with GdImageFile.open(TEST_GD_FILE) as im:
         assert im.size == (128, 128)
         assert im.format == "GD"
 
 
-def test_bad_mode():
+def test_bad_mode() -> None:
     with pytest.raises(ValueError):
         GdImageFile.open(TEST_GD_FILE, "bad mode")
 
 
-def test_invalid_file():
+def test_invalid_file() -> None:
     invalid_file = "Tests/images/flower.jpg"
 
     with pytest.raises(UnidentifiedImageError):
diff --git a/Tests/test_file_gimppalette.py b/Tests/test_file_gimppalette.py
index 28855c28acc..e8d5f170506 100644
--- a/Tests/test_file_gimppalette.py
+++ b/Tests/test_file_gimppalette.py
@@ -5,7 +5,7 @@
 from PIL.GimpPaletteFile import GimpPaletteFile
 
 
-def test_sanity():
+def test_sanity() -> None:
     with open("Tests/images/test.gpl", "rb") as fp:
         GimpPaletteFile(fp)
 
@@ -22,7 +22,7 @@ def test_sanity():
             GimpPaletteFile(fp)
 
 
-def test_get_palette():
+def test_get_palette() -> None:
     # Arrange
     with open("Tests/images/custom_gimp_palette.gpl", "rb") as fp:
         palette_file = GimpPaletteFile(fp)
diff --git a/Tests/test_file_imt.py b/Tests/test_file_imt.py
index aa13d4407bc..6957dfa0ac5 100644
--- a/Tests/test_file_imt.py
+++ b/Tests/test_file_imt.py
@@ -9,13 +9,13 @@
 from .helper import assert_image_equal_tofile
 
 
-def test_sanity():
+def test_sanity() -> None:
     with Image.open("Tests/images/bw_gradient.imt") as im:
         assert_image_equal_tofile(im, "Tests/images/bw_gradient.png")
 
 
 @pytest.mark.parametrize("data", (b"\n", b"\n-", b"width 1\n"))
-def test_invalid_file(data):
+def test_invalid_file(data: bytes) -> None:
     with io.BytesIO(data) as fp:
         with pytest.raises(SyntaxError):
             ImtImagePlugin.ImtImageFile(fp)
diff --git a/Tests/test_file_mcidas.py b/Tests/test_file_mcidas.py
index 73eba5cc861..2c94fdc3911 100644
--- a/Tests/test_file_mcidas.py
+++ b/Tests/test_file_mcidas.py
@@ -7,14 +7,14 @@
 from .helper import assert_image_equal_tofile
 
 
-def test_invalid_file():
+def test_invalid_file() -> None:
     invalid_file = "Tests/images/flower.jpg"
 
     with pytest.raises(SyntaxError):
         McIdasImagePlugin.McIdasImageFile(invalid_file)
 
 
-def test_valid_file():
+def test_valid_file() -> None:
     # Arrange
     # https://ghrc.nsstc.nasa.gov/hydro/details/cmx3g8
     # https://ghrc.nsstc.nasa.gov/pub/fieldCampaigns/camex3/cmx3g8/browse/
diff --git a/Tests/test_file_pcd.py b/Tests/test_file_pcd.py
index 1a37c6ab31d..81a316fc14a 100644
--- a/Tests/test_file_pcd.py
+++ b/Tests/test_file_pcd.py
@@ -3,7 +3,7 @@
 from PIL import Image
 
 
-def test_load_raw():
+def test_load_raw() -> None:
     with Image.open("Tests/images/hopper.pcd") as im:
         im.load()  # should not segfault.
 
diff --git a/Tests/test_file_pixar.py b/Tests/test_file_pixar.py
index c6ddc54e714..8f208cfbf07 100644
--- a/Tests/test_file_pixar.py
+++ b/Tests/test_file_pixar.py
@@ -9,7 +9,7 @@
 TEST_FILE = "Tests/images/hopper.pxr"
 
 
-def test_sanity():
+def test_sanity() -> None:
     with Image.open(TEST_FILE) as im:
         im.load()
         assert im.mode == "RGB"
@@ -21,7 +21,7 @@ def test_sanity():
         assert_image_similar(im, im2, 4.8)
 
 
-def test_invalid_file():
+def test_invalid_file() -> None:
     invalid_file = "Tests/images/flower.jpg"
 
     with pytest.raises(SyntaxError):
diff --git a/Tests/test_file_qoi.py b/Tests/test_file_qoi.py
index 6dc468754ef..fd4b981ce93 100644
--- a/Tests/test_file_qoi.py
+++ b/Tests/test_file_qoi.py
@@ -7,7 +7,7 @@
 from .helper import assert_image_equal_tofile
 
 
-def test_sanity():
+def test_sanity() -> None:
     with Image.open("Tests/images/hopper.qoi") as im:
         assert im.mode == "RGB"
         assert im.size == (128, 128)
@@ -23,7 +23,7 @@ def test_sanity():
         assert_image_equal_tofile(im, "Tests/images/pil123rgba.png")
 
 
-def test_invalid_file():
+def test_invalid_file() -> None:
     invalid_file = "Tests/images/flower.jpg"
 
     with pytest.raises(SyntaxError):
diff --git a/Tests/test_file_wal.py b/Tests/test_file_wal.py
index 7acec975942..b34975e8380 100644
--- a/Tests/test_file_wal.py
+++ b/Tests/test_file_wal.py
@@ -7,7 +7,7 @@
 TEST_FILE = "Tests/images/hopper.wal"
 
 
-def test_open():
+def test_open() -> None:
     with WalImageFile.open(TEST_FILE) as im:
         assert im.format == "WAL"
         assert im.format_description == "Quake2 Texture"
@@ -19,7 +19,7 @@ def test_open():
         assert_image_equal_tofile(im, "Tests/images/hopper_wal.png")
 
 
-def test_load():
+def test_load() -> None:
     with WalImageFile.open(TEST_FILE) as im:
         assert im.load()[0, 0] == 122
 
diff --git a/Tests/test_file_webp_lossless.py b/Tests/test_file_webp_lossless.py
index 08c80973a74..32e29de56ad 100644
--- a/Tests/test_file_webp_lossless.py
+++ b/Tests/test_file_webp_lossless.py
@@ -1,5 +1,7 @@
 from __future__ import annotations
 
+from pathlib import Path
+
 import pytest
 
 from PIL import Image
@@ -10,7 +12,7 @@
 RGB_MODE = "RGB"
 
 
-def test_write_lossless_rgb(tmp_path):
+def test_write_lossless_rgb(tmp_path: Path) -> None:
     if _webp.WebPDecoderVersion() < 0x0200:
         pytest.skip("lossless not included")
 
diff --git a/Tests/test_file_xpm.py b/Tests/test_file_xpm.py
index 529a4558073..26afe93f450 100644
--- a/Tests/test_file_xpm.py
+++ b/Tests/test_file_xpm.py
@@ -9,7 +9,7 @@
 TEST_FILE = "Tests/images/hopper.xpm"
 
 
-def test_sanity():
+def test_sanity() -> None:
     with Image.open(TEST_FILE) as im:
         im.load()
         assert im.mode == "P"
@@ -20,14 +20,14 @@ def test_sanity():
         assert_image_similar(im.convert("RGB"), hopper("RGB"), 60)
 
 
-def test_invalid_file():
+def test_invalid_file() -> None:
     invalid_file = "Tests/images/flower.jpg"
 
     with pytest.raises(SyntaxError):
         XpmImagePlugin.XpmImageFile(invalid_file)
 
 
-def test_load_read():
+def test_load_read() -> None:
     # Arrange
     with Image.open(TEST_FILE) as im:
         dummy_bytes = 1
diff --git a/Tests/test_file_xvthumb.py b/Tests/test_file_xvthumb.py
index b87494eba18..6b81159303e 100644
--- a/Tests/test_file_xvthumb.py
+++ b/Tests/test_file_xvthumb.py
@@ -9,7 +9,7 @@
 TEST_FILE = "Tests/images/hopper.p7"
 
 
-def test_open():
+def test_open() -> None:
     # Act
     with Image.open(TEST_FILE) as im:
         # Assert
@@ -20,7 +20,7 @@ def test_open():
         assert_image_similar(im, im_hopper, 9)
 
 
-def test_unexpected_eof():
+def test_unexpected_eof() -> None:
     # Test unexpected EOF reading XV thumbnail file
     # Arrange
     bad_file = "Tests/images/hopper_bad.p7"
@@ -30,7 +30,7 @@ def test_unexpected_eof():
         XVThumbImagePlugin.XVThumbImageFile(bad_file)
 
 
-def test_invalid_file():
+def test_invalid_file() -> None:
     # Arrange
     invalid_file = "Tests/images/flower.jpg"
 
diff --git a/Tests/test_fontfile.py b/Tests/test_fontfile.py
index eda8fb81283..206499a047f 100644
--- a/Tests/test_fontfile.py
+++ b/Tests/test_fontfile.py
@@ -1,11 +1,13 @@
 from __future__ import annotations
 
+from pathlib import Path
+
 import pytest
 
 from PIL import FontFile
 
 
-def test_save(tmp_path):
+def test_save(tmp_path: Path) -> None:
     tempname = str(tmp_path / "temp.pil")
 
     font = FontFile.FontFile()
diff --git a/Tests/test_format_lab.py b/Tests/test_format_lab.py
index a55620e09ab..4fcc37e88cc 100644
--- a/Tests/test_format_lab.py
+++ b/Tests/test_format_lab.py
@@ -3,7 +3,7 @@
 from PIL import Image
 
 
-def test_white():
+def test_white() -> None:
     with Image.open("Tests/images/lab.tif") as i:
         i.load()
 
@@ -24,7 +24,7 @@ def test_white():
     assert list(b) == [128] * 100
 
 
-def test_green():
+def test_green() -> None:
     # l= 50 (/100), a = -100 (-128 .. 128) b=0 in PS
     # == RGB: 0, 152, 117
     with Image.open("Tests/images/lab-green.tif") as i:
@@ -32,7 +32,7 @@ def test_green():
     assert k == (128, 28, 128)
 
 
-def test_red():
+def test_red() -> None:
     # l= 50 (/100), a = 100 (-128 .. 128) b=0 in PS
     # == RGB: 255, 0, 124
     with Image.open("Tests/images/lab-red.tif") as i:
diff --git a/Tests/test_lib_image.py b/Tests/test_lib_image.py
index 1c642e4c981..31548bbc91f 100644
--- a/Tests/test_lib_image.py
+++ b/Tests/test_lib_image.py
@@ -5,7 +5,7 @@
 from PIL import Image
 
 
-def test_setmode():
+def test_setmode() -> None:
     im = Image.new("L", (1, 1), 255)
     im.im.setmode("1")
     assert im.im.getpixel((0, 0)) == 255
diff --git a/Tests/test_locale.py b/Tests/test_locale.py
index db9557d7ba2..1c8b84a2b41 100644
--- a/Tests/test_locale.py
+++ b/Tests/test_locale.py
@@ -24,7 +24,7 @@
 path = "Tests/images/hopper.jpg"
 
 
-def test_sanity():
+def test_sanity() -> None:
     with Image.open(path):
         pass
     try:
diff --git a/Tests/test_main.py b/Tests/test_main.py
index 9f61a0c8169..46259f1dc52 100644
--- a/Tests/test_main.py
+++ b/Tests/test_main.py
@@ -5,7 +5,7 @@
 import sys
 
 
-def test_main():
+def test_main() -> None:
     out = subprocess.check_output([sys.executable, "-m", "PIL"]).decode("utf-8")
     lines = out.splitlines()
     assert lines[0] == "-" * 68
diff --git a/Tests/test_pyroma.py b/Tests/test_pyroma.py
index c2cea08ca61..c2f7fe22ecb 100644
--- a/Tests/test_pyroma.py
+++ b/Tests/test_pyroma.py
@@ -7,7 +7,7 @@
 pyroma = pytest.importorskip("pyroma", reason="Pyroma not installed")
 
 
-def test_pyroma():
+def test_pyroma() -> None:
     # Arrange
     data = pyroma.projectdata.get_data(".")
 
diff --git a/Tests/test_uploader.py b/Tests/test_uploader.py
index 75326288f97..d55ceb4be17 100644
--- a/Tests/test_uploader.py
+++ b/Tests/test_uploader.py
@@ -3,13 +3,13 @@
 from .helper import assert_image_equal, assert_image_similar, hopper
 
 
-def check_upload_equal():
+def check_upload_equal() -> None:
     result = hopper("P").convert("RGB")
     target = hopper("RGB")
     assert_image_equal(result, target)
 
 
-def check_upload_similar():
+def check_upload_similar() -> None:
     result = hopper("P").convert("RGB")
     target = hopper("RGB")
     assert_image_similar(result, target, 0)
diff --git a/Tests/test_util.py b/Tests/test_util.py
index 3395ef753d7..b47ca88271c 100644
--- a/Tests/test_util.py
+++ b/Tests/test_util.py
@@ -1,11 +1,13 @@
 from __future__ import annotations
 
+from pathlib import Path
+
 import pytest
 
 from PIL import _util
 
 
-def test_is_path():
+def test_is_path() -> None:
     # Arrange
     fp = "filename.ext"
 
@@ -16,7 +18,7 @@ def test_is_path():
     assert it_is
 
 
-def test_path_obj_is_path():
+def test_path_obj_is_path() -> None:
     # Arrange
     from pathlib import Path
 
@@ -29,7 +31,7 @@ def test_path_obj_is_path():
     assert it_is
 
 
-def test_is_not_path(tmp_path):
+def test_is_not_path(tmp_path: Path) -> None:
     # Arrange
     with (tmp_path / "temp.ext").open("w") as fp:
         pass
@@ -41,7 +43,7 @@ def test_is_not_path(tmp_path):
     assert not it_is_not
 
 
-def test_is_directory():
+def test_is_directory() -> None:
     # Arrange
     directory = "Tests"
 
@@ -52,7 +54,7 @@ def test_is_directory():
     assert it_is
 
 
-def test_is_not_directory():
+def test_is_not_directory() -> None:
     # Arrange
     text = "abc"
 
@@ -63,7 +65,7 @@ def test_is_not_directory():
     assert not it_is_not
 
 
-def test_deferred_error():
+def test_deferred_error() -> None:
     # Arrange
 
     # Act
diff --git a/Tests/test_webp_leaks.py b/Tests/test_webp_leaks.py
index 0f51abc9574..626fe427cab 100644
--- a/Tests/test_webp_leaks.py
+++ b/Tests/test_webp_leaks.py
@@ -14,11 +14,11 @@ class TestWebPLeaks(PillowLeakTestCase):
     mem_limit = 3 * 1024  # kb
     iterations = 100
 
-    def test_leak_load(self):
+    def test_leak_load(self) -> None:
         with open(test_file, "rb") as f:
             im_data = f.read()
 
-        def core():
+        def core() -> None:
             with Image.open(BytesIO(im_data)) as im:
                 im.load()
 

From cd640e5df27c6c3c58d8cc63c16cba71c237b9a4 Mon Sep 17 00:00:00 2001
From: Nicola Guerrera <guerrera.nicola@gmail.com>
Date: Mon, 22 Jan 2024 15:19:59 +0100
Subject: [PATCH 0128/1178] Refactor grabclipboard() for x11 and wayland
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit

Simpified logic and made it more robust against edge cases ( see the `allowed_errors` list ). Doing error checking this way, makes the behaviour of this function for x11 and wayland platforms more silimar to darwin and windows systems.

fix typo src/PIL/ImageGrab.py

Co-authored-by: Ondrej Baranovič <nulano@nulano.eu>

fix typo src/PIL/ImageGrab.py

Co-authored-by: Andrew Murray <3112309+radarhere@users.noreply.github.com>

ImageGrab: \added debian edge case to comment
---
 src/PIL/ImageGrab.py | 28 +++++++++++++---------------
 1 file changed, 13 insertions(+), 15 deletions(-)

diff --git a/src/PIL/ImageGrab.py b/src/PIL/ImageGrab.py
index a4993d3d4b8..1cb02f5f93c 100644
--- a/src/PIL/ImageGrab.py
+++ b/src/PIL/ImageGrab.py
@@ -149,18 +149,7 @@ def grabclipboard():
             session_type = None
 
         if shutil.which("wl-paste") and session_type in ("wayland", None):
-            output = subprocess.check_output(["wl-paste", "-l"]).decode()
-            mimetypes = output.splitlines()
-            if "image/png" in mimetypes:
-                mimetype = "image/png"
-            elif mimetypes:
-                mimetype = mimetypes[0]
-            else:
-                mimetype = None
-
-            args = ["wl-paste"]
-            if mimetype:
-                args.extend(["-t", mimetype])
+            args = ["wl-paste", "-t", "image"]
         elif shutil.which("xclip") and session_type in ("x11", None):
             args = ["xclip", "-selection", "clipboard", "-t", "image/png", "-o"]
         else:
@@ -168,10 +157,19 @@ def grabclipboard():
             raise NotImplementedError(msg)
 
         p = subprocess.run(args, capture_output=True)
-        err = p.stderr
-        if err:
-            msg = f"{args[0]} error: {err.strip().decode()}"
+        err = p.stderr.decode()
+        if p.returncode != 0:
+            allowed_errors = [
+                "Nothing is copied",  # wl-paste, when the clipboard is empty
+                "not available",  # wl-paste/debian xclip, when an image isn't available
+                "cannot convert",  # xclip, when an image isn't available
+                "There is no owner",  # xclip, when the clipboard isn't initialized
+            ]
+            if any(e in err for e in allowed_errors):
+                return None
+            msg = f"{args[0]} error: {err.strip() if err else 'Unknown error'}"
             raise ChildProcessError(msg)
+
         data = io.BytesIO(p.stdout)
         im = Image.open(data)
         im.load()

From b81341ae7e62a246adabc40982d2b81ed3b7542d Mon Sep 17 00:00:00 2001
From: Andrew Murray <radarhere@users.noreply.github.com>
Date: Sat, 27 Jan 2024 20:15:10 +1100
Subject: [PATCH 0129/1178] Only decode stderr when necessary

---
 src/PIL/ImageGrab.py | 16 ++++++++++------
 1 file changed, 10 insertions(+), 6 deletions(-)

diff --git a/src/PIL/ImageGrab.py b/src/PIL/ImageGrab.py
index 1cb02f5f93c..730351c0d68 100644
--- a/src/PIL/ImageGrab.py
+++ b/src/PIL/ImageGrab.py
@@ -157,17 +157,21 @@ def grabclipboard():
             raise NotImplementedError(msg)
 
         p = subprocess.run(args, capture_output=True)
-        err = p.stderr.decode()
+        err = p.stderr
         if p.returncode != 0:
             allowed_errors = [
-                "Nothing is copied",  # wl-paste, when the clipboard is empty
-                "not available",  # wl-paste/debian xclip, when an image isn't available
-                "cannot convert",  # xclip, when an image isn't available
-                "There is no owner",  # xclip, when the clipboard isn't initialized
+                # wl-paste, when the clipboard is empty
+                b"Nothing is copied",
+                # wl-paste/debian xclip, when an image isn't available
+                b"not available",
+                # xclip, when an image isn't available
+                b"cannot convert",
+                # xclip, when the clipboard isn't initialized
+                b"There is no owner",
             ]
             if any(e in err for e in allowed_errors):
                 return None
-            msg = f"{args[0]} error: {err.strip() if err else 'Unknown error'}"
+            msg = f"{args[0]} error: {err.strip().decode() if err else 'Unknown error'}"
             raise ChildProcessError(msg)
 
         data = io.BytesIO(p.stdout)

From d2d9240de4cafee650f11c085a7ec321240a8e3e Mon Sep 17 00:00:00 2001
From: Andrew Murray <radarhere@users.noreply.github.com>
Date: Sat, 27 Jan 2024 19:26:55 +1100
Subject: [PATCH 0130/1178] Do not declare variable until necessary

---
 src/PIL/ImageGrab.py | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/src/PIL/ImageGrab.py b/src/PIL/ImageGrab.py
index 730351c0d68..ca27b520caa 100644
--- a/src/PIL/ImageGrab.py
+++ b/src/PIL/ImageGrab.py
@@ -157,7 +157,6 @@ def grabclipboard():
             raise NotImplementedError(msg)
 
         p = subprocess.run(args, capture_output=True)
-        err = p.stderr
         if p.returncode != 0:
             allowed_errors = [
                 # wl-paste, when the clipboard is empty
@@ -169,6 +168,7 @@ def grabclipboard():
                 # xclip, when the clipboard isn't initialized
                 b"There is no owner",
             ]
+            err = p.stderr
             if any(e in err for e in allowed_errors):
                 return None
             msg = f"{args[0]} error: {err.strip().decode() if err else 'Unknown error'}"

From 6998f3476843e2f8da00eb23545aab55dc280006 Mon Sep 17 00:00:00 2001
From: Nicola Guerrera <guerrera.nicola@gmail.com>
Date: Sat, 27 Jan 2024 12:08:16 +0100
Subject: [PATCH 0131/1178] Rearrange error handling

Co-authored-by: Andrew Murray <3112309+radarhere@users.noreply.github.com>
---
 src/PIL/ImageGrab.py | 4 +++-
 1 file changed, 3 insertions(+), 1 deletion(-)

diff --git a/src/PIL/ImageGrab.py b/src/PIL/ImageGrab.py
index ca27b520caa..a2c7a935103 100644
--- a/src/PIL/ImageGrab.py
+++ b/src/PIL/ImageGrab.py
@@ -171,7 +171,9 @@ def grabclipboard():
             err = p.stderr
             if any(e in err for e in allowed_errors):
                 return None
-            msg = f"{args[0]} error: {err.strip().decode() if err else 'Unknown error'}"
+            msg = f"{args[0]} error"
+            if err:
+                msg += f": {err.strip().decode()}"
             raise ChildProcessError(msg)
 
         data = io.BytesIO(p.stdout)

From d3205fae192ec10497326aacb7325f5880d07b04 Mon Sep 17 00:00:00 2001
From: Andrew Murray <radarhere@users.noreply.github.com>
Date: Sat, 27 Jan 2024 22:54:01 +1100
Subject: [PATCH 0132/1178] Simplified code

---
 src/PIL/ImageGrab.py | 10 +++++-----
 1 file changed, 5 insertions(+), 5 deletions(-)

diff --git a/src/PIL/ImageGrab.py b/src/PIL/ImageGrab.py
index a2c7a935103..c04be521f91 100644
--- a/src/PIL/ImageGrab.py
+++ b/src/PIL/ImageGrab.py
@@ -158,7 +158,8 @@ def grabclipboard():
 
         p = subprocess.run(args, capture_output=True)
         if p.returncode != 0:
-            allowed_errors = [
+            err = p.stderr
+            for silent_error in [
                 # wl-paste, when the clipboard is empty
                 b"Nothing is copied",
                 # wl-paste/debian xclip, when an image isn't available
@@ -167,10 +168,9 @@ def grabclipboard():
                 b"cannot convert",
                 # xclip, when the clipboard isn't initialized
                 b"There is no owner",
-            ]
-            err = p.stderr
-            if any(e in err for e in allowed_errors):
-                return None
+            ]:
+                if err in silent_error:
+                    return None
             msg = f"{args[0]} error"
             if err:
                 msg += f": {err.strip().decode()}"

From 61d47c3dfa200b186ecacd7b9a5090cedb5523b6 Mon Sep 17 00:00:00 2001
From: Hugo van Kemenade <1324225+hugovk@users.noreply.github.com>
Date: Sat, 27 Jan 2024 14:06:06 +0200
Subject: [PATCH 0133/1178] More support for arbitrary os.PathLike

---
 Tests/test_image.py           |  3 +--
 docs/reference/open_files.rst |  2 +-
 src/PIL/Image.py              | 16 ++++++----------
 3 files changed, 8 insertions(+), 13 deletions(-)

diff --git a/Tests/test_image.py b/Tests/test_image.py
index dd989ad99b5..84189df5477 100644
--- a/Tests/test_image.py
+++ b/Tests/test_image.py
@@ -7,6 +7,7 @@
 import sys
 import tempfile
 import warnings
+from pathlib import Path
 
 import pytest
 
@@ -161,8 +162,6 @@ def test_stringio(self):
                 pass
 
     def test_pathlib(self, tmp_path):
-        from PIL.Image import Path
-
         with Image.open(Path("Tests/images/multipage-mmap.tiff")) as im:
             assert im.mode == "P"
             assert im.size == (10, 10)
diff --git a/docs/reference/open_files.rst b/docs/reference/open_files.rst
index f31941c9abb..730c8da5b80 100644
--- a/docs/reference/open_files.rst
+++ b/docs/reference/open_files.rst
@@ -3,7 +3,7 @@
 File Handling in Pillow
 =======================
 
-When opening a file as an image, Pillow requires a filename, ``pathlib.Path``
+When opening a file as an image, Pillow requires a filename, ``os.PathLike``
 object, or a file-like object. Pillow uses the filename or ``Path`` to open a
 file, so for the rest of this article, they will all be treated as a file-like
 object.
diff --git a/src/PIL/Image.py b/src/PIL/Image.py
index 553f36703b3..48125b3173b 100644
--- a/src/PIL/Image.py
+++ b/src/PIL/Image.py
@@ -39,7 +39,6 @@
 import warnings
 from collections.abc import Callable, MutableMapping
 from enum import IntEnum
-from pathlib import Path
 
 try:
     from defusedxml import ElementTree
@@ -2370,7 +2369,7 @@ def save(self, fp, format=None, **params) -> None:
         implement the ``seek``, ``tell``, and ``write``
         methods, and be opened in binary mode.
 
-        :param fp: A filename (string), pathlib.Path object or file object.
+        :param fp: A filename (string), os.PathLike object or file object.
         :param format: Optional format override.  If omitted, the
            format to use is determined from the filename extension.
            If a file object was used instead of a filename, this
@@ -2385,11 +2384,8 @@ def save(self, fp, format=None, **params) -> None:
 
         filename = ""
         open_fp = False
-        if isinstance(fp, Path):
-            filename = str(fp)
-            open_fp = True
-        elif is_path(fp):
-            filename = fp
+        if is_path(fp):
+            filename = os.fspath(fp)
             open_fp = True
         elif fp == sys.stdout:
             try:
@@ -3206,7 +3202,7 @@ def open(fp, mode="r", formats=None) -> Image:
     :py:meth:`~PIL.Image.Image.load` method).  See
     :py:func:`~PIL.Image.new`. See :ref:`file-handling`.
 
-    :param fp: A filename (string), pathlib.Path object or a file object.
+    :param fp: A filename (string), os.PathLike object or a file object.
        The file object must implement ``file.read``,
        ``file.seek``, and ``file.tell`` methods,
        and be opened in binary mode. The file object will also seek to zero
@@ -3244,8 +3240,8 @@ def open(fp, mode="r", formats=None) -> Image:
 
     exclusive_fp = False
     filename = ""
-    if isinstance(fp, Path):
-        filename = str(fp.resolve())
+    if isinstance(fp, os.PathLike):
+        filename = os.path.realpath(os.fspath(fp))
     elif is_path(fp):
         filename = fp
 

From 52e51e12b950aac7a5bd5593ea9fc2981490c2d3 Mon Sep 17 00:00:00 2001
From: "renovate[bot]" <29139614+renovate[bot]@users.noreply.github.com>
Date: Sun, 28 Jan 2024 21:20:28 +0000
Subject: [PATCH 0134/1178] Update dependency cibuildwheel to v2.16.4

---
 .ci/requirements-cibw.txt | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/.ci/requirements-cibw.txt b/.ci/requirements-cibw.txt
index dd61634cd31..867543ebd84 100644
--- a/.ci/requirements-cibw.txt
+++ b/.ci/requirements-cibw.txt
@@ -1 +1 @@
-cibuildwheel==2.16.2
+cibuildwheel==2.16.4

From 529487c244c64ee93ed7601eac9a9bbc3194827f Mon Sep 17 00:00:00 2001
From: Hugo van Kemenade <1324225+hugovk@users.noreply.github.com>
Date: Mon, 29 Jan 2024 16:48:39 +0200
Subject: [PATCH 0135/1178] Remove execute bit from setup.py

---
 setup.py | 0
 1 file changed, 0 insertions(+), 0 deletions(-)
 mode change 100755 => 100644 setup.py

diff --git a/setup.py b/setup.py
old mode 100755
new mode 100644

From 866c26957d521ec02c6dc86c686800fe0a18a4d6 Mon Sep 17 00:00:00 2001
From: Hugo van Kemenade <1324225+hugovk@users.noreply.github.com>
Date: Mon, 29 Jan 2024 18:37:24 +0200
Subject: [PATCH 0136/1178] Add check-shebang-scripts-are-executable to
 pre-commit

---
 .pre-commit-config.yaml | 1 +
 1 file changed, 1 insertion(+)

diff --git a/.pre-commit-config.yaml b/.pre-commit-config.yaml
index 6adc75b4902..5ce0c9a1792 100644
--- a/.pre-commit-config.yaml
+++ b/.pre-commit-config.yaml
@@ -32,6 +32,7 @@ repos:
     rev: v4.5.0
     hooks:
       - id: check-executables-have-shebangs
+      - id: check-shebang-scripts-are-executable
       - id: check-merge-conflict
       - id: check-json
       - id: check-toml

From 0669532898c9cbb45ceebbeefb317dfcc97eaac1 Mon Sep 17 00:00:00 2001
From: Hugo van Kemenade <1324225+hugovk@users.noreply.github.com>
Date: Mon, 29 Jan 2024 18:43:03 +0200
Subject: [PATCH 0137/1178] Remove shebangs

---
 Tests/check_fli_oob.py          | 1 -
 Tests/images/create_eps.gnuplot | 2 --
 Tests/oss-fuzz/fuzz_pillow.py   | 2 --
 setup.py                        | 1 -
 4 files changed, 6 deletions(-)

diff --git a/Tests/check_fli_oob.py b/Tests/check_fli_oob.py
index ac46ff1ebc0..e0057a2c2ad 100644
--- a/Tests/check_fli_oob.py
+++ b/Tests/check_fli_oob.py
@@ -1,4 +1,3 @@
-#!/usr/bin/env python3
 from __future__ import annotations
 
 from PIL import Image
diff --git a/Tests/images/create_eps.gnuplot b/Tests/images/create_eps.gnuplot
index 4d7e2987769..57a3c8c9725 100644
--- a/Tests/images/create_eps.gnuplot
+++ b/Tests/images/create_eps.gnuplot
@@ -1,5 +1,3 @@
-#!/usr/bin/gnuplot
-
 #This is the script that was used to create our sample EPS files
 #We used the following version of the gnuplot program
 #G N U P L O T
diff --git a/Tests/oss-fuzz/fuzz_pillow.py b/Tests/oss-fuzz/fuzz_pillow.py
index e6e99d415a6..9137391b656 100644
--- a/Tests/oss-fuzz/fuzz_pillow.py
+++ b/Tests/oss-fuzz/fuzz_pillow.py
@@ -1,5 +1,3 @@
-#!/usr/bin/python3
-
 # Copyright 2020 Google LLC
 #
 # Licensed under the Apache License, Version 2.0 (the "License");
diff --git a/setup.py b/setup.py
index 1bf0bcff558..1bbd2c05cc9 100644
--- a/setup.py
+++ b/setup.py
@@ -1,4 +1,3 @@
-#!/usr/bin/env python3
 # > pyroma .
 # ------------------------------
 # Checking .

From 76955bbaf7ee718c743da8ba1866e5c98b69f272 Mon Sep 17 00:00:00 2001
From: Hugo van Kemenade <1324225+hugovk@users.noreply.github.com>
Date: Mon, 29 Jan 2024 18:43:51 +0200
Subject: [PATCH 0138/1178] Remove shebang and execute bit

---
 Tests/check_jp2_overflow.py | 2 --
 1 file changed, 2 deletions(-)
 mode change 100755 => 100644 Tests/check_jp2_overflow.py

diff --git a/Tests/check_jp2_overflow.py b/Tests/check_jp2_overflow.py
old mode 100755
new mode 100644
index 5adbb84b69c..954d68bf7e3
--- a/Tests/check_jp2_overflow.py
+++ b/Tests/check_jp2_overflow.py
@@ -1,5 +1,3 @@
-#!/usr/bin/env python3
-
 # Reproductions/tests for OOB read errors in FliDecode.c
 
 # When run in python, all of these images should fail for

From 139320be3a121dbc38d51baefda8d0b97441314d Mon Sep 17 00:00:00 2001
From: Andrew Murray <radarhere@users.noreply.github.com>
Date: Tue, 30 Jan 2024 19:44:42 +1100
Subject: [PATCH 0139/1178] Pin to Python 3.9.16-1

---
 .github/workflows/test-cygwin.yml | 5 +++--
 1 file changed, 3 insertions(+), 2 deletions(-)

diff --git a/.github/workflows/test-cygwin.yml b/.github/workflows/test-cygwin.yml
index 9c3eb092417..b5c8c39aaef 100644
--- a/.github/workflows/test-cygwin.yml
+++ b/.github/workflows/test-cygwin.yml
@@ -47,7 +47,7 @@ jobs:
         uses: actions/checkout@v4
 
       - name: Install Cygwin
-        uses: cygwin/cygwin-install-action@v4
+        uses: egor-tensin/setup-cygwin@v4
         with:
           platform: x86_64
           packages: >
@@ -69,6 +69,7 @@ jobs:
             make
             netpbm
             perl
+            python39=3.9.16-1
             python3${{ matrix.python-minor-version }}-cffi
             python3${{ matrix.python-minor-version }}-cython
             python3${{ matrix.python-minor-version }}-devel
@@ -86,7 +87,7 @@ jobs:
 
       - name: Select Python version
         run: |
-          ln -sf c:/cygwin/bin/python3.${{ matrix.python-minor-version }} c:/cygwin/bin/python3
+          ln -sf c:/tools/cygwin/bin/python3.${{ matrix.python-minor-version }} c:/tools/cygwin/bin/python3
 
       - name: Get latest NumPy version
         id: latest-numpy

From 40fceedfba5d79cde4891ec70e69aee961cd3165 Mon Sep 17 00:00:00 2001
From: Andrew Murray <radarhere@users.noreply.github.com>
Date: Tue, 30 Jan 2024 22:22:13 +1100
Subject: [PATCH 0140/1178] brew remove libxau

---
 .github/workflows/wheels-dependencies.sh | 4 ++--
 1 file changed, 2 insertions(+), 2 deletions(-)

diff --git a/.github/workflows/wheels-dependencies.sh b/.github/workflows/wheels-dependencies.sh
index 3ec3148734f..50ac2e18e8b 100755
--- a/.github/workflows/wheels-dependencies.sh
+++ b/.github/workflows/wheels-dependencies.sh
@@ -131,13 +131,13 @@ untar pillow-depends-main.zip
 
 if [[ -n "$IS_MACOS" ]]; then
   # webp, libtiff, libxcb cause a conflict with building webp, libtiff, libxcb
-  # libxdmcp causes an issue on macOS < 11
+  # libxau and libxdmcp cause an issue on macOS < 11
   # if php is installed, brew tries to reinstall these after installing openblas
   # remove cairo to fix building harfbuzz on arm64
   # remove lcms2 and libpng to fix building openjpeg on arm64
   # remove zstd to avoid inclusion on x86_64
   # curl from brew requires zstd, use system curl
-  brew remove --ignore-dependencies webp libpng libtiff libxcb libxdmcp curl php cairo lcms2 ghostscript zstd
+  brew remove --ignore-dependencies webp libpng libtiff libxcb libxau libxdmcp curl php cairo lcms2 ghostscript zstd
 
   brew install pkg-config
 fi

From b374f2679c4a0b102a1bc59b177a1a6b5cd0e1be Mon Sep 17 00:00:00 2001
From: Andrew Murray <radarhere@users.noreply.github.com>
Date: Tue, 30 Jan 2024 22:57:17 +1100
Subject: [PATCH 0141/1178] Build libxcb dependencies on macOS x86-64

---
 .github/workflows/wheels-dependencies.sh | 12 +++++-------
 1 file changed, 5 insertions(+), 7 deletions(-)

diff --git a/.github/workflows/wheels-dependencies.sh b/.github/workflows/wheels-dependencies.sh
index 50ac2e18e8b..26bf2f6d655 100755
--- a/.github/workflows/wheels-dependencies.sh
+++ b/.github/workflows/wheels-dependencies.sh
@@ -72,13 +72,11 @@ function build {
 
     build_simple xcb-proto 1.16.0 https://xorg.freedesktop.org/archive/individual/proto
     if [ -n "$IS_MACOS" ]; then
-        if [[ "$CIBW_ARCHS" == "arm64" ]]; then
-            build_simple xorgproto 2023.2 https://www.x.org/pub/individual/proto
-            build_simple libXau 1.0.11 https://www.x.org/pub/individual/lib
-            build_simple libpthread-stubs 0.5 https://xcb.freedesktop.org/dist
-            if [ -f /Library/Frameworks/Python.framework/Versions/Current/share/pkgconfig/xcb-proto.pc ]; then
-                cp /Library/Frameworks/Python.framework/Versions/Current/share/pkgconfig/xcb-proto.pc /Library/Frameworks/Python.framework/Versions/Current/lib/pkgconfig/xcb-proto.pc
-            fi
+        build_simple xorgproto 2023.2 https://www.x.org/pub/individual/proto
+        build_simple libXau 1.0.11 https://www.x.org/pub/individual/lib
+        build_simple libpthread-stubs 0.5 https://xcb.freedesktop.org/dist
+        if [ -f /Library/Frameworks/Python.framework/Versions/Current/share/pkgconfig/xcb-proto.pc ]; then
+            cp /Library/Frameworks/Python.framework/Versions/Current/share/pkgconfig/xcb-proto.pc /Library/Frameworks/Python.framework/Versions/Current/lib/pkgconfig/xcb-proto.pc
         fi
     else
         sed s/\${pc_sysrootdir\}// /usr/local/share/pkgconfig/xcb-proto.pc > /usr/local/lib/pkgconfig/xcb-proto.pc

From 7c6d8066452621f1adc54ca21305563e5fef99d5 Mon Sep 17 00:00:00 2001
From: Hugo van Kemenade <1324225+hugovk@users.noreply.github.com>
Date: Tue, 30 Jan 2024 18:26:20 +0200
Subject: [PATCH 0142/1178] Test on macOS M1 where available

---
 .github/workflows/test.yml | 18 ++++++++++++++----
 1 file changed, 14 insertions(+), 4 deletions(-)

diff --git a/.github/workflows/test.yml b/.github/workflows/test.yml
index 4e23f5c5b12..ae84a4d8fd5 100644
--- a/.github/workflows/test.yml
+++ b/.github/workflows/test.yml
@@ -36,7 +36,7 @@ jobs:
       fail-fast: false
       matrix:
         os: [
-          "macos-latest",
+          "macos-14",
           "ubuntu-latest",
         ]
         python-version: [
@@ -50,11 +50,21 @@ jobs:
           "3.8",
         ]
         include:
-        - python-version: "3.9"
+        - python-version: "3.11"
           PYTHONOPTIMIZE: 1
           REVERSE: "--reverse"
-        - python-version: "3.8"
+        - python-version: "3.10"
           PYTHONOPTIMIZE: 2
+        # M1 only available for 3.10+
+        - os: "macos-latest"
+          python-version: "3.9"
+        - os: "macos-latest"
+          python-version: "3.8"
+        exclude:
+        - os: "macos-14"
+          python-version: "3.9"
+        - os: "macos-14"
+          python-version: "3.8"
 
     runs-on: ${{ matrix.os }}
     name: ${{ matrix.os }} Python ${{ matrix.python-version }}
@@ -141,7 +151,7 @@ jobs:
     - name: Upload coverage
       uses: codecov/codecov-action@v3
       with:
-        flags: ${{ matrix.os == 'macos-latest' && 'GHA_macOS' || 'GHA_Ubuntu' }}
+        flags: ${{ matrix.os == 'ubuntu-latest' && 'GHA_Ubuntu' || 'GHA_macOS' }}
         name: ${{ matrix.os }} Python ${{ matrix.python-version }}
         gcov: true
 

From d65f7b5ef7ef32905078e10af4471ce8bfa54c9f Mon Sep 17 00:00:00 2001
From: Hugo van Kemenade <1324225+hugovk@users.noreply.github.com>
Date: Tue, 30 Jan 2024 22:10:22 +0200
Subject: [PATCH 0143/1178] brew install ghostscript

---
 .github/workflows/macos-install.sh | 11 ++++++++++-
 1 file changed, 10 insertions(+), 1 deletion(-)

diff --git a/.github/workflows/macos-install.sh b/.github/workflows/macos-install.sh
index f41324c4ba6..28124d7f759 100755
--- a/.github/workflows/macos-install.sh
+++ b/.github/workflows/macos-install.sh
@@ -2,7 +2,16 @@
 
 set -e
 
-brew install libtiff libjpeg openjpeg libimagequant webp little-cms2 freetype libraqm
+brew install \
+    freetype \
+    ghostscript \
+    libimagequant \
+    libjpeg \
+    libraqm \
+    libtiff \
+    little-cms2 \
+    openjpeg \
+    webp
 export PKG_CONFIG_PATH="/usr/local/opt/openblas/lib/pkgconfig"
 
 # TODO Update condition when cffi supports 3.13

From 1dad1b87ed77e283d8fb10eee1e61e66c5173eba Mon Sep 17 00:00:00 2001
From: "renovate[bot]" <29139614+renovate[bot]@users.noreply.github.com>
Date: Wed, 31 Jan 2024 00:17:32 +0000
Subject: [PATCH 0144/1178] Update dependency cibuildwheel to v2.16.5

---
 .ci/requirements-cibw.txt | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/.ci/requirements-cibw.txt b/.ci/requirements-cibw.txt
index 867543ebd84..ccd6d87edc6 100644
--- a/.ci/requirements-cibw.txt
+++ b/.ci/requirements-cibw.txt
@@ -1 +1 @@
-cibuildwheel==2.16.4
+cibuildwheel==2.16.5

From 39cbd4f0f1bf4f40229f50aa5480b4b25eaae1a5 Mon Sep 17 00:00:00 2001
From: Andrew Murray <radarhere@users.noreply.github.com>
Date: Sun, 28 Jan 2024 16:31:03 +1100
Subject: [PATCH 0145/1178] Expanded error message strings

---
 src/PIL/ImageGrab.py | 6 +++---
 1 file changed, 3 insertions(+), 3 deletions(-)

diff --git a/src/PIL/ImageGrab.py b/src/PIL/ImageGrab.py
index c04be521f91..b888e66f1c1 100644
--- a/src/PIL/ImageGrab.py
+++ b/src/PIL/ImageGrab.py
@@ -163,11 +163,11 @@ def grabclipboard():
                 # wl-paste, when the clipboard is empty
                 b"Nothing is copied",
                 # wl-paste/debian xclip, when an image isn't available
-                b"not available",
+                b" not available",
                 # xclip, when an image isn't available
-                b"cannot convert",
+                b"cannot convert ",
                 # xclip, when the clipboard isn't initialized
-                b"There is no owner",
+                b"xclip: Error: There is no owner for the ",
             ]:
                 if err in silent_error:
                     return None

From 5efa2ade222785979c1b085be09eff5ee738c42c Mon Sep 17 00:00:00 2001
From: Andrew Murray <radarhere@users.noreply.github.com>
Date: Sun, 28 Jan 2024 16:53:27 +1100
Subject: [PATCH 0146/1178] Added test

---
 Tests/test_imagegrab.py | 12 ++++++++++++
 src/PIL/ImageGrab.py    |  6 +++++-
 2 files changed, 17 insertions(+), 1 deletion(-)

diff --git a/Tests/test_imagegrab.py b/Tests/test_imagegrab.py
index 9d3d40398f6..efef4d90807 100644
--- a/Tests/test_imagegrab.py
+++ b/Tests/test_imagegrab.py
@@ -119,3 +119,15 @@ def test_grabclipboard_wl_clipboard(self, ext):
             subprocess.call(["wl-copy"], stdin=fp)
         im = ImageGrab.grabclipboard()
         assert_image_equal_tofile(im, image_path)
+
+    @pytest.mark.skipif(
+        (
+            sys.platform != "linux"
+            or not all(shutil.which(cmd) for cmd in ("wl-paste", "wl-copy"))
+        ),
+        reason="Linux with wl-clipboard only",
+    )
+    @pytest.mark.parametrize("arg", ("text", "--clear"))
+    def test_grabclipboard_wl_clipboard_errors(self, arg):
+        subprocess.call(["wl-copy", arg])
+        assert ImageGrab.grabclipboard() is None
diff --git a/src/PIL/ImageGrab.py b/src/PIL/ImageGrab.py
index b888e66f1c1..17f5750b1f3 100644
--- a/src/PIL/ImageGrab.py
+++ b/src/PIL/ImageGrab.py
@@ -162,7 +162,11 @@ def grabclipboard():
             for silent_error in [
                 # wl-paste, when the clipboard is empty
                 b"Nothing is copied",
-                # wl-paste/debian xclip, when an image isn't available
+                # Ubuntu/Debian wl-paste, when the clipboard is empty
+                b"No selection",
+                # Ubuntu/Debian wl-paste, when an image isn't available
+                b"No suitable type of content copied",
+                # wl-paste or Ubuntu/Debian xclip, when an image isn't available
                 b" not available",
                 # xclip, when an image isn't available
                 b"cannot convert ",

From d57b5e827cfd0e9850a074a4ba27e9f5ad0c9910 Mon Sep 17 00:00:00 2001
From: Andrew Murray <radarhere@users.noreply.github.com>
Date: Sun, 28 Jan 2024 16:49:44 +1100
Subject: [PATCH 0147/1178] Corrected check

---
 src/PIL/ImageGrab.py | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/src/PIL/ImageGrab.py b/src/PIL/ImageGrab.py
index 17f5750b1f3..3f3be706d96 100644
--- a/src/PIL/ImageGrab.py
+++ b/src/PIL/ImageGrab.py
@@ -173,7 +173,7 @@ def grabclipboard():
                 # xclip, when the clipboard isn't initialized
                 b"xclip: Error: There is no owner for the ",
             ]:
-                if err in silent_error:
+                if silent_error in err:
                     return None
             msg = f"{args[0]} error"
             if err:

From 4a4b90c3652d5036ab8d7d140763fa1eeef62985 Mon Sep 17 00:00:00 2001
From: Hugo van Kemenade <1324225+hugovk@users.noreply.github.com>
Date: Wed, 31 Jan 2024 11:12:58 +0200
Subject: [PATCH 0148/1178] Autotype tests (#7756)

* autotyping: --none-return
* autotyping: --scalar-return
* autotyping: --int-param
* autotyping: --float-param
* autotyping: --str-param
* autotyping: --annotate-named-param tmp_path:pathlib.Path
---
 Tests/bench_cffi_access.py          |   8 +-
 Tests/test_bmp_reference.py         |   6 +-
 Tests/test_box_blur.py              |  34 +++---
 Tests/test_color_lut.py             |  52 ++++-----
 Tests/test_core_resources.py        |  32 ++---
 Tests/test_decompression_bomb.py    |  28 ++---
 Tests/test_deprecate.py             |  14 +--
 Tests/test_features.py              |  30 ++---
 Tests/test_file_apng.py             |  52 +++++----
 Tests/test_file_blp.py              |  14 ++-
 Tests/test_file_bmp.py              |  35 +++---
 Tests/test_file_bufrstub.py         |  16 +--
 Tests/test_file_container.py        |  20 ++--
 Tests/test_file_dcx.py              |  20 ++--
 Tests/test_file_dds.py              |  53 ++++-----
 Tests/test_file_eps.py              |  71 ++++++------
 Tests/test_file_fits.py             |  10 +-
 Tests/test_file_fli.py              |  30 ++---
 Tests/test_file_fpx.py              |   8 +-
 Tests/test_file_gif.py              | 173 +++++++++++++--------------
 Tests/test_file_gimpgradient.py     |  20 ++--
 Tests/test_file_gribstub.py         |  16 +--
 Tests/test_file_hdf5stub.py         |  16 +--
 Tests/test_file_icns.py             |  23 ++--
 Tests/test_file_ico.py              |  33 +++---
 Tests/test_file_im.py               |  29 ++---
 Tests/test_file_iptc.py             |  18 +--
 Tests/test_file_jpeg.py             | 155 +++++++++++++------------
 Tests/test_file_jpeg2k.py           |  77 ++++++------
 Tests/test_file_libtiff.py          | 167 +++++++++++++-------------
 Tests/test_file_libtiff_small.py    |   7 +-
 Tests/test_file_mic.py              |  14 +--
 Tests/test_file_mpo.py              |  44 +++----
 Tests/test_file_msp.py              |  17 +--
 Tests/test_file_palm.py             |  13 ++-
 Tests/test_file_pcx.py              |  32 ++---
 Tests/test_file_pdf.py              |  35 +++---
 Tests/test_file_png.py              | 109 ++++++++---------
 Tests/test_file_ppm.py              |  51 ++++----
 Tests/test_file_psd.py              |  34 +++---
 Tests/test_file_sgi.py              |  24 ++--
 Tests/test_file_spider.py           |  35 +++---
 Tests/test_file_sun.py              |   6 +-
 Tests/test_file_tar.py              |   8 +-
 Tests/test_file_tga.py              |  31 ++---
 Tests/test_file_tiff.py             | 151 ++++++++++++------------
 Tests/test_file_tiff_metadata.py    |  49 ++++----
 Tests/test_file_webp.py             |  41 +++----
 Tests/test_file_webp_alpha.py       |  14 ++-
 Tests/test_file_webp_animated.py    |  18 +--
 Tests/test_file_webp_metadata.py    |  17 +--
 Tests/test_file_wmf.py              |  16 +--
 Tests/test_file_xbm.py              |  13 ++-
 Tests/test_format_hsv.py            |   8 +-
 Tests/test_image.py                 | 155 +++++++++++++------------
 Tests/test_image_access.py          |  44 +++----
 Tests/test_image_array.py           |  10 +-
 Tests/test_image_draft.py           |   6 +-
 Tests/test_image_entropy.py         |   2 +-
 Tests/test_image_filter.py          |  24 ++--
 Tests/test_image_getextrema.py      |   4 +-
 Tests/test_image_getpalette.py      |   4 +-
 Tests/test_image_load.py            |  10 +-
 Tests/test_image_mode.py            |   4 +-
 Tests/test_image_paste.py           |  28 ++---
 Tests/test_image_putdata.py         |  20 ++--
 Tests/test_image_putpalette.py      |  12 +-
 Tests/test_image_reduce.py          |  40 ++++---
 Tests/test_image_resample.py        |  80 ++++++-------
 Tests/test_image_rotate.py          |  30 ++---
 Tests/test_image_thumbnail.py       |  20 ++--
 Tests/test_image_transform.py       |  38 +++---
 Tests/test_imagechops.py            |  60 +++++-----
 Tests/test_imagecms.py              |  71 ++++++------
 Tests/test_imagecolor.py            |  12 +-
 Tests/test_imagedraw.py             | 174 ++++++++++++++--------------
 Tests/test_imagedraw2.py            |  24 ++--
 Tests/test_imageenhance.py          |   8 +-
 Tests/test_imagefile.py             |  58 +++++-----
 Tests/test_imagefont.py             | 122 +++++++++----------
 Tests/test_imagefontctl.py          |  40 +++----
 Tests/test_imagefontpil.py          |  16 +--
 Tests/test_imagegrab.py             |  16 +--
 Tests/test_imagemath.py             |  50 ++++----
 Tests/test_imagemorph.py            |  40 ++++---
 Tests/test_imageops.py              |  50 ++++----
 Tests/test_imageops_usm.py          |  10 +-
 Tests/test_imagepalette.py          |  30 ++---
 Tests/test_imagepath.py             |  24 ++--
 Tests/test_imageqt.py               |   8 +-
 Tests/test_imagesequence.py         |  20 ++--
 Tests/test_imageshow.py             |  18 +--
 Tests/test_imagestat.py             |   6 +-
 Tests/test_imagetk.py               |  12 +-
 Tests/test_imagewin.py              |  16 +--
 Tests/test_imagewin_pointers.py     |   3 +-
 Tests/test_lib_pack.py              |  80 ++++++-------
 Tests/test_map.py                   |   6 +-
 Tests/test_mode_i16.py              |  10 +-
 Tests/test_numpy.py                 |  32 ++---
 Tests/test_pdfparser.py             |  10 +-
 Tests/test_pickle.py                |  17 +--
 Tests/test_psdraw.py                |   7 +-
 Tests/test_qt_image_qapplication.py |   8 +-
 Tests/test_qt_image_toqimage.py     |   4 +-
 Tests/test_sgi_crash.py             |   2 +-
 Tests/test_shell_injection.py       |  11 +-
 Tests/test_tiff_ifdrational.py      |  11 +-
 108 files changed, 1866 insertions(+), 1798 deletions(-)

diff --git a/Tests/bench_cffi_access.py b/Tests/bench_cffi_access.py
index ad15a9739b2..c4ab3bdccb3 100644
--- a/Tests/bench_cffi_access.py
+++ b/Tests/bench_cffi_access.py
@@ -9,21 +9,21 @@
 # Not running this test by default. No DOS against CI.
 
 
-def iterate_get(size, access):
+def iterate_get(size, access) -> None:
     (w, h) = size
     for x in range(w):
         for y in range(h):
             access[(x, y)]
 
 
-def iterate_set(size, access):
+def iterate_set(size, access) -> None:
     (w, h) = size
     for x in range(w):
         for y in range(h):
             access[(x, y)] = (x % 256, y % 256, 0)
 
 
-def timer(func, label, *args):
+def timer(func, label, *args) -> None:
     iterations = 5000
     starttime = time.time()
     for x in range(iterations):
@@ -38,7 +38,7 @@ def timer(func, label, *args):
     )
 
 
-def test_direct():
+def test_direct() -> None:
     im = hopper()
     im.load()
     # im = Image.new("RGB", (2000, 2000), (1, 3, 2))
diff --git a/Tests/test_bmp_reference.py b/Tests/test_bmp_reference.py
index 0da41e85845..22ac9443e86 100644
--- a/Tests/test_bmp_reference.py
+++ b/Tests/test_bmp_reference.py
@@ -10,13 +10,13 @@
 base = os.path.join("Tests", "images", "bmp")
 
 
-def get_files(d, ext=".bmp"):
+def get_files(d, ext: str = ".bmp"):
     return [
         os.path.join(base, d, f) for f in os.listdir(os.path.join(base, d)) if ext in f
     ]
 
 
-def test_bad():
+def test_bad() -> None:
     """These shouldn't crash/dos, but they shouldn't return anything
     either"""
     for f in get_files("b"):
@@ -56,7 +56,7 @@ def test_questionable():
                 raise
 
 
-def test_good():
+def test_good() -> None:
     """These should all work. There's a set of target files in the
     html directory that we can compare against."""
 
diff --git a/Tests/test_box_blur.py b/Tests/test_box_blur.py
index 461e6aaacb3..dfedb48d911 100644
--- a/Tests/test_box_blur.py
+++ b/Tests/test_box_blur.py
@@ -16,18 +16,18 @@
 # fmt: on
 
 
-def test_imageops_box_blur():
+def test_imageops_box_blur() -> None:
     i = sample.filter(ImageFilter.BoxBlur(1))
     assert i.mode == sample.mode
     assert i.size == sample.size
     assert isinstance(i, Image.Image)
 
 
-def box_blur(image, radius=1, n=1):
+def box_blur(image, radius: int = 1, n: int = 1):
     return image._new(image.im.box_blur((radius, radius), n))
 
 
-def assert_image(im, data, delta=0):
+def assert_image(im, data, delta: int = 0) -> None:
     it = iter(im.getdata())
     for data_row in data:
         im_row = [next(it) for _ in range(im.size[0])]
@@ -37,7 +37,7 @@ def assert_image(im, data, delta=0):
         next(it)
 
 
-def assert_blur(im, radius, data, passes=1, delta=0):
+def assert_blur(im, radius, data, passes: int = 1, delta: int = 0) -> None:
     # check grayscale image
     assert_image(box_blur(im, radius, passes), data, delta)
     rgba = Image.merge("RGBA", (im, im, im, im))
@@ -45,7 +45,7 @@ def assert_blur(im, radius, data, passes=1, delta=0):
         assert_image(band, data, delta)
 
 
-def test_color_modes():
+def test_color_modes() -> None:
     with pytest.raises(ValueError):
         box_blur(sample.convert("1"))
     with pytest.raises(ValueError):
@@ -65,7 +65,7 @@ def test_color_modes():
         box_blur(sample.convert("YCbCr"))
 
 
-def test_radius_0():
+def test_radius_0() -> None:
     assert_blur(
         sample,
         0,
@@ -81,7 +81,7 @@ def test_radius_0():
     )
 
 
-def test_radius_0_02():
+def test_radius_0_02() -> None:
     assert_blur(
         sample,
         0.02,
@@ -98,7 +98,7 @@ def test_radius_0_02():
     )
 
 
-def test_radius_0_05():
+def test_radius_0_05() -> None:
     assert_blur(
         sample,
         0.05,
@@ -115,7 +115,7 @@ def test_radius_0_05():
     )
 
 
-def test_radius_0_1():
+def test_radius_0_1() -> None:
     assert_blur(
         sample,
         0.1,
@@ -132,7 +132,7 @@ def test_radius_0_1():
     )
 
 
-def test_radius_0_5():
+def test_radius_0_5() -> None:
     assert_blur(
         sample,
         0.5,
@@ -149,7 +149,7 @@ def test_radius_0_5():
     )
 
 
-def test_radius_1():
+def test_radius_1() -> None:
     assert_blur(
         sample,
         1,
@@ -166,7 +166,7 @@ def test_radius_1():
     )
 
 
-def test_radius_1_5():
+def test_radius_1_5() -> None:
     assert_blur(
         sample,
         1.5,
@@ -183,7 +183,7 @@ def test_radius_1_5():
     )
 
 
-def test_radius_bigger_then_half():
+def test_radius_bigger_then_half() -> None:
     assert_blur(
         sample,
         3,
@@ -200,7 +200,7 @@ def test_radius_bigger_then_half():
     )
 
 
-def test_radius_bigger_then_width():
+def test_radius_bigger_then_width() -> None:
     assert_blur(
         sample,
         10,
@@ -215,7 +215,7 @@ def test_radius_bigger_then_width():
     )
 
 
-def test_extreme_large_radius():
+def test_extreme_large_radius() -> None:
     assert_blur(
         sample,
         600,
@@ -230,7 +230,7 @@ def test_extreme_large_radius():
     )
 
 
-def test_two_passes():
+def test_two_passes() -> None:
     assert_blur(
         sample,
         1,
@@ -248,7 +248,7 @@ def test_two_passes():
     )
 
 
-def test_three_passes():
+def test_three_passes() -> None:
     assert_blur(
         sample,
         1,
diff --git a/Tests/test_color_lut.py b/Tests/test_color_lut.py
index fcd1169ef81..e6c8d7819a6 100644
--- a/Tests/test_color_lut.py
+++ b/Tests/test_color_lut.py
@@ -41,7 +41,7 @@ def generate_identity_table(self, channels, size):
             [item for sublist in table for item in sublist],
         )
 
-    def test_wrong_args(self):
+    def test_wrong_args(self) -> None:
         im = Image.new("RGB", (10, 10), 0)
 
         with pytest.raises(ValueError, match="filter"):
@@ -101,7 +101,7 @@ def test_wrong_args(self):
         with pytest.raises(TypeError):
             im.im.color_lut_3d("RGB", Image.Resampling.BILINEAR, 3, 2, 2, 2, 16)
 
-    def test_correct_args(self):
+    def test_correct_args(self) -> None:
         im = Image.new("RGB", (10, 10), 0)
 
         im.im.color_lut_3d(
@@ -136,7 +136,7 @@ def test_correct_args(self):
             *self.generate_identity_table(3, (3, 3, 65)),
         )
 
-    def test_wrong_mode(self):
+    def test_wrong_mode(self) -> None:
         with pytest.raises(ValueError, match="wrong mode"):
             im = Image.new("L", (10, 10), 0)
             im.im.color_lut_3d(
@@ -167,7 +167,7 @@ def test_wrong_mode(self):
                 "RGB", Image.Resampling.BILINEAR, *self.generate_identity_table(4, 3)
             )
 
-    def test_correct_mode(self):
+    def test_correct_mode(self) -> None:
         im = Image.new("RGBA", (10, 10), 0)
         im.im.color_lut_3d(
             "RGBA", Image.Resampling.BILINEAR, *self.generate_identity_table(3, 3)
@@ -188,7 +188,7 @@ def test_correct_mode(self):
             "RGBA", Image.Resampling.BILINEAR, *self.generate_identity_table(4, 3)
         )
 
-    def test_identities(self):
+    def test_identities(self) -> None:
         g = Image.linear_gradient("L")
         im = Image.merge(
             "RGB",
@@ -224,7 +224,7 @@ def test_identities(self):
             ),
         )
 
-    def test_identities_4_channels(self):
+    def test_identities_4_channels(self) -> None:
         g = Image.linear_gradient("L")
         im = Image.merge(
             "RGB",
@@ -247,7 +247,7 @@ def test_identities_4_channels(self):
             ),
         )
 
-    def test_copy_alpha_channel(self):
+    def test_copy_alpha_channel(self) -> None:
         g = Image.linear_gradient("L")
         im = Image.merge(
             "RGBA",
@@ -270,7 +270,7 @@ def test_copy_alpha_channel(self):
             ),
         )
 
-    def test_channels_order(self):
+    def test_channels_order(self) -> None:
         g = Image.linear_gradient("L")
         im = Image.merge(
             "RGB",
@@ -295,7 +295,7 @@ def test_channels_order(self):
                     ])))
         # fmt: on
 
-    def test_overflow(self):
+    def test_overflow(self) -> None:
         g = Image.linear_gradient("L")
         im = Image.merge(
             "RGB",
@@ -348,7 +348,7 @@ def test_overflow(self):
 
 
 class TestColorLut3DFilter:
-    def test_wrong_args(self):
+    def test_wrong_args(self) -> None:
         with pytest.raises(ValueError, match="should be either an integer"):
             ImageFilter.Color3DLUT("small", [1])
 
@@ -376,7 +376,7 @@ def test_wrong_args(self):
         with pytest.raises(ValueError, match="Only 3 or 4 output"):
             ImageFilter.Color3DLUT((2, 2, 2), [[1, 1]] * 8, channels=2)
 
-    def test_convert_table(self):
+    def test_convert_table(self) -> None:
         lut = ImageFilter.Color3DLUT(2, [0, 1, 2] * 8)
         assert tuple(lut.size) == (2, 2, 2)
         assert lut.name == "Color 3D LUT"
@@ -394,7 +394,7 @@ def test_convert_table(self):
         assert lut.table == list(range(4)) * 8
 
     @pytest.mark.skipif(numpy is None, reason="NumPy not installed")
-    def test_numpy_sources(self):
+    def test_numpy_sources(self) -> None:
         table = numpy.ones((5, 6, 7, 3), dtype=numpy.float16)
         with pytest.raises(ValueError, match="should have either channels"):
             lut = ImageFilter.Color3DLUT((5, 6, 7), table)
@@ -427,7 +427,7 @@ def test_numpy_sources(self):
         assert lut.table[0] == 33
 
     @pytest.mark.skipif(numpy is None, reason="NumPy not installed")
-    def test_numpy_formats(self):
+    def test_numpy_formats(self) -> None:
         g = Image.linear_gradient("L")
         im = Image.merge(
             "RGB",
@@ -466,7 +466,7 @@ def test_numpy_formats(self):
         lut.table = numpy.array(lut.table, dtype=numpy.int8)
         im.filter(lut)
 
-    def test_repr(self):
+    def test_repr(self) -> None:
         lut = ImageFilter.Color3DLUT(2, [0, 1, 2] * 8)
         assert repr(lut) == "<Color3DLUT from list size=2x2x2 channels=3>"
 
@@ -484,7 +484,7 @@ def test_repr(self):
 
 
 class TestGenerateColorLut3D:
-    def test_wrong_channels_count(self):
+    def test_wrong_channels_count(self) -> None:
         with pytest.raises(ValueError, match="3 or 4 output channels"):
             ImageFilter.Color3DLUT.generate(
                 5, channels=2, callback=lambda r, g, b: (r, g, b)
@@ -498,7 +498,7 @@ def test_wrong_channels_count(self):
                 5, channels=4, callback=lambda r, g, b: (r, g, b)
             )
 
-    def test_3_channels(self):
+    def test_3_channels(self) -> None:
         lut = ImageFilter.Color3DLUT.generate(5, lambda r, g, b: (r, g, b))
         assert tuple(lut.size) == (5, 5, 5)
         assert lut.name == "Color 3D LUT"
@@ -508,7 +508,7 @@ def test_3_channels(self):
             1.0, 0.0, 0.0,  0.0, 0.25, 0.0,  0.25, 0.25, 0.0,  0.5, 0.25, 0.0]
         # fmt: on
 
-    def test_4_channels(self):
+    def test_4_channels(self) -> None:
         lut = ImageFilter.Color3DLUT.generate(
             5, channels=4, callback=lambda r, g, b: (b, r, g, (r + g + b) / 2)
         )
@@ -521,7 +521,7 @@ def test_4_channels(self):
         ]
         # fmt: on
 
-    def test_apply(self):
+    def test_apply(self) -> None:
         lut = ImageFilter.Color3DLUT.generate(5, lambda r, g, b: (r, g, b))
 
         g = Image.linear_gradient("L")
@@ -537,7 +537,7 @@ def test_apply(self):
 
 
 class TestTransformColorLut3D:
-    def test_wrong_args(self):
+    def test_wrong_args(self) -> None:
         source = ImageFilter.Color3DLUT.generate(5, lambda r, g, b: (r, g, b))
 
         with pytest.raises(ValueError, match="Only 3 or 4 output"):
@@ -552,7 +552,7 @@ def test_wrong_args(self):
         with pytest.raises(TypeError):
             source.transform(lambda r, g, b, a: (r, g, b))
 
-    def test_target_mode(self):
+    def test_target_mode(self) -> None:
         source = ImageFilter.Color3DLUT.generate(
             2, lambda r, g, b: (r, g, b), target_mode="HSV"
         )
@@ -563,7 +563,7 @@ def test_target_mode(self):
         lut = source.transform(lambda r, g, b: (r, g, b), target_mode="RGB")
         assert lut.mode == "RGB"
 
-    def test_3_to_3_channels(self):
+    def test_3_to_3_channels(self) -> None:
         source = ImageFilter.Color3DLUT.generate((3, 4, 5), lambda r, g, b: (r, g, b))
         lut = source.transform(lambda r, g, b: (r * r, g * g, b * b))
         assert tuple(lut.size) == tuple(source.size)
@@ -571,7 +571,7 @@ def test_3_to_3_channels(self):
         assert lut.table != source.table
         assert lut.table[:10] == [0.0, 0.0, 0.0, 0.25, 0.0, 0.0, 1.0, 0.0, 0.0, 0.0]
 
-    def test_3_to_4_channels(self):
+    def test_3_to_4_channels(self) -> None:
         source = ImageFilter.Color3DLUT.generate((6, 5, 4), lambda r, g, b: (r, g, b))
         lut = source.transform(lambda r, g, b: (r * r, g * g, b * b, 1), channels=4)
         assert tuple(lut.size) == tuple(source.size)
@@ -583,7 +583,7 @@ def test_3_to_4_channels(self):
             0.4**2, 0.0, 0.0, 1,  0.6**2, 0.0, 0.0, 1]
         # fmt: on
 
-    def test_4_to_3_channels(self):
+    def test_4_to_3_channels(self) -> None:
         source = ImageFilter.Color3DLUT.generate(
             (3, 6, 5), lambda r, g, b: (r, g, b, 1), channels=4
         )
@@ -599,7 +599,7 @@ def test_4_to_3_channels(self):
             1.0, 0.96, 1.0,  0.75, 0.96, 1.0,  0.0, 0.96, 1.0]
         # fmt: on
 
-    def test_4_to_4_channels(self):
+    def test_4_to_4_channels(self) -> None:
         source = ImageFilter.Color3DLUT.generate(
             (6, 5, 4), lambda r, g, b: (r, g, b, 1), channels=4
         )
@@ -613,7 +613,7 @@ def test_4_to_4_channels(self):
             0.4**2, 0.0, 0.0, 0.5,  0.6**2, 0.0, 0.0, 0.5]
         # fmt: on
 
-    def test_with_normals_3_channels(self):
+    def test_with_normals_3_channels(self) -> None:
         source = ImageFilter.Color3DLUT.generate(
             (6, 5, 4), lambda r, g, b: (r * r, g * g, b * b)
         )
@@ -629,7 +629,7 @@ def test_with_normals_3_channels(self):
             0.24, 0.0, 0.0,  0.8 - (0.8**2), 0, 0,  0, 0, 0]
         # fmt: on
 
-    def test_with_normals_4_channels(self):
+    def test_with_normals_4_channels(self) -> None:
         source = ImageFilter.Color3DLUT.generate(
             (3, 6, 5), lambda r, g, b: (r * r, g * g, b * b, 1), channels=4
         )
diff --git a/Tests/test_core_resources.py b/Tests/test_core_resources.py
index d3f76fdb1b9..5eabe8f11ba 100644
--- a/Tests/test_core_resources.py
+++ b/Tests/test_core_resources.py
@@ -9,7 +9,7 @@
 from .helper import is_pypy
 
 
-def test_get_stats():
+def test_get_stats() -> None:
     # Create at least one image
     Image.new("RGB", (10, 10))
 
@@ -22,7 +22,7 @@ def test_get_stats():
     assert "blocks_cached" in stats
 
 
-def test_reset_stats():
+def test_reset_stats() -> None:
     Image.core.reset_stats()
 
     stats = Image.core.get_stats()
@@ -35,19 +35,19 @@ def test_reset_stats():
 
 
 class TestCoreMemory:
-    def teardown_method(self):
+    def teardown_method(self) -> None:
         # Restore default values
         Image.core.set_alignment(1)
         Image.core.set_block_size(1024 * 1024)
         Image.core.set_blocks_max(0)
         Image.core.clear_cache()
 
-    def test_get_alignment(self):
+    def test_get_alignment(self) -> None:
         alignment = Image.core.get_alignment()
 
         assert alignment > 0
 
-    def test_set_alignment(self):
+    def test_set_alignment(self) -> None:
         for i in [1, 2, 4, 8, 16, 32]:
             Image.core.set_alignment(i)
             alignment = Image.core.get_alignment()
@@ -63,12 +63,12 @@ def test_set_alignment(self):
         with pytest.raises(ValueError):
             Image.core.set_alignment(3)
 
-    def test_get_block_size(self):
+    def test_get_block_size(self) -> None:
         block_size = Image.core.get_block_size()
 
         assert block_size >= 4096
 
-    def test_set_block_size(self):
+    def test_set_block_size(self) -> None:
         for i in [4096, 2 * 4096, 3 * 4096]:
             Image.core.set_block_size(i)
             block_size = Image.core.get_block_size()
@@ -84,7 +84,7 @@ def test_set_block_size(self):
         with pytest.raises(ValueError):
             Image.core.set_block_size(4000)
 
-    def test_set_block_size_stats(self):
+    def test_set_block_size_stats(self) -> None:
         Image.core.reset_stats()
         Image.core.set_blocks_max(0)
         Image.core.set_block_size(4096)
@@ -96,12 +96,12 @@ def test_set_block_size_stats(self):
         if not is_pypy():
             assert stats["freed_blocks"] >= 64
 
-    def test_get_blocks_max(self):
+    def test_get_blocks_max(self) -> None:
         blocks_max = Image.core.get_blocks_max()
 
         assert blocks_max >= 0
 
-    def test_set_blocks_max(self):
+    def test_set_blocks_max(self) -> None:
         for i in [0, 1, 10]:
             Image.core.set_blocks_max(i)
             blocks_max = Image.core.get_blocks_max()
@@ -117,7 +117,7 @@ def test_set_blocks_max(self):
                 Image.core.set_blocks_max(2**29)
 
     @pytest.mark.skipif(is_pypy(), reason="Images not collected")
-    def test_set_blocks_max_stats(self):
+    def test_set_blocks_max_stats(self) -> None:
         Image.core.reset_stats()
         Image.core.set_blocks_max(128)
         Image.core.set_block_size(4096)
@@ -132,7 +132,7 @@ def test_set_blocks_max_stats(self):
         assert stats["blocks_cached"] == 64
 
     @pytest.mark.skipif(is_pypy(), reason="Images not collected")
-    def test_clear_cache_stats(self):
+    def test_clear_cache_stats(self) -> None:
         Image.core.reset_stats()
         Image.core.clear_cache()
         Image.core.set_blocks_max(128)
@@ -149,7 +149,7 @@ def test_clear_cache_stats(self):
         assert stats["freed_blocks"] >= 48
         assert stats["blocks_cached"] == 16
 
-    def test_large_images(self):
+    def test_large_images(self) -> None:
         Image.core.reset_stats()
         Image.core.set_blocks_max(0)
         Image.core.set_block_size(4096)
@@ -166,14 +166,14 @@ def test_large_images(self):
 
 
 class TestEnvVars:
-    def teardown_method(self):
+    def teardown_method(self) -> None:
         # Restore default values
         Image.core.set_alignment(1)
         Image.core.set_block_size(1024 * 1024)
         Image.core.set_blocks_max(0)
         Image.core.clear_cache()
 
-    def test_units(self):
+    def test_units(self) -> None:
         Image._apply_env_variables({"PILLOW_BLOCKS_MAX": "2K"})
         assert Image.core.get_blocks_max() == 2 * 1024
         Image._apply_env_variables({"PILLOW_BLOCK_SIZE": "2m"})
@@ -187,6 +187,6 @@ def test_units(self):
             {"PILLOW_BLOCKS_MAX": "wat"},
         ),
     )
-    def test_warnings(self, var):
+    def test_warnings(self, var) -> None:
         with pytest.warns(UserWarning):
             Image._apply_env_variables(var)
diff --git a/Tests/test_decompression_bomb.py b/Tests/test_decompression_bomb.py
index d3049eff124..9c21efa45f7 100644
--- a/Tests/test_decompression_bomb.py
+++ b/Tests/test_decompression_bomb.py
@@ -12,16 +12,16 @@
 
 
 class TestDecompressionBomb:
-    def teardown_method(self, method):
+    def teardown_method(self, method) -> None:
         Image.MAX_IMAGE_PIXELS = ORIGINAL_LIMIT
 
-    def test_no_warning_small_file(self):
+    def test_no_warning_small_file(self) -> None:
         # Implicit assert: no warning.
         # A warning would cause a failure.
         with Image.open(TEST_FILE):
             pass
 
-    def test_no_warning_no_limit(self):
+    def test_no_warning_no_limit(self) -> None:
         # Arrange
         # Turn limit off
         Image.MAX_IMAGE_PIXELS = None
@@ -33,7 +33,7 @@ def test_no_warning_no_limit(self):
         with Image.open(TEST_FILE):
             pass
 
-    def test_warning(self):
+    def test_warning(self) -> None:
         # Set limit to trigger warning on the test file
         Image.MAX_IMAGE_PIXELS = 128 * 128 - 1
         assert Image.MAX_IMAGE_PIXELS == 128 * 128 - 1
@@ -42,7 +42,7 @@ def test_warning(self):
             with Image.open(TEST_FILE):
                 pass
 
-    def test_exception(self):
+    def test_exception(self) -> None:
         # Set limit to trigger exception on the test file
         Image.MAX_IMAGE_PIXELS = 64 * 128 - 1
         assert Image.MAX_IMAGE_PIXELS == 64 * 128 - 1
@@ -51,22 +51,22 @@ def test_exception(self):
             with Image.open(TEST_FILE):
                 pass
 
-    def test_exception_ico(self):
+    def test_exception_ico(self) -> None:
         with pytest.raises(Image.DecompressionBombError):
             with Image.open("Tests/images/decompression_bomb.ico"):
                 pass
 
-    def test_exception_gif(self):
+    def test_exception_gif(self) -> None:
         with pytest.raises(Image.DecompressionBombError):
             with Image.open("Tests/images/decompression_bomb.gif"):
                 pass
 
-    def test_exception_gif_extents(self):
+    def test_exception_gif_extents(self) -> None:
         with Image.open("Tests/images/decompression_bomb_extents.gif") as im:
             with pytest.raises(Image.DecompressionBombError):
                 im.seek(1)
 
-    def test_exception_gif_zero_width(self):
+    def test_exception_gif_zero_width(self) -> None:
         # Set limit to trigger exception on the test file
         Image.MAX_IMAGE_PIXELS = 4 * 64 * 128
         assert Image.MAX_IMAGE_PIXELS == 4 * 64 * 128
@@ -75,7 +75,7 @@ def test_exception_gif_zero_width(self):
             with Image.open("Tests/images/zero_width.gif"):
                 pass
 
-    def test_exception_bmp(self):
+    def test_exception_bmp(self) -> None:
         with pytest.raises(Image.DecompressionBombError):
             with Image.open("Tests/images/bmp/b/reallybig.bmp"):
                 pass
@@ -83,15 +83,15 @@ def test_exception_bmp(self):
 
 class TestDecompressionCrop:
     @classmethod
-    def setup_class(cls):
+    def setup_class(cls) -> None:
         width, height = 128, 128
         Image.MAX_IMAGE_PIXELS = height * width * 4 - 1
 
     @classmethod
-    def teardown_class(cls):
+    def teardown_class(cls) -> None:
         Image.MAX_IMAGE_PIXELS = ORIGINAL_LIMIT
 
-    def test_enlarge_crop(self):
+    def test_enlarge_crop(self) -> None:
         # Crops can extend the extents, therefore we should have the
         # same decompression bomb warnings on them.
         with hopper() as src:
@@ -99,7 +99,7 @@ def test_enlarge_crop(self):
             with pytest.warns(Image.DecompressionBombWarning):
                 src.crop(box)
 
-    def test_crop_decompression_checks(self):
+    def test_crop_decompression_checks(self) -> None:
         im = Image.new("RGB", (100, 100))
 
         for value in ((-9999, -9999, -9990, -9990), (-999, -999, -990, -990)):
diff --git a/Tests/test_deprecate.py b/Tests/test_deprecate.py
index 6c7f509a795..6ffc8f6f589 100644
--- a/Tests/test_deprecate.py
+++ b/Tests/test_deprecate.py
@@ -20,12 +20,12 @@
         ),
     ],
 )
-def test_version(version, expected):
+def test_version(version, expected) -> None:
     with pytest.warns(DeprecationWarning, match=expected):
         _deprecate.deprecate("Old thing", version, "new thing")
 
 
-def test_unknown_version():
+def test_unknown_version() -> None:
     expected = r"Unknown removal version: 12345. Update PIL\._deprecate\?"
     with pytest.raises(ValueError, match=expected):
         _deprecate.deprecate("Old thing", 12345, "new thing")
@@ -46,13 +46,13 @@ def test_unknown_version():
         ),
     ],
 )
-def test_old_version(deprecated, plural, expected):
+def test_old_version(deprecated, plural, expected) -> None:
     expected = r""
     with pytest.raises(RuntimeError, match=expected):
         _deprecate.deprecate(deprecated, 1, plural=plural)
 
 
-def test_plural():
+def test_plural() -> None:
     expected = (
         r"Old things are deprecated and will be removed in Pillow 11 \(2024-10-15\)\. "
         r"Use new thing instead\."
@@ -61,7 +61,7 @@ def test_plural():
         _deprecate.deprecate("Old things", 11, "new thing", plural=True)
 
 
-def test_replacement_and_action():
+def test_replacement_and_action() -> None:
     expected = "Use only one of 'replacement' and 'action'"
     with pytest.raises(ValueError, match=expected):
         _deprecate.deprecate(
@@ -76,7 +76,7 @@ def test_replacement_and_action():
         "Upgrade to new thing.",
     ],
 )
-def test_action(action):
+def test_action(action) -> None:
     expected = (
         r"Old thing is deprecated and will be removed in Pillow 11 \(2024-10-15\)\. "
         r"Upgrade to new thing\."
@@ -85,7 +85,7 @@ def test_action(action):
         _deprecate.deprecate("Old thing", 11, action=action)
 
 
-def test_no_replacement_or_action():
+def test_no_replacement_or_action() -> None:
     expected = (
         r"Old thing is deprecated and will be removed in Pillow 11 \(2024-10-15\)"
     )
diff --git a/Tests/test_features.py b/Tests/test_features.py
index b90c1d25f2b..de74e9c1829 100644
--- a/Tests/test_features.py
+++ b/Tests/test_features.py
@@ -15,7 +15,7 @@
     pass
 
 
-def test_check():
+def test_check() -> None:
     # Check the correctness of the convenience function
     for module in features.modules:
         assert features.check_module(module) == features.check(module)
@@ -25,11 +25,11 @@ def test_check():
         assert features.check_feature(feature) == features.check(feature)
 
 
-def test_version():
+def test_version() -> None:
     # Check the correctness of the convenience function
     # and the format of version numbers
 
-    def test(name, function):
+    def test(name, function) -> None:
         version = features.version(name)
         if not features.check(name):
             assert version is None
@@ -47,56 +47,56 @@ def test(name, function):
 
 
 @skip_unless_feature("webp")
-def test_webp_transparency():
+def test_webp_transparency() -> None:
     assert features.check("transp_webp") != _webp.WebPDecoderBuggyAlpha()
     assert features.check("transp_webp") == _webp.HAVE_TRANSPARENCY
 
 
 @skip_unless_feature("webp")
-def test_webp_mux():
+def test_webp_mux() -> None:
     assert features.check("webp_mux") == _webp.HAVE_WEBPMUX
 
 
 @skip_unless_feature("webp")
-def test_webp_anim():
+def test_webp_anim() -> None:
     assert features.check("webp_anim") == _webp.HAVE_WEBPANIM
 
 
 @skip_unless_feature("libjpeg_turbo")
-def test_libjpeg_turbo_version():
+def test_libjpeg_turbo_version() -> None:
     assert re.search(r"\d+\.\d+\.\d+$", features.version("libjpeg_turbo"))
 
 
 @skip_unless_feature("libimagequant")
-def test_libimagequant_version():
+def test_libimagequant_version() -> None:
     assert re.search(r"\d+\.\d+\.\d+$", features.version("libimagequant"))
 
 
 @pytest.mark.parametrize("feature", features.modules)
-def test_check_modules(feature):
+def test_check_modules(feature) -> None:
     assert features.check_module(feature) in [True, False]
 
 
 @pytest.mark.parametrize("feature", features.codecs)
-def test_check_codecs(feature):
+def test_check_codecs(feature) -> None:
     assert features.check_codec(feature) in [True, False]
 
 
-def test_check_warns_on_nonexistent():
+def test_check_warns_on_nonexistent() -> None:
     with pytest.warns(UserWarning) as cm:
         has_feature = features.check("typo")
     assert has_feature is False
     assert str(cm[-1].message) == "Unknown feature 'typo'."
 
 
-def test_supported_modules():
+def test_supported_modules() -> None:
     assert isinstance(features.get_supported_modules(), list)
     assert isinstance(features.get_supported_codecs(), list)
     assert isinstance(features.get_supported_features(), list)
     assert isinstance(features.get_supported(), list)
 
 
-def test_unsupported_codec():
+def test_unsupported_codec() -> None:
     # Arrange
     codec = "unsupported_codec"
     # Act / Assert
@@ -106,7 +106,7 @@ def test_unsupported_codec():
         features.version_codec(codec)
 
 
-def test_unsupported_module():
+def test_unsupported_module() -> None:
     # Arrange
     module = "unsupported_module"
     # Act / Assert
@@ -116,7 +116,7 @@ def test_unsupported_module():
         features.version_module(module)
 
 
-def test_pilinfo():
+def test_pilinfo() -> None:
     buf = io.StringIO()
     features.pilinfo(buf)
     out = buf.getvalue()
diff --git a/Tests/test_file_apng.py b/Tests/test_file_apng.py
index 23263b5d459..f9edf6e9877 100644
--- a/Tests/test_file_apng.py
+++ b/Tests/test_file_apng.py
@@ -1,5 +1,7 @@
 from __future__ import annotations
 
+from pathlib import Path
+
 import pytest
 
 from PIL import Image, ImageSequence, PngImagePlugin
@@ -8,7 +10,7 @@
 # APNG browser support tests and fixtures via:
 # https://philip.html5.org/tests/apng/tests.html
 # (referenced from https://wiki.mozilla.org/APNG_Specification)
-def test_apng_basic():
+def test_apng_basic() -> None:
     with Image.open("Tests/images/apng/single_frame.png") as im:
         assert not im.is_animated
         assert im.n_frames == 1
@@ -45,14 +47,14 @@ def test_apng_basic():
     "filename",
     ("Tests/images/apng/split_fdat.png", "Tests/images/apng/split_fdat_zero_chunk.png"),
 )
-def test_apng_fdat(filename):
+def test_apng_fdat(filename) -> None:
     with Image.open(filename) as im:
         im.seek(im.n_frames - 1)
         assert im.getpixel((0, 0)) == (0, 255, 0, 255)
         assert im.getpixel((64, 32)) == (0, 255, 0, 255)
 
 
-def test_apng_dispose():
+def test_apng_dispose() -> None:
     with Image.open("Tests/images/apng/dispose_op_none.png") as im:
         im.seek(im.n_frames - 1)
         assert im.getpixel((0, 0)) == (0, 255, 0, 255)
@@ -84,7 +86,7 @@ def test_apng_dispose():
         assert im.getpixel((64, 32)) == (0, 0, 0, 0)
 
 
-def test_apng_dispose_region():
+def test_apng_dispose_region() -> None:
     with Image.open("Tests/images/apng/dispose_op_none_region.png") as im:
         im.seek(im.n_frames - 1)
         assert im.getpixel((0, 0)) == (0, 255, 0, 255)
@@ -106,7 +108,7 @@ def test_apng_dispose_region():
         assert im.getpixel((64, 32)) == (0, 255, 0, 255)
 
 
-def test_apng_dispose_op_previous_frame():
+def test_apng_dispose_op_previous_frame() -> None:
     # Test that the dispose settings being used are from the previous frame
     #
     # Image created with:
@@ -131,14 +133,14 @@ def test_apng_dispose_op_previous_frame():
         assert im.getpixel((0, 0)) == (255, 0, 0, 255)
 
 
-def test_apng_dispose_op_background_p_mode():
+def test_apng_dispose_op_background_p_mode() -> None:
     with Image.open("Tests/images/apng/dispose_op_background_p_mode.png") as im:
         im.seek(1)
         im.load()
         assert im.size == (128, 64)
 
 
-def test_apng_blend():
+def test_apng_blend() -> None:
     with Image.open("Tests/images/apng/blend_op_source_solid.png") as im:
         im.seek(im.n_frames - 1)
         assert im.getpixel((0, 0)) == (0, 255, 0, 255)
@@ -165,20 +167,20 @@ def test_apng_blend():
         assert im.getpixel((64, 32)) == (0, 255, 0, 255)
 
 
-def test_apng_blend_transparency():
+def test_apng_blend_transparency() -> None:
     with Image.open("Tests/images/blend_transparency.png") as im:
         im.seek(1)
         assert im.getpixel((0, 0)) == (255, 0, 0)
 
 
-def test_apng_chunk_order():
+def test_apng_chunk_order() -> None:
     with Image.open("Tests/images/apng/fctl_actl.png") as im:
         im.seek(im.n_frames - 1)
         assert im.getpixel((0, 0)) == (0, 255, 0, 255)
         assert im.getpixel((64, 32)) == (0, 255, 0, 255)
 
 
-def test_apng_delay():
+def test_apng_delay() -> None:
     with Image.open("Tests/images/apng/delay.png") as im:
         im.seek(1)
         assert im.info.get("duration") == 500.0
@@ -218,7 +220,7 @@ def test_apng_delay():
         assert im.info.get("duration") == 1000.0
 
 
-def test_apng_num_plays():
+def test_apng_num_plays() -> None:
     with Image.open("Tests/images/apng/num_plays.png") as im:
         assert im.info.get("loop") == 0
 
@@ -226,7 +228,7 @@ def test_apng_num_plays():
         assert im.info.get("loop") == 1
 
 
-def test_apng_mode():
+def test_apng_mode() -> None:
     with Image.open("Tests/images/apng/mode_16bit.png") as im:
         assert im.mode == "RGBA"
         im.seek(im.n_frames - 1)
@@ -267,7 +269,7 @@ def test_apng_mode():
         assert im.getpixel((64, 32)) == (0, 0, 255, 128)
 
 
-def test_apng_chunk_errors():
+def test_apng_chunk_errors() -> None:
     with Image.open("Tests/images/apng/chunk_no_actl.png") as im:
         assert not im.is_animated
 
@@ -292,7 +294,7 @@ def test_apng_chunk_errors():
             im.seek(im.n_frames - 1)
 
 
-def test_apng_syntax_errors():
+def test_apng_syntax_errors() -> None:
     with pytest.warns(UserWarning):
         with Image.open("Tests/images/apng/syntax_num_frames_zero.png") as im:
             assert not im.is_animated
@@ -336,14 +338,14 @@ def test_apng_syntax_errors():
         "sequence_fdat_fctl.png",
     ),
 )
-def test_apng_sequence_errors(test_file):
+def test_apng_sequence_errors(test_file) -> None:
     with pytest.raises(SyntaxError):
         with Image.open(f"Tests/images/apng/{test_file}") as im:
             im.seek(im.n_frames - 1)
             im.load()
 
 
-def test_apng_save(tmp_path):
+def test_apng_save(tmp_path: Path) -> None:
     with Image.open("Tests/images/apng/single_frame.png") as im:
         test_file = str(tmp_path / "temp.png")
         im.save(test_file, save_all=True)
@@ -374,7 +376,7 @@ def test_apng_save(tmp_path):
         assert im.getpixel((64, 32)) == (0, 255, 0, 255)
 
 
-def test_apng_save_alpha(tmp_path):
+def test_apng_save_alpha(tmp_path: Path) -> None:
     test_file = str(tmp_path / "temp.png")
 
     im = Image.new("RGBA", (1, 1), (255, 0, 0, 255))
@@ -388,7 +390,7 @@ def test_apng_save_alpha(tmp_path):
         assert reloaded.getpixel((0, 0)) == (255, 0, 0, 127)
 
 
-def test_apng_save_split_fdat(tmp_path):
+def test_apng_save_split_fdat(tmp_path: Path) -> None:
     # test to make sure we do not generate sequence errors when writing
     # frames with image data spanning multiple fdAT chunks (in this case
     # both the default image and first animation frame will span multiple
@@ -412,7 +414,7 @@ def test_apng_save_split_fdat(tmp_path):
         assert exception is None
 
 
-def test_apng_save_duration_loop(tmp_path):
+def test_apng_save_duration_loop(tmp_path: Path) -> None:
     test_file = str(tmp_path / "temp.png")
     with Image.open("Tests/images/apng/delay.png") as im:
         frames = []
@@ -475,7 +477,7 @@ def test_apng_save_duration_loop(tmp_path):
         assert im.info["duration"] == 600
 
 
-def test_apng_save_disposal(tmp_path):
+def test_apng_save_disposal(tmp_path: Path) -> None:
     test_file = str(tmp_path / "temp.png")
     size = (128, 64)
     red = Image.new("RGBA", size, (255, 0, 0, 255))
@@ -576,7 +578,7 @@ def test_apng_save_disposal(tmp_path):
         assert im.getpixel((64, 32)) == (0, 0, 0, 0)
 
 
-def test_apng_save_disposal_previous(tmp_path):
+def test_apng_save_disposal_previous(tmp_path: Path) -> None:
     test_file = str(tmp_path / "temp.png")
     size = (128, 64)
     blue = Image.new("RGBA", size, (0, 0, 255, 255))
@@ -598,7 +600,7 @@ def test_apng_save_disposal_previous(tmp_path):
         assert im.getpixel((64, 32)) == (0, 255, 0, 255)
 
 
-def test_apng_save_blend(tmp_path):
+def test_apng_save_blend(tmp_path: Path) -> None:
     test_file = str(tmp_path / "temp.png")
     size = (128, 64)
     red = Image.new("RGBA", size, (255, 0, 0, 255))
@@ -666,7 +668,7 @@ def test_apng_save_blend(tmp_path):
         assert im.getpixel((0, 0)) == (0, 255, 0, 255)
 
 
-def test_seek_after_close():
+def test_seek_after_close() -> None:
     im = Image.open("Tests/images/apng/delay.png")
     im.seek(1)
     im.close()
@@ -678,7 +680,9 @@ def test_seek_after_close():
 @pytest.mark.parametrize("mode", ("RGBA", "RGB", "P"))
 @pytest.mark.parametrize("default_image", (True, False))
 @pytest.mark.parametrize("duplicate", (True, False))
-def test_different_modes_in_later_frames(mode, default_image, duplicate, tmp_path):
+def test_different_modes_in_later_frames(
+    mode, default_image, duplicate, tmp_path: Path
+) -> None:
     test_file = str(tmp_path / "temp.png")
 
     im = Image.new("L", (1, 1))
diff --git a/Tests/test_file_blp.py b/Tests/test_file_blp.py
index 27ff7ab6640..3904d3bc5b5 100644
--- a/Tests/test_file_blp.py
+++ b/Tests/test_file_blp.py
@@ -1,5 +1,7 @@
 from __future__ import annotations
 
+from pathlib import Path
+
 import pytest
 
 from PIL import Image
@@ -12,7 +14,7 @@
 )
 
 
-def test_load_blp1():
+def test_load_blp1() -> None:
     with Image.open("Tests/images/blp/blp1_jpeg.blp") as im:
         assert_image_equal_tofile(im, "Tests/images/blp/blp1_jpeg.png")
 
@@ -20,22 +22,22 @@ def test_load_blp1():
         im.load()
 
 
-def test_load_blp2_raw():
+def test_load_blp2_raw() -> None:
     with Image.open("Tests/images/blp/blp2_raw.blp") as im:
         assert_image_equal_tofile(im, "Tests/images/blp/blp2_raw.png")
 
 
-def test_load_blp2_dxt1():
+def test_load_blp2_dxt1() -> None:
     with Image.open("Tests/images/blp/blp2_dxt1.blp") as im:
         assert_image_equal_tofile(im, "Tests/images/blp/blp2_dxt1.png")
 
 
-def test_load_blp2_dxt1a():
+def test_load_blp2_dxt1a() -> None:
     with Image.open("Tests/images/blp/blp2_dxt1a.blp") as im:
         assert_image_equal_tofile(im, "Tests/images/blp/blp2_dxt1a.png")
 
 
-def test_save(tmp_path):
+def test_save(tmp_path: Path) -> None:
     f = str(tmp_path / "temp.blp")
 
     for version in ("BLP1", "BLP2"):
@@ -69,7 +71,7 @@ def test_save(tmp_path):
         "Tests/images/timeout-ef9112a065e7183fa7faa2e18929b03e44ee16bf.blp",
     ],
 )
-def test_crashes(test_file):
+def test_crashes(test_file) -> None:
     with open(test_file, "rb") as f:
         with Image.open(f) as im:
             with pytest.raises(OSError):
diff --git a/Tests/test_file_bmp.py b/Tests/test_file_bmp.py
index 225fb28ba51..c36466e0269 100644
--- a/Tests/test_file_bmp.py
+++ b/Tests/test_file_bmp.py
@@ -1,6 +1,7 @@
 from __future__ import annotations
 
 import io
+from pathlib import Path
 
 import pytest
 
@@ -14,8 +15,8 @@
 )
 
 
-def test_sanity(tmp_path):
-    def roundtrip(im):
+def test_sanity(tmp_path: Path) -> None:
+    def roundtrip(im) -> None:
         outfile = str(tmp_path / "temp.bmp")
 
         im.save(outfile, "BMP")
@@ -35,20 +36,20 @@ def roundtrip(im):
     roundtrip(hopper("RGB"))
 
 
-def test_invalid_file():
+def test_invalid_file() -> None:
     with open("Tests/images/flower.jpg", "rb") as fp:
         with pytest.raises(SyntaxError):
             BmpImagePlugin.BmpImageFile(fp)
 
 
-def test_fallback_if_mmap_errors():
+def test_fallback_if_mmap_errors() -> None:
     # This image has been truncated,
     # so that the buffer is not large enough when using mmap
     with Image.open("Tests/images/mmap_error.bmp") as im:
         assert_image_equal_tofile(im, "Tests/images/pal8_offset.bmp")
 
 
-def test_save_to_bytes():
+def test_save_to_bytes() -> None:
     output = io.BytesIO()
     im = hopper()
     im.save(output, "BMP")
@@ -60,7 +61,7 @@ def test_save_to_bytes():
         assert reloaded.format == "BMP"
 
 
-def test_small_palette(tmp_path):
+def test_small_palette(tmp_path: Path) -> None:
     im = Image.new("P", (1, 1))
     colors = [0, 0, 0, 125, 125, 125, 255, 255, 255]
     im.putpalette(colors)
@@ -72,7 +73,7 @@ def test_small_palette(tmp_path):
         assert reloaded.getpalette() == colors
 
 
-def test_save_too_large(tmp_path):
+def test_save_too_large(tmp_path: Path) -> None:
     outfile = str(tmp_path / "temp.bmp")
     with Image.new("RGB", (1, 1)) as im:
         im._size = (37838, 37838)
@@ -80,7 +81,7 @@ def test_save_too_large(tmp_path):
             im.save(outfile)
 
 
-def test_dpi():
+def test_dpi() -> None:
     dpi = (72, 72)
 
     output = io.BytesIO()
@@ -92,7 +93,7 @@ def test_dpi():
         assert reloaded.info["dpi"] == (72.008961115161, 72.008961115161)
 
 
-def test_save_bmp_with_dpi(tmp_path):
+def test_save_bmp_with_dpi(tmp_path: Path) -> None:
     # Test for #1301
     # Arrange
     outfile = str(tmp_path / "temp.jpg")
@@ -110,7 +111,7 @@ def test_save_bmp_with_dpi(tmp_path):
             assert reloaded.format == "JPEG"
 
 
-def test_save_float_dpi(tmp_path):
+def test_save_float_dpi(tmp_path: Path) -> None:
     outfile = str(tmp_path / "temp.bmp")
     with Image.open("Tests/images/hopper.bmp") as im:
         im.save(outfile, dpi=(72.21216100543306, 72.21216100543306))
@@ -118,7 +119,7 @@ def test_save_float_dpi(tmp_path):
             assert reloaded.info["dpi"] == (72.21216100543306, 72.21216100543306)
 
 
-def test_load_dib():
+def test_load_dib() -> None:
     # test for #1293, Imagegrab returning Unsupported Bitfields Format
     with Image.open("Tests/images/clipboard.dib") as im:
         assert im.format == "DIB"
@@ -127,7 +128,7 @@ def test_load_dib():
         assert_image_equal_tofile(im, "Tests/images/clipboard_target.png")
 
 
-def test_save_dib(tmp_path):
+def test_save_dib(tmp_path: Path) -> None:
     outfile = str(tmp_path / "temp.dib")
 
     with Image.open("Tests/images/clipboard.dib") as im:
@@ -139,7 +140,7 @@ def test_save_dib(tmp_path):
             assert_image_equal(im, reloaded)
 
 
-def test_rgba_bitfields():
+def test_rgba_bitfields() -> None:
     # This test image has been manually hexedited
     # to change the bitfield compression in the header from XBGR to RGBA
     with Image.open("Tests/images/rgb32bf-rgba.bmp") as im:
@@ -157,7 +158,7 @@ def test_rgba_bitfields():
         )
 
 
-def test_rle8():
+def test_rle8() -> None:
     with Image.open("Tests/images/hopper_rle8.bmp") as im:
         assert_image_similar_tofile(im.convert("RGB"), "Tests/images/hopper.bmp", 12)
 
@@ -177,7 +178,7 @@ def test_rle8():
                 im.load()
 
 
-def test_rle4():
+def test_rle4() -> None:
     with Image.open("Tests/images/bmp/g/pal4rle.bmp") as im:
         assert_image_similar_tofile(im, "Tests/images/bmp/g/pal4.bmp", 12)
 
@@ -193,7 +194,7 @@ def test_rle4():
         ("Tests/images/bmp/g/pal8rle.bmp", 1064),
     ),
 )
-def test_rle8_eof(file_name, length):
+def test_rle8_eof(file_name, length) -> None:
     with open(file_name, "rb") as fp:
         data = fp.read(length)
         with Image.open(io.BytesIO(data)) as im:
@@ -201,7 +202,7 @@ def test_rle8_eof(file_name, length):
                 im.load()
 
 
-def test_offset():
+def test_offset() -> None:
     # This image has been hexedited
     # to exclude the palette size from the pixel data offset
     with Image.open("Tests/images/pal8_offset.bmp") as im:
diff --git a/Tests/test_file_bufrstub.py b/Tests/test_file_bufrstub.py
index 45081832e68..3dd24533aae 100644
--- a/Tests/test_file_bufrstub.py
+++ b/Tests/test_file_bufrstub.py
@@ -1,5 +1,7 @@
 from __future__ import annotations
 
+from pathlib import Path
+
 import pytest
 
 from PIL import BufrStubImagePlugin, Image
@@ -9,7 +11,7 @@
 TEST_FILE = "Tests/images/gfs.t06z.rassda.tm00.bufr_d"
 
 
-def test_open():
+def test_open() -> None:
     # Act
     with Image.open(TEST_FILE) as im:
         # Assert
@@ -20,7 +22,7 @@ def test_open():
         assert im.size == (1, 1)
 
 
-def test_invalid_file():
+def test_invalid_file() -> None:
     # Arrange
     invalid_file = "Tests/images/flower.jpg"
 
@@ -29,7 +31,7 @@ def test_invalid_file():
         BufrStubImagePlugin.BufrStubImageFile(invalid_file)
 
 
-def test_load():
+def test_load() -> None:
     # Arrange
     with Image.open(TEST_FILE) as im:
         # Act / Assert: stub cannot load without an implemented handler
@@ -37,7 +39,7 @@ def test_load():
             im.load()
 
 
-def test_save(tmp_path):
+def test_save(tmp_path: Path) -> None:
     # Arrange
     im = hopper()
     tmpfile = str(tmp_path / "temp.bufr")
@@ -47,13 +49,13 @@ def test_save(tmp_path):
         im.save(tmpfile)
 
 
-def test_handler(tmp_path):
+def test_handler(tmp_path: Path) -> None:
     class TestHandler:
         opened = False
         loaded = False
         saved = False
 
-        def open(self, im):
+        def open(self, im) -> None:
             self.opened = True
 
         def load(self, im):
@@ -61,7 +63,7 @@ def load(self, im):
             im.fp.close()
             return Image.new("RGB", (1, 1))
 
-        def save(self, im, fp, filename):
+        def save(self, im, fp, filename) -> None:
             self.saved = True
 
     handler = TestHandler()
diff --git a/Tests/test_file_container.py b/Tests/test_file_container.py
index 95a5b2337d8..4dba4be5d5c 100644
--- a/Tests/test_file_container.py
+++ b/Tests/test_file_container.py
@@ -9,19 +9,19 @@
 TEST_FILE = "Tests/images/dummy.container"
 
 
-def test_sanity():
+def test_sanity() -> None:
     dir(Image)
     dir(ContainerIO)
 
 
-def test_isatty():
+def test_isatty() -> None:
     with hopper() as im:
         container = ContainerIO.ContainerIO(im, 0, 0)
 
     assert container.isatty() is False
 
 
-def test_seek_mode_0():
+def test_seek_mode_0() -> None:
     # Arrange
     mode = 0
     with open(TEST_FILE, "rb") as fh:
@@ -35,7 +35,7 @@ def test_seek_mode_0():
         assert container.tell() == 33
 
 
-def test_seek_mode_1():
+def test_seek_mode_1() -> None:
     # Arrange
     mode = 1
     with open(TEST_FILE, "rb") as fh:
@@ -49,7 +49,7 @@ def test_seek_mode_1():
         assert container.tell() == 66
 
 
-def test_seek_mode_2():
+def test_seek_mode_2() -> None:
     # Arrange
     mode = 2
     with open(TEST_FILE, "rb") as fh:
@@ -64,7 +64,7 @@ def test_seek_mode_2():
 
 
 @pytest.mark.parametrize("bytesmode", (True, False))
-def test_read_n0(bytesmode):
+def test_read_n0(bytesmode) -> None:
     # Arrange
     with open(TEST_FILE, "rb" if bytesmode else "r") as fh:
         container = ContainerIO.ContainerIO(fh, 22, 100)
@@ -80,7 +80,7 @@ def test_read_n0(bytesmode):
 
 
 @pytest.mark.parametrize("bytesmode", (True, False))
-def test_read_n(bytesmode):
+def test_read_n(bytesmode) -> None:
     # Arrange
     with open(TEST_FILE, "rb" if bytesmode else "r") as fh:
         container = ContainerIO.ContainerIO(fh, 22, 100)
@@ -96,7 +96,7 @@ def test_read_n(bytesmode):
 
 
 @pytest.mark.parametrize("bytesmode", (True, False))
-def test_read_eof(bytesmode):
+def test_read_eof(bytesmode) -> None:
     # Arrange
     with open(TEST_FILE, "rb" if bytesmode else "r") as fh:
         container = ContainerIO.ContainerIO(fh, 22, 100)
@@ -112,7 +112,7 @@ def test_read_eof(bytesmode):
 
 
 @pytest.mark.parametrize("bytesmode", (True, False))
-def test_readline(bytesmode):
+def test_readline(bytesmode) -> None:
     # Arrange
     with open(TEST_FILE, "rb" if bytesmode else "r") as fh:
         container = ContainerIO.ContainerIO(fh, 0, 120)
@@ -127,7 +127,7 @@ def test_readline(bytesmode):
 
 
 @pytest.mark.parametrize("bytesmode", (True, False))
-def test_readlines(bytesmode):
+def test_readlines(bytesmode) -> None:
     # Arrange
     expected = [
         "This is line 1\n",
diff --git a/Tests/test_file_dcx.py b/Tests/test_file_dcx.py
index cba7c10bf76..65337cad9b1 100644
--- a/Tests/test_file_dcx.py
+++ b/Tests/test_file_dcx.py
@@ -12,7 +12,7 @@
 TEST_FILE = "Tests/images/hopper.dcx"
 
 
-def test_sanity():
+def test_sanity() -> None:
     # Arrange
 
     # Act
@@ -25,8 +25,8 @@ def test_sanity():
 
 
 @pytest.mark.skipif(is_pypy(), reason="Requires CPython")
-def test_unclosed_file():
-    def open():
+def test_unclosed_file() -> None:
+    def open() -> None:
         im = Image.open(TEST_FILE)
         im.load()
 
@@ -34,26 +34,26 @@ def open():
         open()
 
 
-def test_closed_file():
+def test_closed_file() -> None:
     with warnings.catch_warnings():
         im = Image.open(TEST_FILE)
         im.load()
         im.close()
 
 
-def test_context_manager():
+def test_context_manager() -> None:
     with warnings.catch_warnings():
         with Image.open(TEST_FILE) as im:
             im.load()
 
 
-def test_invalid_file():
+def test_invalid_file() -> None:
     with open("Tests/images/flower.jpg", "rb") as fp:
         with pytest.raises(SyntaxError):
             DcxImagePlugin.DcxImageFile(fp)
 
 
-def test_tell():
+def test_tell() -> None:
     # Arrange
     with Image.open(TEST_FILE) as im:
         # Act
@@ -63,13 +63,13 @@ def test_tell():
         assert frame == 0
 
 
-def test_n_frames():
+def test_n_frames() -> None:
     with Image.open(TEST_FILE) as im:
         assert im.n_frames == 1
         assert not im.is_animated
 
 
-def test_eoferror():
+def test_eoferror() -> None:
     with Image.open(TEST_FILE) as im:
         n_frames = im.n_frames
 
@@ -82,7 +82,7 @@ def test_eoferror():
         im.seek(n_frames - 1)
 
 
-def test_seek_too_far():
+def test_seek_too_far() -> None:
     # Arrange
     with Image.open(TEST_FILE) as im:
         frame = 999  # too big on purpose
diff --git a/Tests/test_file_dds.py b/Tests/test_file_dds.py
index 7064b74c07b..09ee8986aca 100644
--- a/Tests/test_file_dds.py
+++ b/Tests/test_file_dds.py
@@ -2,6 +2,7 @@
 from __future__ import annotations
 
 from io import BytesIO
+from pathlib import Path
 
 import pytest
 
@@ -46,7 +47,7 @@
         TEST_FILE_DX10_BC1_TYPELESS,
     ),
 )
-def test_sanity_dxt1_bc1(image_path):
+def test_sanity_dxt1_bc1(image_path) -> None:
     """Check DXT1 and BC1 images can be opened"""
     with Image.open(TEST_FILE_DXT1.replace(".dds", ".png")) as target:
         target = target.convert("RGBA")
@@ -60,7 +61,7 @@ def test_sanity_dxt1_bc1(image_path):
         assert_image_equal(im, target)
 
 
-def test_sanity_dxt3():
+def test_sanity_dxt3() -> None:
     """Check DXT3 images can be opened"""
 
     with Image.open(TEST_FILE_DXT3) as im:
@@ -73,7 +74,7 @@ def test_sanity_dxt3():
         assert_image_equal_tofile(im, TEST_FILE_DXT3.replace(".dds", ".png"))
 
 
-def test_sanity_dxt5():
+def test_sanity_dxt5() -> None:
     """Check DXT5 images can be opened"""
 
     with Image.open(TEST_FILE_DXT5) as im:
@@ -94,7 +95,7 @@ def test_sanity_dxt5():
         TEST_FILE_BC4U,
     ),
 )
-def test_sanity_ati1_bc4u(image_path):
+def test_sanity_ati1_bc4u(image_path) -> None:
     """Check ATI1 and BC4U images can be opened"""
 
     with Image.open(image_path) as im:
@@ -115,7 +116,7 @@ def test_sanity_ati1_bc4u(image_path):
         TEST_FILE_DX10_BC4_TYPELESS,
     ),
 )
-def test_dx10_bc4(image_path):
+def test_dx10_bc4(image_path) -> None:
     """Check DX10 BC4 images can be opened"""
 
     with Image.open(image_path) as im:
@@ -136,7 +137,7 @@ def test_dx10_bc4(image_path):
         TEST_FILE_BC5U,
     ),
 )
-def test_sanity_ati2_bc5u(image_path):
+def test_sanity_ati2_bc5u(image_path) -> None:
     """Check ATI2 and BC5U images can be opened"""
 
     with Image.open(image_path) as im:
@@ -160,7 +161,7 @@ def test_sanity_ati2_bc5u(image_path):
         (TEST_FILE_BC5S, TEST_FILE_BC5S),
     ),
 )
-def test_dx10_bc5(image_path, expected_path):
+def test_dx10_bc5(image_path, expected_path) -> None:
     """Check DX10 BC5 images can be opened"""
 
     with Image.open(image_path) as im:
@@ -174,7 +175,7 @@ def test_dx10_bc5(image_path, expected_path):
 
 
 @pytest.mark.parametrize("image_path", (TEST_FILE_BC6H, TEST_FILE_BC6HS))
-def test_dx10_bc6h(image_path):
+def test_dx10_bc6h(image_path) -> None:
     """Check DX10 BC6H/BC6HS images can be opened"""
 
     with Image.open(image_path) as im:
@@ -187,7 +188,7 @@ def test_dx10_bc6h(image_path):
         assert_image_equal_tofile(im, image_path.replace(".dds", ".png"))
 
 
-def test_dx10_bc7():
+def test_dx10_bc7() -> None:
     """Check DX10 images can be opened"""
 
     with Image.open(TEST_FILE_DX10_BC7) as im:
@@ -200,7 +201,7 @@ def test_dx10_bc7():
         assert_image_equal_tofile(im, TEST_FILE_DX10_BC7.replace(".dds", ".png"))
 
 
-def test_dx10_bc7_unorm_srgb():
+def test_dx10_bc7_unorm_srgb() -> None:
     """Check DX10 unsigned normalized integer images can be opened"""
 
     with Image.open(TEST_FILE_DX10_BC7_UNORM_SRGB) as im:
@@ -216,7 +217,7 @@ def test_dx10_bc7_unorm_srgb():
         )
 
 
-def test_dx10_r8g8b8a8():
+def test_dx10_r8g8b8a8() -> None:
     """Check DX10 images can be opened"""
 
     with Image.open(TEST_FILE_DX10_R8G8B8A8) as im:
@@ -229,7 +230,7 @@ def test_dx10_r8g8b8a8():
         assert_image_equal_tofile(im, TEST_FILE_DX10_R8G8B8A8.replace(".dds", ".png"))
 
 
-def test_dx10_r8g8b8a8_unorm_srgb():
+def test_dx10_r8g8b8a8_unorm_srgb() -> None:
     """Check DX10 unsigned normalized integer images can be opened"""
 
     with Image.open(TEST_FILE_DX10_R8G8B8A8_UNORM_SRGB) as im:
@@ -255,7 +256,7 @@ def test_dx10_r8g8b8a8_unorm_srgb():
         ("RGBA", (800, 600), TEST_FILE_UNCOMPRESSED_RGB_WITH_ALPHA),
     ],
 )
-def test_uncompressed(mode, size, test_file):
+def test_uncompressed(mode, size, test_file) -> None:
     """Check uncompressed images can be opened"""
 
     with Image.open(test_file) as im:
@@ -266,7 +267,7 @@ def test_uncompressed(mode, size, test_file):
         assert_image_equal_tofile(im, test_file.replace(".dds", ".png"))
 
 
-def test__accept_true():
+def test__accept_true() -> None:
     """Check valid prefix"""
     # Arrange
     prefix = b"DDS etc"
@@ -278,7 +279,7 @@ def test__accept_true():
     assert output
 
 
-def test__accept_false():
+def test__accept_false() -> None:
     """Check invalid prefix"""
     # Arrange
     prefix = b"something invalid"
@@ -290,19 +291,19 @@ def test__accept_false():
     assert not output
 
 
-def test_invalid_file():
+def test_invalid_file() -> None:
     invalid_file = "Tests/images/flower.jpg"
 
     with pytest.raises(SyntaxError):
         DdsImagePlugin.DdsImageFile(invalid_file)
 
 
-def test_short_header():
+def test_short_header() -> None:
     """Check a short header"""
     with open(TEST_FILE_DXT5, "rb") as f:
         img_file = f.read()
 
-    def short_header():
+    def short_header() -> None:
         with Image.open(BytesIO(img_file[:119])):
             pass  # pragma: no cover
 
@@ -310,13 +311,13 @@ def short_header():
         short_header()
 
 
-def test_short_file():
+def test_short_file() -> None:
     """Check that the appropriate error is thrown for a short file"""
 
     with open(TEST_FILE_DXT5, "rb") as f:
         img_file = f.read()
 
-    def short_file():
+    def short_file() -> None:
         with Image.open(BytesIO(img_file[:-100])) as im:
             im.load()
 
@@ -324,7 +325,7 @@ def short_file():
         short_file()
 
 
-def test_dxt5_colorblock_alpha_issue_4142():
+def test_dxt5_colorblock_alpha_issue_4142() -> None:
     """Check that colorblocks are decoded correctly in DXT5"""
 
     with Image.open("Tests/images/dxt5-colorblock-alpha-issue-4142.dds") as im:
@@ -339,12 +340,12 @@ def test_dxt5_colorblock_alpha_issue_4142():
         assert px[2] != 0
 
 
-def test_palette():
+def test_palette() -> None:
     with Image.open("Tests/images/palette.dds") as im:
         assert_image_equal_tofile(im, "Tests/images/transparent.gif")
 
 
-def test_unsupported_bitcount():
+def test_unsupported_bitcount() -> None:
     with pytest.raises(OSError):
         with Image.open("Tests/images/unsupported_bitcount.dds"):
             pass
@@ -357,13 +358,13 @@ def test_unsupported_bitcount():
         "Tests/images/unimplemented_pfflags.dds",
     ),
 )
-def test_not_implemented(test_file):
+def test_not_implemented(test_file) -> None:
     with pytest.raises(NotImplementedError):
         with Image.open(test_file):
             pass
 
 
-def test_save_unsupported_mode(tmp_path):
+def test_save_unsupported_mode(tmp_path: Path) -> None:
     out = str(tmp_path / "temp.dds")
     im = hopper("HSV")
     with pytest.raises(OSError):
@@ -379,7 +380,7 @@ def test_save_unsupported_mode(tmp_path):
         ("RGBA", "Tests/images/pil123rgba.png"),
     ],
 )
-def test_save(mode, test_file, tmp_path):
+def test_save(mode, test_file, tmp_path: Path) -> None:
     out = str(tmp_path / "temp.dds")
     with Image.open(test_file) as im:
         assert im.mode == mode
diff --git a/Tests/test_file_eps.py b/Tests/test_file_eps.py
index 8def9a43511..06f927c7bb2 100644
--- a/Tests/test_file_eps.py
+++ b/Tests/test_file_eps.py
@@ -1,6 +1,7 @@
 from __future__ import annotations
 
 import io
+from pathlib import Path
 
 import pytest
 
@@ -83,7 +84,7 @@
     ("filename", "size"), ((FILE1, (460, 352)), (FILE2, (360, 252)))
 )
 @pytest.mark.parametrize("scale", (1, 2))
-def test_sanity(filename, size, scale):
+def test_sanity(filename, size, scale) -> None:
     expected_size = tuple(s * scale for s in size)
     with Image.open(filename) as image:
         image.load(scale=scale)
@@ -93,7 +94,7 @@ def test_sanity(filename, size, scale):
 
 
 @pytest.mark.skipif(not HAS_GHOSTSCRIPT, reason="Ghostscript not available")
-def test_load():
+def test_load() -> None:
     with Image.open(FILE1) as im:
         assert im.load()[0, 0] == (255, 255, 255)
 
@@ -101,7 +102,7 @@ def test_load():
         assert im.load()[0, 0] == (255, 255, 255)
 
 
-def test_binary():
+def test_binary() -> None:
     if HAS_GHOSTSCRIPT:
         assert EpsImagePlugin.gs_binary is not None
     else:
@@ -115,41 +116,41 @@ def test_binary():
         assert EpsImagePlugin.gs_windows_binary is not None
 
 
-def test_invalid_file():
+def test_invalid_file() -> None:
     invalid_file = "Tests/images/flower.jpg"
     with pytest.raises(SyntaxError):
         EpsImagePlugin.EpsImageFile(invalid_file)
 
 
-def test_binary_header_only():
+def test_binary_header_only() -> None:
     data = io.BytesIO(simple_binary_header)
     with pytest.raises(SyntaxError, match='EPS header missing "%!PS-Adobe" comment'):
         EpsImagePlugin.EpsImageFile(data)
 
 
 @pytest.mark.parametrize("prefix", (b"", simple_binary_header))
-def test_missing_version_comment(prefix):
+def test_missing_version_comment(prefix) -> None:
     data = io.BytesIO(prefix + b"\n".join(simple_eps_file_without_version))
     with pytest.raises(SyntaxError):
         EpsImagePlugin.EpsImageFile(data)
 
 
 @pytest.mark.parametrize("prefix", (b"", simple_binary_header))
-def test_missing_boundingbox_comment(prefix):
+def test_missing_boundingbox_comment(prefix) -> None:
     data = io.BytesIO(prefix + b"\n".join(simple_eps_file_without_boundingbox))
     with pytest.raises(SyntaxError, match='EPS header missing "%%BoundingBox" comment'):
         EpsImagePlugin.EpsImageFile(data)
 
 
 @pytest.mark.parametrize("prefix", (b"", simple_binary_header))
-def test_invalid_boundingbox_comment(prefix):
+def test_invalid_boundingbox_comment(prefix) -> None:
     data = io.BytesIO(prefix + b"\n".join(simple_eps_file_with_invalid_boundingbox))
     with pytest.raises(OSError, match="cannot determine EPS bounding box"):
         EpsImagePlugin.EpsImageFile(data)
 
 
 @pytest.mark.parametrize("prefix", (b"", simple_binary_header))
-def test_invalid_boundingbox_comment_valid_imagedata_comment(prefix):
+def test_invalid_boundingbox_comment_valid_imagedata_comment(prefix) -> None:
     data = io.BytesIO(
         prefix + b"\n".join(simple_eps_file_with_invalid_boundingbox_valid_imagedata)
     )
@@ -160,21 +161,21 @@ def test_invalid_boundingbox_comment_valid_imagedata_comment(prefix):
 
 
 @pytest.mark.parametrize("prefix", (b"", simple_binary_header))
-def test_ascii_comment_too_long(prefix):
+def test_ascii_comment_too_long(prefix) -> None:
     data = io.BytesIO(prefix + b"\n".join(simple_eps_file_with_long_ascii_comment))
     with pytest.raises(SyntaxError, match="not an EPS file"):
         EpsImagePlugin.EpsImageFile(data)
 
 
 @pytest.mark.parametrize("prefix", (b"", simple_binary_header))
-def test_long_binary_data(prefix):
+def test_long_binary_data(prefix) -> None:
     data = io.BytesIO(prefix + b"\n".join(simple_eps_file_with_long_binary_data))
     EpsImagePlugin.EpsImageFile(data)
 
 
 @pytest.mark.skipif(not HAS_GHOSTSCRIPT, reason="Ghostscript not available")
 @pytest.mark.parametrize("prefix", (b"", simple_binary_header))
-def test_load_long_binary_data(prefix):
+def test_load_long_binary_data(prefix) -> None:
     data = io.BytesIO(prefix + b"\n".join(simple_eps_file_with_long_binary_data))
     with Image.open(data) as img:
         img.load()
@@ -187,7 +188,7 @@ def test_load_long_binary_data(prefix):
     pytest.mark.valgrind_known_error, "libjpeg_turbo", "2.0", reason="Known Failing"
 )
 @pytest.mark.skipif(not HAS_GHOSTSCRIPT, reason="Ghostscript not available")
-def test_cmyk():
+def test_cmyk() -> None:
     with Image.open("Tests/images/pil_sample_cmyk.eps") as cmyk_image:
         assert cmyk_image.mode == "CMYK"
         assert cmyk_image.size == (100, 100)
@@ -203,7 +204,7 @@ def test_cmyk():
 
 
 @pytest.mark.skipif(not HAS_GHOSTSCRIPT, reason="Ghostscript not available")
-def test_showpage():
+def test_showpage() -> None:
     # See https://github.com/python-pillow/Pillow/issues/2615
     with Image.open("Tests/images/reqd_showpage.eps") as plot_image:
         with Image.open("Tests/images/reqd_showpage.png") as target:
@@ -214,7 +215,7 @@ def test_showpage():
 
 
 @pytest.mark.skipif(not HAS_GHOSTSCRIPT, reason="Ghostscript not available")
-def test_transparency():
+def test_transparency() -> None:
     with Image.open("Tests/images/reqd_showpage.eps") as plot_image:
         plot_image.load(transparency=True)
         assert plot_image.mode == "RGBA"
@@ -225,7 +226,7 @@ def test_transparency():
 
 
 @pytest.mark.skipif(not HAS_GHOSTSCRIPT, reason="Ghostscript not available")
-def test_file_object(tmp_path):
+def test_file_object(tmp_path: Path) -> None:
     # issue 479
     with Image.open(FILE1) as image1:
         with open(str(tmp_path / "temp.eps"), "wb") as fh:
@@ -233,7 +234,7 @@ def test_file_object(tmp_path):
 
 
 @pytest.mark.skipif(not HAS_GHOSTSCRIPT, reason="Ghostscript not available")
-def test_bytesio_object():
+def test_bytesio_object() -> None:
     with open(FILE1, "rb") as f:
         img_bytes = io.BytesIO(f.read())
 
@@ -246,12 +247,12 @@ def test_bytesio_object():
         assert_image_similar(img, image1_scale1_compare, 5)
 
 
-def test_1_mode():
+def test_1_mode() -> None:
     with Image.open("Tests/images/1.eps") as im:
         assert im.mode == "1"
 
 
-def test_image_mode_not_supported(tmp_path):
+def test_image_mode_not_supported(tmp_path: Path) -> None:
     im = hopper("RGBA")
     tmpfile = str(tmp_path / "temp.eps")
     with pytest.raises(ValueError):
@@ -260,7 +261,7 @@ def test_image_mode_not_supported(tmp_path):
 
 @pytest.mark.skipif(not HAS_GHOSTSCRIPT, reason="Ghostscript not available")
 @skip_unless_feature("zlib")
-def test_render_scale1():
+def test_render_scale1() -> None:
     # We need png support for these render test
 
     # Zero bounding box
@@ -282,7 +283,7 @@ def test_render_scale1():
 
 @pytest.mark.skipif(not HAS_GHOSTSCRIPT, reason="Ghostscript not available")
 @skip_unless_feature("zlib")
-def test_render_scale2():
+def test_render_scale2() -> None:
     # We need png support for these render test
 
     # Zero bounding box
@@ -304,7 +305,7 @@ def test_render_scale2():
 
 @pytest.mark.skipif(not HAS_GHOSTSCRIPT, reason="Ghostscript not available")
 @pytest.mark.parametrize("filename", (FILE1, FILE2, "Tests/images/illu10_preview.eps"))
-def test_resize(filename):
+def test_resize(filename) -> None:
     with Image.open(filename) as im:
         new_size = (100, 100)
         im = im.resize(new_size)
@@ -313,7 +314,7 @@ def test_resize(filename):
 
 @pytest.mark.skipif(not HAS_GHOSTSCRIPT, reason="Ghostscript not available")
 @pytest.mark.parametrize("filename", (FILE1, FILE2))
-def test_thumbnail(filename):
+def test_thumbnail(filename) -> None:
     # Issue #619
     with Image.open(filename) as im:
         new_size = (100, 100)
@@ -321,20 +322,20 @@ def test_thumbnail(filename):
         assert max(im.size) == max(new_size)
 
 
-def test_read_binary_preview():
+def test_read_binary_preview() -> None:
     # Issue 302
     # open image with binary preview
     with Image.open(FILE3):
         pass
 
 
-def test_readline_psfile(tmp_path):
+def test_readline_psfile(tmp_path: Path) -> None:
     # check all the freaking line endings possible from the spec
     # test_string = u'something\r\nelse\n\rbaz\rbif\n'
     line_endings = ["\r\n", "\n", "\n\r", "\r"]
     strings = ["something", "else", "baz", "bif"]
 
-    def _test_readline(t, ending):
+    def _test_readline(t, ending) -> None:
         ending = "Failure with line ending: %s" % (
             "".join("%s" % ord(s) for s in ending)
         )
@@ -343,13 +344,13 @@ def _test_readline(t, ending):
         assert t.readline().strip("\r\n") == "baz", ending
         assert t.readline().strip("\r\n") == "bif", ending
 
-    def _test_readline_io_psfile(test_string, ending):
+    def _test_readline_io_psfile(test_string, ending) -> None:
         f = io.BytesIO(test_string.encode("latin-1"))
         with pytest.warns(DeprecationWarning):
             t = EpsImagePlugin.PSFile(f)
         _test_readline(t, ending)
 
-    def _test_readline_file_psfile(test_string, ending):
+    def _test_readline_file_psfile(test_string, ending) -> None:
         f = str(tmp_path / "temp.txt")
         with open(f, "wb") as w:
             w.write(test_string.encode("latin-1"))
@@ -365,7 +366,7 @@ def _test_readline_file_psfile(test_string, ending):
         _test_readline_file_psfile(s, ending)
 
 
-def test_psfile_deprecation():
+def test_psfile_deprecation() -> None:
     with pytest.warns(DeprecationWarning):
         EpsImagePlugin.PSFile(None)
 
@@ -375,7 +376,7 @@ def test_psfile_deprecation():
     "line_ending",
     (b"\r\n", b"\n", b"\n\r", b"\r"),
 )
-def test_readline(prefix, line_ending):
+def test_readline(prefix, line_ending) -> None:
     simple_file = prefix + line_ending.join(simple_eps_file_with_comments)
     data = io.BytesIO(simple_file)
     test_file = EpsImagePlugin.EpsImageFile(data)
@@ -393,14 +394,14 @@ def test_readline(prefix, line_ending):
         "Tests/images/illuCS6_preview.eps",
     ),
 )
-def test_open_eps(filename):
+def test_open_eps(filename) -> None:
     # https://github.com/python-pillow/Pillow/issues/1104
     with Image.open(filename) as img:
         assert img.mode == "RGB"
 
 
 @pytest.mark.skipif(not HAS_GHOSTSCRIPT, reason="Ghostscript not available")
-def test_emptyline():
+def test_emptyline() -> None:
     # Test file includes an empty line in the header data
     emptyline_file = "Tests/images/zero_bb_emptyline.eps"
 
@@ -416,14 +417,14 @@ def test_emptyline():
     "test_file",
     ["Tests/images/timeout-d675703545fee17acab56e5fec644c19979175de.eps"],
 )
-def test_timeout(test_file):
+def test_timeout(test_file) -> None:
     with open(test_file, "rb") as f:
         with pytest.raises(Image.UnidentifiedImageError):
             with Image.open(f):
                 pass
 
 
-def test_bounding_box_in_trailer():
+def test_bounding_box_in_trailer() -> None:
     # Check bounding boxes are parsed in the same way
     # when specified in the header and the trailer
     with Image.open("Tests/images/zero_bb_trailer.eps") as trailer_image, Image.open(
@@ -432,7 +433,7 @@ def test_bounding_box_in_trailer():
         assert trailer_image.size == header_image.size
 
 
-def test_eof_before_bounding_box():
+def test_eof_before_bounding_box() -> None:
     with pytest.raises(OSError):
         with Image.open("Tests/images/zero_bb_eof_before_boundingbox.eps"):
             pass
diff --git a/Tests/test_file_fits.py b/Tests/test_file_fits.py
index 7444eb673cb..cce0b05cda8 100644
--- a/Tests/test_file_fits.py
+++ b/Tests/test_file_fits.py
@@ -11,7 +11,7 @@
 TEST_FILE = "Tests/images/hopper.fits"
 
 
-def test_open():
+def test_open() -> None:
     # Act
     with Image.open(TEST_FILE) as im:
         # Assert
@@ -22,7 +22,7 @@ def test_open():
         assert_image_equal(im, hopper("L"))
 
 
-def test_invalid_file():
+def test_invalid_file() -> None:
     # Arrange
     invalid_file = "Tests/images/flower.jpg"
 
@@ -31,14 +31,14 @@ def test_invalid_file():
         FitsImagePlugin.FitsImageFile(invalid_file)
 
 
-def test_truncated_fits():
+def test_truncated_fits() -> None:
     # No END to headers
     image_data = b"SIMPLE  =                    T" + b" " * 50 + b"TRUNCATE"
     with pytest.raises(OSError):
         FitsImagePlugin.FitsImageFile(BytesIO(image_data))
 
 
-def test_naxis_zero():
+def test_naxis_zero() -> None:
     # This test image has been manually hexedited
     # to set the number of data axes to zero
     with pytest.raises(ValueError):
@@ -46,7 +46,7 @@ def test_naxis_zero():
             pass
 
 
-def test_comment():
+def test_comment() -> None:
     image_data = b"SIMPLE  =                    T / comment string"
     with pytest.raises(OSError):
         FitsImagePlugin.FitsImageFile(BytesIO(image_data))
diff --git a/Tests/test_file_fli.py b/Tests/test_file_fli.py
index 00377e0c92d..a673d4af851 100644
--- a/Tests/test_file_fli.py
+++ b/Tests/test_file_fli.py
@@ -16,7 +16,7 @@
 animated_test_file = "Tests/images/a.fli"
 
 
-def test_sanity():
+def test_sanity() -> None:
     with Image.open(static_test_file) as im:
         im.load()
         assert im.mode == "P"
@@ -33,8 +33,8 @@ def test_sanity():
 
 
 @pytest.mark.skipif(is_pypy(), reason="Requires CPython")
-def test_unclosed_file():
-    def open():
+def test_unclosed_file() -> None:
+    def open() -> None:
         im = Image.open(static_test_file)
         im.load()
 
@@ -42,14 +42,14 @@ def open():
         open()
 
 
-def test_closed_file():
+def test_closed_file() -> None:
     with warnings.catch_warnings():
         im = Image.open(static_test_file)
         im.load()
         im.close()
 
 
-def test_seek_after_close():
+def test_seek_after_close() -> None:
     im = Image.open(animated_test_file)
     im.seek(1)
     im.close()
@@ -58,13 +58,13 @@ def test_seek_after_close():
         im.seek(0)
 
 
-def test_context_manager():
+def test_context_manager() -> None:
     with warnings.catch_warnings():
         with Image.open(static_test_file) as im:
             im.load()
 
 
-def test_tell():
+def test_tell() -> None:
     # Arrange
     with Image.open(static_test_file) as im:
         # Act
@@ -74,20 +74,20 @@ def test_tell():
         assert frame == 0
 
 
-def test_invalid_file():
+def test_invalid_file() -> None:
     invalid_file = "Tests/images/flower.jpg"
 
     with pytest.raises(SyntaxError):
         FliImagePlugin.FliImageFile(invalid_file)
 
 
-def test_palette_chunk_second():
+def test_palette_chunk_second() -> None:
     with Image.open("Tests/images/hopper_palette_chunk_second.fli") as im:
         with Image.open(static_test_file) as expected:
             assert_image_equal(im.convert("RGB"), expected.convert("RGB"))
 
 
-def test_n_frames():
+def test_n_frames() -> None:
     with Image.open(static_test_file) as im:
         assert im.n_frames == 1
         assert not im.is_animated
@@ -97,7 +97,7 @@ def test_n_frames():
         assert im.is_animated
 
 
-def test_eoferror():
+def test_eoferror() -> None:
     with Image.open(animated_test_file) as im:
         n_frames = im.n_frames
 
@@ -110,7 +110,7 @@ def test_eoferror():
         im.seek(n_frames - 1)
 
 
-def test_seek_tell():
+def test_seek_tell() -> None:
     with Image.open(animated_test_file) as im:
         layer_number = im.tell()
         assert layer_number == 0
@@ -132,7 +132,7 @@ def test_seek_tell():
         assert layer_number == 1
 
 
-def test_seek():
+def test_seek() -> None:
     with Image.open(animated_test_file) as im:
         im.seek(50)
 
@@ -147,7 +147,7 @@ def test_seek():
     ],
 )
 @pytest.mark.timeout(timeout=3)
-def test_timeouts(test_file):
+def test_timeouts(test_file) -> None:
     with open(test_file, "rb") as f:
         with Image.open(f) as im:
             with pytest.raises(OSError):
@@ -160,7 +160,7 @@ def test_timeouts(test_file):
         "Tests/images/crash-5762152299364352.fli",
     ],
 )
-def test_crash(test_file):
+def test_crash(test_file) -> None:
     with open(test_file, "rb") as f:
         with Image.open(f) as im:
             with pytest.raises(OSError):
diff --git a/Tests/test_file_fpx.py b/Tests/test_file_fpx.py
index d710070c01b..e32f30a0123 100644
--- a/Tests/test_file_fpx.py
+++ b/Tests/test_file_fpx.py
@@ -11,7 +11,7 @@
 )
 
 
-def test_sanity():
+def test_sanity() -> None:
     with Image.open("Tests/images/input_bw_one_band.fpx") as im:
         assert im.mode == "L"
         assert im.size == (70, 46)
@@ -20,7 +20,7 @@ def test_sanity():
         assert_image_equal_tofile(im, "Tests/images/input_bw_one_band.png")
 
 
-def test_close():
+def test_close() -> None:
     with Image.open("Tests/images/input_bw_one_band.fpx") as im:
         pass
     assert im.ole.fp.closed
@@ -30,7 +30,7 @@ def test_close():
     assert im.ole.fp.closed
 
 
-def test_invalid_file():
+def test_invalid_file() -> None:
     # Test an invalid OLE file
     invalid_file = "Tests/images/flower.jpg"
     with pytest.raises(SyntaxError):
@@ -42,7 +42,7 @@ def test_invalid_file():
         FpxImagePlugin.FpxImageFile(ole_file)
 
 
-def test_fpx_invalid_number_of_bands():
+def test_fpx_invalid_number_of_bands() -> None:
     with pytest.raises(OSError, match="Invalid number of bands"):
         with Image.open("Tests/images/input_bw_five_bands.fpx"):
             pass
diff --git a/Tests/test_file_gif.py b/Tests/test_file_gif.py
index 3e19940aab9..3f550fd1109 100644
--- a/Tests/test_file_gif.py
+++ b/Tests/test_file_gif.py
@@ -2,6 +2,7 @@
 
 import warnings
 from io import BytesIO
+from pathlib import Path
 
 import pytest
 
@@ -23,7 +24,7 @@
     data = f.read()
 
 
-def test_sanity():
+def test_sanity() -> None:
     with Image.open(TEST_GIF) as im:
         im.load()
         assert im.mode == "P"
@@ -33,8 +34,8 @@ def test_sanity():
 
 
 @pytest.mark.skipif(is_pypy(), reason="Requires CPython")
-def test_unclosed_file():
-    def open():
+def test_unclosed_file() -> None:
+    def open() -> None:
         im = Image.open(TEST_GIF)
         im.load()
 
@@ -42,14 +43,14 @@ def open():
         open()
 
 
-def test_closed_file():
+def test_closed_file() -> None:
     with warnings.catch_warnings():
         im = Image.open(TEST_GIF)
         im.load()
         im.close()
 
 
-def test_seek_after_close():
+def test_seek_after_close() -> None:
     im = Image.open("Tests/images/iss634.gif")
     im.load()
     im.close()
@@ -62,20 +63,20 @@ def test_seek_after_close():
         im.seek(1)
 
 
-def test_context_manager():
+def test_context_manager() -> None:
     with warnings.catch_warnings():
         with Image.open(TEST_GIF) as im:
             im.load()
 
 
-def test_invalid_file():
+def test_invalid_file() -> None:
     invalid_file = "Tests/images/flower.jpg"
 
     with pytest.raises(SyntaxError):
         GifImagePlugin.GifImageFile(invalid_file)
 
 
-def test_l_mode_transparency():
+def test_l_mode_transparency() -> None:
     with Image.open("Tests/images/no_palette_with_transparency.gif") as im:
         assert im.mode == "L"
         assert im.load()[0, 0] == 128
@@ -86,7 +87,7 @@ def test_l_mode_transparency():
         assert im.load()[0, 0] == 128
 
 
-def test_l_mode_after_rgb():
+def test_l_mode_after_rgb() -> None:
     with Image.open("Tests/images/no_palette_after_rgb.gif") as im:
         im.seek(1)
         assert im.mode == "RGB"
@@ -95,13 +96,13 @@ def test_l_mode_after_rgb():
         assert im.mode == "RGB"
 
 
-def test_palette_not_needed_for_second_frame():
+def test_palette_not_needed_for_second_frame() -> None:
     with Image.open("Tests/images/palette_not_needed_for_second_frame.gif") as im:
         im.seek(1)
         assert_image_similar(im, hopper("L").convert("RGB"), 8)
 
 
-def test_strategy():
+def test_strategy() -> None:
     with Image.open("Tests/images/iss634.gif") as im:
         expected_rgb_always = im.convert("RGB")
 
@@ -142,7 +143,7 @@ def test_strategy():
         GifImagePlugin.LOADING_STRATEGY = GifImagePlugin.LoadingStrategy.RGB_AFTER_FIRST
 
 
-def test_optimize():
+def test_optimize() -> None:
     def test_grayscale(optimize):
         im = Image.new("L", (1, 1), 0)
         filename = BytesIO()
@@ -177,7 +178,7 @@ def test_bilevel(optimize):
         (4, 513, 256),
     ),
 )
-def test_optimize_correctness(colors, size, expected_palette_length):
+def test_optimize_correctness(colors, size, expected_palette_length) -> None:
     # 256 color Palette image, posterize to > 128 and < 128 levels.
     # Size bigger and smaller than 512x512.
     # Check the palette for number of colors allocated.
@@ -199,14 +200,14 @@ def test_optimize_correctness(colors, size, expected_palette_length):
         assert_image_equal(im.convert("RGB"), reloaded.convert("RGB"))
 
 
-def test_optimize_full_l():
+def test_optimize_full_l() -> None:
     im = Image.frombytes("L", (16, 16), bytes(range(256)))
     test_file = BytesIO()
     im.save(test_file, "GIF", optimize=True)
     assert im.mode == "L"
 
 
-def test_optimize_if_palette_can_be_reduced_by_half():
+def test_optimize_if_palette_can_be_reduced_by_half() -> None:
     im = Image.new("P", (8, 1))
     im.palette = ImagePalette.raw("RGB", bytes((0, 0, 0) * 150))
     for i in range(8):
@@ -219,7 +220,7 @@ def test_optimize_if_palette_can_be_reduced_by_half():
             assert len(reloaded.palette.palette) // 3 == colors
 
 
-def test_full_palette_second_frame(tmp_path):
+def test_full_palette_second_frame(tmp_path: Path) -> None:
     out = str(tmp_path / "temp.gif")
     im = Image.new("P", (1, 256))
 
@@ -240,7 +241,7 @@ def test_full_palette_second_frame(tmp_path):
             reloaded.getpixel((0, i)) == i
 
 
-def test_roundtrip(tmp_path):
+def test_roundtrip(tmp_path: Path) -> None:
     out = str(tmp_path / "temp.gif")
     im = hopper()
     im.save(out)
@@ -248,7 +249,7 @@ def test_roundtrip(tmp_path):
         assert_image_similar(reread.convert("RGB"), im, 50)
 
 
-def test_roundtrip2(tmp_path):
+def test_roundtrip2(tmp_path: Path) -> None:
     # see https://github.com/python-pillow/Pillow/issues/403
     out = str(tmp_path / "temp.gif")
     with Image.open(TEST_GIF) as im:
@@ -258,7 +259,7 @@ def test_roundtrip2(tmp_path):
         assert_image_similar(reread.convert("RGB"), hopper(), 50)
 
 
-def test_roundtrip_save_all(tmp_path):
+def test_roundtrip_save_all(tmp_path: Path) -> None:
     # Single frame image
     out = str(tmp_path / "temp.gif")
     im = hopper()
@@ -275,7 +276,7 @@ def test_roundtrip_save_all(tmp_path):
         assert reread.n_frames == 5
 
 
-def test_roundtrip_save_all_1(tmp_path):
+def test_roundtrip_save_all_1(tmp_path: Path) -> None:
     out = str(tmp_path / "temp.gif")
     im = Image.new("1", (1, 1))
     im2 = Image.new("1", (1, 1), 1)
@@ -296,7 +297,7 @@ def test_roundtrip_save_all_1(tmp_path):
         ("Tests/images/dispose_bgnd_rgba.gif", "RGBA"),
     ),
 )
-def test_loading_multiple_palettes(path, mode):
+def test_loading_multiple_palettes(path, mode) -> None:
     with Image.open(path) as im:
         assert im.mode == "P"
         first_frame_colors = im.palette.colors.keys()
@@ -314,7 +315,7 @@ def test_loading_multiple_palettes(path, mode):
         assert im.load()[24, 24] not in first_frame_colors
 
 
-def test_headers_saving_for_animated_gifs(tmp_path):
+def test_headers_saving_for_animated_gifs(tmp_path: Path) -> None:
     important_headers = ["background", "version", "duration", "loop"]
     # Multiframe image
     with Image.open("Tests/images/dispose_bgnd.gif") as im:
@@ -327,7 +328,7 @@ def test_headers_saving_for_animated_gifs(tmp_path):
             assert info[header] == reread.info[header]
 
 
-def test_palette_handling(tmp_path):
+def test_palette_handling(tmp_path: Path) -> None:
     # see https://github.com/python-pillow/Pillow/issues/513
 
     with Image.open(TEST_GIF) as im:
@@ -343,7 +344,7 @@ def test_palette_handling(tmp_path):
         assert_image_similar(im, reloaded.convert("RGB"), 10)
 
 
-def test_palette_434(tmp_path):
+def test_palette_434(tmp_path: Path) -> None:
     # see https://github.com/python-pillow/Pillow/issues/434
 
     def roundtrip(im, *args, **kwargs):
@@ -368,7 +369,7 @@ def roundtrip(im, *args, **kwargs):
 
 
 @pytest.mark.skipif(not netpbm_available(), reason="Netpbm not available")
-def test_save_netpbm_bmp_mode(tmp_path):
+def test_save_netpbm_bmp_mode(tmp_path: Path) -> None:
     with Image.open(TEST_GIF) as img:
         img = img.convert("RGB")
 
@@ -379,7 +380,7 @@ def test_save_netpbm_bmp_mode(tmp_path):
 
 
 @pytest.mark.skipif(not netpbm_available(), reason="Netpbm not available")
-def test_save_netpbm_l_mode(tmp_path):
+def test_save_netpbm_l_mode(tmp_path: Path) -> None:
     with Image.open(TEST_GIF) as img:
         img = img.convert("L")
 
@@ -389,7 +390,7 @@ def test_save_netpbm_l_mode(tmp_path):
             assert_image_similar(img, reloaded.convert("L"), 0)
 
 
-def test_seek():
+def test_seek() -> None:
     with Image.open("Tests/images/dispose_none.gif") as img:
         frame_count = 0
         try:
@@ -400,7 +401,7 @@ def test_seek():
             assert frame_count == 5
 
 
-def test_seek_info():
+def test_seek_info() -> None:
     with Image.open("Tests/images/iss634.gif") as im:
         info = im.info.copy()
 
@@ -410,7 +411,7 @@ def test_seek_info():
         assert im.info == info
 
 
-def test_seek_rewind():
+def test_seek_rewind() -> None:
     with Image.open("Tests/images/iss634.gif") as im:
         im.seek(2)
         im.seek(1)
@@ -428,7 +429,7 @@ def test_seek_rewind():
         ("Tests/images/iss634.gif", 42),
     ),
 )
-def test_n_frames(path, n_frames):
+def test_n_frames(path, n_frames) -> None:
     # Test is_animated before n_frames
     with Image.open(path) as im:
         assert im.is_animated == (n_frames != 1)
@@ -439,7 +440,7 @@ def test_n_frames(path, n_frames):
         assert im.is_animated == (n_frames != 1)
 
 
-def test_no_change():
+def test_no_change() -> None:
     # Test n_frames does not change the image
     with Image.open("Tests/images/dispose_bgnd.gif") as im:
         im.seek(1)
@@ -460,7 +461,7 @@ def test_no_change():
         assert_image_equal(im, expected)
 
 
-def test_eoferror():
+def test_eoferror() -> None:
     with Image.open(TEST_GIF) as im:
         n_frames = im.n_frames
 
@@ -473,13 +474,13 @@ def test_eoferror():
         im.seek(n_frames - 1)
 
 
-def test_first_frame_transparency():
+def test_first_frame_transparency() -> None:
     with Image.open("Tests/images/first_frame_transparency.gif") as im:
         px = im.load()
         assert px[0, 0] == im.info["transparency"]
 
 
-def test_dispose_none():
+def test_dispose_none() -> None:
     with Image.open("Tests/images/dispose_none.gif") as img:
         try:
             while True:
@@ -489,7 +490,7 @@ def test_dispose_none():
             pass
 
 
-def test_dispose_none_load_end():
+def test_dispose_none_load_end() -> None:
     # Test image created with:
     #
     # im = Image.open("transparent.gif")
@@ -502,7 +503,7 @@ def test_dispose_none_load_end():
         assert_image_equal_tofile(img, "Tests/images/dispose_none_load_end_second.png")
 
 
-def test_dispose_background():
+def test_dispose_background() -> None:
     with Image.open("Tests/images/dispose_bgnd.gif") as img:
         try:
             while True:
@@ -512,7 +513,7 @@ def test_dispose_background():
             pass
 
 
-def test_dispose_background_transparency():
+def test_dispose_background_transparency() -> None:
     with Image.open("Tests/images/dispose_bgnd_transparency.gif") as img:
         img.seek(2)
         px = img.load()
@@ -540,7 +541,7 @@ def test_dispose_background_transparency():
         ),
     ),
 )
-def test_transparent_dispose(loading_strategy, expected_colors):
+def test_transparent_dispose(loading_strategy, expected_colors) -> None:
     GifImagePlugin.LOADING_STRATEGY = loading_strategy
     try:
         with Image.open("Tests/images/transparent_dispose.gif") as img:
@@ -553,7 +554,7 @@ def test_transparent_dispose(loading_strategy, expected_colors):
         GifImagePlugin.LOADING_STRATEGY = GifImagePlugin.LoadingStrategy.RGB_AFTER_FIRST
 
 
-def test_dispose_previous():
+def test_dispose_previous() -> None:
     with Image.open("Tests/images/dispose_prev.gif") as img:
         try:
             while True:
@@ -563,7 +564,7 @@ def test_dispose_previous():
             pass
 
 
-def test_dispose_previous_first_frame():
+def test_dispose_previous_first_frame() -> None:
     with Image.open("Tests/images/dispose_prev_first_frame.gif") as im:
         im.seek(1)
         assert_image_equal_tofile(
@@ -571,7 +572,7 @@ def test_dispose_previous_first_frame():
         )
 
 
-def test_previous_frame_loaded():
+def test_previous_frame_loaded() -> None:
     with Image.open("Tests/images/dispose_none.gif") as img:
         img.load()
         img.seek(1)
@@ -582,7 +583,7 @@ def test_previous_frame_loaded():
             assert_image_equal(img_skipped, img)
 
 
-def test_save_dispose(tmp_path):
+def test_save_dispose(tmp_path: Path) -> None:
     out = str(tmp_path / "temp.gif")
     im_list = [
         Image.new("L", (100, 100), "#000"),
@@ -610,7 +611,7 @@ def test_save_dispose(tmp_path):
             assert img.disposal_method == i + 1
 
 
-def test_dispose2_palette(tmp_path):
+def test_dispose2_palette(tmp_path: Path) -> None:
     out = str(tmp_path / "temp.gif")
 
     # Four colors: white, gray, black, red
@@ -641,7 +642,7 @@ def test_dispose2_palette(tmp_path):
             assert rgb_img.getpixel((50, 50)) == circle
 
 
-def test_dispose2_diff(tmp_path):
+def test_dispose2_diff(tmp_path: Path) -> None:
     out = str(tmp_path / "temp.gif")
 
     # 4 frames: red/blue, red/red, blue/blue, red/blue
@@ -683,7 +684,7 @@ def test_dispose2_diff(tmp_path):
             assert rgb_img.getpixel((1, 1)) == (255, 255, 255, 0)
 
 
-def test_dispose2_background(tmp_path):
+def test_dispose2_background(tmp_path: Path) -> None:
     out = str(tmp_path / "temp.gif")
 
     im_list = []
@@ -709,7 +710,7 @@ def test_dispose2_background(tmp_path):
         assert im.getpixel((0, 0)) == (255, 0, 0)
 
 
-def test_dispose2_background_frame(tmp_path):
+def test_dispose2_background_frame(tmp_path: Path) -> None:
     out = str(tmp_path / "temp.gif")
 
     im_list = [Image.new("RGBA", (1, 20))]
@@ -727,7 +728,7 @@ def test_dispose2_background_frame(tmp_path):
         assert im.n_frames == 3
 
 
-def test_transparency_in_second_frame(tmp_path):
+def test_transparency_in_second_frame(tmp_path: Path) -> None:
     out = str(tmp_path / "temp.gif")
     with Image.open("Tests/images/different_transparency.gif") as im:
         assert im.info["transparency"] == 0
@@ -747,7 +748,7 @@ def test_transparency_in_second_frame(tmp_path):
         )
 
 
-def test_no_transparency_in_second_frame():
+def test_no_transparency_in_second_frame() -> None:
     with Image.open("Tests/images/iss634.gif") as img:
         # Seek to the second frame
         img.seek(img.tell() + 1)
@@ -757,7 +758,7 @@ def test_no_transparency_in_second_frame():
         assert img.histogram()[255] == 0
 
 
-def test_remapped_transparency(tmp_path):
+def test_remapped_transparency(tmp_path: Path) -> None:
     out = str(tmp_path / "temp.gif")
 
     im = Image.new("P", (1, 2))
@@ -773,7 +774,7 @@ def test_remapped_transparency(tmp_path):
         assert reloaded.info["transparency"] == reloaded.getpixel((0, 1))
 
 
-def test_duration(tmp_path):
+def test_duration(tmp_path: Path) -> None:
     duration = 1000
 
     out = str(tmp_path / "temp.gif")
@@ -787,7 +788,7 @@ def test_duration(tmp_path):
         assert reread.info["duration"] == duration
 
 
-def test_multiple_duration(tmp_path):
+def test_multiple_duration(tmp_path: Path) -> None:
     duration_list = [1000, 2000, 3000]
 
     out = str(tmp_path / "temp.gif")
@@ -822,7 +823,7 @@ def test_multiple_duration(tmp_path):
                 pass
 
 
-def test_roundtrip_info_duration(tmp_path):
+def test_roundtrip_info_duration(tmp_path: Path) -> None:
     duration_list = [100, 500, 500]
 
     out = str(tmp_path / "temp.gif")
@@ -839,7 +840,7 @@ def test_roundtrip_info_duration(tmp_path):
         ] == duration_list
 
 
-def test_roundtrip_info_duration_combined(tmp_path):
+def test_roundtrip_info_duration_combined(tmp_path: Path) -> None:
     out = str(tmp_path / "temp.gif")
     with Image.open("Tests/images/duplicate_frame.gif") as im:
         assert [frame.info["duration"] for frame in ImageSequence.Iterator(im)] == [
@@ -855,7 +856,7 @@ def test_roundtrip_info_duration_combined(tmp_path):
         ] == [1000, 2000]
 
 
-def test_identical_frames(tmp_path):
+def test_identical_frames(tmp_path: Path) -> None:
     duration_list = [1000, 1500, 2000, 4000]
 
     out = str(tmp_path / "temp.gif")
@@ -888,7 +889,7 @@ def test_identical_frames(tmp_path):
         1500,
     ),
 )
-def test_identical_frames_to_single_frame(duration, tmp_path):
+def test_identical_frames_to_single_frame(duration, tmp_path: Path) -> None:
     out = str(tmp_path / "temp.gif")
     im_list = [
         Image.new("L", (100, 100), "#000"),
@@ -905,7 +906,7 @@ def test_identical_frames_to_single_frame(duration, tmp_path):
         assert reread.info["duration"] == 4500
 
 
-def test_loop_none(tmp_path):
+def test_loop_none(tmp_path: Path) -> None:
     out = str(tmp_path / "temp.gif")
     im = Image.new("L", (100, 100), "#000")
     im.save(out, loop=None)
@@ -913,7 +914,7 @@ def test_loop_none(tmp_path):
         assert "loop" not in reread.info
 
 
-def test_number_of_loops(tmp_path):
+def test_number_of_loops(tmp_path: Path) -> None:
     number_of_loops = 2
 
     out = str(tmp_path / "temp.gif")
@@ -931,7 +932,7 @@ def test_number_of_loops(tmp_path):
         assert im.info["loop"] == 2
 
 
-def test_background(tmp_path):
+def test_background(tmp_path: Path) -> None:
     out = str(tmp_path / "temp.gif")
     im = Image.new("L", (100, 100), "#000")
     im.info["background"] = 1
@@ -940,7 +941,7 @@ def test_background(tmp_path):
         assert reread.info["background"] == im.info["background"]
 
 
-def test_webp_background(tmp_path):
+def test_webp_background(tmp_path: Path) -> None:
     out = str(tmp_path / "temp.gif")
 
     # Test opaque WebP background
@@ -955,7 +956,7 @@ def test_webp_background(tmp_path):
     im.save(out)
 
 
-def test_comment(tmp_path):
+def test_comment(tmp_path: Path) -> None:
     with Image.open(TEST_GIF) as im:
         assert im.info["comment"] == b"File written by Adobe Photoshop\xa8 4.0"
 
@@ -975,7 +976,7 @@ def test_comment(tmp_path):
         assert reread.info["version"] == b"GIF89a"
 
 
-def test_comment_over_255(tmp_path):
+def test_comment_over_255(tmp_path: Path) -> None:
     out = str(tmp_path / "temp.gif")
     im = Image.new("L", (100, 100), "#000")
     comment = b"Test comment text"
@@ -990,18 +991,18 @@ def test_comment_over_255(tmp_path):
         assert reread.info["version"] == b"GIF89a"
 
 
-def test_zero_comment_subblocks():
+def test_zero_comment_subblocks() -> None:
     with Image.open("Tests/images/hopper_zero_comment_subblocks.gif") as im:
         assert_image_equal_tofile(im, TEST_GIF)
 
 
-def test_read_multiple_comment_blocks():
+def test_read_multiple_comment_blocks() -> None:
     with Image.open("Tests/images/multiple_comments.gif") as im:
         # Multiple comment blocks in a frame are separated not concatenated
         assert im.info["comment"] == b"Test comment 1\nTest comment 2"
 
 
-def test_empty_string_comment(tmp_path):
+def test_empty_string_comment(tmp_path: Path) -> None:
     out = str(tmp_path / "temp.gif")
     with Image.open("Tests/images/chi.gif") as im:
         assert "comment" in im.info
@@ -1014,7 +1015,7 @@ def test_empty_string_comment(tmp_path):
             assert "comment" not in frame.info
 
 
-def test_retain_comment_in_subsequent_frames(tmp_path):
+def test_retain_comment_in_subsequent_frames(tmp_path: Path) -> None:
     # Test that a comment block at the beginning is kept
     with Image.open("Tests/images/chi.gif") as im:
         for frame in ImageSequence.Iterator(im):
@@ -1045,10 +1046,10 @@ def test_retain_comment_in_subsequent_frames(tmp_path):
             assert frame.info["comment"] == b"Test"
 
 
-def test_version(tmp_path):
+def test_version(tmp_path: Path) -> None:
     out = str(tmp_path / "temp.gif")
 
-    def assert_version_after_save(im, version):
+    def assert_version_after_save(im, version) -> None:
         im.save(out)
         with Image.open(out) as reread:
             assert reread.info["version"] == version
@@ -1075,7 +1076,7 @@ def assert_version_after_save(im, version):
         assert_version_after_save(im, b"GIF87a")
 
 
-def test_append_images(tmp_path):
+def test_append_images(tmp_path: Path) -> None:
     out = str(tmp_path / "temp.gif")
 
     # Test appending single frame images
@@ -1104,7 +1105,7 @@ def im_generator(ims):
         assert reread.n_frames == 10
 
 
-def test_transparent_optimize(tmp_path):
+def test_transparent_optimize(tmp_path: Path) -> None:
     # From issue #2195, if the transparent color is incorrectly optimized out, GIF loses
     # transparency.
     # Need a palette that isn't using the 0 color,
@@ -1124,7 +1125,7 @@ def test_transparent_optimize(tmp_path):
         assert reloaded.info["transparency"] == reloaded.getpixel((252, 0))
 
 
-def test_removed_transparency(tmp_path):
+def test_removed_transparency(tmp_path: Path) -> None:
     out = str(tmp_path / "temp.gif")
     im = Image.new("RGB", (256, 1))
 
@@ -1139,7 +1140,7 @@ def test_removed_transparency(tmp_path):
         assert "transparency" not in reloaded.info
 
 
-def test_rgb_transparency(tmp_path):
+def test_rgb_transparency(tmp_path: Path) -> None:
     out = str(tmp_path / "temp.gif")
 
     # Single frame
@@ -1161,7 +1162,7 @@ def test_rgb_transparency(tmp_path):
         assert "transparency" not in reloaded.info
 
 
-def test_rgba_transparency(tmp_path):
+def test_rgba_transparency(tmp_path: Path) -> None:
     out = str(tmp_path / "temp.gif")
 
     im = hopper("P")
@@ -1172,13 +1173,13 @@ def test_rgba_transparency(tmp_path):
         assert_image_equal(hopper("P").convert("RGB"), reloaded)
 
 
-def test_background_outside_palettte(tmp_path):
+def test_background_outside_palettte(tmp_path: Path) -> None:
     with Image.open("Tests/images/background_outside_palette.gif") as im:
         im.seek(1)
         assert im.info["background"] == 255
 
 
-def test_bbox(tmp_path):
+def test_bbox(tmp_path: Path) -> None:
     out = str(tmp_path / "temp.gif")
 
     im = Image.new("RGB", (100, 100), "#fff")
@@ -1189,7 +1190,7 @@ def test_bbox(tmp_path):
         assert reread.n_frames == 2
 
 
-def test_bbox_alpha(tmp_path):
+def test_bbox_alpha(tmp_path: Path) -> None:
     out = str(tmp_path / "temp.gif")
 
     im = Image.new("RGBA", (1, 2), (255, 0, 0, 255))
@@ -1201,7 +1202,7 @@ def test_bbox_alpha(tmp_path):
         assert reread.n_frames == 2
 
 
-def test_palette_save_L(tmp_path):
+def test_palette_save_L(tmp_path: Path) -> None:
     # Generate an L mode image with a separate palette
 
     im = hopper("P")
@@ -1215,7 +1216,7 @@ def test_palette_save_L(tmp_path):
         assert_image_equal(reloaded.convert("RGB"), im.convert("RGB"))
 
 
-def test_palette_save_P(tmp_path):
+def test_palette_save_P(tmp_path: Path) -> None:
     im = Image.new("P", (1, 2))
     im.putpixel((0, 1), 1)
 
@@ -1229,7 +1230,7 @@ def test_palette_save_P(tmp_path):
         assert reloaded_rgb.getpixel((0, 1)) == (4, 5, 6)
 
 
-def test_palette_save_duplicate_entries(tmp_path):
+def test_palette_save_duplicate_entries(tmp_path: Path) -> None:
     im = Image.new("P", (1, 2))
     im.putpixel((0, 1), 1)
 
@@ -1242,7 +1243,7 @@ def test_palette_save_duplicate_entries(tmp_path):
         assert reloaded.convert("RGB").getpixel((0, 1)) == (0, 0, 0)
 
 
-def test_palette_save_all_P(tmp_path):
+def test_palette_save_all_P(tmp_path: Path) -> None:
     frames = []
     colors = ((255, 0, 0), (0, 255, 0))
     for color in colors:
@@ -1265,7 +1266,7 @@ def test_palette_save_all_P(tmp_path):
         assert im.palette.palette == im.global_palette.palette
 
 
-def test_palette_save_ImagePalette(tmp_path):
+def test_palette_save_ImagePalette(tmp_path: Path) -> None:
     # Pass in a different palette, as an ImagePalette.ImagePalette
     # effectively the same as test_palette_save_P
 
@@ -1280,7 +1281,7 @@ def test_palette_save_ImagePalette(tmp_path):
         assert_image_equal(reloaded.convert("RGB"), im.convert("RGB"))
 
 
-def test_save_I(tmp_path):
+def test_save_I(tmp_path: Path) -> None:
     # Test saving something that would trigger the auto-convert to 'L'
 
     im = hopper("I")
@@ -1292,7 +1293,7 @@ def test_save_I(tmp_path):
         assert_image_equal(reloaded.convert("L"), im.convert("L"))
 
 
-def test_getdata():
+def test_getdata() -> None:
     # Test getheader/getdata against legacy values.
     # Create a 'P' image with holes in the palette.
     im = Image._wedge().resize((16, 16), Image.Resampling.NEAREST)
@@ -1320,7 +1321,7 @@ def test_getdata():
         GifImagePlugin._FORCE_OPTIMIZE = False
 
 
-def test_lzw_bits():
+def test_lzw_bits() -> None:
     # see https://github.com/python-pillow/Pillow/issues/2811
     with Image.open("Tests/images/issue_2811.gif") as im:
         assert im.tile[0][3][0] == 11  # LZW bits
@@ -1328,7 +1329,7 @@ def test_lzw_bits():
         im.load()
 
 
-def test_extents():
+def test_extents() -> None:
     with Image.open("Tests/images/test_extents.gif") as im:
         assert im.size == (100, 100)
 
@@ -1340,7 +1341,7 @@ def test_extents():
         assert im.size == (150, 150)
 
 
-def test_missing_background():
+def test_missing_background() -> None:
     # The Global Color Table Flag isn't set, so there is no background color index,
     # but the disposal method is "Restore to background color"
     with Image.open("Tests/images/missing_background.gif") as im:
@@ -1348,7 +1349,7 @@ def test_missing_background():
         assert_image_equal_tofile(im, "Tests/images/missing_background_first_frame.png")
 
 
-def test_saving_rgba(tmp_path):
+def test_saving_rgba(tmp_path: Path) -> None:
     out = str(tmp_path / "temp.gif")
     with Image.open("Tests/images/transparent.png") as im:
         im.save(out)
diff --git a/Tests/test_file_gimpgradient.py b/Tests/test_file_gimpgradient.py
index ceea1edd34c..006ee952d43 100644
--- a/Tests/test_file_gimpgradient.py
+++ b/Tests/test_file_gimpgradient.py
@@ -3,7 +3,7 @@
 from PIL import GimpGradientFile, ImagePalette
 
 
-def test_linear_pos_le_middle():
+def test_linear_pos_le_middle() -> None:
     # Arrange
     middle = 0.5
     pos = 0.25
@@ -15,7 +15,7 @@ def test_linear_pos_le_middle():
     assert ret == 0.25
 
 
-def test_linear_pos_le_small_middle():
+def test_linear_pos_le_small_middle() -> None:
     # Arrange
     middle = 1e-11
     pos = 1e-12
@@ -27,7 +27,7 @@ def test_linear_pos_le_small_middle():
     assert ret == 0.0
 
 
-def test_linear_pos_gt_middle():
+def test_linear_pos_gt_middle() -> None:
     # Arrange
     middle = 0.5
     pos = 0.75
@@ -39,7 +39,7 @@ def test_linear_pos_gt_middle():
     assert ret == 0.75
 
 
-def test_linear_pos_gt_small_middle():
+def test_linear_pos_gt_small_middle() -> None:
     # Arrange
     middle = 1 - 1e-11
     pos = 1 - 1e-12
@@ -51,7 +51,7 @@ def test_linear_pos_gt_small_middle():
     assert ret == 1.0
 
 
-def test_curved():
+def test_curved() -> None:
     # Arrange
     middle = 0.5
     pos = 0.75
@@ -63,7 +63,7 @@ def test_curved():
     assert ret == 0.75
 
 
-def test_sine():
+def test_sine() -> None:
     # Arrange
     middle = 0.5
     pos = 0.75
@@ -75,7 +75,7 @@ def test_sine():
     assert ret == 0.8535533905932737
 
 
-def test_sphere_increasing():
+def test_sphere_increasing() -> None:
     # Arrange
     middle = 0.5
     pos = 0.75
@@ -87,7 +87,7 @@ def test_sphere_increasing():
     assert round(abs(ret - 0.9682458365518543), 7) == 0
 
 
-def test_sphere_decreasing():
+def test_sphere_decreasing() -> None:
     # Arrange
     middle = 0.5
     pos = 0.75
@@ -99,7 +99,7 @@ def test_sphere_decreasing():
     assert ret == 0.3385621722338523
 
 
-def test_load_via_imagepalette():
+def test_load_via_imagepalette() -> None:
     # Arrange
     test_file = "Tests/images/gimp_gradient.ggr"
 
@@ -112,7 +112,7 @@ def test_load_via_imagepalette():
     assert palette[1] == "RGBA"
 
 
-def test_load_1_3_via_imagepalette():
+def test_load_1_3_via_imagepalette() -> None:
     # Arrange
     # GIMP 1.3 gradient files contain a name field
     test_file = "Tests/images/gimp_gradient_with_name.ggr"
diff --git a/Tests/test_file_gribstub.py b/Tests/test_file_gribstub.py
index a4ce6dde674..4945468be40 100644
--- a/Tests/test_file_gribstub.py
+++ b/Tests/test_file_gribstub.py
@@ -1,5 +1,7 @@
 from __future__ import annotations
 
+from pathlib import Path
+
 import pytest
 
 from PIL import GribStubImagePlugin, Image
@@ -9,7 +11,7 @@
 TEST_FILE = "Tests/images/WAlaska.wind.7days.grb"
 
 
-def test_open():
+def test_open() -> None:
     # Act
     with Image.open(TEST_FILE) as im:
         # Assert
@@ -20,7 +22,7 @@ def test_open():
         assert im.size == (1, 1)
 
 
-def test_invalid_file():
+def test_invalid_file() -> None:
     # Arrange
     invalid_file = "Tests/images/flower.jpg"
 
@@ -29,7 +31,7 @@ def test_invalid_file():
         GribStubImagePlugin.GribStubImageFile(invalid_file)
 
 
-def test_load():
+def test_load() -> None:
     # Arrange
     with Image.open(TEST_FILE) as im:
         # Act / Assert: stub cannot load without an implemented handler
@@ -37,7 +39,7 @@ def test_load():
             im.load()
 
 
-def test_save(tmp_path):
+def test_save(tmp_path: Path) -> None:
     # Arrange
     im = hopper()
     tmpfile = str(tmp_path / "temp.grib")
@@ -47,13 +49,13 @@ def test_save(tmp_path):
         im.save(tmpfile)
 
 
-def test_handler(tmp_path):
+def test_handler(tmp_path: Path) -> None:
     class TestHandler:
         opened = False
         loaded = False
         saved = False
 
-        def open(self, im):
+        def open(self, im) -> None:
             self.opened = True
 
         def load(self, im):
@@ -61,7 +63,7 @@ def load(self, im):
             im.fp.close()
             return Image.new("RGB", (1, 1))
 
-        def save(self, im, fp, filename):
+        def save(self, im, fp, filename) -> None:
             self.saved = True
 
     handler = TestHandler()
diff --git a/Tests/test_file_hdf5stub.py b/Tests/test_file_hdf5stub.py
index 72764461730..ac3d40bf287 100644
--- a/Tests/test_file_hdf5stub.py
+++ b/Tests/test_file_hdf5stub.py
@@ -1,5 +1,7 @@
 from __future__ import annotations
 
+from pathlib import Path
+
 import pytest
 
 from PIL import Hdf5StubImagePlugin, Image
@@ -7,7 +9,7 @@
 TEST_FILE = "Tests/images/hdf5.h5"
 
 
-def test_open():
+def test_open() -> None:
     # Act
     with Image.open(TEST_FILE) as im:
         # Assert
@@ -18,7 +20,7 @@ def test_open():
         assert im.size == (1, 1)
 
 
-def test_invalid_file():
+def test_invalid_file() -> None:
     # Arrange
     invalid_file = "Tests/images/flower.jpg"
 
@@ -27,7 +29,7 @@ def test_invalid_file():
         Hdf5StubImagePlugin.HDF5StubImageFile(invalid_file)
 
 
-def test_load():
+def test_load() -> None:
     # Arrange
     with Image.open(TEST_FILE) as im:
         # Act / Assert: stub cannot load without an implemented handler
@@ -35,7 +37,7 @@ def test_load():
             im.load()
 
 
-def test_save():
+def test_save() -> None:
     # Arrange
     with Image.open(TEST_FILE) as im:
         dummy_fp = None
@@ -48,13 +50,13 @@ def test_save():
             Hdf5StubImagePlugin._save(im, dummy_fp, dummy_filename)
 
 
-def test_handler(tmp_path):
+def test_handler(tmp_path: Path) -> None:
     class TestHandler:
         opened = False
         loaded = False
         saved = False
 
-        def open(self, im):
+        def open(self, im) -> None:
             self.opened = True
 
         def load(self, im):
@@ -62,7 +64,7 @@ def load(self, im):
             im.fp.close()
             return Image.new("RGB", (1, 1))
 
-        def save(self, im, fp, filename):
+        def save(self, im, fp, filename) -> None:
             self.saved = True
 
     handler = TestHandler()
diff --git a/Tests/test_file_icns.py b/Tests/test_file_icns.py
index 314fa800868..488984aef70 100644
--- a/Tests/test_file_icns.py
+++ b/Tests/test_file_icns.py
@@ -3,6 +3,7 @@
 import io
 import os
 import warnings
+from pathlib import Path
 
 import pytest
 
@@ -14,7 +15,7 @@
 TEST_FILE = "Tests/images/pillow.icns"
 
 
-def test_sanity():
+def test_sanity() -> None:
     # Loading this icon by default should result in the largest size
     # (512x512@2x) being loaded
     with Image.open(TEST_FILE) as im:
@@ -27,7 +28,7 @@ def test_sanity():
         assert im.format == "ICNS"
 
 
-def test_load():
+def test_load() -> None:
     with Image.open(TEST_FILE) as im:
         assert im.load()[0, 0] == (0, 0, 0, 0)
 
@@ -35,7 +36,7 @@ def test_load():
         assert im.load()[0, 0] == (0, 0, 0, 0)
 
 
-def test_save(tmp_path):
+def test_save(tmp_path: Path) -> None:
     temp_file = str(tmp_path / "temp.icns")
 
     with Image.open(TEST_FILE) as im:
@@ -52,7 +53,7 @@ def test_save(tmp_path):
         assert _binary.i32be(fp.read(4)) == file_length
 
 
-def test_save_append_images(tmp_path):
+def test_save_append_images(tmp_path: Path) -> None:
     temp_file = str(tmp_path / "temp.icns")
     provided_im = Image.new("RGBA", (32, 32), (255, 0, 0, 128))
 
@@ -67,7 +68,7 @@ def test_save_append_images(tmp_path):
             assert_image_equal(reread, provided_im)
 
 
-def test_save_fp():
+def test_save_fp() -> None:
     fp = io.BytesIO()
 
     with Image.open(TEST_FILE) as im:
@@ -79,7 +80,7 @@ def test_save_fp():
         assert reread.format == "ICNS"
 
 
-def test_sizes():
+def test_sizes() -> None:
     # Check that we can load all of the sizes, and that the final pixel
     # dimensions are as expected
     with Image.open(TEST_FILE) as im:
@@ -96,7 +97,7 @@ def test_sizes():
             im.size = (1, 1)
 
 
-def test_older_icon():
+def test_older_icon() -> None:
     # This icon was made with Icon Composer rather than iconutil; it still
     # uses PNG rather than JP2, however (since it was made on 10.9).
     with Image.open("Tests/images/pillow2.icns") as im:
@@ -111,7 +112,7 @@ def test_older_icon():
 
 
 @skip_unless_feature("jpg_2000")
-def test_jp2_icon():
+def test_jp2_icon() -> None:
     # This icon uses JPEG 2000 images instead of the PNG images.
     # The advantage of doing this is that OS X 10.5 supports JPEG 2000
     # but not PNG; some commercial software therefore does just this.
@@ -127,7 +128,7 @@ def test_jp2_icon():
                 assert im2.size == (wr, hr)
 
 
-def test_getimage():
+def test_getimage() -> None:
     with open(TEST_FILE, "rb") as fp:
         icns_file = IcnsImagePlugin.IcnsFile(fp)
 
@@ -140,14 +141,14 @@ def test_getimage():
         assert im.size == (512, 512)
 
 
-def test_not_an_icns_file():
+def test_not_an_icns_file() -> None:
     with io.BytesIO(b"invalid\n") as fp:
         with pytest.raises(SyntaxError):
             IcnsImagePlugin.IcnsFile(fp)
 
 
 @skip_unless_feature("jpg_2000")
-def test_icns_decompression_bomb():
+def test_icns_decompression_bomb() -> None:
     with Image.open(
         "Tests/images/oom-8ed3316a4109213ca96fb8a256a0bfefdece1461.icns"
     ) as im:
diff --git a/Tests/test_file_ico.py b/Tests/test_file_ico.py
index 99b3048d1e0..65f090931b4 100644
--- a/Tests/test_file_ico.py
+++ b/Tests/test_file_ico.py
@@ -2,6 +2,7 @@
 
 import io
 import os
+from pathlib import Path
 
 import pytest
 
@@ -12,7 +13,7 @@
 TEST_ICO_FILE = "Tests/images/hopper.ico"
 
 
-def test_sanity():
+def test_sanity() -> None:
     with Image.open(TEST_ICO_FILE) as im:
         im.load()
     assert im.mode == "RGBA"
@@ -21,29 +22,29 @@ def test_sanity():
     assert im.get_format_mimetype() == "image/x-icon"
 
 
-def test_load():
+def test_load() -> None:
     with Image.open(TEST_ICO_FILE) as im:
         assert im.load()[0, 0] == (1, 1, 9, 255)
 
 
-def test_mask():
+def test_mask() -> None:
     with Image.open("Tests/images/hopper_mask.ico") as im:
         assert_image_equal_tofile(im, "Tests/images/hopper_mask.png")
 
 
-def test_black_and_white():
+def test_black_and_white() -> None:
     with Image.open("Tests/images/black_and_white.ico") as im:
         assert im.mode == "RGBA"
         assert im.size == (16, 16)
 
 
-def test_invalid_file():
+def test_invalid_file() -> None:
     with open("Tests/images/flower.jpg", "rb") as fp:
         with pytest.raises(SyntaxError):
             IcoImagePlugin.IcoImageFile(fp)
 
 
-def test_save_to_bytes():
+def test_save_to_bytes() -> None:
     output = io.BytesIO()
     im = hopper()
     im.save(output, "ico", sizes=[(32, 32), (64, 64)])
@@ -73,7 +74,7 @@ def test_save_to_bytes():
         )
 
 
-def test_getpixel(tmp_path):
+def test_getpixel(tmp_path: Path) -> None:
     temp_file = str(tmp_path / "temp.ico")
 
     im = hopper()
@@ -86,7 +87,7 @@ def test_getpixel(tmp_path):
         assert reloaded.getpixel((0, 0)) == (18, 20, 62)
 
 
-def test_no_duplicates(tmp_path):
+def test_no_duplicates(tmp_path: Path) -> None:
     temp_file = str(tmp_path / "temp.ico")
     temp_file2 = str(tmp_path / "temp2.ico")
 
@@ -100,7 +101,7 @@ def test_no_duplicates(tmp_path):
     assert os.path.getsize(temp_file) == os.path.getsize(temp_file2)
 
 
-def test_different_bit_depths(tmp_path):
+def test_different_bit_depths(tmp_path: Path) -> None:
     temp_file = str(tmp_path / "temp.ico")
     temp_file2 = str(tmp_path / "temp2.ico")
 
@@ -134,7 +135,7 @@ def test_different_bit_depths(tmp_path):
 
 
 @pytest.mark.parametrize("mode", ("1", "L", "P", "RGB", "RGBA"))
-def test_save_to_bytes_bmp(mode):
+def test_save_to_bytes_bmp(mode) -> None:
     output = io.BytesIO()
     im = hopper(mode)
     im.save(output, "ico", bitmap_format="bmp", sizes=[(32, 32), (64, 64)])
@@ -162,13 +163,13 @@ def test_save_to_bytes_bmp(mode):
         assert_image_equal(reloaded, im)
 
 
-def test_incorrect_size():
+def test_incorrect_size() -> None:
     with Image.open(TEST_ICO_FILE) as im:
         with pytest.raises(ValueError):
             im.size = (1, 1)
 
 
-def test_save_256x256(tmp_path):
+def test_save_256x256(tmp_path: Path) -> None:
     """Issue #2264 https://github.com/python-pillow/Pillow/issues/2264"""
     # Arrange
     with Image.open("Tests/images/hopper_256x256.ico") as im:
@@ -181,7 +182,7 @@ def test_save_256x256(tmp_path):
         assert im_saved.size == (256, 256)
 
 
-def test_only_save_relevant_sizes(tmp_path):
+def test_only_save_relevant_sizes(tmp_path: Path) -> None:
     """Issue #2266 https://github.com/python-pillow/Pillow/issues/2266
     Should save in 16x16, 24x24, 32x32, 48x48 sizes
     and not in 16x16, 24x24, 32x32, 48x48, 48x48, 48x48, 48x48 sizes
@@ -197,7 +198,7 @@ def test_only_save_relevant_sizes(tmp_path):
         assert im_saved.info["sizes"] == {(16, 16), (24, 24), (32, 32), (48, 48)}
 
 
-def test_save_append_images(tmp_path):
+def test_save_append_images(tmp_path: Path) -> None:
     # append_images should be used for scaled down versions of the image
     im = hopper("RGBA")
     provided_im = Image.new("RGBA", (32, 32), (255, 0, 0))
@@ -211,7 +212,7 @@ def test_save_append_images(tmp_path):
         assert_image_equal(reread, provided_im)
 
 
-def test_unexpected_size():
+def test_unexpected_size() -> None:
     # This image has been manually hexedited to state that it is 16x32
     # while the image within is still 16x16
     with pytest.warns(UserWarning):
@@ -219,7 +220,7 @@ def test_unexpected_size():
             assert im.size == (16, 16)
 
 
-def test_draw_reloaded(tmp_path):
+def test_draw_reloaded(tmp_path: Path) -> None:
     with Image.open(TEST_ICO_FILE) as im:
         outfile = str(tmp_path / "temp_saved_hopper_draw.ico")
 
diff --git a/Tests/test_file_im.py b/Tests/test_file_im.py
index a031b3e887c..f932069b9c3 100644
--- a/Tests/test_file_im.py
+++ b/Tests/test_file_im.py
@@ -2,6 +2,7 @@
 
 import filecmp
 import warnings
+from pathlib import Path
 
 import pytest
 
@@ -13,7 +14,7 @@
 TEST_IM = "Tests/images/hopper.im"
 
 
-def test_sanity():
+def test_sanity() -> None:
     with Image.open(TEST_IM) as im:
         im.load()
         assert im.mode == "RGB"
@@ -21,7 +22,7 @@ def test_sanity():
         assert im.format == "IM"
 
 
-def test_name_limit(tmp_path):
+def test_name_limit(tmp_path: Path) -> None:
     out = str(tmp_path / ("name_limit_test" * 7 + ".im"))
     with Image.open(TEST_IM) as im:
         im.save(out)
@@ -29,8 +30,8 @@ def test_name_limit(tmp_path):
 
 
 @pytest.mark.skipif(is_pypy(), reason="Requires CPython")
-def test_unclosed_file():
-    def open():
+def test_unclosed_file() -> None:
+    def open() -> None:
         im = Image.open(TEST_IM)
         im.load()
 
@@ -38,20 +39,20 @@ def open():
         open()
 
 
-def test_closed_file():
+def test_closed_file() -> None:
     with warnings.catch_warnings():
         im = Image.open(TEST_IM)
         im.load()
         im.close()
 
 
-def test_context_manager():
+def test_context_manager() -> None:
     with warnings.catch_warnings():
         with Image.open(TEST_IM) as im:
             im.load()
 
 
-def test_tell():
+def test_tell() -> None:
     # Arrange
     with Image.open(TEST_IM) as im:
         # Act
@@ -61,13 +62,13 @@ def test_tell():
     assert frame == 0
 
 
-def test_n_frames():
+def test_n_frames() -> None:
     with Image.open(TEST_IM) as im:
         assert im.n_frames == 1
         assert not im.is_animated
 
 
-def test_eoferror():
+def test_eoferror() -> None:
     with Image.open(TEST_IM) as im:
         n_frames = im.n_frames
 
@@ -81,14 +82,14 @@ def test_eoferror():
 
 
 @pytest.mark.parametrize("mode", ("RGB", "P", "PA"))
-def test_roundtrip(mode, tmp_path):
+def test_roundtrip(mode, tmp_path: Path) -> None:
     out = str(tmp_path / "temp.im")
     im = hopper(mode)
     im.save(out)
     assert_image_equal_tofile(im, out)
 
 
-def test_small_palette(tmp_path):
+def test_small_palette(tmp_path: Path) -> None:
     im = Image.new("P", (1, 1))
     colors = [0, 1, 2]
     im.putpalette(colors)
@@ -100,19 +101,19 @@ def test_small_palette(tmp_path):
         assert reloaded.getpalette() == colors + [0] * 765
 
 
-def test_save_unsupported_mode(tmp_path):
+def test_save_unsupported_mode(tmp_path: Path) -> None:
     out = str(tmp_path / "temp.im")
     im = hopper("HSV")
     with pytest.raises(ValueError):
         im.save(out)
 
 
-def test_invalid_file():
+def test_invalid_file() -> None:
     invalid_file = "Tests/images/flower.jpg"
 
     with pytest.raises(SyntaxError):
         ImImagePlugin.ImImageFile(invalid_file)
 
 
-def test_number():
+def test_number() -> None:
     assert ImImagePlugin.number("1.2") == 1.2
diff --git a/Tests/test_file_iptc.py b/Tests/test_file_iptc.py
index a2c50ecefdf..9c0969437ea 100644
--- a/Tests/test_file_iptc.py
+++ b/Tests/test_file_iptc.py
@@ -12,7 +12,7 @@
 TEST_FILE = "Tests/images/iptc.jpg"
 
 
-def test_open():
+def test_open() -> None:
     expected = Image.new("L", (1, 1))
 
     f = BytesIO(
@@ -24,7 +24,7 @@ def test_open():
         assert_image_equal(im, expected)
 
 
-def test_getiptcinfo_jpg_none():
+def test_getiptcinfo_jpg_none() -> None:
     # Arrange
     with hopper() as im:
         # Act
@@ -34,7 +34,7 @@ def test_getiptcinfo_jpg_none():
     assert iptc is None
 
 
-def test_getiptcinfo_jpg_found():
+def test_getiptcinfo_jpg_found() -> None:
     # Arrange
     with Image.open(TEST_FILE) as im:
         # Act
@@ -46,7 +46,7 @@ def test_getiptcinfo_jpg_found():
     assert iptc[(2, 101)] == b"Hungary"
 
 
-def test_getiptcinfo_fotostation():
+def test_getiptcinfo_fotostation() -> None:
     # Arrange
     with open(TEST_FILE, "rb") as fp:
         data = bytearray(fp.read())
@@ -63,7 +63,7 @@ def test_getiptcinfo_fotostation():
     pytest.fail("FotoStation tag not found")
 
 
-def test_getiptcinfo_zero_padding():
+def test_getiptcinfo_zero_padding() -> None:
     # Arrange
     with Image.open(TEST_FILE) as im:
         im.info["photoshop"][0x0404] += b"\x00\x00\x00"
@@ -76,7 +76,7 @@ def test_getiptcinfo_zero_padding():
     assert len(iptc) == 3
 
 
-def test_getiptcinfo_tiff_none():
+def test_getiptcinfo_tiff_none() -> None:
     # Arrange
     with Image.open("Tests/images/hopper.tif") as im:
         # Act
@@ -86,7 +86,7 @@ def test_getiptcinfo_tiff_none():
     assert iptc is None
 
 
-def test_i():
+def test_i() -> None:
     # Arrange
     c = b"a"
 
@@ -98,7 +98,7 @@ def test_i():
     assert ret == 97
 
 
-def test_dump(monkeypatch):
+def test_dump(monkeypatch) -> None:
     # Arrange
     c = b"abc"
     # Temporarily redirect stdout
@@ -113,6 +113,6 @@ def test_dump(monkeypatch):
     assert mystdout.getvalue() == "61 62 63 \n"
 
 
-def test_pad_deprecation():
+def test_pad_deprecation() -> None:
     with pytest.warns(DeprecationWarning):
         assert IptcImagePlugin.PAD == b"\0\0\0\0"
diff --git a/Tests/test_file_jpeg.py b/Tests/test_file_jpeg.py
index 232e51f9126..ff278d4c1bf 100644
--- a/Tests/test_file_jpeg.py
+++ b/Tests/test_file_jpeg.py
@@ -4,6 +4,7 @@
 import re
 import warnings
 from io import BytesIO
+from pathlib import Path
 
 import pytest
 
@@ -50,7 +51,7 @@ def roundtrip(self, im, **options):
         im.bytes = test_bytes  # for testing only
         return im
 
-    def gen_random_image(self, size, mode="RGB"):
+    def gen_random_image(self, size, mode: str = "RGB"):
         """Generates a very hard to compress file
         :param size: tuple
         :param mode: optional image mode
@@ -58,7 +59,7 @@ def gen_random_image(self, size, mode="RGB"):
         """
         return Image.frombytes(mode, size, os.urandom(size[0] * size[1] * len(mode)))
 
-    def test_sanity(self):
+    def test_sanity(self) -> None:
         # internal version number
         assert re.search(r"\d+\.\d+$", features.version_codec("jpg"))
 
@@ -70,13 +71,13 @@ def test_sanity(self):
             assert im.get_format_mimetype() == "image/jpeg"
 
     @pytest.mark.parametrize("size", ((1, 0), (0, 1), (0, 0)))
-    def test_zero(self, size, tmp_path):
+    def test_zero(self, size, tmp_path: Path) -> None:
         f = str(tmp_path / "temp.jpg")
         im = Image.new("RGB", size)
         with pytest.raises(ValueError):
             im.save(f)
 
-    def test_app(self):
+    def test_app(self) -> None:
         # Test APP/COM reader (@PIL135)
         with Image.open(TEST_FILE) as im:
             assert im.applist[0] == ("APP0", b"JFIF\x00\x01\x01\x01\x00`\x00`\x00\x00")
@@ -89,7 +90,7 @@ def test_app(self):
             assert im.info["comment"] == b"File written by Adobe Photoshop\xa8 4.0\x00"
             assert im.app["COM"] == im.info["comment"]
 
-    def test_comment_write(self):
+    def test_comment_write(self) -> None:
         with Image.open(TEST_FILE) as im:
             assert im.info["comment"] == b"File written by Adobe Photoshop\xa8 4.0\x00"
 
@@ -115,7 +116,7 @@ def test_comment_write(self):
                         comment = comment.encode()
                     assert reloaded.info["comment"] == comment
 
-    def test_cmyk(self):
+    def test_cmyk(self) -> None:
         # Test CMYK handling.  Thanks to Tim and Charlie for test data,
         # Michael for getting me to look one more time.
         f = "Tests/images/pil_sample_cmyk.jpg"
@@ -143,7 +144,7 @@ def test_cmyk(self):
             )
             assert k > 0.9
 
-    def test_rgb(self):
+    def test_rgb(self) -> None:
         def getchannels(im):
             return tuple(v[0] for v in im.layer)
 
@@ -160,7 +161,7 @@ def getchannels(im):
         "test_image_path",
         [TEST_FILE, "Tests/images/pil_sample_cmyk.jpg"],
     )
-    def test_dpi(self, test_image_path):
+    def test_dpi(self, test_image_path) -> None:
         def test(xdpi, ydpi=None):
             with Image.open(test_image_path) as im:
                 im = self.roundtrip(im, dpi=(xdpi, ydpi or xdpi))
@@ -174,7 +175,7 @@ def test(xdpi, ydpi=None):
     @mark_if_feature_version(
         pytest.mark.valgrind_known_error, "libjpeg_turbo", "2.0", reason="Known Failing"
     )
-    def test_icc(self, tmp_path):
+    def test_icc(self, tmp_path: Path) -> None:
         # Test ICC support
         with Image.open("Tests/images/rgb.jpg") as im1:
             icc_profile = im1.info["icc_profile"]
@@ -206,7 +207,7 @@ def test_icc(self, tmp_path):
             ImageFile.MAXBLOCK * 4 + 3,  # large block
         ),
     )
-    def test_icc_big(self, n):
+    def test_icc_big(self, n) -> None:
         # Make sure that the "extra" support handles large blocks
         # The ICC APP marker can store 65519 bytes per marker, so
         # using a 4-byte test code should allow us to detect out of
@@ -219,7 +220,7 @@ def test_icc_big(self, n):
     @mark_if_feature_version(
         pytest.mark.valgrind_known_error, "libjpeg_turbo", "2.0", reason="Known Failing"
     )
-    def test_large_icc_meta(self, tmp_path):
+    def test_large_icc_meta(self, tmp_path: Path) -> None:
         # https://github.com/python-pillow/Pillow/issues/148
         # Sometimes the meta data on the icc_profile block is bigger than
         # Image.MAXBLOCK or the image size.
@@ -243,7 +244,7 @@ def test_large_icc_meta(self, tmp_path):
             f = str(tmp_path / "temp3.jpg")
             im.save(f, progressive=True, quality=94, exif=b" " * 43668)
 
-    def test_optimize(self):
+    def test_optimize(self) -> None:
         im1 = self.roundtrip(hopper())
         im2 = self.roundtrip(hopper(), optimize=0)
         im3 = self.roundtrip(hopper(), optimize=1)
@@ -252,14 +253,14 @@ def test_optimize(self):
         assert im1.bytes >= im2.bytes
         assert im1.bytes >= im3.bytes
 
-    def test_optimize_large_buffer(self, tmp_path):
+    def test_optimize_large_buffer(self, tmp_path: Path) -> None:
         # https://github.com/python-pillow/Pillow/issues/148
         f = str(tmp_path / "temp.jpg")
         # this requires ~ 1.5x Image.MAXBLOCK
         im = Image.new("RGB", (4096, 4096), 0xFF3333)
         im.save(f, format="JPEG", optimize=True)
 
-    def test_progressive(self):
+    def test_progressive(self) -> None:
         im1 = self.roundtrip(hopper())
         im2 = self.roundtrip(hopper(), progressive=False)
         im3 = self.roundtrip(hopper(), progressive=True)
@@ -270,25 +271,25 @@ def test_progressive(self):
         assert_image_equal(im1, im3)
         assert im1.bytes >= im3.bytes
 
-    def test_progressive_large_buffer(self, tmp_path):
+    def test_progressive_large_buffer(self, tmp_path: Path) -> None:
         f = str(tmp_path / "temp.jpg")
         # this requires ~ 1.5x Image.MAXBLOCK
         im = Image.new("RGB", (4096, 4096), 0xFF3333)
         im.save(f, format="JPEG", progressive=True)
 
-    def test_progressive_large_buffer_highest_quality(self, tmp_path):
+    def test_progressive_large_buffer_highest_quality(self, tmp_path: Path) -> None:
         f = str(tmp_path / "temp.jpg")
         im = self.gen_random_image((255, 255))
         # this requires more bytes than pixels in the image
         im.save(f, format="JPEG", progressive=True, quality=100)
 
-    def test_progressive_cmyk_buffer(self):
+    def test_progressive_cmyk_buffer(self) -> None:
         # Issue 2272, quality 90 cmyk image is tripping the large buffer bug.
         f = BytesIO()
         im = self.gen_random_image((256, 256), "CMYK")
         im.save(f, format="JPEG", progressive=True, quality=94)
 
-    def test_large_exif(self, tmp_path):
+    def test_large_exif(self, tmp_path: Path) -> None:
         # https://github.com/python-pillow/Pillow/issues/148
         f = str(tmp_path / "temp.jpg")
         im = hopper()
@@ -297,12 +298,12 @@ def test_large_exif(self, tmp_path):
         with pytest.raises(ValueError):
             im.save(f, "JPEG", quality=90, exif=b"1" * 65534)
 
-    def test_exif_typeerror(self):
+    def test_exif_typeerror(self) -> None:
         with Image.open("Tests/images/exif_typeerror.jpg") as im:
             # Should not raise a TypeError
             im._getexif()
 
-    def test_exif_gps(self, tmp_path):
+    def test_exif_gps(self, tmp_path: Path) -> None:
         expected_exif_gps = {
             0: b"\x00\x00\x00\x01",
             2: 4294967295,
@@ -327,7 +328,7 @@ def test_exif_gps(self, tmp_path):
             exif = reloaded._getexif()
             assert exif[gps_index] == expected_exif_gps
 
-    def test_empty_exif_gps(self):
+    def test_empty_exif_gps(self) -> None:
         with Image.open("Tests/images/empty_gps_ifd.jpg") as im:
             exif = im.getexif()
             del exif[0x8769]
@@ -345,7 +346,7 @@ def test_empty_exif_gps(self):
         # Assert that it was transposed
         assert 0x0112 not in exif
 
-    def test_exif_equality(self):
+    def test_exif_equality(self) -> None:
         # In 7.2.0, Exif rationals were changed to be read as
         # TiffImagePlugin.IFDRational. This class had a bug in __eq__,
         # breaking the self-equality of Exif data
@@ -355,7 +356,7 @@ def test_exif_equality(self):
                 exifs.append(im._getexif())
         assert exifs[0] == exifs[1]
 
-    def test_exif_rollback(self):
+    def test_exif_rollback(self) -> None:
         # rolling back exif support in 3.1 to pre-3.0 formatting.
         # expected from 2.9, with b/u qualifiers switched for 3.2 compatibility
         # this test passes on 2.9 and 3.1, but not 3.0
@@ -390,12 +391,12 @@ def test_exif_rollback(self):
         for tag, value in expected_exif.items():
             assert value == exif[tag]
 
-    def test_exif_gps_typeerror(self):
+    def test_exif_gps_typeerror(self) -> None:
         with Image.open("Tests/images/exif_gps_typeerror.jpg") as im:
             # Should not raise a TypeError
             im._getexif()
 
-    def test_progressive_compat(self):
+    def test_progressive_compat(self) -> None:
         im1 = self.roundtrip(hopper())
         assert not im1.info.get("progressive")
         assert not im1.info.get("progression")
@@ -416,7 +417,7 @@ def test_progressive_compat(self):
         assert im3.info.get("progressive")
         assert im3.info.get("progression")
 
-    def test_quality(self):
+    def test_quality(self) -> None:
         im1 = self.roundtrip(hopper())
         im2 = self.roundtrip(hopper(), quality=50)
         assert_image(im1, im2.mode, im2.size)
@@ -426,12 +427,12 @@ def test_quality(self):
         assert_image(im1, im3.mode, im3.size)
         assert im2.bytes > im3.bytes
 
-    def test_smooth(self):
+    def test_smooth(self) -> None:
         im1 = self.roundtrip(hopper())
         im2 = self.roundtrip(hopper(), smooth=100)
         assert_image(im1, im2.mode, im2.size)
 
-    def test_subsampling(self):
+    def test_subsampling(self) -> None:
         def getsampling(im):
             layer = im.layer
             return layer[0][1:3] + layer[1][1:3] + layer[2][1:3]
@@ -463,23 +464,23 @@ def getsampling(im):
         with pytest.raises(TypeError):
             self.roundtrip(hopper(), subsampling="1:1:1")
 
-    def test_exif(self):
+    def test_exif(self) -> None:
         with Image.open("Tests/images/pil_sample_rgb.jpg") as im:
             info = im._getexif()
             assert info[305] == "Adobe Photoshop CS Macintosh"
 
-    def test_get_child_images(self):
+    def test_get_child_images(self) -> None:
         with Image.open("Tests/images/flower.jpg") as im:
             ims = im.get_child_images()
 
         assert len(ims) == 1
         assert_image_similar_tofile(ims[0], "Tests/images/flower_thumbnail.png", 2.1)
 
-    def test_mp(self):
+    def test_mp(self) -> None:
         with Image.open("Tests/images/pil_sample_rgb.jpg") as im:
             assert im._getmp() is None
 
-    def test_quality_keep(self, tmp_path):
+    def test_quality_keep(self, tmp_path: Path) -> None:
         # RGB
         with Image.open("Tests/images/hopper.jpg") as im:
             f = str(tmp_path / "temp.jpg")
@@ -493,13 +494,13 @@ def test_quality_keep(self, tmp_path):
             f = str(tmp_path / "temp.jpg")
             im.save(f, quality="keep")
 
-    def test_junk_jpeg_header(self):
+    def test_junk_jpeg_header(self) -> None:
         # https://github.com/python-pillow/Pillow/issues/630
         filename = "Tests/images/junk_jpeg_header.jpg"
         with Image.open(filename):
             pass
 
-    def test_ff00_jpeg_header(self):
+    def test_ff00_jpeg_header(self) -> None:
         filename = "Tests/images/jpeg_ff00_header.jpg"
         with Image.open(filename):
             pass
@@ -507,7 +508,7 @@ def test_ff00_jpeg_header(self):
     @mark_if_feature_version(
         pytest.mark.valgrind_known_error, "libjpeg_turbo", "2.0", reason="Known Failing"
     )
-    def test_truncated_jpeg_should_read_all_the_data(self):
+    def test_truncated_jpeg_should_read_all_the_data(self) -> None:
         filename = "Tests/images/truncated_jpeg.jpg"
         ImageFile.LOAD_TRUNCATED_IMAGES = True
         with Image.open(filename) as im:
@@ -515,7 +516,7 @@ def test_truncated_jpeg_should_read_all_the_data(self):
             ImageFile.LOAD_TRUNCATED_IMAGES = False
             assert im.getbbox() is not None
 
-    def test_truncated_jpeg_throws_oserror(self):
+    def test_truncated_jpeg_throws_oserror(self) -> None:
         filename = "Tests/images/truncated_jpeg.jpg"
         with Image.open(filename) as im:
             with pytest.raises(OSError):
@@ -528,8 +529,8 @@ def test_truncated_jpeg_throws_oserror(self):
     @mark_if_feature_version(
         pytest.mark.valgrind_known_error, "libjpeg_turbo", "2.0", reason="Known Failing"
     )
-    def test_qtables(self, tmp_path):
-        def _n_qtables_helper(n, test_file):
+    def test_qtables(self, tmp_path: Path) -> None:
+        def _n_qtables_helper(n, test_file) -> None:
             with Image.open(test_file) as im:
                 f = str(tmp_path / "temp.jpg")
                 im.save(f, qtables=[[n] * 64] * n)
@@ -637,24 +638,24 @@ def _n_qtables_helper(n, test_file):
             with pytest.raises(ValueError):
                 self.roundtrip(im, qtables=[[1, 2, 3, 4]])
 
-    def test_load_16bit_qtables(self):
+    def test_load_16bit_qtables(self) -> None:
         with Image.open("Tests/images/hopper_16bit_qtables.jpg") as im:
             assert len(im.quantization) == 2
             assert len(im.quantization[0]) == 64
             assert max(im.quantization[0]) > 255
 
-    def test_save_multiple_16bit_qtables(self):
+    def test_save_multiple_16bit_qtables(self) -> None:
         with Image.open("Tests/images/hopper_16bit_qtables.jpg") as im:
             im2 = self.roundtrip(im, qtables="keep")
             assert im.quantization == im2.quantization
 
-    def test_save_single_16bit_qtable(self):
+    def test_save_single_16bit_qtable(self) -> None:
         with Image.open("Tests/images/hopper_16bit_qtables.jpg") as im:
             im2 = self.roundtrip(im, qtables={0: im.quantization[0]})
             assert len(im2.quantization) == 1
             assert im2.quantization[0] == im.quantization[0]
 
-    def test_save_low_quality_baseline_qtables(self):
+    def test_save_low_quality_baseline_qtables(self) -> None:
         with Image.open(TEST_FILE) as im:
             im2 = self.roundtrip(im, quality=10)
             assert len(im2.quantization) == 2
@@ -665,7 +666,7 @@ def test_save_low_quality_baseline_qtables(self):
         "blocks, rows, markers",
         ((0, 0, 0), (1, 0, 15), (3, 0, 5), (8, 0, 1), (0, 1, 3), (0, 2, 1)),
     )
-    def test_restart_markers(self, blocks, rows, markers):
+    def test_restart_markers(self, blocks, rows, markers) -> None:
         im = Image.new("RGB", (32, 32))  # 16 MCUs
         out = BytesIO()
         im.save(
@@ -679,20 +680,20 @@ def test_restart_markers(self, blocks, rows, markers):
         assert len(re.findall(b"\xff[\xd0-\xd7]", out.getvalue())) == markers
 
     @pytest.mark.skipif(not djpeg_available(), reason="djpeg not available")
-    def test_load_djpeg(self):
+    def test_load_djpeg(self) -> None:
         with Image.open(TEST_FILE) as img:
             img.load_djpeg()
             assert_image_similar_tofile(img, TEST_FILE, 5)
 
     @pytest.mark.skipif(not cjpeg_available(), reason="cjpeg not available")
-    def test_save_cjpeg(self, tmp_path):
+    def test_save_cjpeg(self, tmp_path: Path) -> None:
         with Image.open(TEST_FILE) as img:
             tempfile = str(tmp_path / "temp.jpg")
             JpegImagePlugin._save_cjpeg(img, 0, tempfile)
             # Default save quality is 75%, so a tiny bit of difference is alright
             assert_image_similar_tofile(img, tempfile, 17)
 
-    def test_no_duplicate_0x1001_tag(self):
+    def test_no_duplicate_0x1001_tag(self) -> None:
         # Arrange
         tag_ids = {v: k for k, v in ExifTags.TAGS.items()}
 
@@ -700,7 +701,7 @@ def test_no_duplicate_0x1001_tag(self):
         assert tag_ids["RelatedImageWidth"] == 0x1001
         assert tag_ids["RelatedImageLength"] == 0x1002
 
-    def test_MAXBLOCK_scaling(self, tmp_path):
+    def test_MAXBLOCK_scaling(self, tmp_path: Path) -> None:
         im = self.gen_random_image((512, 512))
         f = str(tmp_path / "temp.jpeg")
         im.save(f, quality=100, optimize=True)
@@ -711,7 +712,7 @@ def test_MAXBLOCK_scaling(self, tmp_path):
             reloaded.save(f, quality="keep", progressive=True)
             reloaded.save(f, quality="keep", optimize=True)
 
-    def test_bad_mpo_header(self):
+    def test_bad_mpo_header(self) -> None:
         """Treat unknown MPO as JPEG"""
         # Arrange
 
@@ -723,20 +724,20 @@ def test_bad_mpo_header(self):
             assert im.format == "JPEG"
 
     @pytest.mark.parametrize("mode", ("1", "L", "RGB", "RGBX", "CMYK", "YCbCr"))
-    def test_save_correct_modes(self, mode):
+    def test_save_correct_modes(self, mode) -> None:
         out = BytesIO()
         img = Image.new(mode, (20, 20))
         img.save(out, "JPEG")
 
     @pytest.mark.parametrize("mode", ("LA", "La", "RGBA", "RGBa", "P"))
-    def test_save_wrong_modes(self, mode):
+    def test_save_wrong_modes(self, mode) -> None:
         # ref https://github.com/python-pillow/Pillow/issues/2005
         out = BytesIO()
         img = Image.new(mode, (20, 20))
         with pytest.raises(OSError):
             img.save(out, "JPEG")
 
-    def test_save_tiff_with_dpi(self, tmp_path):
+    def test_save_tiff_with_dpi(self, tmp_path: Path) -> None:
         # Arrange
         outfile = str(tmp_path / "temp.tif")
         with Image.open("Tests/images/hopper.tif") as im:
@@ -748,7 +749,7 @@ def test_save_tiff_with_dpi(self, tmp_path):
                 reloaded.load()
                 assert im.info["dpi"] == reloaded.info["dpi"]
 
-    def test_save_dpi_rounding(self, tmp_path):
+    def test_save_dpi_rounding(self, tmp_path: Path) -> None:
         outfile = str(tmp_path / "temp.jpg")
         with Image.open("Tests/images/hopper.jpg") as im:
             im.save(outfile, dpi=(72.2, 72.2))
@@ -761,7 +762,7 @@ def test_save_dpi_rounding(self, tmp_path):
         with Image.open(outfile) as reloaded:
             assert reloaded.info["dpi"] == (73, 73)
 
-    def test_dpi_tuple_from_exif(self):
+    def test_dpi_tuple_from_exif(self) -> None:
         # Arrange
         # This Photoshop CC 2017 image has DPI in EXIF not metadata
         # EXIF XResolution is (2000000, 10000)
@@ -769,7 +770,7 @@ def test_dpi_tuple_from_exif(self):
             # Act / Assert
             assert im.info.get("dpi") == (200, 200)
 
-    def test_dpi_int_from_exif(self):
+    def test_dpi_int_from_exif(self) -> None:
         # Arrange
         # This image has DPI in EXIF not metadata
         # EXIF XResolution is 72
@@ -777,7 +778,7 @@ def test_dpi_int_from_exif(self):
             # Act / Assert
             assert im.info.get("dpi") == (72, 72)
 
-    def test_dpi_from_dpcm_exif(self):
+    def test_dpi_from_dpcm_exif(self) -> None:
         # Arrange
         # This is photoshop-200dpi.jpg with EXIF resolution unit set to cm:
         # exiftool -exif:ResolutionUnit=cm photoshop-200dpi.jpg
@@ -785,7 +786,7 @@ def test_dpi_from_dpcm_exif(self):
             # Act / Assert
             assert im.info.get("dpi") == (508, 508)
 
-    def test_dpi_exif_zero_division(self):
+    def test_dpi_exif_zero_division(self) -> None:
         # Arrange
         # This is photoshop-200dpi.jpg with EXIF resolution set to 0/0:
         # exiftool -XResolution=0/0 -YResolution=0/0 photoshop-200dpi.jpg
@@ -794,7 +795,7 @@ def test_dpi_exif_zero_division(self):
             # This should return the default, and not raise a ZeroDivisionError
             assert im.info.get("dpi") == (72, 72)
 
-    def test_dpi_exif_string(self):
+    def test_dpi_exif_string(self) -> None:
         # Arrange
         # 0x011A tag in this exif contains string '300300\x02'
         with Image.open("Tests/images/broken_exif_dpi.jpg") as im:
@@ -802,14 +803,14 @@ def test_dpi_exif_string(self):
             # This should return the default
             assert im.info.get("dpi") == (72, 72)
 
-    def test_dpi_exif_truncated(self):
+    def test_dpi_exif_truncated(self) -> None:
         # Arrange
         with Image.open("Tests/images/truncated_exif_dpi.jpg") as im:
             # Act / Assert
             # This should return the default
             assert im.info.get("dpi") == (72, 72)
 
-    def test_no_dpi_in_exif(self):
+    def test_no_dpi_in_exif(self) -> None:
         # Arrange
         # This is photoshop-200dpi.jpg with resolution removed from EXIF:
         # exiftool "-*resolution*"= photoshop-200dpi.jpg
@@ -819,7 +820,7 @@ def test_no_dpi_in_exif(self):
             # https://exiv2.org/tags.html
             assert im.info.get("dpi") == (72, 72)
 
-    def test_invalid_exif(self):
+    def test_invalid_exif(self) -> None:
         # This is no-dpi-in-exif with the tiff header of the exif block
         # hexedited from MM * to FF FF FF FF
         with Image.open("Tests/images/invalid-exif.jpg") as im:
@@ -830,7 +831,7 @@ def test_invalid_exif(self):
     @mark_if_feature_version(
         pytest.mark.valgrind_known_error, "libjpeg_turbo", "2.0", reason="Known Failing"
     )
-    def test_exif_x_resolution(self, tmp_path):
+    def test_exif_x_resolution(self, tmp_path: Path) -> None:
         with Image.open("Tests/images/flower.jpg") as im:
             exif = im.getexif()
             assert exif[282] == 180
@@ -842,14 +843,14 @@ def test_exif_x_resolution(self, tmp_path):
         with Image.open(out) as reloaded:
             assert reloaded.getexif()[282] == 180
 
-    def test_invalid_exif_x_resolution(self):
+    def test_invalid_exif_x_resolution(self) -> None:
         # When no x or y resolution is defined in EXIF
         with Image.open("Tests/images/invalid-exif-without-x-resolution.jpg") as im:
             # This should return the default, and not a ValueError or
             # OSError for an unidentified image.
             assert im.info.get("dpi") == (72, 72)
 
-    def test_ifd_offset_exif(self):
+    def test_ifd_offset_exif(self) -> None:
         # Arrange
         # This image has been manually hexedited to have an IFD offset of 10,
         # in contrast to normal 8
@@ -857,14 +858,14 @@ def test_ifd_offset_exif(self):
             # Act / Assert
             assert im._getexif()[306] == "2017:03:13 23:03:09"
 
-    def test_multiple_exif(self):
+    def test_multiple_exif(self) -> None:
         with Image.open("Tests/images/multiple_exif.jpg") as im:
             assert im.info["exif"] == b"Exif\x00\x00firstsecond"
 
     @mark_if_feature_version(
         pytest.mark.valgrind_known_error, "libjpeg_turbo", "2.0", reason="Known Failing"
     )
-    def test_photoshop(self):
+    def test_photoshop(self) -> None:
         with Image.open("Tests/images/photoshop-200dpi.jpg") as im:
             assert im.info["photoshop"][0x03ED] == {
                 "XResolution": 200.0,
@@ -881,14 +882,14 @@ def test_photoshop(self):
         with Image.open("Tests/images/app13.jpg") as im:
             assert "photoshop" not in im.info
 
-    def test_photoshop_malformed_and_multiple(self):
+    def test_photoshop_malformed_and_multiple(self) -> None:
         with Image.open("Tests/images/app13-multiple.jpg") as im:
             assert "photoshop" in im.info
             assert 24 == len(im.info["photoshop"])
             apps_13_lengths = [len(v) for k, v in im.applist if k == "APP13"]
             assert [65504, 24] == apps_13_lengths
 
-    def test_adobe_transform(self):
+    def test_adobe_transform(self) -> None:
         with Image.open("Tests/images/pil_sample_rgb.jpg") as im:
             assert im.info["adobe_transform"] == 1
 
@@ -902,11 +903,11 @@ def test_adobe_transform(self):
             assert "adobe" in im.info
             assert "adobe_transform" not in im.info
 
-    def test_icc_after_SOF(self):
+    def test_icc_after_SOF(self) -> None:
         with Image.open("Tests/images/icc-after-SOF.jpg") as im:
             assert im.info["icc_profile"] == b"profile"
 
-    def test_jpeg_magic_number(self):
+    def test_jpeg_magic_number(self) -> None:
         size = 4097
         buffer = BytesIO(b"\xFF" * size)  # Many xFF bytes
         buffer.max_pos = 0
@@ -925,7 +926,7 @@ def read(n=-1):
         # Assert the entire file has not been read
         assert 0 < buffer.max_pos < size
 
-    def test_getxmp(self):
+    def test_getxmp(self) -> None:
         with Image.open("Tests/images/xmp_test.jpg") as im:
             if ElementTree is None:
                 with pytest.warns(
@@ -954,7 +955,7 @@ def test_getxmp(self):
             with Image.open("Tests/images/hopper.jpg") as im:
                 assert im.getxmp() == {}
 
-    def test_getxmp_no_prefix(self):
+    def test_getxmp_no_prefix(self) -> None:
         with Image.open("Tests/images/xmp_no_prefix.jpg") as im:
             if ElementTree is None:
                 with pytest.warns(
@@ -965,7 +966,7 @@ def test_getxmp_no_prefix(self):
             else:
                 assert im.getxmp() == {"xmpmeta": {"key": "value"}}
 
-    def test_getxmp_padded(self):
+    def test_getxmp_padded(self) -> None:
         with Image.open("Tests/images/xmp_padded.jpg") as im:
             if ElementTree is None:
                 with pytest.warns(
@@ -977,7 +978,7 @@ def test_getxmp_padded(self):
                 assert im.getxmp() == {"xmpmeta": None}
 
     @pytest.mark.timeout(timeout=1)
-    def test_eof(self):
+    def test_eof(self) -> None:
         # Even though this decoder never says that it is finished
         # the image should still end when there is no new data
         class InfiniteMockPyDecoder(ImageFile.PyDecoder):
@@ -1000,7 +1001,7 @@ def closure(mode, *args):
             im.load()
             ImageFile.LOAD_TRUNCATED_IMAGES = False
 
-    def test_separate_tables(self):
+    def test_separate_tables(self) -> None:
         im = hopper()
         data = []  # [interchange, tables-only, image-only]
         for streamtype in range(3):
@@ -1022,14 +1023,14 @@ def test_separate_tables(self):
             with Image.open(BytesIO(data[1] + data[2])) as combined_im:
                 assert_image_equal(interchange_im, combined_im)
 
-    def test_repr_jpeg(self):
+    def test_repr_jpeg(self) -> None:
         im = hopper()
 
         with Image.open(BytesIO(im._repr_jpeg_())) as repr_jpeg:
             assert repr_jpeg.format == "JPEG"
             assert_image_similar(im, repr_jpeg, 17)
 
-    def test_repr_jpeg_error_returns_none(self):
+    def test_repr_jpeg_error_returns_none(self) -> None:
         im = hopper("F")
 
         assert im._repr_jpeg_() is None
@@ -1038,7 +1039,7 @@ def test_repr_jpeg_error_returns_none(self):
 @pytest.mark.skipif(not is_win32(), reason="Windows only")
 @skip_unless_feature("jpg")
 class TestFileCloseW32:
-    def test_fd_leak(self, tmp_path):
+    def test_fd_leak(self, tmp_path: Path) -> None:
         tmpfile = str(tmp_path / "temp.jpg")
 
         with Image.open("Tests/images/hopper.jpg") as im:
diff --git a/Tests/test_file_jpeg2k.py b/Tests/test_file_jpeg2k.py
index 94b02c9ff52..e3f1fa8fde1 100644
--- a/Tests/test_file_jpeg2k.py
+++ b/Tests/test_file_jpeg2k.py
@@ -3,6 +3,7 @@
 import os
 import re
 from io import BytesIO
+from pathlib import Path
 
 import pytest
 
@@ -46,7 +47,7 @@ def roundtrip(im, **options):
     return im
 
 
-def test_sanity():
+def test_sanity() -> None:
     # Internal version number
     assert re.search(r"\d+\.\d+\.\d+$", features.version_codec("jpg_2000"))
 
@@ -59,20 +60,20 @@ def test_sanity():
         assert im.get_format_mimetype() == "image/jp2"
 
 
-def test_jpf():
+def test_jpf() -> None:
     with Image.open("Tests/images/balloon.jpf") as im:
         assert im.format == "JPEG2000"
         assert im.get_format_mimetype() == "image/jpx"
 
 
-def test_invalid_file():
+def test_invalid_file() -> None:
     invalid_file = "Tests/images/flower.jpg"
 
     with pytest.raises(SyntaxError):
         Jpeg2KImagePlugin.Jpeg2KImageFile(invalid_file)
 
 
-def test_bytesio():
+def test_bytesio() -> None:
     with open("Tests/images/test-card-lossless.jp2", "rb") as f:
         data = BytesIO(f.read())
     assert_image_similar_tofile(test_card, data, 1.0e-3)
@@ -82,7 +83,7 @@ def test_bytesio():
 # PIL (they were made using Adobe Photoshop)
 
 
-def test_lossless(tmp_path):
+def test_lossless(tmp_path: Path) -> None:
     with Image.open("Tests/images/test-card-lossless.jp2") as im:
         im.load()
         outfile = str(tmp_path / "temp_test-card.png")
@@ -90,54 +91,54 @@ def test_lossless(tmp_path):
     assert_image_similar(im, test_card, 1.0e-3)
 
 
-def test_lossy_tiled():
+def test_lossy_tiled() -> None:
     assert_image_similar_tofile(
         test_card, "Tests/images/test-card-lossy-tiled.jp2", 2.0
     )
 
 
-def test_lossless_rt():
+def test_lossless_rt() -> None:
     im = roundtrip(test_card)
     assert_image_equal(im, test_card)
 
 
-def test_lossy_rt():
+def test_lossy_rt() -> None:
     im = roundtrip(test_card, quality_layers=[20])
     assert_image_similar(im, test_card, 2.0)
 
 
-def test_tiled_rt():
+def test_tiled_rt() -> None:
     im = roundtrip(test_card, tile_size=(128, 128))
     assert_image_equal(im, test_card)
 
 
-def test_tiled_offset_rt():
+def test_tiled_offset_rt() -> None:
     im = roundtrip(test_card, tile_size=(128, 128), tile_offset=(0, 0), offset=(32, 32))
     assert_image_equal(im, test_card)
 
 
-def test_tiled_offset_too_small():
+def test_tiled_offset_too_small() -> None:
     with pytest.raises(ValueError):
         roundtrip(test_card, tile_size=(128, 128), tile_offset=(0, 0), offset=(128, 32))
 
 
-def test_irreversible_rt():
+def test_irreversible_rt() -> None:
     im = roundtrip(test_card, irreversible=True, quality_layers=[20])
     assert_image_similar(im, test_card, 2.0)
 
 
-def test_prog_qual_rt():
+def test_prog_qual_rt() -> None:
     im = roundtrip(test_card, quality_layers=[60, 40, 20], progression="LRCP")
     assert_image_similar(im, test_card, 2.0)
 
 
-def test_prog_res_rt():
+def test_prog_res_rt() -> None:
     im = roundtrip(test_card, num_resolutions=8, progression="RLCP")
     assert_image_equal(im, test_card)
 
 
 @pytest.mark.parametrize("num_resolutions", range(2, 6))
-def test_default_num_resolutions(num_resolutions):
+def test_default_num_resolutions(num_resolutions) -> None:
     d = 1 << (num_resolutions - 1)
     im = test_card.resize((d - 1, d - 1))
     with pytest.raises(OSError):
@@ -146,7 +147,7 @@ def test_default_num_resolutions(num_resolutions):
     assert_image_equal(im, reloaded)
 
 
-def test_reduce():
+def test_reduce() -> None:
     with Image.open("Tests/images/test-card-lossless.jp2") as im:
         assert callable(im.reduce)
 
@@ -160,7 +161,7 @@ def test_reduce():
         assert im.size == (40, 30)
 
 
-def test_load_dpi():
+def test_load_dpi() -> None:
     with Image.open("Tests/images/test-card-lossless.jp2") as im:
         assert im.info["dpi"] == (71.9836, 71.9836)
 
@@ -168,7 +169,7 @@ def test_load_dpi():
         assert "dpi" not in im.info
 
 
-def test_restricted_icc_profile():
+def test_restricted_icc_profile() -> None:
     ImageFile.LOAD_TRUNCATED_IMAGES = True
     try:
         # JPEG2000 image with a restricted ICC profile and a known colorspace
@@ -178,7 +179,7 @@ def test_restricted_icc_profile():
         ImageFile.LOAD_TRUNCATED_IMAGES = False
 
 
-def test_header_errors():
+def test_header_errors() -> None:
     for path in (
         "Tests/images/invalid_header_length.jp2",
         "Tests/images/not_enough_data.jp2",
@@ -192,7 +193,7 @@ def test_header_errors():
             pass
 
 
-def test_layers_type(tmp_path):
+def test_layers_type(tmp_path: Path) -> None:
     outfile = str(tmp_path / "temp_layers.jp2")
     for quality_layers in [[100, 50, 10], (100, 50, 10), None]:
         test_card.save(outfile, quality_layers=quality_layers)
@@ -202,7 +203,7 @@ def test_layers_type(tmp_path):
             test_card.save(outfile, quality_layers=quality_layers)
 
 
-def test_layers():
+def test_layers() -> None:
     out = BytesIO()
     test_card.save(out, "JPEG2000", quality_layers=[100, 50, 10], progression="LRCP")
     out.seek(0)
@@ -232,7 +233,7 @@ def test_layers():
         ("foo.jp2", {"no_jp2": False}, 4, b"jP"),
     ),
 )
-def test_no_jp2(name, args, offset, data):
+def test_no_jp2(name, args, offset, data) -> None:
     out = BytesIO()
     if name:
         out.name = name
@@ -241,7 +242,7 @@ def test_no_jp2(name, args, offset, data):
     assert out.read(2) == data
 
 
-def test_mct():
+def test_mct() -> None:
     # Three component
     for val in (0, 1):
         out = BytesIO()
@@ -262,7 +263,7 @@ def test_mct():
             assert_image_similar(im, jp2, 1.0e-3)
 
 
-def test_sgnd(tmp_path):
+def test_sgnd(tmp_path: Path) -> None:
     outfile = str(tmp_path / "temp.jp2")
 
     im = Image.new("L", (1, 1))
@@ -277,7 +278,7 @@ def test_sgnd(tmp_path):
 
 
 @pytest.mark.parametrize("ext", (".j2k", ".jp2"))
-def test_rgba(ext):
+def test_rgba(ext) -> None:
     # Arrange
     with Image.open("Tests/images/rgb_trns_ycbc" + ext) as im:
         # Act
@@ -288,47 +289,47 @@ def test_rgba(ext):
 
 
 @pytest.mark.parametrize("ext", (".j2k", ".jp2"))
-def test_16bit_monochrome_has_correct_mode(ext):
+def test_16bit_monochrome_has_correct_mode(ext) -> None:
     with Image.open("Tests/images/16bit.cropped" + ext) as im:
         im.load()
         assert im.mode == "I;16"
 
 
-def test_16bit_monochrome_jp2_like_tiff():
+def test_16bit_monochrome_jp2_like_tiff() -> None:
     with Image.open("Tests/images/16bit.cropped.tif") as tiff_16bit:
         assert_image_similar_tofile(tiff_16bit, "Tests/images/16bit.cropped.jp2", 1e-3)
 
 
-def test_16bit_monochrome_j2k_like_tiff():
+def test_16bit_monochrome_j2k_like_tiff() -> None:
     with Image.open("Tests/images/16bit.cropped.tif") as tiff_16bit:
         assert_image_similar_tofile(tiff_16bit, "Tests/images/16bit.cropped.j2k", 1e-3)
 
 
-def test_16bit_j2k_roundtrips():
+def test_16bit_j2k_roundtrips() -> None:
     with Image.open("Tests/images/16bit.cropped.j2k") as j2k:
         im = roundtrip(j2k)
         assert_image_equal(im, j2k)
 
 
-def test_16bit_jp2_roundtrips():
+def test_16bit_jp2_roundtrips() -> None:
     with Image.open("Tests/images/16bit.cropped.jp2") as jp2:
         im = roundtrip(jp2)
         assert_image_equal(im, jp2)
 
 
-def test_issue_6194():
+def test_issue_6194() -> None:
     with Image.open("Tests/images/issue_6194.j2k") as im:
         assert im.getpixel((5, 5)) == 31
 
 
-def test_unbound_local():
+def test_unbound_local() -> None:
     # prepatch, a malformed jp2 file could cause an UnboundLocalError exception.
     with pytest.raises(OSError):
         with Image.open("Tests/images/unbound_variable.jp2"):
             pass
 
 
-def test_parser_feed():
+def test_parser_feed() -> None:
     # Arrange
     with open("Tests/images/test-card-lossless.jp2", "rb") as f:
         data = f.read()
@@ -345,7 +346,7 @@ def test_parser_feed():
     not os.path.exists(EXTRA_DIR), reason="Extra image files not installed"
 )
 @pytest.mark.parametrize("name", ("subsampling_1", "subsampling_2", "zoo1", "zoo2"))
-def test_subsampling_decode(name):
+def test_subsampling_decode(name) -> None:
     test = f"{EXTRA_DIR}/{name}.jp2"
     reference = f"{EXTRA_DIR}/{name}.ppm"
 
@@ -361,7 +362,7 @@ def test_subsampling_decode(name):
         assert_image_similar(im, expected, epsilon)
 
 
-def test_comment():
+def test_comment() -> None:
     with Image.open("Tests/images/comment.jp2") as im:
         assert im.info["comment"] == b"Created by OpenJPEG version 2.5.0"
 
@@ -372,7 +373,7 @@ def test_comment():
             pass
 
 
-def test_save_comment():
+def test_save_comment() -> None:
     for comment in ("Created by Pillow", b"Created by Pillow"):
         out = BytesIO()
         test_card.save(out, "JPEG2000", comment=comment)
@@ -399,7 +400,7 @@ def test_save_comment():
         "Tests/images/crash-d2c93af851d3ab9a19e34503626368b2ecde9c03.j2k",
     ],
 )
-def test_crashes(test_file):
+def test_crashes(test_file) -> None:
     with open(test_file, "rb") as f:
         with Image.open(f) as im:
             # Valgrind should not complain here
@@ -410,7 +411,7 @@ def test_crashes(test_file):
 
 
 @skip_unless_feature_version("jpg_2000", "2.4.0")
-def test_plt_marker():
+def test_plt_marker() -> None:
     # Search the start of the codesteam for PLT
     out = BytesIO()
     test_card.save(out, "JPEG2000", no_jp2=True, plt=True)
diff --git a/Tests/test_file_libtiff.py b/Tests/test_file_libtiff.py
index 494253c87c1..1386034e5a3 100644
--- a/Tests/test_file_libtiff.py
+++ b/Tests/test_file_libtiff.py
@@ -7,6 +7,7 @@
 import re
 import sys
 from collections import namedtuple
+from pathlib import Path
 
 import pytest
 
@@ -26,7 +27,7 @@
 
 @skip_unless_feature("libtiff")
 class LibTiffTestCase:
-    def _assert_noerr(self, tmp_path, im):
+    def _assert_noerr(self, tmp_path: Path, im) -> None:
         """Helper tests that assert basic sanity about the g4 tiff reading"""
         # 1 bit
         assert im.mode == "1"
@@ -50,10 +51,10 @@ def _assert_noerr(self, tmp_path, im):
 
 
 class TestFileLibTiff(LibTiffTestCase):
-    def test_version(self):
+    def test_version(self) -> None:
         assert re.search(r"\d+\.\d+\.\d+$", features.version_codec("libtiff"))
 
-    def test_g4_tiff(self, tmp_path):
+    def test_g4_tiff(self, tmp_path: Path) -> None:
         """Test the ordinary file path load path"""
 
         test_file = "Tests/images/hopper_g4_500.tif"
@@ -61,12 +62,12 @@ def test_g4_tiff(self, tmp_path):
             assert im.size == (500, 500)
             self._assert_noerr(tmp_path, im)
 
-    def test_g4_large(self, tmp_path):
+    def test_g4_large(self, tmp_path: Path) -> None:
         test_file = "Tests/images/pport_g4.tif"
         with Image.open(test_file) as im:
             self._assert_noerr(tmp_path, im)
 
-    def test_g4_tiff_file(self, tmp_path):
+    def test_g4_tiff_file(self, tmp_path: Path) -> None:
         """Testing the string load path"""
 
         test_file = "Tests/images/hopper_g4_500.tif"
@@ -75,7 +76,7 @@ def test_g4_tiff_file(self, tmp_path):
                 assert im.size == (500, 500)
                 self._assert_noerr(tmp_path, im)
 
-    def test_g4_tiff_bytesio(self, tmp_path):
+    def test_g4_tiff_bytesio(self, tmp_path: Path) -> None:
         """Testing the stringio loading code path"""
         test_file = "Tests/images/hopper_g4_500.tif"
         s = io.BytesIO()
@@ -86,7 +87,7 @@ def test_g4_tiff_bytesio(self, tmp_path):
             assert im.size == (500, 500)
             self._assert_noerr(tmp_path, im)
 
-    def test_g4_non_disk_file_object(self, tmp_path):
+    def test_g4_non_disk_file_object(self, tmp_path: Path) -> None:
         """Testing loading from non-disk non-BytesIO file object"""
         test_file = "Tests/images/hopper_g4_500.tif"
         s = io.BytesIO()
@@ -98,18 +99,18 @@ def test_g4_non_disk_file_object(self, tmp_path):
             assert im.size == (500, 500)
             self._assert_noerr(tmp_path, im)
 
-    def test_g4_eq_png(self):
+    def test_g4_eq_png(self) -> None:
         """Checking that we're actually getting the data that we expect"""
         with Image.open("Tests/images/hopper_bw_500.png") as png:
             assert_image_equal_tofile(png, "Tests/images/hopper_g4_500.tif")
 
     # see https://github.com/python-pillow/Pillow/issues/279
-    def test_g4_fillorder_eq_png(self):
+    def test_g4_fillorder_eq_png(self) -> None:
         """Checking that we're actually getting the data that we expect"""
         with Image.open("Tests/images/g4-fillorder-test.tif") as g4:
             assert_image_equal_tofile(g4, "Tests/images/g4-fillorder-test.png")
 
-    def test_g4_write(self, tmp_path):
+    def test_g4_write(self, tmp_path: Path) -> None:
         """Checking to see that the saved image is the same as what we wrote"""
         test_file = "Tests/images/hopper_g4_500.tif"
         with Image.open(test_file) as orig:
@@ -128,7 +129,7 @@ def test_g4_write(self, tmp_path):
 
                 assert orig.tobytes() != reread.tobytes()
 
-    def test_adobe_deflate_tiff(self):
+    def test_adobe_deflate_tiff(self) -> None:
         test_file = "Tests/images/tiff_adobe_deflate.tif"
         with Image.open(test_file) as im:
             assert im.mode == "RGB"
@@ -139,7 +140,7 @@ def test_adobe_deflate_tiff(self):
             assert_image_equal_tofile(im, "Tests/images/tiff_adobe_deflate.png")
 
     @pytest.mark.parametrize("legacy_api", (False, True))
-    def test_write_metadata(self, legacy_api, tmp_path):
+    def test_write_metadata(self, legacy_api, tmp_path: Path) -> None:
         """Test metadata writing through libtiff"""
         f = str(tmp_path / "temp.tiff")
         with Image.open("Tests/images/hopper_g4.tif") as img:
@@ -184,7 +185,7 @@ def test_write_metadata(self, legacy_api, tmp_path):
             assert field in reloaded, f"{field} not in metadata"
 
     @pytest.mark.valgrind_known_error(reason="Known invalid metadata")
-    def test_additional_metadata(self, tmp_path):
+    def test_additional_metadata(self, tmp_path: Path) -> None:
         # these should not crash. Seriously dummy data, most of it doesn't make
         # any sense, so we're running up against limits where we're asking
         # libtiff to do stupid things.
@@ -241,7 +242,7 @@ def test_additional_metadata(self, tmp_path):
 
         TiffImagePlugin.WRITE_LIBTIFF = False
 
-    def test_custom_metadata(self, tmp_path):
+    def test_custom_metadata(self, tmp_path: Path) -> None:
         tc = namedtuple("test_case", "value,type,supported_by_default")
         custom = {
             37000 + k: v
@@ -283,7 +284,7 @@ def test_custom_metadata(self, tmp_path):
         for libtiff in libtiffs:
             TiffImagePlugin.WRITE_LIBTIFF = libtiff
 
-            def check_tags(tiffinfo):
+            def check_tags(tiffinfo) -> None:
                 im = hopper()
 
                 out = str(tmp_path / "temp.tif")
@@ -322,7 +323,7 @@ def check_tags(tiffinfo):
             )
         TiffImagePlugin.WRITE_LIBTIFF = False
 
-    def test_subifd(self, tmp_path):
+    def test_subifd(self, tmp_path: Path) -> None:
         outfile = str(tmp_path / "temp.tif")
         with Image.open("Tests/images/g4_orientation_6.tif") as im:
             im.tag_v2[SUBIFD] = 10000
@@ -330,7 +331,7 @@ def test_subifd(self, tmp_path):
             # Should not segfault
             im.save(outfile)
 
-    def test_xmlpacket_tag(self, tmp_path):
+    def test_xmlpacket_tag(self, tmp_path: Path) -> None:
         TiffImagePlugin.WRITE_LIBTIFF = True
 
         out = str(tmp_path / "temp.tif")
@@ -341,7 +342,7 @@ def test_xmlpacket_tag(self, tmp_path):
             if 700 in reloaded.tag_v2:
                 assert reloaded.tag_v2[700] == b"xmlpacket tag"
 
-    def test_int_dpi(self, tmp_path):
+    def test_int_dpi(self, tmp_path: Path) -> None:
         # issue #1765
         im = hopper("RGB")
         out = str(tmp_path / "temp.tif")
@@ -351,7 +352,7 @@ def test_int_dpi(self, tmp_path):
         with Image.open(out) as reloaded:
             assert reloaded.info["dpi"] == (72.0, 72.0)
 
-    def test_g3_compression(self, tmp_path):
+    def test_g3_compression(self, tmp_path: Path) -> None:
         with Image.open("Tests/images/hopper_g4_500.tif") as i:
             out = str(tmp_path / "temp.tif")
             i.save(out, compression="group3")
@@ -360,7 +361,7 @@ def test_g3_compression(self, tmp_path):
                 assert reread.info["compression"] == "group3"
                 assert_image_equal(reread, i)
 
-    def test_little_endian(self, tmp_path):
+    def test_little_endian(self, tmp_path: Path) -> None:
         with Image.open("Tests/images/16bit.deflate.tif") as im:
             assert im.getpixel((0, 0)) == 480
             assert im.mode == "I;16"
@@ -379,7 +380,7 @@ def test_little_endian(self, tmp_path):
         # UNDONE - libtiff defaults to writing in native endian, so
         # on big endian, we'll get back mode = 'I;16B' here.
 
-    def test_big_endian(self, tmp_path):
+    def test_big_endian(self, tmp_path: Path) -> None:
         with Image.open("Tests/images/16bit.MM.deflate.tif") as im:
             assert im.getpixel((0, 0)) == 480
             assert im.mode == "I;16B"
@@ -396,7 +397,7 @@ def test_big_endian(self, tmp_path):
                 assert reread.info["compression"] == im.info["compression"]
                 assert reread.getpixel((0, 0)) == 480
 
-    def test_g4_string_info(self, tmp_path):
+    def test_g4_string_info(self, tmp_path: Path) -> None:
         """Tests String data in info directory"""
         test_file = "Tests/images/hopper_g4_500.tif"
         with Image.open(test_file) as orig:
@@ -409,7 +410,7 @@ def test_g4_string_info(self, tmp_path):
             assert "temp.tif" == reread.tag_v2[269]
             assert "temp.tif" == reread.tag[269][0]
 
-    def test_12bit_rawmode(self):
+    def test_12bit_rawmode(self) -> None:
         """Are we generating the same interpretation
         of the image as Imagemagick is?"""
         TiffImagePlugin.READ_LIBTIFF = True
@@ -424,7 +425,7 @@ def test_12bit_rawmode(self):
 
             assert_image_equal_tofile(im, "Tests/images/12in16bit.tif")
 
-    def test_blur(self, tmp_path):
+    def test_blur(self, tmp_path: Path) -> None:
         # test case from irc, how to do blur on b/w image
         # and save to compressed tif.
         out = str(tmp_path / "temp.tif")
@@ -436,7 +437,7 @@ def test_blur(self, tmp_path):
 
         assert_image_equal_tofile(im, out)
 
-    def test_compressions(self, tmp_path):
+    def test_compressions(self, tmp_path: Path) -> None:
         # Test various tiff compressions and assert similar image content but reduced
         # file sizes.
         im = hopper("RGB")
@@ -462,7 +463,7 @@ def test_compressions(self, tmp_path):
         assert size_compressed > size_jpeg
         assert size_jpeg > size_jpeg_30
 
-    def test_tiff_jpeg_compression(self, tmp_path):
+    def test_tiff_jpeg_compression(self, tmp_path: Path) -> None:
         im = hopper("RGB")
         out = str(tmp_path / "temp.tif")
         im.save(out, compression="tiff_jpeg")
@@ -470,7 +471,7 @@ def test_tiff_jpeg_compression(self, tmp_path):
         with Image.open(out) as reloaded:
             assert reloaded.info["compression"] == "jpeg"
 
-    def test_tiff_deflate_compression(self, tmp_path):
+    def test_tiff_deflate_compression(self, tmp_path: Path) -> None:
         im = hopper("RGB")
         out = str(tmp_path / "temp.tif")
         im.save(out, compression="tiff_deflate")
@@ -478,7 +479,7 @@ def test_tiff_deflate_compression(self, tmp_path):
         with Image.open(out) as reloaded:
             assert reloaded.info["compression"] == "tiff_adobe_deflate"
 
-    def test_quality(self, tmp_path):
+    def test_quality(self, tmp_path: Path) -> None:
         im = hopper("RGB")
         out = str(tmp_path / "temp.tif")
 
@@ -493,7 +494,7 @@ def test_quality(self, tmp_path):
         im.save(out, compression="jpeg", quality=0)
         im.save(out, compression="jpeg", quality=100)
 
-    def test_cmyk_save(self, tmp_path):
+    def test_cmyk_save(self, tmp_path: Path) -> None:
         im = hopper("CMYK")
         out = str(tmp_path / "temp.tif")
 
@@ -501,7 +502,7 @@ def test_cmyk_save(self, tmp_path):
         assert_image_equal_tofile(im, out)
 
     @pytest.mark.parametrize("im", (hopper("P"), Image.new("P", (1, 1), "#000")))
-    def test_palette_save(self, im, tmp_path):
+    def test_palette_save(self, im, tmp_path: Path) -> None:
         out = str(tmp_path / "temp.tif")
 
         TiffImagePlugin.WRITE_LIBTIFF = True
@@ -513,14 +514,14 @@ def test_palette_save(self, im, tmp_path):
             assert len(reloaded.tag_v2[320]) == 768
 
     @pytest.mark.parametrize("compression", ("tiff_ccitt", "group3", "group4"))
-    def test_bw_compression_w_rgb(self, compression, tmp_path):
+    def test_bw_compression_w_rgb(self, compression, tmp_path: Path) -> None:
         im = hopper("RGB")
         out = str(tmp_path / "temp.tif")
 
         with pytest.raises(OSError):
             im.save(out, compression=compression)
 
-    def test_fp_leak(self):
+    def test_fp_leak(self) -> None:
         im = Image.open("Tests/images/hopper_g4_500.tif")
         fn = im.fp.fileno()
 
@@ -534,7 +535,7 @@ def test_fp_leak(self):
         with pytest.raises(OSError):
             os.close(fn)
 
-    def test_multipage(self):
+    def test_multipage(self) -> None:
         # issue #862
         TiffImagePlugin.READ_LIBTIFF = True
         with Image.open("Tests/images/multipage.tiff") as im:
@@ -557,7 +558,7 @@ def test_multipage(self):
 
         TiffImagePlugin.READ_LIBTIFF = False
 
-    def test_multipage_nframes(self):
+    def test_multipage_nframes(self) -> None:
         # issue #862
         TiffImagePlugin.READ_LIBTIFF = True
         with Image.open("Tests/images/multipage.tiff") as im:
@@ -570,7 +571,7 @@ def test_multipage_nframes(self):
 
         TiffImagePlugin.READ_LIBTIFF = False
 
-    def test_multipage_seek_backwards(self):
+    def test_multipage_seek_backwards(self) -> None:
         TiffImagePlugin.READ_LIBTIFF = True
         with Image.open("Tests/images/multipage.tiff") as im:
             im.seek(1)
@@ -581,14 +582,14 @@ def test_multipage_seek_backwards(self):
 
         TiffImagePlugin.READ_LIBTIFF = False
 
-    def test__next(self):
+    def test__next(self) -> None:
         TiffImagePlugin.READ_LIBTIFF = True
         with Image.open("Tests/images/hopper.tif") as im:
             assert not im.tag.next
             im.load()
             assert not im.tag.next
 
-    def test_4bit(self):
+    def test_4bit(self) -> None:
         # Arrange
         test_file = "Tests/images/hopper_gray_4bpp.tif"
         original = hopper("L")
@@ -603,7 +604,7 @@ def test_4bit(self):
             assert im.mode == "L"
             assert_image_similar(im, original, 7.3)
 
-    def test_gray_semibyte_per_pixel(self):
+    def test_gray_semibyte_per_pixel(self) -> None:
         test_files = (
             (
                 24.8,  # epsilon
@@ -636,7 +637,7 @@ def test_gray_semibyte_per_pixel(self):
                     assert im2.mode == "L"
                     assert_image_equal(im, im2)
 
-    def test_save_bytesio(self):
+    def test_save_bytesio(self) -> None:
         # PR 1011
         # Test TIFF saving to io.BytesIO() object.
 
@@ -646,7 +647,7 @@ def test_save_bytesio(self):
         # Generate test image
         pilim = hopper()
 
-        def save_bytesio(compression=None):
+        def save_bytesio(compression=None) -> None:
             buffer_io = io.BytesIO()
             pilim.save(buffer_io, format="tiff", compression=compression)
             buffer_io.seek(0)
@@ -661,7 +662,7 @@ def save_bytesio(compression=None):
         TiffImagePlugin.WRITE_LIBTIFF = False
         TiffImagePlugin.READ_LIBTIFF = False
 
-    def test_save_ycbcr(self, tmp_path):
+    def test_save_ycbcr(self, tmp_path: Path) -> None:
         im = hopper("YCbCr")
         outfile = str(tmp_path / "temp.tif")
         im.save(outfile, compression="jpeg")
@@ -670,7 +671,7 @@ def test_save_ycbcr(self, tmp_path):
             assert reloaded.tag_v2[530] == (1, 1)
             assert reloaded.tag_v2[532] == (0, 255, 128, 255, 128, 255)
 
-    def test_exif_ifd(self, tmp_path):
+    def test_exif_ifd(self, tmp_path: Path) -> None:
         outfile = str(tmp_path / "temp.tif")
         with Image.open("Tests/images/tiff_adobe_deflate.tif") as im:
             assert im.tag_v2[34665] == 125456
@@ -680,7 +681,7 @@ def test_exif_ifd(self, tmp_path):
             if Image.core.libtiff_support_custom_tags:
                 assert reloaded.tag_v2[34665] == 125456
 
-    def test_crashing_metadata(self, tmp_path):
+    def test_crashing_metadata(self, tmp_path: Path) -> None:
         # issue 1597
         with Image.open("Tests/images/rdf.tif") as im:
             out = str(tmp_path / "temp.tif")
@@ -690,7 +691,7 @@ def test_crashing_metadata(self, tmp_path):
             im.save(out, format="TIFF")
         TiffImagePlugin.WRITE_LIBTIFF = False
 
-    def test_page_number_x_0(self, tmp_path):
+    def test_page_number_x_0(self, tmp_path: Path) -> None:
         # Issue 973
         # Test TIFF with tag 297 (Page Number) having value of 0 0.
         # The first number is the current page number.
@@ -704,7 +705,7 @@ def test_page_number_x_0(self, tmp_path):
             # Should not divide by zero
             im.save(outfile)
 
-    def test_fd_duplication(self, tmp_path):
+    def test_fd_duplication(self, tmp_path: Path) -> None:
         # https://github.com/python-pillow/Pillow/issues/1651
 
         tmpfile = str(tmp_path / "temp.tif")
@@ -718,7 +719,7 @@ def test_fd_duplication(self, tmp_path):
         # Should not raise PermissionError.
         os.remove(tmpfile)
 
-    def test_read_icc(self):
+    def test_read_icc(self) -> None:
         with Image.open("Tests/images/hopper.iccprofile.tif") as img:
             icc = img.info.get("icc_profile")
             assert icc is not None
@@ -729,8 +730,8 @@ def test_read_icc(self):
         TiffImagePlugin.READ_LIBTIFF = False
         assert icc == icc_libtiff
 
-    def test_write_icc(self, tmp_path):
-        def check_write(libtiff):
+    def test_write_icc(self, tmp_path: Path) -> None:
+        def check_write(libtiff) -> None:
             TiffImagePlugin.WRITE_LIBTIFF = libtiff
 
             with Image.open("Tests/images/hopper.iccprofile.tif") as img:
@@ -749,7 +750,7 @@ def check_write(libtiff):
         for libtiff in libtiffs:
             check_write(libtiff)
 
-    def test_multipage_compression(self):
+    def test_multipage_compression(self) -> None:
         with Image.open("Tests/images/compression.tif") as im:
             im.seek(0)
             assert im._compression == "tiff_ccitt"
@@ -765,7 +766,7 @@ def test_multipage_compression(self):
             assert im.size == (10, 10)
             im.load()
 
-    def test_save_tiff_with_jpegtables(self, tmp_path):
+    def test_save_tiff_with_jpegtables(self, tmp_path: Path) -> None:
         # Arrange
         outfile = str(tmp_path / "temp.tif")
 
@@ -777,7 +778,7 @@ def test_save_tiff_with_jpegtables(self, tmp_path):
             # Should not raise UnicodeDecodeError or anything else
             im.save(outfile)
 
-    def test_16bit_RGB_tiff(self):
+    def test_16bit_RGB_tiff(self) -> None:
         with Image.open("Tests/images/tiff_16bit_RGB.tiff") as im:
             assert im.mode == "RGB"
             assert im.size == (100, 40)
@@ -793,7 +794,7 @@ def test_16bit_RGB_tiff(self):
 
             assert_image_equal_tofile(im, "Tests/images/tiff_16bit_RGB_target.png")
 
-    def test_16bit_RGBa_tiff(self):
+    def test_16bit_RGBa_tiff(self) -> None:
         with Image.open("Tests/images/tiff_16bit_RGBa.tiff") as im:
             assert im.mode == "RGBA"
             assert im.size == (100, 40)
@@ -805,7 +806,7 @@ def test_16bit_RGBa_tiff(self):
             assert_image_equal_tofile(im, "Tests/images/tiff_16bit_RGBa_target.png")
 
     @skip_unless_feature("jpg")
-    def test_gimp_tiff(self):
+    def test_gimp_tiff(self) -> None:
         # Read TIFF JPEG images from GIMP [@PIL168]
         filename = "Tests/images/pil168.tif"
         with Image.open(filename) as im:
@@ -818,14 +819,14 @@ def test_gimp_tiff(self):
 
             assert_image_equal_tofile(im, "Tests/images/pil168.png")
 
-    def test_sampleformat(self):
+    def test_sampleformat(self) -> None:
         # https://github.com/python-pillow/Pillow/issues/1466
         with Image.open("Tests/images/copyleft.tiff") as im:
             assert im.mode == "RGB"
 
             assert_image_equal_tofile(im, "Tests/images/copyleft.png", mode="RGB")
 
-    def test_sampleformat_write(self, tmp_path):
+    def test_sampleformat_write(self, tmp_path: Path) -> None:
         im = Image.new("F", (1, 1))
         out = str(tmp_path / "temp.tif")
         TiffImagePlugin.WRITE_LIBTIFF = True
@@ -874,7 +875,7 @@ def test_webp(self, capfd):
             sys.stderr.write(captured.err)
             raise
 
-    def test_lzw(self):
+    def test_lzw(self) -> None:
         with Image.open("Tests/images/hopper_lzw.tif") as im:
             assert im.mode == "RGB"
             assert im.size == (128, 128)
@@ -882,12 +883,12 @@ def test_lzw(self):
             im2 = hopper()
             assert_image_similar(im, im2, 5)
 
-    def test_strip_cmyk_jpeg(self):
+    def test_strip_cmyk_jpeg(self) -> None:
         infile = "Tests/images/tiff_strip_cmyk_jpeg.tif"
         with Image.open(infile) as im:
             assert_image_similar_tofile(im, "Tests/images/pil_sample_cmyk.jpg", 0.5)
 
-    def test_strip_cmyk_16l_jpeg(self):
+    def test_strip_cmyk_16l_jpeg(self) -> None:
         infile = "Tests/images/tiff_strip_cmyk_16l_jpeg.tif"
         with Image.open(infile) as im:
             assert_image_similar_tofile(im, "Tests/images/pil_sample_cmyk.jpg", 0.5)
@@ -895,7 +896,7 @@ def test_strip_cmyk_16l_jpeg(self):
     @mark_if_feature_version(
         pytest.mark.valgrind_known_error, "libjpeg_turbo", "2.0", reason="Known Failing"
     )
-    def test_strip_ycbcr_jpeg_2x2_sampling(self):
+    def test_strip_ycbcr_jpeg_2x2_sampling(self) -> None:
         infile = "Tests/images/tiff_strip_ycbcr_jpeg_2x2_sampling.tif"
         with Image.open(infile) as im:
             assert_image_similar_tofile(im, "Tests/images/flower.jpg", 1.2)
@@ -903,12 +904,12 @@ def test_strip_ycbcr_jpeg_2x2_sampling(self):
     @mark_if_feature_version(
         pytest.mark.valgrind_known_error, "libjpeg_turbo", "2.0", reason="Known Failing"
     )
-    def test_strip_ycbcr_jpeg_1x1_sampling(self):
+    def test_strip_ycbcr_jpeg_1x1_sampling(self) -> None:
         infile = "Tests/images/tiff_strip_ycbcr_jpeg_1x1_sampling.tif"
         with Image.open(infile) as im:
             assert_image_similar_tofile(im, "Tests/images/flower2.jpg", 0.01)
 
-    def test_tiled_cmyk_jpeg(self):
+    def test_tiled_cmyk_jpeg(self) -> None:
         infile = "Tests/images/tiff_tiled_cmyk_jpeg.tif"
         with Image.open(infile) as im:
             assert_image_similar_tofile(im, "Tests/images/pil_sample_cmyk.jpg", 0.5)
@@ -916,7 +917,7 @@ def test_tiled_cmyk_jpeg(self):
     @mark_if_feature_version(
         pytest.mark.valgrind_known_error, "libjpeg_turbo", "2.0", reason="Known Failing"
     )
-    def test_tiled_ycbcr_jpeg_1x1_sampling(self):
+    def test_tiled_ycbcr_jpeg_1x1_sampling(self) -> None:
         infile = "Tests/images/tiff_tiled_ycbcr_jpeg_1x1_sampling.tif"
         with Image.open(infile) as im:
             assert_image_similar_tofile(im, "Tests/images/flower2.jpg", 0.01)
@@ -924,45 +925,45 @@ def test_tiled_ycbcr_jpeg_1x1_sampling(self):
     @mark_if_feature_version(
         pytest.mark.valgrind_known_error, "libjpeg_turbo", "2.0", reason="Known Failing"
     )
-    def test_tiled_ycbcr_jpeg_2x2_sampling(self):
+    def test_tiled_ycbcr_jpeg_2x2_sampling(self) -> None:
         infile = "Tests/images/tiff_tiled_ycbcr_jpeg_2x2_sampling.tif"
         with Image.open(infile) as im:
             assert_image_similar_tofile(im, "Tests/images/flower.jpg", 1.5)
 
-    def test_strip_planar_rgb(self):
+    def test_strip_planar_rgb(self) -> None:
         # gdal_translate -co TILED=no -co INTERLEAVE=BAND -co COMPRESS=LZW \
         # tiff_strip_raw.tif tiff_strip_planar_lzw.tiff
         infile = "Tests/images/tiff_strip_planar_lzw.tiff"
         with Image.open(infile) as im:
             assert_image_equal_tofile(im, "Tests/images/tiff_adobe_deflate.png")
 
-    def test_tiled_planar_rgb(self):
+    def test_tiled_planar_rgb(self) -> None:
         # gdal_translate -co TILED=yes -co INTERLEAVE=BAND -co COMPRESS=LZW \
         # tiff_tiled_raw.tif tiff_tiled_planar_lzw.tiff
         infile = "Tests/images/tiff_tiled_planar_lzw.tiff"
         with Image.open(infile) as im:
             assert_image_equal_tofile(im, "Tests/images/tiff_adobe_deflate.png")
 
-    def test_tiled_planar_16bit_RGB(self):
+    def test_tiled_planar_16bit_RGB(self) -> None:
         # gdal_translate -co TILED=yes -co INTERLEAVE=BAND -co COMPRESS=LZW \
         # tiff_16bit_RGB.tiff tiff_tiled_planar_16bit_RGB.tiff
         with Image.open("Tests/images/tiff_tiled_planar_16bit_RGB.tiff") as im:
             assert_image_equal_tofile(im, "Tests/images/tiff_16bit_RGB_target.png")
 
-    def test_strip_planar_16bit_RGB(self):
+    def test_strip_planar_16bit_RGB(self) -> None:
         # gdal_translate -co TILED=no -co INTERLEAVE=BAND -co COMPRESS=LZW \
         # tiff_16bit_RGB.tiff tiff_strip_planar_16bit_RGB.tiff
         with Image.open("Tests/images/tiff_strip_planar_16bit_RGB.tiff") as im:
             assert_image_equal_tofile(im, "Tests/images/tiff_16bit_RGB_target.png")
 
-    def test_tiled_planar_16bit_RGBa(self):
+    def test_tiled_planar_16bit_RGBa(self) -> None:
         # gdal_translate -co TILED=yes \
         # -co INTERLEAVE=BAND -co COMPRESS=LZW -co ALPHA=PREMULTIPLIED \
         # tiff_16bit_RGBa.tiff tiff_tiled_planar_16bit_RGBa.tiff
         with Image.open("Tests/images/tiff_tiled_planar_16bit_RGBa.tiff") as im:
             assert_image_equal_tofile(im, "Tests/images/tiff_16bit_RGBa_target.png")
 
-    def test_strip_planar_16bit_RGBa(self):
+    def test_strip_planar_16bit_RGBa(self) -> None:
         # gdal_translate -co TILED=no \
         # -co INTERLEAVE=BAND -co COMPRESS=LZW -co ALPHA=PREMULTIPLIED \
         # tiff_16bit_RGBa.tiff tiff_strip_planar_16bit_RGBa.tiff
@@ -970,7 +971,7 @@ def test_strip_planar_16bit_RGBa(self):
             assert_image_equal_tofile(im, "Tests/images/tiff_16bit_RGBa_target.png")
 
     @pytest.mark.parametrize("compression", (None, "jpeg"))
-    def test_block_tile_tags(self, compression, tmp_path):
+    def test_block_tile_tags(self, compression, tmp_path: Path) -> None:
         im = hopper()
         out = str(tmp_path / "temp.tif")
 
@@ -986,11 +987,11 @@ def test_block_tile_tags(self, compression, tmp_path):
             for tag in tags:
                 assert tag not in reloaded.getexif()
 
-    def test_old_style_jpeg(self):
+    def test_old_style_jpeg(self) -> None:
         with Image.open("Tests/images/old-style-jpeg-compression.tif") as im:
             assert_image_equal_tofile(im, "Tests/images/old-style-jpeg-compression.png")
 
-    def test_open_missing_samplesperpixel(self):
+    def test_open_missing_samplesperpixel(self) -> None:
         with Image.open(
             "Tests/images/old-style-jpeg-compression-no-samplesperpixel.tif"
         ) as im:
@@ -1019,21 +1020,21 @@ def test_open_missing_samplesperpixel(self):
             ),
         ],
     )
-    def test_wrong_bits_per_sample(self, file_name, mode, size, tile):
+    def test_wrong_bits_per_sample(self, file_name, mode, size, tile) -> None:
         with Image.open("Tests/images/" + file_name) as im:
             assert im.mode == mode
             assert im.size == size
             assert im.tile == tile
             im.load()
 
-    def test_no_rows_per_strip(self):
+    def test_no_rows_per_strip(self) -> None:
         # This image does not have a RowsPerStrip TIFF tag
         infile = "Tests/images/no_rows_per_strip.tif"
         with Image.open(infile) as im:
             im.load()
         assert im.size == (950, 975)
 
-    def test_orientation(self):
+    def test_orientation(self) -> None:
         with Image.open("Tests/images/g4_orientation_1.tif") as base_im:
             for i in range(2, 9):
                 with Image.open("Tests/images/g4_orientation_" + str(i) + ".tif") as im:
@@ -1044,7 +1045,7 @@ def test_orientation(self):
 
                     assert_image_similar(base_im, im, 0.7)
 
-    def test_exif_transpose(self):
+    def test_exif_transpose(self) -> None:
         with Image.open("Tests/images/g4_orientation_1.tif") as base_im:
             for i in range(2, 9):
                 with Image.open("Tests/images/g4_orientation_" + str(i) + ".tif") as im:
@@ -1053,7 +1054,7 @@ def test_exif_transpose(self):
                     assert_image_similar(base_im, im, 0.7)
 
     @pytest.mark.valgrind_known_error(reason="Backtrace in Python Core")
-    def test_sampleformat_not_corrupted(self):
+    def test_sampleformat_not_corrupted(self) -> None:
         # Assert that a TIFF image with SampleFormat=UINT tag is not corrupted
         # when saving to a new file.
         # Pillow 6.0 fails with "OSError: cannot identify image file".
@@ -1074,7 +1075,7 @@ def test_sampleformat_not_corrupted(self):
         with Image.open(out) as im:
             im.load()
 
-    def test_realloc_overflow(self):
+    def test_realloc_overflow(self) -> None:
         TiffImagePlugin.READ_LIBTIFF = True
         with Image.open("Tests/images/tiff_overflow_rows_per_strip.tif") as im:
             with pytest.raises(OSError) as e:
@@ -1085,7 +1086,7 @@ def test_realloc_overflow(self):
         TiffImagePlugin.READ_LIBTIFF = False
 
     @pytest.mark.parametrize("compression", ("tiff_adobe_deflate", "jpeg"))
-    def test_save_multistrip(self, compression, tmp_path):
+    def test_save_multistrip(self, compression, tmp_path: Path) -> None:
         im = hopper("RGB").resize((256, 256))
         out = str(tmp_path / "temp.tif")
         im.save(out, compression=compression)
@@ -1095,7 +1096,7 @@ def test_save_multistrip(self, compression, tmp_path):
             assert len(im.tag_v2[STRIPOFFSETS]) > 1
 
     @pytest.mark.parametrize("argument", (True, False))
-    def test_save_single_strip(self, argument, tmp_path):
+    def test_save_single_strip(self, argument, tmp_path: Path) -> None:
         im = hopper("RGB").resize((256, 256))
         out = str(tmp_path / "temp.tif")
 
@@ -1113,13 +1114,13 @@ def test_save_single_strip(self, argument, tmp_path):
             TiffImagePlugin.STRIP_SIZE = 65536
 
     @pytest.mark.parametrize("compression", ("tiff_adobe_deflate", None))
-    def test_save_zero(self, compression, tmp_path):
+    def test_save_zero(self, compression, tmp_path: Path) -> None:
         im = Image.new("RGB", (0, 0))
         out = str(tmp_path / "temp.tif")
         with pytest.raises(SystemError):
             im.save(out, compression=compression)
 
-    def test_save_many_compressed(self, tmp_path):
+    def test_save_many_compressed(self, tmp_path: Path) -> None:
         im = hopper()
         out = str(tmp_path / "temp.tif")
         for _ in range(10000):
@@ -1133,7 +1134,7 @@ def test_save_many_compressed(self, tmp_path):
             ("Tests/images/child_ifd_jpeg.tiff", (20,)),
         ),
     )
-    def test_get_child_images(self, path, sizes):
+    def test_get_child_images(self, path, sizes) -> None:
         with Image.open(path) as im:
             ims = im.get_child_images()
 
diff --git a/Tests/test_file_libtiff_small.py b/Tests/test_file_libtiff_small.py
index 171e4a3f866..ac5270eac30 100644
--- a/Tests/test_file_libtiff_small.py
+++ b/Tests/test_file_libtiff_small.py
@@ -1,6 +1,7 @@
 from __future__ import annotations
 
 from io import BytesIO
+from pathlib import Path
 
 from PIL import Image
 
@@ -17,7 +18,7 @@ class TestFileLibTiffSmall(LibTiffTestCase):
     file just before reading in libtiff. These tests remain
     to ensure that it stays fixed."""
 
-    def test_g4_hopper_file(self, tmp_path):
+    def test_g4_hopper_file(self, tmp_path: Path) -> None:
         """Testing the open file load path"""
 
         test_file = "Tests/images/hopper_g4.tif"
@@ -26,7 +27,7 @@ def test_g4_hopper_file(self, tmp_path):
                 assert im.size == (128, 128)
                 self._assert_noerr(tmp_path, im)
 
-    def test_g4_hopper_bytesio(self, tmp_path):
+    def test_g4_hopper_bytesio(self, tmp_path: Path) -> None:
         """Testing the bytesio loading code path"""
         test_file = "Tests/images/hopper_g4.tif"
         s = BytesIO()
@@ -37,7 +38,7 @@ def test_g4_hopper_bytesio(self, tmp_path):
             assert im.size == (128, 128)
             self._assert_noerr(tmp_path, im)
 
-    def test_g4_hopper(self, tmp_path):
+    def test_g4_hopper(self, tmp_path: Path) -> None:
         """The 128x128 lena image failed for some reason."""
 
         test_file = "Tests/images/hopper_g4.tif"
diff --git a/Tests/test_file_mic.py b/Tests/test_file_mic.py
index 8c43f7d7ab7..9a6f13ea366 100644
--- a/Tests/test_file_mic.py
+++ b/Tests/test_file_mic.py
@@ -13,7 +13,7 @@
 TEST_FILE = "Tests/images/hopper.mic"
 
 
-def test_sanity():
+def test_sanity() -> None:
     with Image.open(TEST_FILE) as im:
         im.load()
         assert im.mode == "RGBA"
@@ -28,22 +28,22 @@ def test_sanity():
         assert_image_similar(im, im2, 10)
 
 
-def test_n_frames():
+def test_n_frames() -> None:
     with Image.open(TEST_FILE) as im:
         assert im.n_frames == 1
 
 
-def test_is_animated():
+def test_is_animated() -> None:
     with Image.open(TEST_FILE) as im:
         assert not im.is_animated
 
 
-def test_tell():
+def test_tell() -> None:
     with Image.open(TEST_FILE) as im:
         assert im.tell() == 0
 
 
-def test_seek():
+def test_seek() -> None:
     with Image.open(TEST_FILE) as im:
         im.seek(0)
         assert im.tell() == 0
@@ -53,7 +53,7 @@ def test_seek():
         assert im.tell() == 0
 
 
-def test_close():
+def test_close() -> None:
     with Image.open(TEST_FILE) as im:
         pass
     assert im.ole.fp.closed
@@ -63,7 +63,7 @@ def test_close():
     assert im.ole.fp.closed
 
 
-def test_invalid_file():
+def test_invalid_file() -> None:
     # Test an invalid OLE file
     invalid_file = "Tests/images/flower.jpg"
     with pytest.raises(SyntaxError):
diff --git a/Tests/test_file_mpo.py b/Tests/test_file_mpo.py
index c7121ea28c9..55b04a1e076 100644
--- a/Tests/test_file_mpo.py
+++ b/Tests/test_file_mpo.py
@@ -30,7 +30,7 @@ def roundtrip(im, **options):
 
 
 @pytest.mark.parametrize("test_file", test_files)
-def test_sanity(test_file):
+def test_sanity(test_file) -> None:
     with Image.open(test_file) as im:
         im.load()
         assert im.mode == "RGB"
@@ -39,8 +39,8 @@ def test_sanity(test_file):
 
 
 @pytest.mark.skipif(is_pypy(), reason="Requires CPython")
-def test_unclosed_file():
-    def open():
+def test_unclosed_file() -> None:
+    def open() -> None:
         im = Image.open(test_files[0])
         im.load()
 
@@ -48,14 +48,14 @@ def open():
         open()
 
 
-def test_closed_file():
+def test_closed_file() -> None:
     with warnings.catch_warnings():
         im = Image.open(test_files[0])
         im.load()
         im.close()
 
 
-def test_seek_after_close():
+def test_seek_after_close() -> None:
     im = Image.open(test_files[0])
     im.close()
 
@@ -63,14 +63,14 @@ def test_seek_after_close():
         im.seek(1)
 
 
-def test_context_manager():
+def test_context_manager() -> None:
     with warnings.catch_warnings():
         with Image.open(test_files[0]) as im:
             im.load()
 
 
 @pytest.mark.parametrize("test_file", test_files)
-def test_app(test_file):
+def test_app(test_file) -> None:
     # Test APP/COM reader (@PIL135)
     with Image.open(test_file) as im:
         assert im.applist[0][0] == "APP1"
@@ -82,7 +82,7 @@ def test_app(test_file):
 
 
 @pytest.mark.parametrize("test_file", test_files)
-def test_exif(test_file):
+def test_exif(test_file) -> None:
     with Image.open(test_file) as im_original:
         im_reloaded = roundtrip(im_original, save_all=True, exif=im_original.getexif())
 
@@ -93,7 +93,7 @@ def test_exif(test_file):
         assert info[34665] == 188
 
 
-def test_frame_size():
+def test_frame_size() -> None:
     # This image has been hexedited to contain a different size
     # in the EXIF data of the second frame
     with Image.open("Tests/images/sugarshack_frame_size.mpo") as im:
@@ -106,7 +106,7 @@ def test_frame_size():
         assert im.size == (640, 480)
 
 
-def test_ignore_frame_size():
+def test_ignore_frame_size() -> None:
     # Ignore the different size of the second frame
     # since this is not a "Large Thumbnail" image
     with Image.open("Tests/images/ignore_frame_size.mpo") as im:
@@ -120,7 +120,7 @@ def test_ignore_frame_size():
         assert im.size == (64, 64)
 
 
-def test_parallax():
+def test_parallax() -> None:
     # Nintendo
     with Image.open("Tests/images/sugarshack.mpo") as im:
         exif = im.getexif()
@@ -133,7 +133,7 @@ def test_parallax():
         assert exif.get_ifd(0x927C)[0xB211] == -3.125
 
 
-def test_reload_exif_after_seek():
+def test_reload_exif_after_seek() -> None:
     with Image.open("Tests/images/sugarshack.mpo") as im:
         exif = im.getexif()
         del exif[296]
@@ -143,14 +143,14 @@ def test_reload_exif_after_seek():
 
 
 @pytest.mark.parametrize("test_file", test_files)
-def test_mp(test_file):
+def test_mp(test_file) -> None:
     with Image.open(test_file) as im:
         mpinfo = im._getmp()
         assert mpinfo[45056] == b"0100"
         assert mpinfo[45057] == 2
 
 
-def test_mp_offset():
+def test_mp_offset() -> None:
     # This image has been manually hexedited to have an IFD offset of 10
     # in APP2 data, in contrast to normal 8
     with Image.open("Tests/images/sugarshack_ifd_offset.mpo") as im:
@@ -159,7 +159,7 @@ def test_mp_offset():
         assert mpinfo[45057] == 2
 
 
-def test_mp_no_data():
+def test_mp_no_data() -> None:
     # This image has been manually hexedited to have the second frame
     # beyond the end of the file
     with Image.open("Tests/images/sugarshack_no_data.mpo") as im:
@@ -168,7 +168,7 @@ def test_mp_no_data():
 
 
 @pytest.mark.parametrize("test_file", test_files)
-def test_mp_attribute(test_file):
+def test_mp_attribute(test_file) -> None:
     with Image.open(test_file) as im:
         mpinfo = im._getmp()
     for frame_number, mpentry in enumerate(mpinfo[0xB002]):
@@ -185,7 +185,7 @@ def test_mp_attribute(test_file):
 
 
 @pytest.mark.parametrize("test_file", test_files)
-def test_seek(test_file):
+def test_seek(test_file) -> None:
     with Image.open(test_file) as im:
         assert im.tell() == 0
         # prior to first image raises an error, both blatant and borderline
@@ -209,13 +209,13 @@ def test_seek(test_file):
         assert im.tell() == 0
 
 
-def test_n_frames():
+def test_n_frames() -> None:
     with Image.open("Tests/images/sugarshack.mpo") as im:
         assert im.n_frames == 2
         assert im.is_animated
 
 
-def test_eoferror():
+def test_eoferror() -> None:
     with Image.open("Tests/images/sugarshack.mpo") as im:
         n_frames = im.n_frames
 
@@ -229,7 +229,7 @@ def test_eoferror():
 
 
 @pytest.mark.parametrize("test_file", test_files)
-def test_image_grab(test_file):
+def test_image_grab(test_file) -> None:
     with Image.open(test_file) as im:
         assert im.tell() == 0
         im0 = im.tobytes()
@@ -244,7 +244,7 @@ def test_image_grab(test_file):
 
 
 @pytest.mark.parametrize("test_file", test_files)
-def test_save(test_file):
+def test_save(test_file) -> None:
     with Image.open(test_file) as im:
         assert im.tell() == 0
         jpg0 = roundtrip(im)
@@ -255,7 +255,7 @@ def test_save(test_file):
         assert_image_similar(im, jpg1, 30)
 
 
-def test_save_all():
+def test_save_all() -> None:
     for test_file in test_files:
         with Image.open(test_file) as im:
             im_reloaded = roundtrip(im, save_all=True)
diff --git a/Tests/test_file_msp.py b/Tests/test_file_msp.py
index 9037ea33b54..f9f81d11413 100644
--- a/Tests/test_file_msp.py
+++ b/Tests/test_file_msp.py
@@ -1,6 +1,7 @@
 from __future__ import annotations
 
 import os
+from pathlib import Path
 
 import pytest
 
@@ -13,7 +14,7 @@
 YA_EXTRA_DIR = "Tests/images/msp"
 
 
-def test_sanity(tmp_path):
+def test_sanity(tmp_path: Path) -> None:
     test_file = str(tmp_path / "temp.msp")
 
     hopper("1").save(test_file)
@@ -25,14 +26,14 @@ def test_sanity(tmp_path):
         assert im.format == "MSP"
 
 
-def test_invalid_file():
+def test_invalid_file() -> None:
     invalid_file = "Tests/images/flower.jpg"
 
     with pytest.raises(SyntaxError):
         MspImagePlugin.MspImageFile(invalid_file)
 
 
-def test_bad_checksum():
+def test_bad_checksum() -> None:
     # Arrange
     # This was created by forcing Pillow to save with checksum=0
     bad_checksum = "Tests/images/hopper_bad_checksum.msp"
@@ -42,7 +43,7 @@ def test_bad_checksum():
         MspImagePlugin.MspImageFile(bad_checksum)
 
 
-def test_open_windows_v1():
+def test_open_windows_v1() -> None:
     # Arrange
     # Act
     with Image.open(TEST_FILE) as im:
@@ -51,7 +52,7 @@ def test_open_windows_v1():
         assert isinstance(im, MspImagePlugin.MspImageFile)
 
 
-def _assert_file_image_equal(source_path, target_path):
+def _assert_file_image_equal(source_path, target_path) -> None:
     with Image.open(source_path) as im:
         assert_image_equal_tofile(im, target_path)
 
@@ -59,7 +60,7 @@ def _assert_file_image_equal(source_path, target_path):
 @pytest.mark.skipif(
     not os.path.exists(EXTRA_DIR), reason="Extra image files not installed"
 )
-def test_open_windows_v2():
+def test_open_windows_v2() -> None:
     files = (
         os.path.join(EXTRA_DIR, f)
         for f in os.listdir(EXTRA_DIR)
@@ -72,7 +73,7 @@ def test_open_windows_v2():
 @pytest.mark.skipif(
     not os.path.exists(YA_EXTRA_DIR), reason="Even More Extra image files not installed"
 )
-def test_msp_v2():
+def test_msp_v2() -> None:
     for f in os.listdir(YA_EXTRA_DIR):
         if ".MSP" not in f:
             continue
@@ -80,7 +81,7 @@ def test_msp_v2():
         _assert_file_image_equal(path, path.replace(".MSP", ".png"))
 
 
-def test_cannot_save_wrong_mode(tmp_path):
+def test_cannot_save_wrong_mode(tmp_path: Path) -> None:
     # Arrange
     im = hopper()
     filename = str(tmp_path / "temp.msp")
diff --git a/Tests/test_file_palm.py b/Tests/test_file_palm.py
index eba69415395..55041a4b202 100644
--- a/Tests/test_file_palm.py
+++ b/Tests/test_file_palm.py
@@ -2,6 +2,7 @@
 
 import os.path
 import subprocess
+from pathlib import Path
 
 import pytest
 
@@ -10,7 +11,7 @@
 from .helper import assert_image_equal, hopper, magick_command
 
 
-def helper_save_as_palm(tmp_path, mode):
+def helper_save_as_palm(tmp_path: Path, mode) -> None:
     # Arrange
     im = hopper(mode)
     outfile = str(tmp_path / ("temp_" + mode + ".palm"))
@@ -23,7 +24,7 @@ def helper_save_as_palm(tmp_path, mode):
     assert os.path.getsize(outfile) > 0
 
 
-def open_with_magick(magick, tmp_path, f):
+def open_with_magick(magick, tmp_path: Path, f):
     outfile = str(tmp_path / "temp.png")
     rc = subprocess.call(
         magick + [f, outfile], stdout=subprocess.DEVNULL, stderr=subprocess.STDOUT
@@ -32,7 +33,7 @@ def open_with_magick(magick, tmp_path, f):
     return Image.open(outfile)
 
 
-def roundtrip(tmp_path, mode):
+def roundtrip(tmp_path: Path, mode) -> None:
     magick = magick_command()
     if not magick:
         return
@@ -45,7 +46,7 @@ def roundtrip(tmp_path, mode):
     assert_image_equal(converted, im)
 
 
-def test_monochrome(tmp_path):
+def test_monochrome(tmp_path: Path) -> None:
     # Arrange
     mode = "1"
 
@@ -55,7 +56,7 @@ def test_monochrome(tmp_path):
 
 
 @pytest.mark.xfail(reason="Palm P image is wrong")
-def test_p_mode(tmp_path):
+def test_p_mode(tmp_path: Path) -> None:
     # Arrange
     mode = "P"
 
@@ -65,6 +66,6 @@ def test_p_mode(tmp_path):
 
 
 @pytest.mark.parametrize("mode", ("L", "RGB"))
-def test_oserror(tmp_path, mode):
+def test_oserror(tmp_path: Path, mode) -> None:
     with pytest.raises(OSError):
         helper_save_as_palm(tmp_path, mode)
diff --git a/Tests/test_file_pcx.py b/Tests/test_file_pcx.py
index 2565e0b6ddc..a2486be40c5 100644
--- a/Tests/test_file_pcx.py
+++ b/Tests/test_file_pcx.py
@@ -1,5 +1,7 @@
 from __future__ import annotations
 
+from pathlib import Path
+
 import pytest
 
 from PIL import Image, ImageFile, PcxImagePlugin
@@ -7,7 +9,7 @@
 from .helper import assert_image_equal, hopper
 
 
-def _roundtrip(tmp_path, im):
+def _roundtrip(tmp_path: Path, im) -> None:
     f = str(tmp_path / "temp.pcx")
     im.save(f)
     with Image.open(f) as im2:
@@ -18,7 +20,7 @@ def _roundtrip(tmp_path, im):
         assert_image_equal(im2, im)
 
 
-def test_sanity(tmp_path):
+def test_sanity(tmp_path: Path) -> None:
     for mode in ("1", "L", "P", "RGB"):
         _roundtrip(tmp_path, hopper(mode))
 
@@ -34,7 +36,7 @@ def test_sanity(tmp_path):
         im.save(f)
 
 
-def test_invalid_file():
+def test_invalid_file() -> None:
     invalid_file = "Tests/images/flower.jpg"
 
     with pytest.raises(SyntaxError):
@@ -42,7 +44,7 @@ def test_invalid_file():
 
 
 @pytest.mark.parametrize("mode", ("1", "L", "P", "RGB"))
-def test_odd(tmp_path, mode):
+def test_odd(tmp_path: Path, mode) -> None:
     # See issue #523, odd sized images should have a stride that's even.
     # Not that ImageMagick or GIMP write PCX that way.
     # We were not handling properly.
@@ -51,7 +53,7 @@ def test_odd(tmp_path, mode):
     _roundtrip(tmp_path, hopper(mode).resize((511, 511)))
 
 
-def test_odd_read():
+def test_odd_read() -> None:
     # Reading an image with an odd stride, making it malformed
     with Image.open("Tests/images/odd_stride.pcx") as im:
         im.load()
@@ -59,7 +61,7 @@ def test_odd_read():
         assert im.size == (371, 150)
 
 
-def test_pil184():
+def test_pil184() -> None:
     # Check reading of files where xmin/xmax is not zero.
 
     test_file = "Tests/images/pil184.pcx"
@@ -71,7 +73,7 @@ def test_pil184():
         assert im.histogram()[0] + im.histogram()[255] == 447 * 144
 
 
-def test_1px_width(tmp_path):
+def test_1px_width(tmp_path: Path) -> None:
     im = Image.new("L", (1, 256))
     px = im.load()
     for y in range(256):
@@ -79,7 +81,7 @@ def test_1px_width(tmp_path):
     _roundtrip(tmp_path, im)
 
 
-def test_large_count(tmp_path):
+def test_large_count(tmp_path: Path) -> None:
     im = Image.new("L", (256, 1))
     px = im.load()
     for x in range(256):
@@ -87,7 +89,7 @@ def test_large_count(tmp_path):
     _roundtrip(tmp_path, im)
 
 
-def _test_buffer_overflow(tmp_path, im, size=1024):
+def _test_buffer_overflow(tmp_path: Path, im, size: int = 1024) -> None:
     _last = ImageFile.MAXBLOCK
     ImageFile.MAXBLOCK = size
     try:
@@ -96,7 +98,7 @@ def _test_buffer_overflow(tmp_path, im, size=1024):
         ImageFile.MAXBLOCK = _last
 
 
-def test_break_in_count_overflow(tmp_path):
+def test_break_in_count_overflow(tmp_path: Path) -> None:
     im = Image.new("L", (256, 5))
     px = im.load()
     for y in range(4):
@@ -105,7 +107,7 @@ def test_break_in_count_overflow(tmp_path):
     _test_buffer_overflow(tmp_path, im)
 
 
-def test_break_one_in_loop(tmp_path):
+def test_break_one_in_loop(tmp_path: Path) -> None:
     im = Image.new("L", (256, 5))
     px = im.load()
     for y in range(5):
@@ -114,7 +116,7 @@ def test_break_one_in_loop(tmp_path):
     _test_buffer_overflow(tmp_path, im)
 
 
-def test_break_many_in_loop(tmp_path):
+def test_break_many_in_loop(tmp_path: Path) -> None:
     im = Image.new("L", (256, 5))
     px = im.load()
     for y in range(4):
@@ -125,7 +127,7 @@ def test_break_many_in_loop(tmp_path):
     _test_buffer_overflow(tmp_path, im)
 
 
-def test_break_one_at_end(tmp_path):
+def test_break_one_at_end(tmp_path: Path) -> None:
     im = Image.new("L", (256, 5))
     px = im.load()
     for y in range(5):
@@ -135,7 +137,7 @@ def test_break_one_at_end(tmp_path):
     _test_buffer_overflow(tmp_path, im)
 
 
-def test_break_many_at_end(tmp_path):
+def test_break_many_at_end(tmp_path: Path) -> None:
     im = Image.new("L", (256, 5))
     px = im.load()
     for y in range(5):
@@ -147,7 +149,7 @@ def test_break_many_at_end(tmp_path):
     _test_buffer_overflow(tmp_path, im)
 
 
-def test_break_padding(tmp_path):
+def test_break_padding(tmp_path: Path) -> None:
     im = Image.new("L", (257, 5))
     px = im.load()
     for y in range(5):
diff --git a/Tests/test_file_pdf.py b/Tests/test_file_pdf.py
index 30c54c963cb..65a93c138e9 100644
--- a/Tests/test_file_pdf.py
+++ b/Tests/test_file_pdf.py
@@ -5,6 +5,7 @@
 import os.path
 import tempfile
 import time
+from pathlib import Path
 
 import pytest
 
@@ -13,7 +14,7 @@
 from .helper import hopper, mark_if_feature_version, skip_unless_feature
 
 
-def helper_save_as_pdf(tmp_path, mode, **kwargs):
+def helper_save_as_pdf(tmp_path: Path, mode, **kwargs):
     # Arrange
     im = hopper(mode)
     outfile = str(tmp_path / ("temp_" + mode + ".pdf"))
@@ -40,17 +41,17 @@ def helper_save_as_pdf(tmp_path, mode, **kwargs):
 
 
 @pytest.mark.parametrize("mode", ("L", "P", "RGB", "CMYK"))
-def test_save(tmp_path, mode):
+def test_save(tmp_path: Path, mode) -> None:
     helper_save_as_pdf(tmp_path, mode)
 
 
 @skip_unless_feature("jpg_2000")
 @pytest.mark.parametrize("mode", ("LA", "RGBA"))
-def test_save_alpha(tmp_path, mode):
+def test_save_alpha(tmp_path: Path, mode) -> None:
     helper_save_as_pdf(tmp_path, mode)
 
 
-def test_p_alpha(tmp_path):
+def test_p_alpha(tmp_path: Path) -> None:
     # Arrange
     outfile = str(tmp_path / "temp.pdf")
     with Image.open("Tests/images/pil123p.png") as im:
@@ -66,7 +67,7 @@ def test_p_alpha(tmp_path):
     assert b"\n/SMask " in contents
 
 
-def test_monochrome(tmp_path):
+def test_monochrome(tmp_path: Path) -> None:
     # Arrange
     mode = "1"
 
@@ -75,7 +76,7 @@ def test_monochrome(tmp_path):
     assert os.path.getsize(outfile) < (5000 if features.check("libtiff") else 15000)
 
 
-def test_unsupported_mode(tmp_path):
+def test_unsupported_mode(tmp_path: Path) -> None:
     im = hopper("PA")
     outfile = str(tmp_path / "temp_PA.pdf")
 
@@ -83,7 +84,7 @@ def test_unsupported_mode(tmp_path):
         im.save(outfile)
 
 
-def test_resolution(tmp_path):
+def test_resolution(tmp_path: Path) -> None:
     im = hopper()
 
     outfile = str(tmp_path / "temp.pdf")
@@ -111,7 +112,7 @@ def test_resolution(tmp_path):
         {"dpi": (75, 150), "resolution": 200},
     ),
 )
-def test_dpi(params, tmp_path):
+def test_dpi(params, tmp_path: Path) -> None:
     im = hopper()
 
     outfile = str(tmp_path / "temp.pdf")
@@ -135,7 +136,7 @@ def test_dpi(params, tmp_path):
 @mark_if_feature_version(
     pytest.mark.valgrind_known_error, "libjpeg_turbo", "2.0", reason="Known Failing"
 )
-def test_save_all(tmp_path):
+def test_save_all(tmp_path: Path) -> None:
     # Single frame image
     helper_save_as_pdf(tmp_path, "RGB", save_all=True)
 
@@ -171,7 +172,7 @@ def im_generator(ims):
     assert os.path.getsize(outfile) > 0
 
 
-def test_multiframe_normal_save(tmp_path):
+def test_multiframe_normal_save(tmp_path: Path) -> None:
     # Test saving a multiframe image without save_all
     with Image.open("Tests/images/dispose_bgnd.gif") as im:
         outfile = str(tmp_path / "temp.pdf")
@@ -181,7 +182,7 @@ def test_multiframe_normal_save(tmp_path):
     assert os.path.getsize(outfile) > 0
 
 
-def test_pdf_open(tmp_path):
+def test_pdf_open(tmp_path: Path) -> None:
     # fail on a buffer full of null bytes
     with pytest.raises(PdfParser.PdfFormatError):
         PdfParser.PdfParser(buf=bytearray(65536))
@@ -218,14 +219,14 @@ def test_pdf_open(tmp_path):
             assert not hopper_pdf.should_close_file
 
 
-def test_pdf_append_fails_on_nonexistent_file():
+def test_pdf_append_fails_on_nonexistent_file() -> None:
     im = hopper("RGB")
     with tempfile.TemporaryDirectory() as temp_dir:
         with pytest.raises(OSError):
             im.save(os.path.join(temp_dir, "nonexistent.pdf"), append=True)
 
 
-def check_pdf_pages_consistency(pdf):
+def check_pdf_pages_consistency(pdf) -> None:
     pages_info = pdf.read_indirect(pdf.pages_ref)
     assert b"Parent" not in pages_info
     assert b"Kids" in pages_info
@@ -243,7 +244,7 @@ def check_pdf_pages_consistency(pdf):
     assert kids_not_used == []
 
 
-def test_pdf_append(tmp_path):
+def test_pdf_append(tmp_path: Path) -> None:
     # make a PDF file
     pdf_filename = helper_save_as_pdf(tmp_path, "RGB", producer="PdfParser")
 
@@ -294,7 +295,7 @@ def test_pdf_append(tmp_path):
         check_pdf_pages_consistency(pdf)
 
 
-def test_pdf_info(tmp_path):
+def test_pdf_info(tmp_path: Path) -> None:
     # make a PDF file
     pdf_filename = helper_save_as_pdf(
         tmp_path,
@@ -323,7 +324,7 @@ def test_pdf_info(tmp_path):
         check_pdf_pages_consistency(pdf)
 
 
-def test_pdf_append_to_bytesio():
+def test_pdf_append_to_bytesio() -> None:
     im = hopper("RGB")
     f = io.BytesIO()
     im.save(f, format="PDF")
@@ -338,7 +339,7 @@ def test_pdf_append_to_bytesio():
 @pytest.mark.timeout(1)
 @pytest.mark.skipif("PILLOW_VALGRIND_TEST" in os.environ, reason="Valgrind is slower")
 @pytest.mark.parametrize("newline", (b"\r", b"\n"))
-def test_redos(newline):
+def test_redos(newline) -> None:
     malicious = b" trailer<<>>" + newline * 3456
 
     # This particular exception isn't relevant here.
diff --git a/Tests/test_file_png.py b/Tests/test_file_png.py
index ae2a4772b60..0f1d96365ea 100644
--- a/Tests/test_file_png.py
+++ b/Tests/test_file_png.py
@@ -5,6 +5,7 @@
 import warnings
 import zlib
 from io import BytesIO
+from pathlib import Path
 
 import pytest
 
@@ -79,7 +80,7 @@ def get_chunks(self, filename):
                     png.crc(cid, s)
         return chunks
 
-    def test_sanity(self, tmp_path):
+    def test_sanity(self, tmp_path: Path) -> None:
         # internal version number
         assert re.search(r"\d+(\.\d+){1,3}$", features.version_codec("zlib"))
 
@@ -102,13 +103,13 @@ def test_sanity(self, tmp_path):
                     reloaded = reloaded.convert(mode)
                 assert_image_equal(reloaded, im)
 
-    def test_invalid_file(self):
+    def test_invalid_file(self) -> None:
         invalid_file = "Tests/images/flower.jpg"
 
         with pytest.raises(SyntaxError):
             PngImagePlugin.PngImageFile(invalid_file)
 
-    def test_broken(self):
+    def test_broken(self) -> None:
         # Check reading of totally broken files.  In this case, the test
         # file was checked into Subversion as a text file.
 
@@ -117,7 +118,7 @@ def test_broken(self):
             with Image.open(test_file):
                 pass
 
-    def test_bad_text(self):
+    def test_bad_text(self) -> None:
         # Make sure PIL can read malformed tEXt chunks (@PIL152)
 
         im = load(HEAD + chunk(b"tEXt") + TAIL)
@@ -135,7 +136,7 @@ def test_bad_text(self):
         im = load(HEAD + chunk(b"tEXt", b"spam\0egg\0") + TAIL)
         assert im.info == {"spam": "egg\x00"}
 
-    def test_bad_ztxt(self):
+    def test_bad_ztxt(self) -> None:
         # Test reading malformed zTXt chunks (python-pillow/Pillow#318)
 
         im = load(HEAD + chunk(b"zTXt") + TAIL)
@@ -156,7 +157,7 @@ def test_bad_ztxt(self):
         im = load(HEAD + chunk(b"zTXt", b"spam\0\0" + zlib.compress(b"egg")) + TAIL)
         assert im.info == {"spam": "egg"}
 
-    def test_bad_itxt(self):
+    def test_bad_itxt(self) -> None:
         im = load(HEAD + chunk(b"iTXt") + TAIL)
         assert im.info == {}
 
@@ -200,7 +201,7 @@ def test_bad_itxt(self):
         assert im.info["spam"].lang == "en"
         assert im.info["spam"].tkey == "Spam"
 
-    def test_interlace(self):
+    def test_interlace(self) -> None:
         test_file = "Tests/images/pil123p.png"
         with Image.open(test_file) as im:
             assert_image(im, "P", (162, 150))
@@ -215,7 +216,7 @@ def test_interlace(self):
 
             im.load()
 
-    def test_load_transparent_p(self):
+    def test_load_transparent_p(self) -> None:
         test_file = "Tests/images/pil123p.png"
         with Image.open(test_file) as im:
             assert_image(im, "P", (162, 150))
@@ -225,7 +226,7 @@ def test_load_transparent_p(self):
         # image has 124 unique alpha values
         assert len(im.getchannel("A").getcolors()) == 124
 
-    def test_load_transparent_rgb(self):
+    def test_load_transparent_rgb(self) -> None:
         test_file = "Tests/images/rgb_trns.png"
         with Image.open(test_file) as im:
             assert im.info["transparency"] == (0, 255, 52)
@@ -237,7 +238,7 @@ def test_load_transparent_rgb(self):
         # image has 876 transparent pixels
         assert im.getchannel("A").getcolors()[0][0] == 876
 
-    def test_save_p_transparent_palette(self, tmp_path):
+    def test_save_p_transparent_palette(self, tmp_path: Path) -> None:
         in_file = "Tests/images/pil123p.png"
         with Image.open(in_file) as im:
             # 'transparency' contains a byte string with the opacity for
@@ -258,7 +259,7 @@ def test_save_p_transparent_palette(self, tmp_path):
         # image has 124 unique alpha values
         assert len(im.getchannel("A").getcolors()) == 124
 
-    def test_save_p_single_transparency(self, tmp_path):
+    def test_save_p_single_transparency(self, tmp_path: Path) -> None:
         in_file = "Tests/images/p_trns_single.png"
         with Image.open(in_file) as im:
             # pixel value 164 is full transparent
@@ -281,7 +282,7 @@ def test_save_p_single_transparency(self, tmp_path):
         # image has 876 transparent pixels
         assert im.getchannel("A").getcolors()[0][0] == 876
 
-    def test_save_p_transparent_black(self, tmp_path):
+    def test_save_p_transparent_black(self, tmp_path: Path) -> None:
         # check if solid black image with full transparency
         # is supported (check for #1838)
         im = Image.new("RGBA", (10, 10), (0, 0, 0, 0))
@@ -299,7 +300,7 @@ def test_save_p_transparent_black(self, tmp_path):
         assert_image(im, "RGBA", (10, 10))
         assert im.getcolors() == [(100, (0, 0, 0, 0))]
 
-    def test_save_grayscale_transparency(self, tmp_path):
+    def test_save_grayscale_transparency(self, tmp_path: Path) -> None:
         for mode, num_transparent in {"1": 1994, "L": 559, "I": 559}.items():
             in_file = "Tests/images/" + mode.lower() + "_trns.png"
             with Image.open(in_file) as im:
@@ -320,13 +321,13 @@ def test_save_grayscale_transparency(self, tmp_path):
             test_im_rgba = test_im.convert("RGBA")
             assert test_im_rgba.getchannel("A").getcolors()[0][0] == num_transparent
 
-    def test_save_rgb_single_transparency(self, tmp_path):
+    def test_save_rgb_single_transparency(self, tmp_path: Path) -> None:
         in_file = "Tests/images/caption_6_33_22.png"
         with Image.open(in_file) as im:
             test_file = str(tmp_path / "temp.png")
             im.save(test_file)
 
-    def test_load_verify(self):
+    def test_load_verify(self) -> None:
         # Check open/load/verify exception (@PIL150)
 
         with Image.open(TEST_PNG_FILE) as im:
@@ -339,7 +340,7 @@ def test_load_verify(self):
             with pytest.raises(RuntimeError):
                 im.verify()
 
-    def test_verify_struct_error(self):
+    def test_verify_struct_error(self) -> None:
         # Check open/load/verify exception (#1755)
 
         # offsets to test, -10: breaks in i32() in read. (OSError)
@@ -355,7 +356,7 @@ def test_verify_struct_error(self):
                 with pytest.raises((OSError, SyntaxError)):
                     im.verify()
 
-    def test_verify_ignores_crc_error(self):
+    def test_verify_ignores_crc_error(self) -> None:
         # check ignores crc errors in ancillary chunks
 
         chunk_data = chunk(b"tEXt", b"spam")
@@ -372,7 +373,7 @@ def test_verify_ignores_crc_error(self):
         finally:
             ImageFile.LOAD_TRUNCATED_IMAGES = False
 
-    def test_verify_not_ignores_crc_error_in_required_chunk(self):
+    def test_verify_not_ignores_crc_error_in_required_chunk(self) -> None:
         # check does not ignore crc errors in required chunks
 
         image_data = MAGIC + IHDR[:-1] + b"q" + TAIL
@@ -384,18 +385,18 @@ def test_verify_not_ignores_crc_error_in_required_chunk(self):
         finally:
             ImageFile.LOAD_TRUNCATED_IMAGES = False
 
-    def test_roundtrip_dpi(self):
+    def test_roundtrip_dpi(self) -> None:
         # Check dpi roundtripping
 
         with Image.open(TEST_PNG_FILE) as im:
             im = roundtrip(im, dpi=(100.33, 100.33))
         assert im.info["dpi"] == (100.33, 100.33)
 
-    def test_load_float_dpi(self):
+    def test_load_float_dpi(self) -> None:
         with Image.open(TEST_PNG_FILE) as im:
             assert im.info["dpi"] == (95.9866, 95.9866)
 
-    def test_roundtrip_text(self):
+    def test_roundtrip_text(self) -> None:
         # Check text roundtripping
 
         with Image.open(TEST_PNG_FILE) as im:
@@ -407,7 +408,7 @@ def test_roundtrip_text(self):
         assert im.info == {"TXT": "VALUE", "ZIP": "VALUE"}
         assert im.text == {"TXT": "VALUE", "ZIP": "VALUE"}
 
-    def test_roundtrip_itxt(self):
+    def test_roundtrip_itxt(self) -> None:
         # Check iTXt roundtripping
 
         im = Image.new("RGB", (32, 32))
@@ -423,7 +424,7 @@ def test_roundtrip_itxt(self):
         assert im.text["eggs"].lang == "en"
         assert im.text["eggs"].tkey == "Eggs"
 
-    def test_nonunicode_text(self):
+    def test_nonunicode_text(self) -> None:
         # Check so that non-Unicode text is saved as a tEXt rather than iTXt
 
         im = Image.new("RGB", (32, 32))
@@ -432,10 +433,10 @@ def test_nonunicode_text(self):
         im = roundtrip(im, pnginfo=info)
         assert isinstance(im.info["Text"], str)
 
-    def test_unicode_text(self):
+    def test_unicode_text(self) -> None:
         # Check preservation of non-ASCII characters
 
-        def rt_text(value):
+        def rt_text(value) -> None:
             im = Image.new("RGB", (32, 32))
             info = PngImagePlugin.PngInfo()
             info.add_text("Text", value)
@@ -448,7 +449,7 @@ def rt_text(value):
         rt_text(chr(0x4E00) + chr(0x66F0) + chr(0x9FBA) + chr(0x3042) + chr(0xAC00))
         rt_text("A" + chr(0xC4) + chr(0x472) + chr(0x3042))  # Combined
 
-    def test_scary(self):
+    def test_scary(self) -> None:
         # Check reading of evil PNG file.  For information, see:
         # http://scary.beasts.org/security/CESA-2004-001.txt
         # The first byte is removed from pngtest_bad.png
@@ -462,7 +463,7 @@ def test_scary(self):
             with Image.open(pngfile):
                 pass
 
-    def test_trns_rgb(self):
+    def test_trns_rgb(self) -> None:
         # Check writing and reading of tRNS chunks for RGB images.
         # Independent file sample provided by Sebastian Spaeth.
 
@@ -477,7 +478,7 @@ def test_trns_rgb(self):
         im = roundtrip(im, transparency=(0, 1, 2))
         assert im.info["transparency"] == (0, 1, 2)
 
-    def test_trns_p(self, tmp_path):
+    def test_trns_p(self, tmp_path: Path) -> None:
         # Check writing a transparency of 0, issue #528
         im = hopper("P")
         im.info["transparency"] = 0
@@ -490,13 +491,13 @@ def test_trns_p(self, tmp_path):
 
             assert_image_equal(im2.convert("RGBA"), im.convert("RGBA"))
 
-    def test_trns_null(self):
+    def test_trns_null(self) -> None:
         # Check reading images with null tRNS value, issue #1239
         test_file = "Tests/images/tRNS_null_1x1.png"
         with Image.open(test_file) as im:
             assert im.info["transparency"] == 0
 
-    def test_save_icc_profile(self):
+    def test_save_icc_profile(self) -> None:
         with Image.open("Tests/images/icc_profile_none.png") as im:
             assert im.info["icc_profile"] is None
 
@@ -506,40 +507,40 @@ def test_save_icc_profile(self):
                 im = roundtrip(im, icc_profile=expected_icc)
                 assert im.info["icc_profile"] == expected_icc
 
-    def test_discard_icc_profile(self):
+    def test_discard_icc_profile(self) -> None:
         with Image.open("Tests/images/icc_profile.png") as im:
             assert "icc_profile" in im.info
 
             im = roundtrip(im, icc_profile=None)
         assert "icc_profile" not in im.info
 
-    def test_roundtrip_icc_profile(self):
+    def test_roundtrip_icc_profile(self) -> None:
         with Image.open("Tests/images/icc_profile.png") as im:
             expected_icc = im.info["icc_profile"]
 
             im = roundtrip(im)
         assert im.info["icc_profile"] == expected_icc
 
-    def test_roundtrip_no_icc_profile(self):
+    def test_roundtrip_no_icc_profile(self) -> None:
         with Image.open("Tests/images/icc_profile_none.png") as im:
             assert im.info["icc_profile"] is None
 
             im = roundtrip(im)
         assert "icc_profile" not in im.info
 
-    def test_repr_png(self):
+    def test_repr_png(self) -> None:
         im = hopper()
 
         with Image.open(BytesIO(im._repr_png_())) as repr_png:
             assert repr_png.format == "PNG"
             assert_image_equal(im, repr_png)
 
-    def test_repr_png_error_returns_none(self):
+    def test_repr_png_error_returns_none(self) -> None:
         im = hopper("F")
 
         assert im._repr_png_() is None
 
-    def test_chunk_order(self, tmp_path):
+    def test_chunk_order(self, tmp_path: Path) -> None:
         with Image.open("Tests/images/icc_profile.png") as im:
             test_file = str(tmp_path / "temp.png")
             im.convert("P").save(test_file, dpi=(100, 100))
@@ -560,17 +561,17 @@ def test_chunk_order(self, tmp_path):
         # pHYs - before IDAT
         assert chunks.index(b"pHYs") < chunks.index(b"IDAT")
 
-    def test_getchunks(self):
+    def test_getchunks(self) -> None:
         im = hopper()
 
         chunks = PngImagePlugin.getchunks(im)
         assert len(chunks) == 3
 
-    def test_read_private_chunks(self):
+    def test_read_private_chunks(self) -> None:
         with Image.open("Tests/images/exif.png") as im:
             assert im.private_chunks == [(b"orNT", b"\x01")]
 
-    def test_roundtrip_private_chunk(self):
+    def test_roundtrip_private_chunk(self) -> None:
         # Check private chunk roundtripping
 
         with Image.open(TEST_PNG_FILE) as im:
@@ -588,7 +589,7 @@ def test_roundtrip_private_chunk(self):
             (b"prIV", b"VALUE3", True),
         ]
 
-    def test_textual_chunks_after_idat(self):
+    def test_textual_chunks_after_idat(self) -> None:
         with Image.open("Tests/images/hopper.png") as im:
             assert "comment" in im.text
             for k, v in {
@@ -615,7 +616,7 @@ def test_textual_chunks_after_idat(self):
         with Image.open("Tests/images/hopper_idat_after_image_end.png") as im:
             assert im.text == {"TXT": "VALUE", "ZIP": "VALUE"}
 
-    def test_padded_idat(self):
+    def test_padded_idat(self) -> None:
         # This image has been manually hexedited
         # so that the IDAT chunk has padding at the end
         # Set MAXBLOCK to the length of the actual data
@@ -635,7 +636,7 @@ def test_padded_idat(self):
     @pytest.mark.parametrize(
         "cid", (b"IHDR", b"sRGB", b"pHYs", b"acTL", b"fcTL", b"fdAT")
     )
-    def test_truncated_chunks(self, cid):
+    def test_truncated_chunks(self, cid) -> None:
         fp = BytesIO()
         with PngImagePlugin.PngStream(fp) as png:
             with pytest.raises(ValueError):
@@ -645,7 +646,7 @@ def test_truncated_chunks(self, cid):
             png.call(cid, 0, 0)
             ImageFile.LOAD_TRUNCATED_IMAGES = False
 
-    def test_specify_bits(self, tmp_path):
+    def test_specify_bits(self, tmp_path: Path) -> None:
         im = hopper("P")
 
         out = str(tmp_path / "temp.png")
@@ -654,7 +655,7 @@ def test_specify_bits(self, tmp_path):
         with Image.open(out) as reloaded:
             assert len(reloaded.png.im_palette[1]) == 48
 
-    def test_plte_length(self, tmp_path):
+    def test_plte_length(self, tmp_path: Path) -> None:
         im = Image.new("P", (1, 1))
         im.putpalette((1, 1, 1))
 
@@ -664,7 +665,7 @@ def test_plte_length(self, tmp_path):
         with Image.open(out) as reloaded:
             assert len(reloaded.png.im_palette[1]) == 3
 
-    def test_getxmp(self):
+    def test_getxmp(self) -> None:
         with Image.open("Tests/images/color_snakes.png") as im:
             if ElementTree is None:
                 with pytest.warns(
@@ -679,7 +680,7 @@ def test_getxmp(self):
                 assert description["PixelXDimension"] == "10"
                 assert description["subject"]["Seq"] is None
 
-    def test_exif(self):
+    def test_exif(self) -> None:
         # With an EXIF chunk
         with Image.open("Tests/images/exif.png") as im:
             exif = im._getexif()
@@ -705,7 +706,7 @@ def test_exif(self):
             exif = im.getexif()
         assert exif[274] == 3
 
-    def test_exif_save(self, tmp_path):
+    def test_exif_save(self, tmp_path: Path) -> None:
         # Test exif is not saved from info
         test_file = str(tmp_path / "temp.png")
         with Image.open("Tests/images/exif.png") as im:
@@ -725,7 +726,7 @@ def test_exif_save(self, tmp_path):
     @mark_if_feature_version(
         pytest.mark.valgrind_known_error, "libjpeg_turbo", "2.0", reason="Known Failing"
     )
-    def test_exif_from_jpg(self, tmp_path):
+    def test_exif_from_jpg(self, tmp_path: Path) -> None:
         with Image.open("Tests/images/pil_sample_rgb.jpg") as im:
             test_file = str(tmp_path / "temp.png")
             im.save(test_file, exif=im.getexif())
@@ -734,7 +735,7 @@ def test_exif_from_jpg(self, tmp_path):
             exif = reloaded._getexif()
         assert exif[305] == "Adobe Photoshop CS Macintosh"
 
-    def test_exif_argument(self, tmp_path):
+    def test_exif_argument(self, tmp_path: Path) -> None:
         with Image.open(TEST_PNG_FILE) as im:
             test_file = str(tmp_path / "temp.png")
             im.save(test_file, exif=b"exifstring")
@@ -742,11 +743,11 @@ def test_exif_argument(self, tmp_path):
         with Image.open(test_file) as reloaded:
             assert reloaded.info["exif"] == b"Exif\x00\x00exifstring"
 
-    def test_tell(self):
+    def test_tell(self) -> None:
         with Image.open(TEST_PNG_FILE) as im:
             assert im.tell() == 0
 
-    def test_seek(self):
+    def test_seek(self) -> None:
         with Image.open(TEST_PNG_FILE) as im:
             im.seek(0)
 
@@ -754,7 +755,7 @@ def test_seek(self):
                 im.seek(1)
 
     @pytest.mark.parametrize("buffer", (True, False))
-    def test_save_stdout(self, buffer):
+    def test_save_stdout(self, buffer) -> None:
         old_stdout = sys.stdout
 
         if buffer:
@@ -786,7 +787,7 @@ class TestTruncatedPngPLeaks(PillowLeakTestCase):
     mem_limit = 2 * 1024  # max increase in K
     iterations = 100  # Leak is 56k/iteration, this will leak 5.6megs
 
-    def test_leak_load(self):
+    def test_leak_load(self) -> None:
         with open("Tests/images/hopper.png", "rb") as f:
             DATA = BytesIO(f.read(16 * 1024))
 
@@ -794,7 +795,7 @@ def test_leak_load(self):
         with Image.open(DATA) as im:
             im.load()
 
-        def core():
+        def core() -> None:
             with Image.open(DATA) as im:
                 im.load()
 
diff --git a/Tests/test_file_ppm.py b/Tests/test_file_ppm.py
index 32de42ed45d..94f66ee7d28 100644
--- a/Tests/test_file_ppm.py
+++ b/Tests/test_file_ppm.py
@@ -2,6 +2,7 @@
 
 import sys
 from io import BytesIO
+from pathlib import Path
 
 import pytest
 
@@ -18,7 +19,7 @@
 TEST_FILE = "Tests/images/hopper.ppm"
 
 
-def test_sanity():
+def test_sanity() -> None:
     with Image.open(TEST_FILE) as im:
         assert im.mode == "RGB"
         assert im.size == (128, 128)
@@ -69,7 +70,7 @@ def test_sanity():
         ),
     ),
 )
-def test_arbitrary_maxval(data, mode, pixels):
+def test_arbitrary_maxval(data, mode, pixels) -> None:
     fp = BytesIO(data)
     with Image.open(fp) as im:
         assert im.size == (3, 1)
@@ -79,7 +80,7 @@ def test_arbitrary_maxval(data, mode, pixels):
         assert tuple(px[x, 0] for x in range(3)) == pixels
 
 
-def test_16bit_pgm():
+def test_16bit_pgm() -> None:
     with Image.open("Tests/images/16_bit_binary.pgm") as im:
         assert im.mode == "I"
         assert im.size == (20, 100)
@@ -88,7 +89,7 @@ def test_16bit_pgm():
         assert_image_equal_tofile(im, "Tests/images/16_bit_binary_pgm.png")
 
 
-def test_16bit_pgm_write(tmp_path):
+def test_16bit_pgm_write(tmp_path: Path) -> None:
     with Image.open("Tests/images/16_bit_binary.pgm") as im:
         filename = str(tmp_path / "temp.pgm")
         im.save(filename, "PPM")
@@ -96,7 +97,7 @@ def test_16bit_pgm_write(tmp_path):
         assert_image_equal_tofile(im, filename)
 
 
-def test_pnm(tmp_path):
+def test_pnm(tmp_path: Path) -> None:
     with Image.open("Tests/images/hopper.pnm") as im:
         assert_image_similar(im, hopper(), 0.0001)
 
@@ -106,7 +107,7 @@ def test_pnm(tmp_path):
         assert_image_equal_tofile(im, filename)
 
 
-def test_pfm(tmp_path):
+def test_pfm(tmp_path: Path) -> None:
     with Image.open("Tests/images/hopper.pfm") as im:
         assert im.info["scale"] == 1.0
         assert_image_equal(im, hopper("F"))
@@ -117,7 +118,7 @@ def test_pfm(tmp_path):
         assert_image_equal_tofile(im, filename)
 
 
-def test_pfm_big_endian(tmp_path):
+def test_pfm_big_endian(tmp_path: Path) -> None:
     with Image.open("Tests/images/hopper_be.pfm") as im:
         assert im.info["scale"] == 2.5
         assert_image_equal(im, hopper("F"))
@@ -138,7 +139,7 @@ def test_pfm_big_endian(tmp_path):
         b"Pf 1 1 -0.0 \0\0\0\0",
     ],
 )
-def test_pfm_invalid(data):
+def test_pfm_invalid(data) -> None:
     with pytest.raises(ValueError):
         with Image.open(BytesIO(data)):
             pass
@@ -161,12 +162,12 @@ def test_pfm_invalid(data):
         ),
     ),
 )
-def test_plain(plain_path, raw_path):
+def test_plain(plain_path, raw_path) -> None:
     with Image.open(plain_path) as im:
         assert_image_equal_tofile(im, raw_path)
 
 
-def test_16bit_plain_pgm():
+def test_16bit_plain_pgm() -> None:
     # P2 with maxval 2 ** 16 - 1
     with Image.open("Tests/images/hopper_16bit_plain.pgm") as im:
         assert im.mode == "I"
@@ -185,7 +186,7 @@ def test_16bit_plain_pgm():
         (b"P3\n2 2\n255", b"0 0 0 001 1 1 2 2 2 255 255 255", 10**6),
     ),
 )
-def test_plain_data_with_comment(tmp_path, header, data, comment_count):
+def test_plain_data_with_comment(tmp_path: Path, header, data, comment_count) -> None:
     path1 = str(tmp_path / "temp1.ppm")
     path2 = str(tmp_path / "temp2.ppm")
     comment = b"# comment" * comment_count
@@ -198,7 +199,7 @@ def test_plain_data_with_comment(tmp_path, header, data, comment_count):
 
 
 @pytest.mark.parametrize("data", (b"P1\n128 128\n", b"P3\n128 128\n255\n"))
-def test_plain_truncated_data(tmp_path, data):
+def test_plain_truncated_data(tmp_path: Path, data) -> None:
     path = str(tmp_path / "temp.ppm")
     with open(path, "wb") as f:
         f.write(data)
@@ -209,7 +210,7 @@ def test_plain_truncated_data(tmp_path, data):
 
 
 @pytest.mark.parametrize("data", (b"P1\n128 128\n1009", b"P3\n128 128\n255\n100A"))
-def test_plain_invalid_data(tmp_path, data):
+def test_plain_invalid_data(tmp_path: Path, data) -> None:
     path = str(tmp_path / "temp.ppm")
     with open(path, "wb") as f:
         f.write(data)
@@ -226,7 +227,7 @@ def test_plain_invalid_data(tmp_path, data):
         b"P3\n128 128\n255\n012345678910 0",  # token too long
     ),
 )
-def test_plain_ppm_token_too_long(tmp_path, data):
+def test_plain_ppm_token_too_long(tmp_path: Path, data) -> None:
     path = str(tmp_path / "temp.ppm")
     with open(path, "wb") as f:
         f.write(data)
@@ -236,7 +237,7 @@ def test_plain_ppm_token_too_long(tmp_path, data):
             im.load()
 
 
-def test_plain_ppm_value_too_large(tmp_path):
+def test_plain_ppm_value_too_large(tmp_path: Path) -> None:
     path = str(tmp_path / "temp.ppm")
     with open(path, "wb") as f:
         f.write(b"P3\n128 128\n255\n256")
@@ -246,12 +247,12 @@ def test_plain_ppm_value_too_large(tmp_path):
             im.load()
 
 
-def test_magic():
+def test_magic() -> None:
     with pytest.raises(SyntaxError):
         PpmImagePlugin.PpmImageFile(fp=BytesIO(b"PyInvalid"))
 
 
-def test_header_with_comments(tmp_path):
+def test_header_with_comments(tmp_path: Path) -> None:
     path = str(tmp_path / "temp.ppm")
     with open(path, "wb") as f:
         f.write(b"P6 #comment\n#comment\r12#comment\r8\n128 #comment\n255\n")
@@ -260,7 +261,7 @@ def test_header_with_comments(tmp_path):
         assert im.size == (128, 128)
 
 
-def test_non_integer_token(tmp_path):
+def test_non_integer_token(tmp_path: Path) -> None:
     path = str(tmp_path / "temp.ppm")
     with open(path, "wb") as f:
         f.write(b"P6\nTEST")
@@ -270,7 +271,7 @@ def test_non_integer_token(tmp_path):
             pass
 
 
-def test_header_token_too_long(tmp_path):
+def test_header_token_too_long(tmp_path: Path) -> None:
     path = str(tmp_path / "temp.ppm")
     with open(path, "wb") as f:
         f.write(b"P6\n 01234567890")
@@ -282,7 +283,7 @@ def test_header_token_too_long(tmp_path):
     assert str(e.value) == "Token too long in file header: 01234567890"
 
 
-def test_truncated_file(tmp_path):
+def test_truncated_file(tmp_path: Path) -> None:
     # Test EOF in header
     path = str(tmp_path / "temp.pgm")
     with open(path, "wb") as f:
@@ -301,7 +302,7 @@ def test_truncated_file(tmp_path):
             im.load()
 
 
-def test_not_enough_image_data(tmp_path):
+def test_not_enough_image_data(tmp_path: Path) -> None:
     path = str(tmp_path / "temp.ppm")
     with open(path, "wb") as f:
         f.write(b"P2 1 2 255 255")
@@ -312,7 +313,7 @@ def test_not_enough_image_data(tmp_path):
 
 
 @pytest.mark.parametrize("maxval", (b"0", b"65536"))
-def test_invalid_maxval(maxval, tmp_path):
+def test_invalid_maxval(maxval, tmp_path: Path) -> None:
     path = str(tmp_path / "temp.ppm")
     with open(path, "wb") as f:
         f.write(b"P6\n3 1 " + maxval)
@@ -324,7 +325,7 @@ def test_invalid_maxval(maxval, tmp_path):
     assert str(e.value) == "maxval must be greater than 0 and less than 65536"
 
 
-def test_neg_ppm():
+def test_neg_ppm() -> None:
     # Storage.c accepted negative values for xsize, ysize.  the
     # internal open_ppm function didn't check for sanity but it
     # has been removed. The default opener doesn't accept negative
@@ -335,7 +336,7 @@ def test_neg_ppm():
             pass
 
 
-def test_mimetypes(tmp_path):
+def test_mimetypes(tmp_path: Path) -> None:
     path = str(tmp_path / "temp.pgm")
 
     with open(path, "wb") as f:
@@ -350,7 +351,7 @@ def test_mimetypes(tmp_path):
 
 
 @pytest.mark.parametrize("buffer", (True, False))
-def test_save_stdout(buffer):
+def test_save_stdout(buffer) -> None:
     old_stdout = sys.stdout
 
     if buffer:
diff --git a/Tests/test_file_psd.py b/Tests/test_file_psd.py
index 16f049602bc..7eca8d9b151 100644
--- a/Tests/test_file_psd.py
+++ b/Tests/test_file_psd.py
@@ -11,7 +11,7 @@
 test_file = "Tests/images/hopper.psd"
 
 
-def test_sanity():
+def test_sanity() -> None:
     with Image.open(test_file) as im:
         im.load()
         assert im.mode == "RGB"
@@ -24,8 +24,8 @@ def test_sanity():
 
 
 @pytest.mark.skipif(is_pypy(), reason="Requires CPython")
-def test_unclosed_file():
-    def open():
+def test_unclosed_file() -> None:
+    def open() -> None:
         im = Image.open(test_file)
         im.load()
 
@@ -33,27 +33,27 @@ def open():
         open()
 
 
-def test_closed_file():
+def test_closed_file() -> None:
     with warnings.catch_warnings():
         im = Image.open(test_file)
         im.load()
         im.close()
 
 
-def test_context_manager():
+def test_context_manager() -> None:
     with warnings.catch_warnings():
         with Image.open(test_file) as im:
             im.load()
 
 
-def test_invalid_file():
+def test_invalid_file() -> None:
     invalid_file = "Tests/images/flower.jpg"
 
     with pytest.raises(SyntaxError):
         PsdImagePlugin.PsdImageFile(invalid_file)
 
 
-def test_n_frames():
+def test_n_frames() -> None:
     with Image.open("Tests/images/hopper_merged.psd") as im:
         assert im.n_frames == 1
         assert not im.is_animated
@@ -64,7 +64,7 @@ def test_n_frames():
             assert im.is_animated
 
 
-def test_eoferror():
+def test_eoferror() -> None:
     with Image.open(test_file) as im:
         # PSD seek index starts at 1 rather than 0
         n_frames = im.n_frames + 1
@@ -78,7 +78,7 @@ def test_eoferror():
         im.seek(n_frames - 1)
 
 
-def test_seek_tell():
+def test_seek_tell() -> None:
     with Image.open(test_file) as im:
         layer_number = im.tell()
         assert layer_number == 1
@@ -95,30 +95,30 @@ def test_seek_tell():
         assert layer_number == 2
 
 
-def test_seek_eoferror():
+def test_seek_eoferror() -> None:
     with Image.open(test_file) as im:
         with pytest.raises(EOFError):
             im.seek(-1)
 
 
-def test_open_after_exclusive_load():
+def test_open_after_exclusive_load() -> None:
     with Image.open(test_file) as im:
         im.load()
         im.seek(im.tell() + 1)
         im.load()
 
 
-def test_rgba():
+def test_rgba() -> None:
     with Image.open("Tests/images/rgba.psd") as im:
         assert_image_equal_tofile(im, "Tests/images/imagedraw_square.png")
 
 
-def test_layer_skip():
+def test_layer_skip() -> None:
     with Image.open("Tests/images/five_channels.psd") as im:
         assert im.n_frames == 1
 
 
-def test_icc_profile():
+def test_icc_profile() -> None:
     with Image.open(test_file) as im:
         assert "icc_profile" in im.info
 
@@ -126,12 +126,12 @@ def test_icc_profile():
         assert len(icc_profile) == 3144
 
 
-def test_no_icc_profile():
+def test_no_icc_profile() -> None:
     with Image.open("Tests/images/hopper_merged.psd") as im:
         assert "icc_profile" not in im.info
 
 
-def test_combined_larger_than_size():
+def test_combined_larger_than_size() -> None:
     # The combined size of the individual parts is larger than the
     # declared 'size' of the extra data field, resulting in a backwards seek.
 
@@ -157,7 +157,7 @@ def test_combined_larger_than_size():
         ("Tests/images/timeout-dedc7a4ebd856d79b4359bbcc79e8ef231ce38f6.psd", OSError),
     ],
 )
-def test_crashes(test_file, raises):
+def test_crashes(test_file, raises) -> None:
     with open(test_file, "rb") as f:
         with pytest.raises(raises):
             with Image.open(f):
diff --git a/Tests/test_file_sgi.py b/Tests/test_file_sgi.py
index bc45bbfd34d..92aea07350e 100644
--- a/Tests/test_file_sgi.py
+++ b/Tests/test_file_sgi.py
@@ -1,5 +1,7 @@
 from __future__ import annotations
 
+from pathlib import Path
+
 import pytest
 
 from PIL import Image, SgiImagePlugin
@@ -12,7 +14,7 @@
 )
 
 
-def test_rgb():
+def test_rgb() -> None:
     # Created with ImageMagick then renamed:
     # convert hopper.ppm -compress None sgi:hopper.rgb
     test_file = "Tests/images/hopper.rgb"
@@ -22,11 +24,11 @@ def test_rgb():
         assert im.get_format_mimetype() == "image/rgb"
 
 
-def test_rgb16():
+def test_rgb16() -> None:
     assert_image_equal_tofile(hopper(), "Tests/images/hopper16.rgb")
 
 
-def test_l():
+def test_l() -> None:
     # Created with ImageMagick
     # convert hopper.ppm -monochrome -compress None sgi:hopper.bw
     test_file = "Tests/images/hopper.bw"
@@ -36,7 +38,7 @@ def test_l():
         assert im.get_format_mimetype() == "image/sgi"
 
 
-def test_rgba():
+def test_rgba() -> None:
     # Created with ImageMagick:
     # convert transparent.png -compress None transparent.sgi
     test_file = "Tests/images/transparent.sgi"
@@ -46,7 +48,7 @@ def test_rgba():
         assert im.get_format_mimetype() == "image/sgi"
 
 
-def test_rle():
+def test_rle() -> None:
     # Created with ImageMagick:
     # convert hopper.ppm  hopper.sgi
     test_file = "Tests/images/hopper.sgi"
@@ -55,22 +57,22 @@ def test_rle():
         assert_image_equal_tofile(im, "Tests/images/hopper.rgb")
 
 
-def test_rle16():
+def test_rle16() -> None:
     test_file = "Tests/images/tv16.sgi"
 
     with Image.open(test_file) as im:
         assert_image_equal_tofile(im, "Tests/images/tv.rgb")
 
 
-def test_invalid_file():
+def test_invalid_file() -> None:
     invalid_file = "Tests/images/flower.jpg"
 
     with pytest.raises(ValueError):
         SgiImagePlugin.SgiImageFile(invalid_file)
 
 
-def test_write(tmp_path):
-    def roundtrip(img):
+def test_write(tmp_path: Path) -> None:
+    def roundtrip(img) -> None:
         out = str(tmp_path / "temp.sgi")
         img.save(out, format="sgi")
         assert_image_equal_tofile(img, out)
@@ -89,7 +91,7 @@ def roundtrip(img):
     roundtrip(Image.new("L", (10, 1)))
 
 
-def test_write16(tmp_path):
+def test_write16(tmp_path: Path) -> None:
     test_file = "Tests/images/hopper16.rgb"
 
     with Image.open(test_file) as im:
@@ -99,7 +101,7 @@ def test_write16(tmp_path):
         assert_image_equal_tofile(im, out)
 
 
-def test_unsupported_mode(tmp_path):
+def test_unsupported_mode(tmp_path: Path) -> None:
     im = hopper("LA")
     out = str(tmp_path / "temp.sgi")
 
diff --git a/Tests/test_file_spider.py b/Tests/test_file_spider.py
index 42d833fb25c..75fef1dc6b6 100644
--- a/Tests/test_file_spider.py
+++ b/Tests/test_file_spider.py
@@ -3,6 +3,7 @@
 import tempfile
 import warnings
 from io import BytesIO
+from pathlib import Path
 
 import pytest
 
@@ -13,7 +14,7 @@
 TEST_FILE = "Tests/images/hopper.spider"
 
 
-def test_sanity():
+def test_sanity() -> None:
     with Image.open(TEST_FILE) as im:
         im.load()
         assert im.mode == "F"
@@ -22,8 +23,8 @@ def test_sanity():
 
 
 @pytest.mark.skipif(is_pypy(), reason="Requires CPython")
-def test_unclosed_file():
-    def open():
+def test_unclosed_file() -> None:
+    def open() -> None:
         im = Image.open(TEST_FILE)
         im.load()
 
@@ -31,20 +32,20 @@ def open():
         open()
 
 
-def test_closed_file():
+def test_closed_file() -> None:
     with warnings.catch_warnings():
         im = Image.open(TEST_FILE)
         im.load()
         im.close()
 
 
-def test_context_manager():
+def test_context_manager() -> None:
     with warnings.catch_warnings():
         with Image.open(TEST_FILE) as im:
             im.load()
 
 
-def test_save(tmp_path):
+def test_save(tmp_path: Path) -> None:
     # Arrange
     temp = str(tmp_path / "temp.spider")
     im = hopper()
@@ -59,7 +60,7 @@ def test_save(tmp_path):
         assert im2.format == "SPIDER"
 
 
-def test_tempfile():
+def test_tempfile() -> None:
     # Arrange
     im = hopper()
 
@@ -75,11 +76,11 @@ def test_tempfile():
             assert reloaded.format == "SPIDER"
 
 
-def test_is_spider_image():
+def test_is_spider_image() -> None:
     assert SpiderImagePlugin.isSpiderImage(TEST_FILE)
 
 
-def test_tell():
+def test_tell() -> None:
     # Arrange
     with Image.open(TEST_FILE) as im:
         # Act
@@ -89,13 +90,13 @@ def test_tell():
         assert index == 0
 
 
-def test_n_frames():
+def test_n_frames() -> None:
     with Image.open(TEST_FILE) as im:
         assert im.n_frames == 1
         assert not im.is_animated
 
 
-def test_load_image_series():
+def test_load_image_series() -> None:
     # Arrange
     not_spider_file = "Tests/images/hopper.ppm"
     file_list = [TEST_FILE, not_spider_file, "path/not_found.ext"]
@@ -109,7 +110,7 @@ def test_load_image_series():
     assert img_list[0].size == (128, 128)
 
 
-def test_load_image_series_no_input():
+def test_load_image_series_no_input() -> None:
     # Arrange
     file_list = None
 
@@ -120,7 +121,7 @@ def test_load_image_series_no_input():
     assert img_list is None
 
 
-def test_is_int_not_a_number():
+def test_is_int_not_a_number() -> None:
     # Arrange
     not_a_number = "a"
 
@@ -131,7 +132,7 @@ def test_is_int_not_a_number():
     assert ret == 0
 
 
-def test_invalid_file():
+def test_invalid_file() -> None:
     invalid_file = "Tests/images/invalid.spider"
 
     with pytest.raises(OSError):
@@ -139,20 +140,20 @@ def test_invalid_file():
             pass
 
 
-def test_nonstack_file():
+def test_nonstack_file() -> None:
     with Image.open(TEST_FILE) as im:
         with pytest.raises(EOFError):
             im.seek(0)
 
 
-def test_nonstack_dos():
+def test_nonstack_dos() -> None:
     with Image.open(TEST_FILE) as im:
         for i, frame in enumerate(ImageSequence.Iterator(im)):
             assert i <= 1, "Non-stack DOS file test failed"
 
 
 # for issue #4093
-def test_odd_size():
+def test_odd_size() -> None:
     data = BytesIO()
     width = 100
     im = Image.new("F", (width, 64))
diff --git a/Tests/test_file_sun.py b/Tests/test_file_sun.py
index 41f3b7d98f3..6cfff87309c 100644
--- a/Tests/test_file_sun.py
+++ b/Tests/test_file_sun.py
@@ -11,7 +11,7 @@
 EXTRA_DIR = "Tests/images/sunraster"
 
 
-def test_sanity():
+def test_sanity() -> None:
     # Arrange
     # Created with ImageMagick: convert hopper.jpg hopper.ras
     test_file = "Tests/images/hopper.ras"
@@ -28,7 +28,7 @@ def test_sanity():
         SunImagePlugin.SunImageFile(invalid_file)
 
 
-def test_im1():
+def test_im1() -> None:
     with Image.open("Tests/images/sunraster.im1") as im:
         assert_image_equal_tofile(im, "Tests/images/sunraster.im1.png")
 
@@ -36,7 +36,7 @@ def test_im1():
 @pytest.mark.skipif(
     not os.path.exists(EXTRA_DIR), reason="Extra image files not installed"
 )
-def test_others():
+def test_others() -> None:
     files = (
         os.path.join(EXTRA_DIR, f)
         for f in os.listdir(EXTRA_DIR)
diff --git a/Tests/test_file_tar.py b/Tests/test_file_tar.py
index 58226c33062..44e78e972dc 100644
--- a/Tests/test_file_tar.py
+++ b/Tests/test_file_tar.py
@@ -19,7 +19,7 @@
         ("jpg", "hopper.jpg", "JPEG"),
     ),
 )
-def test_sanity(codec, test_path, format):
+def test_sanity(codec, test_path, format) -> None:
     if features.check(codec):
         with TarIO.TarIO(TEST_TAR_FILE, test_path) as tar:
             with Image.open(tar) as im:
@@ -30,18 +30,18 @@ def test_sanity(codec, test_path, format):
 
 
 @pytest.mark.skipif(is_pypy(), reason="Requires CPython")
-def test_unclosed_file():
+def test_unclosed_file() -> None:
     with pytest.warns(ResourceWarning):
         TarIO.TarIO(TEST_TAR_FILE, "hopper.jpg")
 
 
-def test_close():
+def test_close() -> None:
     with warnings.catch_warnings():
         tar = TarIO.TarIO(TEST_TAR_FILE, "hopper.jpg")
         tar.close()
 
 
-def test_contextmanager():
+def test_contextmanager() -> None:
     with warnings.catch_warnings():
         with TarIO.TarIO(TEST_TAR_FILE, "hopper.jpg"):
             pass
diff --git a/Tests/test_file_tga.py b/Tests/test_file_tga.py
index eafb61d30af..bd8e522c7b5 100644
--- a/Tests/test_file_tga.py
+++ b/Tests/test_file_tga.py
@@ -3,6 +3,7 @@
 import os
 from glob import glob
 from itertools import product
+from pathlib import Path
 
 import pytest
 
@@ -21,8 +22,8 @@
 
 
 @pytest.mark.parametrize("mode", _MODES)
-def test_sanity(mode, tmp_path):
-    def roundtrip(original_im):
+def test_sanity(mode, tmp_path: Path) -> None:
+    def roundtrip(original_im) -> None:
         out = str(tmp_path / "temp.tga")
 
         original_im.save(out, rle=rle)
@@ -64,7 +65,7 @@ def roundtrip(original_im):
                     roundtrip(original_im)
 
 
-def test_palette_depth_16(tmp_path):
+def test_palette_depth_16(tmp_path: Path) -> None:
     with Image.open("Tests/images/p_16.tga") as im:
         assert_image_equal_tofile(im.convert("RGB"), "Tests/images/p_16.png")
 
@@ -74,7 +75,7 @@ def test_palette_depth_16(tmp_path):
             assert_image_equal_tofile(reloaded.convert("RGB"), "Tests/images/p_16.png")
 
 
-def test_id_field():
+def test_id_field() -> None:
     # tga file with id field
     test_file = "Tests/images/tga_id_field.tga"
 
@@ -84,7 +85,7 @@ def test_id_field():
         assert im.size == (100, 100)
 
 
-def test_id_field_rle():
+def test_id_field_rle() -> None:
     # tga file with id field
     test_file = "Tests/images/rgb32rle.tga"
 
@@ -94,7 +95,7 @@ def test_id_field_rle():
         assert im.size == (199, 199)
 
 
-def test_cross_scan_line():
+def test_cross_scan_line() -> None:
     with Image.open("Tests/images/cross_scan_line.tga") as im:
         assert_image_equal_tofile(im, "Tests/images/cross_scan_line.png")
 
@@ -103,7 +104,7 @@ def test_cross_scan_line():
             im.load()
 
 
-def test_save(tmp_path):
+def test_save(tmp_path: Path) -> None:
     test_file = "Tests/images/tga_id_field.tga"
     with Image.open(test_file) as im:
         out = str(tmp_path / "temp.tga")
@@ -120,7 +121,7 @@ def test_save(tmp_path):
         assert test_im.size == (100, 100)
 
 
-def test_small_palette(tmp_path):
+def test_small_palette(tmp_path: Path) -> None:
     im = Image.new("P", (1, 1))
     colors = [0, 0, 0]
     im.putpalette(colors)
@@ -132,7 +133,7 @@ def test_small_palette(tmp_path):
         assert reloaded.getpalette() == colors
 
 
-def test_save_wrong_mode(tmp_path):
+def test_save_wrong_mode(tmp_path: Path) -> None:
     im = hopper("PA")
     out = str(tmp_path / "temp.tga")
 
@@ -140,7 +141,7 @@ def test_save_wrong_mode(tmp_path):
         im.save(out)
 
 
-def test_save_mapdepth():
+def test_save_mapdepth() -> None:
     # This image has been manually hexedited from 200x32_p_bl_raw.tga
     # to include an origin
     test_file = "Tests/images/200x32_p_bl_raw_origin.tga"
@@ -148,7 +149,7 @@ def test_save_mapdepth():
         assert_image_equal_tofile(im, "Tests/images/tga/common/200x32_p.png")
 
 
-def test_save_id_section(tmp_path):
+def test_save_id_section(tmp_path: Path) -> None:
     test_file = "Tests/images/rgb32rle.tga"
     with Image.open(test_file) as im:
         out = str(tmp_path / "temp.tga")
@@ -179,7 +180,7 @@ def test_save_id_section(tmp_path):
         assert "id_section" not in test_im.info
 
 
-def test_save_orientation(tmp_path):
+def test_save_orientation(tmp_path: Path) -> None:
     test_file = "Tests/images/rgb32rle.tga"
     out = str(tmp_path / "temp.tga")
     with Image.open(test_file) as im:
@@ -190,7 +191,7 @@ def test_save_orientation(tmp_path):
         assert test_im.info["orientation"] == 1
 
 
-def test_horizontal_orientations():
+def test_horizontal_orientations() -> None:
     # These images have been manually hexedited to have the relevant orientations
     with Image.open("Tests/images/rgb32rle_top_right.tga") as im:
         assert im.load()[90, 90][:3] == (0, 0, 0)
@@ -199,7 +200,7 @@ def test_horizontal_orientations():
         assert im.load()[90, 90][:3] == (0, 255, 0)
 
 
-def test_save_rle(tmp_path):
+def test_save_rle(tmp_path: Path) -> None:
     test_file = "Tests/images/rgb32rle.tga"
     with Image.open(test_file) as im:
         assert im.info["compression"] == "tga_rle"
@@ -232,7 +233,7 @@ def test_save_rle(tmp_path):
         assert test_im.info["compression"] == "tga_rle"
 
 
-def test_save_l_transparency(tmp_path):
+def test_save_l_transparency(tmp_path: Path) -> None:
     # There are 559 transparent pixels in la.tga.
     num_transparent = 559
 
diff --git a/Tests/test_file_tiff.py b/Tests/test_file_tiff.py
index f0995679b1f..a16b76e19f7 100644
--- a/Tests/test_file_tiff.py
+++ b/Tests/test_file_tiff.py
@@ -3,6 +3,7 @@
 import os
 import warnings
 from io import BytesIO
+from pathlib import Path
 
 import pytest
 
@@ -26,7 +27,7 @@
 
 
 class TestFileTiff:
-    def test_sanity(self, tmp_path):
+    def test_sanity(self, tmp_path: Path) -> None:
         filename = str(tmp_path / "temp.tif")
 
         hopper("RGB").save(filename)
@@ -58,21 +59,21 @@ def test_sanity(self, tmp_path):
             pass
 
     @pytest.mark.skipif(is_pypy(), reason="Requires CPython")
-    def test_unclosed_file(self):
-        def open():
+    def test_unclosed_file(self) -> None:
+        def open() -> None:
             im = Image.open("Tests/images/multipage.tiff")
             im.load()
 
         with pytest.warns(ResourceWarning):
             open()
 
-    def test_closed_file(self):
+    def test_closed_file(self) -> None:
         with warnings.catch_warnings():
             im = Image.open("Tests/images/multipage.tiff")
             im.load()
             im.close()
 
-    def test_seek_after_close(self):
+    def test_seek_after_close(self) -> None:
         im = Image.open("Tests/images/multipage.tiff")
         im.close()
 
@@ -81,12 +82,12 @@ def test_seek_after_close(self):
         with pytest.raises(ValueError):
             im.seek(1)
 
-    def test_context_manager(self):
+    def test_context_manager(self) -> None:
         with warnings.catch_warnings():
             with Image.open("Tests/images/multipage.tiff") as im:
                 im.load()
 
-    def test_mac_tiff(self):
+    def test_mac_tiff(self) -> None:
         # Read RGBa images from macOS [@PIL136]
 
         filename = "Tests/images/pil136.tiff"
@@ -98,7 +99,7 @@ def test_mac_tiff(self):
 
             assert_image_similar_tofile(im, "Tests/images/pil136.png", 1)
 
-    def test_bigtiff(self, tmp_path):
+    def test_bigtiff(self, tmp_path: Path) -> None:
         with Image.open("Tests/images/hopper_bigtiff.tif") as im:
             assert_image_equal_tofile(im, "Tests/images/hopper.tif")
 
@@ -109,13 +110,13 @@ def test_bigtiff(self, tmp_path):
             outfile = str(tmp_path / "temp.tif")
             im.save(outfile, save_all=True, append_images=[im], tiffinfo=im.tag_v2)
 
-    def test_set_legacy_api(self):
+    def test_set_legacy_api(self) -> None:
         ifd = TiffImagePlugin.ImageFileDirectory_v2()
         with pytest.raises(Exception) as e:
             ifd.legacy_api = None
         assert str(e.value) == "Not allowing setting of legacy api"
 
-    def test_xyres_tiff(self):
+    def test_xyres_tiff(self) -> None:
         filename = "Tests/images/pil168.tif"
         with Image.open(filename) as im:
             # legacy api
@@ -128,7 +129,7 @@ def test_xyres_tiff(self):
 
             assert im.info["dpi"] == (72.0, 72.0)
 
-    def test_xyres_fallback_tiff(self):
+    def test_xyres_fallback_tiff(self) -> None:
         filename = "Tests/images/compression.tif"
         with Image.open(filename) as im:
             # v2 api
@@ -142,7 +143,7 @@ def test_xyres_fallback_tiff(self):
             # Fallback "inch".
             assert im.info["dpi"] == (100.0, 100.0)
 
-    def test_int_resolution(self):
+    def test_int_resolution(self) -> None:
         filename = "Tests/images/pil168.tif"
         with Image.open(filename) as im:
             # Try to read a file where X,Y_RESOLUTION are ints
@@ -155,14 +156,14 @@ def test_int_resolution(self):
         "resolution_unit, dpi",
         [(None, 72.8), (2, 72.8), (3, 184.912)],
     )
-    def test_load_float_dpi(self, resolution_unit, dpi):
+    def test_load_float_dpi(self, resolution_unit, dpi) -> None:
         with Image.open(
             "Tests/images/hopper_float_dpi_" + str(resolution_unit) + ".tif"
         ) as im:
             assert im.tag_v2.get(RESOLUTION_UNIT) == resolution_unit
             assert im.info["dpi"] == (dpi, dpi)
 
-    def test_save_float_dpi(self, tmp_path):
+    def test_save_float_dpi(self, tmp_path: Path) -> None:
         outfile = str(tmp_path / "temp.tif")
         with Image.open("Tests/images/hopper.tif") as im:
             dpi = (72.2, 72.2)
@@ -171,7 +172,7 @@ def test_save_float_dpi(self, tmp_path):
             with Image.open(outfile) as reloaded:
                 assert reloaded.info["dpi"] == dpi
 
-    def test_save_setting_missing_resolution(self):
+    def test_save_setting_missing_resolution(self) -> None:
         b = BytesIO()
         with Image.open("Tests/images/10ct_32bit_128.tiff") as im:
             im.save(b, format="tiff", resolution=123.45)
@@ -179,7 +180,7 @@ def test_save_setting_missing_resolution(self):
             assert im.tag_v2[X_RESOLUTION] == 123.45
             assert im.tag_v2[Y_RESOLUTION] == 123.45
 
-    def test_invalid_file(self):
+    def test_invalid_file(self) -> None:
         invalid_file = "Tests/images/flower.jpg"
 
         with pytest.raises(SyntaxError):
@@ -190,30 +191,30 @@ def test_invalid_file(self):
             TiffImagePlugin.TiffImageFile(invalid_file)
         TiffImagePlugin.PREFIXES.pop()
 
-    def test_bad_exif(self):
+    def test_bad_exif(self) -> None:
         with Image.open("Tests/images/hopper_bad_exif.jpg") as i:
             # Should not raise struct.error.
             with pytest.warns(UserWarning):
                 i._getexif()
 
-    def test_save_rgba(self, tmp_path):
+    def test_save_rgba(self, tmp_path: Path) -> None:
         im = hopper("RGBA")
         outfile = str(tmp_path / "temp.tif")
         im.save(outfile)
 
-    def test_save_unsupported_mode(self, tmp_path):
+    def test_save_unsupported_mode(self, tmp_path: Path) -> None:
         im = hopper("HSV")
         outfile = str(tmp_path / "temp.tif")
         with pytest.raises(OSError):
             im.save(outfile)
 
-    def test_8bit_s(self):
+    def test_8bit_s(self) -> None:
         with Image.open("Tests/images/8bit.s.tif") as im:
             im.load()
             assert im.mode == "L"
             assert im.getpixel((50, 50)) == 184
 
-    def test_little_endian(self):
+    def test_little_endian(self) -> None:
         with Image.open("Tests/images/16bit.cropped.tif") as im:
             assert im.getpixel((0, 0)) == 480
             assert im.mode == "I;16"
@@ -223,7 +224,7 @@ def test_little_endian(self):
         assert b[0] == ord(b"\xe0")
         assert b[1] == ord(b"\x01")
 
-    def test_big_endian(self):
+    def test_big_endian(self) -> None:
         with Image.open("Tests/images/16bit.MM.cropped.tif") as im:
             assert im.getpixel((0, 0)) == 480
             assert im.mode == "I;16B"
@@ -233,7 +234,7 @@ def test_big_endian(self):
         assert b[0] == ord(b"\x01")
         assert b[1] == ord(b"\xe0")
 
-    def test_16bit_r(self):
+    def test_16bit_r(self) -> None:
         with Image.open("Tests/images/16bit.r.tif") as im:
             assert im.getpixel((0, 0)) == 480
             assert im.mode == "I;16"
@@ -242,14 +243,14 @@ def test_16bit_r(self):
         assert b[0] == ord(b"\xe0")
         assert b[1] == ord(b"\x01")
 
-    def test_16bit_s(self):
+    def test_16bit_s(self) -> None:
         with Image.open("Tests/images/16bit.s.tif") as im:
             im.load()
             assert im.mode == "I"
             assert im.getpixel((0, 0)) == 32767
             assert im.getpixel((0, 1)) == 0
 
-    def test_12bit_rawmode(self):
+    def test_12bit_rawmode(self) -> None:
         """Are we generating the same interpretation
         of the image as Imagemagick is?"""
 
@@ -262,7 +263,7 @@ def test_12bit_rawmode(self):
 
             assert_image_equal_tofile(im, "Tests/images/12in16bit.tif")
 
-    def test_32bit_float(self):
+    def test_32bit_float(self) -> None:
         # Issue 614, specific 32-bit float format
         path = "Tests/images/10ct_32bit_128.tiff"
         with Image.open(path) as im:
@@ -271,7 +272,7 @@ def test_32bit_float(self):
             assert im.getpixel((0, 0)) == -0.4526388943195343
             assert im.getextrema() == (-3.140936851501465, 3.140684127807617)
 
-    def test_unknown_pixel_mode(self):
+    def test_unknown_pixel_mode(self) -> None:
         with pytest.raises(OSError):
             with Image.open("Tests/images/hopper_unknown_pixel_mode.tif"):
                 pass
@@ -283,12 +284,12 @@ def test_unknown_pixel_mode(self):
             ("Tests/images/multipage.tiff", 3),
         ),
     )
-    def test_n_frames(self, path, n_frames):
+    def test_n_frames(self, path, n_frames) -> None:
         with Image.open(path) as im:
             assert im.n_frames == n_frames
             assert im.is_animated == (n_frames != 1)
 
-    def test_eoferror(self):
+    def test_eoferror(self) -> None:
         with Image.open("Tests/images/multipage-lastframe.tif") as im:
             n_frames = im.n_frames
 
@@ -300,7 +301,7 @@ def test_eoferror(self):
             # Test that seeking to the last frame does not raise an error
             im.seek(n_frames - 1)
 
-    def test_multipage(self):
+    def test_multipage(self) -> None:
         # issue #862
         with Image.open("Tests/images/multipage.tiff") as im:
             # file is a multipage tiff: 10x10 green, 10x10 red, 20x20 blue
@@ -324,13 +325,13 @@ def test_multipage(self):
             assert im.size == (20, 20)
             assert im.convert("RGB").getpixel((0, 0)) == (0, 0, 255)
 
-    def test_multipage_last_frame(self):
+    def test_multipage_last_frame(self) -> None:
         with Image.open("Tests/images/multipage-lastframe.tif") as im:
             im.load()
             assert im.size == (20, 20)
             assert im.convert("RGB").getpixel((0, 0)) == (0, 0, 255)
 
-    def test_frame_order(self):
+    def test_frame_order(self) -> None:
         # A frame can't progress to itself after reading
         with Image.open("Tests/images/multipage_single_frame_loop.tiff") as im:
             assert im.n_frames == 1
@@ -343,7 +344,7 @@ def test_frame_order(self):
         with Image.open("Tests/images/multipage_out_of_order.tiff") as im:
             assert im.n_frames == 3
 
-    def test___str__(self):
+    def test___str__(self) -> None:
         filename = "Tests/images/pil136.tiff"
         with Image.open(filename) as im:
             # Act
@@ -352,7 +353,7 @@ def test___str__(self):
             # Assert
             assert isinstance(ret, str)
 
-    def test_dict(self):
+    def test_dict(self) -> None:
         # Arrange
         filename = "Tests/images/pil136.tiff"
         with Image.open(filename) as im:
@@ -392,7 +393,7 @@ def test_dict(self):
             }
             assert dict(im.tag) == legacy_tags
 
-    def test__delitem__(self):
+    def test__delitem__(self) -> None:
         filename = "Tests/images/pil136.tiff"
         with Image.open(filename) as im:
             len_before = len(dict(im.ifd))
@@ -401,36 +402,36 @@ def test__delitem__(self):
             assert len_before == len_after + 1
 
     @pytest.mark.parametrize("legacy_api", (False, True))
-    def test_load_byte(self, legacy_api):
+    def test_load_byte(self, legacy_api) -> None:
         ifd = TiffImagePlugin.ImageFileDirectory_v2()
         data = b"abc"
         ret = ifd.load_byte(data, legacy_api)
         assert ret == b"abc"
 
-    def test_load_string(self):
+    def test_load_string(self) -> None:
         ifd = TiffImagePlugin.ImageFileDirectory_v2()
         data = b"abc\0"
         ret = ifd.load_string(data, False)
         assert ret == "abc"
 
-    def test_load_float(self):
+    def test_load_float(self) -> None:
         ifd = TiffImagePlugin.ImageFileDirectory_v2()
         data = b"abcdabcd"
         ret = ifd.load_float(data, False)
         assert ret == (1.6777999408082104e22, 1.6777999408082104e22)
 
-    def test_load_double(self):
+    def test_load_double(self) -> None:
         ifd = TiffImagePlugin.ImageFileDirectory_v2()
         data = b"abcdefghabcdefgh"
         ret = ifd.load_double(data, False)
         assert ret == (8.540883223036124e194, 8.540883223036124e194)
 
-    def test_ifd_tag_type(self):
+    def test_ifd_tag_type(self) -> None:
         with Image.open("Tests/images/ifd_tag_type.tiff") as im:
             assert 0x8825 in im.tag_v2
 
-    def test_exif(self, tmp_path):
-        def check_exif(exif):
+    def test_exif(self, tmp_path: Path) -> None:
+        def check_exif(exif) -> None:
             assert sorted(exif.keys()) == [
                 256,
                 257,
@@ -481,7 +482,7 @@ def check_exif(exif):
             exif = im.getexif()
             check_exif(exif)
 
-    def test_modify_exif(self, tmp_path):
+    def test_modify_exif(self, tmp_path: Path) -> None:
         outfile = str(tmp_path / "temp.tif")
         with Image.open("Tests/images/ifd_tag_type.tiff") as im:
             exif = im.getexif()
@@ -493,7 +494,7 @@ def test_modify_exif(self, tmp_path):
             exif = im.getexif()
             assert exif[264] == 100
 
-    def test_reload_exif_after_seek(self):
+    def test_reload_exif_after_seek(self) -> None:
         with Image.open("Tests/images/multipage.tiff") as im:
             exif = im.getexif()
             del exif[256]
@@ -501,7 +502,7 @@ def test_reload_exif_after_seek(self):
 
             assert 256 in exif
 
-    def test_exif_frames(self):
+    def test_exif_frames(self) -> None:
         # Test that EXIF data can change across frames
         with Image.open("Tests/images/g4-multi.tiff") as im:
             assert im.getexif()[273] == (328, 815)
@@ -510,7 +511,7 @@ def test_exif_frames(self):
             assert im.getexif()[273] == (1408, 1907)
 
     @pytest.mark.parametrize("mode", ("1", "L"))
-    def test_photometric(self, mode, tmp_path):
+    def test_photometric(self, mode, tmp_path: Path) -> None:
         filename = str(tmp_path / "temp.tif")
         im = hopper(mode)
         im.save(filename, tiffinfo={262: 0})
@@ -518,13 +519,13 @@ def test_photometric(self, mode, tmp_path):
             assert reloaded.tag_v2[262] == 0
             assert_image_equal(im, reloaded)
 
-    def test_seek(self):
+    def test_seek(self) -> None:
         filename = "Tests/images/pil136.tiff"
         with Image.open(filename) as im:
             im.seek(0)
             assert im.tell() == 0
 
-    def test_seek_eof(self):
+    def test_seek_eof(self) -> None:
         filename = "Tests/images/pil136.tiff"
         with Image.open(filename) as im:
             assert im.tell() == 0
@@ -533,21 +534,21 @@ def test_seek_eof(self):
             with pytest.raises(EOFError):
                 im.seek(1)
 
-    def test__limit_rational_int(self):
+    def test__limit_rational_int(self) -> None:
         from PIL.TiffImagePlugin import _limit_rational
 
         value = 34
         ret = _limit_rational(value, 65536)
         assert ret == (34, 1)
 
-    def test__limit_rational_float(self):
+    def test__limit_rational_float(self) -> None:
         from PIL.TiffImagePlugin import _limit_rational
 
         value = 22.3
         ret = _limit_rational(value, 65536)
         assert ret == (223, 10)
 
-    def test_4bit(self):
+    def test_4bit(self) -> None:
         test_file = "Tests/images/hopper_gray_4bpp.tif"
         original = hopper("L")
         with Image.open(test_file) as im:
@@ -555,7 +556,7 @@ def test_4bit(self):
             assert im.mode == "L"
             assert_image_similar(im, original, 7.3)
 
-    def test_gray_semibyte_per_pixel(self):
+    def test_gray_semibyte_per_pixel(self) -> None:
         test_files = (
             (
                 24.8,  # epsilon
@@ -588,7 +589,7 @@ def test_gray_semibyte_per_pixel(self):
                         assert im2.mode == "L"
                         assert_image_equal(im, im2)
 
-    def test_with_underscores(self, tmp_path):
+    def test_with_underscores(self, tmp_path: Path) -> None:
         kwargs = {"resolution_unit": "inch", "x_resolution": 72, "y_resolution": 36}
         filename = str(tmp_path / "temp.tif")
         hopper("RGB").save(filename, **kwargs)
@@ -601,7 +602,7 @@ def test_with_underscores(self, tmp_path):
             assert im.tag_v2[X_RESOLUTION] == 72
             assert im.tag_v2[Y_RESOLUTION] == 36
 
-    def test_roundtrip_tiff_uint16(self, tmp_path):
+    def test_roundtrip_tiff_uint16(self, tmp_path: Path) -> None:
         # Test an image of all '0' values
         pixel_value = 0x1234
         infile = "Tests/images/uint16_1_4660.tif"
@@ -613,7 +614,7 @@ def test_roundtrip_tiff_uint16(self, tmp_path):
 
             assert_image_equal_tofile(im, tmpfile)
 
-    def test_rowsperstrip(self, tmp_path):
+    def test_rowsperstrip(self, tmp_path: Path) -> None:
         outfile = str(tmp_path / "temp.tif")
         im = hopper()
         im.save(outfile, tiffinfo={278: 256})
@@ -621,25 +622,25 @@ def test_rowsperstrip(self, tmp_path):
         with Image.open(outfile) as im:
             assert im.tag_v2[278] == 256
 
-    def test_strip_raw(self):
+    def test_strip_raw(self) -> None:
         infile = "Tests/images/tiff_strip_raw.tif"
         with Image.open(infile) as im:
             assert_image_equal_tofile(im, "Tests/images/tiff_adobe_deflate.png")
 
-    def test_strip_planar_raw(self):
+    def test_strip_planar_raw(self) -> None:
         # gdal_translate -of GTiff -co INTERLEAVE=BAND \
         # tiff_strip_raw.tif tiff_strip_planar_raw.tiff
         infile = "Tests/images/tiff_strip_planar_raw.tif"
         with Image.open(infile) as im:
             assert_image_equal_tofile(im, "Tests/images/tiff_adobe_deflate.png")
 
-    def test_strip_planar_raw_with_overviews(self):
+    def test_strip_planar_raw_with_overviews(self) -> None:
         # gdaladdo tiff_strip_planar_raw2.tif 2 4 8 16
         infile = "Tests/images/tiff_strip_planar_raw_with_overviews.tif"
         with Image.open(infile) as im:
             assert_image_equal_tofile(im, "Tests/images/tiff_adobe_deflate.png")
 
-    def test_tiled_planar_raw(self):
+    def test_tiled_planar_raw(self) -> None:
         # gdal_translate -of GTiff -co TILED=YES -co BLOCKXSIZE=32 \
         # -co BLOCKYSIZE=32 -co INTERLEAVE=BAND \
         # tiff_tiled_raw.tif tiff_tiled_planar_raw.tiff
@@ -647,7 +648,7 @@ def test_tiled_planar_raw(self):
         with Image.open(infile) as im:
             assert_image_equal_tofile(im, "Tests/images/tiff_adobe_deflate.png")
 
-    def test_planar_configuration_save(self, tmp_path):
+    def test_planar_configuration_save(self, tmp_path: Path) -> None:
         infile = "Tests/images/tiff_tiled_planar_raw.tif"
         with Image.open(infile) as im:
             assert im._planar_configuration == 2
@@ -659,7 +660,7 @@ def test_planar_configuration_save(self, tmp_path):
                 assert_image_equal_tofile(reloaded, infile)
 
     @pytest.mark.parametrize("mode", ("P", "PA"))
-    def test_palette(self, mode, tmp_path):
+    def test_palette(self, mode, tmp_path: Path) -> None:
         outfile = str(tmp_path / "temp.tif")
 
         im = hopper(mode)
@@ -668,7 +669,7 @@ def test_palette(self, mode, tmp_path):
         with Image.open(outfile) as reloaded:
             assert_image_equal(im.convert("RGB"), reloaded.convert("RGB"))
 
-    def test_tiff_save_all(self):
+    def test_tiff_save_all(self) -> None:
         mp = BytesIO()
         with Image.open("Tests/images/multipage.tiff") as im:
             im.save(mp, format="tiff", save_all=True)
@@ -698,7 +699,7 @@ def im_generator(ims):
         with Image.open(mp) as reread:
             assert reread.n_frames == 3
 
-    def test_saving_icc_profile(self, tmp_path):
+    def test_saving_icc_profile(self, tmp_path: Path) -> None:
         # Tests saving TIFF with icc_profile set.
         # At the time of writing this will only work for non-compressed tiffs
         # as libtiff does not support embedded ICC profiles,
@@ -712,7 +713,7 @@ def test_saving_icc_profile(self, tmp_path):
         with Image.open(tmpfile) as reloaded:
             assert b"Dummy value" == reloaded.info["icc_profile"]
 
-    def test_save_icc_profile(self, tmp_path):
+    def test_save_icc_profile(self, tmp_path: Path) -> None:
         im = hopper()
         assert "icc_profile" not in im.info
 
@@ -723,14 +724,14 @@ def test_save_icc_profile(self, tmp_path):
         with Image.open(outfile) as reloaded:
             assert reloaded.info["icc_profile"] == icc_profile
 
-    def test_save_bmp_compression(self, tmp_path):
+    def test_save_bmp_compression(self, tmp_path: Path) -> None:
         with Image.open("Tests/images/hopper.bmp") as im:
             assert im.info["compression"] == 0
 
             outfile = str(tmp_path / "temp.tif")
             im.save(outfile)
 
-    def test_discard_icc_profile(self, tmp_path):
+    def test_discard_icc_profile(self, tmp_path: Path) -> None:
         outfile = str(tmp_path / "temp.tif")
 
         with Image.open("Tests/images/icc_profile.png") as im:
@@ -741,7 +742,7 @@ def test_discard_icc_profile(self, tmp_path):
         with Image.open(outfile) as reloaded:
             assert "icc_profile" not in reloaded.info
 
-    def test_getxmp(self):
+    def test_getxmp(self) -> None:
         with Image.open("Tests/images/lab.tif") as im:
             if ElementTree is None:
                 with pytest.warns(
@@ -756,7 +757,7 @@ def test_getxmp(self):
                 assert description[0]["format"] == "image/tiff"
                 assert description[3]["BitsPerSample"]["Seq"]["li"] == ["8", "8", "8"]
 
-    def test_get_photoshop_blocks(self):
+    def test_get_photoshop_blocks(self) -> None:
         with Image.open("Tests/images/lab.tif") as im:
             assert list(im.get_photoshop_blocks().keys()) == [
                 1061,
@@ -782,7 +783,7 @@ def test_get_photoshop_blocks(self):
                 4001,
             ]
 
-    def test_tiff_chunks(self, tmp_path):
+    def test_tiff_chunks(self, tmp_path: Path) -> None:
         tmpfile = str(tmp_path / "temp.tif")
 
         im = hopper()
@@ -803,7 +804,7 @@ def test_tiff_chunks(self, tmp_path):
 
         assert_image_equal_tofile(im, tmpfile)
 
-    def test_close_on_load_exclusive(self, tmp_path):
+    def test_close_on_load_exclusive(self, tmp_path: Path) -> None:
         # similar to test_fd_leak, but runs on unixlike os
         tmpfile = str(tmp_path / "temp.tif")
 
@@ -816,7 +817,7 @@ def test_close_on_load_exclusive(self, tmp_path):
         im.load()
         assert fp.closed
 
-    def test_close_on_load_nonexclusive(self, tmp_path):
+    def test_close_on_load_nonexclusive(self, tmp_path: Path) -> None:
         tmpfile = str(tmp_path / "temp.tif")
 
         with Image.open("Tests/images/uint16_1_4660.tif") as im:
@@ -838,7 +839,7 @@ def test_close_on_load_nonexclusive(self, tmp_path):
         not os.path.exists("Tests/images/string_dimension.tiff"),
         reason="Extra image files not installed",
     )
-    def test_string_dimension(self):
+    def test_string_dimension(self) -> None:
         # Assert that an error is raised if one of the dimensions is a string
         with Image.open("Tests/images/string_dimension.tiff") as im:
             with pytest.raises(OSError):
@@ -846,7 +847,7 @@ def test_string_dimension(self):
 
     @pytest.mark.timeout(6)
     @pytest.mark.filterwarnings("ignore:Truncated File Read")
-    def test_timeout(self):
+    def test_timeout(self) -> None:
         with Image.open("Tests/images/timeout-6646305047838720") as im:
             ImageFile.LOAD_TRUNCATED_IMAGES = True
             im.load()
@@ -859,7 +860,7 @@ def test_timeout(self):
         ],
     )
     @pytest.mark.timeout(2)
-    def test_oom(self, test_file):
+    def test_oom(self, test_file) -> None:
         with pytest.raises(UnidentifiedImageError):
             with pytest.warns(UserWarning):
                 with Image.open(test_file):
@@ -868,7 +869,7 @@ def test_oom(self, test_file):
 
 @pytest.mark.skipif(not is_win32(), reason="Windows only")
 class TestFileTiffW32:
-    def test_fd_leak(self, tmp_path):
+    def test_fd_leak(self, tmp_path: Path) -> None:
         tmpfile = str(tmp_path / "temp.tif")
 
         # this is an mmaped file.
diff --git a/Tests/test_file_tiff_metadata.py b/Tests/test_file_tiff_metadata.py
index 06689bc9092..bb6225d075b 100644
--- a/Tests/test_file_tiff_metadata.py
+++ b/Tests/test_file_tiff_metadata.py
@@ -2,6 +2,7 @@
 
 import io
 import struct
+from pathlib import Path
 
 import pytest
 
@@ -13,7 +14,7 @@
 TAG_IDS = {info.name: info.value for info in TiffTags.TAGS_V2.values()}
 
 
-def test_rt_metadata(tmp_path):
+def test_rt_metadata(tmp_path: Path) -> None:
     """Test writing arbitrary metadata into the tiff image directory
     Use case is ImageJ private tags, one numeric, one arbitrary
     data.  https://github.com/python-pillow/Pillow/issues/291
@@ -79,7 +80,7 @@ def test_rt_metadata(tmp_path):
         assert loaded.tag_v2[ImageJMetaDataByteCounts] == (8, len(bin_data) - 8)
 
 
-def test_read_metadata():
+def test_read_metadata() -> None:
     with Image.open("Tests/images/hopper_g4.tif") as img:
         assert {
             "YResolution": IFDRational(4294967295, 113653537),
@@ -120,7 +121,7 @@ def test_read_metadata():
         } == img.tag.named()
 
 
-def test_write_metadata(tmp_path):
+def test_write_metadata(tmp_path: Path) -> None:
     """Test metadata writing through the python code"""
     with Image.open("Tests/images/hopper.tif") as img:
         f = str(tmp_path / "temp.tiff")
@@ -157,7 +158,7 @@ def test_write_metadata(tmp_path):
             assert value == reloaded[tag], f"{tag} didn't roundtrip"
 
 
-def test_change_stripbytecounts_tag_type(tmp_path):
+def test_change_stripbytecounts_tag_type(tmp_path: Path) -> None:
     out = str(tmp_path / "temp.tiff")
     with Image.open("Tests/images/hopper.tif") as im:
         info = im.tag_v2
@@ -176,19 +177,19 @@ def test_change_stripbytecounts_tag_type(tmp_path):
         assert reloaded.tag_v2.tagtype[TiffImagePlugin.STRIPBYTECOUNTS] == TiffTags.LONG
 
 
-def test_no_duplicate_50741_tag():
+def test_no_duplicate_50741_tag() -> None:
     assert TAG_IDS["MakerNoteSafety"] == 50741
     assert TAG_IDS["BestQualityScale"] == 50780
 
 
-def test_iptc(tmp_path):
+def test_iptc(tmp_path: Path) -> None:
     out = str(tmp_path / "temp.tiff")
     with Image.open("Tests/images/hopper.Lab.tif") as im:
         im.save(out)
 
 
 @pytest.mark.parametrize("value, expected", ((b"test", "test"), (1, "1")))
-def test_writing_other_types_to_ascii(value, expected, tmp_path):
+def test_writing_other_types_to_ascii(value, expected, tmp_path: Path) -> None:
     info = TiffImagePlugin.ImageFileDirectory_v2()
 
     tag = TiffTags.TAGS_V2[271]
@@ -205,7 +206,7 @@ def test_writing_other_types_to_ascii(value, expected, tmp_path):
 
 
 @pytest.mark.parametrize("value", (1, IFDRational(1)))
-def test_writing_other_types_to_bytes(value, tmp_path):
+def test_writing_other_types_to_bytes(value, tmp_path: Path) -> None:
     im = hopper()
     info = TiffImagePlugin.ImageFileDirectory_v2()
 
@@ -221,7 +222,7 @@ def test_writing_other_types_to_bytes(value, tmp_path):
         assert reloaded.tag_v2[700] == b"\x01"
 
 
-def test_writing_other_types_to_undefined(tmp_path):
+def test_writing_other_types_to_undefined(tmp_path: Path) -> None:
     im = hopper()
     info = TiffImagePlugin.ImageFileDirectory_v2()
 
@@ -237,7 +238,7 @@ def test_writing_other_types_to_undefined(tmp_path):
         assert reloaded.tag_v2[33723] == b"1"
 
 
-def test_undefined_zero(tmp_path):
+def test_undefined_zero(tmp_path: Path) -> None:
     # Check that the tag has not been changed since this test was created
     tag = TiffTags.TAGS_V2[45059]
     assert tag.type == TiffTags.UNDEFINED
@@ -252,7 +253,7 @@ def test_undefined_zero(tmp_path):
     assert info[45059] == original
 
 
-def test_empty_metadata():
+def test_empty_metadata() -> None:
     f = io.BytesIO(b"II*\x00\x08\x00\x00\x00")
     head = f.read(8)
     info = TiffImagePlugin.ImageFileDirectory(head)
@@ -261,7 +262,7 @@ def test_empty_metadata():
         info.load(f)
 
 
-def test_iccprofile(tmp_path):
+def test_iccprofile(tmp_path: Path) -> None:
     # https://github.com/python-pillow/Pillow/issues/1462
     out = str(tmp_path / "temp.tiff")
     with Image.open("Tests/images/hopper.iccprofile.tif") as im:
@@ -272,7 +273,7 @@ def test_iccprofile(tmp_path):
         assert im.info["icc_profile"] == reloaded.info["icc_profile"]
 
 
-def test_iccprofile_binary():
+def test_iccprofile_binary() -> None:
     # https://github.com/python-pillow/Pillow/issues/1526
     # We should be able to load this,
     # but probably won't be able to save it.
@@ -282,19 +283,19 @@ def test_iccprofile_binary():
         assert im.info["icc_profile"]
 
 
-def test_iccprofile_save_png(tmp_path):
+def test_iccprofile_save_png(tmp_path: Path) -> None:
     with Image.open("Tests/images/hopper.iccprofile.tif") as im:
         outfile = str(tmp_path / "temp.png")
         im.save(outfile)
 
 
-def test_iccprofile_binary_save_png(tmp_path):
+def test_iccprofile_binary_save_png(tmp_path: Path) -> None:
     with Image.open("Tests/images/hopper.iccprofile_binary.tif") as im:
         outfile = str(tmp_path / "temp.png")
         im.save(outfile)
 
 
-def test_exif_div_zero(tmp_path):
+def test_exif_div_zero(tmp_path: Path) -> None:
     im = hopper()
     info = TiffImagePlugin.ImageFileDirectory_v2()
     info[41988] = TiffImagePlugin.IFDRational(0, 0)
@@ -307,7 +308,7 @@ def test_exif_div_zero(tmp_path):
         assert 0 == reloaded.tag_v2[41988].denominator
 
 
-def test_ifd_unsigned_rational(tmp_path):
+def test_ifd_unsigned_rational(tmp_path: Path) -> None:
     im = hopper()
     info = TiffImagePlugin.ImageFileDirectory_v2()
 
@@ -338,7 +339,7 @@ def test_ifd_unsigned_rational(tmp_path):
         assert 1 == reloaded.tag_v2[41493].denominator
 
 
-def test_ifd_signed_rational(tmp_path):
+def test_ifd_signed_rational(tmp_path: Path) -> None:
     im = hopper()
     info = TiffImagePlugin.ImageFileDirectory_v2()
 
@@ -381,7 +382,7 @@ def test_ifd_signed_rational(tmp_path):
         assert -1 == reloaded.tag_v2[37380].denominator
 
 
-def test_ifd_signed_long(tmp_path):
+def test_ifd_signed_long(tmp_path: Path) -> None:
     im = hopper()
     info = TiffImagePlugin.ImageFileDirectory_v2()
 
@@ -394,7 +395,7 @@ def test_ifd_signed_long(tmp_path):
         assert reloaded.tag_v2[37000] == -60000
 
 
-def test_empty_values():
+def test_empty_values() -> None:
     data = io.BytesIO(
         b"II*\x00\x08\x00\x00\x00\x03\x00\x1a\x01\x05\x00\x00\x00\x00\x00"
         b"\x00\x00\x00\x00\x1b\x01\x05\x00\x00\x00\x00\x00\x00\x00\x00\x00"
@@ -409,7 +410,7 @@ def test_empty_values():
     assert 33432 in info
 
 
-def test_photoshop_info(tmp_path):
+def test_photoshop_info(tmp_path: Path) -> None:
     with Image.open("Tests/images/issue_2278.tif") as im:
         assert len(im.tag_v2[34377]) == 70
         assert isinstance(im.tag_v2[34377], bytes)
@@ -420,7 +421,7 @@ def test_photoshop_info(tmp_path):
         assert isinstance(reloaded.tag_v2[34377], bytes)
 
 
-def test_too_many_entries():
+def test_too_many_entries() -> None:
     ifd = TiffImagePlugin.ImageFileDirectory_v2()
 
     #    277: ("SamplesPerPixel", SHORT, 1),
@@ -432,7 +433,7 @@ def test_too_many_entries():
         assert ifd[277] == 4
 
 
-def test_tag_group_data():
+def test_tag_group_data() -> None:
     base_ifd = TiffImagePlugin.ImageFileDirectory_v2()
     interop_ifd = TiffImagePlugin.ImageFileDirectory_v2(group=40965)
     for ifd in (base_ifd, interop_ifd):
@@ -446,7 +447,7 @@ def test_tag_group_data():
     assert base_ifd.tagtype[2] != interop_ifd.tagtype[256]
 
 
-def test_empty_subifd(tmp_path):
+def test_empty_subifd(tmp_path: Path) -> None:
     out = str(tmp_path / "temp.jpg")
 
     im = hopper()
diff --git a/Tests/test_file_webp.py b/Tests/test_file_webp.py
index c49418ce3c5..249846da481 100644
--- a/Tests/test_file_webp.py
+++ b/Tests/test_file_webp.py
@@ -4,6 +4,7 @@
 import re
 import sys
 import warnings
+from pathlib import Path
 
 import pytest
 
@@ -26,7 +27,7 @@
 
 
 class TestUnsupportedWebp:
-    def test_unsupported(self):
+    def test_unsupported(self) -> None:
         if HAVE_WEBP:
             WebPImagePlugin.SUPPORTED = False
 
@@ -42,15 +43,15 @@ def test_unsupported(self):
 
 @skip_unless_feature("webp")
 class TestFileWebp:
-    def setup_method(self):
+    def setup_method(self) -> None:
         self.rgb_mode = "RGB"
 
-    def test_version(self):
+    def test_version(self) -> None:
         _webp.WebPDecoderVersion()
         _webp.WebPDecoderBuggyAlpha()
         assert re.search(r"\d+\.\d+\.\d+$", features.version_module("webp"))
 
-    def test_read_rgb(self):
+    def test_read_rgb(self) -> None:
         """
         Can we read a RGB mode WebP file without error?
         Does it have the bits we expect?
@@ -67,7 +68,7 @@ def test_read_rgb(self):
             # dwebp -ppm ../../Tests/images/hopper.webp -o hopper_webp_bits.ppm
             assert_image_similar_tofile(image, "Tests/images/hopper_webp_bits.ppm", 1.0)
 
-    def _roundtrip(self, tmp_path, mode, epsilon, args={}):
+    def _roundtrip(self, tmp_path: Path, mode, epsilon, args={}) -> None:
         temp_file = str(tmp_path / "temp.webp")
 
         hopper(mode).save(temp_file, **args)
@@ -93,7 +94,7 @@ def _roundtrip(self, tmp_path, mode, epsilon, args={}):
                 target = target.convert(self.rgb_mode)
             assert_image_similar(image, target, epsilon)
 
-    def test_write_rgb(self, tmp_path):
+    def test_write_rgb(self, tmp_path: Path) -> None:
         """
         Can we write a RGB mode file to webp without error?
         Does it have the bits we expect?
@@ -101,7 +102,7 @@ def test_write_rgb(self, tmp_path):
 
         self._roundtrip(tmp_path, self.rgb_mode, 12.5)
 
-    def test_write_method(self, tmp_path):
+    def test_write_method(self, tmp_path: Path) -> None:
         self._roundtrip(tmp_path, self.rgb_mode, 12.0, {"method": 6})
 
         buffer_no_args = io.BytesIO()
@@ -112,7 +113,7 @@ def test_write_method(self, tmp_path):
         assert buffer_no_args.getbuffer() != buffer_method.getbuffer()
 
     @skip_unless_feature("webp_anim")
-    def test_save_all(self, tmp_path):
+    def test_save_all(self, tmp_path: Path) -> None:
         temp_file = str(tmp_path / "temp.webp")
         im = Image.new("RGB", (1, 1))
         im2 = Image.new("RGB", (1, 1), "#f00")
@@ -124,14 +125,14 @@ def test_save_all(self, tmp_path):
             reloaded.seek(1)
             assert_image_similar(im2, reloaded, 1)
 
-    def test_icc_profile(self, tmp_path):
+    def test_icc_profile(self, tmp_path: Path) -> None:
         self._roundtrip(tmp_path, self.rgb_mode, 12.5, {"icc_profile": None})
         if _webp.HAVE_WEBPANIM:
             self._roundtrip(
                 tmp_path, self.rgb_mode, 12.5, {"icc_profile": None, "save_all": True}
             )
 
-    def test_write_unsupported_mode_L(self, tmp_path):
+    def test_write_unsupported_mode_L(self, tmp_path: Path) -> None:
         """
         Saving a black-and-white file to WebP format should work, and be
         similar to the original file.
@@ -139,7 +140,7 @@ def test_write_unsupported_mode_L(self, tmp_path):
 
         self._roundtrip(tmp_path, "L", 10.0)
 
-    def test_write_unsupported_mode_P(self, tmp_path):
+    def test_write_unsupported_mode_P(self, tmp_path: Path) -> None:
         """
         Saving a palette-based file to WebP format should work, and be
         similar to the original file.
@@ -148,14 +149,14 @@ def test_write_unsupported_mode_P(self, tmp_path):
         self._roundtrip(tmp_path, "P", 50.0)
 
     @pytest.mark.skipif(sys.maxsize <= 2**32, reason="Requires 64-bit system")
-    def test_write_encoding_error_message(self, tmp_path):
+    def test_write_encoding_error_message(self, tmp_path: Path) -> None:
         temp_file = str(tmp_path / "temp.webp")
         im = Image.new("RGB", (15000, 15000))
         with pytest.raises(ValueError) as e:
             im.save(temp_file, method=0)
         assert str(e.value) == "encoding error 6"
 
-    def test_WebPEncode_with_invalid_args(self):
+    def test_WebPEncode_with_invalid_args(self) -> None:
         """
         Calling encoder functions with no arguments should result in an error.
         """
@@ -166,7 +167,7 @@ def test_WebPEncode_with_invalid_args(self):
         with pytest.raises(TypeError):
             _webp.WebPEncode()
 
-    def test_WebPDecode_with_invalid_args(self):
+    def test_WebPDecode_with_invalid_args(self) -> None:
         """
         Calling decoder functions with no arguments should result in an error.
         """
@@ -177,14 +178,14 @@ def test_WebPDecode_with_invalid_args(self):
         with pytest.raises(TypeError):
             _webp.WebPDecode()
 
-    def test_no_resource_warning(self, tmp_path):
+    def test_no_resource_warning(self, tmp_path: Path) -> None:
         file_path = "Tests/images/hopper.webp"
         with Image.open(file_path) as image:
             temp_file = str(tmp_path / "temp.webp")
             with warnings.catch_warnings():
                 image.save(temp_file)
 
-    def test_file_pointer_could_be_reused(self):
+    def test_file_pointer_could_be_reused(self) -> None:
         file_path = "Tests/images/hopper.webp"
         with open(file_path, "rb") as blob:
             Image.open(blob).load()
@@ -195,14 +196,14 @@ def test_file_pointer_could_be_reused(self):
         (0, (0,), (-1, 0, 1, 2), (253, 254, 255, 256)),
     )
     @skip_unless_feature("webp_anim")
-    def test_invalid_background(self, background, tmp_path):
+    def test_invalid_background(self, background, tmp_path: Path) -> None:
         temp_file = str(tmp_path / "temp.webp")
         im = hopper()
         with pytest.raises(OSError):
             im.save(temp_file, save_all=True, append_images=[im], background=background)
 
     @skip_unless_feature("webp_anim")
-    def test_background_from_gif(self, tmp_path):
+    def test_background_from_gif(self, tmp_path: Path) -> None:
         # Save L mode GIF with background
         with Image.open("Tests/images/no_palette_with_background.gif") as im:
             out_webp = str(tmp_path / "temp.webp")
@@ -227,7 +228,7 @@ def test_background_from_gif(self, tmp_path):
         assert difference < 5
 
     @skip_unless_feature("webp_anim")
-    def test_duration(self, tmp_path):
+    def test_duration(self, tmp_path: Path) -> None:
         with Image.open("Tests/images/dispose_bgnd.gif") as im:
             assert im.info["duration"] == 1000
 
@@ -238,7 +239,7 @@ def test_duration(self, tmp_path):
             reloaded.load()
             assert reloaded.info["duration"] == 1000
 
-    def test_roundtrip_rgba_palette(self, tmp_path):
+    def test_roundtrip_rgba_palette(self, tmp_path: Path) -> None:
         temp_file = str(tmp_path / "temp.webp")
         im = Image.new("RGBA", (1, 1)).convert("P")
         assert im.mode == "P"
diff --git a/Tests/test_file_webp_alpha.py b/Tests/test_file_webp_alpha.py
index cfda35a0962..a95434624f5 100644
--- a/Tests/test_file_webp_alpha.py
+++ b/Tests/test_file_webp_alpha.py
@@ -1,5 +1,7 @@
 from __future__ import annotations
 
+from pathlib import Path
+
 import pytest
 
 from PIL import Image
@@ -14,12 +16,12 @@
 _webp = pytest.importorskip("PIL._webp", reason="WebP support not installed")
 
 
-def setup_module():
+def setup_module() -> None:
     if _webp.WebPDecoderBuggyAlpha():
         pytest.skip("Buggy early version of WebP installed, not testing transparency")
 
 
-def test_read_rgba():
+def test_read_rgba() -> None:
     """
     Can we read an RGBA mode file without error?
     Does it have the bits we expect?
@@ -39,7 +41,7 @@ def test_read_rgba():
         assert_image_similar_tofile(image, "Tests/images/transparent.png", 20.0)
 
 
-def test_write_lossless_rgb(tmp_path):
+def test_write_lossless_rgb(tmp_path: Path) -> None:
     """
     Can we write an RGBA mode file with lossless compression without error?
     Does it have the bits we expect?
@@ -68,7 +70,7 @@ def test_write_lossless_rgb(tmp_path):
         assert_image_equal(image, pil_image)
 
 
-def test_write_rgba(tmp_path):
+def test_write_rgba(tmp_path: Path) -> None:
     """
     Can we write a RGBA mode file to WebP without error.
     Does it have the bits we expect?
@@ -99,7 +101,7 @@ def test_write_rgba(tmp_path):
             assert_image_similar(image, pil_image, 1.0)
 
 
-def test_keep_rgb_values_when_transparent(tmp_path):
+def test_keep_rgb_values_when_transparent(tmp_path: Path) -> None:
     """
     Saving transparent pixels should retain their original RGB values
     when using the "exact" parameter.
@@ -128,7 +130,7 @@ def test_keep_rgb_values_when_transparent(tmp_path):
         assert_image_equal(reloaded.convert("RGB"), image)
 
 
-def test_write_unsupported_mode_PA(tmp_path):
+def test_write_unsupported_mode_PA(tmp_path: Path) -> None:
     """
     Saving a palette-based file with transparency to WebP format
     should work, and be similar to the original file.
diff --git a/Tests/test_file_webp_animated.py b/Tests/test_file_webp_animated.py
index 426fe7a0293..9a730f1f9bd 100644
--- a/Tests/test_file_webp_animated.py
+++ b/Tests/test_file_webp_animated.py
@@ -1,5 +1,7 @@
 from __future__ import annotations
 
+from pathlib import Path
+
 import pytest
 from packaging.version import parse as parse_version
 
@@ -18,7 +20,7 @@
 ]
 
 
-def test_n_frames():
+def test_n_frames() -> None:
     """Ensure that WebP format sets n_frames and is_animated attributes correctly."""
 
     with Image.open("Tests/images/hopper.webp") as im:
@@ -30,7 +32,7 @@ def test_n_frames():
         assert im.is_animated
 
 
-def test_write_animation_L(tmp_path):
+def test_write_animation_L(tmp_path: Path) -> None:
     """
     Convert an animated GIF to animated WebP, then compare the frame count, and first
     and last frames to ensure they're visually similar.
@@ -60,13 +62,13 @@ def test_write_animation_L(tmp_path):
             assert_image_similar(im, orig.convert("RGBA"), 32.9)
 
 
-def test_write_animation_RGB(tmp_path):
+def test_write_animation_RGB(tmp_path: Path) -> None:
     """
     Write an animated WebP from RGB frames, and ensure the frames
     are visually similar to the originals.
     """
 
-    def check(temp_file):
+    def check(temp_file) -> None:
         with Image.open(temp_file) as im:
             assert im.n_frames == 2
 
@@ -105,7 +107,7 @@ def im_generator(ims):
             check(temp_file2)
 
 
-def test_timestamp_and_duration(tmp_path):
+def test_timestamp_and_duration(tmp_path: Path) -> None:
     """
     Try passing a list of durations, and make sure the encoded
     timestamps and durations are correct.
@@ -136,7 +138,7 @@ def test_timestamp_and_duration(tmp_path):
             ts += durations[frame]
 
 
-def test_float_duration(tmp_path):
+def test_float_duration(tmp_path: Path) -> None:
     temp_file = str(tmp_path / "temp.webp")
     with Image.open("Tests/images/iss634.apng") as im:
         assert im.info["duration"] == 70.0
@@ -148,7 +150,7 @@ def test_float_duration(tmp_path):
         assert reloaded.info["duration"] == 70
 
 
-def test_seeking(tmp_path):
+def test_seeking(tmp_path: Path) -> None:
     """
     Create an animated WebP file, and then try seeking through frames in reverse-order,
     verifying the timestamps and durations are correct.
@@ -179,7 +181,7 @@ def test_seeking(tmp_path):
             ts -= dur
 
 
-def test_seek_errors():
+def test_seek_errors() -> None:
     with Image.open("Tests/images/iss634.webp") as im:
         with pytest.raises(EOFError):
             im.seek(-1)
diff --git a/Tests/test_file_webp_metadata.py b/Tests/test_file_webp_metadata.py
index deaf5e380db..fea19694109 100644
--- a/Tests/test_file_webp_metadata.py
+++ b/Tests/test_file_webp_metadata.py
@@ -1,6 +1,7 @@
 from __future__ import annotations
 
 from io import BytesIO
+from pathlib import Path
 
 import pytest
 
@@ -19,7 +20,7 @@
     ElementTree = None
 
 
-def test_read_exif_metadata():
+def test_read_exif_metadata() -> None:
     file_path = "Tests/images/flower.webp"
     with Image.open(file_path) as image:
         assert image.format == "WEBP"
@@ -37,7 +38,7 @@ def test_read_exif_metadata():
             assert exif_data == expected_exif
 
 
-def test_read_exif_metadata_without_prefix():
+def test_read_exif_metadata_without_prefix() -> None:
     with Image.open("Tests/images/flower2.webp") as im:
         # Assert prefix is not present
         assert im.info["exif"][:6] != b"Exif\x00\x00"
@@ -49,7 +50,7 @@ def test_read_exif_metadata_without_prefix():
 @mark_if_feature_version(
     pytest.mark.valgrind_known_error, "libjpeg_turbo", "2.0", reason="Known Failing"
 )
-def test_write_exif_metadata():
+def test_write_exif_metadata() -> None:
     file_path = "Tests/images/flower.jpg"
     test_buffer = BytesIO()
     with Image.open(file_path) as image:
@@ -63,7 +64,7 @@ def test_write_exif_metadata():
     assert webp_exif == expected_exif[6:], "WebP EXIF didn't match"
 
 
-def test_read_icc_profile():
+def test_read_icc_profile() -> None:
     file_path = "Tests/images/flower2.webp"
     with Image.open(file_path) as image:
         assert image.format == "WEBP"
@@ -80,7 +81,7 @@ def test_read_icc_profile():
 @mark_if_feature_version(
     pytest.mark.valgrind_known_error, "libjpeg_turbo", "2.0", reason="Known Failing"
 )
-def test_write_icc_metadata():
+def test_write_icc_metadata() -> None:
     file_path = "Tests/images/flower2.jpg"
     test_buffer = BytesIO()
     with Image.open(file_path) as image:
@@ -100,7 +101,7 @@ def test_write_icc_metadata():
 @mark_if_feature_version(
     pytest.mark.valgrind_known_error, "libjpeg_turbo", "2.0", reason="Known Failing"
 )
-def test_read_no_exif():
+def test_read_no_exif() -> None:
     file_path = "Tests/images/flower.jpg"
     test_buffer = BytesIO()
     with Image.open(file_path) as image:
@@ -113,7 +114,7 @@ def test_read_no_exif():
         assert not webp_image._getexif()
 
 
-def test_getxmp():
+def test_getxmp() -> None:
     with Image.open("Tests/images/flower.webp") as im:
         assert "xmp" not in im.info
         assert im.getxmp() == {}
@@ -133,7 +134,7 @@ def test_getxmp():
 
 
 @skip_unless_feature("webp_anim")
-def test_write_animated_metadata(tmp_path):
+def test_write_animated_metadata(tmp_path: Path) -> None:
     iccp_data = b"<iccp_data>"
     exif_data = b"<exif_data>"
     xmp_data = b"<xmp_data>"
diff --git a/Tests/test_file_wmf.py b/Tests/test_file_wmf.py
index 6e1d4c1361f..b43e3f2965f 100644
--- a/Tests/test_file_wmf.py
+++ b/Tests/test_file_wmf.py
@@ -1,5 +1,7 @@
 from __future__ import annotations
 
+from pathlib import Path
+
 import pytest
 
 from PIL import Image, WmfImagePlugin
@@ -7,7 +9,7 @@
 from .helper import assert_image_similar_tofile, hopper
 
 
-def test_load_raw():
+def test_load_raw() -> None:
     # Test basic EMF open and rendering
     with Image.open("Tests/images/drawing.emf") as im:
         if hasattr(Image.core, "drawwmf"):
@@ -25,17 +27,17 @@ def test_load_raw():
             assert_image_similar_tofile(im, "Tests/images/drawing_wmf_ref.png", 2.0)
 
 
-def test_load():
+def test_load() -> None:
     with Image.open("Tests/images/drawing.emf") as im:
         if hasattr(Image.core, "drawwmf"):
             assert im.load()[0, 0] == (255, 255, 255)
 
 
-def test_register_handler(tmp_path):
+def test_register_handler(tmp_path: Path) -> None:
     class TestHandler:
         methodCalled = False
 
-        def save(self, im, fp, filename):
+        def save(self, im, fp, filename) -> None:
             self.methodCalled = True
 
     handler = TestHandler()
@@ -51,12 +53,12 @@ def save(self, im, fp, filename):
     WmfImagePlugin.register_handler(original_handler)
 
 
-def test_load_float_dpi():
+def test_load_float_dpi() -> None:
     with Image.open("Tests/images/drawing.emf") as im:
         assert im.info["dpi"] == 1423.7668161434979
 
 
-def test_load_set_dpi():
+def test_load_set_dpi() -> None:
     with Image.open("Tests/images/drawing.wmf") as im:
         assert im.size == (82, 82)
 
@@ -68,7 +70,7 @@ def test_load_set_dpi():
 
 
 @pytest.mark.parametrize("ext", (".wmf", ".emf"))
-def test_save(ext, tmp_path):
+def test_save(ext, tmp_path: Path) -> None:
     im = hopper()
 
     tmpfile = str(tmp_path / ("temp" + ext))
diff --git a/Tests/test_file_xbm.py b/Tests/test_file_xbm.py
index 69a0a1b38d8..44dd2541fb5 100644
--- a/Tests/test_file_xbm.py
+++ b/Tests/test_file_xbm.py
@@ -1,6 +1,7 @@
 from __future__ import annotations
 
 from io import BytesIO
+from pathlib import Path
 
 import pytest
 
@@ -32,14 +33,14 @@
 """
 
 
-def test_pil151():
+def test_pil151() -> None:
     with Image.open(BytesIO(PIL151)) as im:
         im.load()
         assert im.mode == "1"
         assert im.size == (32, 32)
 
 
-def test_open():
+def test_open() -> None:
     # Arrange
     # Created with `convert hopper.png hopper.xbm`
     filename = "Tests/images/hopper.xbm"
@@ -51,7 +52,7 @@ def test_open():
         assert im.size == (128, 128)
 
 
-def test_open_filename_with_underscore():
+def test_open_filename_with_underscore() -> None:
     # Arrange
     # Created with `convert hopper.png hopper_underscore.xbm`
     filename = "Tests/images/hopper_underscore.xbm"
@@ -63,14 +64,14 @@ def test_open_filename_with_underscore():
         assert im.size == (128, 128)
 
 
-def test_invalid_file():
+def test_invalid_file() -> None:
     invalid_file = "Tests/images/flower.jpg"
 
     with pytest.raises(SyntaxError):
         XbmImagePlugin.XbmImageFile(invalid_file)
 
 
-def test_save_wrong_mode(tmp_path):
+def test_save_wrong_mode(tmp_path: Path) -> None:
     im = hopper()
     out = str(tmp_path / "temp.xbm")
 
@@ -78,7 +79,7 @@ def test_save_wrong_mode(tmp_path):
         im.save(out)
 
 
-def test_hotspot(tmp_path):
+def test_hotspot(tmp_path: Path) -> None:
     im = hopper("1")
     out = str(tmp_path / "temp.xbm")
 
diff --git a/Tests/test_format_hsv.py b/Tests/test_format_hsv.py
index 6395ae4aad8..73aaae6e757 100644
--- a/Tests/test_format_hsv.py
+++ b/Tests/test_format_hsv.py
@@ -21,7 +21,7 @@ def tuple_to_ints(tp):
     return int(x * 255.0), int(y * 255.0), int(z * 255.0)
 
 
-def test_sanity():
+def test_sanity() -> None:
     Image.new("HSV", (100, 100))
 
 
@@ -78,7 +78,7 @@ def to_rgb_colorsys(im):
     return to_xxx_colorsys(im, colorsys.hsv_to_rgb, "RGB")
 
 
-def test_wedge():
+def test_wedge() -> None:
     src = wedge().resize((3 * 32, 32), Image.Resampling.BILINEAR)
     im = src.convert("HSV")
     comparable = to_hsv_colorsys(src)
@@ -110,7 +110,7 @@ def test_wedge():
     )
 
 
-def test_convert():
+def test_convert() -> None:
     im = hopper("RGB").convert("HSV")
     comparable = to_hsv_colorsys(hopper("RGB"))
 
@@ -128,7 +128,7 @@ def test_convert():
     )
 
 
-def test_hsv_to_rgb():
+def test_hsv_to_rgb() -> None:
     comparable = to_hsv_colorsys(hopper("RGB"))
     converted = comparable.convert("RGB")
     comparable = to_rgb_colorsys(comparable)
diff --git a/Tests/test_image.py b/Tests/test_image.py
index dd989ad99b5..67a7d7eca54 100644
--- a/Tests/test_image.py
+++ b/Tests/test_image.py
@@ -7,6 +7,7 @@
 import sys
 import tempfile
 import warnings
+from pathlib import Path
 
 import pytest
 
@@ -60,19 +61,19 @@ class TestImage:
             "HSV",
         ),
     )
-    def test_image_modes_success(self, mode):
+    def test_image_modes_success(self, mode) -> None:
         Image.new(mode, (1, 1))
 
     @pytest.mark.parametrize("mode", ("", "bad", "very very long"))
-    def test_image_modes_fail(self, mode):
+    def test_image_modes_fail(self, mode) -> None:
         with pytest.raises(ValueError) as e:
             Image.new(mode, (1, 1))
         assert str(e.value) == "unrecognized image mode"
 
-    def test_exception_inheritance(self):
+    def test_exception_inheritance(self) -> None:
         assert issubclass(UnidentifiedImageError, OSError)
 
-    def test_sanity(self):
+    def test_sanity(self) -> None:
         im = Image.new("L", (100, 100))
         assert repr(im)[:45] == "<PIL.Image.Image image mode=L size=100x100 at"
         assert im.mode == "L"
@@ -97,9 +98,9 @@ def test_sanity(self):
         # with pytest.raises(MemoryError):
         #   Image.new("L", (1000000, 1000000))
 
-    def test_repr_pretty(self):
+    def test_repr_pretty(self) -> None:
         class Pretty:
-            def text(self, text):
+            def text(self, text) -> None:
                 self.pretty_output = text
 
         im = Image.new("L", (100, 100))
@@ -108,7 +109,7 @@ def text(self, text):
         im._repr_pretty_(p, None)
         assert p.pretty_output == "<PIL.Image.Image image mode=L size=100x100>"
 
-    def test_open_formats(self):
+    def test_open_formats(self) -> None:
         PNGFILE = "Tests/images/hopper.png"
         JPGFILE = "Tests/images/hopper.jpg"
 
@@ -130,7 +131,7 @@ def test_open_formats(self):
                 assert im.mode == "RGB"
                 assert im.size == (128, 128)
 
-    def test_width_height(self):
+    def test_width_height(self) -> None:
         im = Image.new("RGB", (1, 2))
         assert im.width == 1
         assert im.height == 2
@@ -138,29 +139,29 @@ def test_width_height(self):
         with pytest.raises(AttributeError):
             im.size = (3, 4)
 
-    def test_set_mode(self):
+    def test_set_mode(self) -> None:
         im = Image.new("RGB", (1, 1))
 
         with pytest.raises(AttributeError):
             im.mode = "P"
 
-    def test_invalid_image(self):
+    def test_invalid_image(self) -> None:
         im = io.BytesIO(b"")
         with pytest.raises(UnidentifiedImageError):
             with Image.open(im):
                 pass
 
-    def test_bad_mode(self):
+    def test_bad_mode(self) -> None:
         with pytest.raises(ValueError):
             with Image.open("filename", "bad mode"):
                 pass
 
-    def test_stringio(self):
+    def test_stringio(self) -> None:
         with pytest.raises(ValueError):
             with Image.open(io.StringIO()):
                 pass
 
-    def test_pathlib(self, tmp_path):
+    def test_pathlib(self, tmp_path: Path) -> None:
         from PIL.Image import Path
 
         with Image.open(Path("Tests/images/multipage-mmap.tiff")) as im:
@@ -179,11 +180,11 @@ def test_pathlib(self, tmp_path):
                     os.remove(temp_file)
                 im.save(Path(temp_file))
 
-    def test_fp_name(self, tmp_path):
+    def test_fp_name(self, tmp_path: Path) -> None:
         temp_file = str(tmp_path / "temp.jpg")
 
         class FP:
-            def write(self, b):
+            def write(self, b) -> None:
                 pass
 
         fp = FP()
@@ -192,7 +193,7 @@ def write(self, b):
         im = hopper()
         im.save(fp)
 
-    def test_tempfile(self):
+    def test_tempfile(self) -> None:
         # see #1460, pathlib support breaks tempfile.TemporaryFile on py27
         # Will error out on save on 3.0.0
         im = hopper()
@@ -201,13 +202,13 @@ def test_tempfile(self):
             fp.seek(0)
             assert_image_similar_tofile(im, fp, 20)
 
-    def test_unknown_extension(self, tmp_path):
+    def test_unknown_extension(self, tmp_path: Path) -> None:
         im = hopper()
         temp_file = str(tmp_path / "temp.unknown")
         with pytest.raises(ValueError):
             im.save(temp_file)
 
-    def test_internals(self):
+    def test_internals(self) -> None:
         im = Image.new("L", (100, 100))
         im.readonly = 1
         im._copy()
@@ -222,7 +223,7 @@ def test_internals(self):
         sys.platform == "cygwin",
         reason="Test requires opening an mmaped file for writing",
     )
-    def test_readonly_save(self, tmp_path):
+    def test_readonly_save(self, tmp_path: Path) -> None:
         temp_file = str(tmp_path / "temp.bmp")
         shutil.copy("Tests/images/rgb32bf-rgba.bmp", temp_file)
 
@@ -230,7 +231,7 @@ def test_readonly_save(self, tmp_path):
             assert im.readonly
             im.save(temp_file)
 
-    def test_dump(self, tmp_path):
+    def test_dump(self, tmp_path: Path) -> None:
         im = Image.new("L", (10, 10))
         im._dump(str(tmp_path / "temp_L.ppm"))
 
@@ -241,7 +242,7 @@ def test_dump(self, tmp_path):
         with pytest.raises(ValueError):
             im._dump(str(tmp_path / "temp_HSV.ppm"))
 
-    def test_comparison_with_other_type(self):
+    def test_comparison_with_other_type(self) -> None:
         # Arrange
         item = Image.new("RGB", (25, 25), "#000")
         num = 12
@@ -251,7 +252,7 @@ def test_comparison_with_other_type(self):
         assert item is not None
         assert item != num
 
-    def test_expand_x(self):
+    def test_expand_x(self) -> None:
         # Arrange
         im = hopper()
         orig_size = im.size
@@ -264,7 +265,7 @@ def test_expand_x(self):
         assert im.size[0] == orig_size[0] + 2 * xmargin
         assert im.size[1] == orig_size[1] + 2 * xmargin
 
-    def test_expand_xy(self):
+    def test_expand_xy(self) -> None:
         # Arrange
         im = hopper()
         orig_size = im.size
@@ -278,12 +279,12 @@ def test_expand_xy(self):
         assert im.size[0] == orig_size[0] + 2 * xmargin
         assert im.size[1] == orig_size[1] + 2 * ymargin
 
-    def test_getbands(self):
+    def test_getbands(self) -> None:
         # Assert
         assert hopper("RGB").getbands() == ("R", "G", "B")
         assert hopper("YCbCr").getbands() == ("Y", "Cb", "Cr")
 
-    def test_getchannel_wrong_params(self):
+    def test_getchannel_wrong_params(self) -> None:
         im = hopper()
 
         with pytest.raises(ValueError):
@@ -295,7 +296,7 @@ def test_getchannel_wrong_params(self):
         with pytest.raises(ValueError):
             im.getchannel("1")
 
-    def test_getchannel(self):
+    def test_getchannel(self) -> None:
         im = hopper("YCbCr")
         Y, Cb, Cr = im.split()
 
@@ -306,7 +307,7 @@ def test_getchannel(self):
         assert_image_equal(Cr, im.getchannel(2))
         assert_image_equal(Cr, im.getchannel("Cr"))
 
-    def test_getbbox(self):
+    def test_getbbox(self) -> None:
         # Arrange
         im = hopper()
 
@@ -316,7 +317,7 @@ def test_getbbox(self):
         # Assert
         assert bbox == (0, 0, 128, 128)
 
-    def test_ne(self):
+    def test_ne(self) -> None:
         # Arrange
         im1 = Image.new("RGB", (25, 25), "black")
         im2 = Image.new("RGB", (25, 25), "white")
@@ -324,7 +325,7 @@ def test_ne(self):
         # Act / Assert
         assert im1 != im2
 
-    def test_alpha_composite(self):
+    def test_alpha_composite(self) -> None:
         # https://stackoverflow.com/questions/3374878
         # Arrange
         expected_colors = sorted(
@@ -355,7 +356,7 @@ def test_alpha_composite(self):
         img_colors = sorted(img.getcolors())
         assert img_colors == expected_colors
 
-    def test_alpha_inplace(self):
+    def test_alpha_inplace(self) -> None:
         src = Image.new("RGBA", (128, 128), "blue")
 
         over = Image.new("RGBA", (128, 128), "red")
@@ -407,7 +408,7 @@ def test_alpha_inplace(self):
         with pytest.raises(ValueError):
             source.alpha_composite(over, (0, 0), (0, -1))
 
-    def test_register_open_duplicates(self):
+    def test_register_open_duplicates(self) -> None:
         # Arrange
         factory, accept = Image.OPEN["JPEG"]
         id_length = len(Image.ID)
@@ -418,7 +419,7 @@ def test_register_open_duplicates(self):
         # Assert
         assert len(Image.ID) == id_length
 
-    def test_registered_extensions_uninitialized(self):
+    def test_registered_extensions_uninitialized(self) -> None:
         # Arrange
         Image._initialized = 0
 
@@ -428,7 +429,7 @@ def test_registered_extensions_uninitialized(self):
         # Assert
         assert Image._initialized == 2
 
-    def test_registered_extensions(self):
+    def test_registered_extensions(self) -> None:
         # Arrange
         # Open an image to trigger plugin registration
         with Image.open("Tests/images/rgb.jpg"):
@@ -442,7 +443,7 @@ def test_registered_extensions(self):
         for ext in [".cur", ".icns", ".tif", ".tiff"]:
             assert ext in extensions
 
-    def test_effect_mandelbrot(self):
+    def test_effect_mandelbrot(self) -> None:
         # Arrange
         size = (512, 512)
         extent = (-3, -2.5, 2, 2.5)
@@ -455,7 +456,7 @@ def test_effect_mandelbrot(self):
         assert im.size == (512, 512)
         assert_image_equal_tofile(im, "Tests/images/effect_mandelbrot.png")
 
-    def test_effect_mandelbrot_bad_arguments(self):
+    def test_effect_mandelbrot_bad_arguments(self) -> None:
         # Arrange
         size = (512, 512)
         # Get coordinates the wrong way round:
@@ -467,7 +468,7 @@ def test_effect_mandelbrot_bad_arguments(self):
         with pytest.raises(ValueError):
             Image.effect_mandelbrot(size, extent, quality)
 
-    def test_effect_noise(self):
+    def test_effect_noise(self) -> None:
         # Arrange
         size = (100, 100)
         sigma = 128
@@ -485,7 +486,7 @@ def test_effect_noise(self):
         p4 = im.getpixel((0, 4))
         assert_not_all_same([p0, p1, p2, p3, p4])
 
-    def test_effect_spread(self):
+    def test_effect_spread(self) -> None:
         # Arrange
         im = hopper()
         distance = 10
@@ -497,7 +498,7 @@ def test_effect_spread(self):
         assert im.size == (128, 128)
         assert_image_similar_tofile(im2, "Tests/images/effect_spread.png", 110)
 
-    def test_effect_spread_zero(self):
+    def test_effect_spread_zero(self) -> None:
         # Arrange
         im = hopper()
         distance = 0
@@ -508,7 +509,7 @@ def test_effect_spread_zero(self):
         # Assert
         assert_image_equal(im, im2)
 
-    def test_check_size(self):
+    def test_check_size(self) -> None:
         # Checking that the _check_size function throws value errors when we want it to
         with pytest.raises(ValueError):
             Image.new("RGB", 0)  # not a tuple
@@ -537,10 +538,10 @@ def test_check_size(self):
         "PILLOW_VALGRIND_TEST" in os.environ, reason="Valgrind is slower"
     )
     @pytest.mark.parametrize("size", ((0, 100000000), (100000000, 0)))
-    def test_empty_image(self, size):
+    def test_empty_image(self, size) -> None:
         Image.new("RGB", size)
 
-    def test_storage_neg(self):
+    def test_storage_neg(self) -> None:
         # Storage.c accepted negative values for xsize, ysize.  Was
         # test_neg_ppm, but the core function for that has been
         # removed Calling directly into core to test the error in
@@ -549,13 +550,13 @@ def test_storage_neg(self):
         with pytest.raises(ValueError):
             Image.core.fill("RGB", (2, -2), (0, 0, 0))
 
-    def test_one_item_tuple(self):
+    def test_one_item_tuple(self) -> None:
         for mode in ("I", "F", "L"):
             im = Image.new(mode, (100, 100), (5,))
             px = im.load()
             assert px[0, 0] == 5
 
-    def test_linear_gradient_wrong_mode(self):
+    def test_linear_gradient_wrong_mode(self) -> None:
         # Arrange
         wrong_mode = "RGB"
 
@@ -564,7 +565,7 @@ def test_linear_gradient_wrong_mode(self):
             Image.linear_gradient(wrong_mode)
 
     @pytest.mark.parametrize("mode", ("L", "P", "I", "F"))
-    def test_linear_gradient(self, mode):
+    def test_linear_gradient(self, mode) -> None:
         # Arrange
         target_file = "Tests/images/linear_gradient.png"
 
@@ -580,7 +581,7 @@ def test_linear_gradient(self, mode):
             target = target.convert(mode)
         assert_image_equal(im, target)
 
-    def test_radial_gradient_wrong_mode(self):
+    def test_radial_gradient_wrong_mode(self) -> None:
         # Arrange
         wrong_mode = "RGB"
 
@@ -589,7 +590,7 @@ def test_radial_gradient_wrong_mode(self):
             Image.radial_gradient(wrong_mode)
 
     @pytest.mark.parametrize("mode", ("L", "P", "I", "F"))
-    def test_radial_gradient(self, mode):
+    def test_radial_gradient(self, mode) -> None:
         # Arrange
         target_file = "Tests/images/radial_gradient.png"
 
@@ -605,7 +606,7 @@ def test_radial_gradient(self, mode):
             target = target.convert(mode)
         assert_image_equal(im, target)
 
-    def test_register_extensions(self):
+    def test_register_extensions(self) -> None:
         test_format = "a"
         exts = ["b", "c"]
         for ext in exts:
@@ -621,7 +622,7 @@ def test_register_extensions(self):
 
         assert ext_individual == ext_multiple
 
-    def test_remap_palette(self):
+    def test_remap_palette(self) -> None:
         # Test identity transform
         with Image.open("Tests/images/hopper.gif") as im:
             assert_image_equal(im, im.remap_palette(list(range(256))))
@@ -640,7 +641,7 @@ def test_remap_palette(self):
             with pytest.raises(ValueError):
                 im.remap_palette(None)
 
-    def test_remap_palette_transparency(self):
+    def test_remap_palette_transparency(self) -> None:
         im = Image.new("P", (1, 2), (0, 0, 0))
         im.putpixel((0, 1), (255, 0, 0))
         im.info["transparency"] = 0
@@ -655,7 +656,7 @@ def test_remap_palette_transparency(self):
         im_remapped = im.remap_palette([1, 0])
         assert "transparency" not in im_remapped.info
 
-    def test__new(self):
+    def test__new(self) -> None:
         im = hopper("RGB")
         im_p = hopper("P")
 
@@ -664,7 +665,7 @@ def test__new(self):
         blank_p.palette = None
         blank_pa.palette = None
 
-        def _make_new(base_image, image, palette_result=None):
+        def _make_new(base_image, image, palette_result=None) -> None:
             new_image = base_image._new(image.im)
             assert new_image.mode == image.mode
             assert new_image.size == image.size
@@ -679,7 +680,7 @@ def _make_new(base_image, image, palette_result=None):
         _make_new(im, blank_p, ImagePalette.ImagePalette())
         _make_new(im, blank_pa, ImagePalette.ImagePalette())
 
-    def test_p_from_rgb_rgba(self):
+    def test_p_from_rgb_rgba(self) -> None:
         for mode, color in [
             ("RGB", "#DDEEFF"),
             ("RGB", (221, 238, 255)),
@@ -689,7 +690,7 @@ def test_p_from_rgb_rgba(self):
             expected = Image.new(mode, (100, 100), color)
             assert_image_equal(im.convert(mode), expected)
 
-    def test_no_resource_warning_on_save(self, tmp_path):
+    def test_no_resource_warning_on_save(self, tmp_path: Path) -> None:
         # https://github.com/python-pillow/Pillow/issues/835
         # Arrange
         test_file = "Tests/images/hopper.png"
@@ -700,7 +701,7 @@ def test_no_resource_warning_on_save(self, tmp_path):
             with warnings.catch_warnings():
                 im.save(temp_file)
 
-    def test_no_new_file_on_error(self, tmp_path):
+    def test_no_new_file_on_error(self, tmp_path: Path) -> None:
         temp_file = str(tmp_path / "temp.jpg")
 
         im = Image.new("RGB", (0, 0))
@@ -709,10 +710,10 @@ def test_no_new_file_on_error(self, tmp_path):
 
         assert not os.path.exists(temp_file)
 
-    def test_load_on_nonexclusive_multiframe(self):
+    def test_load_on_nonexclusive_multiframe(self) -> None:
         with open("Tests/images/frozenpond.mpo", "rb") as fp:
 
-            def act(fp):
+            def act(fp) -> None:
                 im = Image.open(fp)
                 im.load()
 
@@ -723,7 +724,7 @@ def act(fp):
 
             assert not fp.closed
 
-    def test_empty_exif(self):
+    def test_empty_exif(self) -> None:
         with Image.open("Tests/images/exif.png") as im:
             exif = im.getexif()
         assert dict(exif)
@@ -739,7 +740,7 @@ def test_empty_exif(self):
     @mark_if_feature_version(
         pytest.mark.valgrind_known_error, "libjpeg_turbo", "2.0", reason="Known Failing"
     )
-    def test_exif_jpeg(self, tmp_path):
+    def test_exif_jpeg(self, tmp_path: Path) -> None:
         with Image.open("Tests/images/exif-72dpi-int.jpg") as im:  # Little endian
             exif = im.getexif()
             assert 258 not in exif
@@ -785,7 +786,7 @@ def test_exif_jpeg(self, tmp_path):
 
     @skip_unless_feature("webp")
     @skip_unless_feature("webp_anim")
-    def test_exif_webp(self, tmp_path):
+    def test_exif_webp(self, tmp_path: Path) -> None:
         with Image.open("Tests/images/hopper.webp") as im:
             exif = im.getexif()
             assert exif == {}
@@ -795,7 +796,7 @@ def test_exif_webp(self, tmp_path):
             exif[40963] = 455
             exif[305] = "Pillow test"
 
-            def check_exif():
+            def check_exif() -> None:
                 with Image.open(out) as reloaded:
                     reloaded_exif = reloaded.getexif()
                     assert reloaded_exif[258] == 8
@@ -807,7 +808,7 @@ def check_exif():
             im.save(out, exif=exif, save_all=True)
             check_exif()
 
-    def test_exif_png(self, tmp_path):
+    def test_exif_png(self, tmp_path: Path) -> None:
         with Image.open("Tests/images/exif.png") as im:
             exif = im.getexif()
             assert exif == {274: 1}
@@ -823,7 +824,7 @@ def test_exif_png(self, tmp_path):
             reloaded_exif = reloaded.getexif()
             assert reloaded_exif == {258: 8, 40963: 455, 305: "Pillow test"}
 
-    def test_exif_interop(self):
+    def test_exif_interop(self) -> None:
         with Image.open("Tests/images/flower.jpg") as im:
             exif = im.getexif()
             assert exif.get_ifd(0xA005) == {
@@ -837,7 +838,7 @@ def test_exif_interop(self):
             reloaded_exif.load(exif.tobytes())
             assert reloaded_exif.get_ifd(0xA005) == exif.get_ifd(0xA005)
 
-    def test_exif_ifd1(self):
+    def test_exif_ifd1(self) -> None:
         with Image.open("Tests/images/flower.jpg") as im:
             exif = im.getexif()
             assert exif.get_ifd(ExifTags.IFD.IFD1) == {
@@ -849,7 +850,7 @@ def test_exif_ifd1(self):
                 283: 180.0,
             }
 
-    def test_exif_ifd(self):
+    def test_exif_ifd(self) -> None:
         with Image.open("Tests/images/flower.jpg") as im:
             exif = im.getexif()
         del exif.get_ifd(0x8769)[0xA005]
@@ -858,7 +859,7 @@ def test_exif_ifd(self):
         reloaded_exif.load(exif.tobytes())
         assert reloaded_exif.get_ifd(0x8769) == exif.get_ifd(0x8769)
 
-    def test_exif_load_from_fp(self):
+    def test_exif_load_from_fp(self) -> None:
         with Image.open("Tests/images/flower.jpg") as im:
             data = im.info["exif"]
             if data.startswith(b"Exif\x00\x00"):
@@ -879,7 +880,7 @@ def test_exif_load_from_fp(self):
                 34665: 196,
             }
 
-    def test_exif_hide_offsets(self):
+    def test_exif_hide_offsets(self) -> None:
         with Image.open("Tests/images/flower.jpg") as im:
             exif = im.getexif()
 
@@ -905,18 +906,18 @@ def test_exif_hide_offsets(self):
                 assert exif.get_ifd(0xA005)
 
     @pytest.mark.parametrize("size", ((1, 0), (0, 1), (0, 0)))
-    def test_zero_tobytes(self, size):
+    def test_zero_tobytes(self, size) -> None:
         im = Image.new("RGB", size)
         assert im.tobytes() == b""
 
     @pytest.mark.parametrize("size", ((1, 0), (0, 1), (0, 0)))
-    def test_zero_frombytes(self, size):
+    def test_zero_frombytes(self, size) -> None:
         Image.frombytes("RGB", size, b"")
 
         im = Image.new("RGB", size)
         im.frombytes(b"")
 
-    def test_has_transparency_data(self):
+    def test_has_transparency_data(self) -> None:
         for mode in ("1", "L", "P", "RGB"):
             im = Image.new(mode, (1, 1))
             assert not im.has_transparency_data
@@ -941,7 +942,7 @@ def test_has_transparency_data(self):
         assert im.palette.mode == "RGBA"
         assert im.has_transparency_data
 
-    def test_apply_transparency(self):
+    def test_apply_transparency(self) -> None:
         im = Image.new("P", (1, 1))
         im.putpalette((0, 0, 0, 1, 1, 1))
         assert im.palette.colors == {(0, 0, 0): 0, (1, 1, 1): 1}
@@ -970,7 +971,7 @@ def test_apply_transparency(self):
             im.apply_transparency()
             assert im.palette.colors[(27, 35, 6, 214)] == 24
 
-    def test_constants(self):
+    def test_constants(self) -> None:
         for enum in (
             Image.Transpose,
             Image.Transform,
@@ -995,7 +996,7 @@ def test_constants(self):
             "01r_00.pcx",
         ],
     )
-    def test_overrun(self, path):
+    def test_overrun(self, path) -> None:
         """For overrun completeness, test as:
         valgrind pytest -qq Tests/test_image.py::TestImage::test_overrun | grep decode.c
         """
@@ -1009,7 +1010,7 @@ def test_overrun(self, path):
 
                 assert buffer_overrun or truncated
 
-    def test_fli_overrun2(self):
+    def test_fli_overrun2(self) -> None:
         with Image.open("Tests/images/fli_overrun2.bin") as im:
             try:
                 im.seek(1)
@@ -1017,12 +1018,12 @@ def test_fli_overrun2(self):
             except OSError as e:
                 assert str(e) == "buffer overrun when reading image file"
 
-    def test_exit_fp(self):
+    def test_exit_fp(self) -> None:
         with Image.new("L", (1, 1)) as im:
             pass
         assert not hasattr(im, "fp")
 
-    def test_close_graceful(self, caplog):
+    def test_close_graceful(self, caplog) -> None:
         with Image.open("Tests/images/hopper.jpg") as im:
             copy = im.copy()
             with caplog.at_level(logging.DEBUG):
@@ -1043,7 +1044,7 @@ def mock_encode(*args):
 
 
 class TestRegistry:
-    def test_encode_registry(self):
+    def test_encode_registry(self) -> None:
         Image.register_encoder("MOCK", mock_encode)
         assert "MOCK" in Image.ENCODERS
 
@@ -1052,6 +1053,6 @@ def test_encode_registry(self):
         assert isinstance(enc, MockEncoder)
         assert enc.args == ("RGB", "args", "extra")
 
-    def test_encode_registry_fail(self):
+    def test_encode_registry_fail(self) -> None:
         with pytest.raises(OSError):
             Image._getencoder("RGB", "DoesNotExist", ("args",), extra=("extra",))
diff --git a/Tests/test_image_access.py b/Tests/test_image_access.py
index 4ae56fae0cc..00cd4e7a9a1 100644
--- a/Tests/test_image_access.py
+++ b/Tests/test_image_access.py
@@ -35,16 +35,16 @@ class AccessTest:
     _need_cffi_access = False
 
     @classmethod
-    def setup_class(cls):
+    def setup_class(cls) -> None:
         Image.USE_CFFI_ACCESS = cls._need_cffi_access
 
     @classmethod
-    def teardown_class(cls):
+    def teardown_class(cls) -> None:
         Image.USE_CFFI_ACCESS = cls._init_cffi_access
 
 
 class TestImagePutPixel(AccessTest):
-    def test_sanity(self):
+    def test_sanity(self) -> None:
         im1 = hopper()
         im2 = Image.new(im1.mode, im1.size, 0)
 
@@ -81,7 +81,7 @@ def test_sanity(self):
 
         assert_image_equal(im1, im2)
 
-    def test_sanity_negative_index(self):
+    def test_sanity_negative_index(self) -> None:
         im1 = hopper()
         im2 = Image.new(im1.mode, im1.size, 0)
 
@@ -119,7 +119,7 @@ def test_sanity_negative_index(self):
         assert_image_equal(im1, im2)
 
     @pytest.mark.skipif(numpy is None, reason="NumPy not installed")
-    def test_numpy(self):
+    def test_numpy(self) -> None:
         im = hopper()
         pix = im.load()
 
@@ -138,7 +138,7 @@ def color(mode):
             return (16, 32, 49)
         return tuple(range(1, bands + 1))
 
-    def check(self, mode, expected_color=None):
+    def check(self, mode, expected_color=None) -> None:
         if self._need_cffi_access and mode.startswith("BGR;"):
             pytest.skip("Support not added to deprecated module for BGR;* modes")
 
@@ -222,10 +222,10 @@ def check(self, mode, expected_color=None):
             "YCbCr",
         ),
     )
-    def test_basic(self, mode):
+    def test_basic(self, mode) -> None:
         self.check(mode)
 
-    def test_list(self):
+    def test_list(self) -> None:
         im = hopper()
         assert im.getpixel([0, 0]) == (20, 20, 70)
 
@@ -233,14 +233,14 @@ def test_list(self):
     @pytest.mark.parametrize(
         "expected_color", (2**15 - 1, 2**15, 2**15 + 1, 2**16 - 1)
     )
-    def test_signedness(self, mode, expected_color):
+    def test_signedness(self, mode, expected_color) -> None:
         # see https://github.com/python-pillow/Pillow/issues/452
         # pixelaccess is using signed int* instead of uint*
         self.check(mode, expected_color)
 
     @pytest.mark.parametrize("mode", ("P", "PA"))
     @pytest.mark.parametrize("color", ((255, 0, 0), (255, 0, 0, 255)))
-    def test_p_putpixel_rgb_rgba(self, mode, color):
+    def test_p_putpixel_rgb_rgba(self, mode, color) -> None:
         im = Image.new(mode, (1, 1))
         im.putpixel((0, 0), color)
 
@@ -264,7 +264,7 @@ class TestCffiGetPixel(TestImageGetPixel):
 class TestCffi(AccessTest):
     _need_cffi_access = True
 
-    def _test_get_access(self, im):
+    def _test_get_access(self, im) -> None:
         """Do we get the same thing as the old pixel access
 
         Using private interfaces, forcing a capi access and
@@ -282,7 +282,7 @@ def _test_get_access(self, im):
         with pytest.raises(ValueError):
             access[(access.xsize + 1, access.ysize + 1)]
 
-    def test_get_vs_c(self):
+    def test_get_vs_c(self) -> None:
         with pytest.warns(DeprecationWarning):
             rgb = hopper("RGB")
             rgb.load()
@@ -301,7 +301,7 @@ def test_get_vs_c(self):
         # im = Image.new('I;32B', (10, 10), 2**10)
         # self._test_get_access(im)
 
-    def _test_set_access(self, im, color):
+    def _test_set_access(self, im, color) -> None:
         """Are we writing the correct bits into the image?
 
         Using private interfaces, forcing a capi access and
@@ -322,7 +322,7 @@ def _test_set_access(self, im, color):
         with pytest.raises(ValueError):
             access[(0, 0)] = color
 
-    def test_set_vs_c(self):
+    def test_set_vs_c(self) -> None:
         rgb = hopper("RGB")
         with pytest.warns(DeprecationWarning):
             rgb.load()
@@ -345,11 +345,11 @@ def test_set_vs_c(self):
         # self._test_set_access(im, 2**13-1)
 
     @pytest.mark.filterwarnings("ignore::DeprecationWarning")
-    def test_not_implemented(self):
+    def test_not_implemented(self) -> None:
         assert PyAccess.new(hopper("BGR;15")) is None
 
     # ref https://github.com/python-pillow/Pillow/pull/2009
-    def test_reference_counting(self):
+    def test_reference_counting(self) -> None:
         size = 10
 
         for _ in range(10):
@@ -361,7 +361,7 @@ def test_reference_counting(self):
                 assert px[i, 0] == 0
 
     @pytest.mark.parametrize("mode", ("P", "PA"))
-    def test_p_putpixel_rgb_rgba(self, mode):
+    def test_p_putpixel_rgb_rgba(self, mode) -> None:
         for color in ((255, 0, 0), (255, 0, 0, 127 if mode == "PA" else 255)):
             im = Image.new(mode, (1, 1))
             with pytest.warns(DeprecationWarning):
@@ -379,7 +379,7 @@ class TestImagePutPixelError(AccessTest):
     INVALID_TYPES = ["foo", 1.0, None]
 
     @pytest.mark.parametrize("mode", IMAGE_MODES1)
-    def test_putpixel_type_error1(self, mode):
+    def test_putpixel_type_error1(self, mode) -> None:
         im = hopper(mode)
         for v in self.INVALID_TYPES:
             with pytest.raises(TypeError, match="color must be int or tuple"):
@@ -402,14 +402,14 @@ def test_putpixel_type_error1(self, mode):
             ),
         ),
     )
-    def test_putpixel_invalid_number_of_bands(self, mode, band_numbers, match):
+    def test_putpixel_invalid_number_of_bands(self, mode, band_numbers, match) -> None:
         im = hopper(mode)
         for band_number in band_numbers:
             with pytest.raises(TypeError, match=match):
                 im.putpixel((0, 0), (0,) * band_number)
 
     @pytest.mark.parametrize("mode", IMAGE_MODES2)
-    def test_putpixel_type_error2(self, mode):
+    def test_putpixel_type_error2(self, mode) -> None:
         im = hopper(mode)
         for v in self.INVALID_TYPES:
             with pytest.raises(
@@ -418,7 +418,7 @@ def test_putpixel_type_error2(self, mode):
                 im.putpixel((0, 0), v)
 
     @pytest.mark.parametrize("mode", IMAGE_MODES1 + IMAGE_MODES2)
-    def test_putpixel_overflow_error(self, mode):
+    def test_putpixel_overflow_error(self, mode) -> None:
         im = hopper(mode)
         with pytest.raises(OverflowError):
             im.putpixel((0, 0), 2**80)
@@ -427,7 +427,7 @@ def test_putpixel_overflow_error(self, mode):
 class TestEmbeddable:
     @pytest.mark.xfail(reason="failing test")
     @pytest.mark.skipif(not is_win32(), reason="requires Windows")
-    def test_embeddable(self):
+    def test_embeddable(self) -> None:
         import ctypes
 
         from setuptools.command.build_ext import new_compiler
diff --git a/Tests/test_image_array.py b/Tests/test_image_array.py
index 0dacb3157a2..0125ab56af9 100644
--- a/Tests/test_image_array.py
+++ b/Tests/test_image_array.py
@@ -12,12 +12,12 @@
 im = hopper().resize((128, 100))
 
 
-def test_toarray():
+def test_toarray() -> None:
     def test(mode):
         ai = numpy.array(im.convert(mode))
         return ai.shape, ai.dtype.str, ai.nbytes
 
-    def test_with_dtype(dtype):
+    def test_with_dtype(dtype) -> None:
         ai = numpy.array(im, dtype=dtype)
         assert ai.dtype == dtype
 
@@ -46,11 +46,11 @@ def test_with_dtype(dtype):
                 numpy.array(im_truncated)
 
 
-def test_fromarray():
+def test_fromarray() -> None:
     class Wrapper:
         """Class with API matching Image.fromarray"""
 
-        def __init__(self, img, arr_params):
+        def __init__(self, img, arr_params) -> None:
             self.img = img
             self.__array_interface__ = arr_params
 
@@ -89,7 +89,7 @@ def test(mode):
         Image.fromarray(wrapped)
 
 
-def test_fromarray_palette():
+def test_fromarray_palette() -> None:
     # Arrange
     i = im.convert("L")
     a = numpy.array(i)
diff --git a/Tests/test_image_draft.py b/Tests/test_image_draft.py
index 08c40af1f16..54474311a09 100644
--- a/Tests/test_image_draft.py
+++ b/Tests/test_image_draft.py
@@ -19,7 +19,7 @@ def draft_roundtrip(in_mode, in_size, req_mode, req_size):
     return im
 
 
-def test_size():
+def test_size() -> None:
     for in_size, req_size, out_size in [
         ((435, 361), (2048, 2048), (435, 361)),  # bigger
         ((435, 361), (435, 361), (435, 361)),  # same
@@ -48,7 +48,7 @@ def test_size():
         assert im.size == out_size
 
 
-def test_mode():
+def test_mode() -> None:
     for in_mode, req_mode, out_mode in [
         ("RGB", "1", "RGB"),
         ("RGB", "L", "L"),
@@ -68,7 +68,7 @@ def test_mode():
         assert im.mode == out_mode
 
 
-def test_several_drafts():
+def test_several_drafts() -> None:
     im = draft_roundtrip("L", (128, 128), None, (64, 64))
     im.draft(None, (64, 64))
     im.load()
diff --git a/Tests/test_image_entropy.py b/Tests/test_image_entropy.py
index fce16122409..01107ae6b88 100644
--- a/Tests/test_image_entropy.py
+++ b/Tests/test_image_entropy.py
@@ -3,7 +3,7 @@
 from .helper import hopper
 
 
-def test_entropy():
+def test_entropy() -> None:
     def entropy(mode):
         return hopper(mode).entropy()
 
diff --git a/Tests/test_image_filter.py b/Tests/test_image_filter.py
index 3fa5dd2423a..2b6787933cd 100644
--- a/Tests/test_image_filter.py
+++ b/Tests/test_image_filter.py
@@ -36,7 +36,7 @@
     ),
 )
 @pytest.mark.parametrize("mode", ("L", "I", "RGB", "CMYK"))
-def test_sanity(filter_to_apply, mode):
+def test_sanity(filter_to_apply, mode) -> None:
     im = hopper(mode)
     if mode != "I" or isinstance(filter_to_apply, ImageFilter.BuiltinFilter):
         out = im.filter(filter_to_apply)
@@ -45,7 +45,7 @@ def test_sanity(filter_to_apply, mode):
 
 
 @pytest.mark.parametrize("mode", ("L", "I", "RGB", "CMYK"))
-def test_sanity_error(mode):
+def test_sanity_error(mode) -> None:
     with pytest.raises(TypeError):
         im = hopper(mode)
         im.filter("hello")
@@ -53,7 +53,7 @@ def test_sanity_error(mode):
 
 # crashes on small images
 @pytest.mark.parametrize("size", ((1, 1), (2, 2), (3, 3)))
-def test_crash(size):
+def test_crash(size) -> None:
     im = Image.new("RGB", size)
     im.filter(ImageFilter.SMOOTH)
 
@@ -67,7 +67,7 @@ def test_crash(size):
         ("RGB", ((4, 0, 0), (0, 0, 0))),
     ),
 )
-def test_modefilter(mode, expected):
+def test_modefilter(mode, expected) -> None:
     im = Image.new(mode, (3, 3), None)
     im.putdata(list(range(9)))
     # image is:
@@ -90,7 +90,7 @@ def test_modefilter(mode, expected):
         ("F", (0.0, 4.0, 8.0)),
     ),
 )
-def test_rankfilter(mode, expected):
+def test_rankfilter(mode, expected) -> None:
     im = Image.new(mode, (3, 3), None)
     im.putdata(list(range(9)))
     # image is:
@@ -106,7 +106,7 @@ def test_rankfilter(mode, expected):
 @pytest.mark.parametrize(
     "filter", (ImageFilter.MinFilter, ImageFilter.MedianFilter, ImageFilter.MaxFilter)
 )
-def test_rankfilter_error(filter):
+def test_rankfilter_error(filter) -> None:
     with pytest.raises(ValueError):
         im = Image.new("P", (3, 3), None)
         im.putdata(list(range(9)))
@@ -117,27 +117,27 @@ def test_rankfilter_error(filter):
         im.filter(filter).getpixel((1, 1))
 
 
-def test_rankfilter_properties():
+def test_rankfilter_properties() -> None:
     rankfilter = ImageFilter.RankFilter(1, 2)
 
     assert rankfilter.size == 1
     assert rankfilter.rank == 2
 
 
-def test_builtinfilter_p():
+def test_builtinfilter_p() -> None:
     builtin_filter = ImageFilter.BuiltinFilter()
 
     with pytest.raises(ValueError):
         builtin_filter.filter(hopper("P"))
 
 
-def test_kernel_not_enough_coefficients():
+def test_kernel_not_enough_coefficients() -> None:
     with pytest.raises(ValueError):
         ImageFilter.Kernel((3, 3), (0, 0))
 
 
 @pytest.mark.parametrize("mode", ("L", "LA", "I", "RGB", "CMYK"))
-def test_consistency_3x3(mode):
+def test_consistency_3x3(mode) -> None:
     with Image.open("Tests/images/hopper.bmp") as source:
         reference_name = "hopper_emboss"
         reference_name += "_I.png" if mode == "I" else ".bmp"
@@ -163,7 +163,7 @@ def test_consistency_3x3(mode):
 
 
 @pytest.mark.parametrize("mode", ("L", "LA", "I", "RGB", "CMYK"))
-def test_consistency_5x5(mode):
+def test_consistency_5x5(mode) -> None:
     with Image.open("Tests/images/hopper.bmp") as source:
         reference_name = "hopper_emboss_more"
         reference_name += "_I.png" if mode == "I" else ".bmp"
@@ -199,7 +199,7 @@ def test_consistency_5x5(mode):
         (2, -2),
     ),
 )
-def test_invalid_box_blur_filter(radius):
+def test_invalid_box_blur_filter(radius) -> None:
     with pytest.raises(ValueError):
         ImageFilter.BoxBlur(radius)
 
diff --git a/Tests/test_image_getextrema.py b/Tests/test_image_getextrema.py
index 6bbc4da9a01..0107fdcc426 100644
--- a/Tests/test_image_getextrema.py
+++ b/Tests/test_image_getextrema.py
@@ -5,7 +5,7 @@
 from .helper import hopper
 
 
-def test_extrema():
+def test_extrema() -> None:
     def extrema(mode):
         return hopper(mode).getextrema()
 
@@ -20,7 +20,7 @@ def extrema(mode):
     assert extrema("I;16") == (1, 255)
 
 
-def test_true_16():
+def test_true_16() -> None:
     with Image.open("Tests/images/16_bit_noise.tif") as im:
         assert im.mode == "I;16"
         extrema = im.getextrema()
diff --git a/Tests/test_image_getpalette.py b/Tests/test_image_getpalette.py
index 4340f46f619..e7304c98f30 100644
--- a/Tests/test_image_getpalette.py
+++ b/Tests/test_image_getpalette.py
@@ -5,7 +5,7 @@
 from .helper import hopper
 
 
-def test_palette():
+def test_palette() -> None:
     def palette(mode):
         p = hopper(mode).getpalette()
         if p:
@@ -23,7 +23,7 @@ def palette(mode):
     assert palette("YCbCr") is None
 
 
-def test_palette_rawmode():
+def test_palette_rawmode() -> None:
     im = Image.new("P", (1, 1))
     im.putpalette((1, 2, 3))
 
diff --git a/Tests/test_image_load.py b/Tests/test_image_load.py
index 36f8ba575d8..5b1a9ee2dda 100644
--- a/Tests/test_image_load.py
+++ b/Tests/test_image_load.py
@@ -10,14 +10,14 @@
 from .helper import hopper
 
 
-def test_sanity():
+def test_sanity() -> None:
     im = hopper()
     pix = im.load()
 
     assert pix[0, 0] == (20, 20, 70)
 
 
-def test_close():
+def test_close() -> None:
     im = Image.open("Tests/images/hopper.gif")
     im.close()
     with pytest.raises(ValueError):
@@ -26,7 +26,7 @@ def test_close():
         im.getpixel((0, 0))
 
 
-def test_close_after_load(caplog):
+def test_close_after_load(caplog) -> None:
     im = Image.open("Tests/images/hopper.gif")
     im.load()
     with caplog.at_level(logging.DEBUG):
@@ -34,7 +34,7 @@ def test_close_after_load(caplog):
     assert len(caplog.records) == 0
 
 
-def test_contextmanager():
+def test_contextmanager() -> None:
     fn = None
     with Image.open("Tests/images/hopper.gif") as im:
         fn = im.fp.fileno()
@@ -44,7 +44,7 @@ def test_contextmanager():
         os.fstat(fn)
 
 
-def test_contextmanager_non_exclusive_fp():
+def test_contextmanager_non_exclusive_fp() -> None:
     with open("Tests/images/hopper.gif", "rb") as fp:
         with Image.open(fp):
             pass
diff --git a/Tests/test_image_mode.py b/Tests/test_image_mode.py
index 3c1d494fab2..8e94aafc598 100644
--- a/Tests/test_image_mode.py
+++ b/Tests/test_image_mode.py
@@ -7,7 +7,7 @@
 from .helper import hopper
 
 
-def test_sanity():
+def test_sanity() -> None:
     with hopper() as im:
         im.mode
 
@@ -69,7 +69,7 @@ def test_sanity():
 )
 def test_properties(
     mode, expected_base, expected_type, expected_bands, expected_band_names
-):
+) -> None:
     assert Image.getmodebase(mode) == expected_base
     assert Image.getmodetype(mode) == expected_type
     assert Image.getmodebands(mode) == expected_bands
diff --git a/Tests/test_image_paste.py b/Tests/test_image_paste.py
index fd117f9dbc9..34a2f8f3db5 100644
--- a/Tests/test_image_paste.py
+++ b/Tests/test_image_paste.py
@@ -11,7 +11,7 @@ class TestImagingPaste:
     masks = {}
     size = 128
 
-    def assert_9points_image(self, im, expected):
+    def assert_9points_image(self, im, expected) -> None:
         expected = [
             point[0] if im.mode == "L" else point[: len(im.mode)] for point in expected
         ]
@@ -29,7 +29,7 @@ def assert_9points_image(self, im, expected):
         ]
         assert actual == expected
 
-    def assert_9points_paste(self, im, im2, mask, expected):
+    def assert_9points_paste(self, im, im2, mask, expected) -> None:
         im3 = im.copy()
         im3.paste(im2, (0, 0), mask)
         self.assert_9points_image(im3, expected)
@@ -106,7 +106,7 @@ def gradient_RGBa(self):
         )
 
     @pytest.mark.parametrize("mode", ["RGBA", "RGB", "L"])
-    def test_image_solid(self, mode):
+    def test_image_solid(self, mode) -> None:
         im = Image.new(mode, (200, 200), "red")
         im2 = getattr(self, "gradient_" + mode)
 
@@ -116,7 +116,7 @@ def test_image_solid(self, mode):
         assert_image_equal(im, im2)
 
     @pytest.mark.parametrize("mode", ["RGBA", "RGB", "L"])
-    def test_image_mask_1(self, mode):
+    def test_image_mask_1(self, mode) -> None:
         im = Image.new(mode, (200, 200), "white")
         im2 = getattr(self, "gradient_" + mode)
 
@@ -138,7 +138,7 @@ def test_image_mask_1(self, mode):
         )
 
     @pytest.mark.parametrize("mode", ["RGBA", "RGB", "L"])
-    def test_image_mask_L(self, mode):
+    def test_image_mask_L(self, mode) -> None:
         im = Image.new(mode, (200, 200), "white")
         im2 = getattr(self, "gradient_" + mode)
 
@@ -160,7 +160,7 @@ def test_image_mask_L(self, mode):
         )
 
     @pytest.mark.parametrize("mode", ["RGBA", "RGB", "L"])
-    def test_image_mask_LA(self, mode):
+    def test_image_mask_LA(self, mode) -> None:
         im = Image.new(mode, (200, 200), "white")
         im2 = getattr(self, "gradient_" + mode)
 
@@ -182,7 +182,7 @@ def test_image_mask_LA(self, mode):
         )
 
     @pytest.mark.parametrize("mode", ["RGBA", "RGB", "L"])
-    def test_image_mask_RGBA(self, mode):
+    def test_image_mask_RGBA(self, mode) -> None:
         im = Image.new(mode, (200, 200), "white")
         im2 = getattr(self, "gradient_" + mode)
 
@@ -204,7 +204,7 @@ def test_image_mask_RGBA(self, mode):
         )
 
     @pytest.mark.parametrize("mode", ["RGBA", "RGB", "L"])
-    def test_image_mask_RGBa(self, mode):
+    def test_image_mask_RGBa(self, mode) -> None:
         im = Image.new(mode, (200, 200), "white")
         im2 = getattr(self, "gradient_" + mode)
 
@@ -226,7 +226,7 @@ def test_image_mask_RGBa(self, mode):
         )
 
     @pytest.mark.parametrize("mode", ["RGBA", "RGB", "L"])
-    def test_color_solid(self, mode):
+    def test_color_solid(self, mode) -> None:
         im = Image.new(mode, (200, 200), "black")
 
         rect = (12, 23, 128 + 12, 128 + 23)
@@ -239,7 +239,7 @@ def test_color_solid(self, mode):
             assert sum(head[:255]) == 0
 
     @pytest.mark.parametrize("mode", ["RGBA", "RGB", "L"])
-    def test_color_mask_1(self, mode):
+    def test_color_mask_1(self, mode) -> None:
         im = Image.new(mode, (200, 200), (50, 60, 70, 80)[: len(mode)])
         color = (10, 20, 30, 40)[: len(mode)]
 
@@ -261,7 +261,7 @@ def test_color_mask_1(self, mode):
         )
 
     @pytest.mark.parametrize("mode", ["RGBA", "RGB", "L"])
-    def test_color_mask_L(self, mode):
+    def test_color_mask_L(self, mode) -> None:
         im = getattr(self, "gradient_" + mode).copy()
         color = "white"
 
@@ -283,7 +283,7 @@ def test_color_mask_L(self, mode):
         )
 
     @pytest.mark.parametrize("mode", ["RGBA", "RGB", "L"])
-    def test_color_mask_RGBA(self, mode):
+    def test_color_mask_RGBA(self, mode) -> None:
         im = getattr(self, "gradient_" + mode).copy()
         color = "white"
 
@@ -305,7 +305,7 @@ def test_color_mask_RGBA(self, mode):
         )
 
     @pytest.mark.parametrize("mode", ["RGBA", "RGB", "L"])
-    def test_color_mask_RGBa(self, mode):
+    def test_color_mask_RGBa(self, mode) -> None:
         im = getattr(self, "gradient_" + mode).copy()
         color = "white"
 
@@ -326,7 +326,7 @@ def test_color_mask_RGBa(self, mode):
             ],
         )
 
-    def test_different_sizes(self):
+    def test_different_sizes(self) -> None:
         im = Image.new("RGB", (100, 100))
         im2 = Image.new("RGB", (50, 50))
 
diff --git a/Tests/test_image_putdata.py b/Tests/test_image_putdata.py
index 2648af8fa2e..10301991624 100644
--- a/Tests/test_image_putdata.py
+++ b/Tests/test_image_putdata.py
@@ -10,7 +10,7 @@
 from .helper import assert_image_equal, hopper
 
 
-def test_sanity():
+def test_sanity() -> None:
     im1 = hopper()
 
     data = list(im1.getdata())
@@ -29,7 +29,7 @@ def test_sanity():
     assert_image_equal(im1, im2)
 
 
-def test_long_integers():
+def test_long_integers() -> None:
     # see bug-200802-systemerror
     def put(value):
         im = Image.new("RGBA", (1, 1))
@@ -46,19 +46,19 @@ def put(value):
         assert put(sys.maxsize) == (255, 255, 255, 127)
 
 
-def test_pypy_performance():
+def test_pypy_performance() -> None:
     im = Image.new("L", (256, 256))
     im.putdata(list(range(256)) * 256)
 
 
-def test_mode_with_L_with_float():
+def test_mode_with_L_with_float() -> None:
     im = Image.new("L", (1, 1), 0)
     im.putdata([2.0])
     assert im.getpixel((0, 0)) == 2
 
 
 @pytest.mark.parametrize("mode", ("I", "I;16", "I;16L", "I;16B"))
-def test_mode_i(mode):
+def test_mode_i(mode) -> None:
     src = hopper("L")
     data = list(src.getdata())
     im = Image.new(mode, src.size, 0)
@@ -68,7 +68,7 @@ def test_mode_i(mode):
     assert list(im.getdata()) == target
 
 
-def test_mode_F():
+def test_mode_F() -> None:
     src = hopper("L")
     data = list(src.getdata())
     im = Image.new("F", src.size, 0)
@@ -79,7 +79,7 @@ def test_mode_F():
 
 
 @pytest.mark.parametrize("mode", ("BGR;15", "BGR;16", "BGR;24"))
-def test_mode_BGR(mode):
+def test_mode_BGR(mode) -> None:
     data = [(16, 32, 49), (32, 32, 98)]
     im = Image.new(mode, (1, 2))
     im.putdata(data)
@@ -87,7 +87,7 @@ def test_mode_BGR(mode):
     assert list(im.getdata()) == data
 
 
-def test_array_B():
+def test_array_B() -> None:
     # shouldn't segfault
     # see https://github.com/python-pillow/Pillow/issues/1008
 
@@ -98,7 +98,7 @@ def test_array_B():
     assert len(im.getdata()) == len(arr)
 
 
-def test_array_F():
+def test_array_F() -> None:
     # shouldn't segfault
     # see https://github.com/python-pillow/Pillow/issues/1008
 
@@ -109,7 +109,7 @@ def test_array_F():
     assert len(im.getdata()) == len(arr)
 
 
-def test_not_flattened():
+def test_not_flattened() -> None:
     im = Image.new("L", (1, 1))
     with pytest.raises(TypeError):
         im.putdata([[0]])
diff --git a/Tests/test_image_putpalette.py b/Tests/test_image_putpalette.py
index 43b65be2b17..ffe2551d239 100644
--- a/Tests/test_image_putpalette.py
+++ b/Tests/test_image_putpalette.py
@@ -7,7 +7,7 @@
 from .helper import assert_image_equal, assert_image_equal_tofile, hopper
 
 
-def test_putpalette():
+def test_putpalette() -> None:
     def palette(mode):
         im = hopper(mode).copy()
         im.putpalette(list(range(256)) * 3)
@@ -43,7 +43,7 @@ def palette(mode):
         im.putpalette(list(range(256)) * 3)
 
 
-def test_imagepalette():
+def test_imagepalette() -> None:
     im = hopper("P")
     im.putpalette(ImagePalette.negative())
     assert_image_equal_tofile(im.convert("RGB"), "Tests/images/palette_negative.png")
@@ -57,7 +57,7 @@ def test_imagepalette():
     assert_image_equal_tofile(im.convert("RGB"), "Tests/images/palette_wedge.png")
 
 
-def test_putpalette_with_alpha_values():
+def test_putpalette_with_alpha_values() -> None:
     with Image.open("Tests/images/transparent.gif") as im:
         expected = im.convert("RGBA")
 
@@ -81,19 +81,19 @@ def test_putpalette_with_alpha_values():
         ("RGBAX", (1, 2, 3, 4, 0)),
     ),
 )
-def test_rgba_palette(mode, palette):
+def test_rgba_palette(mode, palette) -> None:
     im = Image.new("P", (1, 1))
     im.putpalette(palette, mode)
     assert im.getpalette() == [1, 2, 3]
     assert im.palette.colors == {(1, 2, 3, 4): 0}
 
 
-def test_empty_palette():
+def test_empty_palette() -> None:
     im = Image.new("P", (1, 1))
     assert im.getpalette() == []
 
 
-def test_undefined_palette_index():
+def test_undefined_palette_index() -> None:
     im = Image.new("P", (1, 1), 3)
     im.putpalette((1, 2, 3))
     assert im.convert("RGB").getpixel((0, 0)) == (0, 0, 0)
diff --git a/Tests/test_image_reduce.py b/Tests/test_image_reduce.py
index ba9100415a2..c29830a7e5f 100644
--- a/Tests/test_image_reduce.py
+++ b/Tests/test_image_reduce.py
@@ -48,7 +48,7 @@
         ((1, 3), (10, 4)),
     ),
 )
-def test_args_factor(size, expected):
+def test_args_factor(size, expected) -> None:
     im = Image.new("L", (10, 10))
     assert expected == im.reduce(size).size
 
@@ -56,7 +56,7 @@ def test_args_factor(size, expected):
 @pytest.mark.parametrize(
     "size, expected_error", ((0, ValueError), (2.0, TypeError), ((0, 10), ValueError))
 )
-def test_args_factor_error(size, expected_error):
+def test_args_factor_error(size, expected_error) -> None:
     im = Image.new("L", (10, 10))
     with pytest.raises(expected_error):
         im.reduce(size)
@@ -69,7 +69,7 @@ def test_args_factor_error(size, expected_error):
         ((5, 5, 6, 6), (1, 1)),
     ),
 )
-def test_args_box(size, expected):
+def test_args_box(size, expected) -> None:
     im = Image.new("L", (10, 10))
     assert expected == im.reduce(2, size).size
 
@@ -86,14 +86,14 @@ def test_args_box(size, expected):
         ((5, 0, 5, 10), ValueError),
     ),
 )
-def test_args_box_error(size, expected_error):
+def test_args_box_error(size, expected_error) -> None:
     im = Image.new("L", (10, 10))
     with pytest.raises(expected_error):
         im.reduce(2, size).size
 
 
 @pytest.mark.parametrize("mode", ("P", "1", "I;16"))
-def test_unsupported_modes(mode):
+def test_unsupported_modes(mode) -> None:
     im = Image.new("P", (10, 10))
     with pytest.raises(ValueError):
         im.reduce(3)
@@ -119,14 +119,16 @@ def get_image(mode):
     return im.crop((0, 0, im.width, im.height - 5))
 
 
-def compare_reduce_with_box(im, factor):
+def compare_reduce_with_box(im, factor) -> None:
     box = (11, 13, 146, 164)
     reduced = im.reduce(factor, box=box)
     reference = im.crop(box).reduce(factor)
     assert reduced == reference
 
 
-def compare_reduce_with_reference(im, factor, average_diff=0.4, max_diff=1):
+def compare_reduce_with_reference(
+    im, factor, average_diff: float = 0.4, max_diff: int = 1
+) -> None:
     """Image.reduce() should look very similar to Image.resize(BOX).
 
     A reference image is compiled from a large source area
@@ -171,7 +173,7 @@ def compare_reduce_with_reference(im, factor, average_diff=0.4, max_diff=1):
     assert_compare_images(reduced, reference, average_diff, max_diff)
 
 
-def assert_compare_images(a, b, max_average_diff, max_diff=255):
+def assert_compare_images(a, b, max_average_diff, max_diff: int = 255) -> None:
     assert a.mode == b.mode, f"got mode {repr(a.mode)}, expected {repr(b.mode)}"
     assert a.size == b.size, f"got size {repr(a.size)}, expected {repr(b.size)}"
 
@@ -199,20 +201,20 @@ def assert_compare_images(a, b, max_average_diff, max_diff=255):
 
 
 @pytest.mark.parametrize("factor", remarkable_factors)
-def test_mode_L(factor):
+def test_mode_L(factor) -> None:
     im = get_image("L")
     compare_reduce_with_reference(im, factor)
     compare_reduce_with_box(im, factor)
 
 
 @pytest.mark.parametrize("factor", remarkable_factors)
-def test_mode_LA(factor):
+def test_mode_LA(factor) -> None:
     im = get_image("LA")
     compare_reduce_with_reference(im, factor, 0.8, 5)
 
 
 @pytest.mark.parametrize("factor", remarkable_factors)
-def test_mode_LA_opaque(factor):
+def test_mode_LA_opaque(factor) -> None:
     im = get_image("LA")
     # With opaque alpha, an error should be way smaller.
     im.putalpha(Image.new("L", im.size, 255))
@@ -221,27 +223,27 @@ def test_mode_LA_opaque(factor):
 
 
 @pytest.mark.parametrize("factor", remarkable_factors)
-def test_mode_La(factor):
+def test_mode_La(factor) -> None:
     im = get_image("La")
     compare_reduce_with_reference(im, factor)
     compare_reduce_with_box(im, factor)
 
 
 @pytest.mark.parametrize("factor", remarkable_factors)
-def test_mode_RGB(factor):
+def test_mode_RGB(factor) -> None:
     im = get_image("RGB")
     compare_reduce_with_reference(im, factor)
     compare_reduce_with_box(im, factor)
 
 
 @pytest.mark.parametrize("factor", remarkable_factors)
-def test_mode_RGBA(factor):
+def test_mode_RGBA(factor) -> None:
     im = get_image("RGBA")
     compare_reduce_with_reference(im, factor, 0.8, 5)
 
 
 @pytest.mark.parametrize("factor", remarkable_factors)
-def test_mode_RGBA_opaque(factor):
+def test_mode_RGBA_opaque(factor) -> None:
     im = get_image("RGBA")
     # With opaque alpha, an error should be way smaller.
     im.putalpha(Image.new("L", im.size, 255))
@@ -250,27 +252,27 @@ def test_mode_RGBA_opaque(factor):
 
 
 @pytest.mark.parametrize("factor", remarkable_factors)
-def test_mode_RGBa(factor):
+def test_mode_RGBa(factor) -> None:
     im = get_image("RGBa")
     compare_reduce_with_reference(im, factor)
     compare_reduce_with_box(im, factor)
 
 
 @pytest.mark.parametrize("factor", remarkable_factors)
-def test_mode_I(factor):
+def test_mode_I(factor) -> None:
     im = get_image("I")
     compare_reduce_with_reference(im, factor)
     compare_reduce_with_box(im, factor)
 
 
 @pytest.mark.parametrize("factor", remarkable_factors)
-def test_mode_F(factor):
+def test_mode_F(factor) -> None:
     im = get_image("F")
     compare_reduce_with_reference(im, factor, 0, 0)
     compare_reduce_with_box(im, factor)
 
 
 @skip_unless_feature("jpg_2000")
-def test_jpeg2k():
+def test_jpeg2k() -> None:
     with Image.open("Tests/images/test-card-lossless.jp2") as im:
         assert im.reduce(2).size == (320, 240)
diff --git a/Tests/test_image_resample.py b/Tests/test_image_resample.py
index af730dce13d..f4c9eb0e6fa 100644
--- a/Tests/test_image_resample.py
+++ b/Tests/test_image_resample.py
@@ -16,7 +16,7 @@
 
 class TestImagingResampleVulnerability:
     # see https://github.com/python-pillow/Pillow/issues/1710
-    def test_overflow(self):
+    def test_overflow(self) -> None:
         im = hopper("L")
         size_too_large = 0x100000008 // 4
         size_normal = 1000  # unimportant
@@ -28,7 +28,7 @@ def test_overflow(self):
                 # any resampling filter will do here
                 im.im.resize((xsize, ysize), Image.Resampling.BILINEAR)
 
-    def test_invalid_size(self):
+    def test_invalid_size(self) -> None:
         im = hopper()
 
         # Should not crash
@@ -40,7 +40,7 @@ def test_invalid_size(self):
         with pytest.raises(ValueError):
             im.resize((100, -100))
 
-    def test_modify_after_resizing(self):
+    def test_modify_after_resizing(self) -> None:
         im = hopper("RGB")
         # get copy with same size
         copy = im.resize(im.size)
@@ -83,7 +83,7 @@ def make_sample(self, data, size):
                 s_px[size[0] - x - 1, y] = 255 - val
         return sample
 
-    def check_case(self, case, sample):
+    def check_case(self, case, sample) -> None:
         s_px = sample.load()
         c_px = case.load()
         for y in range(case.size[1]):
@@ -103,7 +103,7 @@ def serialize_image(self, image):
         )
 
     @pytest.mark.parametrize("mode", ("RGBX", "RGB", "La", "L"))
-    def test_reduce_box(self, mode):
+    def test_reduce_box(self, mode) -> None:
         case = self.make_case(mode, (8, 8), 0xE1)
         case = case.resize((4, 4), Image.Resampling.BOX)
         # fmt: off
@@ -114,7 +114,7 @@ def test_reduce_box(self, mode):
             self.check_case(channel, self.make_sample(data, (4, 4)))
 
     @pytest.mark.parametrize("mode", ("RGBX", "RGB", "La", "L"))
-    def test_reduce_bilinear(self, mode):
+    def test_reduce_bilinear(self, mode) -> None:
         case = self.make_case(mode, (8, 8), 0xE1)
         case = case.resize((4, 4), Image.Resampling.BILINEAR)
         # fmt: off
@@ -125,7 +125,7 @@ def test_reduce_bilinear(self, mode):
             self.check_case(channel, self.make_sample(data, (4, 4)))
 
     @pytest.mark.parametrize("mode", ("RGBX", "RGB", "La", "L"))
-    def test_reduce_hamming(self, mode):
+    def test_reduce_hamming(self, mode) -> None:
         case = self.make_case(mode, (8, 8), 0xE1)
         case = case.resize((4, 4), Image.Resampling.HAMMING)
         # fmt: off
@@ -136,7 +136,7 @@ def test_reduce_hamming(self, mode):
             self.check_case(channel, self.make_sample(data, (4, 4)))
 
     @pytest.mark.parametrize("mode", ("RGBX", "RGB", "La", "L"))
-    def test_reduce_bicubic(self, mode):
+    def test_reduce_bicubic(self, mode) -> None:
         case = self.make_case(mode, (12, 12), 0xE1)
         case = case.resize((6, 6), Image.Resampling.BICUBIC)
         # fmt: off
@@ -148,7 +148,7 @@ def test_reduce_bicubic(self, mode):
             self.check_case(channel, self.make_sample(data, (6, 6)))
 
     @pytest.mark.parametrize("mode", ("RGBX", "RGB", "La", "L"))
-    def test_reduce_lanczos(self, mode):
+    def test_reduce_lanczos(self, mode) -> None:
         case = self.make_case(mode, (16, 16), 0xE1)
         case = case.resize((8, 8), Image.Resampling.LANCZOS)
         # fmt: off
@@ -161,7 +161,7 @@ def test_reduce_lanczos(self, mode):
             self.check_case(channel, self.make_sample(data, (8, 8)))
 
     @pytest.mark.parametrize("mode", ("RGBX", "RGB", "La", "L"))
-    def test_enlarge_box(self, mode):
+    def test_enlarge_box(self, mode) -> None:
         case = self.make_case(mode, (2, 2), 0xE1)
         case = case.resize((4, 4), Image.Resampling.BOX)
         # fmt: off
@@ -172,7 +172,7 @@ def test_enlarge_box(self, mode):
             self.check_case(channel, self.make_sample(data, (4, 4)))
 
     @pytest.mark.parametrize("mode", ("RGBX", "RGB", "La", "L"))
-    def test_enlarge_bilinear(self, mode):
+    def test_enlarge_bilinear(self, mode) -> None:
         case = self.make_case(mode, (2, 2), 0xE1)
         case = case.resize((4, 4), Image.Resampling.BILINEAR)
         # fmt: off
@@ -183,7 +183,7 @@ def test_enlarge_bilinear(self, mode):
             self.check_case(channel, self.make_sample(data, (4, 4)))
 
     @pytest.mark.parametrize("mode", ("RGBX", "RGB", "La", "L"))
-    def test_enlarge_hamming(self, mode):
+    def test_enlarge_hamming(self, mode) -> None:
         case = self.make_case(mode, (2, 2), 0xE1)
         case = case.resize((4, 4), Image.Resampling.HAMMING)
         # fmt: off
@@ -194,7 +194,7 @@ def test_enlarge_hamming(self, mode):
             self.check_case(channel, self.make_sample(data, (4, 4)))
 
     @pytest.mark.parametrize("mode", ("RGBX", "RGB", "La", "L"))
-    def test_enlarge_bicubic(self, mode):
+    def test_enlarge_bicubic(self, mode) -> None:
         case = self.make_case(mode, (4, 4), 0xE1)
         case = case.resize((8, 8), Image.Resampling.BICUBIC)
         # fmt: off
@@ -207,7 +207,7 @@ def test_enlarge_bicubic(self, mode):
             self.check_case(channel, self.make_sample(data, (8, 8)))
 
     @pytest.mark.parametrize("mode", ("RGBX", "RGB", "La", "L"))
-    def test_enlarge_lanczos(self, mode):
+    def test_enlarge_lanczos(self, mode) -> None:
         case = self.make_case(mode, (6, 6), 0xE1)
         case = case.resize((12, 12), Image.Resampling.LANCZOS)
         data = (
@@ -221,7 +221,7 @@ def test_enlarge_lanczos(self, mode):
         for channel in case.split():
             self.check_case(channel, self.make_sample(data, (12, 12)))
 
-    def test_box_filter_correct_range(self):
+    def test_box_filter_correct_range(self) -> None:
         im = Image.new("RGB", (8, 8), "#1688ff").resize(
             (100, 100), Image.Resampling.BOX
         )
@@ -234,7 +234,7 @@ def make_case(self, mode, fill):
         im = Image.new(mode, (512, 9), fill)
         return im.resize((9, 512), Image.Resampling.LANCZOS), im.load()[0, 0]
 
-    def run_case(self, case):
+    def run_case(self, case) -> None:
         channel, color = case
         px = channel.load()
         for x in range(channel.size[0]):
@@ -243,7 +243,7 @@ def run_case(self, case):
                     message = f"{px[x, y]} != {color} for pixel {(x, y)}"
                     assert px[x, y] == color, message
 
-    def test_8u(self):
+    def test_8u(self) -> None:
         im, color = self.make_case("RGB", (0, 64, 255))
         r, g, b = im.split()
         self.run_case((r, color[0]))
@@ -251,13 +251,13 @@ def test_8u(self):
         self.run_case((b, color[2]))
         self.run_case(self.make_case("L", 12))
 
-    def test_32i(self):
+    def test_32i(self) -> None:
         self.run_case(self.make_case("I", 12))
         self.run_case(self.make_case("I", 0x7FFFFFFF))
         self.run_case(self.make_case("I", -12))
         self.run_case(self.make_case("I", -1 << 31))
 
-    def test_32f(self):
+    def test_32f(self) -> None:
         self.run_case(self.make_case("F", 1))
         self.run_case(self.make_case("F", 3.40282306074e38))
         self.run_case(self.make_case("F", 1.175494e-38))
@@ -275,7 +275,7 @@ def make_levels_case(self, mode):
                 px[x, y] = tuple(pix)
         return i
 
-    def run_levels_case(self, i):
+    def run_levels_case(self, i) -> None:
         px = i.load()
         for y in range(i.size[1]):
             used_colors = {px[x, y][0] for x in range(i.size[0])}
@@ -285,7 +285,7 @@ def run_levels_case(self, i):
             )
 
     @pytest.mark.xfail(reason="Current implementation isn't precise enough")
-    def test_levels_rgba(self):
+    def test_levels_rgba(self) -> None:
         case = self.make_levels_case("RGBA")
         self.run_levels_case(case.resize((512, 32), Image.Resampling.BOX))
         self.run_levels_case(case.resize((512, 32), Image.Resampling.BILINEAR))
@@ -294,7 +294,7 @@ def test_levels_rgba(self):
         self.run_levels_case(case.resize((512, 32), Image.Resampling.LANCZOS))
 
     @pytest.mark.xfail(reason="Current implementation isn't precise enough")
-    def test_levels_la(self):
+    def test_levels_la(self) -> None:
         case = self.make_levels_case("LA")
         self.run_levels_case(case.resize((512, 32), Image.Resampling.BOX))
         self.run_levels_case(case.resize((512, 32), Image.Resampling.BILINEAR))
@@ -312,7 +312,7 @@ def make_dirty_case(self, mode, clean_pixel, dirty_pixel):
                 px[x + xdiv4, y + ydiv4] = clean_pixel
         return i
 
-    def run_dirty_case(self, i, clean_pixel):
+    def run_dirty_case(self, i, clean_pixel) -> None:
         px = i.load()
         for y in range(i.size[1]):
             for x in range(i.size[0]):
@@ -323,7 +323,7 @@ def run_dirty_case(self, i, clean_pixel):
                     )
                     assert px[x, y][:3] == clean_pixel, message
 
-    def test_dirty_pixels_rgba(self):
+    def test_dirty_pixels_rgba(self) -> None:
         case = self.make_dirty_case("RGBA", (255, 255, 0, 128), (0, 0, 255, 0))
         self.run_dirty_case(case.resize((20, 20), Image.Resampling.BOX), (255, 255, 0))
         self.run_dirty_case(
@@ -339,7 +339,7 @@ def test_dirty_pixels_rgba(self):
             case.resize((20, 20), Image.Resampling.LANCZOS), (255, 255, 0)
         )
 
-    def test_dirty_pixels_la(self):
+    def test_dirty_pixels_la(self) -> None:
         case = self.make_dirty_case("LA", (255, 128), (0, 0))
         self.run_dirty_case(case.resize((20, 20), Image.Resampling.BOX), (255,))
         self.run_dirty_case(case.resize((20, 20), Image.Resampling.BILINEAR), (255,))
@@ -355,22 +355,22 @@ def count(self, diff):
         yield
         assert Image.core.get_stats()["new_count"] - count == diff
 
-    def test_horizontal(self):
+    def test_horizontal(self) -> None:
         im = hopper("L")
         with self.count(1):
             im.resize((im.size[0] - 10, im.size[1]), Image.Resampling.BILINEAR)
 
-    def test_vertical(self):
+    def test_vertical(self) -> None:
         im = hopper("L")
         with self.count(1):
             im.resize((im.size[0], im.size[1] - 10), Image.Resampling.BILINEAR)
 
-    def test_both(self):
+    def test_both(self) -> None:
         im = hopper("L")
         with self.count(2):
             im.resize((im.size[0] - 10, im.size[1] - 10), Image.Resampling.BILINEAR)
 
-    def test_box_horizontal(self):
+    def test_box_horizontal(self) -> None:
         im = hopper("L")
         box = (20, 0, im.size[0] - 20, im.size[1])
         with self.count(1):
@@ -380,7 +380,7 @@ def test_box_horizontal(self):
             cropped = im.crop(box).resize(im.size, Image.Resampling.BILINEAR)
         assert_image_similar(with_box, cropped, 0.1)
 
-    def test_box_vertical(self):
+    def test_box_vertical(self) -> None:
         im = hopper("L")
         box = (0, 20, im.size[0], im.size[1] - 20)
         with self.count(1):
@@ -392,7 +392,7 @@ def test_box_vertical(self):
 
 
 class TestCoreResampleCoefficients:
-    def test_reduce(self):
+    def test_reduce(self) -> None:
         test_color = 254
 
         for size in range(400000, 400010, 2):
@@ -404,7 +404,7 @@ def test_reduce(self):
             if px[2, 0] != test_color // 2:
                 assert test_color // 2 == px[2, 0]
 
-    def test_non_zero_coefficients(self):
+    def test_non_zero_coefficients(self) -> None:
         # regression test for the wrong coefficients calculation
         # due to bug https://github.com/python-pillow/Pillow/issues/2161
         im = Image.new("RGBA", (1280, 1280), (0x20, 0x40, 0x60, 0xFF))
@@ -432,7 +432,7 @@ class TestCoreResampleBox:
             Image.Resampling.LANCZOS,
         ),
     )
-    def test_wrong_arguments(self, resample):
+    def test_wrong_arguments(self, resample) -> None:
         im = hopper()
         im.resize((32, 32), resample, (0, 0, im.width, im.height))
         im.resize((32, 32), resample, (20, 20, im.width, im.height))
@@ -478,7 +478,7 @@ def split_range(size, tiles):
     @mark_if_feature_version(
         pytest.mark.valgrind_known_error, "libjpeg_turbo", "2.0", reason="Known Failing"
     )
-    def test_tiles(self):
+    def test_tiles(self) -> None:
         with Image.open("Tests/images/flower.jpg") as im:
             assert im.size == (480, 360)
             dst_size = (251, 188)
@@ -491,7 +491,7 @@ def test_tiles(self):
     @mark_if_feature_version(
         pytest.mark.valgrind_known_error, "libjpeg_turbo", "2.0", reason="Known Failing"
     )
-    def test_subsample(self):
+    def test_subsample(self) -> None:
         # This test shows advantages of the subpixel resizing
         # after supersampling (e.g. during JPEG decoding).
         with Image.open("Tests/images/flower.jpg") as im:
@@ -518,14 +518,14 @@ def test_subsample(self):
     @pytest.mark.parametrize(
         "resample", (Image.Resampling.NEAREST, Image.Resampling.BILINEAR)
     )
-    def test_formats(self, mode, resample):
+    def test_formats(self, mode, resample) -> None:
         im = hopper(mode)
         box = (20, 20, im.size[0] - 20, im.size[1] - 20)
         with_box = im.resize((32, 32), resample, box)
         cropped = im.crop(box).resize((32, 32), resample)
         assert_image_similar(cropped, with_box, 0.4)
 
-    def test_passthrough(self):
+    def test_passthrough(self) -> None:
         # When no resize is required
         im = hopper()
 
@@ -539,7 +539,7 @@ def test_passthrough(self):
             assert res.size == size
             assert_image_equal(res, im.crop(box), f">>> {size} {box}")
 
-    def test_no_passthrough(self):
+    def test_no_passthrough(self) -> None:
         # When resize is required
         im = hopper()
 
@@ -558,7 +558,7 @@ def test_no_passthrough(self):
     @pytest.mark.parametrize(
         "flt", (Image.Resampling.NEAREST, Image.Resampling.BICUBIC)
     )
-    def test_skip_horizontal(self, flt):
+    def test_skip_horizontal(self, flt) -> None:
         # Can skip resize for one dimension
         im = hopper()
 
@@ -581,7 +581,7 @@ def test_skip_horizontal(self, flt):
     @pytest.mark.parametrize(
         "flt", (Image.Resampling.NEAREST, Image.Resampling.BICUBIC)
     )
-    def test_skip_vertical(self, flt):
+    def test_skip_vertical(self, flt) -> None:
         # Can skip resize for one dimension
         im = hopper()
 
diff --git a/Tests/test_image_rotate.py b/Tests/test_image_rotate.py
index e63fef2c152..51e0f585421 100644
--- a/Tests/test_image_rotate.py
+++ b/Tests/test_image_rotate.py
@@ -12,7 +12,7 @@
 )
 
 
-def rotate(im, mode, angle, center=None, translate=None):
+def rotate(im, mode, angle, center=None, translate=None) -> None:
     out = im.rotate(angle, center=center, translate=translate)
     assert out.mode == mode
     assert out.size == im.size  # default rotate clips output
@@ -27,13 +27,13 @@ def rotate(im, mode, angle, center=None, translate=None):
 
 
 @pytest.mark.parametrize("mode", ("1", "P", "L", "RGB", "I", "F"))
-def test_mode(mode):
+def test_mode(mode) -> None:
     im = hopper(mode)
     rotate(im, mode, 45)
 
 
 @pytest.mark.parametrize("angle", (0, 90, 180, 270))
-def test_angle(angle):
+def test_angle(angle) -> None:
     with Image.open("Tests/images/test-card.png") as im:
         rotate(im, im.mode, angle)
 
@@ -42,12 +42,12 @@ def test_angle(angle):
 
 
 @pytest.mark.parametrize("angle", (0, 45, 90, 180, 270))
-def test_zero(angle):
+def test_zero(angle) -> None:
     im = Image.new("RGB", (0, 0))
     rotate(im, im.mode, angle)
 
 
-def test_resample():
+def test_resample() -> None:
     # Target image creation, inspected by eye.
     # >>> im = Image.open('Tests/images/hopper.ppm')
     # >>> im = im.rotate(45, resample=Image.Resampling.BICUBIC, expand=True)
@@ -64,7 +64,7 @@ def test_resample():
             assert_image_similar(im, target, epsilon)
 
 
-def test_center_0():
+def test_center_0() -> None:
     im = hopper()
     im = im.rotate(45, center=(0, 0), resample=Image.Resampling.BICUBIC)
 
@@ -75,7 +75,7 @@ def test_center_0():
     assert_image_similar(im, target, 15)
 
 
-def test_center_14():
+def test_center_14() -> None:
     im = hopper()
     im = im.rotate(45, center=(14, 14), resample=Image.Resampling.BICUBIC)
 
@@ -86,7 +86,7 @@ def test_center_14():
         assert_image_similar(im, target, 10)
 
 
-def test_translate():
+def test_translate() -> None:
     im = hopper()
     with Image.open("Tests/images/hopper_45.png") as target:
         target_origin = (target.size[1] / 2 - 64) - 5
@@ -99,7 +99,7 @@ def test_translate():
     assert_image_similar(im, target, 1)
 
 
-def test_fastpath_center():
+def test_fastpath_center() -> None:
     # if the center is -1,-1 and we rotate by 90<=x<=270 the
     # resulting image should be black
     for angle in (90, 180, 270):
@@ -107,7 +107,7 @@ def test_fastpath_center():
         assert_image_equal(im, Image.new("RGB", im.size, "black"))
 
 
-def test_fastpath_translate():
+def test_fastpath_translate() -> None:
     # if we post-translate by -128
     # resulting image should be black
     for angle in (0, 90, 180, 270):
@@ -115,26 +115,26 @@ def test_fastpath_translate():
         assert_image_equal(im, Image.new("RGB", im.size, "black"))
 
 
-def test_center():
+def test_center() -> None:
     im = hopper()
     rotate(im, im.mode, 45, center=(0, 0))
     rotate(im, im.mode, 45, translate=(im.size[0] / 2, 0))
     rotate(im, im.mode, 45, center=(0, 0), translate=(im.size[0] / 2, 0))
 
 
-def test_rotate_no_fill():
+def test_rotate_no_fill() -> None:
     im = Image.new("RGB", (100, 100), "green")
     im = im.rotate(45)
     assert_image_equal_tofile(im, "Tests/images/rotate_45_no_fill.png")
 
 
-def test_rotate_with_fill():
+def test_rotate_with_fill() -> None:
     im = Image.new("RGB", (100, 100), "green")
     im = im.rotate(45, fillcolor="white")
     assert_image_equal_tofile(im, "Tests/images/rotate_45_with_fill.png")
 
 
-def test_alpha_rotate_no_fill():
+def test_alpha_rotate_no_fill() -> None:
     # Alpha images are handled differently internally
     im = Image.new("RGBA", (10, 10), "green")
     im = im.rotate(45, expand=1)
@@ -142,7 +142,7 @@ def test_alpha_rotate_no_fill():
     assert corner == (0, 0, 0, 0)
 
 
-def test_alpha_rotate_with_fill():
+def test_alpha_rotate_with_fill() -> None:
     # Alpha images are handled differently internally
     im = Image.new("RGBA", (10, 10), "green")
     im = im.rotate(45, expand=1, fillcolor=(255, 0, 0, 255))
diff --git a/Tests/test_image_thumbnail.py b/Tests/test_image_thumbnail.py
index 7fa5692aa7d..6aeeea2ed0d 100644
--- a/Tests/test_image_thumbnail.py
+++ b/Tests/test_image_thumbnail.py
@@ -14,14 +14,14 @@
 )
 
 
-def test_sanity():
+def test_sanity() -> None:
     im = hopper()
     assert im.thumbnail((100, 100)) is None
 
     assert im.size == (100, 100)
 
 
-def test_aspect():
+def test_aspect() -> None:
     im = Image.new("L", (128, 128))
     im.thumbnail((100, 100))
     assert im.size == (100, 100)
@@ -67,19 +67,19 @@ def test_aspect():
     assert im.size == (75, 23)  # ratio is 3.260869565217
 
 
-def test_division_by_zero():
+def test_division_by_zero() -> None:
     im = Image.new("L", (200, 2))
     im.thumbnail((75, 75))
     assert im.size == (75, 1)
 
 
-def test_float():
+def test_float() -> None:
     im = Image.new("L", (128, 128))
     im.thumbnail((99.9, 99.9))
     assert im.size == (99, 99)
 
 
-def test_no_resize():
+def test_no_resize() -> None:
     # Check that draft() can resize the image to the destination size
     with Image.open("Tests/images/hopper.jpg") as im:
         im.draft(None, (64, 64))
@@ -92,7 +92,7 @@ def test_no_resize():
 
 
 @skip_unless_feature("libtiff")
-def test_load_first():
+def test_load_first() -> None:
     # load() may change the size of the image
     # Test that thumbnail() is calling it before performing size calculations
     with Image.open("Tests/images/g4_orientation_5.tif") as im:
@@ -106,7 +106,7 @@ def test_load_first():
         assert im.size == (590, 88)
 
 
-def test_load_first_unless_jpeg():
+def test_load_first_unless_jpeg() -> None:
     # Test that thumbnail() still uses draft() for JPEG
     with Image.open("Tests/images/hopper.jpg") as im:
         draft = im.draft
@@ -124,7 +124,7 @@ def im_draft(mode, size):
 
 # valgrind test is failing with memory allocated in libjpeg
 @pytest.mark.valgrind_known_error(reason="Known Failing")
-def test_DCT_scaling_edges():
+def test_DCT_scaling_edges() -> None:
     # Make an image with red borders and size (N * 8) + 1 to cross DCT grid
     im = Image.new("RGB", (257, 257), "red")
     im.paste(Image.new("RGB", (235, 235)), (11, 11))
@@ -138,7 +138,7 @@ def test_DCT_scaling_edges():
     assert_image_similar(thumb, ref, 1.5)
 
 
-def test_reducing_gap_values():
+def test_reducing_gap_values() -> None:
     im = hopper()
     im.thumbnail((18, 18), Image.Resampling.BICUBIC)
 
@@ -155,7 +155,7 @@ def test_reducing_gap_values():
     assert_image_similar(ref, im, 3.5)
 
 
-def test_reducing_gap_for_DCT_scaling():
+def test_reducing_gap_for_DCT_scaling() -> None:
     with Image.open("Tests/images/hopper.jpg") as ref:
         # thumbnail should call draft with reducing_gap scale
         ref.draft(None, (18 * 3, 18 * 3))
diff --git a/Tests/test_image_transform.py b/Tests/test_image_transform.py
index 0fe9fd1d5f5..1067dd563c1 100644
--- a/Tests/test_image_transform.py
+++ b/Tests/test_image_transform.py
@@ -10,7 +10,7 @@
 
 
 class TestImageTransform:
-    def test_sanity(self):
+    def test_sanity(self) -> None:
         im = hopper()
 
         for transform in (
@@ -31,7 +31,7 @@ def test_sanity(self):
         ):
             assert_image_equal(im, im.transform(im.size, transform))
 
-    def test_info(self):
+    def test_info(self) -> None:
         comment = b"File written by Adobe Photoshop\xa8 4.0"
 
         with Image.open("Tests/images/hopper.gif") as im:
@@ -41,14 +41,14 @@ def test_info(self):
             new_im = im.transform((100, 100), transform)
         assert new_im.info["comment"] == comment
 
-    def test_palette(self):
+    def test_palette(self) -> None:
         with Image.open("Tests/images/hopper.gif") as im:
             transformed = im.transform(
                 im.size, Image.Transform.AFFINE, [1, 0, 0, 0, 1, 0]
             )
             assert im.palette.palette == transformed.palette.palette
 
-    def test_extent(self):
+    def test_extent(self) -> None:
         im = hopper("RGB")
         (w, h) = im.size
         transformed = im.transform(
@@ -63,7 +63,7 @@ def test_extent(self):
         # undone -- precision?
         assert_image_similar(transformed, scaled, 23)
 
-    def test_quad(self):
+    def test_quad(self) -> None:
         # one simple quad transform, equivalent to scale & crop upper left quad
         im = hopper("RGB")
         (w, h) = im.size
@@ -91,7 +91,7 @@ def test_quad(self):
             ("LA", (76, 0)),
         ),
     )
-    def test_fill(self, mode, expected_pixel):
+    def test_fill(self, mode, expected_pixel) -> None:
         im = hopper(mode)
         (w, h) = im.size
         transformed = im.transform(
@@ -103,7 +103,7 @@ def test_fill(self, mode, expected_pixel):
         )
         assert transformed.getpixel((w - 1, h - 1)) == expected_pixel
 
-    def test_mesh(self):
+    def test_mesh(self) -> None:
         # this should be a checkerboard of halfsized hoppers in ul, lr
         im = hopper("RGBA")
         (w, h) = im.size
@@ -142,7 +142,7 @@ def test_mesh(self):
         assert_image_equal(blank, transformed.crop((w // 2, 0, w, h // 2)))
         assert_image_equal(blank, transformed.crop((0, h // 2, w // 2, h)))
 
-    def _test_alpha_premult(self, op):
+    def _test_alpha_premult(self, op) -> None:
         # create image with half white, half black,
         # with the black half transparent.
         # do op,
@@ -158,13 +158,13 @@ def _test_alpha_premult(self, op):
         hist = im_background.histogram()
         assert 40 * 10 == hist[-1]
 
-    def test_alpha_premult_resize(self):
+    def test_alpha_premult_resize(self) -> None:
         def op(im, sz):
             return im.resize(sz, Image.Resampling.BILINEAR)
 
         self._test_alpha_premult(op)
 
-    def test_alpha_premult_transform(self):
+    def test_alpha_premult_transform(self) -> None:
         def op(im, sz):
             (w, h) = im.size
             return im.transform(
@@ -173,7 +173,7 @@ def op(im, sz):
 
         self._test_alpha_premult(op)
 
-    def _test_nearest(self, op, mode):
+    def _test_nearest(self, op, mode) -> None:
         # create white image with half transparent,
         # do op,
         # the image should remain white with half transparent
@@ -196,14 +196,14 @@ def _test_nearest(self, op, mode):
         )
 
     @pytest.mark.parametrize("mode", ("RGBA", "LA"))
-    def test_nearest_resize(self, mode):
+    def test_nearest_resize(self, mode) -> None:
         def op(im, sz):
             return im.resize(sz, Image.Resampling.NEAREST)
 
         self._test_nearest(op, mode)
 
     @pytest.mark.parametrize("mode", ("RGBA", "LA"))
-    def test_nearest_transform(self, mode):
+    def test_nearest_transform(self, mode) -> None:
         def op(im, sz):
             (w, h) = im.size
             return im.transform(
@@ -212,7 +212,7 @@ def op(im, sz):
 
         self._test_nearest(op, mode)
 
-    def test_blank_fill(self):
+    def test_blank_fill(self) -> None:
         # attempting to hit
         # https://github.com/python-pillow/Pillow/issues/254 reported
         #
@@ -234,13 +234,13 @@ def test_blank_fill(self):
 
         self.test_mesh()
 
-    def test_missing_method_data(self):
+    def test_missing_method_data(self) -> None:
         with hopper() as im:
             with pytest.raises(ValueError):
                 im.transform((100, 100), None)
 
     @pytest.mark.parametrize("resample", (Image.Resampling.BOX, "unknown"))
-    def test_unknown_resampling_filter(self, resample):
+    def test_unknown_resampling_filter(self, resample) -> None:
         with hopper() as im:
             (w, h) = im.size
             with pytest.raises(ValueError):
@@ -263,7 +263,7 @@ def _test_image(self):
             (270, Image.Transpose.ROTATE_270),
         ),
     )
-    def test_rotate(self, deg, transpose):
+    def test_rotate(self, deg, transpose) -> None:
         im = self._test_image()
 
         angle = -math.radians(deg)
@@ -313,7 +313,7 @@ def test_rotate(self, deg, transpose):
             (Image.Resampling.BICUBIC, 1),
         ),
     )
-    def test_resize(self, scale, epsilon_scale, resample, epsilon):
+    def test_resize(self, scale, epsilon_scale, resample, epsilon) -> None:
         im = self._test_image()
 
         size_up = int(round(im.width * scale)), int(round(im.height * scale))
@@ -342,7 +342,7 @@ def test_resize(self, scale, epsilon_scale, resample, epsilon):
             (Image.Resampling.BICUBIC, 1),
         ),
     )
-    def test_translate(self, x, y, epsilon_scale, resample, epsilon):
+    def test_translate(self, x, y, epsilon_scale, resample, epsilon) -> None:
         im = self._test_image()
 
         size_up = int(round(im.width + x)), int(round(im.height + y))
diff --git a/Tests/test_imagechops.py b/Tests/test_imagechops.py
index 2f0614385aa..94f57e06690 100644
--- a/Tests/test_imagechops.py
+++ b/Tests/test_imagechops.py
@@ -15,7 +15,7 @@
 GRAY = 128
 
 
-def test_sanity():
+def test_sanity() -> None:
     im = hopper("L")
 
     ImageChops.constant(im, 128)
@@ -48,7 +48,7 @@ def test_sanity():
     ImageChops.offset(im, 10, 20)
 
 
-def test_add():
+def test_add() -> None:
     # Arrange
     with Image.open("Tests/images/imagedraw_ellipse_RGB.png") as im1:
         with Image.open("Tests/images/imagedraw_floodfill_RGB.png") as im2:
@@ -60,7 +60,7 @@ def test_add():
     assert new.getpixel((50, 50)) == ORANGE
 
 
-def test_add_scale_offset():
+def test_add_scale_offset() -> None:
     # Arrange
     with Image.open("Tests/images/imagedraw_ellipse_RGB.png") as im1:
         with Image.open("Tests/images/imagedraw_floodfill_RGB.png") as im2:
@@ -72,7 +72,7 @@ def test_add_scale_offset():
     assert new.getpixel((50, 50)) == (202, 151, 100)
 
 
-def test_add_clip():
+def test_add_clip() -> None:
     # Arrange
     im = hopper()
 
@@ -83,7 +83,7 @@ def test_add_clip():
     assert new.getpixel((50, 50)) == (255, 255, 254)
 
 
-def test_add_modulo():
+def test_add_modulo() -> None:
     # Arrange
     with Image.open("Tests/images/imagedraw_ellipse_RGB.png") as im1:
         with Image.open("Tests/images/imagedraw_floodfill_RGB.png") as im2:
@@ -95,7 +95,7 @@ def test_add_modulo():
     assert new.getpixel((50, 50)) == ORANGE
 
 
-def test_add_modulo_no_clip():
+def test_add_modulo_no_clip() -> None:
     # Arrange
     im = hopper()
 
@@ -106,7 +106,7 @@ def test_add_modulo_no_clip():
     assert new.getpixel((50, 50)) == (224, 76, 254)
 
 
-def test_blend():
+def test_blend() -> None:
     # Arrange
     with Image.open("Tests/images/imagedraw_ellipse_RGB.png") as im1:
         with Image.open("Tests/images/imagedraw_floodfill_RGB.png") as im2:
@@ -118,7 +118,7 @@ def test_blend():
     assert new.getpixel((50, 50)) == BROWN
 
 
-def test_constant():
+def test_constant() -> None:
     # Arrange
     im = Image.new("RGB", (20, 10))
 
@@ -131,7 +131,7 @@ def test_constant():
     assert new.getpixel((19, 9)) == GRAY
 
 
-def test_darker_image():
+def test_darker_image() -> None:
     # Arrange
     with Image.open("Tests/images/imagedraw_chord_RGB.png") as im1:
         with Image.open("Tests/images/imagedraw_outline_chord_RGB.png") as im2:
@@ -142,7 +142,7 @@ def test_darker_image():
             assert_image_equal(new, im2)
 
 
-def test_darker_pixel():
+def test_darker_pixel() -> None:
     # Arrange
     im1 = hopper()
     with Image.open("Tests/images/imagedraw_chord_RGB.png") as im2:
@@ -153,7 +153,7 @@ def test_darker_pixel():
     assert new.getpixel((50, 50)) == (240, 166, 0)
 
 
-def test_difference():
+def test_difference() -> None:
     # Arrange
     with Image.open("Tests/images/imagedraw_arc_end_le_start.png") as im1:
         with Image.open("Tests/images/imagedraw_arc_no_loops.png") as im2:
@@ -164,7 +164,7 @@ def test_difference():
     assert new.getbbox() == (25, 25, 76, 76)
 
 
-def test_difference_pixel():
+def test_difference_pixel() -> None:
     # Arrange
     im1 = hopper()
     with Image.open("Tests/images/imagedraw_polygon_kite_RGB.png") as im2:
@@ -175,7 +175,7 @@ def test_difference_pixel():
     assert new.getpixel((50, 50)) == (240, 166, 128)
 
 
-def test_duplicate():
+def test_duplicate() -> None:
     # Arrange
     im = hopper()
 
@@ -186,7 +186,7 @@ def test_duplicate():
     assert_image_equal(new, im)
 
 
-def test_invert():
+def test_invert() -> None:
     # Arrange
     with Image.open("Tests/images/imagedraw_floodfill_RGB.png") as im:
         # Act
@@ -198,7 +198,7 @@ def test_invert():
     assert new.getpixel((50, 50)) == CYAN
 
 
-def test_lighter_image():
+def test_lighter_image() -> None:
     # Arrange
     with Image.open("Tests/images/imagedraw_chord_RGB.png") as im1:
         with Image.open("Tests/images/imagedraw_outline_chord_RGB.png") as im2:
@@ -209,7 +209,7 @@ def test_lighter_image():
         assert_image_equal(new, im1)
 
 
-def test_lighter_pixel():
+def test_lighter_pixel() -> None:
     # Arrange
     im1 = hopper()
     with Image.open("Tests/images/imagedraw_chord_RGB.png") as im2:
@@ -220,7 +220,7 @@ def test_lighter_pixel():
     assert new.getpixel((50, 50)) == (255, 255, 127)
 
 
-def test_multiply_black():
+def test_multiply_black() -> None:
     """If you multiply an image with a solid black image,
     the result is black."""
     # Arrange
@@ -234,7 +234,7 @@ def test_multiply_black():
     assert_image_equal(new, black)
 
 
-def test_multiply_green():
+def test_multiply_green() -> None:
     # Arrange
     with Image.open("Tests/images/imagedraw_floodfill_RGB.png") as im:
         green = Image.new("RGB", im.size, "green")
@@ -248,7 +248,7 @@ def test_multiply_green():
     assert new.getpixel((50, 50)) == BLACK
 
 
-def test_multiply_white():
+def test_multiply_white() -> None:
     """If you multiply with a solid white image, the image is unaffected."""
     # Arrange
     im1 = hopper()
@@ -261,7 +261,7 @@ def test_multiply_white():
     assert_image_equal(new, im1)
 
 
-def test_offset():
+def test_offset() -> None:
     # Arrange
     xoffset = 45
     yoffset = 20
@@ -278,7 +278,7 @@ def test_offset():
         assert ImageChops.offset(im, xoffset) == ImageChops.offset(im, xoffset, xoffset)
 
 
-def test_screen():
+def test_screen() -> None:
     # Arrange
     with Image.open("Tests/images/imagedraw_ellipse_RGB.png") as im1:
         with Image.open("Tests/images/imagedraw_floodfill_RGB.png") as im2:
@@ -290,7 +290,7 @@ def test_screen():
     assert new.getpixel((50, 50)) == ORANGE
 
 
-def test_subtract():
+def test_subtract() -> None:
     # Arrange
     with Image.open("Tests/images/imagedraw_chord_RGB.png") as im1:
         with Image.open("Tests/images/imagedraw_outline_chord_RGB.png") as im2:
@@ -303,7 +303,7 @@ def test_subtract():
     assert new.getpixel((50, 52)) == BLACK
 
 
-def test_subtract_scale_offset():
+def test_subtract_scale_offset() -> None:
     # Arrange
     with Image.open("Tests/images/imagedraw_chord_RGB.png") as im1:
         with Image.open("Tests/images/imagedraw_outline_chord_RGB.png") as im2:
@@ -315,7 +315,7 @@ def test_subtract_scale_offset():
     assert new.getpixel((50, 50)) == (100, 202, 100)
 
 
-def test_subtract_clip():
+def test_subtract_clip() -> None:
     # Arrange
     im1 = hopper()
     with Image.open("Tests/images/imagedraw_chord_RGB.png") as im2:
@@ -326,7 +326,7 @@ def test_subtract_clip():
     assert new.getpixel((50, 50)) == (0, 0, 127)
 
 
-def test_subtract_modulo():
+def test_subtract_modulo() -> None:
     # Arrange
     with Image.open("Tests/images/imagedraw_chord_RGB.png") as im1:
         with Image.open("Tests/images/imagedraw_outline_chord_RGB.png") as im2:
@@ -339,7 +339,7 @@ def test_subtract_modulo():
     assert new.getpixel((50, 52)) == BLACK
 
 
-def test_subtract_modulo_no_clip():
+def test_subtract_modulo_no_clip() -> None:
     # Arrange
     im1 = hopper()
     with Image.open("Tests/images/imagedraw_chord_RGB.png") as im2:
@@ -350,7 +350,7 @@ def test_subtract_modulo_no_clip():
     assert new.getpixel((50, 50)) == (241, 167, 127)
 
 
-def test_soft_light():
+def test_soft_light() -> None:
     # Arrange
     with Image.open("Tests/images/hopper.png") as im1:
         with Image.open("Tests/images/hopper-XYZ.png") as im2:
@@ -362,7 +362,7 @@ def test_soft_light():
     assert new.getpixel((15, 100)) == (1, 1, 3)
 
 
-def test_hard_light():
+def test_hard_light() -> None:
     # Arrange
     with Image.open("Tests/images/hopper.png") as im1:
         with Image.open("Tests/images/hopper-XYZ.png") as im2:
@@ -374,7 +374,7 @@ def test_hard_light():
     assert new.getpixel((15, 100)) == (1, 1, 2)
 
 
-def test_overlay():
+def test_overlay() -> None:
     # Arrange
     with Image.open("Tests/images/hopper.png") as im1:
         with Image.open("Tests/images/hopper-XYZ.png") as im2:
@@ -386,7 +386,7 @@ def test_overlay():
     assert new.getpixel((15, 100)) == (1, 1, 2)
 
 
-def test_logical():
+def test_logical() -> None:
     def table(op, a, b):
         out = []
         for x in (a, b):
diff --git a/Tests/test_imagecms.py b/Tests/test_imagecms.py
index 03332699a1d..7f652715566 100644
--- a/Tests/test_imagecms.py
+++ b/Tests/test_imagecms.py
@@ -5,6 +5,7 @@
 import re
 import shutil
 from io import BytesIO
+from pathlib import Path
 
 import pytest
 
@@ -32,7 +33,7 @@
 HAVE_PROFILE = os.path.exists(SRGB)
 
 
-def setup_module():
+def setup_module() -> None:
     try:
         from PIL import ImageCms
 
@@ -42,12 +43,12 @@ def setup_module():
         pytest.skip(str(v))
 
 
-def skip_missing():
+def skip_missing() -> None:
     if not HAVE_PROFILE:
         pytest.skip("SRGB profile not available")
 
 
-def test_sanity():
+def test_sanity() -> None:
     # basic smoke test.
     # this mostly follows the cms_test outline.
     with pytest.warns(DeprecationWarning):
@@ -91,7 +92,7 @@ def test_sanity():
     hopper().point(t)
 
 
-def test_flags():
+def test_flags() -> None:
     assert ImageCms.Flags.NONE == 0
     assert ImageCms.Flags.GRIDPOINTS(0) == ImageCms.Flags.NONE
     assert ImageCms.Flags.GRIDPOINTS(256) == ImageCms.Flags.NONE
@@ -101,7 +102,7 @@ def test_flags():
     assert ImageCms.Flags.GRIDPOINTS(511) == ImageCms.Flags.GRIDPOINTS(255)
 
 
-def test_name():
+def test_name() -> None:
     skip_missing()
     # get profile information for file
     assert (
@@ -110,7 +111,7 @@ def test_name():
     )
 
 
-def test_info():
+def test_info() -> None:
     skip_missing()
     assert ImageCms.getProfileInfo(SRGB).splitlines() == [
         "sRGB IEC61966-2-1 black scaled",
@@ -120,7 +121,7 @@ def test_info():
     ]
 
 
-def test_copyright():
+def test_copyright() -> None:
     skip_missing()
     assert (
         ImageCms.getProfileCopyright(SRGB).strip()
@@ -128,12 +129,12 @@ def test_copyright():
     )
 
 
-def test_manufacturer():
+def test_manufacturer() -> None:
     skip_missing()
     assert ImageCms.getProfileManufacturer(SRGB).strip() == ""
 
 
-def test_model():
+def test_model() -> None:
     skip_missing()
     assert (
         ImageCms.getProfileModel(SRGB).strip()
@@ -141,14 +142,14 @@ def test_model():
     )
 
 
-def test_description():
+def test_description() -> None:
     skip_missing()
     assert (
         ImageCms.getProfileDescription(SRGB).strip() == "sRGB IEC61966-2-1 black scaled"
     )
 
 
-def test_intent():
+def test_intent() -> None:
     skip_missing()
     assert ImageCms.getDefaultIntent(SRGB) == 0
     support = ImageCms.isIntentSupported(
@@ -157,7 +158,7 @@ def test_intent():
     assert support == 1
 
 
-def test_profile_object():
+def test_profile_object() -> None:
     # same, using profile object
     p = ImageCms.createProfile("sRGB")
     # assert ImageCms.getProfileName(p).strip() == "sRGB built-in - (lcms internal)"
@@ -170,7 +171,7 @@ def test_profile_object():
     assert support == 1
 
 
-def test_extensions():
+def test_extensions() -> None:
     # extensions
 
     with Image.open("Tests/images/rgb.jpg") as i:
@@ -181,7 +182,7 @@ def test_extensions():
     )
 
 
-def test_exceptions():
+def test_exceptions() -> None:
     # Test mode mismatch
     psRGB = ImageCms.createProfile("sRGB")
     pLab = ImageCms.createProfile("LAB")
@@ -207,17 +208,17 @@ def test_exceptions():
         ImageCms.isIntentSupported(SRGB, None, None)
 
 
-def test_display_profile():
+def test_display_profile() -> None:
     # try fetching the profile for the current display device
     ImageCms.get_display_profile()
 
 
-def test_lab_color_profile():
+def test_lab_color_profile() -> None:
     ImageCms.createProfile("LAB", 5000)
     ImageCms.createProfile("LAB", 6500)
 
 
-def test_unsupported_color_space():
+def test_unsupported_color_space() -> None:
     with pytest.raises(
         ImageCms.PyCMSError,
         match=re.escape(
@@ -227,7 +228,7 @@ def test_unsupported_color_space():
         ImageCms.createProfile("unsupported")
 
 
-def test_invalid_color_temperature():
+def test_invalid_color_temperature() -> None:
     with pytest.raises(
         ImageCms.PyCMSError,
         match='Color temperature must be numeric, "invalid" not valid',
@@ -236,7 +237,7 @@ def test_invalid_color_temperature():
 
 
 @pytest.mark.parametrize("flag", ("my string", -1))
-def test_invalid_flag(flag):
+def test_invalid_flag(flag) -> None:
     with hopper() as im:
         with pytest.raises(
             ImageCms.PyCMSError, match="flags must be an integer between 0 and "
@@ -244,7 +245,7 @@ def test_invalid_flag(flag):
             ImageCms.profileToProfile(im, "foo", "bar", flags=flag)
 
 
-def test_simple_lab():
+def test_simple_lab() -> None:
     i = Image.new("RGB", (10, 10), (128, 128, 128))
 
     psRGB = ImageCms.createProfile("sRGB")
@@ -268,7 +269,7 @@ def test_simple_lab():
     assert list(b_data) == [128] * 100
 
 
-def test_lab_color():
+def test_lab_color() -> None:
     psRGB = ImageCms.createProfile("sRGB")
     pLab = ImageCms.createProfile("LAB")
     t = ImageCms.buildTransform(psRGB, pLab, "RGB", "LAB")
@@ -283,7 +284,7 @@ def test_lab_color():
     assert_image_similar_tofile(i, "Tests/images/hopper.Lab.tif", 3.5)
 
 
-def test_lab_srgb():
+def test_lab_srgb() -> None:
     psRGB = ImageCms.createProfile("sRGB")
     pLab = ImageCms.createProfile("LAB")
     t = ImageCms.buildTransform(pLab, psRGB, "LAB", "RGB")
@@ -300,7 +301,7 @@ def test_lab_srgb():
     assert "sRGB" in ImageCms.getProfileDescription(profile)
 
 
-def test_lab_roundtrip():
+def test_lab_roundtrip() -> None:
     # check to see if we're at least internally consistent.
     psRGB = ImageCms.createProfile("sRGB")
     pLab = ImageCms.createProfile("LAB")
@@ -317,7 +318,7 @@ def test_lab_roundtrip():
     assert_image_similar(hopper(), out, 2)
 
 
-def test_profile_tobytes():
+def test_profile_tobytes() -> None:
     with Image.open("Tests/images/rgb.jpg") as i:
         p = ImageCms.getOpenProfile(BytesIO(i.info["icc_profile"]))
 
@@ -329,12 +330,12 @@ def test_profile_tobytes():
     assert ImageCms.getProfileDescription(p) == ImageCms.getProfileDescription(p2)
 
 
-def test_extended_information():
+def test_extended_information() -> None:
     skip_missing()
     o = ImageCms.getOpenProfile(SRGB)
     p = o.profile
 
-    def assert_truncated_tuple_equal(tup1, tup2, digits=10):
+    def assert_truncated_tuple_equal(tup1, tup2, digits: int = 10) -> None:
         # Helper function to reduce precision of tuples of floats
         # recursively and then check equality.
         power = 10**digits
@@ -476,7 +477,7 @@ def truncate_tuple(tuple_or_float):
     assert p.xcolor_space == "RGB "
 
 
-def test_non_ascii_path(tmp_path):
+def test_non_ascii_path(tmp_path: Path) -> None:
     skip_missing()
     tempfile = str(tmp_path / ("temp_" + chr(128) + ".icc"))
     try:
@@ -489,7 +490,7 @@ def test_non_ascii_path(tmp_path):
     assert p.model == "IEC 61966-2-1 Default RGB Colour Space - sRGB"
 
 
-def test_profile_typesafety():
+def test_profile_typesafety() -> None:
     """Profile init type safety
 
     prepatch, these would segfault, postpatch they should emit a typeerror
@@ -501,7 +502,7 @@ def test_profile_typesafety():
         ImageCms.ImageCmsProfile(1).tobytes()
 
 
-def assert_aux_channel_preserved(mode, transform_in_place, preserved_channel):
+def assert_aux_channel_preserved(mode, transform_in_place, preserved_channel) -> None:
     def create_test_image():
         # set up test image with something interesting in the tested aux channel.
         # fmt: off
@@ -556,31 +557,31 @@ def create_test_image():
     assert_image_equal(source_image_aux, result_image_aux)
 
 
-def test_preserve_auxiliary_channels_rgba():
+def test_preserve_auxiliary_channels_rgba() -> None:
     assert_aux_channel_preserved(
         mode="RGBA", transform_in_place=False, preserved_channel="A"
     )
 
 
-def test_preserve_auxiliary_channels_rgba_in_place():
+def test_preserve_auxiliary_channels_rgba_in_place() -> None:
     assert_aux_channel_preserved(
         mode="RGBA", transform_in_place=True, preserved_channel="A"
     )
 
 
-def test_preserve_auxiliary_channels_rgbx():
+def test_preserve_auxiliary_channels_rgbx() -> None:
     assert_aux_channel_preserved(
         mode="RGBX", transform_in_place=False, preserved_channel="X"
     )
 
 
-def test_preserve_auxiliary_channels_rgbx_in_place():
+def test_preserve_auxiliary_channels_rgbx_in_place() -> None:
     assert_aux_channel_preserved(
         mode="RGBX", transform_in_place=True, preserved_channel="X"
     )
 
 
-def test_auxiliary_channels_isolated():
+def test_auxiliary_channels_isolated() -> None:
     # test data in aux channels does not affect non-aux channels
     aux_channel_formats = [
         # format, profile, color-only format, source test image
@@ -630,7 +631,7 @@ def test_auxiliary_channels_isolated():
 
 
 @pytest.mark.parametrize("mode", ("RGB", "RGBA", "RGBX"))
-def test_rgb_lab(mode):
+def test_rgb_lab(mode) -> None:
     im = Image.new(mode, (1, 1))
     converted_im = im.convert("LAB")
     assert converted_im.getpixel((0, 0)) == (0, 128, 128)
diff --git a/Tests/test_imagecolor.py b/Tests/test_imagecolor.py
index b602172b642..6eea7886dd8 100644
--- a/Tests/test_imagecolor.py
+++ b/Tests/test_imagecolor.py
@@ -5,7 +5,7 @@
 from PIL import Image, ImageColor
 
 
-def test_hash():
+def test_hash() -> None:
     # short 3 components
     assert (255, 0, 0) == ImageColor.getrgb("#f00")
     assert (0, 255, 0) == ImageColor.getrgb("#0f0")
@@ -57,7 +57,7 @@ def test_hash():
         ImageColor.getrgb("#f00000 ")
 
 
-def test_colormap():
+def test_colormap() -> None:
     assert (0, 0, 0) == ImageColor.getrgb("black")
     assert (255, 255, 255) == ImageColor.getrgb("white")
     assert (255, 255, 255) == ImageColor.getrgb("WHITE")
@@ -66,7 +66,7 @@ def test_colormap():
         ImageColor.getrgb("black ")
 
 
-def test_functions():
+def test_functions() -> None:
     # rgb numbers
     assert (255, 0, 0) == ImageColor.getrgb("rgb(255,0,0)")
     assert (0, 255, 0) == ImageColor.getrgb("rgb(0,255,0)")
@@ -160,7 +160,7 @@ def test_functions():
 
 
 # look for rounding errors (based on code by Tim Hatch)
-def test_rounding_errors():
+def test_rounding_errors() -> None:
     for color in ImageColor.colormap:
         expected = Image.new("RGB", (1, 1), color).convert("L").getpixel((0, 0))
         actual = ImageColor.getcolor(color, "L")
@@ -195,11 +195,11 @@ def test_rounding_errors():
     Image.new("LA", (1, 1), "white")
 
 
-def test_color_hsv():
+def test_color_hsv() -> None:
     assert (170, 255, 255) == ImageColor.getcolor("hsv(240, 100%, 100%)", "HSV")
 
 
-def test_color_too_long():
+def test_color_too_long() -> None:
     # Arrange
     color_too_long = "hsl(" + "1" * 40 + "," + "1" * 40 + "%," + "1" * 40 + "%)"
 
diff --git a/Tests/test_imagedraw.py b/Tests/test_imagedraw.py
index 69aab48912b..86d25b1ebc7 100644
--- a/Tests/test_imagedraw.py
+++ b/Tests/test_imagedraw.py
@@ -47,7 +47,7 @@
 )
 
 
-def test_sanity():
+def test_sanity() -> None:
     im = hopper("RGB").copy()
 
     draw = ImageDraw.ImageDraw(im)
@@ -59,13 +59,13 @@ def test_sanity():
     draw.rectangle(list(range(4)))
 
 
-def test_valueerror():
+def test_valueerror() -> None:
     with Image.open("Tests/images/chi.gif") as im:
         draw = ImageDraw.Draw(im)
         draw.line((0, 0), fill=(0, 0, 0))
 
 
-def test_mode_mismatch():
+def test_mode_mismatch() -> None:
     im = hopper("RGB").copy()
 
     with pytest.raises(ValueError):
@@ -74,7 +74,7 @@ def test_mode_mismatch():
 
 @pytest.mark.parametrize("bbox", BBOX)
 @pytest.mark.parametrize("start, end", ((0, 180), (0.5, 180.4)))
-def test_arc(bbox, start, end):
+def test_arc(bbox, start, end) -> None:
     # Arrange
     im = Image.new("RGB", (W, H))
     draw = ImageDraw.Draw(im)
@@ -87,7 +87,7 @@ def test_arc(bbox, start, end):
 
 
 @pytest.mark.parametrize("bbox", BBOX)
-def test_arc_end_le_start(bbox):
+def test_arc_end_le_start(bbox) -> None:
     # Arrange
     im = Image.new("RGB", (W, H))
     draw = ImageDraw.Draw(im)
@@ -102,7 +102,7 @@ def test_arc_end_le_start(bbox):
 
 
 @pytest.mark.parametrize("bbox", BBOX)
-def test_arc_no_loops(bbox):
+def test_arc_no_loops(bbox) -> None:
     # No need to go in loops
     # Arrange
     im = Image.new("RGB", (W, H))
@@ -118,7 +118,7 @@ def test_arc_no_loops(bbox):
 
 
 @pytest.mark.parametrize("bbox", BBOX)
-def test_arc_width(bbox):
+def test_arc_width(bbox) -> None:
     # Arrange
     im = Image.new("RGB", (W, H))
     draw = ImageDraw.Draw(im)
@@ -131,7 +131,7 @@ def test_arc_width(bbox):
 
 
 @pytest.mark.parametrize("bbox", BBOX)
-def test_arc_width_pieslice_large(bbox):
+def test_arc_width_pieslice_large(bbox) -> None:
     # Tests an arc with a large enough width that it is a pieslice
     # Arrange
     im = Image.new("RGB", (W, H))
@@ -145,7 +145,7 @@ def test_arc_width_pieslice_large(bbox):
 
 
 @pytest.mark.parametrize("bbox", BBOX)
-def test_arc_width_fill(bbox):
+def test_arc_width_fill(bbox) -> None:
     # Arrange
     im = Image.new("RGB", (W, H))
     draw = ImageDraw.Draw(im)
@@ -158,7 +158,7 @@ def test_arc_width_fill(bbox):
 
 
 @pytest.mark.parametrize("bbox", BBOX)
-def test_arc_width_non_whole_angle(bbox):
+def test_arc_width_non_whole_angle(bbox) -> None:
     # Arrange
     im = Image.new("RGB", (W, H))
     draw = ImageDraw.Draw(im)
@@ -171,7 +171,7 @@ def test_arc_width_non_whole_angle(bbox):
     assert_image_similar_tofile(im, expected, 1)
 
 
-def test_arc_high():
+def test_arc_high() -> None:
     # Arrange
     im = Image.new("RGB", (200, 200))
     draw = ImageDraw.Draw(im)
@@ -184,7 +184,7 @@ def test_arc_high():
     assert_image_equal_tofile(im, "Tests/images/imagedraw_arc_high.png")
 
 
-def test_bitmap():
+def test_bitmap() -> None:
     # Arrange
     im = Image.new("RGB", (W, H))
     draw = ImageDraw.Draw(im)
@@ -200,7 +200,7 @@ def test_bitmap():
 
 @pytest.mark.parametrize("mode", ("RGB", "L"))
 @pytest.mark.parametrize("bbox", BBOX)
-def test_chord(mode, bbox):
+def test_chord(mode, bbox) -> None:
     # Arrange
     im = Image.new(mode, (W, H))
     draw = ImageDraw.Draw(im)
@@ -214,7 +214,7 @@ def test_chord(mode, bbox):
 
 
 @pytest.mark.parametrize("bbox", BBOX)
-def test_chord_width(bbox):
+def test_chord_width(bbox) -> None:
     # Arrange
     im = Image.new("RGB", (W, H))
     draw = ImageDraw.Draw(im)
@@ -227,7 +227,7 @@ def test_chord_width(bbox):
 
 
 @pytest.mark.parametrize("bbox", BBOX)
-def test_chord_width_fill(bbox):
+def test_chord_width_fill(bbox) -> None:
     # Arrange
     im = Image.new("RGB", (W, H))
     draw = ImageDraw.Draw(im)
@@ -240,7 +240,7 @@ def test_chord_width_fill(bbox):
 
 
 @pytest.mark.parametrize("bbox", BBOX)
-def test_chord_zero_width(bbox):
+def test_chord_zero_width(bbox) -> None:
     # Arrange
     im = Image.new("RGB", (W, H))
     draw = ImageDraw.Draw(im)
@@ -252,7 +252,7 @@ def test_chord_zero_width(bbox):
     assert_image_equal_tofile(im, "Tests/images/imagedraw_chord_zero_width.png")
 
 
-def test_chord_too_fat():
+def test_chord_too_fat() -> None:
     # Arrange
     im = Image.new("RGB", (100, 100))
     draw = ImageDraw.Draw(im)
@@ -266,7 +266,7 @@ def test_chord_too_fat():
 
 @pytest.mark.parametrize("mode", ("RGB", "L"))
 @pytest.mark.parametrize("bbox", BBOX)
-def test_ellipse(mode, bbox):
+def test_ellipse(mode, bbox) -> None:
     # Arrange
     im = Image.new(mode, (W, H))
     draw = ImageDraw.Draw(im)
@@ -280,7 +280,7 @@ def test_ellipse(mode, bbox):
 
 
 @pytest.mark.parametrize("bbox", BBOX)
-def test_ellipse_translucent(bbox):
+def test_ellipse_translucent(bbox) -> None:
     # Arrange
     im = Image.new("RGB", (W, H))
     draw = ImageDraw.Draw(im, "RGBA")
@@ -293,7 +293,7 @@ def test_ellipse_translucent(bbox):
     assert_image_similar_tofile(im, expected, 1)
 
 
-def test_ellipse_edge():
+def test_ellipse_edge() -> None:
     # Arrange
     im = Image.new("RGB", (W, H))
     draw = ImageDraw.Draw(im)
@@ -305,7 +305,7 @@ def test_ellipse_edge():
     assert_image_similar_tofile(im, "Tests/images/imagedraw_ellipse_edge.png", 1)
 
 
-def test_ellipse_symmetric():
+def test_ellipse_symmetric() -> None:
     for width, bbox in (
         (100, (24, 24, 75, 75)),
         (101, (25, 25, 75, 75)),
@@ -317,7 +317,7 @@ def test_ellipse_symmetric():
 
 
 @pytest.mark.parametrize("bbox", BBOX)
-def test_ellipse_width(bbox):
+def test_ellipse_width(bbox) -> None:
     # Arrange
     im = Image.new("RGB", (W, H))
     draw = ImageDraw.Draw(im)
@@ -329,7 +329,7 @@ def test_ellipse_width(bbox):
     assert_image_similar_tofile(im, "Tests/images/imagedraw_ellipse_width.png", 1)
 
 
-def test_ellipse_width_large():
+def test_ellipse_width_large() -> None:
     # Arrange
     im = Image.new("RGB", (500, 500))
     draw = ImageDraw.Draw(im)
@@ -342,7 +342,7 @@ def test_ellipse_width_large():
 
 
 @pytest.mark.parametrize("bbox", BBOX)
-def test_ellipse_width_fill(bbox):
+def test_ellipse_width_fill(bbox) -> None:
     # Arrange
     im = Image.new("RGB", (W, H))
     draw = ImageDraw.Draw(im)
@@ -355,7 +355,7 @@ def test_ellipse_width_fill(bbox):
 
 
 @pytest.mark.parametrize("bbox", BBOX)
-def test_ellipse_zero_width(bbox):
+def test_ellipse_zero_width(bbox) -> None:
     # Arrange
     im = Image.new("RGB", (W, H))
     draw = ImageDraw.Draw(im)
@@ -394,13 +394,13 @@ def ellipse_various_sizes_helper(filled):
     return im
 
 
-def test_ellipse_various_sizes():
+def test_ellipse_various_sizes() -> None:
     im = ellipse_various_sizes_helper(False)
 
     assert_image_equal_tofile(im, "Tests/images/imagedraw_ellipse_various_sizes.png")
 
 
-def test_ellipse_various_sizes_filled():
+def test_ellipse_various_sizes_filled() -> None:
     im = ellipse_various_sizes_helper(True)
 
     assert_image_equal_tofile(
@@ -409,7 +409,7 @@ def test_ellipse_various_sizes_filled():
 
 
 @pytest.mark.parametrize("points", POINTS)
-def test_line(points):
+def test_line(points) -> None:
     # Arrange
     im = Image.new("RGB", (W, H))
     draw = ImageDraw.Draw(im)
@@ -421,7 +421,7 @@ def test_line(points):
     assert_image_equal_tofile(im, "Tests/images/imagedraw_line.png")
 
 
-def test_shape1():
+def test_shape1() -> None:
     # Arrange
     im = Image.new("RGB", (100, 100), "white")
     draw = ImageDraw.Draw(im)
@@ -442,7 +442,7 @@ def test_shape1():
     assert_image_equal_tofile(im, "Tests/images/imagedraw_shape1.png")
 
 
-def test_shape2():
+def test_shape2() -> None:
     # Arrange
     im = Image.new("RGB", (100, 100), "white")
     draw = ImageDraw.Draw(im)
@@ -463,7 +463,7 @@ def test_shape2():
     assert_image_equal_tofile(im, "Tests/images/imagedraw_shape2.png")
 
 
-def test_transform():
+def test_transform() -> None:
     # Arrange
     im = Image.new("RGB", (100, 100), "white")
     expected = im.copy()
@@ -482,7 +482,7 @@ def test_transform():
 
 @pytest.mark.parametrize("bbox", BBOX)
 @pytest.mark.parametrize("start, end", ((-92, 46), (-92.2, 46.2)))
-def test_pieslice(bbox, start, end):
+def test_pieslice(bbox, start, end) -> None:
     # Arrange
     im = Image.new("RGB", (W, H))
     draw = ImageDraw.Draw(im)
@@ -495,7 +495,7 @@ def test_pieslice(bbox, start, end):
 
 
 @pytest.mark.parametrize("bbox", BBOX)
-def test_pieslice_width(bbox):
+def test_pieslice_width(bbox) -> None:
     # Arrange
     im = Image.new("RGB", (W, H))
     draw = ImageDraw.Draw(im)
@@ -508,7 +508,7 @@ def test_pieslice_width(bbox):
 
 
 @pytest.mark.parametrize("bbox", BBOX)
-def test_pieslice_width_fill(bbox):
+def test_pieslice_width_fill(bbox) -> None:
     # Arrange
     im = Image.new("RGB", (W, H))
     draw = ImageDraw.Draw(im)
@@ -522,7 +522,7 @@ def test_pieslice_width_fill(bbox):
 
 
 @pytest.mark.parametrize("bbox", BBOX)
-def test_pieslice_zero_width(bbox):
+def test_pieslice_zero_width(bbox) -> None:
     # Arrange
     im = Image.new("RGB", (W, H))
     draw = ImageDraw.Draw(im)
@@ -534,7 +534,7 @@ def test_pieslice_zero_width(bbox):
     assert_image_equal_tofile(im, "Tests/images/imagedraw_pieslice_zero_width.png")
 
 
-def test_pieslice_wide():
+def test_pieslice_wide() -> None:
     # Arrange
     im = Image.new("RGB", (200, 100))
     draw = ImageDraw.Draw(im)
@@ -546,7 +546,7 @@ def test_pieslice_wide():
     assert_image_equal_tofile(im, "Tests/images/imagedraw_pieslice_wide.png")
 
 
-def test_pieslice_no_spikes():
+def test_pieslice_no_spikes() -> None:
     im = Image.new("RGB", (161, 161), "white")
     draw = ImageDraw.Draw(im)
     cxs = (
@@ -577,7 +577,7 @@ def test_pieslice_no_spikes():
 
 
 @pytest.mark.parametrize("points", POINTS)
-def test_point(points):
+def test_point(points) -> None:
     # Arrange
     im = Image.new("RGB", (W, H))
     draw = ImageDraw.Draw(im)
@@ -589,7 +589,7 @@ def test_point(points):
     assert_image_equal_tofile(im, "Tests/images/imagedraw_point.png")
 
 
-def test_point_I16():
+def test_point_I16() -> None:
     # Arrange
     im = Image.new("I;16", (1, 1))
     draw = ImageDraw.Draw(im)
@@ -602,7 +602,7 @@ def test_point_I16():
 
 
 @pytest.mark.parametrize("points", POINTS)
-def test_polygon(points):
+def test_polygon(points) -> None:
     # Arrange
     im = Image.new("RGB", (W, H))
     draw = ImageDraw.Draw(im)
@@ -616,7 +616,7 @@ def test_polygon(points):
 
 @pytest.mark.parametrize("mode", ("RGB", "L"))
 @pytest.mark.parametrize("kite_points", KITE_POINTS)
-def test_polygon_kite(mode, kite_points):
+def test_polygon_kite(mode, kite_points) -> None:
     # Test drawing lines of different gradients (dx>dy, dy>dx) and
     # vertical (dx==0) and horizontal (dy==0) lines
     # Arrange
@@ -631,7 +631,7 @@ def test_polygon_kite(mode, kite_points):
     assert_image_equal_tofile(im, expected)
 
 
-def test_polygon_1px_high():
+def test_polygon_1px_high() -> None:
     # Test drawing a 1px high polygon
     # Arrange
     im = Image.new("RGB", (3, 3))
@@ -645,7 +645,7 @@ def test_polygon_1px_high():
     assert_image_equal_tofile(im, expected)
 
 
-def test_polygon_1px_high_translucent():
+def test_polygon_1px_high_translucent() -> None:
     # Test drawing a translucent 1px high polygon
     # Arrange
     im = Image.new("RGB", (4, 3))
@@ -659,7 +659,7 @@ def test_polygon_1px_high_translucent():
     assert_image_equal_tofile(im, expected)
 
 
-def test_polygon_translucent():
+def test_polygon_translucent() -> None:
     # Arrange
     im = Image.new("RGB", (W, H))
     draw = ImageDraw.Draw(im, "RGBA")
@@ -673,7 +673,7 @@ def test_polygon_translucent():
 
 
 @pytest.mark.parametrize("bbox", BBOX)
-def test_rectangle(bbox):
+def test_rectangle(bbox) -> None:
     # Arrange
     im = Image.new("RGB", (W, H))
     draw = ImageDraw.Draw(im)
@@ -685,7 +685,7 @@ def test_rectangle(bbox):
     assert_image_equal_tofile(im, "Tests/images/imagedraw_rectangle.png")
 
 
-def test_big_rectangle():
+def test_big_rectangle() -> None:
     # Test drawing a rectangle bigger than the image
     # Arrange
     im = Image.new("RGB", (W, H))
@@ -700,7 +700,7 @@ def test_big_rectangle():
 
 
 @pytest.mark.parametrize("bbox", BBOX)
-def test_rectangle_width(bbox):
+def test_rectangle_width(bbox) -> None:
     # Arrange
     im = Image.new("RGB", (W, H))
     draw = ImageDraw.Draw(im)
@@ -714,7 +714,7 @@ def test_rectangle_width(bbox):
 
 
 @pytest.mark.parametrize("bbox", BBOX)
-def test_rectangle_width_fill(bbox):
+def test_rectangle_width_fill(bbox) -> None:
     # Arrange
     im = Image.new("RGB", (W, H))
     draw = ImageDraw.Draw(im)
@@ -728,7 +728,7 @@ def test_rectangle_width_fill(bbox):
 
 
 @pytest.mark.parametrize("bbox", BBOX)
-def test_rectangle_zero_width(bbox):
+def test_rectangle_zero_width(bbox) -> None:
     # Arrange
     im = Image.new("RGB", (W, H))
     draw = ImageDraw.Draw(im)
@@ -741,7 +741,7 @@ def test_rectangle_zero_width(bbox):
 
 
 @pytest.mark.parametrize("bbox", BBOX)
-def test_rectangle_I16(bbox):
+def test_rectangle_I16(bbox) -> None:
     # Arrange
     im = Image.new("I;16", (W, H))
     draw = ImageDraw.Draw(im)
@@ -754,7 +754,7 @@ def test_rectangle_I16(bbox):
 
 
 @pytest.mark.parametrize("bbox", BBOX)
-def test_rectangle_translucent_outline(bbox):
+def test_rectangle_translucent_outline(bbox) -> None:
     # Arrange
     im = Image.new("RGB", (W, H))
     draw = ImageDraw.Draw(im, "RGBA")
@@ -772,7 +772,7 @@ def test_rectangle_translucent_outline(bbox):
     "xy",
     [(10, 20, 190, 180), ([10, 20], [190, 180]), ((10, 20), (190, 180))],
 )
-def test_rounded_rectangle(xy):
+def test_rounded_rectangle(xy) -> None:
     # Arrange
     im = Image.new("RGB", (200, 200))
     draw = ImageDraw.Draw(im)
@@ -788,7 +788,9 @@ def test_rounded_rectangle(xy):
 @pytest.mark.parametrize("top_right", (True, False))
 @pytest.mark.parametrize("bottom_right", (True, False))
 @pytest.mark.parametrize("bottom_left", (True, False))
-def test_rounded_rectangle_corners(top_left, top_right, bottom_right, bottom_left):
+def test_rounded_rectangle_corners(
+    top_left, top_right, bottom_right, bottom_left
+) -> None:
     corners = (top_left, top_right, bottom_right, bottom_left)
 
     # Arrange
@@ -822,7 +824,7 @@ def test_rounded_rectangle_corners(top_left, top_right, bottom_right, bottom_lef
         ((10, 20, 190, 181), 85, "height"),
     ],
 )
-def test_rounded_rectangle_non_integer_radius(xy, radius, type):
+def test_rounded_rectangle_non_integer_radius(xy, radius, type) -> None:
     # Arrange
     im = Image.new("RGB", (200, 200))
     draw = ImageDraw.Draw(im)
@@ -838,7 +840,7 @@ def test_rounded_rectangle_non_integer_radius(xy, radius, type):
 
 
 @pytest.mark.parametrize("bbox", BBOX)
-def test_rounded_rectangle_zero_radius(bbox):
+def test_rounded_rectangle_zero_radius(bbox) -> None:
     # Arrange
     im = Image.new("RGB", (W, H))
     draw = ImageDraw.Draw(im)
@@ -860,7 +862,7 @@ def test_rounded_rectangle_zero_radius(bbox):
         ((20, 20, 80, 80), "both"),
     ],
 )
-def test_rounded_rectangle_translucent(xy, suffix):
+def test_rounded_rectangle_translucent(xy, suffix) -> None:
     # Arrange
     im = Image.new("RGB", (W, H))
     draw = ImageDraw.Draw(im, "RGBA")
@@ -877,7 +879,7 @@ def test_rounded_rectangle_translucent(xy, suffix):
 
 
 @pytest.mark.parametrize("bbox", BBOX)
-def test_floodfill(bbox):
+def test_floodfill(bbox) -> None:
     red = ImageColor.getrgb("red")
 
     for mode, value in [("L", 1), ("RGBA", (255, 0, 0, 0)), ("RGB", red)]:
@@ -910,7 +912,7 @@ def test_floodfill(bbox):
 
 
 @pytest.mark.parametrize("bbox", BBOX)
-def test_floodfill_border(bbox):
+def test_floodfill_border(bbox) -> None:
     # floodfill() is experimental
 
     # Arrange
@@ -932,7 +934,7 @@ def test_floodfill_border(bbox):
 
 
 @pytest.mark.parametrize("bbox", BBOX)
-def test_floodfill_thresh(bbox):
+def test_floodfill_thresh(bbox) -> None:
     # floodfill() is experimental
 
     # Arrange
@@ -948,7 +950,7 @@ def test_floodfill_thresh(bbox):
     assert_image_equal_tofile(im, "Tests/images/imagedraw_floodfill2.png")
 
 
-def test_floodfill_not_negative():
+def test_floodfill_not_negative() -> None:
     # floodfill() is experimental
     # Test that floodfill does not extend into negative coordinates
 
@@ -976,7 +978,7 @@ def create_base_image_draw(
     return img, ImageDraw.Draw(img)
 
 
-def test_square():
+def test_square() -> None:
     expected = os.path.join(IMAGES_PATH, "square.png")
     img, draw = create_base_image_draw((10, 10))
     draw.polygon([(2, 2), (2, 7), (7, 7), (7, 2)], BLACK)
@@ -989,7 +991,7 @@ def test_square():
     assert_image_equal_tofile(img, expected, "square as normal rectangle failed")
 
 
-def test_triangle_right():
+def test_triangle_right() -> None:
     img, draw = create_base_image_draw((20, 20))
     draw.polygon([(3, 5), (17, 5), (10, 12)], BLACK)
     assert_image_equal_tofile(
@@ -1001,7 +1003,7 @@ def test_triangle_right():
     "fill, suffix",
     ((BLACK, "width"), (None, "width_no_fill")),
 )
-def test_triangle_right_width(fill, suffix):
+def test_triangle_right_width(fill, suffix) -> None:
     img, draw = create_base_image_draw((100, 100))
     draw.polygon([(15, 25), (85, 25), (50, 60)], fill, WHITE, width=5)
     assert_image_equal_tofile(
@@ -1009,7 +1011,7 @@ def test_triangle_right_width(fill, suffix):
     )
 
 
-def test_line_horizontal():
+def test_line_horizontal() -> None:
     img, draw = create_base_image_draw((20, 20))
     draw.line((5, 5, 14, 5), BLACK, 2)
     assert_image_equal_tofile(
@@ -1047,7 +1049,7 @@ def test_line_horizontal():
     )
 
 
-def test_line_h_s1_w2():
+def test_line_h_s1_w2() -> None:
     pytest.skip("failing")
     img, draw = create_base_image_draw((20, 20))
     draw.line((5, 5, 14, 6), BLACK, 2)
@@ -1058,7 +1060,7 @@ def test_line_h_s1_w2():
     )
 
 
-def test_line_vertical():
+def test_line_vertical() -> None:
     img, draw = create_base_image_draw((20, 20))
     draw.line((5, 5, 5, 14), BLACK, 2)
     assert_image_equal_tofile(
@@ -1104,7 +1106,7 @@ def test_line_vertical():
     )
 
 
-def test_line_oblique_45():
+def test_line_oblique_45() -> None:
     expected = os.path.join(IMAGES_PATH, "line_oblique_45_w3px_a.png")
     img, draw = create_base_image_draw((20, 20))
     draw.line((5, 5, 14, 14), BLACK, 3)
@@ -1126,7 +1128,7 @@ def test_line_oblique_45():
     )
 
 
-def test_wide_line_dot():
+def test_wide_line_dot() -> None:
     # Test drawing a wide "line" from one point to another just draws a single point
     # Arrange
     im = Image.new("RGB", (W, H))
@@ -1139,7 +1141,7 @@ def test_wide_line_dot():
     assert_image_similar_tofile(im, "Tests/images/imagedraw_wide_line_dot.png", 1)
 
 
-def test_wide_line_larger_than_int():
+def test_wide_line_larger_than_int() -> None:
     # Arrange
     im = Image.new("RGB", (W, H))
     draw = ImageDraw.Draw(im)
@@ -1233,7 +1235,7 @@ def test_wide_line_larger_than_int():
         ],
     ],
 )
-def test_line_joint(xy):
+def test_line_joint(xy) -> None:
     im = Image.new("RGB", (500, 325))
     draw = ImageDraw.Draw(im)
 
@@ -1244,7 +1246,7 @@ def test_line_joint(xy):
     assert_image_similar_tofile(im, "Tests/images/imagedraw_line_joint_curve.png", 3)
 
 
-def test_textsize_empty_string():
+def test_textsize_empty_string() -> None:
     # https://github.com/python-pillow/Pillow/issues/2783
     # Arrange
     im = Image.new("RGB", (W, H))
@@ -1260,7 +1262,7 @@ def test_textsize_empty_string():
 
 
 @skip_unless_feature("freetype2")
-def test_textbbox_stroke():
+def test_textbbox_stroke() -> None:
     # Arrange
     im = Image.new("RGB", (W, H))
     draw = ImageDraw.Draw(im)
@@ -1274,7 +1276,7 @@ def test_textbbox_stroke():
 
 
 @skip_unless_feature("freetype2")
-def test_stroke():
+def test_stroke() -> None:
     for suffix, stroke_fill in {"same": None, "different": "#0f0"}.items():
         # Arrange
         im = Image.new("RGB", (120, 130))
@@ -1291,7 +1293,7 @@ def test_stroke():
 
 
 @skip_unless_feature("freetype2")
-def test_stroke_descender():
+def test_stroke_descender() -> None:
     # Arrange
     im = Image.new("RGB", (120, 130))
     draw = ImageDraw.Draw(im)
@@ -1305,7 +1307,7 @@ def test_stroke_descender():
 
 
 @skip_unless_feature("freetype2")
-def test_split_word():
+def test_split_word() -> None:
     # Arrange
     im = Image.new("RGB", (230, 55))
     expected = im.copy()
@@ -1326,7 +1328,7 @@ def test_split_word():
 
 
 @skip_unless_feature("freetype2")
-def test_stroke_multiline():
+def test_stroke_multiline() -> None:
     # Arrange
     im = Image.new("RGB", (100, 250))
     draw = ImageDraw.Draw(im)
@@ -1342,7 +1344,7 @@ def test_stroke_multiline():
 
 
 @skip_unless_feature("freetype2")
-def test_setting_default_font():
+def test_setting_default_font() -> None:
     # Arrange
     im = Image.new("RGB", (100, 250))
     draw = ImageDraw.Draw(im)
@@ -1359,7 +1361,7 @@ def test_setting_default_font():
         assert isinstance(draw.getfont(), ImageFont.load_default().__class__)
 
 
-def test_default_font_size():
+def test_default_font_size() -> None:
     freetype_support = features.check_module("freetype2")
     text = "Default font at a specific size."
 
@@ -1386,7 +1388,7 @@ def test_default_font_size():
 
 
 @pytest.mark.parametrize("bbox", BBOX)
-def test_same_color_outline(bbox):
+def test_same_color_outline(bbox) -> None:
     # Prepare shape
     x0, y0 = 5, 5
     x1, y1 = 5, 50
@@ -1432,7 +1434,7 @@ def test_same_color_outline(bbox):
         (3, "triangle_width", {"width": 5, "outline": "yellow"}),
     ],
 )
-def test_draw_regular_polygon(n_sides, polygon_name, args):
+def test_draw_regular_polygon(n_sides, polygon_name, args) -> None:
     im = Image.new("RGBA", size=(W, H), color=(255, 0, 0, 0))
     filename = f"Tests/images/imagedraw_{polygon_name}.png"
     draw = ImageDraw.Draw(im)
@@ -1469,7 +1471,7 @@ def test_draw_regular_polygon(n_sides, polygon_name, args):
         ),
     ],
 )
-def test_compute_regular_polygon_vertices(n_sides, expected_vertices):
+def test_compute_regular_polygon_vertices(n_sides, expected_vertices) -> None:
     bounding_circle = (W // 2, H // 2, 25)
     vertices = ImageDraw._compute_regular_polygon_vertices(bounding_circle, n_sides, 0)
     assert vertices == expected_vertices
@@ -1521,13 +1523,13 @@ def test_compute_regular_polygon_vertices(n_sides, expected_vertices):
 )
 def test_compute_regular_polygon_vertices_input_error_handling(
     n_sides, bounding_circle, rotation, expected_error, error_message
-):
+) -> None:
     with pytest.raises(expected_error) as e:
         ImageDraw._compute_regular_polygon_vertices(bounding_circle, n_sides, rotation)
     assert str(e.value) == error_message
 
 
-def test_continuous_horizontal_edges_polygon():
+def test_continuous_horizontal_edges_polygon() -> None:
     xy = [
         (2, 6),
         (6, 6),
@@ -1546,7 +1548,7 @@ def test_continuous_horizontal_edges_polygon():
     )
 
 
-def test_discontiguous_corners_polygon():
+def test_discontiguous_corners_polygon() -> None:
     img, draw = create_base_image_draw((84, 68))
     draw.polygon(((1, 21), (34, 4), (71, 1), (38, 18)), BLACK)
     draw.polygon(((71, 44), (38, 27), (1, 24)), BLACK)
@@ -1558,7 +1560,7 @@ def test_discontiguous_corners_polygon():
     assert_image_similar_tofile(img, expected, 1)
 
 
-def test_polygon2():
+def test_polygon2() -> None:
     im = Image.new("RGB", (W, H))
     draw = ImageDraw.Draw(im)
     draw.polygon([(18, 30), (19, 31), (18, 30), (85, 30), (60, 72)], "red")
@@ -1567,7 +1569,7 @@ def test_polygon2():
 
 
 @pytest.mark.parametrize("xy", ((1, 1, 0, 1), (1, 1, 1, 0)))
-def test_incorrectly_ordered_coordinates(xy):
+def test_incorrectly_ordered_coordinates(xy) -> None:
     im = Image.new("RGB", (W, H))
     draw = ImageDraw.Draw(im)
     with pytest.raises(ValueError):
diff --git a/Tests/test_imagedraw2.py b/Tests/test_imagedraw2.py
index 004c2d768fd..07a25b84b4e 100644
--- a/Tests/test_imagedraw2.py
+++ b/Tests/test_imagedraw2.py
@@ -43,7 +43,7 @@
 FONT_PATH = "Tests/fonts/FreeMono.ttf"
 
 
-def test_sanity():
+def test_sanity() -> None:
     im = hopper("RGB").copy()
 
     draw = ImageDraw2.Draw(im)
@@ -56,7 +56,7 @@ def test_sanity():
 
 
 @pytest.mark.parametrize("bbox", BBOX)
-def test_ellipse(bbox):
+def test_ellipse(bbox) -> None:
     # Arrange
     im = Image.new("RGB", (W, H))
     draw = ImageDraw2.Draw(im)
@@ -70,7 +70,7 @@ def test_ellipse(bbox):
     assert_image_similar_tofile(im, "Tests/images/imagedraw_ellipse_RGB.png", 1)
 
 
-def test_ellipse_edge():
+def test_ellipse_edge() -> None:
     # Arrange
     im = Image.new("RGB", (W, H))
     draw = ImageDraw2.Draw(im)
@@ -84,7 +84,7 @@ def test_ellipse_edge():
 
 
 @pytest.mark.parametrize("points", POINTS)
-def test_line(points):
+def test_line(points) -> None:
     # Arrange
     im = Image.new("RGB", (W, H))
     draw = ImageDraw2.Draw(im)
@@ -98,7 +98,7 @@ def test_line(points):
 
 
 @pytest.mark.parametrize("points", POINTS)
-def test_line_pen_as_brush(points):
+def test_line_pen_as_brush(points) -> None:
     # Arrange
     im = Image.new("RGB", (W, H))
     draw = ImageDraw2.Draw(im)
@@ -114,7 +114,7 @@ def test_line_pen_as_brush(points):
 
 
 @pytest.mark.parametrize("points", POINTS)
-def test_polygon(points):
+def test_polygon(points) -> None:
     # Arrange
     im = Image.new("RGB", (W, H))
     draw = ImageDraw2.Draw(im)
@@ -129,7 +129,7 @@ def test_polygon(points):
 
 
 @pytest.mark.parametrize("bbox", BBOX)
-def test_rectangle(bbox):
+def test_rectangle(bbox) -> None:
     # Arrange
     im = Image.new("RGB", (W, H))
     draw = ImageDraw2.Draw(im)
@@ -143,7 +143,7 @@ def test_rectangle(bbox):
     assert_image_equal_tofile(im, "Tests/images/imagedraw_rectangle.png")
 
 
-def test_big_rectangle():
+def test_big_rectangle() -> None:
     # Test drawing a rectangle bigger than the image
     # Arrange
     im = Image.new("RGB", (W, H))
@@ -160,7 +160,7 @@ def test_big_rectangle():
 
 
 @skip_unless_feature("freetype2")
-def test_text():
+def test_text() -> None:
     # Arrange
     im = Image.new("RGB", (W, H))
     draw = ImageDraw2.Draw(im)
@@ -175,7 +175,7 @@ def test_text():
 
 
 @skip_unless_feature("freetype2")
-def test_textbbox():
+def test_textbbox() -> None:
     # Arrange
     im = Image.new("RGB", (W, H))
     draw = ImageDraw2.Draw(im)
@@ -190,7 +190,7 @@ def test_textbbox():
 
 
 @skip_unless_feature("freetype2")
-def test_textsize_empty_string():
+def test_textsize_empty_string() -> None:
     # Arrange
     im = Image.new("RGB", (W, H))
     draw = ImageDraw2.Draw(im)
@@ -206,7 +206,7 @@ def test_textsize_empty_string():
 
 
 @skip_unless_feature("freetype2")
-def test_flush():
+def test_flush() -> None:
     # Arrange
     im = Image.new("RGB", (W, H))
     draw = ImageDraw2.Draw(im)
diff --git a/Tests/test_imageenhance.py b/Tests/test_imageenhance.py
index e3d8a7ab251..9ce9cda8267 100644
--- a/Tests/test_imageenhance.py
+++ b/Tests/test_imageenhance.py
@@ -7,7 +7,7 @@
 from .helper import assert_image_equal, hopper
 
 
-def test_sanity():
+def test_sanity() -> None:
     # FIXME: assert_image
     # Implicit asserts no exception:
     ImageEnhance.Color(hopper()).enhance(0.5)
@@ -16,7 +16,7 @@ def test_sanity():
     ImageEnhance.Sharpness(hopper()).enhance(0.5)
 
 
-def test_crash():
+def test_crash() -> None:
     # crashes on small images
     im = Image.new("RGB", (1, 1))
     ImageEnhance.Sharpness(im).enhance(0.5)
@@ -34,7 +34,7 @@ def _half_transparent_image():
     return im
 
 
-def _check_alpha(im, original, op, amount):
+def _check_alpha(im, original, op, amount) -> None:
     assert im.getbands() == original.getbands()
     assert_image_equal(
         im.getchannel("A"),
@@ -44,7 +44,7 @@ def _check_alpha(im, original, op, amount):
 
 
 @pytest.mark.parametrize("op", ("Color", "Brightness", "Contrast", "Sharpness"))
-def test_alpha(op):
+def test_alpha(op) -> None:
     # Issue https://github.com/python-pillow/Pillow/issues/899
     # Is alpha preserved through image enhancement?
 
diff --git a/Tests/test_imagefile.py b/Tests/test_imagefile.py
index 99731f35208..49140978168 100644
--- a/Tests/test_imagefile.py
+++ b/Tests/test_imagefile.py
@@ -30,7 +30,7 @@
 
 
 class TestImageFile:
-    def test_parser(self):
+    def test_parser(self) -> None:
         def roundtrip(format):
             im = hopper("L").resize((1000, 1000), Image.Resampling.NEAREST)
             if format in ("MSP", "XBM"):
@@ -84,7 +84,7 @@ def roundtrip(format):
         with pytest.raises(OSError):
             roundtrip("PDF")
 
-    def test_ico(self):
+    def test_ico(self) -> None:
         with open("Tests/images/python.ico", "rb") as f:
             data = f.read()
         with ImageFile.Parser() as p:
@@ -93,7 +93,7 @@ def test_ico(self):
 
     @skip_unless_feature("webp")
     @skip_unless_feature("webp_anim")
-    def test_incremental_webp(self):
+    def test_incremental_webp(self) -> None:
         with ImageFile.Parser() as p:
             with open("Tests/images/hopper.webp", "rb") as f:
                 p.feed(f.read(1024))
@@ -105,7 +105,7 @@ def test_incremental_webp(self):
             assert (128, 128) == p.image.size
 
     @skip_unless_feature("zlib")
-    def test_safeblock(self):
+    def test_safeblock(self) -> None:
         im1 = hopper()
 
         try:
@@ -116,17 +116,17 @@ def test_safeblock(self):
 
         assert_image_equal(im1, im2)
 
-    def test_raise_oserror(self):
+    def test_raise_oserror(self) -> None:
         with pytest.warns(DeprecationWarning):
             with pytest.raises(OSError):
                 ImageFile.raise_oserror(1)
 
-    def test_raise_typeerror(self):
+    def test_raise_typeerror(self) -> None:
         with pytest.raises(TypeError):
             parser = ImageFile.Parser()
             parser.feed(1)
 
-    def test_negative_stride(self):
+    def test_negative_stride(self) -> None:
         with open("Tests/images/raw_negative_stride.bin", "rb") as f:
             input = f.read()
         p = ImageFile.Parser()
@@ -134,11 +134,11 @@ def test_negative_stride(self):
         with pytest.raises(OSError):
             p.close()
 
-    def test_no_format(self):
+    def test_no_format(self) -> None:
         buf = BytesIO(b"\x00" * 255)
 
         class DummyImageFile(ImageFile.ImageFile):
-            def _open(self):
+            def _open(self) -> None:
                 self._mode = "RGB"
                 self._size = (1, 1)
 
@@ -146,12 +146,12 @@ def _open(self):
         assert im.format is None
         assert im.get_format_mimetype() is None
 
-    def test_oserror(self):
+    def test_oserror(self) -> None:
         im = Image.new("RGB", (1, 1))
         with pytest.raises(OSError):
             im.save(BytesIO(), "JPEG2000", num_resolutions=2)
 
-    def test_truncated(self):
+    def test_truncated(self) -> None:
         b = BytesIO(
             b"BM000000000000"  # head_data
             + _binary.o32le(
@@ -166,7 +166,7 @@ def test_truncated(self):
         assert str(e.value) == "Truncated File Read"
 
     @skip_unless_feature("zlib")
-    def test_truncated_with_errors(self):
+    def test_truncated_with_errors(self) -> None:
         with Image.open("Tests/images/truncated_image.png") as im:
             with pytest.raises(OSError):
                 im.load()
@@ -176,7 +176,7 @@ def test_truncated_with_errors(self):
                 im.load()
 
     @skip_unless_feature("zlib")
-    def test_truncated_without_errors(self):
+    def test_truncated_without_errors(self) -> None:
         with Image.open("Tests/images/truncated_image.png") as im:
             ImageFile.LOAD_TRUNCATED_IMAGES = True
             try:
@@ -185,13 +185,13 @@ def test_truncated_without_errors(self):
                 ImageFile.LOAD_TRUNCATED_IMAGES = False
 
     @skip_unless_feature("zlib")
-    def test_broken_datastream_with_errors(self):
+    def test_broken_datastream_with_errors(self) -> None:
         with Image.open("Tests/images/broken_data_stream.png") as im:
             with pytest.raises(OSError):
                 im.load()
 
     @skip_unless_feature("zlib")
-    def test_broken_datastream_without_errors(self):
+    def test_broken_datastream_without_errors(self) -> None:
         with Image.open("Tests/images/broken_data_stream.png") as im:
             ImageFile.LOAD_TRUNCATED_IMAGES = True
             try:
@@ -210,7 +210,7 @@ class MockPyEncoder(ImageFile.PyEncoder):
     def encode(self, buffer):
         return 1, 1, b""
 
-    def cleanup(self):
+    def cleanup(self) -> None:
         self.cleanup_called = True
 
 
@@ -218,7 +218,7 @@ def cleanup(self):
 
 
 class MockImageFile(ImageFile.ImageFile):
-    def _open(self):
+    def _open(self) -> None:
         self.rawmode = "RGBA"
         self._mode = "RGBA"
         self._size = (200, 200)
@@ -227,7 +227,7 @@ def _open(self):
 
 class CodecsTest:
     @classmethod
-    def setup_class(cls):
+    def setup_class(cls) -> None:
         cls.decoder = MockPyDecoder(None)
         cls.encoder = MockPyEncoder(None)
 
@@ -244,7 +244,7 @@ def encoder_closure(mode, *args):
 
 
 class TestPyDecoder(CodecsTest):
-    def test_setimage(self):
+    def test_setimage(self) -> None:
         buf = BytesIO(b"\x00" * 255)
 
         im = MockImageFile(buf)
@@ -259,7 +259,7 @@ def test_setimage(self):
         with pytest.raises(ValueError):
             self.decoder.set_as_raw(b"\x00")
 
-    def test_extents_none(self):
+    def test_extents_none(self) -> None:
         buf = BytesIO(b"\x00" * 255)
 
         im = MockImageFile(buf)
@@ -272,7 +272,7 @@ def test_extents_none(self):
         assert self.decoder.state.xsize == 200
         assert self.decoder.state.ysize == 200
 
-    def test_negsize(self):
+    def test_negsize(self) -> None:
         buf = BytesIO(b"\x00" * 255)
 
         im = MockImageFile(buf)
@@ -285,7 +285,7 @@ def test_negsize(self):
         with pytest.raises(ValueError):
             im.load()
 
-    def test_oversize(self):
+    def test_oversize(self) -> None:
         buf = BytesIO(b"\x00" * 255)
 
         im = MockImageFile(buf)
@@ -298,14 +298,14 @@ def test_oversize(self):
         with pytest.raises(ValueError):
             im.load()
 
-    def test_decode(self):
+    def test_decode(self) -> None:
         decoder = ImageFile.PyDecoder(None)
         with pytest.raises(NotImplementedError):
             decoder.decode(None)
 
 
 class TestPyEncoder(CodecsTest):
-    def test_setimage(self):
+    def test_setimage(self) -> None:
         buf = BytesIO(b"\x00" * 255)
 
         im = MockImageFile(buf)
@@ -320,7 +320,7 @@ def test_setimage(self):
         assert self.encoder.state.xsize == xsize
         assert self.encoder.state.ysize == ysize
 
-    def test_extents_none(self):
+    def test_extents_none(self) -> None:
         buf = BytesIO(b"\x00" * 255)
 
         im = MockImageFile(buf)
@@ -334,7 +334,7 @@ def test_extents_none(self):
         assert self.encoder.state.xsize == 200
         assert self.encoder.state.ysize == 200
 
-    def test_negsize(self):
+    def test_negsize(self) -> None:
         buf = BytesIO(b"\x00" * 255)
 
         im = MockImageFile(buf)
@@ -352,7 +352,7 @@ def test_negsize(self):
                 im, fp, [("MOCK", (xoff, yoff, xoff + xsize, -10), 0, "RGB")]
             )
 
-    def test_oversize(self):
+    def test_oversize(self) -> None:
         buf = BytesIO(b"\x00" * 255)
 
         im = MockImageFile(buf)
@@ -372,7 +372,7 @@ def test_oversize(self):
                 [("MOCK", (xoff, yoff, xoff + xsize, yoff + ysize + 100), 0, "RGB")],
             )
 
-    def test_encode(self):
+    def test_encode(self) -> None:
         encoder = ImageFile.PyEncoder(None)
         with pytest.raises(NotImplementedError):
             encoder.encode(None)
@@ -388,6 +388,6 @@ def test_encode(self):
         with pytest.raises(NotImplementedError):
             encoder.encode_to_file(None, None)
 
-    def test_zero_height(self):
+    def test_zero_height(self) -> None:
         with pytest.raises(UnidentifiedImageError):
             Image.open("Tests/images/zero_height.j2k")
diff --git a/Tests/test_imagefont.py b/Tests/test_imagefont.py
index d2c87d42aaa..909026dc8c6 100644
--- a/Tests/test_imagefont.py
+++ b/Tests/test_imagefont.py
@@ -31,7 +31,7 @@
 pytestmark = skip_unless_feature("freetype2")
 
 
-def test_sanity():
+def test_sanity() -> None:
     assert re.search(r"\d+\.\d+\.\d+$", features.version_module("freetype2"))
 
 
@@ -51,7 +51,7 @@ def font(layout_engine):
     return ImageFont.truetype(FONT_PATH, FONT_SIZE, layout_engine=layout_engine)
 
 
-def test_font_properties(font):
+def test_font_properties(font) -> None:
     assert font.path == FONT_PATH
     assert font.size == FONT_SIZE
 
@@ -80,11 +80,11 @@ def _render(font, layout_engine):
 
 
 @pytest.mark.parametrize("font", (FONT_PATH, Path(FONT_PATH)))
-def test_font_with_name(layout_engine, font):
+def test_font_with_name(layout_engine, font) -> None:
     _render(font, layout_engine)
 
 
-def test_font_with_filelike(layout_engine):
+def test_font_with_filelike(layout_engine) -> None:
     def _font_as_bytes():
         with open(FONT_PATH, "rb") as f:
             font_bytes = BytesIO(f.read())
@@ -102,12 +102,12 @@ def _font_as_bytes():
     #   _render(shared_bytes)
 
 
-def test_font_with_open_file(layout_engine):
+def test_font_with_open_file(layout_engine) -> None:
     with open(FONT_PATH, "rb") as f:
         _render(f, layout_engine)
 
 
-def test_render_equal(layout_engine):
+def test_render_equal(layout_engine) -> None:
     img_path = _render(FONT_PATH, layout_engine)
     with open(FONT_PATH, "rb") as f:
         font_filelike = BytesIO(f.read())
@@ -116,7 +116,7 @@ def test_render_equal(layout_engine):
     assert_image_equal(img_path, img_filelike)
 
 
-def test_non_ascii_path(tmp_path, layout_engine):
+def test_non_ascii_path(tmp_path: Path, layout_engine) -> None:
     tempfile = str(tmp_path / ("temp_" + chr(128) + ".ttf"))
     try:
         shutil.copy(FONT_PATH, tempfile)
@@ -126,7 +126,7 @@ def test_non_ascii_path(tmp_path, layout_engine):
     ImageFont.truetype(tempfile, FONT_SIZE, layout_engine=layout_engine)
 
 
-def test_transparent_background(font):
+def test_transparent_background(font) -> None:
     im = Image.new(mode="RGBA", size=(300, 100))
     draw = ImageDraw.Draw(im)
 
@@ -140,7 +140,7 @@ def test_transparent_background(font):
     assert_image_similar_tofile(im.convert("L"), target, 0.01)
 
 
-def test_I16(font):
+def test_I16(font) -> None:
     im = Image.new(mode="I;16", size=(300, 100))
     draw = ImageDraw.Draw(im)
 
@@ -153,7 +153,7 @@ def test_I16(font):
     assert_image_similar_tofile(im.convert("L"), target, 0.01)
 
 
-def test_textbbox_equal(font):
+def test_textbbox_equal(font) -> None:
     im = Image.new(mode="RGB", size=(300, 100))
     draw = ImageDraw.Draw(im)
 
@@ -182,7 +182,7 @@ def test_textbbox_equal(font):
 )
 def test_getlength(
     text, mode, fontname, size, layout_engine, length_basic, length_raqm
-):
+) -> None:
     f = ImageFont.truetype("Tests/fonts/" + fontname, size, layout_engine=layout_engine)
 
     im = Image.new(mode, (1, 1), 0)
@@ -197,7 +197,7 @@ def test_getlength(
         assert length == length_raqm
 
 
-def test_float_size():
+def test_float_size() -> None:
     lengths = []
     for size in (48, 48.5, 49):
         f = ImageFont.truetype(
@@ -207,7 +207,7 @@ def test_float_size():
     assert lengths[0] != lengths[1] != lengths[2]
 
 
-def test_render_multiline(font):
+def test_render_multiline(font) -> None:
     im = Image.new(mode="RGB", size=(300, 100))
     draw = ImageDraw.Draw(im)
     line_spacing = font.getbbox("A")[3] + 4
@@ -223,7 +223,7 @@ def test_render_multiline(font):
     assert_image_similar_tofile(im, "Tests/images/multiline_text.png", 6.2)
 
 
-def test_render_multiline_text(font):
+def test_render_multiline_text(font) -> None:
     # Test that text() correctly connects to multiline_text()
     # and that align defaults to left
     im = Image.new(mode="RGB", size=(300, 100))
@@ -243,7 +243,7 @@ def test_render_multiline_text(font):
 @pytest.mark.parametrize(
     "align, ext", (("left", ""), ("center", "_center"), ("right", "_right"))
 )
-def test_render_multiline_text_align(font, align, ext):
+def test_render_multiline_text_align(font, align, ext) -> None:
     im = Image.new(mode="RGB", size=(300, 100))
     draw = ImageDraw.Draw(im)
     draw.multiline_text((0, 0), TEST_TEXT, font=font, align=align)
@@ -251,7 +251,7 @@ def test_render_multiline_text_align(font, align, ext):
     assert_image_similar_tofile(im, f"Tests/images/multiline_text{ext}.png", 0.01)
 
 
-def test_unknown_align(font):
+def test_unknown_align(font) -> None:
     im = Image.new(mode="RGB", size=(300, 100))
     draw = ImageDraw.Draw(im)
 
@@ -260,14 +260,14 @@ def test_unknown_align(font):
         draw.multiline_text((0, 0), TEST_TEXT, font=font, align="unknown")
 
 
-def test_draw_align(font):
+def test_draw_align(font) -> None:
     im = Image.new("RGB", (300, 100), "white")
     draw = ImageDraw.Draw(im)
     line = "some text"
     draw.text((100, 40), line, (0, 0, 0), font=font, align="left")
 
 
-def test_multiline_bbox(font):
+def test_multiline_bbox(font) -> None:
     im = Image.new(mode="RGB", size=(300, 100))
     draw = ImageDraw.Draw(im)
 
@@ -285,7 +285,7 @@ def test_multiline_bbox(font):
     draw.textbbox((0, 0), TEST_TEXT, font=font, spacing=4)
 
 
-def test_multiline_width(font):
+def test_multiline_width(font) -> None:
     im = Image.new(mode="RGB", size=(300, 100))
     draw = ImageDraw.Draw(im)
 
@@ -295,7 +295,7 @@ def test_multiline_width(font):
     )
 
 
-def test_multiline_spacing(font):
+def test_multiline_spacing(font) -> None:
     im = Image.new(mode="RGB", size=(300, 100))
     draw = ImageDraw.Draw(im)
     draw.multiline_text((0, 0), TEST_TEXT, font=font, spacing=10)
@@ -306,7 +306,7 @@ def test_multiline_spacing(font):
 @pytest.mark.parametrize(
     "orientation", (Image.Transpose.ROTATE_90, Image.Transpose.ROTATE_270)
 )
-def test_rotated_transposed_font(font, orientation):
+def test_rotated_transposed_font(font, orientation) -> None:
     img_gray = Image.new("L", (100, 100))
     draw = ImageDraw.Draw(img_gray)
     word = "testing"
@@ -347,7 +347,7 @@ def test_rotated_transposed_font(font, orientation):
         Image.Transpose.FLIP_TOP_BOTTOM,
     ),
 )
-def test_unrotated_transposed_font(font, orientation):
+def test_unrotated_transposed_font(font, orientation) -> None:
     img_gray = Image.new("L", (100, 100))
     draw = ImageDraw.Draw(img_gray)
     word = "testing"
@@ -382,7 +382,7 @@ def test_unrotated_transposed_font(font, orientation):
 @pytest.mark.parametrize(
     "orientation", (Image.Transpose.ROTATE_90, Image.Transpose.ROTATE_270)
 )
-def test_rotated_transposed_font_get_mask(font, orientation):
+def test_rotated_transposed_font_get_mask(font, orientation) -> None:
     # Arrange
     text = "mask this"
     transposed_font = ImageFont.TransposedFont(font, orientation=orientation)
@@ -403,7 +403,7 @@ def test_rotated_transposed_font_get_mask(font, orientation):
         Image.Transpose.FLIP_TOP_BOTTOM,
     ),
 )
-def test_unrotated_transposed_font_get_mask(font, orientation):
+def test_unrotated_transposed_font_get_mask(font, orientation) -> None:
     # Arrange
     text = "mask this"
     transposed_font = ImageFont.TransposedFont(font, orientation=orientation)
@@ -415,11 +415,11 @@ def test_unrotated_transposed_font_get_mask(font, orientation):
     assert mask.size == (108, 13)
 
 
-def test_free_type_font_get_name(font):
+def test_free_type_font_get_name(font) -> None:
     assert ("FreeMono", "Regular") == font.getname()
 
 
-def test_free_type_font_get_metrics(font):
+def test_free_type_font_get_metrics(font) -> None:
     ascent, descent = font.getmetrics()
 
     assert isinstance(ascent, int)
@@ -427,7 +427,7 @@ def test_free_type_font_get_metrics(font):
     assert (ascent, descent) == (16, 4)
 
 
-def test_free_type_font_get_mask(font):
+def test_free_type_font_get_mask(font) -> None:
     # Arrange
     text = "mask this"
 
@@ -438,7 +438,7 @@ def test_free_type_font_get_mask(font):
     assert mask.size == (108, 13)
 
 
-def test_load_path_not_found():
+def test_load_path_not_found() -> None:
     # Arrange
     filename = "somefilenamethatdoesntexist.ttf"
 
@@ -449,13 +449,13 @@ def test_load_path_not_found():
         ImageFont.truetype(filename)
 
 
-def test_load_non_font_bytes():
+def test_load_non_font_bytes() -> None:
     with open("Tests/images/hopper.jpg", "rb") as f:
         with pytest.raises(OSError):
             ImageFont.truetype(f)
 
 
-def test_default_font():
+def test_default_font() -> None:
     # Arrange
     txt = "This is a default font using FreeType support."
     im = Image.new(mode="RGB", size=(300, 100))
@@ -473,16 +473,16 @@ def test_default_font():
 
 
 @pytest.mark.parametrize("mode", (None, "1", "RGBA"))
-def test_getbbox(font, mode):
+def test_getbbox(font, mode) -> None:
     assert (0, 4, 12, 16) == font.getbbox("A", mode)
 
 
-def test_getbbox_empty(font):
+def test_getbbox_empty(font) -> None:
     # issue #2614, should not crash.
     assert (0, 0, 0, 0) == font.getbbox("")
 
 
-def test_render_empty(font):
+def test_render_empty(font) -> None:
     # issue 2666
     im = Image.new(mode="RGB", size=(300, 100))
     target = im.copy()
@@ -492,7 +492,7 @@ def test_render_empty(font):
     assert_image_equal(im, target)
 
 
-def test_unicode_extended(layout_engine):
+def test_unicode_extended(layout_engine) -> None:
     # issue #3777
     text = "A\u278A\U0001F12B"
     target = "Tests/images/unicode_extended.png"
@@ -515,8 +515,8 @@ def test_unicode_extended(layout_engine):
     (("linux", "/usr/local/share/fonts"), ("darwin", "/System/Library/Fonts")),
 )
 @pytest.mark.skipif(is_win32(), reason="requires Unix or macOS")
-def test_find_font(monkeypatch, platform, font_directory):
-    def _test_fake_loading_font(path_to_fake, fontname):
+def test_find_font(monkeypatch, platform, font_directory) -> None:
+    def _test_fake_loading_font(path_to_fake, fontname) -> None:
         # Make a copy of FreeTypeFont so we can patch the original
         free_type_font = copy.deepcopy(ImageFont.FreeTypeFont)
         with monkeypatch.context() as m:
@@ -567,7 +567,7 @@ def fake_walker(path):
     _test_fake_loading_font(font_directory + "/Duplicate.ttf", "Duplicate")
 
 
-def test_imagefont_getters(font):
+def test_imagefont_getters(font) -> None:
     assert font.getmetrics() == (16, 4)
     assert font.font.ascent == 16
     assert font.font.descent == 4
@@ -588,7 +588,7 @@ def test_imagefont_getters(font):
 
 
 @pytest.mark.parametrize("stroke_width", (0, 2))
-def test_getsize_stroke(font, stroke_width):
+def test_getsize_stroke(font, stroke_width) -> None:
     assert font.getbbox("A", stroke_width=stroke_width) == (
         0 - stroke_width,
         4 - stroke_width,
@@ -597,7 +597,7 @@ def test_getsize_stroke(font, stroke_width):
     )
 
 
-def test_complex_font_settings():
+def test_complex_font_settings() -> None:
     t = ImageFont.truetype(FONT_PATH, FONT_SIZE, layout_engine=ImageFont.Layout.BASIC)
     with pytest.raises(KeyError):
         t.getmask("абвг", direction="rtl")
@@ -607,7 +607,7 @@ def test_complex_font_settings():
         t.getmask("абвг", language="sr")
 
 
-def test_variation_get(font):
+def test_variation_get(font) -> None:
     freetype = parse_version(features.version_module("freetype2"))
     if freetype < parse_version("2.9.1"):
         with pytest.raises(NotImplementedError):
@@ -677,7 +677,7 @@ def _check_text(font, path, epsilon):
             raise
 
 
-def test_variation_set_by_name(font):
+def test_variation_set_by_name(font) -> None:
     freetype = parse_version(features.version_module("freetype2"))
     if freetype < parse_version("2.9.1"):
         with pytest.raises(NotImplementedError):
@@ -702,7 +702,7 @@ def test_variation_set_by_name(font):
     _check_text(font, "Tests/images/variation_tiny_name.png", 40)
 
 
-def test_variation_set_by_axes(font):
+def test_variation_set_by_axes(font) -> None:
     freetype = parse_version(features.version_module("freetype2"))
     if freetype < parse_version("2.9.1"):
         with pytest.raises(NotImplementedError):
@@ -737,7 +737,7 @@ def test_variation_set_by_axes(font):
     ),
     ids=("ls", "ms", "rs", "ma", "mt", "mm", "mb", "md"),
 )
-def test_anchor(layout_engine, anchor, left, top):
+def test_anchor(layout_engine, anchor, left, top) -> None:
     name, text = "quick", "Quick"
     path = f"Tests/images/test_anchor_{name}_{anchor}.png"
 
@@ -782,7 +782,7 @@ def test_anchor(layout_engine, anchor, left, top):
         ("md", "center"),
     ),
 )
-def test_anchor_multiline(layout_engine, anchor, align):
+def test_anchor_multiline(layout_engine, anchor, align) -> None:
     target = f"Tests/images/test_anchor_multiline_{anchor}_{align}.png"
     text = "a\nlong\ntext sample"
 
@@ -800,7 +800,7 @@ def test_anchor_multiline(layout_engine, anchor, align):
     assert_image_similar_tofile(im, target, 4)
 
 
-def test_anchor_invalid(font):
+def test_anchor_invalid(font) -> None:
     im = Image.new("RGB", (100, 100), "white")
     d = ImageDraw.Draw(im)
     d.font = font
@@ -826,7 +826,7 @@ def test_anchor_invalid(font):
 
 
 @pytest.mark.parametrize("bpp", (1, 2, 4, 8))
-def test_bitmap_font(layout_engine, bpp):
+def test_bitmap_font(layout_engine, bpp) -> None:
     text = "Bitmap Font"
     layout_name = ["basic", "raqm"][layout_engine]
     target = f"Tests/images/bitmap_font_{bpp}_{layout_name}.png"
@@ -843,7 +843,7 @@ def test_bitmap_font(layout_engine, bpp):
     assert_image_equal_tofile(im, target)
 
 
-def test_bitmap_font_stroke(layout_engine):
+def test_bitmap_font_stroke(layout_engine) -> None:
     text = "Bitmap Font"
     layout_name = ["basic", "raqm"][layout_engine]
     target = f"Tests/images/bitmap_font_stroke_{layout_name}.png"
@@ -861,7 +861,7 @@ def test_bitmap_font_stroke(layout_engine):
 
 
 @pytest.mark.parametrize("embedded_color", (False, True))
-def test_bitmap_blend(layout_engine, embedded_color):
+def test_bitmap_blend(layout_engine, embedded_color) -> None:
     font = ImageFont.truetype(
         "Tests/fonts/EBDTTestFont.ttf", size=64, layout_engine=layout_engine
     )
@@ -873,7 +873,7 @@ def test_bitmap_blend(layout_engine, embedded_color):
     assert_image_equal_tofile(im, "Tests/images/bitmap_font_blend.png")
 
 
-def test_standard_embedded_color(layout_engine):
+def test_standard_embedded_color(layout_engine) -> None:
     txt = "Hello World!"
     ttf = ImageFont.truetype(FONT_PATH, 40, layout_engine=layout_engine)
     ttf.getbbox(txt)
@@ -908,7 +908,7 @@ def test_float_coord(layout_engine, fontmode):
             raise
 
 
-def test_cbdt(layout_engine):
+def test_cbdt(layout_engine) -> None:
     try:
         font = ImageFont.truetype(
             "Tests/fonts/CBDTTestFont.ttf", size=64, layout_engine=layout_engine
@@ -925,7 +925,7 @@ def test_cbdt(layout_engine):
         pytest.skip("freetype compiled without libpng or CBDT support")
 
 
-def test_cbdt_mask(layout_engine):
+def test_cbdt_mask(layout_engine) -> None:
     try:
         font = ImageFont.truetype(
             "Tests/fonts/CBDTTestFont.ttf", size=64, layout_engine=layout_engine
@@ -942,7 +942,7 @@ def test_cbdt_mask(layout_engine):
         pytest.skip("freetype compiled without libpng or CBDT support")
 
 
-def test_sbix(layout_engine):
+def test_sbix(layout_engine) -> None:
     try:
         font = ImageFont.truetype(
             "Tests/fonts/chromacheck-sbix.woff", size=300, layout_engine=layout_engine
@@ -959,7 +959,7 @@ def test_sbix(layout_engine):
         pytest.skip("freetype compiled without libpng or SBIX support")
 
 
-def test_sbix_mask(layout_engine):
+def test_sbix_mask(layout_engine) -> None:
     try:
         font = ImageFont.truetype(
             "Tests/fonts/chromacheck-sbix.woff", size=300, layout_engine=layout_engine
@@ -977,7 +977,7 @@ def test_sbix_mask(layout_engine):
 
 
 @skip_unless_feature_version("freetype2", "2.10.0")
-def test_colr(layout_engine):
+def test_colr(layout_engine) -> None:
     font = ImageFont.truetype(
         "Tests/fonts/BungeeColor-Regular_colr_Windows.ttf",
         size=64,
@@ -993,7 +993,7 @@ def test_colr(layout_engine):
 
 
 @skip_unless_feature_version("freetype2", "2.10.0")
-def test_colr_mask(layout_engine):
+def test_colr_mask(layout_engine) -> None:
     font = ImageFont.truetype(
         "Tests/fonts/BungeeColor-Regular_colr_Windows.ttf",
         size=64,
@@ -1008,7 +1008,7 @@ def test_colr_mask(layout_engine):
     assert_image_similar_tofile(im, "Tests/images/colr_bungee_mask.png", 22)
 
 
-def test_woff2(layout_engine):
+def test_woff2(layout_engine) -> None:
     try:
         font = ImageFont.truetype(
             "Tests/fonts/OpenSans.woff2",
@@ -1027,7 +1027,7 @@ def test_woff2(layout_engine):
     assert_image_similar_tofile(im, "Tests/images/test_woff2.png", 5)
 
 
-def test_render_mono_size():
+def test_render_mono_size() -> None:
     # issue 4177
 
     im = Image.new("P", (100, 30), "white")
@@ -1042,7 +1042,7 @@ def test_render_mono_size():
     assert_image_equal_tofile(im, "Tests/images/text_mono.gif")
 
 
-def test_too_many_characters(font):
+def test_too_many_characters(font) -> None:
     with pytest.raises(ValueError):
         font.getlength("A" * 1_000_001)
     with pytest.raises(ValueError):
@@ -1070,14 +1070,14 @@ def test_too_many_characters(font):
         "Tests/fonts/oom-4da0210eb7081b0bf15bf16cc4c52ce02c1e1bbc.ttf",
     ],
 )
-def test_oom(test_file):
+def test_oom(test_file) -> None:
     with open(test_file, "rb") as f:
         font = ImageFont.truetype(BytesIO(f.read()))
         with pytest.raises(Image.DecompressionBombError):
             font.getmask("Test Text")
 
 
-def test_raqm_missing_warning(monkeypatch):
+def test_raqm_missing_warning(monkeypatch) -> None:
     monkeypatch.setattr(ImageFont.core, "HAVE_RAQM", False)
     with pytest.warns(UserWarning) as record:
         font = ImageFont.truetype(
@@ -1091,6 +1091,6 @@ def test_raqm_missing_warning(monkeypatch):
 
 
 @pytest.mark.parametrize("size", [-1, 0])
-def test_invalid_truetype_sizes_raise_valueerror(layout_engine, size):
+def test_invalid_truetype_sizes_raise_valueerror(layout_engine, size) -> None:
     with pytest.raises(ValueError):
         ImageFont.truetype(FONT_PATH, size, layout_engine=layout_engine)
diff --git a/Tests/test_imagefontctl.py b/Tests/test_imagefontctl.py
index 09e68ea488a..325e7ef216b 100644
--- a/Tests/test_imagefontctl.py
+++ b/Tests/test_imagefontctl.py
@@ -12,7 +12,7 @@
 pytestmark = skip_unless_feature("raqm")
 
 
-def test_english():
+def test_english() -> None:
     # smoke test, this should not fail
     ttf = ImageFont.truetype(FONT_PATH, FONT_SIZE)
     im = Image.new(mode="RGB", size=(300, 100))
@@ -20,7 +20,7 @@ def test_english():
     draw.text((0, 0), "TEST", font=ttf, fill=500, direction="ltr")
 
 
-def test_complex_text():
+def test_complex_text() -> None:
     ttf = ImageFont.truetype(FONT_PATH, FONT_SIZE)
 
     im = Image.new(mode="RGB", size=(300, 100))
@@ -31,7 +31,7 @@ def test_complex_text():
     assert_image_similar_tofile(im, target, 0.5)
 
 
-def test_y_offset():
+def test_y_offset() -> None:
     ttf = ImageFont.truetype("Tests/fonts/NotoNastaliqUrdu-Regular.ttf", FONT_SIZE)
 
     im = Image.new(mode="RGB", size=(300, 100))
@@ -42,7 +42,7 @@ def test_y_offset():
     assert_image_similar_tofile(im, target, 1.7)
 
 
-def test_complex_unicode_text():
+def test_complex_unicode_text() -> None:
     ttf = ImageFont.truetype(FONT_PATH, FONT_SIZE)
 
     im = Image.new(mode="RGB", size=(300, 100))
@@ -62,7 +62,7 @@ def test_complex_unicode_text():
     assert_image_similar_tofile(im, target, 2.33)
 
 
-def test_text_direction_rtl():
+def test_text_direction_rtl() -> None:
     ttf = ImageFont.truetype(FONT_PATH, FONT_SIZE)
 
     im = Image.new(mode="RGB", size=(300, 100))
@@ -73,7 +73,7 @@ def test_text_direction_rtl():
     assert_image_similar_tofile(im, target, 0.5)
 
 
-def test_text_direction_ltr():
+def test_text_direction_ltr() -> None:
     ttf = ImageFont.truetype(FONT_PATH, FONT_SIZE)
 
     im = Image.new(mode="RGB", size=(300, 100))
@@ -84,7 +84,7 @@ def test_text_direction_ltr():
     assert_image_similar_tofile(im, target, 0.5)
 
 
-def test_text_direction_rtl2():
+def test_text_direction_rtl2() -> None:
     ttf = ImageFont.truetype(FONT_PATH, FONT_SIZE)
 
     im = Image.new(mode="RGB", size=(300, 100))
@@ -95,7 +95,7 @@ def test_text_direction_rtl2():
     assert_image_similar_tofile(im, target, 0.5)
 
 
-def test_text_direction_ttb():
+def test_text_direction_ttb() -> None:
     ttf = ImageFont.truetype("Tests/fonts/NotoSansJP-Regular.otf", FONT_SIZE)
 
     im = Image.new(mode="RGB", size=(100, 300))
@@ -110,7 +110,7 @@ def test_text_direction_ttb():
     assert_image_similar_tofile(im, target, 2.8)
 
 
-def test_text_direction_ttb_stroke():
+def test_text_direction_ttb_stroke() -> None:
     ttf = ImageFont.truetype("Tests/fonts/NotoSansJP-Regular.otf", 50)
 
     im = Image.new(mode="RGB", size=(100, 300))
@@ -133,7 +133,7 @@ def test_text_direction_ttb_stroke():
     assert_image_similar_tofile(im, target, 19.4)
 
 
-def test_ligature_features():
+def test_ligature_features() -> None:
     ttf = ImageFont.truetype(FONT_PATH, FONT_SIZE)
 
     im = Image.new(mode="RGB", size=(300, 100))
@@ -146,7 +146,7 @@ def test_ligature_features():
     assert liga_bbox == (0, 4, 13, 19)
 
 
-def test_kerning_features():
+def test_kerning_features() -> None:
     ttf = ImageFont.truetype(FONT_PATH, FONT_SIZE)
 
     im = Image.new(mode="RGB", size=(300, 100))
@@ -157,7 +157,7 @@ def test_kerning_features():
     assert_image_similar_tofile(im, target, 0.5)
 
 
-def test_arabictext_features():
+def test_arabictext_features() -> None:
     ttf = ImageFont.truetype(FONT_PATH, FONT_SIZE)
 
     im = Image.new(mode="RGB", size=(300, 100))
@@ -174,7 +174,7 @@ def test_arabictext_features():
     assert_image_similar_tofile(im, target, 0.5)
 
 
-def test_x_max_and_y_offset():
+def test_x_max_and_y_offset() -> None:
     ttf = ImageFont.truetype("Tests/fonts/ArefRuqaa-Regular.ttf", 40)
 
     im = Image.new(mode="RGB", size=(50, 100))
@@ -185,7 +185,7 @@ def test_x_max_and_y_offset():
     assert_image_similar_tofile(im, target, 0.5)
 
 
-def test_language():
+def test_language() -> None:
     ttf = ImageFont.truetype(FONT_PATH, FONT_SIZE)
 
     im = Image.new(mode="RGB", size=(300, 100))
@@ -208,7 +208,7 @@ def test_language():
     ),
     ids=("None", "ltr", "rtl2", "rtl", "ttb"),
 )
-def test_getlength(mode, text, direction, expected):
+def test_getlength(mode, text, direction, expected) -> None:
     ttf = ImageFont.truetype(FONT_PATH, FONT_SIZE)
     im = Image.new(mode, (1, 1), 0)
     d = ImageDraw.Draw(im)
@@ -230,7 +230,7 @@ def test_getlength(mode, text, direction, expected):
     ("i" + ("\u030C" * 15) + "i", "i" + "\u032C" * 15 + "i", "\u035Cii", "i\u0305i"),
     ids=("caron-above", "caron-below", "double-breve", "overline"),
 )
-def test_getlength_combine(mode, direction, text):
+def test_getlength_combine(mode, direction, text) -> None:
     if text == "i\u0305i" and direction == "ttb":
         pytest.skip("fails with this font")
 
@@ -250,7 +250,7 @@ def test_getlength_combine(mode, direction, text):
 
 
 @pytest.mark.parametrize("anchor", ("lt", "mm", "rb", "sm"))
-def test_anchor_ttb(anchor):
+def test_anchor_ttb(anchor) -> None:
     text = "f"
     path = f"Tests/images/test_anchor_ttb_{text}_{anchor}.png"
     f = ImageFont.truetype("Tests/fonts/NotoSans-Regular.ttf", 120)
@@ -306,7 +306,7 @@ def test_anchor_ttb(anchor):
 @pytest.mark.parametrize(
     "name, text, anchor, dir, epsilon", combine_tests, ids=[r[0] for r in combine_tests]
 )
-def test_combine(name, text, dir, anchor, epsilon):
+def test_combine(name, text, dir, anchor, epsilon) -> None:
     path = f"Tests/images/test_combine_{name}.png"
     f = ImageFont.truetype("Tests/fonts/NotoSans-Regular.ttf", 48)
 
@@ -337,7 +337,7 @@ def test_combine(name, text, dir, anchor, epsilon):
         ("rm", "right"),  # pass with getsize
     ),
 )
-def test_combine_multiline(anchor, align):
+def test_combine_multiline(anchor, align) -> None:
     # test that multiline text uses getlength, not getsize or getbbox
 
     path = f"Tests/images/test_combine_multiline_{anchor}_{align}.png"
@@ -355,7 +355,7 @@ def test_combine_multiline(anchor, align):
     assert_image_similar_tofile(im, path, 0.015)
 
 
-def test_anchor_invalid_ttb():
+def test_anchor_invalid_ttb() -> None:
     font = ImageFont.truetype(FONT_PATH, FONT_SIZE)
     im = Image.new("RGB", (100, 100), "white")
     d = ImageDraw.Draw(im)
diff --git a/Tests/test_imagefontpil.py b/Tests/test_imagefontpil.py
index be4be1c546e..3b1c14b4e18 100644
--- a/Tests/test_imagefontpil.py
+++ b/Tests/test_imagefontpil.py
@@ -12,16 +12,16 @@
 original_core = ImageFont.core
 
 
-def setup_module():
+def setup_module() -> None:
     if features.check_module("freetype2"):
         ImageFont.core = _util.DeferredError(ImportError)
 
 
-def teardown_module():
+def teardown_module() -> None:
     ImageFont.core = original_core
 
 
-def test_default_font():
+def test_default_font() -> None:
     # Arrange
     txt = 'This is a "better than nothing" default font.'
     im = Image.new(mode="RGB", size=(300, 100))
@@ -35,12 +35,12 @@ def test_default_font():
     assert_image_equal_tofile(im, "Tests/images/default_font.png")
 
 
-def test_size_without_freetype():
+def test_size_without_freetype() -> None:
     with pytest.raises(ImportError):
         ImageFont.load_default(size=14)
 
 
-def test_unicode():
+def test_unicode() -> None:
     # should not segfault, should return UnicodeDecodeError
     # issue #2826
     font = ImageFont.load_default()
@@ -48,7 +48,7 @@ def test_unicode():
         font.getbbox("’")
 
 
-def test_textbbox():
+def test_textbbox() -> None:
     im = Image.new("RGB", (200, 200))
     d = ImageDraw.Draw(im)
     default_font = ImageFont.load_default()
@@ -56,7 +56,7 @@ def test_textbbox():
     assert d.textbbox((0, 0), "test", font=default_font) == (0, 0, 24, 11)
 
 
-def test_decompression_bomb():
+def test_decompression_bomb() -> None:
     glyph = struct.pack(">hhhhhhhhhh", 1, 0, 0, 0, 256, 256, 0, 0, 256, 256)
     fp = BytesIO(b"PILfont\n\nDATA\n" + glyph * 256)
 
@@ -67,7 +67,7 @@ def test_decompression_bomb():
 
 
 @pytest.mark.timeout(4)
-def test_oom():
+def test_oom() -> None:
     glyph = struct.pack(
         ">hhhhhhhhhh", 1, 0, -32767, -32767, 32767, 32767, -32767, -32767, 32767, 32767
     )
diff --git a/Tests/test_imagegrab.py b/Tests/test_imagegrab.py
index 9d3d40398f6..40c1d323e77 100644
--- a/Tests/test_imagegrab.py
+++ b/Tests/test_imagegrab.py
@@ -20,7 +20,7 @@ class TestImageGrab:
     @pytest.mark.skipif(
         sys.platform not in ("win32", "darwin"), reason="requires Windows or macOS"
     )
-    def test_grab(self):
+    def test_grab(self) -> None:
         ImageGrab.grab()
         ImageGrab.grab(include_layered_windows=True)
         ImageGrab.grab(all_screens=True)
@@ -29,7 +29,7 @@ def test_grab(self):
         assert im.size == (40, 60)
 
     @skip_unless_feature("xcb")
-    def test_grab_x11(self):
+    def test_grab_x11(self) -> None:
         try:
             if sys.platform not in ("win32", "darwin"):
                 ImageGrab.grab()
@@ -39,7 +39,7 @@ def test_grab_x11(self):
             pytest.skip(str(e))
 
     @pytest.mark.skipif(Image.core.HAVE_XCB, reason="tests missing XCB")
-    def test_grab_no_xcb(self):
+    def test_grab_no_xcb(self) -> None:
         if sys.platform not in ("win32", "darwin") and not shutil.which(
             "gnome-screenshot"
         ):
@@ -52,12 +52,12 @@ def test_grab_no_xcb(self):
         assert str(e.value).startswith("Pillow was built without XCB support")
 
     @skip_unless_feature("xcb")
-    def test_grab_invalid_xdisplay(self):
+    def test_grab_invalid_xdisplay(self) -> None:
         with pytest.raises(OSError) as e:
             ImageGrab.grab(xdisplay="error.test:0.0")
         assert str(e.value).startswith("X connection failed")
 
-    def test_grabclipboard(self):
+    def test_grabclipboard(self) -> None:
         if sys.platform == "darwin":
             subprocess.call(["screencapture", "-cx"])
         elif sys.platform == "win32":
@@ -82,7 +82,7 @@ def test_grabclipboard(self):
         ImageGrab.grabclipboard()
 
     @pytest.mark.skipif(sys.platform != "win32", reason="Windows only")
-    def test_grabclipboard_file(self):
+    def test_grabclipboard_file(self) -> None:
         p = subprocess.Popen(["powershell", "-command", "-"], stdin=subprocess.PIPE)
         p.stdin.write(rb'Set-Clipboard -Path "Tests\images\hopper.gif"')
         p.communicate()
@@ -92,7 +92,7 @@ def test_grabclipboard_file(self):
         assert os.path.samefile(im[0], "Tests/images/hopper.gif")
 
     @pytest.mark.skipif(sys.platform != "win32", reason="Windows only")
-    def test_grabclipboard_png(self):
+    def test_grabclipboard_png(self) -> None:
         p = subprocess.Popen(["powershell", "-command", "-"], stdin=subprocess.PIPE)
         p.stdin.write(
             rb"""$bytes = [System.IO.File]::ReadAllBytes("Tests\images\hopper.png")
@@ -113,7 +113,7 @@ def test_grabclipboard_png(self):
         reason="Linux with wl-clipboard only",
     )
     @pytest.mark.parametrize("ext", ("gif", "png", "ico"))
-    def test_grabclipboard_wl_clipboard(self, ext):
+    def test_grabclipboard_wl_clipboard(self, ext) -> None:
         image_path = "Tests/images/hopper." + ext
         with open(image_path, "rb") as fp:
             subprocess.call(["wl-copy"], stdin=fp)
diff --git a/Tests/test_imagemath.py b/Tests/test_imagemath.py
index 622ad27eacb..ea6e80f1ee7 100644
--- a/Tests/test_imagemath.py
+++ b/Tests/test_imagemath.py
@@ -24,7 +24,7 @@ def pixel(im):
 images = {"A": A, "B": B, "F": F, "I": I}
 
 
-def test_sanity():
+def test_sanity() -> None:
     assert ImageMath.eval("1") == 1
     assert ImageMath.eval("1+A", A=2) == 3
     assert pixel(ImageMath.eval("A+B", A=A, B=B)) == "I 3"
@@ -33,7 +33,7 @@ def test_sanity():
     assert pixel(ImageMath.eval("int(float(A)+B)", images)) == "I 3"
 
 
-def test_ops():
+def test_ops() -> None:
     assert pixel(ImageMath.eval("-A", images)) == "I -1"
     assert pixel(ImageMath.eval("+B", images)) == "L 2"
 
@@ -60,51 +60,51 @@ def test_ops():
         "(lambda: (lambda: exec('pass'))())()",
     ),
 )
-def test_prevent_exec(expression):
+def test_prevent_exec(expression) -> None:
     with pytest.raises(ValueError):
         ImageMath.eval(expression)
 
 
-def test_prevent_double_underscores():
+def test_prevent_double_underscores() -> None:
     with pytest.raises(ValueError):
         ImageMath.eval("1", {"__": None})
 
 
-def test_prevent_builtins():
+def test_prevent_builtins() -> None:
     with pytest.raises(ValueError):
         ImageMath.eval("(lambda: exec('exit()'))()", {"exec": None})
 
 
-def test_logical():
+def test_logical() -> None:
     assert pixel(ImageMath.eval("not A", images)) == 0
     assert pixel(ImageMath.eval("A and B", images)) == "L 2"
     assert pixel(ImageMath.eval("A or B", images)) == "L 1"
 
 
-def test_convert():
+def test_convert() -> None:
     assert pixel(ImageMath.eval("convert(A+B, 'L')", images)) == "L 3"
     assert pixel(ImageMath.eval("convert(A+B, '1')", images)) == "1 0"
     assert pixel(ImageMath.eval("convert(A+B, 'RGB')", images)) == "RGB (3, 3, 3)"
 
 
-def test_compare():
+def test_compare() -> None:
     assert pixel(ImageMath.eval("min(A, B)", images)) == "I 1"
     assert pixel(ImageMath.eval("max(A, B)", images)) == "I 2"
     assert pixel(ImageMath.eval("A == 1", images)) == "I 1"
     assert pixel(ImageMath.eval("A == 2", images)) == "I 0"
 
 
-def test_one_image_larger():
+def test_one_image_larger() -> None:
     assert pixel(ImageMath.eval("A+B", A=A2, B=B)) == "I 3"
     assert pixel(ImageMath.eval("A+B", A=A, B=B2)) == "I 3"
 
 
-def test_abs():
+def test_abs() -> None:
     assert pixel(ImageMath.eval("abs(A)", A=A)) == "I 1"
     assert pixel(ImageMath.eval("abs(B)", B=B)) == "I 2"
 
 
-def test_binary_mod():
+def test_binary_mod() -> None:
     assert pixel(ImageMath.eval("A%A", A=A)) == "I 0"
     assert pixel(ImageMath.eval("B%B", B=B)) == "I 0"
     assert pixel(ImageMath.eval("A%B", A=A, B=B)) == "I 1"
@@ -113,90 +113,90 @@ def test_binary_mod():
     assert pixel(ImageMath.eval("Z%B", B=B, Z=Z)) == "I 0"
 
 
-def test_bitwise_invert():
+def test_bitwise_invert() -> None:
     assert pixel(ImageMath.eval("~Z", Z=Z)) == "I -1"
     assert pixel(ImageMath.eval("~A", A=A)) == "I -2"
     assert pixel(ImageMath.eval("~B", B=B)) == "I -3"
 
 
-def test_bitwise_and():
+def test_bitwise_and() -> None:
     assert pixel(ImageMath.eval("Z&Z", A=A, Z=Z)) == "I 0"
     assert pixel(ImageMath.eval("Z&A", A=A, Z=Z)) == "I 0"
     assert pixel(ImageMath.eval("A&Z", A=A, Z=Z)) == "I 0"
     assert pixel(ImageMath.eval("A&A", A=A, Z=Z)) == "I 1"
 
 
-def test_bitwise_or():
+def test_bitwise_or() -> None:
     assert pixel(ImageMath.eval("Z|Z", A=A, Z=Z)) == "I 0"
     assert pixel(ImageMath.eval("Z|A", A=A, Z=Z)) == "I 1"
     assert pixel(ImageMath.eval("A|Z", A=A, Z=Z)) == "I 1"
     assert pixel(ImageMath.eval("A|A", A=A, Z=Z)) == "I 1"
 
 
-def test_bitwise_xor():
+def test_bitwise_xor() -> None:
     assert pixel(ImageMath.eval("Z^Z", A=A, Z=Z)) == "I 0"
     assert pixel(ImageMath.eval("Z^A", A=A, Z=Z)) == "I 1"
     assert pixel(ImageMath.eval("A^Z", A=A, Z=Z)) == "I 1"
     assert pixel(ImageMath.eval("A^A", A=A, Z=Z)) == "I 0"
 
 
-def test_bitwise_leftshift():
+def test_bitwise_leftshift() -> None:
     assert pixel(ImageMath.eval("Z<<0", Z=Z)) == "I 0"
     assert pixel(ImageMath.eval("Z<<1", Z=Z)) == "I 0"
     assert pixel(ImageMath.eval("A<<0", A=A)) == "I 1"
     assert pixel(ImageMath.eval("A<<1", A=A)) == "I 2"
 
 
-def test_bitwise_rightshift():
+def test_bitwise_rightshift() -> None:
     assert pixel(ImageMath.eval("Z>>0", Z=Z)) == "I 0"
     assert pixel(ImageMath.eval("Z>>1", Z=Z)) == "I 0"
     assert pixel(ImageMath.eval("A>>0", A=A)) == "I 1"
     assert pixel(ImageMath.eval("A>>1", A=A)) == "I 0"
 
 
-def test_logical_eq():
+def test_logical_eq() -> None:
     assert pixel(ImageMath.eval("A==A", A=A)) == "I 1"
     assert pixel(ImageMath.eval("B==B", B=B)) == "I 1"
     assert pixel(ImageMath.eval("A==B", A=A, B=B)) == "I 0"
     assert pixel(ImageMath.eval("B==A", A=A, B=B)) == "I 0"
 
 
-def test_logical_ne():
+def test_logical_ne() -> None:
     assert pixel(ImageMath.eval("A!=A", A=A)) == "I 0"
     assert pixel(ImageMath.eval("B!=B", B=B)) == "I 0"
     assert pixel(ImageMath.eval("A!=B", A=A, B=B)) == "I 1"
     assert pixel(ImageMath.eval("B!=A", A=A, B=B)) == "I 1"
 
 
-def test_logical_lt():
+def test_logical_lt() -> None:
     assert pixel(ImageMath.eval("A<A", A=A)) == "I 0"
     assert pixel(ImageMath.eval("B<B", B=B)) == "I 0"
     assert pixel(ImageMath.eval("A<B", A=A, B=B)) == "I 1"
     assert pixel(ImageMath.eval("B<A", A=A, B=B)) == "I 0"
 
 
-def test_logical_le():
+def test_logical_le() -> None:
     assert pixel(ImageMath.eval("A<=A", A=A)) == "I 1"
     assert pixel(ImageMath.eval("B<=B", B=B)) == "I 1"
     assert pixel(ImageMath.eval("A<=B", A=A, B=B)) == "I 1"
     assert pixel(ImageMath.eval("B<=A", A=A, B=B)) == "I 0"
 
 
-def test_logical_gt():
+def test_logical_gt() -> None:
     assert pixel(ImageMath.eval("A>A", A=A)) == "I 0"
     assert pixel(ImageMath.eval("B>B", B=B)) == "I 0"
     assert pixel(ImageMath.eval("A>B", A=A, B=B)) == "I 0"
     assert pixel(ImageMath.eval("B>A", A=A, B=B)) == "I 1"
 
 
-def test_logical_ge():
+def test_logical_ge() -> None:
     assert pixel(ImageMath.eval("A>=A", A=A)) == "I 1"
     assert pixel(ImageMath.eval("B>=B", B=B)) == "I 1"
     assert pixel(ImageMath.eval("A>=B", A=A, B=B)) == "I 0"
     assert pixel(ImageMath.eval("B>=A", A=A, B=B)) == "I 1"
 
 
-def test_logical_equal():
+def test_logical_equal() -> None:
     assert pixel(ImageMath.eval("equal(A, A)", A=A)) == "I 1"
     assert pixel(ImageMath.eval("equal(B, B)", B=B)) == "I 1"
     assert pixel(ImageMath.eval("equal(Z, Z)", Z=Z)) == "I 1"
@@ -205,7 +205,7 @@ def test_logical_equal():
     assert pixel(ImageMath.eval("equal(A, Z)", A=A, Z=Z)) == "I 0"
 
 
-def test_logical_not_equal():
+def test_logical_not_equal() -> None:
     assert pixel(ImageMath.eval("notequal(A, A)", A=A)) == "I 0"
     assert pixel(ImageMath.eval("notequal(B, B)", B=B)) == "I 0"
     assert pixel(ImageMath.eval("notequal(Z, Z)", Z=Z)) == "I 0"
diff --git a/Tests/test_imagemorph.py b/Tests/test_imagemorph.py
index 0708ee63905..0b0c6d2d31a 100644
--- a/Tests/test_imagemorph.py
+++ b/Tests/test_imagemorph.py
@@ -1,6 +1,8 @@
 # Test the ImageMorphology functionality
 from __future__ import annotations
 
+from pathlib import Path
+
 import pytest
 
 from PIL import Image, ImageMorph, _imagingmorph
@@ -50,18 +52,18 @@ def img_string_normalize(im):
     return img_to_string(string_to_img(im))
 
 
-def assert_img_equal_img_string(a, b_string):
+def assert_img_equal_img_string(a, b_string) -> None:
     assert img_to_string(a) == img_string_normalize(b_string)
 
 
-def test_str_to_img():
+def test_str_to_img() -> None:
     assert_image_equal_tofile(A, "Tests/images/morph_a.png")
 
 
 @pytest.mark.parametrize(
     "op", ("corner", "dilation4", "dilation8", "erosion4", "erosion8", "edge")
 )
-def test_lut(op):
+def test_lut(op) -> None:
     lb = ImageMorph.LutBuilder(op_name=op)
     assert lb.get_lut() is None
 
@@ -70,7 +72,7 @@ def test_lut(op):
         assert lut == bytearray(f.read())
 
 
-def test_no_operator_loaded():
+def test_no_operator_loaded() -> None:
     mop = ImageMorph.MorphOp()
     with pytest.raises(Exception) as e:
         mop.apply(None)
@@ -84,7 +86,7 @@ def test_no_operator_loaded():
 
 
 # Test the named patterns
-def test_erosion8():
+def test_erosion8() -> None:
     # erosion8
     mop = ImageMorph.MorphOp(op_name="erosion8")
     count, Aout = mop.apply(A)
@@ -103,7 +105,7 @@ def test_erosion8():
     )
 
 
-def test_dialation8():
+def test_dialation8() -> None:
     # dialation8
     mop = ImageMorph.MorphOp(op_name="dilation8")
     count, Aout = mop.apply(A)
@@ -122,7 +124,7 @@ def test_dialation8():
     )
 
 
-def test_erosion4():
+def test_erosion4() -> None:
     # erosion4
     mop = ImageMorph.MorphOp(op_name="dilation4")
     count, Aout = mop.apply(A)
@@ -141,7 +143,7 @@ def test_erosion4():
     )
 
 
-def test_edge():
+def test_edge() -> None:
     # edge
     mop = ImageMorph.MorphOp(op_name="edge")
     count, Aout = mop.apply(A)
@@ -160,7 +162,7 @@ def test_edge():
     )
 
 
-def test_corner():
+def test_corner() -> None:
     # Create a corner detector pattern
     mop = ImageMorph.MorphOp(patterns=["1:(... ... ...)->0", "4:(00. 01. ...)->1"])
     count, Aout = mop.apply(A)
@@ -188,7 +190,7 @@ def test_corner():
     assert tuple(coords) == ((2, 2), (4, 2), (2, 4), (4, 4))
 
 
-def test_mirroring():
+def test_mirroring() -> None:
     # Test 'M' for mirroring
     mop = ImageMorph.MorphOp(patterns=["1:(... ... ...)->0", "M:(00. 01. ...)->1"])
     count, Aout = mop.apply(A)
@@ -207,7 +209,7 @@ def test_mirroring():
     )
 
 
-def test_negate():
+def test_negate() -> None:
     # Test 'N' for negate
     mop = ImageMorph.MorphOp(patterns=["1:(... ... ...)->0", "N:(00. 01. ...)->1"])
     count, Aout = mop.apply(A)
@@ -226,7 +228,7 @@ def test_negate():
     )
 
 
-def test_incorrect_mode():
+def test_incorrect_mode() -> None:
     im = hopper("RGB")
     mop = ImageMorph.MorphOp(op_name="erosion8")
 
@@ -241,7 +243,7 @@ def test_incorrect_mode():
     assert str(e.value) == "Image mode must be L"
 
 
-def test_add_patterns():
+def test_add_patterns() -> None:
     # Arrange
     lb = ImageMorph.LutBuilder(op_name="corner")
     assert lb.patterns == ["1:(... ... ...)->0", "4:(00. 01. ...)->1"]
@@ -259,12 +261,12 @@ def test_add_patterns():
     ]
 
 
-def test_unknown_pattern():
+def test_unknown_pattern() -> None:
     with pytest.raises(Exception):
         ImageMorph.LutBuilder(op_name="unknown")
 
 
-def test_pattern_syntax_error():
+def test_pattern_syntax_error() -> None:
     # Arrange
     lb = ImageMorph.LutBuilder(op_name="corner")
     new_patterns = ["a pattern with a syntax error"]
@@ -276,7 +278,7 @@ def test_pattern_syntax_error():
     assert str(e.value) == 'Syntax error in pattern "a pattern with a syntax error"'
 
 
-def test_load_invalid_mrl():
+def test_load_invalid_mrl() -> None:
     # Arrange
     invalid_mrl = "Tests/images/hopper.png"
     mop = ImageMorph.MorphOp()
@@ -287,7 +289,7 @@ def test_load_invalid_mrl():
     assert str(e.value) == "Wrong size operator file!"
 
 
-def test_roundtrip_mrl(tmp_path):
+def test_roundtrip_mrl(tmp_path: Path) -> None:
     # Arrange
     tempfile = str(tmp_path / "temp.mrl")
     mop = ImageMorph.MorphOp(op_name="corner")
@@ -301,7 +303,7 @@ def test_roundtrip_mrl(tmp_path):
     assert mop.lut == initial_lut
 
 
-def test_set_lut():
+def test_set_lut() -> None:
     # Arrange
     lb = ImageMorph.LutBuilder(op_name="corner")
     lut = lb.build_lut()
@@ -314,7 +316,7 @@ def test_set_lut():
     assert mop.lut == lut
 
 
-def test_wrong_mode():
+def test_wrong_mode() -> None:
     lut = ImageMorph.LutBuilder(op_name="corner").build_lut()
     imrgb = Image.new("RGB", (10, 10))
     iml = Image.new("L", (10, 10))
diff --git a/Tests/test_imageops.py b/Tests/test_imageops.py
index 636b99dbe8f..50bf404aebe 100644
--- a/Tests/test_imageops.py
+++ b/Tests/test_imageops.py
@@ -22,7 +22,7 @@ def getmesh(self, im):
 deformer = Deformer()
 
 
-def test_sanity():
+def test_sanity() -> None:
     ImageOps.autocontrast(hopper("L"))
     ImageOps.autocontrast(hopper("RGB"))
 
@@ -84,7 +84,7 @@ def test_sanity():
     ImageOps.exif_transpose(hopper("RGB"))
 
 
-def test_1pxfit():
+def test_1pxfit() -> None:
     # Division by zero in equalize if image is 1 pixel high
     newimg = ImageOps.fit(hopper("RGB").resize((1, 1)), (35, 35))
     assert newimg.size == (35, 35)
@@ -96,7 +96,7 @@ def test_1pxfit():
     assert newimg.size == (35, 35)
 
 
-def test_fit_same_ratio():
+def test_fit_same_ratio() -> None:
     # The ratio for this image is 1000.0 / 755 = 1.3245033112582782
     # If the ratios are not acknowledged to be the same,
     # and Pillow attempts to adjust the width to
@@ -108,13 +108,13 @@ def test_fit_same_ratio():
 
 
 @pytest.mark.parametrize("new_size", ((256, 256), (512, 256), (256, 512)))
-def test_contain(new_size):
+def test_contain(new_size) -> None:
     im = hopper()
     new_im = ImageOps.contain(im, new_size)
     assert new_im.size == (256, 256)
 
 
-def test_contain_round():
+def test_contain_round() -> None:
     im = Image.new("1", (43, 63), 1)
     new_im = ImageOps.contain(im, (5, 7))
     assert new_im.width == 5
@@ -132,13 +132,13 @@ def test_contain_round():
         ("hopper.png", (256, 256)),  # square
     ),
 )
-def test_cover(image_name, expected_size):
+def test_cover(image_name, expected_size) -> None:
     with Image.open("Tests/images/" + image_name) as im:
         new_im = ImageOps.cover(im, (256, 256))
         assert new_im.size == expected_size
 
 
-def test_pad():
+def test_pad() -> None:
     # Same ratio
     im = hopper()
     new_size = (im.width * 2, im.height * 2)
@@ -158,7 +158,7 @@ def test_pad():
             )
 
 
-def test_pad_round():
+def test_pad_round() -> None:
     im = Image.new("1", (1, 1), 1)
     new_im = ImageOps.pad(im, (4, 1))
     assert new_im.load()[2, 0] == 1
@@ -168,7 +168,7 @@ def test_pad_round():
 
 
 @pytest.mark.parametrize("mode", ("P", "PA"))
-def test_palette(mode):
+def test_palette(mode) -> None:
     im = hopper(mode)
 
     # Expand
@@ -182,7 +182,7 @@ def test_palette(mode):
     )
 
 
-def test_pil163():
+def test_pil163() -> None:
     # Division by zero in equalize if < 255 pixels in image (@PIL163)
 
     i = hopper("RGB").resize((15, 16))
@@ -192,7 +192,7 @@ def test_pil163():
     ImageOps.equalize(i.convert("RGB"))
 
 
-def test_scale():
+def test_scale() -> None:
     # Test the scaling function
     i = hopper("L").resize((50, 50))
 
@@ -210,7 +210,7 @@ def test_scale():
 
 
 @pytest.mark.parametrize("border", (10, (1, 2, 3, 4)))
-def test_expand_palette(border):
+def test_expand_palette(border) -> None:
     with Image.open("Tests/images/p_16.tga") as im:
         im_expanded = ImageOps.expand(im, border, (255, 0, 0))
 
@@ -236,7 +236,7 @@ def test_expand_palette(border):
         assert_image_equal(im_cropped, im)
 
 
-def test_colorize_2color():
+def test_colorize_2color() -> None:
     # Test the colorizing function with 2-color functionality
 
     # Open test image (256px by 10px, black to white)
@@ -270,7 +270,7 @@ def test_colorize_2color():
     )
 
 
-def test_colorize_2color_offset():
+def test_colorize_2color_offset() -> None:
     # Test the colorizing function with 2-color functionality and offset
 
     # Open test image (256px by 10px, black to white)
@@ -306,7 +306,7 @@ def test_colorize_2color_offset():
     )
 
 
-def test_colorize_3color_offset():
+def test_colorize_3color_offset() -> None:
     # Test the colorizing function with 3-color functionality and offset
 
     # Open test image (256px by 10px, black to white)
@@ -359,14 +359,14 @@ def test_colorize_3color_offset():
     )
 
 
-def test_exif_transpose():
+def test_exif_transpose() -> None:
     exts = [".jpg"]
     if features.check("webp") and features.check("webp_anim"):
         exts.append(".webp")
     for ext in exts:
         with Image.open("Tests/images/hopper" + ext) as base_im:
 
-            def check(orientation_im):
+            def check(orientation_im) -> None:
                 for im in [
                     orientation_im,
                     orientation_im.copy(),
@@ -423,7 +423,7 @@ def check(orientation_im):
     assert 0x0112 not in transposed_im.getexif()
 
 
-def test_exif_transpose_in_place():
+def test_exif_transpose_in_place() -> None:
     with Image.open("Tests/images/orientation_rectangle.jpg") as im:
         assert im.size == (2, 1)
         assert im.getexif()[0x0112] == 8
@@ -435,13 +435,13 @@ def test_exif_transpose_in_place():
         assert_image_equal(im, expected)
 
 
-def test_autocontrast_unsupported_mode():
+def test_autocontrast_unsupported_mode() -> None:
     im = Image.new("RGBA", (1, 1))
     with pytest.raises(OSError):
         ImageOps.autocontrast(im)
 
 
-def test_autocontrast_cutoff():
+def test_autocontrast_cutoff() -> None:
     # Test the cutoff argument of autocontrast
     with Image.open("Tests/images/bw_gradient.png") as img:
 
@@ -452,7 +452,7 @@ def autocontrast(cutoff):
         assert autocontrast(10) != autocontrast((1, 10))
 
 
-def test_autocontrast_mask_toy_input():
+def test_autocontrast_mask_toy_input() -> None:
     # Test the mask argument of autocontrast
     with Image.open("Tests/images/bw_gradient.png") as img:
         rect_mask = Image.new("L", img.size, 0)
@@ -471,7 +471,7 @@ def test_autocontrast_mask_toy_input():
         assert ImageStat.Stat(result_nomask).median == [128]
 
 
-def test_autocontrast_mask_real_input():
+def test_autocontrast_mask_real_input() -> None:
     # Test the autocontrast with a rectangular mask
     with Image.open("Tests/images/iptc.jpg") as img:
         rect_mask = Image.new("L", img.size, 0)
@@ -498,7 +498,7 @@ def test_autocontrast_mask_real_input():
         )
 
 
-def test_autocontrast_preserve_tone():
+def test_autocontrast_preserve_tone() -> None:
     def autocontrast(mode, preserve_tone):
         im = hopper(mode)
         return ImageOps.autocontrast(im, preserve_tone=preserve_tone).histogram()
@@ -507,7 +507,7 @@ def autocontrast(mode, preserve_tone):
     assert autocontrast("L", True) == autocontrast("L", False)
 
 
-def test_autocontrast_preserve_gradient():
+def test_autocontrast_preserve_gradient() -> None:
     gradient = Image.linear_gradient("L")
 
     # test with a grayscale gradient that extends to 0,255.
@@ -533,7 +533,7 @@ def test_autocontrast_preserve_gradient():
 @pytest.mark.parametrize(
     "color", ((255, 255, 255), (127, 255, 0), (127, 127, 127), (0, 0, 0))
 )
-def test_autocontrast_preserve_one_color(color):
+def test_autocontrast_preserve_one_color(color) -> None:
     img = Image.new("RGB", (10, 10), color)
 
     # single color images shouldn't change
diff --git a/Tests/test_imageops_usm.py b/Tests/test_imageops_usm.py
index 8ffb9bff7a2..03302e20f2a 100644
--- a/Tests/test_imageops_usm.py
+++ b/Tests/test_imageops_usm.py
@@ -18,7 +18,7 @@ def test_images():
             im.close()
 
 
-def test_filter_api(test_images):
+def test_filter_api(test_images) -> None:
     im = test_images["im"]
 
     test_filter = ImageFilter.GaussianBlur(2.0)
@@ -32,7 +32,7 @@ def test_filter_api(test_images):
     assert i.size == (128, 128)
 
 
-def test_usm_formats(test_images):
+def test_usm_formats(test_images) -> None:
     im = test_images["im"]
 
     usm = ImageFilter.UnsharpMask
@@ -50,7 +50,7 @@ def test_usm_formats(test_images):
         im.convert("YCbCr").filter(usm)
 
 
-def test_blur_formats(test_images):
+def test_blur_formats(test_images) -> None:
     im = test_images["im"]
 
     blur = ImageFilter.GaussianBlur
@@ -68,7 +68,7 @@ def test_blur_formats(test_images):
         im.convert("YCbCr").filter(blur)
 
 
-def test_usm_accuracy(test_images):
+def test_usm_accuracy(test_images) -> None:
     snakes = test_images["snakes"]
 
     src = snakes.convert("RGB")
@@ -77,7 +77,7 @@ def test_usm_accuracy(test_images):
     assert i.tobytes() == src.tobytes()
 
 
-def test_blur_accuracy(test_images):
+def test_blur_accuracy(test_images) -> None:
     snakes = test_images["snakes"]
 
     i = snakes.filter(ImageFilter.GaussianBlur(0.4))
diff --git a/Tests/test_imagepalette.py b/Tests/test_imagepalette.py
index be21464b4ae..545229500a6 100644
--- a/Tests/test_imagepalette.py
+++ b/Tests/test_imagepalette.py
@@ -1,5 +1,7 @@
 from __future__ import annotations
 
+from pathlib import Path
+
 import pytest
 
 from PIL import Image, ImagePalette
@@ -7,19 +9,19 @@
 from .helper import assert_image_equal, assert_image_equal_tofile
 
 
-def test_sanity():
+def test_sanity() -> None:
     palette = ImagePalette.ImagePalette("RGB", list(range(256)) * 3)
     assert len(palette.colors) == 256
 
 
-def test_reload():
+def test_reload() -> None:
     with Image.open("Tests/images/hopper.gif") as im:
         original = im.copy()
         im.palette.dirty = 1
         assert_image_equal(im.convert("RGB"), original.convert("RGB"))
 
 
-def test_getcolor():
+def test_getcolor() -> None:
     palette = ImagePalette.ImagePalette()
     assert len(palette.palette) == 0
     assert len(palette.colors) == 0
@@ -46,7 +48,7 @@ def test_getcolor():
         palette.getcolor("unknown")
 
 
-def test_getcolor_rgba_color_rgb_palette():
+def test_getcolor_rgba_color_rgb_palette() -> None:
     palette = ImagePalette.ImagePalette("RGB")
 
     # Opaque RGBA colors are converted
@@ -65,7 +67,7 @@ def test_getcolor_rgba_color_rgb_palette():
         (255, ImagePalette.ImagePalette("RGB", list(range(256)) * 3)),
     ],
 )
-def test_getcolor_not_special(index, palette):
+def test_getcolor_not_special(index, palette) -> None:
     im = Image.new("P", (1, 1))
 
     # Do not use transparency index as a new color
@@ -79,7 +81,7 @@ def test_getcolor_not_special(index, palette):
     assert index2 not in (index, index1)
 
 
-def test_file(tmp_path):
+def test_file(tmp_path: Path) -> None:
     palette = ImagePalette.ImagePalette("RGB", list(range(256)) * 3)
 
     f = str(tmp_path / "temp.lut")
@@ -97,7 +99,7 @@ def test_file(tmp_path):
     assert p.palette == palette.tobytes()
 
 
-def test_make_linear_lut():
+def test_make_linear_lut() -> None:
     # Arrange
     black = 0
     white = 255
@@ -113,7 +115,7 @@ def test_make_linear_lut():
         assert lut[i] == i
 
 
-def test_make_linear_lut_not_yet_implemented():
+def test_make_linear_lut_not_yet_implemented() -> None:
     # Update after FIXME
     # Arrange
     black = 1
@@ -124,7 +126,7 @@ def test_make_linear_lut_not_yet_implemented():
         ImagePalette.make_linear_lut(black, white)
 
 
-def test_make_gamma_lut():
+def test_make_gamma_lut() -> None:
     # Arrange
     exp = 5
 
@@ -142,7 +144,7 @@ def test_make_gamma_lut():
     assert lut[255] == 255
 
 
-def test_rawmode_valueerrors(tmp_path):
+def test_rawmode_valueerrors(tmp_path: Path) -> None:
     # Arrange
     palette = ImagePalette.raw("RGB", list(range(256)) * 3)
 
@@ -156,7 +158,7 @@ def test_rawmode_valueerrors(tmp_path):
         palette.save(f)
 
 
-def test_getdata():
+def test_getdata() -> None:
     # Arrange
     data_in = list(range(256)) * 3
     palette = ImagePalette.ImagePalette("RGB", data_in)
@@ -168,7 +170,7 @@ def test_getdata():
     assert mode == "RGB"
 
 
-def test_rawmode_getdata():
+def test_rawmode_getdata() -> None:
     # Arrange
     data_in = list(range(256)) * 3
     palette = ImagePalette.raw("RGB", data_in)
@@ -181,7 +183,7 @@ def test_rawmode_getdata():
     assert data_in == data_out
 
 
-def test_2bit_palette(tmp_path):
+def test_2bit_palette(tmp_path: Path) -> None:
     # issue #2258, 2 bit palettes are corrupted.
     outfile = str(tmp_path / "temp.png")
 
@@ -193,6 +195,6 @@ def test_2bit_palette(tmp_path):
     assert_image_equal_tofile(img, outfile)
 
 
-def test_invalid_palette():
+def test_invalid_palette() -> None:
     with pytest.raises(OSError):
         ImagePalette.load("Tests/images/hopper.jpg")
diff --git a/Tests/test_imagepath.py b/Tests/test_imagepath.py
index 5c6393e237f..8ba745f215d 100644
--- a/Tests/test_imagepath.py
+++ b/Tests/test_imagepath.py
@@ -9,7 +9,7 @@
 from PIL import Image, ImagePath
 
 
-def test_path():
+def test_path() -> None:
     p = ImagePath.Path(list(range(10)))
 
     # sequence interface
@@ -57,7 +57,7 @@ def test_path():
         ImagePath.Path((0, 1)),
     ),
 )
-def test_path_constructors(coords):
+def test_path_constructors(coords) -> None:
     # Arrange / Act
     p = ImagePath.Path(coords)
 
@@ -75,7 +75,7 @@ def test_path_constructors(coords):
         [[0.0, 1.0]],
     ),
 )
-def test_invalid_path_constructors(coords):
+def test_invalid_path_constructors(coords) -> None:
     # Act
     with pytest.raises(ValueError) as e:
         ImagePath.Path(coords)
@@ -93,7 +93,7 @@ def test_invalid_path_constructors(coords):
         [0, 1, 2],
     ),
 )
-def test_path_odd_number_of_coordinates(coords):
+def test_path_odd_number_of_coordinates(coords) -> None:
     # Act
     with pytest.raises(ValueError) as e:
         ImagePath.Path(coords)
@@ -111,7 +111,7 @@ def test_path_odd_number_of_coordinates(coords):
         (1, (0.0, 0.0, 0.0, 0.0)),
     ],
 )
-def test_getbbox(coords, expected):
+def test_getbbox(coords, expected) -> None:
     # Arrange
     p = ImagePath.Path(coords)
 
@@ -119,7 +119,7 @@ def test_getbbox(coords, expected):
     assert p.getbbox() == expected
 
 
-def test_getbbox_no_args():
+def test_getbbox_no_args() -> None:
     # Arrange
     p = ImagePath.Path([0, 1, 2, 3])
 
@@ -135,7 +135,7 @@ def test_getbbox_no_args():
         (list(range(6)), [(0.0, 3.0), (4.0, 9.0), (8.0, 15.0)]),
     ],
 )
-def test_map(coords, expected):
+def test_map(coords, expected) -> None:
     # Arrange
     p = ImagePath.Path(coords)
 
@@ -147,7 +147,7 @@ def test_map(coords, expected):
     assert list(p) == expected
 
 
-def test_transform():
+def test_transform() -> None:
     # Arrange
     p = ImagePath.Path([0, 1, 2, 3])
     theta = math.pi / 15
@@ -165,7 +165,7 @@ def test_transform():
     ]
 
 
-def test_transform_with_wrap():
+def test_transform_with_wrap() -> None:
     # Arrange
     p = ImagePath.Path([0, 1, 2, 3])
     theta = math.pi / 15
@@ -184,7 +184,7 @@ def test_transform_with_wrap():
     ]
 
 
-def test_overflow_segfault():
+def test_overflow_segfault() -> None:
     # Some Pythons fail getting the argument as an integer, and it falls
     # through to the sequence. Seeing this on 32-bit Windows.
     with pytest.raises((TypeError, MemoryError)):
@@ -198,12 +198,12 @@ def test_overflow_segfault():
 
 
 class Evil:
-    def __init__(self):
+    def __init__(self) -> None:
         self.corrupt = Image.core.path(0x4000000000000000)
 
     def __getitem__(self, i):
         x = self.corrupt[i]
         return struct.pack("dd", x[0], x[1])
 
-    def __setitem__(self, i, x):
+    def __setitem__(self, i, x) -> None:
         self.corrupt[i] = struct.unpack("dd", x)
diff --git a/Tests/test_imageqt.py b/Tests/test_imageqt.py
index d55d980d9be..909f9716700 100644
--- a/Tests/test_imageqt.py
+++ b/Tests/test_imageqt.py
@@ -16,7 +16,7 @@
     from PIL.ImageQt import qRgba
 
 
-def test_rgb():
+def test_rgb() -> None:
     # from https://doc.qt.io/archives/qt-4.8/qcolor.html
     # typedef QRgb
     # An ARGB quadruplet on the format #AARRGGBB,
@@ -28,7 +28,7 @@ def test_rgb():
 
     assert qRgb(0, 0, 0) == qRgba(0, 0, 0, 255)
 
-    def checkrgb(r, g, b):
+    def checkrgb(r, g, b) -> None:
         val = ImageQt.rgb(r, g, b)
         val = val % 2**24  # drop the alpha
         assert val >> 16 == r
@@ -41,7 +41,7 @@ def checkrgb(r, g, b):
     checkrgb(0, 0, 255)
 
 
-def test_image():
+def test_image() -> None:
     modes = ["1", "RGB", "RGBA", "L", "P"]
     qt_format = ImageQt.QImage.Format if ImageQt.qt_version == "6" else ImageQt.QImage
     if hasattr(qt_format, "Format_Grayscale16"):  # Qt 5.13+
@@ -55,6 +55,6 @@ def test_image():
         assert_image_similar(roundtripped_im, im, 1)
 
 
-def test_closed_file():
+def test_closed_file() -> None:
     with warnings.catch_warnings():
         ImageQt.ImageQt("Tests/images/hopper.gif")
diff --git a/Tests/test_imagesequence.py b/Tests/test_imagesequence.py
index 66d553bcbc7..7280dded01f 100644
--- a/Tests/test_imagesequence.py
+++ b/Tests/test_imagesequence.py
@@ -1,5 +1,7 @@
 from __future__ import annotations
 
+from pathlib import Path
+
 import pytest
 
 from PIL import Image, ImageSequence, TiffImagePlugin
@@ -7,7 +9,7 @@
 from .helper import assert_image_equal, hopper, skip_unless_feature
 
 
-def test_sanity(tmp_path):
+def test_sanity(tmp_path: Path) -> None:
     test_file = str(tmp_path / "temp.im")
 
     im = hopper("RGB")
@@ -27,7 +29,7 @@ def test_sanity(tmp_path):
         ImageSequence.Iterator(0)
 
 
-def test_iterator():
+def test_iterator() -> None:
     with Image.open("Tests/images/multipage.tiff") as im:
         i = ImageSequence.Iterator(im)
         for index in range(0, im.n_frames):
@@ -38,14 +40,14 @@ def test_iterator():
             next(i)
 
 
-def test_iterator_min_frame():
+def test_iterator_min_frame() -> None:
     with Image.open("Tests/images/hopper.psd") as im:
         i = ImageSequence.Iterator(im)
         for index in range(1, im.n_frames):
             assert i[index] == next(i)
 
 
-def _test_multipage_tiff():
+def _test_multipage_tiff() -> None:
     with Image.open("Tests/images/multipage.tiff") as im:
         for index, frame in enumerate(ImageSequence.Iterator(im)):
             frame.load()
@@ -53,18 +55,18 @@ def _test_multipage_tiff():
             frame.convert("RGB")
 
 
-def test_tiff():
+def test_tiff() -> None:
     _test_multipage_tiff()
 
 
 @skip_unless_feature("libtiff")
-def test_libtiff():
+def test_libtiff() -> None:
     TiffImagePlugin.READ_LIBTIFF = True
     _test_multipage_tiff()
     TiffImagePlugin.READ_LIBTIFF = False
 
 
-def test_consecutive():
+def test_consecutive() -> None:
     with Image.open("Tests/images/multipage.tiff") as im:
         first_frame = None
         for frame in ImageSequence.Iterator(im):
@@ -75,7 +77,7 @@ def test_consecutive():
             break
 
 
-def test_palette_mmap():
+def test_palette_mmap() -> None:
     # Using mmap in ImageFile can require to reload the palette.
     with Image.open("Tests/images/multipage-mmap.tiff") as im:
         color1 = im.getpalette()[:3]
@@ -84,7 +86,7 @@ def test_palette_mmap():
         assert color1 == color2
 
 
-def test_all_frames():
+def test_all_frames() -> None:
     # Test a single image
     with Image.open("Tests/images/iss634.gif") as im:
         ims = ImageSequence.all_frames(im)
diff --git a/Tests/test_imageshow.py b/Tests/test_imageshow.py
index 0996ad41d4d..f7269d45b56 100644
--- a/Tests/test_imageshow.py
+++ b/Tests/test_imageshow.py
@@ -7,12 +7,12 @@
 from .helper import hopper, is_win32, on_ci
 
 
-def test_sanity():
+def test_sanity() -> None:
     dir(Image)
     dir(ImageShow)
 
 
-def test_register():
+def test_register() -> None:
     # Test registering a viewer that is not a class
     ImageShow.register("not a class")
 
@@ -24,9 +24,9 @@ def test_register():
     "order",
     [-1, 0],
 )
-def test_viewer_show(order):
+def test_viewer_show(order) -> None:
     class TestViewer(ImageShow.Viewer):
-        def show_image(self, image, **options):
+        def show_image(self, image, **options) -> bool:
             self.methodCalled = True
             return True
 
@@ -48,12 +48,12 @@ def show_image(self, image, **options):
     reason="Only run on CIs; hangs on Windows CIs",
 )
 @pytest.mark.parametrize("mode", ("1", "I;16", "LA", "RGB", "RGBA"))
-def test_show(mode):
+def test_show(mode) -> None:
     im = hopper(mode)
     assert ImageShow.show(im)
 
 
-def test_show_without_viewers():
+def test_show_without_viewers() -> None:
     viewers = ImageShow._viewers
     ImageShow._viewers = []
 
@@ -63,7 +63,7 @@ def test_show_without_viewers():
     ImageShow._viewers = viewers
 
 
-def test_viewer():
+def test_viewer() -> None:
     viewer = ImageShow.Viewer()
 
     assert viewer.get_format(None) is None
@@ -73,14 +73,14 @@ def test_viewer():
 
 
 @pytest.mark.parametrize("viewer", ImageShow._viewers)
-def test_viewers(viewer):
+def test_viewers(viewer) -> None:
     try:
         viewer.get_command("test.jpg")
     except NotImplementedError:
         pass
 
 
-def test_ipythonviewer():
+def test_ipythonviewer() -> None:
     pytest.importorskip("IPython", reason="IPython not installed")
     for viewer in ImageShow._viewers:
         if isinstance(viewer, ImageShow.IPythonViewer):
diff --git a/Tests/test_imagestat.py b/Tests/test_imagestat.py
index 01687db353e..b1c1306c1ec 100644
--- a/Tests/test_imagestat.py
+++ b/Tests/test_imagestat.py
@@ -7,7 +7,7 @@
 from .helper import hopper
 
 
-def test_sanity():
+def test_sanity() -> None:
     im = hopper()
 
     st = ImageStat.Stat(im)
@@ -31,7 +31,7 @@ def test_sanity():
         ImageStat.Stat(1)
 
 
-def test_hopper():
+def test_hopper() -> None:
     im = hopper()
 
     st = ImageStat.Stat(im)
@@ -44,7 +44,7 @@ def test_hopper():
     assert st.sum[2] == 1563008
 
 
-def test_constant():
+def test_constant() -> None:
     im = Image.new("L", (128, 128), 128)
 
     st = ImageStat.Stat(im)
diff --git a/Tests/test_imagetk.py b/Tests/test_imagetk.py
index c06fc58235b..a216bd21de2 100644
--- a/Tests/test_imagetk.py
+++ b/Tests/test_imagetk.py
@@ -23,7 +23,7 @@
 pytestmark = pytest.mark.skipif(not HAS_TK, reason="Tk not installed")
 
 
-def setup_module():
+def setup_module() -> None:
     try:
         # setup tk
         tk.Frame()
@@ -34,7 +34,7 @@ def setup_module():
         pytest.skip(f"TCL Error: {v}")
 
 
-def test_kw():
+def test_kw() -> None:
     TEST_JPG = "Tests/images/hopper.jpg"
     TEST_PNG = "Tests/images/hopper.png"
     with Image.open(TEST_JPG) as im1:
@@ -57,7 +57,7 @@ def test_kw():
 
 
 @pytest.mark.parametrize("mode", TK_MODES)
-def test_photoimage(mode):
+def test_photoimage(mode) -> None:
     # test as image:
     im = hopper(mode)
 
@@ -71,7 +71,7 @@ def test_photoimage(mode):
     assert_image_equal(reloaded, im.convert("RGBA"))
 
 
-def test_photoimage_apply_transparency():
+def test_photoimage_apply_transparency() -> None:
     with Image.open("Tests/images/pil123p.png") as im:
         im_tk = ImageTk.PhotoImage(im)
         reloaded = ImageTk.getimage(im_tk)
@@ -79,7 +79,7 @@ def test_photoimage_apply_transparency():
 
 
 @pytest.mark.parametrize("mode", TK_MODES)
-def test_photoimage_blank(mode):
+def test_photoimage_blank(mode) -> None:
     # test a image using mode/size:
     im_tk = ImageTk.PhotoImage(mode, (100, 100))
 
@@ -91,7 +91,7 @@ def test_photoimage_blank(mode):
     assert_image_equal(reloaded.convert(mode), im)
 
 
-def test_bitmapimage():
+def test_bitmapimage() -> None:
     im = hopper("1")
 
     # this should not crash
diff --git a/Tests/test_imagewin.py b/Tests/test_imagewin.py
index f93eabcb4ff..b43c31b521f 100644
--- a/Tests/test_imagewin.py
+++ b/Tests/test_imagewin.py
@@ -8,10 +8,10 @@
 
 
 class TestImageWin:
-    def test_sanity(self):
+    def test_sanity(self) -> None:
         dir(ImageWin)
 
-    def test_hdc(self):
+    def test_hdc(self) -> None:
         # Arrange
         dc = 50
 
@@ -22,7 +22,7 @@ def test_hdc(self):
         # Assert
         assert dc2 == 50
 
-    def test_hwnd(self):
+    def test_hwnd(self) -> None:
         # Arrange
         wnd = 50
 
@@ -36,7 +36,7 @@ def test_hwnd(self):
 
 @pytest.mark.skipif(not is_win32(), reason="Windows only")
 class TestImageWinDib:
-    def test_dib_image(self):
+    def test_dib_image(self) -> None:
         # Arrange
         im = hopper()
 
@@ -46,7 +46,7 @@ def test_dib_image(self):
         # Assert
         assert dib.size == im.size
 
-    def test_dib_mode_string(self):
+    def test_dib_mode_string(self) -> None:
         # Arrange
         mode = "RGBA"
         size = (128, 128)
@@ -57,7 +57,7 @@ def test_dib_mode_string(self):
         # Assert
         assert dib.size == (128, 128)
 
-    def test_dib_paste(self):
+    def test_dib_paste(self) -> None:
         # Arrange
         im = hopper()
 
@@ -71,7 +71,7 @@ def test_dib_paste(self):
         # Assert
         assert dib.size == (128, 128)
 
-    def test_dib_paste_bbox(self):
+    def test_dib_paste_bbox(self) -> None:
         # Arrange
         im = hopper()
         bbox = (0, 0, 10, 10)
@@ -86,7 +86,7 @@ def test_dib_paste_bbox(self):
         # Assert
         assert dib.size == (128, 128)
 
-    def test_dib_frombytes_tobytes_roundtrip(self):
+    def test_dib_frombytes_tobytes_roundtrip(self) -> None:
         # Arrange
         # Make two different DIB images
         im = hopper()
diff --git a/Tests/test_imagewin_pointers.py b/Tests/test_imagewin_pointers.py
index 63d6b903ca6..c7f633e6290 100644
--- a/Tests/test_imagewin_pointers.py
+++ b/Tests/test_imagewin_pointers.py
@@ -1,6 +1,7 @@
 from __future__ import annotations
 
 from io import BytesIO
+from pathlib import Path
 
 from PIL import Image, ImageWin
 
@@ -83,7 +84,7 @@ def serialize_dib(bi, pixels):
         memcpy(bp + bf.bfOffBits, pixels, bi.biSizeImage)
         return bytearray(buf)
 
-    def test_pointer(tmp_path):
+    def test_pointer(tmp_path: Path) -> None:
         im = hopper()
         (width, height) = im.size
         opath = str(tmp_path / "temp.png")
diff --git a/Tests/test_lib_pack.py b/Tests/test_lib_pack.py
index e2024abbf2e..c8d6d33d223 100644
--- a/Tests/test_lib_pack.py
+++ b/Tests/test_lib_pack.py
@@ -10,7 +10,7 @@
 
 
 class TestLibPack:
-    def assert_pack(self, mode, rawmode, data, *pixels):
+    def assert_pack(self, mode, rawmode, data, *pixels) -> None:
         """
         data - either raw bytes with data or just number of bytes in rawmode.
         """
@@ -24,7 +24,7 @@ def assert_pack(self, mode, rawmode, data, *pixels):
 
         assert data == im.tobytes("raw", rawmode)
 
-    def test_1(self):
+    def test_1(self) -> None:
         self.assert_pack("1", "1", b"\x01", 0, 0, 0, 0, 0, 0, 0, X)
         self.assert_pack("1", "1;I", b"\x01", X, X, X, X, X, X, X, 0)
         self.assert_pack("1", "1;R", b"\x01", X, 0, 0, 0, 0, 0, 0, 0)
@@ -37,29 +37,29 @@ def test_1(self):
 
         self.assert_pack("1", "L", b"\xff\x00\x00\xff\x00\x00", X, 0, 0, X, 0, 0)
 
-    def test_L(self):
+    def test_L(self) -> None:
         self.assert_pack("L", "L", 1, 1, 2, 3, 4)
         self.assert_pack("L", "L;16", b"\x00\xc6\x00\xaf", 198, 175)
         self.assert_pack("L", "L;16B", b"\xc6\x00\xaf\x00", 198, 175)
 
-    def test_LA(self):
+    def test_LA(self) -> None:
         self.assert_pack("LA", "LA", 2, (1, 2), (3, 4), (5, 6))
         self.assert_pack("LA", "LA;L", 2, (1, 4), (2, 5), (3, 6))
 
-    def test_La(self):
+    def test_La(self) -> None:
         self.assert_pack("La", "La", 2, (1, 2), (3, 4), (5, 6))
 
-    def test_P(self):
+    def test_P(self) -> None:
         self.assert_pack("P", "P;1", b"\xe4", 1, 1, 1, 0, 0, 255, 0, 0)
         self.assert_pack("P", "P;2", b"\xe4", 3, 2, 1, 0)
         self.assert_pack("P", "P;4", b"\x02\xef", 0, 2, 14, 15)
         self.assert_pack("P", "P", 1, 1, 2, 3, 4)
 
-    def test_PA(self):
+    def test_PA(self) -> None:
         self.assert_pack("PA", "PA", 2, (1, 2), (3, 4), (5, 6))
         self.assert_pack("PA", "PA;L", 2, (1, 4), (2, 5), (3, 6))
 
-    def test_RGB(self):
+    def test_RGB(self) -> None:
         self.assert_pack("RGB", "RGB", 3, (1, 2, 3), (4, 5, 6), (7, 8, 9))
         self.assert_pack(
             "RGB", "RGBX", b"\x01\x02\x03\xff\x05\x06\x07\xff", (1, 2, 3), (5, 6, 7)
@@ -79,7 +79,7 @@ def test_RGB(self):
         self.assert_pack("RGB", "G", 1, (9, 1, 9), (9, 2, 9), (9, 3, 9))
         self.assert_pack("RGB", "B", 1, (9, 9, 1), (9, 9, 2), (9, 9, 3))
 
-    def test_RGBA(self):
+    def test_RGBA(self) -> None:
         self.assert_pack("RGBA", "RGBA", 4, (1, 2, 3, 4), (5, 6, 7, 8), (9, 10, 11, 12))
         self.assert_pack(
             "RGBA", "RGBA;L", 4, (1, 4, 7, 10), (2, 5, 8, 11), (3, 6, 9, 12)
@@ -101,12 +101,12 @@ def test_RGBA(self):
         self.assert_pack("RGBA", "B", 1, (6, 7, 1, 9), (6, 7, 2, 0), (6, 7, 3, 9))
         self.assert_pack("RGBA", "A", 1, (6, 7, 0, 1), (6, 7, 0, 2), (0, 7, 0, 3))
 
-    def test_RGBa(self):
+    def test_RGBa(self) -> None:
         self.assert_pack("RGBa", "RGBa", 4, (1, 2, 3, 4), (5, 6, 7, 8), (9, 10, 11, 12))
         self.assert_pack("RGBa", "BGRa", 4, (3, 2, 1, 4), (7, 6, 5, 8), (11, 10, 9, 12))
         self.assert_pack("RGBa", "aBGR", 4, (4, 3, 2, 1), (8, 7, 6, 5), (12, 11, 10, 9))
 
-    def test_RGBX(self):
+    def test_RGBX(self) -> None:
         self.assert_pack("RGBX", "RGBX", 4, (1, 2, 3, 4), (5, 6, 7, 8), (9, 10, 11, 12))
         self.assert_pack(
             "RGBX", "RGBX;L", 4, (1, 4, 7, 10), (2, 5, 8, 11), (3, 6, 9, 12)
@@ -134,7 +134,7 @@ def test_RGBX(self):
         self.assert_pack("RGBX", "B", 1, (6, 7, 1, 9), (6, 7, 2, 0), (6, 7, 3, 9))
         self.assert_pack("RGBX", "X", 1, (6, 7, 0, 1), (6, 7, 0, 2), (0, 7, 0, 3))
 
-    def test_CMYK(self):
+    def test_CMYK(self) -> None:
         self.assert_pack("CMYK", "CMYK", 4, (1, 2, 3, 4), (5, 6, 7, 8), (9, 10, 11, 12))
         self.assert_pack(
             "CMYK",
@@ -149,7 +149,7 @@ def test_CMYK(self):
         )
         self.assert_pack("CMYK", "K", 1, (6, 7, 0, 1), (6, 7, 0, 2), (0, 7, 0, 3))
 
-    def test_YCbCr(self):
+    def test_YCbCr(self) -> None:
         self.assert_pack("YCbCr", "YCbCr", 3, (1, 2, 3), (4, 5, 6), (7, 8, 9))
         self.assert_pack("YCbCr", "YCbCr;L", 3, (1, 4, 7), (2, 5, 8), (3, 6, 9))
         self.assert_pack(
@@ -172,19 +172,19 @@ def test_YCbCr(self):
         self.assert_pack("YCbCr", "Cb", 1, (6, 1, 8, 9), (6, 2, 8, 9), (6, 3, 8, 9))
         self.assert_pack("YCbCr", "Cr", 1, (6, 7, 1, 9), (6, 7, 2, 0), (6, 7, 3, 9))
 
-    def test_LAB(self):
+    def test_LAB(self) -> None:
         self.assert_pack("LAB", "LAB", 3, (1, 130, 131), (4, 133, 134), (7, 136, 137))
         self.assert_pack("LAB", "L", 1, (1, 9, 9), (2, 9, 9), (3, 9, 9))
         self.assert_pack("LAB", "A", 1, (9, 1, 9), (9, 2, 9), (9, 3, 9))
         self.assert_pack("LAB", "B", 1, (9, 9, 1), (9, 9, 2), (9, 9, 3))
 
-    def test_HSV(self):
+    def test_HSV(self) -> None:
         self.assert_pack("HSV", "HSV", 3, (1, 2, 3), (4, 5, 6), (7, 8, 9))
         self.assert_pack("HSV", "H", 1, (1, 9, 9), (2, 9, 9), (3, 9, 9))
         self.assert_pack("HSV", "S", 1, (9, 1, 9), (9, 2, 9), (9, 3, 9))
         self.assert_pack("HSV", "V", 1, (9, 9, 1), (9, 9, 2), (9, 9, 3))
 
-    def test_I(self):
+    def test_I(self) -> None:
         self.assert_pack("I", "I;16B", 2, 0x0102, 0x0304)
         self.assert_pack(
             "I", "I;32S", b"\x83\x00\x00\x01\x01\x00\x00\x83", 0x01000083, -2097151999
@@ -209,10 +209,10 @@ def test_I(self):
                 0x01000083,
             )
 
-    def test_I16(self):
+    def test_I16(self) -> None:
         self.assert_pack("I;16N", "I;16N", 2, 0x0201, 0x0403, 0x0605)
 
-    def test_F_float(self):
+    def test_F_float(self) -> None:
         self.assert_pack("F", "F;32F", 4, 1.539989614439558e-36, 4.063216068939723e-34)
 
         if sys.byteorder == "little":
@@ -228,7 +228,7 @@ def test_F_float(self):
 
 
 class TestLibUnpack:
-    def assert_unpack(self, mode, rawmode, data, *pixels):
+    def assert_unpack(self, mode, rawmode, data, *pixels) -> None:
         """
         data - either raw bytes with data or just number of bytes in rawmode.
         """
@@ -241,7 +241,7 @@ def assert_unpack(self, mode, rawmode, data, *pixels):
         for x, pixel in enumerate(pixels):
             assert pixel == im.getpixel((x, 0))
 
-    def test_1(self):
+    def test_1(self) -> None:
         self.assert_unpack("1", "1", b"\x01", 0, 0, 0, 0, 0, 0, 0, X)
         self.assert_unpack("1", "1;I", b"\x01", X, X, X, X, X, X, X, 0)
         self.assert_unpack("1", "1;R", b"\x01", X, 0, 0, 0, 0, 0, 0, 0)
@@ -254,7 +254,7 @@ def test_1(self):
 
         self.assert_unpack("1", "1;8", b"\x00\x01\x02\xff", 0, X, X, X)
 
-    def test_L(self):
+    def test_L(self) -> None:
         self.assert_unpack("L", "L;2", b"\xe4", 255, 170, 85, 0)
         self.assert_unpack("L", "L;2I", b"\xe4", 0, 85, 170, 255)
         self.assert_unpack("L", "L;2R", b"\xe4", 0, 170, 85, 255)
@@ -273,14 +273,14 @@ def test_L(self):
         self.assert_unpack("L", "L;16", b"\x00\xc6\x00\xaf", 198, 175)
         self.assert_unpack("L", "L;16B", b"\xc6\x00\xaf\x00", 198, 175)
 
-    def test_LA(self):
+    def test_LA(self) -> None:
         self.assert_unpack("LA", "LA", 2, (1, 2), (3, 4), (5, 6))
         self.assert_unpack("LA", "LA;L", 2, (1, 4), (2, 5), (3, 6))
 
-    def test_La(self):
+    def test_La(self) -> None:
         self.assert_unpack("La", "La", 2, (1, 2), (3, 4), (5, 6))
 
-    def test_P(self):
+    def test_P(self) -> None:
         self.assert_unpack("P", "P;1", b"\xe4", 1, 1, 1, 0, 0, 1, 0, 0)
         self.assert_unpack("P", "P;2", b"\xe4", 3, 2, 1, 0)
         # erroneous?
@@ -291,11 +291,11 @@ def test_P(self):
         self.assert_unpack("P", "P", 1, 1, 2, 3, 4)
         self.assert_unpack("P", "P;R", 1, 128, 64, 192, 32)
 
-    def test_PA(self):
+    def test_PA(self) -> None:
         self.assert_unpack("PA", "PA", 2, (1, 2), (3, 4), (5, 6))
         self.assert_unpack("PA", "PA;L", 2, (1, 4), (2, 5), (3, 6))
 
-    def test_RGB(self):
+    def test_RGB(self) -> None:
         self.assert_unpack("RGB", "RGB", 3, (1, 2, 3), (4, 5, 6), (7, 8, 9))
         self.assert_unpack("RGB", "RGB;L", 3, (1, 4, 7), (2, 5, 8), (3, 6, 9))
         self.assert_unpack("RGB", "RGB;R", 3, (128, 64, 192), (32, 160, 96))
@@ -346,14 +346,14 @@ def test_RGB(self):
             "RGB", "CMYK", 4, (250, 249, 248), (242, 241, 240), (234, 233, 233)
         )
 
-    def test_BGR(self):
+    def test_BGR(self) -> None:
         self.assert_unpack("BGR;15", "BGR;15", 3, (8, 131, 0), (24, 0, 8), (41, 131, 8))
         self.assert_unpack(
             "BGR;16", "BGR;16", 3, (8, 64, 0), (24, 129, 0), (41, 194, 0)
         )
         self.assert_unpack("BGR;24", "BGR;24", 3, (1, 2, 3), (4, 5, 6), (7, 8, 9))
 
-    def test_RGBA(self):
+    def test_RGBA(self) -> None:
         self.assert_unpack("RGBA", "LA", 2, (1, 1, 1, 2), (3, 3, 3, 4), (5, 5, 5, 6))
         self.assert_unpack(
             "RGBA", "LA;16B", 4, (1, 1, 1, 3), (5, 5, 5, 7), (9, 9, 9, 11)
@@ -522,7 +522,7 @@ def test_RGBA(self):
                 "RGBA", "A;16N", 2, (0, 0, 0, 1), (0, 0, 0, 3), (0, 0, 0, 5)
             )
 
-    def test_RGBa(self):
+    def test_RGBa(self) -> None:
         self.assert_unpack(
             "RGBa", "RGBa", 4, (1, 2, 3, 4), (5, 6, 7, 8), (9, 10, 11, 12)
         )
@@ -536,7 +536,7 @@ def test_RGBa(self):
             "RGBa", "aBGR", 4, (4, 3, 2, 1), (8, 7, 6, 5), (12, 11, 10, 9)
         )
 
-    def test_RGBX(self):
+    def test_RGBX(self) -> None:
         self.assert_unpack("RGBX", "RGB", 3, (1, 2, 3, X), (4, 5, 6, X), (7, 8, 9, X))
         self.assert_unpack("RGBX", "RGB;L", 3, (1, 4, 7, X), (2, 5, 8, X), (3, 6, 9, X))
         self.assert_unpack("RGBX", "RGB;16B", 6, (1, 3, 5, X), (7, 9, 11, X))
@@ -581,7 +581,7 @@ def test_RGBX(self):
         self.assert_unpack("RGBX", "B", 1, (0, 0, 1, 0), (0, 0, 2, 0), (0, 0, 3, 0))
         self.assert_unpack("RGBX", "X", 1, (0, 0, 0, 1), (0, 0, 0, 2), (0, 0, 0, 3))
 
-    def test_CMYK(self):
+    def test_CMYK(self) -> None:
         self.assert_unpack(
             "CMYK", "CMYK", 4, (1, 2, 3, 4), (5, 6, 7, 8), (9, 10, 11, 12)
         )
@@ -619,25 +619,25 @@ def test_CMYK(self):
             "CMYK", "K;I", 1, (0, 0, 0, 254), (0, 0, 0, 253), (0, 0, 0, 252)
         )
 
-    def test_YCbCr(self):
+    def test_YCbCr(self) -> None:
         self.assert_unpack("YCbCr", "YCbCr", 3, (1, 2, 3), (4, 5, 6), (7, 8, 9))
         self.assert_unpack("YCbCr", "YCbCr;L", 3, (1, 4, 7), (2, 5, 8), (3, 6, 9))
         self.assert_unpack("YCbCr", "YCbCrK", 4, (1, 2, 3), (5, 6, 7), (9, 10, 11))
         self.assert_unpack("YCbCr", "YCbCrX", 4, (1, 2, 3), (5, 6, 7), (9, 10, 11))
 
-    def test_LAB(self):
+    def test_LAB(self) -> None:
         self.assert_unpack("LAB", "LAB", 3, (1, 130, 131), (4, 133, 134), (7, 136, 137))
         self.assert_unpack("LAB", "L", 1, (1, 0, 0), (2, 0, 0), (3, 0, 0))
         self.assert_unpack("LAB", "A", 1, (0, 1, 0), (0, 2, 0), (0, 3, 0))
         self.assert_unpack("LAB", "B", 1, (0, 0, 1), (0, 0, 2), (0, 0, 3))
 
-    def test_HSV(self):
+    def test_HSV(self) -> None:
         self.assert_unpack("HSV", "HSV", 3, (1, 2, 3), (4, 5, 6), (7, 8, 9))
         self.assert_unpack("HSV", "H", 1, (1, 0, 0), (2, 0, 0), (3, 0, 0))
         self.assert_unpack("HSV", "S", 1, (0, 1, 0), (0, 2, 0), (0, 3, 0))
         self.assert_unpack("HSV", "V", 1, (0, 0, 1), (0, 0, 2), (0, 0, 3))
 
-    def test_I(self):
+    def test_I(self) -> None:
         self.assert_unpack("I", "I;8", 1, 0x01, 0x02, 0x03, 0x04)
         self.assert_unpack("I", "I;8S", b"\x01\x83", 1, -125)
         self.assert_unpack("I", "I;16", 2, 0x0201, 0x0403)
@@ -678,7 +678,7 @@ def test_I(self):
                 0x01000083,
             )
 
-    def test_F_int(self):
+    def test_F_int(self) -> None:
         self.assert_unpack("F", "F;8", 1, 0x01, 0x02, 0x03, 0x04)
         self.assert_unpack("F", "F;8S", b"\x01\x83", 1, -125)
         self.assert_unpack("F", "F;16", 2, 0x0201, 0x0403)
@@ -717,7 +717,7 @@ def test_F_int(self):
                 16777348,
             )
 
-    def test_F_float(self):
+    def test_F_float(self) -> None:
         self.assert_unpack(
             "F", "F;32F", 4, 1.539989614439558e-36, 4.063216068939723e-34
         )
@@ -768,7 +768,7 @@ def test_F_float(self):
                 -1234.5,
             )
 
-    def test_I16(self):
+    def test_I16(self) -> None:
         self.assert_unpack("I;16", "I;16", 2, 0x0201, 0x0403, 0x0605)
         self.assert_unpack("I;16", "I;16B", 2, 0x0102, 0x0304, 0x0506)
         self.assert_unpack("I;16B", "I;16B", 2, 0x0102, 0x0304, 0x0506)
@@ -785,7 +785,7 @@ def test_I16(self):
             self.assert_unpack("I;16L", "I;16N", 2, 0x0102, 0x0304, 0x0506)
             self.assert_unpack("I;16N", "I;16N", 2, 0x0102, 0x0304, 0x0506)
 
-    def test_CMYK16(self):
+    def test_CMYK16(self) -> None:
         self.assert_unpack("CMYK", "CMYK;16L", 8, (2, 4, 6, 8), (10, 12, 14, 16))
         self.assert_unpack("CMYK", "CMYK;16B", 8, (1, 3, 5, 7), (9, 11, 13, 15))
         if sys.byteorder == "little":
@@ -793,7 +793,7 @@ def test_CMYK16(self):
         else:
             self.assert_unpack("CMYK", "CMYK;16N", 8, (1, 3, 5, 7), (9, 11, 13, 15))
 
-    def test_value_error(self):
+    def test_value_error(self) -> None:
         with pytest.raises(ValueError):
             self.assert_unpack("L", "L", 0, 0)
         with pytest.raises(ValueError):
diff --git a/Tests/test_map.py b/Tests/test_map.py
index 9c79fe35906..93140f6e5a5 100644
--- a/Tests/test_map.py
+++ b/Tests/test_map.py
@@ -7,7 +7,7 @@
 from PIL import Image
 
 
-def test_overflow():
+def test_overflow() -> None:
     # There is the potential to overflow comparisons in map.c
     # if there are > SIZE_MAX bytes in the image or if
     # the file encodes an offset that makes
@@ -25,7 +25,7 @@ def test_overflow():
     Image.MAX_IMAGE_PIXELS = max_pixels
 
 
-def test_tobytes():
+def test_tobytes() -> None:
     # Note that this image triggers the decompression bomb warning:
     max_pixels = Image.MAX_IMAGE_PIXELS
     Image.MAX_IMAGE_PIXELS = None
@@ -39,7 +39,7 @@ def test_tobytes():
 
 
 @pytest.mark.skipif(sys.maxsize <= 2**32, reason="Requires 64-bit system")
-def test_ysize():
+def test_ysize() -> None:
     numpy = pytest.importorskip("numpy", reason="NumPy not installed")
 
     # Should not raise 'Integer overflow in ysize'
diff --git a/Tests/test_mode_i16.py b/Tests/test_mode_i16.py
index d3ee511b7c2..f2540bb465e 100644
--- a/Tests/test_mode_i16.py
+++ b/Tests/test_mode_i16.py
@@ -1,5 +1,7 @@
 from __future__ import annotations
 
+from pathlib import Path
+
 import pytest
 
 from PIL import Image
@@ -9,7 +11,7 @@
 original = hopper().resize((32, 32)).convert("I")
 
 
-def verify(im1):
+def verify(im1) -> None:
     im2 = original.copy()
     assert im1.size == im2.size
     pix1 = im1.load()
@@ -25,7 +27,7 @@ def verify(im1):
 
 
 @pytest.mark.parametrize("mode", ("L", "I;16", "I;16B", "I;16L", "I"))
-def test_basic(tmp_path, mode):
+def test_basic(tmp_path: Path, mode) -> None:
     # PIL 1.1 has limited support for 16-bit image data.  Check that
     # create/copy/transform and save works as expected.
 
@@ -75,7 +77,7 @@ def test_basic(tmp_path, mode):
     assert im_in.getpixel((0, 0)) == min(512, maximum)
 
 
-def test_tobytes():
+def test_tobytes() -> None:
     def tobytes(mode):
         return Image.new(mode, (1, 1), 1).tobytes()
 
@@ -87,7 +89,7 @@ def tobytes(mode):
     assert tobytes("I") == b"\x01\x00\x00\x00"[::order]
 
 
-def test_convert():
+def test_convert() -> None:
     im = original.copy()
 
     for mode in ("I;16", "I;16B", "I;16N"):
diff --git a/Tests/test_numpy.py b/Tests/test_numpy.py
index 24dff36a610..6ba95c2d700 100644
--- a/Tests/test_numpy.py
+++ b/Tests/test_numpy.py
@@ -13,8 +13,8 @@
 TEST_IMAGE_SIZE = (10, 10)
 
 
-def test_numpy_to_image():
-    def to_image(dtype, bands=1, boolean=0):
+def test_numpy_to_image() -> None:
+    def to_image(dtype, bands: int = 1, boolean: int = 0):
         if bands == 1:
             if boolean:
                 data = [0, 255] * 50
@@ -82,7 +82,7 @@ def to_image(dtype, bands=1, boolean=0):
 
 # Based on an erring example at
 # https://stackoverflow.com/questions/10854903/what-is-causing-dimension-dependent-attributeerror-in-pil-fromarray-function
-def test_3d_array():
+def test_3d_array() -> None:
     size = (5, TEST_IMAGE_SIZE[0], TEST_IMAGE_SIZE[1])
     a = numpy.ones(size, dtype=numpy.uint8)
     assert_image(Image.fromarray(a[1, :, :]), "L", TEST_IMAGE_SIZE)
@@ -94,12 +94,12 @@ def test_3d_array():
     assert_image(Image.fromarray(a[:, :, 1]), "L", TEST_IMAGE_SIZE)
 
 
-def test_1d_array():
+def test_1d_array() -> None:
     a = numpy.ones(5, dtype=numpy.uint8)
     assert_image(Image.fromarray(a), "L", (1, 5))
 
 
-def _test_img_equals_nparray(img, np):
+def _test_img_equals_nparray(img, np) -> None:
     assert len(np.shape) >= 2
     np_size = np.shape[1], np.shape[0]
     assert img.size == np_size
@@ -109,14 +109,14 @@ def _test_img_equals_nparray(img, np):
             assert_deep_equal(px[x, y], np[y, x])
 
 
-def test_16bit():
+def test_16bit() -> None:
     with Image.open("Tests/images/16bit.cropped.tif") as img:
         np_img = numpy.array(img)
         _test_img_equals_nparray(img, np_img)
     assert np_img.dtype == numpy.dtype("<u2")
 
 
-def test_1bit():
+def test_1bit() -> None:
     # Test that 1-bit arrays convert to numpy and back
     # See: https://github.com/python-pillow/Pillow/issues/350
     arr = numpy.array([[1, 0, 0, 1, 0], [0, 1, 0, 0, 0]], "u1")
@@ -126,7 +126,7 @@ def test_1bit():
     numpy.testing.assert_array_equal(arr, arr_back)
 
 
-def test_save_tiff_uint16():
+def test_save_tiff_uint16() -> None:
     # Tests that we're getting the pixel value in the right byte order.
     pixel_value = 0x1234
     a = numpy.array(
@@ -157,7 +157,7 @@ def test_save_tiff_uint16():
         ("HSV", numpy.uint8),
     ),
 )
-def test_to_array(mode, dtype):
+def test_to_array(mode, dtype) -> None:
     img = hopper(mode)
 
     # Resize to non-square
@@ -169,7 +169,7 @@ def test_to_array(mode, dtype):
     assert np_img.dtype == dtype
 
 
-def test_point_lut():
+def test_point_lut() -> None:
     # See https://github.com/python-pillow/Pillow/issues/439
 
     data = list(range(256)) * 3
@@ -180,7 +180,7 @@ def test_point_lut():
     im.point(lut)
 
 
-def test_putdata():
+def test_putdata() -> None:
     # Shouldn't segfault
     # See https://github.com/python-pillow/Pillow/issues/1008
 
@@ -207,12 +207,12 @@ def test_putdata():
         numpy.float64,
     ),
 )
-def test_roundtrip_eye(dtype):
+def test_roundtrip_eye(dtype) -> None:
     arr = numpy.eye(10, dtype=dtype)
     numpy.testing.assert_array_equal(arr, numpy.array(Image.fromarray(arr)))
 
 
-def test_zero_size():
+def test_zero_size() -> None:
     # Shouldn't cause floating point exception
     # See https://github.com/python-pillow/Pillow/issues/2259
 
@@ -222,13 +222,13 @@ def test_zero_size():
 
 
 @skip_unless_feature("libtiff")
-def test_load_first():
+def test_load_first() -> None:
     with Image.open("Tests/images/g4_orientation_5.tif") as im:
         a = numpy.array(im)
         assert a.shape == (88, 590)
 
 
-def test_bool():
+def test_bool() -> None:
     # https://github.com/python-pillow/Pillow/issues/2044
     a = numpy.zeros((10, 2), dtype=bool)
     a[0][0] = True
@@ -237,7 +237,7 @@ def test_bool():
     assert im2.getdata()[0] == 255
 
 
-def test_no_resource_warning_for_numpy_array():
+def test_no_resource_warning_for_numpy_array() -> None:
     # https://github.com/python-pillow/Pillow/issues/835
     # Arrange
     from numpy import array
diff --git a/Tests/test_pdfparser.py b/Tests/test_pdfparser.py
index a89d75b59d3..f6b12cb2047 100644
--- a/Tests/test_pdfparser.py
+++ b/Tests/test_pdfparser.py
@@ -19,14 +19,14 @@
 )
 
 
-def test_text_encode_decode():
+def test_text_encode_decode() -> None:
     assert encode_text("abc") == b"\xFE\xFF\x00a\x00b\x00c"
     assert decode_text(b"\xFE\xFF\x00a\x00b\x00c") == "abc"
     assert decode_text(b"abc") == "abc"
     assert decode_text(b"\x1B a \x1C") == "\u02D9 a \u02DD"
 
 
-def test_indirect_refs():
+def test_indirect_refs() -> None:
     assert IndirectReference(1, 2) == IndirectReference(1, 2)
     assert IndirectReference(1, 2) != IndirectReference(1, 3)
     assert IndirectReference(1, 2) != IndirectObjectDef(1, 2)
@@ -37,7 +37,7 @@ def test_indirect_refs():
     assert IndirectObjectDef(1, 2) != (1, 2)
 
 
-def test_parsing():
+def test_parsing() -> None:
     assert PdfParser.interpret_name(b"Name#23Hash") == b"Name#Hash"
     assert PdfParser.interpret_name(b"Name#23Hash", as_text=True) == "Name#Hash"
     assert PdfParser.get_value(b"1 2 R ", 0) == (IndirectReference(1, 2), 5)
@@ -95,7 +95,7 @@ def test_parsing():
             assert time.strftime("%Y%m%d%H%M%S", getattr(d, name)) == value
 
 
-def test_pdf_repr():
+def test_pdf_repr() -> None:
     assert bytes(IndirectReference(1, 2)) == b"1 2 R"
     assert bytes(IndirectObjectDef(*IndirectReference(1, 2))) == b"1 2 obj"
     assert bytes(PdfName(b"Name#Hash")) == b"/Name#23Hash"
@@ -121,7 +121,7 @@ def test_pdf_repr():
     assert pdf_repr(PdfBinary(b"\x90\x1F\xA0")) == b"<901FA0>"
 
 
-def test_duplicate_xref_entry():
+def test_duplicate_xref_entry() -> None:
     pdf = PdfParser("Tests/images/duplicate_xref_entry.pdf")
     assert pdf.xref_table.existing_entries[6][0] == 1197
     pdf.close()
diff --git a/Tests/test_pickle.py b/Tests/test_pickle.py
index c445e349447..560cdbd35f7 100644
--- a/Tests/test_pickle.py
+++ b/Tests/test_pickle.py
@@ -1,6 +1,7 @@
 from __future__ import annotations
 
 import pickle
+from pathlib import Path
 
 import pytest
 
@@ -12,7 +13,7 @@
 FONT_PATH = "Tests/fonts/DejaVuSans/DejaVuSans.ttf"
 
 
-def helper_pickle_file(tmp_path, pickle, protocol, test_file, mode):
+def helper_pickle_file(tmp_path: Path, pickle, protocol, test_file, mode) -> None:
     # Arrange
     with Image.open(test_file) as im:
         filename = str(tmp_path / "temp.pkl")
@@ -29,7 +30,7 @@ def helper_pickle_file(tmp_path, pickle, protocol, test_file, mode):
         assert im == loaded_im
 
 
-def helper_pickle_string(pickle, protocol, test_file, mode):
+def helper_pickle_string(pickle, protocol, test_file, mode) -> None:
     with Image.open(test_file) as im:
         if mode:
             im = im.convert(mode)
@@ -63,13 +64,13 @@ def helper_pickle_string(pickle, protocol, test_file, mode):
     ],
 )
 @pytest.mark.parametrize("protocol", range(0, pickle.HIGHEST_PROTOCOL + 1))
-def test_pickle_image(tmp_path, test_file, test_mode, protocol):
+def test_pickle_image(tmp_path: Path, test_file, test_mode, protocol) -> None:
     # Act / Assert
     helper_pickle_string(pickle, protocol, test_file, test_mode)
     helper_pickle_file(tmp_path, pickle, protocol, test_file, test_mode)
 
 
-def test_pickle_la_mode_with_palette(tmp_path):
+def test_pickle_la_mode_with_palette(tmp_path: Path) -> None:
     # Arrange
     filename = str(tmp_path / "temp.pkl")
     with Image.open("Tests/images/hopper.jpg") as im:
@@ -88,7 +89,7 @@ def test_pickle_la_mode_with_palette(tmp_path):
 
 
 @skip_unless_feature("webp")
-def test_pickle_tell():
+def test_pickle_tell() -> None:
     # Arrange
     with Image.open("Tests/images/hopper.webp") as image:
         # Act: roundtrip
@@ -98,7 +99,7 @@ def test_pickle_tell():
     assert unpickled_image.tell() == 0
 
 
-def helper_assert_pickled_font_images(font1, font2):
+def helper_assert_pickled_font_images(font1, font2) -> None:
     # Arrange
     im1 = Image.new(mode="RGBA", size=(300, 100))
     im2 = Image.new(mode="RGBA", size=(300, 100))
@@ -116,7 +117,7 @@ def helper_assert_pickled_font_images(font1, font2):
 
 @skip_unless_feature("freetype2")
 @pytest.mark.parametrize("protocol", list(range(0, pickle.HIGHEST_PROTOCOL + 1)))
-def test_pickle_font_string(protocol):
+def test_pickle_font_string(protocol) -> None:
     # Arrange
     font = ImageFont.truetype(FONT_PATH, FONT_SIZE)
 
@@ -130,7 +131,7 @@ def test_pickle_font_string(protocol):
 
 @skip_unless_feature("freetype2")
 @pytest.mark.parametrize("protocol", list(range(0, pickle.HIGHEST_PROTOCOL + 1)))
-def test_pickle_font_file(tmp_path, protocol):
+def test_pickle_font_file(tmp_path: Path, protocol) -> None:
     # Arrange
     font = ImageFont.truetype(FONT_PATH, FONT_SIZE)
     filename = str(tmp_path / "temp.pkl")
diff --git a/Tests/test_psdraw.py b/Tests/test_psdraw.py
index 7f618d0f53b..797539f35ef 100644
--- a/Tests/test_psdraw.py
+++ b/Tests/test_psdraw.py
@@ -3,13 +3,14 @@
 import os
 import sys
 from io import BytesIO
+from pathlib import Path
 
 import pytest
 
 from PIL import Image, PSDraw
 
 
-def _create_document(ps):
+def _create_document(ps) -> None:
     title = "hopper"
     box = (1 * 72, 2 * 72, 7 * 72, 10 * 72)  # in points
 
@@ -31,7 +32,7 @@ def _create_document(ps):
     ps.end_document()
 
 
-def test_draw_postscript(tmp_path):
+def test_draw_postscript(tmp_path: Path) -> None:
     # Based on Pillow tutorial, but there is no textsize:
     # https://pillow.readthedocs.io/en/latest/handbook/tutorial.html#drawing-postscript
 
@@ -49,7 +50,7 @@ def test_draw_postscript(tmp_path):
 
 
 @pytest.mark.parametrize("buffer", (True, False))
-def test_stdout(buffer):
+def test_stdout(buffer) -> None:
     # Temporarily redirect stdout
     old_stdout = sys.stdout
 
diff --git a/Tests/test_qt_image_qapplication.py b/Tests/test_qt_image_qapplication.py
index ad2b5ad9bf5..7d6c0a8cb7d 100644
--- a/Tests/test_qt_image_qapplication.py
+++ b/Tests/test_qt_image_qapplication.py
@@ -1,5 +1,7 @@
 from __future__ import annotations
 
+from pathlib import Path
+
 import pytest
 
 from PIL import ImageQt
@@ -19,7 +21,7 @@
         from PySide6.QtWidgets import QApplication, QHBoxLayout, QLabel, QWidget
 
     class Example(QWidget):
-        def __init__(self):
+        def __init__(self) -> None:
             super().__init__()
 
             img = hopper().resize((1000, 1000))
@@ -35,14 +37,14 @@ def __init__(self):
             lbl.setPixmap(pixmap1.copy())
 
 
-def roundtrip(expected):
+def roundtrip(expected) -> None:
     result = ImageQt.fromqpixmap(ImageQt.toqpixmap(expected))
     # Qt saves all pixmaps as rgb
     assert_image_similar(result, expected.convert("RGB"), 1)
 
 
 @pytest.mark.skipif(not ImageQt.qt_is_installed, reason="Qt bindings are not installed")
-def test_sanity(tmp_path):
+def test_sanity(tmp_path: Path) -> None:
     # Segfault test
     app = QApplication([])
     ex = Example()
diff --git a/Tests/test_qt_image_toqimage.py b/Tests/test_qt_image_toqimage.py
index b26787ce668..a222a7d71b9 100644
--- a/Tests/test_qt_image_toqimage.py
+++ b/Tests/test_qt_image_toqimage.py
@@ -1,5 +1,7 @@
 from __future__ import annotations
 
+from pathlib import Path
+
 import pytest
 
 from PIL import ImageQt
@@ -15,7 +17,7 @@
 
 
 @pytest.mark.parametrize("mode", ("RGB", "RGBA", "L", "P", "1"))
-def test_sanity(mode, tmp_path):
+def test_sanity(mode, tmp_path: Path) -> None:
     src = hopper(mode)
     data = ImageQt.toqimage(src)
 
diff --git a/Tests/test_sgi_crash.py b/Tests/test_sgi_crash.py
index dee6258ecb5..9442801d05c 100644
--- a/Tests/test_sgi_crash.py
+++ b/Tests/test_sgi_crash.py
@@ -21,7 +21,7 @@
         "Tests/images/crash-db8bfa78b19721225425530c5946217720d7df4e.sgi",
     ],
 )
-def test_crashes(test_file):
+def test_crashes(test_file) -> None:
     with open(test_file, "rb") as f:
         with Image.open(f) as im:
             with pytest.raises(OSError):
diff --git a/Tests/test_shell_injection.py b/Tests/test_shell_injection.py
index 9f3e86a32a8..3db0660eab7 100644
--- a/Tests/test_shell_injection.py
+++ b/Tests/test_shell_injection.py
@@ -1,6 +1,7 @@
 from __future__ import annotations
 
 import shutil
+from pathlib import Path
 
 import pytest
 
@@ -16,7 +17,7 @@
 
 @pytest.mark.skipif(is_win32(), reason="Requires Unix or macOS")
 class TestShellInjection:
-    def assert_save_filename_check(self, tmp_path, src_img, save_func):
+    def assert_save_filename_check(self, tmp_path: Path, src_img, save_func) -> None:
         for filename in test_filenames:
             dest_file = str(tmp_path / filename)
             save_func(src_img, 0, dest_file)
@@ -25,7 +26,7 @@ def assert_save_filename_check(self, tmp_path, src_img, save_func):
                 im.load()
 
     @pytest.mark.skipif(not djpeg_available(), reason="djpeg not available")
-    def test_load_djpeg_filename(self, tmp_path):
+    def test_load_djpeg_filename(self, tmp_path: Path) -> None:
         for filename in test_filenames:
             src_file = str(tmp_path / filename)
             shutil.copy(TEST_JPG, src_file)
@@ -34,18 +35,18 @@ def test_load_djpeg_filename(self, tmp_path):
                 im.load_djpeg()
 
     @pytest.mark.skipif(not cjpeg_available(), reason="cjpeg not available")
-    def test_save_cjpeg_filename(self, tmp_path):
+    def test_save_cjpeg_filename(self, tmp_path: Path) -> None:
         with Image.open(TEST_JPG) as im:
             self.assert_save_filename_check(tmp_path, im, JpegImagePlugin._save_cjpeg)
 
     @pytest.mark.skipif(not netpbm_available(), reason="Netpbm not available")
-    def test_save_netpbm_filename_bmp_mode(self, tmp_path):
+    def test_save_netpbm_filename_bmp_mode(self, tmp_path: Path) -> None:
         with Image.open(TEST_GIF) as im:
             im = im.convert("RGB")
             self.assert_save_filename_check(tmp_path, im, GifImagePlugin._save_netpbm)
 
     @pytest.mark.skipif(not netpbm_available(), reason="Netpbm not available")
-    def test_save_netpbm_filename_l_mode(self, tmp_path):
+    def test_save_netpbm_filename_l_mode(self, tmp_path: Path) -> None:
         with Image.open(TEST_GIF) as im:
             im = im.convert("L")
             self.assert_save_filename_check(tmp_path, im, GifImagePlugin._save_netpbm)
diff --git a/Tests/test_tiff_ifdrational.py b/Tests/test_tiff_ifdrational.py
index c07e7f7d395..5368545232b 100644
--- a/Tests/test_tiff_ifdrational.py
+++ b/Tests/test_tiff_ifdrational.py
@@ -1,6 +1,7 @@
 from __future__ import annotations
 
 from fractions import Fraction
+from pathlib import Path
 
 from PIL import Image, TiffImagePlugin, features
 from PIL.TiffImagePlugin import IFDRational
@@ -8,14 +9,14 @@
 from .helper import hopper
 
 
-def _test_equal(num, denom, target):
+def _test_equal(num, denom, target) -> None:
     t = IFDRational(num, denom)
 
     assert target == t
     assert t == target
 
 
-def test_sanity():
+def test_sanity() -> None:
     _test_equal(1, 1, 1)
     _test_equal(1, 1, Fraction(1, 1))
 
@@ -31,13 +32,13 @@ def test_sanity():
     _test_equal(7, 5, 1.4)
 
 
-def test_ranges():
+def test_ranges() -> None:
     for num in range(1, 10):
         for denom in range(1, 10):
             assert IFDRational(num, denom) == IFDRational(num, denom)
 
 
-def test_nonetype():
+def test_nonetype() -> None:
     # Fails if the _delegate function doesn't return a valid function
 
     xres = IFDRational(72)
@@ -51,7 +52,7 @@ def test_nonetype():
     assert xres and yres
 
 
-def test_ifd_rational_save(tmp_path):
+def test_ifd_rational_save(tmp_path: Path) -> None:
     methods = (True, False)
     if not features.check("libtiff"):
         methods = (False,)

From bb1fece57a2c894773597c9a6fb10bd81e36123d Mon Sep 17 00:00:00 2001
From: Andrew Murray <radarhere@users.noreply.github.com>
Date: Wed, 31 Jan 2024 21:55:32 +1100
Subject: [PATCH 0149/1178] Added type hints

---
 Tests/test_bmp_reference.py   |   6 +-
 Tests/test_box_blur.py        |  12 +-
 Tests/test_file_apng.py       |   6 +-
 Tests/test_file_container.py  |  10 +-
 Tests/test_file_gif.py        |  30 ++--
 Tests/test_file_mpo.py        |  19 +--
 Tests/test_file_ppm.py        |  22 +--
 Tests/test_file_sgi.py        |   2 +-
 Tests/test_image_frombytes.py |   2 +-
 Tests/test_image_load.py      |   2 +-
 Tests/test_imagedraw.py       | 291 ++++++++++++++++++++++++++++------
 Tests/test_imagetk.py         |   4 +-
 Tests/test_lib_pack.py        |  16 +-
 Tests/test_mode_i16.py        |   6 +-
 14 files changed, 327 insertions(+), 101 deletions(-)

diff --git a/Tests/test_bmp_reference.py b/Tests/test_bmp_reference.py
index 22ac9443e86..0ad49613553 100644
--- a/Tests/test_bmp_reference.py
+++ b/Tests/test_bmp_reference.py
@@ -10,7 +10,7 @@
 base = os.path.join("Tests", "images", "bmp")
 
 
-def get_files(d, ext: str = ".bmp"):
+def get_files(d: str, ext: str = ".bmp") -> list[str]:
     return [
         os.path.join(base, d, f) for f in os.listdir(os.path.join(base, d)) if ext in f
     ]
@@ -29,7 +29,7 @@ def test_bad() -> None:
                 pass
 
 
-def test_questionable():
+def test_questionable() -> None:
     """These shouldn't crash/dos, but it's not well defined that these
     are in spec"""
     supported = [
@@ -80,7 +80,7 @@ def test_good() -> None:
         "rgb32bf.bmp": "rgb24.png",
     }
 
-    def get_compare(f):
+    def get_compare(f: str) -> str:
         name = os.path.split(f)[1]
         if name in file_map:
             return os.path.join(base, "html", file_map[name])
diff --git a/Tests/test_box_blur.py b/Tests/test_box_blur.py
index dfedb48d911..1f6ed61277a 100644
--- a/Tests/test_box_blur.py
+++ b/Tests/test_box_blur.py
@@ -23,11 +23,11 @@ def test_imageops_box_blur() -> None:
     assert isinstance(i, Image.Image)
 
 
-def box_blur(image, radius: int = 1, n: int = 1):
+def box_blur(image: Image.Image, radius: float = 1, n: int = 1) -> Image.Image:
     return image._new(image.im.box_blur((radius, radius), n))
 
 
-def assert_image(im, data, delta: int = 0) -> None:
+def assert_image(im: Image.Image, data: list[list[int]], delta: int = 0) -> None:
     it = iter(im.getdata())
     for data_row in data:
         im_row = [next(it) for _ in range(im.size[0])]
@@ -37,7 +37,13 @@ def assert_image(im, data, delta: int = 0) -> None:
         next(it)
 
 
-def assert_blur(im, radius, data, passes: int = 1, delta: int = 0) -> None:
+def assert_blur(
+    im: Image.Image,
+    radius: float,
+    data: list[list[int]],
+    passes: int = 1,
+    delta: int = 0,
+) -> None:
     # check grayscale image
     assert_image(box_blur(im, radius, passes), data, delta)
     rgba = Image.merge("RGBA", (im, im, im, im))
diff --git a/Tests/test_file_apng.py b/Tests/test_file_apng.py
index f9edf6e9877..395165b3657 100644
--- a/Tests/test_file_apng.py
+++ b/Tests/test_file_apng.py
@@ -47,7 +47,7 @@ def test_apng_basic() -> None:
     "filename",
     ("Tests/images/apng/split_fdat.png", "Tests/images/apng/split_fdat_zero_chunk.png"),
 )
-def test_apng_fdat(filename) -> None:
+def test_apng_fdat(filename: str) -> None:
     with Image.open(filename) as im:
         im.seek(im.n_frames - 1)
         assert im.getpixel((0, 0)) == (0, 255, 0, 255)
@@ -338,7 +338,7 @@ def test_apng_syntax_errors() -> None:
         "sequence_fdat_fctl.png",
     ),
 )
-def test_apng_sequence_errors(test_file) -> None:
+def test_apng_sequence_errors(test_file: str) -> None:
     with pytest.raises(SyntaxError):
         with Image.open(f"Tests/images/apng/{test_file}") as im:
             im.seek(im.n_frames - 1)
@@ -681,7 +681,7 @@ def test_seek_after_close() -> None:
 @pytest.mark.parametrize("default_image", (True, False))
 @pytest.mark.parametrize("duplicate", (True, False))
 def test_different_modes_in_later_frames(
-    mode, default_image, duplicate, tmp_path: Path
+    mode: str, default_image: bool, duplicate: bool, tmp_path: Path
 ) -> None:
     test_file = str(tmp_path / "temp.png")
 
diff --git a/Tests/test_file_container.py b/Tests/test_file_container.py
index 4dba4be5d5c..813b444dbcf 100644
--- a/Tests/test_file_container.py
+++ b/Tests/test_file_container.py
@@ -64,7 +64,7 @@ def test_seek_mode_2() -> None:
 
 
 @pytest.mark.parametrize("bytesmode", (True, False))
-def test_read_n0(bytesmode) -> None:
+def test_read_n0(bytesmode: bool) -> None:
     # Arrange
     with open(TEST_FILE, "rb" if bytesmode else "r") as fh:
         container = ContainerIO.ContainerIO(fh, 22, 100)
@@ -80,7 +80,7 @@ def test_read_n0(bytesmode) -> None:
 
 
 @pytest.mark.parametrize("bytesmode", (True, False))
-def test_read_n(bytesmode) -> None:
+def test_read_n(bytesmode: bool) -> None:
     # Arrange
     with open(TEST_FILE, "rb" if bytesmode else "r") as fh:
         container = ContainerIO.ContainerIO(fh, 22, 100)
@@ -96,7 +96,7 @@ def test_read_n(bytesmode) -> None:
 
 
 @pytest.mark.parametrize("bytesmode", (True, False))
-def test_read_eof(bytesmode) -> None:
+def test_read_eof(bytesmode: bool) -> None:
     # Arrange
     with open(TEST_FILE, "rb" if bytesmode else "r") as fh:
         container = ContainerIO.ContainerIO(fh, 22, 100)
@@ -112,7 +112,7 @@ def test_read_eof(bytesmode) -> None:
 
 
 @pytest.mark.parametrize("bytesmode", (True, False))
-def test_readline(bytesmode) -> None:
+def test_readline(bytesmode: bool) -> None:
     # Arrange
     with open(TEST_FILE, "rb" if bytesmode else "r") as fh:
         container = ContainerIO.ContainerIO(fh, 0, 120)
@@ -127,7 +127,7 @@ def test_readline(bytesmode) -> None:
 
 
 @pytest.mark.parametrize("bytesmode", (True, False))
-def test_readlines(bytesmode) -> None:
+def test_readlines(bytesmode: bool) -> None:
     # Arrange
     expected = [
         "This is line 1\n",
diff --git a/Tests/test_file_gif.py b/Tests/test_file_gif.py
index 3f550fd1109..db9d3586c4d 100644
--- a/Tests/test_file_gif.py
+++ b/Tests/test_file_gif.py
@@ -3,6 +3,7 @@
 import warnings
 from io import BytesIO
 from pathlib import Path
+from typing import Generator
 
 import pytest
 
@@ -144,13 +145,13 @@ def test_strategy() -> None:
 
 
 def test_optimize() -> None:
-    def test_grayscale(optimize):
+    def test_grayscale(optimize: int) -> int:
         im = Image.new("L", (1, 1), 0)
         filename = BytesIO()
         im.save(filename, "GIF", optimize=optimize)
         return len(filename.getvalue())
 
-    def test_bilevel(optimize):
+    def test_bilevel(optimize: int) -> int:
         im = Image.new("1", (1, 1), 0)
         test_file = BytesIO()
         im.save(test_file, "GIF", optimize=optimize)
@@ -178,7 +179,9 @@ def test_bilevel(optimize):
         (4, 513, 256),
     ),
 )
-def test_optimize_correctness(colors, size, expected_palette_length) -> None:
+def test_optimize_correctness(
+    colors: int, size: int, expected_palette_length: int
+) -> None:
     # 256 color Palette image, posterize to > 128 and < 128 levels.
     # Size bigger and smaller than 512x512.
     # Check the palette for number of colors allocated.
@@ -297,7 +300,7 @@ def test_roundtrip_save_all_1(tmp_path: Path) -> None:
         ("Tests/images/dispose_bgnd_rgba.gif", "RGBA"),
     ),
 )
-def test_loading_multiple_palettes(path, mode) -> None:
+def test_loading_multiple_palettes(path: str, mode: str) -> None:
     with Image.open(path) as im:
         assert im.mode == "P"
         first_frame_colors = im.palette.colors.keys()
@@ -347,9 +350,9 @@ def test_palette_handling(tmp_path: Path) -> None:
 def test_palette_434(tmp_path: Path) -> None:
     # see https://github.com/python-pillow/Pillow/issues/434
 
-    def roundtrip(im, *args, **kwargs):
+    def roundtrip(im: Image.Image, **kwargs: bool) -> Image.Image:
         out = str(tmp_path / "temp.gif")
-        im.copy().save(out, *args, **kwargs)
+        im.copy().save(out, **kwargs)
         reloaded = Image.open(out)
 
         return reloaded
@@ -429,7 +432,7 @@ def test_seek_rewind() -> None:
         ("Tests/images/iss634.gif", 42),
     ),
 )
-def test_n_frames(path, n_frames) -> None:
+def test_n_frames(path: str, n_frames: int) -> None:
     # Test is_animated before n_frames
     with Image.open(path) as im:
         assert im.is_animated == (n_frames != 1)
@@ -541,7 +544,10 @@ def test_dispose_background_transparency() -> None:
         ),
     ),
 )
-def test_transparent_dispose(loading_strategy, expected_colors) -> None:
+def test_transparent_dispose(
+    loading_strategy: GifImagePlugin.LoadingStrategy,
+    expected_colors: tuple[tuple[int | tuple[int, int, int, int], ...]],
+) -> None:
     GifImagePlugin.LOADING_STRATEGY = loading_strategy
     try:
         with Image.open("Tests/images/transparent_dispose.gif") as img:
@@ -889,7 +895,9 @@ def test_identical_frames(tmp_path: Path) -> None:
         1500,
     ),
 )
-def test_identical_frames_to_single_frame(duration, tmp_path: Path) -> None:
+def test_identical_frames_to_single_frame(
+    duration: int | list[int], tmp_path: Path
+) -> None:
     out = str(tmp_path / "temp.gif")
     im_list = [
         Image.new("L", (100, 100), "#000"),
@@ -1049,7 +1057,7 @@ def test_retain_comment_in_subsequent_frames(tmp_path: Path) -> None:
 def test_version(tmp_path: Path) -> None:
     out = str(tmp_path / "temp.gif")
 
-    def assert_version_after_save(im, version) -> None:
+    def assert_version_after_save(im: Image.Image, version: bytes) -> None:
         im.save(out)
         with Image.open(out) as reread:
             assert reread.info["version"] == version
@@ -1088,7 +1096,7 @@ def test_append_images(tmp_path: Path) -> None:
         assert reread.n_frames == 3
 
     # Tests appending using a generator
-    def im_generator(ims):
+    def im_generator(ims: list[Image.Image]) -> Generator[Image.Image, None, None]:
         yield from ims
 
     im.save(out, save_all=True, append_images=im_generator(ims))
diff --git a/Tests/test_file_mpo.py b/Tests/test_file_mpo.py
index 55b04a1e076..4fb00d6994a 100644
--- a/Tests/test_file_mpo.py
+++ b/Tests/test_file_mpo.py
@@ -2,6 +2,7 @@
 
 import warnings
 from io import BytesIO
+from typing import Any
 
 import pytest
 
@@ -19,7 +20,7 @@
 pytestmark = skip_unless_feature("jpg")
 
 
-def roundtrip(im, **options):
+def roundtrip(im: Image.Image, **options: Any) -> Image.Image:
     out = BytesIO()
     im.save(out, "MPO", **options)
     test_bytes = out.tell()
@@ -30,7 +31,7 @@ def roundtrip(im, **options):
 
 
 @pytest.mark.parametrize("test_file", test_files)
-def test_sanity(test_file) -> None:
+def test_sanity(test_file: str) -> None:
     with Image.open(test_file) as im:
         im.load()
         assert im.mode == "RGB"
@@ -70,7 +71,7 @@ def test_context_manager() -> None:
 
 
 @pytest.mark.parametrize("test_file", test_files)
-def test_app(test_file) -> None:
+def test_app(test_file: str) -> None:
     # Test APP/COM reader (@PIL135)
     with Image.open(test_file) as im:
         assert im.applist[0][0] == "APP1"
@@ -82,7 +83,7 @@ def test_app(test_file) -> None:
 
 
 @pytest.mark.parametrize("test_file", test_files)
-def test_exif(test_file) -> None:
+def test_exif(test_file: str) -> None:
     with Image.open(test_file) as im_original:
         im_reloaded = roundtrip(im_original, save_all=True, exif=im_original.getexif())
 
@@ -143,7 +144,7 @@ def test_reload_exif_after_seek() -> None:
 
 
 @pytest.mark.parametrize("test_file", test_files)
-def test_mp(test_file) -> None:
+def test_mp(test_file: str) -> None:
     with Image.open(test_file) as im:
         mpinfo = im._getmp()
         assert mpinfo[45056] == b"0100"
@@ -168,7 +169,7 @@ def test_mp_no_data() -> None:
 
 
 @pytest.mark.parametrize("test_file", test_files)
-def test_mp_attribute(test_file) -> None:
+def test_mp_attribute(test_file: str) -> None:
     with Image.open(test_file) as im:
         mpinfo = im._getmp()
     for frame_number, mpentry in enumerate(mpinfo[0xB002]):
@@ -185,7 +186,7 @@ def test_mp_attribute(test_file) -> None:
 
 
 @pytest.mark.parametrize("test_file", test_files)
-def test_seek(test_file) -> None:
+def test_seek(test_file: str) -> None:
     with Image.open(test_file) as im:
         assert im.tell() == 0
         # prior to first image raises an error, both blatant and borderline
@@ -229,7 +230,7 @@ def test_eoferror() -> None:
 
 
 @pytest.mark.parametrize("test_file", test_files)
-def test_image_grab(test_file) -> None:
+def test_image_grab(test_file: str) -> None:
     with Image.open(test_file) as im:
         assert im.tell() == 0
         im0 = im.tobytes()
@@ -244,7 +245,7 @@ def test_image_grab(test_file) -> None:
 
 
 @pytest.mark.parametrize("test_file", test_files)
-def test_save(test_file) -> None:
+def test_save(test_file: str) -> None:
     with Image.open(test_file) as im:
         assert im.tell() == 0
         jpg0 = roundtrip(im)
diff --git a/Tests/test_file_ppm.py b/Tests/test_file_ppm.py
index 94f66ee7d28..6e0fa32e49f 100644
--- a/Tests/test_file_ppm.py
+++ b/Tests/test_file_ppm.py
@@ -70,7 +70,9 @@ def test_sanity() -> None:
         ),
     ),
 )
-def test_arbitrary_maxval(data, mode, pixels) -> None:
+def test_arbitrary_maxval(
+    data: bytes, mode: str, pixels: tuple[int | tuple[int, int, int], ...]
+) -> None:
     fp = BytesIO(data)
     with Image.open(fp) as im:
         assert im.size == (3, 1)
@@ -139,7 +141,7 @@ def test_pfm_big_endian(tmp_path: Path) -> None:
         b"Pf 1 1 -0.0 \0\0\0\0",
     ],
 )
-def test_pfm_invalid(data) -> None:
+def test_pfm_invalid(data: bytes) -> None:
     with pytest.raises(ValueError):
         with Image.open(BytesIO(data)):
             pass
@@ -162,7 +164,7 @@ def test_pfm_invalid(data) -> None:
         ),
     ),
 )
-def test_plain(plain_path, raw_path) -> None:
+def test_plain(plain_path: str, raw_path: str) -> None:
     with Image.open(plain_path) as im:
         assert_image_equal_tofile(im, raw_path)
 
@@ -186,7 +188,9 @@ def test_16bit_plain_pgm() -> None:
         (b"P3\n2 2\n255", b"0 0 0 001 1 1 2 2 2 255 255 255", 10**6),
     ),
 )
-def test_plain_data_with_comment(tmp_path: Path, header, data, comment_count) -> None:
+def test_plain_data_with_comment(
+    tmp_path: Path, header: bytes, data: bytes, comment_count: int
+) -> None:
     path1 = str(tmp_path / "temp1.ppm")
     path2 = str(tmp_path / "temp2.ppm")
     comment = b"# comment" * comment_count
@@ -199,7 +203,7 @@ def test_plain_data_with_comment(tmp_path: Path, header, data, comment_count) ->
 
 
 @pytest.mark.parametrize("data", (b"P1\n128 128\n", b"P3\n128 128\n255\n"))
-def test_plain_truncated_data(tmp_path: Path, data) -> None:
+def test_plain_truncated_data(tmp_path: Path, data: bytes) -> None:
     path = str(tmp_path / "temp.ppm")
     with open(path, "wb") as f:
         f.write(data)
@@ -210,7 +214,7 @@ def test_plain_truncated_data(tmp_path: Path, data) -> None:
 
 
 @pytest.mark.parametrize("data", (b"P1\n128 128\n1009", b"P3\n128 128\n255\n100A"))
-def test_plain_invalid_data(tmp_path: Path, data) -> None:
+def test_plain_invalid_data(tmp_path: Path, data: bytes) -> None:
     path = str(tmp_path / "temp.ppm")
     with open(path, "wb") as f:
         f.write(data)
@@ -227,7 +231,7 @@ def test_plain_invalid_data(tmp_path: Path, data) -> None:
         b"P3\n128 128\n255\n012345678910 0",  # token too long
     ),
 )
-def test_plain_ppm_token_too_long(tmp_path: Path, data) -> None:
+def test_plain_ppm_token_too_long(tmp_path: Path, data: bytes) -> None:
     path = str(tmp_path / "temp.ppm")
     with open(path, "wb") as f:
         f.write(data)
@@ -313,7 +317,7 @@ def test_not_enough_image_data(tmp_path: Path) -> None:
 
 
 @pytest.mark.parametrize("maxval", (b"0", b"65536"))
-def test_invalid_maxval(maxval, tmp_path: Path) -> None:
+def test_invalid_maxval(maxval: bytes, tmp_path: Path) -> None:
     path = str(tmp_path / "temp.ppm")
     with open(path, "wb") as f:
         f.write(b"P6\n3 1 " + maxval)
@@ -351,7 +355,7 @@ def test_mimetypes(tmp_path: Path) -> None:
 
 
 @pytest.mark.parametrize("buffer", (True, False))
-def test_save_stdout(buffer) -> None:
+def test_save_stdout(buffer: bool) -> None:
     old_stdout = sys.stdout
 
     if buffer:
diff --git a/Tests/test_file_sgi.py b/Tests/test_file_sgi.py
index 92aea07350e..e13a8019ed4 100644
--- a/Tests/test_file_sgi.py
+++ b/Tests/test_file_sgi.py
@@ -72,7 +72,7 @@ def test_invalid_file() -> None:
 
 
 def test_write(tmp_path: Path) -> None:
-    def roundtrip(img) -> None:
+    def roundtrip(img: Image.Image) -> None:
         out = str(tmp_path / "temp.sgi")
         img.save(out, format="sgi")
         assert_image_equal_tofile(img, out)
diff --git a/Tests/test_image_frombytes.py b/Tests/test_image_frombytes.py
index 6474daba108..98c0ea0b43c 100644
--- a/Tests/test_image_frombytes.py
+++ b/Tests/test_image_frombytes.py
@@ -8,7 +8,7 @@
 
 
 @pytest.mark.parametrize("data_type", ("bytes", "memoryview"))
-def test_sanity(data_type) -> None:
+def test_sanity(data_type: str) -> None:
     im1 = hopper()
 
     data = im1.tobytes()
diff --git a/Tests/test_image_load.py b/Tests/test_image_load.py
index 5b1a9ee2dda..0605821e0ad 100644
--- a/Tests/test_image_load.py
+++ b/Tests/test_image_load.py
@@ -26,7 +26,7 @@ def test_close() -> None:
         im.getpixel((0, 0))
 
 
-def test_close_after_load(caplog) -> None:
+def test_close_after_load(caplog: pytest.LogCaptureFixture) -> None:
     im = Image.open("Tests/images/hopper.gif")
     im.load()
     with caplog.at_level(logging.DEBUG):
diff --git a/Tests/test_imagedraw.py b/Tests/test_imagedraw.py
index 86d25b1ebc7..c02ac49ddc3 100644
--- a/Tests/test_imagedraw.py
+++ b/Tests/test_imagedraw.py
@@ -74,7 +74,14 @@ def test_mode_mismatch() -> None:
 
 @pytest.mark.parametrize("bbox", BBOX)
 @pytest.mark.parametrize("start, end", ((0, 180), (0.5, 180.4)))
-def test_arc(bbox, start, end) -> None:
+def test_arc(
+    bbox: tuple[tuple[int, int], tuple[int, int]]
+    | list[tuple[int, int]]
+    | list[int]
+    | tuple[int, int, int, int],
+    start: float,
+    end: float,
+) -> None:
     # Arrange
     im = Image.new("RGB", (W, H))
     draw = ImageDraw.Draw(im)
@@ -87,7 +94,12 @@ def test_arc(bbox, start, end) -> None:
 
 
 @pytest.mark.parametrize("bbox", BBOX)
-def test_arc_end_le_start(bbox) -> None:
+def test_arc_end_le_start(
+    bbox: tuple[tuple[int, int], tuple[int, int]]
+    | list[tuple[int, int]]
+    | list[int]
+    | tuple[int, int, int, int]
+) -> None:
     # Arrange
     im = Image.new("RGB", (W, H))
     draw = ImageDraw.Draw(im)
@@ -102,7 +114,12 @@ def test_arc_end_le_start(bbox) -> None:
 
 
 @pytest.mark.parametrize("bbox", BBOX)
-def test_arc_no_loops(bbox) -> None:
+def test_arc_no_loops(
+    bbox: tuple[tuple[int, int], tuple[int, int]]
+    | list[tuple[int, int]]
+    | list[int]
+    | tuple[int, int, int, int]
+) -> None:
     # No need to go in loops
     # Arrange
     im = Image.new("RGB", (W, H))
@@ -118,7 +135,12 @@ def test_arc_no_loops(bbox) -> None:
 
 
 @pytest.mark.parametrize("bbox", BBOX)
-def test_arc_width(bbox) -> None:
+def test_arc_width(
+    bbox: tuple[tuple[int, int], tuple[int, int]]
+    | list[tuple[int, int]]
+    | list[int]
+    | tuple[int, int, int, int]
+) -> None:
     # Arrange
     im = Image.new("RGB", (W, H))
     draw = ImageDraw.Draw(im)
@@ -131,7 +153,12 @@ def test_arc_width(bbox) -> None:
 
 
 @pytest.mark.parametrize("bbox", BBOX)
-def test_arc_width_pieslice_large(bbox) -> None:
+def test_arc_width_pieslice_large(
+    bbox: tuple[tuple[int, int], tuple[int, int]]
+    | list[tuple[int, int]]
+    | list[int]
+    | tuple[int, int, int, int]
+) -> None:
     # Tests an arc with a large enough width that it is a pieslice
     # Arrange
     im = Image.new("RGB", (W, H))
@@ -145,7 +172,12 @@ def test_arc_width_pieslice_large(bbox) -> None:
 
 
 @pytest.mark.parametrize("bbox", BBOX)
-def test_arc_width_fill(bbox) -> None:
+def test_arc_width_fill(
+    bbox: tuple[tuple[int, int], tuple[int, int]]
+    | list[tuple[int, int]]
+    | list[int]
+    | tuple[int, int, int, int]
+) -> None:
     # Arrange
     im = Image.new("RGB", (W, H))
     draw = ImageDraw.Draw(im)
@@ -158,7 +190,12 @@ def test_arc_width_fill(bbox) -> None:
 
 
 @pytest.mark.parametrize("bbox", BBOX)
-def test_arc_width_non_whole_angle(bbox) -> None:
+def test_arc_width_non_whole_angle(
+    bbox: tuple[tuple[int, int], tuple[int, int]]
+    | list[tuple[int, int]]
+    | list[int]
+    | tuple[int, int, int, int]
+) -> None:
     # Arrange
     im = Image.new("RGB", (W, H))
     draw = ImageDraw.Draw(im)
@@ -200,7 +237,13 @@ def test_bitmap() -> None:
 
 @pytest.mark.parametrize("mode", ("RGB", "L"))
 @pytest.mark.parametrize("bbox", BBOX)
-def test_chord(mode, bbox) -> None:
+def test_chord(
+    mode: str,
+    bbox: tuple[tuple[int, int], tuple[int, int]]
+    | list[tuple[int, int]]
+    | list[int]
+    | tuple[int, int, int, int],
+) -> None:
     # Arrange
     im = Image.new(mode, (W, H))
     draw = ImageDraw.Draw(im)
@@ -214,7 +257,12 @@ def test_chord(mode, bbox) -> None:
 
 
 @pytest.mark.parametrize("bbox", BBOX)
-def test_chord_width(bbox) -> None:
+def test_chord_width(
+    bbox: tuple[tuple[int, int], tuple[int, int]]
+    | list[tuple[int, int]]
+    | list[int]
+    | tuple[int, int, int, int]
+) -> None:
     # Arrange
     im = Image.new("RGB", (W, H))
     draw = ImageDraw.Draw(im)
@@ -227,7 +275,12 @@ def test_chord_width(bbox) -> None:
 
 
 @pytest.mark.parametrize("bbox", BBOX)
-def test_chord_width_fill(bbox) -> None:
+def test_chord_width_fill(
+    bbox: tuple[tuple[int, int], tuple[int, int]]
+    | list[tuple[int, int]]
+    | list[int]
+    | tuple[int, int, int, int]
+) -> None:
     # Arrange
     im = Image.new("RGB", (W, H))
     draw = ImageDraw.Draw(im)
@@ -240,7 +293,12 @@ def test_chord_width_fill(bbox) -> None:
 
 
 @pytest.mark.parametrize("bbox", BBOX)
-def test_chord_zero_width(bbox) -> None:
+def test_chord_zero_width(
+    bbox: tuple[tuple[int, int], tuple[int, int]]
+    | list[tuple[int, int]]
+    | list[int]
+    | tuple[int, int, int, int]
+) -> None:
     # Arrange
     im = Image.new("RGB", (W, H))
     draw = ImageDraw.Draw(im)
@@ -266,7 +324,13 @@ def test_chord_too_fat() -> None:
 
 @pytest.mark.parametrize("mode", ("RGB", "L"))
 @pytest.mark.parametrize("bbox", BBOX)
-def test_ellipse(mode, bbox) -> None:
+def test_ellipse(
+    mode: str,
+    bbox: tuple[tuple[int, int], tuple[int, int]]
+    | list[tuple[int, int]]
+    | list[int]
+    | tuple[int, int, int, int],
+) -> None:
     # Arrange
     im = Image.new(mode, (W, H))
     draw = ImageDraw.Draw(im)
@@ -280,7 +344,12 @@ def test_ellipse(mode, bbox) -> None:
 
 
 @pytest.mark.parametrize("bbox", BBOX)
-def test_ellipse_translucent(bbox) -> None:
+def test_ellipse_translucent(
+    bbox: tuple[tuple[int, int], tuple[int, int]]
+    | list[tuple[int, int]]
+    | list[int]
+    | tuple[int, int, int, int]
+) -> None:
     # Arrange
     im = Image.new("RGB", (W, H))
     draw = ImageDraw.Draw(im, "RGBA")
@@ -317,7 +386,12 @@ def test_ellipse_symmetric() -> None:
 
 
 @pytest.mark.parametrize("bbox", BBOX)
-def test_ellipse_width(bbox) -> None:
+def test_ellipse_width(
+    bbox: tuple[tuple[int, int], tuple[int, int]]
+    | list[tuple[int, int]]
+    | list[int]
+    | tuple[int, int, int, int]
+) -> None:
     # Arrange
     im = Image.new("RGB", (W, H))
     draw = ImageDraw.Draw(im)
@@ -342,7 +416,12 @@ def test_ellipse_width_large() -> None:
 
 
 @pytest.mark.parametrize("bbox", BBOX)
-def test_ellipse_width_fill(bbox) -> None:
+def test_ellipse_width_fill(
+    bbox: tuple[tuple[int, int], tuple[int, int]]
+    | list[tuple[int, int]]
+    | list[int]
+    | tuple[int, int, int, int]
+) -> None:
     # Arrange
     im = Image.new("RGB", (W, H))
     draw = ImageDraw.Draw(im)
@@ -355,7 +434,12 @@ def test_ellipse_width_fill(bbox) -> None:
 
 
 @pytest.mark.parametrize("bbox", BBOX)
-def test_ellipse_zero_width(bbox) -> None:
+def test_ellipse_zero_width(
+    bbox: tuple[tuple[int, int], tuple[int, int]]
+    | list[tuple[int, int]]
+    | list[int]
+    | tuple[int, int, int, int]
+) -> None:
     # Arrange
     im = Image.new("RGB", (W, H))
     draw = ImageDraw.Draw(im)
@@ -367,7 +451,7 @@ def test_ellipse_zero_width(bbox) -> None:
     assert_image_equal_tofile(im, "Tests/images/imagedraw_ellipse_zero_width.png")
 
 
-def ellipse_various_sizes_helper(filled):
+def ellipse_various_sizes_helper(filled: bool) -> Image.Image:
     ellipse_sizes = range(32)
     image_size = sum(ellipse_sizes) + len(ellipse_sizes) + 1
     im = Image.new("RGB", (image_size, image_size))
@@ -409,7 +493,12 @@ def test_ellipse_various_sizes_filled() -> None:
 
 
 @pytest.mark.parametrize("points", POINTS)
-def test_line(points) -> None:
+def test_line(
+    points: tuple[tuple[int, int], ...]
+    | list[tuple[int, int]]
+    | tuple[int, ...]
+    | list[int]
+) -> None:
     # Arrange
     im = Image.new("RGB", (W, H))
     draw = ImageDraw.Draw(im)
@@ -482,7 +571,14 @@ def test_transform() -> None:
 
 @pytest.mark.parametrize("bbox", BBOX)
 @pytest.mark.parametrize("start, end", ((-92, 46), (-92.2, 46.2)))
-def test_pieslice(bbox, start, end) -> None:
+def test_pieslice(
+    bbox: tuple[tuple[int, int], tuple[int, int]]
+    | list[tuple[int, int]]
+    | list[int]
+    | tuple[int, int, int, int],
+    start: float,
+    end: float,
+) -> None:
     # Arrange
     im = Image.new("RGB", (W, H))
     draw = ImageDraw.Draw(im)
@@ -495,7 +591,12 @@ def test_pieslice(bbox, start, end) -> None:
 
 
 @pytest.mark.parametrize("bbox", BBOX)
-def test_pieslice_width(bbox) -> None:
+def test_pieslice_width(
+    bbox: tuple[tuple[int, int], tuple[int, int]]
+    | list[tuple[int, int]]
+    | list[int]
+    | tuple[int, int, int, int]
+) -> None:
     # Arrange
     im = Image.new("RGB", (W, H))
     draw = ImageDraw.Draw(im)
@@ -508,7 +609,12 @@ def test_pieslice_width(bbox) -> None:
 
 
 @pytest.mark.parametrize("bbox", BBOX)
-def test_pieslice_width_fill(bbox) -> None:
+def test_pieslice_width_fill(
+    bbox: tuple[tuple[int, int], tuple[int, int]]
+    | list[tuple[int, int]]
+    | list[int]
+    | tuple[int, int, int, int]
+) -> None:
     # Arrange
     im = Image.new("RGB", (W, H))
     draw = ImageDraw.Draw(im)
@@ -522,7 +628,12 @@ def test_pieslice_width_fill(bbox) -> None:
 
 
 @pytest.mark.parametrize("bbox", BBOX)
-def test_pieslice_zero_width(bbox) -> None:
+def test_pieslice_zero_width(
+    bbox: tuple[tuple[int, int], tuple[int, int]]
+    | list[tuple[int, int]]
+    | list[int]
+    | tuple[int, int, int, int]
+) -> None:
     # Arrange
     im = Image.new("RGB", (W, H))
     draw = ImageDraw.Draw(im)
@@ -577,7 +688,12 @@ def test_pieslice_no_spikes() -> None:
 
 
 @pytest.mark.parametrize("points", POINTS)
-def test_point(points) -> None:
+def test_point(
+    points: tuple[tuple[int, int], ...]
+    | list[tuple[int, int]]
+    | tuple[int, ...]
+    | list[int]
+) -> None:
     # Arrange
     im = Image.new("RGB", (W, H))
     draw = ImageDraw.Draw(im)
@@ -602,7 +718,12 @@ def test_point_I16() -> None:
 
 
 @pytest.mark.parametrize("points", POINTS)
-def test_polygon(points) -> None:
+def test_polygon(
+    points: tuple[tuple[int, int], ...]
+    | list[tuple[int, int]]
+    | tuple[int, ...]
+    | list[int]
+) -> None:
     # Arrange
     im = Image.new("RGB", (W, H))
     draw = ImageDraw.Draw(im)
@@ -616,7 +737,9 @@ def test_polygon(points) -> None:
 
 @pytest.mark.parametrize("mode", ("RGB", "L"))
 @pytest.mark.parametrize("kite_points", KITE_POINTS)
-def test_polygon_kite(mode, kite_points) -> None:
+def test_polygon_kite(
+    mode: str, kite_points: tuple[tuple[int, int], ...] | list[tuple[int, int]]
+) -> None:
     # Test drawing lines of different gradients (dx>dy, dy>dx) and
     # vertical (dx==0) and horizontal (dy==0) lines
     # Arrange
@@ -673,7 +796,12 @@ def test_polygon_translucent() -> None:
 
 
 @pytest.mark.parametrize("bbox", BBOX)
-def test_rectangle(bbox) -> None:
+def test_rectangle(
+    bbox: tuple[tuple[int, int], tuple[int, int]]
+    | list[tuple[int, int]]
+    | list[int]
+    | tuple[int, int, int, int]
+) -> None:
     # Arrange
     im = Image.new("RGB", (W, H))
     draw = ImageDraw.Draw(im)
@@ -700,7 +828,12 @@ def test_big_rectangle() -> None:
 
 
 @pytest.mark.parametrize("bbox", BBOX)
-def test_rectangle_width(bbox) -> None:
+def test_rectangle_width(
+    bbox: tuple[tuple[int, int], tuple[int, int]]
+    | list[tuple[int, int]]
+    | list[int]
+    | tuple[int, int, int, int]
+) -> None:
     # Arrange
     im = Image.new("RGB", (W, H))
     draw = ImageDraw.Draw(im)
@@ -714,7 +847,12 @@ def test_rectangle_width(bbox) -> None:
 
 
 @pytest.mark.parametrize("bbox", BBOX)
-def test_rectangle_width_fill(bbox) -> None:
+def test_rectangle_width_fill(
+    bbox: tuple[tuple[int, int], tuple[int, int]]
+    | list[tuple[int, int]]
+    | list[int]
+    | tuple[int, int, int, int]
+) -> None:
     # Arrange
     im = Image.new("RGB", (W, H))
     draw = ImageDraw.Draw(im)
@@ -728,7 +866,12 @@ def test_rectangle_width_fill(bbox) -> None:
 
 
 @pytest.mark.parametrize("bbox", BBOX)
-def test_rectangle_zero_width(bbox) -> None:
+def test_rectangle_zero_width(
+    bbox: tuple[tuple[int, int], tuple[int, int]]
+    | list[tuple[int, int]]
+    | list[int]
+    | tuple[int, int, int, int]
+) -> None:
     # Arrange
     im = Image.new("RGB", (W, H))
     draw = ImageDraw.Draw(im)
@@ -741,7 +884,12 @@ def test_rectangle_zero_width(bbox) -> None:
 
 
 @pytest.mark.parametrize("bbox", BBOX)
-def test_rectangle_I16(bbox) -> None:
+def test_rectangle_I16(
+    bbox: tuple[tuple[int, int], tuple[int, int]]
+    | list[tuple[int, int]]
+    | list[int]
+    | tuple[int, int, int, int]
+) -> None:
     # Arrange
     im = Image.new("I;16", (W, H))
     draw = ImageDraw.Draw(im)
@@ -754,7 +902,12 @@ def test_rectangle_I16(bbox) -> None:
 
 
 @pytest.mark.parametrize("bbox", BBOX)
-def test_rectangle_translucent_outline(bbox) -> None:
+def test_rectangle_translucent_outline(
+    bbox: tuple[tuple[int, int], tuple[int, int]]
+    | list[tuple[int, int]]
+    | list[int]
+    | tuple[int, int, int, int]
+) -> None:
     # Arrange
     im = Image.new("RGB", (W, H))
     draw = ImageDraw.Draw(im, "RGBA")
@@ -772,7 +925,11 @@ def test_rectangle_translucent_outline(bbox) -> None:
     "xy",
     [(10, 20, 190, 180), ([10, 20], [190, 180]), ((10, 20), (190, 180))],
 )
-def test_rounded_rectangle(xy) -> None:
+def test_rounded_rectangle(
+    xy: tuple[int, int, int, int]
+    | tuple[list[int]]
+    | tuple[tuple[int, int], tuple[int, int]]
+) -> None:
     # Arrange
     im = Image.new("RGB", (200, 200))
     draw = ImageDraw.Draw(im)
@@ -789,7 +946,7 @@ def test_rounded_rectangle(xy) -> None:
 @pytest.mark.parametrize("bottom_right", (True, False))
 @pytest.mark.parametrize("bottom_left", (True, False))
 def test_rounded_rectangle_corners(
-    top_left, top_right, bottom_right, bottom_left
+    top_left: bool, top_right: bool, bottom_right: bool, bottom_left: bool
 ) -> None:
     corners = (top_left, top_right, bottom_right, bottom_left)
 
@@ -824,7 +981,9 @@ def test_rounded_rectangle_corners(
         ((10, 20, 190, 181), 85, "height"),
     ],
 )
-def test_rounded_rectangle_non_integer_radius(xy, radius, type) -> None:
+def test_rounded_rectangle_non_integer_radius(
+    xy: tuple[int, int, int, int], radius: float, type: str
+) -> None:
     # Arrange
     im = Image.new("RGB", (200, 200))
     draw = ImageDraw.Draw(im)
@@ -840,7 +999,12 @@ def test_rounded_rectangle_non_integer_radius(xy, radius, type) -> None:
 
 
 @pytest.mark.parametrize("bbox", BBOX)
-def test_rounded_rectangle_zero_radius(bbox) -> None:
+def test_rounded_rectangle_zero_radius(
+    bbox: tuple[tuple[int, int], tuple[int, int]]
+    | list[tuple[int, int]]
+    | list[int]
+    | tuple[int, int, int, int]
+) -> None:
     # Arrange
     im = Image.new("RGB", (W, H))
     draw = ImageDraw.Draw(im)
@@ -862,7 +1026,9 @@ def test_rounded_rectangle_zero_radius(bbox) -> None:
         ((20, 20, 80, 80), "both"),
     ],
 )
-def test_rounded_rectangle_translucent(xy, suffix) -> None:
+def test_rounded_rectangle_translucent(
+    xy: tuple[int, int, int, int], suffix: str
+) -> None:
     # Arrange
     im = Image.new("RGB", (W, H))
     draw = ImageDraw.Draw(im, "RGBA")
@@ -879,7 +1045,12 @@ def test_rounded_rectangle_translucent(xy, suffix) -> None:
 
 
 @pytest.mark.parametrize("bbox", BBOX)
-def test_floodfill(bbox) -> None:
+def test_floodfill(
+    bbox: tuple[tuple[int, int], tuple[int, int]]
+    | list[tuple[int, int]]
+    | list[int]
+    | tuple[int, int, int, int]
+) -> None:
     red = ImageColor.getrgb("red")
 
     for mode, value in [("L", 1), ("RGBA", (255, 0, 0, 0)), ("RGB", red)]:
@@ -912,7 +1083,12 @@ def test_floodfill(bbox) -> None:
 
 
 @pytest.mark.parametrize("bbox", BBOX)
-def test_floodfill_border(bbox) -> None:
+def test_floodfill_border(
+    bbox: tuple[tuple[int, int], tuple[int, int]]
+    | list[tuple[int, int]]
+    | list[int]
+    | tuple[int, int, int, int]
+) -> None:
     # floodfill() is experimental
 
     # Arrange
@@ -934,7 +1110,12 @@ def test_floodfill_border(bbox) -> None:
 
 
 @pytest.mark.parametrize("bbox", BBOX)
-def test_floodfill_thresh(bbox) -> None:
+def test_floodfill_thresh(
+    bbox: tuple[tuple[int, int], tuple[int, int]]
+    | list[tuple[int, int]]
+    | list[int]
+    | tuple[int, int, int, int]
+) -> None:
     # floodfill() is experimental
 
     # Arrange
@@ -968,8 +1149,11 @@ def test_floodfill_not_negative() -> None:
 
 
 def create_base_image_draw(
-    size, mode=DEFAULT_MODE, background1=WHITE, background2=GRAY
-):
+    size: tuple[int, int],
+    mode: str = DEFAULT_MODE,
+    background1: tuple[int, int, int] = WHITE,
+    background2: tuple[int, int, int] = GRAY,
+) -> tuple[Image.Image, ImageDraw.ImageDraw]:
     img = Image.new(mode, size, background1)
     for x in range(0, size[0]):
         for y in range(0, size[1]):
@@ -1003,7 +1187,7 @@ def test_triangle_right() -> None:
     "fill, suffix",
     ((BLACK, "width"), (None, "width_no_fill")),
 )
-def test_triangle_right_width(fill, suffix) -> None:
+def test_triangle_right_width(fill: tuple[int, int, int] | None, suffix: str) -> None:
     img, draw = create_base_image_draw((100, 100))
     draw.polygon([(15, 25), (85, 25), (50, 60)], fill, WHITE, width=5)
     assert_image_equal_tofile(
@@ -1235,7 +1419,7 @@ def test_wide_line_larger_than_int() -> None:
         ],
     ],
 )
-def test_line_joint(xy) -> None:
+def test_line_joint(xy: list[tuple[int, int]] | tuple[int, ...] | list[int]) -> None:
     im = Image.new("RGB", (500, 325))
     draw = ImageDraw.Draw(im)
 
@@ -1388,7 +1572,12 @@ def test_default_font_size() -> None:
 
 
 @pytest.mark.parametrize("bbox", BBOX)
-def test_same_color_outline(bbox) -> None:
+def test_same_color_outline(
+    bbox: tuple[tuple[int, int], tuple[int, int]]
+    | list[tuple[int, int]]
+    | list[int]
+    | tuple[int, int, int, int]
+) -> None:
     # Prepare shape
     x0, y0 = 5, 5
     x1, y1 = 5, 50
@@ -1402,7 +1591,8 @@ def test_same_color_outline(bbox) -> None:
 
     # Begin
     for mode in ["RGB", "L"]:
-        for fill, outline in [["red", None], ["red", "red"], ["red", "#f00"]]:
+        fill = "red"
+        for outline in [None, "red", "#f00"]:
             for operation, args in {
                 "chord": [bbox, 0, 180],
                 "ellipse": [bbox],
@@ -1417,6 +1607,7 @@ def test_same_color_outline(bbox) -> None:
 
                 # Act
                 draw_method = getattr(draw, operation)
+                assert isinstance(args, list)
                 args += [fill, outline]
                 draw_method(*args)
 
@@ -1434,7 +1625,9 @@ def test_same_color_outline(bbox) -> None:
         (3, "triangle_width", {"width": 5, "outline": "yellow"}),
     ],
 )
-def test_draw_regular_polygon(n_sides, polygon_name, args) -> None:
+def test_draw_regular_polygon(
+    n_sides: int, polygon_name: str, args: dict[str, int | str]
+) -> None:
     im = Image.new("RGBA", size=(W, H), color=(255, 0, 0, 0))
     filename = f"Tests/images/imagedraw_{polygon_name}.png"
     draw = ImageDraw.Draw(im)
@@ -1471,7 +1664,9 @@ def test_draw_regular_polygon(n_sides, polygon_name, args) -> None:
         ),
     ],
 )
-def test_compute_regular_polygon_vertices(n_sides, expected_vertices) -> None:
+def test_compute_regular_polygon_vertices(
+    n_sides: int, expected_vertices: list[tuple[float, float]]
+) -> None:
     bounding_circle = (W // 2, H // 2, 25)
     vertices = ImageDraw._compute_regular_polygon_vertices(bounding_circle, n_sides, 0)
     assert vertices == expected_vertices
@@ -1569,7 +1764,7 @@ def test_polygon2() -> None:
 
 
 @pytest.mark.parametrize("xy", ((1, 1, 0, 1), (1, 1, 1, 0)))
-def test_incorrectly_ordered_coordinates(xy) -> None:
+def test_incorrectly_ordered_coordinates(xy: tuple[int, int, int, int]) -> None:
     im = Image.new("RGB", (W, H))
     draw = ImageDraw.Draw(im)
     with pytest.raises(ValueError):
diff --git a/Tests/test_imagetk.py b/Tests/test_imagetk.py
index a216bd21de2..b607b8c43aa 100644
--- a/Tests/test_imagetk.py
+++ b/Tests/test_imagetk.py
@@ -57,7 +57,7 @@ def test_kw() -> None:
 
 
 @pytest.mark.parametrize("mode", TK_MODES)
-def test_photoimage(mode) -> None:
+def test_photoimage(mode: str) -> None:
     # test as image:
     im = hopper(mode)
 
@@ -79,7 +79,7 @@ def test_photoimage_apply_transparency() -> None:
 
 
 @pytest.mark.parametrize("mode", TK_MODES)
-def test_photoimage_blank(mode) -> None:
+def test_photoimage_blank(mode: str) -> None:
     # test a image using mode/size:
     im_tk = ImageTk.PhotoImage(mode, (100, 100))
 
diff --git a/Tests/test_lib_pack.py b/Tests/test_lib_pack.py
index c8d6d33d223..629a6dc7a87 100644
--- a/Tests/test_lib_pack.py
+++ b/Tests/test_lib_pack.py
@@ -10,7 +10,13 @@
 
 
 class TestLibPack:
-    def assert_pack(self, mode, rawmode, data, *pixels) -> None:
+    def assert_pack(
+        self,
+        mode: str,
+        rawmode: str,
+        data: int | bytes,
+        *pixels: int | float | tuple[int, ...],
+    ) -> None:
         """
         data - either raw bytes with data or just number of bytes in rawmode.
         """
@@ -228,7 +234,13 @@ def test_F_float(self) -> None:
 
 
 class TestLibUnpack:
-    def assert_unpack(self, mode, rawmode, data, *pixels) -> None:
+    def assert_unpack(
+        self,
+        mode: str,
+        rawmode: str,
+        data: int | bytes,
+        *pixels: int | float | tuple[int, ...],
+    ) -> None:
         """
         data - either raw bytes with data or just number of bytes in rawmode.
         """
diff --git a/Tests/test_mode_i16.py b/Tests/test_mode_i16.py
index f2540bb465e..903f7e0c60e 100644
--- a/Tests/test_mode_i16.py
+++ b/Tests/test_mode_i16.py
@@ -11,7 +11,7 @@
 original = hopper().resize((32, 32)).convert("I")
 
 
-def verify(im1) -> None:
+def verify(im1: Image.Image) -> None:
     im2 = original.copy()
     assert im1.size == im2.size
     pix1 = im1.load()
@@ -27,7 +27,7 @@ def verify(im1) -> None:
 
 
 @pytest.mark.parametrize("mode", ("L", "I;16", "I;16B", "I;16L", "I"))
-def test_basic(tmp_path: Path, mode) -> None:
+def test_basic(tmp_path: Path, mode: str) -> None:
     # PIL 1.1 has limited support for 16-bit image data.  Check that
     # create/copy/transform and save works as expected.
 
@@ -78,7 +78,7 @@ def test_basic(tmp_path: Path, mode) -> None:
 
 
 def test_tobytes() -> None:
-    def tobytes(mode):
+    def tobytes(mode: str) -> Image.Image:
         return Image.new(mode, (1, 1), 1).tobytes()
 
     order = 1 if Image._ENDIAN == "<" else -1

From b8769d1cf5782f3db934b861ad764dc9b1466fb4 Mon Sep 17 00:00:00 2001
From: FangFuxin <38530078+lajiyuan@users.noreply.github.com>
Date: Wed, 31 Jan 2024 21:02:50 +0800
Subject: [PATCH 0150/1178] Update Tests/test_file_png.py

Co-authored-by: Andrew Murray <3112309+radarhere@users.noreply.github.com>
---
 Tests/test_file_png.py | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/Tests/test_file_png.py b/Tests/test_file_png.py
index 0884ddcc35d..ec8794b3008 100644
--- a/Tests/test_file_png.py
+++ b/Tests/test_file_png.py
@@ -778,7 +778,7 @@ class MyStdOut:
         with Image.open(mystdout) as reloaded:
             assert_image_equal_tofile(reloaded, TEST_PNG_FILE)
 
-    def test_truncated_end_chunk(self):
+    def test_truncated_end_chunk(self) -> None:
         with Image.open("Tests/images/truncated_end_chunk.png") as im:
             with pytest.raises(OSError):
                 im.load()

From f2228e0a7c19d74c83b99f92edc113ba0cac7625 Mon Sep 17 00:00:00 2001
From: Hugo van Kemenade <1324225+hugovk@users.noreply.github.com>
Date: Wed, 31 Jan 2024 12:37:53 -0700
Subject: [PATCH 0151/1178] Replace bytes | str | Path with StrOrBytesPath
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit

Co-authored-by: Ondrej Baranovič <nulano@nulano.eu>
---
 src/PIL/_util.py | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/src/PIL/_util.py b/src/PIL/_util.py
index b649500abb5..f7a69fae15d 100644
--- a/src/PIL/_util.py
+++ b/src/PIL/_util.py
@@ -11,7 +11,7 @@ def is_path(f: Any) -> TypeGuard[StrOrBytesPath]:
     return isinstance(f, (bytes, str, os.PathLike))
 
 
-def is_directory(f: Any) -> TypeGuard[bytes | str | Path]:
+def is_directory(f: Any) -> TypeGuard[StrOrBytesPath]:
     """Checks if an object is a string, and that it points to a directory."""
     return is_path(f) and os.path.isdir(f)
 

From 256f3f1966d6b56f178d0a9bb2bc4b0b334c77b1 Mon Sep 17 00:00:00 2001
From: "pre-commit-ci[bot]"
 <66853113+pre-commit-ci[bot]@users.noreply.github.com>
Date: Wed, 31 Jan 2024 19:38:49 +0000
Subject: [PATCH 0152/1178] [pre-commit.ci] auto fixes from pre-commit.com
 hooks

for more information, see https://pre-commit.ci
---
 src/PIL/_util.py | 1 -
 1 file changed, 1 deletion(-)

diff --git a/src/PIL/_util.py b/src/PIL/_util.py
index f7a69fae15d..6bc76281616 100644
--- a/src/PIL/_util.py
+++ b/src/PIL/_util.py
@@ -1,7 +1,6 @@
 from __future__ import annotations
 
 import os
-from pathlib import Path
 from typing import Any, NoReturn
 
 from ._typing import StrOrBytesPath, TypeGuard

From 6dba9c988765084c104fd93c9fcc9ba3d18f6873 Mon Sep 17 00:00:00 2001
From: "renovate[bot]" <29139614+renovate[bot]@users.noreply.github.com>
Date: Wed, 31 Jan 2024 21:14:01 +0000
Subject: [PATCH 0153/1178] Update github-actions to v4

---
 .github/workflows/test-cygwin.yml  | 4 ++--
 .github/workflows/test-docker.yml  | 2 +-
 .github/workflows/test-mingw.yml   | 2 +-
 .github/workflows/test-windows.yml | 2 +-
 .github/workflows/test.yml         | 2 +-
 5 files changed, 6 insertions(+), 6 deletions(-)

diff --git a/.github/workflows/test-cygwin.yml b/.github/workflows/test-cygwin.yml
index b5c8c39aaef..7bbe5a37f50 100644
--- a/.github/workflows/test-cygwin.yml
+++ b/.github/workflows/test-cygwin.yml
@@ -81,7 +81,7 @@ jobs:
             zlib-devel
 
       - name: Add Lapack to PATH
-        uses: egor-tensin/cleanup-path@v3
+        uses: egor-tensin/cleanup-path@v4
         with:
           dirs: 'C:\cygwin\bin;C:\cygwin\lib\lapack'
 
@@ -142,7 +142,7 @@ jobs:
           bash.exe .ci/after_success.sh
 
       - name: Upload coverage
-        uses: codecov/codecov-action@v3
+        uses: codecov/codecov-action@v4
         with:
           file: ./coverage.xml
           flags: GHA_Cygwin
diff --git a/.github/workflows/test-docker.yml b/.github/workflows/test-docker.yml
index 3bb6856f6e8..75aab9bd489 100644
--- a/.github/workflows/test-docker.yml
+++ b/.github/workflows/test-docker.yml
@@ -101,7 +101,7 @@ jobs:
         MATRIX_DOCKER: ${{ matrix.docker }}
 
     - name: Upload coverage
-      uses: codecov/codecov-action@v3
+      uses: codecov/codecov-action@v4
       with:
         flags: GHA_Docker
         name: ${{ matrix.docker }}
diff --git a/.github/workflows/test-mingw.yml b/.github/workflows/test-mingw.yml
index cdd51e2bb3f..acea78c37d9 100644
--- a/.github/workflows/test-mingw.yml
+++ b/.github/workflows/test-mingw.yml
@@ -82,7 +82,7 @@ jobs:
           python3 -m pytest -vx --cov PIL --cov Tests --cov-report term --cov-report xml Tests
 
       - name: Upload coverage
-        uses: codecov/codecov-action@v3
+        uses: codecov/codecov-action@v4
         with:
           file: ./coverage.xml
           flags: GHA_Windows
diff --git a/.github/workflows/test-windows.yml b/.github/workflows/test-windows.yml
index 8cad7a8b281..b737615ca4b 100644
--- a/.github/workflows/test-windows.yml
+++ b/.github/workflows/test-windows.yml
@@ -202,7 +202,7 @@ jobs:
       shell: pwsh
 
     - name: Upload coverage
-      uses: codecov/codecov-action@v3
+      uses: codecov/codecov-action@v4
       with:
         file: ./coverage.xml
         flags: GHA_Windows
diff --git a/.github/workflows/test.yml b/.github/workflows/test.yml
index ae84a4d8fd5..038bcfbc35a 100644
--- a/.github/workflows/test.yml
+++ b/.github/workflows/test.yml
@@ -149,7 +149,7 @@ jobs:
         .ci/after_success.sh
 
     - name: Upload coverage
-      uses: codecov/codecov-action@v3
+      uses: codecov/codecov-action@v4
       with:
         flags: ${{ matrix.os == 'ubuntu-latest' && 'GHA_Ubuntu' || 'GHA_macOS' }}
         name: ${{ matrix.os }} Python ${{ matrix.python-version }}

From 2515938cdd321a5940a070f808c01ed48ad4e10e Mon Sep 17 00:00:00 2001
From: Andrew Murray <radarhere@users.noreply.github.com>
Date: Fri, 2 Feb 2024 19:04:22 +1100
Subject: [PATCH 0154/1178] Simplified type hints

---
 Tests/test_imagedraw.py | 222 ++++++----------------------------------
 1 file changed, 32 insertions(+), 190 deletions(-)

diff --git a/Tests/test_imagedraw.py b/Tests/test_imagedraw.py
index c02ac49ddc3..6e7dce420d2 100644
--- a/Tests/test_imagedraw.py
+++ b/Tests/test_imagedraw.py
@@ -2,6 +2,7 @@
 
 import contextlib
 import os.path
+from typing import Sequence
 
 import pytest
 
@@ -74,14 +75,7 @@ def test_mode_mismatch() -> None:
 
 @pytest.mark.parametrize("bbox", BBOX)
 @pytest.mark.parametrize("start, end", ((0, 180), (0.5, 180.4)))
-def test_arc(
-    bbox: tuple[tuple[int, int], tuple[int, int]]
-    | list[tuple[int, int]]
-    | list[int]
-    | tuple[int, int, int, int],
-    start: float,
-    end: float,
-) -> None:
+def test_arc(bbox: Sequence[int | Sequence[int]], start: float, end: float) -> None:
     # Arrange
     im = Image.new("RGB", (W, H))
     draw = ImageDraw.Draw(im)
@@ -94,12 +88,7 @@ def test_arc(
 
 
 @pytest.mark.parametrize("bbox", BBOX)
-def test_arc_end_le_start(
-    bbox: tuple[tuple[int, int], tuple[int, int]]
-    | list[tuple[int, int]]
-    | list[int]
-    | tuple[int, int, int, int]
-) -> None:
+def test_arc_end_le_start(bbox: Sequence[int | Sequence[int]]) -> None:
     # Arrange
     im = Image.new("RGB", (W, H))
     draw = ImageDraw.Draw(im)
@@ -114,12 +103,7 @@ def test_arc_end_le_start(
 
 
 @pytest.mark.parametrize("bbox", BBOX)
-def test_arc_no_loops(
-    bbox: tuple[tuple[int, int], tuple[int, int]]
-    | list[tuple[int, int]]
-    | list[int]
-    | tuple[int, int, int, int]
-) -> None:
+def test_arc_no_loops(bbox: Sequence[int | Sequence[int]]) -> None:
     # No need to go in loops
     # Arrange
     im = Image.new("RGB", (W, H))
@@ -135,12 +119,7 @@ def test_arc_no_loops(
 
 
 @pytest.mark.parametrize("bbox", BBOX)
-def test_arc_width(
-    bbox: tuple[tuple[int, int], tuple[int, int]]
-    | list[tuple[int, int]]
-    | list[int]
-    | tuple[int, int, int, int]
-) -> None:
+def test_arc_width(bbox: Sequence[int | Sequence[int]]) -> None:
     # Arrange
     im = Image.new("RGB", (W, H))
     draw = ImageDraw.Draw(im)
@@ -153,12 +132,7 @@ def test_arc_width(
 
 
 @pytest.mark.parametrize("bbox", BBOX)
-def test_arc_width_pieslice_large(
-    bbox: tuple[tuple[int, int], tuple[int, int]]
-    | list[tuple[int, int]]
-    | list[int]
-    | tuple[int, int, int, int]
-) -> None:
+def test_arc_width_pieslice_large(bbox: Sequence[int | Sequence[int]]) -> None:
     # Tests an arc with a large enough width that it is a pieslice
     # Arrange
     im = Image.new("RGB", (W, H))
@@ -172,12 +146,7 @@ def test_arc_width_pieslice_large(
 
 
 @pytest.mark.parametrize("bbox", BBOX)
-def test_arc_width_fill(
-    bbox: tuple[tuple[int, int], tuple[int, int]]
-    | list[tuple[int, int]]
-    | list[int]
-    | tuple[int, int, int, int]
-) -> None:
+def test_arc_width_fill(bbox: Sequence[int | Sequence[int]]) -> None:
     # Arrange
     im = Image.new("RGB", (W, H))
     draw = ImageDraw.Draw(im)
@@ -190,12 +159,7 @@ def test_arc_width_fill(
 
 
 @pytest.mark.parametrize("bbox", BBOX)
-def test_arc_width_non_whole_angle(
-    bbox: tuple[tuple[int, int], tuple[int, int]]
-    | list[tuple[int, int]]
-    | list[int]
-    | tuple[int, int, int, int]
-) -> None:
+def test_arc_width_non_whole_angle(bbox: Sequence[int | Sequence[int]]) -> None:
     # Arrange
     im = Image.new("RGB", (W, H))
     draw = ImageDraw.Draw(im)
@@ -237,13 +201,7 @@ def test_bitmap() -> None:
 
 @pytest.mark.parametrize("mode", ("RGB", "L"))
 @pytest.mark.parametrize("bbox", BBOX)
-def test_chord(
-    mode: str,
-    bbox: tuple[tuple[int, int], tuple[int, int]]
-    | list[tuple[int, int]]
-    | list[int]
-    | tuple[int, int, int, int],
-) -> None:
+def test_chord(mode: str, bbox: Sequence[int | Sequence[int]]) -> None:
     # Arrange
     im = Image.new(mode, (W, H))
     draw = ImageDraw.Draw(im)
@@ -257,12 +215,7 @@ def test_chord(
 
 
 @pytest.mark.parametrize("bbox", BBOX)
-def test_chord_width(
-    bbox: tuple[tuple[int, int], tuple[int, int]]
-    | list[tuple[int, int]]
-    | list[int]
-    | tuple[int, int, int, int]
-) -> None:
+def test_chord_width(bbox: Sequence[int | Sequence[int]]) -> None:
     # Arrange
     im = Image.new("RGB", (W, H))
     draw = ImageDraw.Draw(im)
@@ -275,12 +228,7 @@ def test_chord_width(
 
 
 @pytest.mark.parametrize("bbox", BBOX)
-def test_chord_width_fill(
-    bbox: tuple[tuple[int, int], tuple[int, int]]
-    | list[tuple[int, int]]
-    | list[int]
-    | tuple[int, int, int, int]
-) -> None:
+def test_chord_width_fill(bbox: Sequence[int | Sequence[int]]) -> None:
     # Arrange
     im = Image.new("RGB", (W, H))
     draw = ImageDraw.Draw(im)
@@ -293,12 +241,7 @@ def test_chord_width_fill(
 
 
 @pytest.mark.parametrize("bbox", BBOX)
-def test_chord_zero_width(
-    bbox: tuple[tuple[int, int], tuple[int, int]]
-    | list[tuple[int, int]]
-    | list[int]
-    | tuple[int, int, int, int]
-) -> None:
+def test_chord_zero_width(bbox: Sequence[int | Sequence[int]]) -> None:
     # Arrange
     im = Image.new("RGB", (W, H))
     draw = ImageDraw.Draw(im)
@@ -324,13 +267,7 @@ def test_chord_too_fat() -> None:
 
 @pytest.mark.parametrize("mode", ("RGB", "L"))
 @pytest.mark.parametrize("bbox", BBOX)
-def test_ellipse(
-    mode: str,
-    bbox: tuple[tuple[int, int], tuple[int, int]]
-    | list[tuple[int, int]]
-    | list[int]
-    | tuple[int, int, int, int],
-) -> None:
+def test_ellipse(mode: str, bbox: Sequence[int | Sequence[int]]) -> None:
     # Arrange
     im = Image.new(mode, (W, H))
     draw = ImageDraw.Draw(im)
@@ -344,12 +281,7 @@ def test_ellipse(
 
 
 @pytest.mark.parametrize("bbox", BBOX)
-def test_ellipse_translucent(
-    bbox: tuple[tuple[int, int], tuple[int, int]]
-    | list[tuple[int, int]]
-    | list[int]
-    | tuple[int, int, int, int]
-) -> None:
+def test_ellipse_translucent(bbox: Sequence[int | Sequence[int]]) -> None:
     # Arrange
     im = Image.new("RGB", (W, H))
     draw = ImageDraw.Draw(im, "RGBA")
@@ -386,12 +318,7 @@ def test_ellipse_symmetric() -> None:
 
 
 @pytest.mark.parametrize("bbox", BBOX)
-def test_ellipse_width(
-    bbox: tuple[tuple[int, int], tuple[int, int]]
-    | list[tuple[int, int]]
-    | list[int]
-    | tuple[int, int, int, int]
-) -> None:
+def test_ellipse_width(bbox: Sequence[int | Sequence[int]]) -> None:
     # Arrange
     im = Image.new("RGB", (W, H))
     draw = ImageDraw.Draw(im)
@@ -416,12 +343,7 @@ def test_ellipse_width_large() -> None:
 
 
 @pytest.mark.parametrize("bbox", BBOX)
-def test_ellipse_width_fill(
-    bbox: tuple[tuple[int, int], tuple[int, int]]
-    | list[tuple[int, int]]
-    | list[int]
-    | tuple[int, int, int, int]
-) -> None:
+def test_ellipse_width_fill(bbox: Sequence[int | Sequence[int]]) -> None:
     # Arrange
     im = Image.new("RGB", (W, H))
     draw = ImageDraw.Draw(im)
@@ -434,12 +356,7 @@ def test_ellipse_width_fill(
 
 
 @pytest.mark.parametrize("bbox", BBOX)
-def test_ellipse_zero_width(
-    bbox: tuple[tuple[int, int], tuple[int, int]]
-    | list[tuple[int, int]]
-    | list[int]
-    | tuple[int, int, int, int]
-) -> None:
+def test_ellipse_zero_width(bbox: Sequence[int | Sequence[int]]) -> None:
     # Arrange
     im = Image.new("RGB", (W, H))
     draw = ImageDraw.Draw(im)
@@ -572,12 +489,7 @@ def test_transform() -> None:
 @pytest.mark.parametrize("bbox", BBOX)
 @pytest.mark.parametrize("start, end", ((-92, 46), (-92.2, 46.2)))
 def test_pieslice(
-    bbox: tuple[tuple[int, int], tuple[int, int]]
-    | list[tuple[int, int]]
-    | list[int]
-    | tuple[int, int, int, int],
-    start: float,
-    end: float,
+    bbox: Sequence[int | Sequence[int]], start: float, end: float
 ) -> None:
     # Arrange
     im = Image.new("RGB", (W, H))
@@ -591,12 +503,7 @@ def test_pieslice(
 
 
 @pytest.mark.parametrize("bbox", BBOX)
-def test_pieslice_width(
-    bbox: tuple[tuple[int, int], tuple[int, int]]
-    | list[tuple[int, int]]
-    | list[int]
-    | tuple[int, int, int, int]
-) -> None:
+def test_pieslice_width(bbox: Sequence[int | Sequence[int]]) -> None:
     # Arrange
     im = Image.new("RGB", (W, H))
     draw = ImageDraw.Draw(im)
@@ -609,12 +516,7 @@ def test_pieslice_width(
 
 
 @pytest.mark.parametrize("bbox", BBOX)
-def test_pieslice_width_fill(
-    bbox: tuple[tuple[int, int], tuple[int, int]]
-    | list[tuple[int, int]]
-    | list[int]
-    | tuple[int, int, int, int]
-) -> None:
+def test_pieslice_width_fill(bbox: Sequence[int | Sequence[int]]) -> None:
     # Arrange
     im = Image.new("RGB", (W, H))
     draw = ImageDraw.Draw(im)
@@ -628,12 +530,7 @@ def test_pieslice_width_fill(
 
 
 @pytest.mark.parametrize("bbox", BBOX)
-def test_pieslice_zero_width(
-    bbox: tuple[tuple[int, int], tuple[int, int]]
-    | list[tuple[int, int]]
-    | list[int]
-    | tuple[int, int, int, int]
-) -> None:
+def test_pieslice_zero_width(bbox: Sequence[int | Sequence[int]]) -> None:
     # Arrange
     im = Image.new("RGB", (W, H))
     draw = ImageDraw.Draw(im)
@@ -796,12 +693,7 @@ def test_polygon_translucent() -> None:
 
 
 @pytest.mark.parametrize("bbox", BBOX)
-def test_rectangle(
-    bbox: tuple[tuple[int, int], tuple[int, int]]
-    | list[tuple[int, int]]
-    | list[int]
-    | tuple[int, int, int, int]
-) -> None:
+def test_rectangle(bbox: Sequence[int | Sequence[int]]) -> None:
     # Arrange
     im = Image.new("RGB", (W, H))
     draw = ImageDraw.Draw(im)
@@ -828,12 +720,7 @@ def test_big_rectangle() -> None:
 
 
 @pytest.mark.parametrize("bbox", BBOX)
-def test_rectangle_width(
-    bbox: tuple[tuple[int, int], tuple[int, int]]
-    | list[tuple[int, int]]
-    | list[int]
-    | tuple[int, int, int, int]
-) -> None:
+def test_rectangle_width(bbox: Sequence[int | Sequence[int]]) -> None:
     # Arrange
     im = Image.new("RGB", (W, H))
     draw = ImageDraw.Draw(im)
@@ -847,12 +734,7 @@ def test_rectangle_width(
 
 
 @pytest.mark.parametrize("bbox", BBOX)
-def test_rectangle_width_fill(
-    bbox: tuple[tuple[int, int], tuple[int, int]]
-    | list[tuple[int, int]]
-    | list[int]
-    | tuple[int, int, int, int]
-) -> None:
+def test_rectangle_width_fill(bbox: Sequence[int | Sequence[int]]) -> None:
     # Arrange
     im = Image.new("RGB", (W, H))
     draw = ImageDraw.Draw(im)
@@ -866,12 +748,7 @@ def test_rectangle_width_fill(
 
 
 @pytest.mark.parametrize("bbox", BBOX)
-def test_rectangle_zero_width(
-    bbox: tuple[tuple[int, int], tuple[int, int]]
-    | list[tuple[int, int]]
-    | list[int]
-    | tuple[int, int, int, int]
-) -> None:
+def test_rectangle_zero_width(bbox: Sequence[int | Sequence[int]]) -> None:
     # Arrange
     im = Image.new("RGB", (W, H))
     draw = ImageDraw.Draw(im)
@@ -884,12 +761,7 @@ def test_rectangle_zero_width(
 
 
 @pytest.mark.parametrize("bbox", BBOX)
-def test_rectangle_I16(
-    bbox: tuple[tuple[int, int], tuple[int, int]]
-    | list[tuple[int, int]]
-    | list[int]
-    | tuple[int, int, int, int]
-) -> None:
+def test_rectangle_I16(bbox: Sequence[int | Sequence[int]]) -> None:
     # Arrange
     im = Image.new("I;16", (W, H))
     draw = ImageDraw.Draw(im)
@@ -902,12 +774,7 @@ def test_rectangle_I16(
 
 
 @pytest.mark.parametrize("bbox", BBOX)
-def test_rectangle_translucent_outline(
-    bbox: tuple[tuple[int, int], tuple[int, int]]
-    | list[tuple[int, int]]
-    | list[int]
-    | tuple[int, int, int, int]
-) -> None:
+def test_rectangle_translucent_outline(bbox: Sequence[int | Sequence[int]]) -> None:
     # Arrange
     im = Image.new("RGB", (W, H))
     draw = ImageDraw.Draw(im, "RGBA")
@@ -999,12 +866,7 @@ def test_rounded_rectangle_non_integer_radius(
 
 
 @pytest.mark.parametrize("bbox", BBOX)
-def test_rounded_rectangle_zero_radius(
-    bbox: tuple[tuple[int, int], tuple[int, int]]
-    | list[tuple[int, int]]
-    | list[int]
-    | tuple[int, int, int, int]
-) -> None:
+def test_rounded_rectangle_zero_radius(bbox: Sequence[int | Sequence[int]]) -> None:
     # Arrange
     im = Image.new("RGB", (W, H))
     draw = ImageDraw.Draw(im)
@@ -1045,12 +907,7 @@ def test_rounded_rectangle_translucent(
 
 
 @pytest.mark.parametrize("bbox", BBOX)
-def test_floodfill(
-    bbox: tuple[tuple[int, int], tuple[int, int]]
-    | list[tuple[int, int]]
-    | list[int]
-    | tuple[int, int, int, int]
-) -> None:
+def test_floodfill(bbox: Sequence[int | Sequence[int]]) -> None:
     red = ImageColor.getrgb("red")
 
     for mode, value in [("L", 1), ("RGBA", (255, 0, 0, 0)), ("RGB", red)]:
@@ -1083,12 +940,7 @@ def test_floodfill(
 
 
 @pytest.mark.parametrize("bbox", BBOX)
-def test_floodfill_border(
-    bbox: tuple[tuple[int, int], tuple[int, int]]
-    | list[tuple[int, int]]
-    | list[int]
-    | tuple[int, int, int, int]
-) -> None:
+def test_floodfill_border(bbox: Sequence[int | Sequence[int]]) -> None:
     # floodfill() is experimental
 
     # Arrange
@@ -1110,12 +962,7 @@ def test_floodfill_border(
 
 
 @pytest.mark.parametrize("bbox", BBOX)
-def test_floodfill_thresh(
-    bbox: tuple[tuple[int, int], tuple[int, int]]
-    | list[tuple[int, int]]
-    | list[int]
-    | tuple[int, int, int, int]
-) -> None:
+def test_floodfill_thresh(bbox: Sequence[int | Sequence[int]]) -> None:
     # floodfill() is experimental
 
     # Arrange
@@ -1572,12 +1419,7 @@ def test_default_font_size() -> None:
 
 
 @pytest.mark.parametrize("bbox", BBOX)
-def test_same_color_outline(
-    bbox: tuple[tuple[int, int], tuple[int, int]]
-    | list[tuple[int, int]]
-    | list[int]
-    | tuple[int, int, int, int]
-) -> None:
+def test_same_color_outline(bbox: Sequence[int | Sequence[int]]) -> None:
     # Prepare shape
     x0, y0 = 5, 5
     x1, y1 = 5, 50

From 8d96e3bc590ec9c003efc47ad35295d7de4ed95c Mon Sep 17 00:00:00 2001
From: Andrew Murray <radarhere@users.noreply.github.com>
Date: Fri, 2 Feb 2024 23:54:31 +1100
Subject: [PATCH 0155/1178] Changed name of first _Tile parameter

---
 src/PIL/ImageFile.py | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/src/PIL/ImageFile.py b/src/PIL/ImageFile.py
index 5ba5a6f8277..487f53efe1f 100644
--- a/src/PIL/ImageFile.py
+++ b/src/PIL/ImageFile.py
@@ -91,7 +91,7 @@ def _tilesort(t):
 
 
 class _Tile(NamedTuple):
-    encoder_name: str
+    codec_name: str
     extents: tuple[int, int, int, int]
     offset: int
     args: tuple[Any, ...] | str | None

From 6207ad419640475440de2f57c710e1a6235dfe90 Mon Sep 17 00:00:00 2001
From: "renovate[bot]" <29139614+renovate[bot]@users.noreply.github.com>
Date: Sat, 3 Feb 2024 02:24:17 +0000
Subject: [PATCH 0156/1178] Update release-drafter/release-drafter action to v6

---
 .github/workflows/release-drafter.yml | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/.github/workflows/release-drafter.yml b/.github/workflows/release-drafter.yml
index 8fc7bd3799d..a8ddef22c86 100644
--- a/.github/workflows/release-drafter.yml
+++ b/.github/workflows/release-drafter.yml
@@ -23,6 +23,6 @@ jobs:
     runs-on: ubuntu-latest
     steps:
       # Drafts your next release notes as pull requests are merged into "main"
-      - uses: release-drafter/release-drafter@v5
+      - uses: release-drafter/release-drafter@v6
         env:
           GITHUB_TOKEN: ${{ secrets.GITHUB_TOKEN }}

From dba7dea3263dfa3252f7381307323477531646c8 Mon Sep 17 00:00:00 2001
From: Hugo van Kemenade <1324225+hugovk@users.noreply.github.com>
Date: Sat, 3 Feb 2024 14:43:04 +0200
Subject: [PATCH 0157/1178] Pin codecov/codecov-action to v3.1.5

---
 .github/workflows/test-cygwin.yml  | 2 +-
 .github/workflows/test-docker.yml  | 2 +-
 .github/workflows/test-mingw.yml   | 2 +-
 .github/workflows/test-windows.yml | 2 +-
 .github/workflows/test.yml         | 2 +-
 5 files changed, 5 insertions(+), 5 deletions(-)

diff --git a/.github/workflows/test-cygwin.yml b/.github/workflows/test-cygwin.yml
index 7bbe5a37f50..a6b2935a921 100644
--- a/.github/workflows/test-cygwin.yml
+++ b/.github/workflows/test-cygwin.yml
@@ -142,7 +142,7 @@ jobs:
           bash.exe .ci/after_success.sh
 
       - name: Upload coverage
-        uses: codecov/codecov-action@v4
+        uses: codecov/codecov-action@v3.1.5
         with:
           file: ./coverage.xml
           flags: GHA_Cygwin
diff --git a/.github/workflows/test-docker.yml b/.github/workflows/test-docker.yml
index 75aab9bd489..f40286fe434 100644
--- a/.github/workflows/test-docker.yml
+++ b/.github/workflows/test-docker.yml
@@ -101,7 +101,7 @@ jobs:
         MATRIX_DOCKER: ${{ matrix.docker }}
 
     - name: Upload coverage
-      uses: codecov/codecov-action@v4
+      uses: codecov/codecov-action@v3.1.5
       with:
         flags: GHA_Docker
         name: ${{ matrix.docker }}
diff --git a/.github/workflows/test-mingw.yml b/.github/workflows/test-mingw.yml
index acea78c37d9..1c6d15b77d7 100644
--- a/.github/workflows/test-mingw.yml
+++ b/.github/workflows/test-mingw.yml
@@ -82,7 +82,7 @@ jobs:
           python3 -m pytest -vx --cov PIL --cov Tests --cov-report term --cov-report xml Tests
 
       - name: Upload coverage
-        uses: codecov/codecov-action@v4
+        uses: codecov/codecov-action@v3.1.5
         with:
           file: ./coverage.xml
           flags: GHA_Windows
diff --git a/.github/workflows/test-windows.yml b/.github/workflows/test-windows.yml
index b737615ca4b..75fccf7959a 100644
--- a/.github/workflows/test-windows.yml
+++ b/.github/workflows/test-windows.yml
@@ -202,7 +202,7 @@ jobs:
       shell: pwsh
 
     - name: Upload coverage
-      uses: codecov/codecov-action@v4
+      uses: codecov/codecov-action@v3.1.5
       with:
         file: ./coverage.xml
         flags: GHA_Windows
diff --git a/.github/workflows/test.yml b/.github/workflows/test.yml
index 038bcfbc35a..19f4a6daedc 100644
--- a/.github/workflows/test.yml
+++ b/.github/workflows/test.yml
@@ -149,7 +149,7 @@ jobs:
         .ci/after_success.sh
 
     - name: Upload coverage
-      uses: codecov/codecov-action@v4
+      uses: codecov/codecov-action@v3.1.5
       with:
         flags: ${{ matrix.os == 'ubuntu-latest' && 'GHA_Ubuntu' || 'GHA_macOS' }}
         name: ${{ matrix.os }} Python ${{ matrix.python-version }}

From 435c884ebbee326daf55599c6248028684206cc4 Mon Sep 17 00:00:00 2001
From: Andrew Murray <radarhere@users.noreply.github.com>
Date: Sat, 3 Feb 2024 23:44:33 +1100
Subject: [PATCH 0158/1178] Removed platform argument from setup-cygwin action

---
 .github/workflows/test-cygwin.yml | 1 -
 1 file changed, 1 deletion(-)

diff --git a/.github/workflows/test-cygwin.yml b/.github/workflows/test-cygwin.yml
index 7bbe5a37f50..4b958e889bb 100644
--- a/.github/workflows/test-cygwin.yml
+++ b/.github/workflows/test-cygwin.yml
@@ -49,7 +49,6 @@ jobs:
       - name: Install Cygwin
         uses: egor-tensin/setup-cygwin@v4
         with:
-          platform: x86_64
           packages: >
             gcc-g++
             ghostscript

From 1b6723967440cf8474a9bd1e1c394c90c5c2f986 Mon Sep 17 00:00:00 2001
From: Andrew Murray <radarhere@users.noreply.github.com>
Date: Mon, 5 Feb 2024 11:56:55 +1100
Subject: [PATCH 0159/1178] Update CHANGES.rst [ci skip]

---
 CHANGES.rst | 6 ++++++
 1 file changed, 6 insertions(+)

diff --git a/CHANGES.rst b/CHANGES.rst
index 7d80eec0345..a8404260ff3 100644
--- a/CHANGES.rst
+++ b/CHANGES.rst
@@ -5,6 +5,12 @@ Changelog (Pillow)
 10.3.0 (unreleased)
 -------------------
 
+- Update wl-paste handling and return None for some errors in grabclipboard() on Linux #7745
+  [nik012003, radarhere]
+
+- Remove execute bit from ``setup.py`` #7760
+  [hugovk]
+
 - Do not support using test-image-results to upload images after test failures #7739
   [radarhere]
 

From dfb48ff297aa2b227a98f20ff0ae5a0009644ad3 Mon Sep 17 00:00:00 2001
From: Andrew Murray <radarhere@users.noreply.github.com>
Date: Mon, 5 Feb 2024 19:16:15 +1100
Subject: [PATCH 0160/1178] Match mask size to pasted image size

---
 Tests/test_file_gif.py    | 15 +++++++++++++++
 src/PIL/GifImagePlugin.py |  4 +---
 2 files changed, 16 insertions(+), 3 deletions(-)

diff --git a/Tests/test_file_gif.py b/Tests/test_file_gif.py
index 3f550fd1109..263c897ef51 100644
--- a/Tests/test_file_gif.py
+++ b/Tests/test_file_gif.py
@@ -1105,6 +1105,21 @@ def im_generator(ims):
         assert reread.n_frames == 10
 
 
+def test_append_different_size_image(tmp_path: Path) -> None:
+    out = str(tmp_path / "temp.gif")
+
+    im = Image.new("RGB", (100, 100))
+    bigger_im = Image.new("RGB", (200, 200), "#f00")
+
+    im.save(out, save_all=True, append_images=[bigger_im])
+
+    with Image.open(out) as reread:
+        assert reread.size == (100, 100)
+
+        reread.seek(1)
+        assert reread.size == (100, 100)
+
+
 def test_transparent_optimize(tmp_path: Path) -> None:
     # From issue #2195, if the transparent color is incorrectly optimized out, GIF loses
     # transparency.
diff --git a/src/PIL/GifImagePlugin.py b/src/PIL/GifImagePlugin.py
index 57d87078bca..935b95ca8c6 100644
--- a/src/PIL/GifImagePlugin.py
+++ b/src/PIL/GifImagePlugin.py
@@ -649,9 +649,7 @@ def _write_multiple_frames(im, fp, palette):
                     if "transparency" in encoderinfo:
                         # When the delta is zero, fill the image with transparency
                         diff_frame = im_frame.copy()
-                        fill = Image.new(
-                            "P", diff_frame.size, encoderinfo["transparency"]
-                        )
+                        fill = Image.new("P", delta.size, encoderinfo["transparency"])
                         if delta.mode == "RGBA":
                             r, g, b, a = delta.split()
                             mask = ImageMath.eval(

From 5a8e7dda79e5ee4d0f8436179f61881a5d8bd286 Mon Sep 17 00:00:00 2001
From: Andrew Murray <radarhere@users.noreply.github.com>
Date: Mon, 5 Feb 2024 20:36:34 +1100
Subject: [PATCH 0161/1178] Added type hints

---
 Tests/test_imagedraw.py |  2 +-
 src/PIL/Image.py        |  2 +-
 src/PIL/ImageDraw.py    | 73 +++++++++++++++++++++--------------------
 src/PIL/ImageFont.py    |  2 +-
 4 files changed, 40 insertions(+), 39 deletions(-)

diff --git a/Tests/test_imagedraw.py b/Tests/test_imagedraw.py
index 6e7dce420d2..4503a929280 100644
--- a/Tests/test_imagedraw.py
+++ b/Tests/test_imagedraw.py
@@ -1519,7 +1519,7 @@ def test_compute_regular_polygon_vertices(
     [
         (None, (50, 50, 25), 0, TypeError, "n_sides should be an int"),
         (1, (50, 50, 25), 0, ValueError, "n_sides should be an int > 2"),
-        (3, 50, 0, TypeError, "bounding_circle should be a tuple"),
+        (3, 50, 0, TypeError, "bounding_circle should be a sequence"),
         (
             3,
             (50, 50, 100, 100),
diff --git a/src/PIL/Image.py b/src/PIL/Image.py
index 553f36703b3..111d060129e 100644
--- a/src/PIL/Image.py
+++ b/src/PIL/Image.py
@@ -571,7 +571,7 @@ def close(self):
         # object is gone.
         self.im = DeferredError(ValueError("Operation on closed image"))
 
-    def _copy(self):
+    def _copy(self) -> None:
         self.load()
         self.im = self.im.copy()
         self.pyaccess = None
diff --git a/src/PIL/ImageDraw.py b/src/PIL/ImageDraw.py
index 84665f54fff..650e3085763 100644
--- a/src/PIL/ImageDraw.py
+++ b/src/PIL/ImageDraw.py
@@ -48,7 +48,7 @@
 class ImageDraw:
     font = None
 
-    def __init__(self, im, mode=None):
+    def __init__(self, im: Image.Image, mode: str | None = None) -> None:
         """
         Create a drawing instance.
 
@@ -115,7 +115,7 @@ def getfont(self):
             self.font = ImageFont.load_default()
         return self.font
 
-    def _getfont(self, font_size):
+    def _getfont(self, font_size: float | None):
         if font_size is not None:
             from . import ImageFont
 
@@ -124,7 +124,7 @@ def _getfont(self, font_size):
             font = self.getfont()
         return font
 
-    def _getink(self, ink, fill=None):
+    def _getink(self, ink, fill=None) -> tuple[int | None, int | None]:
         if ink is None and fill is None:
             if self.fill:
                 fill = self.ink
@@ -145,13 +145,13 @@ def _getink(self, ink, fill=None):
                 fill = self.draw.draw_ink(fill)
         return ink, fill
 
-    def arc(self, xy, start, end, fill=None, width=1):
+    def arc(self, xy, start, end, fill=None, width=1) -> None:
         """Draw an arc."""
         ink, fill = self._getink(fill)
         if ink is not None:
             self.draw.draw_arc(xy, start, end, ink, width)
 
-    def bitmap(self, xy, bitmap, fill=None):
+    def bitmap(self, xy, bitmap, fill=None) -> None:
         """Draw a bitmap."""
         bitmap.load()
         ink, fill = self._getink(fill)
@@ -160,7 +160,7 @@ def bitmap(self, xy, bitmap, fill=None):
         if ink is not None:
             self.draw.draw_bitmap(xy, bitmap.im, ink)
 
-    def chord(self, xy, start, end, fill=None, outline=None, width=1):
+    def chord(self, xy, start, end, fill=None, outline=None, width=1) -> None:
         """Draw a chord."""
         ink, fill = self._getink(outline, fill)
         if fill is not None:
@@ -168,7 +168,7 @@ def chord(self, xy, start, end, fill=None, outline=None, width=1):
         if ink is not None and ink != fill and width != 0:
             self.draw.draw_chord(xy, start, end, ink, 0, width)
 
-    def ellipse(self, xy, fill=None, outline=None, width=1):
+    def ellipse(self, xy, fill=None, outline=None, width=1) -> None:
         """Draw an ellipse."""
         ink, fill = self._getink(outline, fill)
         if fill is not None:
@@ -176,7 +176,7 @@ def ellipse(self, xy, fill=None, outline=None, width=1):
         if ink is not None and ink != fill and width != 0:
             self.draw.draw_ellipse(xy, ink, 0, width)
 
-    def line(self, xy, fill=None, width=0, joint=None):
+    def line(self, xy, fill=None, width=0, joint=None) -> None:
         """Draw a line, or a connected sequence of line segments."""
         ink = self._getink(fill)[0]
         if ink is not None:
@@ -236,7 +236,7 @@ def coord_at_angle(coord, angle):
                             ]
                         self.line(gap_coords, fill, width=3)
 
-    def shape(self, shape, fill=None, outline=None):
+    def shape(self, shape, fill=None, outline=None) -> None:
         """(Experimental) Draw a shape."""
         shape.close()
         ink, fill = self._getink(outline, fill)
@@ -245,7 +245,7 @@ def shape(self, shape, fill=None, outline=None):
         if ink is not None and ink != fill:
             self.draw.draw_outline(shape, ink, 0)
 
-    def pieslice(self, xy, start, end, fill=None, outline=None, width=1):
+    def pieslice(self, xy, start, end, fill=None, outline=None, width=1) -> None:
         """Draw a pieslice."""
         ink, fill = self._getink(outline, fill)
         if fill is not None:
@@ -253,13 +253,13 @@ def pieslice(self, xy, start, end, fill=None, outline=None, width=1):
         if ink is not None and ink != fill and width != 0:
             self.draw.draw_pieslice(xy, start, end, ink, 0, width)
 
-    def point(self, xy, fill=None):
+    def point(self, xy, fill=None) -> None:
         """Draw one or more individual pixels."""
         ink, fill = self._getink(fill)
         if ink is not None:
             self.draw.draw_points(xy, ink)
 
-    def polygon(self, xy, fill=None, outline=None, width=1):
+    def polygon(self, xy, fill=None, outline=None, width=1) -> None:
         """Draw a polygon."""
         ink, fill = self._getink(outline, fill)
         if fill is not None:
@@ -267,7 +267,7 @@ def polygon(self, xy, fill=None, outline=None, width=1):
         if ink is not None and ink != fill and width != 0:
             if width == 1:
                 self.draw.draw_polygon(xy, ink, 0, width)
-            else:
+            elif self.im is not None:
                 # To avoid expanding the polygon outwards,
                 # use the fill as a mask
                 mask = Image.new("1", self.im.size)
@@ -291,12 +291,12 @@ def polygon(self, xy, fill=None, outline=None, width=1):
 
     def regular_polygon(
         self, bounding_circle, n_sides, rotation=0, fill=None, outline=None, width=1
-    ):
+    ) -> None:
         """Draw a regular polygon."""
         xy = _compute_regular_polygon_vertices(bounding_circle, n_sides, rotation)
         self.polygon(xy, fill, outline, width)
 
-    def rectangle(self, xy, fill=None, outline=None, width=1):
+    def rectangle(self, xy, fill=None, outline=None, width=1) -> None:
         """Draw a rectangle."""
         ink, fill = self._getink(outline, fill)
         if fill is not None:
@@ -306,7 +306,7 @@ def rectangle(self, xy, fill=None, outline=None, width=1):
 
     def rounded_rectangle(
         self, xy, radius=0, fill=None, outline=None, width=1, *, corners=None
-    ):
+    ) -> None:
         """Draw a rounded rectangle."""
         if isinstance(xy[0], (list, tuple)):
             (x0, y0), (x1, y1) = xy
@@ -346,7 +346,7 @@ def rounded_rectangle(
         r = d // 2
         ink, fill = self._getink(outline, fill)
 
-        def draw_corners(pieslice):
+        def draw_corners(pieslice) -> None:
             if full_x:
                 # Draw top and bottom halves
                 parts = (
@@ -431,12 +431,12 @@ def draw_corners(pieslice):
                     right[3] -= r + 1
                 self.draw.draw_rectangle(right, ink, 1)
 
-    def _multiline_check(self, text):
+    def _multiline_check(self, text) -> bool:
         split_character = "\n" if isinstance(text, str) else b"\n"
 
         return split_character in text
 
-    def _multiline_split(self, text):
+    def _multiline_split(self, text) -> list[str | bytes]:
         split_character = "\n" if isinstance(text, str) else b"\n"
 
         return text.split(split_character)
@@ -465,7 +465,7 @@ def text(
         embedded_color=False,
         *args,
         **kwargs,
-    ):
+    ) -> None:
         """Draw text."""
         if embedded_color and self.mode not in ("RGB", "RGBA"):
             msg = "Embedded color supported only in RGB and RGBA modes"
@@ -497,7 +497,7 @@ def getink(fill):
                 return fill
             return ink
 
-        def draw_text(ink, stroke_width=0, stroke_offset=None):
+        def draw_text(ink, stroke_width=0, stroke_offset=None) -> None:
             mode = self.fontmode
             if stroke_width == 0 and embedded_color:
                 mode = "RGBA"
@@ -547,7 +547,8 @@ def draw_text(ink, stroke_width=0, stroke_offset=None):
                 ink_alpha = struct.pack("i", ink)[3]
                 color.fillband(3, ink_alpha)
                 x, y = coord
-                self.im.paste(color, (x, y, x + mask.size[0], y + mask.size[1]), mask)
+                if self.im is not None:
+                    self.im.paste(color, (x, y, x + mask.size[0], y + mask.size[1]), mask)
             else:
                 self.draw.draw_bitmap(coord, mask, ink)
 
@@ -584,7 +585,7 @@ def multiline_text(
         embedded_color=False,
         *,
         font_size=None,
-    ):
+    ) -> None:
         if direction == "ttb":
             msg = "ttb direction is unsupported for multiline text"
             raise ValueError(msg)
@@ -693,7 +694,7 @@ def textbbox(
         embedded_color=False,
         *,
         font_size=None,
-    ):
+    ) -> tuple[int, int, int, int]:
         """Get the bounding box of a given string, in pixels."""
         if embedded_color and self.mode not in ("RGB", "RGBA"):
             msg = "Embedded color supported only in RGB and RGBA modes"
@@ -738,7 +739,7 @@ def multiline_textbbox(
         embedded_color=False,
         *,
         font_size=None,
-    ):
+    ) -> tuple[int, int, int, int]:
         if direction == "ttb":
             msg = "ttb direction is unsupported for multiline text"
             raise ValueError(msg)
@@ -777,7 +778,7 @@ def multiline_textbbox(
         elif anchor[1] == "d":
             top -= (len(lines) - 1) * line_spacing
 
-        bbox = None
+        bbox: tuple[int, int, int, int] | None = None
 
         for idx, line in enumerate(lines):
             left = xy[0]
@@ -828,7 +829,7 @@ def multiline_textbbox(
         return bbox
 
 
-def Draw(im, mode=None):
+def Draw(im: Image.Image, mode: str | None = None) -> ImageDraw:
     """
     A simple 2D drawing interface for PIL images.
 
@@ -876,7 +877,7 @@ def getdraw(im=None, hints=None):
     return im, handler
 
 
-def floodfill(image, xy, value, border=None, thresh=0):
+def floodfill(image: Image.Image, xy, value, border=None, thresh=0) -> None:
     """
     (experimental) Fills a bounded region with a given color.
 
@@ -932,7 +933,7 @@ def floodfill(image, xy, value, border=None, thresh=0):
         edge = new_edge
 
 
-def _compute_regular_polygon_vertices(bounding_circle, n_sides, rotation):
+def _compute_regular_polygon_vertices(bounding_circle, n_sides, rotation) -> list[tuple[float, float]]:
     """
     Generate a list of vertices for a 2D regular polygon.
 
@@ -982,7 +983,7 @@ def _compute_regular_polygon_vertices(bounding_circle, n_sides, rotation):
 
     # 1.2 Check `bounding_circle` has an appropriate value
     if not isinstance(bounding_circle, (list, tuple)):
-        msg = "bounding_circle should be a tuple"
+        msg = "bounding_circle should be a sequence"
         raise TypeError(msg)
 
     if len(bounding_circle) == 3:
@@ -1014,7 +1015,7 @@ def _compute_regular_polygon_vertices(bounding_circle, n_sides, rotation):
         raise ValueError(msg)
 
     # 2. Define Helper Functions
-    def _apply_rotation(point, degrees, centroid):
+    def _apply_rotation(point: list[float], degrees: float) -> tuple[int, int]:
         return (
             round(
                 point[0] * math.cos(math.radians(360 - degrees))
@@ -1030,11 +1031,11 @@ def _apply_rotation(point, degrees, centroid):
             ),
         )
 
-    def _compute_polygon_vertex(centroid, polygon_radius, angle):
+    def _compute_polygon_vertex(angle: float) -> tuple[int, int]:
         start_point = [polygon_radius, 0]
-        return _apply_rotation(start_point, angle, centroid)
+        return _apply_rotation(start_point, angle)
 
-    def _get_angles(n_sides, rotation):
+    def _get_angles(n_sides: int, rotation: float) -> list[float]:
         angles = []
         degrees = 360 / n_sides
         # Start with the bottom left polygon vertex
@@ -1051,11 +1052,11 @@ def _get_angles(n_sides, rotation):
 
     # 4. Compute Vertices
     return [
-        _compute_polygon_vertex(centroid, polygon_radius, angle) for angle in angles
+        _compute_polygon_vertex(angle) for angle in angles
     ]
 
 
-def _color_diff(color1, color2):
+def _color_diff(color1, color2: float | tuple[int, ...]) -> float:
     """
     Uses 1-norm distance to calculate difference between two values.
     """
diff --git a/src/PIL/ImageFont.py b/src/PIL/ImageFont.py
index a63b73b33f5..1ec8a9f4d1f 100644
--- a/src/PIL/ImageFont.py
+++ b/src/PIL/ImageFont.py
@@ -872,7 +872,7 @@ def load_path(filename):
     raise OSError(msg)
 
 
-def load_default(size=None):
+def load_default(size: float | None = None) -> FreeTypeFont | ImageFont:
     """If FreeType support is available, load a version of Aileron Regular,
     https://dotcolon.net/font/aileron, with a more limited character set.
 

From e0da2b71206c8c06ff4a9f67d6dade6973a7ae96 Mon Sep 17 00:00:00 2001
From: "pre-commit-ci[bot]"
 <66853113+pre-commit-ci[bot]@users.noreply.github.com>
Date: Mon, 5 Feb 2024 17:18:25 +0000
Subject: [PATCH 0162/1178] [pre-commit.ci] pre-commit autoupdate
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit

updates:
- [github.com/astral-sh/ruff-pre-commit: v0.1.9 → v0.2.0](https://github.com/astral-sh/ruff-pre-commit/compare/v0.1.9...v0.2.0)
- [github.com/psf/black-pre-commit-mirror: 23.12.1 → 24.1.1](https://github.com/psf/black-pre-commit-mirror/compare/23.12.1...24.1.1)
- [github.com/PyCQA/bandit: 1.7.6 → 1.7.7](https://github.com/PyCQA/bandit/compare/1.7.6...1.7.7)
- [github.com/tox-dev/pyproject-fmt: 1.5.3 → 1.7.0](https://github.com/tox-dev/pyproject-fmt/compare/1.5.3...1.7.0)
- [github.com/abravalheri/validate-pyproject: v0.15 → v0.16](https://github.com/abravalheri/validate-pyproject/compare/v0.15...v0.16)
---
 .pre-commit-config.yaml | 10 +++++-----
 1 file changed, 5 insertions(+), 5 deletions(-)

diff --git a/.pre-commit-config.yaml b/.pre-commit-config.yaml
index 5ce0c9a1792..c52fdcb552d 100644
--- a/.pre-commit-config.yaml
+++ b/.pre-commit-config.yaml
@@ -1,17 +1,17 @@
 repos:
   - repo: https://github.com/astral-sh/ruff-pre-commit
-    rev: v0.1.9
+    rev: v0.2.0
     hooks:
       - id: ruff
         args: [--fix, --exit-non-zero-on-fix]
 
   - repo: https://github.com/psf/black-pre-commit-mirror
-    rev: 23.12.1
+    rev: 24.1.1
     hooks:
       - id: black
 
   - repo: https://github.com/PyCQA/bandit
-    rev: 1.7.6
+    rev: 1.7.7
     hooks:
     - id: bandit
       args: [--severity-level=high]
@@ -48,12 +48,12 @@ repos:
       - id: sphinx-lint
 
   - repo: https://github.com/tox-dev/pyproject-fmt
-    rev: 1.5.3
+    rev: 1.7.0
     hooks:
       - id: pyproject-fmt
 
   - repo: https://github.com/abravalheri/validate-pyproject
-    rev: v0.15
+    rev: v0.16
     hooks:
       - id: validate-pyproject
 

From 27b0cf67e784c0c9e58e60afd8ffa1ba274681c6 Mon Sep 17 00:00:00 2001
From: "pre-commit-ci[bot]"
 <66853113+pre-commit-ci[bot]@users.noreply.github.com>
Date: Mon, 5 Feb 2024 17:18:49 +0000
Subject: [PATCH 0163/1178] [pre-commit.ci] auto fixes from pre-commit.com
 hooks

for more information, see https://pre-commit.ci
---
 .github/workflows/system-info.py | 1 +
 Tests/helper.py                  | 1 +
 Tests/test_file_dds.py           | 1 +
 Tests/test_file_libtiff_small.py | 1 -
 Tests/test_image_access.py       | 4 +---
 Tests/test_image_resize.py       | 1 +
 Tests/test_imagecms.py           | 8 +++++---
 docs/example/DdsImagePlugin.py   | 1 +
 src/PIL/BlpImagePlugin.py        | 1 +
 src/PIL/DdsImagePlugin.py        | 1 +
 src/PIL/FontFile.py              | 4 +---
 src/PIL/FtexImagePlugin.py       | 1 +
 src/PIL/GifImagePlugin.py        | 6 +++---
 src/PIL/ImageCms.py              | 2 --
 src/PIL/JpegPresets.py           | 1 +
 src/PIL/PdfImagePlugin.py        | 6 +++---
 src/PIL/__init__.py              | 1 +
 src/PIL/_tkinter_finder.py       | 1 +
 18 files changed, 24 insertions(+), 18 deletions(-)

diff --git a/.github/workflows/system-info.py b/.github/workflows/system-info.py
index 57f28c620b7..9e97b897104 100644
--- a/.github/workflows/system-info.py
+++ b/.github/workflows/system-info.py
@@ -6,6 +6,7 @@
 Requested here:
 https://github.com/actions/virtual-environments/issues/79
 """
+
 from __future__ import annotations
 
 import os
diff --git a/Tests/helper.py b/Tests/helper.py
index b2e7d43dd67..3e2a40e02da 100644
--- a/Tests/helper.py
+++ b/Tests/helper.py
@@ -1,6 +1,7 @@
 """
 Helper functions.
 """
+
 from __future__ import annotations
 
 import logging
diff --git a/Tests/test_file_dds.py b/Tests/test_file_dds.py
index 09ee8986aca..b78a0dd8109 100644
--- a/Tests/test_file_dds.py
+++ b/Tests/test_file_dds.py
@@ -1,4 +1,5 @@
 """Test DdsImagePlugin"""
+
 from __future__ import annotations
 
 from io import BytesIO
diff --git a/Tests/test_file_libtiff_small.py b/Tests/test_file_libtiff_small.py
index ac5270eac30..617e1e89c72 100644
--- a/Tests/test_file_libtiff_small.py
+++ b/Tests/test_file_libtiff_small.py
@@ -9,7 +9,6 @@
 
 
 class TestFileLibTiffSmall(LibTiffTestCase):
-
     """The small lena image was failing on open in the libtiff
     decoder because the file pointer was set to the wrong place
     by a spurious seek. It wasn't failing with the byteio method.
diff --git a/Tests/test_image_access.py b/Tests/test_image_access.py
index 00cd4e7a9a1..e4cb2dad102 100644
--- a/Tests/test_image_access.py
+++ b/Tests/test_image_access.py
@@ -230,9 +230,7 @@ def test_list(self) -> None:
         assert im.getpixel([0, 0]) == (20, 20, 70)
 
     @pytest.mark.parametrize("mode", ("I;16", "I;16B"))
-    @pytest.mark.parametrize(
-        "expected_color", (2**15 - 1, 2**15, 2**15 + 1, 2**16 - 1)
-    )
+    @pytest.mark.parametrize("expected_color", (2**15 - 1, 2**15, 2**15 + 1, 2**16 - 1))
     def test_signedness(self, mode, expected_color) -> None:
         # see https://github.com/python-pillow/Pillow/issues/452
         # pixelaccess is using signed int* instead of uint*
diff --git a/Tests/test_image_resize.py b/Tests/test_image_resize.py
index bd45ee893ad..a64e4a84621 100644
--- a/Tests/test_image_resize.py
+++ b/Tests/test_image_resize.py
@@ -1,6 +1,7 @@
 """
 Tests for resize functionality.
 """
+
 from __future__ import annotations
 
 from itertools import permutations
diff --git a/Tests/test_imagecms.py b/Tests/test_imagecms.py
index 7f652715566..83fc38ed3fd 100644
--- a/Tests/test_imagecms.py
+++ b/Tests/test_imagecms.py
@@ -342,9 +342,11 @@ def assert_truncated_tuple_equal(tup1, tup2, digits: int = 10) -> None:
 
         def truncate_tuple(tuple_or_float):
             return tuple(
-                truncate_tuple(val)
-                if isinstance(val, tuple)
-                else int(val * power) / power
+                (
+                    truncate_tuple(val)
+                    if isinstance(val, tuple)
+                    else int(val * power) / power
+                )
                 for val in tuple_or_float
             )
 
diff --git a/docs/example/DdsImagePlugin.py b/docs/example/DdsImagePlugin.py
index e98bb86806f..2a2a0ba2961 100644
--- a/docs/example/DdsImagePlugin.py
+++ b/docs/example/DdsImagePlugin.py
@@ -9,6 +9,7 @@
 Full text of the CC0 license:
   https://creativecommons.org/publicdomain/zero/1.0/
 """
+
 from __future__ import annotations
 
 import struct
diff --git a/src/PIL/BlpImagePlugin.py b/src/PIL/BlpImagePlugin.py
index b8f38b78a2e..f0fbc8cc28a 100644
--- a/src/PIL/BlpImagePlugin.py
+++ b/src/PIL/BlpImagePlugin.py
@@ -28,6 +28,7 @@
   - DXT3 compression is used if alpha_encoding == 1.
   - DXT5 compression is used if alpha_encoding == 7.
 """
+
 from __future__ import annotations
 
 import os
diff --git a/src/PIL/DdsImagePlugin.py b/src/PIL/DdsImagePlugin.py
index eb4c8f557af..3785174ef65 100644
--- a/src/PIL/DdsImagePlugin.py
+++ b/src/PIL/DdsImagePlugin.py
@@ -9,6 +9,7 @@
 Full text of the CC0 license:
 https://creativecommons.org/publicdomain/zero/1.0/
 """
+
 from __future__ import annotations
 
 import io
diff --git a/src/PIL/FontFile.py b/src/PIL/FontFile.py
index 3ec1ae819fc..1e0c1c166b5 100644
--- a/src/PIL/FontFile.py
+++ b/src/PIL/FontFile.py
@@ -50,9 +50,7 @@ def __init__(self) -> None:
             | None
         ] = [None] * 256
 
-    def __getitem__(
-        self, ix: int
-    ) -> (
+    def __getitem__(self, ix: int) -> (
         tuple[
             tuple[int, int],
             tuple[int, int, int, int],
diff --git a/src/PIL/FtexImagePlugin.py b/src/PIL/FtexImagePlugin.py
index d5513a56a11..b4488e6ee9c 100644
--- a/src/PIL/FtexImagePlugin.py
+++ b/src/PIL/FtexImagePlugin.py
@@ -50,6 +50,7 @@
 
 Note: All data is stored in little-Endian (Intel) byte order.
 """
+
 from __future__ import annotations
 
 import struct
diff --git a/src/PIL/GifImagePlugin.py b/src/PIL/GifImagePlugin.py
index 57d87078bca..dc842d7a30b 100644
--- a/src/PIL/GifImagePlugin.py
+++ b/src/PIL/GifImagePlugin.py
@@ -641,9 +641,9 @@ def _write_multiple_frames(im, fp, palette):
                 if encoderinfo.get("optimize") and im_frame.mode != "1":
                     if "transparency" not in encoderinfo:
                         try:
-                            encoderinfo[
-                                "transparency"
-                            ] = im_frame.palette._new_color_index(im_frame)
+                            encoderinfo["transparency"] = (
+                                im_frame.palette._new_color_index(im_frame)
+                            )
                         except ValueError:
                             pass
                     if "transparency" in encoderinfo:
diff --git a/src/PIL/ImageCms.py b/src/PIL/ImageCms.py
index 3e40105e46a..2b0ed6c9d2f 100644
--- a/src/PIL/ImageCms.py
+++ b/src/PIL/ImageCms.py
@@ -281,7 +281,6 @@ def tobytes(self):
 
 
 class ImageCmsTransform(Image.ImagePointHandler):
-
     """
     Transform.  This can be used with the procedural API, or with the standard
     :py:func:`~PIL.Image.Image.point` method.
@@ -369,7 +368,6 @@ def get_display_profile(handle=None):
 
 
 class PyCMSError(Exception):
-
     """(pyCMS) Exception class.
     This is used for all errors in the pyCMS API."""
 
diff --git a/src/PIL/JpegPresets.py b/src/PIL/JpegPresets.py
index 9ecfdb2599a..d0e64a35ee1 100644
--- a/src/PIL/JpegPresets.py
+++ b/src/PIL/JpegPresets.py
@@ -62,6 +62,7 @@
 https://web.archive.org/web/20120328125543/http://www.jpegcameras.com/libjpeg/libjpeg-3.html
 
 """
+
 from __future__ import annotations
 
 # fmt: off
diff --git a/src/PIL/PdfImagePlugin.py b/src/PIL/PdfImagePlugin.py
index 3506aadce83..1777f1f20db 100644
--- a/src/PIL/PdfImagePlugin.py
+++ b/src/PIL/PdfImagePlugin.py
@@ -188,9 +188,9 @@ def _save(im, fp, filename, save_all=False):
         x_resolution = y_resolution = im.encoderinfo.get("resolution", 72.0)
 
     info = {
-        "title": None
-        if is_appending
-        else os.path.splitext(os.path.basename(filename))[0],
+        "title": (
+            None if is_appending else os.path.splitext(os.path.basename(filename))[0]
+        ),
         "author": None,
         "subject": None,
         "keywords": None,
diff --git a/src/PIL/__init__.py b/src/PIL/__init__.py
index 3fcac8643cb..63a45769ba6 100644
--- a/src/PIL/__init__.py
+++ b/src/PIL/__init__.py
@@ -12,6 +12,7 @@
 
 ;-)
 """
+
 from __future__ import annotations
 
 from . import _version
diff --git a/src/PIL/_tkinter_finder.py b/src/PIL/_tkinter_finder.py
index 03a6eba44ff..71c0ad4651b 100644
--- a/src/PIL/_tkinter_finder.py
+++ b/src/PIL/_tkinter_finder.py
@@ -1,5 +1,6 @@
 """ Find compiled module linking to Tcl / Tk libraries
 """
+
 from __future__ import annotations
 
 import sys

From 1acaf20f7215c567f0ea04bf20c396a237a2a542 Mon Sep 17 00:00:00 2001
From: Hugo van Kemenade <1324225+hugovk@users.noreply.github.com>
Date: Mon, 5 Feb 2024 20:37:45 +0200
Subject: [PATCH 0164/1178] Enable LOG rules for Ruff linter

---
 pyproject.toml | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/pyproject.toml b/pyproject.toml
index b1ce9cf1d07..48257b750a4 100644
--- a/pyproject.toml
+++ b/pyproject.toml
@@ -104,12 +104,12 @@ select = [
   "F", # pyflakes errors
   "I", # isort
   "ISC", # flake8-implicit-str-concat
+  "LOG", # flake8-logging
   "PGH", # pygrep-hooks
   "RUF100", # unused noqa (yesqa)
   "UP", # pyupgrade
   "W", # pycodestyle warnings
   "YTT", # flake8-2020
-  # "LOG", # TODO: enable flake8-logging when it's not in preview anymore
 ]
 extend-ignore = [
   "E203", # Whitespace before ':'

From 3bcc7072d68d3d534f06938879cd6b2fa31e61b9 Mon Sep 17 00:00:00 2001
From: Hugo van Kemenade <1324225+hugovk@users.noreply.github.com>
Date: Mon, 5 Feb 2024 20:39:08 +0200
Subject: [PATCH 0165/1178] Move linter config from deprecated top-level to own
 section

---
 pyproject.toml | 6 +++---
 1 file changed, 3 insertions(+), 3 deletions(-)

diff --git a/pyproject.toml b/pyproject.toml
index 48257b750a4..d7b60ef17d2 100644
--- a/pyproject.toml
+++ b/pyproject.toml
@@ -96,7 +96,7 @@ config-settings = "raqm=enable raqm=vendor fribidi=vendor imagequant=disable"
 test-command = "cd {project} && .github/workflows/wheels-test.sh"
 test-extras = "tests"
 
-[tool.ruff]
+[tool.ruff.lint]
 select = [
   "C4", # flake8-comprehensions
   "E", # pycodestyle errors
@@ -118,11 +118,11 @@ extend-ignore = [
   "E241", # Multiple spaces after ','
 ]
 
-[tool.ruff.per-file-ignores]
+[tool.ruff.lint.per-file-ignores]
 "Tests/oss-fuzz/fuzz_font.py" = ["I002"]
 "Tests/oss-fuzz/fuzz_pillow.py" = ["I002"]
 
-[tool.ruff.isort]
+[tool.ruff.lint.isort]
 known-first-party = ["PIL"]
 required-imports = ["from __future__ import annotations"]
 

From 65cb0b0487c29c91f0145226e1cd173511bc3586 Mon Sep 17 00:00:00 2001
From: Andrew Murray <radarhere@users.noreply.github.com>
Date: Tue, 6 Feb 2024 07:49:43 +1100
Subject: [PATCH 0166/1178] Added _typing.Coords

---
 Tests/test_imagedraw.py | 87 +++++++++++++++++------------------------
 src/PIL/ImageDraw.py    | 87 ++++++++++++++++++++++++-----------------
 src/PIL/_typing.py      |  4 ++
 3 files changed, 91 insertions(+), 87 deletions(-)

diff --git a/Tests/test_imagedraw.py b/Tests/test_imagedraw.py
index 4503a929280..4e6cedcd15f 100644
--- a/Tests/test_imagedraw.py
+++ b/Tests/test_imagedraw.py
@@ -2,11 +2,11 @@
 
 import contextlib
 import os.path
-from typing import Sequence
 
 import pytest
 
 from PIL import Image, ImageColor, ImageDraw, ImageFont, features
+from PIL._typing import Coords
 
 from .helper import (
     assert_image_equal,
@@ -75,7 +75,7 @@ def test_mode_mismatch() -> None:
 
 @pytest.mark.parametrize("bbox", BBOX)
 @pytest.mark.parametrize("start, end", ((0, 180), (0.5, 180.4)))
-def test_arc(bbox: Sequence[int | Sequence[int]], start: float, end: float) -> None:
+def test_arc(bbox: Coords, start: float, end: float) -> None:
     # Arrange
     im = Image.new("RGB", (W, H))
     draw = ImageDraw.Draw(im)
@@ -88,7 +88,7 @@ def test_arc(bbox: Sequence[int | Sequence[int]], start: float, end: float) -> N
 
 
 @pytest.mark.parametrize("bbox", BBOX)
-def test_arc_end_le_start(bbox: Sequence[int | Sequence[int]]) -> None:
+def test_arc_end_le_start(bbox: Coords) -> None:
     # Arrange
     im = Image.new("RGB", (W, H))
     draw = ImageDraw.Draw(im)
@@ -103,7 +103,7 @@ def test_arc_end_le_start(bbox: Sequence[int | Sequence[int]]) -> None:
 
 
 @pytest.mark.parametrize("bbox", BBOX)
-def test_arc_no_loops(bbox: Sequence[int | Sequence[int]]) -> None:
+def test_arc_no_loops(bbox: Coords) -> None:
     # No need to go in loops
     # Arrange
     im = Image.new("RGB", (W, H))
@@ -119,7 +119,7 @@ def test_arc_no_loops(bbox: Sequence[int | Sequence[int]]) -> None:
 
 
 @pytest.mark.parametrize("bbox", BBOX)
-def test_arc_width(bbox: Sequence[int | Sequence[int]]) -> None:
+def test_arc_width(bbox: Coords) -> None:
     # Arrange
     im = Image.new("RGB", (W, H))
     draw = ImageDraw.Draw(im)
@@ -132,7 +132,7 @@ def test_arc_width(bbox: Sequence[int | Sequence[int]]) -> None:
 
 
 @pytest.mark.parametrize("bbox", BBOX)
-def test_arc_width_pieslice_large(bbox: Sequence[int | Sequence[int]]) -> None:
+def test_arc_width_pieslice_large(bbox: Coords) -> None:
     # Tests an arc with a large enough width that it is a pieslice
     # Arrange
     im = Image.new("RGB", (W, H))
@@ -146,7 +146,7 @@ def test_arc_width_pieslice_large(bbox: Sequence[int | Sequence[int]]) -> None:
 
 
 @pytest.mark.parametrize("bbox", BBOX)
-def test_arc_width_fill(bbox: Sequence[int | Sequence[int]]) -> None:
+def test_arc_width_fill(bbox: Coords) -> None:
     # Arrange
     im = Image.new("RGB", (W, H))
     draw = ImageDraw.Draw(im)
@@ -159,7 +159,7 @@ def test_arc_width_fill(bbox: Sequence[int | Sequence[int]]) -> None:
 
 
 @pytest.mark.parametrize("bbox", BBOX)
-def test_arc_width_non_whole_angle(bbox: Sequence[int | Sequence[int]]) -> None:
+def test_arc_width_non_whole_angle(bbox: Coords) -> None:
     # Arrange
     im = Image.new("RGB", (W, H))
     draw = ImageDraw.Draw(im)
@@ -201,7 +201,7 @@ def test_bitmap() -> None:
 
 @pytest.mark.parametrize("mode", ("RGB", "L"))
 @pytest.mark.parametrize("bbox", BBOX)
-def test_chord(mode: str, bbox: Sequence[int | Sequence[int]]) -> None:
+def test_chord(mode: str, bbox: Coords) -> None:
     # Arrange
     im = Image.new(mode, (W, H))
     draw = ImageDraw.Draw(im)
@@ -215,7 +215,7 @@ def test_chord(mode: str, bbox: Sequence[int | Sequence[int]]) -> None:
 
 
 @pytest.mark.parametrize("bbox", BBOX)
-def test_chord_width(bbox: Sequence[int | Sequence[int]]) -> None:
+def test_chord_width(bbox: Coords) -> None:
     # Arrange
     im = Image.new("RGB", (W, H))
     draw = ImageDraw.Draw(im)
@@ -228,7 +228,7 @@ def test_chord_width(bbox: Sequence[int | Sequence[int]]) -> None:
 
 
 @pytest.mark.parametrize("bbox", BBOX)
-def test_chord_width_fill(bbox: Sequence[int | Sequence[int]]) -> None:
+def test_chord_width_fill(bbox: Coords) -> None:
     # Arrange
     im = Image.new("RGB", (W, H))
     draw = ImageDraw.Draw(im)
@@ -241,7 +241,7 @@ def test_chord_width_fill(bbox: Sequence[int | Sequence[int]]) -> None:
 
 
 @pytest.mark.parametrize("bbox", BBOX)
-def test_chord_zero_width(bbox: Sequence[int | Sequence[int]]) -> None:
+def test_chord_zero_width(bbox: Coords) -> None:
     # Arrange
     im = Image.new("RGB", (W, H))
     draw = ImageDraw.Draw(im)
@@ -267,7 +267,7 @@ def test_chord_too_fat() -> None:
 
 @pytest.mark.parametrize("mode", ("RGB", "L"))
 @pytest.mark.parametrize("bbox", BBOX)
-def test_ellipse(mode: str, bbox: Sequence[int | Sequence[int]]) -> None:
+def test_ellipse(mode: str, bbox: Coords) -> None:
     # Arrange
     im = Image.new(mode, (W, H))
     draw = ImageDraw.Draw(im)
@@ -281,7 +281,7 @@ def test_ellipse(mode: str, bbox: Sequence[int | Sequence[int]]) -> None:
 
 
 @pytest.mark.parametrize("bbox", BBOX)
-def test_ellipse_translucent(bbox: Sequence[int | Sequence[int]]) -> None:
+def test_ellipse_translucent(bbox: Coords) -> None:
     # Arrange
     im = Image.new("RGB", (W, H))
     draw = ImageDraw.Draw(im, "RGBA")
@@ -318,7 +318,7 @@ def test_ellipse_symmetric() -> None:
 
 
 @pytest.mark.parametrize("bbox", BBOX)
-def test_ellipse_width(bbox: Sequence[int | Sequence[int]]) -> None:
+def test_ellipse_width(bbox: Coords) -> None:
     # Arrange
     im = Image.new("RGB", (W, H))
     draw = ImageDraw.Draw(im)
@@ -343,7 +343,7 @@ def test_ellipse_width_large() -> None:
 
 
 @pytest.mark.parametrize("bbox", BBOX)
-def test_ellipse_width_fill(bbox: Sequence[int | Sequence[int]]) -> None:
+def test_ellipse_width_fill(bbox: Coords) -> None:
     # Arrange
     im = Image.new("RGB", (W, H))
     draw = ImageDraw.Draw(im)
@@ -356,7 +356,7 @@ def test_ellipse_width_fill(bbox: Sequence[int | Sequence[int]]) -> None:
 
 
 @pytest.mark.parametrize("bbox", BBOX)
-def test_ellipse_zero_width(bbox: Sequence[int | Sequence[int]]) -> None:
+def test_ellipse_zero_width(bbox: Coords) -> None:
     # Arrange
     im = Image.new("RGB", (W, H))
     draw = ImageDraw.Draw(im)
@@ -410,12 +410,7 @@ def test_ellipse_various_sizes_filled() -> None:
 
 
 @pytest.mark.parametrize("points", POINTS)
-def test_line(
-    points: tuple[tuple[int, int], ...]
-    | list[tuple[int, int]]
-    | tuple[int, ...]
-    | list[int]
-) -> None:
+def test_line(points: Coords) -> None:
     # Arrange
     im = Image.new("RGB", (W, H))
     draw = ImageDraw.Draw(im)
@@ -488,9 +483,7 @@ def test_transform() -> None:
 
 @pytest.mark.parametrize("bbox", BBOX)
 @pytest.mark.parametrize("start, end", ((-92, 46), (-92.2, 46.2)))
-def test_pieslice(
-    bbox: Sequence[int | Sequence[int]], start: float, end: float
-) -> None:
+def test_pieslice(bbox: Coords, start: float, end: float) -> None:
     # Arrange
     im = Image.new("RGB", (W, H))
     draw = ImageDraw.Draw(im)
@@ -503,7 +496,7 @@ def test_pieslice(
 
 
 @pytest.mark.parametrize("bbox", BBOX)
-def test_pieslice_width(bbox: Sequence[int | Sequence[int]]) -> None:
+def test_pieslice_width(bbox: Coords) -> None:
     # Arrange
     im = Image.new("RGB", (W, H))
     draw = ImageDraw.Draw(im)
@@ -516,7 +509,7 @@ def test_pieslice_width(bbox: Sequence[int | Sequence[int]]) -> None:
 
 
 @pytest.mark.parametrize("bbox", BBOX)
-def test_pieslice_width_fill(bbox: Sequence[int | Sequence[int]]) -> None:
+def test_pieslice_width_fill(bbox: Coords) -> None:
     # Arrange
     im = Image.new("RGB", (W, H))
     draw = ImageDraw.Draw(im)
@@ -530,7 +523,7 @@ def test_pieslice_width_fill(bbox: Sequence[int | Sequence[int]]) -> None:
 
 
 @pytest.mark.parametrize("bbox", BBOX)
-def test_pieslice_zero_width(bbox: Sequence[int | Sequence[int]]) -> None:
+def test_pieslice_zero_width(bbox: Coords) -> None:
     # Arrange
     im = Image.new("RGB", (W, H))
     draw = ImageDraw.Draw(im)
@@ -585,12 +578,7 @@ def test_pieslice_no_spikes() -> None:
 
 
 @pytest.mark.parametrize("points", POINTS)
-def test_point(
-    points: tuple[tuple[int, int], ...]
-    | list[tuple[int, int]]
-    | tuple[int, ...]
-    | list[int]
-) -> None:
+def test_point(points: Coords) -> None:
     # Arrange
     im = Image.new("RGB", (W, H))
     draw = ImageDraw.Draw(im)
@@ -615,12 +603,7 @@ def test_point_I16() -> None:
 
 
 @pytest.mark.parametrize("points", POINTS)
-def test_polygon(
-    points: tuple[tuple[int, int], ...]
-    | list[tuple[int, int]]
-    | tuple[int, ...]
-    | list[int]
-) -> None:
+def test_polygon(points: Coords) -> None:
     # Arrange
     im = Image.new("RGB", (W, H))
     draw = ImageDraw.Draw(im)
@@ -693,7 +676,7 @@ def test_polygon_translucent() -> None:
 
 
 @pytest.mark.parametrize("bbox", BBOX)
-def test_rectangle(bbox: Sequence[int | Sequence[int]]) -> None:
+def test_rectangle(bbox: Coords) -> None:
     # Arrange
     im = Image.new("RGB", (W, H))
     draw = ImageDraw.Draw(im)
@@ -720,7 +703,7 @@ def test_big_rectangle() -> None:
 
 
 @pytest.mark.parametrize("bbox", BBOX)
-def test_rectangle_width(bbox: Sequence[int | Sequence[int]]) -> None:
+def test_rectangle_width(bbox: Coords) -> None:
     # Arrange
     im = Image.new("RGB", (W, H))
     draw = ImageDraw.Draw(im)
@@ -734,7 +717,7 @@ def test_rectangle_width(bbox: Sequence[int | Sequence[int]]) -> None:
 
 
 @pytest.mark.parametrize("bbox", BBOX)
-def test_rectangle_width_fill(bbox: Sequence[int | Sequence[int]]) -> None:
+def test_rectangle_width_fill(bbox: Coords) -> None:
     # Arrange
     im = Image.new("RGB", (W, H))
     draw = ImageDraw.Draw(im)
@@ -748,7 +731,7 @@ def test_rectangle_width_fill(bbox: Sequence[int | Sequence[int]]) -> None:
 
 
 @pytest.mark.parametrize("bbox", BBOX)
-def test_rectangle_zero_width(bbox: Sequence[int | Sequence[int]]) -> None:
+def test_rectangle_zero_width(bbox: Coords) -> None:
     # Arrange
     im = Image.new("RGB", (W, H))
     draw = ImageDraw.Draw(im)
@@ -761,7 +744,7 @@ def test_rectangle_zero_width(bbox: Sequence[int | Sequence[int]]) -> None:
 
 
 @pytest.mark.parametrize("bbox", BBOX)
-def test_rectangle_I16(bbox: Sequence[int | Sequence[int]]) -> None:
+def test_rectangle_I16(bbox: Coords) -> None:
     # Arrange
     im = Image.new("I;16", (W, H))
     draw = ImageDraw.Draw(im)
@@ -774,7 +757,7 @@ def test_rectangle_I16(bbox: Sequence[int | Sequence[int]]) -> None:
 
 
 @pytest.mark.parametrize("bbox", BBOX)
-def test_rectangle_translucent_outline(bbox: Sequence[int | Sequence[int]]) -> None:
+def test_rectangle_translucent_outline(bbox: Coords) -> None:
     # Arrange
     im = Image.new("RGB", (W, H))
     draw = ImageDraw.Draw(im, "RGBA")
@@ -866,7 +849,7 @@ def test_rounded_rectangle_non_integer_radius(
 
 
 @pytest.mark.parametrize("bbox", BBOX)
-def test_rounded_rectangle_zero_radius(bbox: Sequence[int | Sequence[int]]) -> None:
+def test_rounded_rectangle_zero_radius(bbox: Coords) -> None:
     # Arrange
     im = Image.new("RGB", (W, H))
     draw = ImageDraw.Draw(im)
@@ -907,7 +890,7 @@ def test_rounded_rectangle_translucent(
 
 
 @pytest.mark.parametrize("bbox", BBOX)
-def test_floodfill(bbox: Sequence[int | Sequence[int]]) -> None:
+def test_floodfill(bbox: Coords) -> None:
     red = ImageColor.getrgb("red")
 
     for mode, value in [("L", 1), ("RGBA", (255, 0, 0, 0)), ("RGB", red)]:
@@ -940,7 +923,7 @@ def test_floodfill(bbox: Sequence[int | Sequence[int]]) -> None:
 
 
 @pytest.mark.parametrize("bbox", BBOX)
-def test_floodfill_border(bbox: Sequence[int | Sequence[int]]) -> None:
+def test_floodfill_border(bbox: Coords) -> None:
     # floodfill() is experimental
 
     # Arrange
@@ -962,7 +945,7 @@ def test_floodfill_border(bbox: Sequence[int | Sequence[int]]) -> None:
 
 
 @pytest.mark.parametrize("bbox", BBOX)
-def test_floodfill_thresh(bbox: Sequence[int | Sequence[int]]) -> None:
+def test_floodfill_thresh(bbox: Coords) -> None:
     # floodfill() is experimental
 
     # Arrange
@@ -1419,7 +1402,7 @@ def test_default_font_size() -> None:
 
 
 @pytest.mark.parametrize("bbox", BBOX)
-def test_same_color_outline(bbox: Sequence[int | Sequence[int]]) -> None:
+def test_same_color_outline(bbox: Coords) -> None:
     # Prepare shape
     x0, y0 = 5, 5
     x1, y1 = 5, 50
diff --git a/src/PIL/ImageDraw.py b/src/PIL/ImageDraw.py
index 650e3085763..d4e000087c4 100644
--- a/src/PIL/ImageDraw.py
+++ b/src/PIL/ImageDraw.py
@@ -34,8 +34,10 @@
 import math
 import numbers
 import struct
+from typing import Sequence, cast
 
 from . import Image, ImageColor
+from ._typing import Coords
 
 """
 A simple 2D drawing interface for PIL images.
@@ -145,13 +147,13 @@ def _getink(self, ink, fill=None) -> tuple[int | None, int | None]:
                 fill = self.draw.draw_ink(fill)
         return ink, fill
 
-    def arc(self, xy, start, end, fill=None, width=1) -> None:
+    def arc(self, xy: Coords, start, end, fill=None, width=1) -> None:
         """Draw an arc."""
         ink, fill = self._getink(fill)
         if ink is not None:
             self.draw.draw_arc(xy, start, end, ink, width)
 
-    def bitmap(self, xy, bitmap, fill=None) -> None:
+    def bitmap(self, xy: Sequence[int], bitmap, fill=None) -> None:
         """Draw a bitmap."""
         bitmap.load()
         ink, fill = self._getink(fill)
@@ -160,7 +162,7 @@ def bitmap(self, xy, bitmap, fill=None) -> None:
         if ink is not None:
             self.draw.draw_bitmap(xy, bitmap.im, ink)
 
-    def chord(self, xy, start, end, fill=None, outline=None, width=1) -> None:
+    def chord(self, xy: Coords, start, end, fill=None, outline=None, width=1) -> None:
         """Draw a chord."""
         ink, fill = self._getink(outline, fill)
         if fill is not None:
@@ -168,7 +170,7 @@ def chord(self, xy, start, end, fill=None, outline=None, width=1) -> None:
         if ink is not None and ink != fill and width != 0:
             self.draw.draw_chord(xy, start, end, ink, 0, width)
 
-    def ellipse(self, xy, fill=None, outline=None, width=1) -> None:
+    def ellipse(self, xy: Coords, fill=None, outline=None, width=1) -> None:
         """Draw an ellipse."""
         ink, fill = self._getink(outline, fill)
         if fill is not None:
@@ -176,20 +178,29 @@ def ellipse(self, xy, fill=None, outline=None, width=1) -> None:
         if ink is not None and ink != fill and width != 0:
             self.draw.draw_ellipse(xy, ink, 0, width)
 
-    def line(self, xy, fill=None, width=0, joint=None) -> None:
+    def line(self, xy: Coords, fill=None, width=0, joint=None) -> None:
         """Draw a line, or a connected sequence of line segments."""
         ink = self._getink(fill)[0]
         if ink is not None:
             self.draw.draw_lines(xy, ink, width)
             if joint == "curve" and width > 4:
-                if not isinstance(xy[0], (list, tuple)):
-                    xy = [tuple(xy[i : i + 2]) for i in range(0, len(xy), 2)]
-                for i in range(1, len(xy) - 1):
-                    point = xy[i]
+                points: Sequence[Sequence[float]]
+                if isinstance(xy[0], (list, tuple)):
+                    points = cast(Sequence[Sequence[float]], xy)
+                else:
+                    points = [
+                        cast(Sequence[float], tuple(xy[i : i + 2]))
+                        for i in range(0, len(xy), 2)
+                    ]
+                for i in range(1, len(points) - 1):
+                    point = points[i]
                     angles = [
                         math.degrees(math.atan2(end[0] - start[0], start[1] - end[1]))
                         % 360
-                        for start, end in ((xy[i - 1], point), (point, xy[i + 1]))
+                        for start, end in (
+                            (points[i - 1], point),
+                            (point, points[i + 1]),
+                        )
                     ]
                     if angles[0] == angles[1]:
                         # This is a straight line, so no joint is required
@@ -245,7 +256,9 @@ def shape(self, shape, fill=None, outline=None) -> None:
         if ink is not None and ink != fill:
             self.draw.draw_outline(shape, ink, 0)
 
-    def pieslice(self, xy, start, end, fill=None, outline=None, width=1) -> None:
+    def pieslice(
+        self, xy: Coords, start, end, fill=None, outline=None, width=1
+    ) -> None:
         """Draw a pieslice."""
         ink, fill = self._getink(outline, fill)
         if fill is not None:
@@ -253,13 +266,13 @@ def pieslice(self, xy, start, end, fill=None, outline=None, width=1) -> None:
         if ink is not None and ink != fill and width != 0:
             self.draw.draw_pieslice(xy, start, end, ink, 0, width)
 
-    def point(self, xy, fill=None) -> None:
+    def point(self, xy: Coords, fill=None) -> None:
         """Draw one or more individual pixels."""
         ink, fill = self._getink(fill)
         if ink is not None:
             self.draw.draw_points(xy, ink)
 
-    def polygon(self, xy, fill=None, outline=None, width=1) -> None:
+    def polygon(self, xy: Coords, fill=None, outline=None, width=1) -> None:
         """Draw a polygon."""
         ink, fill = self._getink(outline, fill)
         if fill is not None:
@@ -296,7 +309,7 @@ def regular_polygon(
         xy = _compute_regular_polygon_vertices(bounding_circle, n_sides, rotation)
         self.polygon(xy, fill, outline, width)
 
-    def rectangle(self, xy, fill=None, outline=None, width=1) -> None:
+    def rectangle(self, xy: Coords, fill=None, outline=None, width=1) -> None:
         """Draw a rectangle."""
         ink, fill = self._getink(outline, fill)
         if fill is not None:
@@ -305,13 +318,13 @@ def rectangle(self, xy, fill=None, outline=None, width=1) -> None:
             self.draw.draw_rectangle(xy, ink, 0, width)
 
     def rounded_rectangle(
-        self, xy, radius=0, fill=None, outline=None, width=1, *, corners=None
+        self, xy: Coords, radius=0, fill=None, outline=None, width=1, *, corners=None
     ) -> None:
         """Draw a rounded rectangle."""
         if isinstance(xy[0], (list, tuple)):
-            (x0, y0), (x1, y1) = xy
+            (x0, y0), (x1, y1) = cast(Sequence[Sequence[float]], xy)
         else:
-            x0, y0, x1, y1 = xy
+            x0, y0, x1, y1 = cast(Sequence[float], xy)
         if x1 < x0:
             msg = "x1 must be greater than or equal to x0"
             raise ValueError(msg)
@@ -347,6 +360,7 @@ def rounded_rectangle(
         ink, fill = self._getink(outline, fill)
 
         def draw_corners(pieslice) -> None:
+            parts: tuple[tuple[tuple[float, float, float, float], int, int], ...]
             if full_x:
                 # Draw top and bottom halves
                 parts = (
@@ -361,17 +375,18 @@ def draw_corners(pieslice) -> None:
                 )
             else:
                 # Draw four separate corners
-                parts = []
-                for i, part in enumerate(
-                    (
-                        ((x0, y0, x0 + d, y0 + d), 180, 270),
-                        ((x1 - d, y0, x1, y0 + d), 270, 360),
-                        ((x1 - d, y1 - d, x1, y1), 0, 90),
-                        ((x0, y1 - d, x0 + d, y1), 90, 180),
+                parts = tuple(
+                    part
+                    for i, part in enumerate(
+                        (
+                            ((x0, y0, x0 + d, y0 + d), 180, 270),
+                            ((x1 - d, y0, x1, y0 + d), 270, 360),
+                            ((x1 - d, y1 - d, x1, y1), 0, 90),
+                            ((x0, y1 - d, x0 + d, y1), 90, 180),
+                        )
                     )
-                ):
-                    if corners[i]:
-                        parts.append(part)
+                    if corners[i]
+                )
             for part in parts:
                 if pieslice:
                     self.draw.draw_pieslice(*(part + (fill, 1)))
@@ -520,7 +535,7 @@ def draw_text(ink, stroke_width=0, stroke_offset=None) -> None:
                     *args,
                     **kwargs,
                 )
-                coord = coord[0] + offset[0], coord[1] + offset[1]
+                coord = [coord[0] + offset[0], coord[1] + offset[1]]
             except AttributeError:
                 try:
                     mask = font.getmask(
@@ -539,7 +554,7 @@ def draw_text(ink, stroke_width=0, stroke_offset=None) -> None:
                 except TypeError:
                     mask = font.getmask(text)
             if stroke_offset:
-                coord = coord[0] + stroke_offset[0], coord[1] + stroke_offset[1]
+                coord = [coord[0] + stroke_offset[0], coord[1] + stroke_offset[1]]
             if mode == "RGBA":
                 # font.getmask2(mode="RGBA") returns color in RGB bands and mask in A
                 # extract mask and set text alpha
@@ -548,7 +563,9 @@ def draw_text(ink, stroke_width=0, stroke_offset=None) -> None:
                 color.fillband(3, ink_alpha)
                 x, y = coord
                 if self.im is not None:
-                    self.im.paste(color, (x, y, x + mask.size[0], y + mask.size[1]), mask)
+                    self.im.paste(
+                        color, (x, y, x + mask.size[0], y + mask.size[1]), mask
+                    )
             else:
                 self.draw.draw_bitmap(coord, mask, ink)
 
@@ -829,7 +846,7 @@ def multiline_textbbox(
         return bbox
 
 
-def Draw(im: Image.Image, mode: str | None = None) -> ImageDraw:
+def Draw(im, mode: str | None = None) -> ImageDraw:
     """
     A simple 2D drawing interface for PIL images.
 
@@ -933,7 +950,9 @@ def floodfill(image: Image.Image, xy, value, border=None, thresh=0) -> None:
         edge = new_edge
 
 
-def _compute_regular_polygon_vertices(bounding_circle, n_sides, rotation) -> list[tuple[float, float]]:
+def _compute_regular_polygon_vertices(
+    bounding_circle, n_sides, rotation
+) -> list[tuple[float, float]]:
     """
     Generate a list of vertices for a 2D regular polygon.
 
@@ -1051,9 +1070,7 @@ def _get_angles(n_sides: int, rotation: float) -> list[float]:
     angles = _get_angles(n_sides, rotation)
 
     # 4. Compute Vertices
-    return [
-        _compute_polygon_vertex(angle) for angle in angles
-    ]
+    return [_compute_polygon_vertex(angle) for angle in angles]
 
 
 def _color_diff(color1, color2: float | tuple[int, ...]) -> float:
diff --git a/src/PIL/_typing.py b/src/PIL/_typing.py
index 608b2b41fa8..ddea0b41467 100644
--- a/src/PIL/_typing.py
+++ b/src/PIL/_typing.py
@@ -1,6 +1,7 @@
 from __future__ import annotations
 
 import sys
+from typing import Sequence, Union
 
 if sys.version_info >= (3, 10):
     from typing import TypeGuard
@@ -15,4 +16,7 @@ def __class_getitem__(cls, item: Any) -> type[bool]:
                 return bool
 
 
+Coords = Union[Sequence[float], Sequence[Sequence[float]]]
+
+
 __all__ = ["TypeGuard"]

From 5f115df74f7aa26ec94b79ecad720a707be029e8 Mon Sep 17 00:00:00 2001
From: Andrew Murray <radarhere@users.noreply.github.com>
Date: Tue, 6 Feb 2024 08:05:30 +1100
Subject: [PATCH 0167/1178] Replace deprecated "extend-ignore" with "ignore"

---
 pyproject.toml | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/pyproject.toml b/pyproject.toml
index d7b60ef17d2..652ae36333c 100644
--- a/pyproject.toml
+++ b/pyproject.toml
@@ -111,7 +111,7 @@ select = [
   "W", # pycodestyle warnings
   "YTT", # flake8-2020
 ]
-extend-ignore = [
+ignore = [
   "E203", # Whitespace before ':'
   "E221", # Multiple spaces before operator
   "E226", # Missing whitespace around arithmetic operator

From 469db5114cf317ea128bd8c4b508eed537b7ce9e Mon Sep 17 00:00:00 2001
From: Evan Miller <emmiller@gmail.com>
Date: Tue, 6 Feb 2024 15:41:08 -0500
Subject: [PATCH 0168/1178] Release GIL while calling WebPAnimDecoderGetNext

---
 src/_webp.c | 4 ++++
 1 file changed, 4 insertions(+)

diff --git a/src/_webp.c b/src/_webp.c
index a1b4dbc1a25..4e7d41f1121 100644
--- a/src/_webp.c
+++ b/src/_webp.c
@@ -450,12 +450,16 @@ _anim_decoder_get_next(PyObject *self) {
     int timestamp;
     PyObject *bytes;
     PyObject *ret;
+    ImagingSectionCookie cookie;
     WebPAnimDecoderObject *decp = (WebPAnimDecoderObject *)self;
 
+    ImagingSectionEnter(&cookie);
     if (!WebPAnimDecoderGetNext(decp->dec, &buf, &timestamp)) {
+        ImagingSectionLeave(&cookie);
         PyErr_SetString(PyExc_OSError, "failed to read next frame");
         return NULL;
     }
+    ImagingSectionLeave(&cookie);
 
     bytes = PyBytes_FromStringAndSize(
         (char *)buf, decp->info.canvas_width * 4 * decp->info.canvas_height);

From 91645f9efffc623cb83221a8d9c9a0b98d3ce548 Mon Sep 17 00:00:00 2001
From: Andrew Murray <radarhere@users.noreply.github.com>
Date: Wed, 7 Feb 2024 10:19:00 +1100
Subject: [PATCH 0169/1178] Lint fix

---
 Tests/test_imagedraw.py | 8 +++++---
 1 file changed, 5 insertions(+), 3 deletions(-)

diff --git a/Tests/test_imagedraw.py b/Tests/test_imagedraw.py
index 4e6cedcd15f..f7aea30348d 100644
--- a/Tests/test_imagedraw.py
+++ b/Tests/test_imagedraw.py
@@ -776,9 +776,11 @@ def test_rectangle_translucent_outline(bbox: Coords) -> None:
     [(10, 20, 190, 180), ([10, 20], [190, 180]), ((10, 20), (190, 180))],
 )
 def test_rounded_rectangle(
-    xy: tuple[int, int, int, int]
-    | tuple[list[int]]
-    | tuple[tuple[int, int], tuple[int, int]]
+    xy: (
+        tuple[int, int, int, int]
+        | tuple[list[int]]
+        | tuple[tuple[int, int], tuple[int, int]]
+    )
 ) -> None:
     # Arrange
     im = Image.new("RGB", (200, 200))

From cdc498e6f3b2060906ca14fe9b9187e0a93a1613 Mon Sep 17 00:00:00 2001
From: Andrew Murray <radarhere@users.noreply.github.com>
Date: Wed, 7 Feb 2024 19:16:28 +1100
Subject: [PATCH 0170/1178] Added type hints

---
 Tests/test_color_lut.py      |  4 ++-
 Tests/test_file_eps.py       | 32 ++++++++++----------
 Tests/test_file_jpeg.py      | 35 +++++++++++-----------
 Tests/test_file_jpeg2k.py    | 21 ++++++-------
 Tests/test_file_libtiff.py   | 38 +++++++++++++-----------
 Tests/test_file_png.py       | 15 +++++-----
 Tests/test_image_paste.py    | 41 +++++++++++++++-----------
 Tests/test_image_reduce.py   | 43 +++++++++++++++------------
 Tests/test_image_resample.py | 57 ++++++++++++++++++++----------------
 Tests/test_imagemath.py      |  8 ++---
 10 files changed, 160 insertions(+), 134 deletions(-)

diff --git a/Tests/test_color_lut.py b/Tests/test_color_lut.py
index e6c8d7819a6..2bb1b57d482 100644
--- a/Tests/test_color_lut.py
+++ b/Tests/test_color_lut.py
@@ -15,7 +15,9 @@
 
 
 class TestColorLut3DCoreAPI:
-    def generate_identity_table(self, channels, size):
+    def generate_identity_table(
+        self, channels: int, size: int | tuple[int, int, int]
+    ) -> tuple[int, int, int, int, list[float]]:
         if isinstance(size, tuple):
             size_1d, size_2d, size_3d = size
         else:
diff --git a/Tests/test_file_eps.py b/Tests/test_file_eps.py
index 06f927c7bb2..00f5f39e8c8 100644
--- a/Tests/test_file_eps.py
+++ b/Tests/test_file_eps.py
@@ -84,7 +84,7 @@
     ("filename", "size"), ((FILE1, (460, 352)), (FILE2, (360, 252)))
 )
 @pytest.mark.parametrize("scale", (1, 2))
-def test_sanity(filename, size, scale) -> None:
+def test_sanity(filename: str, size: tuple[int, int], scale: int) -> None:
     expected_size = tuple(s * scale for s in size)
     with Image.open(filename) as image:
         image.load(scale=scale)
@@ -129,28 +129,28 @@ def test_binary_header_only() -> None:
 
 
 @pytest.mark.parametrize("prefix", (b"", simple_binary_header))
-def test_missing_version_comment(prefix) -> None:
+def test_missing_version_comment(prefix: bytes) -> None:
     data = io.BytesIO(prefix + b"\n".join(simple_eps_file_without_version))
     with pytest.raises(SyntaxError):
         EpsImagePlugin.EpsImageFile(data)
 
 
 @pytest.mark.parametrize("prefix", (b"", simple_binary_header))
-def test_missing_boundingbox_comment(prefix) -> None:
+def test_missing_boundingbox_comment(prefix: bytes) -> None:
     data = io.BytesIO(prefix + b"\n".join(simple_eps_file_without_boundingbox))
     with pytest.raises(SyntaxError, match='EPS header missing "%%BoundingBox" comment'):
         EpsImagePlugin.EpsImageFile(data)
 
 
 @pytest.mark.parametrize("prefix", (b"", simple_binary_header))
-def test_invalid_boundingbox_comment(prefix) -> None:
+def test_invalid_boundingbox_comment(prefix: bytes) -> None:
     data = io.BytesIO(prefix + b"\n".join(simple_eps_file_with_invalid_boundingbox))
     with pytest.raises(OSError, match="cannot determine EPS bounding box"):
         EpsImagePlugin.EpsImageFile(data)
 
 
 @pytest.mark.parametrize("prefix", (b"", simple_binary_header))
-def test_invalid_boundingbox_comment_valid_imagedata_comment(prefix) -> None:
+def test_invalid_boundingbox_comment_valid_imagedata_comment(prefix: bytes) -> None:
     data = io.BytesIO(
         prefix + b"\n".join(simple_eps_file_with_invalid_boundingbox_valid_imagedata)
     )
@@ -161,21 +161,21 @@ def test_invalid_boundingbox_comment_valid_imagedata_comment(prefix) -> None:
 
 
 @pytest.mark.parametrize("prefix", (b"", simple_binary_header))
-def test_ascii_comment_too_long(prefix) -> None:
+def test_ascii_comment_too_long(prefix: bytes) -> None:
     data = io.BytesIO(prefix + b"\n".join(simple_eps_file_with_long_ascii_comment))
     with pytest.raises(SyntaxError, match="not an EPS file"):
         EpsImagePlugin.EpsImageFile(data)
 
 
 @pytest.mark.parametrize("prefix", (b"", simple_binary_header))
-def test_long_binary_data(prefix) -> None:
+def test_long_binary_data(prefix: bytes) -> None:
     data = io.BytesIO(prefix + b"\n".join(simple_eps_file_with_long_binary_data))
     EpsImagePlugin.EpsImageFile(data)
 
 
 @pytest.mark.skipif(not HAS_GHOSTSCRIPT, reason="Ghostscript not available")
 @pytest.mark.parametrize("prefix", (b"", simple_binary_header))
-def test_load_long_binary_data(prefix) -> None:
+def test_load_long_binary_data(prefix: bytes) -> None:
     data = io.BytesIO(prefix + b"\n".join(simple_eps_file_with_long_binary_data))
     with Image.open(data) as img:
         img.load()
@@ -305,7 +305,7 @@ def test_render_scale2() -> None:
 
 @pytest.mark.skipif(not HAS_GHOSTSCRIPT, reason="Ghostscript not available")
 @pytest.mark.parametrize("filename", (FILE1, FILE2, "Tests/images/illu10_preview.eps"))
-def test_resize(filename) -> None:
+def test_resize(filename: str) -> None:
     with Image.open(filename) as im:
         new_size = (100, 100)
         im = im.resize(new_size)
@@ -314,7 +314,7 @@ def test_resize(filename) -> None:
 
 @pytest.mark.skipif(not HAS_GHOSTSCRIPT, reason="Ghostscript not available")
 @pytest.mark.parametrize("filename", (FILE1, FILE2))
-def test_thumbnail(filename) -> None:
+def test_thumbnail(filename: str) -> None:
     # Issue #619
     with Image.open(filename) as im:
         new_size = (100, 100)
@@ -335,7 +335,7 @@ def test_readline_psfile(tmp_path: Path) -> None:
     line_endings = ["\r\n", "\n", "\n\r", "\r"]
     strings = ["something", "else", "baz", "bif"]
 
-    def _test_readline(t, ending) -> None:
+    def _test_readline(t: EpsImagePlugin.PSFile, ending: str) -> None:
         ending = "Failure with line ending: %s" % (
             "".join("%s" % ord(s) for s in ending)
         )
@@ -344,13 +344,13 @@ def _test_readline(t, ending) -> None:
         assert t.readline().strip("\r\n") == "baz", ending
         assert t.readline().strip("\r\n") == "bif", ending
 
-    def _test_readline_io_psfile(test_string, ending) -> None:
+    def _test_readline_io_psfile(test_string: str, ending: str) -> None:
         f = io.BytesIO(test_string.encode("latin-1"))
         with pytest.warns(DeprecationWarning):
             t = EpsImagePlugin.PSFile(f)
         _test_readline(t, ending)
 
-    def _test_readline_file_psfile(test_string, ending) -> None:
+    def _test_readline_file_psfile(test_string: str, ending: str) -> None:
         f = str(tmp_path / "temp.txt")
         with open(f, "wb") as w:
             w.write(test_string.encode("latin-1"))
@@ -376,7 +376,7 @@ def test_psfile_deprecation() -> None:
     "line_ending",
     (b"\r\n", b"\n", b"\n\r", b"\r"),
 )
-def test_readline(prefix, line_ending) -> None:
+def test_readline(prefix: bytes, line_ending: bytes) -> None:
     simple_file = prefix + line_ending.join(simple_eps_file_with_comments)
     data = io.BytesIO(simple_file)
     test_file = EpsImagePlugin.EpsImageFile(data)
@@ -394,7 +394,7 @@ def test_readline(prefix, line_ending) -> None:
         "Tests/images/illuCS6_preview.eps",
     ),
 )
-def test_open_eps(filename) -> None:
+def test_open_eps(filename: str) -> None:
     # https://github.com/python-pillow/Pillow/issues/1104
     with Image.open(filename) as img:
         assert img.mode == "RGB"
@@ -417,7 +417,7 @@ def test_emptyline() -> None:
     "test_file",
     ["Tests/images/timeout-d675703545fee17acab56e5fec644c19979175de.eps"],
 )
-def test_timeout(test_file) -> None:
+def test_timeout(test_file: str) -> None:
     with open(test_file, "rb") as f:
         with pytest.raises(Image.UnidentifiedImageError):
             with Image.open(f):
diff --git a/Tests/test_file_jpeg.py b/Tests/test_file_jpeg.py
index ff278d4c1bf..6b0662e0be3 100644
--- a/Tests/test_file_jpeg.py
+++ b/Tests/test_file_jpeg.py
@@ -5,6 +5,7 @@
 import warnings
 from io import BytesIO
 from pathlib import Path
+from typing import Any
 
 import pytest
 
@@ -42,7 +43,7 @@
 
 @skip_unless_feature("jpg")
 class TestFileJpeg:
-    def roundtrip(self, im, **options):
+    def roundtrip(self, im: Image.Image, **options: Any) -> Image.Image:
         out = BytesIO()
         im.save(out, "JPEG", **options)
         test_bytes = out.tell()
@@ -51,7 +52,7 @@ def roundtrip(self, im, **options):
         im.bytes = test_bytes  # for testing only
         return im
 
-    def gen_random_image(self, size, mode: str = "RGB"):
+    def gen_random_image(self, size: tuple[int, int], mode: str = "RGB") -> Image.Image:
         """Generates a very hard to compress file
         :param size: tuple
         :param mode: optional image mode
@@ -71,7 +72,7 @@ def test_sanity(self) -> None:
             assert im.get_format_mimetype() == "image/jpeg"
 
     @pytest.mark.parametrize("size", ((1, 0), (0, 1), (0, 0)))
-    def test_zero(self, size, tmp_path: Path) -> None:
+    def test_zero(self, size: tuple[int, int], tmp_path: Path) -> None:
         f = str(tmp_path / "temp.jpg")
         im = Image.new("RGB", size)
         with pytest.raises(ValueError):
@@ -108,13 +109,11 @@ def test_comment_write(self) -> None:
                     assert "comment" not in reloaded.info
 
             # Test that a comment argument overrides the default comment
-            for comment in ("Test comment text", b"Text comment text"):
+            for comment in ("Test comment text", b"Test comment text"):
                 out = BytesIO()
                 im.save(out, format="JPEG", comment=comment)
                 with Image.open(out) as reloaded:
-                    if not isinstance(comment, bytes):
-                        comment = comment.encode()
-                    assert reloaded.info["comment"] == comment
+                    assert reloaded.info["comment"] == b"Test comment text"
 
     def test_cmyk(self) -> None:
         # Test CMYK handling.  Thanks to Tim and Charlie for test data,
@@ -145,7 +144,7 @@ def test_cmyk(self) -> None:
             assert k > 0.9
 
     def test_rgb(self) -> None:
-        def getchannels(im):
+        def getchannels(im: Image.Image) -> tuple[int, int, int]:
             return tuple(v[0] for v in im.layer)
 
         im = hopper()
@@ -161,8 +160,8 @@ def getchannels(im):
         "test_image_path",
         [TEST_FILE, "Tests/images/pil_sample_cmyk.jpg"],
     )
-    def test_dpi(self, test_image_path) -> None:
-        def test(xdpi, ydpi=None):
+    def test_dpi(self, test_image_path: str) -> None:
+        def test(xdpi: int, ydpi: int | None = None):
             with Image.open(test_image_path) as im:
                 im = self.roundtrip(im, dpi=(xdpi, ydpi or xdpi))
             return im.info.get("dpi")
@@ -207,7 +206,7 @@ def test_icc(self, tmp_path: Path) -> None:
             ImageFile.MAXBLOCK * 4 + 3,  # large block
         ),
     )
-    def test_icc_big(self, n) -> None:
+    def test_icc_big(self, n: int) -> None:
         # Make sure that the "extra" support handles large blocks
         # The ICC APP marker can store 65519 bytes per marker, so
         # using a 4-byte test code should allow us to detect out of
@@ -433,7 +432,7 @@ def test_smooth(self) -> None:
         assert_image(im1, im2.mode, im2.size)
 
     def test_subsampling(self) -> None:
-        def getsampling(im):
+        def getsampling(im: Image.Image):
             layer = im.layer
             return layer[0][1:3] + layer[1][1:3] + layer[2][1:3]
 
@@ -530,7 +529,7 @@ def test_truncated_jpeg_throws_oserror(self) -> None:
         pytest.mark.valgrind_known_error, "libjpeg_turbo", "2.0", reason="Known Failing"
     )
     def test_qtables(self, tmp_path: Path) -> None:
-        def _n_qtables_helper(n, test_file) -> None:
+        def _n_qtables_helper(n: int, test_file: str) -> None:
             with Image.open(test_file) as im:
                 f = str(tmp_path / "temp.jpg")
                 im.save(f, qtables=[[n] * 64] * n)
@@ -666,7 +665,7 @@ def test_save_low_quality_baseline_qtables(self) -> None:
         "blocks, rows, markers",
         ((0, 0, 0), (1, 0, 15), (3, 0, 5), (8, 0, 1), (0, 1, 3), (0, 2, 1)),
     )
-    def test_restart_markers(self, blocks, rows, markers) -> None:
+    def test_restart_markers(self, blocks: int, rows: int, markers: int) -> None:
         im = Image.new("RGB", (32, 32))  # 16 MCUs
         out = BytesIO()
         im.save(
@@ -724,13 +723,13 @@ def test_bad_mpo_header(self) -> None:
             assert im.format == "JPEG"
 
     @pytest.mark.parametrize("mode", ("1", "L", "RGB", "RGBX", "CMYK", "YCbCr"))
-    def test_save_correct_modes(self, mode) -> None:
+    def test_save_correct_modes(self, mode: str) -> None:
         out = BytesIO()
         img = Image.new(mode, (20, 20))
         img.save(out, "JPEG")
 
     @pytest.mark.parametrize("mode", ("LA", "La", "RGBA", "RGBa", "P"))
-    def test_save_wrong_modes(self, mode) -> None:
+    def test_save_wrong_modes(self, mode: str) -> None:
         # ref https://github.com/python-pillow/Pillow/issues/2005
         out = BytesIO()
         img = Image.new(mode, (20, 20))
@@ -982,12 +981,12 @@ def test_eof(self) -> None:
         # Even though this decoder never says that it is finished
         # the image should still end when there is no new data
         class InfiniteMockPyDecoder(ImageFile.PyDecoder):
-            def decode(self, buffer):
+            def decode(self, buffer: bytes) -> tuple[int, int]:
                 return 0, 0
 
         decoder = InfiniteMockPyDecoder(None)
 
-        def closure(mode, *args):
+        def closure(mode: str, *args) -> InfiniteMockPyDecoder:
             decoder.__init__(mode, *args)
             return decoder
 
diff --git a/Tests/test_file_jpeg2k.py b/Tests/test_file_jpeg2k.py
index e3f1fa8fde1..fab19e2eab4 100644
--- a/Tests/test_file_jpeg2k.py
+++ b/Tests/test_file_jpeg2k.py
@@ -4,6 +4,7 @@
 import re
 from io import BytesIO
 from pathlib import Path
+from typing import Any
 
 import pytest
 
@@ -36,7 +37,7 @@
 # 'Not enough memory to handle tile data'
 
 
-def roundtrip(im, **options):
+def roundtrip(im: Image.Image, **options: Any) -> Image.Image:
     out = BytesIO()
     im.save(out, "JPEG2000", **options)
     test_bytes = out.tell()
@@ -138,7 +139,7 @@ def test_prog_res_rt() -> None:
 
 
 @pytest.mark.parametrize("num_resolutions", range(2, 6))
-def test_default_num_resolutions(num_resolutions) -> None:
+def test_default_num_resolutions(num_resolutions: int) -> None:
     d = 1 << (num_resolutions - 1)
     im = test_card.resize((d - 1, d - 1))
     with pytest.raises(OSError):
@@ -198,9 +199,9 @@ def test_layers_type(tmp_path: Path) -> None:
     for quality_layers in [[100, 50, 10], (100, 50, 10), None]:
         test_card.save(outfile, quality_layers=quality_layers)
 
-    for quality_layers in ["quality_layers", ("100", "50", "10")]:
+    for quality_layers_str in ["quality_layers", ("100", "50", "10")]:
         with pytest.raises(ValueError):
-            test_card.save(outfile, quality_layers=quality_layers)
+            test_card.save(outfile, quality_layers=quality_layers_str)
 
 
 def test_layers() -> None:
@@ -233,7 +234,7 @@ def test_layers() -> None:
         ("foo.jp2", {"no_jp2": False}, 4, b"jP"),
     ),
 )
-def test_no_jp2(name, args, offset, data) -> None:
+def test_no_jp2(name: str, args: dict[str, bool], offset: int, data: bytes) -> None:
     out = BytesIO()
     if name:
         out.name = name
@@ -278,7 +279,7 @@ def test_sgnd(tmp_path: Path) -> None:
 
 
 @pytest.mark.parametrize("ext", (".j2k", ".jp2"))
-def test_rgba(ext) -> None:
+def test_rgba(ext: str) -> None:
     # Arrange
     with Image.open("Tests/images/rgb_trns_ycbc" + ext) as im:
         # Act
@@ -289,7 +290,7 @@ def test_rgba(ext) -> None:
 
 
 @pytest.mark.parametrize("ext", (".j2k", ".jp2"))
-def test_16bit_monochrome_has_correct_mode(ext) -> None:
+def test_16bit_monochrome_has_correct_mode(ext: str) -> None:
     with Image.open("Tests/images/16bit.cropped" + ext) as im:
         im.load()
         assert im.mode == "I;16"
@@ -346,12 +347,12 @@ def test_parser_feed() -> None:
     not os.path.exists(EXTRA_DIR), reason="Extra image files not installed"
 )
 @pytest.mark.parametrize("name", ("subsampling_1", "subsampling_2", "zoo1", "zoo2"))
-def test_subsampling_decode(name) -> None:
+def test_subsampling_decode(name: str) -> None:
     test = f"{EXTRA_DIR}/{name}.jp2"
     reference = f"{EXTRA_DIR}/{name}.ppm"
 
     with Image.open(test) as im:
-        epsilon = 3  # for YCbCr images
+        epsilon = 3.0  # for YCbCr images
         with Image.open(reference) as im2:
             width, height = im2.size
             if name[-1] == "2":
@@ -400,7 +401,7 @@ def test_save_comment() -> None:
         "Tests/images/crash-d2c93af851d3ab9a19e34503626368b2ecde9c03.j2k",
     ],
 )
-def test_crashes(test_file) -> None:
+def test_crashes(test_file: str) -> None:
     with open(test_file, "rb") as f:
         with Image.open(f) as im:
             # Valgrind should not complain here
diff --git a/Tests/test_file_libtiff.py b/Tests/test_file_libtiff.py
index 1386034e5a3..0994d99040e 100644
--- a/Tests/test_file_libtiff.py
+++ b/Tests/test_file_libtiff.py
@@ -27,7 +27,7 @@
 
 @skip_unless_feature("libtiff")
 class LibTiffTestCase:
-    def _assert_noerr(self, tmp_path: Path, im) -> None:
+    def _assert_noerr(self, tmp_path: Path, im: Image.Image) -> None:
         """Helper tests that assert basic sanity about the g4 tiff reading"""
         # 1 bit
         assert im.mode == "1"
@@ -140,7 +140,7 @@ def test_adobe_deflate_tiff(self) -> None:
             assert_image_equal_tofile(im, "Tests/images/tiff_adobe_deflate.png")
 
     @pytest.mark.parametrize("legacy_api", (False, True))
-    def test_write_metadata(self, legacy_api, tmp_path: Path) -> None:
+    def test_write_metadata(self, legacy_api: bool, tmp_path: Path) -> None:
         """Test metadata writing through libtiff"""
         f = str(tmp_path / "temp.tiff")
         with Image.open("Tests/images/hopper_g4.tif") as img:
@@ -243,7 +243,7 @@ def test_additional_metadata(self, tmp_path: Path) -> None:
         TiffImagePlugin.WRITE_LIBTIFF = False
 
     def test_custom_metadata(self, tmp_path: Path) -> None:
-        tc = namedtuple("test_case", "value,type,supported_by_default")
+        tc = namedtuple("tc", "value,type,supported_by_default")
         custom = {
             37000 + k: v
             for k, v in enumerate(
@@ -284,7 +284,9 @@ def test_custom_metadata(self, tmp_path: Path) -> None:
         for libtiff in libtiffs:
             TiffImagePlugin.WRITE_LIBTIFF = libtiff
 
-            def check_tags(tiffinfo) -> None:
+            def check_tags(
+                tiffinfo: TiffImagePlugin.ImageFileDirectory_v2 | dict[int, str]
+            ) -> None:
                 im = hopper()
 
                 out = str(tmp_path / "temp.tif")
@@ -502,7 +504,7 @@ def test_cmyk_save(self, tmp_path: Path) -> None:
         assert_image_equal_tofile(im, out)
 
     @pytest.mark.parametrize("im", (hopper("P"), Image.new("P", (1, 1), "#000")))
-    def test_palette_save(self, im, tmp_path: Path) -> None:
+    def test_palette_save(self, im: Image.Image, tmp_path: Path) -> None:
         out = str(tmp_path / "temp.tif")
 
         TiffImagePlugin.WRITE_LIBTIFF = True
@@ -514,7 +516,7 @@ def test_palette_save(self, im, tmp_path: Path) -> None:
             assert len(reloaded.tag_v2[320]) == 768
 
     @pytest.mark.parametrize("compression", ("tiff_ccitt", "group3", "group4"))
-    def test_bw_compression_w_rgb(self, compression, tmp_path: Path) -> None:
+    def test_bw_compression_w_rgb(self, compression: str, tmp_path: Path) -> None:
         im = hopper("RGB")
         out = str(tmp_path / "temp.tif")
 
@@ -647,7 +649,7 @@ def test_save_bytesio(self) -> None:
         # Generate test image
         pilim = hopper()
 
-        def save_bytesio(compression=None) -> None:
+        def save_bytesio(compression: str | None = None) -> None:
             buffer_io = io.BytesIO()
             pilim.save(buffer_io, format="tiff", compression=compression)
             buffer_io.seek(0)
@@ -731,7 +733,7 @@ def test_read_icc(self) -> None:
         assert icc == icc_libtiff
 
     def test_write_icc(self, tmp_path: Path) -> None:
-        def check_write(libtiff) -> None:
+        def check_write(libtiff: bool) -> None:
             TiffImagePlugin.WRITE_LIBTIFF = libtiff
 
             with Image.open("Tests/images/hopper.iccprofile.tif") as img:
@@ -837,7 +839,7 @@ def test_sampleformat_write(self, tmp_path: Path) -> None:
             assert reloaded.mode == "F"
             assert reloaded.getexif()[SAMPLEFORMAT] == 3
 
-    def test_lzma(self, capfd):
+    def test_lzma(self, capfd: pytest.CaptureFixture[str]) -> None:
         try:
             with Image.open("Tests/images/hopper_lzma.tif") as im:
                 assert im.mode == "RGB"
@@ -853,7 +855,7 @@ def test_lzma(self, capfd):
             sys.stderr.write(captured.err)
             raise
 
-    def test_webp(self, capfd):
+    def test_webp(self, capfd: pytest.CaptureFixture[str]) -> None:
         try:
             with Image.open("Tests/images/hopper_webp.tif") as im:
                 assert im.mode == "RGB"
@@ -971,7 +973,7 @@ def test_strip_planar_16bit_RGBa(self) -> None:
             assert_image_equal_tofile(im, "Tests/images/tiff_16bit_RGBa_target.png")
 
     @pytest.mark.parametrize("compression", (None, "jpeg"))
-    def test_block_tile_tags(self, compression, tmp_path: Path) -> None:
+    def test_block_tile_tags(self, compression: str | None, tmp_path: Path) -> None:
         im = hopper()
         out = str(tmp_path / "temp.tif")
 
@@ -1020,7 +1022,9 @@ def test_open_missing_samplesperpixel(self) -> None:
             ),
         ],
     )
-    def test_wrong_bits_per_sample(self, file_name, mode, size, tile) -> None:
+    def test_wrong_bits_per_sample(
+        self, file_name: str, mode: str, size: tuple[int, int], tile
+    ) -> None:
         with Image.open("Tests/images/" + file_name) as im:
             assert im.mode == mode
             assert im.size == size
@@ -1086,7 +1090,7 @@ def test_realloc_overflow(self) -> None:
         TiffImagePlugin.READ_LIBTIFF = False
 
     @pytest.mark.parametrize("compression", ("tiff_adobe_deflate", "jpeg"))
-    def test_save_multistrip(self, compression, tmp_path: Path) -> None:
+    def test_save_multistrip(self, compression: str, tmp_path: Path) -> None:
         im = hopper("RGB").resize((256, 256))
         out = str(tmp_path / "temp.tif")
         im.save(out, compression=compression)
@@ -1096,14 +1100,14 @@ def test_save_multistrip(self, compression, tmp_path: Path) -> None:
             assert len(im.tag_v2[STRIPOFFSETS]) > 1
 
     @pytest.mark.parametrize("argument", (True, False))
-    def test_save_single_strip(self, argument, tmp_path: Path) -> None:
+    def test_save_single_strip(self, argument: bool, tmp_path: Path) -> None:
         im = hopper("RGB").resize((256, 256))
         out = str(tmp_path / "temp.tif")
 
         if not argument:
             TiffImagePlugin.STRIP_SIZE = 2**18
         try:
-            arguments = {"compression": "tiff_adobe_deflate"}
+            arguments: dict[str, str | int] = {"compression": "tiff_adobe_deflate"}
             if argument:
                 arguments["strip_size"] = 2**18
             im.save(out, **arguments)
@@ -1114,7 +1118,7 @@ def test_save_single_strip(self, argument, tmp_path: Path) -> None:
             TiffImagePlugin.STRIP_SIZE = 65536
 
     @pytest.mark.parametrize("compression", ("tiff_adobe_deflate", None))
-    def test_save_zero(self, compression, tmp_path: Path) -> None:
+    def test_save_zero(self, compression: str | None, tmp_path: Path) -> None:
         im = Image.new("RGB", (0, 0))
         out = str(tmp_path / "temp.tif")
         with pytest.raises(SystemError):
@@ -1134,7 +1138,7 @@ def test_save_many_compressed(self, tmp_path: Path) -> None:
             ("Tests/images/child_ifd_jpeg.tiff", (20,)),
         ),
     )
-    def test_get_child_images(self, path, sizes) -> None:
+    def test_get_child_images(self, path: str, sizes: tuple[int, ...]) -> None:
         with Image.open(path) as im:
             ims = im.get_child_images()
 
diff --git a/Tests/test_file_png.py b/Tests/test_file_png.py
index 0f1d96365ea..d4a63431647 100644
--- a/Tests/test_file_png.py
+++ b/Tests/test_file_png.py
@@ -6,6 +6,7 @@
 import zlib
 from io import BytesIO
 from pathlib import Path
+from typing import Any
 
 import pytest
 
@@ -36,7 +37,7 @@
 MAGIC = PngImagePlugin._MAGIC
 
 
-def chunk(cid, *data):
+def chunk(cid: bytes, *data: bytes) -> bytes:
     test_file = BytesIO()
     PngImagePlugin.putchunk(*(test_file, cid) + data)
     return test_file.getvalue()
@@ -52,11 +53,11 @@ def chunk(cid, *data):
 TAIL = IDAT + IEND
 
 
-def load(data):
+def load(data: bytes) -> Image.Image:
     return Image.open(BytesIO(data))
 
 
-def roundtrip(im, **options):
+def roundtrip(im: Image.Image, **options: Any) -> Image.Image:
     out = BytesIO()
     im.save(out, "PNG", **options)
     out.seek(0)
@@ -65,7 +66,7 @@ def roundtrip(im, **options):
 
 @skip_unless_feature("zlib")
 class TestFilePng:
-    def get_chunks(self, filename):
+    def get_chunks(self, filename: str) -> list[bytes]:
         chunks = []
         with open(filename, "rb") as fp:
             fp.read(8)
@@ -436,7 +437,7 @@ def test_nonunicode_text(self) -> None:
     def test_unicode_text(self) -> None:
         # Check preservation of non-ASCII characters
 
-        def rt_text(value) -> None:
+        def rt_text(value: str) -> None:
             im = Image.new("RGB", (32, 32))
             info = PngImagePlugin.PngInfo()
             info.add_text("Text", value)
@@ -636,7 +637,7 @@ def test_padded_idat(self) -> None:
     @pytest.mark.parametrize(
         "cid", (b"IHDR", b"sRGB", b"pHYs", b"acTL", b"fcTL", b"fdAT")
     )
-    def test_truncated_chunks(self, cid) -> None:
+    def test_truncated_chunks(self, cid: bytes) -> None:
         fp = BytesIO()
         with PngImagePlugin.PngStream(fp) as png:
             with pytest.raises(ValueError):
@@ -755,7 +756,7 @@ def test_seek(self) -> None:
                 im.seek(1)
 
     @pytest.mark.parametrize("buffer", (True, False))
-    def test_save_stdout(self, buffer) -> None:
+    def test_save_stdout(self, buffer: bool) -> None:
         old_stdout = sys.stdout
 
         if buffer:
diff --git a/Tests/test_image_paste.py b/Tests/test_image_paste.py
index 34a2f8f3db5..c4d7a5dd254 100644
--- a/Tests/test_image_paste.py
+++ b/Tests/test_image_paste.py
@@ -11,10 +11,9 @@ class TestImagingPaste:
     masks = {}
     size = 128
 
-    def assert_9points_image(self, im, expected) -> None:
-        expected = [
-            point[0] if im.mode == "L" else point[: len(im.mode)] for point in expected
-        ]
+    def assert_9points_image(
+        self, im: Image.Image, expected: list[tuple[int, int, int, int]]
+    ) -> None:
         px = im.load()
         actual = [
             px[0, 0],
@@ -27,9 +26,17 @@ def assert_9points_image(self, im, expected) -> None:
             px[self.size // 2, self.size - 1],
             px[self.size - 1, self.size - 1],
         ]
-        assert actual == expected
+        assert actual == [
+            point[0] if im.mode == "L" else point[: len(im.mode)] for point in expected
+        ]
 
-    def assert_9points_paste(self, im, im2, mask, expected) -> None:
+    def assert_9points_paste(
+        self,
+        im: Image.Image,
+        im2: Image.Image,
+        mask: Image.Image,
+        expected: list[tuple[int, int, int, int]],
+    ) -> None:
         im3 = im.copy()
         im3.paste(im2, (0, 0), mask)
         self.assert_9points_image(im3, expected)
@@ -106,7 +113,7 @@ def gradient_RGBa(self):
         )
 
     @pytest.mark.parametrize("mode", ["RGBA", "RGB", "L"])
-    def test_image_solid(self, mode) -> None:
+    def test_image_solid(self, mode: str) -> None:
         im = Image.new(mode, (200, 200), "red")
         im2 = getattr(self, "gradient_" + mode)
 
@@ -116,7 +123,7 @@ def test_image_solid(self, mode) -> None:
         assert_image_equal(im, im2)
 
     @pytest.mark.parametrize("mode", ["RGBA", "RGB", "L"])
-    def test_image_mask_1(self, mode) -> None:
+    def test_image_mask_1(self, mode: str) -> None:
         im = Image.new(mode, (200, 200), "white")
         im2 = getattr(self, "gradient_" + mode)
 
@@ -138,7 +145,7 @@ def test_image_mask_1(self, mode) -> None:
         )
 
     @pytest.mark.parametrize("mode", ["RGBA", "RGB", "L"])
-    def test_image_mask_L(self, mode) -> None:
+    def test_image_mask_L(self, mode: str) -> None:
         im = Image.new(mode, (200, 200), "white")
         im2 = getattr(self, "gradient_" + mode)
 
@@ -160,7 +167,7 @@ def test_image_mask_L(self, mode) -> None:
         )
 
     @pytest.mark.parametrize("mode", ["RGBA", "RGB", "L"])
-    def test_image_mask_LA(self, mode) -> None:
+    def test_image_mask_LA(self, mode: str) -> None:
         im = Image.new(mode, (200, 200), "white")
         im2 = getattr(self, "gradient_" + mode)
 
@@ -182,7 +189,7 @@ def test_image_mask_LA(self, mode) -> None:
         )
 
     @pytest.mark.parametrize("mode", ["RGBA", "RGB", "L"])
-    def test_image_mask_RGBA(self, mode) -> None:
+    def test_image_mask_RGBA(self, mode: str) -> None:
         im = Image.new(mode, (200, 200), "white")
         im2 = getattr(self, "gradient_" + mode)
 
@@ -204,7 +211,7 @@ def test_image_mask_RGBA(self, mode) -> None:
         )
 
     @pytest.mark.parametrize("mode", ["RGBA", "RGB", "L"])
-    def test_image_mask_RGBa(self, mode) -> None:
+    def test_image_mask_RGBa(self, mode: str) -> None:
         im = Image.new(mode, (200, 200), "white")
         im2 = getattr(self, "gradient_" + mode)
 
@@ -226,7 +233,7 @@ def test_image_mask_RGBa(self, mode) -> None:
         )
 
     @pytest.mark.parametrize("mode", ["RGBA", "RGB", "L"])
-    def test_color_solid(self, mode) -> None:
+    def test_color_solid(self, mode: str) -> None:
         im = Image.new(mode, (200, 200), "black")
 
         rect = (12, 23, 128 + 12, 128 + 23)
@@ -239,7 +246,7 @@ def test_color_solid(self, mode) -> None:
             assert sum(head[:255]) == 0
 
     @pytest.mark.parametrize("mode", ["RGBA", "RGB", "L"])
-    def test_color_mask_1(self, mode) -> None:
+    def test_color_mask_1(self, mode: str) -> None:
         im = Image.new(mode, (200, 200), (50, 60, 70, 80)[: len(mode)])
         color = (10, 20, 30, 40)[: len(mode)]
 
@@ -261,7 +268,7 @@ def test_color_mask_1(self, mode) -> None:
         )
 
     @pytest.mark.parametrize("mode", ["RGBA", "RGB", "L"])
-    def test_color_mask_L(self, mode) -> None:
+    def test_color_mask_L(self, mode: str) -> None:
         im = getattr(self, "gradient_" + mode).copy()
         color = "white"
 
@@ -283,7 +290,7 @@ def test_color_mask_L(self, mode) -> None:
         )
 
     @pytest.mark.parametrize("mode", ["RGBA", "RGB", "L"])
-    def test_color_mask_RGBA(self, mode) -> None:
+    def test_color_mask_RGBA(self, mode: str) -> None:
         im = getattr(self, "gradient_" + mode).copy()
         color = "white"
 
@@ -305,7 +312,7 @@ def test_color_mask_RGBA(self, mode) -> None:
         )
 
     @pytest.mark.parametrize("mode", ["RGBA", "RGB", "L"])
-    def test_color_mask_RGBa(self, mode) -> None:
+    def test_color_mask_RGBa(self, mode: str) -> None:
         im = getattr(self, "gradient_" + mode).copy()
         color = "white"
 
diff --git a/Tests/test_image_reduce.py b/Tests/test_image_reduce.py
index c29830a7e5f..33b33d6b7fc 100644
--- a/Tests/test_image_reduce.py
+++ b/Tests/test_image_reduce.py
@@ -48,7 +48,7 @@
         ((1, 3), (10, 4)),
     ),
 )
-def test_args_factor(size, expected) -> None:
+def test_args_factor(size: int | tuple[int, int], expected: tuple[int, int]) -> None:
     im = Image.new("L", (10, 10))
     assert expected == im.reduce(size).size
 
@@ -56,7 +56,7 @@ def test_args_factor(size, expected) -> None:
 @pytest.mark.parametrize(
     "size, expected_error", ((0, ValueError), (2.0, TypeError), ((0, 10), ValueError))
 )
-def test_args_factor_error(size, expected_error) -> None:
+def test_args_factor_error(size: float | tuple[int, int], expected_error) -> None:
     im = Image.new("L", (10, 10))
     with pytest.raises(expected_error):
         im.reduce(size)
@@ -69,7 +69,7 @@ def test_args_factor_error(size, expected_error) -> None:
         ((5, 5, 6, 6), (1, 1)),
     ),
 )
-def test_args_box(size, expected) -> None:
+def test_args_box(size: tuple[int, int, int, int], expected: tuple[int, int]) -> None:
     im = Image.new("L", (10, 10))
     assert expected == im.reduce(2, size).size
 
@@ -86,20 +86,20 @@ def test_args_box(size, expected) -> None:
         ((5, 0, 5, 10), ValueError),
     ),
 )
-def test_args_box_error(size, expected_error) -> None:
+def test_args_box_error(size: str | tuple[int, int, int, int], expected_error) -> None:
     im = Image.new("L", (10, 10))
     with pytest.raises(expected_error):
         im.reduce(2, size).size
 
 
 @pytest.mark.parametrize("mode", ("P", "1", "I;16"))
-def test_unsupported_modes(mode) -> None:
+def test_unsupported_modes(mode: str) -> None:
     im = Image.new("P", (10, 10))
     with pytest.raises(ValueError):
         im.reduce(3)
 
 
-def get_image(mode):
+def get_image(mode: str) -> Image.Image:
     mode_info = ImageMode.getmode(mode)
     if mode_info.basetype == "L":
         bands = [gradients_image]
@@ -119,7 +119,7 @@ def get_image(mode):
     return im.crop((0, 0, im.width, im.height - 5))
 
 
-def compare_reduce_with_box(im, factor) -> None:
+def compare_reduce_with_box(im: Image.Image, factor: int | tuple[int, int]) -> None:
     box = (11, 13, 146, 164)
     reduced = im.reduce(factor, box=box)
     reference = im.crop(box).reduce(factor)
@@ -127,7 +127,10 @@ def compare_reduce_with_box(im, factor) -> None:
 
 
 def compare_reduce_with_reference(
-    im, factor, average_diff: float = 0.4, max_diff: int = 1
+    im: Image.Image,
+    factor: int | tuple[int, int],
+    average_diff: float = 0.4,
+    max_diff: int = 1,
 ) -> None:
     """Image.reduce() should look very similar to Image.resize(BOX).
 
@@ -173,7 +176,9 @@ def compare_reduce_with_reference(
     assert_compare_images(reduced, reference, average_diff, max_diff)
 
 
-def assert_compare_images(a, b, max_average_diff, max_diff: int = 255) -> None:
+def assert_compare_images(
+    a: Image.Image, b: Image.Image, max_average_diff: float, max_diff: int = 255
+) -> None:
     assert a.mode == b.mode, f"got mode {repr(a.mode)}, expected {repr(b.mode)}"
     assert a.size == b.size, f"got size {repr(a.size)}, expected {repr(b.size)}"
 
@@ -201,20 +206,20 @@ def assert_compare_images(a, b, max_average_diff, max_diff: int = 255) -> None:
 
 
 @pytest.mark.parametrize("factor", remarkable_factors)
-def test_mode_L(factor) -> None:
+def test_mode_L(factor: int | tuple[int, int]) -> None:
     im = get_image("L")
     compare_reduce_with_reference(im, factor)
     compare_reduce_with_box(im, factor)
 
 
 @pytest.mark.parametrize("factor", remarkable_factors)
-def test_mode_LA(factor) -> None:
+def test_mode_LA(factor: int | tuple[int, int]) -> None:
     im = get_image("LA")
     compare_reduce_with_reference(im, factor, 0.8, 5)
 
 
 @pytest.mark.parametrize("factor", remarkable_factors)
-def test_mode_LA_opaque(factor) -> None:
+def test_mode_LA_opaque(factor: int | tuple[int, int]) -> None:
     im = get_image("LA")
     # With opaque alpha, an error should be way smaller.
     im.putalpha(Image.new("L", im.size, 255))
@@ -223,27 +228,27 @@ def test_mode_LA_opaque(factor) -> None:
 
 
 @pytest.mark.parametrize("factor", remarkable_factors)
-def test_mode_La(factor) -> None:
+def test_mode_La(factor: int | tuple[int, int]) -> None:
     im = get_image("La")
     compare_reduce_with_reference(im, factor)
     compare_reduce_with_box(im, factor)
 
 
 @pytest.mark.parametrize("factor", remarkable_factors)
-def test_mode_RGB(factor) -> None:
+def test_mode_RGB(factor: int | tuple[int, int]) -> None:
     im = get_image("RGB")
     compare_reduce_with_reference(im, factor)
     compare_reduce_with_box(im, factor)
 
 
 @pytest.mark.parametrize("factor", remarkable_factors)
-def test_mode_RGBA(factor) -> None:
+def test_mode_RGBA(factor: int | tuple[int, int]) -> None:
     im = get_image("RGBA")
     compare_reduce_with_reference(im, factor, 0.8, 5)
 
 
 @pytest.mark.parametrize("factor", remarkable_factors)
-def test_mode_RGBA_opaque(factor) -> None:
+def test_mode_RGBA_opaque(factor: int | tuple[int, int]) -> None:
     im = get_image("RGBA")
     # With opaque alpha, an error should be way smaller.
     im.putalpha(Image.new("L", im.size, 255))
@@ -252,21 +257,21 @@ def test_mode_RGBA_opaque(factor) -> None:
 
 
 @pytest.mark.parametrize("factor", remarkable_factors)
-def test_mode_RGBa(factor) -> None:
+def test_mode_RGBa(factor: int | tuple[int, int]) -> None:
     im = get_image("RGBa")
     compare_reduce_with_reference(im, factor)
     compare_reduce_with_box(im, factor)
 
 
 @pytest.mark.parametrize("factor", remarkable_factors)
-def test_mode_I(factor) -> None:
+def test_mode_I(factor: int | tuple[int, int]) -> None:
     im = get_image("I")
     compare_reduce_with_reference(im, factor)
     compare_reduce_with_box(im, factor)
 
 
 @pytest.mark.parametrize("factor", remarkable_factors)
-def test_mode_F(factor) -> None:
+def test_mode_F(factor: int | tuple[int, int]) -> None:
     im = get_image("F")
     compare_reduce_with_reference(im, factor, 0, 0)
     compare_reduce_with_box(im, factor)
diff --git a/Tests/test_image_resample.py b/Tests/test_image_resample.py
index f4c9eb0e6fa..f3ec12c053b 100644
--- a/Tests/test_image_resample.py
+++ b/Tests/test_image_resample.py
@@ -1,6 +1,7 @@
 from __future__ import annotations
 
 from contextlib import contextmanager
+from typing import Generator
 
 import pytest
 
@@ -51,7 +52,7 @@ def test_modify_after_resizing(self) -> None:
 
 
 class TestImagingCoreResampleAccuracy:
-    def make_case(self, mode, size, color):
+    def make_case(self, mode: str, size: tuple[int, int], color: int) -> Image.Image:
         """Makes a sample image with two dark and two bright squares.
         For example:
         e0 e0 1f 1f
@@ -66,7 +67,7 @@ def make_case(self, mode, size, color):
 
         return Image.merge(mode, [case] * len(mode))
 
-    def make_sample(self, data, size):
+    def make_sample(self, data: str, size: tuple[int, int]) -> Image.Image:
         """Restores a sample image from given data string which contains
         hex-encoded pixels from the top left fourth of a sample.
         """
@@ -83,7 +84,7 @@ def make_sample(self, data, size):
                 s_px[size[0] - x - 1, y] = 255 - val
         return sample
 
-    def check_case(self, case, sample) -> None:
+    def check_case(self, case: Image.Image, sample: Image.Image) -> None:
         s_px = sample.load()
         c_px = case.load()
         for y in range(case.size[1]):
@@ -95,7 +96,7 @@ def check_case(self, case, sample) -> None:
                     )
                     assert s_px[x, y] == c_px[x, y], message
 
-    def serialize_image(self, image):
+    def serialize_image(self, image: Image.Image) -> str:
         s_px = image.load()
         return "\n".join(
             " ".join(f"{s_px[x, y]:02x}" for x in range(image.size[0]))
@@ -103,7 +104,7 @@ def serialize_image(self, image):
         )
 
     @pytest.mark.parametrize("mode", ("RGBX", "RGB", "La", "L"))
-    def test_reduce_box(self, mode) -> None:
+    def test_reduce_box(self, mode: str) -> None:
         case = self.make_case(mode, (8, 8), 0xE1)
         case = case.resize((4, 4), Image.Resampling.BOX)
         # fmt: off
@@ -114,7 +115,7 @@ def test_reduce_box(self, mode) -> None:
             self.check_case(channel, self.make_sample(data, (4, 4)))
 
     @pytest.mark.parametrize("mode", ("RGBX", "RGB", "La", "L"))
-    def test_reduce_bilinear(self, mode) -> None:
+    def test_reduce_bilinear(self, mode: str) -> None:
         case = self.make_case(mode, (8, 8), 0xE1)
         case = case.resize((4, 4), Image.Resampling.BILINEAR)
         # fmt: off
@@ -125,7 +126,7 @@ def test_reduce_bilinear(self, mode) -> None:
             self.check_case(channel, self.make_sample(data, (4, 4)))
 
     @pytest.mark.parametrize("mode", ("RGBX", "RGB", "La", "L"))
-    def test_reduce_hamming(self, mode) -> None:
+    def test_reduce_hamming(self, mode: str) -> None:
         case = self.make_case(mode, (8, 8), 0xE1)
         case = case.resize((4, 4), Image.Resampling.HAMMING)
         # fmt: off
@@ -136,7 +137,7 @@ def test_reduce_hamming(self, mode) -> None:
             self.check_case(channel, self.make_sample(data, (4, 4)))
 
     @pytest.mark.parametrize("mode", ("RGBX", "RGB", "La", "L"))
-    def test_reduce_bicubic(self, mode) -> None:
+    def test_reduce_bicubic(self, mode: str) -> None:
         case = self.make_case(mode, (12, 12), 0xE1)
         case = case.resize((6, 6), Image.Resampling.BICUBIC)
         # fmt: off
@@ -148,7 +149,7 @@ def test_reduce_bicubic(self, mode) -> None:
             self.check_case(channel, self.make_sample(data, (6, 6)))
 
     @pytest.mark.parametrize("mode", ("RGBX", "RGB", "La", "L"))
-    def test_reduce_lanczos(self, mode) -> None:
+    def test_reduce_lanczos(self, mode: str) -> None:
         case = self.make_case(mode, (16, 16), 0xE1)
         case = case.resize((8, 8), Image.Resampling.LANCZOS)
         # fmt: off
@@ -161,7 +162,7 @@ def test_reduce_lanczos(self, mode) -> None:
             self.check_case(channel, self.make_sample(data, (8, 8)))
 
     @pytest.mark.parametrize("mode", ("RGBX", "RGB", "La", "L"))
-    def test_enlarge_box(self, mode) -> None:
+    def test_enlarge_box(self, mode: str) -> None:
         case = self.make_case(mode, (2, 2), 0xE1)
         case = case.resize((4, 4), Image.Resampling.BOX)
         # fmt: off
@@ -172,7 +173,7 @@ def test_enlarge_box(self, mode) -> None:
             self.check_case(channel, self.make_sample(data, (4, 4)))
 
     @pytest.mark.parametrize("mode", ("RGBX", "RGB", "La", "L"))
-    def test_enlarge_bilinear(self, mode) -> None:
+    def test_enlarge_bilinear(self, mode: str) -> None:
         case = self.make_case(mode, (2, 2), 0xE1)
         case = case.resize((4, 4), Image.Resampling.BILINEAR)
         # fmt: off
@@ -183,7 +184,7 @@ def test_enlarge_bilinear(self, mode) -> None:
             self.check_case(channel, self.make_sample(data, (4, 4)))
 
     @pytest.mark.parametrize("mode", ("RGBX", "RGB", "La", "L"))
-    def test_enlarge_hamming(self, mode) -> None:
+    def test_enlarge_hamming(self, mode: str) -> None:
         case = self.make_case(mode, (2, 2), 0xE1)
         case = case.resize((4, 4), Image.Resampling.HAMMING)
         # fmt: off
@@ -194,7 +195,7 @@ def test_enlarge_hamming(self, mode) -> None:
             self.check_case(channel, self.make_sample(data, (4, 4)))
 
     @pytest.mark.parametrize("mode", ("RGBX", "RGB", "La", "L"))
-    def test_enlarge_bicubic(self, mode) -> None:
+    def test_enlarge_bicubic(self, mode: str) -> None:
         case = self.make_case(mode, (4, 4), 0xE1)
         case = case.resize((8, 8), Image.Resampling.BICUBIC)
         # fmt: off
@@ -207,7 +208,7 @@ def test_enlarge_bicubic(self, mode) -> None:
             self.check_case(channel, self.make_sample(data, (8, 8)))
 
     @pytest.mark.parametrize("mode", ("RGBX", "RGB", "La", "L"))
-    def test_enlarge_lanczos(self, mode) -> None:
+    def test_enlarge_lanczos(self, mode: str) -> None:
         case = self.make_case(mode, (6, 6), 0xE1)
         case = case.resize((12, 12), Image.Resampling.LANCZOS)
         data = (
@@ -230,7 +231,7 @@ def test_box_filter_correct_range(self) -> None:
 
 
 class TestCoreResampleConsistency:
-    def make_case(self, mode, fill):
+    def make_case(self, mode: str, fill: tuple[int, int, int] | float):
         im = Image.new(mode, (512, 9), fill)
         return im.resize((9, 512), Image.Resampling.LANCZOS), im.load()[0, 0]
 
@@ -265,7 +266,7 @@ def test_32f(self) -> None:
 
 
 class TestCoreResampleAlphaCorrect:
-    def make_levels_case(self, mode):
+    def make_levels_case(self, mode: str) -> Image.Image:
         i = Image.new(mode, (256, 16))
         px = i.load()
         for y in range(i.size[1]):
@@ -275,7 +276,7 @@ def make_levels_case(self, mode):
                 px[x, y] = tuple(pix)
         return i
 
-    def run_levels_case(self, i) -> None:
+    def run_levels_case(self, i: Image.Image) -> None:
         px = i.load()
         for y in range(i.size[1]):
             used_colors = {px[x, y][0] for x in range(i.size[0])}
@@ -302,7 +303,9 @@ def test_levels_la(self) -> None:
         self.run_levels_case(case.resize((512, 32), Image.Resampling.BICUBIC))
         self.run_levels_case(case.resize((512, 32), Image.Resampling.LANCZOS))
 
-    def make_dirty_case(self, mode, clean_pixel, dirty_pixel):
+    def make_dirty_case(
+        self, mode: str, clean_pixel: tuple[int, ...], dirty_pixel: tuple[int, ...]
+    ) -> Image.Image:
         i = Image.new(mode, (64, 64), dirty_pixel)
         px = i.load()
         xdiv4 = i.size[0] // 4
@@ -312,7 +315,7 @@ def make_dirty_case(self, mode, clean_pixel, dirty_pixel):
                 px[x + xdiv4, y + ydiv4] = clean_pixel
         return i
 
-    def run_dirty_case(self, i, clean_pixel) -> None:
+    def run_dirty_case(self, i: Image.Image, clean_pixel: tuple[int, ...]) -> None:
         px = i.load()
         for y in range(i.size[1]):
             for x in range(i.size[0]):
@@ -432,7 +435,7 @@ class TestCoreResampleBox:
             Image.Resampling.LANCZOS,
         ),
     )
-    def test_wrong_arguments(self, resample) -> None:
+    def test_wrong_arguments(self, resample: Image.Resampling) -> None:
         im = hopper()
         im.resize((32, 32), resample, (0, 0, im.width, im.height))
         im.resize((32, 32), resample, (20, 20, im.width, im.height))
@@ -459,8 +462,12 @@ def test_wrong_arguments(self, resample) -> None:
         with pytest.raises(ValueError, match="can't exceed"):
             im.resize((32, 32), resample, (0, 0, im.width, im.height + 1))
 
-    def resize_tiled(self, im, dst_size, xtiles, ytiles):
-        def split_range(size, tiles):
+    def resize_tiled(
+        self, im: Image.Image, dst_size: tuple[int, int], xtiles: int, ytiles: int
+    ) -> Image.Image:
+        def split_range(
+            size: int, tiles: int
+        ) -> Generator[tuple[int, int], None, None]:
             scale = size / tiles
             for i in range(tiles):
                 yield int(round(scale * i)), int(round(scale * (i + 1)))
@@ -518,7 +525,7 @@ def test_subsample(self) -> None:
     @pytest.mark.parametrize(
         "resample", (Image.Resampling.NEAREST, Image.Resampling.BILINEAR)
     )
-    def test_formats(self, mode, resample) -> None:
+    def test_formats(self, mode: str, resample: Image.Resampling) -> None:
         im = hopper(mode)
         box = (20, 20, im.size[0] - 20, im.size[1] - 20)
         with_box = im.resize((32, 32), resample, box)
@@ -558,7 +565,7 @@ def test_no_passthrough(self) -> None:
     @pytest.mark.parametrize(
         "flt", (Image.Resampling.NEAREST, Image.Resampling.BICUBIC)
     )
-    def test_skip_horizontal(self, flt) -> None:
+    def test_skip_horizontal(self, flt: Image.Resampling) -> None:
         # Can skip resize for one dimension
         im = hopper()
 
@@ -581,7 +588,7 @@ def test_skip_horizontal(self, flt) -> None:
     @pytest.mark.parametrize(
         "flt", (Image.Resampling.NEAREST, Image.Resampling.BICUBIC)
     )
-    def test_skip_vertical(self, flt) -> None:
+    def test_skip_vertical(self, flt: Image.Resampling) -> None:
         # Can skip resize for one dimension
         im = hopper()
 
diff --git a/Tests/test_imagemath.py b/Tests/test_imagemath.py
index ea6e80f1ee7..b65ea874063 100644
--- a/Tests/test_imagemath.py
+++ b/Tests/test_imagemath.py
@@ -5,11 +5,11 @@
 from PIL import Image, ImageMath
 
 
-def pixel(im):
-    if hasattr(im, "im"):
-        return f"{im.mode} {repr(im.getpixel((0, 0)))}"
+def pixel(im: Image.Image | int) -> str | int:
     if isinstance(im, int):
         return int(im)  # hack to deal with booleans
+    else:
+        return f"{im.mode} {repr(im.getpixel((0, 0)))}"
 
 
 A = Image.new("L", (1, 1), 1)
@@ -60,7 +60,7 @@ def test_ops() -> None:
         "(lambda: (lambda: exec('pass'))())()",
     ),
 )
-def test_prevent_exec(expression) -> None:
+def test_prevent_exec(expression: str) -> None:
     with pytest.raises(ValueError):
         ImageMath.eval(expression)
 

From 463c36821136652a05517a4db810a265d25c9b0c Mon Sep 17 00:00:00 2001
From: Andrew Murray <3112309+radarhere@users.noreply.github.com>
Date: Wed, 7 Feb 2024 21:02:34 +1100
Subject: [PATCH 0171/1178] Simplified code

Co-authored-by: Hugo van Kemenade <1324225+hugovk@users.noreply.github.com>
---
 Tests/test_imagemath.py | 4 ++--
 1 file changed, 2 insertions(+), 2 deletions(-)

diff --git a/Tests/test_imagemath.py b/Tests/test_imagemath.py
index b65ea874063..a21e2307d5f 100644
--- a/Tests/test_imagemath.py
+++ b/Tests/test_imagemath.py
@@ -8,8 +8,8 @@
 def pixel(im: Image.Image | int) -> str | int:
     if isinstance(im, int):
         return int(im)  # hack to deal with booleans
-    else:
-        return f"{im.mode} {repr(im.getpixel((0, 0)))}"
+
+    return f"{im.mode} {repr(im.getpixel((0, 0)))}"
 
 
 A = Image.new("L", (1, 1), 1)

From c93b23239d4cbe8b8c6d4d6c04db35763a25db62 Mon Sep 17 00:00:00 2001
From: Evan Miller <emmiller@gmail.com>
Date: Wed, 7 Feb 2024 20:20:27 -0500
Subject: [PATCH 0172/1178] Update src/_webp.c

Co-authored-by: Andrew Murray <3112309+radarhere@users.noreply.github.com>
---
 src/_webp.c | 7 ++++---
 1 file changed, 4 insertions(+), 3 deletions(-)

diff --git a/src/_webp.c b/src/_webp.c
index 4e7d41f1121..927d8dc3f4c 100644
--- a/src/_webp.c
+++ b/src/_webp.c
@@ -448,18 +448,19 @@ PyObject *
 _anim_decoder_get_next(PyObject *self) {
     uint8_t *buf;
     int timestamp;
+    int ok;
     PyObject *bytes;
     PyObject *ret;
     ImagingSectionCookie cookie;
     WebPAnimDecoderObject *decp = (WebPAnimDecoderObject *)self;
 
     ImagingSectionEnter(&cookie);
-    if (!WebPAnimDecoderGetNext(decp->dec, &buf, &timestamp)) {
-        ImagingSectionLeave(&cookie);
+    ok = WebPAnimDecoderGetNext(decp->dec, &buf, &timestamp)
+    ImagingSectionLeave(&cookie);
+    if (!ok) {
         PyErr_SetString(PyExc_OSError, "failed to read next frame");
         return NULL;
     }
-    ImagingSectionLeave(&cookie);
 
     bytes = PyBytes_FromStringAndSize(
         (char *)buf, decp->info.canvas_width * 4 * decp->info.canvas_height);

From cb39b1c89e71f67ce4dacd41cebf723ff86306dd Mon Sep 17 00:00:00 2001
From: Andrew Murray <3112309+radarhere@users.noreply.github.com>
Date: Thu, 8 Feb 2024 12:29:06 +1100
Subject: [PATCH 0173/1178] Corrected syntax

---
 src/_webp.c | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/src/_webp.c b/src/_webp.c
index 927d8dc3f4c..47592547cc2 100644
--- a/src/_webp.c
+++ b/src/_webp.c
@@ -455,7 +455,7 @@ _anim_decoder_get_next(PyObject *self) {
     WebPAnimDecoderObject *decp = (WebPAnimDecoderObject *)self;
 
     ImagingSectionEnter(&cookie);
-    ok = WebPAnimDecoderGetNext(decp->dec, &buf, &timestamp)
+    ok = WebPAnimDecoderGetNext(decp->dec, &buf, &timestamp);
     ImagingSectionLeave(&cookie);
     if (!ok) {
         PyErr_SetString(PyExc_OSError, "failed to read next frame");

From a276cf2c9fadf39cc5e663e44bc160c566d7c050 Mon Sep 17 00:00:00 2001
From: Andrew Murray <radarhere@users.noreply.github.com>
Date: Thu, 8 Feb 2024 18:48:38 +1100
Subject: [PATCH 0174/1178] Use _typing alias

---
 src/PIL/ImageFont.py | 4 ++--
 1 file changed, 2 insertions(+), 2 deletions(-)

diff --git a/src/PIL/ImageFont.py b/src/PIL/ImageFont.py
index 9f8394d63b4..7be2fdf0445 100644
--- a/src/PIL/ImageFont.py
+++ b/src/PIL/ImageFont.py
@@ -33,10 +33,10 @@
 import warnings
 from enum import IntEnum
 from io import BytesIO
-from pathlib import Path
 from typing import BinaryIO
 
 from . import Image
+from ._typing import StrOrBytesPath
 from ._util import is_directory, is_path
 
 
@@ -193,7 +193,7 @@ class FreeTypeFont:
 
     def __init__(
         self,
-        font: bytes | str | Path | BinaryIO | None = None,
+        font: StrOrBytesPath | BinaryIO | None = None,
         size: float = 10,
         index: int = 0,
         encoding: str = "",

From a118a82c30acf6427653b129fab263fde3bdbbac Mon Sep 17 00:00:00 2001
From: Andrew Murray <radarhere@users.noreply.github.com>
Date: Thu, 8 Feb 2024 18:35:37 +1100
Subject: [PATCH 0175/1178] Use os.path.realpath consistently when os.fspath is
 used

---
 src/PIL/Image.py     | 2 +-
 src/PIL/ImageFont.py | 2 +-
 2 files changed, 2 insertions(+), 2 deletions(-)

diff --git a/src/PIL/Image.py b/src/PIL/Image.py
index d7d0a1ae7f0..adb63b07f79 100644
--- a/src/PIL/Image.py
+++ b/src/PIL/Image.py
@@ -2385,7 +2385,7 @@ def save(self, fp, format=None, **params) -> None:
         filename = ""
         open_fp = False
         if is_path(fp):
-            filename = os.fspath(fp)
+            filename = os.path.realpath(os.fspath(fp))
             open_fp = True
         elif fp == sys.stdout:
             try:
diff --git a/src/PIL/ImageFont.py b/src/PIL/ImageFont.py
index 7be2fdf0445..256c581df0c 100644
--- a/src/PIL/ImageFont.py
+++ b/src/PIL/ImageFont.py
@@ -230,7 +230,7 @@ def load_from_bytes(f):
             )
 
         if is_path(font):
-            font = os.fspath(font)
+            font = os.path.realpath(os.fspath(font))
             if sys.platform == "win32":
                 font_bytes_path = font if isinstance(font, bytes) else font.encode()
                 try:

From e6a521130e975f89529442597735a6a48cc3685f Mon Sep 17 00:00:00 2001
From: Andrew Murray <radarhere@users.noreply.github.com>
Date: Fri, 9 Feb 2024 19:47:09 +1100
Subject: [PATCH 0176/1178] If previous disposal was 2, do not fill identical
 pixels

---
 Tests/test_file_gif.py    | 3 +++
 src/PIL/GifImagePlugin.py | 6 +++++-
 2 files changed, 8 insertions(+), 1 deletion(-)

diff --git a/Tests/test_file_gif.py b/Tests/test_file_gif.py
index db9d3586c4d..0399c6b6798 100644
--- a/Tests/test_file_gif.py
+++ b/Tests/test_file_gif.py
@@ -647,6 +647,9 @@ def test_dispose2_palette(tmp_path: Path) -> None:
             # Center remains red every frame
             assert rgb_img.getpixel((50, 50)) == circle
 
+            # Check that frame transparency wasn't added unnecessarily
+            assert img._frame_transparency is None
+
 
 def test_dispose2_diff(tmp_path: Path) -> None:
     out = str(tmp_path / "temp.gif")
diff --git a/src/PIL/GifImagePlugin.py b/src/PIL/GifImagePlugin.py
index dc842d7a30b..73a5487d9a7 100644
--- a/src/PIL/GifImagePlugin.py
+++ b/src/PIL/GifImagePlugin.py
@@ -638,7 +638,11 @@ def _write_multiple_frames(im, fp, palette):
                         background_im = Image.new("P", im_frame.size, background)
                         background_im.putpalette(im_frames[0]["im"].palette)
                     delta, bbox = _getbbox(background_im, im_frame)
-                if encoderinfo.get("optimize") and im_frame.mode != "1":
+                if (
+                    encoderinfo.get("optimize")
+                    and im_frames[-1]["encoderinfo"].get("disposal") != 2
+                    and im_frame.mode != "1"
+                ):
                     if "transparency" not in encoderinfo:
                         try:
                             encoderinfo["transparency"] = (

From 152a24e13abfe099d4cf75dc7982290feb200ad2 Mon Sep 17 00:00:00 2001
From: Andrew Murray <radarhere@users.noreply.github.com>
Date: Sat, 10 Feb 2024 16:48:02 +1100
Subject: [PATCH 0177/1178] Simplified code

---
 src/PIL/Image.py | 4 +---
 1 file changed, 1 insertion(+), 3 deletions(-)

diff --git a/src/PIL/Image.py b/src/PIL/Image.py
index adb63b07f79..231674f5448 100644
--- a/src/PIL/Image.py
+++ b/src/PIL/Image.py
@@ -3240,10 +3240,8 @@ def open(fp, mode="r", formats=None) -> Image:
 
     exclusive_fp = False
     filename = ""
-    if isinstance(fp, os.PathLike):
+    if is_path(fp):
         filename = os.path.realpath(os.fspath(fp))
-    elif is_path(fp):
-        filename = fp
 
     if filename:
         fp = builtins.open(filename, "rb")

From 373c62e5cbcd27a4e497e61b44cda89911f38807 Mon Sep 17 00:00:00 2001
From: Andrew Murray <radarhere@users.noreply.github.com>
Date: Sat, 10 Feb 2024 19:47:50 +1100
Subject: [PATCH 0178/1178] Use subprocess with CREATE_NO_WINDOW flag in
 WindowsViewer

---
 src/PIL/ImageShow.py | 11 +++++++++++
 1 file changed, 11 insertions(+)

diff --git a/src/PIL/ImageShow.py b/src/PIL/ImageShow.py
index c03122c11aa..4a801e5b0fb 100644
--- a/src/PIL/ImageShow.py
+++ b/src/PIL/ImageShow.py
@@ -138,6 +138,17 @@ def get_command(self, file: str, **options: Any) -> str:
             f'&& del /f "{file}"'
         )
 
+    def show_file(self, path: str, **options: Any) -> int:
+        """
+        Display given file.
+        """
+        subprocess.Popen(
+            self.get_command(path, **options),
+            shell=True,
+            creationflags=getattr(subprocess, "CREATE_NO_WINDOW"),
+        )  # nosec
+        return 1
+
 
 if sys.platform == "win32":
     register(WindowsViewer)

From 19a6edeecce2f3605fcdb074c00ac0152c6bdf05 Mon Sep 17 00:00:00 2001
From: Andrew Murray <radarhere@users.noreply.github.com>
Date: Sat, 10 Feb 2024 19:50:45 +1100
Subject: [PATCH 0179/1178] Added type hints

---
 pyproject.toml             |  10 ----
 src/PIL/DdsImagePlugin.py  |  16 ++++--
 src/PIL/ImImagePlugin.py   |   4 +-
 src/PIL/Image.py           |  86 +++++++++++++++++++----------
 src/PIL/ImageQt.py         |  12 +++-
 src/PIL/PdfParser.py       |  11 +++-
 src/PIL/PyAccess.py        |   1 +
 src/PIL/TiffImagePlugin.py | 109 +++++++++++++++++++++----------------
 src/PIL/TiffTags.py        |   4 +-
 src/PIL/_imaging.pyi       |   5 ++
 src/PIL/_tkinter_finder.py |   3 +-
 src/PIL/_webp.pyi          |   5 ++
 tox.ini                    |   5 ++
 13 files changed, 171 insertions(+), 100 deletions(-)
 create mode 100644 src/PIL/_imaging.pyi
 create mode 100644 src/PIL/_webp.pyi

diff --git a/pyproject.toml b/pyproject.toml
index 652ae36333c..48c59f2a1b4 100644
--- a/pyproject.toml
+++ b/pyproject.toml
@@ -141,16 +141,6 @@ warn_redundant_casts = true
 warn_unreachable = true
 warn_unused_ignores = true
 exclude = [
-  '^src/PIL/_tkinter_finder.py$',
-  '^src/PIL/DdsImagePlugin.py$',
   '^src/PIL/FpxImagePlugin.py$',
-  '^src/PIL/Image.py$',
-  '^src/PIL/ImageQt.py$',
-  '^src/PIL/ImImagePlugin.py$',
   '^src/PIL/MicImagePlugin.py$',
-  '^src/PIL/PdfParser.py$',
-  '^src/PIL/PyAccess.py$',
-  '^src/PIL/TiffImagePlugin.py$',
-  '^src/PIL/TiffTags.py$',
-  '^src/PIL/WebPImagePlugin.py$',
 ]
diff --git a/src/PIL/DdsImagePlugin.py b/src/PIL/DdsImagePlugin.py
index 3785174ef65..be17f4223aa 100644
--- a/src/PIL/DdsImagePlugin.py
+++ b/src/PIL/DdsImagePlugin.py
@@ -270,13 +270,17 @@ class D3DFMT(IntEnum):
 # Backward compatibility layer
 module = sys.modules[__name__]
 for item in DDSD:
+    assert item.name is not None
     setattr(module, "DDSD_" + item.name, item.value)
-for item in DDSCAPS:
-    setattr(module, "DDSCAPS_" + item.name, item.value)
-for item in DDSCAPS2:
-    setattr(module, "DDSCAPS2_" + item.name, item.value)
-for item in DDPF:
-    setattr(module, "DDPF_" + item.name, item.value)
+for item1 in DDSCAPS:
+    assert item1.name is not None
+    setattr(module, "DDSCAPS_" + item1.name, item1.value)
+for item2 in DDSCAPS2:
+    assert item2.name is not None
+    setattr(module, "DDSCAPS2_" + item2.name, item2.value)
+for item3 in DDPF:
+    assert item3.name is not None
+    setattr(module, "DDPF_" + item3.name, item3.value)
 
 DDS_FOURCC = DDPF.FOURCC
 DDS_RGB = DDPF.RGB
diff --git a/src/PIL/ImImagePlugin.py b/src/PIL/ImImagePlugin.py
index 97d726a8a65..4613e40b60f 100644
--- a/src/PIL/ImImagePlugin.py
+++ b/src/PIL/ImImagePlugin.py
@@ -93,8 +93,8 @@
 for i in ["32S"]:
     OPEN[f"L {i} image"] = ("I", f"I;{i}")
     OPEN[f"L*{i} image"] = ("I", f"I;{i}")
-for i in range(2, 33):
-    OPEN[f"L*{i} image"] = ("F", f"F;{i}")
+for j in range(2, 33):
+    OPEN[f"L*{j} image"] = ("F", f"F;{j}")
 
 
 # --------------------------------------------------------------------
diff --git a/src/PIL/Image.py b/src/PIL/Image.py
index 111d060129e..d32a0fc199e 100644
--- a/src/PIL/Image.py
+++ b/src/PIL/Image.py
@@ -26,6 +26,7 @@
 
 from __future__ import annotations
 
+import abc
 import atexit
 import builtins
 import io
@@ -40,11 +41,8 @@
 from collections.abc import Callable, MutableMapping
 from enum import IntEnum
 from pathlib import Path
-
-try:
-    from defusedxml import ElementTree
-except ImportError:
-    ElementTree = None
+from types import ModuleType
+from typing import IO, TYPE_CHECKING, Any
 
 # VERSION was removed in Pillow 6.0.0.
 # PILLOW_VERSION was removed in Pillow 9.0.0.
@@ -60,6 +58,12 @@
 from ._binary import i32le, o32be, o32le
 from ._util import DeferredError, is_path
 
+ElementTree: ModuleType | None
+try:
+    from defusedxml import ElementTree
+except ImportError:
+    ElementTree = None
+
 logger = logging.getLogger(__name__)
 
 
@@ -110,6 +114,7 @@ class DecompressionBombError(Exception):
 
 
 USE_CFFI_ACCESS = False
+cffi: ModuleType | None
 try:
     import cffi
 except ImportError:
@@ -211,14 +216,22 @@ class Quantize(IntEnum):
 # --------------------------------------------------------------------
 # Registries
 
-ID = []
-OPEN = {}
-MIME = {}
-SAVE = {}
-SAVE_ALL = {}
-EXTENSION = {}
-DECODERS = {}
-ENCODERS = {}
+if TYPE_CHECKING:
+    from . import ImageFile  # pragma: no cover
+ID: list[str] = []
+OPEN: dict[
+    str,
+    tuple[
+        Callable[[IO[bytes], str | bytes], ImageFile.ImageFile],
+        Callable[[bytes], bool] | None,
+    ],
+] = {}
+MIME: dict[str, str] = {}
+SAVE: dict[str, Callable[[Image, IO[bytes], str | bytes], None]] = {}
+SAVE_ALL: dict[str, Callable[[Image, IO[bytes], str | bytes], None]] = {}
+EXTENSION: dict[str, str] = {}
+DECODERS: dict[str, object] = {}
+ENCODERS: dict[str, object] = {}
 
 # --------------------------------------------------------------------
 # Modes
@@ -2383,12 +2396,12 @@ def save(self, fp, format=None, **params) -> None:
            may have been created, and may contain partial data.
         """
 
-        filename = ""
+        filename: str | bytes = ""
         open_fp = False
         if isinstance(fp, Path):
             filename = str(fp)
             open_fp = True
-        elif is_path(fp):
+        elif isinstance(fp, (str, bytes)):
             filename = fp
             open_fp = True
         elif fp == sys.stdout:
@@ -2398,7 +2411,7 @@ def save(self, fp, format=None, **params) -> None:
                 pass
         if not filename and hasattr(fp, "name") and is_path(fp.name):
             # only set the name for metadata purposes
-            filename = fp.name
+            filename = os.path.realpath(os.fspath(fp.name))
 
         # may mutate self!
         self._ensure_mutable()
@@ -2409,7 +2422,8 @@ def save(self, fp, format=None, **params) -> None:
 
         preinit()
 
-        ext = os.path.splitext(filename)[1].lower()
+        filename_ext = os.path.splitext(filename)[1].lower()
+        ext = filename_ext.decode() if isinstance(filename_ext, bytes) else filename_ext
 
         if not format:
             if ext not in EXTENSION:
@@ -2451,7 +2465,7 @@ def save(self, fp, format=None, **params) -> None:
         if open_fp:
             fp.close()
 
-    def seek(self, frame) -> Image:
+    def seek(self, frame) -> None:
         """
         Seeks to the given frame in this sequence file. If you seek
         beyond the end of the sequence, the method raises an
@@ -2511,10 +2525,9 @@ def split(self) -> tuple[Image, ...]:
 
         self.load()
         if self.im.bands == 1:
-            ims = [self.copy()]
+            return (self.copy(),)
         else:
-            ims = map(self._new, self.im.split())
-        return tuple(ims)
+            return tuple(map(self._new, self.im.split()))
 
     def getchannel(self, channel):
         """
@@ -2871,7 +2884,14 @@ class ImageTransformHandler:
     (for use with :py:meth:`~PIL.Image.Image.transform`)
     """
 
-    pass
+    @abc.abstractmethod
+    def transform(
+        self,
+        size: tuple[int, int],
+        image: Image,
+        **options: dict[str, str | int | tuple[int, ...] | list[int]],
+    ) -> Image:
+        pass  # pragma: no cover
 
 
 # --------------------------------------------------------------------
@@ -3243,11 +3263,9 @@ def open(fp, mode="r", formats=None) -> Image:
         raise TypeError(msg)
 
     exclusive_fp = False
-    filename = ""
-    if isinstance(fp, Path):
-        filename = str(fp.resolve())
-    elif is_path(fp):
-        filename = fp
+    filename: str | bytes = ""
+    if is_path(fp):
+        filename = os.path.realpath(os.fspath(fp))
 
     if filename:
         fp = builtins.open(filename, "rb")
@@ -3421,7 +3439,11 @@ def merge(mode, bands):
 # Plugin registry
 
 
-def register_open(id, factory, accept=None) -> None:
+def register_open(
+    id,
+    factory: Callable[[IO[bytes], str | bytes], ImageFile.ImageFile],
+    accept: Callable[[bytes], bool] | None = None,
+) -> None:
     """
     Register an image file plugin.  This function should not be used
     in application code.
@@ -3631,7 +3653,13 @@ def _apply_env_variables(env=None):
 atexit.register(core.clear_cache)
 
 
-class Exif(MutableMapping):
+if TYPE_CHECKING:
+    _ExifBase = MutableMapping[int, Any]  # pragma: no cover
+else:
+    _ExifBase = MutableMapping
+
+
+class Exif(_ExifBase):
     """
     This class provides read and write access to EXIF image data::
 
diff --git a/src/PIL/ImageQt.py b/src/PIL/ImageQt.py
index 6377c750105..293ba4941e3 100644
--- a/src/PIL/ImageQt.py
+++ b/src/PIL/ImageQt.py
@@ -19,19 +19,26 @@
 
 import sys
 from io import BytesIO
+from typing import Callable
 
 from . import Image
 from ._util import is_path
 
+qt_version: str | None
 qt_versions = [
     ["6", "PyQt6"],
     ["side6", "PySide6"],
 ]
 
 # If a version has already been imported, attempt it first
-qt_versions.sort(key=lambda qt_version: qt_version[1] in sys.modules, reverse=True)
-for qt_version, qt_module in qt_versions:
+qt_versions.sort(key=lambda version: version[1] in sys.modules, reverse=True)
+for version, qt_module in qt_versions:
     try:
+        QBuffer: type
+        QIODevice: type
+        QImage: type
+        QPixmap: type
+        qRgba: Callable[[int, int, int, int], int]
         if qt_module == "PyQt6":
             from PyQt6.QtCore import QBuffer, QIODevice
             from PyQt6.QtGui import QImage, QPixmap, qRgba
@@ -41,6 +48,7 @@
     except (ImportError, RuntimeError):
         continue
     qt_is_installed = True
+    qt_version = version
     break
 else:
     qt_is_installed = False
diff --git a/src/PIL/PdfParser.py b/src/PIL/PdfParser.py
index 0144600066f..9aa8dde8327 100644
--- a/src/PIL/PdfParser.py
+++ b/src/PIL/PdfParser.py
@@ -8,6 +8,7 @@
 import re
 import time
 import zlib
+from typing import TYPE_CHECKING, Any, List, Union
 
 
 # see 7.9.2.2 Text String Type on page 86 and D.3 PDFDocEncoding Character Set
@@ -239,12 +240,18 @@ def __bytes__(self):
         return bytes(result)
 
 
-class PdfArray(list):
+class PdfArray(List[Any]):
     def __bytes__(self):
         return b"[ " + b" ".join(pdf_repr(x) for x in self) + b" ]"
 
 
-class PdfDict(collections.UserDict):
+if TYPE_CHECKING:
+    _DictBase = collections.UserDict[Union[str, bytes], Any]  # pragma: no cover
+else:
+    _DictBase = collections.UserDict
+
+
+class PdfDict(_DictBase):
     def __setattr__(self, key, value):
         if key == "data":
             collections.UserDict.__setattr__(self, key, value)
diff --git a/src/PIL/PyAccess.py b/src/PIL/PyAccess.py
index 07bb712d83e..2c831913d69 100644
--- a/src/PIL/PyAccess.py
+++ b/src/PIL/PyAccess.py
@@ -25,6 +25,7 @@
 
 from ._deprecate import deprecate
 
+FFI: type
 try:
     from cffi import FFI
 
diff --git a/src/PIL/TiffImagePlugin.py b/src/PIL/TiffImagePlugin.py
index e20d4d5ea81..af22d76cbf5 100644
--- a/src/PIL/TiffImagePlugin.py
+++ b/src/PIL/TiffImagePlugin.py
@@ -50,6 +50,7 @@
 from collections.abc import MutableMapping
 from fractions import Fraction
 from numbers import Number, Rational
+from typing import TYPE_CHECKING, Any, Callable
 
 from . import ExifTags, Image, ImageFile, ImageOps, ImagePalette, TiffTags
 from ._binary import i16be as i16
@@ -306,6 +307,13 @@ def _limit_signed_rational(val, max_val, min_val):
 _write_dispatch = {}
 
 
+def _delegate(op):
+    def delegate(self, *args):
+        return getattr(self._val, op)(*args)
+
+    return delegate
+
+
 class IFDRational(Rational):
     """Implements a rational class where 0/0 is a legal value to match
     the in the wild use of exif rationals.
@@ -391,12 +399,6 @@ def __setstate__(self, state):
         self._numerator = _numerator
         self._denominator = _denominator
 
-    def _delegate(op):
-        def delegate(self, *args):
-            return getattr(self._val, op)(*args)
-
-        return delegate
-
     """ a = ['add','radd', 'sub', 'rsub', 'mul', 'rmul',
              'truediv', 'rtruediv', 'floordiv', 'rfloordiv',
              'mod','rmod', 'pow','rpow', 'pos', 'neg',
@@ -436,7 +438,50 @@ def delegate(self, *args):
         __int__ = _delegate("__int__")
 
 
-class ImageFileDirectory_v2(MutableMapping):
+def _register_loader(idx, size):
+    def decorator(func):
+        from .TiffTags import TYPES
+
+        if func.__name__.startswith("load_"):
+            TYPES[idx] = func.__name__[5:].replace("_", " ")
+        _load_dispatch[idx] = size, func  # noqa: F821
+        return func
+
+    return decorator
+
+
+def _register_writer(idx):
+    def decorator(func):
+        _write_dispatch[idx] = func  # noqa: F821
+        return func
+
+    return decorator
+
+
+def _register_basic(idx_fmt_name):
+    from .TiffTags import TYPES
+
+    idx, fmt, name = idx_fmt_name
+    TYPES[idx] = name
+    size = struct.calcsize("=" + fmt)
+    _load_dispatch[idx] = (  # noqa: F821
+        size,
+        lambda self, data, legacy_api=True: (
+            self._unpack(f"{len(data) // size}{fmt}", data)
+        ),
+    )
+    _write_dispatch[idx] = lambda self, *values: (  # noqa: F821
+        b"".join(self._pack(fmt, value) for value in values)
+    )
+
+
+if TYPE_CHECKING:
+    _IFDv2Base = MutableMapping[int, Any]  # pragma: no cover
+else:
+    _IFDv2Base = MutableMapping
+
+
+class ImageFileDirectory_v2(_IFDv2Base):
     """This class represents a TIFF tag directory.  To speed things up, we
     don't decode tags unless they're asked for.
 
@@ -497,6 +542,9 @@ class ImageFileDirectory_v2(MutableMapping):
 
     """
 
+    _load_dispatch: dict[int, Callable[[ImageFileDirectory_v2, bytes, bool], Any]] = {}
+    _write_dispatch: dict[int, Callable[..., Any]] = {}
+
     def __init__(self, ifh=b"II\052\0\0\0\0\0", prefix=None, group=None):
         """Initialize an ImageFileDirectory.
 
@@ -531,7 +579,10 @@ def __init__(self, ifh=b"II\052\0\0\0\0\0", prefix=None, group=None):
 
     prefix = property(lambda self: self._prefix)
     offset = property(lambda self: self._offset)
-    legacy_api = property(lambda self: self._legacy_api)
+
+    @property
+    def legacy_api(self):
+        return self._legacy_api
 
     @legacy_api.setter
     def legacy_api(self, value):
@@ -674,40 +725,6 @@ def _unpack(self, fmt, data):
     def _pack(self, fmt, *values):
         return struct.pack(self._endian + fmt, *values)
 
-    def _register_loader(idx, size):
-        def decorator(func):
-            from .TiffTags import TYPES
-
-            if func.__name__.startswith("load_"):
-                TYPES[idx] = func.__name__[5:].replace("_", " ")
-            _load_dispatch[idx] = size, func  # noqa: F821
-            return func
-
-        return decorator
-
-    def _register_writer(idx):
-        def decorator(func):
-            _write_dispatch[idx] = func  # noqa: F821
-            return func
-
-        return decorator
-
-    def _register_basic(idx_fmt_name):
-        from .TiffTags import TYPES
-
-        idx, fmt, name = idx_fmt_name
-        TYPES[idx] = name
-        size = struct.calcsize("=" + fmt)
-        _load_dispatch[idx] = (  # noqa: F821
-            size,
-            lambda self, data, legacy_api=True: (
-                self._unpack(f"{len(data) // size}{fmt}", data)
-            ),
-        )
-        _write_dispatch[idx] = lambda self, *values: (  # noqa: F821
-            b"".join(self._pack(fmt, value) for value in values)
-        )
-
     list(
         map(
             _register_basic,
@@ -995,7 +1012,7 @@ def __init__(self, *args, **kwargs):
     tagdata = property(lambda self: self._tagdata)
 
     # defined in ImageFileDirectory_v2
-    tagtype: dict
+    tagtype: dict[int, int]
     """Dictionary of tag types"""
 
     @classmethod
@@ -1835,11 +1852,11 @@ def _save(im, fp, filename):
         tags = list(atts.items())
         tags.sort()
         a = (rawmode, compression, _fp, filename, tags, types)
-        e = Image._getencoder(im.mode, "libtiff", a, encoderconfig)
-        e.setimage(im.im, (0, 0) + im.size)
+        encoder = Image._getencoder(im.mode, "libtiff", a, encoderconfig)
+        encoder.setimage(im.im, (0, 0) + im.size)
         while True:
             # undone, change to self.decodermaxblock:
-            errcode, data = e.encode(16 * 1024)[1:]
+            errcode, data = encoder.encode(16 * 1024)[1:]
             if not _fp:
                 fp.write(data)
             if errcode:
diff --git a/src/PIL/TiffTags.py b/src/PIL/TiffTags.py
index 88ff2f4fcd5..b9419393119 100644
--- a/src/PIL/TiffTags.py
+++ b/src/PIL/TiffTags.py
@@ -22,7 +22,7 @@
 
 
 class TagInfo(namedtuple("_TagInfo", "value name type length enum")):
-    __slots__ = []
+    __slots__: list[str] = []
 
     def __new__(cls, value=None, name="unknown", type=None, length=None, enum=None):
         return super().__new__(cls, value, name, type, length, enum or {})
@@ -437,7 +437,7 @@ def _populate():
 ##
 # Map type numbers to type names -- defined in ImageFileDirectory.
 
-TYPES = {}
+TYPES: dict[int, str] = {}
 
 #
 # These tags are handled by default in libtiff, without
diff --git a/src/PIL/_imaging.pyi b/src/PIL/_imaging.pyi
new file mode 100644
index 00000000000..b0235555dc5
--- /dev/null
+++ b/src/PIL/_imaging.pyi
@@ -0,0 +1,5 @@
+from __future__ import annotations
+
+from typing import Any
+
+def __getattr__(name: str) -> Any: ...
diff --git a/src/PIL/_tkinter_finder.py b/src/PIL/_tkinter_finder.py
index 71c0ad4651b..beddfb0628a 100644
--- a/src/PIL/_tkinter_finder.py
+++ b/src/PIL/_tkinter_finder.py
@@ -5,7 +5,8 @@
 
 import sys
 import tkinter
-from tkinter import _tkinter as tk
+
+tk = getattr(tkinter, "_tkinter")
 
 try:
     if hasattr(sys, "pypy_find_executable"):
diff --git a/src/PIL/_webp.pyi b/src/PIL/_webp.pyi
new file mode 100644
index 00000000000..b0235555dc5
--- /dev/null
+++ b/src/PIL/_webp.pyi
@@ -0,0 +1,5 @@
+from __future__ import annotations
+
+from typing import Any
+
+def __getattr__(name: str) -> Any: ...
diff --git a/tox.ini b/tox.ini
index fb6746ce7bf..8c818df7a6a 100644
--- a/tox.ini
+++ b/tox.ini
@@ -33,9 +33,14 @@ commands =
 [testenv:mypy]
 skip_install = true
 deps =
+    IceSpringPySideStubs-PyQt6
+    IceSpringPySideStubs-PySide6
     ipython
     mypy==1.7.1
     numpy
+    packaging
+    types-cffi
+    types-defusedxml
 extras =
     typing
 commands =

From 517b797132a65a8a873d0c22008d760d2a706ff6 Mon Sep 17 00:00:00 2001
From: Andrew Murray <radarhere@users.noreply.github.com>
Date: Sat, 10 Feb 2024 20:47:32 +1100
Subject: [PATCH 0180/1178] Removed FileDescriptor

---
 src/PIL/GdImageFile.py | 6 ++----
 src/PIL/_typing.py     | 3 +--
 2 files changed, 3 insertions(+), 6 deletions(-)

diff --git a/src/PIL/GdImageFile.py b/src/PIL/GdImageFile.py
index 315ac6d6c1a..88b87a22cd6 100644
--- a/src/PIL/GdImageFile.py
+++ b/src/PIL/GdImageFile.py
@@ -32,7 +32,7 @@ class is not registered for use with :py:func:`PIL.Image.open()`.  To open a
 from . import ImageFile, ImagePalette, UnidentifiedImageError
 from ._binary import i16be as i16
 from ._binary import i32be as i32
-from ._typing import FileDescriptor, StrOrBytesPath
+from ._typing import StrOrBytesPath
 
 
 class GdImageFile(ImageFile.ImageFile):
@@ -81,9 +81,7 @@ def _open(self) -> None:
         ]
 
 
-def open(
-    fp: StrOrBytesPath | FileDescriptor | IO[bytes], mode: str = "r"
-) -> GdImageFile:
+def open(fp: StrOrBytesPath | IO[bytes], mode: str = "r") -> GdImageFile:
     """
     Load texture from a GD image file.
 
diff --git a/src/PIL/_typing.py b/src/PIL/_typing.py
index 346702037d2..7075e86726a 100644
--- a/src/PIL/_typing.py
+++ b/src/PIL/_typing.py
@@ -27,8 +27,7 @@ class SupportsRead(Protocol[_T_co]):
     def read(self, __length: int = ...) -> _T_co: ...
 
 
-FileDescriptor = int
 StrOrBytesPath = Union[str, bytes, "os.PathLike[str]", "os.PathLike[bytes]"]
 
 
-__all__ = ["FileDescriptor", "TypeGuard", "StrOrBytesPath", "SupportsRead"]
+__all__ = ["TypeGuard", "StrOrBytesPath", "SupportsRead"]

From 430f50606e2fc5620c6605cd43eb360be6bbd655 Mon Sep 17 00:00:00 2001
From: Andrew Murray <radarhere@users.noreply.github.com>
Date: Sat, 10 Feb 2024 21:33:32 +1100
Subject: [PATCH 0181/1178] Current delta is determined by previous disposal

---
 Tests/test_file_gif.py    | 19 +++++++++++++++++++
 src/PIL/GifImagePlugin.py | 10 +++-------
 2 files changed, 22 insertions(+), 7 deletions(-)

diff --git a/Tests/test_file_gif.py b/Tests/test_file_gif.py
index 0399c6b6798..6527d90de96 100644
--- a/Tests/test_file_gif.py
+++ b/Tests/test_file_gif.py
@@ -737,6 +737,25 @@ def test_dispose2_background_frame(tmp_path: Path) -> None:
         assert im.n_frames == 3
 
 
+def test_dispose2_previous_frame(tmp_path: Path) -> None:
+    out = str(tmp_path / "temp.gif")
+
+    im = Image.new("P", (100, 100))
+    im.info["transparency"] = 0
+    d = ImageDraw.Draw(im)
+    d.rectangle([(0, 0), (100, 50)], 1)
+    im.putpalette((0, 0, 0, 255, 0, 0))
+
+    im2 = Image.new("P", (100, 100))
+    im2.putpalette((0, 0, 0))
+
+    im.save(out, save_all=True, append_images=[im2], disposal=[0, 2])
+
+    with Image.open(out) as im:
+        im.seek(1)
+        assert im.getpixel((0, 0)) == (0, 0, 0, 255)
+
+
 def test_transparency_in_second_frame(tmp_path: Path) -> None:
     out = str(tmp_path / "temp.gif")
     with Image.open("Tests/images/different_transparency.gif") as im:
diff --git a/src/PIL/GifImagePlugin.py b/src/PIL/GifImagePlugin.py
index 73a5487d9a7..9368dd7e7c4 100644
--- a/src/PIL/GifImagePlugin.py
+++ b/src/PIL/GifImagePlugin.py
@@ -629,7 +629,7 @@ def _write_multiple_frames(im, fp, palette):
                             "duration"
                         ]
                     continue
-                if encoderinfo.get("disposal") == 2:
+                if im_frames[-1]["encoderinfo"].get("disposal") == 2:
                     if background_im is None:
                         color = im.encoderinfo.get(
                             "transparency", im.info.get("transparency", (0, 0, 0))
@@ -637,12 +637,8 @@ def _write_multiple_frames(im, fp, palette):
                         background = _get_background(im_frame, color)
                         background_im = Image.new("P", im_frame.size, background)
                         background_im.putpalette(im_frames[0]["im"].palette)
-                    delta, bbox = _getbbox(background_im, im_frame)
-                if (
-                    encoderinfo.get("optimize")
-                    and im_frames[-1]["encoderinfo"].get("disposal") != 2
-                    and im_frame.mode != "1"
-                ):
+                    bbox = _getbbox(background_im, im_frame)[1]
+                elif encoderinfo.get("optimize") and im_frame.mode != "1":
                     if "transparency" not in encoderinfo:
                         try:
                             encoderinfo["transparency"] = (

From 68db96981c0819efc51bea995915eaa389a292e7 Mon Sep 17 00:00:00 2001
From: Andrew Murray <3112309+radarhere@users.noreply.github.com>
Date: Sat, 10 Feb 2024 21:50:48 +1100
Subject: [PATCH 0182/1178] Removed else

Co-authored-by: Hugo van Kemenade <1324225+hugovk@users.noreply.github.com>
---
 src/PIL/Image.py | 3 +--
 1 file changed, 1 insertion(+), 2 deletions(-)

diff --git a/src/PIL/Image.py b/src/PIL/Image.py
index d32a0fc199e..c3ab6217452 100644
--- a/src/PIL/Image.py
+++ b/src/PIL/Image.py
@@ -2526,8 +2526,7 @@ def split(self) -> tuple[Image, ...]:
         self.load()
         if self.im.bands == 1:
             return (self.copy(),)
-        else:
-            return tuple(map(self._new, self.im.split()))
+        return tuple(map(self._new, self.im.split()))
 
     def getchannel(self, channel):
         """

From d02a778efd443db9f69233763f187e14eebde6db Mon Sep 17 00:00:00 2001
From: Andrew Murray <3112309+radarhere@users.noreply.github.com>
Date: Sat, 10 Feb 2024 21:57:59 +1100
Subject: [PATCH 0183/1178] Removed no cover pragmas

Co-authored-by: Hugo van Kemenade <1324225+hugovk@users.noreply.github.com>
---
 src/PIL/Image.py           | 6 +++---
 src/PIL/PdfParser.py       | 2 +-
 src/PIL/TiffImagePlugin.py | 2 +-
 3 files changed, 5 insertions(+), 5 deletions(-)

diff --git a/src/PIL/Image.py b/src/PIL/Image.py
index c3ab6217452..d9d708d5da4 100644
--- a/src/PIL/Image.py
+++ b/src/PIL/Image.py
@@ -217,7 +217,7 @@ class Quantize(IntEnum):
 # Registries
 
 if TYPE_CHECKING:
-    from . import ImageFile  # pragma: no cover
+    from . import ImageFile
 ID: list[str] = []
 OPEN: dict[
     str,
@@ -2890,7 +2890,7 @@ def transform(
         image: Image,
         **options: dict[str, str | int | tuple[int, ...] | list[int]],
     ) -> Image:
-        pass  # pragma: no cover
+        pass
 
 
 # --------------------------------------------------------------------
@@ -3653,7 +3653,7 @@ def _apply_env_variables(env=None):
 
 
 if TYPE_CHECKING:
-    _ExifBase = MutableMapping[int, Any]  # pragma: no cover
+    _ExifBase = MutableMapping[int, Any]
 else:
     _ExifBase = MutableMapping
 
diff --git a/src/PIL/PdfParser.py b/src/PIL/PdfParser.py
index 9aa8dde8327..4c510173814 100644
--- a/src/PIL/PdfParser.py
+++ b/src/PIL/PdfParser.py
@@ -246,7 +246,7 @@ def __bytes__(self):
 
 
 if TYPE_CHECKING:
-    _DictBase = collections.UserDict[Union[str, bytes], Any]  # pragma: no cover
+    _DictBase = collections.UserDict[Union[str, bytes], Any]
 else:
     _DictBase = collections.UserDict
 
diff --git a/src/PIL/TiffImagePlugin.py b/src/PIL/TiffImagePlugin.py
index af22d76cbf5..3ba4de9d12e 100644
--- a/src/PIL/TiffImagePlugin.py
+++ b/src/PIL/TiffImagePlugin.py
@@ -476,7 +476,7 @@ def _register_basic(idx_fmt_name):
 
 
 if TYPE_CHECKING:
-    _IFDv2Base = MutableMapping[int, Any]  # pragma: no cover
+    _IFDv2Base = MutableMapping[int, Any]
 else:
     _IFDv2Base = MutableMapping
 

From 8ef0ffc2b849245bde6f96b58b4af48bf498bda7 Mon Sep 17 00:00:00 2001
From: Andrew Murray <radarhere@users.noreply.github.com>
Date: Sat, 10 Feb 2024 22:37:42 +1100
Subject: [PATCH 0184/1178] Removed no cover pragma

---
 src/PIL/ImageShow.py | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/src/PIL/ImageShow.py b/src/PIL/ImageShow.py
index c03122c11aa..d90545e92ec 100644
--- a/src/PIL/ImageShow.py
+++ b/src/PIL/ImageShow.py
@@ -184,7 +184,7 @@ class UnixViewer(Viewer):
 
     @abc.abstractmethod
     def get_command_ex(self, file: str, **options: Any) -> tuple[str, str]:
-        pass  # pragma: no cover
+        pass
 
     def get_command(self, file: str, **options: Any) -> str:
         command = self.get_command_ex(file, **options)[0]

From e614bbfe501811bcb4a080ba9f07d745ba3ad231 Mon Sep 17 00:00:00 2001
From: Andrew Murray <radarhere@users.noreply.github.com>
Date: Sat, 10 Feb 2024 22:39:18 +1100
Subject: [PATCH 0185/1178] Exclude code only for type checking

---
 .coveragerc | 1 +
 1 file changed, 1 insertion(+)

diff --git a/.coveragerc b/.coveragerc
index 46df3f90d27..115286b749c 100644
--- a/.coveragerc
+++ b/.coveragerc
@@ -10,6 +10,7 @@ exclude_also =
     if DEBUG:
     # Don't complain about compatibility code for missing optional dependencies
     except ImportError
+    if TYPE_CHECKING:
 
 [run]
 omit =

From 112a5a4813f34235530c2ac382108a5cf722789a Mon Sep 17 00:00:00 2001
From: Andrew Murray <radarhere@users.noreply.github.com>
Date: Sat, 10 Feb 2024 22:40:24 +1100
Subject: [PATCH 0186/1178] Exclude abstract methods

---
 .coveragerc | 1 +
 1 file changed, 1 insertion(+)

diff --git a/.coveragerc b/.coveragerc
index 115286b749c..ca5f114c645 100644
--- a/.coveragerc
+++ b/.coveragerc
@@ -11,6 +11,7 @@ exclude_also =
     # Don't complain about compatibility code for missing optional dependencies
     except ImportError
     if TYPE_CHECKING:
+    @abc.abstractmethod
 
 [run]
 omit =

From 3977124908b934a9b037d1e8ba5549393bed9dda Mon Sep 17 00:00:00 2001
From: Hugo van Kemenade <1324225+hugovk@users.noreply.github.com>
Date: Sat, 10 Feb 2024 14:54:20 +0200
Subject: [PATCH 0187/1178] Update docs/reference/internal_modules.rst

Co-authored-by: Andrew Murray <3112309+radarhere@users.noreply.github.com>
---
 docs/reference/internal_modules.rst | 4 ----
 1 file changed, 4 deletions(-)

diff --git a/docs/reference/internal_modules.rst b/docs/reference/internal_modules.rst
index c3cc700607f..899e4966ff2 100644
--- a/docs/reference/internal_modules.rst
+++ b/docs/reference/internal_modules.rst
@@ -33,10 +33,6 @@ Internal Modules
 Provides a convenient way to import type hints that are not available
 on some Python versions.
 
-.. py:class:: FileDescriptor
-
-    Typing alias.
-
 .. py:class:: StrOrBytesPath
 
     Typing alias.

From 3f6422b512ff39cffaa5a37915c970d7683b6d62 Mon Sep 17 00:00:00 2001
From: Andrew Murray <radarhere@users.noreply.github.com>
Date: Mon, 12 Feb 2024 09:28:53 +1100
Subject: [PATCH 0188/1178] Added type hints

---
 Tests/helper.py                |  2 +-
 Tests/test_image_access.py     | 47 ++++++++++++++++++--------------
 Tests/test_image_array.py      | 10 ++++---
 Tests/test_image_draft.py      |  7 ++++-
 Tests/test_image_entropy.py    |  2 +-
 Tests/test_image_filter.py     | 27 ++++++++++++------
 Tests/test_image_getextrema.py |  2 +-
 Tests/test_image_getpalette.py |  2 +-
 Tests/test_image_paste.py      | 14 +++++-----
 Tests/test_image_putdata.py    |  6 ++--
 Tests/test_image_putpalette.py |  4 +--
 Tests/test_image_resample.py   |  8 ++++--
 Tests/test_image_rotate.py     | 14 +++++++---
 Tests/test_image_thumbnail.py  |  2 +-
 Tests/test_image_transform.py  | 50 ++++++++++++++++++++++++----------
 15 files changed, 124 insertions(+), 73 deletions(-)

diff --git a/Tests/helper.py b/Tests/helper.py
index 3e2a40e02da..b9888394659 100644
--- a/Tests/helper.py
+++ b/Tests/helper.py
@@ -244,7 +244,7 @@ def fromstring(data: bytes) -> Image.Image:
     return Image.open(BytesIO(data))
 
 
-def tostring(im: Image.Image, string_format: str, **options: dict[str, Any]) -> bytes:
+def tostring(im: Image.Image, string_format: str, **options: Any) -> bytes:
     out = BytesIO()
     im.save(out, string_format, **options)
     return out.getvalue()
diff --git a/Tests/test_image_access.py b/Tests/test_image_access.py
index e4cb2dad102..3bdaea75026 100644
--- a/Tests/test_image_access.py
+++ b/Tests/test_image_access.py
@@ -4,6 +4,7 @@
 import subprocess
 import sys
 import sysconfig
+from types import ModuleType
 
 import pytest
 
@@ -23,6 +24,7 @@
     except ImportError:
         cffi = None
 
+numpy: ModuleType | None
 try:
     import numpy
 except ImportError:
@@ -71,9 +73,10 @@ def test_sanity(self) -> None:
         pix1 = im1.load()
         pix2 = im2.load()
 
-        for x, y in ((0, "0"), ("0", 0)):
-            with pytest.raises(TypeError):
-                pix1[x, y]
+        with pytest.raises(TypeError):
+            pix1[0, "0"]
+        with pytest.raises(TypeError):
+            pix1["0", 0]
 
         for y in range(im1.size[1]):
             for x in range(im1.size[0]):
@@ -123,12 +126,13 @@ def test_numpy(self) -> None:
         im = hopper()
         pix = im.load()
 
+        assert numpy is not None
         assert pix[numpy.int32(1), numpy.int32(2)] == (18, 20, 59)
 
 
 class TestImageGetPixel(AccessTest):
     @staticmethod
-    def color(mode):
+    def color(mode: str) -> int | tuple[int, ...]:
         bands = Image.getmodebands(mode)
         if bands == 1:
             return 1
@@ -138,12 +142,13 @@ def color(mode):
             return (16, 32, 49)
         return tuple(range(1, bands + 1))
 
-    def check(self, mode, expected_color=None) -> None:
+    def check(self, mode: str, expected_color_int: int | None = None) -> None:
         if self._need_cffi_access and mode.startswith("BGR;"):
             pytest.skip("Support not added to deprecated module for BGR;* modes")
 
-        if not expected_color:
-            expected_color = self.color(mode)
+        expected_color = (
+            expected_color_int if expected_color_int is not None else self.color(mode)
+        )
 
         # check putpixel
         im = Image.new(mode, (1, 1), None)
@@ -222,7 +227,7 @@ def check(self, mode, expected_color=None) -> None:
             "YCbCr",
         ),
     )
-    def test_basic(self, mode) -> None:
+    def test_basic(self, mode: str) -> None:
         self.check(mode)
 
     def test_list(self) -> None:
@@ -231,14 +236,14 @@ def test_list(self) -> None:
 
     @pytest.mark.parametrize("mode", ("I;16", "I;16B"))
     @pytest.mark.parametrize("expected_color", (2**15 - 1, 2**15, 2**15 + 1, 2**16 - 1))
-    def test_signedness(self, mode, expected_color) -> None:
+    def test_signedness(self, mode: str, expected_color: int) -> None:
         # see https://github.com/python-pillow/Pillow/issues/452
         # pixelaccess is using signed int* instead of uint*
         self.check(mode, expected_color)
 
     @pytest.mark.parametrize("mode", ("P", "PA"))
     @pytest.mark.parametrize("color", ((255, 0, 0), (255, 0, 0, 255)))
-    def test_p_putpixel_rgb_rgba(self, mode, color) -> None:
+    def test_p_putpixel_rgb_rgba(self, mode: str, color: tuple[int, ...]) -> None:
         im = Image.new(mode, (1, 1))
         im.putpixel((0, 0), color)
 
@@ -262,7 +267,7 @@ class TestCffiGetPixel(TestImageGetPixel):
 class TestCffi(AccessTest):
     _need_cffi_access = True
 
-    def _test_get_access(self, im) -> None:
+    def _test_get_access(self, im: Image.Image) -> None:
         """Do we get the same thing as the old pixel access
 
         Using private interfaces, forcing a capi access and
@@ -299,7 +304,7 @@ def test_get_vs_c(self) -> None:
         # im = Image.new('I;32B', (10, 10), 2**10)
         # self._test_get_access(im)
 
-    def _test_set_access(self, im, color) -> None:
+    def _test_set_access(self, im: Image.Image, color: tuple[int, ...] | float) -> None:
         """Are we writing the correct bits into the image?
 
         Using private interfaces, forcing a capi access and
@@ -359,7 +364,7 @@ def test_reference_counting(self) -> None:
                 assert px[i, 0] == 0
 
     @pytest.mark.parametrize("mode", ("P", "PA"))
-    def test_p_putpixel_rgb_rgba(self, mode) -> None:
+    def test_p_putpixel_rgb_rgba(self, mode: str) -> None:
         for color in ((255, 0, 0), (255, 0, 0, 127 if mode == "PA" else 255)):
             im = Image.new(mode, (1, 1))
             with pytest.warns(DeprecationWarning):
@@ -377,7 +382,7 @@ class TestImagePutPixelError(AccessTest):
     INVALID_TYPES = ["foo", 1.0, None]
 
     @pytest.mark.parametrize("mode", IMAGE_MODES1)
-    def test_putpixel_type_error1(self, mode) -> None:
+    def test_putpixel_type_error1(self, mode: str) -> None:
         im = hopper(mode)
         for v in self.INVALID_TYPES:
             with pytest.raises(TypeError, match="color must be int or tuple"):
@@ -400,14 +405,16 @@ def test_putpixel_type_error1(self, mode) -> None:
             ),
         ),
     )
-    def test_putpixel_invalid_number_of_bands(self, mode, band_numbers, match) -> None:
+    def test_putpixel_invalid_number_of_bands(
+        self, mode: str, band_numbers: tuple[int, ...], match: str
+    ) -> None:
         im = hopper(mode)
         for band_number in band_numbers:
             with pytest.raises(TypeError, match=match):
                 im.putpixel((0, 0), (0,) * band_number)
 
     @pytest.mark.parametrize("mode", IMAGE_MODES2)
-    def test_putpixel_type_error2(self, mode) -> None:
+    def test_putpixel_type_error2(self, mode: str) -> None:
         im = hopper(mode)
         for v in self.INVALID_TYPES:
             with pytest.raises(
@@ -416,7 +423,7 @@ def test_putpixel_type_error2(self, mode) -> None:
                 im.putpixel((0, 0), v)
 
     @pytest.mark.parametrize("mode", IMAGE_MODES1 + IMAGE_MODES2)
-    def test_putpixel_overflow_error(self, mode) -> None:
+    def test_putpixel_overflow_error(self, mode: str) -> None:
         im = hopper(mode)
         with pytest.raises(OverflowError):
             im.putpixel((0, 0), 2**80)
@@ -428,7 +435,7 @@ class TestEmbeddable:
     def test_embeddable(self) -> None:
         import ctypes
 
-        from setuptools.command.build_ext import new_compiler
+        from setuptools.command import build_ext
 
         with open("embed_pil.c", "w", encoding="utf-8") as fh:
             fh.write(
@@ -457,7 +464,7 @@ def test_embeddable(self) -> None:
                 % sys.prefix.replace("\\", "\\\\")
             )
 
-        compiler = new_compiler()
+        compiler = getattr(build_ext, "new_compiler")()
         compiler.add_include_dir(sysconfig.get_config_var("INCLUDEPY"))
 
         libdir = sysconfig.get_config_var("LIBDIR") or sysconfig.get_config_var(
@@ -471,7 +478,7 @@ def test_embeddable(self) -> None:
         env["PATH"] = sys.prefix + ";" + env["PATH"]
 
         # do not display the Windows Error Reporting dialog
-        ctypes.windll.kernel32.SetErrorMode(0x0002)
+        getattr(ctypes, "windll").kernel32.SetErrorMode(0x0002)
 
         process = subprocess.Popen(["embed_pil.exe"], env=env)
         process.communicate()
diff --git a/Tests/test_image_array.py b/Tests/test_image_array.py
index 0125ab56af9..cf85ee4fa1c 100644
--- a/Tests/test_image_array.py
+++ b/Tests/test_image_array.py
@@ -1,5 +1,7 @@
 from __future__ import annotations
 
+from typing import Any
+
 import pytest
 from packaging.version import parse as parse_version
 
@@ -13,7 +15,7 @@
 
 
 def test_toarray() -> None:
-    def test(mode):
+    def test(mode: str) -> tuple[tuple[int, ...], str, int]:
         ai = numpy.array(im.convert(mode))
         return ai.shape, ai.dtype.str, ai.nbytes
 
@@ -50,14 +52,14 @@ def test_fromarray() -> None:
     class Wrapper:
         """Class with API matching Image.fromarray"""
 
-        def __init__(self, img, arr_params) -> None:
+        def __init__(self, img: Image.Image, arr_params: dict[str, Any]) -> None:
             self.img = img
             self.__array_interface__ = arr_params
 
-        def tobytes(self):
+        def tobytes(self) -> bytes:
             return self.img.tobytes()
 
-    def test(mode):
+    def test(mode: str) -> tuple[str, tuple[int, int], bool]:
         i = im.convert(mode)
         a = numpy.array(i)
         # Make wrapper instance for image, new array interface
diff --git a/Tests/test_image_draft.py b/Tests/test_image_draft.py
index 54474311a09..1ce1a7cd8f6 100644
--- a/Tests/test_image_draft.py
+++ b/Tests/test_image_draft.py
@@ -7,7 +7,12 @@
 pytestmark = skip_unless_feature("jpg")
 
 
-def draft_roundtrip(in_mode, in_size, req_mode, req_size):
+def draft_roundtrip(
+    in_mode: str,
+    in_size: tuple[int, int],
+    req_mode: str | None,
+    req_size: tuple[int, int] | None,
+) -> Image.Image:
     im = Image.new(in_mode, in_size)
     data = tostring(im, "JPEG")
     im = fromstring(data)
diff --git a/Tests/test_image_entropy.py b/Tests/test_image_entropy.py
index 01107ae6b88..c1dbb879b0b 100644
--- a/Tests/test_image_entropy.py
+++ b/Tests/test_image_entropy.py
@@ -4,7 +4,7 @@
 
 
 def test_entropy() -> None:
-    def entropy(mode):
+    def entropy(mode: str) -> float:
         return hopper(mode).entropy()
 
     assert round(abs(entropy("1") - 0.9138803254693582), 7) == 0
diff --git a/Tests/test_image_filter.py b/Tests/test_image_filter.py
index 2b6787933cd..6a10ae4532b 100644
--- a/Tests/test_image_filter.py
+++ b/Tests/test_image_filter.py
@@ -36,7 +36,7 @@
     ),
 )
 @pytest.mark.parametrize("mode", ("L", "I", "RGB", "CMYK"))
-def test_sanity(filter_to_apply, mode) -> None:
+def test_sanity(filter_to_apply: ImageFilter.Filter, mode: str) -> None:
     im = hopper(mode)
     if mode != "I" or isinstance(filter_to_apply, ImageFilter.BuiltinFilter):
         out = im.filter(filter_to_apply)
@@ -45,7 +45,7 @@ def test_sanity(filter_to_apply, mode) -> None:
 
 
 @pytest.mark.parametrize("mode", ("L", "I", "RGB", "CMYK"))
-def test_sanity_error(mode) -> None:
+def test_sanity_error(mode: str) -> None:
     with pytest.raises(TypeError):
         im = hopper(mode)
         im.filter("hello")
@@ -53,7 +53,7 @@ def test_sanity_error(mode) -> None:
 
 # crashes on small images
 @pytest.mark.parametrize("size", ((1, 1), (2, 2), (3, 3)))
-def test_crash(size) -> None:
+def test_crash(size: tuple[int, int]) -> None:
     im = Image.new("RGB", size)
     im.filter(ImageFilter.SMOOTH)
 
@@ -67,7 +67,10 @@ def test_crash(size) -> None:
         ("RGB", ((4, 0, 0), (0, 0, 0))),
     ),
 )
-def test_modefilter(mode, expected) -> None:
+def test_modefilter(
+    mode: str,
+    expected: tuple[int, int] | tuple[tuple[int, int, int], tuple[int, int, int]],
+) -> None:
     im = Image.new(mode, (3, 3), None)
     im.putdata(list(range(9)))
     # image is:
@@ -90,7 +93,13 @@ def test_modefilter(mode, expected) -> None:
         ("F", (0.0, 4.0, 8.0)),
     ),
 )
-def test_rankfilter(mode, expected) -> None:
+def test_rankfilter(
+    mode: str,
+    expected: (
+        tuple[float, float, float]
+        | tuple[tuple[int, int, int], tuple[int, int, int], tuple[int, int, int]]
+    ),
+) -> None:
     im = Image.new(mode, (3, 3), None)
     im.putdata(list(range(9)))
     # image is:
@@ -106,7 +115,7 @@ def test_rankfilter(mode, expected) -> None:
 @pytest.mark.parametrize(
     "filter", (ImageFilter.MinFilter, ImageFilter.MedianFilter, ImageFilter.MaxFilter)
 )
-def test_rankfilter_error(filter) -> None:
+def test_rankfilter_error(filter: ImageFilter.RankFilter) -> None:
     with pytest.raises(ValueError):
         im = Image.new("P", (3, 3), None)
         im.putdata(list(range(9)))
@@ -137,7 +146,7 @@ def test_kernel_not_enough_coefficients() -> None:
 
 
 @pytest.mark.parametrize("mode", ("L", "LA", "I", "RGB", "CMYK"))
-def test_consistency_3x3(mode) -> None:
+def test_consistency_3x3(mode: str) -> None:
     with Image.open("Tests/images/hopper.bmp") as source:
         reference_name = "hopper_emboss"
         reference_name += "_I.png" if mode == "I" else ".bmp"
@@ -163,7 +172,7 @@ def test_consistency_3x3(mode) -> None:
 
 
 @pytest.mark.parametrize("mode", ("L", "LA", "I", "RGB", "CMYK"))
-def test_consistency_5x5(mode) -> None:
+def test_consistency_5x5(mode: str) -> None:
     with Image.open("Tests/images/hopper.bmp") as source:
         reference_name = "hopper_emboss_more"
         reference_name += "_I.png" if mode == "I" else ".bmp"
@@ -199,7 +208,7 @@ def test_consistency_5x5(mode) -> None:
         (2, -2),
     ),
 )
-def test_invalid_box_blur_filter(radius) -> None:
+def test_invalid_box_blur_filter(radius: int | tuple[int, int]) -> None:
     with pytest.raises(ValueError):
         ImageFilter.BoxBlur(radius)
 
diff --git a/Tests/test_image_getextrema.py b/Tests/test_image_getextrema.py
index 0107fdcc426..a5b974459a6 100644
--- a/Tests/test_image_getextrema.py
+++ b/Tests/test_image_getextrema.py
@@ -6,7 +6,7 @@
 
 
 def test_extrema() -> None:
-    def extrema(mode):
+    def extrema(mode: str) -> tuple[int, int] | tuple[tuple[int, int], ...]:
         return hopper(mode).getextrema()
 
     assert extrema("1") == (0, 255)
diff --git a/Tests/test_image_getpalette.py b/Tests/test_image_getpalette.py
index e7304c98f30..6a8f157fc3e 100644
--- a/Tests/test_image_getpalette.py
+++ b/Tests/test_image_getpalette.py
@@ -6,7 +6,7 @@
 
 
 def test_palette() -> None:
-    def palette(mode):
+    def palette(mode: str) -> list[int] | None:
         p = hopper(mode).getpalette()
         if p:
             return p[:10]
diff --git a/Tests/test_image_paste.py b/Tests/test_image_paste.py
index c4d7a5dd254..ce73455729a 100644
--- a/Tests/test_image_paste.py
+++ b/Tests/test_image_paste.py
@@ -46,7 +46,7 @@ def assert_9points_paste(
         self.assert_9points_image(im, expected)
 
     @CachedProperty
-    def mask_1(self):
+    def mask_1(self) -> Image.Image:
         mask = Image.new("1", (self.size, self.size))
         px = mask.load()
         for y in range(mask.height):
@@ -55,11 +55,11 @@ def mask_1(self):
         return mask
 
     @CachedProperty
-    def mask_L(self):
+    def mask_L(self) -> Image.Image:
         return self.gradient_L.transpose(Image.Transpose.ROTATE_270)
 
     @CachedProperty
-    def gradient_L(self):
+    def gradient_L(self) -> Image.Image:
         gradient = Image.new("L", (self.size, self.size))
         px = gradient.load()
         for y in range(gradient.height):
@@ -68,7 +68,7 @@ def gradient_L(self):
         return gradient
 
     @CachedProperty
-    def gradient_RGB(self):
+    def gradient_RGB(self) -> Image.Image:
         return Image.merge(
             "RGB",
             [
@@ -79,7 +79,7 @@ def gradient_RGB(self):
         )
 
     @CachedProperty
-    def gradient_LA(self):
+    def gradient_LA(self) -> Image.Image:
         return Image.merge(
             "LA",
             [
@@ -89,7 +89,7 @@ def gradient_LA(self):
         )
 
     @CachedProperty
-    def gradient_RGBA(self):
+    def gradient_RGBA(self) -> Image.Image:
         return Image.merge(
             "RGBA",
             [
@@ -101,7 +101,7 @@ def gradient_RGBA(self):
         )
 
     @CachedProperty
-    def gradient_RGBa(self):
+    def gradient_RGBa(self) -> Image.Image:
         return Image.merge(
             "RGBa",
             [
diff --git a/Tests/test_image_putdata.py b/Tests/test_image_putdata.py
index 10301991624..73145faac15 100644
--- a/Tests/test_image_putdata.py
+++ b/Tests/test_image_putdata.py
@@ -31,7 +31,7 @@ def test_sanity() -> None:
 
 def test_long_integers() -> None:
     # see bug-200802-systemerror
-    def put(value):
+    def put(value: int) -> tuple[int, int, int, int]:
         im = Image.new("RGBA", (1, 1))
         im.putdata([value])
         return im.getpixel((0, 0))
@@ -58,7 +58,7 @@ def test_mode_with_L_with_float() -> None:
 
 
 @pytest.mark.parametrize("mode", ("I", "I;16", "I;16L", "I;16B"))
-def test_mode_i(mode) -> None:
+def test_mode_i(mode: str) -> None:
     src = hopper("L")
     data = list(src.getdata())
     im = Image.new(mode, src.size, 0)
@@ -79,7 +79,7 @@ def test_mode_F() -> None:
 
 
 @pytest.mark.parametrize("mode", ("BGR;15", "BGR;16", "BGR;24"))
-def test_mode_BGR(mode) -> None:
+def test_mode_BGR(mode: str) -> None:
     data = [(16, 32, 49), (32, 32, 98)]
     im = Image.new(mode, (1, 2))
     im.putdata(data)
diff --git a/Tests/test_image_putpalette.py b/Tests/test_image_putpalette.py
index ffe2551d239..cc7cf58f0fc 100644
--- a/Tests/test_image_putpalette.py
+++ b/Tests/test_image_putpalette.py
@@ -8,7 +8,7 @@
 
 
 def test_putpalette() -> None:
-    def palette(mode):
+    def palette(mode: str) -> str | tuple[str, list[int]]:
         im = hopper(mode).copy()
         im.putpalette(list(range(256)) * 3)
         p = im.getpalette()
@@ -81,7 +81,7 @@ def test_putpalette_with_alpha_values() -> None:
         ("RGBAX", (1, 2, 3, 4, 0)),
     ),
 )
-def test_rgba_palette(mode, palette) -> None:
+def test_rgba_palette(mode: str, palette: tuple[int, ...]) -> None:
     im = Image.new("P", (1, 1))
     im.putpalette(palette, mode)
     assert im.getpalette() == [1, 2, 3]
diff --git a/Tests/test_image_resample.py b/Tests/test_image_resample.py
index f3ec12c053b..7090ff9cdb8 100644
--- a/Tests/test_image_resample.py
+++ b/Tests/test_image_resample.py
@@ -231,11 +231,13 @@ def test_box_filter_correct_range(self) -> None:
 
 
 class TestCoreResampleConsistency:
-    def make_case(self, mode: str, fill: tuple[int, int, int] | float):
+    def make_case(
+        self, mode: str, fill: tuple[int, int, int] | float
+    ) -> tuple[Image.Image, tuple[int, ...]]:
         im = Image.new(mode, (512, 9), fill)
         return im.resize((9, 512), Image.Resampling.LANCZOS), im.load()[0, 0]
 
-    def run_case(self, case) -> None:
+    def run_case(self, case: tuple[Image.Image, Image.Image]) -> None:
         channel, color = case
         px = channel.load()
         for x in range(channel.size[0]):
@@ -353,7 +355,7 @@ def test_dirty_pixels_la(self) -> None:
 
 class TestCoreResamplePasses:
     @contextmanager
-    def count(self, diff):
+    def count(self, diff: int) -> Generator[None, None, None]:
         count = Image.core.get_stats()["new_count"]
         yield
         assert Image.core.get_stats()["new_count"] - count == diff
diff --git a/Tests/test_image_rotate.py b/Tests/test_image_rotate.py
index 51e0f585421..c10c96da6f9 100644
--- a/Tests/test_image_rotate.py
+++ b/Tests/test_image_rotate.py
@@ -12,7 +12,13 @@
 )
 
 
-def rotate(im, mode, angle, center=None, translate=None) -> None:
+def rotate(
+    im: Image.Image,
+    mode: str,
+    angle: int,
+    center: tuple[int, int] | None = None,
+    translate: tuple[int, int] | None = None,
+) -> None:
     out = im.rotate(angle, center=center, translate=translate)
     assert out.mode == mode
     assert out.size == im.size  # default rotate clips output
@@ -27,13 +33,13 @@ def rotate(im, mode, angle, center=None, translate=None) -> None:
 
 
 @pytest.mark.parametrize("mode", ("1", "P", "L", "RGB", "I", "F"))
-def test_mode(mode) -> None:
+def test_mode(mode: str) -> None:
     im = hopper(mode)
     rotate(im, mode, 45)
 
 
 @pytest.mark.parametrize("angle", (0, 90, 180, 270))
-def test_angle(angle) -> None:
+def test_angle(angle: int) -> None:
     with Image.open("Tests/images/test-card.png") as im:
         rotate(im, im.mode, angle)
 
@@ -42,7 +48,7 @@ def test_angle(angle) -> None:
 
 
 @pytest.mark.parametrize("angle", (0, 45, 90, 180, 270))
-def test_zero(angle) -> None:
+def test_zero(angle: int) -> None:
     im = Image.new("RGB", (0, 0))
     rotate(im, im.mode, angle)
 
diff --git a/Tests/test_image_thumbnail.py b/Tests/test_image_thumbnail.py
index 6aeeea2ed0d..2ca1d2cfc03 100644
--- a/Tests/test_image_thumbnail.py
+++ b/Tests/test_image_thumbnail.py
@@ -111,7 +111,7 @@ def test_load_first_unless_jpeg() -> None:
     with Image.open("Tests/images/hopper.jpg") as im:
         draft = im.draft
 
-        def im_draft(mode, size):
+        def im_draft(mode: str, size: tuple[int, int]):
             result = draft(mode, size)
             assert result is not None
 
diff --git a/Tests/test_image_transform.py b/Tests/test_image_transform.py
index 1067dd563c1..638d1224710 100644
--- a/Tests/test_image_transform.py
+++ b/Tests/test_image_transform.py
@@ -1,6 +1,7 @@
 from __future__ import annotations
 
 import math
+from typing import Callable
 
 import pytest
 
@@ -91,7 +92,7 @@ def test_quad(self) -> None:
             ("LA", (76, 0)),
         ),
     )
-    def test_fill(self, mode, expected_pixel) -> None:
+    def test_fill(self, mode: str, expected_pixel: tuple[int, ...]) -> None:
         im = hopper(mode)
         (w, h) = im.size
         transformed = im.transform(
@@ -142,7 +143,9 @@ def test_mesh(self) -> None:
         assert_image_equal(blank, transformed.crop((w // 2, 0, w, h // 2)))
         assert_image_equal(blank, transformed.crop((0, h // 2, w // 2, h)))
 
-    def _test_alpha_premult(self, op) -> None:
+    def _test_alpha_premult(
+        self, op: Callable[[Image.Image, tuple[int, int]], Image.Image]
+    ) -> None:
         # create image with half white, half black,
         # with the black half transparent.
         # do op,
@@ -159,13 +162,13 @@ def _test_alpha_premult(self, op) -> None:
         assert 40 * 10 == hist[-1]
 
     def test_alpha_premult_resize(self) -> None:
-        def op(im, sz):
+        def op(im: Image.Image, sz: tuple[int, int]) -> Image.Image:
             return im.resize(sz, Image.Resampling.BILINEAR)
 
         self._test_alpha_premult(op)
 
     def test_alpha_premult_transform(self) -> None:
-        def op(im, sz):
+        def op(im: Image.Image, sz: tuple[int, int]) -> Image.Image:
             (w, h) = im.size
             return im.transform(
                 sz, Image.Transform.EXTENT, (0, 0, w, h), Image.Resampling.BILINEAR
@@ -173,7 +176,9 @@ def op(im, sz):
 
         self._test_alpha_premult(op)
 
-    def _test_nearest(self, op, mode) -> None:
+    def _test_nearest(
+        self, op: Callable[[Image.Image, tuple[int, int]], Image.Image], mode: str
+    ) -> None:
         # create white image with half transparent,
         # do op,
         # the image should remain white with half transparent
@@ -196,15 +201,15 @@ def _test_nearest(self, op, mode) -> None:
         )
 
     @pytest.mark.parametrize("mode", ("RGBA", "LA"))
-    def test_nearest_resize(self, mode) -> None:
-        def op(im, sz):
+    def test_nearest_resize(self, mode: str) -> None:
+        def op(im: Image.Image, sz: tuple[int, int]) -> Image.Image:
             return im.resize(sz, Image.Resampling.NEAREST)
 
         self._test_nearest(op, mode)
 
     @pytest.mark.parametrize("mode", ("RGBA", "LA"))
-    def test_nearest_transform(self, mode) -> None:
-        def op(im, sz):
+    def test_nearest_transform(self, mode: str) -> None:
+        def op(im: Image.Image, sz: tuple[int, int]) -> Image.Image:
             (w, h) = im.size
             return im.transform(
                 sz, Image.Transform.EXTENT, (0, 0, w, h), Image.Resampling.NEAREST
@@ -227,7 +232,9 @@ def test_blank_fill(self) -> None:
         # Running by default, but I'd totally understand not doing it in
         # the future
 
-        pattern = [Image.new("RGBA", (1024, 1024), (a, a, a, a)) for a in range(1, 65)]
+        pattern: list[Image.Image] | None = [
+            Image.new("RGBA", (1024, 1024), (a, a, a, a)) for a in range(1, 65)
+        ]
 
         # Yeah. Watch some JIT optimize this out.
         pattern = None  # noqa: F841
@@ -240,7 +247,7 @@ def test_missing_method_data(self) -> None:
                 im.transform((100, 100), None)
 
     @pytest.mark.parametrize("resample", (Image.Resampling.BOX, "unknown"))
-    def test_unknown_resampling_filter(self, resample) -> None:
+    def test_unknown_resampling_filter(self, resample: Image.Resampling | str) -> None:
         with hopper() as im:
             (w, h) = im.size
             with pytest.raises(ValueError):
@@ -250,7 +257,7 @@ def test_unknown_resampling_filter(self, resample) -> None:
 class TestImageTransformAffine:
     transform = Image.Transform.AFFINE
 
-    def _test_image(self):
+    def _test_image(self) -> Image.Image:
         im = hopper("RGB")
         return im.crop((10, 20, im.width - 10, im.height - 20))
 
@@ -263,7 +270,7 @@ def _test_image(self):
             (270, Image.Transpose.ROTATE_270),
         ),
     )
-    def test_rotate(self, deg, transpose) -> None:
+    def test_rotate(self, deg: int, transpose: Image.Transpose | None) -> None:
         im = self._test_image()
 
         angle = -math.radians(deg)
@@ -313,7 +320,13 @@ def test_rotate(self, deg, transpose) -> None:
             (Image.Resampling.BICUBIC, 1),
         ),
     )
-    def test_resize(self, scale, epsilon_scale, resample, epsilon) -> None:
+    def test_resize(
+        self,
+        scale: float,
+        epsilon_scale: float,
+        resample: Image.Resampling,
+        epsilon: int,
+    ) -> None:
         im = self._test_image()
 
         size_up = int(round(im.width * scale)), int(round(im.height * scale))
@@ -342,7 +355,14 @@ def test_resize(self, scale, epsilon_scale, resample, epsilon) -> None:
             (Image.Resampling.BICUBIC, 1),
         ),
     )
-    def test_translate(self, x, y, epsilon_scale, resample, epsilon) -> None:
+    def test_translate(
+        self,
+        x: float,
+        y: float,
+        epsilon_scale: float,
+        resample: Image.Resampling,
+        epsilon: float,
+    ) -> None:
         im = self._test_image()
 
         size_up = int(round(im.width + x)), int(round(im.height + y))

From ea0240bf2d414ff297c7959f904c252bae696ff3 Mon Sep 17 00:00:00 2001
From: Andrew Murray <3112309+radarhere@users.noreply.github.com>
Date: Mon, 12 Feb 2024 19:12:08 +1100
Subject: [PATCH 0189/1178] Use is None

Co-authored-by: Hugo van Kemenade <1324225+hugovk@users.noreply.github.com>
---
 Tests/test_image_access.py | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/Tests/test_image_access.py b/Tests/test_image_access.py
index 3bdaea75026..380b89de86f 100644
--- a/Tests/test_image_access.py
+++ b/Tests/test_image_access.py
@@ -147,7 +147,7 @@ def check(self, mode: str, expected_color_int: int | None = None) -> None:
             pytest.skip("Support not added to deprecated module for BGR;* modes")
 
         expected_color = (
-            expected_color_int if expected_color_int is not None else self.color(mode)
+            self.color(mode) if expected_color_int is None else expected_color_int
         )
 
         # check putpixel

From 4ce06aac3bc6aeb0425f78fc691210a839d6d875 Mon Sep 17 00:00:00 2001
From: Andrew Murray <radarhere@users.noreply.github.com>
Date: Mon, 12 Feb 2024 21:06:17 +1100
Subject: [PATCH 0190/1178] Added type hints

---
 Tests/test_color_lut.py          |  4 ++++
 Tests/test_core_resources.py     |  2 +-
 Tests/test_file_dds.py           | 18 ++++++++--------
 Tests/test_file_fli.py           |  4 ++--
 Tests/test_file_gribstub.py      |  7 +++---
 Tests/test_file_hdf5stub.py      |  7 +++---
 Tests/test_file_jpeg.py          | 22 ++++++++++---------
 Tests/test_file_palm.py          |  8 +++----
 Tests/test_file_tar.py           |  2 +-
 Tests/test_file_webp_metadata.py |  2 ++
 Tests/test_image.py              | 37 +++++++++++++++++++-------------
 Tests/test_imagefontctl.py       | 14 +++++++-----
 Tests/test_imagemorph.py         | 10 ++++-----
 Tests/test_imagepalette.py       |  2 +-
 Tests/test_pickle.py             | 22 ++++++++++++-------
 Tests/test_psdraw.py             |  4 ++--
 Tests/test_sgi_crash.py          |  2 +-
 Tests/test_shell_injection.py    |  8 ++++++-
 Tests/test_tiff_crashes.py       |  2 +-
 Tests/test_tiff_ifdrational.py   |  6 +++---
 20 files changed, 108 insertions(+), 75 deletions(-)

diff --git a/Tests/test_color_lut.py b/Tests/test_color_lut.py
index 2bb1b57d482..c8886a7796d 100644
--- a/Tests/test_color_lut.py
+++ b/Tests/test_color_lut.py
@@ -1,6 +1,7 @@
 from __future__ import annotations
 
 from array import array
+from types import ModuleType
 
 import pytest
 
@@ -8,6 +9,7 @@
 
 from .helper import assert_image_equal
 
+numpy: ModuleType | None
 try:
     import numpy
 except ImportError:
@@ -397,6 +399,7 @@ def test_convert_table(self) -> None:
 
     @pytest.mark.skipif(numpy is None, reason="NumPy not installed")
     def test_numpy_sources(self) -> None:
+        assert numpy is not None
         table = numpy.ones((5, 6, 7, 3), dtype=numpy.float16)
         with pytest.raises(ValueError, match="should have either channels"):
             lut = ImageFilter.Color3DLUT((5, 6, 7), table)
@@ -430,6 +433,7 @@ def test_numpy_sources(self) -> None:
 
     @pytest.mark.skipif(numpy is None, reason="NumPy not installed")
     def test_numpy_formats(self) -> None:
+        assert numpy is not None
         g = Image.linear_gradient("L")
         im = Image.merge(
             "RGB",
diff --git a/Tests/test_core_resources.py b/Tests/test_core_resources.py
index 5eabe8f11ba..2c1de8bc3d2 100644
--- a/Tests/test_core_resources.py
+++ b/Tests/test_core_resources.py
@@ -187,6 +187,6 @@ def test_units(self) -> None:
             {"PILLOW_BLOCKS_MAX": "wat"},
         ),
     )
-    def test_warnings(self, var) -> None:
+    def test_warnings(self, var: dict[str, str]) -> None:
         with pytest.warns(UserWarning):
             Image._apply_env_variables(var)
diff --git a/Tests/test_file_dds.py b/Tests/test_file_dds.py
index b78a0dd8109..ebc0e89a1c5 100644
--- a/Tests/test_file_dds.py
+++ b/Tests/test_file_dds.py
@@ -48,7 +48,7 @@
         TEST_FILE_DX10_BC1_TYPELESS,
     ),
 )
-def test_sanity_dxt1_bc1(image_path) -> None:
+def test_sanity_dxt1_bc1(image_path: str) -> None:
     """Check DXT1 and BC1 images can be opened"""
     with Image.open(TEST_FILE_DXT1.replace(".dds", ".png")) as target:
         target = target.convert("RGBA")
@@ -96,7 +96,7 @@ def test_sanity_dxt5() -> None:
         TEST_FILE_BC4U,
     ),
 )
-def test_sanity_ati1_bc4u(image_path) -> None:
+def test_sanity_ati1_bc4u(image_path: str) -> None:
     """Check ATI1 and BC4U images can be opened"""
 
     with Image.open(image_path) as im:
@@ -117,7 +117,7 @@ def test_sanity_ati1_bc4u(image_path) -> None:
         TEST_FILE_DX10_BC4_TYPELESS,
     ),
 )
-def test_dx10_bc4(image_path) -> None:
+def test_dx10_bc4(image_path: str) -> None:
     """Check DX10 BC4 images can be opened"""
 
     with Image.open(image_path) as im:
@@ -138,7 +138,7 @@ def test_dx10_bc4(image_path) -> None:
         TEST_FILE_BC5U,
     ),
 )
-def test_sanity_ati2_bc5u(image_path) -> None:
+def test_sanity_ati2_bc5u(image_path: str) -> None:
     """Check ATI2 and BC5U images can be opened"""
 
     with Image.open(image_path) as im:
@@ -162,7 +162,7 @@ def test_sanity_ati2_bc5u(image_path) -> None:
         (TEST_FILE_BC5S, TEST_FILE_BC5S),
     ),
 )
-def test_dx10_bc5(image_path, expected_path) -> None:
+def test_dx10_bc5(image_path: str, expected_path: str) -> None:
     """Check DX10 BC5 images can be opened"""
 
     with Image.open(image_path) as im:
@@ -176,7 +176,7 @@ def test_dx10_bc5(image_path, expected_path) -> None:
 
 
 @pytest.mark.parametrize("image_path", (TEST_FILE_BC6H, TEST_FILE_BC6HS))
-def test_dx10_bc6h(image_path) -> None:
+def test_dx10_bc6h(image_path: str) -> None:
     """Check DX10 BC6H/BC6HS images can be opened"""
 
     with Image.open(image_path) as im:
@@ -257,7 +257,7 @@ def test_dx10_r8g8b8a8_unorm_srgb() -> None:
         ("RGBA", (800, 600), TEST_FILE_UNCOMPRESSED_RGB_WITH_ALPHA),
     ],
 )
-def test_uncompressed(mode, size, test_file) -> None:
+def test_uncompressed(mode: str, size: tuple[int, int], test_file: str) -> None:
     """Check uncompressed images can be opened"""
 
     with Image.open(test_file) as im:
@@ -359,7 +359,7 @@ def test_unsupported_bitcount() -> None:
         "Tests/images/unimplemented_pfflags.dds",
     ),
 )
-def test_not_implemented(test_file) -> None:
+def test_not_implemented(test_file: str) -> None:
     with pytest.raises(NotImplementedError):
         with Image.open(test_file):
             pass
@@ -381,7 +381,7 @@ def test_save_unsupported_mode(tmp_path: Path) -> None:
         ("RGBA", "Tests/images/pil123rgba.png"),
     ],
 )
-def test_save(mode, test_file, tmp_path: Path) -> None:
+def test_save(mode: str, test_file: str, tmp_path: Path) -> None:
     out = str(tmp_path / "temp.dds")
     with Image.open(test_file) as im:
         assert im.mode == mode
diff --git a/Tests/test_file_fli.py b/Tests/test_file_fli.py
index a673d4af851..fc524721c2b 100644
--- a/Tests/test_file_fli.py
+++ b/Tests/test_file_fli.py
@@ -147,7 +147,7 @@ def test_seek() -> None:
     ],
 )
 @pytest.mark.timeout(timeout=3)
-def test_timeouts(test_file) -> None:
+def test_timeouts(test_file: str) -> None:
     with open(test_file, "rb") as f:
         with Image.open(f) as im:
             with pytest.raises(OSError):
@@ -160,7 +160,7 @@ def test_timeouts(test_file) -> None:
         "Tests/images/crash-5762152299364352.fli",
     ],
 )
-def test_crash(test_file) -> None:
+def test_crash(test_file: str) -> None:
     with open(test_file, "rb") as f:
         with Image.open(f) as im:
             with pytest.raises(OSError):
diff --git a/Tests/test_file_gribstub.py b/Tests/test_file_gribstub.py
index 4945468be40..096a5b88b21 100644
--- a/Tests/test_file_gribstub.py
+++ b/Tests/test_file_gribstub.py
@@ -1,6 +1,7 @@
 from __future__ import annotations
 
 from pathlib import Path
+from typing import IO
 
 import pytest
 
@@ -55,15 +56,15 @@ class TestHandler:
         loaded = False
         saved = False
 
-        def open(self, im) -> None:
+        def open(self, im: Image.Image) -> None:
             self.opened = True
 
-        def load(self, im):
+        def load(self, im: Image.Image) -> Image.Image:
             self.loaded = True
             im.fp.close()
             return Image.new("RGB", (1, 1))
 
-        def save(self, im, fp, filename) -> None:
+        def save(self, im: Image.Image, fp: IO[bytes], filename: str) -> None:
             self.saved = True
 
     handler = TestHandler()
diff --git a/Tests/test_file_hdf5stub.py b/Tests/test_file_hdf5stub.py
index ac3d40bf287..f871e2eff16 100644
--- a/Tests/test_file_hdf5stub.py
+++ b/Tests/test_file_hdf5stub.py
@@ -1,6 +1,7 @@
 from __future__ import annotations
 
 from pathlib import Path
+from typing import IO
 
 import pytest
 
@@ -56,15 +57,15 @@ class TestHandler:
         loaded = False
         saved = False
 
-        def open(self, im) -> None:
+        def open(self, im: Image.Image) -> None:
             self.opened = True
 
-        def load(self, im):
+        def load(self, im: Image.Image) -> Image.Image:
             self.loaded = True
             im.fp.close()
             return Image.new("RGB", (1, 1))
 
-        def save(self, im, fp, filename) -> None:
+        def save(self, im: Image.Image, fp: IO[bytes], filename: str) -> None:
             self.saved = True
 
     handler = TestHandler()
diff --git a/Tests/test_file_jpeg.py b/Tests/test_file_jpeg.py
index 6b0662e0be3..65424214838 100644
--- a/Tests/test_file_jpeg.py
+++ b/Tests/test_file_jpeg.py
@@ -5,6 +5,7 @@
 import warnings
 from io import BytesIO
 from pathlib import Path
+from types import ModuleType
 from typing import Any
 
 import pytest
@@ -33,6 +34,7 @@
     skip_unless_feature,
 )
 
+ElementTree: ModuleType | None
 try:
     from defusedxml import ElementTree
 except ImportError:
@@ -440,25 +442,25 @@ def getsampling(im: Image.Image):
         for subsampling in (-1, 3):  # (default, invalid)
             im = self.roundtrip(hopper(), subsampling=subsampling)
             assert getsampling(im) == (2, 2, 1, 1, 1, 1)
-        for subsampling in (0, "4:4:4"):
-            im = self.roundtrip(hopper(), subsampling=subsampling)
+        for subsampling1 in (0, "4:4:4"):
+            im = self.roundtrip(hopper(), subsampling=subsampling1)
             assert getsampling(im) == (1, 1, 1, 1, 1, 1)
-        for subsampling in (1, "4:2:2"):
-            im = self.roundtrip(hopper(), subsampling=subsampling)
+        for subsampling1 in (1, "4:2:2"):
+            im = self.roundtrip(hopper(), subsampling=subsampling1)
             assert getsampling(im) == (2, 1, 1, 1, 1, 1)
-        for subsampling in (2, "4:2:0", "4:1:1"):
-            im = self.roundtrip(hopper(), subsampling=subsampling)
+        for subsampling1 in (2, "4:2:0", "4:1:1"):
+            im = self.roundtrip(hopper(), subsampling=subsampling1)
             assert getsampling(im) == (2, 2, 1, 1, 1, 1)
 
         # RGB colorspace
-        for subsampling in (-1, 0, "4:4:4"):
+        for subsampling1 in (-1, 0, "4:4:4"):
             # "4:4:4" doesn't really make sense for RGB, but the conversion
             # to an integer happens at a higher level
-            im = self.roundtrip(hopper(), keep_rgb=True, subsampling=subsampling)
+            im = self.roundtrip(hopper(), keep_rgb=True, subsampling=subsampling1)
             assert getsampling(im) == (1, 1, 1, 1, 1, 1)
-        for subsampling in (1, "4:2:2", 2, "4:2:0", 3):
+        for subsampling1 in (1, "4:2:2", 2, "4:2:0", 3):
             with pytest.raises(OSError):
-                self.roundtrip(hopper(), keep_rgb=True, subsampling=subsampling)
+                self.roundtrip(hopper(), keep_rgb=True, subsampling=subsampling1)
 
         with pytest.raises(TypeError):
             self.roundtrip(hopper(), subsampling="1:1:1")
diff --git a/Tests/test_file_palm.py b/Tests/test_file_palm.py
index 55041a4b202..194f39b30b8 100644
--- a/Tests/test_file_palm.py
+++ b/Tests/test_file_palm.py
@@ -11,7 +11,7 @@
 from .helper import assert_image_equal, hopper, magick_command
 
 
-def helper_save_as_palm(tmp_path: Path, mode) -> None:
+def helper_save_as_palm(tmp_path: Path, mode: str) -> None:
     # Arrange
     im = hopper(mode)
     outfile = str(tmp_path / ("temp_" + mode + ".palm"))
@@ -24,7 +24,7 @@ def helper_save_as_palm(tmp_path: Path, mode) -> None:
     assert os.path.getsize(outfile) > 0
 
 
-def open_with_magick(magick, tmp_path: Path, f):
+def open_with_magick(magick: list[str], tmp_path: Path, f: str) -> Image.Image:
     outfile = str(tmp_path / "temp.png")
     rc = subprocess.call(
         magick + [f, outfile], stdout=subprocess.DEVNULL, stderr=subprocess.STDOUT
@@ -33,7 +33,7 @@ def open_with_magick(magick, tmp_path: Path, f):
     return Image.open(outfile)
 
 
-def roundtrip(tmp_path: Path, mode) -> None:
+def roundtrip(tmp_path: Path, mode: str) -> None:
     magick = magick_command()
     if not magick:
         return
@@ -66,6 +66,6 @@ def test_p_mode(tmp_path: Path) -> None:
 
 
 @pytest.mark.parametrize("mode", ("L", "RGB"))
-def test_oserror(tmp_path: Path, mode) -> None:
+def test_oserror(tmp_path: Path, mode: str) -> None:
     with pytest.raises(OSError):
         helper_save_as_palm(tmp_path, mode)
diff --git a/Tests/test_file_tar.py b/Tests/test_file_tar.py
index 44e78e972dc..6217ebedd8a 100644
--- a/Tests/test_file_tar.py
+++ b/Tests/test_file_tar.py
@@ -19,7 +19,7 @@
         ("jpg", "hopper.jpg", "JPEG"),
     ),
 )
-def test_sanity(codec, test_path, format) -> None:
+def test_sanity(codec: str, test_path: str, format: str) -> None:
     if features.check(codec):
         with TarIO.TarIO(TEST_TAR_FILE, test_path) as tar:
             with Image.open(tar) as im:
diff --git a/Tests/test_file_webp_metadata.py b/Tests/test_file_webp_metadata.py
index fea19694109..8759412408c 100644
--- a/Tests/test_file_webp_metadata.py
+++ b/Tests/test_file_webp_metadata.py
@@ -2,6 +2,7 @@
 
 from io import BytesIO
 from pathlib import Path
+from types import ModuleType
 
 import pytest
 
@@ -14,6 +15,7 @@
     skip_unless_feature("webp_mux"),
 ]
 
+ElementTree: ModuleType | None
 try:
     from defusedxml import ElementTree
 except ImportError:
diff --git a/Tests/test_image.py b/Tests/test_image.py
index 67a7d7eca54..75b28c2dc07 100644
--- a/Tests/test_image.py
+++ b/Tests/test_image.py
@@ -8,6 +8,7 @@
 import tempfile
 import warnings
 from pathlib import Path
+from typing import IO
 
 import pytest
 
@@ -61,11 +62,11 @@ class TestImage:
             "HSV",
         ),
     )
-    def test_image_modes_success(self, mode) -> None:
+    def test_image_modes_success(self, mode: str) -> None:
         Image.new(mode, (1, 1))
 
     @pytest.mark.parametrize("mode", ("", "bad", "very very long"))
-    def test_image_modes_fail(self, mode) -> None:
+    def test_image_modes_fail(self, mode: str) -> None:
         with pytest.raises(ValueError) as e:
             Image.new(mode, (1, 1))
         assert str(e.value) == "unrecognized image mode"
@@ -100,7 +101,7 @@ def test_sanity(self) -> None:
 
     def test_repr_pretty(self) -> None:
         class Pretty:
-            def text(self, text) -> None:
+            def text(self, text: str) -> None:
                 self.pretty_output = text
 
         im = Image.new("L", (100, 100))
@@ -184,7 +185,9 @@ def test_fp_name(self, tmp_path: Path) -> None:
         temp_file = str(tmp_path / "temp.jpg")
 
         class FP:
-            def write(self, b) -> None:
+            name: str
+
+            def write(self, b: bytes) -> None:
                 pass
 
         fp = FP()
@@ -538,7 +541,7 @@ def test_check_size(self) -> None:
         "PILLOW_VALGRIND_TEST" in os.environ, reason="Valgrind is slower"
     )
     @pytest.mark.parametrize("size", ((0, 100000000), (100000000, 0)))
-    def test_empty_image(self, size) -> None:
+    def test_empty_image(self, size: tuple[int, int]) -> None:
         Image.new("RGB", size)
 
     def test_storage_neg(self) -> None:
@@ -565,7 +568,7 @@ def test_linear_gradient_wrong_mode(self) -> None:
             Image.linear_gradient(wrong_mode)
 
     @pytest.mark.parametrize("mode", ("L", "P", "I", "F"))
-    def test_linear_gradient(self, mode) -> None:
+    def test_linear_gradient(self, mode: str) -> None:
         # Arrange
         target_file = "Tests/images/linear_gradient.png"
 
@@ -590,7 +593,7 @@ def test_radial_gradient_wrong_mode(self) -> None:
             Image.radial_gradient(wrong_mode)
 
     @pytest.mark.parametrize("mode", ("L", "P", "I", "F"))
-    def test_radial_gradient(self, mode) -> None:
+    def test_radial_gradient(self, mode: str) -> None:
         # Arrange
         target_file = "Tests/images/radial_gradient.png"
 
@@ -665,7 +668,11 @@ def test__new(self) -> None:
         blank_p.palette = None
         blank_pa.palette = None
 
-        def _make_new(base_image, image, palette_result=None) -> None:
+        def _make_new(
+            base_image: Image.Image,
+            image: Image.Image,
+            palette_result: ImagePalette.ImagePalette | None = None,
+        ) -> None:
             new_image = base_image._new(image.im)
             assert new_image.mode == image.mode
             assert new_image.size == image.size
@@ -713,7 +720,7 @@ def test_no_new_file_on_error(self, tmp_path: Path) -> None:
     def test_load_on_nonexclusive_multiframe(self) -> None:
         with open("Tests/images/frozenpond.mpo", "rb") as fp:
 
-            def act(fp) -> None:
+            def act(fp: IO[bytes]) -> None:
                 im = Image.open(fp)
                 im.load()
 
@@ -906,12 +913,12 @@ def test_exif_hide_offsets(self) -> None:
                 assert exif.get_ifd(0xA005)
 
     @pytest.mark.parametrize("size", ((1, 0), (0, 1), (0, 0)))
-    def test_zero_tobytes(self, size) -> None:
+    def test_zero_tobytes(self, size: tuple[int, int]) -> None:
         im = Image.new("RGB", size)
         assert im.tobytes() == b""
 
     @pytest.mark.parametrize("size", ((1, 0), (0, 1), (0, 0)))
-    def test_zero_frombytes(self, size) -> None:
+    def test_zero_frombytes(self, size: tuple[int, int]) -> None:
         Image.frombytes("RGB", size, b"")
 
         im = Image.new("RGB", size)
@@ -996,7 +1003,7 @@ def test_constants(self) -> None:
             "01r_00.pcx",
         ],
     )
-    def test_overrun(self, path) -> None:
+    def test_overrun(self, path: str) -> None:
         """For overrun completeness, test as:
         valgrind pytest -qq Tests/test_image.py::TestImage::test_overrun | grep decode.c
         """
@@ -1023,7 +1030,7 @@ def test_exit_fp(self) -> None:
             pass
         assert not hasattr(im, "fp")
 
-    def test_close_graceful(self, caplog) -> None:
+    def test_close_graceful(self, caplog: pytest.LogCaptureFixture) -> None:
         with Image.open("Tests/images/hopper.jpg") as im:
             copy = im.copy()
             with caplog.at_level(logging.DEBUG):
@@ -1034,10 +1041,10 @@ def test_close_graceful(self, caplog) -> None:
 
 
 class MockEncoder:
-    pass
+    args: tuple[str, ...]
 
 
-def mock_encode(*args):
+def mock_encode(*args: str) -> MockEncoder:
     encoder = MockEncoder()
     encoder.args = args
     return encoder
diff --git a/Tests/test_imagefontctl.py b/Tests/test_imagefontctl.py
index 325e7ef216b..24c7b871a68 100644
--- a/Tests/test_imagefontctl.py
+++ b/Tests/test_imagefontctl.py
@@ -208,7 +208,9 @@ def test_language() -> None:
     ),
     ids=("None", "ltr", "rtl2", "rtl", "ttb"),
 )
-def test_getlength(mode, text, direction, expected) -> None:
+def test_getlength(
+    mode: str, text: str, direction: str | None, expected: float
+) -> None:
     ttf = ImageFont.truetype(FONT_PATH, FONT_SIZE)
     im = Image.new(mode, (1, 1), 0)
     d = ImageDraw.Draw(im)
@@ -230,7 +232,7 @@ def test_getlength(mode, text, direction, expected) -> None:
     ("i" + ("\u030C" * 15) + "i", "i" + "\u032C" * 15 + "i", "\u035Cii", "i\u0305i"),
     ids=("caron-above", "caron-below", "double-breve", "overline"),
 )
-def test_getlength_combine(mode, direction, text) -> None:
+def test_getlength_combine(mode: str, direction: str, text: str) -> None:
     if text == "i\u0305i" and direction == "ttb":
         pytest.skip("fails with this font")
 
@@ -250,7 +252,7 @@ def test_getlength_combine(mode, direction, text) -> None:
 
 
 @pytest.mark.parametrize("anchor", ("lt", "mm", "rb", "sm"))
-def test_anchor_ttb(anchor) -> None:
+def test_anchor_ttb(anchor: str) -> None:
     text = "f"
     path = f"Tests/images/test_anchor_ttb_{text}_{anchor}.png"
     f = ImageFont.truetype("Tests/fonts/NotoSans-Regular.ttf", 120)
@@ -306,7 +308,9 @@ def test_anchor_ttb(anchor) -> None:
 @pytest.mark.parametrize(
     "name, text, anchor, dir, epsilon", combine_tests, ids=[r[0] for r in combine_tests]
 )
-def test_combine(name, text, dir, anchor, epsilon) -> None:
+def test_combine(
+    name: str, text: str, dir: str | None, anchor: str | None, epsilon: float
+) -> None:
     path = f"Tests/images/test_combine_{name}.png"
     f = ImageFont.truetype("Tests/fonts/NotoSans-Regular.ttf", 48)
 
@@ -337,7 +341,7 @@ def test_combine(name, text, dir, anchor, epsilon) -> None:
         ("rm", "right"),  # pass with getsize
     ),
 )
-def test_combine_multiline(anchor, align) -> None:
+def test_combine_multiline(anchor: str, align: str) -> None:
     # test that multiline text uses getlength, not getsize or getbbox
 
     path = f"Tests/images/test_combine_multiline_{anchor}_{align}.png"
diff --git a/Tests/test_imagemorph.py b/Tests/test_imagemorph.py
index 0b0c6d2d31a..46b473d7ac8 100644
--- a/Tests/test_imagemorph.py
+++ b/Tests/test_imagemorph.py
@@ -10,7 +10,7 @@
 from .helper import assert_image_equal_tofile, hopper
 
 
-def string_to_img(image_string):
+def string_to_img(image_string: str) -> Image.Image:
     """Turn a string image representation into a binary image"""
     rows = [s for s in image_string.replace(" ", "").split("\n") if len(s)]
     height = len(rows)
@@ -38,7 +38,7 @@ def string_to_img(image_string):
 )
 
 
-def img_to_string(im):
+def img_to_string(im: Image.Image) -> str:
     """Turn a (small) binary image into a string representation"""
     chars = ".1"
     width, height = im.size
@@ -48,11 +48,11 @@ def img_to_string(im):
     )
 
 
-def img_string_normalize(im):
+def img_string_normalize(im: str) -> str:
     return img_to_string(string_to_img(im))
 
 
-def assert_img_equal_img_string(a, b_string) -> None:
+def assert_img_equal_img_string(a: Image.Image, b_string: str) -> None:
     assert img_to_string(a) == img_string_normalize(b_string)
 
 
@@ -63,7 +63,7 @@ def test_str_to_img() -> None:
 @pytest.mark.parametrize(
     "op", ("corner", "dilation4", "dilation8", "erosion4", "erosion8", "edge")
 )
-def test_lut(op) -> None:
+def test_lut(op: str) -> None:
     lb = ImageMorph.LutBuilder(op_name=op)
     assert lb.get_lut() is None
 
diff --git a/Tests/test_imagepalette.py b/Tests/test_imagepalette.py
index 545229500a6..8e2db15aab7 100644
--- a/Tests/test_imagepalette.py
+++ b/Tests/test_imagepalette.py
@@ -67,7 +67,7 @@ def test_getcolor_rgba_color_rgb_palette() -> None:
         (255, ImagePalette.ImagePalette("RGB", list(range(256)) * 3)),
     ],
 )
-def test_getcolor_not_special(index, palette) -> None:
+def test_getcolor_not_special(index: int, palette: ImagePalette.ImagePalette) -> None:
     im = Image.new("P", (1, 1))
 
     # Do not use transparency index as a new color
diff --git a/Tests/test_pickle.py b/Tests/test_pickle.py
index 560cdbd35f7..ed415953f06 100644
--- a/Tests/test_pickle.py
+++ b/Tests/test_pickle.py
@@ -13,7 +13,9 @@
 FONT_PATH = "Tests/fonts/DejaVuSans/DejaVuSans.ttf"
 
 
-def helper_pickle_file(tmp_path: Path, pickle, protocol, test_file, mode) -> None:
+def helper_pickle_file(
+    tmp_path: Path, protocol: int, test_file: str, mode: str | None
+) -> None:
     # Arrange
     with Image.open(test_file) as im:
         filename = str(tmp_path / "temp.pkl")
@@ -30,7 +32,7 @@ def helper_pickle_file(tmp_path: Path, pickle, protocol, test_file, mode) -> Non
         assert im == loaded_im
 
 
-def helper_pickle_string(pickle, protocol, test_file, mode) -> None:
+def helper_pickle_string(protocol: int, test_file: str, mode: str | None) -> None:
     with Image.open(test_file) as im:
         if mode:
             im = im.convert(mode)
@@ -64,10 +66,12 @@ def helper_pickle_string(pickle, protocol, test_file, mode) -> None:
     ],
 )
 @pytest.mark.parametrize("protocol", range(0, pickle.HIGHEST_PROTOCOL + 1))
-def test_pickle_image(tmp_path: Path, test_file, test_mode, protocol) -> None:
+def test_pickle_image(
+    tmp_path: Path, test_file: str, test_mode: str | None, protocol: int
+) -> None:
     # Act / Assert
-    helper_pickle_string(pickle, protocol, test_file, test_mode)
-    helper_pickle_file(tmp_path, pickle, protocol, test_file, test_mode)
+    helper_pickle_string(protocol, test_file, test_mode)
+    helper_pickle_file(tmp_path, protocol, test_file, test_mode)
 
 
 def test_pickle_la_mode_with_palette(tmp_path: Path) -> None:
@@ -99,7 +103,9 @@ def test_pickle_tell() -> None:
     assert unpickled_image.tell() == 0
 
 
-def helper_assert_pickled_font_images(font1, font2) -> None:
+def helper_assert_pickled_font_images(
+    font1: ImageFont.FreeTypeFont, font2: ImageFont.FreeTypeFont
+) -> None:
     # Arrange
     im1 = Image.new(mode="RGBA", size=(300, 100))
     im2 = Image.new(mode="RGBA", size=(300, 100))
@@ -117,7 +123,7 @@ def helper_assert_pickled_font_images(font1, font2) -> None:
 
 @skip_unless_feature("freetype2")
 @pytest.mark.parametrize("protocol", list(range(0, pickle.HIGHEST_PROTOCOL + 1)))
-def test_pickle_font_string(protocol) -> None:
+def test_pickle_font_string(protocol: int) -> None:
     # Arrange
     font = ImageFont.truetype(FONT_PATH, FONT_SIZE)
 
@@ -131,7 +137,7 @@ def test_pickle_font_string(protocol) -> None:
 
 @skip_unless_feature("freetype2")
 @pytest.mark.parametrize("protocol", list(range(0, pickle.HIGHEST_PROTOCOL + 1)))
-def test_pickle_font_file(tmp_path: Path, protocol) -> None:
+def test_pickle_font_file(tmp_path: Path, protocol: int) -> None:
     # Arrange
     font = ImageFont.truetype(FONT_PATH, FONT_SIZE)
     filename = str(tmp_path / "temp.pkl")
diff --git a/Tests/test_psdraw.py b/Tests/test_psdraw.py
index 797539f35ef..64dfb2c95fb 100644
--- a/Tests/test_psdraw.py
+++ b/Tests/test_psdraw.py
@@ -10,7 +10,7 @@
 from PIL import Image, PSDraw
 
 
-def _create_document(ps) -> None:
+def _create_document(ps: PSDraw.PSDraw) -> None:
     title = "hopper"
     box = (1 * 72, 2 * 72, 7 * 72, 10 * 72)  # in points
 
@@ -50,7 +50,7 @@ def test_draw_postscript(tmp_path: Path) -> None:
 
 
 @pytest.mark.parametrize("buffer", (True, False))
-def test_stdout(buffer) -> None:
+def test_stdout(buffer: bool) -> None:
     # Temporarily redirect stdout
     old_stdout = sys.stdout
 
diff --git a/Tests/test_sgi_crash.py b/Tests/test_sgi_crash.py
index 9442801d05c..3ce31cd2d1e 100644
--- a/Tests/test_sgi_crash.py
+++ b/Tests/test_sgi_crash.py
@@ -21,7 +21,7 @@
         "Tests/images/crash-db8bfa78b19721225425530c5946217720d7df4e.sgi",
     ],
 )
-def test_crashes(test_file) -> None:
+def test_crashes(test_file: str) -> None:
     with open(test_file, "rb") as f:
         with Image.open(f) as im:
             with pytest.raises(OSError):
diff --git a/Tests/test_shell_injection.py b/Tests/test_shell_injection.py
index 3db0660eab7..2a072fd44c5 100644
--- a/Tests/test_shell_injection.py
+++ b/Tests/test_shell_injection.py
@@ -2,6 +2,7 @@
 
 import shutil
 from pathlib import Path
+from typing import Callable
 
 import pytest
 
@@ -17,7 +18,12 @@
 
 @pytest.mark.skipif(is_win32(), reason="Requires Unix or macOS")
 class TestShellInjection:
-    def assert_save_filename_check(self, tmp_path: Path, src_img, save_func) -> None:
+    def assert_save_filename_check(
+        self,
+        tmp_path: Path,
+        src_img: Image.Image,
+        save_func: Callable[[Image.Image, int, str], None],
+    ) -> None:
         for filename in test_filenames:
             dest_file = str(tmp_path / filename)
             save_func(src_img, 0, dest_file)
diff --git a/Tests/test_tiff_crashes.py b/Tests/test_tiff_crashes.py
index 64e781cbada..f51e8b3a8bd 100644
--- a/Tests/test_tiff_crashes.py
+++ b/Tests/test_tiff_crashes.py
@@ -42,7 +42,7 @@
 @pytest.mark.filterwarnings("ignore:Possibly corrupt EXIF data")
 @pytest.mark.filterwarnings("ignore:Metadata warning")
 @pytest.mark.filterwarnings("ignore:Truncated File Read")
-def test_tiff_crashes(test_file):
+def test_tiff_crashes(test_file: str) -> None:
     try:
         with Image.open(test_file) as im:
             im.load()
diff --git a/Tests/test_tiff_ifdrational.py b/Tests/test_tiff_ifdrational.py
index 5368545232b..f6adae3e6e7 100644
--- a/Tests/test_tiff_ifdrational.py
+++ b/Tests/test_tiff_ifdrational.py
@@ -53,9 +53,9 @@ def test_nonetype() -> None:
 
 
 def test_ifd_rational_save(tmp_path: Path) -> None:
-    methods = (True, False)
-    if not features.check("libtiff"):
-        methods = (False,)
+    methods = [True]
+    if features.check("libtiff"):
+        methods.append(False)
 
     for libtiff in methods:
         TiffImagePlugin.WRITE_LIBTIFF = libtiff

From 47eaf0937f8e4f10fce8473007aba449c0c280f7 Mon Sep 17 00:00:00 2001
From: Andrew Murray <radarhere@users.noreply.github.com>
Date: Tue, 13 Feb 2024 22:26:23 +1100
Subject: [PATCH 0191/1178] Use IO[bytes] in type hints

---
 src/PIL/ImageFile.py      | 4 ++--
 src/PIL/MspImagePlugin.py | 3 ++-
 src/PIL/PcxImagePlugin.py | 3 ++-
 src/PIL/PpmImagePlugin.py | 4 ++--
 src/PIL/SgiImagePlugin.py | 4 ++--
 src/PIL/TgaImagePlugin.py | 4 ++--
 src/PIL/XbmImagePlugin.py | 4 ++--
 7 files changed, 14 insertions(+), 12 deletions(-)

diff --git a/src/PIL/ImageFile.py b/src/PIL/ImageFile.py
index 487f53efe1f..e929b665e06 100644
--- a/src/PIL/ImageFile.py
+++ b/src/PIL/ImageFile.py
@@ -32,7 +32,7 @@
 import itertools
 import struct
 import sys
-from typing import Any, NamedTuple
+from typing import IO, Any, NamedTuple
 
 from . import Image
 from ._deprecate import deprecate
@@ -616,7 +616,7 @@ def extents(self):
 
 
 class PyCodec:
-    fd: io.BytesIO | None
+    fd: IO[bytes] | None
 
     def __init__(self, mode, *args):
         self.im = None
diff --git a/src/PIL/MspImagePlugin.py b/src/PIL/MspImagePlugin.py
index bb7e466a790..65cc70624b7 100644
--- a/src/PIL/MspImagePlugin.py
+++ b/src/PIL/MspImagePlugin.py
@@ -26,6 +26,7 @@
 
 import io
 import struct
+from typing import IO
 
 from . import Image, ImageFile
 from ._binary import i16le as i16
@@ -163,7 +164,7 @@ def decode(self, buffer: bytes) -> tuple[int, int]:
 # write MSP files (uncompressed only)
 
 
-def _save(im: Image.Image, fp: io.BytesIO, filename: str) -> None:
+def _save(im: Image.Image, fp: IO[bytes], filename: str) -> None:
     if im.mode != "1":
         msg = f"cannot write mode {im.mode} as MSP"
         raise OSError(msg)
diff --git a/src/PIL/PcxImagePlugin.py b/src/PIL/PcxImagePlugin.py
index 3e0968a8386..026bfd9a01b 100644
--- a/src/PIL/PcxImagePlugin.py
+++ b/src/PIL/PcxImagePlugin.py
@@ -28,6 +28,7 @@
 
 import io
 import logging
+from typing import IO
 
 from . import Image, ImageFile, ImagePalette
 from ._binary import i16le as i16
@@ -143,7 +144,7 @@ def _open(self) -> None:
 }
 
 
-def _save(im: Image.Image, fp: io.BytesIO, filename: str) -> None:
+def _save(im: Image.Image, fp: IO[bytes], filename: str) -> None:
     try:
         version, bits, planes, rawmode = SAVE[im.mode]
     except KeyError as e:
diff --git a/src/PIL/PpmImagePlugin.py b/src/PIL/PpmImagePlugin.py
index 3e45ba95c84..6ac7a9bbc79 100644
--- a/src/PIL/PpmImagePlugin.py
+++ b/src/PIL/PpmImagePlugin.py
@@ -16,7 +16,7 @@
 from __future__ import annotations
 
 import math
-from io import BytesIO
+from typing import IO
 
 from . import Image, ImageFile
 from ._binary import i16be as i16
@@ -324,7 +324,7 @@ def decode(self, buffer: bytes) -> tuple[int, int]:
 # --------------------------------------------------------------------
 
 
-def _save(im: Image.Image, fp: BytesIO, filename: str) -> None:
+def _save(im: Image.Image, fp: IO[bytes], filename: str) -> None:
     if im.mode == "1":
         rawmode, head = "1;I", b"P4"
     elif im.mode == "L":
diff --git a/src/PIL/SgiImagePlugin.py b/src/PIL/SgiImagePlugin.py
index ccf661ff1f3..7bd84ebd491 100644
--- a/src/PIL/SgiImagePlugin.py
+++ b/src/PIL/SgiImagePlugin.py
@@ -24,7 +24,7 @@
 
 import os
 import struct
-from io import BytesIO
+from typing import IO
 
 from . import Image, ImageFile
 from ._binary import i16be as i16
@@ -125,7 +125,7 @@ def _open(self) -> None:
             ]
 
 
-def _save(im: Image.Image, fp: BytesIO, filename: str) -> None:
+def _save(im: Image.Image, fp: IO[bytes], filename: str) -> None:
     if im.mode not in {"RGB", "RGBA", "L"}:
         msg = "Unsupported SGI image mode"
         raise ValueError(msg)
diff --git a/src/PIL/TgaImagePlugin.py b/src/PIL/TgaImagePlugin.py
index 584932d2c7d..828701342b7 100644
--- a/src/PIL/TgaImagePlugin.py
+++ b/src/PIL/TgaImagePlugin.py
@@ -18,7 +18,7 @@
 from __future__ import annotations
 
 import warnings
-from io import BytesIO
+from typing import IO
 
 from . import Image, ImageFile, ImagePalette
 from ._binary import i16le as i16
@@ -175,7 +175,7 @@ def load_end(self) -> None:
 }
 
 
-def _save(im: Image.Image, fp: BytesIO, filename: str) -> None:
+def _save(im: Image.Image, fp: IO[bytes], filename: str) -> None:
     try:
         rawmode, bits, colormaptype, imagetype = SAVE[im.mode]
     except KeyError as e:
diff --git a/src/PIL/XbmImagePlugin.py b/src/PIL/XbmImagePlugin.py
index 0291e2858ac..eee7274361c 100644
--- a/src/PIL/XbmImagePlugin.py
+++ b/src/PIL/XbmImagePlugin.py
@@ -21,7 +21,7 @@
 from __future__ import annotations
 
 import re
-from io import BytesIO
+from typing import IO
 
 from . import Image, ImageFile
 
@@ -70,7 +70,7 @@ def _open(self) -> None:
         self.tile = [("xbm", (0, 0) + self.size, m.end(), None)]
 
 
-def _save(im: Image.Image, fp: BytesIO, filename: str) -> None:
+def _save(im: Image.Image, fp: IO[bytes], filename: str) -> None:
     if im.mode != "1":
         msg = f"cannot write mode {im.mode} as XBM"
         raise OSError(msg)

From 63987b7abaf6907a8985b867be154debfef0ec1b Mon Sep 17 00:00:00 2001
From: Andrew Murray <radarhere@users.noreply.github.com>
Date: Wed, 14 Feb 2024 06:55:13 +1100
Subject: [PATCH 0192/1178] Set mode to L if palette is missing

---
 Tests/test_file_tga.py    | 5 +++++
 src/PIL/TgaImagePlugin.py | 2 +-
 2 files changed, 6 insertions(+), 1 deletion(-)

diff --git a/Tests/test_file_tga.py b/Tests/test_file_tga.py
index bd8e522c7b5..87a59ff3d7a 100644
--- a/Tests/test_file_tga.py
+++ b/Tests/test_file_tga.py
@@ -133,6 +133,11 @@ def test_small_palette(tmp_path: Path) -> None:
         assert reloaded.getpalette() == colors
 
 
+def test_missing_palette() -> None:
+    with Image.open("Tests/images/dilation4.lut") as im:
+        assert im.mode == "L"
+
+
 def test_save_wrong_mode(tmp_path: Path) -> None:
     im = hopper("PA")
     out = str(tmp_path / "temp.tga")
diff --git a/src/PIL/TgaImagePlugin.py b/src/PIL/TgaImagePlugin.py
index 584932d2c7d..5d48275251e 100644
--- a/src/PIL/TgaImagePlugin.py
+++ b/src/PIL/TgaImagePlugin.py
@@ -85,7 +85,7 @@ def _open(self) -> None:
             elif depth == 16:
                 self._mode = "LA"
         elif imagetype in (1, 9):
-            self._mode = "P"
+            self._mode = "P" if colormaptype else "L"
         elif imagetype in (2, 10):
             self._mode = "RGB"
             if depth == 32:

From 818500b329555969cdb852c81d667cc70faaed94 Mon Sep 17 00:00:00 2001
From: Andrew Murray <radarhere@users.noreply.github.com>
Date: Wed, 14 Feb 2024 07:10:44 +1100
Subject: [PATCH 0193/1178] Raise an error if map depth is unknown

---
 Tests/images/p_8.tga      | Bin 0 -> 18 bytes
 Tests/test_file_tga.py    |   7 ++++++-
 src/PIL/TgaImagePlugin.py |   3 +++
 3 files changed, 9 insertions(+), 1 deletion(-)
 create mode 100644 Tests/images/p_8.tga

diff --git a/Tests/images/p_8.tga b/Tests/images/p_8.tga
new file mode 100644
index 0000000000000000000000000000000000000000..73759a2822419fd38134be80acf7918c0a437e43
GIT binary patch
literal 18
Wcmb1RWMp7qVB`Q23=KfY!2kdU!vQh?

literal 0
HcmV?d00001

diff --git a/Tests/test_file_tga.py b/Tests/test_file_tga.py
index 87a59ff3d7a..75c592da26b 100644
--- a/Tests/test_file_tga.py
+++ b/Tests/test_file_tga.py
@@ -7,7 +7,7 @@
 
 import pytest
 
-from PIL import Image
+from PIL import Image, UnidentifiedImageError
 
 from .helper import assert_image_equal, assert_image_equal_tofile, hopper
 
@@ -65,6 +65,11 @@ def roundtrip(original_im) -> None:
                     roundtrip(original_im)
 
 
+def test_palette_depth_8(tmp_path: Path) -> None:
+    with pytest.raises(UnidentifiedImageError):
+        Image.open("Tests/images/p_8.tga")
+
+
 def test_palette_depth_16(tmp_path: Path) -> None:
     with Image.open("Tests/images/p_16.tga") as im:
         assert_image_equal_tofile(im.convert("RGB"), "Tests/images/p_16.png")
diff --git a/src/PIL/TgaImagePlugin.py b/src/PIL/TgaImagePlugin.py
index 5d48275251e..b6748c25ed2 100644
--- a/src/PIL/TgaImagePlugin.py
+++ b/src/PIL/TgaImagePlugin.py
@@ -128,6 +128,9 @@ def _open(self) -> None:
                 self.palette = ImagePalette.raw(
                     "BGRA", b"\0" * 4 * start + self.fp.read(4 * size)
                 )
+            else:
+                msg = "unknown TGA map depth"
+                raise SyntaxError(msg)
 
         # setup tile descriptor
         try:

From 21e5d5d082dfe47fda2779e10d446e6593c04dd8 Mon Sep 17 00:00:00 2001
From: Andrew Murray <radarhere@users.noreply.github.com>
Date: Wed, 14 Feb 2024 09:17:22 +1100
Subject: [PATCH 0194/1178] Use palette when loading

---
 Tests/test_file_ico.py    | 11 +++++++++++
 src/PIL/IcoImagePlugin.py |  2 ++
 2 files changed, 13 insertions(+)

diff --git a/Tests/test_file_ico.py b/Tests/test_file_ico.py
index 65f090931b4..e75561f6978 100644
--- a/Tests/test_file_ico.py
+++ b/Tests/test_file_ico.py
@@ -38,6 +38,17 @@ def test_black_and_white() -> None:
         assert im.size == (16, 16)
 
 
+def test_palette(tmp_path: Path) -> None:
+    temp_file = str(tmp_path / "temp.ico")
+
+    im = Image.new("P", (16, 16))
+    im.save(temp_file)
+
+    with Image.open(temp_file) as reloaded:
+        assert reloaded.mode == "P"
+        assert reloaded.palette is not None
+
+
 def test_invalid_file() -> None:
     with open("Tests/images/flower.jpg", "rb") as fp:
         with pytest.raises(SyntaxError):
diff --git a/src/PIL/IcoImagePlugin.py b/src/PIL/IcoImagePlugin.py
index 1b22f8645dc..b558fdf3476 100644
--- a/src/PIL/IcoImagePlugin.py
+++ b/src/PIL/IcoImagePlugin.py
@@ -329,6 +329,8 @@ def load(self):
         self.im = im.im
         self.pyaccess = None
         self._mode = im.mode
+        if im.palette:
+            self.palette = im.palette
         if im.size != self.size:
             warnings.warn("Image was not the expected size")
 

From 3199c0ea40c041d41fe2499c86893a7e795f0929 Mon Sep 17 00:00:00 2001
From: Andrew Murray <radarhere@users.noreply.github.com>
Date: Thu, 15 Feb 2024 20:20:42 +1100
Subject: [PATCH 0195/1178] Decoder and encoders subclass PyDecoder and
 PyEncoder

---
 Tests/test_file_jpeg.py |  8 +-----
 Tests/test_image.py     | 16 ++++-------
 Tests/test_imagefile.py | 64 ++++++++++++++++++++---------------------
 src/PIL/Image.py        | 14 ++++-----
 4 files changed, 45 insertions(+), 57 deletions(-)

diff --git a/Tests/test_file_jpeg.py b/Tests/test_file_jpeg.py
index 65424214838..4858d92e6ea 100644
--- a/Tests/test_file_jpeg.py
+++ b/Tests/test_file_jpeg.py
@@ -986,13 +986,7 @@ class InfiniteMockPyDecoder(ImageFile.PyDecoder):
             def decode(self, buffer: bytes) -> tuple[int, int]:
                 return 0, 0
 
-        decoder = InfiniteMockPyDecoder(None)
-
-        def closure(mode: str, *args) -> InfiniteMockPyDecoder:
-            decoder.__init__(mode, *args)
-            return decoder
-
-        Image.register_decoder("INFINITE", closure)
+        Image.register_decoder("INFINITE", InfiniteMockPyDecoder)
 
         with Image.open(TEST_FILE) as im:
             im.tile = [
diff --git a/Tests/test_image.py b/Tests/test_image.py
index 4c04e0da48e..aae51eaa42a 100644
--- a/Tests/test_image.py
+++ b/Tests/test_image.py
@@ -16,6 +16,7 @@
     ExifTags,
     Image,
     ImageDraw,
+    ImageFile,
     ImagePalette,
     UnidentifiedImageError,
     features,
@@ -1038,25 +1039,20 @@ def test_close_graceful(self, caplog: pytest.LogCaptureFixture) -> None:
             assert im.fp is None
 
 
-class MockEncoder:
-    args: tuple[str, ...]
-
-
-def mock_encode(*args: str) -> MockEncoder:
-    encoder = MockEncoder()
-    encoder.args = args
-    return encoder
+class MockEncoder(ImageFile.PyEncoder):
+    pass
 
 
 class TestRegistry:
     def test_encode_registry(self) -> None:
-        Image.register_encoder("MOCK", mock_encode)
+        Image.register_encoder("MOCK", MockEncoder)
         assert "MOCK" in Image.ENCODERS
 
         enc = Image._getencoder("RGB", "MOCK", ("args",), extra=("extra",))
 
         assert isinstance(enc, MockEncoder)
-        assert enc.args == ("RGB", "args", "extra")
+        assert enc.mode == "RGB"
+        assert enc.args == ("args", "extra")
 
     def test_encode_registry_fail(self) -> None:
         with pytest.raises(OSError):
diff --git a/Tests/test_imagefile.py b/Tests/test_imagefile.py
index 49140978168..cf251c9cec6 100644
--- a/Tests/test_imagefile.py
+++ b/Tests/test_imagefile.py
@@ -1,6 +1,7 @@
 from __future__ import annotations
 
 from io import BytesIO
+from typing import Any
 
 import pytest
 
@@ -201,12 +202,22 @@ def test_broken_datastream_without_errors(self) -> None:
 
 
 class MockPyDecoder(ImageFile.PyDecoder):
+    def __init__(self, mode: str, *args: Any) -> None:
+        MockPyDecoder.last = self
+
+        super().__init__(mode, *args)
+
     def decode(self, buffer):
         # eof
         return -1, 0
 
 
 class MockPyEncoder(ImageFile.PyEncoder):
+    def __init__(self, mode: str, *args: Any) -> None:
+        MockPyEncoder.last = self
+
+        super().__init__(mode, *args)
+
     def encode(self, buffer):
         return 1, 1, b""
 
@@ -228,19 +239,8 @@ def _open(self) -> None:
 class CodecsTest:
     @classmethod
     def setup_class(cls) -> None:
-        cls.decoder = MockPyDecoder(None)
-        cls.encoder = MockPyEncoder(None)
-
-        def decoder_closure(mode, *args):
-            cls.decoder.__init__(mode, *args)
-            return cls.decoder
-
-        def encoder_closure(mode, *args):
-            cls.encoder.__init__(mode, *args)
-            return cls.encoder
-
-        Image.register_decoder("MOCK", decoder_closure)
-        Image.register_encoder("MOCK", encoder_closure)
+        Image.register_decoder("MOCK", MockPyDecoder)
+        Image.register_encoder("MOCK", MockPyEncoder)
 
 
 class TestPyDecoder(CodecsTest):
@@ -251,13 +251,13 @@ def test_setimage(self) -> None:
 
         im.load()
 
-        assert self.decoder.state.xoff == xoff
-        assert self.decoder.state.yoff == yoff
-        assert self.decoder.state.xsize == xsize
-        assert self.decoder.state.ysize == ysize
+        assert MockPyDecoder.last.state.xoff == xoff
+        assert MockPyDecoder.last.state.yoff == yoff
+        assert MockPyDecoder.last.state.xsize == xsize
+        assert MockPyDecoder.last.state.ysize == ysize
 
         with pytest.raises(ValueError):
-            self.decoder.set_as_raw(b"\x00")
+            MockPyDecoder.last.set_as_raw(b"\x00")
 
     def test_extents_none(self) -> None:
         buf = BytesIO(b"\x00" * 255)
@@ -267,10 +267,10 @@ def test_extents_none(self) -> None:
 
         im.load()
 
-        assert self.decoder.state.xoff == 0
-        assert self.decoder.state.yoff == 0
-        assert self.decoder.state.xsize == 200
-        assert self.decoder.state.ysize == 200
+        assert MockPyDecoder.last.state.xoff == 0
+        assert MockPyDecoder.last.state.yoff == 0
+        assert MockPyDecoder.last.state.xsize == 200
+        assert MockPyDecoder.last.state.ysize == 200
 
     def test_negsize(self) -> None:
         buf = BytesIO(b"\x00" * 255)
@@ -315,10 +315,10 @@ def test_setimage(self) -> None:
             im, fp, [("MOCK", (xoff, yoff, xoff + xsize, yoff + ysize), 0, "RGB")]
         )
 
-        assert self.encoder.state.xoff == xoff
-        assert self.encoder.state.yoff == yoff
-        assert self.encoder.state.xsize == xsize
-        assert self.encoder.state.ysize == ysize
+        assert MockPyEncoder.last.state.xoff == xoff
+        assert MockPyEncoder.last.state.yoff == yoff
+        assert MockPyEncoder.last.state.xsize == xsize
+        assert MockPyEncoder.last.state.ysize == ysize
 
     def test_extents_none(self) -> None:
         buf = BytesIO(b"\x00" * 255)
@@ -329,10 +329,10 @@ def test_extents_none(self) -> None:
         fp = BytesIO()
         ImageFile._save(im, fp, [("MOCK", None, 0, "RGB")])
 
-        assert self.encoder.state.xoff == 0
-        assert self.encoder.state.yoff == 0
-        assert self.encoder.state.xsize == 200
-        assert self.encoder.state.ysize == 200
+        assert MockPyEncoder.last.state.xoff == 0
+        assert MockPyEncoder.last.state.yoff == 0
+        assert MockPyEncoder.last.state.xsize == 200
+        assert MockPyEncoder.last.state.ysize == 200
 
     def test_negsize(self) -> None:
         buf = BytesIO(b"\x00" * 255)
@@ -340,12 +340,12 @@ def test_negsize(self) -> None:
         im = MockImageFile(buf)
 
         fp = BytesIO()
-        self.encoder.cleanup_called = False
+        MockPyEncoder.last = None
         with pytest.raises(ValueError):
             ImageFile._save(
                 im, fp, [("MOCK", (xoff, yoff, -10, yoff + ysize), 0, "RGB")]
             )
-        assert self.encoder.cleanup_called
+        assert MockPyEncoder.last.cleanup_called
 
         with pytest.raises(ValueError):
             ImageFile._save(
diff --git a/src/PIL/Image.py b/src/PIL/Image.py
index a770488b7ec..eba30537f13 100644
--- a/src/PIL/Image.py
+++ b/src/PIL/Image.py
@@ -229,8 +229,8 @@ class Quantize(IntEnum):
 SAVE: dict[str, Callable[[Image, IO[bytes], str | bytes], None]] = {}
 SAVE_ALL: dict[str, Callable[[Image, IO[bytes], str | bytes], None]] = {}
 EXTENSION: dict[str, str] = {}
-DECODERS: dict[str, object] = {}
-ENCODERS: dict[str, object] = {}
+DECODERS: dict[str, type[ImageFile.PyDecoder]] = {}
+ENCODERS: dict[str, type[ImageFile.PyEncoder]] = {}
 
 # --------------------------------------------------------------------
 # Modes
@@ -3524,28 +3524,26 @@ def registered_extensions():
     return EXTENSION
 
 
-def register_decoder(name: str, decoder) -> None:
+def register_decoder(name: str, decoder: type[ImageFile.PyDecoder]) -> None:
     """
     Registers an image decoder.  This function should not be
     used in application code.
 
     :param name: The name of the decoder
-    :param decoder: A callable(mode, args) that returns an
-                    ImageFile.PyDecoder object
+    :param decoder: An ImageFile.PyDecoder object
 
     .. versionadded:: 4.1.0
     """
     DECODERS[name] = decoder
 
 
-def register_encoder(name, encoder):
+def register_encoder(name: str, encoder: type[ImageFile.PyEncoder]) -> None:
     """
     Registers an image encoder.  This function should not be
     used in application code.
 
     :param name: The name of the encoder
-    :param encoder: A callable(mode, args) that returns an
-                    ImageFile.PyEncoder object
+    :param encoder: An ImageFile.PyEncoder object
 
     .. versionadded:: 4.1.0
     """

From 26e0f6df56c1289d52b156642c6ee1197d2bf69b Mon Sep 17 00:00:00 2001
From: Andrew Murray <radarhere@users.noreply.github.com>
Date: Sat, 17 Feb 2024 10:18:54 +1100
Subject: [PATCH 0196/1178] Pin Python 3.13 on Windows to a3

---
 .github/workflows/test-windows.yml | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/.github/workflows/test-windows.yml b/.github/workflows/test-windows.yml
index 75fccf7959a..79a2e60b251 100644
--- a/.github/workflows/test-windows.yml
+++ b/.github/workflows/test-windows.yml
@@ -32,7 +32,7 @@ jobs:
     strategy:
       fail-fast: false
       matrix:
-        python-version: ["pypy3.10", "pypy3.9", "3.8", "3.9", "3.10", "3.11", "3.12", "3.13"]
+        python-version: ["pypy3.10", "pypy3.9", "3.8", "3.9", "3.10", "3.11", "3.12", "3.13.0-alpha.3"]
 
     timeout-minutes: 30
 

From 5c858d75e4a58e895bed56c2ff6c0bae245c88cf Mon Sep 17 00:00:00 2001
From: Andrew Murray <radarhere@users.noreply.github.com>
Date: Sat, 17 Feb 2024 10:45:52 +1100
Subject: [PATCH 0197/1178] Added type hints

---
 src/PIL/Image.py        |  33 ++++----
 src/PIL/ImageColor.py   |   2 +-
 src/PIL/ImageOps.py     | 171 +++++++++++++++++++++++++++-------------
 src/PIL/ImagePalette.py |   7 +-
 4 files changed, 139 insertions(+), 74 deletions(-)

diff --git a/src/PIL/Image.py b/src/PIL/Image.py
index a770488b7ec..ba81a22c7f0 100644
--- a/src/PIL/Image.py
+++ b/src/PIL/Image.py
@@ -1430,7 +1430,7 @@ def get_value(element):
             root = ElementTree.fromstring(xmp_tags)
             return {get_name(root.tag): get_value(root)}
 
-    def getexif(self):
+    def getexif(self) -> Exif:
         """
         Gets EXIF data from the image.
 
@@ -1438,7 +1438,6 @@ def getexif(self):
         """
         if self._exif is None:
             self._exif = Exif()
-            self._exif._loaded = False
         elif self._exif._loaded:
             return self._exif
         self._exif._loaded = True
@@ -1525,7 +1524,7 @@ def getim(self):
         self.load()
         return self.im.ptr
 
-    def getpalette(self, rawmode="RGB"):
+    def getpalette(self, rawmode: str | None = "RGB") -> list[int] | None:
         """
         Returns the image palette as a list.
 
@@ -1615,7 +1614,7 @@ def getprojection(self):
         x, y = self.im.getprojection()
         return list(x), list(y)
 
-    def histogram(self, mask=None, extrema=None):
+    def histogram(self, mask=None, extrema=None) -> list[int]:
         """
         Returns a histogram for the image. The histogram is returned as a
         list of pixel counts, one for each pixel value in the source
@@ -1804,7 +1803,7 @@ def alpha_composite(self, im, dest=(0, 0), source=(0, 0)):
         result = alpha_composite(background, overlay)
         self.paste(result, box)
 
-    def point(self, lut, mode=None):
+    def point(self, lut, mode: str | None = None) -> Image:
         """
         Maps this image through a lookup table or function.
 
@@ -1928,7 +1927,7 @@ def putdata(self, data, scale=1.0, offset=0.0):
 
         self.im.putdata(data, scale, offset)
 
-    def putpalette(self, data, rawmode="RGB"):
+    def putpalette(self, data, rawmode="RGB") -> None:
         """
         Attaches a palette to this image.  The image must be a "P", "PA", "L"
         or "LA" image.
@@ -2108,7 +2107,7 @@ def _get_safe_box(self, size, resample, box):
             min(self.size[1], math.ceil(box[3] + support_y)),
         )
 
-    def resize(self, size, resample=None, box=None, reducing_gap=None):
+    def resize(self, size, resample=None, box=None, reducing_gap=None) -> Image:
         """
         Returns a resized copy of this image.
 
@@ -2200,10 +2199,11 @@ def resize(self, size, resample=None, box=None, reducing_gap=None):
             if factor_x > 1 or factor_y > 1:
                 reduce_box = self._get_safe_box(size, resample, box)
                 factor = (factor_x, factor_y)
-                if callable(self.reduce):
-                    self = self.reduce(factor, box=reduce_box)
-                else:
-                    self = Image.reduce(self, factor, box=reduce_box)
+                self = (
+                    self.reduce(factor, box=reduce_box)
+                    if callable(self.reduce)
+                    else Image.reduce(self, factor, box=reduce_box)
+                )
                 box = (
                     (box[0] - reduce_box[0]) / factor_x,
                     (box[1] - reduce_box[1]) / factor_y,
@@ -2818,7 +2818,7 @@ def __transformer(
 
         self.im.transform2(box, image.im, method, data, resample, fill)
 
-    def transpose(self, method):
+    def transpose(self, method: Transpose) -> Image:
         """
         Transpose image (flip or rotate in 90 degree steps)
 
@@ -2870,7 +2870,9 @@ class ImagePointHandler:
     (for use with :py:meth:`~PIL.Image.Image.point`)
     """
 
-    pass
+    @abc.abstractmethod
+    def point(self, im: Image) -> Image:
+        pass
 
 
 class ImageTransformHandler:
@@ -3690,6 +3692,7 @@ class Exif(_ExifBase):
 
     endian = None
     bigtiff = False
+    _loaded = False
 
     def __init__(self):
         self._data = {}
@@ -3805,7 +3808,7 @@ def _get_merged_dict(self):
 
         return merged_dict
 
-    def tobytes(self, offset=8):
+    def tobytes(self, offset: int = 8) -> bytes:
         from . import TiffImagePlugin
 
         head = self._get_head()
@@ -3960,7 +3963,7 @@ def __setitem__(self, tag, value):
             del self._info[tag]
         self._data[tag] = value
 
-    def __delitem__(self, tag):
+    def __delitem__(self, tag: int) -> None:
         if self._info is not None and tag in self._info:
             del self._info[tag]
         else:
diff --git a/src/PIL/ImageColor.py b/src/PIL/ImageColor.py
index ad59b066779..5fb80b75310 100644
--- a/src/PIL/ImageColor.py
+++ b/src/PIL/ImageColor.py
@@ -124,7 +124,7 @@ def getrgb(color):
 
 
 @lru_cache
-def getcolor(color, mode):
+def getcolor(color, mode: str) -> tuple[int, ...]:
     """
     Same as :py:func:`~PIL.ImageColor.getrgb` for most modes. However, if
     ``mode`` is HSV, converts the RGB value to a HSV value, or if ``mode`` is
diff --git a/src/PIL/ImageOps.py b/src/PIL/ImageOps.py
index a9e626b2b2a..6218c723f85 100644
--- a/src/PIL/ImageOps.py
+++ b/src/PIL/ImageOps.py
@@ -21,6 +21,7 @@
 import functools
 import operator
 import re
+from typing import Protocol, Sequence, cast
 
 from . import ExifTags, Image, ImagePalette
 
@@ -28,7 +29,7 @@
 # helpers
 
 
-def _border(border):
+def _border(border: int | tuple[int, ...]) -> tuple[int, int, int, int]:
     if isinstance(border, tuple):
         if len(border) == 2:
             left, top = right, bottom = border
@@ -39,7 +40,7 @@ def _border(border):
     return left, top, right, bottom
 
 
-def _color(color, mode):
+def _color(color: str | int | tuple[int, ...], mode: str) -> int | tuple[int, ...]:
     if isinstance(color, str):
         from . import ImageColor
 
@@ -47,7 +48,7 @@ def _color(color, mode):
     return color
 
 
-def _lut(image, lut):
+def _lut(image: Image.Image, lut: list[int]) -> Image.Image:
     if image.mode == "P":
         # FIXME: apply to lookup table, not image data
         msg = "mode P support coming soon"
@@ -65,7 +66,13 @@ def _lut(image, lut):
 # actions
 
 
-def autocontrast(image, cutoff=0, ignore=None, mask=None, preserve_tone=False):
+def autocontrast(
+    image: Image.Image,
+    cutoff: float | tuple[float, float] = 0,
+    ignore: int | Sequence[int] | None = None,
+    mask: Image.Image | None = None,
+    preserve_tone: bool = False,
+) -> Image.Image:
     """
     Maximize (normalize) image contrast. This function calculates a
     histogram of the input image (or mask region), removes ``cutoff`` percent of the
@@ -97,10 +104,9 @@ def autocontrast(image, cutoff=0, ignore=None, mask=None, preserve_tone=False):
         h = histogram[layer : layer + 256]
         if ignore is not None:
             # get rid of outliers
-            try:
+            if isinstance(ignore, int):
                 h[ignore] = 0
-            except TypeError:
-                # assume sequence
+            else:
                 for ix in ignore:
                     h[ix] = 0
         if cutoff:
@@ -112,7 +118,7 @@ def autocontrast(image, cutoff=0, ignore=None, mask=None, preserve_tone=False):
             for ix in range(256):
                 n = n + h[ix]
             # remove cutoff% pixels from the low end
-            cut = n * cutoff[0] // 100
+            cut = int(n * cutoff[0] // 100)
             for lo in range(256):
                 if cut > h[lo]:
                     cut = cut - h[lo]
@@ -123,7 +129,7 @@ def autocontrast(image, cutoff=0, ignore=None, mask=None, preserve_tone=False):
                 if cut <= 0:
                     break
             # remove cutoff% samples from the high end
-            cut = n * cutoff[1] // 100
+            cut = int(n * cutoff[1] // 100)
             for hi in range(255, -1, -1):
                 if cut > h[hi]:
                     cut = cut - h[hi]
@@ -156,7 +162,15 @@ def autocontrast(image, cutoff=0, ignore=None, mask=None, preserve_tone=False):
     return _lut(image, lut)
 
 
-def colorize(image, black, white, mid=None, blackpoint=0, whitepoint=255, midpoint=127):
+def colorize(
+    image: Image.Image,
+    black: str | tuple[int, ...],
+    white: str | tuple[int, ...],
+    mid: str | int | tuple[int, ...] | None = None,
+    blackpoint: int = 0,
+    whitepoint: int = 255,
+    midpoint: int = 127,
+) -> Image.Image:
     """
     Colorize grayscale image.
     This function calculates a color wedge which maps all black pixels in
@@ -188,10 +202,9 @@ def colorize(image, black, white, mid=None, blackpoint=0, whitepoint=255, midpoi
         assert 0 <= blackpoint <= midpoint <= whitepoint <= 255
 
     # Define colors from arguments
-    black = _color(black, "RGB")
-    white = _color(white, "RGB")
-    if mid is not None:
-        mid = _color(mid, "RGB")
+    rgb_black = cast(Sequence[int], _color(black, "RGB"))
+    rgb_white = cast(Sequence[int], _color(white, "RGB"))
+    rgb_mid = cast(Sequence[int], _color(mid, "RGB")) if mid is not None else None
 
     # Empty lists for the mapping
     red = []
@@ -200,18 +213,24 @@ def colorize(image, black, white, mid=None, blackpoint=0, whitepoint=255, midpoi
 
     # Create the low-end values
     for i in range(0, blackpoint):
-        red.append(black[0])
-        green.append(black[1])
-        blue.append(black[2])
+        red.append(rgb_black[0])
+        green.append(rgb_black[1])
+        blue.append(rgb_black[2])
 
     # Create the mapping (2-color)
-    if mid is None:
+    if rgb_mid is None:
         range_map = range(0, whitepoint - blackpoint)
 
         for i in range_map:
-            red.append(black[0] + i * (white[0] - black[0]) // len(range_map))
-            green.append(black[1] + i * (white[1] - black[1]) // len(range_map))
-            blue.append(black[2] + i * (white[2] - black[2]) // len(range_map))
+            red.append(
+                rgb_black[0] + i * (rgb_white[0] - rgb_black[0]) // len(range_map)
+            )
+            green.append(
+                rgb_black[1] + i * (rgb_white[1] - rgb_black[1]) // len(range_map)
+            )
+            blue.append(
+                rgb_black[2] + i * (rgb_white[2] - rgb_black[2]) // len(range_map)
+            )
 
     # Create the mapping (3-color)
     else:
@@ -219,26 +238,36 @@ def colorize(image, black, white, mid=None, blackpoint=0, whitepoint=255, midpoi
         range_map2 = range(0, whitepoint - midpoint)
 
         for i in range_map1:
-            red.append(black[0] + i * (mid[0] - black[0]) // len(range_map1))
-            green.append(black[1] + i * (mid[1] - black[1]) // len(range_map1))
-            blue.append(black[2] + i * (mid[2] - black[2]) // len(range_map1))
+            red.append(
+                rgb_black[0] + i * (rgb_mid[0] - rgb_black[0]) // len(range_map1)
+            )
+            green.append(
+                rgb_black[1] + i * (rgb_mid[1] - rgb_black[1]) // len(range_map1)
+            )
+            blue.append(
+                rgb_black[2] + i * (rgb_mid[2] - rgb_black[2]) // len(range_map1)
+            )
         for i in range_map2:
-            red.append(mid[0] + i * (white[0] - mid[0]) // len(range_map2))
-            green.append(mid[1] + i * (white[1] - mid[1]) // len(range_map2))
-            blue.append(mid[2] + i * (white[2] - mid[2]) // len(range_map2))
+            red.append(rgb_mid[0] + i * (rgb_white[0] - rgb_mid[0]) // len(range_map2))
+            green.append(
+                rgb_mid[1] + i * (rgb_white[1] - rgb_mid[1]) // len(range_map2)
+            )
+            blue.append(rgb_mid[2] + i * (rgb_white[2] - rgb_mid[2]) // len(range_map2))
 
     # Create the high-end values
     for i in range(0, 256 - whitepoint):
-        red.append(white[0])
-        green.append(white[1])
-        blue.append(white[2])
+        red.append(rgb_white[0])
+        green.append(rgb_white[1])
+        blue.append(rgb_white[2])
 
     # Return converted image
     image = image.convert("RGB")
     return _lut(image, red + green + blue)
 
 
-def contain(image, size, method=Image.Resampling.BICUBIC):
+def contain(
+    image: Image.Image, size: tuple[int, int], method: int = Image.Resampling.BICUBIC
+) -> Image.Image:
     """
     Returns a resized version of the image, set to the maximum width and height
     within the requested size, while maintaining the original aspect ratio.
@@ -267,7 +296,9 @@ def contain(image, size, method=Image.Resampling.BICUBIC):
     return image.resize(size, resample=method)
 
 
-def cover(image, size, method=Image.Resampling.BICUBIC):
+def cover(
+    image: Image.Image, size: tuple[int, int], method: int = Image.Resampling.BICUBIC
+) -> Image.Image:
     """
     Returns a resized version of the image, so that the requested size is
     covered, while maintaining the original aspect ratio.
@@ -296,7 +327,13 @@ def cover(image, size, method=Image.Resampling.BICUBIC):
     return image.resize(size, resample=method)
 
 
-def pad(image, size, method=Image.Resampling.BICUBIC, color=None, centering=(0.5, 0.5)):
+def pad(
+    image: Image.Image,
+    size: tuple[int, int],
+    method: int = Image.Resampling.BICUBIC,
+    color: str | int | tuple[int, ...] | None = None,
+    centering: tuple[float, float] = (0.5, 0.5),
+) -> Image.Image:
     """
     Returns a resized and padded version of the image, expanded to fill the
     requested aspect ratio and size.
@@ -334,7 +371,7 @@ def pad(image, size, method=Image.Resampling.BICUBIC, color=None, centering=(0.5
     return out
 
 
-def crop(image, border=0):
+def crop(image: Image.Image, border: int = 0) -> Image.Image:
     """
     Remove border from image.  The same amount of pixels are removed
     from all four sides.  This function works on all image modes.
@@ -349,7 +386,9 @@ def crop(image, border=0):
     return image.crop((left, top, image.size[0] - right, image.size[1] - bottom))
 
 
-def scale(image, factor, resample=Image.Resampling.BICUBIC):
+def scale(
+    image: Image.Image, factor: float, resample: int = Image.Resampling.BICUBIC
+) -> Image.Image:
     """
     Returns a rescaled image by a specific factor given in parameter.
     A factor greater than 1 expands the image, between 0 and 1 contracts the
@@ -372,7 +411,19 @@ def scale(image, factor, resample=Image.Resampling.BICUBIC):
         return image.resize(size, resample)
 
 
-def deform(image, deformer, resample=Image.Resampling.BILINEAR):
+class _SupportsGetMesh(Protocol):
+    def getmesh(
+        self, image: Image.Image
+    ) -> list[
+        tuple[tuple[int, int, int, int], tuple[int, int, int, int, int, int, int, int]]
+    ]: ...
+
+
+def deform(
+    image: Image.Image,
+    deformer: _SupportsGetMesh,
+    resample: int = Image.Resampling.BILINEAR,
+) -> Image.Image:
     """
     Deform the image.
 
@@ -388,7 +439,7 @@ def deform(image, deformer, resample=Image.Resampling.BILINEAR):
     )
 
 
-def equalize(image, mask=None):
+def equalize(image: Image.Image, mask: Image.Image | None = None) -> Image.Image:
     """
     Equalize the image histogram. This function applies a non-linear
     mapping to the input image, in order to create a uniform
@@ -419,7 +470,11 @@ def equalize(image, mask=None):
     return _lut(image, lut)
 
 
-def expand(image, border=0, fill=0):
+def expand(
+    image: Image.Image,
+    border: int | tuple[int, ...] = 0,
+    fill: str | int | tuple[int, ...] = 0,
+) -> Image.Image:
     """
     Add border to the image
 
@@ -445,7 +500,13 @@ def expand(image, border=0, fill=0):
     return out
 
 
-def fit(image, size, method=Image.Resampling.BICUBIC, bleed=0.0, centering=(0.5, 0.5)):
+def fit(
+    image: Image.Image,
+    size: tuple[int, int],
+    method: int = Image.Resampling.BICUBIC,
+    bleed: float = 0.0,
+    centering: tuple[float, float] = (0.5, 0.5),
+) -> Image.Image:
     """
     Returns a resized and cropped version of the image, cropped to the
     requested aspect ratio and size.
@@ -479,13 +540,12 @@ def fit(image, size, method=Image.Resampling.BICUBIC, bleed=0.0, centering=(0.5,
     # kevin@cazabon.com
     # https://www.cazabon.com
 
-    # ensure centering is mutable
-    centering = list(centering)
+    centering_x, centering_y = centering
 
-    if not 0.0 <= centering[0] <= 1.0:
-        centering[0] = 0.5
-    if not 0.0 <= centering[1] <= 1.0:
-        centering[1] = 0.5
+    if not 0.0 <= centering_x <= 1.0:
+        centering_x = 0.5
+    if not 0.0 <= centering_y <= 1.0:
+        centering_y = 0.5
 
     if not 0.0 <= bleed < 0.5:
         bleed = 0.0
@@ -522,8 +582,8 @@ def fit(image, size, method=Image.Resampling.BICUBIC, bleed=0.0, centering=(0.5,
         crop_height = live_size[0] / output_ratio
 
     # make the crop
-    crop_left = bleed_pixels[0] + (live_size[0] - crop_width) * centering[0]
-    crop_top = bleed_pixels[1] + (live_size[1] - crop_height) * centering[1]
+    crop_left = bleed_pixels[0] + (live_size[0] - crop_width) * centering_x
+    crop_top = bleed_pixels[1] + (live_size[1] - crop_height) * centering_y
 
     crop = (crop_left, crop_top, crop_left + crop_width, crop_top + crop_height)
 
@@ -531,7 +591,7 @@ def fit(image, size, method=Image.Resampling.BICUBIC, bleed=0.0, centering=(0.5,
     return image.resize(size, method, box=crop)
 
 
-def flip(image):
+def flip(image: Image.Image) -> Image.Image:
     """
     Flip the image vertically (top to bottom).
 
@@ -541,7 +601,7 @@ def flip(image):
     return image.transpose(Image.Transpose.FLIP_TOP_BOTTOM)
 
 
-def grayscale(image):
+def grayscale(image: Image.Image) -> Image.Image:
     """
     Convert the image to grayscale.
 
@@ -551,7 +611,7 @@ def grayscale(image):
     return image.convert("L")
 
 
-def invert(image):
+def invert(image: Image.Image) -> Image.Image:
     """
     Invert (negate) the image.
 
@@ -562,7 +622,7 @@ def invert(image):
     return image.point(lut) if image.mode == "1" else _lut(image, lut)
 
 
-def mirror(image):
+def mirror(image: Image.Image) -> Image.Image:
     """
     Flip image horizontally (left to right).
 
@@ -572,7 +632,7 @@ def mirror(image):
     return image.transpose(Image.Transpose.FLIP_LEFT_RIGHT)
 
 
-def posterize(image, bits):
+def posterize(image: Image.Image, bits: int) -> Image.Image:
     """
     Reduce the number of bits for each color channel.
 
@@ -585,7 +645,7 @@ def posterize(image, bits):
     return _lut(image, lut)
 
 
-def solarize(image, threshold=128):
+def solarize(image: Image.Image, threshold: int = 128) -> Image.Image:
     """
     Invert all pixel values above a threshold.
 
@@ -602,7 +662,7 @@ def solarize(image, threshold=128):
     return _lut(image, lut)
 
 
-def exif_transpose(image, *, in_place=False):
+def exif_transpose(image: Image.Image, *, in_place: bool = False) -> Image.Image | None:
     """
     If an image has an EXIF Orientation tag, other than 1, transpose the image
     accordingly, and remove the orientation data.
@@ -616,7 +676,7 @@ def exif_transpose(image, *, in_place=False):
     """
     image.load()
     image_exif = image.getexif()
-    orientation = image_exif.get(ExifTags.Base.Orientation)
+    orientation = image_exif.get(ExifTags.Base.Orientation, 1)
     method = {
         2: Image.Transpose.FLIP_LEFT_RIGHT,
         3: Image.Transpose.ROTATE_180,
@@ -653,3 +713,4 @@ def exif_transpose(image, *, in_place=False):
             return transposed_image
     elif not in_place:
         return image.copy()
+    return None
diff --git a/src/PIL/ImagePalette.py b/src/PIL/ImagePalette.py
index 2b6cecc6105..770d10025c8 100644
--- a/src/PIL/ImagePalette.py
+++ b/src/PIL/ImagePalette.py
@@ -18,6 +18,7 @@
 from __future__ import annotations
 
 import array
+from typing import Sequence
 
 from . import GimpGradientFile, GimpPaletteFile, ImageColor, PaletteFile
 
@@ -34,11 +35,11 @@ class ImagePalette:
         Defaults to an empty palette.
     """
 
-    def __init__(self, mode="RGB", palette=None):
+    def __init__(self, mode: str = "RGB", palette: Sequence[int] | None = None) -> None:
         self.mode = mode
         self.rawmode = None  # if set, palette contains raw data
         self.palette = palette or bytearray()
-        self.dirty = None
+        self.dirty: int | None = None
 
     @property
     def palette(self):
@@ -127,7 +128,7 @@ def _new_color_index(self, image=None, e=None):
                 raise ValueError(msg) from e
         return index
 
-    def getcolor(self, color, image=None):
+    def getcolor(self, color, image=None) -> int:
         """Given an rgb tuple, allocate palette entry.
 
         .. warning:: This method is experimental.

From d3b974b78607d36fbfa392b80c81adbd08d277ac Mon Sep 17 00:00:00 2001
From: Andrew Murray <radarhere@users.noreply.github.com>
Date: Sat, 17 Feb 2024 11:19:32 +1100
Subject: [PATCH 0198/1178] Use font in ImageDraw examples

---
 docs/deprecations.rst       | 8 ++++----
 docs/releasenotes/9.2.0.rst | 8 ++++----
 2 files changed, 8 insertions(+), 8 deletions(-)

diff --git a/docs/deprecations.rst b/docs/deprecations.rst
index 205fcb9abcd..a58ce9bcba6 100644
--- a/docs/deprecations.rst
+++ b/docs/deprecations.rst
@@ -232,10 +232,10 @@ Previous code::
 
     im = Image.new("RGB", (100, 100))
     draw = ImageDraw.Draw(im)
-    width, height = draw.textsize("Hello world")
+    width, height = draw.textsize("Hello world", font)
 
     width, height = font.getsize_multiline("Hello\nworld")
-    width, height = draw.multiline_textsize("Hello\nworld")
+    width, height = draw.multiline_textsize("Hello\nworld", font)
 
 Use instead::
 
@@ -247,9 +247,9 @@ Use instead::
 
     im = Image.new("RGB", (100, 100))
     draw = ImageDraw.Draw(im)
-    width = draw.textlength("Hello world")
+    width = draw.textlength("Hello world", font)
 
-    left, top, right, bottom = draw.multiline_textbbox((0, 0), "Hello\nworld")
+    left, top, right, bottom = draw.multiline_textbbox((0, 0), "Hello\nworld", font)
     width, height = right - left, bottom - top
 
 FreeTypeFont.getmask2 fill parameter
diff --git a/docs/releasenotes/9.2.0.rst b/docs/releasenotes/9.2.0.rst
index b875edf8e5c..3b8d2535f74 100644
--- a/docs/releasenotes/9.2.0.rst
+++ b/docs/releasenotes/9.2.0.rst
@@ -69,10 +69,10 @@ Previous code::
 
     im = Image.new("RGB", (100, 100))
     draw = ImageDraw.Draw(im)
-    width, height = draw.textsize("Hello world")
+    width, height = draw.textsize("Hello world", font)
 
     width, height = font.getsize_multiline("Hello\nworld")
-    width, height = draw.multiline_textsize("Hello\nworld")
+    width, height = draw.multiline_textsize("Hello\nworld", font)
 
 Use instead::
 
@@ -84,9 +84,9 @@ Use instead::
 
     im = Image.new("RGB", (100, 100))
     draw = ImageDraw.Draw(im)
-    width = draw.textlength("Hello world")
+    width = draw.textlength("Hello world", font)
 
-    left, top, right, bottom = draw.multiline_textbbox((0, 0), "Hello\nworld")
+    left, top, right, bottom = draw.multiline_textbbox((0, 0), "Hello\nworld", font)
     width, height = right - left, bottom - top
 
 API Additions

From 617b9cbc00759f042d2c38ea63a14adca2bc902b Mon Sep 17 00:00:00 2001
From: Andrew Murray <radarhere@users.noreply.github.com>
Date: Sat, 17 Feb 2024 11:50:48 +1100
Subject: [PATCH 0199/1178] Describe difference between size and bbox

---
 docs/deprecations.rst       | 4 ++++
 docs/releasenotes/9.2.0.rst | 4 ++++
 2 files changed, 8 insertions(+)

diff --git a/docs/deprecations.rst b/docs/deprecations.rst
index a58ce9bcba6..c90ad481adb 100644
--- a/docs/deprecations.rst
+++ b/docs/deprecations.rst
@@ -252,6 +252,10 @@ Use instead::
     left, top, right, bottom = draw.multiline_textbbox((0, 0), "Hello\nworld", font)
     width, height = right - left, bottom - top
 
+Previously, the ``size`` methods returned a ``height`` that included the vertical
+offset of the text, while the new ``bbox`` methods explicitly distinguish this as a
+``top`` offset.
+
 FreeTypeFont.getmask2 fill parameter
 ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
 
diff --git a/docs/releasenotes/9.2.0.rst b/docs/releasenotes/9.2.0.rst
index 3b8d2535f74..495926ca749 100644
--- a/docs/releasenotes/9.2.0.rst
+++ b/docs/releasenotes/9.2.0.rst
@@ -89,6 +89,10 @@ Use instead::
     left, top, right, bottom = draw.multiline_textbbox((0, 0), "Hello\nworld", font)
     width, height = right - left, bottom - top
 
+Previously, the ``size`` methods returned a ``height`` that included the vertical
+offset of the text, while the new ``bbox`` methods explicitly distinguish this as a
+``top`` offset.
+
 API Additions
 =============
 

From 1a108281b9b6d894574ec63534a043385549b3be Mon Sep 17 00:00:00 2001
From: Andrew Murray <radarhere@users.noreply.github.com>
Date: Sat, 17 Feb 2024 14:03:56 +1100
Subject: [PATCH 0200/1178] Removed unused code

---
 Tests/test_format_hsv.py  | 4 ----
 Tests/test_image_paste.py | 1 -
 2 files changed, 5 deletions(-)

diff --git a/Tests/test_format_hsv.py b/Tests/test_format_hsv.py
index 73aaae6e757..da909c06c80 100644
--- a/Tests/test_format_hsv.py
+++ b/Tests/test_format_hsv.py
@@ -12,10 +12,6 @@ def int_to_float(i):
     return i / 255
 
 
-def str_to_float(i):
-    return ord(i) / 255
-
-
 def tuple_to_ints(tp):
     x, y, z = tp
     return int(x * 255.0), int(y * 255.0), int(z * 255.0)
diff --git a/Tests/test_image_paste.py b/Tests/test_image_paste.py
index ce73455729a..2966f724f4a 100644
--- a/Tests/test_image_paste.py
+++ b/Tests/test_image_paste.py
@@ -8,7 +8,6 @@
 
 
 class TestImagingPaste:
-    masks = {}
     size = 128
 
     def assert_9points_image(

From 5ff7d926fd24acc2d6d575959635d59123b308a6 Mon Sep 17 00:00:00 2001
From: Andrew Murray <radarhere@users.noreply.github.com>
Date: Sat, 17 Feb 2024 15:00:38 +1100
Subject: [PATCH 0201/1178] Added type hints

---
 Tests/test_features.py     |   7 +-
 Tests/test_file_blp.py     |   2 +-
 Tests/test_file_bmp.py     |   4 +-
 Tests/test_file_im.py      |   2 +-
 Tests/test_file_pcx.py     |   6 +-
 Tests/test_file_pdf.py     |  15 ++--
 Tests/test_file_tiff.py    |  19 ++---
 Tests/test_format_hsv.py   |  19 +++--
 Tests/test_imagechops.py   |   6 +-
 Tests/test_imagedraw2.py   |  11 +--
 Tests/test_imageenhance.py |   8 ++-
 Tests/test_imagefile.py    |   2 +-
 Tests/test_imagefont.py    | 140 ++++++++++++++++++++++---------------
 Tests/test_imageops.py     |  22 +++---
 Tests/test_imageops_usm.py |  14 ++--
 Tests/test_imagepath.py    |  13 ++--
 16 files changed, 170 insertions(+), 120 deletions(-)

diff --git a/Tests/test_features.py b/Tests/test_features.py
index de74e9c1829..8d2d198ffcd 100644
--- a/Tests/test_features.py
+++ b/Tests/test_features.py
@@ -2,6 +2,7 @@
 
 import io
 import re
+from typing import Callable
 
 import pytest
 
@@ -29,7 +30,7 @@ def test_version() -> None:
     # Check the correctness of the convenience function
     # and the format of version numbers
 
-    def test(name, function) -> None:
+    def test(name: str, function: Callable[[str], bool]) -> None:
         version = features.version(name)
         if not features.check(name):
             assert version is None
@@ -73,12 +74,12 @@ def test_libimagequant_version() -> None:
 
 
 @pytest.mark.parametrize("feature", features.modules)
-def test_check_modules(feature) -> None:
+def test_check_modules(feature: str) -> None:
     assert features.check_module(feature) in [True, False]
 
 
 @pytest.mark.parametrize("feature", features.codecs)
-def test_check_codecs(feature) -> None:
+def test_check_codecs(feature: str) -> None:
     assert features.check_codec(feature) in [True, False]
 
 
diff --git a/Tests/test_file_blp.py b/Tests/test_file_blp.py
index 3904d3bc5b5..1e2f20c407b 100644
--- a/Tests/test_file_blp.py
+++ b/Tests/test_file_blp.py
@@ -71,7 +71,7 @@ def test_save(tmp_path: Path) -> None:
         "Tests/images/timeout-ef9112a065e7183fa7faa2e18929b03e44ee16bf.blp",
     ],
 )
-def test_crashes(test_file) -> None:
+def test_crashes(test_file: str) -> None:
     with open(test_file, "rb") as f:
         with Image.open(f) as im:
             with pytest.raises(OSError):
diff --git a/Tests/test_file_bmp.py b/Tests/test_file_bmp.py
index c36466e0269..1eaff0c7df0 100644
--- a/Tests/test_file_bmp.py
+++ b/Tests/test_file_bmp.py
@@ -16,7 +16,7 @@
 
 
 def test_sanity(tmp_path: Path) -> None:
-    def roundtrip(im) -> None:
+    def roundtrip(im: Image.Image) -> None:
         outfile = str(tmp_path / "temp.bmp")
 
         im.save(outfile, "BMP")
@@ -194,7 +194,7 @@ def test_rle4() -> None:
         ("Tests/images/bmp/g/pal8rle.bmp", 1064),
     ),
 )
-def test_rle8_eof(file_name, length) -> None:
+def test_rle8_eof(file_name: str, length: int) -> None:
     with open(file_name, "rb") as fp:
         data = fp.read(length)
         with Image.open(io.BytesIO(data)) as im:
diff --git a/Tests/test_file_im.py b/Tests/test_file_im.py
index f932069b9c3..036965bf5d8 100644
--- a/Tests/test_file_im.py
+++ b/Tests/test_file_im.py
@@ -82,7 +82,7 @@ def test_eoferror() -> None:
 
 
 @pytest.mark.parametrize("mode", ("RGB", "P", "PA"))
-def test_roundtrip(mode, tmp_path: Path) -> None:
+def test_roundtrip(mode: str, tmp_path: Path) -> None:
     out = str(tmp_path / "temp.im")
     im = hopper(mode)
     im.save(out)
diff --git a/Tests/test_file_pcx.py b/Tests/test_file_pcx.py
index a2486be40c5..ab9f9663e1b 100644
--- a/Tests/test_file_pcx.py
+++ b/Tests/test_file_pcx.py
@@ -9,7 +9,7 @@
 from .helper import assert_image_equal, hopper
 
 
-def _roundtrip(tmp_path: Path, im) -> None:
+def _roundtrip(tmp_path: Path, im: Image.Image) -> None:
     f = str(tmp_path / "temp.pcx")
     im.save(f)
     with Image.open(f) as im2:
@@ -44,7 +44,7 @@ def test_invalid_file() -> None:
 
 
 @pytest.mark.parametrize("mode", ("1", "L", "P", "RGB"))
-def test_odd(tmp_path: Path, mode) -> None:
+def test_odd(tmp_path: Path, mode: str) -> None:
     # See issue #523, odd sized images should have a stride that's even.
     # Not that ImageMagick or GIMP write PCX that way.
     # We were not handling properly.
@@ -89,7 +89,7 @@ def test_large_count(tmp_path: Path) -> None:
     _roundtrip(tmp_path, im)
 
 
-def _test_buffer_overflow(tmp_path: Path, im, size: int = 1024) -> None:
+def _test_buffer_overflow(tmp_path: Path, im: Image.Image, size: int = 1024) -> None:
     _last = ImageFile.MAXBLOCK
     ImageFile.MAXBLOCK = size
     try:
diff --git a/Tests/test_file_pdf.py b/Tests/test_file_pdf.py
index 65a93c138e9..d39a86565ce 100644
--- a/Tests/test_file_pdf.py
+++ b/Tests/test_file_pdf.py
@@ -6,6 +6,7 @@
 import tempfile
 import time
 from pathlib import Path
+from typing import Any, Generator
 
 import pytest
 
@@ -14,7 +15,7 @@
 from .helper import hopper, mark_if_feature_version, skip_unless_feature
 
 
-def helper_save_as_pdf(tmp_path: Path, mode, **kwargs):
+def helper_save_as_pdf(tmp_path: Path, mode: str, **kwargs: Any) -> str:
     # Arrange
     im = hopper(mode)
     outfile = str(tmp_path / ("temp_" + mode + ".pdf"))
@@ -41,13 +42,13 @@ def helper_save_as_pdf(tmp_path: Path, mode, **kwargs):
 
 
 @pytest.mark.parametrize("mode", ("L", "P", "RGB", "CMYK"))
-def test_save(tmp_path: Path, mode) -> None:
+def test_save(tmp_path: Path, mode: str) -> None:
     helper_save_as_pdf(tmp_path, mode)
 
 
 @skip_unless_feature("jpg_2000")
 @pytest.mark.parametrize("mode", ("LA", "RGBA"))
-def test_save_alpha(tmp_path: Path, mode) -> None:
+def test_save_alpha(tmp_path: Path, mode: str) -> None:
     helper_save_as_pdf(tmp_path, mode)
 
 
@@ -112,7 +113,7 @@ def test_resolution(tmp_path: Path) -> None:
         {"dpi": (75, 150), "resolution": 200},
     ),
 )
-def test_dpi(params, tmp_path: Path) -> None:
+def test_dpi(params: dict[str, int | tuple[int, int]], tmp_path: Path) -> None:
     im = hopper()
 
     outfile = str(tmp_path / "temp.pdf")
@@ -156,7 +157,7 @@ def test_save_all(tmp_path: Path) -> None:
         assert os.path.getsize(outfile) > 0
 
         # Test appending using a generator
-        def im_generator(ims):
+        def im_generator(ims: list[Image.Image]) -> Generator[Image.Image, None, None]:
             yield from ims
 
         im.save(outfile, save_all=True, append_images=im_generator(ims))
@@ -226,7 +227,7 @@ def test_pdf_append_fails_on_nonexistent_file() -> None:
             im.save(os.path.join(temp_dir, "nonexistent.pdf"), append=True)
 
 
-def check_pdf_pages_consistency(pdf) -> None:
+def check_pdf_pages_consistency(pdf: PdfParser.PdfParser) -> None:
     pages_info = pdf.read_indirect(pdf.pages_ref)
     assert b"Parent" not in pages_info
     assert b"Kids" in pages_info
@@ -339,7 +340,7 @@ def test_pdf_append_to_bytesio() -> None:
 @pytest.mark.timeout(1)
 @pytest.mark.skipif("PILLOW_VALGRIND_TEST" in os.environ, reason="Valgrind is slower")
 @pytest.mark.parametrize("newline", (b"\r", b"\n"))
-def test_redos(newline) -> None:
+def test_redos(newline: bytes) -> None:
     malicious = b" trailer<<>>" + newline * 3456
 
     # This particular exception isn't relevant here.
diff --git a/Tests/test_file_tiff.py b/Tests/test_file_tiff.py
index a16b76e19f7..0110948aeac 100644
--- a/Tests/test_file_tiff.py
+++ b/Tests/test_file_tiff.py
@@ -4,6 +4,8 @@
 import warnings
 from io import BytesIO
 from pathlib import Path
+from types import ModuleType
+from typing import Generator
 
 import pytest
 
@@ -20,6 +22,7 @@
     is_win32,
 )
 
+ElementTree: ModuleType | None
 try:
     from defusedxml import ElementTree
 except ImportError:
@@ -156,7 +159,7 @@ def test_int_resolution(self) -> None:
         "resolution_unit, dpi",
         [(None, 72.8), (2, 72.8), (3, 184.912)],
     )
-    def test_load_float_dpi(self, resolution_unit, dpi) -> None:
+    def test_load_float_dpi(self, resolution_unit: int | None, dpi: float) -> None:
         with Image.open(
             "Tests/images/hopper_float_dpi_" + str(resolution_unit) + ".tif"
         ) as im:
@@ -284,7 +287,7 @@ def test_unknown_pixel_mode(self) -> None:
             ("Tests/images/multipage.tiff", 3),
         ),
     )
-    def test_n_frames(self, path, n_frames) -> None:
+    def test_n_frames(self, path: str, n_frames: int) -> None:
         with Image.open(path) as im:
             assert im.n_frames == n_frames
             assert im.is_animated == (n_frames != 1)
@@ -402,7 +405,7 @@ def test__delitem__(self) -> None:
             assert len_before == len_after + 1
 
     @pytest.mark.parametrize("legacy_api", (False, True))
-    def test_load_byte(self, legacy_api) -> None:
+    def test_load_byte(self, legacy_api: bool) -> None:
         ifd = TiffImagePlugin.ImageFileDirectory_v2()
         data = b"abc"
         ret = ifd.load_byte(data, legacy_api)
@@ -431,7 +434,7 @@ def test_ifd_tag_type(self) -> None:
             assert 0x8825 in im.tag_v2
 
     def test_exif(self, tmp_path: Path) -> None:
-        def check_exif(exif) -> None:
+        def check_exif(exif: Image.Exif) -> None:
             assert sorted(exif.keys()) == [
                 256,
                 257,
@@ -511,7 +514,7 @@ def test_exif_frames(self) -> None:
             assert im.getexif()[273] == (1408, 1907)
 
     @pytest.mark.parametrize("mode", ("1", "L"))
-    def test_photometric(self, mode, tmp_path: Path) -> None:
+    def test_photometric(self, mode: str, tmp_path: Path) -> None:
         filename = str(tmp_path / "temp.tif")
         im = hopper(mode)
         im.save(filename, tiffinfo={262: 0})
@@ -660,7 +663,7 @@ def test_planar_configuration_save(self, tmp_path: Path) -> None:
                 assert_image_equal_tofile(reloaded, infile)
 
     @pytest.mark.parametrize("mode", ("P", "PA"))
-    def test_palette(self, mode, tmp_path: Path) -> None:
+    def test_palette(self, mode: str, tmp_path: Path) -> None:
         outfile = str(tmp_path / "temp.tif")
 
         im = hopper(mode)
@@ -689,7 +692,7 @@ def test_tiff_save_all(self) -> None:
             assert reread.n_frames == 3
 
         # Test appending using a generator
-        def im_generator(ims):
+        def im_generator(ims: list[Image.Image]) -> Generator[Image.Image, None, None]:
             yield from ims
 
         mp = BytesIO()
@@ -860,7 +863,7 @@ def test_timeout(self) -> None:
         ],
     )
     @pytest.mark.timeout(2)
-    def test_oom(self, test_file) -> None:
+    def test_oom(self, test_file: str) -> None:
         with pytest.raises(UnidentifiedImageError):
             with pytest.warns(UserWarning):
                 with Image.open(test_file):
diff --git a/Tests/test_format_hsv.py b/Tests/test_format_hsv.py
index 73aaae6e757..fe055bf4b15 100644
--- a/Tests/test_format_hsv.py
+++ b/Tests/test_format_hsv.py
@@ -2,21 +2,22 @@
 
 import colorsys
 import itertools
+from typing import Callable
 
 from PIL import Image
 
 from .helper import assert_image_similar, hopper
 
 
-def int_to_float(i):
+def int_to_float(i: int) -> float:
     return i / 255
 
 
-def str_to_float(i):
+def str_to_float(i: str) -> float:
     return ord(i) / 255
 
 
-def tuple_to_ints(tp):
+def tuple_to_ints(tp: tuple[float, float, float]) -> tuple[int, int, int]:
     x, y, z = tp
     return int(x * 255.0), int(y * 255.0), int(z * 255.0)
 
@@ -25,7 +26,7 @@ def test_sanity() -> None:
     Image.new("HSV", (100, 100))
 
 
-def wedge():
+def wedge() -> Image.Image:
     w = Image._wedge()
     w90 = w.rotate(90)
 
@@ -49,7 +50,11 @@ def wedge():
     return img
 
 
-def to_xxx_colorsys(im, func, mode):
+def to_xxx_colorsys(
+    im: Image.Image,
+    func: Callable[[float, float, float], tuple[float, float, float]],
+    mode: str,
+) -> Image.Image:
     # convert the hard way using the library colorsys routines.
 
     (r, g, b) = im.split()
@@ -70,11 +75,11 @@ def to_xxx_colorsys(im, func, mode):
     return hsv
 
 
-def to_hsv_colorsys(im):
+def to_hsv_colorsys(im: Image.Image) -> Image.Image:
     return to_xxx_colorsys(im, colorsys.rgb_to_hsv, "HSV")
 
 
-def to_rgb_colorsys(im):
+def to_rgb_colorsys(im: Image.Image) -> Image.Image:
     return to_xxx_colorsys(im, colorsys.hsv_to_rgb, "RGB")
 
 
diff --git a/Tests/test_imagechops.py b/Tests/test_imagechops.py
index 94f57e06690..7e2290c156e 100644
--- a/Tests/test_imagechops.py
+++ b/Tests/test_imagechops.py
@@ -1,5 +1,7 @@
 from __future__ import annotations
 
+from typing import Callable
+
 from PIL import Image, ImageChops
 
 from .helper import assert_image_equal, hopper
@@ -387,7 +389,9 @@ def test_overlay() -> None:
 
 
 def test_logical() -> None:
-    def table(op, a, b):
+    def table(
+        op: Callable[[Image.Image, Image.Image], Image.Image], a: int, b: int
+    ) -> tuple[int, int, int, int]:
         out = []
         for x in (a, b):
             imx = Image.new("1", (1, 1), x)
diff --git a/Tests/test_imagedraw2.py b/Tests/test_imagedraw2.py
index 07a25b84b4e..3171eb9aec1 100644
--- a/Tests/test_imagedraw2.py
+++ b/Tests/test_imagedraw2.py
@@ -5,6 +5,7 @@
 import pytest
 
 from PIL import Image, ImageDraw, ImageDraw2, features
+from PIL._typing import Coords
 
 from .helper import (
     assert_image_equal,
@@ -56,7 +57,7 @@ def test_sanity() -> None:
 
 
 @pytest.mark.parametrize("bbox", BBOX)
-def test_ellipse(bbox) -> None:
+def test_ellipse(bbox: Coords) -> None:
     # Arrange
     im = Image.new("RGB", (W, H))
     draw = ImageDraw2.Draw(im)
@@ -84,7 +85,7 @@ def test_ellipse_edge() -> None:
 
 
 @pytest.mark.parametrize("points", POINTS)
-def test_line(points) -> None:
+def test_line(points: Coords) -> None:
     # Arrange
     im = Image.new("RGB", (W, H))
     draw = ImageDraw2.Draw(im)
@@ -98,7 +99,7 @@ def test_line(points) -> None:
 
 
 @pytest.mark.parametrize("points", POINTS)
-def test_line_pen_as_brush(points) -> None:
+def test_line_pen_as_brush(points: Coords) -> None:
     # Arrange
     im = Image.new("RGB", (W, H))
     draw = ImageDraw2.Draw(im)
@@ -114,7 +115,7 @@ def test_line_pen_as_brush(points) -> None:
 
 
 @pytest.mark.parametrize("points", POINTS)
-def test_polygon(points) -> None:
+def test_polygon(points: Coords) -> None:
     # Arrange
     im = Image.new("RGB", (W, H))
     draw = ImageDraw2.Draw(im)
@@ -129,7 +130,7 @@ def test_polygon(points) -> None:
 
 
 @pytest.mark.parametrize("bbox", BBOX)
-def test_rectangle(bbox) -> None:
+def test_rectangle(bbox: Coords) -> None:
     # Arrange
     im = Image.new("RGB", (W, H))
     draw = ImageDraw2.Draw(im)
diff --git a/Tests/test_imageenhance.py b/Tests/test_imageenhance.py
index 9ce9cda8267..6ebc61e1bc4 100644
--- a/Tests/test_imageenhance.py
+++ b/Tests/test_imageenhance.py
@@ -22,7 +22,7 @@ def test_crash() -> None:
     ImageEnhance.Sharpness(im).enhance(0.5)
 
 
-def _half_transparent_image():
+def _half_transparent_image() -> Image.Image:
     # returns an image, half transparent, half solid
     im = hopper("RGB")
 
@@ -34,7 +34,9 @@ def _half_transparent_image():
     return im
 
 
-def _check_alpha(im, original, op, amount) -> None:
+def _check_alpha(
+    im: Image.Image, original: Image.Image, op: str, amount: float
+) -> None:
     assert im.getbands() == original.getbands()
     assert_image_equal(
         im.getchannel("A"),
@@ -44,7 +46,7 @@ def _check_alpha(im, original, op, amount) -> None:
 
 
 @pytest.mark.parametrize("op", ("Color", "Brightness", "Contrast", "Sharpness"))
-def test_alpha(op) -> None:
+def test_alpha(op: str) -> None:
     # Issue https://github.com/python-pillow/Pillow/issues/899
     # Is alpha preserved through image enhancement?
 
diff --git a/Tests/test_imagefile.py b/Tests/test_imagefile.py
index 49140978168..44521a8b3dd 100644
--- a/Tests/test_imagefile.py
+++ b/Tests/test_imagefile.py
@@ -31,7 +31,7 @@
 
 class TestImageFile:
     def test_parser(self) -> None:
-        def roundtrip(format):
+        def roundtrip(format: str) -> tuple[Image.Image, Image.Image]:
             im = hopper("L").resize((1000, 1000), Image.Resampling.NEAREST)
             if format in ("MSP", "XBM"):
                 im = im.convert("1")
diff --git a/Tests/test_imagefont.py b/Tests/test_imagefont.py
index 909026dc8c6..c79b36ca432 100644
--- a/Tests/test_imagefont.py
+++ b/Tests/test_imagefont.py
@@ -7,11 +7,13 @@
 import sys
 from io import BytesIO
 from pathlib import Path
+from typing import BinaryIO
 
 import pytest
 from packaging.version import parse as parse_version
 
 from PIL import Image, ImageDraw, ImageFont, features
+from PIL._typing import StrOrBytesPath
 
 from .helper import (
     assert_image_equal,
@@ -47,11 +49,11 @@ def layout_engine(request):
 
 
 @pytest.fixture(scope="module")
-def font(layout_engine):
+def font(layout_engine: ImageFont.Layout) -> ImageFont.FreeTypeFont:
     return ImageFont.truetype(FONT_PATH, FONT_SIZE, layout_engine=layout_engine)
 
 
-def test_font_properties(font) -> None:
+def test_font_properties(font: ImageFont.FreeTypeFont) -> None:
     assert font.path == FONT_PATH
     assert font.size == FONT_SIZE
 
@@ -67,7 +69,9 @@ def test_font_properties(font) -> None:
     assert font_copy.path == second_font_path
 
 
-def _render(font, layout_engine):
+def _render(
+    font: StrOrBytesPath | BinaryIO, layout_engine: ImageFont.Layout
+) -> Image.Image:
     txt = "Hello World!"
     ttf = ImageFont.truetype(font, FONT_SIZE, layout_engine=layout_engine)
     ttf.getbbox(txt)
@@ -80,12 +84,12 @@ def _render(font, layout_engine):
 
 
 @pytest.mark.parametrize("font", (FONT_PATH, Path(FONT_PATH)))
-def test_font_with_name(layout_engine, font) -> None:
+def test_font_with_name(layout_engine: ImageFont.Layout, font: str | Path) -> None:
     _render(font, layout_engine)
 
 
-def test_font_with_filelike(layout_engine) -> None:
-    def _font_as_bytes():
+def test_font_with_filelike(layout_engine: ImageFont.Layout) -> None:
+    def _font_as_bytes() -> BytesIO:
         with open(FONT_PATH, "rb") as f:
             font_bytes = BytesIO(f.read())
         return font_bytes
@@ -102,12 +106,12 @@ def _font_as_bytes():
     #   _render(shared_bytes)
 
 
-def test_font_with_open_file(layout_engine) -> None:
+def test_font_with_open_file(layout_engine: ImageFont.Layout) -> None:
     with open(FONT_PATH, "rb") as f:
         _render(f, layout_engine)
 
 
-def test_render_equal(layout_engine) -> None:
+def test_render_equal(layout_engine: ImageFont.Layout) -> None:
     img_path = _render(FONT_PATH, layout_engine)
     with open(FONT_PATH, "rb") as f:
         font_filelike = BytesIO(f.read())
@@ -116,7 +120,7 @@ def test_render_equal(layout_engine) -> None:
     assert_image_equal(img_path, img_filelike)
 
 
-def test_non_ascii_path(tmp_path: Path, layout_engine) -> None:
+def test_non_ascii_path(tmp_path: Path, layout_engine: ImageFont.Layout) -> None:
     tempfile = str(tmp_path / ("temp_" + chr(128) + ".ttf"))
     try:
         shutil.copy(FONT_PATH, tempfile)
@@ -126,7 +130,7 @@ def test_non_ascii_path(tmp_path: Path, layout_engine) -> None:
     ImageFont.truetype(tempfile, FONT_SIZE, layout_engine=layout_engine)
 
 
-def test_transparent_background(font) -> None:
+def test_transparent_background(font: ImageFont.FreeTypeFont) -> None:
     im = Image.new(mode="RGBA", size=(300, 100))
     draw = ImageDraw.Draw(im)
 
@@ -140,7 +144,7 @@ def test_transparent_background(font) -> None:
     assert_image_similar_tofile(im.convert("L"), target, 0.01)
 
 
-def test_I16(font) -> None:
+def test_I16(font: ImageFont.FreeTypeFont) -> None:
     im = Image.new(mode="I;16", size=(300, 100))
     draw = ImageDraw.Draw(im)
 
@@ -153,7 +157,7 @@ def test_I16(font) -> None:
     assert_image_similar_tofile(im.convert("L"), target, 0.01)
 
 
-def test_textbbox_equal(font) -> None:
+def test_textbbox_equal(font: ImageFont.FreeTypeFont) -> None:
     im = Image.new(mode="RGB", size=(300, 100))
     draw = ImageDraw.Draw(im)
 
@@ -181,7 +185,13 @@ def test_textbbox_equal(font) -> None:
     ),
 )
 def test_getlength(
-    text, mode, fontname, size, layout_engine, length_basic, length_raqm
+    text: str,
+    mode: str,
+    fontname: str,
+    size: int,
+    layout_engine: ImageFont.Layout,
+    length_basic: int,
+    length_raqm: float,
 ) -> None:
     f = ImageFont.truetype("Tests/fonts/" + fontname, size, layout_engine=layout_engine)
 
@@ -207,7 +217,7 @@ def test_float_size() -> None:
     assert lengths[0] != lengths[1] != lengths[2]
 
 
-def test_render_multiline(font) -> None:
+def test_render_multiline(font: ImageFont.FreeTypeFont) -> None:
     im = Image.new(mode="RGB", size=(300, 100))
     draw = ImageDraw.Draw(im)
     line_spacing = font.getbbox("A")[3] + 4
@@ -223,7 +233,7 @@ def test_render_multiline(font) -> None:
     assert_image_similar_tofile(im, "Tests/images/multiline_text.png", 6.2)
 
 
-def test_render_multiline_text(font) -> None:
+def test_render_multiline_text(font: ImageFont.FreeTypeFont) -> None:
     # Test that text() correctly connects to multiline_text()
     # and that align defaults to left
     im = Image.new(mode="RGB", size=(300, 100))
@@ -243,7 +253,9 @@ def test_render_multiline_text(font) -> None:
 @pytest.mark.parametrize(
     "align, ext", (("left", ""), ("center", "_center"), ("right", "_right"))
 )
-def test_render_multiline_text_align(font, align, ext) -> None:
+def test_render_multiline_text_align(
+    font: ImageFont.FreeTypeFont, align: str, ext: str
+) -> None:
     im = Image.new(mode="RGB", size=(300, 100))
     draw = ImageDraw.Draw(im)
     draw.multiline_text((0, 0), TEST_TEXT, font=font, align=align)
@@ -251,7 +263,7 @@ def test_render_multiline_text_align(font, align, ext) -> None:
     assert_image_similar_tofile(im, f"Tests/images/multiline_text{ext}.png", 0.01)
 
 
-def test_unknown_align(font) -> None:
+def test_unknown_align(font: ImageFont.FreeTypeFont) -> None:
     im = Image.new(mode="RGB", size=(300, 100))
     draw = ImageDraw.Draw(im)
 
@@ -260,14 +272,14 @@ def test_unknown_align(font) -> None:
         draw.multiline_text((0, 0), TEST_TEXT, font=font, align="unknown")
 
 
-def test_draw_align(font) -> None:
+def test_draw_align(font: ImageFont.FreeTypeFont) -> None:
     im = Image.new("RGB", (300, 100), "white")
     draw = ImageDraw.Draw(im)
     line = "some text"
     draw.text((100, 40), line, (0, 0, 0), font=font, align="left")
 
 
-def test_multiline_bbox(font) -> None:
+def test_multiline_bbox(font: ImageFont.FreeTypeFont) -> None:
     im = Image.new(mode="RGB", size=(300, 100))
     draw = ImageDraw.Draw(im)
 
@@ -285,7 +297,7 @@ def test_multiline_bbox(font) -> None:
     draw.textbbox((0, 0), TEST_TEXT, font=font, spacing=4)
 
 
-def test_multiline_width(font) -> None:
+def test_multiline_width(font: ImageFont.FreeTypeFont) -> None:
     im = Image.new(mode="RGB", size=(300, 100))
     draw = ImageDraw.Draw(im)
 
@@ -295,7 +307,7 @@ def test_multiline_width(font) -> None:
     )
 
 
-def test_multiline_spacing(font) -> None:
+def test_multiline_spacing(font: ImageFont.FreeTypeFont) -> None:
     im = Image.new(mode="RGB", size=(300, 100))
     draw = ImageDraw.Draw(im)
     draw.multiline_text((0, 0), TEST_TEXT, font=font, spacing=10)
@@ -306,7 +318,9 @@ def test_multiline_spacing(font) -> None:
 @pytest.mark.parametrize(
     "orientation", (Image.Transpose.ROTATE_90, Image.Transpose.ROTATE_270)
 )
-def test_rotated_transposed_font(font, orientation) -> None:
+def test_rotated_transposed_font(
+    font: ImageFont.FreeTypeFont, orientation: Image.Transpose
+) -> None:
     img_gray = Image.new("L", (100, 100))
     draw = ImageDraw.Draw(img_gray)
     word = "testing"
@@ -347,7 +361,9 @@ def test_rotated_transposed_font(font, orientation) -> None:
         Image.Transpose.FLIP_TOP_BOTTOM,
     ),
 )
-def test_unrotated_transposed_font(font, orientation) -> None:
+def test_unrotated_transposed_font(
+    font: ImageFont.FreeTypeFont, orientation: Image.Transpose
+) -> None:
     img_gray = Image.new("L", (100, 100))
     draw = ImageDraw.Draw(img_gray)
     word = "testing"
@@ -382,7 +398,9 @@ def test_unrotated_transposed_font(font, orientation) -> None:
 @pytest.mark.parametrize(
     "orientation", (Image.Transpose.ROTATE_90, Image.Transpose.ROTATE_270)
 )
-def test_rotated_transposed_font_get_mask(font, orientation) -> None:
+def test_rotated_transposed_font_get_mask(
+    font: ImageFont.FreeTypeFont, orientation: Image.Transpose
+) -> None:
     # Arrange
     text = "mask this"
     transposed_font = ImageFont.TransposedFont(font, orientation=orientation)
@@ -403,7 +421,9 @@ def test_rotated_transposed_font_get_mask(font, orientation) -> None:
         Image.Transpose.FLIP_TOP_BOTTOM,
     ),
 )
-def test_unrotated_transposed_font_get_mask(font, orientation) -> None:
+def test_unrotated_transposed_font_get_mask(
+    font: ImageFont.FreeTypeFont, orientation: Image.Transpose
+) -> None:
     # Arrange
     text = "mask this"
     transposed_font = ImageFont.TransposedFont(font, orientation=orientation)
@@ -415,11 +435,11 @@ def test_unrotated_transposed_font_get_mask(font, orientation) -> None:
     assert mask.size == (108, 13)
 
 
-def test_free_type_font_get_name(font) -> None:
+def test_free_type_font_get_name(font: ImageFont.FreeTypeFont) -> None:
     assert ("FreeMono", "Regular") == font.getname()
 
 
-def test_free_type_font_get_metrics(font) -> None:
+def test_free_type_font_get_metrics(font: ImageFont.FreeTypeFont) -> None:
     ascent, descent = font.getmetrics()
 
     assert isinstance(ascent, int)
@@ -427,7 +447,7 @@ def test_free_type_font_get_metrics(font) -> None:
     assert (ascent, descent) == (16, 4)
 
 
-def test_free_type_font_get_mask(font) -> None:
+def test_free_type_font_get_mask(font: ImageFont.FreeTypeFont) -> None:
     # Arrange
     text = "mask this"
 
@@ -473,16 +493,16 @@ def test_default_font() -> None:
 
 
 @pytest.mark.parametrize("mode", (None, "1", "RGBA"))
-def test_getbbox(font, mode) -> None:
+def test_getbbox(font: ImageFont.FreeTypeFont, mode: str | None) -> None:
     assert (0, 4, 12, 16) == font.getbbox("A", mode)
 
 
-def test_getbbox_empty(font) -> None:
+def test_getbbox_empty(font: ImageFont.FreeTypeFont) -> None:
     # issue #2614, should not crash.
     assert (0, 0, 0, 0) == font.getbbox("")
 
 
-def test_render_empty(font) -> None:
+def test_render_empty(font: ImageFont.FreeTypeFont) -> None:
     # issue 2666
     im = Image.new(mode="RGB", size=(300, 100))
     target = im.copy()
@@ -492,7 +512,7 @@ def test_render_empty(font) -> None:
     assert_image_equal(im, target)
 
 
-def test_unicode_extended(layout_engine) -> None:
+def test_unicode_extended(layout_engine: ImageFont.Layout) -> None:
     # issue #3777
     text = "A\u278A\U0001F12B"
     target = "Tests/images/unicode_extended.png"
@@ -516,7 +536,7 @@ def test_unicode_extended(layout_engine) -> None:
 )
 @pytest.mark.skipif(is_win32(), reason="requires Unix or macOS")
 def test_find_font(monkeypatch, platform, font_directory) -> None:
-    def _test_fake_loading_font(path_to_fake, fontname) -> None:
+    def _test_fake_loading_font(path_to_fake: str, fontname: str) -> None:
         # Make a copy of FreeTypeFont so we can patch the original
         free_type_font = copy.deepcopy(ImageFont.FreeTypeFont)
         with monkeypatch.context() as m:
@@ -567,7 +587,7 @@ def fake_walker(path):
     _test_fake_loading_font(font_directory + "/Duplicate.ttf", "Duplicate")
 
 
-def test_imagefont_getters(font) -> None:
+def test_imagefont_getters(font: ImageFont.FreeTypeFont) -> None:
     assert font.getmetrics() == (16, 4)
     assert font.font.ascent == 16
     assert font.font.descent == 4
@@ -588,7 +608,7 @@ def test_imagefont_getters(font) -> None:
 
 
 @pytest.mark.parametrize("stroke_width", (0, 2))
-def test_getsize_stroke(font, stroke_width) -> None:
+def test_getsize_stroke(font: ImageFont.FreeTypeFont, stroke_width: int) -> None:
     assert font.getbbox("A", stroke_width=stroke_width) == (
         0 - stroke_width,
         4 - stroke_width,
@@ -607,7 +627,7 @@ def test_complex_font_settings() -> None:
         t.getmask("абвг", language="sr")
 
 
-def test_variation_get(font) -> None:
+def test_variation_get(font: ImageFont.FreeTypeFont) -> None:
     freetype = parse_version(features.version_module("freetype2"))
     if freetype < parse_version("2.9.1"):
         with pytest.raises(NotImplementedError):
@@ -662,7 +682,7 @@ def test_variation_get(font) -> None:
     ]
 
 
-def _check_text(font, path, epsilon):
+def _check_text(font: ImageFont.FreeTypeFont, path: str, epsilon: float) -> None:
     im = Image.new("RGB", (100, 75), "white")
     d = ImageDraw.Draw(im)
     d.text((10, 10), "Text", font=font, fill="black")
@@ -677,7 +697,7 @@ def _check_text(font, path, epsilon):
             raise
 
 
-def test_variation_set_by_name(font) -> None:
+def test_variation_set_by_name(font: ImageFont.FreeTypeFont) -> None:
     freetype = parse_version(features.version_module("freetype2"))
     if freetype < parse_version("2.9.1"):
         with pytest.raises(NotImplementedError):
@@ -702,7 +722,7 @@ def test_variation_set_by_name(font) -> None:
     _check_text(font, "Tests/images/variation_tiny_name.png", 40)
 
 
-def test_variation_set_by_axes(font) -> None:
+def test_variation_set_by_axes(font: ImageFont.FreeTypeFont) -> None:
     freetype = parse_version(features.version_module("freetype2"))
     if freetype < parse_version("2.9.1"):
         with pytest.raises(NotImplementedError):
@@ -737,7 +757,9 @@ def test_variation_set_by_axes(font) -> None:
     ),
     ids=("ls", "ms", "rs", "ma", "mt", "mm", "mb", "md"),
 )
-def test_anchor(layout_engine, anchor, left, top) -> None:
+def test_anchor(
+    layout_engine: ImageFont.Layout, anchor: str, left: int, top: int
+) -> None:
     name, text = "quick", "Quick"
     path = f"Tests/images/test_anchor_{name}_{anchor}.png"
 
@@ -782,7 +804,9 @@ def test_anchor(layout_engine, anchor, left, top) -> None:
         ("md", "center"),
     ),
 )
-def test_anchor_multiline(layout_engine, anchor, align) -> None:
+def test_anchor_multiline(
+    layout_engine: ImageFont.Layout, anchor: str, align: str
+) -> None:
     target = f"Tests/images/test_anchor_multiline_{anchor}_{align}.png"
     text = "a\nlong\ntext sample"
 
@@ -800,7 +824,7 @@ def test_anchor_multiline(layout_engine, anchor, align) -> None:
     assert_image_similar_tofile(im, target, 4)
 
 
-def test_anchor_invalid(font) -> None:
+def test_anchor_invalid(font: ImageFont.FreeTypeFont) -> None:
     im = Image.new("RGB", (100, 100), "white")
     d = ImageDraw.Draw(im)
     d.font = font
@@ -826,7 +850,7 @@ def test_anchor_invalid(font) -> None:
 
 
 @pytest.mark.parametrize("bpp", (1, 2, 4, 8))
-def test_bitmap_font(layout_engine, bpp) -> None:
+def test_bitmap_font(layout_engine: ImageFont.Layout, bpp: int) -> None:
     text = "Bitmap Font"
     layout_name = ["basic", "raqm"][layout_engine]
     target = f"Tests/images/bitmap_font_{bpp}_{layout_name}.png"
@@ -843,7 +867,7 @@ def test_bitmap_font(layout_engine, bpp) -> None:
     assert_image_equal_tofile(im, target)
 
 
-def test_bitmap_font_stroke(layout_engine) -> None:
+def test_bitmap_font_stroke(layout_engine: ImageFont.Layout) -> None:
     text = "Bitmap Font"
     layout_name = ["basic", "raqm"][layout_engine]
     target = f"Tests/images/bitmap_font_stroke_{layout_name}.png"
@@ -861,7 +885,7 @@ def test_bitmap_font_stroke(layout_engine) -> None:
 
 
 @pytest.mark.parametrize("embedded_color", (False, True))
-def test_bitmap_blend(layout_engine, embedded_color) -> None:
+def test_bitmap_blend(layout_engine: ImageFont.Layout, embedded_color: bool) -> None:
     font = ImageFont.truetype(
         "Tests/fonts/EBDTTestFont.ttf", size=64, layout_engine=layout_engine
     )
@@ -873,7 +897,7 @@ def test_bitmap_blend(layout_engine, embedded_color) -> None:
     assert_image_equal_tofile(im, "Tests/images/bitmap_font_blend.png")
 
 
-def test_standard_embedded_color(layout_engine) -> None:
+def test_standard_embedded_color(layout_engine: ImageFont.Layout) -> None:
     txt = "Hello World!"
     ttf = ImageFont.truetype(FONT_PATH, 40, layout_engine=layout_engine)
     ttf.getbbox(txt)
@@ -886,7 +910,7 @@ def test_standard_embedded_color(layout_engine) -> None:
 
 
 @pytest.mark.parametrize("fontmode", ("1", "L", "RGBA"))
-def test_float_coord(layout_engine, fontmode):
+def test_float_coord(layout_engine: ImageFont.Layout, fontmode: str) -> None:
     txt = "Hello World!"
     ttf = ImageFont.truetype(FONT_PATH, 40, layout_engine=layout_engine)
 
@@ -908,7 +932,7 @@ def test_float_coord(layout_engine, fontmode):
             raise
 
 
-def test_cbdt(layout_engine) -> None:
+def test_cbdt(layout_engine: ImageFont.Layout) -> None:
     try:
         font = ImageFont.truetype(
             "Tests/fonts/CBDTTestFont.ttf", size=64, layout_engine=layout_engine
@@ -925,7 +949,7 @@ def test_cbdt(layout_engine) -> None:
         pytest.skip("freetype compiled without libpng or CBDT support")
 
 
-def test_cbdt_mask(layout_engine) -> None:
+def test_cbdt_mask(layout_engine: ImageFont.Layout) -> None:
     try:
         font = ImageFont.truetype(
             "Tests/fonts/CBDTTestFont.ttf", size=64, layout_engine=layout_engine
@@ -942,7 +966,7 @@ def test_cbdt_mask(layout_engine) -> None:
         pytest.skip("freetype compiled without libpng or CBDT support")
 
 
-def test_sbix(layout_engine) -> None:
+def test_sbix(layout_engine: ImageFont.Layout) -> None:
     try:
         font = ImageFont.truetype(
             "Tests/fonts/chromacheck-sbix.woff", size=300, layout_engine=layout_engine
@@ -959,7 +983,7 @@ def test_sbix(layout_engine) -> None:
         pytest.skip("freetype compiled without libpng or SBIX support")
 
 
-def test_sbix_mask(layout_engine) -> None:
+def test_sbix_mask(layout_engine: ImageFont.Layout) -> None:
     try:
         font = ImageFont.truetype(
             "Tests/fonts/chromacheck-sbix.woff", size=300, layout_engine=layout_engine
@@ -977,7 +1001,7 @@ def test_sbix_mask(layout_engine) -> None:
 
 
 @skip_unless_feature_version("freetype2", "2.10.0")
-def test_colr(layout_engine) -> None:
+def test_colr(layout_engine: ImageFont.Layout) -> None:
     font = ImageFont.truetype(
         "Tests/fonts/BungeeColor-Regular_colr_Windows.ttf",
         size=64,
@@ -993,7 +1017,7 @@ def test_colr(layout_engine) -> None:
 
 
 @skip_unless_feature_version("freetype2", "2.10.0")
-def test_colr_mask(layout_engine) -> None:
+def test_colr_mask(layout_engine: ImageFont.Layout) -> None:
     font = ImageFont.truetype(
         "Tests/fonts/BungeeColor-Regular_colr_Windows.ttf",
         size=64,
@@ -1008,7 +1032,7 @@ def test_colr_mask(layout_engine) -> None:
     assert_image_similar_tofile(im, "Tests/images/colr_bungee_mask.png", 22)
 
 
-def test_woff2(layout_engine) -> None:
+def test_woff2(layout_engine: ImageFont.Layout) -> None:
     try:
         font = ImageFont.truetype(
             "Tests/fonts/OpenSans.woff2",
@@ -1042,7 +1066,7 @@ def test_render_mono_size() -> None:
     assert_image_equal_tofile(im, "Tests/images/text_mono.gif")
 
 
-def test_too_many_characters(font) -> None:
+def test_too_many_characters(font: ImageFont.FreeTypeFont) -> None:
     with pytest.raises(ValueError):
         font.getlength("A" * 1_000_001)
     with pytest.raises(ValueError):
@@ -1070,7 +1094,7 @@ def test_too_many_characters(font) -> None:
         "Tests/fonts/oom-4da0210eb7081b0bf15bf16cc4c52ce02c1e1bbc.ttf",
     ],
 )
-def test_oom(test_file) -> None:
+def test_oom(test_file: str) -> None:
     with open(test_file, "rb") as f:
         font = ImageFont.truetype(BytesIO(f.read()))
         with pytest.raises(Image.DecompressionBombError):
@@ -1091,6 +1115,8 @@ def test_raqm_missing_warning(monkeypatch) -> None:
 
 
 @pytest.mark.parametrize("size", [-1, 0])
-def test_invalid_truetype_sizes_raise_valueerror(layout_engine, size) -> None:
+def test_invalid_truetype_sizes_raise_valueerror(
+    layout_engine: ImageFont.Layout, size: int
+) -> None:
     with pytest.raises(ValueError):
         ImageFont.truetype(FONT_PATH, size, layout_engine=layout_engine)
diff --git a/Tests/test_imageops.py b/Tests/test_imageops.py
index 50bf404aebe..b320e79c10e 100644
--- a/Tests/test_imageops.py
+++ b/Tests/test_imageops.py
@@ -14,7 +14,7 @@
 
 
 class Deformer:
-    def getmesh(self, im):
+    def getmesh(self, im: Image.Image) -> list[tuple[tuple[int, ...], tuple[int, ...]]]:
         x, y = im.size
         return [((0, 0, x, y), (0, 0, x, 0, x, y, y, 0))]
 
@@ -108,7 +108,7 @@ def test_fit_same_ratio() -> None:
 
 
 @pytest.mark.parametrize("new_size", ((256, 256), (512, 256), (256, 512)))
-def test_contain(new_size) -> None:
+def test_contain(new_size: tuple[int, int]) -> None:
     im = hopper()
     new_im = ImageOps.contain(im, new_size)
     assert new_im.size == (256, 256)
@@ -132,7 +132,7 @@ def test_contain_round() -> None:
         ("hopper.png", (256, 256)),  # square
     ),
 )
-def test_cover(image_name, expected_size) -> None:
+def test_cover(image_name: str, expected_size: tuple[int, int]) -> None:
     with Image.open("Tests/images/" + image_name) as im:
         new_im = ImageOps.cover(im, (256, 256))
         assert new_im.size == expected_size
@@ -168,7 +168,7 @@ def test_pad_round() -> None:
 
 
 @pytest.mark.parametrize("mode", ("P", "PA"))
-def test_palette(mode) -> None:
+def test_palette(mode: str) -> None:
     im = hopper(mode)
 
     # Expand
@@ -210,7 +210,7 @@ def test_scale() -> None:
 
 
 @pytest.mark.parametrize("border", (10, (1, 2, 3, 4)))
-def test_expand_palette(border) -> None:
+def test_expand_palette(border: int | tuple[int, int, int, int]) -> None:
     with Image.open("Tests/images/p_16.tga") as im:
         im_expanded = ImageOps.expand(im, border, (255, 0, 0))
 
@@ -366,7 +366,7 @@ def test_exif_transpose() -> None:
     for ext in exts:
         with Image.open("Tests/images/hopper" + ext) as base_im:
 
-            def check(orientation_im) -> None:
+            def check(orientation_im: Image.Image) -> None:
                 for im in [
                     orientation_im,
                     orientation_im.copy(),
@@ -445,7 +445,7 @@ def test_autocontrast_cutoff() -> None:
     # Test the cutoff argument of autocontrast
     with Image.open("Tests/images/bw_gradient.png") as img:
 
-        def autocontrast(cutoff):
+        def autocontrast(cutoff: int | tuple[int, int]):
             return ImageOps.autocontrast(img, cutoff).histogram()
 
         assert autocontrast(10) == autocontrast((10, 10))
@@ -486,20 +486,20 @@ def test_autocontrast_mask_real_input() -> None:
         assert result_nomask != result
         assert_tuple_approx_equal(
             ImageStat.Stat(result, mask=rect_mask).median,
-            [195, 202, 184],
+            (195, 202, 184),
             threshold=2,
             msg="autocontrast with mask pixel incorrect",
         )
         assert_tuple_approx_equal(
             ImageStat.Stat(result_nomask).median,
-            [119, 106, 79],
+            (119, 106, 79),
             threshold=2,
             msg="autocontrast without mask pixel incorrect",
         )
 
 
 def test_autocontrast_preserve_tone() -> None:
-    def autocontrast(mode, preserve_tone):
+    def autocontrast(mode: str, preserve_tone: bool) -> Image.Image:
         im = hopper(mode)
         return ImageOps.autocontrast(im, preserve_tone=preserve_tone).histogram()
 
@@ -533,7 +533,7 @@ def test_autocontrast_preserve_gradient() -> None:
 @pytest.mark.parametrize(
     "color", ((255, 255, 255), (127, 255, 0), (127, 127, 127), (0, 0, 0))
 )
-def test_autocontrast_preserve_one_color(color) -> None:
+def test_autocontrast_preserve_one_color(color: tuple[int, int, int]) -> None:
     img = Image.new("RGB", (10, 10), color)
 
     # single color images shouldn't change
diff --git a/Tests/test_imageops_usm.py b/Tests/test_imageops_usm.py
index 03302e20f2a..519d791050d 100644
--- a/Tests/test_imageops_usm.py
+++ b/Tests/test_imageops_usm.py
@@ -1,12 +1,14 @@
 from __future__ import annotations
 
+from typing import Generator
+
 import pytest
 
 from PIL import Image, ImageFilter
 
 
 @pytest.fixture
-def test_images():
+def test_images() -> Generator[dict[str, Image.Image], None, None]:
     ims = {
         "im": Image.open("Tests/images/hopper.ppm"),
         "snakes": Image.open("Tests/images/color_snakes.png"),
@@ -18,7 +20,7 @@ def test_images():
             im.close()
 
 
-def test_filter_api(test_images) -> None:
+def test_filter_api(test_images: dict[str, Image.Image]) -> None:
     im = test_images["im"]
 
     test_filter = ImageFilter.GaussianBlur(2.0)
@@ -32,7 +34,7 @@ def test_filter_api(test_images) -> None:
     assert i.size == (128, 128)
 
 
-def test_usm_formats(test_images) -> None:
+def test_usm_formats(test_images: dict[str, Image.Image]) -> None:
     im = test_images["im"]
 
     usm = ImageFilter.UnsharpMask
@@ -50,7 +52,7 @@ def test_usm_formats(test_images) -> None:
         im.convert("YCbCr").filter(usm)
 
 
-def test_blur_formats(test_images) -> None:
+def test_blur_formats(test_images: dict[str, Image.Image]) -> None:
     im = test_images["im"]
 
     blur = ImageFilter.GaussianBlur
@@ -68,7 +70,7 @@ def test_blur_formats(test_images) -> None:
         im.convert("YCbCr").filter(blur)
 
 
-def test_usm_accuracy(test_images) -> None:
+def test_usm_accuracy(test_images: dict[str, Image.Image]) -> None:
     snakes = test_images["snakes"]
 
     src = snakes.convert("RGB")
@@ -77,7 +79,7 @@ def test_usm_accuracy(test_images) -> None:
     assert i.tobytes() == src.tobytes()
 
 
-def test_blur_accuracy(test_images) -> None:
+def test_blur_accuracy(test_images: dict[str, Image.Image]) -> None:
     snakes = test_images["snakes"]
 
     i = snakes.filter(ImageFilter.GaussianBlur(0.4))
diff --git a/Tests/test_imagepath.py b/Tests/test_imagepath.py
index 8ba745f215d..bd600b17744 100644
--- a/Tests/test_imagepath.py
+++ b/Tests/test_imagepath.py
@@ -3,6 +3,7 @@
 import array
 import math
 import struct
+from typing import Sequence
 
 import pytest
 
@@ -75,7 +76,9 @@ def test_path_constructors(coords) -> None:
         [[0.0, 1.0]],
     ),
 )
-def test_invalid_path_constructors(coords) -> None:
+def test_invalid_path_constructors(
+    coords: tuple[str, str] | Sequence[Sequence[int]]
+) -> None:
     # Act
     with pytest.raises(ValueError) as e:
         ImagePath.Path(coords)
@@ -93,7 +96,7 @@ def test_invalid_path_constructors(coords) -> None:
         [0, 1, 2],
     ),
 )
-def test_path_odd_number_of_coordinates(coords) -> None:
+def test_path_odd_number_of_coordinates(coords: Sequence[int]) -> None:
     # Act
     with pytest.raises(ValueError) as e:
         ImagePath.Path(coords)
@@ -111,7 +114,9 @@ def test_path_odd_number_of_coordinates(coords) -> None:
         (1, (0.0, 0.0, 0.0, 0.0)),
     ],
 )
-def test_getbbox(coords, expected) -> None:
+def test_getbbox(
+    coords: int | list[int], expected: tuple[float, float, float, float]
+) -> None:
     # Arrange
     p = ImagePath.Path(coords)
 
@@ -135,7 +140,7 @@ def test_getbbox_no_args() -> None:
         (list(range(6)), [(0.0, 3.0), (4.0, 9.0), (8.0, 15.0)]),
     ],
 )
-def test_map(coords, expected) -> None:
+def test_map(coords: int | list[int], expected: list[tuple[float, float]]) -> None:
     # Arrange
     p = ImagePath.Path(coords)
 

From 96fc60d5d2aa0ad13be0951efb1fe990a64f190a Mon Sep 17 00:00:00 2001
From: Andrew Murray <radarhere@users.noreply.github.com>
Date: Sat, 17 Feb 2024 20:21:25 +1100
Subject: [PATCH 0202/1178] Removed mypy excludes

---
 pyproject.toml | 4 ----
 tox.ini        | 1 +
 2 files changed, 1 insertion(+), 4 deletions(-)

diff --git a/pyproject.toml b/pyproject.toml
index 48c59f2a1b4..e687f4bcf76 100644
--- a/pyproject.toml
+++ b/pyproject.toml
@@ -140,7 +140,3 @@ follow_imports = "silent"
 warn_redundant_casts = true
 warn_unreachable = true
 warn_unused_ignores = true
-exclude = [
-  '^src/PIL/FpxImagePlugin.py$',
-  '^src/PIL/MicImagePlugin.py$',
-]
diff --git a/tox.ini b/tox.ini
index 8c818df7a6a..3ef011c9e94 100644
--- a/tox.ini
+++ b/tox.ini
@@ -41,6 +41,7 @@ deps =
     packaging
     types-cffi
     types-defusedxml
+    types-olefile
 extras =
     typing
 commands =

From b6fdf2e9e7a65bf23cac224b2ab96c6b1d2c8449 Mon Sep 17 00:00:00 2001
From: Andrew Murray <radarhere@users.noreply.github.com>
Date: Mon, 19 Feb 2024 07:54:58 +1100
Subject: [PATCH 0203/1178] Updated package name for Tidelift

---
 .github/FUNDING.yml | 2 +-
 README.md           | 2 +-
 docs/conf.py        | 2 +-
 docs/index.rst      | 2 +-
 4 files changed, 4 insertions(+), 4 deletions(-)

diff --git a/.github/FUNDING.yml b/.github/FUNDING.yml
index e0e6804bfe4..8fc6bd0ad54 100644
--- a/.github/FUNDING.yml
+++ b/.github/FUNDING.yml
@@ -1 +1 @@
-tidelift: "pypi/Pillow"
+tidelift: "pypi/pillow"
diff --git a/README.md b/README.md
index 6ca870166a1..9776c40e2f7 100644
--- a/README.md
+++ b/README.md
@@ -64,7 +64,7 @@ As of 2019, Pillow development is
                 src="https://zenodo.org/badge/17549/python-pillow/Pillow.svg"></a>
             <a href="https://tidelift.com/subscription/pkg/pypi-pillow?utm_source=pypi-pillow&utm_medium=badge"><img
                 alt="Tidelift"
-                src="https://tidelift.com/badges/package/pypi/Pillow?style=flat"></a>
+                src="https://tidelift.com/badges/package/pypi/pillow?style=flat"></a>
             <a href="https://pypi.org/project/pillow/"><img
                 alt="Newest PyPI version"
                 src="https://img.shields.io/pypi/v/pillow.svg"></a>
diff --git a/docs/conf.py b/docs/conf.py
index 9ae7ae605fd..97289c91d0c 100644
--- a/docs/conf.py
+++ b/docs/conf.py
@@ -326,7 +326,7 @@
     r"https://gitter.im/python-pillow/Pillow?.*": r"https://app.gitter.im/#/room/#python-pillow_Pillow:gitter.im?.*",
     r"https://pillow.readthedocs.io/?badge=latest": r"https://pillow.readthedocs.io/en/stable/?badge=latest",
     r"https://pillow.readthedocs.io": r"https://pillow.readthedocs.io/en/stable/",
-    r"https://tidelift.com/badges/package/pypi/Pillow?.*": r"https://img.shields.io/badge/.*",
+    r"https://tidelift.com/badges/package/pypi/pillow?.*": r"https://img.shields.io/badge/.*",
     r"https://zenodo.org/badge/17549/python-pillow/Pillow.svg": r"https://zenodo.org/badge/doi/[\.0-9]+/zenodo.[0-9]+.svg",
     r"https://zenodo.org/badge/latestdoi/17549/python-pillow/Pillow": r"https://zenodo.org/record/[0-9]+",
 }
diff --git a/docs/index.rst b/docs/index.rst
index 5583699193c..bf2feea9a53 100644
--- a/docs/index.rst
+++ b/docs/index.rst
@@ -49,7 +49,7 @@ Pillow for enterprise is available via the Tidelift Subscription. `Learn more <h
    :target: https://zenodo.org/badge/latestdoi/17549/python-pillow/Pillow
    :alt: Zenodo
 
-.. image:: https://tidelift.com/badges/package/pypi/Pillow?style=flat
+.. image:: https://tidelift.com/badges/package/pypi/pillow?style=flat
    :target: https://tidelift.com/subscription/pkg/pypi-pillow?utm_source=pypi-pillow&utm_medium=badge
    :alt: Tidelift
 

From 55d0289a7dd5f5261e89b9084fbeac681bf2d626 Mon Sep 17 00:00:00 2001
From: Andrew Murray <radarhere@users.noreply.github.com>
Date: Mon, 19 Feb 2024 17:08:21 +1100
Subject: [PATCH 0204/1178] Added image to illustrate size vs bbox

---
 docs/deprecations.rst         |   8 ++++++--
 docs/example/size_vs_bbox.png | Bin 0 -> 12934 bytes
 docs/releasenotes/9.2.0.rst   |   8 ++++++--
 3 files changed, 12 insertions(+), 4 deletions(-)
 create mode 100644 docs/example/size_vs_bbox.png

diff --git a/docs/deprecations.rst b/docs/deprecations.rst
index c90ad481adb..74021a218ef 100644
--- a/docs/deprecations.rst
+++ b/docs/deprecations.rst
@@ -253,8 +253,12 @@ Use instead::
     width, height = right - left, bottom - top
 
 Previously, the ``size`` methods returned a ``height`` that included the vertical
-offset of the text, while the new ``bbox`` methods explicitly distinguish this as a
-``top`` offset.
+offset of the text, while the new ``bbox`` methods distinguish this as a ``top``
+offset.
+
+.. image:: ./example/size_vs_bbox.png
+    :alt: Demonstration of size height vs bbox top and bottom
+    :align: center
 
 FreeTypeFont.getmask2 fill parameter
 ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
diff --git a/docs/example/size_vs_bbox.png b/docs/example/size_vs_bbox.png
new file mode 100644
index 0000000000000000000000000000000000000000..11a05d2a8146a612741c7e4ec4d3cf0ce05a35a0
GIT binary patch
literal 12934
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
S1_tO*7#T?giAu0x(EkB>8JTGS

literal 0
HcmV?d00001

diff --git a/docs/releasenotes/9.2.0.rst b/docs/releasenotes/9.2.0.rst
index 495926ca749..db514068f77 100644
--- a/docs/releasenotes/9.2.0.rst
+++ b/docs/releasenotes/9.2.0.rst
@@ -90,8 +90,12 @@ Use instead::
     width, height = right - left, bottom - top
 
 Previously, the ``size`` methods returned a ``height`` that included the vertical
-offset of the text, while the new ``bbox`` methods explicitly distinguish this as a
-``top`` offset.
+offset of the text, while the new ``bbox`` methods distinguish this as a ``top``
+offset.
+
+.. image:: ./example/size_vs_bbox.png
+    :alt: Demonstration of size height vs bbox top and bottom
+    :align: center
 
 API Additions
 =============

From 0692ad8cdd4fe979478d910b705dcc12f8e82f61 Mon Sep 17 00:00:00 2001
From: Andrew Murray <radarhere@users.noreply.github.com>
Date: Mon, 19 Feb 2024 23:29:58 +1100
Subject: [PATCH 0205/1178] Updated giflib on macOS to 5.2.2

---
 .github/workflows/wheels-dependencies.sh | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/.github/workflows/wheels-dependencies.sh b/.github/workflows/wheels-dependencies.sh
index 26bf2f6d655..1ec2811f6d8 100755
--- a/.github/workflows/wheels-dependencies.sh
+++ b/.github/workflows/wheels-dependencies.sh
@@ -24,7 +24,7 @@ XZ_VERSION=5.4.5
 TIFF_VERSION=4.6.0
 LCMS2_VERSION=2.16
 if [[ -n "$IS_MACOS" ]]; then
-    GIFLIB_VERSION=5.1.4
+    GIFLIB_VERSION=5.2.2
 else
     GIFLIB_VERSION=5.2.1
 fi

From fe1edb1e0f8608e3924f67b53776f653c418ddfe Mon Sep 17 00:00:00 2001
From: Hugo van Kemenade <1324225+hugovk@users.noreply.github.com>
Date: Mon, 19 Feb 2024 16:47:07 +0200
Subject: [PATCH 0206/1178] Install mypy from requirements file

So Renovate can update it on a schedule
---
 .ci/requirements-mypy.txt | 1 +
 tox.ini                   | 2 +-
 2 files changed, 2 insertions(+), 1 deletion(-)
 create mode 100644 .ci/requirements-mypy.txt

diff --git a/.ci/requirements-mypy.txt b/.ci/requirements-mypy.txt
new file mode 100644
index 00000000000..ed32694607d
--- /dev/null
+++ b/.ci/requirements-mypy.txt
@@ -0,0 +1 @@
+mypy==1.7.1
diff --git a/tox.ini b/tox.ini
index 8c818df7a6a..85800ff8d7a 100644
--- a/tox.ini
+++ b/tox.ini
@@ -33,10 +33,10 @@ commands =
 [testenv:mypy]
 skip_install = true
 deps =
+    -r .ci/requirements-mypy.txt
     IceSpringPySideStubs-PyQt6
     IceSpringPySideStubs-PySide6
     ipython
-    mypy==1.7.1
     numpy
     packaging
     types-cffi

From 7490aee8362c589a475035bf86c05b29c894593c Mon Sep 17 00:00:00 2001
From: Nulano <nulano@nulano.eu>
Date: Mon, 19 Feb 2024 20:18:18 +0100
Subject: [PATCH 0207/1178] Show how to use anchors to align text in imagefont
 deprecations

---
 docs/deprecations.rst       | 24 ++++++++++++++++++++++++
 docs/releasenotes/9.2.0.rst | 24 ++++++++++++++++++++++++
 2 files changed, 48 insertions(+)

diff --git a/docs/deprecations.rst b/docs/deprecations.rst
index 74021a218ef..9efb1316d5c 100644
--- a/docs/deprecations.rst
+++ b/docs/deprecations.rst
@@ -260,6 +260,30 @@ offset.
     :alt: Demonstration of size height vs bbox top and bottom
     :align: center
 
+If you are using these methods for aligning text, consider using :ref:`text-anchors` instead
+which avoid issues that can occur with non-English text or unusual fonts.
+For example, instead of the following code::
+
+    from PIL import Image, ImageDraw, ImageFont
+
+    font = ImageFont.truetype("Tests/fonts/FreeMono.ttf")
+
+    im = Image.new("RGB", (100, 100))
+    draw = ImageDraw.Draw(im)
+    width, height = draw.textsize("Hello world", font)
+    x, y = (100 - width) / 2, (100 - height) / 2
+    draw.text((x, y), "Hello world", font=font)
+
+Use instead::
+
+    from PIL import Image, ImageDraw, ImageFont
+
+    font = ImageFont.truetype("Tests/fonts/FreeMono.ttf")
+
+    im = Image.new("RGB", (100, 100))
+    draw = ImageDraw.Draw(im)
+    draw.text((100 / 2, 100 / 2), "Hello world", font=font, anchor="mm")
+
 FreeTypeFont.getmask2 fill parameter
 ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
 
diff --git a/docs/releasenotes/9.2.0.rst b/docs/releasenotes/9.2.0.rst
index db514068f77..e8bf33b60f2 100644
--- a/docs/releasenotes/9.2.0.rst
+++ b/docs/releasenotes/9.2.0.rst
@@ -97,6 +97,30 @@ offset.
     :alt: Demonstration of size height vs bbox top and bottom
     :align: center
 
+If you are using these methods for aligning text, consider using :ref:`text-anchors` instead
+which avoid issues that can occur with non-English text or unusual fonts.
+For example, instead of the following code::
+
+    from PIL import Image, ImageDraw, ImageFont
+
+    font = ImageFont.truetype("Tests/fonts/FreeMono.ttf")
+
+    im = Image.new("RGB", (100, 100))
+    draw = ImageDraw.Draw(im)
+    width, height = draw.textsize("Hello world", font)
+    x, y = (100 - width) / 2, (100 - height) / 2
+    draw.text((x, y), "Hello world", font=font)
+
+Use instead::
+
+    from PIL import Image, ImageDraw, ImageFont
+
+    font = ImageFont.truetype("Tests/fonts/FreeMono.ttf")
+
+    im = Image.new("RGB", (100, 100))
+    draw = ImageDraw.Draw(im)
+    draw.text((100 / 2, 100 / 2), "Hello world", font=font, anchor="mm")
+
 API Additions
 =============
 

From 531b1e1b9a6b3f83519d9b6687523474f4a18d83 Mon Sep 17 00:00:00 2001
From: Hugo van Kemenade <1324225+hugovk@users.noreply.github.com>
Date: Mon, 19 Feb 2024 22:50:06 +0200
Subject: [PATCH 0208/1178] Remove outdated installation warnings

---
 docs/installation.rst | 9 ---------
 1 file changed, 9 deletions(-)

diff --git a/docs/installation.rst b/docs/installation.rst
index 116bdcf2fb1..980bbd99def 100644
--- a/docs/installation.rst
+++ b/docs/installation.rst
@@ -9,15 +9,6 @@ Installation
     });
     </script>
 
-Warnings
---------
-
-.. warning:: Pillow and PIL cannot co-exist in the same environment. Before installing Pillow, please uninstall PIL.
-
-.. warning:: Pillow >= 1.0 no longer supports ``import Image``. Please use ``from PIL import Image`` instead.
-
-.. warning:: Pillow >= 2.1.0 no longer supports ``import _imaging``. Please use ``from PIL.Image import core as _imaging`` instead.
-
 Python Support
 --------------
 

From e39765d755cc2d37e79d07f58ebc77a8e44812c6 Mon Sep 17 00:00:00 2001
From: Andrew Murray <radarhere@users.noreply.github.com>
Date: Tue, 20 Feb 2024 15:41:20 +1100
Subject: [PATCH 0209/1178] Added type hints

---
 Tests/test_deprecate.py             |  6 +++---
 Tests/test_file_ico.py              |  2 +-
 Tests/test_file_iptc.py             |  2 +-
 Tests/test_file_msp.py              |  2 +-
 Tests/test_file_png.py              |  2 ++
 Tests/test_file_psd.py              |  2 +-
 Tests/test_file_tga.py              |  4 ++--
 Tests/test_file_tiff_metadata.py    |  6 ++++--
 Tests/test_imagecms.py              | 28 ++++++++++++++++++++++------
 Tests/test_imagefont.py             | 22 ++++++++++++----------
 Tests/test_imagegrab.py             |  6 ++++--
 Tests/test_imagepath.py             |  8 +++++---
 Tests/test_imageqt.py               |  2 +-
 Tests/test_imageshow.py             | 10 ++++++----
 Tests/test_imagewin_pointers.py     |  2 +-
 Tests/test_numpy.py                 |  6 +++---
 Tests/test_qt_image_qapplication.py |  4 ++--
 Tests/test_qt_image_toqimage.py     |  2 +-
 Tests/test_util.py                  |  2 +-
 19 files changed, 73 insertions(+), 45 deletions(-)

diff --git a/Tests/test_deprecate.py b/Tests/test_deprecate.py
index 6ffc8f6f589..584d8f91d67 100644
--- a/Tests/test_deprecate.py
+++ b/Tests/test_deprecate.py
@@ -20,7 +20,7 @@
         ),
     ],
 )
-def test_version(version, expected) -> None:
+def test_version(version: int | None, expected: str) -> None:
     with pytest.warns(DeprecationWarning, match=expected):
         _deprecate.deprecate("Old thing", version, "new thing")
 
@@ -46,7 +46,7 @@ def test_unknown_version() -> None:
         ),
     ],
 )
-def test_old_version(deprecated, plural, expected) -> None:
+def test_old_version(deprecated: str, plural: bool, expected: str) -> None:
     expected = r""
     with pytest.raises(RuntimeError, match=expected):
         _deprecate.deprecate(deprecated, 1, plural=plural)
@@ -76,7 +76,7 @@ def test_replacement_and_action() -> None:
         "Upgrade to new thing.",
     ],
 )
-def test_action(action) -> None:
+def test_action(action: str) -> None:
     expected = (
         r"Old thing is deprecated and will be removed in Pillow 11 \(2024-10-15\)\. "
         r"Upgrade to new thing\."
diff --git a/Tests/test_file_ico.py b/Tests/test_file_ico.py
index 65f090931b4..f69a290fabf 100644
--- a/Tests/test_file_ico.py
+++ b/Tests/test_file_ico.py
@@ -135,7 +135,7 @@ def test_different_bit_depths(tmp_path: Path) -> None:
 
 
 @pytest.mark.parametrize("mode", ("1", "L", "P", "RGB", "RGBA"))
-def test_save_to_bytes_bmp(mode) -> None:
+def test_save_to_bytes_bmp(mode: str) -> None:
     output = io.BytesIO()
     im = hopper(mode)
     im.save(output, "ico", bitmap_format="bmp", sizes=[(32, 32), (64, 64)])
diff --git a/Tests/test_file_iptc.py b/Tests/test_file_iptc.py
index 9c0969437ea..88c30d46895 100644
--- a/Tests/test_file_iptc.py
+++ b/Tests/test_file_iptc.py
@@ -98,7 +98,7 @@ def test_i() -> None:
     assert ret == 97
 
 
-def test_dump(monkeypatch) -> None:
+def test_dump(monkeypatch: pytest.MonkeyPatch) -> None:
     # Arrange
     c = b"abc"
     # Temporarily redirect stdout
diff --git a/Tests/test_file_msp.py b/Tests/test_file_msp.py
index f9f81d11413..b0964aabe12 100644
--- a/Tests/test_file_msp.py
+++ b/Tests/test_file_msp.py
@@ -52,7 +52,7 @@ def test_open_windows_v1() -> None:
         assert isinstance(im, MspImagePlugin.MspImageFile)
 
 
-def _assert_file_image_equal(source_path, target_path) -> None:
+def _assert_file_image_equal(source_path: str, target_path: str) -> None:
     with Image.open(source_path) as im:
         assert_image_equal_tofile(im, target_path)
 
diff --git a/Tests/test_file_png.py b/Tests/test_file_png.py
index d4a63431647..c51f56ce7c0 100644
--- a/Tests/test_file_png.py
+++ b/Tests/test_file_png.py
@@ -6,6 +6,7 @@
 import zlib
 from io import BytesIO
 from pathlib import Path
+from types import ModuleType
 from typing import Any
 
 import pytest
@@ -23,6 +24,7 @@
     skip_unless_feature,
 )
 
+ElementTree: ModuleType | None
 try:
     from defusedxml import ElementTree
 except ImportError:
diff --git a/Tests/test_file_psd.py b/Tests/test_file_psd.py
index 7eca8d9b151..e60638b224d 100644
--- a/Tests/test_file_psd.py
+++ b/Tests/test_file_psd.py
@@ -157,7 +157,7 @@ def test_combined_larger_than_size() -> None:
         ("Tests/images/timeout-dedc7a4ebd856d79b4359bbcc79e8ef231ce38f6.psd", OSError),
     ],
 )
-def test_crashes(test_file, raises) -> None:
+def test_crashes(test_file: str, raises) -> None:
     with open(test_file, "rb") as f:
         with pytest.raises(raises):
             with Image.open(f):
diff --git a/Tests/test_file_tga.py b/Tests/test_file_tga.py
index bd8e522c7b5..3c6da50c532 100644
--- a/Tests/test_file_tga.py
+++ b/Tests/test_file_tga.py
@@ -22,8 +22,8 @@
 
 
 @pytest.mark.parametrize("mode", _MODES)
-def test_sanity(mode, tmp_path: Path) -> None:
-    def roundtrip(original_im) -> None:
+def test_sanity(mode: str, tmp_path: Path) -> None:
+    def roundtrip(original_im: Image.Image) -> None:
         out = str(tmp_path / "temp.tga")
 
         original_im.save(out, rle=rle)
diff --git a/Tests/test_file_tiff_metadata.py b/Tests/test_file_tiff_metadata.py
index bb6225d075b..d7a18c72504 100644
--- a/Tests/test_file_tiff_metadata.py
+++ b/Tests/test_file_tiff_metadata.py
@@ -189,7 +189,9 @@ def test_iptc(tmp_path: Path) -> None:
 
 
 @pytest.mark.parametrize("value, expected", ((b"test", "test"), (1, "1")))
-def test_writing_other_types_to_ascii(value, expected, tmp_path: Path) -> None:
+def test_writing_other_types_to_ascii(
+    value: bytes | int, expected: str, tmp_path: Path
+) -> None:
     info = TiffImagePlugin.ImageFileDirectory_v2()
 
     tag = TiffTags.TAGS_V2[271]
@@ -206,7 +208,7 @@ def test_writing_other_types_to_ascii(value, expected, tmp_path: Path) -> None:
 
 
 @pytest.mark.parametrize("value", (1, IFDRational(1)))
-def test_writing_other_types_to_bytes(value, tmp_path: Path) -> None:
+def test_writing_other_types_to_bytes(value: int | IFDRational, tmp_path: Path) -> None:
     im = hopper()
     info = TiffImagePlugin.ImageFileDirectory_v2()
 
diff --git a/Tests/test_imagecms.py b/Tests/test_imagecms.py
index 83fc38ed3fd..21a0dd75b98 100644
--- a/Tests/test_imagecms.py
+++ b/Tests/test_imagecms.py
@@ -237,7 +237,7 @@ def test_invalid_color_temperature() -> None:
 
 
 @pytest.mark.parametrize("flag", ("my string", -1))
-def test_invalid_flag(flag) -> None:
+def test_invalid_flag(flag: str | int) -> None:
     with hopper() as im:
         with pytest.raises(
             ImageCms.PyCMSError, match="flags must be an integer between 0 and "
@@ -335,12 +335,26 @@ def test_extended_information() -> None:
     o = ImageCms.getOpenProfile(SRGB)
     p = o.profile
 
-    def assert_truncated_tuple_equal(tup1, tup2, digits: int = 10) -> None:
+    def assert_truncated_tuple_equal(
+        tup1: tuple[tuple[float, float, float], ...] | tuple[float],
+        tup2: (
+            tuple[tuple[tuple[float, float, float], ...], ...]
+            | tuple[tuple[float, float, float], ...]
+            | tuple[float]
+        ),
+        digits: int = 10,
+    ) -> None:
         # Helper function to reduce precision of tuples of floats
         # recursively and then check equality.
         power = 10**digits
 
-        def truncate_tuple(tuple_or_float):
+        def truncate_tuple(
+            tuple_or_float: (
+                tuple[tuple[tuple[float, float, float], ...], ...]
+                | tuple[tuple[float, float, float], ...]
+                | tuple[float, ...]
+            )
+        ) -> tuple[tuple[float, ...], ...]:
             return tuple(
                 (
                     truncate_tuple(val)
@@ -504,8 +518,10 @@ def test_profile_typesafety() -> None:
         ImageCms.ImageCmsProfile(1).tobytes()
 
 
-def assert_aux_channel_preserved(mode, transform_in_place, preserved_channel) -> None:
-    def create_test_image():
+def assert_aux_channel_preserved(
+    mode: str, transform_in_place: bool, preserved_channel: str
+) -> None:
+    def create_test_image() -> Image.Image:
         # set up test image with something interesting in the tested aux channel.
         # fmt: off
         nine_grid_deltas = [
@@ -633,7 +649,7 @@ def test_auxiliary_channels_isolated() -> None:
 
 
 @pytest.mark.parametrize("mode", ("RGB", "RGBA", "RGBX"))
-def test_rgb_lab(mode) -> None:
+def test_rgb_lab(mode: str) -> None:
     im = Image.new(mode, (1, 1))
     converted_im = im.convert("LAB")
     assert converted_im.getpixel((0, 0)) == (0, 128, 128)
diff --git a/Tests/test_imagefont.py b/Tests/test_imagefont.py
index c79b36ca432..05b5d471691 100644
--- a/Tests/test_imagefont.py
+++ b/Tests/test_imagefont.py
@@ -7,7 +7,7 @@
 import sys
 from io import BytesIO
 from pathlib import Path
-from typing import BinaryIO
+from typing import Any, BinaryIO
 
 import pytest
 from packaging.version import parse as parse_version
@@ -44,7 +44,7 @@ def test_sanity() -> None:
         pytest.param(ImageFont.Layout.RAQM, marks=skip_unless_feature("raqm")),
     ],
 )
-def layout_engine(request):
+def layout_engine(request: pytest.FixtureRequest) -> ImageFont.Layout:
     return request.param
 
 
@@ -535,21 +535,23 @@ def test_unicode_extended(layout_engine: ImageFont.Layout) -> None:
     (("linux", "/usr/local/share/fonts"), ("darwin", "/System/Library/Fonts")),
 )
 @pytest.mark.skipif(is_win32(), reason="requires Unix or macOS")
-def test_find_font(monkeypatch, platform, font_directory) -> None:
+def test_find_font(
+    monkeypatch: pytest.MonkeyPatch, platform: str, font_directory: str
+) -> None:
     def _test_fake_loading_font(path_to_fake: str, fontname: str) -> None:
         # Make a copy of FreeTypeFont so we can patch the original
         free_type_font = copy.deepcopy(ImageFont.FreeTypeFont)
         with monkeypatch.context() as m:
             m.setattr(ImageFont, "_FreeTypeFont", free_type_font, raising=False)
 
-            def loadable_font(filepath, size, index, encoding, *args, **kwargs):
+            def loadable_font(
+                filepath: str, size: int, index: int, encoding: str, *args: Any
+            ):
                 if filepath == path_to_fake:
                     return ImageFont._FreeTypeFont(
-                        FONT_PATH, size, index, encoding, *args, **kwargs
+                        FONT_PATH, size, index, encoding, *args
                     )
-                return ImageFont._FreeTypeFont(
-                    filepath, size, index, encoding, *args, **kwargs
-                )
+                return ImageFont._FreeTypeFont(filepath, size, index, encoding, *args)
 
             m.setattr(ImageFont, "FreeTypeFont", loadable_font)
             font = ImageFont.truetype(fontname)
@@ -563,7 +565,7 @@ def loadable_font(filepath, size, index, encoding, *args, **kwargs):
     if platform == "linux":
         monkeypatch.setenv("XDG_DATA_DIRS", "/usr/share/:/usr/local/share/")
 
-    def fake_walker(path):
+    def fake_walker(path: str) -> list[tuple[str, list[str], list[str]]]:
         if path == font_directory:
             return [
                 (
@@ -1101,7 +1103,7 @@ def test_oom(test_file: str) -> None:
             font.getmask("Test Text")
 
 
-def test_raqm_missing_warning(monkeypatch) -> None:
+def test_raqm_missing_warning(monkeypatch: pytest.MonkeyPatch) -> None:
     monkeypatch.setattr(ImageFont.core, "HAVE_RAQM", False)
     with pytest.warns(UserWarning) as record:
         font = ImageFont.truetype(
diff --git a/Tests/test_imagegrab.py b/Tests/test_imagegrab.py
index 235a2f993bd..e23adeb7083 100644
--- a/Tests/test_imagegrab.py
+++ b/Tests/test_imagegrab.py
@@ -84,6 +84,7 @@ def test_grabclipboard(self) -> None:
     @pytest.mark.skipif(sys.platform != "win32", reason="Windows only")
     def test_grabclipboard_file(self) -> None:
         p = subprocess.Popen(["powershell", "-command", "-"], stdin=subprocess.PIPE)
+        assert p.stdin is not None
         p.stdin.write(rb'Set-Clipboard -Path "Tests\images\hopper.gif"')
         p.communicate()
 
@@ -94,6 +95,7 @@ def test_grabclipboard_file(self) -> None:
     @pytest.mark.skipif(sys.platform != "win32", reason="Windows only")
     def test_grabclipboard_png(self) -> None:
         p = subprocess.Popen(["powershell", "-command", "-"], stdin=subprocess.PIPE)
+        assert p.stdin is not None
         p.stdin.write(
             rb"""$bytes = [System.IO.File]::ReadAllBytes("Tests\images\hopper.png")
 $ms = new-object System.IO.MemoryStream(, $bytes)
@@ -113,7 +115,7 @@ def test_grabclipboard_png(self) -> None:
         reason="Linux with wl-clipboard only",
     )
     @pytest.mark.parametrize("ext", ("gif", "png", "ico"))
-    def test_grabclipboard_wl_clipboard(self, ext) -> None:
+    def test_grabclipboard_wl_clipboard(self, ext: str) -> None:
         image_path = "Tests/images/hopper." + ext
         with open(image_path, "rb") as fp:
             subprocess.call(["wl-copy"], stdin=fp)
@@ -128,6 +130,6 @@ def test_grabclipboard_wl_clipboard(self, ext) -> None:
         reason="Linux with wl-clipboard only",
     )
     @pytest.mark.parametrize("arg", ("text", "--clear"))
-    def test_grabclipboard_wl_clipboard_errors(self, arg):
+    def test_grabclipboard_wl_clipboard_errors(self, arg: str) -> None:
         subprocess.call(["wl-copy", arg])
         assert ImageGrab.grabclipboard() is None
diff --git a/Tests/test_imagepath.py b/Tests/test_imagepath.py
index bd600b17744..9487560af88 100644
--- a/Tests/test_imagepath.py
+++ b/Tests/test_imagepath.py
@@ -58,7 +58,9 @@ def test_path() -> None:
         ImagePath.Path((0, 1)),
     ),
 )
-def test_path_constructors(coords) -> None:
+def test_path_constructors(
+    coords: Sequence[float] | array.array[float] | ImagePath.Path,
+) -> None:
     # Arrange / Act
     p = ImagePath.Path(coords)
 
@@ -206,9 +208,9 @@ class Evil:
     def __init__(self) -> None:
         self.corrupt = Image.core.path(0x4000000000000000)
 
-    def __getitem__(self, i):
+    def __getitem__(self, i: int) -> bytes:
         x = self.corrupt[i]
         return struct.pack("dd", x[0], x[1])
 
-    def __setitem__(self, i, x) -> None:
+    def __setitem__(self, i: int, x: bytes) -> None:
         self.corrupt[i] = struct.unpack("dd", x)
diff --git a/Tests/test_imageqt.py b/Tests/test_imageqt.py
index 909f9716700..88ad1f9eee4 100644
--- a/Tests/test_imageqt.py
+++ b/Tests/test_imageqt.py
@@ -28,7 +28,7 @@ def test_rgb() -> None:
 
     assert qRgb(0, 0, 0) == qRgba(0, 0, 0, 255)
 
-    def checkrgb(r, g, b) -> None:
+    def checkrgb(r: int, g: int, b: int) -> None:
         val = ImageQt.rgb(r, g, b)
         val = val % 2**24  # drop the alpha
         assert val >> 16 == r
diff --git a/Tests/test_imageshow.py b/Tests/test_imageshow.py
index f7269d45b56..8d741d94ada 100644
--- a/Tests/test_imageshow.py
+++ b/Tests/test_imageshow.py
@@ -1,5 +1,7 @@
 from __future__ import annotations
 
+from typing import Any
+
 import pytest
 
 from PIL import Image, ImageShow
@@ -24,9 +26,9 @@ def test_register() -> None:
     "order",
     [-1, 0],
 )
-def test_viewer_show(order) -> None:
+def test_viewer_show(order: int) -> None:
     class TestViewer(ImageShow.Viewer):
-        def show_image(self, image, **options) -> bool:
+        def show_image(self, image: Image.Image, **options: Any) -> bool:
             self.methodCalled = True
             return True
 
@@ -48,7 +50,7 @@ def show_image(self, image, **options) -> bool:
     reason="Only run on CIs; hangs on Windows CIs",
 )
 @pytest.mark.parametrize("mode", ("1", "I;16", "LA", "RGB", "RGBA"))
-def test_show(mode) -> None:
+def test_show(mode: str) -> None:
     im = hopper(mode)
     assert ImageShow.show(im)
 
@@ -73,7 +75,7 @@ def test_viewer() -> None:
 
 
 @pytest.mark.parametrize("viewer", ImageShow._viewers)
-def test_viewers(viewer) -> None:
+def test_viewers(viewer: ImageShow.Viewer) -> None:
     try:
         viewer.get_command("test.jpg")
     except NotImplementedError:
diff --git a/Tests/test_imagewin_pointers.py b/Tests/test_imagewin_pointers.py
index c7f633e6290..f59ee7284b8 100644
--- a/Tests/test_imagewin_pointers.py
+++ b/Tests/test_imagewin_pointers.py
@@ -70,7 +70,7 @@ class BITMAPINFOHEADER(ctypes.Structure):
     ]
     CreateDIBSection.restype = ctypes.wintypes.HBITMAP
 
-    def serialize_dib(bi, pixels):
+    def serialize_dib(bi, pixels) -> bytearray:
         bf = BITMAPFILEHEADER()
         bf.bfType = 0x4D42
         bf.bfOffBits = ctypes.sizeof(bf) + bi.biSize
diff --git a/Tests/test_numpy.py b/Tests/test_numpy.py
index 6ba95c2d700..9f4e6534e8a 100644
--- a/Tests/test_numpy.py
+++ b/Tests/test_numpy.py
@@ -14,7 +14,7 @@
 
 
 def test_numpy_to_image() -> None:
-    def to_image(dtype, bands: int = 1, boolean: int = 0):
+    def to_image(dtype, bands: int = 1, boolean: int = 0) -> Image.Image:
         if bands == 1:
             if boolean:
                 data = [0, 255] * 50
@@ -99,7 +99,7 @@ def test_1d_array() -> None:
     assert_image(Image.fromarray(a), "L", (1, 5))
 
 
-def _test_img_equals_nparray(img, np) -> None:
+def _test_img_equals_nparray(img: Image.Image, np) -> None:
     assert len(np.shape) >= 2
     np_size = np.shape[1], np.shape[0]
     assert img.size == np_size
@@ -157,7 +157,7 @@ def test_save_tiff_uint16() -> None:
         ("HSV", numpy.uint8),
     ),
 )
-def test_to_array(mode, dtype) -> None:
+def test_to_array(mode: str, dtype) -> None:
     img = hopper(mode)
 
     # Resize to non-square
diff --git a/Tests/test_qt_image_qapplication.py b/Tests/test_qt_image_qapplication.py
index 7d6c0a8cb7d..3cd323553fa 100644
--- a/Tests/test_qt_image_qapplication.py
+++ b/Tests/test_qt_image_qapplication.py
@@ -4,7 +4,7 @@
 
 import pytest
 
-from PIL import ImageQt
+from PIL import Image, ImageQt
 
 from .helper import assert_image_equal_tofile, assert_image_similar, hopper
 
@@ -37,7 +37,7 @@ def __init__(self) -> None:
             lbl.setPixmap(pixmap1.copy())
 
 
-def roundtrip(expected) -> None:
+def roundtrip(expected: Image.Image) -> None:
     result = ImageQt.fromqpixmap(ImageQt.toqpixmap(expected))
     # Qt saves all pixmaps as rgb
     assert_image_similar(result, expected.convert("RGB"), 1)
diff --git a/Tests/test_qt_image_toqimage.py b/Tests/test_qt_image_toqimage.py
index a222a7d71b9..6110be707f5 100644
--- a/Tests/test_qt_image_toqimage.py
+++ b/Tests/test_qt_image_toqimage.py
@@ -17,7 +17,7 @@
 
 
 @pytest.mark.parametrize("mode", ("RGB", "RGBA", "L", "P", "1"))
-def test_sanity(mode, tmp_path: Path) -> None:
+def test_sanity(mode: str, tmp_path: Path) -> None:
     src = hopper(mode)
     data = ImageQt.toqimage(src)
 
diff --git a/Tests/test_util.py b/Tests/test_util.py
index 73e4acd5555..197ef79eef5 100644
--- a/Tests/test_util.py
+++ b/Tests/test_util.py
@@ -10,7 +10,7 @@
 @pytest.mark.parametrize(
     "test_path", ["filename.ext", Path("filename.ext"), PurePath("filename.ext")]
 )
-def test_is_path(test_path) -> None:
+def test_is_path(test_path: str | Path | PurePath) -> None:
     # Act
     it_is = _util.is_path(test_path)
 

From a655d7606e2f12f0e7700ef754ed92a6da45f658 Mon Sep 17 00:00:00 2001
From: Andrew Murray <radarhere@users.noreply.github.com>
Date: Tue, 20 Feb 2024 21:27:30 +1100
Subject: [PATCH 0210/1178] Simplified type hints

---
 Tests/test_imagecms.py | 17 +++--------------
 1 file changed, 3 insertions(+), 14 deletions(-)

diff --git a/Tests/test_imagecms.py b/Tests/test_imagecms.py
index 21a0dd75b98..a7bb31db512 100644
--- a/Tests/test_imagecms.py
+++ b/Tests/test_imagecms.py
@@ -6,6 +6,7 @@
 import shutil
 from io import BytesIO
 from pathlib import Path
+from typing import Any
 
 import pytest
 
@@ -336,25 +337,13 @@ def test_extended_information() -> None:
     p = o.profile
 
     def assert_truncated_tuple_equal(
-        tup1: tuple[tuple[float, float, float], ...] | tuple[float],
-        tup2: (
-            tuple[tuple[tuple[float, float, float], ...], ...]
-            | tuple[tuple[float, float, float], ...]
-            | tuple[float]
-        ),
-        digits: int = 10,
+        tup1: tuple[Any, ...], tup2: tuple[Any, ...], digits: int = 10
     ) -> None:
         # Helper function to reduce precision of tuples of floats
         # recursively and then check equality.
         power = 10**digits
 
-        def truncate_tuple(
-            tuple_or_float: (
-                tuple[tuple[tuple[float, float, float], ...], ...]
-                | tuple[tuple[float, float, float], ...]
-                | tuple[float, ...]
-            )
-        ) -> tuple[tuple[float, ...], ...]:
+        def truncate_tuple(tuple_or_float: tuple[Any, ...]) -> tuple[Any, ...]:
             return tuple(
                 (
                     truncate_tuple(val)

From 64579510c018440edb1b0c9c67f36d478f969f38 Mon Sep 17 00:00:00 2001
From: Andrew Murray <radarhere@users.noreply.github.com>
Date: Tue, 20 Feb 2024 21:37:06 +1100
Subject: [PATCH 0211/1178] Updated alt text

---
 docs/deprecations.rst       | 2 +-
 docs/releasenotes/9.2.0.rst | 2 +-
 2 files changed, 2 insertions(+), 2 deletions(-)

diff --git a/docs/deprecations.rst b/docs/deprecations.rst
index 74021a218ef..9fd64fdaa42 100644
--- a/docs/deprecations.rst
+++ b/docs/deprecations.rst
@@ -257,7 +257,7 @@ offset of the text, while the new ``bbox`` methods distinguish this as a ``top``
 offset.
 
 .. image:: ./example/size_vs_bbox.png
-    :alt: Demonstration of size height vs bbox top and bottom
+    :alt: In bbox methods, top measures the vertical distance above the text, while bottom measures that plus the vertical distance of the text itself. In size methods, height also measures the vertical distance above the text plus the vertical distance of the text itself.
     :align: center
 
 FreeTypeFont.getmask2 fill parameter
diff --git a/docs/releasenotes/9.2.0.rst b/docs/releasenotes/9.2.0.rst
index db514068f77..b596a6ab20f 100644
--- a/docs/releasenotes/9.2.0.rst
+++ b/docs/releasenotes/9.2.0.rst
@@ -94,7 +94,7 @@ offset of the text, while the new ``bbox`` methods distinguish this as a ``top``
 offset.
 
 .. image:: ./example/size_vs_bbox.png
-    :alt: Demonstration of size height vs bbox top and bottom
+    :alt: In bbox methods, top measures the vertical distance above the text, while bottom measures that plus the vertical distance of the text itself. In size methods, height also measures the vertical distance above the text plus the vertical distance of the text itself.
     :align: center
 
 API Additions

From 56a02b76eb403356436e6480c5ada23930825e36 Mon Sep 17 00:00:00 2001
From: Andrew Murray <3112309+radarhere@users.noreply.github.com>
Date: Tue, 20 Feb 2024 21:37:40 +1100
Subject: [PATCH 0212/1178] Corrected image path
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit

Co-authored-by: Ondrej Baranovič <nulano@nulano.eu>
---
 docs/releasenotes/9.2.0.rst | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/docs/releasenotes/9.2.0.rst b/docs/releasenotes/9.2.0.rst
index b596a6ab20f..677438bc63e 100644
--- a/docs/releasenotes/9.2.0.rst
+++ b/docs/releasenotes/9.2.0.rst
@@ -93,7 +93,7 @@ Previously, the ``size`` methods returned a ``height`` that included the vertica
 offset of the text, while the new ``bbox`` methods distinguish this as a ``top``
 offset.
 
-.. image:: ./example/size_vs_bbox.png
+.. image:: ../example/size_vs_bbox.png
     :alt: In bbox methods, top measures the vertical distance above the text, while bottom measures that plus the vertical distance of the text itself. In size methods, height also measures the vertical distance above the text plus the vertical distance of the text itself.
     :align: center
 

From 5b20811cabd4594fd4fafc596e3f94afe12bb361 Mon Sep 17 00:00:00 2001
From: Nulano <nulano@nulano.eu>
Date: Tue, 20 Feb 2024 20:36:36 +0100
Subject: [PATCH 0213/1178] Add `--bugreport` argument to __main__.py to omit
 supported formats

---
 src/PIL/__main__.py | 4 +++-
 1 file changed, 3 insertions(+), 1 deletion(-)

diff --git a/src/PIL/__main__.py b/src/PIL/__main__.py
index 943789923dc..32de33624db 100644
--- a/src/PIL/__main__.py
+++ b/src/PIL/__main__.py
@@ -1,5 +1,7 @@
 from __future__ import annotations
 
+import sys
+
 from .features import pilinfo
 
-pilinfo()
+pilinfo(supported_formats="--bugreport" not in sys.argv)

From 10712be53d575a37d9dc2522c9f8f0f62871f3b6 Mon Sep 17 00:00:00 2001
From: Nulano <nulano@nulano.eu>
Date: Tue, 20 Feb 2024 21:21:10 +0100
Subject: [PATCH 0214/1178] Build docs for Python changes

---
 .github/workflows/docs.yml | 2 ++
 1 file changed, 2 insertions(+)

diff --git a/.github/workflows/docs.yml b/.github/workflows/docs.yml
index 4319cc8ff28..92e860cb547 100644
--- a/.github/workflows/docs.yml
+++ b/.github/workflows/docs.yml
@@ -7,10 +7,12 @@ on:
     paths:
       - ".github/workflows/docs.yml"
       - "docs/**"
+      - "src/PIL/**"
   pull_request:
     paths:
       - ".github/workflows/docs.yml"
       - "docs/**"
+      - "src/PIL/**"
   workflow_dispatch:
 
 permissions:

From ab9dfd8181868922abee46dffb11ffcb9a772958 Mon Sep 17 00:00:00 2001
From: Nulano <nulano@nulano.eu>
Date: Tue, 20 Feb 2024 20:37:33 +0100
Subject: [PATCH 0215/1178] Add sys.{executable,base_prefix,prefix} to
 features.pilinfo

---
 Tests/test_features.py | 12 +++++++++---
 Tests/test_main.py     | 12 +++++++++---
 src/PIL/features.py    |  9 +++++++--
 3 files changed, 25 insertions(+), 8 deletions(-)

diff --git a/Tests/test_features.py b/Tests/test_features.py
index 8d2d198ffcd..3fffa032f81 100644
--- a/Tests/test_features.py
+++ b/Tests/test_features.py
@@ -129,9 +129,15 @@ def test_pilinfo() -> None:
     while lines[0].startswith("    "):
         lines = lines[1:]
     assert lines[0] == "-" * 68
-    assert lines[1].startswith("Python modules loaded from ")
-    assert lines[2].startswith("Binary modules loaded from ")
-    assert lines[3] == "-" * 68
+    assert lines[1].startswith("Python executable is")
+    lines = lines[2:]
+    if lines[0].startswith("Environment Python files loaded from"):
+        lines = lines[1:]
+    assert lines[0].startswith("System Python files loaded from")
+    assert lines[1] == "-" * 68
+    assert lines[2].startswith("Python Pillow modules loaded from ")
+    assert lines[3].startswith("Binary Pillow modules loaded from ")
+    assert lines[4] == "-" * 68
     jpeg = (
         "\n"
         + "-" * 68
diff --git a/Tests/test_main.py b/Tests/test_main.py
index 46259f1dc52..e13e0c5e3ac 100644
--- a/Tests/test_main.py
+++ b/Tests/test_main.py
@@ -15,9 +15,15 @@ def test_main() -> None:
     while lines[0].startswith("    "):
         lines = lines[1:]
     assert lines[0] == "-" * 68
-    assert lines[1].startswith("Python modules loaded from ")
-    assert lines[2].startswith("Binary modules loaded from ")
-    assert lines[3] == "-" * 68
+    assert lines[1].startswith("Python executable is")
+    lines = lines[2:]
+    if lines[0].startswith("Environment Python files loaded from"):
+        lines = lines[1:]
+    assert lines[0].startswith("System Python files loaded from")
+    assert lines[1] == "-" * 68
+    assert lines[2].startswith("Python Pillow modules loaded from ")
+    assert lines[3].startswith("Binary Pillow modules loaded from ")
+    assert lines[4] == "-" * 68
     jpeg = (
         os.linesep
         + "-" * 68
diff --git a/src/PIL/features.py b/src/PIL/features.py
index b14d6df13f2..7c5112ef6e4 100644
--- a/src/PIL/features.py
+++ b/src/PIL/features.py
@@ -249,12 +249,17 @@ def pilinfo(out=None, supported_formats=True):
     for py_version in py_version[1:]:
         print(f"       {py_version.strip()}", file=out)
     print("-" * 68, file=out)
+    print(f"Python executable is {sys.executable or 'unknown'}", file=out)
+    if sys.prefix != sys.base_prefix:
+        print(f"Environment Python files loaded from {sys.prefix}", file=out)
+    print(f"System Python files loaded from {sys.base_prefix}", file=out)
+    print("-" * 68, file=out)
     print(
-        f"Python modules loaded from {os.path.dirname(Image.__file__)}",
+        f"Python Pillow modules loaded from {os.path.dirname(Image.__file__)}",
         file=out,
     )
     print(
-        f"Binary modules loaded from {os.path.dirname(Image.core.__file__)}",
+        f"Binary Pillow modules loaded from {os.path.dirname(Image.core.__file__)}",
         file=out,
     )
     print("-" * 68, file=out)

From 89c44be404081c77e68457c1c50a78e96a6d42b9 Mon Sep 17 00:00:00 2001
From: Nulano <nulano@nulano.eu>
Date: Tue, 20 Feb 2024 20:39:40 +0100
Subject: [PATCH 0216/1178] Mention `python -m PIL --bugreport` in the issue
 template

---
 .github/ISSUE_TEMPLATE/ISSUE_REPORT.md | 4 ++++
 1 file changed, 4 insertions(+)

diff --git a/.github/ISSUE_TEMPLATE/ISSUE_REPORT.md b/.github/ISSUE_TEMPLATE/ISSUE_REPORT.md
index 115f6135dfb..cfd576f3588 100644
--- a/.github/ISSUE_TEMPLATE/ISSUE_REPORT.md
+++ b/.github/ISSUE_TEMPLATE/ISSUE_REPORT.md
@@ -48,6 +48,10 @@ Thank you.
 * Python: 
 * Pillow: 
 
+```text
+please paste the output of running `python3 -m PIL --bugreport` here
+```
+
 <!--
 Please include **code** that reproduces the issue and whenever possible, an **image** that demonstrates the issue. Please upload images to GitHub, not to third-party file hosting sites. If necessary, add the image to a zip or tar archive.
 

From 481ed446e20095fe1372297228d458ee9366d996 Mon Sep 17 00:00:00 2001
From: Hugo van Kemenade <1324225+hugovk@users.noreply.github.com>
Date: Tue, 20 Feb 2024 21:42:39 +0200
Subject: [PATCH 0217/1178] Set "COVERAGE_CORE: sysmon" for faster tests on
 3.12+

---
 .appveyor.yml                      | 1 +
 .github/workflows/test-cygwin.yml  | 3 +++
 .github/workflows/test-mingw.yml   | 3 +++
 .github/workflows/test-windows.yml | 3 +++
 .github/workflows/test.yml         | 1 +
 5 files changed, 11 insertions(+)

diff --git a/.appveyor.yml b/.appveyor.yml
index 4c5a7f9ee47..b0740b1ac6f 100644
--- a/.appveyor.yml
+++ b/.appveyor.yml
@@ -6,6 +6,7 @@ init:
 # Uncomment previous line to get RDP access during the build.
 
 environment:
+  COVERAGE_CORE: sysmon
   EXECUTABLE: python.exe
   TEST_OPTIONS:
   DEPLOY: YES
diff --git a/.github/workflows/test-cygwin.yml b/.github/workflows/test-cygwin.yml
index 2615fb427df..4526b945424 100644
--- a/.github/workflows/test-cygwin.yml
+++ b/.github/workflows/test-cygwin.yml
@@ -26,6 +26,9 @@ concurrency:
   group: ${{ github.workflow }}-${{ github.ref }}
   cancel-in-progress: true
 
+env:
+  COVERAGE_CORE: sysmon
+
 jobs:
   build:
     runs-on: windows-latest
diff --git a/.github/workflows/test-mingw.yml b/.github/workflows/test-mingw.yml
index 1c6d15b77d7..b4e479f123e 100644
--- a/.github/workflows/test-mingw.yml
+++ b/.github/workflows/test-mingw.yml
@@ -26,6 +26,9 @@ concurrency:
   group: ${{ github.workflow }}-${{ github.ref }}
   cancel-in-progress: true
 
+env:
+  COVERAGE_CORE: sysmon
+
 jobs:
   build:
     runs-on: windows-latest
diff --git a/.github/workflows/test-windows.yml b/.github/workflows/test-windows.yml
index 79a2e60b251..d3d1eeaa3c8 100644
--- a/.github/workflows/test-windows.yml
+++ b/.github/workflows/test-windows.yml
@@ -26,6 +26,9 @@ concurrency:
   group: ${{ github.workflow }}-${{ github.ref }}
   cancel-in-progress: true
 
+env:
+  COVERAGE_CORE: sysmon
+
 jobs:
   build:
     runs-on: windows-latest
diff --git a/.github/workflows/test.yml b/.github/workflows/test.yml
index 19f4a6daedc..643273e58b3 100644
--- a/.github/workflows/test.yml
+++ b/.github/workflows/test.yml
@@ -27,6 +27,7 @@ concurrency:
   cancel-in-progress: true
 
 env:
+  COVERAGE_CORE: sysmon
   FORCE_COLOR: 1
 
 jobs:

From 7200f47d315618b64b353c6d4a99860c65ad6df9 Mon Sep 17 00:00:00 2001
From: Andrew Murray <radarhere@users.noreply.github.com>
Date: Wed, 21 Feb 2024 08:11:01 +1100
Subject: [PATCH 0218/1178] Renamed argument

---
 Tests/test_imagecms.py | 4 ++--
 1 file changed, 2 insertions(+), 2 deletions(-)

diff --git a/Tests/test_imagecms.py b/Tests/test_imagecms.py
index a7bb31db512..6be29a70f70 100644
--- a/Tests/test_imagecms.py
+++ b/Tests/test_imagecms.py
@@ -343,14 +343,14 @@ def assert_truncated_tuple_equal(
         # recursively and then check equality.
         power = 10**digits
 
-        def truncate_tuple(tuple_or_float: tuple[Any, ...]) -> tuple[Any, ...]:
+        def truncate_tuple(tuple_value: tuple[Any, ...]) -> tuple[Any, ...]:
             return tuple(
                 (
                     truncate_tuple(val)
                     if isinstance(val, tuple)
                     else int(val * power) / power
                 )
-                for val in tuple_or_float
+                for val in tuple_value
             )
 
         assert truncate_tuple(tup1) == truncate_tuple(tup2)

From ca63a12ac209fa0e1a9156655927d04f6483840b Mon Sep 17 00:00:00 2001
From: Nulano <nulano@nulano.eu>
Date: Tue, 20 Feb 2024 22:50:14 +0100
Subject: [PATCH 0219/1178] Mention features.pilinfo directly in the issue
 template

---
 .github/ISSUE_TEMPLATE/ISSUE_REPORT.md | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/.github/ISSUE_TEMPLATE/ISSUE_REPORT.md b/.github/ISSUE_TEMPLATE/ISSUE_REPORT.md
index cfd576f3588..de1d14bb3e9 100644
--- a/.github/ISSUE_TEMPLATE/ISSUE_REPORT.md
+++ b/.github/ISSUE_TEMPLATE/ISSUE_REPORT.md
@@ -49,7 +49,7 @@ Thank you.
 * Pillow: 
 
 ```text
-please paste the output of running `python3 -m PIL --bugreport` here
+please paste here the output of the following Python code: `from PIL import features; features.pilinfo(supported_formats=False)`
 ```
 
 <!--

From c322a2f63378c04bf1203bab5e3e9e8ff59cbe9e Mon Sep 17 00:00:00 2001
From: Andrew Murray <radarhere@users.noreply.github.com>
Date: Wed, 21 Feb 2024 19:39:29 +1100
Subject: [PATCH 0220/1178] Use maximum frame size in IHDR chunk when saving

---
 Tests/test_file_apng.py   | 10 ++++++++++
 src/PIL/PngImagePlugin.py |  8 ++++++--
 2 files changed, 16 insertions(+), 2 deletions(-)

diff --git a/Tests/test_file_apng.py b/Tests/test_file_apng.py
index 395165b3657..1b393a3ff5d 100644
--- a/Tests/test_file_apng.py
+++ b/Tests/test_file_apng.py
@@ -668,6 +668,16 @@ def test_apng_save_blend(tmp_path: Path) -> None:
         assert im.getpixel((0, 0)) == (0, 255, 0, 255)
 
 
+def test_apng_save_size(tmp_path: Path) -> None:
+    test_file = str(tmp_path / "temp.png")
+
+    im = Image.new("L", (100, 100))
+    im.save(test_file, save_all=True, append_images=[Image.new("L", (200, 200))])
+
+    with Image.open(test_file) as reloaded:
+        assert reloaded.size == (200, 200)
+
+
 def test_seek_after_close() -> None:
     im = Image.open("Tests/images/apng/delay.png")
     im.seek(1)
diff --git a/src/PIL/PngImagePlugin.py b/src/PIL/PngImagePlugin.py
index 823f1249285..203d962e35e 100644
--- a/src/PIL/PngImagePlugin.py
+++ b/src/PIL/PngImagePlugin.py
@@ -1232,16 +1232,20 @@ def _save(im, fp, filename, chunk=putchunk, save_all=False):
             "default_image", im.info.get("default_image")
         )
         modes = set()
+        sizes = set()
         append_images = im.encoderinfo.get("append_images", [])
         for im_seq in itertools.chain([im], append_images):
             for im_frame in ImageSequence.Iterator(im_seq):
                 modes.add(im_frame.mode)
+                sizes.add(im_frame.size)
         for mode in ("RGBA", "RGB", "P"):
             if mode in modes:
                 break
         else:
             mode = modes.pop()
+        size = tuple(max(frame_size[i] for frame_size in sizes) for i in range(2))
     else:
+        size = im.size
         mode = im.mode
 
     if mode == "P":
@@ -1289,8 +1293,8 @@ def _save(im, fp, filename, chunk=putchunk, save_all=False):
     chunk(
         fp,
         b"IHDR",
-        o32(im.size[0]),  # 0: size
-        o32(im.size[1]),
+        o32(size[0]),  # 0: size
+        o32(size[1]),
         mode,  # 8: depth/type
         b"\0",  # 10: compression
         b"\0",  # 11: filter category

From 097cf182fc72ec3c536ac9fc038db4571d63daf1 Mon Sep 17 00:00:00 2001
From: Andrew Murray <radarhere@users.noreply.github.com>
Date: Wed, 21 Feb 2024 21:26:37 +1100
Subject: [PATCH 0221/1178] Added py.typed to support type checking

---
 src/PIL/py.typed | 0
 1 file changed, 0 insertions(+), 0 deletions(-)
 create mode 100644 src/PIL/py.typed

diff --git a/src/PIL/py.typed b/src/PIL/py.typed
new file mode 100644
index 00000000000..e69de29bb2d

From 9115529856cc94226d9bfba165c07813de17ea3c Mon Sep 17 00:00:00 2001
From: Andrew Murray <radarhere@users.noreply.github.com>
Date: Wed, 21 Feb 2024 21:42:04 +1100
Subject: [PATCH 0222/1178] Added "Typing :: Typed" classifier

---
 pyproject.toml | 1 +
 1 file changed, 1 insertion(+)

diff --git a/pyproject.toml b/pyproject.toml
index e687f4bcf76..58c2464bcad 100644
--- a/pyproject.toml
+++ b/pyproject.toml
@@ -33,6 +33,7 @@ classifiers = [
   "Topic :: Multimedia :: Graphics :: Capture :: Screen Capture",
   "Topic :: Multimedia :: Graphics :: Graphics Conversion",
   "Topic :: Multimedia :: Graphics :: Viewers",
+  "Typing :: Typed",
 ]
 dynamic = [
   "version",

From e45477e507c87c65947aea07bc8b081043444517 Mon Sep 17 00:00:00 2001
From: =?UTF-8?q?S=C3=A9bastien=20Noel?= <sebastien@twolife.be>
Date: Fri, 16 Feb 2024 15:47:51 +0100
Subject: [PATCH 0223/1178] fix FLI/FLC decoder for files with a prefix chunk

---
 Tests/images/2422.flc     | Bin 0 -> 14572 bytes
 Tests/test_file_fli.py    |  25 +++++++++++++++++++++++--
 src/PIL/FliImagePlugin.py |   1 +
 3 files changed, 24 insertions(+), 2 deletions(-)
 create mode 100644 Tests/images/2422.flc

diff --git a/Tests/images/2422.flc b/Tests/images/2422.flc
new file mode 100644
index 0000000000000000000000000000000000000000..eed5fb59e1b8793964575df338c68f78c4b23f06
GIT binary patch
literal 14572
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
b@Bk^<%B0|rl&oKRH$D0t%}&?3&xrpAhjQ1S

literal 0
HcmV?d00001

diff --git a/Tests/test_file_fli.py b/Tests/test_file_fli.py
index fc524721c2b..f86fb8d0925 100644
--- a/Tests/test_file_fli.py
+++ b/Tests/test_file_fli.py
@@ -4,7 +4,7 @@
 
 import pytest
 
-from PIL import FliImagePlugin, Image
+from PIL import FliImagePlugin, Image, ImageFile
 
 from .helper import assert_image_equal, assert_image_equal_tofile, is_pypy
 
@@ -12,9 +12,12 @@
 # save as...-> hopper.fli, default options.
 static_test_file = "Tests/images/hopper.fli"
 
-# From https://samples.libav.org/fli-flc/
+# From https://samples.ffmpeg.org/fli-flc/
 animated_test_file = "Tests/images/a.fli"
 
+# From https://samples.ffmpeg.org/fli-flc/
+animated_test_file_with_prefix_chunk = "Tests/images/2422.flc"
+
 
 def test_sanity() -> None:
     with Image.open(static_test_file) as im:
@@ -32,6 +35,24 @@ def test_sanity() -> None:
         assert im.is_animated
 
 
+def test_prefix_chunk() -> None:
+    ImageFile.LOAD_TRUNCATED_IMAGES = True
+    try:
+        with Image.open(animated_test_file_with_prefix_chunk) as im:
+            assert im.mode == "P"
+            assert im.size == (320, 200)
+            assert im.format == "FLI"
+            assert im.info["duration"] == 171
+            assert im.is_animated
+
+            palette = im.getpalette()
+            assert palette[3:6] == [255, 255, 255]
+            assert palette[381:384] == [204, 204, 12]
+            assert palette[765:] == [252, 0, 0]
+    finally:
+        ImageFile.LOAD_TRUNCATED_IMAGES = False
+
+
 @pytest.mark.skipif(is_pypy(), reason="Requires CPython")
 def test_unclosed_file() -> None:
     def open() -> None:
diff --git a/src/PIL/FliImagePlugin.py b/src/PIL/FliImagePlugin.py
index 9769761fc15..f9e4c731c88 100644
--- a/src/PIL/FliImagePlugin.py
+++ b/src/PIL/FliImagePlugin.py
@@ -77,6 +77,7 @@ def _open(self):
         if i16(s, 4) == 0xF100:
             # prefix chunk; ignore it
             self.__offset = self.__offset + i32(s)
+            self.fp.seek(self.__offset)
             s = self.fp.read(16)
 
         if i16(s, 4) == 0xF1FA:

From 383ac4fca01289139ab9e7d7e41d6fdf97a3df90 Mon Sep 17 00:00:00 2001
From: Andrew Murray <radarhere@users.noreply.github.com>
Date: Thu, 22 Feb 2024 19:50:36 +1100
Subject: [PATCH 0224/1178] Fixed reading PNG iCCP compression method

---
 Tests/images/unknown_compression_method.png | Bin 0 -> 4128 bytes
 Tests/test_file_png.py                      |   4 ++++
 src/PIL/PngImagePlugin.py                   |   4 ++--
 3 files changed, 6 insertions(+), 2 deletions(-)
 create mode 100644 Tests/images/unknown_compression_method.png

diff --git a/Tests/images/unknown_compression_method.png b/Tests/images/unknown_compression_method.png
new file mode 100644
index 0000000000000000000000000000000000000000..e1614a731a5ff0126513cd21d448e42cb084d5b1
GIT binary patch
literal 4128
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

literal 0
HcmV?d00001

diff --git a/Tests/test_file_png.py b/Tests/test_file_png.py
index c51f56ce7c0..38ffc4bd019 100644
--- a/Tests/test_file_png.py
+++ b/Tests/test_file_png.py
@@ -619,6 +619,10 @@ def test_textual_chunks_after_idat(self) -> None:
         with Image.open("Tests/images/hopper_idat_after_image_end.png") as im:
             assert im.text == {"TXT": "VALUE", "ZIP": "VALUE"}
 
+    def test_unknown_compression_method(self) -> None:
+        with pytest.raises(SyntaxError, match="Unknown compression method"):
+            PngImagePlugin.PngImageFile("Tests/images/unknown_compression_method.png")
+
     def test_padded_idat(self) -> None:
         # This image has been manually hexedited
         # so that the IDAT chunk has padding at the end
diff --git a/src/PIL/PngImagePlugin.py b/src/PIL/PngImagePlugin.py
index 823f1249285..d864fd201b8 100644
--- a/src/PIL/PngImagePlugin.py
+++ b/src/PIL/PngImagePlugin.py
@@ -392,8 +392,8 @@ def chunk_iCCP(self, pos, length):
         # Compressed profile    n bytes (zlib with deflate compression)
         i = s.find(b"\0")
         logger.debug("iCCP profile name %r", s[:i])
-        logger.debug("Compression method %s", s[i])
-        comp_method = s[i]
+        comp_method = s[i + 1]
+        logger.debug("Compression method %s", comp_method)
         if comp_method != 0:
             msg = f"Unknown compression method {comp_method} in iCCP chunk"
             raise SyntaxError(msg)

From 9441855107058d464540e45a357ee28e6c7bfba6 Mon Sep 17 00:00:00 2001
From: Andrew Murray <radarhere@users.noreply.github.com>
Date: Thu, 22 Feb 2024 20:11:05 +1100
Subject: [PATCH 0225/1178] Update CHANGES.rst [ci skip]

---
 CHANGES.rst | 3 +++
 1 file changed, 3 insertions(+)

diff --git a/CHANGES.rst b/CHANGES.rst
index a8404260ff3..ce81f206018 100644
--- a/CHANGES.rst
+++ b/CHANGES.rst
@@ -5,6 +5,9 @@ Changelog (Pillow)
 10.3.0 (unreleased)
 -------------------
 
+- Fixed reading FLI/FLC images with a prefix chunk #7804
+  [twolife]
+
 - Update wl-paste handling and return None for some errors in grabclipboard() on Linux #7745
   [nik012003, radarhere]
 

From b5c6f20007d71bd00937c3faed214dc083e46d05 Mon Sep 17 00:00:00 2001
From: Andrew Murray <radarhere@users.noreply.github.com>
Date: Thu, 22 Feb 2024 20:32:46 +1100
Subject: [PATCH 0226/1178] Added release notes

---
 docs/releasenotes/10.3.0.rst | 6 ++++++
 1 file changed, 6 insertions(+)

diff --git a/docs/releasenotes/10.3.0.rst b/docs/releasenotes/10.3.0.rst
index 8772a382dc2..af31cdb74fa 100644
--- a/docs/releasenotes/10.3.0.rst
+++ b/docs/releasenotes/10.3.0.rst
@@ -79,3 +79,9 @@ Portable FloatMap (PFM) images
 
 Support has been added for reading and writing grayscale (Pf format)
 Portable FloatMap (PFM) files containing ``F`` data.
+
+Release GIL when fetching WebP frames
+^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
+
+Python's Global Interpreter Lock is now released when fetching WebP frames from
+the libwebp decoder.

From f86a442bd55835cfaf5297f183f59ddd2a5d2557 Mon Sep 17 00:00:00 2001
From: Andrew Murray <radarhere@users.noreply.github.com>
Date: Thu, 22 Feb 2024 21:51:56 +1100
Subject: [PATCH 0227/1178] Update CHANGES.rst [ci skip]

---
 CHANGES.rst | 3 +++
 1 file changed, 3 insertions(+)

diff --git a/CHANGES.rst b/CHANGES.rst
index ce81f206018..205ffa29482 100644
--- a/CHANGES.rst
+++ b/CHANGES.rst
@@ -5,6 +5,9 @@ Changelog (Pillow)
 10.3.0 (unreleased)
 -------------------
 
+- Release GIL while calling ``WebPAnimDecoderGetNext`` #7782
+  [evanmiller, radarhere]
+
 - Fixed reading FLI/FLC images with a prefix chunk #7804
   [twolife]
 

From a08df5bc589613a682deb9c5dde5b0432c981d22 Mon Sep 17 00:00:00 2001
From: Hugo van Kemenade <1324225+hugovk@users.noreply.github.com>
Date: Fri, 23 Feb 2024 10:56:26 +0200
Subject: [PATCH 0228/1178] Require coverage.py 7.4.2+ for COVERAGE_CORE:
 sysmon

---
 .github/workflows/test-windows.yml | 12 ++++++++++--
 1 file changed, 10 insertions(+), 2 deletions(-)

diff --git a/.github/workflows/test-windows.yml b/.github/workflows/test-windows.yml
index d3d1eeaa3c8..c936be55925 100644
--- a/.github/workflows/test-windows.yml
+++ b/.github/workflows/test-windows.yml
@@ -69,8 +69,16 @@ jobs:
     - name: Print build system information
       run: python3 .github/workflows/system-info.py
 
-    - name: python3 -m pip install pytest pytest-cov pytest-timeout defusedxml olefile pyroma
-      run: python3 -m pip install pytest pytest-cov pytest-timeout defusedxml olefile pyroma
+    - name: Install Python dependencies
+      run: >
+        python3 -m pip install
+        coverage>=7.4.2
+        defusedxml
+        olefile
+        pyroma
+        pytest
+        pytest-cov
+        pytest-timeout
 
     - name: Install dependencies
       id: install

From 24865e58325c8d6fe015aaf5aec0df3b535a09d4 Mon Sep 17 00:00:00 2001
From: Andrew Murray <radarhere@users.noreply.github.com>
Date: Fri, 23 Feb 2024 23:50:36 +1100
Subject: [PATCH 0229/1178] Turn off nullability warnings for macOS SDK

---
 setup.py | 3 +++
 1 file changed, 3 insertions(+)

diff --git a/setup.py b/setup.py
index 1bbd2c05cc9..ce8f989abbe 100644
--- a/setup.py
+++ b/setup.py
@@ -569,6 +569,9 @@ def build_extensions(self):
             if sdk_path:
                 _add_directory(library_dirs, os.path.join(sdk_path, "usr", "lib"))
                 _add_directory(include_dirs, os.path.join(sdk_path, "usr", "include"))
+
+                for extension in self.extensions:
+                    extension.extra_compile_args = ["-Wno-nullability-completeness"]
         elif (
             sys.platform.startswith("linux")
             or sys.platform.startswith("gnu")

From 0a6ccd60bcb4ce674db2e6617c8215efbe4b7fae Mon Sep 17 00:00:00 2001
From: Andrew Murray <radarhere@users.noreply.github.com>
Date: Sat, 24 Feb 2024 11:00:17 +1100
Subject: [PATCH 0230/1178] Updated libpng to 1.6.43

---
 .github/workflows/wheels-dependencies.sh | 2 +-
 winbuild/build_prepare.py                | 6 +++---
 2 files changed, 4 insertions(+), 4 deletions(-)

diff --git a/.github/workflows/wheels-dependencies.sh b/.github/workflows/wheels-dependencies.sh
index 26bf2f6d655..01f8ca9d46e 100755
--- a/.github/workflows/wheels-dependencies.sh
+++ b/.github/workflows/wheels-dependencies.sh
@@ -17,7 +17,7 @@ ARCHIVE_SDIR=pillow-depends-main
 # Package versions for fresh source builds
 FREETYPE_VERSION=2.13.2
 HARFBUZZ_VERSION=8.3.0
-LIBPNG_VERSION=1.6.40
+LIBPNG_VERSION=1.6.43
 JPEGTURBO_VERSION=3.0.1
 OPENJPEG_VERSION=2.5.0
 XZ_VERSION=5.4.5
diff --git a/winbuild/build_prepare.py b/winbuild/build_prepare.py
index df33ea493e6..91d4ca16ab0 100644
--- a/winbuild/build_prepare.py
+++ b/winbuild/build_prepare.py
@@ -224,9 +224,9 @@ def cmd_msbuild(
         "libs": [r"libtiff\*.lib"],
     },
     "libpng": {
-        "url": SF_PROJECTS + "/libpng/files/libpng16/1.6.39/lpng1639.zip/download",
-        "filename": "lpng1639.zip",
-        "dir": "lpng1639",
+        "url": SF_PROJECTS + "/libpng/files/libpng16/1.6.43/lpng1643.zip/download",
+        "filename": "lpng1643.zip",
+        "dir": "lpng1643",
         "license": "LICENSE",
         "build": [
             *cmds_cmake("png_static", "-DPNG_SHARED:BOOL=OFF", "-DPNG_TESTS:BOOL=OFF"),

From f11ff462b33e706c6db476c85956d888b8abf683 Mon Sep 17 00:00:00 2001
From: Hugo van Kemenade <1324225+hugovk@users.noreply.github.com>
Date: Sat, 24 Feb 2024 14:53:25 +0200
Subject: [PATCH 0231/1178] Move outdated installation warnings to
 'Deprecations and removals'

---
 docs/deprecations.rst | 24 ++++++++++++++++++++++++
 1 file changed, 24 insertions(+)

diff --git a/docs/deprecations.rst b/docs/deprecations.rst
index 205fcb9abcd..46c8a07013e 100644
--- a/docs/deprecations.rst
+++ b/docs/deprecations.rst
@@ -504,3 +504,27 @@ PIL.OleFileIO
 the upstream :pypi:`olefile` Python package, and replaced with an :py:exc:`ImportError` in 5.0.0
 (2018-01). The deprecated file has now been removed from Pillow. If needed, install from
 PyPI (eg. ``python3 -m pip install olefile``).
+
+import _imaging
+~~~~~~~~~~~~~~~
+
+.. versionremoved:: 2.1.0
+
+Pillow >= 2.1.0 no longer supports ``import _imaging``.
+Please use ``from PIL.Image import core as _imaging`` instead.
+
+Pillow and PIL
+~~~~~~~~~~~~~~
+
+Pillow and PIL cannot co-exist in the same environment.
+Before installing Pillow, please uninstall PIL.
+
+.. versionremoved:: 1.0.0
+
+import Image
+~~~~~~~~~~~~
+
+.. versionremoved:: 1.0.0
+
+Pillow >= 1.0 no longer supports ``import Image``.
+Please use ``from PIL import Image`` instead.

From e30298f35661c4427fabd73ddaac53c97fe713c6 Mon Sep 17 00:00:00 2001
From: Andrew Murray <radarhere@users.noreply.github.com>
Date: Sun, 25 Feb 2024 06:53:29 +1100
Subject: [PATCH 0232/1178] Consistently place versionremoved under heading

---
 docs/deprecations.rst | 4 ++--
 1 file changed, 2 insertions(+), 2 deletions(-)

diff --git a/docs/deprecations.rst b/docs/deprecations.rst
index 46c8a07013e..8877ccdebd7 100644
--- a/docs/deprecations.rst
+++ b/docs/deprecations.rst
@@ -516,11 +516,11 @@ Please use ``from PIL.Image import core as _imaging`` instead.
 Pillow and PIL
 ~~~~~~~~~~~~~~
 
+.. versionremoved:: 1.0.0
+
 Pillow and PIL cannot co-exist in the same environment.
 Before installing Pillow, please uninstall PIL.
 
-.. versionremoved:: 1.0.0
-
 import Image
 ~~~~~~~~~~~~
 

From ece34104cb0671ef0f1f59e9924fb1be0bcf351a Mon Sep 17 00:00:00 2001
From: Yay295 <Yay295@users.noreply.github.com>
Date: Mon, 26 Feb 2024 00:34:54 -0600
Subject: [PATCH 0233/1178] parametrize test_p_from_rgb_rgba()

---
 Tests/test_image.py | 15 +++++++++------
 1 file changed, 9 insertions(+), 6 deletions(-)

diff --git a/Tests/test_image.py b/Tests/test_image.py
index 4c04e0da48e..ca4458f884d 100644
--- a/Tests/test_image.py
+++ b/Tests/test_image.py
@@ -685,15 +685,18 @@ def _make_new(
         _make_new(im, blank_p, ImagePalette.ImagePalette())
         _make_new(im, blank_pa, ImagePalette.ImagePalette())
 
-    def test_p_from_rgb_rgba(self) -> None:
-        for mode, color in [
+    @pytest.mark.parametrize(
+        ("mode", "color"),
+        (
             ("RGB", "#DDEEFF"),
             ("RGB", (221, 238, 255)),
             ("RGBA", (221, 238, 255, 255)),
-        ]:
-            im = Image.new("P", (100, 100), color)
-            expected = Image.new(mode, (100, 100), color)
-            assert_image_equal(im.convert(mode), expected)
+        ),
+    )
+    def test_p_from_rgb_rgba(self, mode, color) -> None:
+        im = Image.new("P", (100, 100), color)
+        expected = Image.new(mode, (100, 100), color)
+        assert_image_equal(im.convert(mode), expected)
 
     def test_no_resource_warning_on_save(self, tmp_path: Path) -> None:
         # https://github.com/python-pillow/Pillow/issues/835

From 7a5b91dd2c165d9bde5ced73f34ba5a4238981ef Mon Sep 17 00:00:00 2001
From: Andrew Murray <radarhere@users.noreply.github.com>
Date: Mon, 26 Feb 2024 20:29:47 +1100
Subject: [PATCH 0234/1178] Removed references to Twitter

---
 README.md      | 3 ---
 RELEASING.md   | 2 +-
 docs/index.rst | 4 ----
 pyproject.toml | 1 -
 4 files changed, 1 insertion(+), 9 deletions(-)

diff --git a/README.md b/README.md
index 9776c40e2f7..f142ef56302 100644
--- a/README.md
+++ b/README.md
@@ -82,9 +82,6 @@ As of 2019, Pillow development is
             <a href="https://gitter.im/python-pillow/Pillow?utm_source=badge&utm_medium=badge&utm_campaign=pr-badge&utm_content=badge"><img
                 alt="Join the chat at https://gitter.im/python-pillow/Pillow"
                 src="https://badges.gitter.im/python-pillow/Pillow.svg"></a>
-            <a href="https://twitter.com/PythonPillow"><img
-                alt="Follow on https://twitter.com/PythonPillow"
-                src="https://img.shields.io/badge/tweet-on%20Twitter-00aced.svg"></a>
             <a href="https://fosstodon.org/@pillow"><img
                 alt="Follow on https://fosstodon.org/@pillow"
                 src="https://img.shields.io/badge/publish-on%20Mastodon-595aff.svg"
diff --git a/RELEASING.md b/RELEASING.md
index 62f3627de19..b013d8288ff 100644
--- a/RELEASING.md
+++ b/RELEASING.md
@@ -86,7 +86,7 @@ Released as needed privately to individual vendors for critical security-related
 
 ## Publicize Release
 
-* [ ] Announce release availability via [Twitter](https://twitter.com/pythonpillow) and [Mastodon](https://fosstodon.org/@pillow) e.g. https://twitter.com/PythonPillow/status/1013789184354603010
+* [ ] Announce release availability via [Mastodon](https://fosstodon.org/@pillow) e.g. https://fosstodon.org/@pillow/110639450470725321
 
 ## Documentation
 
diff --git a/docs/index.rst b/docs/index.rst
index bf2feea9a53..f4e81e45d7a 100644
--- a/docs/index.rst
+++ b/docs/index.rst
@@ -73,10 +73,6 @@ Pillow for enterprise is available via the Tidelift Subscription. `Learn more <h
    :target: https://gitter.im/python-pillow/Pillow?utm_source=badge&utm_medium=badge&utm_campaign=pr-badge&utm_content=badge
    :alt: Join the chat at https://gitter.im/python-pillow/Pillow
 
-.. image:: https://img.shields.io/badge/tweet-on%20Twitter-00aced.svg
-   :target: https://twitter.com/PythonPillow
-   :alt: Follow on https://twitter.com/PythonPillow
-
 .. image:: https://img.shields.io/badge/publish-on%20Mastodon-595aff.svg
    :target: https://fosstodon.org/@pillow
    :alt: Follow on https://fosstodon.org/@pillow
diff --git a/pyproject.toml b/pyproject.toml
index 58c2464bcad..518facc34f7 100644
--- a/pyproject.toml
+++ b/pyproject.toml
@@ -80,7 +80,6 @@ Homepage = "https://python-pillow.org"
 Mastodon = "https://fosstodon.org/@pillow"
 "Release notes" = "https://pillow.readthedocs.io/en/stable/releasenotes/index.html"
 Source = "https://github.com/python-pillow/Pillow"
-Twitter = "https://twitter.com/PythonPillow"
 
 [tool.setuptools]
 packages = ["PIL"]

From fe85947f16f8f1e27a7416c4f0a0aec72be5b14e Mon Sep 17 00:00:00 2001
From: Yay295 <Yay295@users.noreply.github.com>
Date: Mon, 26 Feb 2024 07:47:13 -0600
Subject: [PATCH 0235/1178] use single string for parameter names instead of
 tuple of strings

Co-authored-by: Andrew Murray <3112309+radarhere@users.noreply.github.com>
---
 Tests/test_image.py | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/Tests/test_image.py b/Tests/test_image.py
index ca4458f884d..cdcbc707211 100644
--- a/Tests/test_image.py
+++ b/Tests/test_image.py
@@ -686,7 +686,7 @@ def _make_new(
         _make_new(im, blank_pa, ImagePalette.ImagePalette())
 
     @pytest.mark.parametrize(
-        ("mode", "color"),
+        "mode, color",
         (
             ("RGB", "#DDEEFF"),
             ("RGB", (221, 238, 255)),

From e6785576b179fe730698d57d74c824c374b117ce Mon Sep 17 00:00:00 2001
From: Yay295 <Yay295@users.noreply.github.com>
Date: Mon, 26 Feb 2024 08:47:30 -0600
Subject: [PATCH 0236/1178] add typing to test_p_from_rgb_rgba()

Co-authored-by: Hugo van Kemenade <1324225+hugovk@users.noreply.github.com>
---
 Tests/test_image.py | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/Tests/test_image.py b/Tests/test_image.py
index cdcbc707211..2a4d453e2eb 100644
--- a/Tests/test_image.py
+++ b/Tests/test_image.py
@@ -693,7 +693,7 @@ def _make_new(
             ("RGBA", (221, 238, 255, 255)),
         ),
     )
-    def test_p_from_rgb_rgba(self, mode, color) -> None:
+    def test_p_from_rgb_rgba(self, mode: str, color: str | tuple[int, ...]) -> None:
         im = Image.new("P", (100, 100), color)
         expected = Image.new(mode, (100, 100), color)
         assert_image_equal(im.convert(mode), expected)

From 73e49cad2125c7b2d01e5fe3293d8a7312f14801 Mon Sep 17 00:00:00 2001
From: Alex Clark <aclark@aclark.net>
Date: Sat, 24 Feb 2024 18:31:43 -0500
Subject: [PATCH 0237/1178] Move installation.rst to installation/*.rst

- Add index
- Move content to sections
- Rearrange sections
---
 docs/index.rst                             |   2 +-
 docs/installation.rst                      | 597 ---------------------
 docs/installation/basic-installation.rst   |  95 ++++
 docs/installation/building-from-source.rst | 298 ++++++++++
 docs/installation/index.rst                |  11 +
 docs/{ => installation}/newer-versions.csv |   0
 docs/installation/old-versions.rst         |   6 +
 docs/{ => installation}/older-versions.csv |   0
 docs/installation/platform-support.rst     | 166 ++++++
 docs/installation/python-support.rst       |  17 +
 10 files changed, 594 insertions(+), 598 deletions(-)
 delete mode 100644 docs/installation.rst
 create mode 100644 docs/installation/basic-installation.rst
 create mode 100644 docs/installation/building-from-source.rst
 create mode 100644 docs/installation/index.rst
 rename docs/{ => installation}/newer-versions.csv (100%)
 create mode 100644 docs/installation/old-versions.rst
 rename docs/{ => installation}/older-versions.csv (100%)
 create mode 100644 docs/installation/platform-support.rst
 create mode 100644 docs/installation/python-support.rst

diff --git a/docs/index.rst b/docs/index.rst
index bf2feea9a53..0c7fb690bc9 100644
--- a/docs/index.rst
+++ b/docs/index.rst
@@ -97,7 +97,7 @@ The core image library is designed for fast access to data stored in a few basic
 .. toctree::
    :maxdepth: 2
 
-   installation.rst
+   installation/index.rst
    handbook/index.rst
    reference/index.rst
    porting.rst
diff --git a/docs/installation.rst b/docs/installation.rst
deleted file mode 100644
index 980bbd99def..00000000000
--- a/docs/installation.rst
+++ /dev/null
@@ -1,597 +0,0 @@
-Installation
-============
-
-.. raw:: html
-
-    <script>
-    document.addEventListener('DOMContentLoaded', function() {
-      activateTab(getOS());
-    });
-    </script>
-
-Python Support
---------------
-
-Pillow supports these Python versions.
-
-.. csv-table:: Newer versions
-   :file: newer-versions.csv
-   :header-rows: 1
-
-.. csv-table:: Older versions
-   :file: older-versions.csv
-   :header-rows: 1
-
-.. _Linux Installation:
-.. _macOS Installation:
-.. _Windows Installation:
-.. _FreeBSD Installation:
-
-Basic Installation
-------------------
-
-.. note::
-
-    The following instructions will install Pillow with support for
-    most common image formats. See :ref:`external-libraries` for a
-    full list of external libraries supported.
-
-Install Pillow with :command:`pip`::
-
-    python3 -m pip install --upgrade pip
-    python3 -m pip install --upgrade Pillow
-
-Optionally, install :pypi:`defusedxml` for Pillow to read XMP data,
-and :pypi:`olefile` for Pillow to read FPX and MIC images::
-
-    python3 -m pip install --upgrade defusedxml olefile
-
-
-.. tab:: Linux
-
-    We provide binaries for Linux for each of the supported Python
-    versions in the manylinux wheel format. These include support for all
-    optional libraries except libimagequant. Raqm support requires
-    FriBiDi to be installed separately::
-
-        python3 -m pip install --upgrade pip
-        python3 -m pip install --upgrade Pillow
-
-    Most major Linux distributions, including Fedora, Ubuntu and ArchLinux
-    also include Pillow in packages that previously contained PIL e.g.
-    ``python-imaging``. Debian splits it into two packages, ``python3-pil``
-    and ``python3-pil.imagetk``.
-
-.. tab:: macOS
-
-    We provide binaries for macOS for each of the supported Python
-    versions in the wheel format. These include support for all optional
-    libraries except libimagequant. Raqm support requires
-    FriBiDi to be installed separately::
-
-        python3 -m pip install --upgrade pip
-        python3 -m pip install --upgrade Pillow
-
-    While we provide binaries for both x86-64 and arm64, we do not provide universal2
-    binaries. However, it is simple to combine our current binaries to create one::
-
-        python3 -m pip download --only-binary=:all: --platform macosx_10_10_x86_64 Pillow
-        python3 -m pip download --only-binary=:all: --platform macosx_11_0_arm64 Pillow
-        python3 -m pip install delocate
-
-    Then, with the names of the downloaded wheels, use Python to combine them::
-
-        from delocate.fuse import fuse_wheels
-        fuse_wheels('Pillow-9.4.0-2-cp39-cp39-macosx_10_10_x86_64.whl', 'Pillow-9.4.0-cp39-cp39-macosx_11_0_arm64.whl', 'Pillow-9.4.0-cp39-cp39-macosx_11_0_universal2.whl')
-
-.. tab:: Windows
-
-    We provide Pillow binaries for Windows compiled for the matrix of supported
-    Pythons in the wheel format. These include x86, x86-64 and arm64 versions
-    (with the exception of Python 3.8 on arm64). These binaries include support
-    for all optional libraries except libimagequant and libxcb. Raqm support
-    requires FriBiDi to be installed separately::
-
-        python3 -m pip install --upgrade pip
-        python3 -m pip install --upgrade Pillow
-
-    To install Pillow in MSYS2, see `Building on Windows using MSYS2/MinGW`_.
-
-.. tab:: FreeBSD
-
-    Pillow can be installed on FreeBSD via the official Ports or Packages systems:
-
-    **Ports**::
-
-        cd /usr/ports/graphics/py-pillow && make install clean
-
-    **Packages**::
-
-        pkg install py38-pillow
-
-    .. note::
-
-        The `Pillow FreeBSD port
-        <https://www.freshports.org/graphics/py-pillow/>`_ and packages
-        are tested by the ports team with all supported FreeBSD versions.
-
-
-.. _Building on Linux:
-.. _Building on macOS:
-.. _Building on Windows:
-.. _Building on Windows using MSYS2/MinGW:
-.. _Building on FreeBSD:
-.. _Building on Android:
-
-Building From Source
---------------------
-
-.. _external-libraries:
-
-External Libraries
-^^^^^^^^^^^^^^^^^^
-
-.. note::
-
-    You **do not need to install all supported external libraries** to
-    use Pillow's basic features. **Zlib** and **libjpeg** are required
-    by default.
-
-.. note::
-
-   There are Dockerfiles in our `Docker images repo
-   <https://github.com/python-pillow/docker-images>`_ to install the
-   dependencies for some operating systems.
-
-Many of Pillow's features require external libraries:
-
-* **libjpeg** provides JPEG functionality.
-
-  * Pillow has been tested with libjpeg versions **6b**, **8**, **9-9d** and
-    libjpeg-turbo version **8**.
-  * Starting with Pillow 3.0.0, libjpeg is required by default. It can be
-    disabled with the ``-C jpeg=disable`` flag.
-
-* **zlib** provides access to compressed PNGs
-
-  * Starting with Pillow 3.0.0, zlib is required by default. It can be
-    disabled with the ``-C zlib=disable`` flag.
-
-* **libtiff** provides compressed TIFF functionality
-
-  * Pillow has been tested with libtiff versions **3.x** and **4.0-4.6.0**
-
-* **libfreetype** provides type related services
-
-* **littlecms** provides color management
-
-  * Pillow version 2.2.1 and below uses liblcms1, Pillow 2.3.0 and
-    above uses liblcms2. Tested with **1.19** and **2.7-2.16**.
-
-* **libwebp** provides the WebP format.
-
-  * Pillow has been tested with version **0.1.3**, which does not read
-    transparent WebP files. Versions **0.3.0** and above support
-    transparency.
-
-* **openjpeg** provides JPEG 2000 functionality.
-
-  * Pillow has been tested with openjpeg **2.0.0**, **2.1.0**, **2.3.1**,
-    **2.4.0** and **2.5.0**.
-  * Pillow does **not** support the earlier **1.5** series which ships
-    with Debian Jessie.
-
-* **libimagequant** provides improved color quantization
-
-  * Pillow has been tested with libimagequant **2.6-4.2.2**
-  * Libimagequant is licensed GPLv3, which is more restrictive than
-    the Pillow license, therefore we will not be distributing binaries
-    with libimagequant support enabled.
-
-* **libraqm** provides complex text layout support.
-
-  * libraqm provides bidirectional text support (using FriBiDi),
-    shaping (using HarfBuzz), and proper script itemization. As a
-    result, Raqm can support most writing systems covered by Unicode.
-  * libraqm depends on the following libraries: FreeType, HarfBuzz,
-    FriBiDi, make sure that you install them before installing libraqm
-    if not available as package in your system.
-  * Setting text direction or font features is not supported without libraqm.
-  * Pillow wheels since version 8.2.0 include a modified version of libraqm that
-    loads libfribidi at runtime if it is installed.
-    On Windows this requires compiling FriBiDi and installing ``fribidi.dll``
-    into a directory listed in the `Dynamic-link library search order (Microsoft Learn)
-    <https://learn.microsoft.com/en-us/windows/win32/dlls/dynamic-link-library-search-order#search-order-for-unpackaged-apps>`_
-    (``fribidi-0.dll`` or ``libfribidi-0.dll`` are also detected).
-    See `Build Options`_ to see how to build this version.
-  * Previous versions of Pillow (5.0.0 to 8.1.2) linked libraqm dynamically at runtime.
-
-* **libxcb** provides X11 screengrab support.
-
-.. tab:: Linux
-
-    If you didn't build Python from source, make sure you have Python's
-    development libraries installed.
-
-    In Debian or Ubuntu::
-
-        sudo apt-get install python3-dev python3-setuptools
-
-    In Fedora, the command is::
-
-        sudo dnf install python3-devel redhat-rpm-config
-
-    In Alpine, the command is::
-
-        sudo apk add python3-dev py3-setuptools
-
-    .. Note:: ``redhat-rpm-config`` is required on Fedora 23, but not earlier versions.
-
-    Prerequisites for **Ubuntu 16.04 LTS - 22.04 LTS** are installed with::
-
-        sudo apt-get install libtiff5-dev libjpeg8-dev libopenjp2-7-dev zlib1g-dev \
-            libfreetype6-dev liblcms2-dev libwebp-dev tcl8.6-dev tk8.6-dev python3-tk \
-            libharfbuzz-dev libfribidi-dev libxcb1-dev
-
-    To install libraqm, ``sudo apt-get install meson`` and then see
-    ``depends/install_raqm.sh``.
-
-    Prerequisites are installed on recent **Red Hat**, **CentOS** or **Fedora** with::
-
-        sudo dnf install libtiff-devel libjpeg-devel openjpeg2-devel zlib-devel \
-            freetype-devel lcms2-devel libwebp-devel tcl-devel tk-devel \
-            harfbuzz-devel fribidi-devel libraqm-devel libimagequant-devel libxcb-devel
-
-    Note that the package manager may be yum or DNF, depending on the
-    exact distribution.
-
-    Prerequisites are installed for **Alpine** with::
-
-        sudo apk add tiff-dev jpeg-dev openjpeg-dev zlib-dev freetype-dev lcms2-dev \
-            libwebp-dev tcl-dev tk-dev harfbuzz-dev fribidi-dev libimagequant-dev \
-            libxcb-dev libpng-dev
-
-    See also the ``Dockerfile``\s in the Test Infrastructure repo
-    (https://github.com/python-pillow/docker-images) for a known working
-    install process for other tested distros.
-
-.. tab:: macOS
-
-    The Xcode command line tools are required to compile portions of
-    Pillow. The tools are installed by running ``xcode-select --install``
-    from the command line. The command line tools are required even if you
-    have the full Xcode package installed.  It may be necessary to run
-    ``sudo xcodebuild -license`` to accept the license prior to using the
-    tools.
-
-    The easiest way to install external libraries is via `Homebrew
-    <https://brew.sh/>`_. After you install Homebrew, run::
-
-        brew install libjpeg libtiff little-cms2 openjpeg webp
-
-    To install libraqm on macOS use Homebrew to install its dependencies::
-
-        brew install freetype harfbuzz fribidi
-
-    Then see ``depends/install_raqm_cmake.sh`` to install libraqm.
-
-.. tab:: Windows
-
-    We recommend you use prebuilt wheels from PyPI.
-    If you wish to compile Pillow manually, you can use the build scripts
-    in the ``winbuild`` directory used for CI testing and development.
-    These scripts require Visual Studio 2017 or newer and NASM.
-
-    The scripts also install Pillow from the local copy of the source code, so the
-    `Installing`_ instructions will not be necessary afterwards.
-
-.. tab:: Windows using MSYS2/MinGW
-
-    To build Pillow using MSYS2, make sure you run the **MSYS2 MinGW 32-bit** or
-    **MSYS2 MinGW 64-bit** console, *not* **MSYS2** directly.
-
-    The following instructions target the 64-bit build, for 32-bit
-    replace all occurrences of ``mingw-w64-x86_64-`` with ``mingw-w64-i686-``.
-
-    Make sure you have Python and GCC installed::
-
-        pacman -S \
-            mingw-w64-x86_64-gcc \
-            mingw-w64-x86_64-python3 \
-            mingw-w64-x86_64-python3-pip \
-            mingw-w64-x86_64-python3-setuptools
-
-    Prerequisites are installed on **MSYS2 MinGW 64-bit** with::
-
-        pacman -S \
-            mingw-w64-x86_64-libjpeg-turbo \
-            mingw-w64-x86_64-zlib \
-            mingw-w64-x86_64-libtiff \
-            mingw-w64-x86_64-freetype \
-            mingw-w64-x86_64-lcms2 \
-            mingw-w64-x86_64-libwebp \
-            mingw-w64-x86_64-openjpeg2 \
-            mingw-w64-x86_64-libimagequant \
-            mingw-w64-x86_64-libraqm
-
-    https://www.msys2.org/docs/python/ states that setuptools >= 60 does not work with
-    MSYS2. To workaround this, before installing Pillow you must run::
-
-        export SETUPTOOLS_USE_DISTUTILS=stdlib
-
-.. tab:: FreeBSD
-
-    .. Note:: Only FreeBSD 10 and 11 tested
-
-    Make sure you have Python's development libraries installed::
-
-        sudo pkg install python3
-
-    Prerequisites are installed on **FreeBSD 10 or 11** with::
-
-        sudo pkg install jpeg-turbo tiff webp lcms2 freetype2 openjpeg harfbuzz fribidi libxcb
-
-    Then see ``depends/install_raqm_cmake.sh`` to install libraqm.
-
-.. tab:: Android
-
-    Basic Android support has been added for compilation within the Termux
-    environment. The dependencies can be installed by::
-
-        pkg install -y python ndk-sysroot clang make \
-            libjpeg-turbo
-
-    This has been tested within the Termux app on ChromeOS, on x86.
-
-Installing
-^^^^^^^^^^
-
-Once you have installed the prerequisites, to install Pillow from the source
-code on PyPI, run::
-
-    python3 -m pip install --upgrade pip
-    python3 -m pip install --upgrade Pillow --no-binary :all:
-
-If the prerequisites are installed in the standard library locations
-for your machine (e.g. :file:`/usr` or :file:`/usr/local`), no
-additional configuration should be required. If they are installed in
-a non-standard location, you may need to configure setuptools to use
-those locations by editing :file:`setup.py` or
-:file:`pyproject.toml`, or by adding environment variables on the command
-line::
-
-    CFLAGS="-I/usr/pkg/include" python3 -m pip install --upgrade Pillow --no-binary :all:
-
-If Pillow has been previously built without the required
-prerequisites, it may be necessary to manually clear the pip cache or
-build without cache using the ``--no-cache-dir`` option to force a
-build with newly installed external libraries.
-
-If you would like to install from a local copy of the source code instead, you
-can clone from GitHub with ``git clone https://github.com/python-pillow/Pillow``
-or download and extract the `compressed archive from PyPI`_.
-
-After navigating to the Pillow directory, run::
-
-    python3 -m pip install --upgrade pip
-    python3 -m pip install .
-
-.. _compressed archive from PyPI: https://pypi.org/project/pillow/#files
-
-Build Options
-"""""""""""""
-
-* Environment variable: ``MAX_CONCURRENCY=n``. Pillow can use
-  multiprocessing to build the extension. Setting ``MAX_CONCURRENCY``
-  sets the number of CPUs to use, or can disable parallel building by
-  using a setting of 1. By default, it uses 4 CPUs, or if 4 are not
-  available, as many as are present.
-
-* Config settings: ``-C zlib=disable``, ``-C jpeg=disable``,
-  ``-C tiff=disable``, ``-C freetype=disable``, ``-C raqm=disable``,
-  ``-C lcms=disable``, ``-C webp=disable``, ``-C webpmux=disable``,
-  ``-C jpeg2000=disable``, ``-C imagequant=disable``, ``-C xcb=disable``.
-  Disable building the corresponding feature even if the development
-  libraries are present on the building machine.
-
-* Config settings: ``-C zlib=enable``, ``-C jpeg=enable``,
-  ``-C tiff=enable``, ``-C freetype=enable``, ``-C raqm=enable``,
-  ``-C lcms=enable``, ``-C webp=enable``, ``-C webpmux=enable``,
-  ``-C jpeg2000=enable``, ``-C imagequant=enable``, ``-C xcb=enable``.
-  Require that the corresponding feature is built. The build will raise
-  an exception if the libraries are not found. Webpmux (WebP metadata)
-  relies on WebP support. Tcl and Tk also must be used together.
-
-* Config settings: ``-C raqm=vendor``, ``-C fribidi=vendor``.
-  These flags are used to compile a modified version of libraqm and
-  a shim that dynamically loads libfribidi at runtime. These are
-  used to compile the standard Pillow wheels. Compiling libraqm requires
-  a C99-compliant compiler.
-
-* Build flag: ``-C platform-guessing=disable``. Skips all of the
-  platform dependent guessing of include and library directories for
-  automated build systems that configure the proper paths in the
-  environment variables (e.g. Buildroot).
-
-* Build flag: ``-C debug=true``. Adds a debugging flag to the include and
-  library search process to dump all paths searched for and found to
-  stdout.
-
-
-Sample usage::
-
-    python3 -m pip install --upgrade Pillow -C [feature]=enable
-
-Platform Support
-----------------
-
-Current platform support for Pillow. Binary distributions are
-contributed for each release on a volunteer basis, but the source
-should compile and run everywhere platform support is listed. In
-general, we aim to support all current versions of Linux, macOS, and
-Windows.
-
-Continuous Integration Targets
-^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
-
-These platforms are built and tested for every change.
-
-+----------------------------------+----------------------------+---------------------+
-| Operating system                 | Tested Python versions     | Tested architecture |
-+==================================+============================+=====================+
-| Alpine                           | 3.9                        | x86-64              |
-+----------------------------------+----------------------------+---------------------+
-| Amazon Linux 2                   | 3.9                        | x86-64              |
-+----------------------------------+----------------------------+---------------------+
-| Amazon Linux 2023                | 3.9                        | x86-64              |
-+----------------------------------+----------------------------+---------------------+
-| Arch                             | 3.9                        | x86-64              |
-+----------------------------------+----------------------------+---------------------+
-| CentOS 7                         | 3.9                        | x86-64              |
-+----------------------------------+----------------------------+---------------------+
-| CentOS Stream 8                  | 3.9                        | x86-64              |
-+----------------------------------+----------------------------+---------------------+
-| CentOS Stream 9                  | 3.9                        | x86-64              |
-+----------------------------------+----------------------------+---------------------+
-| Debian 11 Bullseye               | 3.9                        | x86-64              |
-+----------------------------------+----------------------------+---------------------+
-| Debian 12 Bookworm               | 3.11                       | x86, x86-64         |
-+----------------------------------+----------------------------+---------------------+
-| Fedora 38                        | 3.11                       | x86-64              |
-+----------------------------------+----------------------------+---------------------+
-| Fedora 39                        | 3.12                       | x86-64              |
-+----------------------------------+----------------------------+---------------------+
-| Gentoo                           | 3.9                        | x86-64              |
-+----------------------------------+----------------------------+---------------------+
-| macOS 12 Monterey                | 3.8, 3.9, 3.10, 3.11,      | x86-64              |
-|                                  | 3.12, PyPy3                |                     |
-+----------------------------------+----------------------------+---------------------+
-| Ubuntu Linux 20.04 LTS (Focal)   | 3.8                        | x86-64              |
-+----------------------------------+----------------------------+---------------------+
-| Ubuntu Linux 22.04 LTS (Jammy)   | 3.8, 3.9, 3.10, 3.11,      | x86-64              |
-|                                  | 3.12, PyPy3                |                     |
-|                                  +----------------------------+---------------------+
-|                                  | 3.10                       | arm64v8, ppc64le,   |
-|                                  |                            | s390x               |
-+----------------------------------+----------------------------+---------------------+
-| Windows Server 2016              | 3.8                        | x86-64              |
-+----------------------------------+----------------------------+---------------------+
-| Windows Server 2022              | 3.8, 3.9, 3.10, 3.11,      | x86-64              |
-|                                  | 3.12, PyPy3                |                     |
-|                                  +----------------------------+---------------------+
-|                                  | 3.12                       | x86                 |
-|                                  +----------------------------+---------------------+
-|                                  | 3.9 (MinGW)                | x86-64              |
-|                                  +----------------------------+---------------------+
-|                                  | 3.8, 3.9 (Cygwin)          | x86-64              |
-+----------------------------------+----------------------------+---------------------+
-
-
-Other Platforms
-^^^^^^^^^^^^^^^
-
-These platforms have been reported to work at the versions mentioned.
-
-.. note::
-
-    Contributors please test Pillow on your platform then update this
-    document and send a pull request.
-
-+----------------------------------+----------------------------+------------------+--------------+
-| Operating system                 | | Tested Python            | | Latest tested  | | Tested     |
-|                                  | | versions                 | | Pillow version | | processors |
-+==================================+============================+==================+==============+
-| macOS 14 Sonoma                  | 3.8, 3.9, 3.10, 3.11, 3.12 | 10.2.0           |arm           |
-+----------------------------------+----------------------------+------------------+--------------+
-| macOS 13 Ventura                 | 3.8, 3.9, 3.10, 3.11       | 10.0.1           |arm           |
-|                                  +----------------------------+------------------+              |
-|                                  | 3.7                        | 9.5.0            |              |
-+----------------------------------+----------------------------+------------------+--------------+
-| macOS 12 Monterey                | 3.7, 3.8, 3.9, 3.10, 3.11  | 9.3.0            |arm           |
-+----------------------------------+----------------------------+------------------+--------------+
-| macOS 11 Big Sur                 | 3.7, 3.8, 3.9, 3.10        | 8.4.0            |arm           |
-|                                  +----------------------------+------------------+--------------+
-|                                  | 3.7, 3.8, 3.9, 3.10, 3.11  | 9.4.0            |x86-64        |
-|                                  +----------------------------+------------------+              |
-|                                  | 3.6                        | 8.4.0            |              |
-+----------------------------------+----------------------------+------------------+--------------+
-| macOS 10.15 Catalina             | 3.6, 3.7, 3.8, 3.9         | 8.3.2            |x86-64        |
-|                                  +----------------------------+------------------+              |
-|                                  | 3.5                        | 7.2.0            |              |
-+----------------------------------+----------------------------+------------------+--------------+
-| macOS 10.14 Mojave               | 3.5, 3.6, 3.7, 3.8         | 7.2.0            |x86-64        |
-|                                  +----------------------------+------------------+              |
-|                                  | 2.7                        | 6.0.0            |              |
-|                                  +----------------------------+------------------+              |
-|                                  | 3.4                        | 5.4.1            |              |
-+----------------------------------+----------------------------+------------------+--------------+
-| macOS 10.13 High Sierra          | 2.7, 3.4, 3.5, 3.6         | 4.2.1            |x86-64        |
-+----------------------------------+----------------------------+------------------+--------------+
-| macOS 10.12 Sierra               | 2.7, 3.4, 3.5, 3.6         | 4.1.1            |x86-64        |
-+----------------------------------+----------------------------+------------------+--------------+
-| Mac OS X 10.11 El Capitan        | 2.7, 3.4, 3.5, 3.6, 3.7    | 5.4.1            |x86-64        |
-|                                  +----------------------------+------------------+              |
-|                                  | 3.3                        | 4.1.0            |              |
-+----------------------------------+----------------------------+------------------+--------------+
-| Mac OS X 10.9 Mavericks          | 2.7, 3.2, 3.3, 3.4         | 3.0.0            |x86-64        |
-+----------------------------------+----------------------------+------------------+--------------+
-| Mac OS X 10.8 Mountain Lion      | 2.6, 2.7, 3.2, 3.3         |                  |x86-64        |
-+----------------------------------+----------------------------+------------------+--------------+
-| Redhat Linux 6                   | 2.6                        |                  |x86           |
-+----------------------------------+----------------------------+------------------+--------------+
-| CentOS 6.3                       | 2.7, 3.3                   |                  |x86           |
-+----------------------------------+----------------------------+------------------+--------------+
-| CentOS 8                         | 3.9                        | 9.0.0            |x86-64        |
-+----------------------------------+----------------------------+------------------+--------------+
-| Fedora 23                        | 2.7, 3.4                   | 3.1.0            |x86-64        |
-+----------------------------------+----------------------------+------------------+--------------+
-| Ubuntu Linux 12.04 LTS (Precise) | | 2.6, 3.2, 3.3, 3.4, 3.5  | 3.4.1            |x86,x86-64    |
-|                                  | | PyPy5.3.1, PyPy3 v2.4.0  |                  |              |
-|                                  +----------------------------+------------------+--------------+
-|                                  | 2.7                        | 4.3.0            |x86-64        |
-|                                  +----------------------------+------------------+--------------+
-|                                  | 2.7, 3.2                   | 3.4.1            |ppc           |
-+----------------------------------+----------------------------+------------------+--------------+
-| Ubuntu Linux 10.04 LTS (Lucid)   | 2.6                        | 2.3.0            |x86,x86-64    |
-+----------------------------------+----------------------------+------------------+--------------+
-| Debian 8.2 Jessie                | 2.7, 3.4                   | 3.1.0            |x86-64        |
-+----------------------------------+----------------------------+------------------+--------------+
-| Raspbian Jessie                  | 2.7, 3.4                   | 3.1.0            |arm           |
-+----------------------------------+----------------------------+------------------+--------------+
-| Raspbian Stretch                 | 2.7, 3.5                   | 4.0.0            |arm           |
-+----------------------------------+----------------------------+------------------+--------------+
-| Raspberry Pi OS                  | 3.6, 3.7, 3.8, 3.9         | 8.2.0            |arm           |
-|                                  +----------------------------+------------------+              |
-|                                  | 2.7                        | 6.2.2            |              |
-+----------------------------------+----------------------------+------------------+--------------+
-| Gentoo Linux                     | 2.7, 3.2                   | 2.1.0            |x86-64        |
-+----------------------------------+----------------------------+------------------+--------------+
-| FreeBSD 11.1                     | 2.7, 3.4, 3.5, 3.6         | 4.3.0            |x86-64        |
-+----------------------------------+----------------------------+------------------+--------------+
-| FreeBSD 10.3                     | 2.7, 3.4, 3.5              | 4.2.0            |x86-64        |
-+----------------------------------+----------------------------+------------------+--------------+
-| FreeBSD 10.2                     | 2.7, 3.4                   | 3.1.0            |x86-64        |
-+----------------------------------+----------------------------+------------------+--------------+
-| Windows 11                       | 3.9, 3.10, 3.11, 3.12      | 10.2.0           |arm64         |
-+----------------------------------+----------------------------+------------------+--------------+
-| Windows 11 Pro                   | 3.11, 3.12                 | 10.2.0           |x86-64        |
-+----------------------------------+----------------------------+------------------+--------------+
-| Windows 10                       | 3.7                        | 7.1.0            |x86-64        |
-+----------------------------------+----------------------------+------------------+--------------+
-| Windows 10/Cygwin 3.3            | 3.6, 3.7, 3.8, 3.9         | 8.4.0            |x86-64        |
-+----------------------------------+----------------------------+------------------+--------------+
-| Windows 8.1 Pro                  | 2.6, 2.7, 3.2, 3.3, 3.4    | 2.4.0            |x86,x86-64    |
-+----------------------------------+----------------------------+------------------+--------------+
-| Windows 8 Pro                    | 2.6, 2.7, 3.2, 3.3, 3.4a3  | 2.2.0            |x86,x86-64    |
-+----------------------------------+----------------------------+------------------+--------------+
-| Windows 7 Professional           | 3.7                        | 7.0.0            |x86,x86-64    |
-+----------------------------------+----------------------------+------------------+--------------+
-| Windows Server 2008 R2 Enterprise| 3.3                        |                  |x86-64        |
-+----------------------------------+----------------------------+------------------+--------------+
-
-Old Versions
-------------
-
-You can download old distributions from the `release history at PyPI
-<https://pypi.org/project/pillow/#history>`_ and by direct URL access
-eg. https://pypi.org/project/pillow/1.0/.
diff --git a/docs/installation/basic-installation.rst b/docs/installation/basic-installation.rst
new file mode 100644
index 00000000000..ff05e7f586d
--- /dev/null
+++ b/docs/installation/basic-installation.rst
@@ -0,0 +1,95 @@
+Basic Installation
+------------------
+
+.. note::
+
+    The following instructions will install Pillow with support for
+    most common image formats. See :ref:`external-libraries` for a
+    full list of external libraries supported.
+
+Install Pillow with :command:`pip`::
+
+    python3 -m pip install --upgrade pip
+    python3 -m pip install --upgrade Pillow
+
+Optionally, install :pypi:`defusedxml` for Pillow to read XMP data,
+and :pypi:`olefile` for Pillow to read FPX and MIC images::
+
+    python3 -m pip install --upgrade defusedxml olefile
+
+
+.. tab:: Linux
+
+    We provide binaries for Linux for each of the supported Python
+    versions in the manylinux wheel format. These include support for all
+    optional libraries except libimagequant. Raqm support requires
+    FriBiDi to be installed separately::
+
+        python3 -m pip install --upgrade pip
+        python3 -m pip install --upgrade Pillow
+
+    Most major Linux distributions, including Fedora, Ubuntu and ArchLinux
+    also include Pillow in packages that previously contained PIL e.g.
+    ``python-imaging``. Debian splits it into two packages, ``python3-pil``
+    and ``python3-pil.imagetk``.
+
+.. tab:: macOS
+
+    We provide binaries for macOS for each of the supported Python
+    versions in the wheel format. These include support for all optional
+    libraries except libimagequant. Raqm support requires
+    FriBiDi to be installed separately::
+
+        python3 -m pip install --upgrade pip
+        python3 -m pip install --upgrade Pillow
+
+    While we provide binaries for both x86-64 and arm64, we do not provide universal2
+    binaries. However, it is simple to combine our current binaries to create one::
+
+        python3 -m pip download --only-binary=:all: --platform macosx_10_10_x86_64 Pillow
+        python3 -m pip download --only-binary=:all: --platform macosx_11_0_arm64 Pillow
+        python3 -m pip install delocate
+
+    Then, with the names of the downloaded wheels, use Python to combine them::
+
+        from delocate.fuse import fuse_wheels
+        fuse_wheels('Pillow-9.4.0-2-cp39-cp39-macosx_10_10_x86_64.whl', 'Pillow-9.4.0-cp39-cp39-macosx_11_0_arm64.whl', 'Pillow-9.4.0-cp39-cp39-macosx_11_0_universal2.whl')
+
+.. tab:: Windows
+
+    We provide Pillow binaries for Windows compiled for the matrix of supported
+    Pythons in the wheel format. These include x86, x86-64 and arm64 versions
+    (with the exception of Python 3.8 on arm64). These binaries include support
+    for all optional libraries except libimagequant and libxcb. Raqm support
+    requires FriBiDi to be installed separately::
+
+        python3 -m pip install --upgrade pip
+        python3 -m pip install --upgrade Pillow
+
+    To install Pillow in MSYS2, see `Building on Windows using MSYS2/MinGW`_.
+
+.. tab:: FreeBSD
+
+    Pillow can be installed on FreeBSD via the official Ports or Packages systems:
+
+    **Ports**::
+
+        cd /usr/ports/graphics/py-pillow && make install clean
+
+    **Packages**::
+
+        pkg install py38-pillow
+
+    .. note::
+
+        The `Pillow FreeBSD port
+        <https://www.freshports.org/graphics/py-pillow/>`_ and packages
+        are tested by the ports team with all supported FreeBSD versions.
+
+
+.. _Building on Linux:
+.. _Building on macOS:
+.. _Building on Windows:
+.. _Building on Windows using MSYS2/MinGW:
+.. _Building on FreeBSD:
+.. _Building on Android:
diff --git a/docs/installation/building-from-source.rst b/docs/installation/building-from-source.rst
new file mode 100644
index 00000000000..051d51c225d
--- /dev/null
+++ b/docs/installation/building-from-source.rst
@@ -0,0 +1,298 @@
+Building From Source
+--------------------
+
+.. _external-libraries:
+
+External Libraries
+^^^^^^^^^^^^^^^^^^
+
+.. note::
+
+    You **do not need to install all supported external libraries** to
+    use Pillow's basic features. **Zlib** and **libjpeg** are required
+    by default.
+
+.. note::
+
+   There are Dockerfiles in our `Docker images repo
+   <https://github.com/python-pillow/docker-images>`_ to install the
+   dependencies for some operating systems.
+
+Many of Pillow's features require external libraries:
+
+* **libjpeg** provides JPEG functionality.
+
+  * Pillow has been tested with libjpeg versions **6b**, **8**, **9-9d** and
+    libjpeg-turbo version **8**.
+  * Starting with Pillow 3.0.0, libjpeg is required by default. It can be
+    disabled with the ``-C jpeg=disable`` flag.
+
+* **zlib** provides access to compressed PNGs
+
+  * Starting with Pillow 3.0.0, zlib is required by default. It can be
+    disabled with the ``-C zlib=disable`` flag.
+
+* **libtiff** provides compressed TIFF functionality
+
+  * Pillow has been tested with libtiff versions **3.x** and **4.0-4.6.0**
+
+* **libfreetype** provides type related services
+
+* **littlecms** provides color management
+
+  * Pillow version 2.2.1 and below uses liblcms1, Pillow 2.3.0 and
+    above uses liblcms2. Tested with **1.19** and **2.7-2.16**.
+
+* **libwebp** provides the WebP format.
+
+  * Pillow has been tested with version **0.1.3**, which does not read
+    transparent WebP files. Versions **0.3.0** and above support
+    transparency.
+
+* **openjpeg** provides JPEG 2000 functionality.
+
+  * Pillow has been tested with openjpeg **2.0.0**, **2.1.0**, **2.3.1**,
+    **2.4.0** and **2.5.0**.
+  * Pillow does **not** support the earlier **1.5** series which ships
+    with Debian Jessie.
+
+* **libimagequant** provides improved color quantization
+
+  * Pillow has been tested with libimagequant **2.6-4.2.2**
+  * Libimagequant is licensed GPLv3, which is more restrictive than
+    the Pillow license, therefore we will not be distributing binaries
+    with libimagequant support enabled.
+
+* **libraqm** provides complex text layout support.
+
+  * libraqm provides bidirectional text support (using FriBiDi),
+    shaping (using HarfBuzz), and proper script itemization. As a
+    result, Raqm can support most writing systems covered by Unicode.
+  * libraqm depends on the following libraries: FreeType, HarfBuzz,
+    FriBiDi, make sure that you install them before installing libraqm
+    if not available as package in your system.
+  * Setting text direction or font features is not supported without libraqm.
+  * Pillow wheels since version 8.2.0 include a modified version of libraqm that
+    loads libfribidi at runtime if it is installed.
+    On Windows this requires compiling FriBiDi and installing ``fribidi.dll``
+    into a directory listed in the `Dynamic-link library search order (Microsoft Learn)
+    <https://learn.microsoft.com/en-us/windows/win32/dlls/dynamic-link-library-search-order#search-order-for-unpackaged-apps>`_
+    (``fribidi-0.dll`` or ``libfribidi-0.dll`` are also detected).
+    See `Build Options`_ to see how to build this version.
+  * Previous versions of Pillow (5.0.0 to 8.1.2) linked libraqm dynamically at runtime.
+
+* **libxcb** provides X11 screengrab support.
+
+.. tab:: Linux
+
+    If you didn't build Python from source, make sure you have Python's
+    development libraries installed.
+
+    In Debian or Ubuntu::
+
+        sudo apt-get install python3-dev python3-setuptools
+
+    In Fedora, the command is::
+
+        sudo dnf install python3-devel redhat-rpm-config
+
+    In Alpine, the command is::
+
+        sudo apk add python3-dev py3-setuptools
+
+    .. Note:: ``redhat-rpm-config`` is required on Fedora 23, but not earlier versions.
+
+    Prerequisites for **Ubuntu 16.04 LTS - 22.04 LTS** are installed with::
+
+        sudo apt-get install libtiff5-dev libjpeg8-dev libopenjp2-7-dev zlib1g-dev \
+            libfreetype6-dev liblcms2-dev libwebp-dev tcl8.6-dev tk8.6-dev python3-tk \
+            libharfbuzz-dev libfribidi-dev libxcb1-dev
+
+    To install libraqm, ``sudo apt-get install meson`` and then see
+    ``depends/install_raqm.sh``.
+
+    Prerequisites are installed on recent **Red Hat**, **CentOS** or **Fedora** with::
+
+        sudo dnf install libtiff-devel libjpeg-devel openjpeg2-devel zlib-devel \
+            freetype-devel lcms2-devel libwebp-devel tcl-devel tk-devel \
+            harfbuzz-devel fribidi-devel libraqm-devel libimagequant-devel libxcb-devel
+
+    Note that the package manager may be yum or DNF, depending on the
+    exact distribution.
+
+    Prerequisites are installed for **Alpine** with::
+
+        sudo apk add tiff-dev jpeg-dev openjpeg-dev zlib-dev freetype-dev lcms2-dev \
+            libwebp-dev tcl-dev tk-dev harfbuzz-dev fribidi-dev libimagequant-dev \
+            libxcb-dev libpng-dev
+
+    See also the ``Dockerfile``\s in the Test Infrastructure repo
+    (https://github.com/python-pillow/docker-images) for a known working
+    install process for other tested distros.
+
+.. tab:: macOS
+
+    The Xcode command line tools are required to compile portions of
+    Pillow. The tools are installed by running ``xcode-select --install``
+    from the command line. The command line tools are required even if you
+    have the full Xcode package installed.  It may be necessary to run
+    ``sudo xcodebuild -license`` to accept the license prior to using the
+    tools.
+
+    The easiest way to install external libraries is via `Homebrew
+    <https://brew.sh/>`_. After you install Homebrew, run::
+
+        brew install libjpeg libtiff little-cms2 openjpeg webp
+
+    To install libraqm on macOS use Homebrew to install its dependencies::
+
+        brew install freetype harfbuzz fribidi
+
+    Then see ``depends/install_raqm_cmake.sh`` to install libraqm.
+
+.. tab:: Windows
+
+    We recommend you use prebuilt wheels from PyPI.
+    If you wish to compile Pillow manually, you can use the build scripts
+    in the ``winbuild`` directory used for CI testing and development.
+    These scripts require Visual Studio 2017 or newer and NASM.
+
+    The scripts also install Pillow from the local copy of the source code, so the
+    `Installing`_ instructions will not be necessary afterwards.
+
+.. tab:: Windows using MSYS2/MinGW
+
+    To build Pillow using MSYS2, make sure you run the **MSYS2 MinGW 32-bit** or
+    **MSYS2 MinGW 64-bit** console, *not* **MSYS2** directly.
+
+    The following instructions target the 64-bit build, for 32-bit
+    replace all occurrences of ``mingw-w64-x86_64-`` with ``mingw-w64-i686-``.
+
+    Make sure you have Python and GCC installed::
+
+        pacman -S \
+            mingw-w64-x86_64-gcc \
+            mingw-w64-x86_64-python3 \
+            mingw-w64-x86_64-python3-pip \
+            mingw-w64-x86_64-python3-setuptools
+
+    Prerequisites are installed on **MSYS2 MinGW 64-bit** with::
+
+        pacman -S \
+            mingw-w64-x86_64-libjpeg-turbo \
+            mingw-w64-x86_64-zlib \
+            mingw-w64-x86_64-libtiff \
+            mingw-w64-x86_64-freetype \
+            mingw-w64-x86_64-lcms2 \
+            mingw-w64-x86_64-libwebp \
+            mingw-w64-x86_64-openjpeg2 \
+            mingw-w64-x86_64-libimagequant \
+            mingw-w64-x86_64-libraqm
+
+    https://www.msys2.org/docs/python/ states that setuptools >= 60 does not work with
+    MSYS2. To workaround this, before installing Pillow you must run::
+
+        export SETUPTOOLS_USE_DISTUTILS=stdlib
+
+.. tab:: FreeBSD
+
+    .. Note:: Only FreeBSD 10 and 11 tested
+
+    Make sure you have Python's development libraries installed::
+
+        sudo pkg install python3
+
+    Prerequisites are installed on **FreeBSD 10 or 11** with::
+
+        sudo pkg install jpeg-turbo tiff webp lcms2 freetype2 openjpeg harfbuzz fribidi libxcb
+
+    Then see ``depends/install_raqm_cmake.sh`` to install libraqm.
+
+.. tab:: Android
+
+    Basic Android support has been added for compilation within the Termux
+    environment. The dependencies can be installed by::
+
+        pkg install -y python ndk-sysroot clang make \
+            libjpeg-turbo
+
+    This has been tested within the Termux app on ChromeOS, on x86.
+
+Installing
+^^^^^^^^^^
+
+Once you have installed the prerequisites, to install Pillow from the source
+code on PyPI, run::
+
+    python3 -m pip install --upgrade pip
+    python3 -m pip install --upgrade Pillow --no-binary :all:
+
+If the prerequisites are installed in the standard library locations
+for your machine (e.g. :file:`/usr` or :file:`/usr/local`), no
+additional configuration should be required. If they are installed in
+a non-standard location, you may need to configure setuptools to use
+those locations by editing :file:`setup.py` or
+:file:`pyproject.toml`, or by adding environment variables on the command
+line::
+
+    CFLAGS="-I/usr/pkg/include" python3 -m pip install --upgrade Pillow --no-binary :all:
+
+If Pillow has been previously built without the required
+prerequisites, it may be necessary to manually clear the pip cache or
+build without cache using the ``--no-cache-dir`` option to force a
+build with newly installed external libraries.
+
+If you would like to install from a local copy of the source code instead, you
+can clone from GitHub with ``git clone https://github.com/python-pillow/Pillow``
+or download and extract the `compressed archive from PyPI`_.
+
+After navigating to the Pillow directory, run::
+
+    python3 -m pip install --upgrade pip
+    python3 -m pip install .
+
+.. _compressed archive from PyPI: https://pypi.org/project/pillow/#files
+
+Build Options
+"""""""""""""
+
+* Environment variable: ``MAX_CONCURRENCY=n``. Pillow can use
+  multiprocessing to build the extension. Setting ``MAX_CONCURRENCY``
+  sets the number of CPUs to use, or can disable parallel building by
+  using a setting of 1. By default, it uses 4 CPUs, or if 4 are not
+  available, as many as are present.
+
+* Config settings: ``-C zlib=disable``, ``-C jpeg=disable``,
+  ``-C tiff=disable``, ``-C freetype=disable``, ``-C raqm=disable``,
+  ``-C lcms=disable``, ``-C webp=disable``, ``-C webpmux=disable``,
+  ``-C jpeg2000=disable``, ``-C imagequant=disable``, ``-C xcb=disable``.
+  Disable building the corresponding feature even if the development
+  libraries are present on the building machine.
+
+* Config settings: ``-C zlib=enable``, ``-C jpeg=enable``,
+  ``-C tiff=enable``, ``-C freetype=enable``, ``-C raqm=enable``,
+  ``-C lcms=enable``, ``-C webp=enable``, ``-C webpmux=enable``,
+  ``-C jpeg2000=enable``, ``-C imagequant=enable``, ``-C xcb=enable``.
+  Require that the corresponding feature is built. The build will raise
+  an exception if the libraries are not found. Webpmux (WebP metadata)
+  relies on WebP support. Tcl and Tk also must be used together.
+
+* Config settings: ``-C raqm=vendor``, ``-C fribidi=vendor``.
+  These flags are used to compile a modified version of libraqm and
+  a shim that dynamically loads libfribidi at runtime. These are
+  used to compile the standard Pillow wheels. Compiling libraqm requires
+  a C99-compliant compiler.
+
+* Build flag: ``-C platform-guessing=disable``. Skips all of the
+  platform dependent guessing of include and library directories for
+  automated build systems that configure the proper paths in the
+  environment variables (e.g. Buildroot).
+
+* Build flag: ``-C debug=true``. Adds a debugging flag to the include and
+  library search process to dump all paths searched for and found to
+  stdout.
+
+
+Sample usage::
+
+    python3 -m pip install --upgrade Pillow -C [feature]=enable
diff --git a/docs/installation/index.rst b/docs/installation/index.rst
new file mode 100644
index 00000000000..9e6e5eeecdf
--- /dev/null
+++ b/docs/installation/index.rst
@@ -0,0 +1,11 @@
+Installation
+============
+
+.. toctree::
+  :maxdepth: 2
+
+  basic-installation
+  python-support
+  platform-support
+  building-from-source
+  old-versions
diff --git a/docs/newer-versions.csv b/docs/installation/newer-versions.csv
similarity index 100%
rename from docs/newer-versions.csv
rename to docs/installation/newer-versions.csv
diff --git a/docs/installation/old-versions.rst b/docs/installation/old-versions.rst
new file mode 100644
index 00000000000..48f3f727dd7
--- /dev/null
+++ b/docs/installation/old-versions.rst
@@ -0,0 +1,6 @@
+Old Versions
+------------
+
+You can download old distributions from the `release history at PyPI
+<https://pypi.org/project/pillow/#history>`_ and by direct URL access
+eg. https://pypi.org/project/pillow/1.0/.
diff --git a/docs/older-versions.csv b/docs/installation/older-versions.csv
similarity index 100%
rename from docs/older-versions.csv
rename to docs/installation/older-versions.csv
diff --git a/docs/installation/platform-support.rst b/docs/installation/platform-support.rst
new file mode 100644
index 00000000000..da98d4b9ee1
--- /dev/null
+++ b/docs/installation/platform-support.rst
@@ -0,0 +1,166 @@
+Platform Support
+----------------
+
+Current platform support for Pillow. Binary distributions are
+contributed for each release on a volunteer basis, but the source
+should compile and run everywhere platform support is listed. In
+general, we aim to support all current versions of Linux, macOS, and
+Windows.
+
+Continuous Integration Targets
+^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
+
+These platforms are built and tested for every change.
+
++----------------------------------+----------------------------+---------------------+
+| Operating system                 | Tested Python versions     | Tested architecture |
++==================================+============================+=====================+
+| Alpine                           | 3.9                        | x86-64              |
++----------------------------------+----------------------------+---------------------+
+| Amazon Linux 2                   | 3.9                        | x86-64              |
++----------------------------------+----------------------------+---------------------+
+| Amazon Linux 2023                | 3.9                        | x86-64              |
++----------------------------------+----------------------------+---------------------+
+| Arch                             | 3.9                        | x86-64              |
++----------------------------------+----------------------------+---------------------+
+| CentOS 7                         | 3.9                        | x86-64              |
++----------------------------------+----------------------------+---------------------+
+| CentOS Stream 8                  | 3.9                        | x86-64              |
++----------------------------------+----------------------------+---------------------+
+| CentOS Stream 9                  | 3.9                        | x86-64              |
++----------------------------------+----------------------------+---------------------+
+| Debian 11 Bullseye               | 3.9                        | x86-64              |
++----------------------------------+----------------------------+---------------------+
+| Debian 12 Bookworm               | 3.11                       | x86, x86-64         |
++----------------------------------+----------------------------+---------------------+
+| Fedora 38                        | 3.11                       | x86-64              |
++----------------------------------+----------------------------+---------------------+
+| Fedora 39                        | 3.12                       | x86-64              |
++----------------------------------+----------------------------+---------------------+
+| Gentoo                           | 3.9                        | x86-64              |
++----------------------------------+----------------------------+---------------------+
+| macOS 12 Monterey                | 3.8, 3.9, 3.10, 3.11,      | x86-64              |
+|                                  | 3.12, PyPy3                |                     |
++----------------------------------+----------------------------+---------------------+
+| Ubuntu Linux 20.04 LTS (Focal)   | 3.8                        | x86-64              |
++----------------------------------+----------------------------+---------------------+
+| Ubuntu Linux 22.04 LTS (Jammy)   | 3.8, 3.9, 3.10, 3.11,      | x86-64              |
+|                                  | 3.12, PyPy3                |                     |
+|                                  +----------------------------+---------------------+
+|                                  | 3.10                       | arm64v8, ppc64le,   |
+|                                  |                            | s390x               |
++----------------------------------+----------------------------+---------------------+
+| Windows Server 2016              | 3.8                        | x86-64              |
++----------------------------------+----------------------------+---------------------+
+| Windows Server 2022              | 3.8, 3.9, 3.10, 3.11,      | x86-64              |
+|                                  | 3.12, PyPy3                |                     |
+|                                  +----------------------------+---------------------+
+|                                  | 3.12                       | x86                 |
+|                                  +----------------------------+---------------------+
+|                                  | 3.9 (MinGW)                | x86-64              |
+|                                  +----------------------------+---------------------+
+|                                  | 3.8, 3.9 (Cygwin)          | x86-64              |
++----------------------------------+----------------------------+---------------------+
+
+
+Other Platforms
+^^^^^^^^^^^^^^^
+
+These platforms have been reported to work at the versions mentioned.
+
+.. note::
+
+    Contributors please test Pillow on your platform then update this
+    document and send a pull request.
+
++----------------------------------+----------------------------+------------------+--------------+
+| Operating system                 | | Tested Python            | | Latest tested  | | Tested     |
+|                                  | | versions                 | | Pillow version | | processors |
++==================================+============================+==================+==============+
+| macOS 14 Sonoma                  | 3.8, 3.9, 3.10, 3.11, 3.12 | 10.2.0           |arm           |
++----------------------------------+----------------------------+------------------+--------------+
+| macOS 13 Ventura                 | 3.8, 3.9, 3.10, 3.11       | 10.0.1           |arm           |
+|                                  +----------------------------+------------------+              |
+|                                  | 3.7                        | 9.5.0            |              |
++----------------------------------+----------------------------+------------------+--------------+
+| macOS 12 Monterey                | 3.7, 3.8, 3.9, 3.10, 3.11  | 9.3.0            |arm           |
++----------------------------------+----------------------------+------------------+--------------+
+| macOS 11 Big Sur                 | 3.7, 3.8, 3.9, 3.10        | 8.4.0            |arm           |
+|                                  +----------------------------+------------------+--------------+
+|                                  | 3.7, 3.8, 3.9, 3.10, 3.11  | 9.4.0            |x86-64        |
+|                                  +----------------------------+------------------+              |
+|                                  | 3.6                        | 8.4.0            |              |
++----------------------------------+----------------------------+------------------+--------------+
+| macOS 10.15 Catalina             | 3.6, 3.7, 3.8, 3.9         | 8.3.2            |x86-64        |
+|                                  +----------------------------+------------------+              |
+|                                  | 3.5                        | 7.2.0            |              |
++----------------------------------+----------------------------+------------------+--------------+
+| macOS 10.14 Mojave               | 3.5, 3.6, 3.7, 3.8         | 7.2.0            |x86-64        |
+|                                  +----------------------------+------------------+              |
+|                                  | 2.7                        | 6.0.0            |              |
+|                                  +----------------------------+------------------+              |
+|                                  | 3.4                        | 5.4.1            |              |
++----------------------------------+----------------------------+------------------+--------------+
+| macOS 10.13 High Sierra          | 2.7, 3.4, 3.5, 3.6         | 4.2.1            |x86-64        |
++----------------------------------+----------------------------+------------------+--------------+
+| macOS 10.12 Sierra               | 2.7, 3.4, 3.5, 3.6         | 4.1.1            |x86-64        |
++----------------------------------+----------------------------+------------------+--------------+
+| Mac OS X 10.11 El Capitan        | 2.7, 3.4, 3.5, 3.6, 3.7    | 5.4.1            |x86-64        |
+|                                  +----------------------------+------------------+              |
+|                                  | 3.3                        | 4.1.0            |              |
++----------------------------------+----------------------------+------------------+--------------+
+| Mac OS X 10.9 Mavericks          | 2.7, 3.2, 3.3, 3.4         | 3.0.0            |x86-64        |
++----------------------------------+----------------------------+------------------+--------------+
+| Mac OS X 10.8 Mountain Lion      | 2.6, 2.7, 3.2, 3.3         |                  |x86-64        |
++----------------------------------+----------------------------+------------------+--------------+
+| Redhat Linux 6                   | 2.6                        |                  |x86           |
++----------------------------------+----------------------------+------------------+--------------+
+| CentOS 6.3                       | 2.7, 3.3                   |                  |x86           |
++----------------------------------+----------------------------+------------------+--------------+
+| CentOS 8                         | 3.9                        | 9.0.0            |x86-64        |
++----------------------------------+----------------------------+------------------+--------------+
+| Fedora 23                        | 2.7, 3.4                   | 3.1.0            |x86-64        |
++----------------------------------+----------------------------+------------------+--------------+
+| Ubuntu Linux 12.04 LTS (Precise) | | 2.6, 3.2, 3.3, 3.4, 3.5  | 3.4.1            |x86,x86-64    |
+|                                  | | PyPy5.3.1, PyPy3 v2.4.0  |                  |              |
+|                                  +----------------------------+------------------+--------------+
+|                                  | 2.7                        | 4.3.0            |x86-64        |
+|                                  +----------------------------+------------------+--------------+
+|                                  | 2.7, 3.2                   | 3.4.1            |ppc           |
++----------------------------------+----------------------------+------------------+--------------+
+| Ubuntu Linux 10.04 LTS (Lucid)   | 2.6                        | 2.3.0            |x86,x86-64    |
++----------------------------------+----------------------------+------------------+--------------+
+| Debian 8.2 Jessie                | 2.7, 3.4                   | 3.1.0            |x86-64        |
++----------------------------------+----------------------------+------------------+--------------+
+| Raspbian Jessie                  | 2.7, 3.4                   | 3.1.0            |arm           |
++----------------------------------+----------------------------+------------------+--------------+
+| Raspbian Stretch                 | 2.7, 3.5                   | 4.0.0            |arm           |
++----------------------------------+----------------------------+------------------+--------------+
+| Raspberry Pi OS                  | 3.6, 3.7, 3.8, 3.9         | 8.2.0            |arm           |
+|                                  +----------------------------+------------------+              |
+|                                  | 2.7                        | 6.2.2            |              |
++----------------------------------+----------------------------+------------------+--------------+
+| Gentoo Linux                     | 2.7, 3.2                   | 2.1.0            |x86-64        |
++----------------------------------+----------------------------+------------------+--------------+
+| FreeBSD 11.1                     | 2.7, 3.4, 3.5, 3.6         | 4.3.0            |x86-64        |
++----------------------------------+----------------------------+------------------+--------------+
+| FreeBSD 10.3                     | 2.7, 3.4, 3.5              | 4.2.0            |x86-64        |
++----------------------------------+----------------------------+------------------+--------------+
+| FreeBSD 10.2                     | 2.7, 3.4                   | 3.1.0            |x86-64        |
++----------------------------------+----------------------------+------------------+--------------+
+| Windows 11                       | 3.9, 3.10, 3.11, 3.12      | 10.2.0           |arm64         |
++----------------------------------+----------------------------+------------------+--------------+
+| Windows 11 Pro                   | 3.11, 3.12                 | 10.2.0           |x86-64        |
++----------------------------------+----------------------------+------------------+--------------+
+| Windows 10                       | 3.7                        | 7.1.0            |x86-64        |
++----------------------------------+----------------------------+------------------+--------------+
+| Windows 10/Cygwin 3.3            | 3.6, 3.7, 3.8, 3.9         | 8.4.0            |x86-64        |
++----------------------------------+----------------------------+------------------+--------------+
+| Windows 8.1 Pro                  | 2.6, 2.7, 3.2, 3.3, 3.4    | 2.4.0            |x86,x86-64    |
++----------------------------------+----------------------------+------------------+--------------+
+| Windows 8 Pro                    | 2.6, 2.7, 3.2, 3.3, 3.4a3  | 2.2.0            |x86,x86-64    |
++----------------------------------+----------------------------+------------------+--------------+
+| Windows 7 Professional           | 3.7                        | 7.0.0            |x86,x86-64    |
++----------------------------------+----------------------------+------------------+--------------+
+| Windows Server 2008 R2 Enterprise| 3.3                        |                  |x86-64        |
++----------------------------------+----------------------------+------------------+--------------+
diff --git a/docs/installation/python-support.rst b/docs/installation/python-support.rst
new file mode 100644
index 00000000000..ab075f2545a
--- /dev/null
+++ b/docs/installation/python-support.rst
@@ -0,0 +1,17 @@
+Python Support
+--------------
+
+Pillow supports these Python versions.
+
+.. csv-table:: Newer versions
+   :file: newer-versions.csv
+   :header-rows: 1
+
+.. csv-table:: Older versions
+   :file: older-versions.csv
+   :header-rows: 1
+
+.. _Linux Installation:
+.. _macOS Installation:
+.. _Windows Installation:
+.. _FreeBSD Installation:

From ecba08f8c40415159ed0ed02d5b3cb7f154fddfe Mon Sep 17 00:00:00 2001
From: Alex Clark <aclark@aclark.net>
Date: Sun, 25 Feb 2024 06:36:03 -0500
Subject: [PATCH 0238/1178] Add sphinx-reredirects to handle redirects

- For example, installation.html now redirects to installation/index.html
---
 docs/conf.py   | 6 ++++++
 pyproject.toml | 1 +
 2 files changed, 7 insertions(+)

diff --git a/docs/conf.py b/docs/conf.py
index 97289c91d0c..0733e2938e6 100644
--- a/docs/conf.py
+++ b/docs/conf.py
@@ -36,6 +36,7 @@
     "sphinx_inline_tabs",
     "sphinx_removed_in",
     "sphinxext.opengraph",
+    "sphinx_reredirects",
 ]
 
 intersphinx_mapping = {"python": ("https://docs.python.org/3", None)}
@@ -350,3 +351,8 @@
     "pillow-logo-dark-text-1280x640.png"
 )
 ogp_image_alt = "Pillow"
+
+# sphinx-reredirects
+redirects = {
+     "installation.html": "installation/index.html"
+}
diff --git a/pyproject.toml b/pyproject.toml
index 58c2464bcad..2107800d69a 100644
--- a/pyproject.toml
+++ b/pyproject.toml
@@ -47,6 +47,7 @@ docs = [
   "sphinx-inline-tabs",
   "sphinx-removed-in",
   "sphinxext-opengraph",
+  "sphinx-reredirects",
 ]
 fpx = [
   "olefile",

From fde1ccb555ef275ad087ea70ebc0af31f7b20f8a Mon Sep 17 00:00:00 2001
From: "pre-commit-ci[bot]"
 <66853113+pre-commit-ci[bot]@users.noreply.github.com>
Date: Sun, 25 Feb 2024 11:37:15 +0000
Subject: [PATCH 0239/1178] [pre-commit.ci] auto fixes from pre-commit.com
 hooks

for more information, see https://pre-commit.ci
---
 docs/conf.py   | 4 +---
 pyproject.toml | 2 +-
 2 files changed, 2 insertions(+), 4 deletions(-)

diff --git a/docs/conf.py b/docs/conf.py
index 0733e2938e6..874a077a31d 100644
--- a/docs/conf.py
+++ b/docs/conf.py
@@ -353,6 +353,4 @@
 ogp_image_alt = "Pillow"
 
 # sphinx-reredirects
-redirects = {
-     "installation.html": "installation/index.html"
-}
+redirects = {"installation.html": "installation/index.html"}
diff --git a/pyproject.toml b/pyproject.toml
index 2107800d69a..c3b469f1011 100644
--- a/pyproject.toml
+++ b/pyproject.toml
@@ -46,8 +46,8 @@ docs = [
   "sphinx-copybutton",
   "sphinx-inline-tabs",
   "sphinx-removed-in",
-  "sphinxext-opengraph",
   "sphinx-reredirects",
+  "sphinxext-opengraph",
 ]
 fpx = [
   "olefile",

From a72a5f9ae2239c5478a64761d99aaff8a3499030 Mon Sep 17 00:00:00 2001
From: Alex Clark <aclark@aclark.net>
Date: Tue, 27 Feb 2024 07:12:21 -0500
Subject: [PATCH 0240/1178] Leave a note

---
 docs/conf.py                               | 2 +-
 docs/installation/basic-installation.rst   | 2 ++
 docs/installation/building-from-source.rst | 2 ++
 docs/installation/old-versions.rst         | 2 ++
 docs/installation/platform-support.rst     | 2 ++
 docs/installation/python-support.rst       | 2 ++
 6 files changed, 11 insertions(+), 1 deletion(-)

diff --git a/docs/conf.py b/docs/conf.py
index 874a077a31d..b7ad570849d 100644
--- a/docs/conf.py
+++ b/docs/conf.py
@@ -353,4 +353,4 @@
 ogp_image_alt = "Pillow"
 
 # sphinx-reredirects
-redirects = {"installation.html": "installation/index.html"}
+# redirects = {"installation.html": "installation/index.html"}
diff --git a/docs/installation/basic-installation.rst b/docs/installation/basic-installation.rst
index ff05e7f586d..486e6863b7b 100644
--- a/docs/installation/basic-installation.rst
+++ b/docs/installation/basic-installation.rst
@@ -1,3 +1,5 @@
+.. _basic-installation:
+
 Basic Installation
 ------------------
 
diff --git a/docs/installation/building-from-source.rst b/docs/installation/building-from-source.rst
index 051d51c225d..1f9715547e7 100644
--- a/docs/installation/building-from-source.rst
+++ b/docs/installation/building-from-source.rst
@@ -1,3 +1,5 @@
+.. _building-from-source:
+
 Building From Source
 --------------------
 
diff --git a/docs/installation/old-versions.rst b/docs/installation/old-versions.rst
index 48f3f727dd7..445a70d4ebf 100644
--- a/docs/installation/old-versions.rst
+++ b/docs/installation/old-versions.rst
@@ -1,3 +1,5 @@
+.. _old-versions:
+
 Old Versions
 ------------
 
diff --git a/docs/installation/platform-support.rst b/docs/installation/platform-support.rst
index da98d4b9ee1..602941c3c5a 100644
--- a/docs/installation/platform-support.rst
+++ b/docs/installation/platform-support.rst
@@ -1,3 +1,5 @@
+.. _platform-support:
+
 Platform Support
 ----------------
 
diff --git a/docs/installation/python-support.rst b/docs/installation/python-support.rst
index ab075f2545a..8d7db8d3a48 100644
--- a/docs/installation/python-support.rst
+++ b/docs/installation/python-support.rst
@@ -1,3 +1,5 @@
+.. _python-support:
+
 Python Support
 --------------
 

From fd1cefe2b69193d0cf5c2a52b57820decfd458dd Mon Sep 17 00:00:00 2001
From: Alex Clark <aclark@aclark.net>
Date: Tue, 27 Feb 2024 07:21:38 -0500
Subject: [PATCH 0241/1178] Leave a note

- Re-add installation.rst
---
 docs/installation.rst | 27 +++++++++++++++++++++++++++
 1 file changed, 27 insertions(+)
 create mode 100644 docs/installation.rst

diff --git a/docs/installation.rst b/docs/installation.rst
new file mode 100644
index 00000000000..57659ba48da
--- /dev/null
+++ b/docs/installation.rst
@@ -0,0 +1,27 @@
+Installation
+============
+
+Basic Installation
+------------------
+
+.. Note:: This section has moved to :ref:`basic-installation`. Please update references accordingly.
+
+Python Support
+--------------
+
+.. Note:: This section has moved to :ref:`python-support`. Please update references accordingly.
+
+Platform Support
+----------------
+
+.. Note:: This section has moved to :ref:`platform-support`. Please update references accordingly.
+
+Building From Source
+--------------------
+
+.. Note:: This section has moved to :ref:`building-from-source`. Please update references accordingly.
+
+Old Versions
+------------
+
+.. Note:: This section has moved to :ref:`old-versions`. Please update references accordingly.

From 904b8e549cf74b8981e61cb58d77431e0b53f5ff Mon Sep 17 00:00:00 2001
From: Andrew Murray <radarhere@users.noreply.github.com>
Date: Wed, 28 Feb 2024 21:07:15 +1100
Subject: [PATCH 0242/1178] Allow writing IFDRational to UNDEFINED tag

---
 Tests/test_file_tiff_metadata.py | 7 +++++--
 src/PIL/TiffImagePlugin.py       | 2 ++
 2 files changed, 7 insertions(+), 2 deletions(-)

diff --git a/Tests/test_file_tiff_metadata.py b/Tests/test_file_tiff_metadata.py
index d7a18c72504..8b816aa4fb5 100644
--- a/Tests/test_file_tiff_metadata.py
+++ b/Tests/test_file_tiff_metadata.py
@@ -224,14 +224,17 @@ def test_writing_other_types_to_bytes(value: int | IFDRational, tmp_path: Path)
         assert reloaded.tag_v2[700] == b"\x01"
 
 
-def test_writing_other_types_to_undefined(tmp_path: Path) -> None:
+@pytest.mark.parametrize("value", (1, IFDRational(1)))
+def test_writing_other_types_to_undefined(
+    value: int | IFDRational, tmp_path: Path
+) -> None:
     im = hopper()
     info = TiffImagePlugin.ImageFileDirectory_v2()
 
     tag = TiffTags.TAGS_V2[33723]
     assert tag.type == TiffTags.UNDEFINED
 
-    info[33723] = 1
+    info[33723] = value
 
     out = str(tmp_path / "temp.tiff")
     im.save(out, tiffinfo=info)
diff --git a/src/PIL/TiffImagePlugin.py b/src/PIL/TiffImagePlugin.py
index 3ba4de9d12e..b59139f5858 100644
--- a/src/PIL/TiffImagePlugin.py
+++ b/src/PIL/TiffImagePlugin.py
@@ -790,6 +790,8 @@ def load_undefined(self, data, legacy_api=True):
 
     @_register_writer(7)
     def write_undefined(self, value):
+        if isinstance(value, IFDRational):
+            value = int(value)
         if isinstance(value, int):
             value = str(value).encode("ascii", "replace")
         return value

From c00d0191861fd43b39e75742b68ae8df7041b67e Mon Sep 17 00:00:00 2001
From: Andrew Murray <radarhere@users.noreply.github.com>
Date: Wed, 28 Feb 2024 07:05:47 +1100
Subject: [PATCH 0243/1178] Updated openjpeg to 2.5.2

---
 .github/workflows/wheels-dependencies.sh |  7 +++++--
 depends/install_openjpeg.sh              |  2 +-
 docs/installation.rst                    |  2 +-
 winbuild/build_prepare.py                | 15 +++++----------
 4 files changed, 12 insertions(+), 14 deletions(-)

diff --git a/.github/workflows/wheels-dependencies.sh b/.github/workflows/wheels-dependencies.sh
index 26bf2f6d655..cc8d7e085f9 100755
--- a/.github/workflows/wheels-dependencies.sh
+++ b/.github/workflows/wheels-dependencies.sh
@@ -19,7 +19,7 @@ FREETYPE_VERSION=2.13.2
 HARFBUZZ_VERSION=8.3.0
 LIBPNG_VERSION=1.6.40
 JPEGTURBO_VERSION=3.0.1
-OPENJPEG_VERSION=2.5.0
+OPENJPEG_VERSION=2.5.2
 XZ_VERSION=5.4.5
 TIFF_VERSION=4.6.0
 LCMS2_VERSION=2.16
@@ -40,7 +40,7 @@ BROTLI_VERSION=1.1.0
 
 if [[ -n "$IS_MACOS" ]] && [[ "$CIBW_ARCHS" == "x86_64" ]]; then
     function build_openjpeg {
-        local out_dir=$(fetch_unpack https://github.com/uclouvain/openjpeg/archive/v${OPENJPEG_VERSION}.tar.gz openjpeg-2.5.0.tar.gz)
+        local out_dir=$(fetch_unpack https://github.com/uclouvain/openjpeg/archive/v${OPENJPEG_VERSION}.tar.gz openjpeg-${OPENJPEG_VERSION}.tar.gz)
         (cd $out_dir \
             && cmake -DCMAKE_INSTALL_PREFIX=$BUILD_PREFIX -DCMAKE_INSTALL_NAME_DIR=$BUILD_PREFIX/lib . \
             && make install)
@@ -93,6 +93,9 @@ function build {
         done
     fi
     build_openjpeg
+    if [ -f /usr/local/lib64/libopenjp2.so ]; then
+        cp /usr/local/lib64/libopenjp2.so /usr/local/lib
+    fi
 
     ORIGINAL_CFLAGS=$CFLAGS
     CFLAGS="$CFLAGS -O3 -DNDEBUG"
diff --git a/depends/install_openjpeg.sh b/depends/install_openjpeg.sh
index 4f4b81a628b..8c2967bc21b 100755
--- a/depends/install_openjpeg.sh
+++ b/depends/install_openjpeg.sh
@@ -1,7 +1,7 @@
 #!/bin/bash
 # install openjpeg
 
-archive=openjpeg-2.5.0
+archive=openjpeg-2.5.2
 
 ./download-and-extract.sh $archive https://raw.githubusercontent.com/python-pillow/pillow-depends/main/$archive.tar.gz
 
diff --git a/docs/installation.rst b/docs/installation.rst
index 980bbd99def..de812e3c4b6 100644
--- a/docs/installation.rst
+++ b/docs/installation.rst
@@ -177,7 +177,7 @@ Many of Pillow's features require external libraries:
 * **openjpeg** provides JPEG 2000 functionality.
 
   * Pillow has been tested with openjpeg **2.0.0**, **2.1.0**, **2.3.1**,
-    **2.4.0** and **2.5.0**.
+    **2.4.0**, **2.5.0** and **2.5.2**.
   * Pillow does **not** support the earlier **1.5** series which ships
     with Debian Jessie.
 
diff --git a/winbuild/build_prepare.py b/winbuild/build_prepare.py
index df33ea493e6..2ee9872e6a3 100644
--- a/winbuild/build_prepare.py
+++ b/winbuild/build_prepare.py
@@ -308,21 +308,16 @@ def cmd_msbuild(
         "libs": [r"Lib\MS\*.lib"],
     },
     "openjpeg": {
-        "url": "https://github.com/uclouvain/openjpeg/archive/v2.5.0.tar.gz",
-        "filename": "openjpeg-2.5.0.tar.gz",
-        "dir": "openjpeg-2.5.0",
+        "url": "https://github.com/uclouvain/openjpeg/archive/v2.5.2.tar.gz",
+        "filename": "openjpeg-2.5.2.tar.gz",
+        "dir": "openjpeg-2.5.2",
         "license": "LICENSE",
-        "patch": {
-            r"src\lib\openjp2\ht_dec.c": {
-                "#ifdef OPJ_COMPILER_MSVC\n    return (OPJ_UINT32)__popcnt(val);": "#if defined(OPJ_COMPILER_MSVC) && (defined(_M_IX86) || defined(_M_AMD64))\n    return (OPJ_UINT32)__popcnt(val);",  # noqa: E501
-            }
-        },
         "build": [
             *cmds_cmake(
                 "openjp2", "-DBUILD_CODEC:BOOL=OFF", "-DBUILD_SHARED_LIBS:BOOL=OFF"
             ),
-            cmd_mkdir(r"{inc_dir}\openjpeg-2.5.0"),
-            cmd_copy(r"src\lib\openjp2\*.h", r"{inc_dir}\openjpeg-2.5.0"),
+            cmd_mkdir(r"{inc_dir}\openjpeg-2.5.2"),
+            cmd_copy(r"src\lib\openjp2\*.h", r"{inc_dir}\openjpeg-2.5.2"),
         ],
         "libs": [r"bin\*.lib"],
     },

From dcbe402f77b9a6cbdc09645912404a716e597df9 Mon Sep 17 00:00:00 2001
From: Andrew Murray <radarhere@users.noreply.github.com>
Date: Thu, 29 Feb 2024 20:16:41 +1100
Subject: [PATCH 0244/1178] Changed SupportsGetMesh protocol to be public

---
 docs/reference/ImageOps.rst |  2 ++
 src/PIL/ImageOps.py         | 12 ++++++++++--
 2 files changed, 12 insertions(+), 2 deletions(-)

diff --git a/docs/reference/ImageOps.rst b/docs/reference/ImageOps.rst
index 47525307873..051fdcfc987 100644
--- a/docs/reference/ImageOps.rst
+++ b/docs/reference/ImageOps.rst
@@ -14,6 +14,8 @@ only work on L and RGB images.
 .. autofunction:: colorize
 .. autofunction:: crop
 .. autofunction:: scale
+.. autoclass:: SupportsGetMesh
+    :show-inheritance:
 .. autofunction:: deform
 .. autofunction:: equalize
 .. autofunction:: expand
diff --git a/src/PIL/ImageOps.py b/src/PIL/ImageOps.py
index 6218c723f85..33db8fa50c7 100644
--- a/src/PIL/ImageOps.py
+++ b/src/PIL/ImageOps.py
@@ -411,7 +411,15 @@ def scale(
         return image.resize(size, resample)
 
 
-class _SupportsGetMesh(Protocol):
+class SupportsGetMesh(Protocol):
+    """
+    An object that supports the ``getmesh`` method, taking an image as an
+    argument, and returning a list of tuples. Each tuple contains two tuples,
+    the source box as a tuple of 4 integers, and a tuple of 8 integers for the
+    final quadrilateral, in order of top left, bottom left, bottom right, top
+    right.
+    """
+
     def getmesh(
         self, image: Image.Image
     ) -> list[
@@ -421,7 +429,7 @@ def getmesh(
 
 def deform(
     image: Image.Image,
-    deformer: _SupportsGetMesh,
+    deformer: SupportsGetMesh,
     resample: int = Image.Resampling.BILINEAR,
 ) -> Image.Image:
     """

From 492943a0ff5678a4b624e42e3776adbec52915c3 Mon Sep 17 00:00:00 2001
From: Andrew Murray <radarhere@users.noreply.github.com>
Date: Thu, 29 Feb 2024 20:53:22 +1100
Subject: [PATCH 0245/1178] Fix logged tag name when loading with getexif()

---
 src/PIL/Image.py | 12 ++++++------
 1 file changed, 6 insertions(+), 6 deletions(-)

diff --git a/src/PIL/Image.py b/src/PIL/Image.py
index ba81a22c7f0..34177c481cc 100644
--- a/src/PIL/Image.py
+++ b/src/PIL/Image.py
@@ -3714,7 +3714,7 @@ def _fixup_dict(self, src_dict):
         # returns a dict with any single item tuples/lists as individual values
         return {k: self._fixup(v) for k, v in src_dict.items()}
 
-    def _get_ifd_dict(self, offset):
+    def _get_ifd_dict(self, offset, group=None):
         try:
             # an offset pointer to the location of the nested embedded IFD.
             # It should be a long, but may be corrupted.
@@ -3724,7 +3724,7 @@ def _get_ifd_dict(self, offset):
         else:
             from . import TiffImagePlugin
 
-            info = TiffImagePlugin.ImageFileDirectory_v2(self.head)
+            info = TiffImagePlugin.ImageFileDirectory_v2(self.head, group=group)
             info.load(self.fp)
             return self._fixup_dict(info)
 
@@ -3796,14 +3796,14 @@ def _get_merged_dict(self):
 
         # get EXIF extension
         if ExifTags.IFD.Exif in self:
-            ifd = self._get_ifd_dict(self[ExifTags.IFD.Exif])
+            ifd = self._get_ifd_dict(self[ExifTags.IFD.Exif], ExifTags.IFD.Exif)
             if ifd:
                 merged_dict.update(ifd)
 
         # GPS
         if ExifTags.IFD.GPSInfo in self:
             merged_dict[ExifTags.IFD.GPSInfo] = self._get_ifd_dict(
-                self[ExifTags.IFD.GPSInfo]
+                self[ExifTags.IFD.GPSInfo], ExifTags.IFD.GPSInfo
             )
 
         return merged_dict
@@ -3837,7 +3837,7 @@ def get_ifd(self, tag):
             elif tag in [ExifTags.IFD.Exif, ExifTags.IFD.GPSInfo]:
                 offset = self._hidden_data.get(tag, self.get(tag))
                 if offset is not None:
-                    self._ifds[tag] = self._get_ifd_dict(offset)
+                    self._ifds[tag] = self._get_ifd_dict(offset, tag)
             elif tag in [ExifTags.IFD.Interop, ExifTags.IFD.Makernote]:
                 if ExifTags.IFD.Exif not in self._ifds:
                     self.get_ifd(ExifTags.IFD.Exif)
@@ -3919,7 +3919,7 @@ def get_ifd(self, tag):
                         self._ifds[tag] = makernote
                 else:
                     # Interop
-                    self._ifds[tag] = self._get_ifd_dict(tag_data)
+                    self._ifds[tag] = self._get_ifd_dict(tag_data, tag)
         ifd = self._ifds.get(tag, {})
         if tag == ExifTags.IFD.Exif and self._hidden_data:
             ifd = {

From 0cc1cfb0cc5971d22c4f6294e2b510d74c46afda Mon Sep 17 00:00:00 2001
From: Hugo van Kemenade <1324225+hugovk@users.noreply.github.com>
Date: Thu, 29 Feb 2024 15:31:24 +0200
Subject: [PATCH 0246/1178] Move global into main() to avoid shadowing

---
 winbuild/build_prepare.py | 50 ++++++++++++++++++++++++---------------
 1 file changed, 31 insertions(+), 19 deletions(-)

diff --git a/winbuild/build_prepare.py b/winbuild/build_prepare.py
index 2ee9872e6a3..ede161c4417 100644
--- a/winbuild/build_prepare.py
+++ b/winbuild/build_prepare.py
@@ -456,11 +456,14 @@ def download_dep(url: str, file: str) -> None:
         raise RuntimeError(ex)
 
 
-def extract_dep(url: str, filename: str) -> None:
+def extract_dep(url: str, filename: str, prefs: dict[str, str]) -> None:
     import tarfile
     import zipfile
 
-    file = os.path.join(args.depends_dir, filename)
+    depends_dir = prefs["depends_dir"]
+    sources_dir = prefs["src_dir"]
+
+    file = os.path.join(depends_dir, filename)
     if not os.path.exists(file):
         # First try our mirror
         mirror_url = (
@@ -499,13 +502,15 @@ def extract_dep(url: str, filename: str) -> None:
         raise RuntimeError(msg)
 
 
-def write_script(name: str, lines: list[str]) -> None:
-    name = os.path.join(args.build_dir, name)
+def write_script(
+    name: str, lines: list[str], prefs: dict[str, str], verbose: bool
+) -> None:
+    name = os.path.join(prefs["build_dir"], name)
     lines = [line.format(**prefs) for line in lines]
     print("Writing " + name)
     with open(name, "w", newline="") as f:
         f.write(os.linesep.join(lines))
-    if args.verbose:
+    if verbose:
         for line in lines:
             print("    " + line)
 
@@ -521,7 +526,7 @@ def get_footer(dep: dict) -> list[str]:
     return lines
 
 
-def build_env() -> None:
+def build_env(prefs: dict[str, str], verbose: bool) -> None:
     lines = [
         "if defined DISTUTILS_USE_SDK goto end",
         cmd_set("INCLUDE", "{inc_dir}"),
@@ -534,15 +539,17 @@ def build_env() -> None:
         ":end",
         "@echo on",
     ]
-    write_script("build_env.cmd", lines)
+    write_script("build_env.cmd", lines, prefs, verbose)
 
 
-def build_dep(name: str) -> str:
+def build_dep(name: str, prefs: dict[str, str], verbose: bool) -> str:
     dep = DEPS[name]
     dir = dep["dir"]
     file = f"build_dep_{name}.cmd"
+    license_dir = prefs["license_dir"]
+    sources_dir = prefs["src_dir"]
 
-    extract_dep(dep["url"], dep["filename"])
+    extract_dep(dep["url"], dep["filename"], prefs)
 
     licenses = dep["license"]
     if isinstance(licenses, str):
@@ -583,11 +590,11 @@ def build_dep(name: str) -> str:
         *get_footer(dep),
     ]
 
-    write_script(file, lines)
+    write_script(file, lines, prefs, verbose)
     return file
 
 
-def build_dep_all() -> None:
+def build_dep_all(disabled: list[str], prefs: dict[str, str], verbose: bool) -> None:
     lines = [r'call "{build_dir}\build_env.cmd"']
     gha_groups = "GITHUB_ACTIONS" in os.environ
     for dep_name in DEPS:
@@ -595,7 +602,7 @@ def build_dep_all() -> None:
         if dep_name in disabled:
             print(f"Skipping disabled dependency {dep_name}")
             continue
-        script = build_dep(dep_name)
+        script = build_dep(dep_name, prefs, verbose)
         if gha_groups:
             lines.append(f"@echo ::group::Running {script}")
         lines.append(rf'cmd.exe /c "{{build_dir}}\{script}"')
@@ -604,10 +611,10 @@ def build_dep_all() -> None:
             lines.append("@echo ::endgroup::")
     print()
     lines.append("@echo All Pillow dependencies built successfully!")
-    write_script("build_dep_all.cmd", lines)
+    write_script("build_dep_all.cmd", lines, prefs, verbose)
 
 
-if __name__ == "__main__":
+def main() -> None:
     winbuild_dir = os.path.dirname(os.path.realpath(__file__))
     pillow_dir = os.path.realpath(os.path.join(winbuild_dir, ".."))
 
@@ -718,12 +725,13 @@ def build_dep_all() -> None:
         "pillow_dir": pillow_dir,
         "winbuild_dir": winbuild_dir,
         # Build paths
+        "bin_dir": bin_dir,
         "build_dir": args.build_dir,
+        "depends_dir": args.depends_dir,
         "inc_dir": inc_dir,
         "lib_dir": lib_dir,
-        "bin_dir": bin_dir,
-        "src_dir": sources_dir,
         "license_dir": license_dir,
+        "src_dir": sources_dir,
         # Compilers / Tools
         **msvs,
         "cmake": "cmake.exe",  # TODO find CMAKE automatically
@@ -736,6 +744,10 @@ def build_dep_all() -> None:
 
     print()
 
-    write_script(".gitignore", ["*"])
-    build_env()
-    build_dep_all()
+    write_script(".gitignore", ["*"], prefs, args.verbose)
+    build_env(prefs, args.verbose)
+    build_dep_all(disabled, prefs, args.verbose)
+
+
+if __name__ == "__main__":
+    main()

From fb3cb60c4c2c9919aef0f1d9ee95dedf2c2533ff Mon Sep 17 00:00:00 2001
From: Hugo van Kemenade <1324225+hugovk@users.noreply.github.com>
Date: Thu, 29 Feb 2024 17:09:51 +0200
Subject: [PATCH 0247/1178] Refactor version numbers into constants

---
 winbuild/build_prepare.py | 107 +++++++++++++++++++++++---------------
 1 file changed, 64 insertions(+), 43 deletions(-)

diff --git a/winbuild/build_prepare.py b/winbuild/build_prepare.py
index ede161c4417..fbd0276ed49 100644
--- a/winbuild/build_prepare.py
+++ b/winbuild/build_prepare.py
@@ -109,13 +109,30 @@ def cmd_msbuild(
     "ARM64": {"vcvars_arch": "x86_arm64", "msbuild_arch": "ARM64"},
 }
 
+BROTLI_VERSION = "1.1.0"
+FREETYPE_VERSION = "2.13.2"
+FRIBIDI_VERSION = "1.0.13"
+HARFBUZZ_VERSION = "8.3.0"
+JPEGTURBO_VERSION = "3.0.1"
+LCMS2_VERSION = "2.16"
+LIBPNG_VERSION = "1.6.39"
+LIBPNG_DOTLESS = LIBPNG_VERSION.replace(".", "")
+LIBPNG_XY = "".join(LIBPNG_VERSION.split(".")[:2])
+LIBWEBP_VERSION = "1.3.2"
+LIBXCB_VERSION = "1.16"
+OPENJPEG_VERSION = "2.5.2"
+TIFF_VERSION = "4.6.0"
+XZ_VERSION = "5.4.5"
+ZLIB_VERSION = "1.3"
+ZLIB_DOTLESS = ZLIB_VERSION.replace(".", "")
+
 # dependencies, listed in order of compilation
 DEPS = {
     "libjpeg": {
-        "url": SF_PROJECTS
-        + "/libjpeg-turbo/files/3.0.1/libjpeg-turbo-3.0.1.tar.gz/download",
-        "filename": "libjpeg-turbo-3.0.1.tar.gz",
-        "dir": "libjpeg-turbo-3.0.1",
+        "url": SF_PROJECTS + f"/libjpeg-turbo/files/{JPEGTURBO_VERSION}/"
+        f"libjpeg-turbo-{JPEGTURBO_VERSION}.tar.gz/download",
+        "filename": f"libjpeg-turbo-{JPEGTURBO_VERSION}.tar.gz",
+        "dir": f"libjpeg-turbo-{JPEGTURBO_VERSION}",
         "license": ["README.ijg", "LICENSE.md"],
         "license_pattern": (
             "(LEGAL ISSUES\n============\n\n.+?)\n\nREFERENCES\n=========="
@@ -143,9 +160,9 @@ def cmd_msbuild(
         "bins": ["cjpeg.exe", "djpeg.exe"],
     },
     "zlib": {
-        "url": "https://zlib.net/zlib13.zip",
-        "filename": "zlib13.zip",
-        "dir": "zlib-1.3",
+        "url": f"https://zlib.net/zlib{ZLIB_DOTLESS}.zip",
+        "filename": f"zlib{ZLIB_DOTLESS}.zip",
+        "dir": f"zlib-{ZLIB_VERSION}",
         "license": "README",
         "license_pattern": "Copyright notice:\n\n(.+)$",
         "build": [
@@ -157,9 +174,9 @@ def cmd_msbuild(
         "libs": [r"*.lib"],
     },
     "xz": {
-        "url": SF_PROJECTS + "/lzmautils/files/xz-5.4.5.tar.gz/download",
-        "filename": "xz-5.4.5.tar.gz",
-        "dir": "xz-5.4.5",
+        "url": SF_PROJECTS + f"/lzmautils/files/xz-{XZ_VERSION}.tar.gz/download",
+        "filename": f"xz-{XZ_VERSION}.tar.gz",
+        "dir": f"xz-{XZ_VERSION}",
         "license": "COPYING",
         "build": [
             *cmds_cmake("liblzma", "-DBUILD_SHARED_LIBS:BOOL=OFF"),
@@ -170,9 +187,9 @@ def cmd_msbuild(
         "libs": [r"liblzma.lib"],
     },
     "libwebp": {
-        "url": "http://downloads.webmproject.org/releases/webp/libwebp-1.3.2.tar.gz",
-        "filename": "libwebp-1.3.2.tar.gz",
-        "dir": "libwebp-1.3.2",
+        "url": f"http://downloads.webmproject.org/releases/webp/libwebp-{LIBWEBP_VERSION}.tar.gz",
+        "filename": f"libwebp-{LIBWEBP_VERSION}.tar.gz",
+        "dir": f"libwebp-{LIBWEBP_VERSION}",
         "license": "COPYING",
         "patch": {
             r"src\enc\picture_csp_enc.c": {
@@ -192,9 +209,9 @@ def cmd_msbuild(
         "libs": [r"libsharpyuv.lib", r"libwebp*.lib"],
     },
     "libtiff": {
-        "url": "https://download.osgeo.org/libtiff/tiff-4.6.0.tar.gz",
-        "filename": "tiff-4.6.0.tar.gz",
-        "dir": "tiff-4.6.0",
+        "url": f"https://download.osgeo.org/libtiff/tiff-{TIFF_VERSION}.tar.gz",
+        "filename": f"tiff-{TIFF_VERSION}.tar.gz",
+        "dir": f"tiff-{TIFF_VERSION}",
         "license": "LICENSE.md",
         "patch": {
             r"libtiff\tif_lzma.c": {
@@ -224,21 +241,22 @@ def cmd_msbuild(
         "libs": [r"libtiff\*.lib"],
     },
     "libpng": {
-        "url": SF_PROJECTS + "/libpng/files/libpng16/1.6.39/lpng1639.zip/download",
-        "filename": "lpng1639.zip",
-        "dir": "lpng1639",
+        "url": SF_PROJECTS + f"/libpng/files/libpng{LIBPNG_XY}/{LIBPNG_VERSION}/"
+        f"lpng{LIBPNG_DOTLESS}.zip/download",
+        "filename": f"lpng{LIBPNG_DOTLESS}.zip",
+        "dir": f"lpng{LIBPNG_DOTLESS}",
         "license": "LICENSE",
         "build": [
             *cmds_cmake("png_static", "-DPNG_SHARED:BOOL=OFF", "-DPNG_TESTS:BOOL=OFF"),
-            cmd_copy("libpng16_static.lib", "libpng16.lib"),
+            cmd_copy(f"libpng{LIBPNG_XY}_static.lib", f"libpng{LIBPNG_XY}.lib"),
         ],
         "headers": [r"png*.h"],
-        "libs": [r"libpng16.lib"],
+        "libs": [rf"libpng{LIBPNG_XY}.lib"],
     },
     "brotli": {
-        "url": "https://github.com/google/brotli/archive/refs/tags/v1.1.0.tar.gz",
-        "filename": "brotli-1.1.0.tar.gz",
-        "dir": "brotli-1.1.0",
+        "url": f"https://github.com/google/brotli/archive/refs/tags/v{BROTLI_VERSION}.tar.gz",
+        "filename": f"brotli-{BROTLI_VERSION}.tar.gz",
+        "dir": f"brotli-{BROTLI_VERSION}",
         "license": "LICENSE",
         "build": [
             *cmds_cmake(("brotlicommon", "brotlidec"), "-DBUILD_SHARED_LIBS:BOOL=OFF"),
@@ -247,9 +265,9 @@ def cmd_msbuild(
         "libs": ["*.lib"],
     },
     "freetype": {
-        "url": "https://download.savannah.gnu.org/releases/freetype/freetype-2.13.2.tar.gz",
-        "filename": "freetype-2.13.2.tar.gz",
-        "dir": "freetype-2.13.2",
+        "url": f"https://download.savannah.gnu.org/releases/freetype/freetype-{FREETYPE_VERSION}.tar.gz",
+        "filename": f"freetype-{FREETYPE_VERSION}.tar.gz",
+        "dir": f"freetype-{FREETYPE_VERSION}",
         "license": ["LICENSE.TXT", r"docs\FTL.TXT", r"docs\GPLv2.TXT"],
         "patch": {
             r"builds\windows\vc2010\freetype.vcxproj": {
@@ -262,7 +280,7 @@ def cmd_msbuild(
                 "<UserDefines></UserDefines>": "<UserDefines>FT_CONFIG_OPTION_SYSTEM_ZLIB;FT_CONFIG_OPTION_USE_PNG;FT_CONFIG_OPTION_USE_HARFBUZZ;FT_CONFIG_OPTION_USE_BROTLI</UserDefines>",  # noqa: E501
                 "<UserIncludeDirectories></UserIncludeDirectories>": r"<UserIncludeDirectories>{dir_harfbuzz}\src;{inc_dir}</UserIncludeDirectories>",  # noqa: E501
                 "<UserLibraryDirectories></UserLibraryDirectories>": "<UserLibraryDirectories>{lib_dir}</UserLibraryDirectories>",  # noqa: E501
-                "<UserDependencies></UserDependencies>": "<UserDependencies>zlib.lib;libpng16.lib;brotlicommon.lib;brotlidec.lib</UserDependencies>",  # noqa: E501
+                "<UserDependencies></UserDependencies>": f"<UserDependencies>zlib.lib;libpng{LIBPNG_XY}.lib;brotlicommon.lib;brotlidec.lib</UserDependencies>",  # noqa: E501
             },
             r"src/autofit/afshaper.c": {
                 # link against harfbuzz.lib
@@ -282,9 +300,10 @@ def cmd_msbuild(
         "libs": [r"objs\{msbuild_arch}\Release Static\freetype.lib"],
     },
     "lcms2": {
-        "url": SF_PROJECTS + "/lcms/files/lcms/2.16/lcms2-2.16.tar.gz/download",
-        "filename": "lcms2-2.16.tar.gz",
-        "dir": "lcms2-2.16",
+        "url": SF_PROJECTS
+        + f"/lcms/files/lcms/{LCMS2_VERSION}/lcms2-{LCMS2_VERSION}.tar.gz/download",
+        "filename": f"lcms2-{LCMS2_VERSION}.tar.gz",
+        "dir": f"lcms2-{LCMS2_VERSION}",
         "license": "LICENSE",
         "patch": {
             r"Projects\VC2022\lcms2_static\lcms2_static.vcxproj": {
@@ -308,16 +327,18 @@ def cmd_msbuild(
         "libs": [r"Lib\MS\*.lib"],
     },
     "openjpeg": {
-        "url": "https://github.com/uclouvain/openjpeg/archive/v2.5.2.tar.gz",
-        "filename": "openjpeg-2.5.2.tar.gz",
-        "dir": "openjpeg-2.5.2",
+        "url": f"https://github.com/uclouvain/openjpeg/archive/v{OPENJPEG_VERSION}.tar.gz",
+        "filename": f"openjpeg-{OPENJPEG_VERSION}.tar.gz",
+        "dir": f"openjpeg-{OPENJPEG_VERSION}",
         "license": "LICENSE",
         "build": [
             *cmds_cmake(
                 "openjp2", "-DBUILD_CODEC:BOOL=OFF", "-DBUILD_SHARED_LIBS:BOOL=OFF"
             ),
-            cmd_mkdir(r"{inc_dir}\openjpeg-2.5.2"),
-            cmd_copy(r"src\lib\openjp2\*.h", r"{inc_dir}\openjpeg-2.5.2"),
+            cmd_mkdir(rf"{{inc_dir}}\openjpeg-{OPENJPEG_VERSION}"),
+            cmd_copy(
+                r"src\lib\openjp2\*.h", rf"{{inc_dir}}\openjpeg-{OPENJPEG_VERSION}"
+            ),
         ],
         "libs": [r"bin\*.lib"],
     },
@@ -343,9 +364,9 @@ def cmd_msbuild(
         "libs": [r"imagequant.lib"],
     },
     "harfbuzz": {
-        "url": "https://github.com/harfbuzz/harfbuzz/archive/8.3.0.zip",
-        "filename": "harfbuzz-8.3.0.zip",
-        "dir": "harfbuzz-8.3.0",
+        "url": f"https://github.com/harfbuzz/harfbuzz/archive/{HARFBUZZ_VERSION}.zip",
+        "filename": f"harfbuzz-{HARFBUZZ_VERSION}.zip",
+        "dir": f"harfbuzz-{HARFBUZZ_VERSION}",
         "license": "COPYING",
         "build": [
             *cmds_cmake(
@@ -358,12 +379,12 @@ def cmd_msbuild(
         "libs": [r"*.lib"],
     },
     "fribidi": {
-        "url": "https://github.com/fribidi/fribidi/archive/v1.0.13.zip",
-        "filename": "fribidi-1.0.13.zip",
-        "dir": "fribidi-1.0.13",
+        "url": f"https://github.com/fribidi/fribidi/archive/v{FRIBIDI_VERSION}.zip",
+        "filename": f"fribidi-{FRIBIDI_VERSION}.zip",
+        "dir": f"fribidi-{FRIBIDI_VERSION}",
         "license": "COPYING",
         "build": [
-            cmd_copy(r"COPYING", r"{bin_dir}\fribidi-1.0.13-COPYING"),
+            cmd_copy(r"COPYING", rf"{{bin_dir}}\fribidi-{FRIBIDI_VERSION}-COPYING"),
             cmd_copy(r"{winbuild_dir}\fribidi.cmake", r"CMakeLists.txt"),
             # generated tab.i files cannot be cross-compiled
             " ^&^& ".join(

From 0b546765b8b12280eaf78807173ebf99be73c306 Mon Sep 17 00:00:00 2001
From: Hugo van Kemenade <1324225+hugovk@users.noreply.github.com>
Date: Thu, 29 Feb 2024 17:22:22 +0200
Subject: [PATCH 0248/1178] Refactor constants into dict

---
 winbuild/build_prepare.py | 127 +++++++++++++++++++-------------------
 1 file changed, 65 insertions(+), 62 deletions(-)

diff --git a/winbuild/build_prepare.py b/winbuild/build_prepare.py
index fbd0276ed49..efffbf5acde 100644
--- a/winbuild/build_prepare.py
+++ b/winbuild/build_prepare.py
@@ -109,30 +109,33 @@ def cmd_msbuild(
     "ARM64": {"vcvars_arch": "x86_arm64", "msbuild_arch": "ARM64"},
 }
 
-BROTLI_VERSION = "1.1.0"
-FREETYPE_VERSION = "2.13.2"
-FRIBIDI_VERSION = "1.0.13"
-HARFBUZZ_VERSION = "8.3.0"
-JPEGTURBO_VERSION = "3.0.1"
-LCMS2_VERSION = "2.16"
-LIBPNG_VERSION = "1.6.39"
-LIBPNG_DOTLESS = LIBPNG_VERSION.replace(".", "")
-LIBPNG_XY = "".join(LIBPNG_VERSION.split(".")[:2])
-LIBWEBP_VERSION = "1.3.2"
-LIBXCB_VERSION = "1.16"
-OPENJPEG_VERSION = "2.5.2"
-TIFF_VERSION = "4.6.0"
-XZ_VERSION = "5.4.5"
-ZLIB_VERSION = "1.3"
-ZLIB_DOTLESS = ZLIB_VERSION.replace(".", "")
+V = {
+    "BROTLI": "1.1.0",
+    "FREETYPE": "2.13.2",
+    "FRIBIDI": "1.0.13",
+    "HARFBUZZ": "8.3.0",
+    "JPEGTURBO": "3.0.1",
+    "LCMS2": "2.16",
+    "LIBPNG": "1.6.39",
+    "LIBWEBP": "1.3.2",
+    "LIBXCB": "1.16",
+    "OPENJPEG": "2.5.2",
+    "TIFF": "4.6.0",
+    "XZ": "5.4.5",
+    "ZLIB": "1.3",
+}
+V["LIBPNG_DOTLESS"] = V["LIBPNG"].replace(".", "")
+V["LIBPNG_XY"] = "".join(V["LIBPNG"].split(".")[:2])
+V["ZLIB_DOTLESS"] = V["ZLIB"].replace(".", "")
+
 
 # dependencies, listed in order of compilation
 DEPS = {
     "libjpeg": {
-        "url": SF_PROJECTS + f"/libjpeg-turbo/files/{JPEGTURBO_VERSION}/"
-        f"libjpeg-turbo-{JPEGTURBO_VERSION}.tar.gz/download",
-        "filename": f"libjpeg-turbo-{JPEGTURBO_VERSION}.tar.gz",
-        "dir": f"libjpeg-turbo-{JPEGTURBO_VERSION}",
+        "url": SF_PROJECTS + f"/libjpeg-turbo/files/{V['JPEGTURBO']}/"
+        f"libjpeg-turbo-{V['JPEGTURBO']}.tar.gz/download",
+        "filename": f"libjpeg-turbo-{V['JPEGTURBO']}.tar.gz",
+        "dir": f"libjpeg-turbo-{V['JPEGTURBO']}",
         "license": ["README.ijg", "LICENSE.md"],
         "license_pattern": (
             "(LEGAL ISSUES\n============\n\n.+?)\n\nREFERENCES\n=========="
@@ -160,9 +163,9 @@ def cmd_msbuild(
         "bins": ["cjpeg.exe", "djpeg.exe"],
     },
     "zlib": {
-        "url": f"https://zlib.net/zlib{ZLIB_DOTLESS}.zip",
-        "filename": f"zlib{ZLIB_DOTLESS}.zip",
-        "dir": f"zlib-{ZLIB_VERSION}",
+        "url": f"https://zlib.net/zlib{V['ZLIB_DOTLESS']}.zip",
+        "filename": f"zlib{V['ZLIB_DOTLESS']}.zip",
+        "dir": f"zlib-{V['ZLIB']}",
         "license": "README",
         "license_pattern": "Copyright notice:\n\n(.+)$",
         "build": [
@@ -174,9 +177,9 @@ def cmd_msbuild(
         "libs": [r"*.lib"],
     },
     "xz": {
-        "url": SF_PROJECTS + f"/lzmautils/files/xz-{XZ_VERSION}.tar.gz/download",
-        "filename": f"xz-{XZ_VERSION}.tar.gz",
-        "dir": f"xz-{XZ_VERSION}",
+        "url": SF_PROJECTS + f"/lzmautils/files/xz-{V['XZ']}.tar.gz/download",
+        "filename": f"xz-{V['XZ']}.tar.gz",
+        "dir": f"xz-{V['XZ']}",
         "license": "COPYING",
         "build": [
             *cmds_cmake("liblzma", "-DBUILD_SHARED_LIBS:BOOL=OFF"),
@@ -187,9 +190,9 @@ def cmd_msbuild(
         "libs": [r"liblzma.lib"],
     },
     "libwebp": {
-        "url": f"http://downloads.webmproject.org/releases/webp/libwebp-{LIBWEBP_VERSION}.tar.gz",
-        "filename": f"libwebp-{LIBWEBP_VERSION}.tar.gz",
-        "dir": f"libwebp-{LIBWEBP_VERSION}",
+        "url": f"http://downloads.webmproject.org/releases/webp/libwebp-{V['LIBWEBP']}.tar.gz",
+        "filename": f"libwebp-{V['LIBWEBP']}.tar.gz",
+        "dir": f"libwebp-{V['LIBWEBP']}",
         "license": "COPYING",
         "patch": {
             r"src\enc\picture_csp_enc.c": {
@@ -209,9 +212,9 @@ def cmd_msbuild(
         "libs": [r"libsharpyuv.lib", r"libwebp*.lib"],
     },
     "libtiff": {
-        "url": f"https://download.osgeo.org/libtiff/tiff-{TIFF_VERSION}.tar.gz",
-        "filename": f"tiff-{TIFF_VERSION}.tar.gz",
-        "dir": f"tiff-{TIFF_VERSION}",
+        "url": f"https://download.osgeo.org/libtiff/tiff-{V['TIFF']}.tar.gz",
+        "filename": f"tiff-{V['TIFF']}.tar.gz",
+        "dir": f"tiff-{V['TIFF']}",
         "license": "LICENSE.md",
         "patch": {
             r"libtiff\tif_lzma.c": {
@@ -241,22 +244,24 @@ def cmd_msbuild(
         "libs": [r"libtiff\*.lib"],
     },
     "libpng": {
-        "url": SF_PROJECTS + f"/libpng/files/libpng{LIBPNG_XY}/{LIBPNG_VERSION}/"
-        f"lpng{LIBPNG_DOTLESS}.zip/download",
-        "filename": f"lpng{LIBPNG_DOTLESS}.zip",
-        "dir": f"lpng{LIBPNG_DOTLESS}",
+        "url": SF_PROJECTS + f"/libpng/files/libpng{V['LIBPNG_XY']}/{V['LIBPNG']}/"
+        f"lpng{V['LIBPNG_DOTLESS']}.zip/download",
+        "filename": f"lpng{V['LIBPNG_DOTLESS']}.zip",
+        "dir": f"lpng{V['LIBPNG_DOTLESS']}",
         "license": "LICENSE",
         "build": [
             *cmds_cmake("png_static", "-DPNG_SHARED:BOOL=OFF", "-DPNG_TESTS:BOOL=OFF"),
-            cmd_copy(f"libpng{LIBPNG_XY}_static.lib", f"libpng{LIBPNG_XY}.lib"),
+            cmd_copy(
+                f"libpng{V['LIBPNG_XY']}_static.lib", f"libpng{V['LIBPNG_XY']}.lib"
+            ),
         ],
         "headers": [r"png*.h"],
-        "libs": [rf"libpng{LIBPNG_XY}.lib"],
+        "libs": [rf"libpng{V['LIBPNG_XY']}.lib"],
     },
     "brotli": {
-        "url": f"https://github.com/google/brotli/archive/refs/tags/v{BROTLI_VERSION}.tar.gz",
-        "filename": f"brotli-{BROTLI_VERSION}.tar.gz",
-        "dir": f"brotli-{BROTLI_VERSION}",
+        "url": f"https://github.com/google/brotli/archive/refs/tags/v{V['BROTLI']}.tar.gz",
+        "filename": f"brotli-{V['BROTLI']}.tar.gz",
+        "dir": f"brotli-{V['BROTLI']}",
         "license": "LICENSE",
         "build": [
             *cmds_cmake(("brotlicommon", "brotlidec"), "-DBUILD_SHARED_LIBS:BOOL=OFF"),
@@ -265,9 +270,9 @@ def cmd_msbuild(
         "libs": ["*.lib"],
     },
     "freetype": {
-        "url": f"https://download.savannah.gnu.org/releases/freetype/freetype-{FREETYPE_VERSION}.tar.gz",
-        "filename": f"freetype-{FREETYPE_VERSION}.tar.gz",
-        "dir": f"freetype-{FREETYPE_VERSION}",
+        "url": f"https://download.savannah.gnu.org/releases/freetype/freetype-{V['FREETYPE']}.tar.gz",
+        "filename": f"freetype-{V['FREETYPE']}.tar.gz",
+        "dir": f"freetype-{V['FREETYPE']}",
         "license": ["LICENSE.TXT", r"docs\FTL.TXT", r"docs\GPLv2.TXT"],
         "patch": {
             r"builds\windows\vc2010\freetype.vcxproj": {
@@ -280,7 +285,7 @@ def cmd_msbuild(
                 "<UserDefines></UserDefines>": "<UserDefines>FT_CONFIG_OPTION_SYSTEM_ZLIB;FT_CONFIG_OPTION_USE_PNG;FT_CONFIG_OPTION_USE_HARFBUZZ;FT_CONFIG_OPTION_USE_BROTLI</UserDefines>",  # noqa: E501
                 "<UserIncludeDirectories></UserIncludeDirectories>": r"<UserIncludeDirectories>{dir_harfbuzz}\src;{inc_dir}</UserIncludeDirectories>",  # noqa: E501
                 "<UserLibraryDirectories></UserLibraryDirectories>": "<UserLibraryDirectories>{lib_dir}</UserLibraryDirectories>",  # noqa: E501
-                "<UserDependencies></UserDependencies>": f"<UserDependencies>zlib.lib;libpng{LIBPNG_XY}.lib;brotlicommon.lib;brotlidec.lib</UserDependencies>",  # noqa: E501
+                "<UserDependencies></UserDependencies>": f"<UserDependencies>zlib.lib;libpng{V['LIBPNG_XY']}.lib;brotlicommon.lib;brotlidec.lib</UserDependencies>",  # noqa: E501
             },
             r"src/autofit/afshaper.c": {
                 # link against harfbuzz.lib
@@ -301,9 +306,9 @@ def cmd_msbuild(
     },
     "lcms2": {
         "url": SF_PROJECTS
-        + f"/lcms/files/lcms/{LCMS2_VERSION}/lcms2-{LCMS2_VERSION}.tar.gz/download",
-        "filename": f"lcms2-{LCMS2_VERSION}.tar.gz",
-        "dir": f"lcms2-{LCMS2_VERSION}",
+        + f"/lcms/files/lcms/{V['LCMS2']}/lcms2-{V['LCMS2']}.tar.gz/download",
+        "filename": f"lcms2-{V['LCMS2']}.tar.gz",
+        "dir": f"lcms2-{V['LCMS2']}",
         "license": "LICENSE",
         "patch": {
             r"Projects\VC2022\lcms2_static\lcms2_static.vcxproj": {
@@ -327,18 +332,16 @@ def cmd_msbuild(
         "libs": [r"Lib\MS\*.lib"],
     },
     "openjpeg": {
-        "url": f"https://github.com/uclouvain/openjpeg/archive/v{OPENJPEG_VERSION}.tar.gz",
-        "filename": f"openjpeg-{OPENJPEG_VERSION}.tar.gz",
-        "dir": f"openjpeg-{OPENJPEG_VERSION}",
+        "url": f"https://github.com/uclouvain/openjpeg/archive/v{V['OPENJPEG']}.tar.gz",
+        "filename": f"openjpeg-{V['OPENJPEG']}.tar.gz",
+        "dir": f"openjpeg-{V['OPENJPEG']}",
         "license": "LICENSE",
         "build": [
             *cmds_cmake(
                 "openjp2", "-DBUILD_CODEC:BOOL=OFF", "-DBUILD_SHARED_LIBS:BOOL=OFF"
             ),
-            cmd_mkdir(rf"{{inc_dir}}\openjpeg-{OPENJPEG_VERSION}"),
-            cmd_copy(
-                r"src\lib\openjp2\*.h", rf"{{inc_dir}}\openjpeg-{OPENJPEG_VERSION}"
-            ),
+            cmd_mkdir(rf"{{inc_dir}}\openjpeg-{V['OPENJPEG']}"),
+            cmd_copy(r"src\lib\openjp2\*.h", rf"{{inc_dir}}\openjpeg-{V['OPENJPEG']}"),
         ],
         "libs": [r"bin\*.lib"],
     },
@@ -364,9 +367,9 @@ def cmd_msbuild(
         "libs": [r"imagequant.lib"],
     },
     "harfbuzz": {
-        "url": f"https://github.com/harfbuzz/harfbuzz/archive/{HARFBUZZ_VERSION}.zip",
-        "filename": f"harfbuzz-{HARFBUZZ_VERSION}.zip",
-        "dir": f"harfbuzz-{HARFBUZZ_VERSION}",
+        "url": f"https://github.com/harfbuzz/harfbuzz/archive/{V['HARFBUZZ']}.zip",
+        "filename": f"harfbuzz-{V['HARFBUZZ']}.zip",
+        "dir": f"harfbuzz-{V['HARFBUZZ']}",
         "license": "COPYING",
         "build": [
             *cmds_cmake(
@@ -379,12 +382,12 @@ def cmd_msbuild(
         "libs": [r"*.lib"],
     },
     "fribidi": {
-        "url": f"https://github.com/fribidi/fribidi/archive/v{FRIBIDI_VERSION}.zip",
-        "filename": f"fribidi-{FRIBIDI_VERSION}.zip",
-        "dir": f"fribidi-{FRIBIDI_VERSION}",
+        "url": f"https://github.com/fribidi/fribidi/archive/v{V['FRIBIDI']}.zip",
+        "filename": f"fribidi-{V['FRIBIDI']}.zip",
+        "dir": f"fribidi-{V['FRIBIDI']}",
         "license": "COPYING",
         "build": [
-            cmd_copy(r"COPYING", rf"{{bin_dir}}\fribidi-{FRIBIDI_VERSION}-COPYING"),
+            cmd_copy(r"COPYING", rf"{{bin_dir}}\fribidi-{V['FRIBIDI']}-COPYING"),
             cmd_copy(r"{winbuild_dir}\fribidi.cmake", r"CMakeLists.txt"),
             # generated tab.i files cannot be cross-compiled
             " ^&^& ".join(

From bdabbd6b0f8f8dd190b6a88b24a3b8087b327572 Mon Sep 17 00:00:00 2001
From: Andrew Murray <radarhere@users.noreply.github.com>
Date: Fri, 1 Mar 2024 08:21:14 +1100
Subject: [PATCH 0249/1178] Added sphinx-reredirects to docs Makefile

---
 docs/Makefile | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/docs/Makefile b/docs/Makefile
index 3b4deb9bf9d..24fd05aa25c 100644
--- a/docs/Makefile
+++ b/docs/Makefile
@@ -46,7 +46,7 @@ clean:
 	-rm -rf $(BUILDDIR)/*
 
 install-sphinx:
-	$(PYTHON) -m pip install --quiet furo olefile sphinx sphinx-copybutton sphinx-inline-tabs sphinx-removed-in sphinxext-opengraph
+	$(PYTHON) -m pip install --quiet furo olefile sphinx sphinx-copybutton sphinx-inline-tabs sphinx-removed-in sphinx-reredirects sphinxext-opengraph
 
 .PHONY: html
 html:

From 99c7f5405f96cc3b49b0536b6081e2ee418de55e Mon Sep 17 00:00:00 2001
From: Andrew Murray <radarhere@users.noreply.github.com>
Date: Fri, 1 Mar 2024 12:00:21 +1100
Subject: [PATCH 0250/1178] Do not use packaged pip

---
 .github/workflows/test-mingw.yml | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/.github/workflows/test-mingw.yml b/.github/workflows/test-mingw.yml
index b4e479f123e..a07a27c4631 100644
--- a/.github/workflows/test-mingw.yml
+++ b/.github/workflows/test-mingw.yml
@@ -67,10 +67,10 @@ jobs:
               mingw-w64-x86_64-python3-cffi \
               mingw-w64-x86_64-python3-numpy \
               mingw-w64-x86_64-python3-olefile \
-              mingw-w64-x86_64-python3-pip \
               mingw-w64-x86_64-python3-setuptools \
               mingw-w64-x86_64-python-pyqt6
 
+          python3 -m ensurepip
           python3 -m pip install pyroma pytest pytest-cov pytest-timeout
 
           pushd depends && ./install_extra_test_images.sh && popd

From 1f602433ddd408def888569c21eb5808f193f44e Mon Sep 17 00:00:00 2001
From: Andrew Murray <radarhere@users.noreply.github.com>
Date: Fri, 1 Mar 2024 21:33:26 +1100
Subject: [PATCH 0251/1178] Update CHANGES.rst [ci skip]

---
 CHANGES.rst | 3 +++
 1 file changed, 3 insertions(+)

diff --git a/CHANGES.rst b/CHANGES.rst
index 205ffa29482..a4e90cf5c19 100644
--- a/CHANGES.rst
+++ b/CHANGES.rst
@@ -5,6 +5,9 @@ Changelog (Pillow)
 10.3.0 (unreleased)
 -------------------
 
+- Match mask size to pasted image size in GifImagePlugin #7779
+  [radarhere]
+
 - Release GIL while calling ``WebPAnimDecoderGetNext`` #7782
   [evanmiller, radarhere]
 

From 334c26d80b35ba08265bb1008c9fafa552b31d21 Mon Sep 17 00:00:00 2001
From: Andrew Murray <radarhere@users.noreply.github.com>
Date: Fri, 1 Mar 2024 22:27:26 +1100
Subject: [PATCH 0252/1178] Update CHANGES.rst [ci skip]

---
 CHANGES.rst | 3 +++
 1 file changed, 3 insertions(+)

diff --git a/CHANGES.rst b/CHANGES.rst
index a4e90cf5c19..7adcf1b400b 100644
--- a/CHANGES.rst
+++ b/CHANGES.rst
@@ -5,6 +5,9 @@ Changelog (Pillow)
 10.3.0 (unreleased)
 -------------------
 
+- Handle truncated chunks at the end of PNG images #7709
+  [lajiyuan, radarhere]
+
 - Match mask size to pasted image size in GifImagePlugin #7779
   [radarhere]
 

From c4234800a05e7df079a6266119b9e4cf2a92aca9 Mon Sep 17 00:00:00 2001
From: Yay295 <Yay295@users.noreply.github.com>
Date: Fri, 1 Mar 2024 08:47:50 -0600
Subject: [PATCH 0253/1178] parametrize test_seek_mode functions

---
 Tests/test_file_container.py | 41 +++++++++---------------------------
 1 file changed, 10 insertions(+), 31 deletions(-)

diff --git a/Tests/test_file_container.py b/Tests/test_file_container.py
index 813b444dbcf..1c1f58500be 100644
--- a/Tests/test_file_container.py
+++ b/Tests/test_file_container.py
@@ -21,9 +21,16 @@ def test_isatty() -> None:
     assert container.isatty() is False
 
 
-def test_seek_mode_0() -> None:
+@pytest.mark.parametrize(
+    "mode, expected_value",
+    (
+        (0, 33),
+        (1, 66),
+        (2, 100),
+    ),
+)
+def test_seek_mode(mode: int, expected_value: int) -> None:
     # Arrange
-    mode = 0
     with open(TEST_FILE, "rb") as fh:
         container = ContainerIO.ContainerIO(fh, 22, 100)
 
@@ -32,35 +39,7 @@ def test_seek_mode_0() -> None:
         container.seek(33, mode)
 
         # Assert
-        assert container.tell() == 33
-
-
-def test_seek_mode_1() -> None:
-    # Arrange
-    mode = 1
-    with open(TEST_FILE, "rb") as fh:
-        container = ContainerIO.ContainerIO(fh, 22, 100)
-
-        # Act
-        container.seek(33, mode)
-        container.seek(33, mode)
-
-        # Assert
-        assert container.tell() == 66
-
-
-def test_seek_mode_2() -> None:
-    # Arrange
-    mode = 2
-    with open(TEST_FILE, "rb") as fh:
-        container = ContainerIO.ContainerIO(fh, 22, 100)
-
-        # Act
-        container.seek(33, mode)
-        container.seek(33, mode)
-
-        # Assert
-        assert container.tell() == 100
+        assert container.tell() == expected_value
 
 
 @pytest.mark.parametrize("bytesmode", (True, False))

From 6d78d4276900121985e9460c6ec3b39225c56b72 Mon Sep 17 00:00:00 2001
From: Andrew Murray <radarhere@users.noreply.github.com>
Date: Sat, 2 Mar 2024 13:12:17 +1100
Subject: [PATCH 0254/1178] Added type hints

---
 Tests/check_imaging_leaks.py   |  5 +++-
 Tests/check_png_dos.py         |  3 +++
 Tests/helper.py                |  2 +-
 Tests/test_file_container.py   |  8 ++++---
 Tests/test_file_jpeg.py        | 43 ++++++++++++++++++++--------------
 Tests/test_file_jpeg2k.py      |  7 +++---
 Tests/test_file_libtiff.py     |  8 +++++--
 Tests/test_file_mpo.py         | 11 ++++-----
 Tests/test_file_png.py         |  6 ++---
 Tests/test_file_spider.py      |  7 +++---
 Tests/test_file_tiff.py        |  1 +
 Tests/test_image.py            |  4 ++--
 Tests/test_image_access.py     |  1 +
 Tests/test_image_fromqimage.py | 42 +++++++++++++++------------------
 Tests/test_image_paste.py      |  2 +-
 Tests/test_image_resample.py   |  2 +-
 Tests/test_image_resize.py     |  2 +-
 Tests/test_imagemorph.py       |  7 +++---
 Tests/test_imageops.py         | 15 +++++++++---
 Tests/test_imageops_usm.py     |  4 ++--
 Tests/test_imagesequence.py    |  3 ++-
 Tests/test_imageshow.py        |  5 ++--
 Tests/test_mode_i16.py         |  2 +-
 Tests/test_tiff_crashes.py     |  7 +++---
 src/PIL/EpsImagePlugin.py      |  2 +-
 src/PIL/Image.py               |  2 +-
 src/PIL/ImageFile.py           |  2 +-
 27 files changed, 115 insertions(+), 88 deletions(-)

diff --git a/Tests/check_imaging_leaks.py b/Tests/check_imaging_leaks.py
index 89016703942..231789ca0a0 100755
--- a/Tests/check_imaging_leaks.py
+++ b/Tests/check_imaging_leaks.py
@@ -23,7 +23,10 @@ def _get_mem_usage() -> float:
 
 
 def _test_leak(
-    min_iterations: int, max_iterations: int, fn: Callable[..., None], *args: Any
+    min_iterations: int,
+    max_iterations: int,
+    fn: Callable[..., Image.Image | None],
+    *args: Any,
 ) -> None:
     mem_limit = None
     for i in range(max_iterations):
diff --git a/Tests/check_png_dos.py b/Tests/check_png_dos.py
index d65ba6abc43..63d6657bc45 100644
--- a/Tests/check_png_dos.py
+++ b/Tests/check_png_dos.py
@@ -17,6 +17,7 @@ def test_ignore_dos_text() -> None:
     finally:
         ImageFile.LOAD_TRUNCATED_IMAGES = False
 
+    assert isinstance(im, PngImagePlugin.PngImageFile)
     for s in im.text.values():
         assert len(s) < 1024 * 1024, "Text chunk larger than 1M"
 
@@ -32,6 +33,7 @@ def test_dos_text() -> None:
         assert msg, "Decompressed Data Too Large"
         return
 
+    assert isinstance(im, PngImagePlugin.PngImageFile)
     for s in im.text.values():
         assert len(s) < 1024 * 1024, "Text chunk larger than 1M"
 
@@ -57,6 +59,7 @@ def test_dos_total_memory() -> None:
         return
 
     total_len = 0
+    assert isinstance(im2, PngImagePlugin.PngImageFile)
     for txt in im2.text.values():
         total_len += len(txt)
     assert total_len < 64 * 1024 * 1024, "Total text chunks greater than 64M"
diff --git a/Tests/helper.py b/Tests/helper.py
index b9888394659..9849bf65565 100644
--- a/Tests/helper.py
+++ b/Tests/helper.py
@@ -351,7 +351,7 @@ def is_mingw() -> bool:
 
 
 class CachedProperty:
-    def __init__(self, func: Callable[[Any], None]) -> None:
+    def __init__(self, func: Callable[[Any], Any]) -> None:
         self.func = func
 
     def __get__(self, instance: Any, cls: type[Any] | None = None) -> Any:
diff --git a/Tests/test_file_container.py b/Tests/test_file_container.py
index 1c1f58500be..7f76fb47a6a 100644
--- a/Tests/test_file_container.py
+++ b/Tests/test_file_container.py
@@ -1,5 +1,7 @@
 from __future__ import annotations
 
+from typing import Literal
+
 import pytest
 
 from PIL import ContainerIO, Image
@@ -22,14 +24,14 @@ def test_isatty() -> None:
 
 
 @pytest.mark.parametrize(
-    "mode, expected_value",
+    "mode, expected_position",
     (
         (0, 33),
         (1, 66),
         (2, 100),
     ),
 )
-def test_seek_mode(mode: int, expected_value: int) -> None:
+def test_seek_mode(mode: Literal[0, 1, 2], expected_position: int) -> None:
     # Arrange
     with open(TEST_FILE, "rb") as fh:
         container = ContainerIO.ContainerIO(fh, 22, 100)
@@ -39,7 +41,7 @@ def test_seek_mode(mode: int, expected_value: int) -> None:
         container.seek(33, mode)
 
         # Assert
-        assert container.tell() == expected_value
+        assert container.tell() == expected_position
 
 
 @pytest.mark.parametrize("bytesmode", (True, False))
diff --git a/Tests/test_file_jpeg.py b/Tests/test_file_jpeg.py
index 65424214838..33f8454021d 100644
--- a/Tests/test_file_jpeg.py
+++ b/Tests/test_file_jpeg.py
@@ -6,7 +6,7 @@
 from io import BytesIO
 from pathlib import Path
 from types import ModuleType
-from typing import Any
+from typing import Any, cast
 
 import pytest
 
@@ -45,14 +45,20 @@
 
 @skip_unless_feature("jpg")
 class TestFileJpeg:
-    def roundtrip(self, im: Image.Image, **options: Any) -> Image.Image:
+    def roundtrip_with_bytes(
+        self, im: Image.Image, **options: Any
+    ) -> tuple[JpegImagePlugin.JpegImageFile, int]:
         out = BytesIO()
         im.save(out, "JPEG", **options)
         test_bytes = out.tell()
         out.seek(0)
-        im = Image.open(out)
-        im.bytes = test_bytes  # for testing only
-        return im
+        reloaded = cast(JpegImagePlugin.JpegImageFile, Image.open(out))
+        return reloaded, test_bytes
+
+    def roundtrip(
+        self, im: Image.Image, **options: Any
+    ) -> JpegImagePlugin.JpegImageFile:
+        return self.roundtrip_with_bytes(im, **options)[0]
 
     def gen_random_image(self, size: tuple[int, int], mode: str = "RGB") -> Image.Image:
         """Generates a very hard to compress file
@@ -246,13 +252,13 @@ def test_large_icc_meta(self, tmp_path: Path) -> None:
             im.save(f, progressive=True, quality=94, exif=b" " * 43668)
 
     def test_optimize(self) -> None:
-        im1 = self.roundtrip(hopper())
-        im2 = self.roundtrip(hopper(), optimize=0)
-        im3 = self.roundtrip(hopper(), optimize=1)
+        im1, im1_bytes = self.roundtrip_with_bytes(hopper())
+        im2, im2_bytes = self.roundtrip_with_bytes(hopper(), optimize=0)
+        im3, im3_bytes = self.roundtrip_with_bytes(hopper(), optimize=1)
         assert_image_equal(im1, im2)
         assert_image_equal(im1, im3)
-        assert im1.bytes >= im2.bytes
-        assert im1.bytes >= im3.bytes
+        assert im1_bytes >= im2_bytes
+        assert im1_bytes >= im3_bytes
 
     def test_optimize_large_buffer(self, tmp_path: Path) -> None:
         # https://github.com/python-pillow/Pillow/issues/148
@@ -262,15 +268,15 @@ def test_optimize_large_buffer(self, tmp_path: Path) -> None:
         im.save(f, format="JPEG", optimize=True)
 
     def test_progressive(self) -> None:
-        im1 = self.roundtrip(hopper())
+        im1, im1_bytes = self.roundtrip_with_bytes(hopper())
         im2 = self.roundtrip(hopper(), progressive=False)
-        im3 = self.roundtrip(hopper(), progressive=True)
+        im3, im3_bytes = self.roundtrip_with_bytes(hopper(), progressive=True)
         assert not im1.info.get("progressive")
         assert not im2.info.get("progressive")
         assert im3.info.get("progressive")
 
         assert_image_equal(im1, im3)
-        assert im1.bytes >= im3.bytes
+        assert im1_bytes >= im3_bytes
 
     def test_progressive_large_buffer(self, tmp_path: Path) -> None:
         f = str(tmp_path / "temp.jpg")
@@ -341,6 +347,7 @@ def test_empty_exif_gps(self) -> None:
             assert exif.get_ifd(0x8825) == {}
 
             transposed = ImageOps.exif_transpose(im)
+        assert transposed is not None
         exif = transposed.getexif()
         assert exif.get_ifd(0x8825) == {}
 
@@ -419,14 +426,14 @@ def test_progressive_compat(self) -> None:
         assert im3.info.get("progression")
 
     def test_quality(self) -> None:
-        im1 = self.roundtrip(hopper())
-        im2 = self.roundtrip(hopper(), quality=50)
+        im1, im1_bytes = self.roundtrip_with_bytes(hopper())
+        im2, im2_bytes = self.roundtrip_with_bytes(hopper(), quality=50)
         assert_image(im1, im2.mode, im2.size)
-        assert im1.bytes >= im2.bytes
+        assert im1_bytes >= im2_bytes
 
-        im3 = self.roundtrip(hopper(), quality=0)
+        im3, im3_bytes = self.roundtrip_with_bytes(hopper(), quality=0)
         assert_image(im1, im3.mode, im3.size)
-        assert im2.bytes > im3.bytes
+        assert im2_bytes > im3_bytes
 
     def test_smooth(self) -> None:
         im1 = self.roundtrip(hopper())
diff --git a/Tests/test_file_jpeg2k.py b/Tests/test_file_jpeg2k.py
index fab19e2eab4..b7f8350c775 100644
--- a/Tests/test_file_jpeg2k.py
+++ b/Tests/test_file_jpeg2k.py
@@ -40,10 +40,8 @@
 def roundtrip(im: Image.Image, **options: Any) -> Image.Image:
     out = BytesIO()
     im.save(out, "JPEG2000", **options)
-    test_bytes = out.tell()
     out.seek(0)
     with Image.open(out) as im:
-        im.bytes = test_bytes  # for testing only
         im.load()
     return im
 
@@ -77,7 +75,9 @@ def test_invalid_file() -> None:
 def test_bytesio() -> None:
     with open("Tests/images/test-card-lossless.jp2", "rb") as f:
         data = BytesIO(f.read())
-    assert_image_similar_tofile(test_card, data, 1.0e-3)
+    with Image.open(data) as im:
+        im.load()
+        assert_image_similar(im, test_card, 1.0e-3)
 
 
 # These two test pre-written JPEG 2000 files that were not written with
@@ -340,6 +340,7 @@ def test_parser_feed() -> None:
     p.feed(data)
 
     # Assert
+    assert p.image is not None
     assert p.image.size == (640, 480)
 
 
diff --git a/Tests/test_file_libtiff.py b/Tests/test_file_libtiff.py
index 0994d99040e..908464a11b7 100644
--- a/Tests/test_file_libtiff.py
+++ b/Tests/test_file_libtiff.py
@@ -27,7 +27,7 @@
 
 @skip_unless_feature("libtiff")
 class LibTiffTestCase:
-    def _assert_noerr(self, tmp_path: Path, im: Image.Image) -> None:
+    def _assert_noerr(self, tmp_path: Path, im: TiffImagePlugin.TiffImageFile) -> None:
         """Helper tests that assert basic sanity about the g4 tiff reading"""
         # 1 bit
         assert im.mode == "1"
@@ -524,7 +524,8 @@ def test_bw_compression_w_rgb(self, compression: str, tmp_path: Path) -> None:
             im.save(out, compression=compression)
 
     def test_fp_leak(self) -> None:
-        im = Image.open("Tests/images/hopper_g4_500.tif")
+        im: Image.Image | None = Image.open("Tests/images/hopper_g4_500.tif")
+        assert im is not None
         fn = im.fp.fileno()
 
         os.fstat(fn)
@@ -716,6 +717,7 @@ def test_fd_duplication(self, tmp_path: Path) -> None:
                 f.write(src.read())
 
         im = Image.open(tmpfile)
+        assert isinstance(im, TiffImagePlugin.TiffImageFile)
         im.n_frames
         im.close()
         # Should not raise PermissionError.
@@ -1097,6 +1099,7 @@ def test_save_multistrip(self, compression: str, tmp_path: Path) -> None:
 
         with Image.open(out) as im:
             # Assert that there are multiple strips
+            assert isinstance(im, TiffImagePlugin.TiffImageFile)
             assert len(im.tag_v2[STRIPOFFSETS]) > 1
 
     @pytest.mark.parametrize("argument", (True, False))
@@ -1113,6 +1116,7 @@ def test_save_single_strip(self, argument: bool, tmp_path: Path) -> None:
             im.save(out, **arguments)
 
             with Image.open(out) as im:
+                assert isinstance(im, TiffImagePlugin.TiffImageFile)
                 assert len(im.tag_v2[STRIPOFFSETS]) == 1
         finally:
             TiffImagePlugin.STRIP_SIZE = 65536
diff --git a/Tests/test_file_mpo.py b/Tests/test_file_mpo.py
index 4fb00d6994a..f105428ca82 100644
--- a/Tests/test_file_mpo.py
+++ b/Tests/test_file_mpo.py
@@ -2,11 +2,11 @@
 
 import warnings
 from io import BytesIO
-from typing import Any
+from typing import Any, cast
 
 import pytest
 
-from PIL import Image
+from PIL import Image, MpoImagePlugin
 
 from .helper import (
     assert_image_equal,
@@ -20,14 +20,11 @@
 pytestmark = skip_unless_feature("jpg")
 
 
-def roundtrip(im: Image.Image, **options: Any) -> Image.Image:
+def roundtrip(im: Image.Image, **options: Any) -> MpoImagePlugin.MpoImageFile:
     out = BytesIO()
     im.save(out, "MPO", **options)
-    test_bytes = out.tell()
     out.seek(0)
-    im = Image.open(out)
-    im.bytes = test_bytes  # for testing only
-    return im
+    return cast(MpoImagePlugin.MpoImageFile, Image.open(out))
 
 
 @pytest.mark.parametrize("test_file", test_files)
diff --git a/Tests/test_file_png.py b/Tests/test_file_png.py
index 334839f5c38..379ef157beb 100644
--- a/Tests/test_file_png.py
+++ b/Tests/test_file_png.py
@@ -7,7 +7,7 @@
 from io import BytesIO
 from pathlib import Path
 from types import ModuleType
-from typing import Any
+from typing import Any, cast
 
 import pytest
 
@@ -59,11 +59,11 @@ def load(data: bytes) -> Image.Image:
     return Image.open(BytesIO(data))
 
 
-def roundtrip(im: Image.Image, **options: Any) -> Image.Image:
+def roundtrip(im: Image.Image, **options: Any) -> PngImagePlugin.PngImageFile:
     out = BytesIO()
     im.save(out, "PNG", **options)
     out.seek(0)
-    return Image.open(out)
+    return cast(PngImagePlugin.PngImageFile, Image.open(out))
 
 
 @skip_unless_feature("zlib")
diff --git a/Tests/test_file_spider.py b/Tests/test_file_spider.py
index 75fef1dc6b6..fe71435cce2 100644
--- a/Tests/test_file_spider.py
+++ b/Tests/test_file_spider.py
@@ -9,7 +9,7 @@
 
 from PIL import Image, ImageSequence, SpiderImagePlugin
 
-from .helper import assert_image_equal_tofile, hopper, is_pypy
+from .helper import assert_image_equal, hopper, is_pypy
 
 TEST_FILE = "Tests/images/hopper.spider"
 
@@ -152,7 +152,7 @@ def test_nonstack_dos() -> None:
             assert i <= 1, "Non-stack DOS file test failed"
 
 
-# for issue #4093
+# for issue #4093s
 def test_odd_size() -> None:
     data = BytesIO()
     width = 100
@@ -160,4 +160,5 @@ def test_odd_size() -> None:
     im.save(data, format="SPIDER")
 
     data.seek(0)
-    assert_image_equal_tofile(im, data)
+    with Image.open(data) as im2:
+        assert_image_equal(im, im2)
diff --git a/Tests/test_file_tiff.py b/Tests/test_file_tiff.py
index 0110948aeac..21d52462e91 100644
--- a/Tests/test_file_tiff.py
+++ b/Tests/test_file_tiff.py
@@ -623,6 +623,7 @@ def test_rowsperstrip(self, tmp_path: Path) -> None:
         im.save(outfile, tiffinfo={278: 256})
 
         with Image.open(outfile) as im:
+            assert isinstance(im, TiffImagePlugin.TiffImageFile)
             assert im.tag_v2[278] == 256
 
     def test_strip_raw(self) -> None:
diff --git a/Tests/test_image.py b/Tests/test_image.py
index 2a4d453e2eb..b4e8e660c8c 100644
--- a/Tests/test_image.py
+++ b/Tests/test_image.py
@@ -138,13 +138,13 @@ def test_width_height(self) -> None:
         assert im.height == 2
 
         with pytest.raises(AttributeError):
-            im.size = (3, 4)
+            im.size = (3, 4)  # type: ignore[misc]
 
     def test_set_mode(self) -> None:
         im = Image.new("RGB", (1, 1))
 
         with pytest.raises(AttributeError):
-            im.mode = "P"
+            im.mode = "P"  # type: ignore[misc]
 
     def test_invalid_image(self) -> None:
         im = io.BytesIO(b"")
diff --git a/Tests/test_image_access.py b/Tests/test_image_access.py
index 380b89de86f..8c42da57a37 100644
--- a/Tests/test_image_access.py
+++ b/Tests/test_image_access.py
@@ -14,6 +14,7 @@
 
 # CFFI imports pycparser which doesn't support PYTHONOPTIMIZE=2
 # https://github.com/eliben/pycparser/pull/198#issuecomment-317001670
+cffi: ModuleType | None
 if os.environ.get("PYTHONOPTIMIZE") == "2":
     cffi = None
 else:
diff --git a/Tests/test_image_fromqimage.py b/Tests/test_image_fromqimage.py
index ea31a9de913..c20123a1bbf 100644
--- a/Tests/test_image_fromqimage.py
+++ b/Tests/test_image_fromqimage.py
@@ -1,7 +1,6 @@
 from __future__ import annotations
 
 import warnings
-from typing import Generator
 
 import pytest
 
@@ -17,19 +16,16 @@
     not ImageQt.qt_is_installed, reason="Qt bindings are not installed"
 )
 
+ims = [
+    hopper(),
+    Image.open("Tests/images/transparent.png"),
+    Image.open("Tests/images/7x13.png"),
+]
 
-@pytest.fixture
-def test_images() -> Generator[Image.Image, None, None]:
-    ims = [
-        hopper(),
-        Image.open("Tests/images/transparent.png"),
-        Image.open("Tests/images/7x13.png"),
-    ]
-    try:
-        yield ims
-    finally:
-        for im in ims:
-            im.close()
+
+def teardown_module() -> None:
+    for im in ims:
+        im.close()
 
 
 def roundtrip(expected: Image.Image) -> None:
@@ -44,26 +40,26 @@ def roundtrip(expected: Image.Image) -> None:
         assert_image_equal(result, expected.convert("RGB"))
 
 
-def test_sanity_1(test_images: Generator[Image.Image, None, None]) -> None:
-    for im in test_images:
+def test_sanity_1() -> None:
+    for im in ims:
         roundtrip(im.convert("1"))
 
 
-def test_sanity_rgb(test_images: Generator[Image.Image, None, None]) -> None:
-    for im in test_images:
+def test_sanity_rgb() -> None:
+    for im in ims:
         roundtrip(im.convert("RGB"))
 
 
-def test_sanity_rgba(test_images: Generator[Image.Image, None, None]) -> None:
-    for im in test_images:
+def test_sanity_rgba() -> None:
+    for im in ims:
         roundtrip(im.convert("RGBA"))
 
 
-def test_sanity_l(test_images: Generator[Image.Image, None, None]) -> None:
-    for im in test_images:
+def test_sanity_l() -> None:
+    for im in ims:
         roundtrip(im.convert("L"))
 
 
-def test_sanity_p(test_images: Generator[Image.Image, None, None]) -> None:
-    for im in test_images:
+def test_sanity_p() -> None:
+    for im in ims:
         roundtrip(im.convert("P"))
diff --git a/Tests/test_image_paste.py b/Tests/test_image_paste.py
index 2966f724f4a..d8f6b65e0d8 100644
--- a/Tests/test_image_paste.py
+++ b/Tests/test_image_paste.py
@@ -32,7 +32,7 @@ def assert_9points_image(
     def assert_9points_paste(
         self,
         im: Image.Image,
-        im2: Image.Image,
+        im2: Image.Image | str | tuple[int, ...],
         mask: Image.Image,
         expected: list[tuple[int, int, int, int]],
     ) -> None:
diff --git a/Tests/test_image_resample.py b/Tests/test_image_resample.py
index 7090ff9cdb8..dbe19380831 100644
--- a/Tests/test_image_resample.py
+++ b/Tests/test_image_resample.py
@@ -237,7 +237,7 @@ def make_case(
         im = Image.new(mode, (512, 9), fill)
         return im.resize((9, 512), Image.Resampling.LANCZOS), im.load()[0, 0]
 
-    def run_case(self, case: tuple[Image.Image, Image.Image]) -> None:
+    def run_case(self, case: tuple[Image.Image, int | tuple[int, ...]]) -> None:
         channel, color = case
         px = channel.load()
         for x in range(channel.size[0]):
diff --git a/Tests/test_image_resize.py b/Tests/test_image_resize.py
index a64e4a84621..64098f80fb1 100644
--- a/Tests/test_image_resize.py
+++ b/Tests/test_image_resize.py
@@ -154,7 +154,7 @@ def test_enlarge_zero(self, resample: Image.Resampling) -> None:
 
     def test_unknown_filter(self) -> None:
         with pytest.raises(ValueError):
-            self.resize(hopper(), (10, 10), 9)
+            self.resize(hopper(), (10, 10), 9)  # type: ignore[arg-type]
 
     def test_cross_platform(self, tmp_path: Path) -> None:
         # This test is intended for only check for consistent behaviour across
diff --git a/Tests/test_imagemorph.py b/Tests/test_imagemorph.py
index 46b473d7ac8..32615cf0edb 100644
--- a/Tests/test_imagemorph.py
+++ b/Tests/test_imagemorph.py
@@ -73,15 +73,16 @@ def test_lut(op: str) -> None:
 
 
 def test_no_operator_loaded() -> None:
+    im = Image.new("L", (1, 1))
     mop = ImageMorph.MorphOp()
     with pytest.raises(Exception) as e:
-        mop.apply(None)
+        mop.apply(im)
     assert str(e.value) == "No operator loaded"
     with pytest.raises(Exception) as e:
-        mop.match(None)
+        mop.match(im)
     assert str(e.value) == "No operator loaded"
     with pytest.raises(Exception) as e:
-        mop.save_lut(None)
+        mop.save_lut("")
     assert str(e.value) == "No operator loaded"
 
 
diff --git a/Tests/test_imageops.py b/Tests/test_imageops.py
index b320e79c10e..d6bdaf45073 100644
--- a/Tests/test_imageops.py
+++ b/Tests/test_imageops.py
@@ -13,8 +13,12 @@
 )
 
 
-class Deformer:
-    def getmesh(self, im: Image.Image) -> list[tuple[tuple[int, ...], tuple[int, ...]]]:
+class Deformer(ImageOps.SupportsGetMesh):
+    def getmesh(
+        self, im: Image.Image
+    ) -> list[
+        tuple[tuple[int, int, int, int], tuple[int, int, int, int, int, int, int, int]]
+    ]:
         x, y = im.size
         return [((0, 0, x, y), (0, 0, x, 0, x, y, y, 0))]
 
@@ -376,6 +380,7 @@ def check(orientation_im: Image.Image) -> None:
                     else:
                         original_exif = im.info["exif"]
                     transposed_im = ImageOps.exif_transpose(im)
+                    assert transposed_im is not None
                     assert_image_similar(base_im, transposed_im, 17)
                     if orientation_im is base_im:
                         assert "exif" not in im.info
@@ -387,6 +392,7 @@ def check(orientation_im: Image.Image) -> None:
 
                     # Repeat the operation to test that it does not keep transposing
                     transposed_im2 = ImageOps.exif_transpose(transposed_im)
+                    assert transposed_im2 is not None
                     assert_image_equal(transposed_im2, transposed_im)
 
             check(base_im)
@@ -402,6 +408,7 @@ def check(orientation_im: Image.Image) -> None:
             assert im.getexif()[0x0112] == 3
 
             transposed_im = ImageOps.exif_transpose(im)
+            assert transposed_im is not None
             assert 0x0112 not in transposed_im.getexif()
 
             transposed_im._reload_exif()
@@ -414,12 +421,14 @@ def check(orientation_im: Image.Image) -> None:
         assert im.getexif()[0x0112] == 3
 
         transposed_im = ImageOps.exif_transpose(im)
+        assert transposed_im is not None
         assert 0x0112 not in transposed_im.getexif()
 
     # Orientation set directly on Image.Exif
     im = hopper()
     im.getexif()[0x0112] = 3
     transposed_im = ImageOps.exif_transpose(im)
+    assert transposed_im is not None
     assert 0x0112 not in transposed_im.getexif()
 
 
@@ -499,7 +508,7 @@ def test_autocontrast_mask_real_input() -> None:
 
 
 def test_autocontrast_preserve_tone() -> None:
-    def autocontrast(mode: str, preserve_tone: bool) -> Image.Image:
+    def autocontrast(mode: str, preserve_tone: bool) -> list[int]:
         im = hopper(mode)
         return ImageOps.autocontrast(im, preserve_tone=preserve_tone).histogram()
 
diff --git a/Tests/test_imageops_usm.py b/Tests/test_imageops_usm.py
index 519d791050d..c15907a554a 100644
--- a/Tests/test_imageops_usm.py
+++ b/Tests/test_imageops_usm.py
@@ -28,8 +28,8 @@ def test_filter_api(test_images: dict[str, Image.Image]) -> None:
     assert i.mode == "RGB"
     assert i.size == (128, 128)
 
-    test_filter = ImageFilter.UnsharpMask(2.0, 125, 8)
-    i = im.filter(test_filter)
+    test_filter2 = ImageFilter.UnsharpMask(2.0, 125, 8)
+    i = im.filter(test_filter2)
     assert i.mode == "RGB"
     assert i.size == (128, 128)
 
diff --git a/Tests/test_imagesequence.py b/Tests/test_imagesequence.py
index 7280dded01f..7f3a3d14181 100644
--- a/Tests/test_imagesequence.py
+++ b/Tests/test_imagesequence.py
@@ -26,7 +26,7 @@ def test_sanity(tmp_path: Path) -> None:
     assert index == 1
 
     with pytest.raises(AttributeError):
-        ImageSequence.Iterator(0)
+        ImageSequence.Iterator(0)  # type: ignore[arg-type]
 
 
 def test_iterator() -> None:
@@ -72,6 +72,7 @@ def test_consecutive() -> None:
         for frame in ImageSequence.Iterator(im):
             if first_frame is None:
                 first_frame = frame.copy()
+        assert first_frame is not None
         for frame in ImageSequence.Iterator(im):
             assert_image_equal(frame, first_frame)
             break
diff --git a/Tests/test_imageshow.py b/Tests/test_imageshow.py
index 8d741d94ada..4e9291fbbfb 100644
--- a/Tests/test_imageshow.py
+++ b/Tests/test_imageshow.py
@@ -68,10 +68,11 @@ def test_show_without_viewers() -> None:
 def test_viewer() -> None:
     viewer = ImageShow.Viewer()
 
-    assert viewer.get_format(None) is None
+    im = Image.new("L", (1, 1))
+    assert viewer.get_format(im) is None
 
     with pytest.raises(NotImplementedError):
-        viewer.get_command(None)
+        viewer.get_command("")
 
 
 @pytest.mark.parametrize("viewer", ImageShow._viewers)
diff --git a/Tests/test_mode_i16.py b/Tests/test_mode_i16.py
index 903f7e0c60e..1b01f95ce5b 100644
--- a/Tests/test_mode_i16.py
+++ b/Tests/test_mode_i16.py
@@ -78,7 +78,7 @@ def test_basic(tmp_path: Path, mode: str) -> None:
 
 
 def test_tobytes() -> None:
-    def tobytes(mode: str) -> Image.Image:
+    def tobytes(mode: str) -> bytes:
         return Image.new(mode, (1, 1), 1).tobytes()
 
     order = 1 if Image._ENDIAN == "<" else -1
diff --git a/Tests/test_tiff_crashes.py b/Tests/test_tiff_crashes.py
index f51e8b3a8bd..073e5415c41 100644
--- a/Tests/test_tiff_crashes.py
+++ b/Tests/test_tiff_crashes.py
@@ -47,9 +47,8 @@ def test_tiff_crashes(test_file: str) -> None:
         with Image.open(test_file) as im:
             im.load()
     except FileNotFoundError:
-        if not on_ci():
-            pytest.skip("test image not found")
-            return
-        raise
+        if on_ci():
+            raise
+        pytest.skip("test image not found")
     except OSError:
         pass
diff --git a/src/PIL/EpsImagePlugin.py b/src/PIL/EpsImagePlugin.py
index d2e60aa0759..726359c6741 100644
--- a/src/PIL/EpsImagePlugin.py
+++ b/src/PIL/EpsImagePlugin.py
@@ -38,7 +38,7 @@
 split = re.compile(r"^%%([^:]*):[ \t]*(.*)[ \t]*$")
 field = re.compile(r"^%[%!\w]([^:]*)[ \t]*$")
 
-gs_binary = None
+gs_binary: str | bool | None = None
 gs_windows_binary = None
 
 
diff --git a/src/PIL/Image.py b/src/PIL/Image.py
index ba81a22c7f0..b344e987e11 100644
--- a/src/PIL/Image.py
+++ b/src/PIL/Image.py
@@ -75,7 +75,7 @@ class DecompressionBombError(Exception):
 
 
 # Limit to around a quarter gigabyte for a 24-bit (3 bpp) image
-MAX_IMAGE_PIXELS = int(1024 * 1024 * 1024 // 4 // 3)
+MAX_IMAGE_PIXELS: int | None = int(1024 * 1024 * 1024 // 4 // 3)
 
 
 try:
diff --git a/src/PIL/ImageFile.py b/src/PIL/ImageFile.py
index e929b665e06..a654dea27da 100644
--- a/src/PIL/ImageFile.py
+++ b/src/PIL/ImageFile.py
@@ -384,7 +384,7 @@ class Parser:
     """
 
     incremental = None
-    image = None
+    image: Image.Image | None = None
     data = None
     decoder = None
     offset = 0

From d6a3f89e271f62a780c25e5e504bc84ba6b8576f Mon Sep 17 00:00:00 2001
From: Andrew Murray <radarhere@users.noreply.github.com>
Date: Sat, 2 Mar 2024 15:39:43 +1100
Subject: [PATCH 0255/1178] Open 16-bit grayscale PNGs as I;16

---
 Tests/images/16_bit_binary_pgm.png            | Bin 578 -> 0 bytes
 Tests/images/16_bit_binary_pgm.tiff           | Bin 0 -> 8134 bytes
 .../images/cmx3g8_wv_1998.260_0745_mcidas.png | Bin 305116 -> 0 bytes
 .../cmx3g8_wv_1998.260_0745_mcidas.tiff       | Bin 0 -> 2880134 bytes
 Tests/images/hopper_emboss.bmp                | Bin 49206 -> 49206 bytes
 Tests/images/hopper_emboss_I.png              | Bin 13273 -> 0 bytes
 Tests/images/hopper_emboss_more.bmp           | Bin 49206 -> 49206 bytes
 Tests/images/hopper_emboss_more_I.png         | Bin 14624 -> 0 bytes
 Tests/images/imagedraw_rectangle_I.png        | Bin 180 -> 0 bytes
 Tests/images/imagedraw_rectangle_I.tiff       | Bin 0 -> 20122 bytes
 Tests/test_file_mcidas.py                     |   2 +-
 Tests/test_file_png.py                        |   6 ++---
 Tests/test_file_ppm.py                        |   2 +-
 Tests/test_image_filter.py                    |  24 ++----------------
 Tests/test_imagedraw.py                       |   2 +-
 src/PIL/Image.py                              |   2 +-
 src/PIL/PngImagePlugin.py                     |   6 ++---
 src/libImaging/Convert.c                      |  16 ++++++++++++
 18 files changed, 28 insertions(+), 32 deletions(-)
 delete mode 100644 Tests/images/16_bit_binary_pgm.png
 create mode 100644 Tests/images/16_bit_binary_pgm.tiff
 delete mode 100644 Tests/images/cmx3g8_wv_1998.260_0745_mcidas.png
 create mode 100644 Tests/images/cmx3g8_wv_1998.260_0745_mcidas.tiff
 delete mode 100644 Tests/images/hopper_emboss_I.png
 delete mode 100644 Tests/images/hopper_emboss_more_I.png
 delete mode 100644 Tests/images/imagedraw_rectangle_I.png
 create mode 100644 Tests/images/imagedraw_rectangle_I.tiff

diff --git a/Tests/images/16_bit_binary_pgm.png b/Tests/images/16_bit_binary_pgm.png
deleted file mode 100644
index 918be1ad41d738db5afe429469538df9e580d7d9..0000000000000000000000000000000000000000
GIT binary patch
literal 0
HcmV?d00001

literal 578
zcmeAS@N?(olHy`uVBq!ia0vp^B0!uX03;Yb2TTqIQY`6?zK#rxZ3_%vOp6EdnUcKS
zUH<<US#5Y0$m1;Vh%5%u9$@TtGTV-Ufw9EX#W5t}aPL80cNqqThKJWDPV(psR=Vjj
z%_6&VbEi&cPSUg!QGGfSCn>82DMc#HK4B-bTr#q6iA<!@Y8SJKYVKZ3WIQ`_>L1q1
z{qwxDzj){Gw?)6NJgvI-RO`H|?TezqM@9b*J<U1#^h@LEkJZz!^q#&LJ^gU*^k#Lv
z-|;d3Qg*-jy8DgX&Nn7I{&?-k5!;>9v-^+F?loI?shG!vX~#}WkDbP(*O@n6{<j|Y
zR=xYG`$TsfX^%}x*NdMWYo{9f>{LwJ@>sh&JI}bpEGv&)mKCFxtS4-#_c(C+#VMyf
z7N7nw>2yHn=>sj^UrsIEe|Bm4<)!LRF4;c6H1*-7n~#Mo3tp}$uH5|Kl2}QmY++^X
zyH8$=D$hPm-RXU~$NTYKZ|CKwKif{<wZS|0&eO<s-W3OyKD)7W*U6_JH+iqPvb5;Z
z(~DcZD|dU}oOb%K*7Qr~^;9GEj@Ih6*2gw|)no0}`{}B;Gg;4ay53D)y_v7|Bt`Wa
z`}MBXSFJcPYu(b_w}BC%TH+c}l9E`GYL#4+3Zxi}3=B<l4S>iz#K_Rf*wV__0?4*9
kFqpgI_iPjmx%nxXX_dG&y!q;^4%EQl>FVdQ&MBb@0M*s{ZvX%Q

diff --git a/Tests/images/16_bit_binary_pgm.tiff b/Tests/images/16_bit_binary_pgm.tiff
new file mode 100644
index 0000000000000000000000000000000000000000..1ce808bcfbf463ace43cbf7b41905a4ac832a662
GIT binary patch
literal 8134
zcmb{1{YRZ)9LMqZIjt>;G}*B^v}~enB5M=b9I~m%rpYF<2a!!=Nn{h*M6!u&B6|?o
zL^hFZBAdt_L^hF4BAdu2l1-#t&Hcmq1Kt-eJ}%$;*ZaEe`%_(gj4U7<Vta^%lpn;R
z+!S&=mhpf8aL5@^-ksZ<mh+<dp0Ix)?b$?>Qw5Mro4*w0c$nW^J3FqM+hF>#1*S89
z!SrGiOnDn%y0Z?ZAHTqKVGT@gR>5@SCzu|rfa%XNn658@>C-nbomvFbvjs3^e+_SR
zQTsfYmgc}z^%+d#AHbBH4d<VzX9i5`@4(bB4W^kXFqOOo)8HhS;uGQCC2AQ5)50q-
zrN+QCItr%zm*HM4>KXyl>M)q<o`Y%X37Cq8z|=normaU{Y8n93TtAq~AA)JP4@^0|
zVCo1Tx~AoOV5;c`(?l1T3hsibw-Zbo9bjr~2h;3rFqO7~X{ZHEnYX~y+6<<}@T1IB
zc>_#iSHYBM1XFhdnAR?XslFae({*4fz6hp)S}<+bfT_6(O!Mc!R8a}0krbG6&w{D5
z0!%CAV5&V0rpc3FDl7$4UkR8tkAvx2F_=CUfvM~$n4T7bDJ%48rnV%Qz8?hB`2?6=
mhmzBDXg`?l=Yr{X4w$Zly4du7ADB*Lg6VN6s!gHtR@XmS-^@M$

literal 0
HcmV?d00001

diff --git a/Tests/images/cmx3g8_wv_1998.260_0745_mcidas.png b/Tests/images/cmx3g8_wv_1998.260_0745_mcidas.png
deleted file mode 100644
index 2b84283b7a934d492b5a4ef71fc072e7fcc638ef..0000000000000000000000000000000000000000
GIT binary patch
literal 0
HcmV?d00001

literal 305116
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

diff --git a/Tests/images/cmx3g8_wv_1998.260_0745_mcidas.tiff b/Tests/images/cmx3g8_wv_1998.260_0745_mcidas.tiff
new file mode 100644
index 0000000000000000000000000000000000000000..b72509cc4b3c57c901fb02c24c2b201e94d99fa3
GIT binary patch
literal 2880134
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%0Ae`LX{L@;Kj9
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

literal 0
HcmV?d00001

diff --git a/Tests/images/hopper_emboss.bmp b/Tests/images/hopper_emboss.bmp
index d8e001e2bd7a3345dc9fe53c9441f5869962ebd5..01d48fa3f48ee75744ca75acf8cc7ef5f414007c 100644
GIT binary patch
delta 18
acmdniz`U)2d4d}25k3ZnBOA534*&o^HU?_|

delta 18
acmdniz`U)2d4d}2VLk?i!yC1^4*&o^C<bW&

diff --git a/Tests/images/hopper_emboss_I.png b/Tests/images/hopper_emboss_I.png
deleted file mode 100644
index f4dab388fe5c2dce3771133525df2c09b0fada45..0000000000000000000000000000000000000000
GIT binary patch
literal 0
HcmV?d00001

literal 13273
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
Xz<d1SpzCTq00000NkvXXu0mjf^afVs

diff --git a/Tests/images/hopper_emboss_more.bmp b/Tests/images/hopper_emboss_more.bmp
index 37a5db83075d9ce6792cf2303246bc9ae42a8b0b..01247f97ed3efc6d98280e16bd88d9df8ec71ae7 100644
GIT binary patch
delta 18
acmdniz`U)2d4d}25k3ZnBOA534*&o^HU?_|

delta 18
acmdniz`U)2d4d}2VLk?i!yC1^4*&o^C<bW&

diff --git a/Tests/images/hopper_emboss_more_I.png b/Tests/images/hopper_emboss_more_I.png
deleted file mode 100644
index c417c915f54a4573c80144d9a7982efbf8c6961e..0000000000000000000000000000000000000000
GIT binary patch
literal 0
HcmV?d00001

literal 14624
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
WC}ig2^aR-e0000<MNUMnLSTY(9=)mn

diff --git a/Tests/images/imagedraw_rectangle_I.png b/Tests/images/imagedraw_rectangle_I.png
deleted file mode 100644
index a75f12c2e98f417e662f2661eab980b45b61cde1..0000000000000000000000000000000000000000
GIT binary patch
literal 0
HcmV?d00001

literal 180
zcmeAS@N?(olHy`uVBq!ia0vp^DIhEWBp6sF#ZCjMYEKu(kcv5PZ|&r5Fc4vNbog@L
zNW>wfJGnLOlm7m*dv!o+52RoFIQj98`eRqEHs)NAR(zbF<A3Hy(*!9+Q>Uz!D;z5Y
ugOr!JdGrzxcxJBn`^-h_`WGNGAN=>LVdY3T$Fo)n#PxLbb6Mw<&;$UZr9Vjk

diff --git a/Tests/images/imagedraw_rectangle_I.tiff b/Tests/images/imagedraw_rectangle_I.tiff
new file mode 100644
index 0000000000000000000000000000000000000000..9b9eda883a371d9cc88b4677b09d2e351c42e609
GIT binary patch
literal 20122
zcmeI&F$%&!6h+Y=Bch!)+E`e-lQgcvRk-;$N{W=PF$6gQVHmDR4zF|=?zOL~Lshq}
zuAQFk)6LGCuK(U2+kHQsKizJ2K280r-JfUQy-erZqv|^ATjn7^fB*pk1PBlyK!5-N
z0t5&UAV6T10^=gj?_Yf!{YEOlDwV2Y#VQxbOS@u~3*@C;vC0MV(ymzL0(ogyta5?8
zv@2G*KwjDvt6U&2?TS?{ke7DFDi_F0yJD3K<fUD)$_4V$u2|&)d1+Uya)G?GD^|Hc
qUfLC_Tp%z1XID%7Aue}S5+Fc;009C72oNAZfB*pk1PBmVzrY)UtC9==

literal 0
HcmV?d00001

diff --git a/Tests/test_file_mcidas.py b/Tests/test_file_mcidas.py
index 2c94fdc3911..e11e6bb5284 100644
--- a/Tests/test_file_mcidas.py
+++ b/Tests/test_file_mcidas.py
@@ -19,7 +19,7 @@ def test_valid_file() -> None:
     # https://ghrc.nsstc.nasa.gov/hydro/details/cmx3g8
     # https://ghrc.nsstc.nasa.gov/pub/fieldCampaigns/camex3/cmx3g8/browse/
     test_file = "Tests/images/cmx3g8_wv_1998.260_0745_mcidas.ara"
-    saved_file = "Tests/images/cmx3g8_wv_1998.260_0745_mcidas.png"
+    saved_file = "Tests/images/cmx3g8_wv_1998.260_0745_mcidas.tiff"
 
     # Act
     with Image.open(test_file) as im:
diff --git a/Tests/test_file_png.py b/Tests/test_file_png.py
index 334839f5c38..ddba4b5b45b 100644
--- a/Tests/test_file_png.py
+++ b/Tests/test_file_png.py
@@ -102,7 +102,7 @@ def test_sanity(self, tmp_path: Path) -> None:
             im = hopper(mode)
             im.save(test_file)
             with Image.open(test_file) as reloaded:
-                if mode in ("I;16", "I;16B"):
+                if mode in ("I", "I;16B"):
                     reloaded = reloaded.convert(mode)
                 assert_image_equal(reloaded, im)
 
@@ -304,8 +304,8 @@ def test_save_p_transparent_black(self, tmp_path: Path) -> None:
         assert im.getcolors() == [(100, (0, 0, 0, 0))]
 
     def test_save_grayscale_transparency(self, tmp_path: Path) -> None:
-        for mode, num_transparent in {"1": 1994, "L": 559, "I": 559}.items():
-            in_file = "Tests/images/" + mode.lower() + "_trns.png"
+        for mode, num_transparent in {"1": 1994, "L": 559, "I;16": 559}.items():
+            in_file = "Tests/images/" + mode.split(";")[0].lower() + "_trns.png"
             with Image.open(in_file) as im:
                 assert im.mode == mode
                 assert im.info["transparency"] == 255
diff --git a/Tests/test_file_ppm.py b/Tests/test_file_ppm.py
index 6e0fa32e49f..6a0a5a445a7 100644
--- a/Tests/test_file_ppm.py
+++ b/Tests/test_file_ppm.py
@@ -88,7 +88,7 @@ def test_16bit_pgm() -> None:
         assert im.size == (20, 100)
         assert im.get_format_mimetype() == "image/x-portable-graymap"
 
-        assert_image_equal_tofile(im, "Tests/images/16_bit_binary_pgm.png")
+        assert_image_equal_tofile(im, "Tests/images/16_bit_binary_pgm.tiff")
 
 
 def test_16bit_pgm_write(tmp_path: Path) -> None:
diff --git a/Tests/test_image_filter.py b/Tests/test_image_filter.py
index 6a10ae4532b..47f9ffa3db8 100644
--- a/Tests/test_image_filter.py
+++ b/Tests/test_image_filter.py
@@ -148,9 +148,7 @@ def test_kernel_not_enough_coefficients() -> None:
 @pytest.mark.parametrize("mode", ("L", "LA", "I", "RGB", "CMYK"))
 def test_consistency_3x3(mode: str) -> None:
     with Image.open("Tests/images/hopper.bmp") as source:
-        reference_name = "hopper_emboss"
-        reference_name += "_I.png" if mode == "I" else ".bmp"
-        with Image.open("Tests/images/" + reference_name) as reference:
+        with Image.open("Tests/images/hopper_emboss.bmp") as reference:
             kernel = ImageFilter.Kernel(
                 (3, 3),
                 # fmt: off
@@ -160,23 +158,13 @@ def test_consistency_3x3(mode: str) -> None:
                 # fmt: on
                 0.3,
             )
-            source = source.split() * 2
-            reference = reference.split() * 2
-
-            if mode == "I":
-                source = source[0].convert(mode)
-            else:
-                source = Image.merge(mode, source[: len(mode)])
-            reference = Image.merge(mode, reference[: len(mode)])
             assert_image_equal(source.filter(kernel), reference)
 
 
 @pytest.mark.parametrize("mode", ("L", "LA", "I", "RGB", "CMYK"))
 def test_consistency_5x5(mode: str) -> None:
     with Image.open("Tests/images/hopper.bmp") as source:
-        reference_name = "hopper_emboss_more"
-        reference_name += "_I.png" if mode == "I" else ".bmp"
-        with Image.open("Tests/images/" + reference_name) as reference:
+        with Image.open("Tests/images/hopper_emboss_more.bmp") as reference:
             kernel = ImageFilter.Kernel(
                 (5, 5),
                 # fmt: off
@@ -188,14 +176,6 @@ def test_consistency_5x5(mode: str) -> None:
                 # fmt: on
                 0.3,
             )
-            source = source.split() * 2
-            reference = reference.split() * 2
-
-            if mode == "I":
-                source = source[0].convert(mode)
-            else:
-                source = Image.merge(mode, source[: len(mode)])
-            reference = Image.merge(mode, reference[: len(mode)])
             assert_image_equal(source.filter(kernel), reference)
 
 
diff --git a/Tests/test_imagedraw.py b/Tests/test_imagedraw.py
index f7aea30348d..274753c6cee 100644
--- a/Tests/test_imagedraw.py
+++ b/Tests/test_imagedraw.py
@@ -753,7 +753,7 @@ def test_rectangle_I16(bbox: Coords) -> None:
     draw.rectangle(bbox, outline=0xFFFF)
 
     # Assert
-    assert_image_equal_tofile(im.convert("I"), "Tests/images/imagedraw_rectangle_I.png")
+    assert_image_equal_tofile(im, "Tests/images/imagedraw_rectangle_I.tiff")
 
 
 @pytest.mark.parametrize("bbox", BBOX)
diff --git a/src/PIL/Image.py b/src/PIL/Image.py
index ba81a22c7f0..5d9a3fb2151 100644
--- a/src/PIL/Image.py
+++ b/src/PIL/Image.py
@@ -978,7 +978,7 @@ def convert_transparency(m, v):
         delete_trns = False
         # transparency handling
         if has_transparency:
-            if (self.mode in ("1", "L", "I") and mode in ("LA", "RGBA")) or (
+            if (self.mode in ("1", "L", "I", "I;16") and mode in ("LA", "RGBA")) or (
                 self.mode == "RGB" and mode == "RGBA"
             ):
                 # Use transparent conversion to promote from transparent
diff --git a/src/PIL/PngImagePlugin.py b/src/PIL/PngImagePlugin.py
index 1248fb78529..35f38d67c48 100644
--- a/src/PIL/PngImagePlugin.py
+++ b/src/PIL/PngImagePlugin.py
@@ -62,7 +62,7 @@
     (2, 0): ("L", "L;2"),
     (4, 0): ("L", "L;4"),
     (8, 0): ("L", "L"),
-    (16, 0): ("I", "I;16B"),
+    (16, 0): ("I;16", "I;16B"),
     # Truecolour
     (8, 2): ("RGB", "RGB"),
     (16, 2): ("RGB", "RGB;16B"),
@@ -467,7 +467,7 @@ def chunk_tRNS(self, pos, length):
                 # otherwise, we have a byte string with one alpha value
                 # for each palette entry
                 self.im_info["transparency"] = s
-        elif self.im_mode in ("1", "L", "I"):
+        elif self.im_mode in ("1", "L", "I;16"):
             self.im_info["transparency"] = i16(s)
         elif self.im_mode == "RGB":
             self.im_info["transparency"] = i16(s), i16(s, 2), i16(s, 4)
@@ -1356,7 +1356,7 @@ def _save(im, fp, filename, chunk=putchunk, save_all=False):
                 transparency = max(0, min(255, transparency))
                 alpha = b"\xFF" * transparency + b"\0"
                 chunk(fp, b"tRNS", alpha[:alpha_bytes])
-        elif im.mode in ("1", "L", "I"):
+        elif im.mode in ("1", "L", "I", "I;16"):
             transparency = max(0, min(65535, transparency))
             chunk(fp, b"tRNS", o16(transparency))
         elif im.mode == "RGB":
diff --git a/src/libImaging/Convert.c b/src/libImaging/Convert.c
index 99d2a4ada70..2654fd40d64 100644
--- a/src/libImaging/Convert.c
+++ b/src/libImaging/Convert.c
@@ -878,6 +878,18 @@ I16B_L(UINT8 *out, const UINT8 *in, int xsize) {
     }
 }
 
+static void
+I16_RGB(UINT8 *out, const UINT8 *in, int xsize) {
+    int x;
+    for (x = 0; x < xsize; x++, in += 2) {
+        UINT8 v = in[1] == 0 ? in[0] : 255;
+        *out++ = v;
+        *out++ = v;
+        *out++ = v;
+        *out++ = 255;
+    }
+}
+
 static struct {
     const char *from;
     const char *to;
@@ -978,6 +990,7 @@ static struct {
 
     {"I", "I;16", I_I16L},
     {"I;16", "I", I16L_I},
+    {"I;16", "RGB", I16_RGB},
     {"L", "I;16", L_I16L},
     {"I;16", "L", I16L_L},
 
@@ -1678,6 +1691,7 @@ ImagingConvertTransparent(Imaging imIn, const char *mode, int r, int g, int b) {
         convert = rgb2rgba;
     } else if ((strcmp(imIn->mode, "1") == 0 ||
                 strcmp(imIn->mode, "I") == 0 ||
+                strcmp(imIn->mode, "I;16") == 0 ||
                 strcmp(imIn->mode, "L") == 0
                ) && (
                 strcmp(mode, "RGBA") == 0 ||
@@ -1687,6 +1701,8 @@ ImagingConvertTransparent(Imaging imIn, const char *mode, int r, int g, int b) {
             convert = bit2rgb;
         } else if (strcmp(imIn->mode, "I") == 0) {
             convert = i2rgb;
+        } else if (strcmp(imIn->mode, "I;16") == 0) {
+            convert = I16_RGB;
         } else {
             convert = l2rgb;
         }

From 970c691fa2fad58682030001719775de06a74f74 Mon Sep 17 00:00:00 2001
From: Andrew Murray <radarhere@users.noreply.github.com>
Date: Sat, 2 Mar 2024 16:55:21 +1100
Subject: [PATCH 0256/1178] Document --bugreport

---
 src/PIL/features.py | 3 +++
 1 file changed, 3 insertions(+)

diff --git a/src/PIL/features.py b/src/PIL/features.py
index 7c5112ef6e4..15ab6aa45c5 100644
--- a/src/PIL/features.py
+++ b/src/PIL/features.py
@@ -230,6 +230,9 @@ def pilinfo(out=None, supported_formats=True):
     """
     Prints information about this installation of Pillow.
     This function can be called with ``python3 -m PIL``.
+    It can also be called with ``python3 -m PIL --bugreport`` to have
+    "supported_formats" set to ``False``, omitting the list of all supported image
+    file formats.
 
     :param out:
         The output stream to print to. Defaults to ``sys.stdout`` if ``None``.

From 07bf12f015cd418378bbf753fea3799904e4493f Mon Sep 17 00:00:00 2001
From: Andrew Murray <radarhere@users.noreply.github.com>
Date: Sat, 2 Mar 2024 23:36:19 +1100
Subject: [PATCH 0257/1178] Build macOS arm64 wheels natively

---
 .github/workflows/wheels-dependencies.sh | 16 +++++-----------
 .github/workflows/wheels-test.sh         |  3 +++
 .github/workflows/wheels.yml             |  4 ++--
 3 files changed, 10 insertions(+), 13 deletions(-)

diff --git a/.github/workflows/wheels-dependencies.sh b/.github/workflows/wheels-dependencies.sh
index cc8d7e085f9..9645e16acef 100755
--- a/.github/workflows/wheels-dependencies.sh
+++ b/.github/workflows/wheels-dependencies.sh
@@ -62,7 +62,7 @@ function build_brotli {
 
 function build {
     if [[ -n "$IS_MACOS" ]] && [[ "$CIBW_ARCHS" == "arm64" ]]; then
-        export BUILD_PREFIX="/usr/local"
+        sudo chown -R runner /usr/local
     fi
     build_xz
     if [ -z "$IS_ALPINE" ] && [ -z "$IS_MACOS" ]; then
@@ -75,8 +75,8 @@ function build {
         build_simple xorgproto 2023.2 https://www.x.org/pub/individual/proto
         build_simple libXau 1.0.11 https://www.x.org/pub/individual/lib
         build_simple libpthread-stubs 0.5 https://xcb.freedesktop.org/dist
-        if [ -f /Library/Frameworks/Python.framework/Versions/Current/share/pkgconfig/xcb-proto.pc ]; then
-            cp /Library/Frameworks/Python.framework/Versions/Current/share/pkgconfig/xcb-proto.pc /Library/Frameworks/Python.framework/Versions/Current/lib/pkgconfig/xcb-proto.pc
+        if [[ "$CIBW_ARCHS" == "arm64" ]]; then
+            cp /usr/local/share/pkgconfig/xcb-proto.pc /usr/local/lib/pkgconfig
         fi
     else
         sed s/\${pc_sysrootdir\}// /usr/local/share/pkgconfig/xcb-proto.pc > /usr/local/lib/pkgconfig/xcb-proto.pc
@@ -87,11 +87,6 @@ function build {
     build_tiff
     build_libpng
     build_lcms2
-    if [[ -n "$IS_MACOS" ]] && [[ "$CIBW_ARCHS" == "arm64" ]]; then
-        for dylib in libjpeg.dylib libtiff.dylib liblcms2.dylib; do
-            cp $BUILD_PREFIX/lib/$dylib /opt/arm64-builds/lib
-        done
-    fi
     build_openjpeg
     if [ -f /usr/local/lib64/libopenjp2.so ]; then
         cp /usr/local/lib64/libopenjp2.so /usr/local/lib
@@ -131,14 +126,13 @@ curl -fsSL -o pillow-depends-main.zip https://github.com/python-pillow/pillow-de
 untar pillow-depends-main.zip
 
 if [[ -n "$IS_MACOS" ]]; then
-  # webp, libtiff, libxcb cause a conflict with building webp, libtiff, libxcb
+  # libtiff and libxcb cause a conflict with building libtiff and libxcb
   # libxau and libxdmcp cause an issue on macOS < 11
-  # if php is installed, brew tries to reinstall these after installing openblas
   # remove cairo to fix building harfbuzz on arm64
   # remove lcms2 and libpng to fix building openjpeg on arm64
   # remove zstd to avoid inclusion on x86_64
   # curl from brew requires zstd, use system curl
-  brew remove --ignore-dependencies webp libpng libtiff libxcb libxau libxdmcp curl php cairo lcms2 ghostscript zstd
+  brew remove --ignore-dependencies libpng libtiff libxcb libxau libxdmcp curl cairo lcms2 zstd
 
   brew install pkg-config
 fi
diff --git a/.github/workflows/wheels-test.sh b/.github/workflows/wheels-test.sh
index 207ec15678b..3fbf3be695b 100755
--- a/.github/workflows/wheels-test.sh
+++ b/.github/workflows/wheels-test.sh
@@ -4,6 +4,9 @@ set -e
 if [[ "$OSTYPE" == "darwin"* ]]; then
     brew install fribidi
     export PKG_CONFIG_PATH="/usr/local/opt/openblas/lib/pkgconfig"
+    if [ -f /opt/homebrew/lib/libfribidi.dylib ]; then
+        sudo cp /opt/homebrew/lib/libfribidi.dylib /usr/local/lib
+    fi
 elif [ "${AUDITWHEEL_POLICY::9}" == "musllinux" ]; then
     apk add curl fribidi
 else
diff --git a/.github/workflows/wheels.yml b/.github/workflows/wheels.yml
index 1140aaaad52..e4008489bdd 100644
--- a/.github/workflows/wheels.yml
+++ b/.github/workflows/wheels.yml
@@ -99,7 +99,7 @@ jobs:
             cibw_arch: x86_64
             macosx_deployment_target: "10.10"
           - name: "macOS arm64"
-            os: macos-latest
+            os: macos-14
             cibw_arch: arm64
             macosx_deployment_target: "11.0"
           - name: "manylinux2014 and musllinux x86_64"
@@ -132,7 +132,7 @@ jobs:
           CIBW_MANYLINUX_PYPY_X86_64_IMAGE: ${{ matrix.manylinux }}
           CIBW_MANYLINUX_X86_64_IMAGE: ${{ matrix.manylinux }}
           CIBW_SKIP: pp38-*
-          CIBW_TEST_SKIP: "*-macosx_arm64"
+          CIBW_TEST_SKIP: cp38-macosx_arm64
           MACOSX_DEPLOYMENT_TARGET: ${{ matrix.macosx_deployment_target }}
 
       - uses: actions/upload-artifact@v4

From d3a394fcbb4832d78c39042db56ea22ae88bde45 Mon Sep 17 00:00:00 2001
From: "renovate[bot]" <29139614+renovate[bot]@users.noreply.github.com>
Date: Sun, 3 Mar 2024 04:00:51 +0000
Subject: [PATCH 0258/1178] Update dependency mypy to v1.8.0

---
 .ci/requirements-mypy.txt | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/.ci/requirements-mypy.txt b/.ci/requirements-mypy.txt
index ed32694607d..3673e1d8131 100644
--- a/.ci/requirements-mypy.txt
+++ b/.ci/requirements-mypy.txt
@@ -1 +1 @@
-mypy==1.7.1
+mypy==1.8.0

From 1b7bcfb6e71bc2c8a02ee4334b8dbd3b5db6e6e6 Mon Sep 17 00:00:00 2001
From: Andrew Murray <radarhere@users.noreply.github.com>
Date: Sun, 3 Mar 2024 21:34:48 +1100
Subject: [PATCH 0259/1178] Update CHANGES.rst [ci skip]

---
 CHANGES.rst | 3 +++
 1 file changed, 3 insertions(+)

diff --git a/CHANGES.rst b/CHANGES.rst
index 7adcf1b400b..44dfa65f7a9 100644
--- a/CHANGES.rst
+++ b/CHANGES.rst
@@ -5,6 +5,9 @@ Changelog (Pillow)
 10.3.0 (unreleased)
 -------------------
 
+- Open 16-bit grayscale PNGs as I;16 #7849
+  [radarhere]
+
 - Handle truncated chunks at the end of PNG images #7709
   [lajiyuan, radarhere]
 

From 939da52203786a255327e64638ae845516c524b4 Mon Sep 17 00:00:00 2001
From: Andrew Murray <radarhere@users.noreply.github.com>
Date: Sun, 3 Mar 2024 21:42:21 +1100
Subject: [PATCH 0260/1178] Updated libxcb to 1.16.1

---
 .github/workflows/wheels-dependencies.sh | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/.github/workflows/wheels-dependencies.sh b/.github/workflows/wheels-dependencies.sh
index cc8d7e085f9..a8f212e6835 100755
--- a/.github/workflows/wheels-dependencies.sh
+++ b/.github/workflows/wheels-dependencies.sh
@@ -35,7 +35,7 @@ else
 fi
 LIBWEBP_VERSION=1.3.2
 BZIP2_VERSION=1.0.8
-LIBXCB_VERSION=1.16
+LIBXCB_VERSION=1.16.1
 BROTLI_VERSION=1.1.0
 
 if [[ -n "$IS_MACOS" ]] && [[ "$CIBW_ARCHS" == "x86_64" ]]; then

From 33d92819ef9e6327ec8e3fc2b2b68e9f05d65fc0 Mon Sep 17 00:00:00 2001
From: Hugo van Kemenade <1324225+hugovk@users.noreply.github.com>
Date: Sun, 3 Mar 2024 07:59:36 -0700
Subject: [PATCH 0261/1178] Include SF_PROJECTS in f-strings
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit

Co-authored-by: Ondrej Baranovič <ondreko.tiba@gmail.com>
---
 winbuild/build_prepare.py | 9 ++++-----
 1 file changed, 4 insertions(+), 5 deletions(-)

diff --git a/winbuild/build_prepare.py b/winbuild/build_prepare.py
index efffbf5acde..865e08c22f2 100644
--- a/winbuild/build_prepare.py
+++ b/winbuild/build_prepare.py
@@ -132,7 +132,7 @@ def cmd_msbuild(
 # dependencies, listed in order of compilation
 DEPS = {
     "libjpeg": {
-        "url": SF_PROJECTS + f"/libjpeg-turbo/files/{V['JPEGTURBO']}/"
+        "url": f"{SF_PROJECTS}/libjpeg-turbo/files/{V['JPEGTURBO']}/"
         f"libjpeg-turbo-{V['JPEGTURBO']}.tar.gz/download",
         "filename": f"libjpeg-turbo-{V['JPEGTURBO']}.tar.gz",
         "dir": f"libjpeg-turbo-{V['JPEGTURBO']}",
@@ -177,7 +177,7 @@ def cmd_msbuild(
         "libs": [r"*.lib"],
     },
     "xz": {
-        "url": SF_PROJECTS + f"/lzmautils/files/xz-{V['XZ']}.tar.gz/download",
+        "url": f"{SF_PROJECTS}/lzmautils/files/xz-{V['XZ']}.tar.gz/download",
         "filename": f"xz-{V['XZ']}.tar.gz",
         "dir": f"xz-{V['XZ']}",
         "license": "COPYING",
@@ -244,7 +244,7 @@ def cmd_msbuild(
         "libs": [r"libtiff\*.lib"],
     },
     "libpng": {
-        "url": SF_PROJECTS + f"/libpng/files/libpng{V['LIBPNG_XY']}/{V['LIBPNG']}/"
+        "url": f"{SF_PROJECTS}/libpng/files/libpng{V['LIBPNG_XY']}/{V['LIBPNG']}/"
         f"lpng{V['LIBPNG_DOTLESS']}.zip/download",
         "filename": f"lpng{V['LIBPNG_DOTLESS']}.zip",
         "dir": f"lpng{V['LIBPNG_DOTLESS']}",
@@ -305,8 +305,7 @@ def cmd_msbuild(
         "libs": [r"objs\{msbuild_arch}\Release Static\freetype.lib"],
     },
     "lcms2": {
-        "url": SF_PROJECTS
-        + f"/lcms/files/lcms/{V['LCMS2']}/lcms2-{V['LCMS2']}.tar.gz/download",
+        "url": f"{SF_PROJECTS}/lcms/files/lcms/{V['LCMS2']}/lcms2-{V['LCMS2']}.tar.gz/download",  # noqa: E501
         "filename": f"lcms2-{V['LCMS2']}.tar.gz",
         "dir": f"lcms2-{V['LCMS2']}",
         "license": "LICENSE",

From b3fa754e971722f31c4c75271d58062f3b15997b Mon Sep 17 00:00:00 2001
From: Hugo van Kemenade <1324225+hugovk@users.noreply.github.com>
Date: Sun, 3 Mar 2024 17:11:30 +0200
Subject: [PATCH 0262/1178] Don't shadow stdlib names

---
 winbuild/build_prepare.py | 18 +++++++++---------
 1 file changed, 9 insertions(+), 9 deletions(-)

diff --git a/winbuild/build_prepare.py b/winbuild/build_prepare.py
index 865e08c22f2..657e2f6ec23 100644
--- a/winbuild/build_prepare.py
+++ b/winbuild/build_prepare.py
@@ -87,7 +87,7 @@ def cmd_msbuild(
     file: str,
     configuration: str = "Release",
     target: str = "Build",
-    platform: str = "{msbuild_arch}",
+    plat: str = "{msbuild_arch}",
 ) -> str:
     return " ".join(
         [
@@ -95,7 +95,7 @@ def cmd_msbuild(
             f"{file}",
             f'/t:"{target}"',
             f'/p:Configuration="{configuration}"',
-            f"/p:Platform={platform}",
+            f"/p:Platform={plat}",
             "/m",
         ]
     )
@@ -567,7 +567,7 @@ def build_env(prefs: dict[str, str], verbose: bool) -> None:
 
 def build_dep(name: str, prefs: dict[str, str], verbose: bool) -> str:
     dep = DEPS[name]
-    dir = dep["dir"]
+    directory = dep["dir"]
     file = f"build_dep_{name}.cmd"
     license_dir = prefs["license_dir"]
     sources_dir = prefs["src_dir"]
@@ -579,18 +579,18 @@ def build_dep(name: str, prefs: dict[str, str], verbose: bool) -> str:
         licenses = [licenses]
     license_text = ""
     for license_file in licenses:
-        with open(os.path.join(sources_dir, dir, license_file)) as f:
+        with open(os.path.join(sources_dir, directory, license_file)) as f:
             license_text += f.read()
     if "license_pattern" in dep:
         match = re.search(dep["license_pattern"], license_text, re.DOTALL)
         license_text = "\n".join(match.groups())
     assert len(license_text) > 50
-    with open(os.path.join(license_dir, f"{dir}.txt"), "w") as f:
-        print(f"Writing license {dir}.txt")
+    with open(os.path.join(license_dir, f"{directory}.txt"), "w") as f:
+        print(f"Writing license {directory}.txt")
         f.write(license_text)
 
     for patch_file, patch_list in dep.get("patch", {}).items():
-        patch_file = os.path.join(sources_dir, dir, patch_file.format(**prefs))
+        patch_file = os.path.join(sources_dir, directory, patch_file.format(**prefs))
         with open(patch_file) as f:
             text = f.read()
         for patch_from, patch_to in patch_list.items():
@@ -602,13 +602,13 @@ def build_dep(name: str, prefs: dict[str, str], verbose: bool) -> str:
             print(f"Patching {patch_file}")
             f.write(text)
 
-    banner = f"Building {name} ({dir})"
+    banner = f"Building {name} ({directory})"
     lines = [
         r'call "{build_dir}\build_env.cmd"',
         "@echo " + ("=" * 70),
         f"@echo ==== {banner:<60} ====",
         "@echo " + ("=" * 70),
-        cmd_cd(os.path.join(sources_dir, dir)),
+        cmd_cd(os.path.join(sources_dir, directory)),
         *dep.get("build", []),
         *get_footer(dep),
     ]

From e2c267f0484d81f10b636ffeb810676db31448b8 Mon Sep 17 00:00:00 2001
From: Hugo van Kemenade <1324225+hugovk@users.noreply.github.com>
Date: Sun, 3 Mar 2024 17:11:59 +0200
Subject: [PATCH 0263/1178] Explicitly import urllib.error to avoid IDE warning

---
 winbuild/build_prepare.py | 1 +
 1 file changed, 1 insertion(+)

diff --git a/winbuild/build_prepare.py b/winbuild/build_prepare.py
index 657e2f6ec23..b9df8be6302 100644
--- a/winbuild/build_prepare.py
+++ b/winbuild/build_prepare.py
@@ -463,6 +463,7 @@ def find_msvs(architecture: str) -> dict[str, str] | None:
 
 
 def download_dep(url: str, file: str) -> None:
+    import urllib.error
     import urllib.request
 
     ex = None

From 91eb69c6b2235b01aaae5904b33185deea6257e9 Mon Sep 17 00:00:00 2001
From: Andrew Murray <radarhere@users.noreply.github.com>
Date: Mon, 4 Mar 2024 06:37:56 +1100
Subject: [PATCH 0264/1178] Fixed typo

---
 Tests/test_file_spider.py | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/Tests/test_file_spider.py b/Tests/test_file_spider.py
index fe71435cce2..9b82a962aee 100644
--- a/Tests/test_file_spider.py
+++ b/Tests/test_file_spider.py
@@ -152,7 +152,7 @@ def test_nonstack_dos() -> None:
             assert i <= 1, "Non-stack DOS file test failed"
 
 
-# for issue #4093s
+# for issue #4093
 def test_odd_size() -> None:
     data = BytesIO()
     width = 100

From 14f6a3445c674fbe1de609e7ebae0cc660c1e76c Mon Sep 17 00:00:00 2001
From: Andrew Murray <radarhere@users.noreply.github.com>
Date: Mon, 4 Mar 2024 07:43:40 +1100
Subject: [PATCH 0265/1178] Removed brew packages to avoid inclusion

---
 .github/workflows/wheels-dependencies.sh | 8 +++++++-
 1 file changed, 7 insertions(+), 1 deletion(-)

diff --git a/.github/workflows/wheels-dependencies.sh b/.github/workflows/wheels-dependencies.sh
index 9645e16acef..581c71253a2 100755
--- a/.github/workflows/wheels-dependencies.sh
+++ b/.github/workflows/wheels-dependencies.sh
@@ -130,9 +130,15 @@ if [[ -n "$IS_MACOS" ]]; then
   # libxau and libxdmcp cause an issue on macOS < 11
   # remove cairo to fix building harfbuzz on arm64
   # remove lcms2 and libpng to fix building openjpeg on arm64
-  # remove zstd to avoid inclusion on x86_64
+  # remove jpeg-turbo to avoid inclusion on arm64
+  # remove webp and zstd to avoid inclusion on x86_64
   # curl from brew requires zstd, use system curl
   brew remove --ignore-dependencies libpng libtiff libxcb libxau libxdmcp curl cairo lcms2 zstd
+  if [[ "$CIBW_ARCHS" == "arm64" ]]; then
+    brew remove --ignore-dependencies jpeg-turbo
+  else
+    brew remove --ignore-dependencies webp
+  fi
 
   brew install pkg-config
 fi

From a4ac095a4972d1fd7d9a4ee0b3c1b5de3eb9fdf3 Mon Sep 17 00:00:00 2001
From: Andrew Murray <3112309+radarhere@users.noreply.github.com>
Date: Mon, 4 Mar 2024 22:06:02 +1100
Subject: [PATCH 0266/1178] List extensions alphabetically

---
 docs/conf.py | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/docs/conf.py b/docs/conf.py
index b7ad570849d..40dd4d75899 100644
--- a/docs/conf.py
+++ b/docs/conf.py
@@ -35,8 +35,8 @@
     "sphinx_copybutton",
     "sphinx_inline_tabs",
     "sphinx_removed_in",
-    "sphinxext.opengraph",
     "sphinx_reredirects",
+    "sphinxext.opengraph",
 ]
 
 intersphinx_mapping = {"python": ("https://docs.python.org/3", None)}

From bc00c26edd6b556d0c429508daf47ec9bf9e0e76 Mon Sep 17 00:00:00 2001
From: Andrew Murray <radarhere@users.noreply.github.com>
Date: Mon, 4 Mar 2024 22:48:51 +1100
Subject: [PATCH 0267/1178] Corrected links

---
 Tests/test_file_jpeg.py | 2 +-
 src/PIL/JpegPresets.py  | 2 +-
 2 files changed, 2 insertions(+), 2 deletions(-)

diff --git a/Tests/test_file_jpeg.py b/Tests/test_file_jpeg.py
index 33f8454021d..b66fda8dd2b 100644
--- a/Tests/test_file_jpeg.py
+++ b/Tests/test_file_jpeg.py
@@ -825,7 +825,7 @@ def test_no_dpi_in_exif(self) -> None:
         with Image.open("Tests/images/no-dpi-in-exif.jpg") as im:
             # Act / Assert
             # "When the image resolution is unknown, 72 [dpi] is designated."
-            # https://exiv2.org/tags.html
+            # https://web.archive.org/web/20240227115053/https://exiv2.org/tags.html
             assert im.info.get("dpi") == (72, 72)
 
     def test_invalid_exif(self) -> None:
diff --git a/src/PIL/JpegPresets.py b/src/PIL/JpegPresets.py
index d0e64a35ee1..3aefa073ce2 100644
--- a/src/PIL/JpegPresets.py
+++ b/src/PIL/JpegPresets.py
@@ -37,7 +37,7 @@
 :func:`.JpegImagePlugin.get_sampling` function.
 
 In JPEG compressed data a JPEG marker is used instead of an EXIF tag.
-(ref.: https://exiv2.org/tags.html)
+(ref.: https://web.archive.org/web/20240227115053/https://exiv2.org/tags.html)
 
 
 Quantization tables

From 4dbc428434758463fadb7848fd71e747c2bb6af2 Mon Sep 17 00:00:00 2001
From: Nulano <nulano@nulano.eu>
Date: Mon, 4 Mar 2024 20:11:32 +0100
Subject: [PATCH 0268/1178] list both `python3 -m PIL --bugreport` and
 `features.pilinfo` in the issue template

---
 .github/ISSUE_TEMPLATE/ISSUE_REPORT.md | 6 +++++-
 1 file changed, 5 insertions(+), 1 deletion(-)

diff --git a/.github/ISSUE_TEMPLATE/ISSUE_REPORT.md b/.github/ISSUE_TEMPLATE/ISSUE_REPORT.md
index de1d14bb3e9..25768061cc4 100644
--- a/.github/ISSUE_TEMPLATE/ISSUE_REPORT.md
+++ b/.github/ISSUE_TEMPLATE/ISSUE_REPORT.md
@@ -49,7 +49,11 @@ Thank you.
 * Pillow: 
 
 ```text
-please paste here the output of the following Python code: `from PIL import features; features.pilinfo(supported_formats=False)`
+Please paste here the output of running `python3 -m PIL --bugreport`,
+or the output of the following Python code:
+
+from PIL import features
+features.pilinfo(supported_formats=False)
 ```
 
 <!--

From 07f2b965ed56919c11bf82735206efe895bc6a76 Mon Sep 17 00:00:00 2001
From: Nulano <nulano@nulano.eu>
Date: Mon, 4 Mar 2024 20:12:40 +0100
Subject: [PATCH 0269/1178] rename `--bugreport` to `--report`

---
 .github/ISSUE_TEMPLATE/ISSUE_REPORT.md | 2 +-
 src/PIL/__main__.py                    | 2 +-
 src/PIL/features.py                    | 2 +-
 3 files changed, 3 insertions(+), 3 deletions(-)

diff --git a/.github/ISSUE_TEMPLATE/ISSUE_REPORT.md b/.github/ISSUE_TEMPLATE/ISSUE_REPORT.md
index 25768061cc4..a895c55da0d 100644
--- a/.github/ISSUE_TEMPLATE/ISSUE_REPORT.md
+++ b/.github/ISSUE_TEMPLATE/ISSUE_REPORT.md
@@ -49,7 +49,7 @@ Thank you.
 * Pillow: 
 
 ```text
-Please paste here the output of running `python3 -m PIL --bugreport`,
+Please paste here the output of running `python3 -m PIL --report`,
 or the output of the following Python code:
 
 from PIL import features
diff --git a/src/PIL/__main__.py b/src/PIL/__main__.py
index 32de33624db..043156e892d 100644
--- a/src/PIL/__main__.py
+++ b/src/PIL/__main__.py
@@ -4,4 +4,4 @@
 
 from .features import pilinfo
 
-pilinfo(supported_formats="--bugreport" not in sys.argv)
+pilinfo(supported_formats="--report" not in sys.argv)
diff --git a/src/PIL/features.py b/src/PIL/features.py
index 15ab6aa45c5..a7384a0a0e9 100644
--- a/src/PIL/features.py
+++ b/src/PIL/features.py
@@ -230,7 +230,7 @@ def pilinfo(out=None, supported_formats=True):
     """
     Prints information about this installation of Pillow.
     This function can be called with ``python3 -m PIL``.
-    It can also be called with ``python3 -m PIL --bugreport`` to have
+    It can also be called with ``python3 -m PIL --report`` to have
     "supported_formats" set to ``False``, omitting the list of all supported image
     file formats.
 

From 71018badc0d88cb972c04f8eec4af274820c438a Mon Sep 17 00:00:00 2001
From: Hugo van Kemenade <1324225+hugovk@users.noreply.github.com>
Date: Mon, 4 Mar 2024 23:35:10 -0700
Subject: [PATCH 0270/1178] Remove unused LIBXCB constant

Co-authored-by: Andrew Murray <3112309+radarhere@users.noreply.github.com>
---
 winbuild/build_prepare.py | 1 -
 1 file changed, 1 deletion(-)

diff --git a/winbuild/build_prepare.py b/winbuild/build_prepare.py
index b9df8be6302..0abf624b7e2 100644
--- a/winbuild/build_prepare.py
+++ b/winbuild/build_prepare.py
@@ -118,7 +118,6 @@ def cmd_msbuild(
     "LCMS2": "2.16",
     "LIBPNG": "1.6.39",
     "LIBWEBP": "1.3.2",
-    "LIBXCB": "1.16",
     "OPENJPEG": "2.5.2",
     "TIFF": "4.6.0",
     "XZ": "5.4.5",

From fe8f829f5802c242252b8163351967ff07c52cbe Mon Sep 17 00:00:00 2001
From: Andrew Murray <3112309+radarhere@users.noreply.github.com>
Date: Wed, 6 Mar 2024 07:35:11 +1100
Subject: [PATCH 0271/1178] Mark file as orphan

---
 docs/installation.rst | 2 ++
 1 file changed, 2 insertions(+)

diff --git a/docs/installation.rst b/docs/installation.rst
index 57659ba48da..b4bf2fa00e8 100644
--- a/docs/installation.rst
+++ b/docs/installation.rst
@@ -1,3 +1,5 @@
+:orphan:
+
 Installation
 ============
 

From 7aba72a48f1b55a3716409f66e772af740f40616 Mon Sep 17 00:00:00 2001
From: Andrew Murray <radarhere@users.noreply.github.com>
Date: Wed, 6 Mar 2024 08:44:07 +1100
Subject: [PATCH 0272/1178] Removed unused sphinx-reredirects

---
 docs/Makefile  | 2 +-
 docs/conf.py   | 4 ----
 pyproject.toml | 1 -
 3 files changed, 1 insertion(+), 6 deletions(-)

diff --git a/docs/Makefile b/docs/Makefile
index 24fd05aa25c..3b4deb9bf9d 100644
--- a/docs/Makefile
+++ b/docs/Makefile
@@ -46,7 +46,7 @@ clean:
 	-rm -rf $(BUILDDIR)/*
 
 install-sphinx:
-	$(PYTHON) -m pip install --quiet furo olefile sphinx sphinx-copybutton sphinx-inline-tabs sphinx-removed-in sphinx-reredirects sphinxext-opengraph
+	$(PYTHON) -m pip install --quiet furo olefile sphinx sphinx-copybutton sphinx-inline-tabs sphinx-removed-in sphinxext-opengraph
 
 .PHONY: html
 html:
diff --git a/docs/conf.py b/docs/conf.py
index 40dd4d75899..97289c91d0c 100644
--- a/docs/conf.py
+++ b/docs/conf.py
@@ -35,7 +35,6 @@
     "sphinx_copybutton",
     "sphinx_inline_tabs",
     "sphinx_removed_in",
-    "sphinx_reredirects",
     "sphinxext.opengraph",
 ]
 
@@ -351,6 +350,3 @@
     "pillow-logo-dark-text-1280x640.png"
 )
 ogp_image_alt = "Pillow"
-
-# sphinx-reredirects
-# redirects = {"installation.html": "installation/index.html"}
diff --git a/pyproject.toml b/pyproject.toml
index b09aa642c49..518facc34f7 100644
--- a/pyproject.toml
+++ b/pyproject.toml
@@ -46,7 +46,6 @@ docs = [
   "sphinx-copybutton",
   "sphinx-inline-tabs",
   "sphinx-removed-in",
-  "sphinx-reredirects",
   "sphinxext-opengraph",
 ]
 fpx = [

From 128d0edbd6101ce7b8a38755624186d59a9c0fc3 Mon Sep 17 00:00:00 2001
From: Hugo van Kemenade <1324225+hugovk@users.noreply.github.com>
Date: Wed, 6 Mar 2024 17:22:39 +0200
Subject: [PATCH 0273/1178] Move anchors back into place

---
 docs/installation/basic-installation.rst   | 8 --------
 docs/installation/building-from-source.rst | 6 ++++++
 2 files changed, 6 insertions(+), 8 deletions(-)

diff --git a/docs/installation/basic-installation.rst b/docs/installation/basic-installation.rst
index 486e6863b7b..01aae0406bb 100644
--- a/docs/installation/basic-installation.rst
+++ b/docs/installation/basic-installation.rst
@@ -87,11 +87,3 @@ and :pypi:`olefile` for Pillow to read FPX and MIC images::
         The `Pillow FreeBSD port
         <https://www.freshports.org/graphics/py-pillow/>`_ and packages
         are tested by the ports team with all supported FreeBSD versions.
-
-
-.. _Building on Linux:
-.. _Building on macOS:
-.. _Building on Windows:
-.. _Building on Windows using MSYS2/MinGW:
-.. _Building on FreeBSD:
-.. _Building on Android:
diff --git a/docs/installation/building-from-source.rst b/docs/installation/building-from-source.rst
index 8f4ef9e3e4a..4cb116a6a91 100644
--- a/docs/installation/building-from-source.rst
+++ b/docs/installation/building-from-source.rst
@@ -1,3 +1,9 @@
+.. _Building on Linux:
+.. _Building on macOS:
+.. _Building on Windows:
+.. _Building on Windows using MSYS2/MinGW:
+.. _Building on FreeBSD:
+.. _Building on Android:
 .. _building-from-source:
 
 Building From Source

From a027f698d2dead6dff22686ad8c78072d4768611 Mon Sep 17 00:00:00 2001
From: Hugo van Kemenade <1324225+hugovk@users.noreply.github.com>
Date: Wed, 6 Mar 2024 17:28:06 +0200
Subject: [PATCH 0274/1178] Fix ref link

---
 docs/installation/basic-installation.rst | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/docs/installation/basic-installation.rst b/docs/installation/basic-installation.rst
index 01aae0406bb..44e0f305242 100644
--- a/docs/installation/basic-installation.rst
+++ b/docs/installation/basic-installation.rst
@@ -68,7 +68,7 @@ and :pypi:`olefile` for Pillow to read FPX and MIC images::
         python3 -m pip install --upgrade pip
         python3 -m pip install --upgrade Pillow
 
-    To install Pillow in MSYS2, see `Building on Windows using MSYS2/MinGW`_.
+    To install Pillow in MSYS2, see :ref:`Building on Windows using MSYS2/MinGW`.
 
 .. tab:: FreeBSD
 

From 3106446dade24fd6ded018ac6492057589747bf5 Mon Sep 17 00:00:00 2001
From: Hugo van Kemenade <1324225+hugovk@users.noreply.github.com>
Date: Wed, 6 Mar 2024 17:29:16 +0200
Subject: [PATCH 0275/1178] Move short 'Old Versions' section to 'Building From
 Source' page

---
 docs/installation/building-from-source.rst | 9 +++++++++
 docs/installation/index.rst                | 1 -
 docs/installation/old-versions.rst         | 8 --------
 3 files changed, 9 insertions(+), 9 deletions(-)
 delete mode 100644 docs/installation/old-versions.rst

diff --git a/docs/installation/building-from-source.rst b/docs/installation/building-from-source.rst
index 4cb116a6a91..628acfc38a8 100644
--- a/docs/installation/building-from-source.rst
+++ b/docs/installation/building-from-source.rst
@@ -304,3 +304,12 @@ Build Options
 Sample usage::
 
     python3 -m pip install --upgrade Pillow -C [feature]=enable
+
+.. _old-versions:
+
+Old Versions
+============
+
+You can download old distributions from the `release history at PyPI
+<https://pypi.org/project/pillow/#history>`_ and by direct URL access
+eg. https://pypi.org/project/pillow/1.0/.
diff --git a/docs/installation/index.rst b/docs/installation/index.rst
index 9e6e5eeecdf..a94204b6bbe 100644
--- a/docs/installation/index.rst
+++ b/docs/installation/index.rst
@@ -8,4 +8,3 @@ Installation
   python-support
   platform-support
   building-from-source
-  old-versions
diff --git a/docs/installation/old-versions.rst b/docs/installation/old-versions.rst
deleted file mode 100644
index 445a70d4ebf..00000000000
--- a/docs/installation/old-versions.rst
+++ /dev/null
@@ -1,8 +0,0 @@
-.. _old-versions:
-
-Old Versions
-------------
-
-You can download old distributions from the `release history at PyPI
-<https://pypi.org/project/pillow/#history>`_ and by direct URL access
-eg. https://pypi.org/project/pillow/1.0/.

From e9f82959509192a96b933ee344baa580f4bc7a49 Mon Sep 17 00:00:00 2001
From: Hugo van Kemenade <1324225+hugovk@users.noreply.github.com>
Date: Wed, 6 Mar 2024 17:34:47 +0200
Subject: [PATCH 0276/1178] Consistent header underlines

---
 docs/installation/basic-installation.rst   | 2 +-
 docs/installation/building-from-source.rst | 8 ++++----
 docs/installation/platform-support.rst     | 6 +++---
 docs/installation/python-support.rst       | 2 +-
 4 files changed, 9 insertions(+), 9 deletions(-)

diff --git a/docs/installation/basic-installation.rst b/docs/installation/basic-installation.rst
index 44e0f305242..04d9aca0223 100644
--- a/docs/installation/basic-installation.rst
+++ b/docs/installation/basic-installation.rst
@@ -1,7 +1,7 @@
 .. _basic-installation:
 
 Basic Installation
-------------------
+==================
 
 .. note::
 
diff --git a/docs/installation/building-from-source.rst b/docs/installation/building-from-source.rst
index 628acfc38a8..6b24eeffa13 100644
--- a/docs/installation/building-from-source.rst
+++ b/docs/installation/building-from-source.rst
@@ -7,12 +7,12 @@
 .. _building-from-source:
 
 Building From Source
---------------------
+====================
 
 .. _external-libraries:
 
 External Libraries
-^^^^^^^^^^^^^^^^^^
+------------------
 
 .. note::
 
@@ -227,7 +227,7 @@ Many of Pillow's features require external libraries:
     This has been tested within the Termux app on ChromeOS, on x86.
 
 Installing
-^^^^^^^^^^
+----------
 
 Once you have installed the prerequisites, to install Pillow from the source
 code on PyPI, run::
@@ -262,7 +262,7 @@ After navigating to the Pillow directory, run::
 .. _compressed archive from PyPI: https://pypi.org/project/pillow/#files
 
 Build Options
-"""""""""""""
+^^^^^^^^^^^^^
 
 * Environment variable: ``MAX_CONCURRENCY=n``. Pillow can use
   multiprocessing to build the extension. Setting ``MAX_CONCURRENCY``
diff --git a/docs/installation/platform-support.rst b/docs/installation/platform-support.rst
index 602941c3c5a..9ae97d70ad2 100644
--- a/docs/installation/platform-support.rst
+++ b/docs/installation/platform-support.rst
@@ -1,7 +1,7 @@
 .. _platform-support:
 
 Platform Support
-----------------
+================
 
 Current platform support for Pillow. Binary distributions are
 contributed for each release on a volunteer basis, but the source
@@ -10,7 +10,7 @@ general, we aim to support all current versions of Linux, macOS, and
 Windows.
 
 Continuous Integration Targets
-^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
+------------------------------
 
 These platforms are built and tested for every change.
 
@@ -66,7 +66,7 @@ These platforms are built and tested for every change.
 
 
 Other Platforms
-^^^^^^^^^^^^^^^
+---------------
 
 These platforms have been reported to work at the versions mentioned.
 
diff --git a/docs/installation/python-support.rst b/docs/installation/python-support.rst
index 8d7db8d3a48..0b366a8cd5e 100644
--- a/docs/installation/python-support.rst
+++ b/docs/installation/python-support.rst
@@ -1,7 +1,7 @@
 .. _python-support:
 
 Python Support
---------------
+==============
 
 Pillow supports these Python versions.
 

From 6eb6b52a68992720db3c605f33fa27ac9fce19fd Mon Sep 17 00:00:00 2001
From: Hugo van Kemenade <1324225+hugovk@users.noreply.github.com>
Date: Wed, 6 Mar 2024 17:42:01 +0200
Subject: [PATCH 0277/1178] Fix tab activation per OS

---
 docs/installation/basic-installation.rst   | 8 ++++++++
 docs/installation/building-from-source.rst | 8 ++++++++
 2 files changed, 16 insertions(+)

diff --git a/docs/installation/basic-installation.rst b/docs/installation/basic-installation.rst
index 04d9aca0223..c2f889f0ef3 100644
--- a/docs/installation/basic-installation.rst
+++ b/docs/installation/basic-installation.rst
@@ -1,3 +1,11 @@
+.. raw:: html
+
+    <script>
+    document.addEventListener('DOMContentLoaded', function() {
+      activateTab(getOS());
+    });
+    </script>
+
 .. _basic-installation:
 
 Basic Installation
diff --git a/docs/installation/building-from-source.rst b/docs/installation/building-from-source.rst
index 6b24eeffa13..05e6572724a 100644
--- a/docs/installation/building-from-source.rst
+++ b/docs/installation/building-from-source.rst
@@ -1,3 +1,11 @@
+.. raw:: html
+
+    <script>
+    document.addEventListener('DOMContentLoaded', function() {
+      activateTab(getOS());
+    });
+    </script>
+
 .. _Building on Linux:
 .. _Building on macOS:
 .. _Building on Windows:

From c96cfffef6aea94fae42ba25dab3fe372744c260 Mon Sep 17 00:00:00 2001
From: Andrew Murray <radarhere@users.noreply.github.com>
Date: Thu, 7 Mar 2024 15:31:24 +1100
Subject: [PATCH 0278/1178] Updated libimagequant to 4.3.0

---
 depends/install_imagequant.sh              | 2 +-
 docs/installation/building-from-source.rst | 2 +-
 2 files changed, 2 insertions(+), 2 deletions(-)

diff --git a/depends/install_imagequant.sh b/depends/install_imagequant.sh
index 3adae91a525..973b4374fed 100755
--- a/depends/install_imagequant.sh
+++ b/depends/install_imagequant.sh
@@ -2,7 +2,7 @@
 # install libimagequant
 
 archive_name=libimagequant
-archive_version=4.2.2
+archive_version=4.3.0
 
 archive=$archive_name-$archive_version
 
diff --git a/docs/installation/building-from-source.rst b/docs/installation/building-from-source.rst
index 8f4ef9e3e4a..bcb25adf327 100644
--- a/docs/installation/building-from-source.rst
+++ b/docs/installation/building-from-source.rst
@@ -60,7 +60,7 @@ Many of Pillow's features require external libraries:
 
 * **libimagequant** provides improved color quantization
 
-  * Pillow has been tested with libimagequant **2.6-4.2.2**
+  * Pillow has been tested with libimagequant **2.6-4.3**
   * Libimagequant is licensed GPLv3, which is more restrictive than
     the Pillow license, therefore we will not be distributing binaries
     with libimagequant support enabled.

From d2d6beaf34b1775e5634bc1406e264b3b0c88b23 Mon Sep 17 00:00:00 2001
From: Andrew Murray <radarhere@users.noreply.github.com>
Date: Thu, 7 Mar 2024 19:24:37 +1100
Subject: [PATCH 0279/1178] Simplified anchors

---
 docs/installation/basic-installation.rst   | 2 +-
 docs/installation/building-from-source.rst | 6 ------
 docs/installation/python-support.rst       | 5 -----
 3 files changed, 1 insertion(+), 12 deletions(-)

diff --git a/docs/installation/basic-installation.rst b/docs/installation/basic-installation.rst
index c2f889f0ef3..01981aa4fbe 100644
--- a/docs/installation/basic-installation.rst
+++ b/docs/installation/basic-installation.rst
@@ -76,7 +76,7 @@ and :pypi:`olefile` for Pillow to read FPX and MIC images::
         python3 -m pip install --upgrade pip
         python3 -m pip install --upgrade Pillow
 
-    To install Pillow in MSYS2, see :ref:`Building on Windows using MSYS2/MinGW`.
+    To install Pillow in MSYS2, see :ref:`building-from-source`.
 
 .. tab:: FreeBSD
 
diff --git a/docs/installation/building-from-source.rst b/docs/installation/building-from-source.rst
index 05e6572724a..349d191a68a 100644
--- a/docs/installation/building-from-source.rst
+++ b/docs/installation/building-from-source.rst
@@ -6,12 +6,6 @@
     });
     </script>
 
-.. _Building on Linux:
-.. _Building on macOS:
-.. _Building on Windows:
-.. _Building on Windows using MSYS2/MinGW:
-.. _Building on FreeBSD:
-.. _Building on Android:
 .. _building-from-source:
 
 Building From Source
diff --git a/docs/installation/python-support.rst b/docs/installation/python-support.rst
index 0b366a8cd5e..dd5765b6b70 100644
--- a/docs/installation/python-support.rst
+++ b/docs/installation/python-support.rst
@@ -12,8 +12,3 @@ Pillow supports these Python versions.
 .. csv-table:: Older versions
    :file: older-versions.csv
    :header-rows: 1
-
-.. _Linux Installation:
-.. _macOS Installation:
-.. _Windows Installation:
-.. _FreeBSD Installation:

From 35b803091bb84ed920f26b9d51c2b97f89363400 Mon Sep 17 00:00:00 2001
From: Hugo van Kemenade <1324225+hugovk@users.noreply.github.com>
Date: Thu, 7 Mar 2024 13:39:27 +0200
Subject: [PATCH 0280/1178] Simplify rf to f-string

Co-authored-by: Andrew Murray <3112309+radarhere@users.noreply.github.com>
---
 winbuild/build_prepare.py | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/winbuild/build_prepare.py b/winbuild/build_prepare.py
index 0abf624b7e2..b87b828bfbc 100644
--- a/winbuild/build_prepare.py
+++ b/winbuild/build_prepare.py
@@ -255,7 +255,7 @@ def cmd_msbuild(
             ),
         ],
         "headers": [r"png*.h"],
-        "libs": [rf"libpng{V['LIBPNG_XY']}.lib"],
+        "libs": [f"libpng{V['LIBPNG_XY']}.lib"],
     },
     "brotli": {
         "url": f"https://github.com/google/brotli/archive/refs/tags/v{V['BROTLI']}.tar.gz",

From c4067b08eb2baf2c12de36d3bbbdd3771b5fcf8a Mon Sep 17 00:00:00 2001
From: Alex Clark <aclark@aclark.net>
Date: Thu, 7 Mar 2024 10:46:56 -0500
Subject: [PATCH 0281/1178] Update "What about PIL?" section

PyPI moderators gave PIL project to Pillow team in January 2020
---
 docs/about.rst                | 5 ++++-
 docs/conf.py                  | 2 +-
 docs/resources/css/strike.css | 3 +++
 3 files changed, 8 insertions(+), 2 deletions(-)
 create mode 100644 docs/resources/css/strike.css

diff --git a/docs/about.rst b/docs/about.rst
index cdb32ca5d10..73f7ac45db2 100644
--- a/docs/about.rst
+++ b/docs/about.rst
@@ -35,4 +35,7 @@ What about PIL?
     Prior to Pillow 2.0.0, very few image code changes were made. Pillow 2.0.0
     added Python 3 support and includes many bug fixes from many contributors.
 
-As more time passes since the last PIL release (1.1.7 in 2009), the likelihood of a new PIL release decreases. However, we've yet to hear an official "PIL is dead" announcement.
+.. role:: strike
+    :class: strike
+
+As more time passes since the last PIL release (1.1.7 in 2009), the likelihood of a new PIL release decreases. :strike:`However, we've yet to hear an official "PIL is dead" announcement.` In January 2020, `the PyPI moderators exhausted the PEP 541 process for contacting the PIL project owner <https://github.com/python-pillow/Pillow/issues/1535#issuecomment-570308446>`_ and the `PIL project on PyPI <https://pypi.org/project/PIL>`_ was transferred to the `Pillow team <https://github.com/python-pillow/Pillow/graphs/contributors>`_.
diff --git a/docs/conf.py b/docs/conf.py
index 97289c91d0c..d1505078db6 100644
--- a/docs/conf.py
+++ b/docs/conf.py
@@ -167,7 +167,7 @@
 # directly to the root of the documentation.
 # html_extra_path = []
 
-html_css_files = ["css/dark.css"]
+html_css_files = ["css/dark.css", "css/strike.css"]
 
 html_js_files = [
     "js/activate_tab.js",
diff --git a/docs/resources/css/strike.css b/docs/resources/css/strike.css
new file mode 100644
index 00000000000..1de4c484afe
--- /dev/null
+++ b/docs/resources/css/strike.css
@@ -0,0 +1,3 @@
+.strike {
+    text-decoration: line-through;
+}

From 2078eb4e4e96b298f6ff5702f06861604c1d32c5 Mon Sep 17 00:00:00 2001
From: Hugo van Kemenade <1324225+hugovk@users.noreply.github.com>
Date: Thu, 7 Mar 2024 18:44:38 +0200
Subject: [PATCH 0282/1178] Update CI targets on GitHub Actions

---
 docs/installation/platform-support.rst | 10 ++++++----
 1 file changed, 6 insertions(+), 4 deletions(-)

diff --git a/docs/installation/platform-support.rst b/docs/installation/platform-support.rst
index 9ae97d70ad2..a380c90122e 100644
--- a/docs/installation/platform-support.rst
+++ b/docs/installation/platform-support.rst
@@ -41,13 +41,15 @@ These platforms are built and tested for every change.
 +----------------------------------+----------------------------+---------------------+
 | Gentoo                           | 3.9                        | x86-64              |
 +----------------------------------+----------------------------+---------------------+
-| macOS 12 Monterey                | 3.8, 3.9, 3.10, 3.11,      | x86-64              |
-|                                  | 3.12, PyPy3                |                     |
+| macOS 12 Monterey                | 3.8, 3.9                   | x86-64              |
++----------------------------------+----------------------------+---------------------+
+| macOS 14 Sonoma                  | 3.10, 3.11, 3.12, 3.13     | arm64               |
+|                                  | PyPy3                      |                     |
 +----------------------------------+----------------------------+---------------------+
 | Ubuntu Linux 20.04 LTS (Focal)   | 3.8                        | x86-64              |
 +----------------------------------+----------------------------+---------------------+
 | Ubuntu Linux 22.04 LTS (Jammy)   | 3.8, 3.9, 3.10, 3.11,      | x86-64              |
-|                                  | 3.12, PyPy3                |                     |
+|                                  | 3.12, 3.13, PyPy3          |                     |
 |                                  +----------------------------+---------------------+
 |                                  | 3.10                       | arm64v8, ppc64le,   |
 |                                  |                            | s390x               |
@@ -55,7 +57,7 @@ These platforms are built and tested for every change.
 | Windows Server 2016              | 3.8                        | x86-64              |
 +----------------------------------+----------------------------+---------------------+
 | Windows Server 2022              | 3.8, 3.9, 3.10, 3.11,      | x86-64              |
-|                                  | 3.12, PyPy3                |                     |
+|                                  | 3.12, 3.13, PyPy3          |                     |
 |                                  +----------------------------+---------------------+
 |                                  | 3.12                       | x86                 |
 |                                  +----------------------------+---------------------+

From da5de3c115c6558042ef2861023fb1f7d4a71827 Mon Sep 17 00:00:00 2001
From: "Jeffrey A. Clark (Alex)" <aclark@aclark.net>
Date: Thu, 7 Mar 2024 11:50:22 -0500
Subject: [PATCH 0283/1178] Update docs/about.rst
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit

Co-authored-by: Ondrej Baranovič <nulano@nulano.eu>
---
 docs/about.rst | 5 +----
 1 file changed, 1 insertion(+), 4 deletions(-)

diff --git a/docs/about.rst b/docs/about.rst
index 73f7ac45db2..9cfda53a4b8 100644
--- a/docs/about.rst
+++ b/docs/about.rst
@@ -35,7 +35,4 @@ What about PIL?
     Prior to Pillow 2.0.0, very few image code changes were made. Pillow 2.0.0
     added Python 3 support and includes many bug fixes from many contributors.
 
-.. role:: strike
-    :class: strike
-
-As more time passes since the last PIL release (1.1.7 in 2009), the likelihood of a new PIL release decreases. :strike:`However, we've yet to hear an official "PIL is dead" announcement.` In January 2020, `the PyPI moderators exhausted the PEP 541 process for contacting the PIL project owner <https://github.com/python-pillow/Pillow/issues/1535#issuecomment-570308446>`_ and the `PIL project on PyPI <https://pypi.org/project/PIL>`_ was transferred to the `Pillow team <https://github.com/python-pillow/Pillow/graphs/contributors>`_.
+As more time passes since the last PIL release (1.1.7 in 2009), the likelihood of a new PIL release decreases. Although we've yet to hear an official "PIL is dead" announcement, in January 2020, `the PyPI moderators exhausted the PEP 541 process for contacting the PIL project owner <https://github.com/python-pillow/Pillow/issues/1535#issuecomment-570308446>`_ and the `PIL project on PyPI <https://pypi.org/project/PIL>`_ was transferred to the `Pillow team <https://github.com/python-pillow/Pillow/graphs/contributors>`_.

From debf5565251539623b1727a50084fa5c48ddc198 Mon Sep 17 00:00:00 2001
From: Alex Clark <aclark@aclark.net>
Date: Thu, 7 Mar 2024 11:59:50 -0500
Subject: [PATCH 0284/1178] Remove strike css

---
 docs/resources/css/strike.css | 3 ---
 1 file changed, 3 deletions(-)
 delete mode 100644 docs/resources/css/strike.css

diff --git a/docs/resources/css/strike.css b/docs/resources/css/strike.css
deleted file mode 100644
index 1de4c484afe..00000000000
--- a/docs/resources/css/strike.css
+++ /dev/null
@@ -1,3 +0,0 @@
-.strike {
-    text-decoration: line-through;
-}

From dec53f10d1273dbafb11144fd10b81fff3ce7322 Mon Sep 17 00:00:00 2001
From: Alex Clark <aclark@aclark.net>
Date: Thu, 7 Mar 2024 12:02:22 -0500
Subject: [PATCH 0285/1178] Wording

---
 docs/about.rst | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/docs/about.rst b/docs/about.rst
index 9cfda53a4b8..3e717e7981e 100644
--- a/docs/about.rst
+++ b/docs/about.rst
@@ -35,4 +35,4 @@ What about PIL?
     Prior to Pillow 2.0.0, very few image code changes were made. Pillow 2.0.0
     added Python 3 support and includes many bug fixes from many contributors.
 
-As more time passes since the last PIL release (1.1.7 in 2009), the likelihood of a new PIL release decreases. Although we've yet to hear an official "PIL is dead" announcement, in January 2020, `the PyPI moderators exhausted the PEP 541 process for contacting the PIL project owner <https://github.com/python-pillow/Pillow/issues/1535#issuecomment-570308446>`_ and the `PIL project on PyPI <https://pypi.org/project/PIL>`_ was transferred to the `Pillow team <https://github.com/python-pillow/Pillow/graphs/contributors>`_.
+The last PIL release was in 2009 (1.1.7) and no future releases are expected. In January 2020, `the PyPI moderators exhausted the PEP 541 process for contacting the PIL project owner <https://github.com/python-pillow/Pillow/issues/1535#issuecomment-570308446>`_ and the `PIL project on PyPI <https://pypi.org/project/PIL>`_ was transferred to the `Pillow team <https://github.com/python-pillow/Pillow/graphs/contributors>`_.

From 06c8edb98cbee22302da89b0b44bd77487cfb82d Mon Sep 17 00:00:00 2001
From: Alex Clark <aclark@aclark.net>
Date: Thu, 7 Mar 2024 12:06:04 -0500
Subject: [PATCH 0286/1178] Link to #1535

---
 docs/about.rst | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/docs/about.rst b/docs/about.rst
index 3e717e7981e..eb283247586 100644
--- a/docs/about.rst
+++ b/docs/about.rst
@@ -35,4 +35,4 @@ What about PIL?
     Prior to Pillow 2.0.0, very few image code changes were made. Pillow 2.0.0
     added Python 3 support and includes many bug fixes from many contributors.
 
-The last PIL release was in 2009 (1.1.7) and no future releases are expected. In January 2020, `the PyPI moderators exhausted the PEP 541 process for contacting the PIL project owner <https://github.com/python-pillow/Pillow/issues/1535#issuecomment-570308446>`_ and the `PIL project on PyPI <https://pypi.org/project/PIL>`_ was transferred to the `Pillow team <https://github.com/python-pillow/Pillow/graphs/contributors>`_.
+The last PIL release was in 2009 (1.1.7) and `no future releases are expected <https://github.com/python-pillow/Pillow/issues/1535>`_. In January 2020, `the PyPI moderators exhausted the PEP 541 process for contacting the PIL project owner <https://github.com/python-pillow/Pillow/issues/1535#issuecomment-570308446>`_ and the `PIL project on PyPI <https://pypi.org/project/PIL>`_ was transferred to the `Pillow team <https://github.com/python-pillow/Pillow/graphs/contributors>`_.

From e734dac917b006bb8cded1dc12cfdf453b6b5d77 Mon Sep 17 00:00:00 2001
From: Alex Clark <aclark@aclark.net>
Date: Thu, 7 Mar 2024 12:18:11 -0500
Subject: [PATCH 0287/1178] Remove strike config

---
 docs/conf.py | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/docs/conf.py b/docs/conf.py
index d1505078db6..97289c91d0c 100644
--- a/docs/conf.py
+++ b/docs/conf.py
@@ -167,7 +167,7 @@
 # directly to the root of the documentation.
 # html_extra_path = []
 
-html_css_files = ["css/dark.css", "css/strike.css"]
+html_css_files = ["css/dark.css"]
 
 html_js_files = [
     "js/activate_tab.js",

From f16600640999bddd7fcb6cb5c555fe93e4105edc Mon Sep 17 00:00:00 2001
From: Alex Clark <aclark@aclark.net>
Date: Thu, 7 Mar 2024 14:43:42 -0500
Subject: [PATCH 0288/1178] Wording

---
 docs/about.rst | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/docs/about.rst b/docs/about.rst
index eb283247586..ab1a3eb4acc 100644
--- a/docs/about.rst
+++ b/docs/about.rst
@@ -23,7 +23,7 @@ Like PIL, Pillow is `licensed under the open source HPND License <https://raw.gi
 Why a fork?
 -----------
 
-PIL is not setuptools compatible. Please see `this Image-SIG post`_ for a more detailed explanation. Also, PIL's current bi-yearly (or greater) release schedule is too infrequent to accommodate the large number and frequency of issues reported.
+PIL is not setuptools compatible. Please see `this Image-SIG post`_ for a more detailed explanation. Also, PIL's bi-yearly (or greater) release schedule was too infrequent to accommodate the large number and frequency of issues reported.
 
 .. _this Image-SIG post: https://mail.python.org/pipermail/image-sig/2010-August/006480.html
 

From 966d53b2418af4e598337f9fd97d7b5ac3c13508 Mon Sep 17 00:00:00 2001
From: Alex Clark <aclark@aclark.net>
Date: Thu, 7 Mar 2024 14:54:23 -0500
Subject: [PATCH 0289/1178] Wording

---
 docs/about.rst | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/docs/about.rst b/docs/about.rst
index ab1a3eb4acc..58be7676bab 100644
--- a/docs/about.rst
+++ b/docs/about.rst
@@ -35,4 +35,4 @@ What about PIL?
     Prior to Pillow 2.0.0, very few image code changes were made. Pillow 2.0.0
     added Python 3 support and includes many bug fixes from many contributors.
 
-The last PIL release was in 2009 (1.1.7) and `no future releases are expected <https://github.com/python-pillow/Pillow/issues/1535>`_. In January 2020, `the PyPI moderators exhausted the PEP 541 process for contacting the PIL project owner <https://github.com/python-pillow/Pillow/issues/1535#issuecomment-570308446>`_ and the `PIL project on PyPI <https://pypi.org/project/PIL>`_ was transferred to the `Pillow team <https://github.com/python-pillow/Pillow/graphs/contributors>`_.
+The last PIL release was in 2009 (1.1.7) and `no future releases are expected <https://github.com/python-pillow/Pillow/issues/1535>`_. In January 2020, `the PyPI moderators exhausted the PEP 541 process for contacting the PIL project owner <https://github.com/python-pillow/Pillow/issues/1535#issuecomment-570308446>`_ and the `PIL project on PyPI <https://pypi.org/project/PIL>`_ was transferred to the `Pillow team <https://github.com/python-pillow/Pillow/graphs/contributors>`_. The Pillow team has no plans to update the PIL project on PyPI. 

From 5e9ab05b039b2ba1eaf33b605807bb83812e6de1 Mon Sep 17 00:00:00 2001
From: "pre-commit-ci[bot]"
 <66853113+pre-commit-ci[bot]@users.noreply.github.com>
Date: Thu, 7 Mar 2024 19:55:38 +0000
Subject: [PATCH 0290/1178] [pre-commit.ci] auto fixes from pre-commit.com
 hooks

for more information, see https://pre-commit.ci
---
 docs/about.rst | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/docs/about.rst b/docs/about.rst
index 58be7676bab..98cdd8e5ab0 100644
--- a/docs/about.rst
+++ b/docs/about.rst
@@ -35,4 +35,4 @@ What about PIL?
     Prior to Pillow 2.0.0, very few image code changes were made. Pillow 2.0.0
     added Python 3 support and includes many bug fixes from many contributors.
 
-The last PIL release was in 2009 (1.1.7) and `no future releases are expected <https://github.com/python-pillow/Pillow/issues/1535>`_. In January 2020, `the PyPI moderators exhausted the PEP 541 process for contacting the PIL project owner <https://github.com/python-pillow/Pillow/issues/1535#issuecomment-570308446>`_ and the `PIL project on PyPI <https://pypi.org/project/PIL>`_ was transferred to the `Pillow team <https://github.com/python-pillow/Pillow/graphs/contributors>`_. The Pillow team has no plans to update the PIL project on PyPI. 
+The last PIL release was in 2009 (1.1.7) and `no future releases are expected <https://github.com/python-pillow/Pillow/issues/1535>`_. In January 2020, `the PyPI moderators exhausted the PEP 541 process for contacting the PIL project owner <https://github.com/python-pillow/Pillow/issues/1535#issuecomment-570308446>`_ and the `PIL project on PyPI <https://pypi.org/project/PIL>`_ was transferred to the `Pillow team <https://github.com/python-pillow/Pillow/graphs/contributors>`_. The Pillow team has no plans to update the PIL project on PyPI.

From 2833e367f57df53b865a9d78b70eb86d4176f7ef Mon Sep 17 00:00:00 2001
From: Hugo van Kemenade <1324225+hugovk@users.noreply.github.com>
Date: Fri, 8 Mar 2024 16:31:55 +0200
Subject: [PATCH 0291/1178] Remove comma

Co-authored-by: Andrew Murray <3112309+radarhere@users.noreply.github.com>
---
 docs/installation/platform-support.rst | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/docs/installation/platform-support.rst b/docs/installation/platform-support.rst
index a380c90122e..59fc312ab0b 100644
--- a/docs/installation/platform-support.rst
+++ b/docs/installation/platform-support.rst
@@ -43,7 +43,7 @@ These platforms are built and tested for every change.
 +----------------------------------+----------------------------+---------------------+
 | macOS 12 Monterey                | 3.8, 3.9                   | x86-64              |
 +----------------------------------+----------------------------+---------------------+
-| macOS 14 Sonoma                  | 3.10, 3.11, 3.12, 3.13     | arm64               |
+| macOS 14 Sonoma                  | 3.10, 3.11, 3.12, 3.13,    | arm64               |
 |                                  | PyPy3                      |                     |
 +----------------------------------+----------------------------+---------------------+
 | Ubuntu Linux 20.04 LTS (Focal)   | 3.8                        | x86-64              |

From 984893576f9038cbaa2932c3ef493b870438137c Mon Sep 17 00:00:00 2001
From: Hugo van Kemenade <1324225+hugovk@users.noreply.github.com>
Date: Fri, 8 Mar 2024 15:12:47 -0700
Subject: [PATCH 0292/1178] Remove unused pillow_dir

Co-authored-by: Andrew Murray <3112309+radarhere@users.noreply.github.com>
---
 winbuild/build_prepare.py | 2 --
 1 file changed, 2 deletions(-)

diff --git a/winbuild/build_prepare.py b/winbuild/build_prepare.py
index b87b828bfbc..99c7228faea 100644
--- a/winbuild/build_prepare.py
+++ b/winbuild/build_prepare.py
@@ -639,7 +639,6 @@ def build_dep_all(disabled: list[str], prefs: dict[str, str], verbose: bool) ->
 
 def main() -> None:
     winbuild_dir = os.path.dirname(os.path.realpath(__file__))
-    pillow_dir = os.path.realpath(os.path.join(winbuild_dir, ".."))
 
     parser = argparse.ArgumentParser(
         prog="winbuild\\build_prepare.py",
@@ -745,7 +744,6 @@ def main() -> None:
         "architecture": args.architecture,
         **arch_prefs,
         # Pillow paths
-        "pillow_dir": pillow_dir,
         "winbuild_dir": winbuild_dir,
         # Build paths
         "bin_dir": bin_dir,

From 38cec87c9360db5c78833da505efd50ac8e26a76 Mon Sep 17 00:00:00 2001
From: Richard Barnes <rbarnes@umn.edu>
Date: Sat, 9 Mar 2024 01:52:00 -0500
Subject: [PATCH 0293/1178] Fix shift-sign issue in Convert.c (#7838)

* Fix shift-sign issue in Convert.c

Fixes
```
libImaging/Convert.c:513:25: error: signed shift result (0xFF000000) sets the sign bit of the shift expression's type ('int') and becomes negative [-Werror,-Wshift-sign-overflow]
    UINT32 trns = (0xff << 24) | ((b & 0xff) << 16) | ((g & 0xff) << 8) | (r & 0xff);
                   ~~~~ ^  ~~
```

---------

Co-authored-by: Andrew Murray <3112309+radarhere@users.noreply.github.com>
---
 src/libImaging/Convert.c | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/src/libImaging/Convert.c b/src/libImaging/Convert.c
index 2654fd40d64..5cc39cd0019 100644
--- a/src/libImaging/Convert.c
+++ b/src/libImaging/Convert.c
@@ -510,7 +510,7 @@ rgbT2rgba(UINT8 *out, int xsize, int r, int g, int b) {
     UINT32 trns = ((r & 0xff) << 24) | ((g & 0xff) << 16) | ((b & 0xff) << 8) | 0xff;
     UINT32 repl = trns & 0xffffff00;
 #else
-    UINT32 trns = (0xff << 24) | ((b & 0xff) << 16) | ((g & 0xff) << 8) | (r & 0xff);
+    UINT32 trns = (0xffU << 24) | ((b & 0xff) << 16) | ((g & 0xff) << 8) | (r & 0xff);
     UINT32 repl = trns & 0x00ffffff;
 #endif
 

From 761c430294c66e95514829569c3ffb25bad9f387 Mon Sep 17 00:00:00 2001
From: Andrew Murray <radarhere@users.noreply.github.com>
Date: Sat, 9 Mar 2024 17:58:16 +1100
Subject: [PATCH 0294/1178] Update CHANGES.rst [ci skip]

---
 CHANGES.rst | 3 +++
 1 file changed, 3 insertions(+)

diff --git a/CHANGES.rst b/CHANGES.rst
index 44dfa65f7a9..243c6b82aa5 100644
--- a/CHANGES.rst
+++ b/CHANGES.rst
@@ -5,6 +5,9 @@ Changelog (Pillow)
 10.3.0 (unreleased)
 -------------------
 
+- Fix shift-sign issue in Convert.c #7838
+  [r-barnes, radarhere]
+
 - Open 16-bit grayscale PNGs as I;16 #7849
   [radarhere]
 

From f886766e3a702cead4fd36245bdd39002919c697 Mon Sep 17 00:00:00 2001
From: "renovate[bot]" <29139614+renovate[bot]@users.noreply.github.com>
Date: Sat, 9 Mar 2024 08:45:29 +0000
Subject: [PATCH 0295/1178] Update dependency mypy to v1.9.0

---
 .ci/requirements-mypy.txt | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/.ci/requirements-mypy.txt b/.ci/requirements-mypy.txt
index 3673e1d8131..6b0535fc1cf 100644
--- a/.ci/requirements-mypy.txt
+++ b/.ci/requirements-mypy.txt
@@ -1 +1 @@
-mypy==1.8.0
+mypy==1.9.0

From e5a46ef45dca79c024c5920a46909d8bba09a3ae Mon Sep 17 00:00:00 2001
From: Nulano <nulano@nulano.eu>
Date: Sat, 9 Mar 2024 14:58:05 +0100
Subject: [PATCH 0296/1178] add test for --report argument and
 features.pilinfo(supported_formats)

---
 Tests/test_features.py |  7 ++++---
 Tests/test_main.py     | 12 +++++++++---
 2 files changed, 13 insertions(+), 6 deletions(-)

diff --git a/Tests/test_features.py b/Tests/test_features.py
index 3fffa032f81..3a528a7c8c6 100644
--- a/Tests/test_features.py
+++ b/Tests/test_features.py
@@ -117,9 +117,10 @@ def test_unsupported_module() -> None:
         features.version_module(module)
 
 
-def test_pilinfo() -> None:
+@pytest.mark.parametrize("supported_formats", (True, False))
+def test_pilinfo(supported_formats) -> None:
     buf = io.StringIO()
-    features.pilinfo(buf)
+    features.pilinfo(buf, supported_formats=supported_formats)
     out = buf.getvalue()
     lines = out.splitlines()
     assert lines[0] == "-" * 68
@@ -148,4 +149,4 @@ def test_pilinfo() -> None:
         + "-" * 68
         + "\n"
     )
-    assert jpeg in out
+    assert supported_formats == (jpeg in out)
diff --git a/Tests/test_main.py b/Tests/test_main.py
index e13e0c5e3ac..9ed7fa3d662 100644
--- a/Tests/test_main.py
+++ b/Tests/test_main.py
@@ -4,9 +4,15 @@
 import subprocess
 import sys
 
+import pytest
 
-def test_main() -> None:
-    out = subprocess.check_output([sys.executable, "-m", "PIL"]).decode("utf-8")
+
+@pytest.mark.parametrize("report", (False, True))
+def test_main(report) -> None:
+    args = [sys.executable, "-m", "PIL"]
+    if report:
+        args.append("--report")
+    out = subprocess.check_output(args).decode("utf-8")
     lines = out.splitlines()
     assert lines[0] == "-" * 68
     assert lines[1].startswith("Pillow ")
@@ -37,4 +43,4 @@ def test_main() -> None:
         + "-" * 68
         + os.linesep
     )
-    assert jpeg in out
+    assert report == (jpeg not in out)

From a619a8de2fd82a16b497f7512fde3dd1cc3439b1 Mon Sep 17 00:00:00 2001
From: Nulano <nulano@nulano.eu>
Date: Sat, 9 Mar 2024 15:00:45 +0100
Subject: [PATCH 0297/1178] add PIL.report

---
 Tests/test_report.py | 27 +++++++++++++++++++++++++++
 src/PIL/report.py    |  5 +++++
 2 files changed, 32 insertions(+)
 create mode 100644 Tests/test_report.py
 create mode 100644 src/PIL/report.py

diff --git a/Tests/test_report.py b/Tests/test_report.py
new file mode 100644
index 00000000000..d0fc528860d
--- /dev/null
+++ b/Tests/test_report.py
@@ -0,0 +1,27 @@
+from __future__ import annotations
+
+import subprocess
+import sys
+
+
+def test_main() -> None:
+    args = [sys.executable, "-m", "PIL.report"]
+    out = subprocess.check_output(args).decode("utf-8")
+    lines = out.splitlines()
+    assert lines[0] == "-" * 68
+    assert lines[1].startswith("Pillow ")
+    assert lines[2].startswith("Python ")
+    lines = lines[3:]
+    while lines[0].startswith("    "):
+        lines = lines[1:]
+    assert lines[0] == "-" * 68
+    assert lines[1].startswith("Python executable is")
+    lines = lines[2:]
+    if lines[0].startswith("Environment Python files loaded from"):
+        lines = lines[1:]
+    assert lines[0].startswith("System Python files loaded from")
+    assert lines[1] == "-" * 68
+    assert lines[2].startswith("Python Pillow modules loaded from ")
+    assert lines[3].startswith("Binary Pillow modules loaded from ")
+    assert lines[4] == "-" * 68
+    assert "JPEG image/jpeg" not in out
diff --git a/src/PIL/report.py b/src/PIL/report.py
new file mode 100644
index 00000000000..d2815e8455e
--- /dev/null
+++ b/src/PIL/report.py
@@ -0,0 +1,5 @@
+from __future__ import annotations
+
+from .features import pilinfo
+
+pilinfo(supported_formats=False)

From 4a7a64292e3559f9dc13ae9be7dc70103820cfb7 Mon Sep 17 00:00:00 2001
From: Andrew Murray <radarhere@users.noreply.github.com>
Date: Mon, 11 Mar 2024 22:23:21 +1100
Subject: [PATCH 0298/1178] Update CHANGES.rst [ci skip]

---
 CHANGES.rst | 3 +++
 1 file changed, 3 insertions(+)

diff --git a/CHANGES.rst b/CHANGES.rst
index 243c6b82aa5..20da811ed1e 100644
--- a/CHANGES.rst
+++ b/CHANGES.rst
@@ -5,6 +5,9 @@ Changelog (Pillow)
 10.3.0 (unreleased)
 -------------------
 
+- Turn off nullability warnings for macOS SDK #7827
+  [radarhere]
+
 - Fix shift-sign issue in Convert.c #7838
   [r-barnes, radarhere]
 

From 87ed513f91d132e6eb48a02409f212ef0c2ae9a1 Mon Sep 17 00:00:00 2001
From: Yay295 <Yay295@gmail.com>
Date: Sun, 25 Dec 2022 18:41:21 -0600
Subject: [PATCH 0299/1178] support "RGBa" and "La" in hopper() test helper

---
 Tests/helper.py | 6 +++++-
 1 file changed, 5 insertions(+), 1 deletion(-)

diff --git a/Tests/helper.py b/Tests/helper.py
index 9849bf65565..a7691f64527 100644
--- a/Tests/helper.py
+++ b/Tests/helper.py
@@ -261,7 +261,11 @@ def hopper(mode: str | None = None, cache: dict[str, Image.Image] = {}) -> Image
     # (for fast, isolated, repeatable tests).
     im = cache.get(mode)
     if im is None:
-        if mode == "F":
+        if mode == "RGBa":
+            im = hopper("RGBA").convert(mode)
+        elif mode == "La":
+            im = hopper("LA").convert(mode)
+        elif mode == "F":
             im = hopper("L").convert(mode)
         elif mode[:4] == "I;16":
             im = hopper("I").convert(mode)

From a626ff0e607ab6ed04b990a2b4868d5c35c18ed1 Mon Sep 17 00:00:00 2001
From: Yay295 <Yay295@gmail.com>
Date: Sun, 25 Dec 2022 18:43:39 -0600
Subject: [PATCH 0300/1178] add tests using the bytes Image class methods

---
 Tests/test_image.py | 84 +++++++++++++++++++++++++++++++++++++++++++++
 1 file changed, 84 insertions(+)

diff --git a/Tests/test_image.py b/Tests/test_image.py
index d472bd7ea48..3baf9581013 100644
--- a/Tests/test_image.py
+++ b/Tests/test_image.py
@@ -1042,6 +1042,90 @@ def test_close_graceful(self, caplog: pytest.LogCaptureFixture) -> None:
             assert im.fp is None
 
 
+class TestImageBytes:
+    # modes grouped by pixel size
+    one_byte_modes = (
+        "1",
+        "L",
+        "P",
+    )
+    two_byte_modes = (
+        "I;16",
+        "I;16L",
+        "I;16B",
+        # "I;16N", # unknown raw mode for given image mode
+        # "BGR;15", # unrecognized image mode
+        # "BGR;16", # unrecognized image mode
+    )
+    # three_byte_modes = ("BGR;24",) # unrecognized image mode
+    three_byte_modes = ()
+    four_byte_modes = (
+        "LA",
+        "La",
+        "PA",
+        "F",
+        "I",
+        # "BGR;32", # unrecognized image mode
+        "RGB",
+        "RGBA",
+        "RGBa",
+        "RGBX",
+        "CMYK",
+        "YCbCr",
+        "HSV",
+        "LAB",
+    )
+    all_modes = one_byte_modes + two_byte_modes + three_byte_modes + four_byte_modes
+
+    # make this bigger if necessary
+    sample_bytes = bytes(range(16))
+
+    @pytest.mark.parametrize("mode", all_modes)
+    def test_roundtrip_bytes_constructor(self, mode):
+        source_image = hopper(mode)
+        source_bytes = source_image.tobytes()
+        copy_image = Image.frombytes(mode, source_image.size, source_bytes)
+        assert copy_image.tobytes() == source_bytes
+
+    @pytest.mark.parametrize("mode", all_modes)
+    def test_roundtrip_bytes_method(self, mode):
+        source_image = hopper(mode)
+        source_bytes = source_image.tobytes()
+        copy_image = Image.new(mode, source_image.size)
+        copy_image.frombytes(source_bytes)
+        assert copy_image.tobytes() == source_bytes
+
+    @pytest.mark.parametrize(
+        ("mode", "pixelsize"),
+        tuple((m, 1) for m in one_byte_modes)
+        + tuple((m, 2) for m in two_byte_modes)
+        + tuple((m, 3) for m in three_byte_modes)
+        + tuple((m, 4) for m in four_byte_modes),
+    )
+    def test_get_pixel(self, mode, pixelsize):
+        image_byte_size = 2 * 2 * pixelsize
+        start_bytes = self.sample_bytes[:image_byte_size]
+        image = Image.frombytes(mode, (2, 2), start_bytes)
+
+        start_pixels = (
+            image.getpixel((0, 0)),
+            image.getpixel((0, 1)),
+            image.getpixel((1, 0)),
+            image.getpixel((1, 1)),
+        )
+
+        image.putdata(image.getdata())
+
+        end_pixels = (
+            image.getpixel((0, 0)),
+            image.getpixel((0, 1)),
+            image.getpixel((1, 0)),
+            image.getpixel((1, 1)),
+        )
+
+        assert start_pixels == end_pixels
+
+
 class MockEncoder(ImageFile.PyEncoder):
     pass
 

From 43f3c822a7b157ca31fa7be84f08194694f9fd98 Mon Sep 17 00:00:00 2001
From: Yay295 <Yay295@gmail.com>
Date: Tue, 27 Dec 2022 21:11:05 -0600
Subject: [PATCH 0301/1178] use tuple of tuples for image mode info

---
 Tests/test_image.py | 110 ++++++++++++++++----------------------------
 1 file changed, 39 insertions(+), 71 deletions(-)

diff --git a/Tests/test_image.py b/Tests/test_image.py
index 3baf9581013..f7fd664c034 100644
--- a/Tests/test_image.py
+++ b/Tests/test_image.py
@@ -33,36 +33,38 @@
     skip_unless_feature,
 )
 
+# name, number of bands, pixel size
+image_modes = (
+    ("1", 1, 1),
+    ("L", 1, 1),
+    ("LA", 2, 4),
+    ("La", 2, 4),
+    ("P", 1, 1),
+    ("PA", 2, 4),
+    ("F", 1, 4),
+    ("I", 1, 4),
+    ("I;16", 1, 2),
+    ("I;16L", 1, 2),
+    ("I;16B", 1, 2),
+    ("I;16N", 1, 2),
+    ("RGB", 3, 4),
+    ("RGBA", 4, 4),
+    ("RGBa", 4, 4),
+    ("RGBX", 4, 4),
+    ("BGR;15", 3, 2),
+    ("BGR;16", 3, 2),
+    ("BGR;24", 3, 3),
+    ("CMYK", 4, 4),
+    ("YCbCr", 3, 4),
+    ("HSV", 3, 4),
+    ("LAB", 3, 4),
+)
+
+image_mode_names = [name for name, num_bands, pixelsize in image_modes]
+
 
 class TestImage:
-    @pytest.mark.parametrize(
-        "mode",
-        (
-            "1",
-            "P",
-            "PA",
-            "L",
-            "LA",
-            "La",
-            "F",
-            "I",
-            "I;16",
-            "I;16L",
-            "I;16B",
-            "I;16N",
-            "RGB",
-            "RGBX",
-            "RGBA",
-            "RGBa",
-            "BGR;15",
-            "BGR;16",
-            "BGR;24",
-            "CMYK",
-            "YCbCr",
-            "LAB",
-            "HSV",
-        ),
-    )
+    @pytest.mark.parametrize("mode", image_mode_names)
     def test_image_modes_success(self, mode: str) -> None:
         Image.new(mode, (1, 1))
 
@@ -1043,51 +1045,23 @@ def test_close_graceful(self, caplog: pytest.LogCaptureFixture) -> None:
 
 
 class TestImageBytes:
-    # modes grouped by pixel size
-    one_byte_modes = (
-        "1",
-        "L",
-        "P",
-    )
-    two_byte_modes = (
-        "I;16",
-        "I;16L",
-        "I;16B",
-        # "I;16N", # unknown raw mode for given image mode
-        # "BGR;15", # unrecognized image mode
-        # "BGR;16", # unrecognized image mode
-    )
-    # three_byte_modes = ("BGR;24",) # unrecognized image mode
-    three_byte_modes = ()
-    four_byte_modes = (
-        "LA",
-        "La",
-        "PA",
-        "F",
-        "I",
-        # "BGR;32", # unrecognized image mode
-        "RGB",
-        "RGBA",
-        "RGBa",
-        "RGBX",
-        "CMYK",
-        "YCbCr",
-        "HSV",
-        "LAB",
-    )
-    all_modes = one_byte_modes + two_byte_modes + three_byte_modes + four_byte_modes
+    # The BGR modes don't support the methods tested in this class.
+    image_modes_not_bgr = [mode for mode in image_modes if "BGR" not in mode[0]]
+    image_mode_names_not_bgr = [
+        name for name, num_bands, pixelsize in image_modes if "BGR" not in name
+    ]
 
     # make this bigger if necessary
     sample_bytes = bytes(range(16))
 
-    @pytest.mark.parametrize("mode", all_modes)
+    @pytest.mark.parametrize("mode", image_mode_names_not_bgr)
     def test_roundtrip_bytes_constructor(self, mode):
         source_image = hopper(mode)
         source_bytes = source_image.tobytes()
         copy_image = Image.frombytes(mode, source_image.size, source_bytes)
         assert copy_image.tobytes() == source_bytes
 
-    @pytest.mark.parametrize("mode", all_modes)
+    @pytest.mark.parametrize("mode", image_mode_names_not_bgr)
     def test_roundtrip_bytes_method(self, mode):
         source_image = hopper(mode)
         source_bytes = source_image.tobytes()
@@ -1095,14 +1069,8 @@ def test_roundtrip_bytes_method(self, mode):
         copy_image.frombytes(source_bytes)
         assert copy_image.tobytes() == source_bytes
 
-    @pytest.mark.parametrize(
-        ("mode", "pixelsize"),
-        tuple((m, 1) for m in one_byte_modes)
-        + tuple((m, 2) for m in two_byte_modes)
-        + tuple((m, 3) for m in three_byte_modes)
-        + tuple((m, 4) for m in four_byte_modes),
-    )
-    def test_get_pixel(self, mode, pixelsize):
+    @pytest.mark.parametrize(("mode", "num_bands", "pixelsize"), image_modes_not_bgr)
+    def test_pixels_after_getdata_putdata(self, mode, num_bands, pixelsize):
         image_byte_size = 2 * 2 * pixelsize
         start_bytes = self.sample_bytes[:image_byte_size]
         image = Image.frombytes(mode, (2, 2), start_bytes)

From 79c9b2b26116a9671d0d814eab55284777830370 Mon Sep 17 00:00:00 2001
From: Yay295 <Yay295@gmail.com>
Date: Sat, 10 Jun 2023 21:23:46 -0500
Subject: [PATCH 0302/1178] autosize TestImageBytes.sample_bytes

---
 Tests/test_image.py | 7 +++++--
 1 file changed, 5 insertions(+), 2 deletions(-)

diff --git a/Tests/test_image.py b/Tests/test_image.py
index f7fd664c034..780c843e20d 100644
--- a/Tests/test_image.py
+++ b/Tests/test_image.py
@@ -1051,8 +1051,11 @@ class TestImageBytes:
         name for name, num_bands, pixelsize in image_modes if "BGR" not in name
     ]
 
-    # make this bigger if necessary
-    sample_bytes = bytes(range(16))
+    sample_bytes = bytes(
+        range(
+            2 * 2 * max(pixelsize for mode, num_bands, pixelsize in image_modes_not_bgr)
+        )
+    )
 
     @pytest.mark.parametrize("mode", image_mode_names_not_bgr)
     def test_roundtrip_bytes_constructor(self, mode):

From c56c8901b7800f09a06afdaf4d70eac92bdca176 Mon Sep 17 00:00:00 2001
From: Yay295 <Yay295@gmail.com>
Date: Mon, 26 Feb 2024 01:00:11 -0600
Subject: [PATCH 0303/1178] handle I;16 native endianness on big-endian machine

---
 src/_imaging.c | 12 +++++++++++-
 1 file changed, 11 insertions(+), 1 deletion(-)

diff --git a/src/_imaging.c b/src/_imaging.c
index 59f80a35415..520e5079346 100644
--- a/src/_imaging.c
+++ b/src/_imaging.c
@@ -1578,7 +1578,17 @@ if (PySequence_Check(op)) { \
                 int bigendian = 0;
                 if (image->type == IMAGING_TYPE_SPECIAL) {
                     // I;16*
-                    bigendian = strcmp(image->mode, "I;16B") == 0;
+                    if (strcmp(image->mode, "I;16N") == 0) {
+#ifdef WORDS_BIGENDIAN
+                        bigendian = 1;
+#else
+                        bigendian = 0;
+#endif
+                    } else if (strcmp(image->mode, "I;16B") == 0) {
+                        bigendian = 1;
+                    } else {
+                        bigendian = 0;
+                    }
                 }
                 for (i = x = y = 0; i < n; i++) {
                     set_value_to_item(seq, i);

From 12d626a6bbac15ed7193dd50222c3e7ea5b0b613 Mon Sep 17 00:00:00 2001
From: Yay295 <Yay295@gmail.com>
Date: Mon, 11 Mar 2024 12:00:13 -0500
Subject: [PATCH 0304/1178] add typing to image bytes tests

---
 Tests/test_image.py | 8 +++++---
 1 file changed, 5 insertions(+), 3 deletions(-)

diff --git a/Tests/test_image.py b/Tests/test_image.py
index 780c843e20d..87a9788611c 100644
--- a/Tests/test_image.py
+++ b/Tests/test_image.py
@@ -1058,14 +1058,14 @@ class TestImageBytes:
     )
 
     @pytest.mark.parametrize("mode", image_mode_names_not_bgr)
-    def test_roundtrip_bytes_constructor(self, mode):
+    def test_roundtrip_bytes_constructor(self, mode: str):
         source_image = hopper(mode)
         source_bytes = source_image.tobytes()
         copy_image = Image.frombytes(mode, source_image.size, source_bytes)
         assert copy_image.tobytes() == source_bytes
 
     @pytest.mark.parametrize("mode", image_mode_names_not_bgr)
-    def test_roundtrip_bytes_method(self, mode):
+    def test_roundtrip_bytes_method(self, mode: str):
         source_image = hopper(mode)
         source_bytes = source_image.tobytes()
         copy_image = Image.new(mode, source_image.size)
@@ -1073,7 +1073,9 @@ def test_roundtrip_bytes_method(self, mode):
         assert copy_image.tobytes() == source_bytes
 
     @pytest.mark.parametrize(("mode", "num_bands", "pixelsize"), image_modes_not_bgr)
-    def test_pixels_after_getdata_putdata(self, mode, num_bands, pixelsize):
+    def test_pixels_after_getdata_putdata(
+        self, mode: str, num_bands: int, pixelsize: int
+    ):
         image_byte_size = 2 * 2 * pixelsize
         start_bytes = self.sample_bytes[:image_byte_size]
         image = Image.frombytes(mode, (2, 2), start_bytes)

From 680f387bc2d5d5d0171735e152638e936c2295f1 Mon Sep 17 00:00:00 2001
From: Yay295 <Yay295@gmail.com>
Date: Mon, 11 Mar 2024 12:00:48 -0500
Subject: [PATCH 0305/1178] enable bgr modes for image bytes tests

---
 Tests/test_image.py | 16 ++++------------
 1 file changed, 4 insertions(+), 12 deletions(-)

diff --git a/Tests/test_image.py b/Tests/test_image.py
index 87a9788611c..8890db1289f 100644
--- a/Tests/test_image.py
+++ b/Tests/test_image.py
@@ -1045,26 +1045,18 @@ def test_close_graceful(self, caplog: pytest.LogCaptureFixture) -> None:
 
 
 class TestImageBytes:
-    # The BGR modes don't support the methods tested in this class.
-    image_modes_not_bgr = [mode for mode in image_modes if "BGR" not in mode[0]]
-    image_mode_names_not_bgr = [
-        name for name, num_bands, pixelsize in image_modes if "BGR" not in name
-    ]
-
     sample_bytes = bytes(
-        range(
-            2 * 2 * max(pixelsize for mode, num_bands, pixelsize in image_modes_not_bgr)
-        )
+        range(2 * 2 * max(pixelsize for mode, num_bands, pixelsize in image_modes))
     )
 
-    @pytest.mark.parametrize("mode", image_mode_names_not_bgr)
+    @pytest.mark.parametrize("mode", image_mode_names)
     def test_roundtrip_bytes_constructor(self, mode: str):
         source_image = hopper(mode)
         source_bytes = source_image.tobytes()
         copy_image = Image.frombytes(mode, source_image.size, source_bytes)
         assert copy_image.tobytes() == source_bytes
 
-    @pytest.mark.parametrize("mode", image_mode_names_not_bgr)
+    @pytest.mark.parametrize("mode", image_mode_names)
     def test_roundtrip_bytes_method(self, mode: str):
         source_image = hopper(mode)
         source_bytes = source_image.tobytes()
@@ -1072,7 +1064,7 @@ def test_roundtrip_bytes_method(self, mode: str):
         copy_image.frombytes(source_bytes)
         assert copy_image.tobytes() == source_bytes
 
-    @pytest.mark.parametrize(("mode", "num_bands", "pixelsize"), image_modes_not_bgr)
+    @pytest.mark.parametrize(("mode", "num_bands", "pixelsize"), image_modes)
     def test_pixels_after_getdata_putdata(
         self, mode: str, num_bands: int, pixelsize: int
     ):

From 4db82a0a17a7537961826e21d0668708ab53dbd3 Mon Sep 17 00:00:00 2001
From: "renovate[bot]" <29139614+renovate[bot]@users.noreply.github.com>
Date: Mon, 11 Mar 2024 21:51:55 +0000
Subject: [PATCH 0306/1178] Update dependency cibuildwheel to v2.17.0

---
 .ci/requirements-cibw.txt | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/.ci/requirements-cibw.txt b/.ci/requirements-cibw.txt
index ccd6d87edc6..45c2af975ae 100644
--- a/.ci/requirements-cibw.txt
+++ b/.ci/requirements-cibw.txt
@@ -1 +1 @@
-cibuildwheel==2.16.5
+cibuildwheel==2.17.0

From b22e4711cb75b896a72028a775fa3be557d0ae34 Mon Sep 17 00:00:00 2001
From: Andrew Murray <radarhere@users.noreply.github.com>
Date: Tue, 12 Mar 2024 12:02:26 +1100
Subject: [PATCH 0307/1178] Import __version__ from .

---
 src/PIL/ImageCms.py | 4 ++--
 1 file changed, 2 insertions(+), 2 deletions(-)

diff --git a/src/PIL/ImageCms.py b/src/PIL/ImageCms.py
index 2b0ed6c9d2f..39669d86919 100644
--- a/src/PIL/ImageCms.py
+++ b/src/PIL/ImageCms.py
@@ -25,7 +25,7 @@
 from functools import reduce
 from typing import Any
 
-from . import Image
+from . import Image, __version__
 from ._deprecate import deprecate
 
 try:
@@ -1087,4 +1087,4 @@ def versions():
         12,
         '(PIL.features.version("littlecms2"), sys.version, PIL.__version__)',
     )
-    return _VERSION, core.littlecms_version, sys.version.split()[0], Image.__version__
+    return _VERSION, core.littlecms_version, sys.version.split()[0], __version__

From f128d47e150aa91db74c06092290b9cd0a0b04aa Mon Sep 17 00:00:00 2001
From: Andrew Murray <radarhere@users.noreply.github.com>
Date: Tue, 12 Mar 2024 19:30:23 +1100
Subject: [PATCH 0308/1178] Added reading of JPEG2000 palettes

---
 Tests/test_file_jpeg2k.py     | 10 ++++++++++
 src/PIL/Jpeg2KImagePlugin.py  | 15 ++++++++++++---
 src/libImaging/Jpeg2KDecode.c |  2 ++
 3 files changed, 24 insertions(+), 3 deletions(-)

diff --git a/Tests/test_file_jpeg2k.py b/Tests/test_file_jpeg2k.py
index b7f8350c775..bd114aa1181 100644
--- a/Tests/test_file_jpeg2k.py
+++ b/Tests/test_file_jpeg2k.py
@@ -364,6 +364,16 @@ def test_subsampling_decode(name: str) -> None:
         assert_image_similar(im, expected, epsilon)
 
 
+@pytest.mark.skipif(
+    not os.path.exists(EXTRA_DIR), reason="Extra image files not installed"
+)
+def test_pclr() -> None:
+    with Image.open(f"{EXTRA_DIR}/issue104_jpxstream.jp2") as im:
+        assert im.mode == "P"
+        assert len(im.palette.colors) == 256
+        assert im.palette.colors[(255, 255, 255)] == 0
+
+
 def test_comment() -> None:
     with Image.open("Tests/images/comment.jp2") as im:
         assert im.info["comment"] == b"Created by OpenJPEG version 2.5.0"
diff --git a/src/PIL/Jpeg2KImagePlugin.py b/src/PIL/Jpeg2KImagePlugin.py
index 4b778a0d33a..27f8fbbd0b5 100644
--- a/src/PIL/Jpeg2KImagePlugin.py
+++ b/src/PIL/Jpeg2KImagePlugin.py
@@ -19,7 +19,7 @@
 import os
 import struct
 
-from . import Image, ImageFile, _binary
+from . import Image, ImageFile, ImagePalette, _binary
 
 
 class BoxReader:
@@ -162,6 +162,7 @@ def _parse_jp2_header(fp):
     bpc = None
     nc = None
     dpi = None  # 2-tuple of DPI info, or None
+    palette = None
 
     while header.has_next_box():
         tbox = header.next_box_type()
@@ -179,6 +180,14 @@ def _parse_jp2_header(fp):
                 mode = "RGB"
             elif nc == 4:
                 mode = "RGBA"
+        elif tbox == b"pclr" and mode in ("L", "LA"):
+            ne, npc = header.read_fields(">HB")
+            bitdepths = header.read_fields(">" + ("B" * npc))
+            if max(bitdepths) <= 8:
+                palette = ImagePalette.ImagePalette()
+                for i in range(ne):
+                    palette.getcolor(header.read_fields(">" + ("B" * npc)))
+                mode = "P" if mode == "L" else "PA"
         elif tbox == b"res ":
             res = header.read_boxes()
             while res.has_next_box():
@@ -195,7 +204,7 @@ def _parse_jp2_header(fp):
         msg = "Malformed JP2 header"
         raise SyntaxError(msg)
 
-    return size, mode, mimetype, dpi
+    return size, mode, mimetype, dpi, palette
 
 
 ##
@@ -217,7 +226,7 @@ def _open(self):
             if sig == b"\x00\x00\x00\x0cjP  \x0d\x0a\x87\x0a":
                 self.codec = "jp2"
                 header = _parse_jp2_header(self.fp)
-                self._size, self._mode, self.custom_mimetype, dpi = header
+                self._size, self._mode, self.custom_mimetype, dpi, self.palette = header
                 if dpi is not None:
                     self.info["dpi"] = dpi
                 if self.fp.read(12).endswith(b"jp2c\xff\x4f\xff\x51"):
diff --git a/src/libImaging/Jpeg2KDecode.c b/src/libImaging/Jpeg2KDecode.c
index cff30e2d0bf..13f363422da 100644
--- a/src/libImaging/Jpeg2KDecode.c
+++ b/src/libImaging/Jpeg2KDecode.c
@@ -615,6 +615,8 @@ j2ku_sycca_rgba(
 
 static const struct j2k_decode_unpacker j2k_unpackers[] = {
     {"L", OPJ_CLRSPC_GRAY, 1, 0, j2ku_gray_l},
+    {"P", OPJ_CLRSPC_SRGB, 1, 0, j2ku_gray_l},
+    {"PA", OPJ_CLRSPC_SRGB, 2, 0, j2ku_graya_la},
     {"I;16", OPJ_CLRSPC_GRAY, 1, 0, j2ku_gray_i},
     {"I;16B", OPJ_CLRSPC_GRAY, 1, 0, j2ku_gray_i},
     {"LA", OPJ_CLRSPC_GRAY, 2, 0, j2ku_graya_la},

From 9e3d1a7b05b5c961eb1daaae4e5ed62feb6d5507 Mon Sep 17 00:00:00 2001
From: Andrew Murray <radarhere@users.noreply.github.com>
Date: Wed, 13 Mar 2024 18:47:34 +1100
Subject: [PATCH 0309/1178] Update CHANGES.rst [ci skip]

---
 CHANGES.rst | 33 +++++++++++++++++++++++++++++++++
 1 file changed, 33 insertions(+)

diff --git a/CHANGES.rst b/CHANGES.rst
index 20da811ed1e..b8b8869ddbc 100644
--- a/CHANGES.rst
+++ b/CHANGES.rst
@@ -5,6 +5,39 @@ Changelog (Pillow)
 10.3.0 (unreleased)
 -------------------
 
+- Stop reading EPS image at EOF marker #7753
+  [radarhere]
+
+- PSD layer co-ordinates may be negative #7706
+  [radarhere]
+
+- Use subprocess with CREATE_NO_WINDOW flag in ImageShow WindowsViewer #7791
+  [radarhere]
+
+- When saving GIF frame that restores to background color, do not fill identical pixels #7788
+  [radarhere]
+
+- Fixed reading PNG iCCP compression method #7823
+  [radarhere]
+
+- Allow writing IFDRational to UNDEFINED tag #7840
+  [radarhere]
+
+- Fix logged tag name when loading Exif data #7842
+  [radarhere]
+
+- Use maximum frame size in IHDR chunk when saving APNG images #7821
+  [radarhere]
+
+- Prevent opening P TGA images without a palette #7797
+  [radarhere]
+
+- Use palette when loading ICO images #7798
+  [radarhere]
+
+- Use consistent arguments for load_read and load_seek #7713
+  [radarhere]
+
 - Turn off nullability warnings for macOS SDK #7827
   [radarhere]
 

From 64c8c272711a0604f806b52941510ee4636fbae2 Mon Sep 17 00:00:00 2001
From: Andrew Murray <radarhere@users.noreply.github.com>
Date: Wed, 13 Mar 2024 18:55:26 +1100
Subject: [PATCH 0310/1178] Added alpha_quality argument when saving

---
 Tests/test_file_webp_alpha.py        | 12 ++++++++++++
 Tests/test_file_webp_animated.py     | 18 ++++++++++++++++++
 docs/handbook/image-file-formats.rst |  6 +++++-
 src/PIL/WebPImagePlugin.py           |  6 +++++-
 src/_webp.c                          | 10 ++++++++--
 5 files changed, 48 insertions(+), 4 deletions(-)

diff --git a/Tests/test_file_webp_alpha.py b/Tests/test_file_webp_alpha.py
index a95434624f5..c7445212110 100644
--- a/Tests/test_file_webp_alpha.py
+++ b/Tests/test_file_webp_alpha.py
@@ -151,3 +151,15 @@ def test_write_unsupported_mode_PA(tmp_path: Path) -> None:
             target = im.convert("RGBA")
 
         assert_image_similar(image, target, 25.0)
+
+
+def test_alpha_quality(tmp_path: Path) -> None:
+    with Image.open("Tests/images/transparent.png") as im:
+        out = str(tmp_path / "temp.webp")
+        im.save(out)
+
+        out_quality = str(tmp_path / "quality.webp")
+        im.save(out_quality, alpha_quality=50)
+        with Image.open(out) as reloaded:
+            with Image.open(out_quality) as reloaded_quality:
+                assert reloaded.tobytes() != reloaded_quality.tobytes()
diff --git a/Tests/test_file_webp_animated.py b/Tests/test_file_webp_animated.py
index 9a730f1f9bd..6a9337fa57f 100644
--- a/Tests/test_file_webp_animated.py
+++ b/Tests/test_file_webp_animated.py
@@ -188,3 +188,21 @@ def test_seek_errors() -> None:
 
         with pytest.raises(EOFError):
             im.seek(42)
+
+
+def test_alpha_quality(tmp_path: Path) -> None:
+    with Image.open("Tests/images/transparent.png") as im:
+        first_frame = Image.new("L", im.size)
+
+        out = str(tmp_path / "temp.webp")
+        first_frame.save(out, save_all=True, append_images=[im])
+
+        out_quality = str(tmp_path / "quality.webp")
+        first_frame.save(
+            out_quality, save_all=True, append_images=[im], alpha_quality=50
+        )
+        with Image.open(out) as reloaded:
+            reloaded.seek(1)
+            with Image.open(out_quality) as reloaded_quality:
+                reloaded_quality.seek(1)
+                assert reloaded.tobytes() != reloaded_quality.tobytes()
diff --git a/docs/handbook/image-file-formats.rst b/docs/handbook/image-file-formats.rst
index 569ccb7691b..54f983b69c8 100644
--- a/docs/handbook/image-file-formats.rst
+++ b/docs/handbook/image-file-formats.rst
@@ -1234,11 +1234,15 @@ The :py:meth:`~PIL.Image.Image.save` method supports the following options:
     If present and true, instructs the WebP writer to use lossless compression.
 
 **quality**
-    Integer, 0-100, Defaults to 80. For lossy, 0 gives the smallest
+    Integer, 0-100, defaults to 80. For lossy, 0 gives the smallest
     size and 100 the largest. For lossless, this parameter is the amount
     of effort put into the compression: 0 is the fastest, but gives larger
     files compared to the slowest, but best, 100.
 
+**alpha_quality**
+    Integer, 0-100, defaults to 100. For lossy compression only. 0 gives the
+    smallest size and 100 is lossless.
+
 **method**
     Quality/speed trade-off (0=fast, 6=slower-better). Defaults to 4.
 
diff --git a/src/PIL/WebPImagePlugin.py b/src/PIL/WebPImagePlugin.py
index 59556206a3c..c07abcaf928 100644
--- a/src/PIL/WebPImagePlugin.py
+++ b/src/PIL/WebPImagePlugin.py
@@ -217,6 +217,7 @@ def _save_all(im, fp, filename):
     verbose = False
     lossless = im.encoderinfo.get("lossless", False)
     quality = im.encoderinfo.get("quality", 80)
+    alpha_quality = im.encoderinfo.get("alpha_quality", 100)
     method = im.encoderinfo.get("method", 0)
     icc_profile = im.encoderinfo.get("icc_profile") or ""
     exif = im.encoderinfo.get("exif", "")
@@ -296,6 +297,7 @@ def _save_all(im, fp, filename):
                     rawmode,
                     lossless,
                     quality,
+                    alpha_quality,
                     method,
                 )
 
@@ -310,7 +312,7 @@ def _save_all(im, fp, filename):
         im.seek(cur_idx)
 
     # Force encoder to flush frames
-    enc.add(None, round(timestamp), 0, 0, "", lossless, quality, 0)
+    enc.add(None, round(timestamp), 0, 0, "", lossless, quality, alpha_quality, 0)
 
     # Get the final output from the encoder
     data = enc.assemble(icc_profile, exif, xmp)
@@ -324,6 +326,7 @@ def _save_all(im, fp, filename):
 def _save(im, fp, filename):
     lossless = im.encoderinfo.get("lossless", False)
     quality = im.encoderinfo.get("quality", 80)
+    alpha_quality = im.encoderinfo.get("alpha_quality", 100)
     icc_profile = im.encoderinfo.get("icc_profile") or ""
     exif = im.encoderinfo.get("exif", b"")
     if isinstance(exif, Image.Exif):
@@ -343,6 +346,7 @@ def _save(im, fp, filename):
         im.size[1],
         lossless,
         float(quality),
+        float(alpha_quality),
         im.mode,
         icc_profile,
         method,
diff --git a/src/_webp.c b/src/_webp.c
index 47592547cc2..0a70e335757 100644
--- a/src/_webp.c
+++ b/src/_webp.c
@@ -195,6 +195,7 @@ _anim_encoder_add(PyObject *self, PyObject *args) {
     char *mode;
     int lossless;
     float quality_factor;
+    float alpha_quality_factor;
     int method;
     WebPConfig config;
     WebPAnimEncoderObject *encp = (WebPAnimEncoderObject *)self;
@@ -203,7 +204,7 @@ _anim_encoder_add(PyObject *self, PyObject *args) {
 
     if (!PyArg_ParseTuple(
             args,
-            "z#iiisifi",
+            "z#iiisiffi",
             (char **)&rgb,
             &size,
             &timestamp,
@@ -212,6 +213,7 @@ _anim_encoder_add(PyObject *self, PyObject *args) {
             &mode,
             &lossless,
             &quality_factor,
+            &alpha_quality_factor,
             &method)) {
         return NULL;
     }
@@ -229,6 +231,7 @@ _anim_encoder_add(PyObject *self, PyObject *args) {
     }
     config.lossless = lossless;
     config.quality = quality_factor;
+    config.alpha_quality = alpha_quality_factor;
     config.method = method;
 
     // Validate the config
@@ -578,6 +581,7 @@ WebPEncode_wrapper(PyObject *self, PyObject *args) {
     int height;
     int lossless;
     float quality_factor;
+    float alpha_quality_factor;
     int method;
     int exact;
     uint8_t *rgb;
@@ -601,13 +605,14 @@ WebPEncode_wrapper(PyObject *self, PyObject *args) {
 
     if (!PyArg_ParseTuple(
             args,
-            "y#iiifss#iis#s#",
+            "y#iiiffss#iis#s#",
             (char **)&rgb,
             &size,
             &width,
             &height,
             &lossless,
             &quality_factor,
+            &alpha_quality_factor,
             &mode,
             &icc_bytes,
             &icc_size,
@@ -637,6 +642,7 @@ WebPEncode_wrapper(PyObject *self, PyObject *args) {
     }
     config.lossless = lossless;
     config.quality = quality_factor;
+    config.alpha_quality = alpha_quality_factor;
     config.method = method;
 #if WEBP_ENCODER_ABI_VERSION >= 0x0209
     // the "exact" flag is only available in libwebp 0.5.0 and later

From f60904055182a0902bfa52048d3ce79a88d1682d Mon Sep 17 00:00:00 2001
From: Andrew Murray <radarhere@users.noreply.github.com>
Date: Thu, 14 Mar 2024 22:12:41 +1100
Subject: [PATCH 0311/1178] Revert "Pin Python 3.13 on Windows to a3"

This reverts commit 26e0f6df56c1289d52b156642c6ee1197d2bf69b.
---
 .github/workflows/test-windows.yml | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/.github/workflows/test-windows.yml b/.github/workflows/test-windows.yml
index c936be55925..0ab8def3111 100644
--- a/.github/workflows/test-windows.yml
+++ b/.github/workflows/test-windows.yml
@@ -35,7 +35,7 @@ jobs:
     strategy:
       fail-fast: false
       matrix:
-        python-version: ["pypy3.10", "pypy3.9", "3.8", "3.9", "3.10", "3.11", "3.12", "3.13.0-alpha.3"]
+        python-version: ["pypy3.10", "pypy3.9", "3.8", "3.9", "3.10", "3.11", "3.12", "3.13"]
 
     timeout-minutes: 30
 

From 4ebb4a05b3efa7b83f0fc6c05245eefd750b2b3e Mon Sep 17 00:00:00 2001
From: Andrew Murray <radarhere@users.noreply.github.com>
Date: Thu, 14 Mar 2024 23:04:49 +1100
Subject: [PATCH 0312/1178] Revert "Pin to Python 3.9.16-1"

This reverts commit 139320be3a121dbc38d51baefda8d0b97441314d.
---
 .github/workflows/test-cygwin.yml | 5 ++---
 1 file changed, 2 insertions(+), 3 deletions(-)

diff --git a/.github/workflows/test-cygwin.yml b/.github/workflows/test-cygwin.yml
index 4526b945424..c718e56debd 100644
--- a/.github/workflows/test-cygwin.yml
+++ b/.github/workflows/test-cygwin.yml
@@ -50,7 +50,7 @@ jobs:
         uses: actions/checkout@v4
 
       - name: Install Cygwin
-        uses: egor-tensin/setup-cygwin@v4
+        uses: cygwin/cygwin-install-action@v4
         with:
           packages: >
             gcc-g++
@@ -71,7 +71,6 @@ jobs:
             make
             netpbm
             perl
-            python39=3.9.16-1
             python3${{ matrix.python-minor-version }}-cffi
             python3${{ matrix.python-minor-version }}-cython
             python3${{ matrix.python-minor-version }}-devel
@@ -89,7 +88,7 @@ jobs:
 
       - name: Select Python version
         run: |
-          ln -sf c:/tools/cygwin/bin/python3.${{ matrix.python-minor-version }} c:/tools/cygwin/bin/python3
+          ln -sf c:/cygwin/bin/python3.${{ matrix.python-minor-version }} c:/cygwin/bin/python3
 
       - name: Get latest NumPy version
         id: latest-numpy

From e2986e19897e1a5afa328f7325354e086fc392a3 Mon Sep 17 00:00:00 2001
From: Andrew Murray <radarhere@users.noreply.github.com>
Date: Fri, 15 Mar 2024 20:41:15 +1100
Subject: [PATCH 0313/1178] Do not upgrade NumPy

---
 .github/workflows/test-cygwin.yml | 15 ++-------------
 src/PIL/Image.py                  |  2 +-
 2 files changed, 3 insertions(+), 14 deletions(-)

diff --git a/.github/workflows/test-cygwin.yml b/.github/workflows/test-cygwin.yml
index c718e56debd..9674a466570 100644
--- a/.github/workflows/test-cygwin.yml
+++ b/.github/workflows/test-cygwin.yml
@@ -90,19 +90,13 @@ jobs:
         run: |
           ln -sf c:/cygwin/bin/python3.${{ matrix.python-minor-version }} c:/cygwin/bin/python3
 
-      - name: Get latest NumPy version
-        id: latest-numpy
-        shell: bash.exe -eo pipefail -o igncr "{0}"
-        run: |
-          python3 -m pip list --outdated | grep numpy | sed -r 's/ +/ /g' | cut -d ' ' -f 3 | sed 's/^/version=/' >> $GITHUB_OUTPUT
-
       - name: pip cache
         uses: actions/cache@v4
         with:
           path: 'C:\cygwin\home\runneradmin\.cache\pip'
-          key: ${{ runner.os }}-cygwin-pip3.${{ matrix.python-minor-version }}-numpy${{ steps.latest-numpy.outputs.version }}-${{ hashFiles('.ci/install.sh') }}
+          key: ${{ runner.os }}-cygwin-pip3.${{ matrix.python-minor-version }}-${{ hashFiles('.ci/install.sh') }}
           restore-keys: |
-            ${{ runner.os }}-cygwin-pip3.${{ matrix.python-minor-version }}-numpy${{ steps.latest-numpy.outputs.version }}-
+            ${{ runner.os }}-cygwin-pip3.${{ matrix.python-minor-version }}-
 
       - name: Build system information
         run: |
@@ -112,11 +106,6 @@ jobs:
         run: |
           bash.exe .ci/install.sh
 
-      - name: Upgrade NumPy
-        shell: dash.exe -l "{0}"
-        run: |
-          python3 -m pip install -U "numpy<1.26"
-
       - name: Build
         shell: bash.exe -eo pipefail -o igncr "{0}"
         run: |
diff --git a/src/PIL/Image.py b/src/PIL/Image.py
index 2e28c6868af..ac3a533211b 100644
--- a/src/PIL/Image.py
+++ b/src/PIL/Image.py
@@ -702,7 +702,7 @@ def __array_interface__(self):
                     pass
                 else:
                     if parse_version(numpy.__version__) < parse_version("1.23"):
-                        warnings.warn(e)
+                        warnings.warn(str(e))
             raise
         new["shape"], new["typestr"] = _conv_type_shape(self)
         return new

From d2453250f1cdd42cf23d2abf2fd6ffb7caa3fa0e Mon Sep 17 00:00:00 2001
From: Andrew Murray <radarhere@users.noreply.github.com>
Date: Fri, 15 Mar 2024 23:58:07 +1100
Subject: [PATCH 0314/1178] Fixed joined corners for rounded_rectangle()
 non-integer dimensions

---
 Tests/test_imagedraw.py | 2 ++
 src/PIL/ImageDraw.py    | 4 ++++
 2 files changed, 6 insertions(+)

diff --git a/Tests/test_imagedraw.py b/Tests/test_imagedraw.py
index 274753c6cee..0a699e2ab6a 100644
--- a/Tests/test_imagedraw.py
+++ b/Tests/test_imagedraw.py
@@ -868,8 +868,10 @@ def test_rounded_rectangle_zero_radius(bbox: Coords) -> None:
     [
         ((20, 10, 80, 90), "x"),
         ((20, 10, 81, 90), "x_odd"),
+        ((20, 10, 81.1, 90), "x_odd"),
         ((10, 20, 90, 80), "y"),
         ((10, 20, 90, 81), "y_odd"),
+        ((10, 20, 90, 81.1), "y_odd"),
         ((20, 20, 80, 80), "both"),
     ],
 )
diff --git a/src/PIL/ImageDraw.py b/src/PIL/ImageDraw.py
index d4e000087c4..d3efe64865e 100644
--- a/src/PIL/ImageDraw.py
+++ b/src/PIL/ImageDraw.py
@@ -336,6 +336,10 @@ def rounded_rectangle(
 
         d = radius * 2
 
+        x0 = round(x0)
+        y0 = round(y0)
+        x1 = round(x1)
+        y1 = round(y1)
         full_x, full_y = False, False
         if all(corners):
             full_x = d >= x1 - x0 - 1

From 04f60eba9ce47d2fd6b695ca00e61c3b775a1aea Mon Sep 17 00:00:00 2001
From: Alex Clark <aclark@aclark.net>
Date: Wed, 13 Mar 2024 14:15:16 -0400
Subject: [PATCH 0315/1178] Clean up for #7864

Before back fill, clean up.

- Add suggested CVE format to template
- Move Security to the top of release notes
- Fix headings
- Update all existing CVE notes to match template
---
 docs/releasenotes/10.0.0.rst   |  54 ++++++++-------
 docs/releasenotes/10.0.1.rst   |  12 +++-
 docs/releasenotes/10.2.0.rst   |  68 +++++++++---------
 docs/releasenotes/3.1.1.rst    |  44 ++++++++----
 docs/releasenotes/3.1.2.rst    |  20 ++++--
 docs/releasenotes/6.2.0.rst    |  53 ++++++++------
 docs/releasenotes/6.2.2.rst    |  57 ++++++++++++---
 docs/releasenotes/7.1.0.rst    |  51 +++++++++++---
 docs/releasenotes/8.0.1.rst    |   9 ++-
 docs/releasenotes/8.1.0.rst    |  96 +++++++++++++++-----------
 docs/releasenotes/8.1.1.rst    |  45 ++++++++++--
 docs/releasenotes/8.1.2.rst    |  44 ++++++++++--
 docs/releasenotes/8.2.0.rst    | 122 ++++++++++++++++++---------------
 docs/releasenotes/8.3.0.rst    |  50 ++++++++------
 docs/releasenotes/8.3.2.rst    |  27 +++++---
 docs/releasenotes/9.0.0.rst    |  75 ++++++++++----------
 docs/releasenotes/9.0.1.rst    |  18 ++++-
 docs/releasenotes/9.1.1.rst    |   9 ++-
 docs/releasenotes/index.rst    |   1 +
 docs/releasenotes/template.rst |  23 ++++---
 20 files changed, 571 insertions(+), 307 deletions(-)

diff --git a/docs/releasenotes/10.0.0.rst b/docs/releasenotes/10.0.0.rst
index 705ca04152f..4be590edf8c 100644
--- a/docs/releasenotes/10.0.0.rst
+++ b/docs/releasenotes/10.0.0.rst
@@ -1,6 +1,35 @@
 10.0.0
 ------
 
+Security
+========
+
+Limit size even if one dimension is zero
+^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
+
+When performing decompression bomb checks, Pillow did not reject images with
+excessive width and zero height, or zero width and excessive height. That has
+now been fixed.
+
+This effectively dates to the PIL fork, since problem images would still have
+been processed before Pillow started checking for decompression bombs.
+
+Fix CVE-2023-44271
+^^^^^^^^^^^^^^^^^^
+
+Added ImageFont.MAX_STRING_LENGTH.
+
+.. note:: More information about this vulnerability included in database record :cve:`2023-44271`
+
+To protect against potential DOS attacks when using arbitrary strings as text
+input, Pillow will now raise a :py:exc:`ValueError` if the number of characters
+passed into ImageFont methods is over a certain limit,
+:py:data:`PIL.ImageFont.MAX_STRING_LENGTH`.
+
+This threshold can be changed by setting
+:py:data:`PIL.ImageFont.MAX_STRING_LENGTH`. It can be disabled by setting
+``ImageFont.MAX_STRING_LENGTH = None``.
+
 Backwards Incompatible Changes
 ==============================
 
@@ -157,31 +186,6 @@ Added ``alpha_only`` argument to ``getbbox()``
 and the image has an alpha channel, trim transparent pixels. Otherwise, trim
 pixels when all channels are zero.
 
-Security
-========
-
-Limit size even if one dimension is zero
-^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
-
-When performing decompression bomb checks, Pillow did not reject images with
-excessive width and zero height, or zero width and excessive height. That has
-now been fixed.
-
-This effectively dates to the PIL fork, since problem images would still have
-been processed before Pillow started checking for decompression bombs.
-
-Added ImageFont.MAX_STRING_LENGTH
-^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
-
-:cve:`2023-44271`: To protect against potential DOS attacks when using arbitrary strings as text
-input, Pillow will now raise a :py:exc:`ValueError` if the number of characters
-passed into ImageFont methods is over a certain limit,
-:py:data:`PIL.ImageFont.MAX_STRING_LENGTH`.
-
-This threshold can be changed by setting
-:py:data:`PIL.ImageFont.MAX_STRING_LENGTH`. It can be disabled by setting
-``ImageFont.MAX_STRING_LENGTH = None``.
-
 Other Changes
 =============
 
diff --git a/docs/releasenotes/10.0.1.rst b/docs/releasenotes/10.0.1.rst
index 6ac30e7fce1..0b75d2efaef 100644
--- a/docs/releasenotes/10.0.1.rst
+++ b/docs/releasenotes/10.0.1.rst
@@ -4,9 +4,15 @@
 Security
 ========
 
-This release addresses :cve:`2023-4863`, by providing an updated install script and
-updated wheels to include libwebp 1.3.2, preventing a potential heap buffer overflow
-in WebP.
+Fix CVE-2023-4863
+^^^^^^^^^^^^^^^^^
+
+Updated install script and wheels with libwebp 1.3.2
+
+.. note:: More information about this vulnerability included in database record :cve:`2023-4863`
+
+This release provides an updated install script and updated wheels to
+include libwebp 1.3.2, preventing a potential heap buffer overflow in WebP.
 
 Updated tests to pass with latest zlib version
 ==============================================
diff --git a/docs/releasenotes/10.2.0.rst b/docs/releasenotes/10.2.0.rst
index c3947f64c2e..412995da5be 100644
--- a/docs/releasenotes/10.2.0.rst
+++ b/docs/releasenotes/10.2.0.rst
@@ -1,6 +1,42 @@
 10.2.0
 ------
 
+Security
+========
+
+ImageFont.getmask: Applied ImageFont.MAX_STRING_LENGTH
+^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
+
+To protect against potential DOS attacks when using arbitrary strings as text input,
+Pillow will now raise a :py:exc:`ValueError` if the number of characters passed into
+:py:meth:`PIL.ImageFont.ImageFont.getmask` is over a certain limit,
+:py:data:`PIL.ImageFont.MAX_STRING_LENGTH`.
+
+This threshold can be changed by setting :py:data:`PIL.ImageFont.MAX_STRING_LENGTH`. It
+can be disabled by setting ``ImageFont.MAX_STRING_LENGTH = None``.
+
+A decompression bomb check has also been added to
+:py:meth:`PIL.ImageFont.ImageFont.getmask`.
+
+ImageFont.getmask: Trim glyph size
+^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
+
+To protect against potential DOS attacks when using PIL fonts,
+:py:class:`PIL.ImageFont.ImageFont` now trims the size of individual glyphs so that
+they do not extend beyond the bitmap image.
+
+Fix CVE-2023-50447
+^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
+
+ImageMath.eval: Restricted environment keys.
+
+.. note:: More information about this vulnerability included in database record :cve:`2023-50447`
+
+If an attacker has control over the keys passed to the
+``environment`` argument of :py:meth:`PIL.ImageMath.eval`, they may be able to execute
+arbitrary code. To prevent this, keys matching the names of builtins and keys
+containing double underscores will now raise a :py:exc:`ValueError`.
+
 Deprecations
 ============
 
@@ -63,38 +99,6 @@ JPEG tables-only streamtype
 When saving JPEG files, ``streamtype`` can now be set to 1, for tables-only. This will
 output only the quantization and Huffman tables for the image.
 
-Security
-========
-
-ImageFont.getmask: Applied ImageFont.MAX_STRING_LENGTH
-^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
-
-To protect against potential DOS attacks when using arbitrary strings as text input,
-Pillow will now raise a :py:exc:`ValueError` if the number of characters passed into
-:py:meth:`PIL.ImageFont.ImageFont.getmask` is over a certain limit,
-:py:data:`PIL.ImageFont.MAX_STRING_LENGTH`.
-
-This threshold can be changed by setting :py:data:`PIL.ImageFont.MAX_STRING_LENGTH`. It
-can be disabled by setting ``ImageFont.MAX_STRING_LENGTH = None``.
-
-A decompression bomb check has also been added to
-:py:meth:`PIL.ImageFont.ImageFont.getmask`.
-
-ImageFont.getmask: Trim glyph size
-^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
-
-To protect against potential DOS attacks when using PIL fonts,
-:py:class:`PIL.ImageFont.ImageFont` now trims the size of individual glyphs so that
-they do not extend beyond the bitmap image.
-
-ImageMath.eval: Restricted environment keys
-^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
-
-:cve:`2023-50447`: If an attacker has control over the keys passed to the
-``environment`` argument of :py:meth:`PIL.ImageMath.eval`, they may be able to execute
-arbitrary code. To prevent this, keys matching the names of builtins and keys
-containing double underscores will now raise a :py:exc:`ValueError`.
-
 Other Changes
 =============
 
diff --git a/docs/releasenotes/3.1.1.rst b/docs/releasenotes/3.1.1.rst
index 5d60e116cc1..7d0fcbdf211 100644
--- a/docs/releasenotes/3.1.1.rst
+++ b/docs/releasenotes/3.1.1.rst
@@ -1,12 +1,19 @@
-
 3.1.1
-=====
+-----
+
+Security
+========
+
+Fix CVE-2016-0740
+^^^^^^^^^^^^^^^^^
+
+Buffer overflow in TiffDecode.c.
 
-CVE-2016-0740 -- Buffer overflow in TiffDecode.c
-------------------------------------------------
+.. note:: More information about this vulnerability included in database record :cve:`2016-0740`
 
-Pillow 3.1.0 and earlier when linked against libtiff >= 4.0.0 on x64
-may overflow a buffer when reading a specially crafted tiff file (:cve:`2016-0740`).
+Pillow 3.1.0 and earlier when linked against
+libtiff >= 4.0.0 on x64 may overflow a buffer when reading a
+specially crafted tiff file. 
 
 Specifically, libtiff >= 4.0.0 changed the return type of
 ``TIFFScanlineSize`` from ``int32`` to machine dependent
@@ -19,12 +26,15 @@ image data over 64k is written over the heap, causing a segfault.
 
 This issue was found by security researcher FourOne.
 
+Fix CVE-2016-0775
+^^^^^^^^^^^^^^^^^
 
-CVE-2016-0775 -- Buffer overflow in FliDecode.c
------------------------------------------------
+Buffer overflow in FliDecode.c.
 
-In all versions of Pillow, dating back at least to the last PIL 1.1.7
-release, FliDecode.c has a buffer overflow error (:cve:`2016-0775`).
+.. note:: More information about this vulnerability included in database record :cve:`2016-0775`
+
+In all versions of Pillow, dating back at least to
+the last PIL 1.1.7 release, FliDecode.c has a buffer overflow error. 
 
 Around line 192:
 
@@ -49,11 +59,15 @@ off the end of the memory buffer, causing a segfault.
 
 This issue was found by Alyssa Besseling at Atlassian.
 
-CVE-2016-2533 -- Buffer overflow in PcdDecode.c
------------------------------------------------
+Fix CVE-2016-2533
+^^^^^^^^^^^^^^^^^
+
+Buffer overflow in PcdDecode.c.
+
+.. note:: More information about this vulnerability available in :cve:`2016-2533`
 
-In all versions of Pillow, dating back at least to the last PIL 1.1.7
-release, ``PcdDecode.c`` has a buffer overflow error (:cve:`2016-2533`).
+In all versions of Pillow, dating back at least to the
+last PIL 1.1.7 release, ``PcdDecode.c`` has a buffer overflow error. 
 
 The ``state.buffer`` for ``PcdDecode.c`` is allocated based on a 3
 bytes per pixel sizing, where ``PcdDecode.c`` wrote into the buffer
@@ -62,7 +76,7 @@ the buffer into other Python object storage. In some cases, this
 causes a segfault, in others an internal Python malloc error.
 
 Integer overflow in Resample.c
-------------------------------
+^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
 
 If a large value was passed into the new size for an image, it is
 possible to overflow an ``int32`` value passed into malloc.
diff --git a/docs/releasenotes/3.1.2.rst b/docs/releasenotes/3.1.2.rst
index 04325ad868f..c8e24c8c2b3 100644
--- a/docs/releasenotes/3.1.2.rst
+++ b/docs/releasenotes/3.1.2.rst
@@ -1,13 +1,19 @@
-
 3.1.2
-=====
+-----
+
+Security
+========
+
+Fix CVE-2016-3076
+^^^^^^^^^^^^^^^^^
+
+Buffer overflow in Jpeg2KEncode.c.
 
-CVE-2016-3076 -- Buffer overflow in Jpeg2KEncode.c
---------------------------------------------------
+.. note:: More information about this vulnerability included in database record :cve:`2016-3076`
 
-Pillow between 2.5.0 and 3.1.1 may overflow a buffer when writing
-large Jpeg2000 files, allowing for code execution or other memory
-corruption (:cve:`2016-3076`).
+Pillow between 2.5.0 and 3.1.1 may overflow a buffer
+when writing large Jpeg2000 files, allowing for code execution or other
+memory corruption. 
 
 This occurs specifically in the function ``j2k_encode_entry``, at the line:
 
diff --git a/docs/releasenotes/6.2.0.rst b/docs/releasenotes/6.2.0.rst
index 7daac1b1902..cab01cfad54 100644
--- a/docs/releasenotes/6.2.0.rst
+++ b/docs/releasenotes/6.2.0.rst
@@ -1,6 +1,38 @@
 6.2.0
 -----
 
+Security
+========
+
+This release catches several buffer overruns and fixes CVE-2019-16865.
+
+Buffer overruns
+^^^^^^^^^^^^^^^
+
+In RawDecode.c, an error is now thrown if skip is calculated to be less than
+zero. It is intended to skip padding between lines, not to go backwards.
+
+In PsdImagePlugin, if the combined sizes of the individual parts is larger than
+the declared size of the extra data field, then it looked for the next layer by
+seeking backwards. This is now corrected by seeking to (the start of the layer
++ the size of the extra data field) instead of (the read parts of the layer +
+the rest of the layer).
+
+Decompression bomb checks have been added to GIF and ICO formats.
+
+An error is now raised if a TIFF dimension is a string, rather than trying to
+perform operations on it.
+
+Fix CVE-2019-16865
+^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
+
+DOS attack vulnerabilities.
+
+.. note:: More information about this vulnerability included in database record :cve:`2019-16865`
+
+The CVE is regarding DOS problems, such as consuming large
+amounts of memory, or taking a large amount of time to process an image.
+
 API Additions
 =============
 
@@ -65,27 +97,6 @@ There has been a longstanding warning that the defaults of ``Image.frombuffer``
 may change in the future for the "raw" decoder. The change will now take place
 in Pillow 7.0.
 
-Security
-========
-
-This release catches several buffer overruns, as well as addressing
-:cve:`2019-16865`. The CVE is regarding DOS problems, such as consuming large
-amounts of memory, or taking a large amount of time to process an image.
-
-In RawDecode.c, an error is now thrown if skip is calculated to be less than
-zero. It is intended to skip padding between lines, not to go backwards.
-
-In PsdImagePlugin, if the combined sizes of the individual parts is larger than
-the declared size of the extra data field, then it looked for the next layer by
-seeking backwards. This is now corrected by seeking to (the start of the layer
-+ the size of the extra data field) instead of (the read parts of the layer +
-the rest of the layer).
-
-Decompression bomb checks have been added to GIF and ICO formats.
-
-An error is now raised if a TIFF dimension is a string, rather than trying to
-perform operations on it.
-
 Other Changes
 =============
 
diff --git a/docs/releasenotes/6.2.2.rst b/docs/releasenotes/6.2.2.rst
index 47692a3de6a..96bf0471244 100644
--- a/docs/releasenotes/6.2.2.rst
+++ b/docs/releasenotes/6.2.2.rst
@@ -4,15 +4,56 @@
 Security
 ========
 
-This release addresses several security problems.
+This release fixes several buffer overruns and DOS attacks reported in CVE-2019-19911, CVE-2020-5310, CVE-2020-5311, CVE-2020-5312 and CVE-2020-5313.
 
-:cve:`2019-19911` is regarding FPX images. If an image reports that it has a large
-number of bands, a large amount of resources will be used when trying to process the
-image. This is fixed by limiting the number of bands to those usable by Pillow.
+Fix CVE-2019-19911
+^^^^^^^^^^^^^^^^^^
 
-Buffer overruns were found when processing an SGI (:cve:`2020-5311`),
-PCX (:cve:`2020-5312`) or FLI image (:cve:`2020-5313`). Checks have been added
-to prevent this.
+DOS attack vulnerability.
 
-:cve:`2020-5310`: Overflow checks have been added when calculating the size of a
+.. note:: More information about this vulnerability included in database record :cve:`2019-19911`
+
+If an FPX image reports that it has a large number of bands, a large amount of
+resources will be used when trying to process the image. This is fixed by
+limiting the number of bands to those usable by Pillow.
+
+
+Fix CVE-2020-5310
+^^^^^^^^^^^^^^^^^
+
+Overflow checks added to TIFF image processing.
+
+.. note:: More information about this vulnerability included in database record :cve:`2020-5310`
+
+Overflow checks have been added when calculating the size of a
 memory block to be reallocated in the processing of a TIFF image.
+
+Fix CVE-2020-5311
+^^^^^^^^^^^^^^^^^
+
+Overflow checks added to SGI image processing.
+
+.. note:: More information about this vulnerability included in database record :cve:`2020-5311`
+
+Buffer overruns were found when processing an SGI image. Checks
+have been added to prevent this.
+
+Fix CVE-2020-5312
+^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
+
+Overflow checks added to PCX image processing.
+
+.. note:: More information about this vulnerability included in database record :cve:`2020-5312`
+
+Buffer overruns were found when processing an SGI PCX. Checks have
+been added to prevent this.
+
+Fix CVE-2020-5313
+^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
+
+Overflow checks added to FLI image processing.
+
+.. note:: More information about this vulnerability included in database record :cve:`2020-5313`
+
+Buffer overruns were found when processing an FLI image. Checks
+have been added to prevent this.
diff --git a/docs/releasenotes/7.1.0.rst b/docs/releasenotes/7.1.0.rst
index 6e231464e93..ac9701cae2f 100644
--- a/docs/releasenotes/7.1.0.rst
+++ b/docs/releasenotes/7.1.0.rst
@@ -1,6 +1,46 @@
 7.1.0
 -----
 
+Security
+========
+
+This release includes many security fixes.
+
+Fix CVE-2020-10177
+^^^^^^^^^^^^^^^^^^
+
+Multiple out-of-bounds reads in FLI decoding.
+
+.. note:: More information about this vulnerability included in database record :cve:`2020-10177`
+
+Fix CVE-2020-10378
+^^^^^^^^^^^^^^^^^^
+
+Bounds overflow in PCX decoding.
+
+.. note:: More information about this vulnerability included in database record :cve:`2020-10378`
+
+Fix CVE-2020-10379
+^^^^^^^^^^^^^^^^^^
+
+Two buffer overflows in TIFF decoding
+
+.. note:: More information about this vulnerability included in database record :cve:`2020-10379`
+
+Fix CVE-2020-10994
+^^^^^^^^^^^^^^^^^^
+
+Bounds overflow in JPEG 2000 decoding
+
+.. note:: More information about this vulnerability included in database record :cve:`2020-10994`
+
+Fix CVE-2020-11538
+^^^^^^^^^^^^^^^^^^
+
+Buffer overflow in SGI-RLE decoding
+
+.. note:: More information about this vulnerability included in database record :cve:`2020-11538`
+
 API Changes
 ===========
 
@@ -67,17 +107,6 @@ Passing a different value on Windows or macOS will force taking a snapshot
 using the selected X server; pass an empty string to use the default X server.
 XCB support is not included in pre-compiled wheels for Windows and macOS.
 
-Security
-========
-
-This release includes security fixes.
-
-* :cve:`2020-10177` Fix multiple out-of-bounds reads in FLI decoding
-* :cve:`2020-10378` Fix bounds overflow in PCX decoding
-* :cve:`2020-10379` Fix two buffer overflows in TIFF decoding
-* :cve:`2020-10994` Fix bounds overflow in JPEG 2000 decoding
-* :cve:`2020-11538` Fix buffer overflow in SGI-RLE decoding
-
 Other Changes
 =============
 
diff --git a/docs/releasenotes/8.0.1.rst b/docs/releasenotes/8.0.1.rst
index f7a1cea65da..eb995ebe1ea 100644
--- a/docs/releasenotes/8.0.1.rst
+++ b/docs/releasenotes/8.0.1.rst
@@ -4,7 +4,14 @@
 Security
 ========
 
-Update FreeType used in binary wheels to `2.10.4`_ to fix :cve:`2020-15999`:
+Fix CVE-2020-15999
+^^^^^^^^^^^^^^^^^^
+
+Update FreeType version in wheels.
+
+.. note:: More information about this vulnerability included in database record :cve:`2020-15999`
+
+Update FreeType used in binary wheels to `2.10.4`_. 
 
   - A heap buffer overflow has been found  in the handling of embedded PNG bitmaps,
     introduced in FreeType version 2.6.
diff --git a/docs/releasenotes/8.1.0.rst b/docs/releasenotes/8.1.0.rst
index 69726e628b7..141489cb50f 100644
--- a/docs/releasenotes/8.1.0.rst
+++ b/docs/releasenotes/8.1.0.rst
@@ -1,6 +1,62 @@
 8.1.0
 -----
 
+Security
+========
+
+This release includes security fixes.
+
+* An out-of-bounds read when saving TIFFs with custom metadata through LibTIFF
+* An out-of-bounds read when saving a GIF of 1px width
+
+Fix CVE-2020-35653
+^^^^^^^^^^^^^^^^^^
+
+Buffer read overrun in PCX decoding.
+
+.. note:: More information about this vulnerability included in database record :cve:`2020-35653`
+
+The PCX image decoder used the reported image stride to calculate
+the row buffer, rather than calculating it from the image size. This issue dates back
+to the PIL fork. Thanks to Google's `OSS-Fuzz`_ project for finding this.
+
+Fix CVE-2020-35654
+^^^^^^^^^^^^^^^^^^
+
+TIFF out-of-bounds write error.
+
+.. note:: More information about this vulnerability included in database record :cve:`2020-35654`
+
+Out-of-bounds write in ``TiffDecode.c`` when reading corrupt YCbCr
+files in some LibTIFF versions (4.1.0/Ubuntu 20.04, but not 4.0.9/Ubuntu 18.04).
+In some cases LibTIFF's interpretation of the file is different when reading in RGBA mode,
+leading to an out-of-bounds write in ``TiffDecode.c``. This potentially affects Pillow
+versions from 6.0.0 to 8.0.1, depending on the version of LibTIFF. This was reported through
+`Tidelift`_.
+
+Fix CVE-2020-35655
+^^^^^^^^^^^^^^^^^^
+
+SGI Decode buffer overrun
+
+.. note:: More information about this vulnerability included in database record :cve:`2020-35655`
+
+4 byte read overflow in ``SgiRleDecode.c``, where the code was not correctly
+checking the offsets and length tables. Independently reported through `Tidelift`_ and Google's
+`OSS-Fuzz`_. This vulnerability covers Pillow versions 4.3.0->8.0.1.
+
+.. _Tidelift: https://tidelift.com/subscription/pkg/pypi-pillow?utm_source=pillow&utm_medium=referral&utm_campaign=docs
+.. _OSS-Fuzz: https://github.com/google/oss-fuzz
+
+Dependencies
+^^^^^^^^^^^^
+
+OpenJPEG in the macOS and Linux wheels has been updated from 2.3.1 to 2.4.0, including
+security fixes.
+
+LibTIFF in the macOS and Linux wheels has been updated from 4.1.0 to 4.2.0, including
+security fixes discovered by fuzzers.
+
 Deprecations
 ============
 
@@ -33,46 +89,6 @@ With this release, a list of images can be provided to the ``append_images`` par
 when saving, to replace the scaled down versions. This is the same functionality that
 already exists for the ICNS format.
 
-Security
-========
-
-This release includes security fixes.
-
-* An out-of-bounds read when saving TIFFs with custom metadata through LibTIFF
-* An out-of-bounds read when saving a GIF of 1px width
-* :cve:`2020-35653` Buffer read overrun in PCX decoding
-
-The PCX image decoder used the reported image stride to calculate the row buffer,
-rather than calculating it from the image size. This issue dates back to the PIL fork.
-Thanks to Google's `OSS-Fuzz`_ project for finding this.
-
-* :cve:`2020-35654` Fix TIFF out-of-bounds write error
-
-Out-of-bounds write in ``TiffDecode.c`` when reading corrupt YCbCr files in some
-LibTIFF versions (4.1.0/Ubuntu 20.04, but not 4.0.9/Ubuntu 18.04). In some cases
-LibTIFF's interpretation of the file is different when reading in RGBA mode, leading to
-an out-of-bounds write in ``TiffDecode.c``. This potentially affects Pillow versions
-from 6.0.0 to 8.0.1, depending on the version of LibTIFF. This was reported through
-`Tidelift`_.
-
-* :cve:`2020-35655` Fix for SGI Decode buffer overrun
-
-4 byte read overflow in ``SgiRleDecode.c``, where the code was not correctly checking the
-offsets and length tables. Independently reported through `Tidelift`_ and Google's
-`OSS-Fuzz`_. This vulnerability covers Pillow versions 4.3.0->8.0.1.
-
-.. _Tidelift: https://tidelift.com/subscription/pkg/pypi-pillow?utm_source=pillow&utm_medium=referral&utm_campaign=docs
-.. _OSS-Fuzz: https://github.com/google/oss-fuzz
-
-Dependencies
-^^^^^^^^^^^^
-
-OpenJPEG in the macOS and Linux wheels has been updated from 2.3.1 to 2.4.0, including
-security fixes.
-
-LibTIFF in the macOS and Linux wheels has been updated from 4.1.0 to 4.2.0, including
-security fixes discovered by fuzzers.
-
 Other Changes
 =============
 
diff --git a/docs/releasenotes/8.1.1.rst b/docs/releasenotes/8.1.1.rst
index 18d0a33f1cd..3e084351998 100644
--- a/docs/releasenotes/8.1.1.rst
+++ b/docs/releasenotes/8.1.1.rst
@@ -4,20 +4,51 @@
 Security
 ========
 
-:cve:`2021-25289`: The previous fix for :cve:`2020-35654` was insufficient
-due to incorrect error checking in ``TiffDecode.c``.
+Fix CVE-2021-25289 
+^^^^^^^^^^^^^^^^^^
 
-:cve:`2021-25290`: In ``TiffDecode.c``, there is a negative-offset ``memcpy``
+The previous fix for CVE-2020-35654 was insufficient.
+
+.. note:: More information about this vulnerability included in database record :cve:`2021-25289`
+
+The previous fix for :cve:`2020-35654` was insufficient due to incorrect error checking in ``TiffDecode.c``.
+
+Fix CVE-2021-25290
+^^^^^^^^^^^^^^^^^^
+
+In ``TiffDecode.c`` there is a negative-offset.
+
+.. note:: More information about this vulnerability included in database record :cve:`2021-25290`
+
+In ``TiffDecode.c``, there is a negative-offset ``memcpy``
 with an invalid size.
 
-:cve:`2021-25291`: In ``TiffDecode.c``, invalid tile boundaries could lead to
+Fix CVE-2021-25291
+^^^^^^^^^^^^^^^^^^
+
+``TiffDecode.c`` has invalid tile boundaries.
+
+.. note:: More information about this vulnerability included in database record :cve:`2021-25291`
+
+In ``TiffDecode.c``, invalid tile boundaries could lead to
 an out-of-bounds read in ``TIFFReadRGBATile``.
 
-:cve:`2021-25292`: The PDF parser has a catastrophic backtracking regex
+Fix CVE-2021-25292
+^^^^^^^^^^^^^^^^^^
+
+The PDF parser has a catastrophic backtracking regex.
+
+.. note:: More information about this vulnerability included in database record :cve:`2021-25292`:
+
+The PDF parser has a catastrophic backtracking regex
 that could be used as a DOS attack.
 
-:cve:`2021-25293`: There is an out-of-bounds read in ``SgiRleDecode.c``,
-since Pillow 4.3.0.
+Fix CVE-2021-25293
+^^^^^^^^^^^^^^^^^^
+
+There is an out-of-bounds read in ``SgiRleDecode.c`` since Pillow 4.3.0.
+
+.. note:: More information about this vulnerability included in database record :cve:`2021-25293`
 
 
 Other Changes
diff --git a/docs/releasenotes/8.1.2.rst b/docs/releasenotes/8.1.2.rst
index de50a3f1dad..6d4baa2b6f2 100644
--- a/docs/releasenotes/8.1.2.rst
+++ b/docs/releasenotes/8.1.2.rst
@@ -4,9 +4,41 @@
 Security
 ========
 
-There is an exhaustion of memory DOS in the BLP (:cve:`2021-27921`),
-ICNS (:cve:`2021-27922`) and ICO (:cve:`2021-27923`) container formats
-where Pillow did not properly check the reported size of the contained image.
-These images could cause arbitrarily large memory allocations. This was reported
-by Jiayi Lin, Luke Shaffer, Xinran Xie, and Akshay Ajayan of
-`Arizona State University <https://www.asu.edu/>`_.
+Fix CVE-2021-27921
+^^^^^^^^^^^^^^^^^^
+
+There is an exhaustion of memory DOS in BLP images.
+
+.. note:: More information about this vulnerability included in database record :cve:`2021-27921`
+
+There is an exhaustion of memory DOS in BLP
+images where Pillow did not properly check the reported size of the
+contained image. These images could cause arbitrarily large memory
+allocations.
+
+Fix CVE-2021-27922
+^^^^^^^^^^^^^^^^^^
+
+There is an exhaustion of memory DOS in ICNS images.
+
+.. note:: More information about this vulnerability included in database record :cve:`2021-27921`
+
+There is an exhaustion of memory DOS in the ICNS
+images where Pillow did not properly check the reported size of the
+contained image. These images could cause arbitrarily large memory
+allocations.
+
+Fix CVE-2021-27923
+^^^^^^^^^^^^^^^^^^
+
+There is an exhaustion of memory DOS in ICO images.
+
+.. note:: More information about this vulnerability included in database record :cve:`2021-27923`
+
+There is an exhaustion of memory DOS in ICO
+images where Pillow did not properly check the reported size of the
+contained image. These images could cause arbitrarily large memory
+allocations.
+
+These were reported by Jiayi Lin, Luke Shaffer, Xinran Xie and
+Akshay Ajayan of `Arizona State University <https://www.asu.edu/>`_.
diff --git a/docs/releasenotes/8.2.0.rst b/docs/releasenotes/8.2.0.rst
index 452077f1a64..7e647841e1d 100644
--- a/docs/releasenotes/8.2.0.rst
+++ b/docs/releasenotes/8.2.0.rst
@@ -1,6 +1,73 @@
 8.2.0
 -----
 
+Security
+========
+
+These were all found with `OSS-Fuzz`_.
+
+Fix CVE-2021-25287, CVE-2021-25288, CVE-2021-28675
+^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
+
+OOB read in Jpeg2KDecode
+
+.. note:: More information about these vulnerabilities included in database records
+    :cve:`2021-25287`, :cve:`2021-25288`, :cve:`2021-28675`
+
+* For J2k images with multiple bands, it's legal to have different widths for each band,
+  e.g. 1 byte for ``L``, 4 bytes for ``A``.
+* This dates to Pillow 2.4.0.
+
+Fix CVE-2021-28675 -- DOS attack in PsdImagePlugin
+^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
+
+.. note:: More information about this vulnerability included in database record :cve:`2021-28675`
+
+* :py:class:`.PsdImagePlugin.PsdImageFile` did not sanity check the number of input
+  layers with regard to the size of the data block, this could lead to a
+  denial-of-service on :py:meth:`~PIL.Image.open` prior to
+  :py:meth:`~PIL.Image.Image.load`.
+* This dates to the PIL fork.
+
+Fix CVE-2021-28676 -- FLI image DOS attack
+^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
+
+.. note:: More information about this vulnerability included in database record :cve:`2021-28676`
+
+* ``FliDecode.c`` did not properly check that the block advance was non-zero,
+  potentially leading to an infinite loop on load.
+* This dates to the PIL fork.
+
+Fix CVE-2021-28677 -- EPS DOS on _open
+^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
+
+.. note:: More information about this vulnerability included in database record :cve:`2021-28677`
+
+* The readline used in EPS has to deal with any combination of ``\r`` and ``\n`` as line
+  endings. It accidentally used a quadratic method of accumulating lines while looking
+  for a line ending.
+* A malicious EPS file could use this to perform a denial-of-service of Pillow in the
+  open phase, before an image was accepted for opening.
+* This dates to the PIL fork.
+
+CVE-2021-28678 -- BLP DOS attack
+^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
+
+.. note:: More information about this vulnerability included in database record :cve:`2021-28678`
+
+* ``BlpImagePlugin`` did not properly check that reads after jumping to file offsets
+  returned data. This could lead to a denial-of-service where the decoder could be run a
+  large number of times on empty data.
+* This dates to Pillow 5.1.0.
+
+Fix memory DOS in ImageFont
+^^^^^^^^^^^^^^^^^^^^^^^^^^^
+
+* A corrupt or specially crafted TTF font could have font metrics that lead to
+  unreasonably large sizes when rendering text in font. ``ImageFont.py`` did not check
+  the image size before allocating memory for it.
+* This dates to the PIL fork.
+
 Deprecations
 ============
 
@@ -123,61 +190,6 @@ be specified through a keyword argument::
 
     im.save("out.tif", icc_profile=...)
 
-
-Security
-========
-
-These were all found with `OSS-Fuzz`_.
-
-:cve:`2021-25287`, :cve:`2021-25288`: Fix OOB read in Jpeg2KDecode
-^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
-
-* For J2k images with multiple bands, it's legal to have different widths for each band,
-  e.g. 1 byte for ``L``, 4 bytes for ``A``.
-* This dates to Pillow 2.4.0.
-
-:cve:`2021-28675`: Fix DOS in PsdImagePlugin
-^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
-
-* :py:class:`.PsdImagePlugin.PsdImageFile` did not sanity check the number of input
-  layers with regard to the size of the data block, this could lead to a
-  denial-of-service on :py:meth:`~PIL.Image.open` prior to
-  :py:meth:`~PIL.Image.Image.load`.
-* This dates to the PIL fork.
-
-:cve:`2021-28676`: Fix FLI DOS
-^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
-
-* ``FliDecode.c`` did not properly check that the block advance was non-zero,
-  potentially leading to an infinite loop on load.
-* This dates to the PIL fork.
-
-:cve:`2021-28677`: Fix EPS DOS on _open
-^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
-
-* The readline used in EPS has to deal with any combination of ``\r`` and ``\n`` as line
-  endings. It accidentally used a quadratic method of accumulating lines while looking
-  for a line ending.
-* A malicious EPS file could use this to perform a denial-of-service of Pillow in the
-  open phase, before an image was accepted for opening.
-* This dates to the PIL fork.
-
-:cve:`2021-28678`: Fix BLP DOS
-^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
-
-* ``BlpImagePlugin`` did not properly check that reads after jumping to file offsets
-  returned data. This could lead to a denial-of-service where the decoder could be run a
-  large number of times on empty data.
-* This dates to Pillow 5.1.0.
-
-Fix memory DOS in ImageFont
-^^^^^^^^^^^^^^^^^^^^^^^^^^^
-
-* A corrupt or specially crafted TTF font could have font metrics that lead to
-  unreasonably large sizes when rendering text in font. ``ImageFont.py`` did not check
-  the image size before allocating memory for it.
-* This dates to the PIL fork.
-
 Other Changes
 =============
 
diff --git a/docs/releasenotes/8.3.0.rst b/docs/releasenotes/8.3.0.rst
index e74880f6f40..b0b016a08f1 100644
--- a/docs/releasenotes/8.3.0.rst
+++ b/docs/releasenotes/8.3.0.rst
@@ -1,6 +1,34 @@
 8.3.0
 -----
 
+Security
+========
+
+Buffer overflow
+^^^^^^^^^^^^^^^
+
+Fix CVE-2021-34552
+^^^^^^^^^^^^^^^^^^
+
+Buffer overflow
+
+.. note:: More information about this vulnerability included in database record :cve:`2021-34552`
+
+PIL since 1.1.4 and Pillow since 1.0 allowed parameters passed into a convert function to trigger
+buffer overflow in Convert.c.
+
+Parsing XML
+^^^^^^^^^^^
+
+Pillow previously parsed XMP data using Python's ``xml`` module. However, this module
+is not secure.
+
+- :py:meth:`~PIL.Image.Image.getexif` has used ``xml`` to potentially retrieve
+  orientation data since Pillow 7.2.0. It has been refactored to use ``re`` instead.
+- :py:meth:`~PIL.JpegImagePlugin.JpegImageFile.getxmp` was added in Pillow 8.2.0. It
+  will now use ``defusedxml`` instead. If the dependency is not present, an empty
+  dictionary will be returned and a warning raised.
+
 Deprecations
 ============
 
@@ -79,28 +107,6 @@ format, through the new ``bitmap_format`` argument::
 
     im.save("out.ico", bitmap_format="bmp")
 
-Security
-========
-
-Buffer overflow
-^^^^^^^^^^^^^^^
-
-This release addresses :cve:`2021-34552`. PIL since 1.1.4 and Pillow since 1.0
-allowed parameters passed into a convert function to trigger buffer overflow in
-Convert.c.
-
-Parsing XML
-^^^^^^^^^^^
-
-Pillow previously parsed XMP data using Python's ``xml`` module. However, this module
-is not secure.
-
-- :py:meth:`~PIL.Image.Image.getexif` has used ``xml`` to potentially retrieve
-  orientation data since Pillow 7.2.0. It has been refactored to use ``re`` instead.
-- :py:meth:`~PIL.JpegImagePlugin.JpegImageFile.getxmp` was added in Pillow 8.2.0. It
-  will now use ``defusedxml`` instead. If the dependency is not present, an empty
-  dictionary will be returned and a warning raised.
-
 Other Changes
 =============
 
diff --git a/docs/releasenotes/8.3.2.rst b/docs/releasenotes/8.3.2.rst
index 3333d63a1e8..7e2007649f3 100644
--- a/docs/releasenotes/8.3.2.rst
+++ b/docs/releasenotes/8.3.2.rst
@@ -4,14 +4,25 @@
 Security
 ========
 
-* :cve:`2021-23437`: Avoid a potential ReDoS (regular expression denial of service)
-  in :py:class:`~PIL.ImageColor`'s :py:meth:`~PIL.ImageColor.getrgb` by raising
-  :py:exc:`ValueError` if the color specifier is too long. Present since Pillow 5.2.0.
-
-* Fix 6-byte out-of-bounds (OOB) read. The previous bounds check in ``FliDecode.c``
-  incorrectly calculated the required read buffer size when copying a chunk, potentially
-  reading six extra bytes off the end of the allocated buffer from the heap. Present
-  since Pillow 7.1.0. This bug was found by Google's `OSS-Fuzz`_ `CIFuzz`_ runs.
+Fix CVE-2021-23437
+^^^^^^^^^^^^^^^^^^
+
+Avoid potential ReDoS (regular expression denial of service)
+
+.. note:: More information about this vulnerability included in database record :cve:`2021-23437`
+
+Avoid a potential ReDoS (regular expression denial of service) in :py:class:`~PIL.ImageColor`'s
+:py:meth:`~PIL.ImageColor.getrgb` by raising :py:exc:`ValueError` if the color specifier is
+too long. Present since Pillow 5.2.0.
+
+Fix 6-byte out-of-bounds (OOB) read
+^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
+
+Fix 6-byte out-of-bounds (OOB) read. The previous bounds check in ``FliDecode.c`` incorrectly
+calculated the required read buffer size when copying a chunk, potentially reading six extra
+bytes off the end of the allocated buffer from the heap. Present since Pillow 7.1.0.
+
+This bug was found by Google's `OSS-Fuzz`_ `CIFuzz`_ runs.
 
 Other Changes
 =============
diff --git a/docs/releasenotes/9.0.0.rst b/docs/releasenotes/9.0.0.rst
index 090ec802467..b46932b2423 100644
--- a/docs/releasenotes/9.0.0.rst
+++ b/docs/releasenotes/9.0.0.rst
@@ -24,6 +24,46 @@ success of Python.
 
 Thank you, Fredrik.
 
+Security
+========
+
+Ensure JpegImagePlugin stops at the end of a truncated file
+^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
+
+``JpegImagePlugin`` may append an EOF marker to the end of a truncated file, so that
+the last segment of the data will still be processed by the decoder.
+
+If the EOF marker is not detected as such however, this could lead to an infinite
+loop where ``JpegImagePlugin`` keeps trying to end the file.
+
+Remove consecutive duplicate tiles that only differ by their offset
+^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
+
+To prevent attempts to slow down loading times for images, if an image has consecutive
+duplicate tiles that only differ by their offset, only load the last tile. Credit to
+Google's `OSS-Fuzz`_ project for finding this issue.
+
+Fix CVE-2022-22817
+^^^^^^^^^^^^^^^^^^
+
+Restrict builtins available to ImageMath.eval
+
+.. note:: More information about this vulnerability included in database record :cve:`2022-22817`
+
+To limit :py:class:`PIL.ImageMath` to working with images, Pillow
+will now restrict the builtins available to :py:meth:`PIL.ImageMath.eval`. This will
+help prevent problems arising if users evaluate arbitrary expressions, such as
+``ImageMath.eval("exec(exit())")``.
+
+Fix CVE-2022-22817 -- ImagePath.Path array handling
+^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
+
+.. note:: More information about this vulnerability included in database record :cve:`2022-22815`
+
+(:cwe:`126`) and :cve:`2022-22816` (:cwe:`665`) were found when initializing ``ImagePath.Path``.
+
+.. _OSS-Fuzz: https://github.com/google/oss-fuzz
+
 Backwards Incompatible Changes
 ==============================
 
@@ -97,41 +137,6 @@ Support has been added for the "title" argument in
 argument will also now be supported, e.g. ``im.show(title="My Image")`` and
 ``ImageShow.show(im, title="My Image")``.
 
-Security
-========
-
-Ensure JpegImagePlugin stops at the end of a truncated file
-^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
-
-``JpegImagePlugin`` may append an EOF marker to the end of a truncated file, so that
-the last segment of the data will still be processed by the decoder.
-
-If the EOF marker is not detected as such however, this could lead to an infinite
-loop where ``JpegImagePlugin`` keeps trying to end the file.
-
-Remove consecutive duplicate tiles that only differ by their offset
-^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
-
-To prevent attempts to slow down loading times for images, if an image has consecutive
-duplicate tiles that only differ by their offset, only load the last tile. Credit to
-Google's `OSS-Fuzz`_ project for finding this issue.
-
-Restrict builtins available to ImageMath.eval
-^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
-
-:cve:`2022-22817`: To limit :py:class:`PIL.ImageMath` to working with images, Pillow
-will now restrict the builtins available to :py:meth:`PIL.ImageMath.eval`. This will
-help prevent problems arising if users evaluate arbitrary expressions, such as
-``ImageMath.eval("exec(exit())")``.
-
-Fixed ImagePath.Path array handling
-^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
-
-:cve:`2022-22815` (:cwe:`126`) and :cve:`2022-22816` (:cwe:`665`) were
-found when initializing ``ImagePath.Path``.
-
-.. _OSS-Fuzz: https://github.com/google/oss-fuzz
-
 Other Changes
 =============
 
diff --git a/docs/releasenotes/9.0.1.rst b/docs/releasenotes/9.0.1.rst
index acb92dc4151..b8003e88642 100644
--- a/docs/releasenotes/9.0.1.rst
+++ b/docs/releasenotes/9.0.1.rst
@@ -6,12 +6,26 @@ Security
 
 This release addresses several security problems.
 
-:cve:`2022-24303`: If the path to the temporary directory on Linux or macOS
+Fix CVE-2022-24303
+^^^^^^^^^^^^^^^^^^
+
+Temp image removal
+
+.. note:: More information about this vulnerability included in database record :cve:`2022-24303`
+
+If the path to the temporary directory on Linux or macOS
 contained a space, this would break removal of the temporary image file after
 ``im.show()`` (and related actions), and potentially remove an unrelated file. This
 has been present since PIL.
 
-:cve:`2022-22817`: While Pillow 9.0 restricted top-level builtins available to
+Fix CVE-2022-24303
+^^^^^^^^^^^^^^^^^^
+
+Restrict lambda expressions
+
+.. note:: More information about this vulnerability included in database record :cve:`2022-22817`
+
+While Pillow 9.0 restricted top-level builtins available to
 :py:meth:`PIL.ImageMath.eval`, it did not prevent builtins available to lambda
 expressions. These are now also restricted.
 
diff --git a/docs/releasenotes/9.1.1.rst b/docs/releasenotes/9.1.1.rst
index bab70f8f984..4ae596f3e28 100644
--- a/docs/releasenotes/9.1.1.rst
+++ b/docs/releasenotes/9.1.1.rst
@@ -6,7 +6,14 @@ Security
 
 This release addresses several security problems.
 
-:cve:`2022-30595`: When reading a TGA file with RLE packets that cross scan lines,
+Fix CVE-2022-30595
+^^^^^^^^^^^^^^^^^^
+
+Heap buffer overflow
+
+.. note:: More information about this vulnerability included in database record :cve:`2022-30595`
+
+When reading a TGA file with RLE packets that cross scan lines,
 Pillow reads the information past the end of the first line without deducting that
 from the length of the remaining file data. This vulnerability was introduced in Pillow
 9.1.0, and can cause a heap buffer overflow.
diff --git a/docs/releasenotes/index.rst b/docs/releasenotes/index.rst
index e86f8082b48..e1ebd650966 100644
--- a/docs/releasenotes/index.rst
+++ b/docs/releasenotes/index.rst
@@ -69,4 +69,5 @@ expected to be backported to earlier versions.
   3.0.0
   2.8.0
   2.7.0
+  2.3.1
   versioning
diff --git a/docs/releasenotes/template.rst b/docs/releasenotes/template.rst
index 440d04b1cc4..08dbead7f7a 100644
--- a/docs/releasenotes/template.rst
+++ b/docs/releasenotes/template.rst
@@ -1,6 +1,21 @@
 xx.y.z
 ------
 
+Security
+========
+
+TODO
+^^^^
+
+TODO
+
+Fix CVE-YYYY-XXXXX -- TODO
+^^^^^^^^^^^^^^^^^^^^^^^^^^
+
+.. note:: More information about this vulnerability included in database record :cve:`YYYY-XXXXX`
+
+TODO
+
 Backwards Incompatible Changes
 ==============================
 
@@ -31,14 +46,6 @@ TODO
 
 TODO
 
-Security
-========
-
-TODO
-^^^^
-
-TODO
-
 Other Changes
 =============
 

From 231e7384d00be2f39d6d9671685ced68277ef4d0 Mon Sep 17 00:00:00 2001
From: Alex Clark <aclark@aclark.net>
Date: Wed, 13 Mar 2024 14:40:00 -0400
Subject: [PATCH 0316/1178] Clean up for #7864

---
 docs/releasenotes/10.0.0.rst   |  4 ++--
 docs/releasenotes/10.0.1.rst   |  2 --
 docs/releasenotes/10.2.0.rst   |  4 ++--
 docs/releasenotes/3.1.1.rst    | 12 ++++++------
 docs/releasenotes/3.1.2.rst    |  4 ++--
 docs/releasenotes/6.2.0.rst    |  2 --
 docs/releasenotes/6.2.2.rst    | 26 +++++++-------------------
 docs/releasenotes/7.1.0.rst    | 20 ++++++++++----------
 docs/releasenotes/8.0.1.rst    |  4 +---
 docs/releasenotes/8.1.0.rst    | 12 ++++++------
 docs/releasenotes/8.1.1.rst    | 20 ++++----------------
 docs/releasenotes/8.1.2.rst    | 23 ++++++-----------------
 docs/releasenotes/8.2.0.rst    |  4 ++--
 docs/releasenotes/8.3.0.rst    |  4 ++--
 docs/releasenotes/8.3.2.rst    |  4 ++--
 docs/releasenotes/9.0.0.rst    |  4 ++--
 docs/releasenotes/9.0.1.rst    |  4 ++--
 docs/releasenotes/9.1.1.rst    |  4 ++--
 docs/releasenotes/template.rst |  4 ++--
 19 files changed, 60 insertions(+), 101 deletions(-)

diff --git a/docs/releasenotes/10.0.0.rst b/docs/releasenotes/10.0.0.rst
index 4be590edf8c..25e73bff627 100644
--- a/docs/releasenotes/10.0.0.rst
+++ b/docs/releasenotes/10.0.0.rst
@@ -17,10 +17,10 @@ been processed before Pillow started checking for decompression bombs.
 Fix CVE-2023-44271
 ^^^^^^^^^^^^^^^^^^
 
-Added ImageFont.MAX_STRING_LENGTH.
-
 .. note:: More information about this vulnerability included in database record :cve:`2023-44271`
 
+Added ImageFont.MAX_STRING_LENGTH.
+
 To protect against potential DOS attacks when using arbitrary strings as text
 input, Pillow will now raise a :py:exc:`ValueError` if the number of characters
 passed into ImageFont methods is over a certain limit,
diff --git a/docs/releasenotes/10.0.1.rst b/docs/releasenotes/10.0.1.rst
index 0b75d2efaef..ab0f98123da 100644
--- a/docs/releasenotes/10.0.1.rst
+++ b/docs/releasenotes/10.0.1.rst
@@ -7,8 +7,6 @@ Security
 Fix CVE-2023-4863
 ^^^^^^^^^^^^^^^^^
 
-Updated install script and wheels with libwebp 1.3.2
-
 .. note:: More information about this vulnerability included in database record :cve:`2023-4863`
 
 This release provides an updated install script and updated wheels to
diff --git a/docs/releasenotes/10.2.0.rst b/docs/releasenotes/10.2.0.rst
index 412995da5be..38a31ebf4a1 100644
--- a/docs/releasenotes/10.2.0.rst
+++ b/docs/releasenotes/10.2.0.rst
@@ -28,10 +28,10 @@ they do not extend beyond the bitmap image.
 Fix CVE-2023-50447
 ^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
 
-ImageMath.eval: Restricted environment keys.
-
 .. note:: More information about this vulnerability included in database record :cve:`2023-50447`
 
+ImageMath.eval: Restricted environment keys.
+
 If an attacker has control over the keys passed to the
 ``environment`` argument of :py:meth:`PIL.ImageMath.eval`, they may be able to execute
 arbitrary code. To prevent this, keys matching the names of builtins and keys
diff --git a/docs/releasenotes/3.1.1.rst b/docs/releasenotes/3.1.1.rst
index 7d0fcbdf211..153c12ab030 100644
--- a/docs/releasenotes/3.1.1.rst
+++ b/docs/releasenotes/3.1.1.rst
@@ -7,10 +7,10 @@ Security
 Fix CVE-2016-0740
 ^^^^^^^^^^^^^^^^^
 
-Buffer overflow in TiffDecode.c.
-
 .. note:: More information about this vulnerability included in database record :cve:`2016-0740`
 
+Buffer overflow in TiffDecode.c.
+
 Pillow 3.1.0 and earlier when linked against
 libtiff >= 4.0.0 on x64 may overflow a buffer when reading a
 specially crafted tiff file. 
@@ -29,10 +29,10 @@ This issue was found by security researcher FourOne.
 Fix CVE-2016-0775
 ^^^^^^^^^^^^^^^^^
 
-Buffer overflow in FliDecode.c.
-
 .. note:: More information about this vulnerability included in database record :cve:`2016-0775`
 
+Buffer overflow in FliDecode.c.
+
 In all versions of Pillow, dating back at least to
 the last PIL 1.1.7 release, FliDecode.c has a buffer overflow error. 
 
@@ -62,10 +62,10 @@ This issue was found by Alyssa Besseling at Atlassian.
 Fix CVE-2016-2533
 ^^^^^^^^^^^^^^^^^
 
-Buffer overflow in PcdDecode.c.
-
 .. note:: More information about this vulnerability available in :cve:`2016-2533`
 
+Buffer overflow in PcdDecode.c.
+
 In all versions of Pillow, dating back at least to the
 last PIL 1.1.7 release, ``PcdDecode.c`` has a buffer overflow error. 
 
diff --git a/docs/releasenotes/3.1.2.rst b/docs/releasenotes/3.1.2.rst
index c8e24c8c2b3..fff93b8e4eb 100644
--- a/docs/releasenotes/3.1.2.rst
+++ b/docs/releasenotes/3.1.2.rst
@@ -7,10 +7,10 @@ Security
 Fix CVE-2016-3076
 ^^^^^^^^^^^^^^^^^
 
-Buffer overflow in Jpeg2KEncode.c.
-
 .. note:: More information about this vulnerability included in database record :cve:`2016-3076`
 
+Buffer overflow in Jpeg2KEncode.c.
+
 Pillow between 2.5.0 and 3.1.1 may overflow a buffer
 when writing large Jpeg2000 files, allowing for code execution or other
 memory corruption. 
diff --git a/docs/releasenotes/6.2.0.rst b/docs/releasenotes/6.2.0.rst
index cab01cfad54..6dd65be9d11 100644
--- a/docs/releasenotes/6.2.0.rst
+++ b/docs/releasenotes/6.2.0.rst
@@ -26,8 +26,6 @@ perform operations on it.
 Fix CVE-2019-16865
 ^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
 
-DOS attack vulnerabilities.
-
 .. note:: More information about this vulnerability included in database record :cve:`2019-16865`
 
 The CVE is regarding DOS problems, such as consuming large
diff --git a/docs/releasenotes/6.2.2.rst b/docs/releasenotes/6.2.2.rst
index 96bf0471244..704ea6876be 100644
--- a/docs/releasenotes/6.2.2.rst
+++ b/docs/releasenotes/6.2.2.rst
@@ -9,51 +9,39 @@ This release fixes several buffer overruns and DOS attacks reported in CVE-2019-
 Fix CVE-2019-19911
 ^^^^^^^^^^^^^^^^^^
 
-DOS attack vulnerability.
-
 .. note:: More information about this vulnerability included in database record :cve:`2019-19911`
 
+DOS attack vulnerability.
+
 If an FPX image reports that it has a large number of bands, a large amount of
 resources will be used when trying to process the image. This is fixed by
 limiting the number of bands to those usable by Pillow.
 
-
 Fix CVE-2020-5310
 ^^^^^^^^^^^^^^^^^
 
-Overflow checks added to TIFF image processing.
-
 .. note:: More information about this vulnerability included in database record :cve:`2020-5310`
 
-Overflow checks have been added when calculating the size of a
-memory block to be reallocated in the processing of a TIFF image.
+Overflow checks have been added when calculating the size of a memory block to be reallocated
+in the processing of a TIFF image.
 
 Fix CVE-2020-5311
 ^^^^^^^^^^^^^^^^^
 
-Overflow checks added to SGI image processing.
-
 .. note:: More information about this vulnerability included in database record :cve:`2020-5311`
 
-Buffer overruns were found when processing an SGI image. Checks
-have been added to prevent this.
+Buffer overruns were found when processing an SGI image. Checks have been added to prevent this.
 
 Fix CVE-2020-5312
 ^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
 
-Overflow checks added to PCX image processing.
-
 .. note:: More information about this vulnerability included in database record :cve:`2020-5312`
 
-Buffer overruns were found when processing an SGI PCX. Checks have
-been added to prevent this.
+Buffer overruns were found when processing an SGI PCX. Checks have been added to prevent this.
 
 Fix CVE-2020-5313
 ^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
 
-Overflow checks added to FLI image processing.
-
 .. note:: More information about this vulnerability included in database record :cve:`2020-5313`
 
-Buffer overruns were found when processing an FLI image. Checks
-have been added to prevent this.
+Buffer overruns were found when processing an FLI image. Checks have been added to prevent this.
diff --git a/docs/releasenotes/7.1.0.rst b/docs/releasenotes/7.1.0.rst
index ac9701cae2f..da6595d5ba7 100644
--- a/docs/releasenotes/7.1.0.rst
+++ b/docs/releasenotes/7.1.0.rst
@@ -9,38 +9,38 @@ This release includes many security fixes.
 Fix CVE-2020-10177
 ^^^^^^^^^^^^^^^^^^
 
-Multiple out-of-bounds reads in FLI decoding.
-
 .. note:: More information about this vulnerability included in database record :cve:`2020-10177`
 
+Multiple out-of-bounds reads in FLI decoding.
+
 Fix CVE-2020-10378
 ^^^^^^^^^^^^^^^^^^
 
-Bounds overflow in PCX decoding.
-
 .. note:: More information about this vulnerability included in database record :cve:`2020-10378`
 
+Bounds overflow in PCX decoding.
+
 Fix CVE-2020-10379
 ^^^^^^^^^^^^^^^^^^
 
-Two buffer overflows in TIFF decoding
-
 .. note:: More information about this vulnerability included in database record :cve:`2020-10379`
 
+Two buffer overflows in TIFF decoding.
+
 Fix CVE-2020-10994
 ^^^^^^^^^^^^^^^^^^
 
-Bounds overflow in JPEG 2000 decoding
-
 .. note:: More information about this vulnerability included in database record :cve:`2020-10994`
 
+Bounds overflow in JPEG 2000 decoding.
+
 Fix CVE-2020-11538
 ^^^^^^^^^^^^^^^^^^
 
-Buffer overflow in SGI-RLE decoding
-
 .. note:: More information about this vulnerability included in database record :cve:`2020-11538`
 
+Buffer overflow in SGI-RLE decoding.
+
 API Changes
 ===========
 
diff --git a/docs/releasenotes/8.0.1.rst b/docs/releasenotes/8.0.1.rst
index eb995ebe1ea..54ce4085384 100644
--- a/docs/releasenotes/8.0.1.rst
+++ b/docs/releasenotes/8.0.1.rst
@@ -7,11 +7,9 @@ Security
 Fix CVE-2020-15999
 ^^^^^^^^^^^^^^^^^^
 
-Update FreeType version in wheels.
-
 .. note:: More information about this vulnerability included in database record :cve:`2020-15999`
 
-Update FreeType used in binary wheels to `2.10.4`_. 
+Update FreeType in wheels to `2.10.4`_. 
 
   - A heap buffer overflow has been found  in the handling of embedded PNG bitmaps,
     introduced in FreeType version 2.6.
diff --git a/docs/releasenotes/8.1.0.rst b/docs/releasenotes/8.1.0.rst
index 141489cb50f..0fbf6ffe3cf 100644
--- a/docs/releasenotes/8.1.0.rst
+++ b/docs/releasenotes/8.1.0.rst
@@ -12,10 +12,10 @@ This release includes security fixes.
 Fix CVE-2020-35653
 ^^^^^^^^^^^^^^^^^^
 
-Buffer read overrun in PCX decoding.
-
 .. note:: More information about this vulnerability included in database record :cve:`2020-35653`
 
+Buffer read overrun in PCX decoding.
+
 The PCX image decoder used the reported image stride to calculate
 the row buffer, rather than calculating it from the image size. This issue dates back
 to the PIL fork. Thanks to Google's `OSS-Fuzz`_ project for finding this.
@@ -23,10 +23,10 @@ to the PIL fork. Thanks to Google's `OSS-Fuzz`_ project for finding this.
 Fix CVE-2020-35654
 ^^^^^^^^^^^^^^^^^^
 
-TIFF out-of-bounds write error.
-
 .. note:: More information about this vulnerability included in database record :cve:`2020-35654`
 
+TIFF out-of-bounds write error.
+
 Out-of-bounds write in ``TiffDecode.c`` when reading corrupt YCbCr
 files in some LibTIFF versions (4.1.0/Ubuntu 20.04, but not 4.0.9/Ubuntu 18.04).
 In some cases LibTIFF's interpretation of the file is different when reading in RGBA mode,
@@ -37,10 +37,10 @@ versions from 6.0.0 to 8.0.1, depending on the version of LibTIFF. This was repo
 Fix CVE-2020-35655
 ^^^^^^^^^^^^^^^^^^
 
-SGI Decode buffer overrun
-
 .. note:: More information about this vulnerability included in database record :cve:`2020-35655`
 
+SGI Decode buffer overrun.
+
 4 byte read overflow in ``SgiRleDecode.c``, where the code was not correctly
 checking the offsets and length tables. Independently reported through `Tidelift`_ and Google's
 `OSS-Fuzz`_. This vulnerability covers Pillow versions 4.3.0->8.0.1.
diff --git a/docs/releasenotes/8.1.1.rst b/docs/releasenotes/8.1.1.rst
index 3e084351998..7f871bac1c1 100644
--- a/docs/releasenotes/8.1.1.rst
+++ b/docs/releasenotes/8.1.1.rst
@@ -7,8 +7,6 @@ Security
 Fix CVE-2021-25289 
 ^^^^^^^^^^^^^^^^^^
 
-The previous fix for CVE-2020-35654 was insufficient.
-
 .. note:: More information about this vulnerability included in database record :cve:`2021-25289`
 
 The previous fix for :cve:`2020-35654` was insufficient due to incorrect error checking in ``TiffDecode.c``.
@@ -16,40 +14,30 @@ The previous fix for :cve:`2020-35654` was insufficient due to incorrect error c
 Fix CVE-2021-25290
 ^^^^^^^^^^^^^^^^^^
 
-In ``TiffDecode.c`` there is a negative-offset.
-
 .. note:: More information about this vulnerability included in database record :cve:`2021-25290`
 
-In ``TiffDecode.c``, there is a negative-offset ``memcpy``
-with an invalid size.
+In ``TiffDecode.c``, there is a negative-offset ``memcpy`` with an invalid size.
 
 Fix CVE-2021-25291
 ^^^^^^^^^^^^^^^^^^
 
-``TiffDecode.c`` has invalid tile boundaries.
-
 .. note:: More information about this vulnerability included in database record :cve:`2021-25291`
 
-In ``TiffDecode.c``, invalid tile boundaries could lead to
-an out-of-bounds read in ``TIFFReadRGBATile``.
+In ``TiffDecode.c``, invalid tile boundaries could lead to an out-of-bounds read in ``TIFFReadRGBATile``.
 
 Fix CVE-2021-25292
 ^^^^^^^^^^^^^^^^^^
 
-The PDF parser has a catastrophic backtracking regex.
-
 .. note:: More information about this vulnerability included in database record :cve:`2021-25292`:
 
-The PDF parser has a catastrophic backtracking regex
-that could be used as a DOS attack.
+The PDF parser has a catastrophic backtracking regex that could be used as a DOS attack.
 
 Fix CVE-2021-25293
 ^^^^^^^^^^^^^^^^^^
 
-There is an out-of-bounds read in ``SgiRleDecode.c`` since Pillow 4.3.0.
-
 .. note:: More information about this vulnerability included in database record :cve:`2021-25293`
 
+There is an out-of-bounds read in ``SgiRleDecode.c`` since Pillow 4.3.0.
 
 Other Changes
 =============
diff --git a/docs/releasenotes/8.1.2.rst b/docs/releasenotes/8.1.2.rst
index 6d4baa2b6f2..af60a862e93 100644
--- a/docs/releasenotes/8.1.2.rst
+++ b/docs/releasenotes/8.1.2.rst
@@ -7,38 +7,27 @@ Security
 Fix CVE-2021-27921
 ^^^^^^^^^^^^^^^^^^
 
-There is an exhaustion of memory DOS in BLP images.
-
 .. note:: More information about this vulnerability included in database record :cve:`2021-27921`
 
-There is an exhaustion of memory DOS in BLP
-images where Pillow did not properly check the reported size of the
-contained image. These images could cause arbitrarily large memory
+There is an exhaustion of memory DOS in BLP images. where Pillow did not properly check the
+reported size of the contained image. These images could cause arbitrarily large memory
 allocations.
 
 Fix CVE-2021-27922
 ^^^^^^^^^^^^^^^^^^
 
-There is an exhaustion of memory DOS in ICNS images.
-
 .. note:: More information about this vulnerability included in database record :cve:`2021-27921`
 
-There is an exhaustion of memory DOS in the ICNS
-images where Pillow did not properly check the reported size of the
-contained image. These images could cause arbitrarily large memory
-allocations.
+There is an exhaustion of memory DOS in ICNS images where Pillow did not properly check the
+reported size of the contained image. These images could cause arbitrarily large memory allocations.
 
 Fix CVE-2021-27923
 ^^^^^^^^^^^^^^^^^^
 
-There is an exhaustion of memory DOS in ICO images.
-
 .. note:: More information about this vulnerability included in database record :cve:`2021-27923`
 
-There is an exhaustion of memory DOS in ICO
-images where Pillow did not properly check the reported size of the
-contained image. These images could cause arbitrarily large memory
-allocations.
+There is an exhaustion of memory DOS in ICO images where Pillow did not properly check the reported
+size of the contained image. These images could cause arbitrarily large memory allocations.
 
 These were reported by Jiayi Lin, Luke Shaffer, Xinran Xie and
 Akshay Ajayan of `Arizona State University <https://www.asu.edu/>`_.
diff --git a/docs/releasenotes/8.2.0.rst b/docs/releasenotes/8.2.0.rst
index 7e647841e1d..ea2d7b857cc 100644
--- a/docs/releasenotes/8.2.0.rst
+++ b/docs/releasenotes/8.2.0.rst
@@ -9,11 +9,11 @@ These were all found with `OSS-Fuzz`_.
 Fix CVE-2021-25287, CVE-2021-25288, CVE-2021-28675
 ^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
 
-OOB read in Jpeg2KDecode
-
 .. note:: More information about these vulnerabilities included in database records
     :cve:`2021-25287`, :cve:`2021-25288`, :cve:`2021-28675`
 
+OOB read in Jpeg2KDecode
+
 * For J2k images with multiple bands, it's legal to have different widths for each band,
   e.g. 1 byte for ``L``, 4 bytes for ``A``.
 * This dates to Pillow 2.4.0.
diff --git a/docs/releasenotes/8.3.0.rst b/docs/releasenotes/8.3.0.rst
index b0b016a08f1..e5f8e7996cf 100644
--- a/docs/releasenotes/8.3.0.rst
+++ b/docs/releasenotes/8.3.0.rst
@@ -10,10 +10,10 @@ Buffer overflow
 Fix CVE-2021-34552
 ^^^^^^^^^^^^^^^^^^
 
-Buffer overflow
-
 .. note:: More information about this vulnerability included in database record :cve:`2021-34552`
 
+Buffer overflow
+
 PIL since 1.1.4 and Pillow since 1.0 allowed parameters passed into a convert function to trigger
 buffer overflow in Convert.c.
 
diff --git a/docs/releasenotes/8.3.2.rst b/docs/releasenotes/8.3.2.rst
index 7e2007649f3..3a2295e6a85 100644
--- a/docs/releasenotes/8.3.2.rst
+++ b/docs/releasenotes/8.3.2.rst
@@ -7,10 +7,10 @@ Security
 Fix CVE-2021-23437
 ^^^^^^^^^^^^^^^^^^
 
-Avoid potential ReDoS (regular expression denial of service)
-
 .. note:: More information about this vulnerability included in database record :cve:`2021-23437`
 
+Avoid potential ReDoS (regular expression denial of service)
+
 Avoid a potential ReDoS (regular expression denial of service) in :py:class:`~PIL.ImageColor`'s
 :py:meth:`~PIL.ImageColor.getrgb` by raising :py:exc:`ValueError` if the color specifier is
 too long. Present since Pillow 5.2.0.
diff --git a/docs/releasenotes/9.0.0.rst b/docs/releasenotes/9.0.0.rst
index b46932b2423..2f74f3d7038 100644
--- a/docs/releasenotes/9.0.0.rst
+++ b/docs/releasenotes/9.0.0.rst
@@ -46,10 +46,10 @@ Google's `OSS-Fuzz`_ project for finding this issue.
 Fix CVE-2022-22817
 ^^^^^^^^^^^^^^^^^^
 
-Restrict builtins available to ImageMath.eval
-
 .. note:: More information about this vulnerability included in database record :cve:`2022-22817`
 
+Restrict builtins available to ImageMath.eval.
+
 To limit :py:class:`PIL.ImageMath` to working with images, Pillow
 will now restrict the builtins available to :py:meth:`PIL.ImageMath.eval`. This will
 help prevent problems arising if users evaluate arbitrary expressions, such as
diff --git a/docs/releasenotes/9.0.1.rst b/docs/releasenotes/9.0.1.rst
index b8003e88642..392cf68af84 100644
--- a/docs/releasenotes/9.0.1.rst
+++ b/docs/releasenotes/9.0.1.rst
@@ -9,10 +9,10 @@ This release addresses several security problems.
 Fix CVE-2022-24303
 ^^^^^^^^^^^^^^^^^^
 
-Temp image removal
-
 .. note:: More information about this vulnerability included in database record :cve:`2022-24303`
 
+Temp image removal.
+
 If the path to the temporary directory on Linux or macOS
 contained a space, this would break removal of the temporary image file after
 ``im.show()`` (and related actions), and potentially remove an unrelated file. This
diff --git a/docs/releasenotes/9.1.1.rst b/docs/releasenotes/9.1.1.rst
index 4ae596f3e28..85a1653cccf 100644
--- a/docs/releasenotes/9.1.1.rst
+++ b/docs/releasenotes/9.1.1.rst
@@ -9,10 +9,10 @@ This release addresses several security problems.
 Fix CVE-2022-30595
 ^^^^^^^^^^^^^^^^^^
 
-Heap buffer overflow
-
 .. note:: More information about this vulnerability included in database record :cve:`2022-30595`
 
+Heap buffer overflow.
+
 When reading a TGA file with RLE packets that cross scan lines,
 Pillow reads the information past the end of the first line without deducting that
 from the length of the remaining file data. This vulnerability was introduced in Pillow
diff --git a/docs/releasenotes/template.rst b/docs/releasenotes/template.rst
index 08dbead7f7a..3a89ca55e6c 100644
--- a/docs/releasenotes/template.rst
+++ b/docs/releasenotes/template.rst
@@ -9,8 +9,8 @@ TODO
 
 TODO
 
-Fix CVE-YYYY-XXXXX -- TODO
-^^^^^^^^^^^^^^^^^^^^^^^^^^
+Fix CVE-YYYY-XXXXX
+^^^^^^^^^^^^^^^^^^
 
 .. note:: More information about this vulnerability included in database record :cve:`YYYY-XXXXX`
 

From 95b31380241412166ee7668268f5944f69edd7d8 Mon Sep 17 00:00:00 2001
From: Alex Clark <aclark@aclark.net>
Date: Wed, 13 Mar 2024 14:52:53 -0400
Subject: [PATCH 0317/1178] Clean up for #7864

---
 docs/releasenotes/10.0.0.rst   | 3 ++-
 docs/releasenotes/10.2.0.rst   | 3 ++-
 docs/releasenotes/3.1.1.rst    | 9 ++++++---
 docs/releasenotes/3.1.2.rst    | 3 ++-
 docs/releasenotes/6.2.2.rst    | 3 ++-
 docs/releasenotes/8.0.1.rst    | 9 +++++----
 docs/releasenotes/8.1.0.rst    | 9 ++++++---
 docs/releasenotes/8.2.0.rst    | 1 +
 docs/releasenotes/8.3.0.rst    | 1 +
 docs/releasenotes/8.3.2.rst    | 1 +
 docs/releasenotes/9.0.0.rst    | 3 ++-
 docs/releasenotes/9.0.1.rst    | 8 +++++---
 docs/releasenotes/9.1.1.rst    | 3 ++-
 docs/releasenotes/template.rst | 3 +++
 14 files changed, 40 insertions(+), 19 deletions(-)

diff --git a/docs/releasenotes/10.0.0.rst b/docs/releasenotes/10.0.0.rst
index 25e73bff627..7d7a22afaa7 100644
--- a/docs/releasenotes/10.0.0.rst
+++ b/docs/releasenotes/10.0.0.rst
@@ -19,7 +19,8 @@ Fix CVE-2023-44271
 
 .. note:: More information about this vulnerability included in database record :cve:`2023-44271`
 
-Added ImageFont.MAX_STRING_LENGTH.
+Added ImageFont.MAX_STRING_LENGTH
++++++++++++++++++++++++++++++++++
 
 To protect against potential DOS attacks when using arbitrary strings as text
 input, Pillow will now raise a :py:exc:`ValueError` if the number of characters
diff --git a/docs/releasenotes/10.2.0.rst b/docs/releasenotes/10.2.0.rst
index 38a31ebf4a1..5432343c772 100644
--- a/docs/releasenotes/10.2.0.rst
+++ b/docs/releasenotes/10.2.0.rst
@@ -30,7 +30,8 @@ Fix CVE-2023-50447
 
 .. note:: More information about this vulnerability included in database record :cve:`2023-50447`
 
-ImageMath.eval: Restricted environment keys.
+ImageMath.eval: Restricted environment keys
++++++++++++++++++++++++++++++++++++++++++++
 
 If an attacker has control over the keys passed to the
 ``environment`` argument of :py:meth:`PIL.ImageMath.eval`, they may be able to execute
diff --git a/docs/releasenotes/3.1.1.rst b/docs/releasenotes/3.1.1.rst
index 153c12ab030..49427609e5c 100644
--- a/docs/releasenotes/3.1.1.rst
+++ b/docs/releasenotes/3.1.1.rst
@@ -9,7 +9,8 @@ Fix CVE-2016-0740
 
 .. note:: More information about this vulnerability included in database record :cve:`2016-0740`
 
-Buffer overflow in TiffDecode.c.
+Buffer overflow in TiffDecode.c
++++++++++++++++++++++++++++++++
 
 Pillow 3.1.0 and earlier when linked against
 libtiff >= 4.0.0 on x64 may overflow a buffer when reading a
@@ -31,7 +32,8 @@ Fix CVE-2016-0775
 
 .. note:: More information about this vulnerability included in database record :cve:`2016-0775`
 
-Buffer overflow in FliDecode.c.
+Buffer overflow in FliDecode.c
+++++++++++++++++++++++++++++++
 
 In all versions of Pillow, dating back at least to
 the last PIL 1.1.7 release, FliDecode.c has a buffer overflow error. 
@@ -64,7 +66,8 @@ Fix CVE-2016-2533
 
 .. note:: More information about this vulnerability available in :cve:`2016-2533`
 
-Buffer overflow in PcdDecode.c.
+Buffer overflow in PcdDecode.c
+++++++++++++++++++++++++++++++
 
 In all versions of Pillow, dating back at least to the
 last PIL 1.1.7 release, ``PcdDecode.c`` has a buffer overflow error. 
diff --git a/docs/releasenotes/3.1.2.rst b/docs/releasenotes/3.1.2.rst
index fff93b8e4eb..5bf66650c4a 100644
--- a/docs/releasenotes/3.1.2.rst
+++ b/docs/releasenotes/3.1.2.rst
@@ -9,7 +9,8 @@ Fix CVE-2016-3076
 
 .. note:: More information about this vulnerability included in database record :cve:`2016-3076`
 
-Buffer overflow in Jpeg2KEncode.c.
+Buffer overflow in Jpeg2KEncode.c
++++++++++++++++++++++++++++++++++
 
 Pillow between 2.5.0 and 3.1.1 may overflow a buffer
 when writing large Jpeg2000 files, allowing for code execution or other
diff --git a/docs/releasenotes/6.2.2.rst b/docs/releasenotes/6.2.2.rst
index 704ea6876be..6f0d468db7d 100644
--- a/docs/releasenotes/6.2.2.rst
+++ b/docs/releasenotes/6.2.2.rst
@@ -11,7 +11,8 @@ Fix CVE-2019-19911
 
 .. note:: More information about this vulnerability included in database record :cve:`2019-19911`
 
-DOS attack vulnerability.
+DOS attack vulnerability
+++++++++++++++++++++++++
 
 If an FPX image reports that it has a large number of bands, a large amount of
 resources will be used when trying to process the image. This is fixed by
diff --git a/docs/releasenotes/8.0.1.rst b/docs/releasenotes/8.0.1.rst
index 54ce4085384..263917922c4 100644
--- a/docs/releasenotes/8.0.1.rst
+++ b/docs/releasenotes/8.0.1.rst
@@ -9,12 +9,13 @@ Fix CVE-2020-15999
 
 .. note:: More information about this vulnerability included in database record :cve:`2020-15999`
 
-Update FreeType in wheels to `2.10.4`_. 
+Update FreeType in wheels to `2.10.4`_ 
+++++++++++++++++++++++++++++++++++++++
 
-  - A heap buffer overflow has been found  in the handling of embedded PNG bitmaps,
-    introduced in FreeType version 2.6.
+* A heap buffer overflow has been found  in the handling of embedded PNG bitmaps,
+  introduced in FreeType version 2.6.
 
-    If you use option ``FT_CONFIG_OPTION_USE_PNG`` you should upgrade immediately.
+* If you use option ``FT_CONFIG_OPTION_USE_PNG`` you should upgrade immediately.
 
 We strongly recommend updating to Pillow 8.0.1 if you are using Pillow 8.0.0, which improved support for bitmap fonts.
 
diff --git a/docs/releasenotes/8.1.0.rst b/docs/releasenotes/8.1.0.rst
index 0fbf6ffe3cf..b5425946778 100644
--- a/docs/releasenotes/8.1.0.rst
+++ b/docs/releasenotes/8.1.0.rst
@@ -14,7 +14,8 @@ Fix CVE-2020-35653
 
 .. note:: More information about this vulnerability included in database record :cve:`2020-35653`
 
-Buffer read overrun in PCX decoding.
+Buffer read overrun in PCX decoding
++++++++++++++++++++++++++++++++++++
 
 The PCX image decoder used the reported image stride to calculate
 the row buffer, rather than calculating it from the image size. This issue dates back
@@ -25,7 +26,8 @@ Fix CVE-2020-35654
 
 .. note:: More information about this vulnerability included in database record :cve:`2020-35654`
 
-TIFF out-of-bounds write error.
+TIFF out-of-bounds write error
+++++++++++++++++++++++++++++++
 
 Out-of-bounds write in ``TiffDecode.c`` when reading corrupt YCbCr
 files in some LibTIFF versions (4.1.0/Ubuntu 20.04, but not 4.0.9/Ubuntu 18.04).
@@ -39,7 +41,8 @@ Fix CVE-2020-35655
 
 .. note:: More information about this vulnerability included in database record :cve:`2020-35655`
 
-SGI Decode buffer overrun.
+SGI Decode buffer overrun
++++++++++++++++++++++++++
 
 4 byte read overflow in ``SgiRleDecode.c``, where the code was not correctly
 checking the offsets and length tables. Independently reported through `Tidelift`_ and Google's
diff --git a/docs/releasenotes/8.2.0.rst b/docs/releasenotes/8.2.0.rst
index ea2d7b857cc..d60be7c018a 100644
--- a/docs/releasenotes/8.2.0.rst
+++ b/docs/releasenotes/8.2.0.rst
@@ -13,6 +13,7 @@ Fix CVE-2021-25287, CVE-2021-25288, CVE-2021-28675
     :cve:`2021-25287`, :cve:`2021-25288`, :cve:`2021-28675`
 
 OOB read in Jpeg2KDecode
+++++++++++++++++++++++++
 
 * For J2k images with multiple bands, it's legal to have different widths for each band,
   e.g. 1 byte for ``L``, 4 bytes for ``A``.
diff --git a/docs/releasenotes/8.3.0.rst b/docs/releasenotes/8.3.0.rst
index e5f8e7996cf..e18dc48b23c 100644
--- a/docs/releasenotes/8.3.0.rst
+++ b/docs/releasenotes/8.3.0.rst
@@ -13,6 +13,7 @@ Fix CVE-2021-34552
 .. note:: More information about this vulnerability included in database record :cve:`2021-34552`
 
 Buffer overflow
++++++++++++++++
 
 PIL since 1.1.4 and Pillow since 1.0 allowed parameters passed into a convert function to trigger
 buffer overflow in Convert.c.
diff --git a/docs/releasenotes/8.3.2.rst b/docs/releasenotes/8.3.2.rst
index 3a2295e6a85..6e393b94d99 100644
--- a/docs/releasenotes/8.3.2.rst
+++ b/docs/releasenotes/8.3.2.rst
@@ -10,6 +10,7 @@ Fix CVE-2021-23437
 .. note:: More information about this vulnerability included in database record :cve:`2021-23437`
 
 Avoid potential ReDoS (regular expression denial of service)
+++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++
 
 Avoid a potential ReDoS (regular expression denial of service) in :py:class:`~PIL.ImageColor`'s
 :py:meth:`~PIL.ImageColor.getrgb` by raising :py:exc:`ValueError` if the color specifier is
diff --git a/docs/releasenotes/9.0.0.rst b/docs/releasenotes/9.0.0.rst
index 2f74f3d7038..130db9ebf66 100644
--- a/docs/releasenotes/9.0.0.rst
+++ b/docs/releasenotes/9.0.0.rst
@@ -48,7 +48,8 @@ Fix CVE-2022-22817
 
 .. note:: More information about this vulnerability included in database record :cve:`2022-22817`
 
-Restrict builtins available to ImageMath.eval.
+Restrict builtins available to ImageMath.eval
++++++++++++++++++++++++++++++++++++++++++++++
 
 To limit :py:class:`PIL.ImageMath` to working with images, Pillow
 will now restrict the builtins available to :py:meth:`PIL.ImageMath.eval`. This will
diff --git a/docs/releasenotes/9.0.1.rst b/docs/releasenotes/9.0.1.rst
index 392cf68af84..9501e1eabf0 100644
--- a/docs/releasenotes/9.0.1.rst
+++ b/docs/releasenotes/9.0.1.rst
@@ -11,7 +11,8 @@ Fix CVE-2022-24303
 
 .. note:: More information about this vulnerability included in database record :cve:`2022-24303`
 
-Temp image removal.
+Temp image removal
+++++++++++++++++++
 
 If the path to the temporary directory on Linux or macOS
 contained a space, this would break removal of the temporary image file after
@@ -21,10 +22,11 @@ has been present since PIL.
 Fix CVE-2022-24303
 ^^^^^^^^^^^^^^^^^^
 
-Restrict lambda expressions
-
 .. note:: More information about this vulnerability included in database record :cve:`2022-22817`
 
+Restrict lambda expressions
++++++++++++++++++++++++++++
+
 While Pillow 9.0 restricted top-level builtins available to
 :py:meth:`PIL.ImageMath.eval`, it did not prevent builtins available to lambda
 expressions. These are now also restricted.
diff --git a/docs/releasenotes/9.1.1.rst b/docs/releasenotes/9.1.1.rst
index 85a1653cccf..3dd070d904a 100644
--- a/docs/releasenotes/9.1.1.rst
+++ b/docs/releasenotes/9.1.1.rst
@@ -11,7 +11,8 @@ Fix CVE-2022-30595
 
 .. note:: More information about this vulnerability included in database record :cve:`2022-30595`
 
-Heap buffer overflow.
+Heap buffer overflow
+++++++++++++++++++++
 
 When reading a TGA file with RLE packets that cross scan lines,
 Pillow reads the information past the end of the first line without deducting that
diff --git a/docs/releasenotes/template.rst b/docs/releasenotes/template.rst
index 3a89ca55e6c..a602f3bbf42 100644
--- a/docs/releasenotes/template.rst
+++ b/docs/releasenotes/template.rst
@@ -14,6 +14,9 @@ Fix CVE-YYYY-XXXXX
 
 .. note:: More information about this vulnerability included in database record :cve:`YYYY-XXXXX`
 
+TODO
+++++
+
 TODO
 
 Backwards Incompatible Changes

From 2b8dfaac7c28d0a15b840807e603b316e88ebed9 Mon Sep 17 00:00:00 2001
From: Alex Clark <aclark@aclark.net>
Date: Wed, 13 Mar 2024 15:11:23 -0400
Subject: [PATCH 0318/1178] Retro-add release notes for 2.3.1 for #7864

---
 docs/releasenotes/2.3.1.rst | 12 ++++++++++++
 1 file changed, 12 insertions(+)
 create mode 100644 docs/releasenotes/2.3.1.rst

diff --git a/docs/releasenotes/2.3.1.rst b/docs/releasenotes/2.3.1.rst
new file mode 100644
index 00000000000..ab5a05d5d92
--- /dev/null
+++ b/docs/releasenotes/2.3.1.rst
@@ -0,0 +1,12 @@
+2.3.1
+-----
+
+Security
+========
+
+Fix CVE-2014-1932, CVE-2014-1933
+^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
+
+.. note:: More information about these vulnerabilities included in database records :cve:`CVE-2014-1932`, :cve:`CVE-2014-1933`
+
+Fix insecure use of tempfile.mktemp as reported in `Debian bug #737059 <https://bugs.debian.org/cgi-bin/bugreport.cgi?bug=737059>`_.

From 20d451b35965b4b27154920dd9a62187547cf93f Mon Sep 17 00:00:00 2001
From: "pre-commit-ci[bot]"
 <66853113+pre-commit-ci[bot]@users.noreply.github.com>
Date: Wed, 13 Mar 2024 19:14:02 +0000
Subject: [PATCH 0319/1178] [pre-commit.ci] auto fixes from pre-commit.com
 hooks

for more information, see https://pre-commit.ci
---
 docs/releasenotes/3.1.1.rst | 6 +++---
 docs/releasenotes/3.1.2.rst | 2 +-
 docs/releasenotes/8.0.1.rst | 2 +-
 docs/releasenotes/8.1.1.rst | 2 +-
 4 files changed, 6 insertions(+), 6 deletions(-)

diff --git a/docs/releasenotes/3.1.1.rst b/docs/releasenotes/3.1.1.rst
index 49427609e5c..d02f68aa350 100644
--- a/docs/releasenotes/3.1.1.rst
+++ b/docs/releasenotes/3.1.1.rst
@@ -14,7 +14,7 @@ Buffer overflow in TiffDecode.c
 
 Pillow 3.1.0 and earlier when linked against
 libtiff >= 4.0.0 on x64 may overflow a buffer when reading a
-specially crafted tiff file. 
+specially crafted tiff file.
 
 Specifically, libtiff >= 4.0.0 changed the return type of
 ``TIFFScanlineSize`` from ``int32`` to machine dependent
@@ -36,7 +36,7 @@ Buffer overflow in FliDecode.c
 ++++++++++++++++++++++++++++++
 
 In all versions of Pillow, dating back at least to
-the last PIL 1.1.7 release, FliDecode.c has a buffer overflow error. 
+the last PIL 1.1.7 release, FliDecode.c has a buffer overflow error.
 
 Around line 192:
 
@@ -70,7 +70,7 @@ Buffer overflow in PcdDecode.c
 ++++++++++++++++++++++++++++++
 
 In all versions of Pillow, dating back at least to the
-last PIL 1.1.7 release, ``PcdDecode.c`` has a buffer overflow error. 
+last PIL 1.1.7 release, ``PcdDecode.c`` has a buffer overflow error.
 
 The ``state.buffer`` for ``PcdDecode.c`` is allocated based on a 3
 bytes per pixel sizing, where ``PcdDecode.c`` wrote into the buffer
diff --git a/docs/releasenotes/3.1.2.rst b/docs/releasenotes/3.1.2.rst
index 5bf66650c4a..289430a714d 100644
--- a/docs/releasenotes/3.1.2.rst
+++ b/docs/releasenotes/3.1.2.rst
@@ -14,7 +14,7 @@ Buffer overflow in Jpeg2KEncode.c
 
 Pillow between 2.5.0 and 3.1.1 may overflow a buffer
 when writing large Jpeg2000 files, allowing for code execution or other
-memory corruption. 
+memory corruption.
 
 This occurs specifically in the function ``j2k_encode_entry``, at the line:
 
diff --git a/docs/releasenotes/8.0.1.rst b/docs/releasenotes/8.0.1.rst
index 263917922c4..c3909ac863f 100644
--- a/docs/releasenotes/8.0.1.rst
+++ b/docs/releasenotes/8.0.1.rst
@@ -9,7 +9,7 @@ Fix CVE-2020-15999
 
 .. note:: More information about this vulnerability included in database record :cve:`2020-15999`
 
-Update FreeType in wheels to `2.10.4`_ 
+Update FreeType in wheels to `2.10.4`_
 ++++++++++++++++++++++++++++++++++++++
 
 * A heap buffer overflow has been found  in the handling of embedded PNG bitmaps,
diff --git a/docs/releasenotes/8.1.1.rst b/docs/releasenotes/8.1.1.rst
index 7f871bac1c1..7b56b838ee7 100644
--- a/docs/releasenotes/8.1.1.rst
+++ b/docs/releasenotes/8.1.1.rst
@@ -4,7 +4,7 @@
 Security
 ========
 
-Fix CVE-2021-25289 
+Fix CVE-2021-25289
 ^^^^^^^^^^^^^^^^^^
 
 .. note:: More information about this vulnerability included in database record :cve:`2021-25289`

From a200d716e8425fb1b5a609e9fa194d37d0695261 Mon Sep 17 00:00:00 2001
From: "Jeffrey A. Clark (Alex)" <aclark@aclark.net>
Date: Wed, 13 Mar 2024 15:33:53 -0400
Subject: [PATCH 0320/1178] Update docs/releasenotes/2.3.1.rst

Co-authored-by: Hugo van Kemenade <1324225+hugovk@users.noreply.github.com>
---
 docs/releasenotes/2.3.1.rst | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/docs/releasenotes/2.3.1.rst b/docs/releasenotes/2.3.1.rst
index ab5a05d5d92..6bf65f5c7b3 100644
--- a/docs/releasenotes/2.3.1.rst
+++ b/docs/releasenotes/2.3.1.rst
@@ -7,6 +7,6 @@ Security
 Fix CVE-2014-1932, CVE-2014-1933
 ^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
 
-.. note:: More information about these vulnerabilities included in database records :cve:`CVE-2014-1932`, :cve:`CVE-2014-1933`
+.. note:: More information about these vulnerabilities included in database records :cve:`2014-1932`, :cve:`2014-1933`
 
 Fix insecure use of tempfile.mktemp as reported in `Debian bug #737059 <https://bugs.debian.org/cgi-bin/bugreport.cgi?bug=737059>`_.

From 914db6c230541e672ebbfd938d231cfa2ab21226 Mon Sep 17 00:00:00 2001
From: "Jeffrey A. Clark (Alex)" <aclark@aclark.net>
Date: Wed, 13 Mar 2024 15:34:04 -0400
Subject: [PATCH 0321/1178] Update docs/releasenotes/2.3.1.rst

Co-authored-by: Hugo van Kemenade <1324225+hugovk@users.noreply.github.com>
---
 docs/releasenotes/2.3.1.rst | 3 ++-
 1 file changed, 2 insertions(+), 1 deletion(-)

diff --git a/docs/releasenotes/2.3.1.rst b/docs/releasenotes/2.3.1.rst
index 6bf65f5c7b3..cad00aa4103 100644
--- a/docs/releasenotes/2.3.1.rst
+++ b/docs/releasenotes/2.3.1.rst
@@ -9,4 +9,5 @@ Fix CVE-2014-1932, CVE-2014-1933
 
 .. note:: More information about these vulnerabilities included in database records :cve:`2014-1932`, :cve:`2014-1933`
 
-Fix insecure use of tempfile.mktemp as reported in `Debian bug #737059 <https://bugs.debian.org/cgi-bin/bugreport.cgi?bug=737059>`_.
+Fix insecure use of :py:func:`tempfile.mktemp` as reported in
+`Debian bug #737059 <https://bugs.debian.org/cgi-bin/bugreport.cgi?bug=737059>`_.

From a78fbfed37d5ede66c5b09d7b845a47768153314 Mon Sep 17 00:00:00 2001
From: "Jeffrey A. Clark (Alex)" <aclark@aclark.net>
Date: Wed, 13 Mar 2024 15:34:19 -0400
Subject: [PATCH 0322/1178] Update docs/releasenotes/6.2.2.rst

Co-authored-by: Hugo van Kemenade <1324225+hugovk@users.noreply.github.com>
---
 docs/releasenotes/6.2.2.rst | 4 ++--
 1 file changed, 2 insertions(+), 2 deletions(-)

diff --git a/docs/releasenotes/6.2.2.rst b/docs/releasenotes/6.2.2.rst
index 6f0d468db7d..34d8d97bacb 100644
--- a/docs/releasenotes/6.2.2.rst
+++ b/docs/releasenotes/6.2.2.rst
@@ -34,14 +34,14 @@ Fix CVE-2020-5311
 Buffer overruns were found when processing an SGI image. Checks have been added to prevent this.
 
 Fix CVE-2020-5312
-^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
+^^^^^^^^^^^^^^^^^
 
 .. note:: More information about this vulnerability included in database record :cve:`2020-5312`
 
 Buffer overruns were found when processing an SGI PCX. Checks have been added to prevent this.
 
 Fix CVE-2020-5313
-^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
+^^^^^^^^^^^^^^^^^
 
 .. note:: More information about this vulnerability included in database record :cve:`2020-5313`
 

From deca2dd5fc08bd65d8e6396874ce185d10f592a9 Mon Sep 17 00:00:00 2001
From: "Jeffrey A. Clark (Alex)" <aclark@aclark.net>
Date: Wed, 13 Mar 2024 15:34:29 -0400
Subject: [PATCH 0323/1178] Update docs/releasenotes/6.2.0.rst

Co-authored-by: Hugo van Kemenade <1324225+hugovk@users.noreply.github.com>
---
 docs/releasenotes/6.2.0.rst | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/docs/releasenotes/6.2.0.rst b/docs/releasenotes/6.2.0.rst
index 6dd65be9d11..ea1f310d7fd 100644
--- a/docs/releasenotes/6.2.0.rst
+++ b/docs/releasenotes/6.2.0.rst
@@ -24,7 +24,7 @@ An error is now raised if a TIFF dimension is a string, rather than trying to
 perform operations on it.
 
 Fix CVE-2019-16865
-^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
+^^^^^^^^^^^^^^^^^^
 
 .. note:: More information about this vulnerability included in database record :cve:`2019-16865`
 

From 1f117339bd44626eba2faa409fca34dc4c43d50f Mon Sep 17 00:00:00 2001
From: "Jeffrey A. Clark (Alex)" <aclark@aclark.net>
Date: Wed, 13 Mar 2024 15:34:36 -0400
Subject: [PATCH 0324/1178] Update docs/releasenotes/10.2.0.rst

Co-authored-by: Hugo van Kemenade <1324225+hugovk@users.noreply.github.com>
---
 docs/releasenotes/10.2.0.rst | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/docs/releasenotes/10.2.0.rst b/docs/releasenotes/10.2.0.rst
index 5432343c772..bec558ec9a1 100644
--- a/docs/releasenotes/10.2.0.rst
+++ b/docs/releasenotes/10.2.0.rst
@@ -26,7 +26,7 @@ To protect against potential DOS attacks when using PIL fonts,
 they do not extend beyond the bitmap image.
 
 Fix CVE-2023-50447
-^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
+^^^^^^^^^^^^^^^^^^
 
 .. note:: More information about this vulnerability included in database record :cve:`2023-50447`
 

From f77273db8fb0a1dc4b44cf9c188ff8e6f0552c7b Mon Sep 17 00:00:00 2001
From: "Jeffrey A. Clark (Alex)" <aclark@aclark.net>
Date: Wed, 13 Mar 2024 15:44:15 -0400
Subject: [PATCH 0325/1178] Update docs/releasenotes/10.0.0.rst
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit

Co-authored-by: Ondrej Baranovič <nulano@nulano.eu>
---
 docs/releasenotes/10.0.0.rst | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/docs/releasenotes/10.0.0.rst b/docs/releasenotes/10.0.0.rst
index 7d7a22afaa7..993ec4d5d02 100644
--- a/docs/releasenotes/10.0.0.rst
+++ b/docs/releasenotes/10.0.0.rst
@@ -20,7 +20,7 @@ Fix CVE-2023-44271
 .. note:: More information about this vulnerability included in database record :cve:`2023-44271`
 
 Added ImageFont.MAX_STRING_LENGTH
-+++++++++++++++++++++++++++++++++
+~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
 
 To protect against potential DOS attacks when using arbitrary strings as text
 input, Pillow will now raise a :py:exc:`ValueError` if the number of characters

From 92f088919f447913484f6c2b57acbd0ce8e668dc Mon Sep 17 00:00:00 2001
From: Alex Clark <aclark@aclark.net>
Date: Wed, 13 Mar 2024 15:45:19 -0400
Subject: [PATCH 0326/1178] Fix template based on
 29a361d60ead196695523212dbb08a3ec4ca4b0d

---
 docs/releasenotes/template.rst | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/docs/releasenotes/template.rst b/docs/releasenotes/template.rst
index a602f3bbf42..65671808185 100644
--- a/docs/releasenotes/template.rst
+++ b/docs/releasenotes/template.rst
@@ -15,7 +15,7 @@ Fix CVE-YYYY-XXXXX
 .. note:: More information about this vulnerability included in database record :cve:`YYYY-XXXXX`
 
 TODO
-++++
+~~~~
 
 TODO
 

From f61e184ab059a87109eec9d0455ec83af3497d7c Mon Sep 17 00:00:00 2001
From: Alex Clark <aclark@aclark.net>
Date: Wed, 13 Mar 2024 15:50:58 -0400
Subject: [PATCH 0327/1178] Fix based on
 29a361d60ead196695523212dbb08a3ec4ca4b0d

---
 docs/releasenotes/10.2.0.rst | 2 +-
 docs/releasenotes/3.1.1.rst  | 6 +++---
 docs/releasenotes/3.1.2.rst  | 2 +-
 docs/releasenotes/6.2.2.rst  | 2 +-
 docs/releasenotes/8.0.1.rst  | 2 +-
 docs/releasenotes/8.1.0.rst  | 6 +++---
 docs/releasenotes/8.2.0.rst  | 2 +-
 docs/releasenotes/8.3.0.rst  | 2 +-
 docs/releasenotes/8.3.2.rst  | 2 +-
 docs/releasenotes/9.0.0.rst  | 2 +-
 docs/releasenotes/9.0.1.rst  | 4 ++--
 docs/releasenotes/9.1.1.rst  | 2 +-
 12 files changed, 17 insertions(+), 17 deletions(-)

diff --git a/docs/releasenotes/10.2.0.rst b/docs/releasenotes/10.2.0.rst
index bec558ec9a1..63cbe8806cd 100644
--- a/docs/releasenotes/10.2.0.rst
+++ b/docs/releasenotes/10.2.0.rst
@@ -31,7 +31,7 @@ Fix CVE-2023-50447
 .. note:: More information about this vulnerability included in database record :cve:`2023-50447`
 
 ImageMath.eval: Restricted environment keys
-+++++++++++++++++++++++++++++++++++++++++++
+~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
 
 If an attacker has control over the keys passed to the
 ``environment`` argument of :py:meth:`PIL.ImageMath.eval`, they may be able to execute
diff --git a/docs/releasenotes/3.1.1.rst b/docs/releasenotes/3.1.1.rst
index d02f68aa350..7f66ac344b9 100644
--- a/docs/releasenotes/3.1.1.rst
+++ b/docs/releasenotes/3.1.1.rst
@@ -10,7 +10,7 @@ Fix CVE-2016-0740
 .. note:: More information about this vulnerability included in database record :cve:`2016-0740`
 
 Buffer overflow in TiffDecode.c
-+++++++++++++++++++++++++++++++
+~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
 
 Pillow 3.1.0 and earlier when linked against
 libtiff >= 4.0.0 on x64 may overflow a buffer when reading a
@@ -33,7 +33,7 @@ Fix CVE-2016-0775
 .. note:: More information about this vulnerability included in database record :cve:`2016-0775`
 
 Buffer overflow in FliDecode.c
-++++++++++++++++++++++++++++++
+~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
 
 In all versions of Pillow, dating back at least to
 the last PIL 1.1.7 release, FliDecode.c has a buffer overflow error.
@@ -67,7 +67,7 @@ Fix CVE-2016-2533
 .. note:: More information about this vulnerability available in :cve:`2016-2533`
 
 Buffer overflow in PcdDecode.c
-++++++++++++++++++++++++++++++
+~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
 
 In all versions of Pillow, dating back at least to the
 last PIL 1.1.7 release, ``PcdDecode.c`` has a buffer overflow error.
diff --git a/docs/releasenotes/3.1.2.rst b/docs/releasenotes/3.1.2.rst
index 289430a714d..1a46d8e639b 100644
--- a/docs/releasenotes/3.1.2.rst
+++ b/docs/releasenotes/3.1.2.rst
@@ -10,7 +10,7 @@ Fix CVE-2016-3076
 .. note:: More information about this vulnerability included in database record :cve:`2016-3076`
 
 Buffer overflow in Jpeg2KEncode.c
-+++++++++++++++++++++++++++++++++
+~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
 
 Pillow between 2.5.0 and 3.1.1 may overflow a buffer
 when writing large Jpeg2000 files, allowing for code execution or other
diff --git a/docs/releasenotes/6.2.2.rst b/docs/releasenotes/6.2.2.rst
index 34d8d97bacb..648d1d66d74 100644
--- a/docs/releasenotes/6.2.2.rst
+++ b/docs/releasenotes/6.2.2.rst
@@ -12,7 +12,7 @@ Fix CVE-2019-19911
 .. note:: More information about this vulnerability included in database record :cve:`2019-19911`
 
 DOS attack vulnerability
-++++++++++++++++++++++++
+~~~~~~~~~~~~~~~~~~~~~~~~
 
 If an FPX image reports that it has a large number of bands, a large amount of
 resources will be used when trying to process the image. This is fixed by
diff --git a/docs/releasenotes/8.0.1.rst b/docs/releasenotes/8.0.1.rst
index c3909ac863f..a492241d7f9 100644
--- a/docs/releasenotes/8.0.1.rst
+++ b/docs/releasenotes/8.0.1.rst
@@ -10,7 +10,7 @@ Fix CVE-2020-15999
 .. note:: More information about this vulnerability included in database record :cve:`2020-15999`
 
 Update FreeType in wheels to `2.10.4`_
-++++++++++++++++++++++++++++++++++++++
+~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
 
 * A heap buffer overflow has been found  in the handling of embedded PNG bitmaps,
   introduced in FreeType version 2.6.
diff --git a/docs/releasenotes/8.1.0.rst b/docs/releasenotes/8.1.0.rst
index b5425946778..909954a37ee 100644
--- a/docs/releasenotes/8.1.0.rst
+++ b/docs/releasenotes/8.1.0.rst
@@ -15,7 +15,7 @@ Fix CVE-2020-35653
 .. note:: More information about this vulnerability included in database record :cve:`2020-35653`
 
 Buffer read overrun in PCX decoding
-+++++++++++++++++++++++++++++++++++
+~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
 
 The PCX image decoder used the reported image stride to calculate
 the row buffer, rather than calculating it from the image size. This issue dates back
@@ -27,7 +27,7 @@ Fix CVE-2020-35654
 .. note:: More information about this vulnerability included in database record :cve:`2020-35654`
 
 TIFF out-of-bounds write error
-++++++++++++++++++++++++++++++
+~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
 
 Out-of-bounds write in ``TiffDecode.c`` when reading corrupt YCbCr
 files in some LibTIFF versions (4.1.0/Ubuntu 20.04, but not 4.0.9/Ubuntu 18.04).
@@ -42,7 +42,7 @@ Fix CVE-2020-35655
 .. note:: More information about this vulnerability included in database record :cve:`2020-35655`
 
 SGI Decode buffer overrun
-+++++++++++++++++++++++++
+~~~~~~~~~~~~~~~~~~~~~~~~~
 
 4 byte read overflow in ``SgiRleDecode.c``, where the code was not correctly
 checking the offsets and length tables. Independently reported through `Tidelift`_ and Google's
diff --git a/docs/releasenotes/8.2.0.rst b/docs/releasenotes/8.2.0.rst
index d60be7c018a..adbabce3a45 100644
--- a/docs/releasenotes/8.2.0.rst
+++ b/docs/releasenotes/8.2.0.rst
@@ -13,7 +13,7 @@ Fix CVE-2021-25287, CVE-2021-25288, CVE-2021-28675
     :cve:`2021-25287`, :cve:`2021-25288`, :cve:`2021-28675`
 
 OOB read in Jpeg2KDecode
-++++++++++++++++++++++++
+~~~~~~~~~~~~~~~~~~~~~~~~
 
 * For J2k images with multiple bands, it's legal to have different widths for each band,
   e.g. 1 byte for ``L``, 4 bytes for ``A``.
diff --git a/docs/releasenotes/8.3.0.rst b/docs/releasenotes/8.3.0.rst
index e18dc48b23c..94ad37bb1b9 100644
--- a/docs/releasenotes/8.3.0.rst
+++ b/docs/releasenotes/8.3.0.rst
@@ -13,7 +13,7 @@ Fix CVE-2021-34552
 .. note:: More information about this vulnerability included in database record :cve:`2021-34552`
 
 Buffer overflow
-+++++++++++++++
+~~~~~~~~~~~~~~~
 
 PIL since 1.1.4 and Pillow since 1.0 allowed parameters passed into a convert function to trigger
 buffer overflow in Convert.c.
diff --git a/docs/releasenotes/8.3.2.rst b/docs/releasenotes/8.3.2.rst
index 6e393b94d99..6796365641c 100644
--- a/docs/releasenotes/8.3.2.rst
+++ b/docs/releasenotes/8.3.2.rst
@@ -10,7 +10,7 @@ Fix CVE-2021-23437
 .. note:: More information about this vulnerability included in database record :cve:`2021-23437`
 
 Avoid potential ReDoS (regular expression denial of service)
-++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++
+~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
 
 Avoid a potential ReDoS (regular expression denial of service) in :py:class:`~PIL.ImageColor`'s
 :py:meth:`~PIL.ImageColor.getrgb` by raising :py:exc:`ValueError` if the color specifier is
diff --git a/docs/releasenotes/9.0.0.rst b/docs/releasenotes/9.0.0.rst
index 130db9ebf66..534209117a5 100644
--- a/docs/releasenotes/9.0.0.rst
+++ b/docs/releasenotes/9.0.0.rst
@@ -49,7 +49,7 @@ Fix CVE-2022-22817
 .. note:: More information about this vulnerability included in database record :cve:`2022-22817`
 
 Restrict builtins available to ImageMath.eval
-+++++++++++++++++++++++++++++++++++++++++++++
+~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
 
 To limit :py:class:`PIL.ImageMath` to working with images, Pillow
 will now restrict the builtins available to :py:meth:`PIL.ImageMath.eval`. This will
diff --git a/docs/releasenotes/9.0.1.rst b/docs/releasenotes/9.0.1.rst
index 9501e1eabf0..ab6c6cbdde3 100644
--- a/docs/releasenotes/9.0.1.rst
+++ b/docs/releasenotes/9.0.1.rst
@@ -12,7 +12,7 @@ Fix CVE-2022-24303
 .. note:: More information about this vulnerability included in database record :cve:`2022-24303`
 
 Temp image removal
-++++++++++++++++++
+~~~~~~~~~~~~~~~~~~
 
 If the path to the temporary directory on Linux or macOS
 contained a space, this would break removal of the temporary image file after
@@ -25,7 +25,7 @@ Fix CVE-2022-24303
 .. note:: More information about this vulnerability included in database record :cve:`2022-22817`
 
 Restrict lambda expressions
-+++++++++++++++++++++++++++
+~~~~~~~~~~~~~~~~~~~~~~~~~~~
 
 While Pillow 9.0 restricted top-level builtins available to
 :py:meth:`PIL.ImageMath.eval`, it did not prevent builtins available to lambda
diff --git a/docs/releasenotes/9.1.1.rst b/docs/releasenotes/9.1.1.rst
index 3dd070d904a..f8f1a802ba0 100644
--- a/docs/releasenotes/9.1.1.rst
+++ b/docs/releasenotes/9.1.1.rst
@@ -12,7 +12,7 @@ Fix CVE-2022-30595
 .. note:: More information about this vulnerability included in database record :cve:`2022-30595`
 
 Heap buffer overflow
-++++++++++++++++++++
+~~~~~~~~~~~~~~~~~~~~
 
 When reading a TGA file with RLE packets that cross scan lines,
 Pillow reads the information past the end of the first line without deducting that

From c69dcc1c2969406155788d4c3f4e8fb496490f5d Mon Sep 17 00:00:00 2001
From: Alex Clark <aclark@aclark.net>
Date: Thu, 14 Mar 2024 13:58:05 -0400
Subject: [PATCH 0328/1178] Fix headers and retro-add notes for #7864

- Include CVE link in title (via @hugovk)
- Retro-add release notes for 2.3.2, 2.5.2 for CVE-2014-3589
---
 docs/releasenotes/10.0.0.rst   |  9 +++-----
 docs/releasenotes/10.0.1.rst   |  9 ++++----
 docs/releasenotes/10.2.0.rst   |  9 ++------
 docs/releasenotes/2.3.1.rst    | 14 +++++++-----
 docs/releasenotes/2.3.2.rst    | 12 ++++++++++
 docs/releasenotes/2.5.2.rst    | 12 ++++++++++
 docs/releasenotes/3.1.1.rst    | 31 +++++++-------------------
 docs/releasenotes/3.1.2.rst    |  9 ++------
 docs/releasenotes/6.2.0.rst    | 10 ++++-----
 docs/releasenotes/6.2.2.rst    | 37 ++++++++++---------------------
 docs/releasenotes/7.1.0.rst    | 40 +++++++++++++---------------------
 docs/releasenotes/8.0.1.rst    |  9 ++------
 docs/releasenotes/8.1.0.rst    | 27 +++++------------------
 docs/releasenotes/8.1.1.rst    | 38 +++++++++-----------------------
 docs/releasenotes/8.1.2.rst    | 18 +++++----------
 docs/releasenotes/8.2.0.rst    | 36 ++++++++++--------------------
 docs/releasenotes/8.3.0.rst    | 12 ++--------
 docs/releasenotes/8.3.2.rst    |  9 ++------
 docs/releasenotes/9.0.0.rst    |  6 ++---
 docs/releasenotes/9.0.1.rst    | 22 +++++--------------
 docs/releasenotes/9.1.1.rst    | 11 +++-------
 docs/releasenotes/index.rst    |  2 ++
 docs/releasenotes/template.rst |  9 ++------
 23 files changed, 137 insertions(+), 254 deletions(-)
 create mode 100644 docs/releasenotes/2.3.2.rst
 create mode 100644 docs/releasenotes/2.5.2.rst

diff --git a/docs/releasenotes/10.0.0.rst b/docs/releasenotes/10.0.0.rst
index 993ec4d5d02..adada6e0151 100644
--- a/docs/releasenotes/10.0.0.rst
+++ b/docs/releasenotes/10.0.0.rst
@@ -14,13 +14,10 @@ now been fixed.
 This effectively dates to the PIL fork, since problem images would still have
 been processed before Pillow started checking for decompression bombs.
 
-Fix CVE-2023-44271
-^^^^^^^^^^^^^^^^^^
+.. _Added ImageFont.MAX_STRING_LENGTH:
 
-.. note:: More information about this vulnerability included in database record :cve:`2023-44271`
-
-Added ImageFont.MAX_STRING_LENGTH
-~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
+:cve:`2023-44271`: Added ImageFont.MAX_STRING_LENGTH
+^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
 
 To protect against potential DOS attacks when using arbitrary strings as text
 input, Pillow will now raise a :py:exc:`ValueError` if the number of characters
diff --git a/docs/releasenotes/10.0.1.rst b/docs/releasenotes/10.0.1.rst
index ab0f98123da..a260fc3819a 100644
--- a/docs/releasenotes/10.0.1.rst
+++ b/docs/releasenotes/10.0.1.rst
@@ -4,13 +4,12 @@
 Security
 ========
 
-Fix CVE-2023-4863
-^^^^^^^^^^^^^^^^^
-
-.. note:: More information about this vulnerability included in database record :cve:`2023-4863`
+:cve:`2023-4863`: Updated install script and updated wheels
+^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
 
 This release provides an updated install script and updated wheels to
-include libwebp 1.3.2, preventing a potential heap buffer overflow in WebP.
+include libwebp 1.3.2, preventing a potential heap buffer overflow in
+WebP.
 
 Updated tests to pass with latest zlib version
 ==============================================
diff --git a/docs/releasenotes/10.2.0.rst b/docs/releasenotes/10.2.0.rst
index 63cbe8806cd..0ffad2e8a1c 100644
--- a/docs/releasenotes/10.2.0.rst
+++ b/docs/releasenotes/10.2.0.rst
@@ -25,13 +25,8 @@ To protect against potential DOS attacks when using PIL fonts,
 :py:class:`PIL.ImageFont.ImageFont` now trims the size of individual glyphs so that
 they do not extend beyond the bitmap image.
 
-Fix CVE-2023-50447
-^^^^^^^^^^^^^^^^^^
-
-.. note:: More information about this vulnerability included in database record :cve:`2023-50447`
-
-ImageMath.eval: Restricted environment keys
-~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
+:cve:`2023-50447`: ImageMath.eval: Restricted environment keys
+^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
 
 If an attacker has control over the keys passed to the
 ``environment`` argument of :py:meth:`PIL.ImageMath.eval`, they may be able to execute
diff --git a/docs/releasenotes/2.3.1.rst b/docs/releasenotes/2.3.1.rst
index cad00aa4103..2c7c8285a3e 100644
--- a/docs/releasenotes/2.3.1.rst
+++ b/docs/releasenotes/2.3.1.rst
@@ -4,10 +4,14 @@
 Security
 ========
 
-Fix CVE-2014-1932, CVE-2014-1933
-^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
+These issues reported in `Debian bug #737059 <https://bugs.debian.org/cgi-bin/bugreport.cgi?bug=737059>`_.
 
-.. note:: More information about these vulnerabilities included in database records :cve:`2014-1932`, :cve:`2014-1933`
+:cve:`2014-1932`: Fix insecure use of :py:func:`tempfile.mktemp`
+^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
 
-Fix insecure use of :py:func:`tempfile.mktemp` as reported in
-`Debian bug #737059 <https://bugs.debian.org/cgi-bin/bugreport.cgi?bug=737059>`_.
+The (1) load_djpeg function in JpegImagePlugin.py, (2) Ghostscript function in EpsImagePlugin.py, (3) load function in IptcImagePlugin.py, and (4) _copy function in Image.py in Python Image Library (PIL) 1.1.7 and earlier and Pillow before 2.3.1 do not properly create temporary files, which allow local users to overwrite arbitrary files and obtain sensitive information via a symlink attack on the temporary file.
+
+:cve:`2014-1933`: Fix insecure use of :py:func:`tempfile.mktemp`
+^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
+
+The (1) JpegImagePlugin.py and (2) EpsImagePlugin.py scripts in Python Image Library (PIL) 1.1.7 and earlier and Pillow before 2.3.1 uses the names of temporary files on the command line, which makes it easier for local users to conduct symlink attacks by listing the processes. 
diff --git a/docs/releasenotes/2.3.2.rst b/docs/releasenotes/2.3.2.rst
new file mode 100644
index 00000000000..a8ed32718aa
--- /dev/null
+++ b/docs/releasenotes/2.3.2.rst
@@ -0,0 +1,12 @@
+2.3.2
+-----
+
+Security
+========
+
+:cve:`2014-3589`: Fix DOS attack
+^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
+
+``PIL/IcnsImagePlugin.py`` in Python Imaging Library (PIL) and Pillow before 2.3.2 and
+2.5.x before 2.5.2 allows remote attackers to cause a denial of service via a crafted
+block size. 
diff --git a/docs/releasenotes/2.5.2.rst b/docs/releasenotes/2.5.2.rst
new file mode 100644
index 00000000000..77365ef3e6e
--- /dev/null
+++ b/docs/releasenotes/2.5.2.rst
@@ -0,0 +1,12 @@
+2.5.2
+-----
+
+Security
+========
+
+:cve:`2014-3589`: Fix DOS attack
+^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
+
+``PIL/IcnsImagePlugin.py`` in Python Imaging Library (PIL) and Pillow before 2.3.2 and
+2.5.x before 2.5.2 allows remote attackers to cause a denial of service via a crafted
+block size. 
diff --git a/docs/releasenotes/3.1.1.rst b/docs/releasenotes/3.1.1.rst
index 7f66ac344b9..6e03382b29f 100644
--- a/docs/releasenotes/3.1.1.rst
+++ b/docs/releasenotes/3.1.1.rst
@@ -4,13 +4,8 @@
 Security
 ========
 
-Fix CVE-2016-0740
-^^^^^^^^^^^^^^^^^
-
-.. note:: More information about this vulnerability included in database record :cve:`2016-0740`
-
-Buffer overflow in TiffDecode.c
-~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
+:cve:`2016-0740`: Buffer overflow in TiffDecode.c
+^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
 
 Pillow 3.1.0 and earlier when linked against
 libtiff >= 4.0.0 on x64 may overflow a buffer when reading a
@@ -27,16 +22,11 @@ image data over 64k is written over the heap, causing a segfault.
 
 This issue was found by security researcher FourOne.
 
-Fix CVE-2016-0775
-^^^^^^^^^^^^^^^^^
-
-.. note:: More information about this vulnerability included in database record :cve:`2016-0775`
+:cve:`2016-0775`: Buffer overflow in FliDecode.c
+^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
 
-Buffer overflow in FliDecode.c
-~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
-
-In all versions of Pillow, dating back at least to
-the last PIL 1.1.7 release, FliDecode.c has a buffer overflow error.
+In all versions of Pillow, dating back at least to the last PIL 1.1.7
+release, FliDecode.c has a buffer overflow error.
 
 Around line 192:
 
@@ -61,13 +51,8 @@ off the end of the memory buffer, causing a segfault.
 
 This issue was found by Alyssa Besseling at Atlassian.
 
-Fix CVE-2016-2533
-^^^^^^^^^^^^^^^^^
-
-.. note:: More information about this vulnerability available in :cve:`2016-2533`
-
-Buffer overflow in PcdDecode.c
-~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
+:cve:`2016-2533`: Buffer overflow in PcdDecode.c
+^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
 
 In all versions of Pillow, dating back at least to the
 last PIL 1.1.7 release, ``PcdDecode.c`` has a buffer overflow error.
diff --git a/docs/releasenotes/3.1.2.rst b/docs/releasenotes/3.1.2.rst
index 1a46d8e639b..a9615497795 100644
--- a/docs/releasenotes/3.1.2.rst
+++ b/docs/releasenotes/3.1.2.rst
@@ -4,13 +4,8 @@
 Security
 ========
 
-Fix CVE-2016-3076
-^^^^^^^^^^^^^^^^^
-
-.. note:: More information about this vulnerability included in database record :cve:`2016-3076`
-
-Buffer overflow in Jpeg2KEncode.c
-~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
+:cve:`2016-3076`: Buffer overflow in Jpeg2KEncode.c
+^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
 
 Pillow between 2.5.0 and 3.1.1 may overflow a buffer
 when writing large Jpeg2000 files, allowing for code execution or other
diff --git a/docs/releasenotes/6.2.0.rst b/docs/releasenotes/6.2.0.rst
index ea1f310d7fd..9c504da0f41 100644
--- a/docs/releasenotes/6.2.0.rst
+++ b/docs/releasenotes/6.2.0.rst
@@ -23,13 +23,11 @@ Decompression bomb checks have been added to GIF and ICO formats.
 An error is now raised if a TIFF dimension is a string, rather than trying to
 perform operations on it.
 
-Fix CVE-2019-16865
-^^^^^^^^^^^^^^^^^^
+:cve:`2019-16865`: Fix DOS attack
+^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
 
-.. note:: More information about this vulnerability included in database record :cve:`2019-16865`
-
-The CVE is regarding DOS problems, such as consuming large
-amounts of memory, or taking a large amount of time to process an image.
+The CVE is regarding DOS problems, such as consuming large amounts of memory,
+or taking a large amount of time to process an image.
 
 API Additions
 =============
diff --git a/docs/releasenotes/6.2.2.rst b/docs/releasenotes/6.2.2.rst
index 648d1d66d74..a95ab1cce6e 100644
--- a/docs/releasenotes/6.2.2.rst
+++ b/docs/releasenotes/6.2.2.rst
@@ -4,45 +4,32 @@
 Security
 ========
 
-This release fixes several buffer overruns and DOS attacks reported in CVE-2019-19911, CVE-2020-5310, CVE-2020-5311, CVE-2020-5312 and CVE-2020-5313.
+This release fixes several buffer overruns and DOS attacks. 
 
-Fix CVE-2019-19911
-^^^^^^^^^^^^^^^^^^
-
-.. note:: More information about this vulnerability included in database record :cve:`2019-19911`
-
-DOS attack vulnerability
-~~~~~~~~~~~~~~~~~~~~~~~~
+:cve:`2019-19911`: DOS attack vulnerability
+^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
 
 If an FPX image reports that it has a large number of bands, a large amount of
 resources will be used when trying to process the image. This is fixed by
 limiting the number of bands to those usable by Pillow.
 
-Fix CVE-2020-5310
-^^^^^^^^^^^^^^^^^
-
-.. note:: More information about this vulnerability included in database record :cve:`2020-5310`
+:cve:`2020-5310`: Overflow checks added to TIFF image processing
+^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
 
 Overflow checks have been added when calculating the size of a memory block to be reallocated
 in the processing of a TIFF image.
 
-Fix CVE-2020-5311
-^^^^^^^^^^^^^^^^^
-
-.. note:: More information about this vulnerability included in database record :cve:`2020-5311`
+:cve:`2020-5311`: Overflow checks added to SGI image processing
+^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
 
 Buffer overruns were found when processing an SGI image. Checks have been added to prevent this.
 
-Fix CVE-2020-5312
-^^^^^^^^^^^^^^^^^
-
-.. note:: More information about this vulnerability included in database record :cve:`2020-5312`
-
-Buffer overruns were found when processing an SGI PCX. Checks have been added to prevent this.
+:cve:`2020-5312`: Overflow checks added to PCX image processing
+^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
 
-Fix CVE-2020-5313
-^^^^^^^^^^^^^^^^^
+Buffer overruns were found when processing a PCX image. Checks have been added to prevent this.
 
-.. note:: More information about this vulnerability included in database record :cve:`2020-5313`
+:cve:`2020-5313`: Overflow checks added to FLI image processing
+^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
 
 Buffer overruns were found when processing an FLI image. Checks have been added to prevent this.
diff --git a/docs/releasenotes/7.1.0.rst b/docs/releasenotes/7.1.0.rst
index da6595d5ba7..e5e8b6a5af6 100644
--- a/docs/releasenotes/7.1.0.rst
+++ b/docs/releasenotes/7.1.0.rst
@@ -6,40 +6,30 @@ Security
 
 This release includes many security fixes.
 
-Fix CVE-2020-10177
-^^^^^^^^^^^^^^^^^^
+:cve:`2020-10177`: Multiple out-of-bounds reads in FLI decoding
+^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
 
-.. note:: More information about this vulnerability included in database record :cve:`2020-10177`
+Pillow before 7.1.0 has multiple out-of-bounds reads in ``libImaging/FliDecode.c``.
 
-Multiple out-of-bounds reads in FLI decoding.
+:cve:`2020-10378`: Bounds overflow in PCX decoding
+^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
 
-Fix CVE-2020-10378
-^^^^^^^^^^^^^^^^^^
+In ``libImaging/PcxDecode.c`` in Pillow before 7.1.0, an out-of-bounds read can occur when reading PCX files where state->shuffle is instructed to read beyond state->buffer. 
 
-.. note:: More information about this vulnerability included in database record :cve:`2020-10378`
+:cve:`2020-10379`: Two buffer overflows in TIFF decoding
+^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
 
-Bounds overflow in PCX decoding.
+In Pillow before 7.1.0, there are two buffer overflows in ``libImaging/TiffDecode.c``.
 
-Fix CVE-2020-10379
-^^^^^^^^^^^^^^^^^^
+:cve:`2020-10994`: Bounds overflow in JPEG 2000 decoding
+^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
 
-.. note:: More information about this vulnerability included in database record :cve:`2020-10379`
+In ``libImaging/Jpeg2KDecode.c`` in Pillow before 7.1.0, there are multiple out-of-bounds reads via a crafted JP2 file. 
 
-Two buffer overflows in TIFF decoding.
-
-Fix CVE-2020-10994
-^^^^^^^^^^^^^^^^^^
-
-.. note:: More information about this vulnerability included in database record :cve:`2020-10994`
-
-Bounds overflow in JPEG 2000 decoding.
-
-Fix CVE-2020-11538
-^^^^^^^^^^^^^^^^^^
-
-.. note:: More information about this vulnerability included in database record :cve:`2020-11538`
+:cve:`2020-11538`: Buffer overflow in SGI-RLE decoding
+^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
 
-Buffer overflow in SGI-RLE decoding.
+In ``libImaging/SgiRleDecode.c`` in Pillow through 7.0.0, a number of out-of-bounds reads exist in the parsing of SGI image files, a different issue than CVE-2020-5311. 
 
 API Changes
 ===========
diff --git a/docs/releasenotes/8.0.1.rst b/docs/releasenotes/8.0.1.rst
index a492241d7f9..29a28443f5e 100644
--- a/docs/releasenotes/8.0.1.rst
+++ b/docs/releasenotes/8.0.1.rst
@@ -4,13 +4,8 @@
 Security
 ========
 
-Fix CVE-2020-15999
-^^^^^^^^^^^^^^^^^^
-
-.. note:: More information about this vulnerability included in database record :cve:`2020-15999`
-
-Update FreeType in wheels to `2.10.4`_
-~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
+:cve:`2020-15999`: Update FreeType in wheels to `2.10.4`_
+^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
 
 * A heap buffer overflow has been found  in the handling of embedded PNG bitmaps,
   introduced in FreeType version 2.6.
diff --git a/docs/releasenotes/8.1.0.rst b/docs/releasenotes/8.1.0.rst
index 909954a37ee..5c399331846 100644
--- a/docs/releasenotes/8.1.0.rst
+++ b/docs/releasenotes/8.1.0.rst
@@ -9,25 +9,15 @@ This release includes security fixes.
 * An out-of-bounds read when saving TIFFs with custom metadata through LibTIFF
 * An out-of-bounds read when saving a GIF of 1px width
 
-Fix CVE-2020-35653
-^^^^^^^^^^^^^^^^^^
-
-.. note:: More information about this vulnerability included in database record :cve:`2020-35653`
-
-Buffer read overrun in PCX decoding
-~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
+:cve:`2020-35653`: Buffer read overrun in PCX decoding
+^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
 
 The PCX image decoder used the reported image stride to calculate
 the row buffer, rather than calculating it from the image size. This issue dates back
 to the PIL fork. Thanks to Google's `OSS-Fuzz`_ project for finding this.
 
-Fix CVE-2020-35654
-^^^^^^^^^^^^^^^^^^
-
-.. note:: More information about this vulnerability included in database record :cve:`2020-35654`
-
-TIFF out-of-bounds write error
-~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
+:cve:`2020-35654`: TIFF out-of-bounds write error
+^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
 
 Out-of-bounds write in ``TiffDecode.c`` when reading corrupt YCbCr
 files in some LibTIFF versions (4.1.0/Ubuntu 20.04, but not 4.0.9/Ubuntu 18.04).
@@ -36,13 +26,8 @@ leading to an out-of-bounds write in ``TiffDecode.c``. This potentially affects
 versions from 6.0.0 to 8.0.1, depending on the version of LibTIFF. This was reported through
 `Tidelift`_.
 
-Fix CVE-2020-35655
-^^^^^^^^^^^^^^^^^^
-
-.. note:: More information about this vulnerability included in database record :cve:`2020-35655`
-
-SGI Decode buffer overrun
-~~~~~~~~~~~~~~~~~~~~~~~~~
+:cve:`2020-35655`: SGI Decode buffer overrun
+^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
 
 4 byte read overflow in ``SgiRleDecode.c``, where the code was not correctly
 checking the offsets and length tables. Independently reported through `Tidelift`_ and Google's
diff --git a/docs/releasenotes/8.1.1.rst b/docs/releasenotes/8.1.1.rst
index 7b56b838ee7..84e9c8f86e0 100644
--- a/docs/releasenotes/8.1.1.rst
+++ b/docs/releasenotes/8.1.1.rst
@@ -4,40 +4,22 @@
 Security
 ========
 
-Fix CVE-2021-25289
-^^^^^^^^^^^^^^^^^^
-
-.. note:: More information about this vulnerability included in database record :cve:`2021-25289`
+:cve:`2021-25289`: The previous fix for :cve:`2020-35654` was insufficient
+^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
 
 The previous fix for :cve:`2020-35654` was insufficient due to incorrect error checking in ``TiffDecode.c``.
 
-Fix CVE-2021-25290
-^^^^^^^^^^^^^^^^^^
-
-.. note:: More information about this vulnerability included in database record :cve:`2021-25290`
-
-In ``TiffDecode.c``, there is a negative-offset ``memcpy`` with an invalid size.
-
-Fix CVE-2021-25291
-^^^^^^^^^^^^^^^^^^
-
-.. note:: More information about this vulnerability included in database record :cve:`2021-25291`
-
-In ``TiffDecode.c``, invalid tile boundaries could lead to an out-of-bounds read in ``TIFFReadRGBATile``.
-
-Fix CVE-2021-25292
-^^^^^^^^^^^^^^^^^^
-
-.. note:: More information about this vulnerability included in database record :cve:`2021-25292`:
-
-The PDF parser has a catastrophic backtracking regex that could be used as a DOS attack.
+:cve:`2021-25290`: In ``TiffDecode.c``, there is a negative-offset ``memcpy`` with an invalid size
+^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
 
-Fix CVE-2021-25293
-^^^^^^^^^^^^^^^^^^
+:cve:`2021-25291`: In ``TiffDecode.c``, invalid tile boundaries could lead to an out-of-bounds read in ``TIFFReadRGBATile``
+^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
 
-.. note:: More information about this vulnerability included in database record :cve:`2021-25293`
+:cve:`2021-25292`: The PDF parser has a catastrophic backtracking regex that could be used as a DOS attack
+^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
 
-There is an out-of-bounds read in ``SgiRleDecode.c`` since Pillow 4.3.0.
+:cve:`2021-25293`: There is an out-of-bounds read in ``SgiRleDecode.c`` since Pillow 4.3.0
+^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
 
 Other Changes
 =============
diff --git a/docs/releasenotes/8.1.2.rst b/docs/releasenotes/8.1.2.rst
index af60a862e93..7d4a6c0be04 100644
--- a/docs/releasenotes/8.1.2.rst
+++ b/docs/releasenotes/8.1.2.rst
@@ -4,27 +4,21 @@
 Security
 ========
 
-Fix CVE-2021-27921
-^^^^^^^^^^^^^^^^^^
-
-.. note:: More information about this vulnerability included in database record :cve:`2021-27921`
+:cve:`2021-27921`: There is an exhaustion of memory DOS in BLP images
+^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
 
 There is an exhaustion of memory DOS in BLP images. where Pillow did not properly check the
 reported size of the contained image. These images could cause arbitrarily large memory
 allocations.
 
-Fix CVE-2021-27922
-^^^^^^^^^^^^^^^^^^
-
-.. note:: More information about this vulnerability included in database record :cve:`2021-27921`
+:cve:`2021-27921`: There is an exhaustion of memory DOS in ICNS images 
+^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
 
 There is an exhaustion of memory DOS in ICNS images where Pillow did not properly check the
 reported size of the contained image. These images could cause arbitrarily large memory allocations.
 
-Fix CVE-2021-27923
-^^^^^^^^^^^^^^^^^^
-
-.. note:: More information about this vulnerability included in database record :cve:`2021-27923`
+:cve:`2021-27923`: There is an exhaustion of memory DOS in ICO images 
+^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
 
 There is an exhaustion of memory DOS in ICO images where Pillow did not properly check the reported
 size of the contained image. These images could cause arbitrarily large memory allocations.
diff --git a/docs/releasenotes/8.2.0.rst b/docs/releasenotes/8.2.0.rst
index adbabce3a45..6e8fd5cdebe 100644
--- a/docs/releasenotes/8.2.0.rst
+++ b/docs/releasenotes/8.2.0.rst
@@ -4,25 +4,17 @@
 Security
 ========
 
-These were all found with `OSS-Fuzz`_.
+These issues were all found with `OSS-Fuzz`_.
 
-Fix CVE-2021-25287, CVE-2021-25288, CVE-2021-28675
-^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
-
-.. note:: More information about these vulnerabilities included in database records
-    :cve:`2021-25287`, :cve:`2021-25288`, :cve:`2021-28675`
-
-OOB read in Jpeg2KDecode
-~~~~~~~~~~~~~~~~~~~~~~~~
+:cve:`2021-25287`, :cve:`2021-25288`, :cve:`2021-28675`: OOB read in Jpeg2KDecode
+^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
 
 * For J2k images with multiple bands, it's legal to have different widths for each band,
   e.g. 1 byte for ``L``, 4 bytes for ``A``.
 * This dates to Pillow 2.4.0.
 
-Fix CVE-2021-28675 -- DOS attack in PsdImagePlugin
-^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
-
-.. note:: More information about this vulnerability included in database record :cve:`2021-28675`
+:cve:`2021-28675`: DOS attack in PsdImagePlugin
+^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
 
 * :py:class:`.PsdImagePlugin.PsdImageFile` did not sanity check the number of input
   layers with regard to the size of the data block, this could lead to a
@@ -30,19 +22,15 @@ Fix CVE-2021-28675 -- DOS attack in PsdImagePlugin
   :py:meth:`~PIL.Image.Image.load`.
 * This dates to the PIL fork.
 
-Fix CVE-2021-28676 -- FLI image DOS attack
-^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
-
-.. note:: More information about this vulnerability included in database record :cve:`2021-28676`
+:cve:`2021-28676`: FLI image DOS attack
+^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
 
 * ``FliDecode.c`` did not properly check that the block advance was non-zero,
   potentially leading to an infinite loop on load.
 * This dates to the PIL fork.
 
-Fix CVE-2021-28677 -- EPS DOS on _open
-^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
-
-.. note:: More information about this vulnerability included in database record :cve:`2021-28677`
+:cve:`2021-28677`: EPS DOS on _open
+^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
 
 * The readline used in EPS has to deal with any combination of ``\r`` and ``\n`` as line
   endings. It accidentally used a quadratic method of accumulating lines while looking
@@ -51,10 +39,8 @@ Fix CVE-2021-28677 -- EPS DOS on _open
   open phase, before an image was accepted for opening.
 * This dates to the PIL fork.
 
-CVE-2021-28678 -- BLP DOS attack
-^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
-
-.. note:: More information about this vulnerability included in database record :cve:`2021-28678`
+:cve:`2021-28678`: BLP DOS attack
+^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
 
 * ``BlpImagePlugin`` did not properly check that reads after jumping to file offsets
   returned data. This could lead to a denial-of-service where the decoder could be run a
diff --git a/docs/releasenotes/8.3.0.rst b/docs/releasenotes/8.3.0.rst
index 94ad37bb1b9..3ef9bb9b334 100644
--- a/docs/releasenotes/8.3.0.rst
+++ b/docs/releasenotes/8.3.0.rst
@@ -4,16 +4,8 @@
 Security
 ========
 
-Buffer overflow
-^^^^^^^^^^^^^^^
-
-Fix CVE-2021-34552
-^^^^^^^^^^^^^^^^^^
-
-.. note:: More information about this vulnerability included in database record :cve:`2021-34552`
-
-Buffer overflow
-~~~~~~~~~~~~~~~
+:cve:`2021-34552`: Buffer overflow
+^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
 
 PIL since 1.1.4 and Pillow since 1.0 allowed parameters passed into a convert function to trigger
 buffer overflow in Convert.c.
diff --git a/docs/releasenotes/8.3.2.rst b/docs/releasenotes/8.3.2.rst
index 6796365641c..34ba703f70a 100644
--- a/docs/releasenotes/8.3.2.rst
+++ b/docs/releasenotes/8.3.2.rst
@@ -4,13 +4,8 @@
 Security
 ========
 
-Fix CVE-2021-23437
-^^^^^^^^^^^^^^^^^^
-
-.. note:: More information about this vulnerability included in database record :cve:`2021-23437`
-
-Avoid potential ReDoS (regular expression denial of service)
-~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
+:cve:`2021-23437`: Avoid potential ReDoS (regular expression denial of service)
+^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
 
 Avoid a potential ReDoS (regular expression denial of service) in :py:class:`~PIL.ImageColor`'s
 :py:meth:`~PIL.ImageColor.getrgb` by raising :py:exc:`ValueError` if the color specifier is
diff --git a/docs/releasenotes/9.0.0.rst b/docs/releasenotes/9.0.0.rst
index 534209117a5..b22912baf17 100644
--- a/docs/releasenotes/9.0.0.rst
+++ b/docs/releasenotes/9.0.0.rst
@@ -56,10 +56,8 @@ will now restrict the builtins available to :py:meth:`PIL.ImageMath.eval`. This
 help prevent problems arising if users evaluate arbitrary expressions, such as
 ``ImageMath.eval("exec(exit())")``.
 
-Fix CVE-2022-22817 -- ImagePath.Path array handling
-^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
-
-.. note:: More information about this vulnerability included in database record :cve:`2022-22815`
+:cve:`2022-22815`: ImagePath.Path array handling
+^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
 
 (:cwe:`126`) and :cve:`2022-22816` (:cwe:`665`) were found when initializing ``ImagePath.Path``.
 
diff --git a/docs/releasenotes/9.0.1.rst b/docs/releasenotes/9.0.1.rst
index ab6c6cbdde3..a25e3f5ac66 100644
--- a/docs/releasenotes/9.0.1.rst
+++ b/docs/releasenotes/9.0.1.rst
@@ -6,30 +6,20 @@ Security
 
 This release addresses several security problems.
 
-Fix CVE-2022-24303
-^^^^^^^^^^^^^^^^^^
-
-.. note:: More information about this vulnerability included in database record :cve:`2022-24303`
-
-Temp image removal
-~~~~~~~~~~~~~~~~~~
+:cve:`2022-24303`: Temp image removal
+^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
 
 If the path to the temporary directory on Linux or macOS
 contained a space, this would break removal of the temporary image file after
 ``im.show()`` (and related actions), and potentially remove an unrelated file. This
 has been present since PIL.
 
-Fix CVE-2022-24303
-^^^^^^^^^^^^^^^^^^
-
-.. note:: More information about this vulnerability included in database record :cve:`2022-22817`
-
-Restrict lambda expressions
-~~~~~~~~~~~~~~~~~~~~~~~~~~~
+:cve:`2022-22817`: Restrict lambda expressions
+^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
 
 While Pillow 9.0 restricted top-level builtins available to
-:py:meth:`PIL.ImageMath.eval`, it did not prevent builtins available to lambda
-expressions. These are now also restricted.
+:py:meth:`PIL.ImageMath.eval`, it did not prevent builtins
+available to lambda expressions. These are now also restricted.
 
 Other Changes
 =============
diff --git a/docs/releasenotes/9.1.1.rst b/docs/releasenotes/9.1.1.rst
index f8f1a802ba0..d538e88c0f9 100644
--- a/docs/releasenotes/9.1.1.rst
+++ b/docs/releasenotes/9.1.1.rst
@@ -4,15 +4,10 @@
 Security
 ========
 
-This release addresses several security problems.
+This release addresses several security issues.
 
-Fix CVE-2022-30595
-^^^^^^^^^^^^^^^^^^
-
-.. note:: More information about this vulnerability included in database record :cve:`2022-30595`
-
-Heap buffer overflow
-~~~~~~~~~~~~~~~~~~~~
+:cve:`2022-30595`: Heap buffer overflow
+^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
 
 When reading a TGA file with RLE packets that cross scan lines,
 Pillow reads the information past the end of the first line without deducting that
diff --git a/docs/releasenotes/index.rst b/docs/releasenotes/index.rst
index e1ebd650966..17a95c6f62a 100644
--- a/docs/releasenotes/index.rst
+++ b/docs/releasenotes/index.rst
@@ -69,5 +69,7 @@ expected to be backported to earlier versions.
   3.0.0
   2.8.0
   2.7.0
+  2.5.2
+  2.3.2
   2.3.1
   versioning
diff --git a/docs/releasenotes/template.rst b/docs/releasenotes/template.rst
index 65671808185..cfc7221a3cc 100644
--- a/docs/releasenotes/template.rst
+++ b/docs/releasenotes/template.rst
@@ -9,13 +9,8 @@ TODO
 
 TODO
 
-Fix CVE-YYYY-XXXXX
-^^^^^^^^^^^^^^^^^^
-
-.. note:: More information about this vulnerability included in database record :cve:`YYYY-XXXXX`
-
-TODO
-~~~~
+:cve:`YYYY-XXXXX`: TODO
+^^^^^^^^^^^^^^^^^^^^^^^
 
 TODO
 

From 3aefe92bdf58b93a8a45adc7b9d58fb4712adb1a Mon Sep 17 00:00:00 2001
From: "pre-commit-ci[bot]"
 <66853113+pre-commit-ci[bot]@users.noreply.github.com>
Date: Thu, 14 Mar 2024 18:01:09 +0000
Subject: [PATCH 0329/1178] [pre-commit.ci] auto fixes from pre-commit.com
 hooks

for more information, see https://pre-commit.ci
---
 docs/releasenotes/2.3.1.rst | 2 +-
 docs/releasenotes/2.3.2.rst | 2 +-
 docs/releasenotes/2.5.2.rst | 2 +-
 docs/releasenotes/6.2.2.rst | 2 +-
 docs/releasenotes/7.1.0.rst | 6 +++---
 docs/releasenotes/8.1.2.rst | 4 ++--
 6 files changed, 9 insertions(+), 9 deletions(-)

diff --git a/docs/releasenotes/2.3.1.rst b/docs/releasenotes/2.3.1.rst
index 2c7c8285a3e..4b58d037036 100644
--- a/docs/releasenotes/2.3.1.rst
+++ b/docs/releasenotes/2.3.1.rst
@@ -14,4 +14,4 @@ The (1) load_djpeg function in JpegImagePlugin.py, (2) Ghostscript function in E
 :cve:`2014-1933`: Fix insecure use of :py:func:`tempfile.mktemp`
 ^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
 
-The (1) JpegImagePlugin.py and (2) EpsImagePlugin.py scripts in Python Image Library (PIL) 1.1.7 and earlier and Pillow before 2.3.1 uses the names of temporary files on the command line, which makes it easier for local users to conduct symlink attacks by listing the processes. 
+The (1) JpegImagePlugin.py and (2) EpsImagePlugin.py scripts in Python Image Library (PIL) 1.1.7 and earlier and Pillow before 2.3.1 uses the names of temporary files on the command line, which makes it easier for local users to conduct symlink attacks by listing the processes.
diff --git a/docs/releasenotes/2.3.2.rst b/docs/releasenotes/2.3.2.rst
index a8ed32718aa..646f7d43b03 100644
--- a/docs/releasenotes/2.3.2.rst
+++ b/docs/releasenotes/2.3.2.rst
@@ -9,4 +9,4 @@ Security
 
 ``PIL/IcnsImagePlugin.py`` in Python Imaging Library (PIL) and Pillow before 2.3.2 and
 2.5.x before 2.5.2 allows remote attackers to cause a denial of service via a crafted
-block size. 
+block size.
diff --git a/docs/releasenotes/2.5.2.rst b/docs/releasenotes/2.5.2.rst
index 77365ef3e6e..7b360051e1b 100644
--- a/docs/releasenotes/2.5.2.rst
+++ b/docs/releasenotes/2.5.2.rst
@@ -9,4 +9,4 @@ Security
 
 ``PIL/IcnsImagePlugin.py`` in Python Imaging Library (PIL) and Pillow before 2.3.2 and
 2.5.x before 2.5.2 allows remote attackers to cause a denial of service via a crafted
-block size. 
+block size.
diff --git a/docs/releasenotes/6.2.2.rst b/docs/releasenotes/6.2.2.rst
index a95ab1cce6e..941bda3a84f 100644
--- a/docs/releasenotes/6.2.2.rst
+++ b/docs/releasenotes/6.2.2.rst
@@ -4,7 +4,7 @@
 Security
 ========
 
-This release fixes several buffer overruns and DOS attacks. 
+This release fixes several buffer overruns and DOS attacks.
 
 :cve:`2019-19911`: DOS attack vulnerability
 ^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
diff --git a/docs/releasenotes/7.1.0.rst b/docs/releasenotes/7.1.0.rst
index e5e8b6a5af6..4c1f41a693a 100644
--- a/docs/releasenotes/7.1.0.rst
+++ b/docs/releasenotes/7.1.0.rst
@@ -14,7 +14,7 @@ Pillow before 7.1.0 has multiple out-of-bounds reads in ``libImaging/FliDecode.c
 :cve:`2020-10378`: Bounds overflow in PCX decoding
 ^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
 
-In ``libImaging/PcxDecode.c`` in Pillow before 7.1.0, an out-of-bounds read can occur when reading PCX files where state->shuffle is instructed to read beyond state->buffer. 
+In ``libImaging/PcxDecode.c`` in Pillow before 7.1.0, an out-of-bounds read can occur when reading PCX files where state->shuffle is instructed to read beyond state->buffer.
 
 :cve:`2020-10379`: Two buffer overflows in TIFF decoding
 ^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
@@ -24,12 +24,12 @@ In Pillow before 7.1.0, there are two buffer overflows in ``libImaging/TiffDecod
 :cve:`2020-10994`: Bounds overflow in JPEG 2000 decoding
 ^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
 
-In ``libImaging/Jpeg2KDecode.c`` in Pillow before 7.1.0, there are multiple out-of-bounds reads via a crafted JP2 file. 
+In ``libImaging/Jpeg2KDecode.c`` in Pillow before 7.1.0, there are multiple out-of-bounds reads via a crafted JP2 file.
 
 :cve:`2020-11538`: Buffer overflow in SGI-RLE decoding
 ^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
 
-In ``libImaging/SgiRleDecode.c`` in Pillow through 7.0.0, a number of out-of-bounds reads exist in the parsing of SGI image files, a different issue than CVE-2020-5311. 
+In ``libImaging/SgiRleDecode.c`` in Pillow through 7.0.0, a number of out-of-bounds reads exist in the parsing of SGI image files, a different issue than CVE-2020-5311.
 
 API Changes
 ===========
diff --git a/docs/releasenotes/8.1.2.rst b/docs/releasenotes/8.1.2.rst
index 7d4a6c0be04..986015e3edd 100644
--- a/docs/releasenotes/8.1.2.rst
+++ b/docs/releasenotes/8.1.2.rst
@@ -11,13 +11,13 @@ There is an exhaustion of memory DOS in BLP images. where Pillow did not properl
 reported size of the contained image. These images could cause arbitrarily large memory
 allocations.
 
-:cve:`2021-27921`: There is an exhaustion of memory DOS in ICNS images 
+:cve:`2021-27921`: There is an exhaustion of memory DOS in ICNS images
 ^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
 
 There is an exhaustion of memory DOS in ICNS images where Pillow did not properly check the
 reported size of the contained image. These images could cause arbitrarily large memory allocations.
 
-:cve:`2021-27923`: There is an exhaustion of memory DOS in ICO images 
+:cve:`2021-27923`: There is an exhaustion of memory DOS in ICO images
 ^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
 
 There is an exhaustion of memory DOS in ICO images where Pillow did not properly check the reported

From 7b1c39cebe9700f92622438f1d834eeed69d9d68 Mon Sep 17 00:00:00 2001
From: "Jeffrey A. Clark" <aclark@aclark.net>
Date: Thu, 14 Mar 2024 16:44:00 -0400
Subject: [PATCH 0330/1178] Update docs/releasenotes/9.0.0.rst

Co-authored-by: Hugo van Kemenade <1324225+hugovk@users.noreply.github.com>
---
 docs/releasenotes/9.0.0.rst | 9 ++-------
 1 file changed, 2 insertions(+), 7 deletions(-)

diff --git a/docs/releasenotes/9.0.0.rst b/docs/releasenotes/9.0.0.rst
index b22912baf17..1c940904f55 100644
--- a/docs/releasenotes/9.0.0.rst
+++ b/docs/releasenotes/9.0.0.rst
@@ -43,13 +43,8 @@ To prevent attempts to slow down loading times for images, if an image has conse
 duplicate tiles that only differ by their offset, only load the last tile. Credit to
 Google's `OSS-Fuzz`_ project for finding this issue.
 
-Fix CVE-2022-22817
-^^^^^^^^^^^^^^^^^^
-
-.. note:: More information about this vulnerability included in database record :cve:`2022-22817`
-
-Restrict builtins available to ImageMath.eval
-~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
+:cve:`2022-22817`: Restrict builtins available to ImageMath.eval
+~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
 
 To limit :py:class:`PIL.ImageMath` to working with images, Pillow
 will now restrict the builtins available to :py:meth:`PIL.ImageMath.eval`. This will

From 4d81ec804a8c95b7fdc01ac62dda8febb5101d56 Mon Sep 17 00:00:00 2001
From: "Jeffrey A. Clark" <aclark@aclark.net>
Date: Thu, 14 Mar 2024 16:44:11 -0400
Subject: [PATCH 0331/1178] Update docs/releasenotes/8.2.0.rst

Co-authored-by: Hugo van Kemenade <1324225+hugovk@users.noreply.github.com>
---
 docs/releasenotes/8.2.0.rst | 4 ++--
 1 file changed, 2 insertions(+), 2 deletions(-)

diff --git a/docs/releasenotes/8.2.0.rst b/docs/releasenotes/8.2.0.rst
index 6e8fd5cdebe..50fe9aa1988 100644
--- a/docs/releasenotes/8.2.0.rst
+++ b/docs/releasenotes/8.2.0.rst
@@ -6,8 +6,8 @@ Security
 
 These issues were all found with `OSS-Fuzz`_.
 
-:cve:`2021-25287`, :cve:`2021-25288`, :cve:`2021-28675`: OOB read in Jpeg2KDecode
-^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
+:cve:`2021-25287`, :cve:`2021-25288`: OOB read in Jpeg2KDecode
+^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
 
 * For J2k images with multiple bands, it's legal to have different widths for each band,
   e.g. 1 byte for ``L``, 4 bytes for ``A``.

From bae0c988e6a7efd6417af41ad9eff04d66e1a5d4 Mon Sep 17 00:00:00 2001
From: "Jeffrey A. Clark" <aclark@aclark.net>
Date: Thu, 14 Mar 2024 16:44:23 -0400
Subject: [PATCH 0332/1178] Update docs/releasenotes/8.1.2.rst

Co-authored-by: Hugo van Kemenade <1324225+hugovk@users.noreply.github.com>
---
 docs/releasenotes/8.1.2.rst | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/docs/releasenotes/8.1.2.rst b/docs/releasenotes/8.1.2.rst
index 986015e3edd..e043bc191d2 100644
--- a/docs/releasenotes/8.1.2.rst
+++ b/docs/releasenotes/8.1.2.rst
@@ -11,7 +11,7 @@ There is an exhaustion of memory DOS in BLP images. where Pillow did not properl
 reported size of the contained image. These images could cause arbitrarily large memory
 allocations.
 
-:cve:`2021-27921`: There is an exhaustion of memory DOS in ICNS images
+:cve:`2021-27922`: There is an exhaustion of memory DOS in ICNS images
 ^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
 
 There is an exhaustion of memory DOS in ICNS images where Pillow did not properly check the

From e97722b7ce30c72c7c26f20d914919aebd218f8f Mon Sep 17 00:00:00 2001
From: "Jeffrey A. Clark" <aclark@aclark.net>
Date: Thu, 14 Mar 2024 16:46:04 -0400
Subject: [PATCH 0333/1178] Update docs/releasenotes/6.2.0.rst

Co-authored-by: Hugo van Kemenade <1324225+hugovk@users.noreply.github.com>
---
 docs/releasenotes/6.2.0.rst | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/docs/releasenotes/6.2.0.rst b/docs/releasenotes/6.2.0.rst
index 9c504da0f41..fe0148060a6 100644
--- a/docs/releasenotes/6.2.0.rst
+++ b/docs/releasenotes/6.2.0.rst
@@ -4,7 +4,7 @@
 Security
 ========
 
-This release catches several buffer overruns and fixes CVE-2019-16865.
+This release catches several buffer overruns and fixes :cve:`2019-16865`.
 
 Buffer overruns
 ^^^^^^^^^^^^^^^

From 7b485c769c82a639b5ea22ead0778515d7734532 Mon Sep 17 00:00:00 2001
From: "Jeffrey A. Clark" <aclark@aclark.net>
Date: Thu, 14 Mar 2024 16:46:15 -0400
Subject: [PATCH 0334/1178] Update docs/releasenotes/6.2.0.rst

Co-authored-by: Hugo van Kemenade <1324225+hugovk@users.noreply.github.com>
---
 docs/releasenotes/6.2.0.rst | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/docs/releasenotes/6.2.0.rst b/docs/releasenotes/6.2.0.rst
index fe0148060a6..c34ba802d3b 100644
--- a/docs/releasenotes/6.2.0.rst
+++ b/docs/releasenotes/6.2.0.rst
@@ -9,7 +9,7 @@ This release catches several buffer overruns and fixes :cve:`2019-16865`.
 Buffer overruns
 ^^^^^^^^^^^^^^^
 
-In RawDecode.c, an error is now thrown if skip is calculated to be less than
+In ``RawDecode.c``, an error is now thrown if skip is calculated to be less than
 zero. It is intended to skip padding between lines, not to go backwards.
 
 In PsdImagePlugin, if the combined sizes of the individual parts is larger than

From 69a4e0d4c914da09c9a9137ea0a27d606bf13658 Mon Sep 17 00:00:00 2001
From: "Jeffrey A. Clark" <aclark@aclark.net>
Date: Thu, 14 Mar 2024 16:49:42 -0400
Subject: [PATCH 0335/1178] Update docs/releasenotes/6.2.0.rst

Co-authored-by: Hugo van Kemenade <1324225+hugovk@users.noreply.github.com>
---
 docs/releasenotes/6.2.0.rst | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/docs/releasenotes/6.2.0.rst b/docs/releasenotes/6.2.0.rst
index c34ba802d3b..c241a3a3b83 100644
--- a/docs/releasenotes/6.2.0.rst
+++ b/docs/releasenotes/6.2.0.rst
@@ -12,7 +12,7 @@ Buffer overruns
 In ``RawDecode.c``, an error is now thrown if skip is calculated to be less than
 zero. It is intended to skip padding between lines, not to go backwards.
 
-In PsdImagePlugin, if the combined sizes of the individual parts is larger than
+In ``PsdImagePlugin``, if the combined sizes of the individual parts is larger than
 the declared size of the extra data field, then it looked for the next layer by
 seeking backwards. This is now corrected by seeking to (the start of the layer
 + the size of the extra data field) instead of (the read parts of the layer +

From 15deb71c3a983e8e43476a543ce55ff3c4ff10ac Mon Sep 17 00:00:00 2001
From: Alex Clark <aclark@aclark.net>
Date: Thu, 14 Mar 2024 17:03:09 -0400
Subject: [PATCH 0336/1178] 80 char wrap + file name tick for #7864

---
 docs/releasenotes/2.3.1.rst | 15 ++++++++++++---
 1 file changed, 12 insertions(+), 3 deletions(-)

diff --git a/docs/releasenotes/2.3.1.rst b/docs/releasenotes/2.3.1.rst
index 4b58d037036..6446ebccbff 100644
--- a/docs/releasenotes/2.3.1.rst
+++ b/docs/releasenotes/2.3.1.rst
@@ -4,14 +4,23 @@
 Security
 ========
 
-These issues reported in `Debian bug #737059 <https://bugs.debian.org/cgi-bin/bugreport.cgi?bug=737059>`_.
+These issues reported in
+`Debian bug #737059 <https://bugs.debian.org/cgi-bin/bugreport.cgi?bug=737059>`_.
 
 :cve:`2014-1932`: Fix insecure use of :py:func:`tempfile.mktemp`
 ^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
 
-The (1) load_djpeg function in JpegImagePlugin.py, (2) Ghostscript function in EpsImagePlugin.py, (3) load function in IptcImagePlugin.py, and (4) _copy function in Image.py in Python Image Library (PIL) 1.1.7 and earlier and Pillow before 2.3.1 do not properly create temporary files, which allow local users to overwrite arbitrary files and obtain sensitive information via a symlink attack on the temporary file.
+The (1) load_djpeg function in ``JpegImagePlugin.py``, (2) Ghostscript function
+in EpsImagePlugin.py, (3) load function in ``IptcImagePlugin.py``, and (4) _copy
+function in Image.py in Python Image Library (PIL) 1.1.7 and earlier and
+Pillow before 2.3.1 do not properly create temporary files, which allow local
+users to overwrite arbitrary files and obtain sensitive information via a
+symlink attack on the temporary file.
 
 :cve:`2014-1933`: Fix insecure use of :py:func:`tempfile.mktemp`
 ^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
 
-The (1) JpegImagePlugin.py and (2) EpsImagePlugin.py scripts in Python Image Library (PIL) 1.1.7 and earlier and Pillow before 2.3.1 uses the names of temporary files on the command line, which makes it easier for local users to conduct symlink attacks by listing the processes.
+The (1) ``JpegImagePlugin.py`` and (2) ``EpsImagePlugin.py`` scripts in Python
+Image Library (PIL) 1.1.7 and earlier and Pillow before 2.3.1 uses the names of
+temporary files on the command line, which makes it easier for local users to
+conduct symlink attacks by listing the processes.

From ad134c63fa7afff28b0e0e55f291919c02a34b28 Mon Sep 17 00:00:00 2001
From: Alex Clark <aclark@aclark.net>
Date: Thu, 14 Mar 2024 17:37:01 -0400
Subject: [PATCH 0337/1178] Combine CVEs

---
 docs/releasenotes/8.1.2.rst | 24 ++++++------------------
 1 file changed, 6 insertions(+), 18 deletions(-)

diff --git a/docs/releasenotes/8.1.2.rst b/docs/releasenotes/8.1.2.rst
index e043bc191d2..de6ba605e6b 100644
--- a/docs/releasenotes/8.1.2.rst
+++ b/docs/releasenotes/8.1.2.rst
@@ -4,24 +4,12 @@
 Security
 ========
 
-:cve:`2021-27921`: There is an exhaustion of memory DOS in BLP images
-^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
+:cve:`2021-27921`, :cve:`2021-27922`, :cve:`2021-27923`: Fix DOS attacks
+^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
 
-There is an exhaustion of memory DOS in BLP images. where Pillow did not properly check the
-reported size of the contained image. These images could cause arbitrarily large memory
-allocations.
+There is an exhaustion of memory DOS attack in BLP, ICNS, ICO images
+where Pillow did not properly check the reported size of the contained image.
+These images could cause arbitrarily large memory allocations.
 
-:cve:`2021-27922`: There is an exhaustion of memory DOS in ICNS images
-^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
-
-There is an exhaustion of memory DOS in ICNS images where Pillow did not properly check the
-reported size of the contained image. These images could cause arbitrarily large memory allocations.
-
-:cve:`2021-27923`: There is an exhaustion of memory DOS in ICO images
-^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
-
-There is an exhaustion of memory DOS in ICO images where Pillow did not properly check the reported
-size of the contained image. These images could cause arbitrarily large memory allocations.
-
-These were reported by Jiayi Lin, Luke Shaffer, Xinran Xie and
+These issues were reported by Jiayi Lin, Luke Shaffer, Xinran Xie and
 Akshay Ajayan of `Arizona State University <https://www.asu.edu/>`_.

From ae5f1de624a38894eeb703e37b5800ce8327d3a9 Mon Sep 17 00:00:00 2001
From: Alex Clark <aclark@aclark.net>
Date: Thu, 14 Mar 2024 19:04:26 -0400
Subject: [PATCH 0338/1178] Back fill release notes for #7864

- Back fill release notes for 3.1.1
- Add credits to 2.3.2, 2.5.2
---
 docs/releasenotes/2.3.2.rst |  2 +
 docs/releasenotes/2.5.2.rst |  2 +
 docs/releasenotes/3.1.1.rst | 82 +++----------------------------------
 3 files changed, 9 insertions(+), 77 deletions(-)

diff --git a/docs/releasenotes/2.3.2.rst b/docs/releasenotes/2.3.2.rst
index 646f7d43b03..56398a97414 100644
--- a/docs/releasenotes/2.3.2.rst
+++ b/docs/releasenotes/2.3.2.rst
@@ -10,3 +10,5 @@ Security
 ``PIL/IcnsImagePlugin.py`` in Python Imaging Library (PIL) and Pillow before 2.3.2 and
 2.5.x before 2.5.2 allows remote attackers to cause a denial of service via a crafted
 block size.
+
+Found and reported by Andrew Drake of dropbox.com
diff --git a/docs/releasenotes/2.5.2.rst b/docs/releasenotes/2.5.2.rst
index 7b360051e1b..4884f8db8c4 100644
--- a/docs/releasenotes/2.5.2.rst
+++ b/docs/releasenotes/2.5.2.rst
@@ -10,3 +10,5 @@ Security
 ``PIL/IcnsImagePlugin.py`` in Python Imaging Library (PIL) and Pillow before 2.3.2 and
 2.5.x before 2.5.2 allows remote attackers to cause a denial of service via a crafted
 block size.
+
+Found and reported by Andrew Drake of dropbox.com
diff --git a/docs/releasenotes/3.1.1.rst b/docs/releasenotes/3.1.1.rst
index 6e03382b29f..8b7780e7e35 100644
--- a/docs/releasenotes/3.1.1.rst
+++ b/docs/releasenotes/3.1.1.rst
@@ -4,81 +4,9 @@
 Security
 ========
 
-:cve:`2016-0740`: Buffer overflow in TiffDecode.c
-^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
+:cve:`2016-0775`: Fix buffer overflow
+^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
 
-Pillow 3.1.0 and earlier when linked against
-libtiff >= 4.0.0 on x64 may overflow a buffer when reading a
-specially crafted tiff file.
-
-Specifically, libtiff >= 4.0.0 changed the return type of
-``TIFFScanlineSize`` from ``int32`` to machine dependent
-``int32|64``. If the scanline is sized so that it overflows an
-``int32``, it may be interpreted as a negative number, which will then
-pass the size check in ``TiffDecode.c`` line 236. To do this, the
-logical scanline size has to be > 2gb, and for the test file, the
-allocated buffer size is 64k against a roughly 4gb scan line size. Any
-image data over 64k is written over the heap, causing a segfault.
-
-This issue was found by security researcher FourOne.
-
-:cve:`2016-0775`: Buffer overflow in FliDecode.c
-^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
-
-In all versions of Pillow, dating back at least to the last PIL 1.1.7
-release, FliDecode.c has a buffer overflow error.
-
-Around line 192:
-
-.. code-block:: c
-
-  case 16:
-      /* COPY chunk */
-      for (y = 0; y < state->ysize; y++) {
-          UINT8* buf = (UINT8*) im->image[y];
-          memcpy(buf+x, data, state->xsize);
-          data += state->xsize;
-      }
-      break;
-
-
-The memcpy has error where ``x`` is added to the target buffer
-address. ``X`` is used in several internal temporary variable roles,
-but can take a value up to the width of the image.  ``Im->image[y]``
-is a set of row pointers to segments of memory that are the size of
-the row.  At the max ``y``, this will write the contents of the line
-off the end of the memory buffer, causing a segfault.
-
-This issue was found by Alyssa Besseling at Atlassian.
-
-:cve:`2016-2533`: Buffer overflow in PcdDecode.c
-^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
-
-In all versions of Pillow, dating back at least to the
-last PIL 1.1.7 release, ``PcdDecode.c`` has a buffer overflow error.
-
-The ``state.buffer`` for ``PcdDecode.c`` is allocated based on a 3
-bytes per pixel sizing, where ``PcdDecode.c`` wrote into the buffer
-assuming 4 bytes per pixel. This writes 768 bytes beyond the end of
-the buffer into other Python object storage. In some cases, this
-causes a segfault, in others an internal Python malloc error.
-
-Integer overflow in Resample.c
-^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
-
-If a large value was passed into the new size for an image, it is
-possible to overflow an ``int32`` value passed into malloc.
-
-.. code-block:: c
-
-    kk = malloc(xsize * kmax * sizeof(float));
-    ...
-    xbounds = malloc(xsize * 2 * sizeof(int));
-
-``xsize`` is trusted user input. These multiplications can overflow,
-leading the ``malloc``'d buffer to be undersized. These allocations are
-followed by a loop that writes out of bounds. This can lead to
-corruption on the heap of the Python process with attacker controlled
-float data.
-
-This issue was found by Ned Williamson.
+Buffer overflow in the ImagingFliDecode function in ``libImaging/FliDecode.c``
+in Pillow before 3.1.1 allows remote attackers to cause a denial of service
+(crash) via a crafted FLI file.

From 0ea144b0875794085a66894b4422aa406c6ef813 Mon Sep 17 00:00:00 2001
From: Alex Clark <aclark@aclark.net>
Date: Thu, 14 Mar 2024 19:36:19 -0400
Subject: [PATCH 0339/1178] Update 3.1.1, 8.1.1 release notes for #7864

---
 docs/releasenotes/3.1.1.rst | 11 +++++++++--
 docs/releasenotes/8.1.1.rst | 33 ++++++++++++++++++++++-----------
 2 files changed, 31 insertions(+), 13 deletions(-)

diff --git a/docs/releasenotes/3.1.1.rst b/docs/releasenotes/3.1.1.rst
index 8b7780e7e35..fc9029ce41d 100644
--- a/docs/releasenotes/3.1.1.rst
+++ b/docs/releasenotes/3.1.1.rst
@@ -4,8 +4,15 @@
 Security
 ========
 
-:cve:`2016-0775`: Fix buffer overflow
-^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
+:cve:`2016-0740`: Fix buffer overflow in ``libImaging/TiffDecode.c``
+^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
+
+Buffer overflow in the ImagingLibTiffDecode function in
+``libImaging/TiffDecode.c`` in Pillow before 3.1.1 allows remote attackers to
+overwrite memory via a crafted TIFF file.
+
+:cve:`2016-0775`: Fix buffer overflow in ``libImaging/FliDecode.c``
+^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
 
 Buffer overflow in the ImagingFliDecode function in ``libImaging/FliDecode.c``
 in Pillow before 3.1.1 allows remote attackers to cause a denial of service
diff --git a/docs/releasenotes/8.1.1.rst b/docs/releasenotes/8.1.1.rst
index 84e9c8f86e0..484b1de36cb 100644
--- a/docs/releasenotes/8.1.1.rst
+++ b/docs/releasenotes/8.1.1.rst
@@ -4,22 +4,33 @@
 Security
 ========
 
-:cve:`2021-25289`: The previous fix for :cve:`2020-35654` was insufficient
-^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
+:cve:`2021-25289`: Fix the fix for :cve:`2020-35654`
+^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
 
-The previous fix for :cve:`2020-35654` was insufficient due to incorrect error checking in ``TiffDecode.c``.
+The previous fix for :cve:`2020-35654` was insufficient due to incorrect
+error checking in ``TiffDecode.c``.
 
-:cve:`2021-25290`: In ``TiffDecode.c``, there is a negative-offset ``memcpy`` with an invalid size
-^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
+:cve:`2021-25290`: Fix buffer overflow in ``TiffDecode.c``
+^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
 
-:cve:`2021-25291`: In ``TiffDecode.c``, invalid tile boundaries could lead to an out-of-bounds read in ``TIFFReadRGBATile``
-^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
+In ``TiffDecode.c``, there is a negative-offset ``memcpy`` with an invalid size.
 
-:cve:`2021-25292`: The PDF parser has a catastrophic backtracking regex that could be used as a DOS attack
-^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
+:cve:`2021-25291`: Fix buffer overflow in ``TIFFReadRGBATile``
+^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
 
-:cve:`2021-25293`: There is an out-of-bounds read in ``SgiRleDecode.c`` since Pillow 4.3.0
-^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
+In ``TiffDecode.c``, invalid tile boundaries could lead to an out-of-bounds
+read in ``TIFFReadRGBATile``.
+
+:cve:`2021-25292`: Fix DOS attack
+^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
+
+The PDF parser has a catastrophic backtracking regex that could be used as a
+DOS attack.
+
+:cve:`2021-25293`: Fix buffer overflow in ``SgiRleDecode.c``
+^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
+
+There is an out-of-bounds read in ``SgiRleDecode.c`` since Pillow 4.3.0.
 
 Other Changes
 =============

From f316fd9c7aa312452550efab4eec2d9ce1ebcf13 Mon Sep 17 00:00:00 2001
From: Alex Clark <aclark@aclark.net>
Date: Thu, 14 Mar 2024 19:45:05 -0400
Subject: [PATCH 0340/1178] Restore and update 3.1.1 release notes for #7864

- Restore accidentally overwritten contents
- Update to match updated template
---
 docs/releasenotes/3.1.1.rst | 85 ++++++++++++++++++++++++++++++++-----
 1 file changed, 75 insertions(+), 10 deletions(-)

diff --git a/docs/releasenotes/3.1.1.rst b/docs/releasenotes/3.1.1.rst
index fc9029ce41d..f5fbd871175 100644
--- a/docs/releasenotes/3.1.1.rst
+++ b/docs/releasenotes/3.1.1.rst
@@ -4,16 +4,81 @@
 Security
 ========
 
-:cve:`2016-0740`: Fix buffer overflow in ``libImaging/TiffDecode.c``
-^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
+:cve:`2016-0740`: Buffer overflow in ``TiffDecode.c``
+^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
 
-Buffer overflow in the ImagingLibTiffDecode function in
-``libImaging/TiffDecode.c`` in Pillow before 3.1.1 allows remote attackers to
-overwrite memory via a crafted TIFF file.
+Pillow 3.1.0 and earlier when linked against libtiff >= 4.0.0 on x64
+may overflow a buffer when reading a specially crafted tiff file
+(:cve:`2016-0740`).
 
-:cve:`2016-0775`: Fix buffer overflow in ``libImaging/FliDecode.c``
-^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
+Specifically, libtiff >= 4.0.0 changed the return type of
+``TIFFScanlineSize`` from ``int32`` to machine dependent
+``int32|64``. If the scanline is sized so that it overflows an
+``int32``, it may be interpreted as a negative number, which will then
+pass the size check in ``TiffDecode.c`` line 236. To do this, the
+logical scanline size has to be > 2gb, and for the test file, the
+allocated buffer size is 64k against a roughly 4gb scan line size. Any
+image data over 64k is written over the heap, causing a segfault.
 
-Buffer overflow in the ImagingFliDecode function in ``libImaging/FliDecode.c``
-in Pillow before 3.1.1 allows remote attackers to cause a denial of service
-(crash) via a crafted FLI file.
+This issue was found by security researcher FourOne.
+
+:cve:`2016-0775`: Buffer overflow in ``FliDecode.c``
+^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
+
+In all versions of Pillow, dating back at least to the last PIL 1.1.7
+release, FliDecode.c has a buffer overflow error (:cve:`2016-0775`).
+
+Around line 192:
+
+.. code-block:: c
+
+  case 16:
+      /* COPY chunk */
+      for (y = 0; y < state->ysize; y++) {
+          UINT8* buf = (UINT8*) im->image[y];
+          memcpy(buf+x, data, state->xsize);
+          data += state->xsize;
+      }
+      break;
+
+
+The memcpy has error where ``x`` is added to the target buffer
+address. ``X`` is used in several internal temporary variable roles,
+but can take a value up to the width of the image.  ``Im->image[y]``
+is a set of row pointers to segments of memory that are the size of
+the row.  At the max ``y``, this will write the contents of the line
+off the end of the memory buffer, causing a segfault.
+
+This issue was found by Alyssa Besseling at Atlassian.
+
+:cve:`2016-2533`: Buffer overflow in ``PcdDecode.c``
+^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
+
+In all versions of Pillow, dating back at least to the last PIL 1.1.7
+release, ``PcdDecode.c`` has a buffer overflow error (:cve:`2016-2533`).
+
+The ``state.buffer`` for ``PcdDecode.c`` is allocated based on a 3
+bytes per pixel sizing, where ``PcdDecode.c`` wrote into the buffer
+assuming 4 bytes per pixel. This writes 768 bytes beyond the end of
+the buffer into other Python object storage. In some cases, this
+causes a segfault, in others an internal Python malloc error.
+
+Integer overflow in Resample.c
+^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
+
+If a large value was passed into the new size for an image, it is
+possible to overflow an ``int32`` value passed into malloc.
+
+.. code-block:: c
+
+    kk = malloc(xsize * kmax * sizeof(float));
+    ...
+    xbounds = malloc(xsize * 2 * sizeof(int));
+
+``xsize`` is trusted user input. These multiplications can overflow,
+leading the ``malloc``'d buffer to be undersized. These allocations are
+followed by a loop that writes out of bounds. This can lead to
+corruption on the heap of the Python process with attacker controlled
+float data.
+
+This issue was found by Ned Williamson.

From 180f37b18e673cdf996fa629596980c332067d2c Mon Sep 17 00:00:00 2001
From: Alex Clark <aclark@aclark.net>
Date: Thu, 14 Mar 2024 20:21:00 -0400
Subject: [PATCH 0341/1178] Update release notes to match template for #7864

- Categorized previously uncategorized notes under ``Other Changes``
- TODO: Fix categorization of notes in ``Other Changes`` that belong in other categories
---
 docs/releasenotes/10.3.0.rst | 21 ++++++++++------
 docs/releasenotes/2.7.0.rst  | 36 ++++++++++++++-------------
 docs/releasenotes/2.8.0.rst  |  7 ++++--
 docs/releasenotes/3.0.0.rst  | 48 +++++++++++++++++++-----------------
 docs/releasenotes/3.1.0.rst  | 18 ++++++++------
 docs/releasenotes/3.2.0.rst  |  8 +++---
 docs/releasenotes/3.3.0.rst  | 16 ++++++------
 docs/releasenotes/3.3.2.rst  | 10 +++++---
 docs/releasenotes/3.4.0.rst  | 45 ++++++++++++++++++---------------
 docs/releasenotes/4.0.0.rst  |  3 +++
 docs/releasenotes/4.1.0.rst  | 12 +++++----
 docs/releasenotes/4.1.1.rst  |  8 +++---
 docs/releasenotes/4.2.0.rst  | 18 ++++++++------
 docs/releasenotes/4.2.1.rst  |  5 +++-
 docs/releasenotes/5.1.0.rst  | 20 +++++++--------
 docs/releasenotes/5.4.1.rst  |  3 +++
 docs/releasenotes/7.1.1.rst  |  5 +++-
 docs/releasenotes/7.1.2.rst  |  5 +++-
 docs/releasenotes/8.3.1.rst  |  7 ++++--
 19 files changed, 172 insertions(+), 123 deletions(-)

diff --git a/docs/releasenotes/10.3.0.rst b/docs/releasenotes/10.3.0.rst
index af31cdb74fa..b5dbf16d4cb 100644
--- a/docs/releasenotes/10.3.0.rst
+++ b/docs/releasenotes/10.3.0.rst
@@ -1,6 +1,19 @@
 10.3.0
 ------
 
+Security
+========
+
+TODO
+^^^^
+
+TODO
+
+:cve:`YYYY-XXXXX`: TODO
+^^^^^^^^^^^^^^^^^^^^^^^
+
+TODO
+
 Backwards Incompatible Changes
 ==============================
 
@@ -63,14 +76,6 @@ Added PerspectiveTransform
 that all of the :py:data:`~PIL.Image.Transform` values now have a corresponding
 subclass of :py:class:`~PIL.ImageTransform.Transform`.
 
-Security
-========
-
-TODO
-^^^^
-
-TODO
-
 Other Changes
 =============
 
diff --git a/docs/releasenotes/2.7.0.rst b/docs/releasenotes/2.7.0.rst
index 0b3eeeb49d5..3b4d6e65dee 100644
--- a/docs/releasenotes/2.7.0.rst
+++ b/docs/releasenotes/2.7.0.rst
@@ -1,15 +1,17 @@
 2.7.0
-=====
+-----
+
+Other Changes
+=============
 
 Sane Plugin
------------
+^^^^^^^^^^^
 
 The Sane plugin has now been split into its own repo:
 https://github.com/python-pillow/Sane .
 
-
 Png text chunk size limits
---------------------------
+^^^^^^^^^^^^^^^^^^^^^^^^^^
 
 To prevent potential denial of service attacks using compressed text
 chunks, there are now limits to the decompressed size of text chunks
@@ -24,7 +26,7 @@ default. The total decompressed size of all text chunks is limited to
 know that there are large text blocks that are desired.
 
 Image resizing filters
-----------------------
+^^^^^^^^^^^^^^^^^^^^^^
 
 Image resizing methods :py:meth:`~PIL.Image.Image.resize` and
 :py:meth:`~PIL.Image.Image.thumbnail` take a ``resample`` argument, which tells
@@ -33,7 +35,7 @@ which filter should be used for resampling. Possible values are:
 were changed in this version.
 
 Bicubic and bilinear downscaling
-^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
+--------------------------------
 
 From the beginning ``BILINEAR`` and ``BICUBIC`` filters were based on affine
 transformations and used a fixed number of pixels from the source image for
@@ -50,7 +52,7 @@ If you have previously used any tricks to maintain quality when downscaling with
 steps), they are unnecessary now.
 
 Antialias renamed to Lanczos
-^^^^^^^^^^^^^^^^^^^^^^^^^^^^
+----------------------------
 
 A new ``LANCZOS`` constant was added instead of ``ANTIALIAS``.
 
@@ -64,19 +66,19 @@ The ``ANTIALIAS`` constant is left for backward compatibility and is an alias
 for ``LANCZOS``.
 
 Lanczos upscaling quality
-^^^^^^^^^^^^^^^^^^^^^^^^^
+-------------------------
 
 The image upscaling quality with ``LANCZOS`` filter was almost the same as
 ``BILINEAR`` due to a bug. This has been fixed.
 
 Bicubic upscaling quality
-^^^^^^^^^^^^^^^^^^^^^^^^^
+-------------------------
 
 The ``BICUBIC`` filter for affine transformations produced sharp, slightly
 pixelated image for upscaling. Bicubic for convolutions is more soft.
 
 Resize performance
-^^^^^^^^^^^^^^^^^^
+------------------
 
 In most cases, convolution is more a expensive algorithm for downscaling
 because it takes into account all the pixels of source image. Therefore
@@ -93,7 +95,7 @@ The upscaling performance of the ``LANCZOS`` filter has remained the same. For
 times.
 
 Default filter for thumbnails
-^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
+-----------------------------
 
 In Pillow 2.5 the default filter for :py:meth:`~PIL.Image.Image.thumbnail` was
 changed from ``NEAREST`` to ``ANTIALIAS``. Antialias was chosen because all the
@@ -103,7 +105,7 @@ other filters gave poor quality for reduction. Starting from Pillow 2.7.0,
 uses supersampling internally, not convolutions.
 
 Image transposition
--------------------
+^^^^^^^^^^^^^^^^^^^
 
 A new method ``TRANSPOSE`` has been added for the
 :py:meth:`~PIL.Image.Image.transpose` operation in addition to
@@ -115,7 +117,7 @@ The speed of ``ROTATE_90``, ``ROTATE_270`` and ``TRANSPOSE`` has been significan
 improved for large images which don't fit in the processor cache.
 
 Gaussian blur and unsharp mask
-------------------------------
+^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
 
 The :py:meth:`~PIL.ImageFilter.GaussianBlur` implementation has been replaced
 with a sequential application of box filters. The new implementation is based on
@@ -125,7 +127,7 @@ implementations use Gaussian blur internally, all changes from this chapter
 are also applicable to it.
 
 Blur radius
-^^^^^^^^^^^
+-----------
 
 There was an error in the previous version of Pillow, where blur radius (the
 standard deviation of Gaussian) actually meant blur diameter. For example, to
@@ -136,7 +138,7 @@ If you used a Gaussian blur with some radius value, you need to divide this
 value by two.
 
 Blur performance
-^^^^^^^^^^^^^^^^
+----------------
 
 Box filter computation time is constant relative to the radius and depends
 on source image size only. Because the new Gaussian blur implementation
@@ -148,7 +150,7 @@ second for radius 1, 3.6 seconds for radius 10 and 17 seconds for 50, now blur
 with any radius on same image is executed for 0.2 seconds.
 
 Blur quality
-^^^^^^^^^^^^
+------------
 
 The previous implementation takes into account only source pixels within
 2 * standard deviation radius for every destination pixel. This was not enough,
@@ -157,7 +159,7 @@ so the quality was worse compared to other Gaussian blur software.
 The new implementation does not have this drawback.
 
 TIFF Parameter Changes
-----------------------
+^^^^^^^^^^^^^^^^^^^^^^
 
 Several kwarg parameters for saving TIFF images were previously
 specified as strings with included spaces (e.g. 'x resolution'). This
diff --git a/docs/releasenotes/2.8.0.rst b/docs/releasenotes/2.8.0.rst
index 4dbbc0bdd29..5af2d70bac2 100644
--- a/docs/releasenotes/2.8.0.rst
+++ b/docs/releasenotes/2.8.0.rst
@@ -1,8 +1,11 @@
 2.8.0
-=====
+-----
+
+Other Changes
+=============
 
 Open HTTP response objects with Image.open
-------------------------------------------
+^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
 
 HTTP response objects returned from ``urllib2.urlopen(url)`` or
 ``requests.get(url, stream=True).raw`` are 'file-like' but do not support ``.seek()``
diff --git a/docs/releasenotes/3.0.0.rst b/docs/releasenotes/3.0.0.rst
index e8eada73c54..4ec71fa6785 100644
--- a/docs/releasenotes/3.0.0.rst
+++ b/docs/releasenotes/3.0.0.rst
@@ -1,9 +1,28 @@
-
 3.0.0
-=====
+-----
+
+Deprecations
+============
+
+Several methods that have been marked as deprecated for many releases
+have been removed in this release::
+
+    Image.tostring()
+    Image.fromstring()
+    Image.offset()
+    ImageDraw.setink()
+    ImageDraw.setfill()
+    The ImageFileIO module
+    The ImageFont.FreeTypeFont and ImageFont.truetype ``file`` keyword arg
+    The ImagePalette private _make functions
+    ImageWin.fromstring()
+    ImageWin.tostring()
+
+Other Changes
+=============
 
 Saving Multipage Images
------------------------
+^^^^^^^^^^^^^^^^^^^^^^^
 
 There is now support for saving multipage images in the ``GIF`` and
 ``PDF`` formats. To enable this functionality, pass in ``save_all=True``
@@ -12,7 +31,7 @@ as a keyword argument to the save::
     im.save('test.pdf', save_all=True)
 
 Tiff ImageFileDirectory Rewrite
--------------------------------
+^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
 
 The Tiff ImageFileDirectory metadata code has been rewritten. Where
 previously it returned a somewhat arbitrary set of values and tuples,
@@ -25,25 +44,8 @@ structures will be deprecated at some point in the future.  When
 saving Tiff metadata, new code should use the
 TiffImagePlugin.ImageFileDirectory_v2 class.
 
-Deprecated Methods
-------------------
-
-Several methods that have been marked as deprecated for many releases
-have been removed in this release::
-
-    Image.tostring()
-    Image.fromstring()
-    Image.offset()
-    ImageDraw.setink()
-    ImageDraw.setfill()
-    The ImageFileIO module
-    The ImageFont.FreeTypeFont and ImageFont.truetype ``file`` keyword arg
-    The ImagePalette private _make functions
-    ImageWin.fromstring()
-    ImageWin.tostring()
-
-LibJpeg and Zlib are Required by Default
-----------------------------------------
+LibJpeg and Zlib are required by default
+^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
 
 The external dependencies on libjpeg and zlib are now required by default.
 If the headers or libraries are not found, then installation will abort
diff --git a/docs/releasenotes/3.1.0.rst b/docs/releasenotes/3.1.0.rst
index 3cdb6939d49..a233b2b8f27 100644
--- a/docs/releasenotes/3.1.0.rst
+++ b/docs/releasenotes/3.1.0.rst
@@ -1,9 +1,11 @@
-
 3.1.0
-=====
+-----
+
+Other Changes
+=============
 
 ImageDraw arc, chord and pieslice can now use floats
-----------------------------------------------------
+^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
 
 There is no longer a need to ensure that the start and end arguments for ``arc``,
 ``chord`` and ``pieslice`` are integers.
@@ -12,7 +14,7 @@ Note that these numbers are not simply rounded internally, but are actually
 utilised in the drawing process.
 
 Consistent multiline text spacing
----------------------------------
+^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
 
 When using the ``ImageDraw`` multiline methods, the spacing between
 lines was inconsistent, based on the combination on ascenders and
@@ -24,7 +26,7 @@ not the absolute height of each line.
 There is also now a default spacing of 4px between lines.
 
 Exif, Jpeg and Tiff Metadata
-----------------------------
+^^^^^^^^^^^^^^^^^^^^^^^^^^^^
 
 There were major changes in the TIFF ImageFileDirectory support in
 Pillow 3.0 that led to a number of regressions. Some of them have been
@@ -32,7 +34,7 @@ fixed in Pillow 3.1, and some of them have been extended to have
 different behavior.
 
 TiffImagePlugin.IFDRational
-+++++++++++++++++++++++++++
+---------------------------
 
 Pillow 3.0 changed rational metadata to use a float. In Pillow 3.1,
 this has changed to allow the expression of 0/0 as a valid piece of
@@ -50,7 +52,7 @@ This class should be used when adding a rational value to an
 ImageFileDirectory for saving to image metadata.
 
 JpegImagePlugin._getexif
-++++++++++++++++++++++++
+------------------------
 
 In Pillow 3.0, the dictionary returned from the private, experimental,
 but generally widely used ``_getexif`` function changed to reflect the
@@ -65,7 +67,7 @@ The format returned by Pillow 3.0 has been abandoned. A more fully
 featured interface for EXIF is anticipated in a future release.
 
 Out of Spec Metadata
-++++++++++++++++++++
+--------------------
 
 In Pillow 3.0 and 3.1, images that contain metadata that is internally
 consistent, but not in agreement with the TIFF spec, may cause an
diff --git a/docs/releasenotes/3.2.0.rst b/docs/releasenotes/3.2.0.rst
index c6177428814..26a91db7950 100644
--- a/docs/releasenotes/3.2.0.rst
+++ b/docs/releasenotes/3.2.0.rst
@@ -1,9 +1,11 @@
-
 3.2.0
 -----
 
+Other Changes
+=============
+
 New DDS and FTEX Image Plugins
-==============================
+^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
 
 The ``DdsImagePlugin`` reading DXT1 and DXT5 encoded ``.dds`` images was
 added. DXT3 images are not currently supported.
@@ -14,7 +16,7 @@ per file, in the ``.ftc`` (compressed) and ``.ftu`` (uncompressed)
 formats.
 
 Updates to the GbrImagePlugin
-=============================
+^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
 
 The ``GbrImagePlugin`` (GIMP brush format) has been updated to fix
 support for version 1 files and add support for version 2 files.
diff --git a/docs/releasenotes/3.3.0.rst b/docs/releasenotes/3.3.0.rst
index 39ffdbb2ef0..35279d493f0 100644
--- a/docs/releasenotes/3.3.0.rst
+++ b/docs/releasenotes/3.3.0.rst
@@ -1,8 +1,11 @@
 3.3.0
 -----
 
+Other Changes
+=============
+
 Libimagequant support
-=====================
+^^^^^^^^^^^^^^^^^^^^^
 
 There is now support for using libimagequant as a higher quality
 quantization option in ``Image.quantize()`` on Unix-like
@@ -12,7 +15,7 @@ differences.
 
 
 New Setup.py options
-====================
+^^^^^^^^^^^^^^^^^^^^
 
 There are two new options to control the ``build_ext`` task in ``setup.py``:
 
@@ -24,9 +27,8 @@ There are two new options to control the ``build_ext`` task in ``setup.py``:
     cross compilers that specify that information in via environment
     variables.
 
-
 Resizing
-========
+^^^^^^^^
 
 Image resampling for 8-bit per channel images was rewritten using only integer
 computings. This is faster on most platforms and doesn't introduce precision
@@ -36,18 +38,16 @@ makes resampling 60% faster on average.
 Color calculation for images in the ``LA`` mode on semitransparent pixels
 was fixed.
 
-
 Rotation
-========
+^^^^^^^^
 
 Rotation for angles divisible by 90 degrees now always uses transposition.
 This greatly improves both quality and performance in this case.
 Also, the bug with wrong image size calculation when rotating by 90 degrees
 was fixed.
 
-
 Image Metadata
-==============
+^^^^^^^^^^^^^^
 
 The return type for binary data in version 2 Exif and Tiff metadata
 has been changed from a tuple of integers to bytes. This is a change
diff --git a/docs/releasenotes/3.3.2.rst b/docs/releasenotes/3.3.2.rst
index 8845b976a8b..73156a65dbb 100644
--- a/docs/releasenotes/3.3.2.rst
+++ b/docs/releasenotes/3.3.2.rst
@@ -1,9 +1,11 @@
-
 3.3.2
-=====
+-----
+
+Security
+========
 
 Integer overflow in Map.c
--------------------------
+^^^^^^^^^^^^^^^^^^^^^^^^^
 
 Pillow prior to 3.3.2 may experience integer overflow errors in map.c
 when reading specially crafted image files. This may lead to memory
@@ -26,7 +28,7 @@ memory without duplicating the image first.
 This issue was found by Cris Neckar at Divergent Security.
 
 Sign Extension in Storage.c
----------------------------
+^^^^^^^^^^^^^^^^^^^^^^^^^^^
 
 Pillow prior to 3.3.2 and PIL 1.1.7 (at least) do not check for
 negative image sizes in ``ImagingNew`` in ``Storage.c``. A negative
diff --git a/docs/releasenotes/3.4.0.rst b/docs/releasenotes/3.4.0.rst
index 2bbafe741d2..05fa7e5e2d8 100644
--- a/docs/releasenotes/3.4.0.rst
+++ b/docs/releasenotes/3.4.0.rst
@@ -1,9 +1,29 @@
-
 3.4.0
 -----
 
+Deprecations
+============
+
+Deprecation Warning when Saving JPEGs
+^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
+
+JPEG images cannot contain an alpha channel. Pillow prior to 3.4.0
+silently drops the alpha channel. With this release Pillow will now
+issue a :py:exc:`DeprecationWarning` when attempting to save a ``RGBA`` mode
+image as a JPEG. This will become an error in Pillow 4.2.
+
+Image.core.open_ppm removed
+^^^^^^^^^^^^^^^^^^^^^^^^^^^
+
+The nominally private/debugging function ``Image.core.open_ppm`` has
+been removed. If you were using this function, please use
+``Image.open`` instead.
+
+Other changes
+=============
+
 New resizing filters
-====================
+^^^^^^^^^^^^^^^^^^^^
 
 Two new filters available for ``Image.resize()`` and ``Image.thumbnail()``
 functions: ``BOX`` and ``HAMMING``. ``BOX`` is the high-performance filter with
@@ -14,23 +34,15 @@ two times shorter window than ``BILINEAR``. It can be used for image reduction
 providing the image downscaling quality comparable to ``BICUBIC``.
 Both new filters don't show good quality for the image upscaling.
 
-Deprecation Warning when Saving JPEGs
-=====================================
-
-JPEG images cannot contain an alpha channel. Pillow prior to 3.4.0
-silently drops the alpha channel. With this release Pillow will now
-issue a :py:exc:`DeprecationWarning` when attempting to save a ``RGBA`` mode
-image as a JPEG. This will become an error in Pillow 4.2.
-
 New DDS Decoders
-================
+^^^^^^^^^^^^^^^^
 
 Pillow can now decode DXT3 images, as well as the previously supported
 DXT1 and DXT5 formats. All three formats are now decoded in C code for
 better performance.
 
 Append images to GIF
-====================
+^^^^^^^^^^^^^^^^^^^^
 
 Additional frames can now be appended when saving a GIF file, through the
 ``append_images`` argument. The new frames are passed in as a list of images,
@@ -42,16 +54,9 @@ in effect, e.g.::
     im.save(out, save_all=True, append_images=[im1, im2, ...])
 
 Save multiple frame TIFF
-========================
+^^^^^^^^^^^^^^^^^^^^^^^^
 
 Multiple frames can now be saved in a TIFF file by using the ``save_all`` option.
 e.g.::
 
     im.save("filename.tiff", format="TIFF", save_all=True)
-
-Image.core.open_ppm removed
-===========================
-
-The nominally private/debugging function ``Image.core.open_ppm`` has
-been removed. If you were using this function, please use
-``Image.open`` instead.
diff --git a/docs/releasenotes/4.0.0.rst b/docs/releasenotes/4.0.0.rst
index 5778de26a82..8b4b403a7aa 100644
--- a/docs/releasenotes/4.0.0.rst
+++ b/docs/releasenotes/4.0.0.rst
@@ -1,6 +1,9 @@
 4.0.0
 -----
 
+Other Changes
+=============
+
 Python 2.6 and 3.2 Dropped
 ==========================
 
diff --git a/docs/releasenotes/4.1.0.rst b/docs/releasenotes/4.1.0.rst
index 4d6598d8efa..c57b1212f17 100644
--- a/docs/releasenotes/4.1.0.rst
+++ b/docs/releasenotes/4.1.0.rst
@@ -1,8 +1,8 @@
 4.1.0
 -----
 
-Removed Deprecated Items
-========================
+Deprecations
+============
 
 Several deprecated items have been removed.
 
@@ -15,8 +15,11 @@ Several deprecated items have been removed.
   ``PIL.ImageDraw.ImageDraw.setfont`` have been removed.
 
 
+Other Changes
+=============
+
 Closing Files When Opening Images
-=================================
+^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
 
 The file handling when opening images has been overhauled. Previously,
 Pillow would attempt to close some, but not all image formats
@@ -38,9 +41,8 @@ is specified:
   the underlying file until we are done with the image. The mapping
   will be closed in the ``close`` or ``__del__`` method.
 
-
 Changes to GIF Handling When Saving
-===================================
+^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
 
 The :py:class:`PIL.GifImagePlugin` code has been refactored to fix the flow when
 saving images. There are two external changes that arise from this:
diff --git a/docs/releasenotes/4.1.1.rst b/docs/releasenotes/4.1.1.rst
index 1b5757015f8..8c04387d4a1 100644
--- a/docs/releasenotes/4.1.1.rst
+++ b/docs/releasenotes/4.1.1.rst
@@ -1,8 +1,11 @@
 4.1.1
 -----
 
+Other Changes
+=============
+
 Fix Regression with reading DPI from EXIF data
-==============================================
+^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
 
 Some JPEG images don't contain DPI information in the image metadata,
 but do contain it in the EXIF data. A patch was added in 4.1.0 to read
@@ -10,9 +13,8 @@ from the EXIF data, but it did not accept all possible types that
 could be included there.  This fix adds the ability to read ints as
 well as rational values.
 
-
 Incompatibility between 3.6.0 and 3.6.1
-=======================================
+^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
 
 CPython 3.6.1 added a new symbol, PySlice_GetIndicesEx, which was not
 present in 3.6.0. This had the effect of causing binaries compiled on
diff --git a/docs/releasenotes/4.2.0.rst b/docs/releasenotes/4.2.0.rst
index 1e9637f1e32..aade307d355 100644
--- a/docs/releasenotes/4.2.0.rst
+++ b/docs/releasenotes/4.2.0.rst
@@ -1,8 +1,11 @@
 4.2.0
 -----
 
+Other Changes
+=============
+
 Added Complex Text Rendering
-============================
+^^^^^^^^^^^^^^^^^^^^^^^^^^^^
 
 Pillow now supports complex text rendering for scripts requiring glyph
 composition and bidirectional flow. This optional feature adds three
@@ -11,7 +14,7 @@ dependencies: harfbuzz, fribidi, and raqm. See the :doc:`install documentation
 Unix and Mac, but has not yet been built on Windows platforms.
 
 New Optional Parameters
-=======================
+^^^^^^^^^^^^^^^^^^^^^^^
 
 * :py:meth:`PIL.ImageDraw.floodfill` has a new optional parameter:
   threshold. This specifies a tolerance for the color to replace with
@@ -22,16 +25,17 @@ New Optional Parameters
   multipage outputs.
 
 New DecompressionBomb Warning
-=============================
+^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
 
 :py:meth:`PIL.Image.Image.crop` now may raise a DecompressionBomb
 warning if the crop region enlarges the image over the threshold
 specified by :py:data:`PIL.Image.MAX_IMAGE_PIXELS`.
 
-Removed Deprecated Items
-========================
+Deprections
+===========
 
-Several deprecated items have been removed.
+Several deprecated items have been removed
+^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
 
 * The methods ``PIL.ImageWin.Dib.fromstring``,
   ``PIL.ImageWin.Dib.tostring`` and
@@ -44,7 +48,7 @@ Several deprecated items have been removed.
   an :py:exc:`IOError` is raised.
 
 Removed Core Image Function
-===========================
+^^^^^^^^^^^^^^^^^^^^^^^^^^^
 
 The unused function ``Image.core.new_array`` was removed. This is an
 internal function that should not have been used by user code, but it
diff --git a/docs/releasenotes/4.2.1.rst b/docs/releasenotes/4.2.1.rst
index 0730936feb0..220cc79b6b4 100644
--- a/docs/releasenotes/4.2.1.rst
+++ b/docs/releasenotes/4.2.1.rst
@@ -3,8 +3,11 @@
 
 There are no functional changes in this release.
 
+Other Changes
+=============
+
 Fixed Windows PyPy Build
-========================
+^^^^^^^^^^^^^^^^^^^^^^^^
 
 A change in the 4.2.0 cycle broke the Windows PyPy build. This has
 been fixed, and PyPy is now part of the Windows CI matrix.
diff --git a/docs/releasenotes/5.1.0.rst b/docs/releasenotes/5.1.0.rst
index 2a4c64ac52e..96d84f68117 100644
--- a/docs/releasenotes/5.1.0.rst
+++ b/docs/releasenotes/5.1.0.rst
@@ -1,15 +1,23 @@
 5.1.0
 -----
 
+Other Changes
+=============
+
 New File Format
-===============
+^^^^^^^^^^^^^^^
 
 BLP File Format
-^^^^^^^^^^^^^^^
+---------------
 
 Pillow now supports reading the BLP "Blizzard Mipmap" file format used
 for tiles in Blizzard's engine.
 
+WebP memory leak
+^^^^^^^^^^^^^^^^
+
+A memory leak when opening ``WebP`` files has been fixed.
+
 API Changes
 ===========
 
@@ -26,11 +34,3 @@ Append to PDF Files
 
 Images can now be appended to PDF files in place by passing in
 ``append=True`` when saving the image.
-
-Other Changes
-=============
-
-WebP memory leak
-^^^^^^^^^^^^^^^^
-
-A memory leak when opening ``WebP`` files has been fixed.
diff --git a/docs/releasenotes/5.4.1.rst b/docs/releasenotes/5.4.1.rst
index bbabd652090..e02ab9b31da 100644
--- a/docs/releasenotes/5.4.1.rst
+++ b/docs/releasenotes/5.4.1.rst
@@ -3,6 +3,9 @@
 
 This release fixes regressions in 5.4.0.
 
+Other Changes
+=============
+
 Installation on Termux
 ^^^^^^^^^^^^^^^^^^^^^^
 
diff --git a/docs/releasenotes/7.1.1.rst b/docs/releasenotes/7.1.1.rst
index 2169e6a05b8..d0bf974ea64 100644
--- a/docs/releasenotes/7.1.1.rst
+++ b/docs/releasenotes/7.1.1.rst
@@ -1,8 +1,11 @@
 7.1.1
 -----
 
+Other Changes
+=============
+
 Fix regression seeking PNG files
-================================
+^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
 
 This fixes a regression introduced in 7.1.0 when adding support for APNG files when calling
 ``seek`` and ``tell``:
diff --git a/docs/releasenotes/7.1.2.rst b/docs/releasenotes/7.1.2.rst
index ec0063e7953..211d9dbc1f5 100644
--- a/docs/releasenotes/7.1.2.rst
+++ b/docs/releasenotes/7.1.2.rst
@@ -1,8 +1,11 @@
 7.1.2
 -----
 
+Other Changes
+=============
+
 Fix another regression seeking PNG files
-========================================
+^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
 
 This fixes a regression introduced in 7.1.0 when adding support for APNG files.
 
diff --git a/docs/releasenotes/8.3.1.rst b/docs/releasenotes/8.3.1.rst
index 6af2b37bfe1..c36aa09fbad 100644
--- a/docs/releasenotes/8.3.1.rst
+++ b/docs/releasenotes/8.3.1.rst
@@ -1,8 +1,11 @@
 8.3.1
 -----
 
+Other Changes
+=============
+
 Fixed regression converting to NumPy arrays
-===========================================
+^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
 
 This fixes a regression introduced in 8.3.0 when converting an image to a NumPy array
 with a ``dtype`` argument.
@@ -28,7 +31,7 @@ access.
 The :py:exc:`OSError` is now silently caught.
 
 Fixed removing orientation in ImageOps.exif_transpose
-=====================================================
+^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
 
 In 8.3.0, :py:meth:`~PIL.ImageOps.exif_transpose` was changed to ensure that the
 original image EXIF data was not modified, and the orientation was only removed from

From b5f77799caf1a46cc196344e71b168087229e3a7 Mon Sep 17 00:00:00 2001
From: Alex Clark <aclark@aclark.net>
Date: Thu, 14 Mar 2024 20:50:17 -0400
Subject: [PATCH 0342/1178] Update release notes to match template for #7864

---
 docs/releasenotes/10.0.1.rst |  5 ++++-
 docs/releasenotes/10.3.0.rst |  5 +++++
 docs/releasenotes/2.7.0.rst  | 19 +++++++++---------
 docs/releasenotes/3.1.0.rst  |  6 +++---
 docs/releasenotes/3.2.0.rst  |  4 ++--
 docs/releasenotes/4.0.0.rst  | 14 ++++++-------
 docs/releasenotes/4.1.0.rst  |  6 +++---
 docs/releasenotes/5.1.0.rst  | 31 +++++++++++++----------------
 docs/releasenotes/6.2.2.rst  | 21 +++-----------------
 docs/releasenotes/8.3.1.rst  |  2 +-
 docs/releasenotes/9.4.0.rst  | 38 ++++++++++++++++++------------------
 11 files changed, 70 insertions(+), 81 deletions(-)

diff --git a/docs/releasenotes/10.0.1.rst b/docs/releasenotes/10.0.1.rst
index a260fc3819a..02189d51405 100644
--- a/docs/releasenotes/10.0.1.rst
+++ b/docs/releasenotes/10.0.1.rst
@@ -11,7 +11,10 @@ This release provides an updated install script and updated wheels to
 include libwebp 1.3.2, preventing a potential heap buffer overflow in
 WebP.
 
+Other Changes
+=============
+
 Updated tests to pass with latest zlib version
-==============================================
+^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
 
 The release of zlib 1.3 caused one of the tests in the Pillow test suite to fail.
diff --git a/docs/releasenotes/10.3.0.rst b/docs/releasenotes/10.3.0.rst
index b5dbf16d4cb..110126dc1e5 100644
--- a/docs/releasenotes/10.3.0.rst
+++ b/docs/releasenotes/10.3.0.rst
@@ -90,3 +90,8 @@ Release GIL when fetching WebP frames
 
 Python's Global Interpreter Lock is now released when fetching WebP frames from
 the libwebp decoder.
+
+Add release notes for 2.3.1, 2.3.2, 2.5.2
+^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
+
+TODO
diff --git a/docs/releasenotes/2.7.0.rst b/docs/releasenotes/2.7.0.rst
index 3b4d6e65dee..82b59a6d8f3 100644
--- a/docs/releasenotes/2.7.0.rst
+++ b/docs/releasenotes/2.7.0.rst
@@ -35,7 +35,7 @@ which filter should be used for resampling. Possible values are:
 were changed in this version.
 
 Bicubic and bilinear downscaling
---------------------------------
+++++++++++++++++++++++++++++++++
 
 From the beginning ``BILINEAR`` and ``BICUBIC`` filters were based on affine
 transformations and used a fixed number of pixels from the source image for
@@ -52,7 +52,7 @@ If you have previously used any tricks to maintain quality when downscaling with
 steps), they are unnecessary now.
 
 Antialias renamed to Lanczos
-----------------------------
+++++++++++++++++++++++++++++
 
 A new ``LANCZOS`` constant was added instead of ``ANTIALIAS``.
 
@@ -66,19 +66,19 @@ The ``ANTIALIAS`` constant is left for backward compatibility and is an alias
 for ``LANCZOS``.
 
 Lanczos upscaling quality
--------------------------
++++++++++++++++++++++++++
 
 The image upscaling quality with ``LANCZOS`` filter was almost the same as
 ``BILINEAR`` due to a bug. This has been fixed.
 
 Bicubic upscaling quality
--------------------------
++++++++++++++++++++++++++
 
 The ``BICUBIC`` filter for affine transformations produced sharp, slightly
 pixelated image for upscaling. Bicubic for convolutions is more soft.
 
 Resize performance
-------------------
+++++++++++++++++++
 
 In most cases, convolution is more a expensive algorithm for downscaling
 because it takes into account all the pixels of source image. Therefore
@@ -95,7 +95,7 @@ The upscaling performance of the ``LANCZOS`` filter has remained the same. For
 times.
 
 Default filter for thumbnails
------------------------------
++++++++++++++++++++++++++++++
 
 In Pillow 2.5 the default filter for :py:meth:`~PIL.Image.Image.thumbnail` was
 changed from ``NEAREST`` to ``ANTIALIAS``. Antialias was chosen because all the
@@ -105,7 +105,6 @@ other filters gave poor quality for reduction. Starting from Pillow 2.7.0,
 uses supersampling internally, not convolutions.
 
 Image transposition
-^^^^^^^^^^^^^^^^^^^
 
 A new method ``TRANSPOSE`` has been added for the
 :py:meth:`~PIL.Image.Image.transpose` operation in addition to
@@ -127,7 +126,7 @@ implementations use Gaussian blur internally, all changes from this chapter
 are also applicable to it.
 
 Blur radius
------------
++++++++++++
 
 There was an error in the previous version of Pillow, where blur radius (the
 standard deviation of Gaussian) actually meant blur diameter. For example, to
@@ -138,7 +137,7 @@ If you used a Gaussian blur with some radius value, you need to divide this
 value by two.
 
 Blur performance
-----------------
+++++++++++++++++
 
 Box filter computation time is constant relative to the radius and depends
 on source image size only. Because the new Gaussian blur implementation
@@ -150,7 +149,7 @@ second for radius 1, 3.6 seconds for radius 10 and 17 seconds for 50, now blur
 with any radius on same image is executed for 0.2 seconds.
 
 Blur quality
-------------
+++++++++++++
 
 The previous implementation takes into account only source pixels within
 2 * standard deviation radius for every destination pixel. This was not enough,
diff --git a/docs/releasenotes/3.1.0.rst b/docs/releasenotes/3.1.0.rst
index a233b2b8f27..78531ca374f 100644
--- a/docs/releasenotes/3.1.0.rst
+++ b/docs/releasenotes/3.1.0.rst
@@ -34,7 +34,7 @@ fixed in Pillow 3.1, and some of them have been extended to have
 different behavior.
 
 TiffImagePlugin.IFDRational
----------------------------
++++++++++++++++++++++++++++
 
 Pillow 3.0 changed rational metadata to use a float. In Pillow 3.1,
 this has changed to allow the expression of 0/0 as a valid piece of
@@ -52,7 +52,7 @@ This class should be used when adding a rational value to an
 ImageFileDirectory for saving to image metadata.
 
 JpegImagePlugin._getexif
-------------------------
+++++++++++++++++++++++++
 
 In Pillow 3.0, the dictionary returned from the private, experimental,
 but generally widely used ``_getexif`` function changed to reflect the
@@ -67,7 +67,7 @@ The format returned by Pillow 3.0 has been abandoned. A more fully
 featured interface for EXIF is anticipated in a future release.
 
 Out of Spec Metadata
---------------------
+++++++++++++++++++++
 
 In Pillow 3.0 and 3.1, images that contain metadata that is internally
 consistent, but not in agreement with the TIFF spec, may cause an
diff --git a/docs/releasenotes/3.2.0.rst b/docs/releasenotes/3.2.0.rst
index 26a91db7950..b050e19426b 100644
--- a/docs/releasenotes/3.2.0.rst
+++ b/docs/releasenotes/3.2.0.rst
@@ -22,7 +22,7 @@ The ``GbrImagePlugin`` (GIMP brush format) has been updated to fix
 support for version 1 files and add support for version 2 files.
 
 Passthrough Parameters for ImageDraw.text
-=========================================
+^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
 
 ``ImageDraw.multiline_text`` and ``ImageDraw.multiline_size`` take extra
 spacing parameters above what are used in ``ImageDraw.text`` and
@@ -31,7 +31,7 @@ spacing parameters above what are used in ``ImageDraw.text`` and
 to the corresponding multiline functions.
 
 ImageSequence.Iterator changes
-==============================
+^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
 
 ``ImageSequence.Iterator`` is now an actual iterator implementing the
 Iterator protocol.  It is also now possible to seek to the first image
diff --git a/docs/releasenotes/4.0.0.rst b/docs/releasenotes/4.0.0.rst
index 8b4b403a7aa..34a59ab6ac4 100644
--- a/docs/releasenotes/4.0.0.rst
+++ b/docs/releasenotes/4.0.0.rst
@@ -5,7 +5,7 @@ Other Changes
 =============
 
 Python 2.6 and 3.2 Dropped
-==========================
+^^^^^^^^^^^^^^^^^^^^^^^^^^
 
 Pillow 4.0 no longer supports Python 2.6 and 3.2. We will not be
 creating binaries, testing, or retaining compatibility with these
@@ -13,12 +13,12 @@ releases. This release removes some workarounds for those Python
 releases, so the final working version of Pillow on 2.6 or 3.2 is 3.4.2.
 
 Support added for Python 3.6
-============================
+^^^^^^^^^^^^^^^^^^^^^^^^^^^^
 
 Pillow 4.0 supports Python 3.6.
 
 OleFileIO.py
-============
+^^^^^^^^^^^^
 
 ``OleFileIO.py`` has been removed as a vendored file and is now installed
 from the upstream :pypi:`olefile` PyPI package. All internal dependencies are
@@ -27,19 +27,19 @@ redirected to the olefile package. Direct accesses to
 upstream olefile into ``sys.modules`` in its place.
 
 SGI image save
-==============
+^^^^^^^^^^^^^^
 
 It is now possible to save images in modes ``L``, ``RGB``, and
 ``RGBA`` to the uncompressed SGI image format.
 
 Zero sized images
-=================
+^^^^^^^^^^^^^^^^^
 
 Pillow 3.4.0 removed support for creating images with (0,0) size. This
 has been reenabled, restoring pre 3.4 behavior.
 
 Internal handles_eof flag
-=========================
+^^^^^^^^^^^^^^^^^^^^^^^^^
 
 The ``handles_eof flag`` for decoding images has been removed, as there
 were no internal users of the flag. Anyone maintaining image decoders
@@ -47,7 +47,7 @@ outside of the Pillow source tree should consider using the cleanup
 function pointers instead.
 
 Image.core.stretch removed
-==========================
+^^^^^^^^^^^^^^^^^^^^^^^^^^
 
 The stretch function on the core image object has been removed. This
 used to be for enlarging the image, but has been aliased to resize
diff --git a/docs/releasenotes/4.1.0.rst b/docs/releasenotes/4.1.0.rst
index c57b1212f17..80ad9b9fb63 100644
--- a/docs/releasenotes/4.1.0.rst
+++ b/docs/releasenotes/4.1.0.rst
@@ -58,14 +58,14 @@ This refactor fixed some bugs with palette handling when saving
 multiple frame GIFs.
 
 New Method: Image.remap_palette
-===============================
+^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
 
 The method :py:meth:`PIL.Image.Image.remap_palette()` has been
 added. This method was hoisted from the GifImagePlugin code used to
 optimize the palette.
 
 Added Decoder Registry and Support for Python Based Decoders
-============================================================
+^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
 
 There is now a decoder registry similar to the image plugin
 registries. Image plugins can register a decoder, and it will be
@@ -75,7 +75,7 @@ their C based counterparts, they may be easier and quicker to develop
 or safer to run.
 
 Tests
-=====
+^^^^^
 
 Many tests have been added, including correctness tests for image
 formats that have been previously untested.
diff --git a/docs/releasenotes/5.1.0.rst b/docs/releasenotes/5.1.0.rst
index 96d84f68117..f965e74a14b 100644
--- a/docs/releasenotes/5.1.0.rst
+++ b/docs/releasenotes/5.1.0.rst
@@ -1,23 +1,6 @@
 5.1.0
 -----
 
-Other Changes
-=============
-
-New File Format
-^^^^^^^^^^^^^^^
-
-BLP File Format
----------------
-
-Pillow now supports reading the BLP "Blizzard Mipmap" file format used
-for tiles in Blizzard's engine.
-
-WebP memory leak
-^^^^^^^^^^^^^^^^
-
-A memory leak when opening ``WebP`` files has been fixed.
-
 API Changes
 ===========
 
@@ -34,3 +17,17 @@ Append to PDF Files
 
 Images can now be appended to PDF files in place by passing in
 ``append=True`` when saving the image.
+
+Other Changes
+=============
+
+New BLP File Format
+^^^^^^^^^^^^^^^^^^^
+
+Pillow now supports reading the BLP "Blizzard Mipmap" file format used
+for tiles in Blizzard's engine.
+
+WebP memory leak
+^^^^^^^^^^^^^^^^
+
+A memory leak when opening ``WebP`` files has been fixed.
diff --git a/docs/releasenotes/6.2.2.rst b/docs/releasenotes/6.2.2.rst
index 941bda3a84f..44bb0ffe34d 100644
--- a/docs/releasenotes/6.2.2.rst
+++ b/docs/releasenotes/6.2.2.rst
@@ -13,23 +13,8 @@ If an FPX image reports that it has a large number of bands, a large amount of
 resources will be used when trying to process the image. This is fixed by
 limiting the number of bands to those usable by Pillow.
 
-:cve:`2020-5310`: Overflow checks added to TIFF image processing
-^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
+:cve:`2020-5310`, :cve:`2020-5311`, :cve:`2020-5312`, :cve:`2020-5313`: Overflow checks added
+^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
 
 Overflow checks have been added when calculating the size of a memory block to be reallocated
-in the processing of a TIFF image.
-
-:cve:`2020-5311`: Overflow checks added to SGI image processing
-^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
-
-Buffer overruns were found when processing an SGI image. Checks have been added to prevent this.
-
-:cve:`2020-5312`: Overflow checks added to PCX image processing
-^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
-
-Buffer overruns were found when processing a PCX image. Checks have been added to prevent this.
-
-:cve:`2020-5313`: Overflow checks added to FLI image processing
-^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
-
-Buffer overruns were found when processing an FLI image. Checks have been added to prevent this.
+in the processing of TIFF, SGI, PCX and FLI images.
diff --git a/docs/releasenotes/8.3.1.rst b/docs/releasenotes/8.3.1.rst
index c36aa09fbad..5f5f9ff29df 100644
--- a/docs/releasenotes/8.3.1.rst
+++ b/docs/releasenotes/8.3.1.rst
@@ -22,7 +22,7 @@ with a ``dtype`` argument.
     >>>
 
 Catch OSError when checking if destination is sys.stdout
-========================================================
+^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
 
 In 8.3.0, a check to see if the destination was ``sys.stdout`` when saving an image was
 updated. This lead to an :py:exc:`OSError` being raised if the environment restricted
diff --git a/docs/releasenotes/9.4.0.rst b/docs/releasenotes/9.4.0.rst
index 0af5bc8ca11..37f26a22c05 100644
--- a/docs/releasenotes/9.4.0.rst
+++ b/docs/releasenotes/9.4.0.rst
@@ -1,6 +1,25 @@
 9.4.0
 -----
 
+Security
+========
+
+Fix memory DOS in ImageFont
+^^^^^^^^^^^^^^^^^^^^^^^^^^^
+
+A corrupt or specially crafted TTF font could have font metrics that lead to
+unreasonably large sizes when rendering text in font. ``ImageFont.py`` did not
+check the image size before allocating memory for it. This dates to the PIL
+fork. Pillow 8.2.0 added a check for large sizes, but did not consider the
+case where one dimension is zero.
+
+Null pointer dereference crash in ImageFont
+^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
+
+Pillow attempted to dereference a null pointer in ``ImageFont``, leading to a
+crash. An error is now raised instead. This has been present since
+Pillow 8.0.0.
+
 API Additions
 =============
 
@@ -69,25 +88,6 @@ When saving a JPEG image, a comment can now be written from
 
     im.save(out, comment="Test comment")
 
-Security
-========
-
-Fix memory DOS in ImageFont
-^^^^^^^^^^^^^^^^^^^^^^^^^^^
-
-A corrupt or specially crafted TTF font could have font metrics that lead to
-unreasonably large sizes when rendering text in font. ``ImageFont.py`` did not
-check the image size before allocating memory for it. This dates to the PIL
-fork. Pillow 8.2.0 added a check for large sizes, but did not consider the
-case where one dimension is zero.
-
-Null pointer dereference crash in ImageFont
-^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
-
-Pillow attempted to dereference a null pointer in ``ImageFont``, leading to a
-crash. An error is now raised instead. This has been present since
-Pillow 8.0.0.
-
 Other Changes
 =============
 

From 45975e482d3590edae92a35032add0a6e847f1e8 Mon Sep 17 00:00:00 2001
From: Alex Clark <aclark@aclark.net>
Date: Thu, 14 Mar 2024 21:04:08 -0400
Subject: [PATCH 0343/1178] Update release notes to match template for #7864

---
 docs/releasenotes/2.3.1.rst |  8 +++----
 docs/releasenotes/4.2.0.rst | 46 ++++++++++++++++++-------------------
 docs/releasenotes/6.2.2.rst |  2 +-
 docs/releasenotes/8.3.0.rst |  8 +++----
 4 files changed, 32 insertions(+), 32 deletions(-)

diff --git a/docs/releasenotes/2.3.1.rst b/docs/releasenotes/2.3.1.rst
index 6446ebccbff..d8c41d3ed36 100644
--- a/docs/releasenotes/2.3.1.rst
+++ b/docs/releasenotes/2.3.1.rst
@@ -11,10 +11,10 @@ These issues reported in
 ^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
 
 The (1) load_djpeg function in ``JpegImagePlugin.py``, (2) Ghostscript function
-in EpsImagePlugin.py, (3) load function in ``IptcImagePlugin.py``, and (4) _copy
-function in Image.py in Python Image Library (PIL) 1.1.7 and earlier and
-Pillow before 2.3.1 do not properly create temporary files, which allow local
-users to overwrite arbitrary files and obtain sensitive information via a
+in EpsImagePlugin.py, (3) load function in ``IptcImagePlugin.py``, and (4)
+``_copy`` function in Image.py in Python Image Library (PIL) 1.1.7 and earlier
+and Pillow before 2.3.1 do not properly create temporary files, which allow
+local users to overwrite arbitrary files and obtain sensitive information via a
 symlink attack on the temporary file.
 
 :cve:`2014-1933`: Fix insecure use of :py:func:`tempfile.mktemp`
diff --git a/docs/releasenotes/4.2.0.rst b/docs/releasenotes/4.2.0.rst
index aade307d355..2590c2610f1 100644
--- a/docs/releasenotes/4.2.0.rst
+++ b/docs/releasenotes/4.2.0.rst
@@ -1,6 +1,29 @@
 4.2.0
 -----
 
+Deprecations
+============
+
+Several deprecated items have been removed
+^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
+
+* The methods ``PIL.ImageWin.Dib.fromstring``,
+  ``PIL.ImageWin.Dib.tostring`` and
+  ``PIL.TiffImagePlugin.ImageFileDirectory_v2.as_dict`` have
+  been removed.
+
+* Before Pillow 4.2.0, attempting to save an RGBA image as JPEG would
+  discard the alpha channel. From Pillow 3.4.0, a deprecation warning
+  was shown. From Pillow 4.2.0, the deprecation warning is removed and
+  an :py:exc:`IOError` is raised.
+
+Removed Core Image Function
+^^^^^^^^^^^^^^^^^^^^^^^^^^^
+
+The unused function ``Image.core.new_array`` was removed. This is an
+internal function that should not have been used by user code, but it
+was accessible from the python layer.
+
 Other Changes
 =============
 
@@ -30,26 +53,3 @@ New DecompressionBomb Warning
 :py:meth:`PIL.Image.Image.crop` now may raise a DecompressionBomb
 warning if the crop region enlarges the image over the threshold
 specified by :py:data:`PIL.Image.MAX_IMAGE_PIXELS`.
-
-Deprections
-===========
-
-Several deprecated items have been removed
-^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
-
-* The methods ``PIL.ImageWin.Dib.fromstring``,
-  ``PIL.ImageWin.Dib.tostring`` and
-  ``PIL.TiffImagePlugin.ImageFileDirectory_v2.as_dict`` have
-  been removed.
-
-* Before Pillow 4.2.0, attempting to save an RGBA image as JPEG would
-  discard the alpha channel. From Pillow 3.4.0, a deprecation warning
-  was shown. From Pillow 4.2.0, the deprecation warning is removed and
-  an :py:exc:`IOError` is raised.
-
-Removed Core Image Function
-^^^^^^^^^^^^^^^^^^^^^^^^^^^
-
-The unused function ``Image.core.new_array`` was removed. This is an
-internal function that should not have been used by user code, but it
-was accessible from the python layer.
diff --git a/docs/releasenotes/6.2.2.rst b/docs/releasenotes/6.2.2.rst
index 44bb0ffe34d..f223b8f5a08 100644
--- a/docs/releasenotes/6.2.2.rst
+++ b/docs/releasenotes/6.2.2.rst
@@ -4,7 +4,7 @@
 Security
 ========
 
-This release fixes several buffer overruns and DOS attacks.
+This release fixes several buffer overflow issues and a DOS attack vulnerability.
 
 :cve:`2019-19911`: DOS attack vulnerability
 ^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
diff --git a/docs/releasenotes/8.3.0.rst b/docs/releasenotes/8.3.0.rst
index 3ef9bb9b334..9f46cc1e9e9 100644
--- a/docs/releasenotes/8.3.0.rst
+++ b/docs/releasenotes/8.3.0.rst
@@ -4,11 +4,11 @@
 Security
 ========
 
-:cve:`2021-34552`: Buffer overflow
-^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
+:cve:`2021-34552`: Fix buffer overflow
+^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
 
-PIL since 1.1.4 and Pillow since 1.0 allowed parameters passed into a convert function to trigger
-buffer overflow in Convert.c.
+PIL since 1.1.4 and Pillow since 1.0 allowed parameters passed into a convert
+function to trigger buffer overflow in ``Convert.c``.
 
 Parsing XML
 ^^^^^^^^^^^

From 4438305a959873107c4165515a5e26b5c5bafc7b Mon Sep 17 00:00:00 2001
From: "Jeffrey A. Clark" <aclark@aclark.net>
Date: Fri, 15 Mar 2024 10:03:19 -0400
Subject: [PATCH 0344/1178] Update docs/releasenotes/7.1.0.rst

Co-authored-by: Hugo van Kemenade <1324225+hugovk@users.noreply.github.com>
---
 docs/releasenotes/7.1.0.rst | 3 ++-
 1 file changed, 2 insertions(+), 1 deletion(-)

diff --git a/docs/releasenotes/7.1.0.rst b/docs/releasenotes/7.1.0.rst
index 4c1f41a693a..2a7d2f1d258 100644
--- a/docs/releasenotes/7.1.0.rst
+++ b/docs/releasenotes/7.1.0.rst
@@ -29,7 +29,8 @@ In ``libImaging/Jpeg2KDecode.c`` in Pillow before 7.1.0, there are multiple out-
 :cve:`2020-11538`: Buffer overflow in SGI-RLE decoding
 ^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
 
-In ``libImaging/SgiRleDecode.c`` in Pillow through 7.0.0, a number of out-of-bounds reads exist in the parsing of SGI image files, a different issue than CVE-2020-5311.
+In ``libImaging/SgiRleDecode.c`` in Pillow through 7.0.0, a number of out-of-bounds
+reads exist in the parsing of SGI image files, a different issue than :cve:`2020-5311`.
 
 API Changes
 ===========

From 5b3dabb3a0b902513fd558525bbc15f83c73b471 Mon Sep 17 00:00:00 2001
From: Alex Clark <aclark@aclark.net>
Date: Fri, 15 Mar 2024 10:27:29 -0400
Subject: [PATCH 0345/1178] Add release notes for 2.6.0 for #7864

---
 docs/releasenotes/10.3.0.rst | 12 +++++++++---
 docs/releasenotes/2.6.0.rst  | 22 ++++++++++++++++++++++
 docs/releasenotes/index.rst  |  1 +
 3 files changed, 32 insertions(+), 3 deletions(-)
 create mode 100644 docs/releasenotes/2.6.0.rst

diff --git a/docs/releasenotes/10.3.0.rst b/docs/releasenotes/10.3.0.rst
index 110126dc1e5..d16d45504ea 100644
--- a/docs/releasenotes/10.3.0.rst
+++ b/docs/releasenotes/10.3.0.rst
@@ -91,7 +91,13 @@ Release GIL when fetching WebP frames
 Python's Global Interpreter Lock is now released when fetching WebP frames from
 the libwebp decoder.
 
-Add release notes for 2.3.1, 2.3.2, 2.5.2
-^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
+Added release notes for past releases
+^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
 
-TODO
+Added release notes for past releases: ``2.6.0``, ``2.5.2``,
+``2.3.2``, ``2.3.1``. This effort is intended to provide a comprehensive
+look at CVE data from 1995 to 2024 across three noteworthy periods:
+
+- 1995-2010: No CVEs
+- 2010-2019: A few CVEs
+- 2019-2024: Many CVEs
diff --git a/docs/releasenotes/2.6.0.rst b/docs/releasenotes/2.6.0.rst
new file mode 100644
index 00000000000..22e8c737b07
--- /dev/null
+++ b/docs/releasenotes/2.6.0.rst
@@ -0,0 +1,22 @@
+2.6.0
+-----
+
+Security
+========
+
+:cve:`2014-3589`: Fix DOS attack
+^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
+
+``PIL/IcnsImagePlugin.py`` in Python Imaging Library (PIL) and Pillow before 2.3.2 and
+2.5.x before 2.5.2 allows remote attackers to cause a denial of service via a crafted
+block size.
+
+Found and reported by Andrew Drake of dropbox.com
+
+Other Changes
+=============
+
+Relaxed precision of some tests
+^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
+
+Relaxed imagedraw tests to allow slight errors for x86 vs x64.
diff --git a/docs/releasenotes/index.rst b/docs/releasenotes/index.rst
index 17a95c6f62a..089d44b9075 100644
--- a/docs/releasenotes/index.rst
+++ b/docs/releasenotes/index.rst
@@ -69,6 +69,7 @@ expected to be backported to earlier versions.
   3.0.0
   2.8.0
   2.7.0
+  2.6.0
   2.5.2
   2.3.2
   2.3.1

From 115179e5a63597387f118c87a3f34cf0c7d47ee9 Mon Sep 17 00:00:00 2001
From: Alex Clark <aclark@aclark.net>
Date: Fri, 15 Mar 2024 14:08:48 -0400
Subject: [PATCH 0346/1178] Update release notes for #7864

---
 docs/releasenotes/10.3.0.rst | 17 +++++++++++------
 1 file changed, 11 insertions(+), 6 deletions(-)

diff --git a/docs/releasenotes/10.3.0.rst b/docs/releasenotes/10.3.0.rst
index d16d45504ea..9b1ca123379 100644
--- a/docs/releasenotes/10.3.0.rst
+++ b/docs/releasenotes/10.3.0.rst
@@ -95,9 +95,14 @@ Added release notes for past releases
 ^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
 
 Added release notes for past releases: ``2.6.0``, ``2.5.2``,
-``2.3.2``, ``2.3.1``. This effort is intended to provide a comprehensive
-look at CVE data from 1995 to 2024 across three noteworthy periods:
-
-- 1995-2010: No CVEs
-- 2010-2019: A few CVEs
-- 2019-2024: Many CVEs
+``2.3.2``, ``2.3.1``. With these additions we are now able to
+provide a comprehensive view of all CVE data from 1995 to 2024
+across three noteworthy periods:
+
+- 1995-2009: No known CVEs
+- 2010-2018: :cve:`2014-1932`, :cve:`2014-3589`, :cve:`2016-0740`, :cve:`2016-3076`
+- 2019-2024: :cve:`2019-16865`, :cve:`2019-19911`, :cve:`2020-10177`, :cve:`2020-15999`,
+  :cve:`2020-35653`, :cve:`2021-25289`, :cve:`2020-35654`, :cve:`2020-35654`,
+  :cve:`2021-27921`, :cve:`2021-27922`, :cve:`2021-27923`, :cve:`2021-25287`,
+  :cve:`2021-25288`, :cve:`2021-34552`, :cve:`2021-23437`, :cve:`2022-22817`,
+  :cve:`2022-24303`, :cve:`2022-30595`, :cve:`2023-44271`, :cve:`2023-4863`

From e7d8774d701a5a647e2b2ae9cbbae711063042db Mon Sep 17 00:00:00 2001
From: Alex Clark <aclark@aclark.net>
Date: Fri, 15 Mar 2024 14:20:12 -0400
Subject: [PATCH 0347/1178] Wording

---
 docs/releasenotes/10.3.0.rst | 6 +++---
 1 file changed, 3 insertions(+), 3 deletions(-)

diff --git a/docs/releasenotes/10.3.0.rst b/docs/releasenotes/10.3.0.rst
index 9b1ca123379..079cc220ccf 100644
--- a/docs/releasenotes/10.3.0.rst
+++ b/docs/releasenotes/10.3.0.rst
@@ -95,9 +95,9 @@ Added release notes for past releases
 ^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
 
 Added release notes for past releases: ``2.6.0``, ``2.5.2``,
-``2.3.2``, ``2.3.1``. With these additions we are now able to
-provide a comprehensive view of all CVE data from 1995 to 2024
-across three noteworthy periods:
+``2.3.2``, ``2.3.1``. With these additions we are able to
+provide a comprehensive list of all Pillow CVE records from
+1995 to 2024 across three noteworthy periods:
 
 - 1995-2009: No known CVEs
 - 2010-2018: :cve:`2014-1932`, :cve:`2014-3589`, :cve:`2016-0740`, :cve:`2016-3076`

From 3ba8eb3b7e0cf6d02c0d62b315cc2db7afe969e8 Mon Sep 17 00:00:00 2001
From: Andrew Murray <radarhere@users.noreply.github.com>
Date: Sat, 16 Mar 2024 12:29:21 +1100
Subject: [PATCH 0348/1178] Raise a ValueError for negative values when loading
 P1-P3 PPM images

---
 Tests/test_file_ppm.py    | 12 +++++++++++-
 src/PIL/PpmImagePlugin.py |  3 +++
 2 files changed, 14 insertions(+), 1 deletion(-)

diff --git a/Tests/test_file_ppm.py b/Tests/test_file_ppm.py
index 6a0a5a445a7..1bfd0434e96 100644
--- a/Tests/test_file_ppm.py
+++ b/Tests/test_file_ppm.py
@@ -241,13 +241,23 @@ def test_plain_ppm_token_too_long(tmp_path: Path, data: bytes) -> None:
             im.load()
 
 
+def test_plain_ppm_value_negative(tmp_path: Path) -> None:
+    path = str(tmp_path / "temp.ppm")
+    with open(path, "wb") as f:
+        f.write(b"P3\n128 128\n255\n-1")
+
+    with Image.open(path) as im:
+        with pytest.raises(ValueError, match="Channel value is negative"):
+            im.load()
+
+
 def test_plain_ppm_value_too_large(tmp_path: Path) -> None:
     path = str(tmp_path / "temp.ppm")
     with open(path, "wb") as f:
         f.write(b"P3\n128 128\n255\n256")
 
     with Image.open(path) as im:
-        with pytest.raises(ValueError):
+        with pytest.raises(ValueError, match="Channel value too large"):
             im.load()
 
 
diff --git a/src/PIL/PpmImagePlugin.py b/src/PIL/PpmImagePlugin.py
index 6ac7a9bbc79..bca3018c36f 100644
--- a/src/PIL/PpmImagePlugin.py
+++ b/src/PIL/PpmImagePlugin.py
@@ -270,6 +270,9 @@ def _decode_blocks(self, maxval: int) -> bytearray:
                     msg = b"Token too long found in data: %s" % token[: max_len + 1]
                     raise ValueError(msg)
                 value = int(token)
+                if value < 0:
+                    msg_str = f"Channel value is negative: {value}"
+                    raise ValueError(msg_str)
                 if value > maxval:
                     msg_str = f"Channel value too large for this mode: {value}"
                     raise ValueError(msg_str)

From 21801f3a45cd9d6a519120acffa7bafa8b44ef77 Mon Sep 17 00:00:00 2001
From: Andrew Murray <radarhere@users.noreply.github.com>
Date: Sat, 16 Mar 2024 13:33:04 +1100
Subject: [PATCH 0349/1178] Raise ValueError if seeking to greater than
 offset-sized integer

---
 Tests/images/seek_too_large.tif | Bin 0 -> 16 bytes
 Tests/test_file_tiff.py         |   4 ++++
 src/PIL/TiffImagePlugin.py      |   3 +++
 3 files changed, 7 insertions(+)
 create mode 100644 Tests/images/seek_too_large.tif

diff --git a/Tests/images/seek_too_large.tif b/Tests/images/seek_too_large.tif
new file mode 100644
index 0000000000000000000000000000000000000000..094c3057c867a1d678b1683937df5ff70e7b3c96
GIT binary patch
literal 16
ScmebD)MnsdU|{$U0Sy2y{s=z+

literal 0
HcmV?d00001

diff --git a/Tests/test_file_tiff.py b/Tests/test_file_tiff.py
index 21d52462e91..8821fb46a84 100644
--- a/Tests/test_file_tiff.py
+++ b/Tests/test_file_tiff.py
@@ -113,6 +113,10 @@ def test_bigtiff(self, tmp_path: Path) -> None:
             outfile = str(tmp_path / "temp.tif")
             im.save(outfile, save_all=True, append_images=[im], tiffinfo=im.tag_v2)
 
+    def test_seek_too_large(self):
+        with pytest.raises(ValueError, match="Unable to seek to frame"):
+            Image.open("Tests/images/seek_too_large.tif")
+
     def test_set_legacy_api(self) -> None:
         ifd = TiffImagePlugin.ImageFileDirectory_v2()
         with pytest.raises(Exception) as e:
diff --git a/src/PIL/TiffImagePlugin.py b/src/PIL/TiffImagePlugin.py
index b59139f5858..3f00c4b3a11 100644
--- a/src/PIL/TiffImagePlugin.py
+++ b/src/PIL/TiffImagePlugin.py
@@ -1166,6 +1166,9 @@ def _seek(self, frame):
                 self.__next,
                 self.fp.tell(),
             )
+            if self.__next >= 2**63:
+                msg = "Unable to seek to frame"
+                raise ValueError(msg)
             self.fp.seek(self.__next)
             self._frame_pos.append(self.__next)
             logger.debug("Loading tags, location: %s", self.fp.tell())

From a78ed9595f8ccbf6735c48462dc58538436e1f52 Mon Sep 17 00:00:00 2001
From: Andrew Murray <radarhere@users.noreply.github.com>
Date: Sat, 16 Mar 2024 18:40:16 +1100
Subject: [PATCH 0350/1178] Determine size from markers, not EXIF data

---
 Tests/images/sugarshack_frame_size.mpo | Bin 120198 -> 120198 bytes
 Tests/test_file_mpo.py                 |   2 +-
 src/PIL/MpoImagePlugin.py              |  29 ++++++++-----------------
 3 files changed, 10 insertions(+), 21 deletions(-)

diff --git a/Tests/images/sugarshack_frame_size.mpo b/Tests/images/sugarshack_frame_size.mpo
index 009280a79a648be15d6064c96f931e71ce9fde8e..abff98ea57d051dcae4a7853dc9c367dbdf57f51 100644
GIT binary patch
delta 36
scmZo$&EB?}eZx_4W+n!v%_qc9Uf!(9Si!iN^KGao<BIL^OpNN60sWv2R{#J2

delta 41
zcmV+^0M`G8s|SXw2e8E#0|5X5v&a|8(*dZnDgk!^vkC206|*83Oaiy61OeR8M8Xe`

diff --git a/Tests/test_file_mpo.py b/Tests/test_file_mpo.py
index f105428ca82..a5018870058 100644
--- a/Tests/test_file_mpo.py
+++ b/Tests/test_file_mpo.py
@@ -93,7 +93,7 @@ def test_exif(test_file: str) -> None:
 
 def test_frame_size() -> None:
     # This image has been hexedited to contain a different size
-    # in the EXIF data of the second frame
+    # in the SOF marker of the second frame
     with Image.open("Tests/images/sugarshack_frame_size.mpo") as im:
         assert im.size == (640, 480)
 
diff --git a/src/PIL/MpoImagePlugin.py b/src/PIL/MpoImagePlugin.py
index 199a100904c..ac9820bbf68 100644
--- a/src/PIL/MpoImagePlugin.py
+++ b/src/PIL/MpoImagePlugin.py
@@ -24,14 +24,11 @@
 import struct
 
 from . import (
-    ExifTags,
     Image,
-    ImageFile,
     ImageSequence,
     JpegImagePlugin,
     TiffImagePlugin,
 )
-from ._binary import i16be as i16
 from ._binary import o32le
 
 
@@ -109,7 +106,6 @@ def _open(self):
         self._after_jpeg_open()
 
     def _after_jpeg_open(self, mpheader=None):
-        self._initial_size = self.size
         self.mpinfo = mpheader if mpheader is not None else self._getmp()
         self.n_frames = self.mpinfo[0xB001]
         self.__mpoffsets = [
@@ -137,27 +133,20 @@ def seek(self, frame):
         self.fp = self._fp
         self.offset = self.__mpoffsets[frame]
 
+        original_exif = self.info.get("exif")
+        if "exif" in self.info:
+            del self.info["exif"]
+
         self.fp.seek(self.offset + 2)  # skip SOI marker
-        segment = self.fp.read(2)
-        if not segment:
+        if not self.fp.read(2):
             msg = "No data found for frame"
             raise ValueError(msg)
-        self._size = self._initial_size
-        if i16(segment) == 0xFFE1:  # APP1
-            n = i16(self.fp.read(2)) - 2
-            self.info["exif"] = ImageFile._safe_read(self.fp, n)
-            self._reload_exif()
-
-            mptype = self.mpinfo[0xB002][frame]["Attribute"]["MPType"]
-            if mptype.startswith("Large Thumbnail"):
-                exif = self.getexif().get_ifd(ExifTags.IFD.Exif)
-                if 40962 in exif and 40963 in exif:
-                    self._size = (exif[40962], exif[40963])
-        elif "exif" in self.info:
-            del self.info["exif"]
+        self.fp.seek(self.offset)
+        JpegImagePlugin.JpegImageFile._open(self)
+        if self.info.get("exif") != original_exif:
             self._reload_exif()
 
-        self.tile = [("jpeg", (0, 0) + self.size, self.offset, (self.mode, ""))]
+        self.tile = [("jpeg", (0, 0) + self.size, self.offset, self.tile[0][-1])]
         self.__frame = frame
 
     def tell(self):

From b795d4c59ea5e3ec15a39553f65572cd2702819e Mon Sep 17 00:00:00 2001
From: Andrew Murray <radarhere@users.noreply.github.com>
Date: Sat, 16 Mar 2024 18:59:51 +1100
Subject: [PATCH 0351/1178] Update CHANGES.rst [ci skip]

---
 CHANGES.rst | 3 +++
 1 file changed, 3 insertions(+)

diff --git a/CHANGES.rst b/CHANGES.rst
index b8b8869ddbc..663a6af7c5c 100644
--- a/CHANGES.rst
+++ b/CHANGES.rst
@@ -5,6 +5,9 @@ Changelog (Pillow)
 10.3.0 (unreleased)
 -------------------
 
+- Fixed joined corners for ImageDraw rounded_rectangle() non-integer dimensions #7881
+  [radarhere]
+
 - Stop reading EPS image at EOF marker #7753
   [radarhere]
 

From 2568fd891f1f66b2120faad93d8eaa8beef49ca4 Mon Sep 17 00:00:00 2001
From: Hugo van Kemenade <1324225+hugovk@users.noreply.github.com>
Date: Sat, 16 Mar 2024 20:29:48 +0200
Subject: [PATCH 0352/1178] Remove listing of newly-added release notes in 10.4
 release notes

---
 docs/releasenotes/10.3.0.rst | 16 ----------------
 1 file changed, 16 deletions(-)

diff --git a/docs/releasenotes/10.3.0.rst b/docs/releasenotes/10.3.0.rst
index 079cc220ccf..b5dbf16d4cb 100644
--- a/docs/releasenotes/10.3.0.rst
+++ b/docs/releasenotes/10.3.0.rst
@@ -90,19 +90,3 @@ Release GIL when fetching WebP frames
 
 Python's Global Interpreter Lock is now released when fetching WebP frames from
 the libwebp decoder.
-
-Added release notes for past releases
-^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
-
-Added release notes for past releases: ``2.6.0``, ``2.5.2``,
-``2.3.2``, ``2.3.1``. With these additions we are able to
-provide a comprehensive list of all Pillow CVE records from
-1995 to 2024 across three noteworthy periods:
-
-- 1995-2009: No known CVEs
-- 2010-2018: :cve:`2014-1932`, :cve:`2014-3589`, :cve:`2016-0740`, :cve:`2016-3076`
-- 2019-2024: :cve:`2019-16865`, :cve:`2019-19911`, :cve:`2020-10177`, :cve:`2020-15999`,
-  :cve:`2020-35653`, :cve:`2021-25289`, :cve:`2020-35654`, :cve:`2020-35654`,
-  :cve:`2021-27921`, :cve:`2021-27922`, :cve:`2021-27923`, :cve:`2021-25287`,
-  :cve:`2021-25288`, :cve:`2021-34552`, :cve:`2021-23437`, :cve:`2022-22817`,
-  :cve:`2022-24303`, :cve:`2022-30595`, :cve:`2023-44271`, :cve:`2023-4863`

From b25a0542415ed2e34f10aaa70dd84a6b6b789921 Mon Sep 17 00:00:00 2001
From: Hugo van Kemenade <1324225+hugovk@users.noreply.github.com>
Date: Sun, 17 Mar 2024 01:17:38 +0200
Subject: [PATCH 0353/1178] Update release notes

---
 docs/releasenotes/2.3.1.rst | 14 +++++++-------
 docs/releasenotes/2.3.2.rst |  4 ++--
 docs/releasenotes/2.5.2.rst |  4 ++--
 docs/releasenotes/2.6.0.rst | 12 ++----------
 docs/releasenotes/2.7.0.rst |  3 ---
 docs/releasenotes/2.8.0.rst |  3 ---
 docs/releasenotes/3.0.0.rst | 28 ++++++++++++++--------------
 docs/releasenotes/3.1.0.rst |  3 ---
 docs/releasenotes/3.2.0.rst |  3 ---
 docs/releasenotes/3.3.0.rst | 19 ++++++++-----------
 docs/releasenotes/3.4.0.rst | 19 +++++++++++--------
 docs/releasenotes/4.0.0.rst |  3 ---
 docs/releasenotes/4.1.1.rst |  3 ---
 docs/releasenotes/4.2.0.rst |  4 ++--
 docs/releasenotes/4.2.1.rst |  3 ---
 docs/releasenotes/5.1.0.rst |  6 +++---
 docs/releasenotes/5.4.1.rst |  3 ---
 docs/releasenotes/7.1.1.rst |  3 ---
 docs/releasenotes/7.1.2.rst |  3 ---
 docs/releasenotes/8.3.1.rst |  3 ---
 20 files changed, 51 insertions(+), 92 deletions(-)

diff --git a/docs/releasenotes/2.3.1.rst b/docs/releasenotes/2.3.1.rst
index d8c41d3ed36..e54065a0b6e 100644
--- a/docs/releasenotes/2.3.1.rst
+++ b/docs/releasenotes/2.3.1.rst
@@ -4,23 +4,23 @@
 Security
 ========
 
-These issues reported in
+These issues were reported in
 `Debian bug #737059 <https://bugs.debian.org/cgi-bin/bugreport.cgi?bug=737059>`_.
 
 :cve:`2014-1932`: Fix insecure use of :py:func:`tempfile.mktemp`
 ^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
 
-The (1) load_djpeg function in ``JpegImagePlugin.py``, (2) Ghostscript function
-in EpsImagePlugin.py, (3) load function in ``IptcImagePlugin.py``, and (4)
-``_copy`` function in Image.py in Python Image Library (PIL) 1.1.7 and earlier
-and Pillow before 2.3.1 do not properly create temporary files, which allow
+The (1) ``load_djpeg`` function in ``JpegImagePlugin.py``, (2) Ghostscript function
+in ``EpsImagePlugin.py``, (3) ``load`` function in ``IptcImagePlugin.py``, and (4)
+``_copy`` function in ``Image.py`` in
+Pillow before 2.3.1 do not properly create temporary files, which allow
 local users to overwrite arbitrary files and obtain sensitive information via a
 symlink attack on the temporary file.
 
 :cve:`2014-1933`: Fix insecure use of :py:func:`tempfile.mktemp`
 ^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
 
-The (1) ``JpegImagePlugin.py`` and (2) ``EpsImagePlugin.py`` scripts in Python
-Image Library (PIL) 1.1.7 and earlier and Pillow before 2.3.1 uses the names of
+The (1) ``JpegImagePlugin.py`` and (2) ``EpsImagePlugin.py`` scripts in
+Pillow before 2.3.1 uses the names of
 temporary files on the command line, which makes it easier for local users to
 conduct symlink attacks by listing the processes.
diff --git a/docs/releasenotes/2.3.2.rst b/docs/releasenotes/2.3.2.rst
index 56398a97414..c4504ee332c 100644
--- a/docs/releasenotes/2.3.2.rst
+++ b/docs/releasenotes/2.3.2.rst
@@ -7,8 +7,8 @@ Security
 :cve:`2014-3589`: Fix DOS attack
 ^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
 
-``PIL/IcnsImagePlugin.py`` in Python Imaging Library (PIL) and Pillow before 2.3.2 and
+``PIL/IcnsImagePlugin.py`` in Pillow before 2.3.2 and
 2.5.x before 2.5.2 allows remote attackers to cause a denial of service via a crafted
 block size.
 
-Found and reported by Andrew Drake of dropbox.com
+Found and reported by Andrew Drake of `Dropbox <https://www.dropbox.com/>`__.
diff --git a/docs/releasenotes/2.5.2.rst b/docs/releasenotes/2.5.2.rst
index 4884f8db8c4..a80b460a894 100644
--- a/docs/releasenotes/2.5.2.rst
+++ b/docs/releasenotes/2.5.2.rst
@@ -7,8 +7,8 @@ Security
 :cve:`2014-3589`: Fix DOS attack
 ^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
 
-``PIL/IcnsImagePlugin.py`` in Python Imaging Library (PIL) and Pillow before 2.3.2 and
+``PIL/IcnsImagePlugin.py`` in Pillow before 2.3.2 and
 2.5.x before 2.5.2 allows remote attackers to cause a denial of service via a crafted
 block size.
 
-Found and reported by Andrew Drake of dropbox.com
+Found and reported by Andrew Drake of `Dropbox <https://www.dropbox.com/>`__.
diff --git a/docs/releasenotes/2.6.0.rst b/docs/releasenotes/2.6.0.rst
index 22e8c737b07..84b0016d27d 100644
--- a/docs/releasenotes/2.6.0.rst
+++ b/docs/releasenotes/2.6.0.rst
@@ -7,16 +7,8 @@ Security
 :cve:`2014-3589`: Fix DOS attack
 ^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
 
-``PIL/IcnsImagePlugin.py`` in Python Imaging Library (PIL) and Pillow before 2.3.2 and
+``PIL/IcnsImagePlugin.py`` in Pillow before 2.3.2 and
 2.5.x before 2.5.2 allows remote attackers to cause a denial of service via a crafted
 block size.
 
-Found and reported by Andrew Drake of dropbox.com
-
-Other Changes
-=============
-
-Relaxed precision of some tests
-^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
-
-Relaxed imagedraw tests to allow slight errors for x86 vs x64.
+Found and reported by Andrew Drake of `Dropbox <https://www.dropbox.com/>`__.
diff --git a/docs/releasenotes/2.7.0.rst b/docs/releasenotes/2.7.0.rst
index 82b59a6d8f3..5d76830d24c 100644
--- a/docs/releasenotes/2.7.0.rst
+++ b/docs/releasenotes/2.7.0.rst
@@ -1,9 +1,6 @@
 2.7.0
 -----
 
-Other Changes
-=============
-
 Sane Plugin
 ^^^^^^^^^^^
 
diff --git a/docs/releasenotes/2.8.0.rst b/docs/releasenotes/2.8.0.rst
index 5af2d70bac2..2b9eed524d9 100644
--- a/docs/releasenotes/2.8.0.rst
+++ b/docs/releasenotes/2.8.0.rst
@@ -1,9 +1,6 @@
 2.8.0
 -----
 
-Other Changes
-=============
-
 Open HTTP response objects with Image.open
 ^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
 
diff --git a/docs/releasenotes/3.0.0.rst b/docs/releasenotes/3.0.0.rst
index 4ec71fa6785..8bc477f7020 100644
--- a/docs/releasenotes/3.0.0.rst
+++ b/docs/releasenotes/3.0.0.rst
@@ -1,22 +1,22 @@
 3.0.0
 -----
 
-Deprecations
-============
+Backwards Incompatible Changes
+==============================
 
 Several methods that have been marked as deprecated for many releases
-have been removed in this release::
-
-    Image.tostring()
-    Image.fromstring()
-    Image.offset()
-    ImageDraw.setink()
-    ImageDraw.setfill()
-    The ImageFileIO module
-    The ImageFont.FreeTypeFont and ImageFont.truetype ``file`` keyword arg
-    The ImagePalette private _make functions
-    ImageWin.fromstring()
-    ImageWin.tostring()
+have been removed in this release:
+
+* ``Image.tostring()``
+* ``Image.fromstring()``
+* ``Image.offset()``
+* ``ImageDraw.setink()``
+* ``ImageDraw.setfill()``
+* The ``ImageFileIO`` module
+* The ``ImageFont.FreeTypeFont`` and ``ImageFont.truetype`` ``file`` keyword arg
+* The ``ImagePalette`` private ``_make`` functions
+* ``ImageWin.fromstring()``
+* ``ImageWin.tostring()``
 
 Other Changes
 =============
diff --git a/docs/releasenotes/3.1.0.rst b/docs/releasenotes/3.1.0.rst
index 78531ca374f..951819f1956 100644
--- a/docs/releasenotes/3.1.0.rst
+++ b/docs/releasenotes/3.1.0.rst
@@ -1,9 +1,6 @@
 3.1.0
 -----
 
-Other Changes
-=============
-
 ImageDraw arc, chord and pieslice can now use floats
 ^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
 
diff --git a/docs/releasenotes/3.2.0.rst b/docs/releasenotes/3.2.0.rst
index b050e19426b..3ed8fae574b 100644
--- a/docs/releasenotes/3.2.0.rst
+++ b/docs/releasenotes/3.2.0.rst
@@ -1,9 +1,6 @@
 3.2.0
 -----
 
-Other Changes
-=============
-
 New DDS and FTEX Image Plugins
 ^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
 
diff --git a/docs/releasenotes/3.3.0.rst b/docs/releasenotes/3.3.0.rst
index 35279d493f0..cd6f7e2f93c 100644
--- a/docs/releasenotes/3.3.0.rst
+++ b/docs/releasenotes/3.3.0.rst
@@ -1,9 +1,6 @@
 3.3.0
 -----
 
-Other Changes
-=============
-
 Libimagequant support
 ^^^^^^^^^^^^^^^^^^^^^
 
@@ -19,13 +16,13 @@ New Setup.py options
 
 There are two new options to control the ``build_ext`` task in ``setup.py``:
 
-  * ``--debug`` dumps all of the directories and files that are
-    checked when searching for libraries or headers when building the
-    extensions.
-  * ``--disable-platform-guessing`` removes many of the directories
-    that are checked for libraries and headers for build systems or
-    cross compilers that specify that information in via environment
-    variables.
+* ``--debug`` dumps all of the directories and files that are
+  checked when searching for libraries or headers when building the
+  extensions.
+* ``--disable-platform-guessing`` removes many of the directories
+  that are checked for libraries and headers for build systems or
+  cross compilers that specify that information in via environment
+  variables.
 
 Resizing
 ^^^^^^^^
@@ -51,4 +48,4 @@ Image Metadata
 
 The return type for binary data in version 2 Exif and Tiff metadata
 has been changed from a tuple of integers to bytes. This is a change
-from the behavior since ``3.0.0``.
+from the behavior since 3.0.0.
diff --git a/docs/releasenotes/3.4.0.rst b/docs/releasenotes/3.4.0.rst
index 05fa7e5e2d8..8a5a7efe350 100644
--- a/docs/releasenotes/3.4.0.rst
+++ b/docs/releasenotes/3.4.0.rst
@@ -1,6 +1,16 @@
 3.4.0
 -----
 
+Backwards Incompatible Changes
+==============================
+
+Image.core.open_ppm removed
+^^^^^^^^^^^^^^^^^^^^^^^^^^^
+
+The nominally private/debugging function ``Image.core.open_ppm`` has
+been removed. If you were using this function, please use
+``Image.open`` instead.
+
 Deprecations
 ============
 
@@ -12,14 +22,7 @@ silently drops the alpha channel. With this release Pillow will now
 issue a :py:exc:`DeprecationWarning` when attempting to save a ``RGBA`` mode
 image as a JPEG. This will become an error in Pillow 4.2.
 
-Image.core.open_ppm removed
-^^^^^^^^^^^^^^^^^^^^^^^^^^^
-
-The nominally private/debugging function ``Image.core.open_ppm`` has
-been removed. If you were using this function, please use
-``Image.open`` instead.
-
-Other changes
+API Additions
 =============
 
 New resizing filters
diff --git a/docs/releasenotes/4.0.0.rst b/docs/releasenotes/4.0.0.rst
index 34a59ab6ac4..625f237e841 100644
--- a/docs/releasenotes/4.0.0.rst
+++ b/docs/releasenotes/4.0.0.rst
@@ -1,9 +1,6 @@
 4.0.0
 -----
 
-Other Changes
-=============
-
 Python 2.6 and 3.2 Dropped
 ^^^^^^^^^^^^^^^^^^^^^^^^^^
 
diff --git a/docs/releasenotes/4.1.1.rst b/docs/releasenotes/4.1.1.rst
index 8c04387d4a1..8c8055bfad8 100644
--- a/docs/releasenotes/4.1.1.rst
+++ b/docs/releasenotes/4.1.1.rst
@@ -1,9 +1,6 @@
 4.1.1
 -----
 
-Other Changes
-=============
-
 Fix Regression with reading DPI from EXIF data
 ^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
 
diff --git a/docs/releasenotes/4.2.0.rst b/docs/releasenotes/4.2.0.rst
index 2590c2610f1..bc2a45f025f 100644
--- a/docs/releasenotes/4.2.0.rst
+++ b/docs/releasenotes/4.2.0.rst
@@ -1,8 +1,8 @@
 4.2.0
 -----
 
-Deprecations
-============
+Backwards Incompatible Changes
+==============================
 
 Several deprecated items have been removed
 ^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
diff --git a/docs/releasenotes/4.2.1.rst b/docs/releasenotes/4.2.1.rst
index 220cc79b6b4..2061f646746 100644
--- a/docs/releasenotes/4.2.1.rst
+++ b/docs/releasenotes/4.2.1.rst
@@ -3,9 +3,6 @@
 
 There are no functional changes in this release.
 
-Other Changes
-=============
-
 Fixed Windows PyPy Build
 ^^^^^^^^^^^^^^^^^^^^^^^^
 
diff --git a/docs/releasenotes/5.1.0.rst b/docs/releasenotes/5.1.0.rst
index f965e74a14b..c49376dee93 100644
--- a/docs/releasenotes/5.1.0.rst
+++ b/docs/releasenotes/5.1.0.rst
@@ -18,15 +18,15 @@ Append to PDF Files
 Images can now be appended to PDF files in place by passing in
 ``append=True`` when saving the image.
 
-Other Changes
-=============
-
 New BLP File Format
 ^^^^^^^^^^^^^^^^^^^
 
 Pillow now supports reading the BLP "Blizzard Mipmap" file format used
 for tiles in Blizzard's engine.
 
+Other Changes
+=============
+
 WebP memory leak
 ^^^^^^^^^^^^^^^^
 
diff --git a/docs/releasenotes/5.4.1.rst b/docs/releasenotes/5.4.1.rst
index e02ab9b31da..bbabd652090 100644
--- a/docs/releasenotes/5.4.1.rst
+++ b/docs/releasenotes/5.4.1.rst
@@ -3,9 +3,6 @@
 
 This release fixes regressions in 5.4.0.
 
-Other Changes
-=============
-
 Installation on Termux
 ^^^^^^^^^^^^^^^^^^^^^^
 
diff --git a/docs/releasenotes/7.1.1.rst b/docs/releasenotes/7.1.1.rst
index d0bf974ea64..4afdb664588 100644
--- a/docs/releasenotes/7.1.1.rst
+++ b/docs/releasenotes/7.1.1.rst
@@ -1,9 +1,6 @@
 7.1.1
 -----
 
-Other Changes
-=============
-
 Fix regression seeking PNG files
 ^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
 
diff --git a/docs/releasenotes/7.1.2.rst b/docs/releasenotes/7.1.2.rst
index 211d9dbc1f5..63a4b7aadbf 100644
--- a/docs/releasenotes/7.1.2.rst
+++ b/docs/releasenotes/7.1.2.rst
@@ -1,9 +1,6 @@
 7.1.2
 -----
 
-Other Changes
-=============
-
 Fix another regression seeking PNG files
 ^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
 
diff --git a/docs/releasenotes/8.3.1.rst b/docs/releasenotes/8.3.1.rst
index 5f5f9ff29df..edcda3d614f 100644
--- a/docs/releasenotes/8.3.1.rst
+++ b/docs/releasenotes/8.3.1.rst
@@ -1,9 +1,6 @@
 8.3.1
 -----
 
-Other Changes
-=============
-
 Fixed regression converting to NumPy arrays
 ^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
 

From c7e40144116428d4af16acab685965dcff90d979 Mon Sep 17 00:00:00 2001
From: Andrew Murray <radarhere@users.noreply.github.com>
Date: Sun, 17 Mar 2024 18:02:39 +1100
Subject: [PATCH 0354/1178] Fixed heading

---
 docs/releasenotes/2.7.0.rst | 1 +
 1 file changed, 1 insertion(+)

diff --git a/docs/releasenotes/2.7.0.rst b/docs/releasenotes/2.7.0.rst
index 5d76830d24c..e9b0995bb9f 100644
--- a/docs/releasenotes/2.7.0.rst
+++ b/docs/releasenotes/2.7.0.rst
@@ -102,6 +102,7 @@ other filters gave poor quality for reduction. Starting from Pillow 2.7.0,
 uses supersampling internally, not convolutions.
 
 Image transposition
++++++++++++++++++++
 
 A new method ``TRANSPOSE`` has been added for the
 :py:meth:`~PIL.Image.Image.transpose` operation in addition to

From 1528ac1a4562e8713c55180b771d9b173af07659 Mon Sep 17 00:00:00 2001
From: Andrew Murray <radarhere@users.noreply.github.com>
Date: Sun, 17 Mar 2024 18:05:07 +1100
Subject: [PATCH 0355/1178] Consistently highlight filenames in headings

---
 docs/releasenotes/3.1.1.rst | 4 ++--
 1 file changed, 2 insertions(+), 2 deletions(-)

diff --git a/docs/releasenotes/3.1.1.rst b/docs/releasenotes/3.1.1.rst
index f5fbd871175..c81f9621254 100644
--- a/docs/releasenotes/3.1.1.rst
+++ b/docs/releasenotes/3.1.1.rst
@@ -63,8 +63,8 @@ assuming 4 bytes per pixel. This writes 768 bytes beyond the end of
 the buffer into other Python object storage. In some cases, this
 causes a segfault, in others an internal Python malloc error.
 
-Integer overflow in Resample.c
-^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
+Integer overflow in ``Resample.c``
+^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
 
 If a large value was passed into the new size for an image, it is
 possible to overflow an ``int32`` value passed into malloc.

From 3b68a56c10ca0e4b346d8d03b75a5e1526009d24 Mon Sep 17 00:00:00 2001
From: Andrew Murray <radarhere@users.noreply.github.com>
Date: Sun, 17 Mar 2024 18:10:39 +1100
Subject: [PATCH 0356/1178] Remove CVE already mentioned in heading

---
 docs/releasenotes/3.1.1.rst | 3 +--
 1 file changed, 1 insertion(+), 2 deletions(-)

diff --git a/docs/releasenotes/3.1.1.rst b/docs/releasenotes/3.1.1.rst
index c81f9621254..4eabd194490 100644
--- a/docs/releasenotes/3.1.1.rst
+++ b/docs/releasenotes/3.1.1.rst
@@ -8,8 +8,7 @@ Security
 ^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
 
 Pillow 3.1.0 and earlier when linked against libtiff >= 4.0.0 on x64
-may overflow a buffer when reading a specially crafted tiff file
-(:cve:`2016-0740`).
+may overflow a buffer when reading a specially crafted tiff file.
 
 Specifically, libtiff >= 4.0.0 changed the return type of
 ``TIFFScanlineSize`` from ``int32`` to machine dependent

From 5208712b497e702411170bbfa665651016a5f3b0 Mon Sep 17 00:00:00 2001
From: Andrew Murray <radarhere@users.noreply.github.com>
Date: Sun, 17 Mar 2024 18:12:15 +1100
Subject: [PATCH 0357/1178] Added "API Additions" section

---
 docs/releasenotes/5.1.0.rst | 3 +++
 1 file changed, 3 insertions(+)

diff --git a/docs/releasenotes/5.1.0.rst b/docs/releasenotes/5.1.0.rst
index c49376dee93..4e3d10ac596 100644
--- a/docs/releasenotes/5.1.0.rst
+++ b/docs/releasenotes/5.1.0.rst
@@ -12,6 +12,9 @@ and ``CMYK`` with up to 6 8-bit channels, discarding any extra
 channels if the content is tagged as UNSPECIFIED.  Pillow still does
 not store more than 4 8-bit channels of image data.
 
+API Additions
+=============
+
 Append to PDF Files
 ^^^^^^^^^^^^^^^^^^^
 

From 5fd4ad4aa066edda0730e421f4463c8b07a4f505 Mon Sep 17 00:00:00 2001
From: Andrew Murray <radarhere@users.noreply.github.com>
Date: Sun, 17 Mar 2024 18:16:52 +1100
Subject: [PATCH 0358/1178] Corrected CVEs being split into heading and text

---
 docs/releasenotes/9.0.0.rst | 7 ++++---
 1 file changed, 4 insertions(+), 3 deletions(-)

diff --git a/docs/releasenotes/9.0.0.rst b/docs/releasenotes/9.0.0.rst
index 1c940904f55..6fe6b499db4 100644
--- a/docs/releasenotes/9.0.0.rst
+++ b/docs/releasenotes/9.0.0.rst
@@ -51,10 +51,11 @@ will now restrict the builtins available to :py:meth:`PIL.ImageMath.eval`. This
 help prevent problems arising if users evaluate arbitrary expressions, such as
 ``ImageMath.eval("exec(exit())")``.
 
-:cve:`2022-22815`: ImagePath.Path array handling
-^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
+:cve:`2022-22815`, :cve:`2022-22816`: ImagePath.Path array handling
+^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
 
-(:cwe:`126`) and :cve:`2022-22816` (:cwe:`665`) were found when initializing ``ImagePath.Path``.
+:cve:`2022-22815` (:cwe:`126`) and :cve:`2022-22816` (:cwe:`665`) were found when
+initializing ``ImagePath.Path``.
 
 .. _OSS-Fuzz: https://github.com/google/oss-fuzz
 

From 9cf0ece464874b6f8c9ae7cf0421a04926e68050 Mon Sep 17 00:00:00 2001
From: Andrew Murray <radarhere@users.noreply.github.com>
Date: Sun, 17 Mar 2024 18:18:04 +1100
Subject: [PATCH 0359/1178] Changed heading level to be consistent

---
 docs/releasenotes/9.0.0.rst | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/docs/releasenotes/9.0.0.rst b/docs/releasenotes/9.0.0.rst
index 6fe6b499db4..8d59aef3029 100644
--- a/docs/releasenotes/9.0.0.rst
+++ b/docs/releasenotes/9.0.0.rst
@@ -44,7 +44,7 @@ duplicate tiles that only differ by their offset, only load the last tile. Credi
 Google's `OSS-Fuzz`_ project for finding this issue.
 
 :cve:`2022-22817`: Restrict builtins available to ImageMath.eval
-~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
+^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
 
 To limit :py:class:`PIL.ImageMath` to working with images, Pillow
 will now restrict the builtins available to :py:meth:`PIL.ImageMath.eval`. This will

From fe06d419fc7071fd972e715df000a01231b7f660 Mon Sep 17 00:00:00 2001
From: Andrew Murray <radarhere@users.noreply.github.com>
Date: Sun, 17 Mar 2024 18:30:56 +1100
Subject: [PATCH 0360/1178] Added heading

---
 docs/releasenotes/9.1.1.rst | 3 +++
 1 file changed, 3 insertions(+)

diff --git a/docs/releasenotes/9.1.1.rst b/docs/releasenotes/9.1.1.rst
index d538e88c0f9..746bec4d4d6 100644
--- a/docs/releasenotes/9.1.1.rst
+++ b/docs/releasenotes/9.1.1.rst
@@ -14,6 +14,9 @@ Pillow reads the information past the end of the first line without deducting th
 from the length of the remaining file data. This vulnerability was introduced in Pillow
 9.1.0, and can cause a heap buffer overflow.
 
+Decompression bomb check fix
+^^^^^^^^^^^^^^^^^^^^^^^^^^^^
+
 Opening an image with a zero or negative height has been found to bypass a
 decompression bomb check. This will now raise a :py:exc:`SyntaxError` instead, in turn
 raising a ``PIL.UnidentifiedImageError``.

From e760a4fc2bbc09377aafd3a9daca766dfde76a00 Mon Sep 17 00:00:00 2001
From: Andrew Murray <radarhere@users.noreply.github.com>
Date: Sun, 17 Mar 2024 21:26:00 +1100
Subject: [PATCH 0361/1178] Updated harfbuzz to 8.3.1

---
 .github/workflows/wheels-dependencies.sh | 2 +-
 winbuild/build_prepare.py                | 2 +-
 2 files changed, 2 insertions(+), 2 deletions(-)

diff --git a/.github/workflows/wheels-dependencies.sh b/.github/workflows/wheels-dependencies.sh
index e22808ed7fb..78600c6ed14 100755
--- a/.github/workflows/wheels-dependencies.sh
+++ b/.github/workflows/wheels-dependencies.sh
@@ -16,7 +16,7 @@ ARCHIVE_SDIR=pillow-depends-main
 
 # Package versions for fresh source builds
 FREETYPE_VERSION=2.13.2
-HARFBUZZ_VERSION=8.3.0
+HARFBUZZ_VERSION=8.3.1
 LIBPNG_VERSION=1.6.43
 JPEGTURBO_VERSION=3.0.2
 OPENJPEG_VERSION=2.5.2
diff --git a/winbuild/build_prepare.py b/winbuild/build_prepare.py
index 5e144d598c8..43d710055b9 100644
--- a/winbuild/build_prepare.py
+++ b/winbuild/build_prepare.py
@@ -113,7 +113,7 @@ def cmd_msbuild(
     "BROTLI": "1.1.0",
     "FREETYPE": "2.13.2",
     "FRIBIDI": "1.0.13",
-    "HARFBUZZ": "8.3.0",
+    "HARFBUZZ": "8.3.1",
     "JPEGTURBO": "3.0.2",
     "LCMS2": "2.16",
     "LIBPNG": "1.6.43",

From b3c19374564fdf7100532f7a3c88e8caaca18300 Mon Sep 17 00:00:00 2001
From: Andrew Murray <radarhere@users.noreply.github.com>
Date: Sun, 17 Mar 2024 21:37:31 +1100
Subject: [PATCH 0362/1178] Changed wording

---
 docs/releasenotes/8.1.1.rst | 4 ++--
 1 file changed, 2 insertions(+), 2 deletions(-)

diff --git a/docs/releasenotes/8.1.1.rst b/docs/releasenotes/8.1.1.rst
index 484b1de36cb..690421c2a56 100644
--- a/docs/releasenotes/8.1.1.rst
+++ b/docs/releasenotes/8.1.1.rst
@@ -4,8 +4,8 @@
 Security
 ========
 
-:cve:`2021-25289`: Fix the fix for :cve:`2020-35654`
-^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
+:cve:`2021-25289`: Correct the fix for :cve:`2020-35654`
+^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
 
 The previous fix for :cve:`2020-35654` was insufficient due to incorrect
 error checking in ``TiffDecode.c``.

From 4ef6e4ef9b3bbe9dedd0da6c384f109785007ede Mon Sep 17 00:00:00 2001
From: Andrew Murray <radarhere@users.noreply.github.com>
Date: Sun, 17 Mar 2024 21:41:55 +1100
Subject: [PATCH 0363/1178] Highlight code

---
 docs/releasenotes/7.1.0.rst | 7 +++++--
 1 file changed, 5 insertions(+), 2 deletions(-)

diff --git a/docs/releasenotes/7.1.0.rst b/docs/releasenotes/7.1.0.rst
index 2a7d2f1d258..0dd8669a5b8 100644
--- a/docs/releasenotes/7.1.0.rst
+++ b/docs/releasenotes/7.1.0.rst
@@ -14,7 +14,9 @@ Pillow before 7.1.0 has multiple out-of-bounds reads in ``libImaging/FliDecode.c
 :cve:`2020-10378`: Bounds overflow in PCX decoding
 ^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
 
-In ``libImaging/PcxDecode.c`` in Pillow before 7.1.0, an out-of-bounds read can occur when reading PCX files where state->shuffle is instructed to read beyond state->buffer.
+In ``libImaging/PcxDecode.c`` in Pillow before 7.1.0, an out-of-bounds read can occur
+when reading PCX files where ``state->shuffle`` is instructed to read beyond
+``state->buffer``.
 
 :cve:`2020-10379`: Two buffer overflows in TIFF decoding
 ^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
@@ -24,7 +26,8 @@ In Pillow before 7.1.0, there are two buffer overflows in ``libImaging/TiffDecod
 :cve:`2020-10994`: Bounds overflow in JPEG 2000 decoding
 ^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
 
-In ``libImaging/Jpeg2KDecode.c`` in Pillow before 7.1.0, there are multiple out-of-bounds reads via a crafted JP2 file.
+In ``libImaging/Jpeg2KDecode.c`` in Pillow before 7.1.0, there are multiple
+out-of-bounds reads via a crafted JP2 file.
 
 :cve:`2020-11538`: Buffer overflow in SGI-RLE decoding
 ^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^

From d2dfb2f87fff0d85865f8943e9f42b5bed40dd9f Mon Sep 17 00:00:00 2001
From: Andrew Murray <radarhere@users.noreply.github.com>
Date: Sun, 17 Mar 2024 21:43:04 +1100
Subject: [PATCH 0364/1178] Swap order to match description

---
 docs/releasenotes/6.2.2.rst | 12 ++++++------
 1 file changed, 6 insertions(+), 6 deletions(-)

diff --git a/docs/releasenotes/6.2.2.rst b/docs/releasenotes/6.2.2.rst
index f223b8f5a08..85b0d0ba96a 100644
--- a/docs/releasenotes/6.2.2.rst
+++ b/docs/releasenotes/6.2.2.rst
@@ -6,15 +6,15 @@ Security
 
 This release fixes several buffer overflow issues and a DOS attack vulnerability.
 
+:cve:`2020-5310`, :cve:`2020-5311`, :cve:`2020-5312`, :cve:`2020-5313`: Overflow checks added
+^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
+
+Overflow checks have been added when calculating the size of a memory block to be reallocated
+in the processing of TIFF, SGI, PCX and FLI images.
+
 :cve:`2019-19911`: DOS attack vulnerability
 ^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
 
 If an FPX image reports that it has a large number of bands, a large amount of
 resources will be used when trying to process the image. This is fixed by
 limiting the number of bands to those usable by Pillow.
-
-:cve:`2020-5310`, :cve:`2020-5311`, :cve:`2020-5312`, :cve:`2020-5313`: Overflow checks added
-^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
-
-Overflow checks have been added when calculating the size of a memory block to be reallocated
-in the processing of TIFF, SGI, PCX and FLI images.

From 4f677f2183cad8f27702d7dc423c07e7a64e05ef Mon Sep 17 00:00:00 2001
From: Andrew Murray <radarhere@users.noreply.github.com>
Date: Sun, 17 Mar 2024 21:59:46 +1100
Subject: [PATCH 0365/1178] Reordered sections to match template

---
 docs/releasenotes/6.2.0.rst | 38 ++++++++--------
 docs/releasenotes/9.1.0.rst | 86 ++++++++++++++++++-------------------
 docs/releasenotes/9.2.0.rst | 10 ++---
 docs/releasenotes/9.3.0.rst | 54 +++++++++++------------
 docs/releasenotes/9.5.0.rst | 50 ++++++++++-----------
 5 files changed, 119 insertions(+), 119 deletions(-)

diff --git a/docs/releasenotes/6.2.0.rst b/docs/releasenotes/6.2.0.rst
index c241a3a3b83..b851c56fc0e 100644
--- a/docs/releasenotes/6.2.0.rst
+++ b/docs/releasenotes/6.2.0.rst
@@ -29,6 +29,25 @@ perform operations on it.
 The CVE is regarding DOS problems, such as consuming large amounts of memory,
 or taking a large amount of time to process an image.
 
+API Changes
+===========
+
+Image.getexif
+^^^^^^^^^^^^^
+
+To allow for lazy loading of Exif data, ``Image.getexif()`` now returns a
+shared instance of ``Image.Exif``.
+
+Deprecations
+^^^^^^^^^^^^
+
+Image.frombuffer
+~~~~~~~~~~~~~~~~
+
+There has been a longstanding warning that the defaults of ``Image.frombuffer``
+may change in the future for the "raw" decoder. The change will now take place
+in Pillow 7.0.
+
 API Additions
 =============
 
@@ -74,25 +93,6 @@ ImageGrab on multi-monitor Windows
 An ``all_screens`` argument has been added to ``ImageGrab.grab``. If ``True``,
 all monitors will be included in the created image.
 
-API Changes
-===========
-
-Image.getexif
-^^^^^^^^^^^^^
-
-To allow for lazy loading of Exif data, ``Image.getexif()`` now returns a
-shared instance of ``Image.Exif``.
-
-Deprecations
-^^^^^^^^^^^^
-
-Image.frombuffer
-~~~~~~~~~~~~~~~~
-
-There has been a longstanding warning that the defaults of ``Image.frombuffer``
-may change in the future for the "raw" decoder. The change will now take place
-in Pillow 7.0.
-
 Other Changes
 =============
 
diff --git a/docs/releasenotes/9.1.0.rst b/docs/releasenotes/9.1.0.rst
index 6400218f467..5b83d1e9c56 100644
--- a/docs/releasenotes/9.1.0.rst
+++ b/docs/releasenotes/9.1.0.rst
@@ -1,49 +1,6 @@
 9.1.0
 -----
 
-API Changes
-===========
-
-Raise an error when performing a negative crop
-^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
-
-Performing a negative crop on an image previously just returned a ``(0, 0)`` image. Now
-it will raise a :py:exc:`ValueError`, to help reduce confusion if a user has unintentionally
-provided the wrong arguments.
-
-Added specific error if path coordinate type is incorrect
-^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
-
-Rather than returning a :py:exc:`SystemError`, passing the incorrect types of coordinates into
-a path will now raise a more specific :py:exc:`ValueError`, with the message "incorrect
-coordinate type".
-
-Replace requirements.txt with extras
-^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
-
-Rather than installing all dependencies for docs and tests via ``requirements.txt``,
-``extras_require`` is used instead. This installs only those needed and at the same
-time as installing Pillow.
-
-For example:
-
-.. code-block:: bash
-
-    # Install with dependencies for tests:
-    python3 -m pip install .[tests]
-
-    # Or for building docs:
-    python3 -m pip install .[docs]
-
-    # Or for all:
-    python3 -m pip install .[docs,tests]
-
-On macOS, the last argument may need to be wrapped in quotes, e.g.
-``python3 -m pip install ".[tests]"``
-
-Therefore ``requirements.txt`` has been removed along with the ``make install-req``
-command for installing its contents.
-
 Deprecations
 ============
 
@@ -137,6 +94,49 @@ The stub image plugin ``FitsStubImagePlugin`` has been deprecated and will be re
 Pillow 10.0.0 (2023-07-01). FITS images can be read without a handler through
 :mod:`~PIL.FitsImagePlugin` instead.
 
+API Changes
+===========
+
+Raise an error when performing a negative crop
+^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
+
+Performing a negative crop on an image previously just returned a ``(0, 0)`` image. Now
+it will raise a :py:exc:`ValueError`, to help reduce confusion if a user has unintentionally
+provided the wrong arguments.
+
+Added specific error if path coordinate type is incorrect
+^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
+
+Rather than returning a :py:exc:`SystemError`, passing the incorrect types of coordinates into
+a path will now raise a more specific :py:exc:`ValueError`, with the message "incorrect
+coordinate type".
+
+Replace requirements.txt with extras
+^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
+
+Rather than installing all dependencies for docs and tests via ``requirements.txt``,
+``extras_require`` is used instead. This installs only those needed and at the same
+time as installing Pillow.
+
+For example:
+
+.. code-block:: bash
+
+    # Install with dependencies for tests:
+    python3 -m pip install .[tests]
+
+    # Or for building docs:
+    python3 -m pip install .[docs]
+
+    # Or for all:
+    python3 -m pip install .[docs,tests]
+
+On macOS, the last argument may need to be wrapped in quotes, e.g.
+``python3 -m pip install ".[tests]"``
+
+Therefore ``requirements.txt`` has been removed along with the ``make install-req``
+command for installing its contents.
+
 API Additions
 =============
 
diff --git a/docs/releasenotes/9.2.0.rst b/docs/releasenotes/9.2.0.rst
index 359a87e6fe8..fe29f2e4f05 100644
--- a/docs/releasenotes/9.2.0.rst
+++ b/docs/releasenotes/9.2.0.rst
@@ -1,6 +1,11 @@
 9.2.0
 -----
 
+Security
+========
+
+An additional decompression bomb check has been added for the GIF format.
+
 Deprecations
 ============
 
@@ -132,11 +137,6 @@ with "transparency" in ``im.info``, and apply the transparency to the palette in
 The image's palette mode will become "RGBA", and "transparency" will be removed from
 ``im.info``.
 
-Security
-========
-
-An additional decompression bomb check has been added for the GIF format.
-
 Other Changes
 =============
 
diff --git a/docs/releasenotes/9.3.0.rst b/docs/releasenotes/9.3.0.rst
index 16075ce95ec..e5987ce086c 100644
--- a/docs/releasenotes/9.3.0.rst
+++ b/docs/releasenotes/9.3.0.rst
@@ -1,6 +1,33 @@
 9.3.0
 -----
 
+Security
+========
+
+Initialize libtiff buffer when saving
+^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
+
+When saving a TIFF image to a file object using libtiff, the buffer was not
+initialized. This behaviour introduced in Pillow 2.0.0, and has now been fixed.
+
+Decode JPEG compressed BLP1 data in original mode
+^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
+
+Within the BLP image format, BLP1 data may use JPEG compression. Instead of
+telling the JPEG library that this data is in BGRX mode, Pillow will now
+decode the data in its natural CMYK mode, then convert it to RGB and rearrange
+the channels afterwards. Trying to load the data in an incorrect mode could
+result in a segmentation fault. This issue was introduced in Pillow 9.1.0.
+
+Limit SAMPLESPERPIXEL to avoid runtime DOS
+^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
+
+A large value in the ``SAMPLESPERPIXEL`` tag could lead to a memory and runtime DOS in
+``TiffImagePlugin.py`` when setting up the context for image decoding.
+This was introduced in Pillow 9.2.0, found with `OSS-Fuzz`_ and fixed by limiting
+``SAMPLESPERPIXEL`` to the number of planes that we can decode.
+
+
 API Additions
 =============
 
@@ -38,33 +65,6 @@ The data from :py:data:`~PIL.ExifTags.TAGS` and
 :py:data:`~PIL.ExifTags.GPS`.
 
 
-Security
-========
-
-Initialize libtiff buffer when saving
-^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
-
-When saving a TIFF image to a file object using libtiff, the buffer was not
-initialized. This behaviour introduced in Pillow 2.0.0, and has now been fixed.
-
-Decode JPEG compressed BLP1 data in original mode
-^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
-
-Within the BLP image format, BLP1 data may use JPEG compression. Instead of
-telling the JPEG library that this data is in BGRX mode, Pillow will now
-decode the data in its natural CMYK mode, then convert it to RGB and rearrange
-the channels afterwards. Trying to load the data in an incorrect mode could
-result in a segmentation fault. This issue was introduced in Pillow 9.1.0.
-
-Limit SAMPLESPERPIXEL to avoid runtime DOS
-^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
-
-A large value in the ``SAMPLESPERPIXEL`` tag could lead to a memory and runtime DOS in
-``TiffImagePlugin.py`` when setting up the context for image decoding.
-This was introduced in Pillow 9.2.0, found with `OSS-Fuzz`_ and fixed by limiting
-``SAMPLESPERPIXEL`` to the number of planes that we can decode.
-
-
 Other Changes
 =============
 
diff --git a/docs/releasenotes/9.5.0.rst b/docs/releasenotes/9.5.0.rst
index b1e982fccff..08e9ec2a473 100644
--- a/docs/releasenotes/9.5.0.rst
+++ b/docs/releasenotes/9.5.0.rst
@@ -1,6 +1,31 @@
 9.5.0
 -----
 
+Security
+========
+
+Clear PPM half token after use
+^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
+
+Image files that are small on disk are often prevented from expanding to be
+big images consuming a large amount of resources simply because they lack the
+data to populate those resources.
+
+PpmImagePlugin might hold onto the last data read for a pixel value in case the
+pixel value has not been finished yet. However, that data was not being cleared
+afterwards, meaning that infinite data could be available to fill any image
+size. This has been present since Pillow 9.2.0.
+
+That data is now cleared after use.
+
+Saving TIFF tag ImageSourceData
+^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
+
+If Pillow incorrectly saved the TIFF tag ImageSourceData as ASCII instead of
+UNDEFINED, a segmentation fault was triggered.
+
+The correct tag type will now be used by default instead.
+
 Deprecations
 ============
 
@@ -46,31 +71,6 @@ If OpenJPEG 2.4.0 or later is available and the ``plt`` keyword argument
 is present and true when saving JPEG2000 images, tell the encoder to generate
 PLT markers.
 
-Security
-========
-
-Clear PPM half token after use
-^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
-
-Image files that are small on disk are often prevented from expanding to be
-big images consuming a large amount of resources simply because they lack the
-data to populate those resources.
-
-PpmImagePlugin might hold onto the last data read for a pixel value in case the
-pixel value has not been finished yet. However, that data was not being cleared
-afterwards, meaning that infinite data could be available to fill any image
-size. This has been present since Pillow 9.2.0.
-
-That data is now cleared after use.
-
-Saving TIFF tag ImageSourceData
-^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
-
-If Pillow incorrectly saved the TIFF tag ImageSourceData as ASCII instead of
-UNDEFINED, a segmentation fault was triggered.
-
-The correct tag type will now be used by default instead.
-
 Other Changes
 =============
 

From 73bb28c8660035a9e6ffd1b09aca1a0be3d5a0f3 Mon Sep 17 00:00:00 2001
From: Andrew Murray <radarhere@users.noreply.github.com>
Date: Sun, 17 Mar 2024 21:53:06 +1100
Subject: [PATCH 0366/1178] Removed blank lines

---
 docs/releasenotes/6.2.1.rst | 2 --
 1 file changed, 2 deletions(-)

diff --git a/docs/releasenotes/6.2.1.rst b/docs/releasenotes/6.2.1.rst
index ca298fa702c..372298fbc2a 100644
--- a/docs/releasenotes/6.2.1.rst
+++ b/docs/releasenotes/6.2.1.rst
@@ -18,8 +18,6 @@ Pillow 7.0.0 will be released on 2020-01-01 and will drop support for Python
 Other Changes
 =============
 
-
-
 Support added for Python 3.8
 ^^^^^^^^^^^^^^^^^^^^^^^^^^^^
 

From 0c436023a0154e343a639784e714fb3e643b9a5c Mon Sep 17 00:00:00 2001
From: Andrew Murray <radarhere@users.noreply.github.com>
Date: Sun, 17 Mar 2024 22:06:56 +1100
Subject: [PATCH 0367/1178] Corrected heading

---
 docs/releasenotes/8.4.0.rst | 7 ++-----
 1 file changed, 2 insertions(+), 5 deletions(-)

diff --git a/docs/releasenotes/8.4.0.rst b/docs/releasenotes/8.4.0.rst
index e61471e726f..bdc8e802082 100644
--- a/docs/releasenotes/8.4.0.rst
+++ b/docs/releasenotes/8.4.0.rst
@@ -1,14 +1,11 @@
 8.4.0
 -----
 
-API Changes
-===========
-
 Deprecations
-^^^^^^^^^^^^
+============
 
 ImagePalette size parameter
-~~~~~~~~~~~~~~~~~~~~~~~~~~~
+^^^^^^^^^^^^^^^^^^^^^^^^^^^
 
 The ``size`` parameter will be removed in Pillow 10.0.0 (2023-07-01).
 

From d30404feded2eb9d16503fa641267b21639b05a3 Mon Sep 17 00:00:00 2001
From: Yay295 <Yay295@users.noreply.github.com>
Date: Wed, 20 Mar 2024 08:55:05 -0500
Subject: [PATCH 0368/1178] use dummy var name for unused parts of unpacked
 tuple

Co-authored-by: Hugo van Kemenade <1324225+hugovk@users.noreply.github.com>
---
 Tests/test_image.py | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/Tests/test_image.py b/Tests/test_image.py
index 8890db1289f..1c2b6d4b938 100644
--- a/Tests/test_image.py
+++ b/Tests/test_image.py
@@ -60,7 +60,7 @@
     ("LAB", 3, 4),
 )
 
-image_mode_names = [name for name, num_bands, pixelsize in image_modes]
+image_mode_names = [name for name, _, _ in image_modes]
 
 
 class TestImage:

From 75a206bf5886dfa7f1f322bcc743eac51c3a566a Mon Sep 17 00:00:00 2001
From: Andrew Murray <radarhere@users.noreply.github.com>
Date: Wed, 20 Mar 2024 20:42:13 +1100
Subject: [PATCH 0369/1178] Added conversion from RGB to RGBa and La

---
 Tests/helper.py          | 6 +-----
 src/libImaging/Convert.c | 2 ++
 2 files changed, 3 insertions(+), 5 deletions(-)

diff --git a/Tests/helper.py b/Tests/helper.py
index a7691f64527..9849bf65565 100644
--- a/Tests/helper.py
+++ b/Tests/helper.py
@@ -261,11 +261,7 @@ def hopper(mode: str | None = None, cache: dict[str, Image.Image] = {}) -> Image
     # (for fast, isolated, repeatable tests).
     im = cache.get(mode)
     if im is None:
-        if mode == "RGBa":
-            im = hopper("RGBA").convert(mode)
-        elif mode == "La":
-            im = hopper("LA").convert(mode)
-        elif mode == "F":
+        if mode == "F":
             im = hopper("L").convert(mode)
         elif mode[:4] == "I;16":
             im = hopper("I").convert(mode)
diff --git a/src/libImaging/Convert.c b/src/libImaging/Convert.c
index 5cc39cd0019..de94ed159f0 100644
--- a/src/libImaging/Convert.c
+++ b/src/libImaging/Convert.c
@@ -941,12 +941,14 @@ static struct {
     {"RGB", "1", rgb2bit},
     {"RGB", "L", rgb2l},
     {"RGB", "LA", rgb2la},
+    {"RGB", "La", rgb2la},
     {"RGB", "I", rgb2i},
     {"RGB", "F", rgb2f},
     {"RGB", "BGR;15", rgb2bgr15},
     {"RGB", "BGR;16", rgb2bgr16},
     {"RGB", "BGR;24", rgb2bgr24},
     {"RGB", "RGBA", rgb2rgba},
+    {"RGB", "RGBa", rgb2rgba},
     {"RGB", "RGBX", rgb2rgba},
     {"RGB", "CMYK", rgb2cmyk},
     {"RGB", "YCbCr", ImagingConvertRGB2YCbCr},

From a0388f2a67700ce0bee0a703d89771246b06e9b6 Mon Sep 17 00:00:00 2001
From: Andrew Murray <radarhere@users.noreply.github.com>
Date: Thu, 21 Mar 2024 11:44:03 +1100
Subject: [PATCH 0370/1178] Updated Ghostscript to 10.3.0

---
 .appveyor.yml                      | 2 +-
 .github/workflows/test-windows.yml | 2 +-
 2 files changed, 2 insertions(+), 2 deletions(-)

diff --git a/.appveyor.yml b/.appveyor.yml
index b0740b1ac6f..93ed3f2dfbe 100644
--- a/.appveyor.yml
+++ b/.appveyor.yml
@@ -27,7 +27,7 @@ install:
 - xcopy /S /Y c:\test-images-main\* c:\pillow\tests\images
 - curl -fsSL -o nasm-win64.zip https://raw.githubusercontent.com/python-pillow/pillow-depends/main/nasm-2.16.01-win64.zip
 - 7z x nasm-win64.zip -oc:\
-- choco install ghostscript --version=10.0.0.20230317
+- choco install ghostscript --version=10.3.0
 - path c:\nasm-2.16.01;C:\Program Files\gs\gs10.00.0\bin;%PATH%
 - cd c:\pillow\winbuild\
 - ps: |
diff --git a/.github/workflows/test-windows.yml b/.github/workflows/test-windows.yml
index 0ab8def3111..40994c60a8d 100644
--- a/.github/workflows/test-windows.yml
+++ b/.github/workflows/test-windows.yml
@@ -86,7 +86,7 @@ jobs:
         choco install nasm --no-progress
         echo "C:\Program Files\NASM" >> $env:GITHUB_PATH
 
-        choco install ghostscript --version=10.0.0.20230317 --no-progress
+        choco install ghostscript --version=10.3.0 --no-progress
         echo "C:\Program Files\gs\gs10.00.0\bin" >> $env:GITHUB_PATH
 
         # Install extra test images

From 8b6a182815060e41994c6d68e04f400a6f781b13 Mon Sep 17 00:00:00 2001
From: Andrew Murray <radarhere@users.noreply.github.com>
Date: Thu, 21 Mar 2024 16:25:40 +1100
Subject: [PATCH 0371/1178] Support conversion from RGB to RGBa

---
 Tests/test_image_convert.py |  4 ++++
 src/PIL/Image.py            |  2 +-
 src/libImaging/Convert.c    | 21 +++++++++++++--------
 3 files changed, 18 insertions(+), 9 deletions(-)

diff --git a/Tests/test_image_convert.py b/Tests/test_image_convert.py
index f154de123bb..569d06894bd 100644
--- a/Tests/test_image_convert.py
+++ b/Tests/test_image_convert.py
@@ -191,6 +191,10 @@ def test_trns_RGB(tmp_path: Path) -> None:
     assert "transparency" not in im_rgba.info
     im_rgba.save(f)
 
+    im_rgba = im.convert("RGBa")
+    assert "transparency" not in im_rgba.info
+    assert im_rgba.getpixel((0, 0)) == (0, 0, 0, 0)
+
     im_p = pytest.warns(UserWarning, im.convert, "P", palette=Image.Palette.ADAPTIVE)
     assert "transparency" not in im_p.info
     im_p.save(f)
diff --git a/src/PIL/Image.py b/src/PIL/Image.py
index ac3a533211b..c64a91eacc8 100644
--- a/src/PIL/Image.py
+++ b/src/PIL/Image.py
@@ -979,7 +979,7 @@ def convert_transparency(m, v):
         # transparency handling
         if has_transparency:
             if (self.mode in ("1", "L", "I", "I;16") and mode in ("LA", "RGBA")) or (
-                self.mode == "RGB" and mode == "RGBA"
+                self.mode == "RGB" and mode in ("RGBa", "RGBA")
             ):
                 # Use transparent conversion to promote from transparent
                 # color to an alpha channel.
diff --git a/src/libImaging/Convert.c b/src/libImaging/Convert.c
index 5cc39cd0019..db874e5bb7f 100644
--- a/src/libImaging/Convert.c
+++ b/src/libImaging/Convert.c
@@ -499,19 +499,19 @@ rgba2rgb_(UINT8 *out, const UINT8 *in, int xsize) {
 }
 
 /*
- * Conversion of RGB + single transparent color to RGBA,
- * where any pixel that matches the color will have the
- * alpha channel set to 0
+ * Conversion of RGB + single transparent color either to
+ * RGBA, where any pixel matching the color will have the alpha channel set to 0, or
+ * RGBa, where any pixel matching the color will have all channels set to 0
  */
 
 static void
-rgbT2rgba(UINT8 *out, int xsize, int r, int g, int b) {
+rgbT2rgba(UINT8 *out, int xsize, int r, int g, int b, int premultiplied) {
 #ifdef WORDS_BIGENDIAN
     UINT32 trns = ((r & 0xff) << 24) | ((g & 0xff) << 16) | ((b & 0xff) << 8) | 0xff;
-    UINT32 repl = trns & 0xffffff00;
+    UINT32 repl = premultiplied ? 0 : (trns & 0xffffff00);
 #else
     UINT32 trns = (0xffU << 24) | ((b & 0xff) << 16) | ((g & 0xff) << 8) | (r & 0xff);
-    UINT32 repl = trns & 0x00ffffff;
+    UINT32 repl = premultiplied ? 0 : (trns & 0x00ffffff);
 #endif
 
     int i;
@@ -947,6 +947,7 @@ static struct {
     {"RGB", "BGR;16", rgb2bgr16},
     {"RGB", "BGR;24", rgb2bgr24},
     {"RGB", "RGBA", rgb2rgba},
+    {"RGB", "RGBa", rgb2rgba},
     {"RGB", "RGBX", rgb2rgba},
     {"RGB", "CMYK", rgb2cmyk},
     {"RGB", "YCbCr", ImagingConvertRGB2YCbCr},
@@ -1681,14 +1682,18 @@ ImagingConvertTransparent(Imaging imIn, const char *mode, int r, int g, int b) {
     ImagingSectionCookie cookie;
     ImagingShuffler convert;
     Imaging imOut = NULL;
+    int premultiplied = 0;
     int y;
 
     if (!imIn) {
         return (Imaging)ImagingError_ModeError();
     }
 
-    if (strcmp(imIn->mode, "RGB") == 0 && strcmp(mode, "RGBA") == 0) {
+    if (strcmp(imIn->mode, "RGB") == 0 && (strcmp(mode, "RGBA") == 0 || strcmp(mode, "RGBa") == 0)) {
         convert = rgb2rgba;
+        if (strcmp(mode, "RGBa") == 0) {
+            premultiplied = 1;
+        }
     } else if ((strcmp(imIn->mode, "1") == 0 ||
                 strcmp(imIn->mode, "I") == 0 ||
                 strcmp(imIn->mode, "I;16") == 0 ||
@@ -1726,7 +1731,7 @@ ImagingConvertTransparent(Imaging imIn, const char *mode, int r, int g, int b) {
     ImagingSectionEnter(&cookie);
     for (y = 0; y < imIn->ysize; y++) {
         (*convert)((UINT8 *)imOut->image[y], (UINT8 *)imIn->image[y], imIn->xsize);
-        rgbT2rgba((UINT8 *)imOut->image[y], imIn->xsize, r, g, b);
+        rgbT2rgba((UINT8 *)imOut->image[y], imIn->xsize, r, g, b, premultiplied);
     }
     ImagingSectionLeave(&cookie);
 

From fd80b2e1d970e7ff115ce9a13b4311a7127c0da1 Mon Sep 17 00:00:00 2001
From: Andrew Murray <radarhere@users.noreply.github.com>
Date: Thu, 21 Mar 2024 18:46:09 +1100
Subject: [PATCH 0372/1178] Moved sample data inside test

---
 Tests/test_image.py | 8 ++------
 1 file changed, 2 insertions(+), 6 deletions(-)

diff --git a/Tests/test_image.py b/Tests/test_image.py
index 1c2b6d4b938..23f6b86deaa 100644
--- a/Tests/test_image.py
+++ b/Tests/test_image.py
@@ -1045,10 +1045,6 @@ def test_close_graceful(self, caplog: pytest.LogCaptureFixture) -> None:
 
 
 class TestImageBytes:
-    sample_bytes = bytes(
-        range(2 * 2 * max(pixelsize for mode, num_bands, pixelsize in image_modes))
-    )
-
     @pytest.mark.parametrize("mode", image_mode_names)
     def test_roundtrip_bytes_constructor(self, mode: str):
         source_image = hopper(mode)
@@ -1065,11 +1061,11 @@ def test_roundtrip_bytes_method(self, mode: str):
         assert copy_image.tobytes() == source_bytes
 
     @pytest.mark.parametrize(("mode", "num_bands", "pixelsize"), image_modes)
-    def test_pixels_after_getdata_putdata(
+    def test_getdata_putdata(
         self, mode: str, num_bands: int, pixelsize: int
     ):
         image_byte_size = 2 * 2 * pixelsize
-        start_bytes = self.sample_bytes[:image_byte_size]
+        start_bytes = bytes(range(image_byte_size))
         image = Image.frombytes(mode, (2, 2), start_bytes)
 
         start_pixels = (

From c3997050b02ddd552e0b01062ffa89131819aa0a Mon Sep 17 00:00:00 2001
From: Andrew Murray <radarhere@users.noreply.github.com>
Date: Thu, 21 Mar 2024 19:11:19 +1100
Subject: [PATCH 0373/1178] Simplified test using assert_image_equal

---
 Tests/test_image.py | 45 ++++++++++++++++-----------------------------
 1 file changed, 16 insertions(+), 29 deletions(-)

diff --git a/Tests/test_image.py b/Tests/test_image.py
index 23f6b86deaa..d1817d9bfaf 100644
--- a/Tests/test_image.py
+++ b/Tests/test_image.py
@@ -1047,44 +1047,31 @@ def test_close_graceful(self, caplog: pytest.LogCaptureFixture) -> None:
 class TestImageBytes:
     @pytest.mark.parametrize("mode", image_mode_names)
     def test_roundtrip_bytes_constructor(self, mode: str):
-        source_image = hopper(mode)
-        source_bytes = source_image.tobytes()
-        copy_image = Image.frombytes(mode, source_image.size, source_bytes)
-        assert copy_image.tobytes() == source_bytes
+        im = hopper(mode)
+        source_bytes = im.tobytes()
+
+        reloaded = Image.frombytes(mode, im.size, source_bytes)
+        assert reloaded.tobytes() == source_bytes
 
     @pytest.mark.parametrize("mode", image_mode_names)
     def test_roundtrip_bytes_method(self, mode: str):
-        source_image = hopper(mode)
-        source_bytes = source_image.tobytes()
-        copy_image = Image.new(mode, source_image.size)
-        copy_image.frombytes(source_bytes)
-        assert copy_image.tobytes() == source_bytes
+        im = hopper(mode)
+        source_bytes = im.tobytes()
+
+        reloaded = Image.new(mode, im.size)
+        reloaded.frombytes(source_bytes)
+        assert reloaded.tobytes() == source_bytes
 
     @pytest.mark.parametrize(("mode", "num_bands", "pixelsize"), image_modes)
     def test_getdata_putdata(
         self, mode: str, num_bands: int, pixelsize: int
     ):
-        image_byte_size = 2 * 2 * pixelsize
-        start_bytes = bytes(range(image_byte_size))
-        image = Image.frombytes(mode, (2, 2), start_bytes)
-
-        start_pixels = (
-            image.getpixel((0, 0)),
-            image.getpixel((0, 1)),
-            image.getpixel((1, 0)),
-            image.getpixel((1, 1)),
-        )
-
-        image.putdata(image.getdata())
-
-        end_pixels = (
-            image.getpixel((0, 0)),
-            image.getpixel((0, 1)),
-            image.getpixel((1, 0)),
-            image.getpixel((1, 1)),
-        )
+        start_bytes = bytes(range(2 * 2 * pixelsize))
+        im = Image.frombytes(mode, (2, 2), start_bytes)
 
-        assert start_pixels == end_pixels
+        reloaded = Image.new(mode, im.size)
+        reloaded.putdata(im.getdata())
+        assert_image_equal(im, reloaded)
 
 
 class MockEncoder(ImageFile.PyEncoder):

From 10ceae924c72e278d5d0393055e360c25f9a081d Mon Sep 17 00:00:00 2001
From: Andrew Murray <radarhere@users.noreply.github.com>
Date: Thu, 21 Mar 2024 18:52:55 +1100
Subject: [PATCH 0374/1178] Removed unused number of bands

---
 Tests/test_image.py | 56 ++++++++++++++++++++++-----------------------
 1 file changed, 27 insertions(+), 29 deletions(-)

diff --git a/Tests/test_image.py b/Tests/test_image.py
index d1817d9bfaf..44ff4527a80 100644
--- a/Tests/test_image.py
+++ b/Tests/test_image.py
@@ -33,34 +33,34 @@
     skip_unless_feature,
 )
 
-# name, number of bands, pixel size
+# name, pixel size
 image_modes = (
-    ("1", 1, 1),
-    ("L", 1, 1),
-    ("LA", 2, 4),
-    ("La", 2, 4),
-    ("P", 1, 1),
-    ("PA", 2, 4),
-    ("F", 1, 4),
-    ("I", 1, 4),
-    ("I;16", 1, 2),
-    ("I;16L", 1, 2),
-    ("I;16B", 1, 2),
-    ("I;16N", 1, 2),
-    ("RGB", 3, 4),
-    ("RGBA", 4, 4),
-    ("RGBa", 4, 4),
-    ("RGBX", 4, 4),
-    ("BGR;15", 3, 2),
-    ("BGR;16", 3, 2),
-    ("BGR;24", 3, 3),
-    ("CMYK", 4, 4),
-    ("YCbCr", 3, 4),
-    ("HSV", 3, 4),
-    ("LAB", 3, 4),
+    ("1", 1),
+    ("L", 1),
+    ("LA", 4),
+    ("La", 4),
+    ("P", 1),
+    ("PA", 4),
+    ("F", 4),
+    ("I", 4),
+    ("I;16", 2),
+    ("I;16L", 2),
+    ("I;16B", 2),
+    ("I;16N", 2),
+    ("RGB", 4),
+    ("RGBA", 4),
+    ("RGBa", 4),
+    ("RGBX", 4),
+    ("BGR;15", 2),
+    ("BGR;16", 2),
+    ("BGR;24", 3),
+    ("CMYK", 4),
+    ("YCbCr", 4),
+    ("HSV", 4),
+    ("LAB", 4),
 )
 
-image_mode_names = [name for name, _, _ in image_modes]
+image_mode_names = [name for name, _ in image_modes]
 
 
 class TestImage:
@@ -1062,10 +1062,8 @@ def test_roundtrip_bytes_method(self, mode: str):
         reloaded.frombytes(source_bytes)
         assert reloaded.tobytes() == source_bytes
 
-    @pytest.mark.parametrize(("mode", "num_bands", "pixelsize"), image_modes)
-    def test_getdata_putdata(
-        self, mode: str, num_bands: int, pixelsize: int
-    ):
+    @pytest.mark.parametrize(("mode", "pixelsize"), image_modes)
+    def test_getdata_putdata(self, mode: str, pixelsize: int):
         start_bytes = bytes(range(2 * 2 * pixelsize))
         im = Image.frombytes(mode, (2, 2), start_bytes)
 

From a0ab9f488febc1543b8000ee1395dd2cf6fdcd50 Mon Sep 17 00:00:00 2001
From: Andrew Murray <radarhere@users.noreply.github.com>
Date: Thu, 21 Mar 2024 19:12:48 +1100
Subject: [PATCH 0375/1178] Added type hints

---
 Tests/test_image.py | 6 +++---
 1 file changed, 3 insertions(+), 3 deletions(-)

diff --git a/Tests/test_image.py b/Tests/test_image.py
index 44ff4527a80..ab5ff640e8c 100644
--- a/Tests/test_image.py
+++ b/Tests/test_image.py
@@ -1046,7 +1046,7 @@ def test_close_graceful(self, caplog: pytest.LogCaptureFixture) -> None:
 
 class TestImageBytes:
     @pytest.mark.parametrize("mode", image_mode_names)
-    def test_roundtrip_bytes_constructor(self, mode: str):
+    def test_roundtrip_bytes_constructor(self, mode: str) -> None:
         im = hopper(mode)
         source_bytes = im.tobytes()
 
@@ -1054,7 +1054,7 @@ def test_roundtrip_bytes_constructor(self, mode: str):
         assert reloaded.tobytes() == source_bytes
 
     @pytest.mark.parametrize("mode", image_mode_names)
-    def test_roundtrip_bytes_method(self, mode: str):
+    def test_roundtrip_bytes_method(self, mode: str) -> None:
         im = hopper(mode)
         source_bytes = im.tobytes()
 
@@ -1063,7 +1063,7 @@ def test_roundtrip_bytes_method(self, mode: str):
         assert reloaded.tobytes() == source_bytes
 
     @pytest.mark.parametrize(("mode", "pixelsize"), image_modes)
-    def test_getdata_putdata(self, mode: str, pixelsize: int):
+    def test_getdata_putdata(self, mode: str, pixelsize: int) -> None:
         start_bytes = bytes(range(2 * 2 * pixelsize))
         im = Image.frombytes(mode, (2, 2), start_bytes)
 

From 9c41bf4641effc9d1a3aa229489449cb761f8958 Mon Sep 17 00:00:00 2001
From: Andrew Murray <radarhere@users.noreply.github.com>
Date: Thu, 21 Mar 2024 19:16:06 +1100
Subject: [PATCH 0376/1178] Only specify image size once

---
 Tests/test_image.py | 5 +++--
 1 file changed, 3 insertions(+), 2 deletions(-)

diff --git a/Tests/test_image.py b/Tests/test_image.py
index ab5ff640e8c..941ec40d9bc 100644
--- a/Tests/test_image.py
+++ b/Tests/test_image.py
@@ -1064,8 +1064,9 @@ def test_roundtrip_bytes_method(self, mode: str) -> None:
 
     @pytest.mark.parametrize(("mode", "pixelsize"), image_modes)
     def test_getdata_putdata(self, mode: str, pixelsize: int) -> None:
-        start_bytes = bytes(range(2 * 2 * pixelsize))
-        im = Image.frombytes(mode, (2, 2), start_bytes)
+        im = Image.new(mode, (2, 2))
+        source_bytes = bytes(range(im.width * im.height * pixelsize))
+        im.frombytes(source_bytes)
 
         reloaded = Image.new(mode, im.size)
         reloaded.putdata(im.getdata())

From 171e497e05518491c6e1505a71326440851335a0 Mon Sep 17 00:00:00 2001
From: Andrew Murray <radarhere@users.noreply.github.com>
Date: Fri, 22 Mar 2024 17:36:04 +1100
Subject: [PATCH 0377/1178] Raise ValueError if kmeans is negative

---
 Tests/test_image_quantize.py | 9 +++++++++
 src/PIL/Image.py             | 6 +++++-
 src/libImaging/Quant.c       | 4 ++--
 3 files changed, 16 insertions(+), 3 deletions(-)

diff --git a/Tests/test_image_quantize.py b/Tests/test_image_quantize.py
index 873a9bb5dcb..da736d6ede1 100644
--- a/Tests/test_image_quantize.py
+++ b/Tests/test_image_quantize.py
@@ -94,6 +94,15 @@ def test_quantize_dither_diff() -> None:
     assert dither.tobytes() != nodither.tobytes()
 
 
+@pytest.mark.parametrize(
+    "method", (Image.Quantize.MEDIANCUT, Image.Quantize.MAXCOVERAGE)
+)
+def test_quantize_kmeans(method) -> None:
+    im = hopper()
+    with pytest.raises(ValueError):
+        im.quantize(kmeans=-1, method=method)
+
+
 def test_colors() -> None:
     im = hopper()
     colors = 2
diff --git a/src/PIL/Image.py b/src/PIL/Image.py
index ac3a533211b..59c5c36f3b6 100644
--- a/src/PIL/Image.py
+++ b/src/PIL/Image.py
@@ -1141,7 +1141,7 @@ def quantize(
                        The exception to this is RGBA images. :data:`Quantize.MEDIANCUT`
                        and :data:`Quantize.MAXCOVERAGE` do not support RGBA images, so
                        :data:`Quantize.FASTOCTREE` is used by default instead.
-        :param kmeans: Integer
+        :param kmeans: Integer greater than or equal to zero.
         :param palette: Quantize to the palette of given
                         :py:class:`PIL.Image.Image`.
         :param dither: Dithering method, used when converting from
@@ -1184,6 +1184,10 @@ def quantize(
             new_im.palette = palette.palette.copy()
             return new_im
 
+        if kmeans < 0:
+            msg = "kmeans must not be negative"
+            raise ValueError(msg)
+
         im = self._new(self.im.quantize(colors, method, kmeans))
 
         from . import ImagePalette
diff --git a/src/libImaging/Quant.c b/src/libImaging/Quant.c
index 398fbf6db57..2582830c4a4 100644
--- a/src/libImaging/Quant.c
+++ b/src/libImaging/Quant.c
@@ -1471,7 +1471,7 @@ quantize(
     fflush(stdout);
     timer = clock();
 #endif
-    if (kmeans) {
+    if (kmeans > 0) {
         k_means(pixelData, nPixels, p, nPaletteEntries, qp, kmeans - 1);
     }
 #ifndef NO_OUTPUT
@@ -1627,7 +1627,7 @@ quantize2(
             pixelData, nPixels, p, nQuantPixels, avgDist, avgDistSortKey, qp)) {
         goto error_4;
     }
-    if (kmeans) {
+    if (kmeans > 0) {
         k_means(pixelData, nPixels, p, nQuantPixels, qp, kmeans - 1);
     }
 

From 3004c46683db95ccfaeb02ecf64ee92b4356dcca Mon Sep 17 00:00:00 2001
From: Andrew Murray <radarhere@users.noreply.github.com>
Date: Fri, 22 Mar 2024 23:43:55 +1100
Subject: [PATCH 0378/1178] Block saving TIFF tag OSUBFILETYPE using libtiff

---
 Tests/test_file_libtiff.py | 8 +++++++-
 src/PIL/TiffImagePlugin.py | 3 +++
 2 files changed, 10 insertions(+), 1 deletion(-)

diff --git a/Tests/test_file_libtiff.py b/Tests/test_file_libtiff.py
index 908464a11b7..14504e58999 100644
--- a/Tests/test_file_libtiff.py
+++ b/Tests/test_file_libtiff.py
@@ -12,7 +12,7 @@
 import pytest
 
 from PIL import Image, ImageFilter, ImageOps, TiffImagePlugin, TiffTags, features
-from PIL.TiffImagePlugin import SAMPLEFORMAT, STRIPOFFSETS, SUBIFD
+from PIL.TiffImagePlugin import OSUBFILETYPE, SAMPLEFORMAT, STRIPOFFSETS, SUBIFD
 
 from .helper import (
     assert_image_equal,
@@ -325,6 +325,12 @@ def check_tags(
             )
         TiffImagePlugin.WRITE_LIBTIFF = False
 
+    def test_osubfiletype(self, tmp_path: Path) -> None:
+        outfile = str(tmp_path / "temp.tif")
+        with Image.open("Tests/images/g4_orientation_6.tif") as im:
+            im.tag_v2[OSUBFILETYPE] = 1
+            im.save(outfile)
+
     def test_subifd(self, tmp_path: Path) -> None:
         outfile = str(tmp_path / "temp.tif")
         with Image.open("Tests/images/g4_orientation_6.tif") as im:
diff --git a/src/PIL/TiffImagePlugin.py b/src/PIL/TiffImagePlugin.py
index b59139f5858..bcb3547eb8e 100644
--- a/src/PIL/TiffImagePlugin.py
+++ b/src/PIL/TiffImagePlugin.py
@@ -74,6 +74,7 @@
 # Read TIFF files
 
 # a few tag names, just to make the code below a bit more readable
+OSUBFILETYPE = 255
 IMAGEWIDTH = 256
 IMAGELENGTH = 257
 BITSPERSAMPLE = 258
@@ -1784,11 +1785,13 @@ def _save(im, fp, filename):
         types = {}
         # STRIPOFFSETS and STRIPBYTECOUNTS are added by the library
         # based on the data in the strip.
+        # OSUBFILETYPE is deprecated.
         # The other tags expect arrays with a certain length (fixed or depending on
         # BITSPERSAMPLE, etc), passing arrays with a different length will result in
         # segfaults. Block these tags until we add extra validation.
         # SUBIFD may also cause a segfault.
         blocklist += [
+            OSUBFILETYPE,
             REFERENCEBLACKWHITE,
             STRIPBYTECOUNTS,
             STRIPOFFSETS,

From 47040c7b35b1fa616035a26784ebb2fc1abef343 Mon Sep 17 00:00:00 2001
From: Andrew Murray <radarhere@users.noreply.github.com>
Date: Fri, 22 Mar 2024 23:53:07 +1100
Subject: [PATCH 0379/1178] Test positive and zero kmeans

---
 Tests/test_image_quantize.py | 4 ++++
 1 file changed, 4 insertions(+)

diff --git a/Tests/test_image_quantize.py b/Tests/test_image_quantize.py
index da736d6ede1..e1aa6252b7a 100644
--- a/Tests/test_image_quantize.py
+++ b/Tests/test_image_quantize.py
@@ -99,6 +99,10 @@ def test_quantize_dither_diff() -> None:
 )
 def test_quantize_kmeans(method) -> None:
     im = hopper()
+    no_kmeans = im.quantize(kmeans=0, method=method)
+    kmeans = im.quantize(kmeans=1, method=method)
+    assert kmeans.tobytes() != no_kmeans.tobytes()
+
     with pytest.raises(ValueError):
         im.quantize(kmeans=-1, method=method)
 

From e320bdc1cd4101d03f1c0a8d8cf159d085a3280b Mon Sep 17 00:00:00 2001
From: Andrew Murray <radarhere@users.noreply.github.com>
Date: Sat, 23 Mar 2024 09:17:16 +1100
Subject: [PATCH 0380/1178] Update CHANGES.rst [ci skip]

---
 CHANGES.rst | 15 +++++++++++++++
 1 file changed, 15 insertions(+)

diff --git a/CHANGES.rst b/CHANGES.rst
index 663a6af7c5c..49f17db1fd2 100644
--- a/CHANGES.rst
+++ b/CHANGES.rst
@@ -5,6 +5,21 @@ Changelog (Pillow)
 10.3.0 (unreleased)
 -------------------
 
+- Raise ValueError if kmeans is negative #7891
+  [radarhere]
+
+- Remove TIFF tag OSUBFILETYPE when saving using libtiff #7893
+  [radarhere]
+
+- Raise ValueError for negative values when loading P1-P3 PPM images #7882
+  [radarhere]
+
+- Added reading of JPEG2000 palettes #7870
+  [radarhere]
+
+- Added alpha_quality argument when saving WebP images #7872
+  [radarhere]
+
 - Fixed joined corners for ImageDraw rounded_rectangle() non-integer dimensions #7881
   [radarhere]
 

From 4197263dff19a79f13cd86f6cdc9a0ec6c06da92 Mon Sep 17 00:00:00 2001
From: "Jeffrey A. Clark (Alex)" <aclark@aclark.net>
Date: Sat, 23 Mar 2024 09:40:39 -0400
Subject: [PATCH 0381/1178] Clean up authors and contributors

- `s/Jeffrey A. Clark (Alex)/Jeffrey A. Clark/g`. People can figure out that I am Alex.
- We've added "contributors" to Fredrik's copyright statements because it seems appropriate that it be there based on: https://github.com/python-pillow/Pillow/blob/main/CHANGES.rst#02b5-117.
- Fredrik is the PIL author and I am the Pillow author.
- Consistently apply all of the above everywhere.
---
 LICENSE             | 4 ++--
 README.md           | 4 ++--
 docs/COPYING        | 4 ++--
 docs/conf.py        | 8 ++++----
 docs/index.rst      | 2 +-
 pyproject.toml      | 2 +-
 src/PIL/__init__.py | 2 +-
 7 files changed, 13 insertions(+), 13 deletions(-)

diff --git a/LICENSE b/LICENSE
index 0069eb5bcec..7990a6e57dc 100644
--- a/LICENSE
+++ b/LICENSE
@@ -1,11 +1,11 @@
 The Python Imaging Library (PIL) is
 
     Copyright © 1997-2011 by Secret Labs AB
-    Copyright © 1995-2011 by Fredrik Lundh
+    Copyright © 1995-2011 by Fredrik Lundh and contributors
 
 Pillow is the friendly PIL fork. It is
 
-    Copyright © 2010-2024 by Jeffrey A. Clark (Alex) and contributors.
+    Copyright © 2010-2024 by Jeffrey A. Clark and contributors
 
 Like PIL, Pillow is licensed under the open source HPND License:
 
diff --git a/README.md b/README.md
index f142ef56302..823ea76d0c5 100644
--- a/README.md
+++ b/README.md
@@ -6,9 +6,9 @@
 
 ## Python Imaging Library (Fork)
 
-Pillow is the friendly PIL fork by [Jeffrey A. Clark (Alex) and
+Pillow is the friendly PIL fork by [Jeffrey A. Clark and
 contributors](https://github.com/python-pillow/Pillow/graphs/contributors).
-PIL is the Python Imaging Library by Fredrik Lundh and Contributors.
+PIL is the Python Imaging Library by Fredrik Lundh and contributors.
 As of 2019, Pillow development is
 [supported by Tidelift](https://tidelift.com/subscription/pkg/pypi-pillow?utm_source=pypi-pillow&utm_medium=readme&utm_campaign=enterprise).
 
diff --git a/docs/COPYING b/docs/COPYING
index 73af6d99c0f..d5ee19f81a6 100644
--- a/docs/COPYING
+++ b/docs/COPYING
@@ -1,11 +1,11 @@
 The Python Imaging Library (PIL) is
 
     Copyright © 1997-2011 by Secret Labs AB
-    Copyright © 1995-2011 by Fredrik Lundh
+    Copyright © 1995-2011 by Fredrik Lundh and contributors
 
 Pillow is the friendly PIL fork. It is
 
-    Copyright © 2010-2024 by Jeffrey A. Clark (Alex) and contributors
+    Copyright © 2010-2024 by Jeffrey A. Clark and contributors
 
 Like PIL, Pillow is licensed under the open source PIL
 Software License:
diff --git a/docs/conf.py b/docs/conf.py
index 97289c91d0c..ebb64680301 100644
--- a/docs/conf.py
+++ b/docs/conf.py
@@ -54,9 +54,9 @@
 # General information about the project.
 project = "Pillow (PIL Fork)"
 copyright = (
-    "1995-2011 Fredrik Lundh, 2010-2024 Jeffrey A. Clark (Alex) and contributors"
+    "1995-2011 Fredrik Lundh and contributors, 2010-2024 Jeffrey A. Clark and contributors."
 )
-author = "Fredrik Lundh, Jeffrey A. Clark (Alex), contributors"
+author = "Fredrik Lundh (PIL), Jeffrey A. Clark (Pillow)"
 
 # The version info for the project you're documenting, acts as replacement for
 # |version| and |release|, also used in various other places throughout the
@@ -252,7 +252,7 @@
         master_doc,
         "PillowPILFork.tex",
         "Pillow (PIL Fork) Documentation",
-        "Jeffrey A. Clark (Alex)",
+        "Jeffrey A. Clark",
         "manual",
     )
 ]
@@ -302,7 +302,7 @@
         "Pillow (PIL Fork) Documentation",
         author,
         "PillowPILFork",
-        "Pillow is the friendly PIL fork by Jeffrey A. Clark (Alex) and contributors.",
+        "Pillow is the friendly PIL fork by Jeffrey A. Clark and contributors.",
         "Miscellaneous",
     )
 ]
diff --git a/docs/index.rst b/docs/index.rst
index 1ed9266eb8e..3a12953f08b 100644
--- a/docs/index.rst
+++ b/docs/index.rst
@@ -1,7 +1,7 @@
 Pillow
 ======
 
-Pillow is the friendly PIL fork by `Jeffrey A. Clark (Alex) and contributors <https://github.com/python-pillow/Pillow/graphs/contributors>`_. PIL is the Python Imaging Library by Fredrik Lundh and contributors.
+Pillow is the friendly PIL fork by `Jeffrey A. Clark and contributors <https://github.com/python-pillow/Pillow/graphs/contributors>`_. PIL is the Python Imaging Library by Fredrik Lundh and contributors.
 
 Pillow for enterprise is available via the Tidelift Subscription. `Learn more <https://tidelift.com/subscription/pkg/pypi-pillow?utm_source=pypi-pillow&utm_medium=docs&utm_campaign=enterprise>`_.
 
diff --git a/pyproject.toml b/pyproject.toml
index 518facc34f7..29b784db7d1 100644
--- a/pyproject.toml
+++ b/pyproject.toml
@@ -15,7 +15,7 @@ keywords = [
   "Imaging",
 ]
 license = {text = "HPND"}
-authors = [{name = "Jeffrey A. Clark (Alex)", email = "aclark@aclark.net"}]
+authors = [{name = "Jeffrey A. Clark", email = "aclark@aclark.net"}]
 requires-python = ">=3.8"
 classifiers = [
   "Development Status :: 6 - Mature",
diff --git a/src/PIL/__init__.py b/src/PIL/__init__.py
index 63a45769ba6..09546fe6333 100644
--- a/src/PIL/__init__.py
+++ b/src/PIL/__init__.py
@@ -1,6 +1,6 @@
 """Pillow (Fork of the Python Imaging Library)
 
-Pillow is the friendly PIL fork by Jeffrey A. Clark (Alex) and contributors.
+Pillow is the friendly PIL fork by Jeffrey A. Clark and contributors.
     https://github.com/python-pillow/Pillow/
 
 Pillow is forked from PIL 1.1.7.

From 66ef6ad9ac65f528bdb7a9e6745bb93154f8b928 Mon Sep 17 00:00:00 2001
From: "pre-commit-ci[bot]"
 <66853113+pre-commit-ci[bot]@users.noreply.github.com>
Date: Sat, 23 Mar 2024 13:49:17 +0000
Subject: [PATCH 0382/1178] [pre-commit.ci] auto fixes from pre-commit.com
 hooks

for more information, see https://pre-commit.ci
---
 docs/conf.py | 4 +---
 1 file changed, 1 insertion(+), 3 deletions(-)

diff --git a/docs/conf.py b/docs/conf.py
index ebb64680301..1312cac6121 100644
--- a/docs/conf.py
+++ b/docs/conf.py
@@ -53,9 +53,7 @@
 
 # General information about the project.
 project = "Pillow (PIL Fork)"
-copyright = (
-    "1995-2011 Fredrik Lundh and contributors, 2010-2024 Jeffrey A. Clark and contributors."
-)
+copyright = "1995-2011 Fredrik Lundh and contributors, 2010-2024 Jeffrey A. Clark and contributors."
 author = "Fredrik Lundh (PIL), Jeffrey A. Clark (Pillow)"
 
 # The version info for the project you're documenting, acts as replacement for

From 9fc3fa82082e13089548446a6f8a9566553e15ea Mon Sep 17 00:00:00 2001
From: Hugo van Kemenade <1324225+hugovk@users.noreply.github.com>
Date: Sun, 4 Feb 2024 18:49:05 +0200
Subject: [PATCH 0383/1178] Add PYI (flake8-pyi) to Ruff

---
 pyproject.toml | 1 +
 1 file changed, 1 insertion(+)

diff --git a/pyproject.toml b/pyproject.toml
index 518facc34f7..d1d9c82e40e 100644
--- a/pyproject.toml
+++ b/pyproject.toml
@@ -106,6 +106,7 @@ select = [
   "ISC", # flake8-implicit-str-concat
   "LOG", # flake8-logging
   "PGH", # pygrep-hooks
+  "PYI", # flake8-pyi
   "RUF100", # unused noqa (yesqa)
   "UP", # pyupgrade
   "W", # pycodestyle warnings

From 41ffc1de81e3dcf1b82c249421ada77e60622afe Mon Sep 17 00:00:00 2001
From: Hugo van Kemenade <1324225+hugovk@users.noreply.github.com>
Date: Sun, 4 Feb 2024 18:49:46 +0200
Subject: [PATCH 0384/1178] Fix: PYI044 'from __future__ import annotations'
 has no effect in stub files, since type checkers automatically treat stubs as
 having those semantics

---
 src/PIL/_imagingcms.pyi   | 2 --
 src/PIL/_imagingft.pyi    | 2 --
 src/PIL/_imagingmath.pyi  | 2 --
 src/PIL/_imagingmorph.pyi | 2 --
 4 files changed, 8 deletions(-)

diff --git a/src/PIL/_imagingcms.pyi b/src/PIL/_imagingcms.pyi
index b0235555dc5..e27843e5338 100644
--- a/src/PIL/_imagingcms.pyi
+++ b/src/PIL/_imagingcms.pyi
@@ -1,5 +1,3 @@
-from __future__ import annotations
-
 from typing import Any
 
 def __getattr__(name: str) -> Any: ...
diff --git a/src/PIL/_imagingft.pyi b/src/PIL/_imagingft.pyi
index b0235555dc5..e27843e5338 100644
--- a/src/PIL/_imagingft.pyi
+++ b/src/PIL/_imagingft.pyi
@@ -1,5 +1,3 @@
-from __future__ import annotations
-
 from typing import Any
 
 def __getattr__(name: str) -> Any: ...
diff --git a/src/PIL/_imagingmath.pyi b/src/PIL/_imagingmath.pyi
index b0235555dc5..e27843e5338 100644
--- a/src/PIL/_imagingmath.pyi
+++ b/src/PIL/_imagingmath.pyi
@@ -1,5 +1,3 @@
-from __future__ import annotations
-
 from typing import Any
 
 def __getattr__(name: str) -> Any: ...
diff --git a/src/PIL/_imagingmorph.pyi b/src/PIL/_imagingmorph.pyi
index b0235555dc5..e27843e5338 100644
--- a/src/PIL/_imagingmorph.pyi
+++ b/src/PIL/_imagingmorph.pyi
@@ -1,5 +1,3 @@
-from __future__ import annotations
-
 from typing import Any
 
 def __getattr__(name: str) -> Any: ...

From 5d37d028d31dc6aea6ee64c61c9870df94d75040 Mon Sep 17 00:00:00 2001
From: Hugo van Kemenade <1324225+hugovk@users.noreply.github.com>
Date: Sat, 23 Mar 2024 20:44:43 +0200
Subject: [PATCH 0385/1178] Fix: PYI044 'from __future__ import annotations'
 has no effect in stub files, since type checkers automatically treat stubs as
 having those semantics

---
 src/PIL/_imaging.pyi | 2 --
 src/PIL/_webp.pyi    | 2 --
 2 files changed, 4 deletions(-)

diff --git a/src/PIL/_imaging.pyi b/src/PIL/_imaging.pyi
index b0235555dc5..e27843e5338 100644
--- a/src/PIL/_imaging.pyi
+++ b/src/PIL/_imaging.pyi
@@ -1,5 +1,3 @@
-from __future__ import annotations
-
 from typing import Any
 
 def __getattr__(name: str) -> Any: ...
diff --git a/src/PIL/_webp.pyi b/src/PIL/_webp.pyi
index b0235555dc5..e27843e5338 100644
--- a/src/PIL/_webp.pyi
+++ b/src/PIL/_webp.pyi
@@ -1,5 +1,3 @@
-from __future__ import annotations
-
 from typing import Any
 
 def __getattr__(name: str) -> Any: ...

From 6ed952b510f256f76ddaf7b43855a85a3e83ca15 Mon Sep 17 00:00:00 2001
From: Hugo van Kemenade <1324225+hugovk@users.noreply.github.com>
Date: Sat, 23 Mar 2024 20:48:46 +0200
Subject: [PATCH 0386/1178] Fix: PYI024 Use typing.NamedTuple instead of
 collections.namedtuple

---
 Tests/test_file_libtiff.py | 46 +++++++++++++++++++++-----------------
 src/PIL/PdfParser.py       | 11 +++++----
 src/PIL/TiffTags.py        | 12 ++++++++--
 3 files changed, 42 insertions(+), 27 deletions(-)

diff --git a/Tests/test_file_libtiff.py b/Tests/test_file_libtiff.py
index 14504e58999..6c32b5ad427 100644
--- a/Tests/test_file_libtiff.py
+++ b/Tests/test_file_libtiff.py
@@ -6,8 +6,8 @@
 import os
 import re
 import sys
-from collections import namedtuple
 from pathlib import Path
+from typing import Any, NamedTuple
 
 import pytest
 
@@ -243,36 +243,40 @@ def test_additional_metadata(self, tmp_path: Path) -> None:
         TiffImagePlugin.WRITE_LIBTIFF = False
 
     def test_custom_metadata(self, tmp_path: Path) -> None:
-        tc = namedtuple("tc", "value,type,supported_by_default")
+        class Tc(NamedTuple):
+            value: Any
+            type: int
+            supported_by_default: bool
+
         custom = {
             37000 + k: v
             for k, v in enumerate(
                 [
-                    tc(4, TiffTags.SHORT, True),
-                    tc(123456789, TiffTags.LONG, True),
-                    tc(-4, TiffTags.SIGNED_BYTE, False),
-                    tc(-4, TiffTags.SIGNED_SHORT, False),
-                    tc(-123456789, TiffTags.SIGNED_LONG, False),
-                    tc(TiffImagePlugin.IFDRational(4, 7), TiffTags.RATIONAL, True),
-                    tc(4.25, TiffTags.FLOAT, True),
-                    tc(4.25, TiffTags.DOUBLE, True),
-                    tc("custom tag value", TiffTags.ASCII, True),
-                    tc(b"custom tag value", TiffTags.BYTE, True),
-                    tc((4, 5, 6), TiffTags.SHORT, True),
-                    tc((123456789, 9, 34, 234, 219387, 92432323), TiffTags.LONG, True),
-                    tc((-4, 9, 10), TiffTags.SIGNED_BYTE, False),
-                    tc((-4, 5, 6), TiffTags.SIGNED_SHORT, False),
-                    tc(
+                    Tc(4, TiffTags.SHORT, True),
+                    Tc(123456789, TiffTags.LONG, True),
+                    Tc(-4, TiffTags.SIGNED_BYTE, False),
+                    Tc(-4, TiffTags.SIGNED_SHORT, False),
+                    Tc(-123456789, TiffTags.SIGNED_LONG, False),
+                    Tc(TiffImagePlugin.IFDRational(4, 7), TiffTags.RATIONAL, True),
+                    Tc(4.25, TiffTags.FLOAT, True),
+                    Tc(4.25, TiffTags.DOUBLE, True),
+                    Tc("custom tag value", TiffTags.ASCII, True),
+                    Tc(b"custom tag value", TiffTags.BYTE, True),
+                    Tc((4, 5, 6), TiffTags.SHORT, True),
+                    Tc((123456789, 9, 34, 234, 219387, 92432323), TiffTags.LONG, True),
+                    Tc((-4, 9, 10), TiffTags.SIGNED_BYTE, False),
+                    Tc((-4, 5, 6), TiffTags.SIGNED_SHORT, False),
+                    Tc(
                         (-123456789, 9, 34, 234, 219387, -92432323),
                         TiffTags.SIGNED_LONG,
                         False,
                     ),
-                    tc((4.25, 5.25), TiffTags.FLOAT, True),
-                    tc((4.25, 5.25), TiffTags.DOUBLE, True),
+                    Tc((4.25, 5.25), TiffTags.FLOAT, True),
+                    Tc((4.25, 5.25), TiffTags.DOUBLE, True),
                     # array of TIFF_BYTE requires bytes instead of tuple for backwards
                     # compatibility
-                    tc(bytes([4]), TiffTags.BYTE, True),
-                    tc(bytes((4, 9, 10)), TiffTags.BYTE, True),
+                    Tc(bytes([4]), TiffTags.BYTE, True),
+                    Tc(bytes((4, 9, 10)), TiffTags.BYTE, True),
                 ]
             )
         }
diff --git a/src/PIL/PdfParser.py b/src/PIL/PdfParser.py
index 4c510173814..2542d4e9127 100644
--- a/src/PIL/PdfParser.py
+++ b/src/PIL/PdfParser.py
@@ -8,7 +8,7 @@
 import re
 import time
 import zlib
-from typing import TYPE_CHECKING, Any, List, Union
+from typing import TYPE_CHECKING, Any, List, NamedTuple, Union
 
 
 # see 7.9.2.2 Text String Type on page 86 and D.3 PDFDocEncoding Character Set
@@ -81,9 +81,12 @@ def check_format_condition(condition, error_message):
         raise PdfFormatError(error_message)
 
 
-class IndirectReference(
-    collections.namedtuple("IndirectReferenceTuple", ["object_id", "generation"])
-):
+class IndirectReferenceTuple(NamedTuple):
+    object_id: int
+    generation: int
+
+
+class IndirectReference(IndirectReferenceTuple):
     def __str__(self):
         return f"{self.object_id} {self.generation} R"
 
diff --git a/src/PIL/TiffTags.py b/src/PIL/TiffTags.py
index b9419393119..3f2220c2ae9 100644
--- a/src/PIL/TiffTags.py
+++ b/src/PIL/TiffTags.py
@@ -18,10 +18,18 @@
 ##
 from __future__ import annotations
 
-from collections import namedtuple
+from typing import NamedTuple
 
 
-class TagInfo(namedtuple("_TagInfo", "value name type length enum")):
+class _TagInfo(NamedTuple):
+    value: int
+    name: str
+    type: int
+    length: int
+    enum: dict[int, str]
+
+
+class TagInfo(_TagInfo):
     __slots__: list[str] = []
 
     def __new__(cls, value=None, name="unknown", type=None, length=None, enum=None):

From 20d8095439c858f9e460c44e476f4e9dc8064ef2 Mon Sep 17 00:00:00 2001
From: Hugo van Kemenade <1324225+hugovk@users.noreply.github.com>
Date: Sat, 23 Mar 2024 20:49:43 +0200
Subject: [PATCH 0387/1178] Fix: PYI041 Use float instead of int | float

---
 Tests/test_lib_pack.py | 4 ++--
 1 file changed, 2 insertions(+), 2 deletions(-)

diff --git a/Tests/test_lib_pack.py b/Tests/test_lib_pack.py
index 629a6dc7a87..6a0e704b89a 100644
--- a/Tests/test_lib_pack.py
+++ b/Tests/test_lib_pack.py
@@ -15,7 +15,7 @@ def assert_pack(
         mode: str,
         rawmode: str,
         data: int | bytes,
-        *pixels: int | float | tuple[int, ...],
+        *pixels: float | tuple[int, ...],
     ) -> None:
         """
         data - either raw bytes with data or just number of bytes in rawmode.
@@ -239,7 +239,7 @@ def assert_unpack(
         mode: str,
         rawmode: str,
         data: int | bytes,
-        *pixels: int | float | tuple[int, ...],
+        *pixels: float | tuple[int, ...],
     ) -> None:
         """
         data - either raw bytes with data or just number of bytes in rawmode.

From eff78cb514f41ca5ee91ae56da3fe44f570b9a87 Mon Sep 17 00:00:00 2001
From: Hugo van Kemenade <1324225+hugovk@users.noreply.github.com>
Date: Sat, 23 Mar 2024 20:52:32 +0200
Subject: [PATCH 0388/1178] Skip PYI034 as typing.Self is in Python 3.10+

---
 pyproject.toml | 1 +
 1 file changed, 1 insertion(+)

diff --git a/pyproject.toml b/pyproject.toml
index d1d9c82e40e..2ef3fb2d1fd 100644
--- a/pyproject.toml
+++ b/pyproject.toml
@@ -117,6 +117,7 @@ ignore = [
   "E221", # Multiple spaces before operator
   "E226", # Missing whitespace around arithmetic operator
   "E241", # Multiple spaces after ','
+  "PYI034", # flake8-pyi: typing.Self added in Python 3.10
 ]
 
 [tool.ruff.lint.per-file-ignores]

From 567ee6bdaa5d9f9bf12d0445573d758ab505b11a Mon Sep 17 00:00:00 2001
From: "Jeffrey A. Clark" <aclark@aclark.net>
Date: Sat, 23 Mar 2024 17:50:41 -0400
Subject: [PATCH 0389/1178] Update docs/conf.py

Co-authored-by: Hugo van Kemenade <1324225+hugovk@users.noreply.github.com>
---
 docs/conf.py | 5 ++++-
 1 file changed, 4 insertions(+), 1 deletion(-)

diff --git a/docs/conf.py b/docs/conf.py
index 1312cac6121..882e076685c 100644
--- a/docs/conf.py
+++ b/docs/conf.py
@@ -53,7 +53,10 @@
 
 # General information about the project.
 project = "Pillow (PIL Fork)"
-copyright = "1995-2011 Fredrik Lundh and contributors, 2010-2024 Jeffrey A. Clark and contributors."
+copyright = (
+    "1995-2011 Fredrik Lundh and contributors, "
+    "2010-2024 Jeffrey A. Clark and contributors."
+)
 author = "Fredrik Lundh (PIL), Jeffrey A. Clark (Pillow)"
 
 # The version info for the project you're documenting, acts as replacement for

From ce060a8e8bc7714220f5747d70de9b3ab55b34e6 Mon Sep 17 00:00:00 2001
From: scaramallion <scaramallion@users.noreply.github.com>
Date: Sun, 24 Mar 2024 15:40:11 +1100
Subject: [PATCH 0390/1178] Fix 9-bit JPEG 2000 images not using I;16

---
 Tests/images/9bit.j2k        | Bin 0 -> 9412 bytes
 Tests/test_file_jpeg2k.py    |   6 ++++++
 src/PIL/Jpeg2KImagePlugin.py |   2 +-
 3 files changed, 7 insertions(+), 1 deletion(-)
 create mode 100644 Tests/images/9bit.j2k

diff --git a/Tests/images/9bit.j2k b/Tests/images/9bit.j2k
new file mode 100644
index 0000000000000000000000000000000000000000..174f565fc64f2791a9b4aef3cc09240b402ddafe
GIT binary patch
literal 9412
zcmV;#Bs<&xPybN>DF6Tf004jh004jh0000000000004jh004jh00000000000SEyB
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
K5ZOQ9|JeY1bRdfW

literal 0
HcmV?d00001

diff --git a/Tests/test_file_jpeg2k.py b/Tests/test_file_jpeg2k.py
index bd114aa1181..00eeb0cf9cc 100644
--- a/Tests/test_file_jpeg2k.py
+++ b/Tests/test_file_jpeg2k.py
@@ -446,3 +446,9 @@ def test_plt_marker() -> None:
         hdr = out.read(2)
         length = _binary.i16be(hdr)
         out.seek(length - 2, os.SEEK_CUR)
+
+def test_9bit():
+    # Test 9-bit images are decoded to I;16
+    with Image.open("Tests/images/9bit.j2k") as im:
+        assert im.mode == "I;16"
+        assert im.size == (128, 128)
diff --git a/src/PIL/Jpeg2KImagePlugin.py b/src/PIL/Jpeg2KImagePlugin.py
index 27f8fbbd0b5..925a9148cf3 100644
--- a/src/PIL/Jpeg2KImagePlugin.py
+++ b/src/PIL/Jpeg2KImagePlugin.py
@@ -114,7 +114,7 @@ def _parse_codestream(fp):
 
     size = (xsiz - xosiz, ysiz - yosiz)
     if csiz == 1:
-        if (yrsiz[0] & 0x7F) > 8:
+        if (yrsiz[0] & 0x7F) + 1 > 8:
             mode = "I;16"
         else:
             mode = "L"

From 901c13c4b195f2e03a8779fe8d54e0e00551b579 Mon Sep 17 00:00:00 2001
From: "pre-commit-ci[bot]"
 <66853113+pre-commit-ci[bot]@users.noreply.github.com>
Date: Sun, 24 Mar 2024 04:47:24 +0000
Subject: [PATCH 0391/1178] [pre-commit.ci] auto fixes from pre-commit.com
 hooks

for more information, see https://pre-commit.ci
---
 Tests/test_file_jpeg2k.py | 1 +
 1 file changed, 1 insertion(+)

diff --git a/Tests/test_file_jpeg2k.py b/Tests/test_file_jpeg2k.py
index 00eeb0cf9cc..ecdda104ad0 100644
--- a/Tests/test_file_jpeg2k.py
+++ b/Tests/test_file_jpeg2k.py
@@ -447,6 +447,7 @@ def test_plt_marker() -> None:
         length = _binary.i16be(hdr)
         out.seek(length - 2, os.SEEK_CUR)
 
+
 def test_9bit():
     # Test 9-bit images are decoded to I;16
     with Image.open("Tests/images/9bit.j2k") as im:

From 0248e418008673f36bfdc2f4e830a4214ddf1bca Mon Sep 17 00:00:00 2001
From: Andrew Murray <radarhere@users.noreply.github.com>
Date: Mon, 25 Mar 2024 10:02:19 +1100
Subject: [PATCH 0392/1178] Added release notes for #7891

---
 docs/releasenotes/10.3.0.rst | 7 ++++---
 1 file changed, 4 insertions(+), 3 deletions(-)

diff --git a/docs/releasenotes/10.3.0.rst b/docs/releasenotes/10.3.0.rst
index b5dbf16d4cb..29ff6ffb798 100644
--- a/docs/releasenotes/10.3.0.rst
+++ b/docs/releasenotes/10.3.0.rst
@@ -61,10 +61,11 @@ Deprecated                                    Use instead
 API Changes
 ===========
 
-TODO
-^^^^
+Negative kmeans error
+^^^^^^^^^^^^^^^^^^^^^
 
-TODO
+When calling :py:meth:`~PIL.Image.Image.quantize`, a negative ``kmeans`` will now
+raise a :py:exc:`ValueError`, unless a palette is supplied to make the value redundant.
 
 API Additions
 =============

From d7dba1cc67869381a77ebe4df846d2deaa281186 Mon Sep 17 00:00:00 2001
From: Andrew Murray <radarhere@users.noreply.github.com>
Date: Mon, 25 Mar 2024 10:04:02 +1100
Subject: [PATCH 0393/1178] Added release notes for #7882

---
 docs/releasenotes/10.3.0.rst | 6 ++++++
 1 file changed, 6 insertions(+)

diff --git a/docs/releasenotes/10.3.0.rst b/docs/releasenotes/10.3.0.rst
index 29ff6ffb798..b6df3182560 100644
--- a/docs/releasenotes/10.3.0.rst
+++ b/docs/releasenotes/10.3.0.rst
@@ -67,6 +67,12 @@ Negative kmeans error
 When calling :py:meth:`~PIL.Image.Image.quantize`, a negative ``kmeans`` will now
 raise a :py:exc:`ValueError`, unless a palette is supplied to make the value redundant.
 
+Negative P1-P3 PPM value error
+^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
+
+If a P1-P3 PPM image contains a negative value, a :py:exc:`ValueError` will now be
+raised.
+
 API Additions
 =============
 

From 38f919379612746c81258a6d8ca4ef06276f9963 Mon Sep 17 00:00:00 2001
From: Andrew Murray <radarhere@users.noreply.github.com>
Date: Mon, 25 Mar 2024 10:35:00 +1100
Subject: [PATCH 0394/1178] Added release notes for #7872

---
 docs/releasenotes/10.3.0.rst | 7 +++++++
 1 file changed, 7 insertions(+)

diff --git a/docs/releasenotes/10.3.0.rst b/docs/releasenotes/10.3.0.rst
index b6df3182560..446ad211de5 100644
--- a/docs/releasenotes/10.3.0.rst
+++ b/docs/releasenotes/10.3.0.rst
@@ -61,6 +61,13 @@ Deprecated                                    Use instead
 API Changes
 ===========
 
+Added alpha_quality argument when saving WebP images
+^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
+
+When saving WebP images, an ``alpha_quality`` argument can be passed to the encoder. It
+is an integer value between 0 to 100, where values other than 100 will provide lossy
+compression.
+
 Negative kmeans error
 ^^^^^^^^^^^^^^^^^^^^^
 

From 1f182ce8da03b375986c6bdf78f1337e3872bd0b Mon Sep 17 00:00:00 2001
From: scaramallion <scaramallion@users.noreply.github.com>
Date: Mon, 25 Mar 2024 17:39:21 +1100
Subject: [PATCH 0395/1178] Fix parsing the J2K header

---
 src/PIL/Jpeg2KImagePlugin.py | 4 ++--
 1 file changed, 2 insertions(+), 2 deletions(-)

diff --git a/src/PIL/Jpeg2KImagePlugin.py b/src/PIL/Jpeg2KImagePlugin.py
index 925a9148cf3..d5734feac51 100644
--- a/src/PIL/Jpeg2KImagePlugin.py
+++ b/src/PIL/Jpeg2KImagePlugin.py
@@ -110,11 +110,11 @@ def _parse_codestream(fp):
     xrsiz = [None] * csiz
     yrsiz = [None] * csiz
     for i in range(csiz):
-        ssiz[i], xrsiz[i], yrsiz[i] = struct.unpack_from(">BBB", siz, 36 + 3 * i)
+        ssiz[i], xrsiz[i], yrsiz[i] = struct.unpack_from(">BBB", siz, 38 + 3 * i)
 
     size = (xsiz - xosiz, ysiz - yosiz)
     if csiz == 1:
-        if (yrsiz[0] & 0x7F) + 1 > 8:
+        if (ssiz[0] & 0x7F) + 1 > 8:
             mode = "I;16"
         else:
             mode = "L"

From 0f49eaf23041e7b27c3a7b8d3b62433b2178fa08 Mon Sep 17 00:00:00 2001
From: Andrew Murray <radarhere@users.noreply.github.com>
Date: Mon, 25 Mar 2024 18:23:52 +1100
Subject: [PATCH 0396/1178] Simplified code

---
 src/PIL/Jpeg2KImagePlugin.py | 6 +-----
 1 file changed, 1 insertion(+), 5 deletions(-)

diff --git a/src/PIL/Jpeg2KImagePlugin.py b/src/PIL/Jpeg2KImagePlugin.py
index d5734feac51..be000c351b6 100644
--- a/src/PIL/Jpeg2KImagePlugin.py
+++ b/src/PIL/Jpeg2KImagePlugin.py
@@ -106,14 +106,10 @@ def _parse_codestream(fp):
     lsiz, rsiz, xsiz, ysiz, xosiz, yosiz, _, _, _, _, csiz = struct.unpack_from(
         ">HHIIIIIIIIH", siz
     )
-    ssiz = [None] * csiz
-    xrsiz = [None] * csiz
-    yrsiz = [None] * csiz
-    for i in range(csiz):
-        ssiz[i], xrsiz[i], yrsiz[i] = struct.unpack_from(">BBB", siz, 38 + 3 * i)
 
     size = (xsiz - xosiz, ysiz - yosiz)
     if csiz == 1:
+        ssiz = struct.unpack_from(">B", siz, 38)
         if (ssiz[0] & 0x7F) + 1 > 8:
             mode = "I;16"
         else:

From 7ca9bddf938537c4f4621e80c9212456b83be414 Mon Sep 17 00:00:00 2001
From: scaramallion <scaramallion@users.noreply.github.com>
Date: Mon, 25 Mar 2024 20:13:45 +1100
Subject: [PATCH 0397/1178] Update Tests/test_file_jpeg2k.py

Co-authored-by: Andrew Murray <3112309+radarhere@users.noreply.github.com>
---
 Tests/test_file_jpeg2k.py | 1 -
 1 file changed, 1 deletion(-)

diff --git a/Tests/test_file_jpeg2k.py b/Tests/test_file_jpeg2k.py
index ecdda104ad0..81f75cc72cf 100644
--- a/Tests/test_file_jpeg2k.py
+++ b/Tests/test_file_jpeg2k.py
@@ -449,7 +449,6 @@ def test_plt_marker() -> None:
 
 
 def test_9bit():
-    # Test 9-bit images are decoded to I;16
     with Image.open("Tests/images/9bit.j2k") as im:
         assert im.mode == "I;16"
         assert im.size == (128, 128)

From 58c4c757a2e969f52d23586e731571887cad2db0 Mon Sep 17 00:00:00 2001
From: Andrew Murray <radarhere@users.noreply.github.com>
Date: Mon, 25 Mar 2024 21:06:10 +1100
Subject: [PATCH 0398/1178] Update CHANGES.rst [ci skip]

---
 CHANGES.rst | 3 +++
 1 file changed, 3 insertions(+)

diff --git a/CHANGES.rst b/CHANGES.rst
index 49f17db1fd2..64f41a6a3ed 100644
--- a/CHANGES.rst
+++ b/CHANGES.rst
@@ -5,6 +5,9 @@ Changelog (Pillow)
 10.3.0 (unreleased)
 -------------------
 
+- Use I;16 mode for 9-bit JPEG 2000 images #7900
+  [scaramallion, radarhere]
+
 - Raise ValueError if kmeans is negative #7891
   [radarhere]
 

From fb84c546b78cb3ea7fe0e5c50648712ce129dde1 Mon Sep 17 00:00:00 2001
From: Andrew Murray <radarhere@users.noreply.github.com>
Date: Tue, 26 Mar 2024 06:00:03 +1100
Subject: [PATCH 0399/1178] Removed references to the "current version"

---
 docs/handbook/image-file-formats.rst |  5 ++---
 docs/reference/ImageFilter.rst       |  3 +--
 docs/reference/ImagePath.rst         |  4 ++--
 src/PIL/Image.py                     | 19 ++++++++-----------
 src/PIL/ImageFilter.py               |  7 +++----
 src/_imagingcms.c                    |  2 +-
 6 files changed, 17 insertions(+), 23 deletions(-)

diff --git a/docs/handbook/image-file-formats.rst b/docs/handbook/image-file-formats.rst
index 54f983b69c8..b49a41a0ec9 100644
--- a/docs/handbook/image-file-formats.rst
+++ b/docs/handbook/image-file-formats.rst
@@ -1355,9 +1355,8 @@ The :py:meth:`~PIL.Image.open` method sets the following
 FPX
 ^^^
 
-Pillow reads Kodak FlashPix files. In the current version, only the highest
-resolution image is read from the file, and the viewing transform is not taken
-into account.
+Pillow reads Kodak FlashPix files. Only the highest resolution image is read from the
+file, and the viewing transform is not taken into account.
 
 To enable FPX support, you must install :pypi:`olefile`.
 
diff --git a/docs/reference/ImageFilter.rst b/docs/reference/ImageFilter.rst
index 044aede6264..5f2b6af7c10 100644
--- a/docs/reference/ImageFilter.rst
+++ b/docs/reference/ImageFilter.rst
@@ -23,8 +23,7 @@ Example: Filter an image
 Filters
 -------
 
-The current version of the library provides the following set of predefined
-image enhancement filters:
+Pillow provides the following set of predefined image enhancement filters:
 
 * **BLUR**
 * **CONTOUR**
diff --git a/docs/reference/ImagePath.rst b/docs/reference/ImagePath.rst
index 500096ef7dc..23544b613a0 100644
--- a/docs/reference/ImagePath.rst
+++ b/docs/reference/ImagePath.rst
@@ -21,8 +21,8 @@ vector data. Path objects can be passed to the methods on the
 
     The path object implements most parts of the Python sequence interface, and
     behaves like a list of (x, y) pairs. You can use len(), item access, and
-    slicing as usual. However, the current version does not support slice
-    assignment, or item and slice deletion.
+    slicing as usual. However, this does not support slice assignment, or item
+    and slice deletion.
 
     :param xy: A sequence. The sequence can contain 2-tuples [(x, y), ...]
                or a flat list of numbers [x, y, ...].
diff --git a/src/PIL/Image.py b/src/PIL/Image.py
index 59c5c36f3b6..24fc94de93e 100644
--- a/src/PIL/Image.py
+++ b/src/PIL/Image.py
@@ -894,9 +894,8 @@ def convert(
         omitted, a mode is chosen so that all information in the image
         and the palette can be represented without a palette.
 
-        The current version supports all possible conversions between
-        "L", "RGB" and "CMYK". The ``matrix`` argument only supports "L"
-        and "RGB".
+        This supports all possible conversions between "L", "RGB" and "CMYK". The
+        ``matrix`` argument only supports "L" and "RGB".
 
         When translating a color image to grayscale (mode "L"),
         the library uses the ITU-R 601-2 luma transform::
@@ -1824,9 +1823,8 @@ def point(self, lut, mode: str | None = None) -> Image:
                class Example(Image.ImagePointHandler):
                  def point(self, data):
                    # Return result
-        :param mode: Output mode (default is same as input).  In the
-           current version, this can only be used if the source image
-           has mode "L" or "P", and the output has mode "1" or the
+        :param mode: Output mode (default is same as input). This can only be used if
+           the source image has mode "L" or "P", and the output has mode "1" or the
            source image mode is "I" and the output mode is "L".
         :returns: An :py:class:`~PIL.Image.Image` object.
         """
@@ -3020,11 +3018,10 @@ def frombuffer(mode, size, data, decoder_name="raw", *args):
     If you have an entire image file in a string, wrap it in a
     :py:class:`~io.BytesIO` object, and use :py:func:`~PIL.Image.open` to load it.
 
-    In the current version, the default parameters used for the "raw" decoder
-    differs from that used for :py:func:`~PIL.Image.frombytes`.  This is a
-    bug, and will probably be fixed in a future release.  The current release
-    issues a warning if you do this; to disable the warning, you should provide
-    the full set of parameters.  See below for details.
+    The default parameters used for the "raw" decoder differs from that used for
+    :py:func:`~PIL.Image.frombytes`. This is a bug, and will probably be fixed in a
+    future release. The current release issues a warning if you do this; to disable
+    the warning, you should provide the full set of parameters. See below for details.
 
     :param mode: The image mode. See: :ref:`concept-modes`.
     :param size: The image size.
diff --git a/src/PIL/ImageFilter.py b/src/PIL/ImageFilter.py
index 035b83c4d77..a6dab3f20fd 100644
--- a/src/PIL/ImageFilter.py
+++ b/src/PIL/ImageFilter.py
@@ -37,11 +37,10 @@ def filter(self, image):
 
 class Kernel(BuiltinFilter):
     """
-    Create a convolution kernel. The current version only
-    supports 3x3 and 5x5 integer and floating point kernels.
+    Create a convolution kernel. This only supports 3x3 and 5x5 integer and floating
+    point kernels.
 
-    In the current version, kernels can only be applied to
-    "L" and "RGB" images.
+    Kernels can only be applied to "L" and "RGB" images.
 
     :param size: Kernel size, given as (width, height). In the current
                     version, this must be (3,3) or (5,5).
diff --git a/src/_imagingcms.c b/src/_imagingcms.c
index 56d5d73f83c..c7728770a3e 100644
--- a/src/_imagingcms.c
+++ b/src/_imagingcms.c
@@ -52,7 +52,7 @@ kevin@cazabon.com\n\
 
 */
 
-/* known to-do list with current version:
+/* known to-do list:
 
    Verify that PILmode->littleCMStype conversion in findLCMStype is correct for all
    PIL modes (it probably isn't for the more obscure ones)

From 9d101bffebcf2dbaf37e79461019d9505f1d907c Mon Sep 17 00:00:00 2001
From: Andrew Murray <3112309+radarhere@users.noreply.github.com>
Date: Tue, 26 Mar 2024 06:07:39 +1100
Subject: [PATCH 0400/1178] Removed reference to "current version"

Co-authored-by: Hugo van Kemenade <1324225+hugovk@users.noreply.github.com>
---
 src/PIL/ImageFilter.py | 4 ++--
 1 file changed, 2 insertions(+), 2 deletions(-)

diff --git a/src/PIL/ImageFilter.py b/src/PIL/ImageFilter.py
index a6dab3f20fd..2ae5b8a1ac2 100644
--- a/src/PIL/ImageFilter.py
+++ b/src/PIL/ImageFilter.py
@@ -42,8 +42,8 @@ class Kernel(BuiltinFilter):
 
     Kernels can only be applied to "L" and "RGB" images.
 
-    :param size: Kernel size, given as (width, height). In the current
-                    version, this must be (3,3) or (5,5).
+    :param size: Kernel size, given as (width, height).
+                    This must be (3,3) or (5,5).
     :param kernel: A sequence containing kernel weights. The kernel will
                    be flipped vertically before being applied to the image.
     :param scale: Scale factor. If given, the result for each pixel is

From 2c6258bee5fd178bd129833c831c9883b097bf28 Mon Sep 17 00:00:00 2001
From: Andrew Murray <radarhere@users.noreply.github.com>
Date: Tue, 26 Mar 2024 06:08:10 +1100
Subject: [PATCH 0401/1178] Updated indents

---
 src/PIL/ImageFilter.py | 16 +++++++---------
 1 file changed, 7 insertions(+), 9 deletions(-)

diff --git a/src/PIL/ImageFilter.py b/src/PIL/ImageFilter.py
index 2ae5b8a1ac2..b2c4950d6a9 100644
--- a/src/PIL/ImageFilter.py
+++ b/src/PIL/ImageFilter.py
@@ -42,15 +42,13 @@ class Kernel(BuiltinFilter):
 
     Kernels can only be applied to "L" and "RGB" images.
 
-    :param size: Kernel size, given as (width, height).
-                    This must be (3,3) or (5,5).
-    :param kernel: A sequence containing kernel weights. The kernel will
-                   be flipped vertically before being applied to the image.
-    :param scale: Scale factor. If given, the result for each pixel is
-                    divided by this value. The default is the sum of the
-                    kernel weights.
-    :param offset: Offset. If given, this value is added to the result,
-                    after it has been divided by the scale factor.
+    :param size: Kernel size, given as (width, height). This must be (3,3) or (5,5).
+    :param kernel: A sequence containing kernel weights. The kernel will be flipped
+                   vertically before being applied to the image.
+    :param scale: Scale factor. If given, the result for each pixel is divided by this
+                  value. The default is the sum of the kernel weights.
+    :param offset: Offset. If given, this value is added to the result, after it has
+                   been divided by the scale factor.
     """
 
     name = "Kernel"

From ab8f465f1acccf58d4a7840e1ec2666e870f4914 Mon Sep 17 00:00:00 2001
From: Andrew Murray <radarhere@users.noreply.github.com>
Date: Tue, 26 Mar 2024 19:55:22 +1100
Subject: [PATCH 0402/1178] Use transparency info when converting from RGB to
 LA

---
 Tests/test_image_convert.py |  4 ++++
 src/PIL/Image.py            |  2 +-
 src/libImaging/Convert.c    | 19 ++++++++++++++-----
 3 files changed, 19 insertions(+), 6 deletions(-)

diff --git a/Tests/test_image_convert.py b/Tests/test_image_convert.py
index 569d06894bd..77ce4e7d52a 100644
--- a/Tests/test_image_convert.py
+++ b/Tests/test_image_convert.py
@@ -183,6 +183,10 @@ def test_trns_RGB(tmp_path: Path) -> None:
     assert im_l.info["transparency"] == im_l.getpixel((0, 0))  # undone
     im_l.save(f)
 
+    im_la = im.convert("LA")
+    assert "transparency" not in im_la.info
+    im_la.save(f)
+
     im_p = im.convert("P")
     assert "transparency" in im_p.info
     im_p.save(f)
diff --git a/src/PIL/Image.py b/src/PIL/Image.py
index c64a91eacc8..11a3459ed58 100644
--- a/src/PIL/Image.py
+++ b/src/PIL/Image.py
@@ -979,7 +979,7 @@ def convert_transparency(m, v):
         # transparency handling
         if has_transparency:
             if (self.mode in ("1", "L", "I", "I;16") and mode in ("LA", "RGBA")) or (
-                self.mode == "RGB" and mode in ("RGBa", "RGBA")
+                self.mode == "RGB" and mode in ("LA", "RGBa", "RGBA")
             ):
                 # Use transparent conversion to promote from transparent
                 # color to an alpha channel.
diff --git a/src/libImaging/Convert.c b/src/libImaging/Convert.c
index db874e5bb7f..4db9eb7007e 100644
--- a/src/libImaging/Convert.c
+++ b/src/libImaging/Convert.c
@@ -500,12 +500,12 @@ rgba2rgb_(UINT8 *out, const UINT8 *in, int xsize) {
 
 /*
  * Conversion of RGB + single transparent color either to
- * RGBA, where any pixel matching the color will have the alpha channel set to 0, or
+ * RGBA or LA, where any pixel matching the color will have the alpha channel set to 0, or
  * RGBa, where any pixel matching the color will have all channels set to 0
  */
 
 static void
-rgbT2rgba(UINT8 *out, int xsize, int r, int g, int b, int premultiplied) {
+rgbT2a(UINT8 *out, UINT8 *in, int xsize, int r, int g, int b, int premultiplied) {
 #ifdef WORDS_BIGENDIAN
     UINT32 trns = ((r & 0xff) << 24) | ((g & 0xff) << 16) | ((b & 0xff) << 8) | 0xff;
     UINT32 repl = premultiplied ? 0 : (trns & 0xffffff00);
@@ -516,9 +516,10 @@ rgbT2rgba(UINT8 *out, int xsize, int r, int g, int b, int premultiplied) {
 
     int i;
 
-    for (i = 0; i < xsize; i++, out += sizeof(trns)) {
+    UINT8 *ref = in != NULL ? in : out;
+    for (i = 0; i < xsize; i++, ref += sizeof(trns), out += sizeof(trns)) {
         UINT32 v;
-        memcpy(&v, out, sizeof(v));
+        memcpy(&v, ref, sizeof(v));
         if (v == trns) {
             memcpy(out, &repl, sizeof(repl));
         }
@@ -1683,6 +1684,9 @@ ImagingConvertTransparent(Imaging imIn, const char *mode, int r, int g, int b) {
     ImagingShuffler convert;
     Imaging imOut = NULL;
     int premultiplied = 0;
+    // If the transparency matches pixels in the source image, not the converted image
+    UINT8 *source;
+    int source_transparency = 0;
     int y;
 
     if (!imIn) {
@@ -1694,6 +1698,9 @@ ImagingConvertTransparent(Imaging imIn, const char *mode, int r, int g, int b) {
         if (strcmp(mode, "RGBa") == 0) {
             premultiplied = 1;
         }
+    } else if (strcmp(imIn->mode, "RGB") == 0 && strcmp(mode, "LA") == 0) {
+        convert = rgb2la;
+        source_transparency = 1;
     } else if ((strcmp(imIn->mode, "1") == 0 ||
                 strcmp(imIn->mode, "I") == 0 ||
                 strcmp(imIn->mode, "I;16") == 0 ||
@@ -1731,7 +1738,9 @@ ImagingConvertTransparent(Imaging imIn, const char *mode, int r, int g, int b) {
     ImagingSectionEnter(&cookie);
     for (y = 0; y < imIn->ysize; y++) {
         (*convert)((UINT8 *)imOut->image[y], (UINT8 *)imIn->image[y], imIn->xsize);
-        rgbT2rgba((UINT8 *)imOut->image[y], imIn->xsize, r, g, b, premultiplied);
+
+        source = source_transparency ? (UINT8 *)imIn->image[y] : NULL;
+        rgbT2a((UINT8 *)imOut->image[y], source, imIn->xsize, r, g, b, premultiplied);
     }
     ImagingSectionLeave(&cookie);
 

From e79d1746f29412c069d30770d86616aa3dafb1d4 Mon Sep 17 00:00:00 2001
From: Andrew Murray <radarhere@users.noreply.github.com>
Date: Tue, 26 Mar 2024 19:57:17 +1100
Subject: [PATCH 0403/1178] Support conversion from RGB to La

---
 Tests/test_image_convert.py | 4 ++++
 src/PIL/Image.py            | 2 +-
 src/libImaging/Convert.c    | 8 ++++++--
 3 files changed, 11 insertions(+), 3 deletions(-)

diff --git a/Tests/test_image_convert.py b/Tests/test_image_convert.py
index 77ce4e7d52a..2fb45854adf 100644
--- a/Tests/test_image_convert.py
+++ b/Tests/test_image_convert.py
@@ -187,6 +187,10 @@ def test_trns_RGB(tmp_path: Path) -> None:
     assert "transparency" not in im_la.info
     im_la.save(f)
 
+    im_la = im.convert("La")
+    assert "transparency" not in im_la.info
+    assert im_la.getpixel((0, 0)) == (0, 0)
+
     im_p = im.convert("P")
     assert "transparency" in im_p.info
     im_p.save(f)
diff --git a/src/PIL/Image.py b/src/PIL/Image.py
index 11a3459ed58..5c2309ac3f2 100644
--- a/src/PIL/Image.py
+++ b/src/PIL/Image.py
@@ -979,7 +979,7 @@ def convert_transparency(m, v):
         # transparency handling
         if has_transparency:
             if (self.mode in ("1", "L", "I", "I;16") and mode in ("LA", "RGBA")) or (
-                self.mode == "RGB" and mode in ("LA", "RGBa", "RGBA")
+                self.mode == "RGB" and mode in ("La", "LA", "RGBa", "RGBA")
             ):
                 # Use transparent conversion to promote from transparent
                 # color to an alpha channel.
diff --git a/src/libImaging/Convert.c b/src/libImaging/Convert.c
index 4db9eb7007e..0b84aa1ba73 100644
--- a/src/libImaging/Convert.c
+++ b/src/libImaging/Convert.c
@@ -501,7 +501,7 @@ rgba2rgb_(UINT8 *out, const UINT8 *in, int xsize) {
 /*
  * Conversion of RGB + single transparent color either to
  * RGBA or LA, where any pixel matching the color will have the alpha channel set to 0, or
- * RGBa, where any pixel matching the color will have all channels set to 0
+ * RGBa or La, where any pixel matching the color will have all channels set to 0
  */
 
 static void
@@ -942,6 +942,7 @@ static struct {
     {"RGB", "1", rgb2bit},
     {"RGB", "L", rgb2l},
     {"RGB", "LA", rgb2la},
+    {"RGB", "La", rgb2la},
     {"RGB", "I", rgb2i},
     {"RGB", "F", rgb2f},
     {"RGB", "BGR;15", rgb2bgr15},
@@ -1698,9 +1699,12 @@ ImagingConvertTransparent(Imaging imIn, const char *mode, int r, int g, int b) {
         if (strcmp(mode, "RGBa") == 0) {
             premultiplied = 1;
         }
-    } else if (strcmp(imIn->mode, "RGB") == 0 && strcmp(mode, "LA") == 0) {
+    } else if (strcmp(imIn->mode, "RGB") == 0 && (strcmp(mode, "LA") == 0 || strcmp(mode, "La") == 0)) {
         convert = rgb2la;
         source_transparency = 1;
+        if (strcmp(mode, "La") == 0) {
+            premultiplied = 1;
+        }
     } else if ((strcmp(imIn->mode, "1") == 0 ||
                 strcmp(imIn->mode, "I") == 0 ||
                 strcmp(imIn->mode, "I;16") == 0 ||

From 984480fd1913ff7e6350197f7f71f2f3045b6449 Mon Sep 17 00:00:00 2001
From: Andrew Murray <radarhere@users.noreply.github.com>
Date: Tue, 26 Mar 2024 20:17:06 +1100
Subject: [PATCH 0404/1178] Updated xorgproto to 2024.1

---
 .github/workflows/wheels-dependencies.sh | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/.github/workflows/wheels-dependencies.sh b/.github/workflows/wheels-dependencies.sh
index 78600c6ed14..797f4613ae7 100755
--- a/.github/workflows/wheels-dependencies.sh
+++ b/.github/workflows/wheels-dependencies.sh
@@ -72,7 +72,7 @@ function build {
 
     build_simple xcb-proto 1.16.0 https://xorg.freedesktop.org/archive/individual/proto
     if [ -n "$IS_MACOS" ]; then
-        build_simple xorgproto 2023.2 https://www.x.org/pub/individual/proto
+        build_simple xorgproto 2024.1 https://www.x.org/pub/individual/proto
         build_simple libXau 1.0.11 https://www.x.org/pub/individual/lib
         build_simple libpthread-stubs 0.5 https://xcb.freedesktop.org/dist
         if [[ "$CIBW_ARCHS" == "arm64" ]]; then

From 142473c7b43a72b5dba534a26cb614b5b207ada5 Mon Sep 17 00:00:00 2001
From: Andrew Murray <radarhere@users.noreply.github.com>
Date: Tue, 26 Mar 2024 21:29:25 +1100
Subject: [PATCH 0405/1178] Support GZIP_1 compression

---
 Tests/images/m13.fits                | Bin 0 -> 184320 bytes
 Tests/images/m13_gzip.fits           | 366 +++++++++++++++++++++++++++
 Tests/test_file_fits.py              |   7 +-
 docs/handbook/image-file-formats.rst |   3 +-
 src/PIL/FitsImagePlugin.py           |  94 ++++++-
 5 files changed, 458 insertions(+), 12 deletions(-)
 create mode 100644 Tests/images/m13.fits
 create mode 100644 Tests/images/m13_gzip.fits

diff --git a/Tests/images/m13.fits b/Tests/images/m13.fits
new file mode 100644
index 0000000000000000000000000000000000000000..1f2f82a4f18e809fcad980498cb2f3b126903a37
GIT binary patch
literal 184320
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
X?w|bkNeO&X0-uz?CnfOzr3C&r4ZA<1

literal 0
HcmV?d00001

diff --git a/Tests/images/m13_gzip.fits b/Tests/images/m13_gzip.fits
new file mode 100644
index 00000000000..cf7acea4eac
--- /dev/null
+++ b/Tests/images/m13_gzip.fits
@@ -0,0 +1,366 @@
+SIMPLE  =                    T / file does conform to FITS standard             BITPIX  =                   16 / number of bits per data pixel                  NAXIS   =                    0 / number of data axes                            EXTEND  =                    T / FITS dataset may contain extensions            COMMENT   FITS (Flexible Image Transport System) format is defined in 'AstronomyCOMMENT   and Astrophysics', volume 376, page 359; bibcode: 2001A&A...376..359H CHECKSUM= '0aE73a960aC60a96'   / HDU checksum updated 2006-11-15T17:28:30       DATASUM = '         0'         / data unit checksum updated 2006-11-15T17:28:30 END                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                             XTENSION= 'BINTABLE'           / binary table extension                         BITPIX  =                    8 / 8-bit bytes                                    NAXIS   =                    2 / 2-dimensional binary table                     NAXIS1  =                    8 / width of table in bytes                        NAXIS2  =                  300 / number of rows in table                        PCOUNT  =               111820 / size of special data area                      GCOUNT  =                    1 / one data group (required keyword)              TFIELDS =                    1 / number of fields in each row                   TTYPE1  = 'COMPRESSED_DATA'    / label for field   1                            TFORM1  = '1PB(506)'           / data format of field: variable length array    ZIMAGE  =                    T / extension contains compressed image            ZTILE1  =                  300 / size of tiles to be compressed                 ZTILE2  =                    1 / size of tiles to be compressed                 ZCMPTYPE= 'GZIP_1  '           / compression algorithm                          EXTNAME = 'COMPRESSED_IMAGE'                                                    ZSIMPLE =                    T / file does conform to FITS standard             ZBITPIX =                   16 / number of bits per data pixel                  ZNAXIS  =                    2 / number of data axes                            ZNAXIS1 =                  300 / length of data axis 1                          ZNAXIS2 =                  300 / length of data axis 2                          ZEXTEND =                    T / FITS dataset may contain extensions            COMMENT   FITS (Flexible Image Transport System) format is defined in 'AstronomyCOMMENT   and Astrophysics', volume 376, page 359; bibcode: 2001A&A...376..359H COMMENT                                                                         COMMENT This file was produced by the SkyView survey analysis system from       COMMENT available astronomical surveys.  The data are formatted                 COMMENT as a simple two-dimensional FITS image with the same units as           COMMENT the orginal survey.                                                     CTYPE1  = 'RA---TAN'           / X-axis type                                    CTYPE2  = 'DEC--TAN'           / Y-axis type                                    CRVAL1  =             250.4226 / Reference pixel value                          CRVAL2  =              36.4602 / Reference pixel value                          CRPIX1  =              150.500 / Reference pixel                                CRPIX2  =              150.500 / Reference pixel                                CDELT1  =       -0.00027770002 / Degrees/pixel                                  CDELT2  =        0.00027770002 / Degrees/pixel                                  CROTA1  =              0.00000 / Rotation in degrees.                           EQUINOX =              2000.00 /Equinox of coordinates                          ZHECKSUM= '2f4R3c4O2c4O2c4O'   / HDU checksum updated 2006-11-15T17:18:55       ZDATASUM= '1803906202'         / data unit checksum updated 2006-11-15T17:18:55 CHECKSUM= 'CeA6FZ03Cd73CZ73'   / HDU checksum updated 2006-11-15T17:28:30       DATASUM = '3567348586'         / data unit checksum updated 2006-11-15T17:28:30 END                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                             
"
/
"
6Q
O�
S�
P)
Sy
K�
7
+
-N
{

�
�
�
�
�
&
)2
&[
/�
�
�
�
*�
*'
,Q
}
"�
 �
-!�
;#	
9$D
6%}
8&�
-'�
)
*-
+?
 ,]
$-}
.�
/�
0�
1�
3
 4*
5J
?6g
Q7�
p8�
e:g
i;�
g=5
H>�
8?�
A
"B5
BCW
YD�
iE�
G[
zH�
iJT
hK�
nM%
rN�
fP
aQk
jR�
{T6
�U�
�W3
�X�
rZ?
_[�
m]
o^}
}_�
�ai
~b�
�do
�e�
�g�
�i
lj�
nl
�mv
�n�
�p�
�ri
�t*
�u�
�w�
�y"
�z�
}|<
�}�
�Q
���
��w
��
���
��<
���
���
��C
���
���
��9
���
��v
��
���
���
��H
��)
���
���
���
��o
��
���
���
���
��
��W
��!
���
���
���
��g
��G
��!
���
���
���
�ù
�ū
�ǒ
��x
��b
��:
��
���
���
�Խ
�֚
��z
��Q
��#
��
���
��
��q
��
���
��
��O
��
���
��
��
��
���
��}
��g
��X
��?
��
�
�
�
�
�
�
�
q
�
>
�

+
�
�
�

�
�
c
�

�
�
�
�
�
l
�

�
�
�
�
�
A
�
�
�
 �
�
"6
�
#�
�
%p
�
'0
�
(�
�
*�
�
,
�
..
�
/�
�
1J
�
2�
�
4c
�
6
�
7�
�
9�
�
;m
�
=+
�
>�
l
@f
l
A�
o
C>
q
D�
z
F
�
G�
�
I!
z
J�
k
L"
{
M�
f
O
q
Pn
t
Q�
n
SS
o
T�
�
V0
�
W�
�
YJ
�
Z�
�
\p
�
]�
�
_�
x
a
{
b�
t
d

b
eu
X
f�
D
h/
@
is
0
j�
G
k�
R
m*
Q
n|
]
o�
b
q*
\
r�
^
s�
c
uF
`
v�
K
x	
@
yT
>
z�
;
{�
/
}

(
~<
'
d

��

��


��

���
��


��

��

��

��

��

��
$
��
)
�
.
�D
,
�r
4
��
@
��
9
�
9
�K
3
��
 
��

��
(
��
,
�
6
�I
"
�

��

��

���
���
��

��

��

��
	
�

�	

�

� 

�7

�U

�c�
�e


�^�
�_

�[
"
�c
'
��
 
�����;n1��3p�H�\
+��.�M
+�"%���"}DA���GR�7��я
ŧ�c^�wly���s^��ؾg��_Ap?.A
&�u:���'�SЀJ�B\���2�'7���3X�w�/&����؀��w�WQ�S�<vn���9��v!��Ú{֣1�iժ�s��qk�yJ�S�ō�m��\�����|��N���VS�N���}�W�7}���<�Mɓ�o���u?�;��������)vOS}���8�����ރԻ�z?F�y���7^����=N�@����p:��c�xp�
��A"�At�P �AOI��x��Ið�'g��3;;���m0�R�����~�����&A6�ua	��i��[��װ��`N�Jr>i��1��9�)��
�bo<���܍+4u��E�57�%˯�gqj��˦r��x�2����>���`ž��k]>����[V���������+��nb�2�=����
��a��	o0B{�/paC��+q�uk��}���.m�M��}�Y���.���݇�~�8�s�;)������q~��?��i�����NA�В�LT<
��rw cb�1�(	/@G�=��O`eſ�O�o��r��3;3�̝�dr�G����6!��~����g���d
+�>Ejx�۠�����
�xK�L���Rb����3~	��԰�S��'k��֭��Z]<}S=CBU�@
+��75���v�6�YI����؀{P$����ϥ��K�y�;���Șw��o����ק�5ƹzG��^���n���ټ��x�N������Ċ�NYo�h��f�F�!]b�/�CQ���r����w��Q4/�����|Lϰ���A.Q�˄c�:
�pK�����i�L̐Y̊�� �`cao!n`���-%���X|�z����z��,�Y
vIAJ��m�v)G��7�}p
��^�z`�[�=�c0'���w�θ?u�W�I�!�A�e�]
�`�:��`P��{jjw�hp[�ծH���3h���!{P�o��a���aԫ�k2�mk�d���5�����3sD��?�=��k=2d<�����.f�������7��o��U��;<�����ǜK%���z]gM���o���9�>��<�^�GԢ��swj���]�)g����]���{���~����=N�@����
+Z��T��q vb�#�"�A 
+
+(�h��.@��	��7�jd�'g&ޙ�o�kf����@�D&<�'<��P'֋�_x�>��>����Wx~��g��n��������;�G�N.J������C�M�N`���v'<.�u����|�s_�7�a3��)�B�R���
+}J�
+k��I���<•��};�t�
+��V?K��3���LL��������]��m�sn���5�3x��j���s���<3b�)����K���B��:۩~;����<�{���ﴯZ����~M�f���NgR%5����{���������J�@��lm|�|c��}�Csj#�"����Y[�#�bkc�/�X��i�#ٙ����NB�Cl�L�8�?wؾ���Fk+�]�
�<�g�
X��
�0�	\�7>��f���	�����n��=W�	�s^����3�GQ��|�"�ۇ�ΏTk_؞JX�4�J���k8�=&�����þt�L�߃�!�[_f�a�8���|��Ã����6o�u�^ME-]>����KDzy��c��/恺V�y>�*���'qA�esgw3Too���Uz�WI��޴���=]wh��_}���^??���r���AJ�����i�RZ*����KJ�@���x/�
<�1��d&��
��]����F\x��K��'�ڿ��������L����N̬4���E����
+��.�U�H��\
˰Gpgp��	��<��f`�?�V��u4�$����sX�Cx���:v��:�_I]�czܜ�&�8��q=Nź��W��>����[8�;���rr�t�̥��&�u&���-���p[�>_'��X�!
������Z�k�~O�z���8�Gx�g�bm�]��v��|6��|�<��<�p}K���|?���&����_}�16l�nMXw�����ƾϩ~����~c}
Fp
|��}�MN�@�M��!8�I�L��Z�W�X�8g`��{��x�ϊe&]|J2�߳="RȆ1��
+L��v���IE���)���ٔ��Χ�O��܃;�0G�����G�
+>�3��?�5�0퍋�9�X��t���W>F�X��-k^��񬥶9�R�ay�T�5X�C�?�b/��{�et��S;�C:������>�����wp�Z���I��ϛ̹�+ߟ�W�8���������|��KpKM�-s���I�������=���sl���E�}���k�c��֒��IΉ���5���������ß�/��H��u�MJ�@�{<�gPc:=�����A\�u-��x�.<�����G�^|�T��^UW%�t�6��|҃.m�D
#)��,N}^�#��Xs8�10n=w��%����Jc��\���Myb�ܠ�P��rG�r��9Xj]'wgf/3y���4��L�x���ZO�N�{r��A����]5Vm����_�F-U��X�P��@��Hs��w$޿⩟k�ۚ���=��5G�9=����wJ���.@��#l_i�>�B�4�7z�#1����i&'��
+<���5�������/�����i�����MAD����٠���`�X�႐o\��J�	��A
�H�fV��ٞ��T��Ye��`:@C{�s�`���o�s�-y?���9-�LI$������4��S >�G�.�+��5���k
|7�������a'�eҜ��X3����=�q�`�yf{�)r�7���؂pK��w�V����׽o~}󩬼����w�,h�3�}�Rg����z<~�g���l0�`Na{�\u.����s�O}������;��w�P����ř�ه��������o(�p�����n�@E����~,�ۘG@Q
�G�(�D�JOO�q7�#M�1�8Z{�swC1���tA���$}��X���͸V`�S(J�j�铨i������#*?
�^�ȗt����}��[y�9ǜ��Y��L�\K����n�P�\��M��v�Zo_��x����9X��{�A�~����խI����}
3�F}z��^����Ot���؂S����l�����	5��@�af��'�m6��O���V�{߬�u��[�i>?�mD>
+����=N�@��.܃A6�M~����!
+
+*�����-~#=����d�;;;;^;"�1��)����3��:��W��<�FrT眷�\#���������rN�k����ǫ�57�K��}x��[�NH�p{��-��7o(7Y�����Bh�ڟ��{Z}�<��Uǜ��Gx�w��uϞt"����2����y��]�c%����Ν���<_�O���o���Z�xɺ�~����N��s��7�P���D���7|�i���
�~��:����#c�����}�]JA��j�����κ��@�?"j@|�p�AR�TAS���,���S;���u��o#UX���+x�o��'�B�撺 ���kW�Y��%ϭ~MZS����-�9CV�s��,�d��T_����3l�*d�Ĝ�9�̾s�K�ޢ�Z6��sÙ��E}to4ooT�z>���>��\�^c�ǩo�I���;�0��e�����u��s����j��ܳf
+g�����_������+��N��>9c
}���>��sx��u2�����
+�0����kLm+�_��^�z|>���em(x�(I6���"D$�	I�X�-h�^���Y�؃9��3Π�#��)�#b��Zv���6��[����
X�5�����:�}����͡��Gz�0�C�:vO�o�Gv�N$�Y�����E����S�Oҫ��2z^?2�e-V����&~�Q�.r>���0���4�?^'w��<r��Q��h��\�5^�>�t�����ţo(�m�x��|��c�{������{��	�����Mn�0�9q��
U�]U��
X��z$6ܤ��{b:‚.>EN&c�%6�'3�������78�0��.�
tPs<"�e�W�y
+R��s�a�p�/x��k�]�(��Ì�7_E-5|���W����>E�Zǔ��8.��#�Oi�/�]G̹�6�/���
g8�;l���#��0Ӵ����=�n�}���'ͣ���uM.�����7�;�a?�6��ͫ�� ����-h��v�C�C���*�>w����R^+x�-<��_��<��+��S�
K��k����9nA��
8+0ݳ	c���"�CB���%���@�}<���k�&xz�^�3[��SX�
��V�p\y���B�
+��j
+�;�7$�/������3�`	-L`xb_��?Rþ��>�F�w!������*�8��y��h�*D�������|�#|�>��nk�ʘPöϭ3����G�����5��o�N#�����u�R��y�����=�Osx}�7��;l��������*2�^�}�Ը������1}W�w$r�����~�?�����}�;NA�������ޏ��
+�	��Cs�@�D�
+$��*i(v<i{�==cG�(�j��	��3|�n�g�Ԥ����kޘwpDS�iN�n8�����ٞr��'��\���<K�u'���]���w^Śߐb�Wm�<����|�<z�d�ݫ�J羄��,�*����`J=c��
+t��b�}��>�e�'���qʾ���}C���x~�.Jy
�_��=�{}��ۇ|��}m�w�{՝y-w��!Z/_g������L�������(H@����MNA����KxNC���a@4*�Q6lX`�jB�a-��8�v�H�,p�a���#"=i�!�����
��+�	z�뫞Ë�拾GpS��A�̤T)�Gx�-�`��i���{����?�*=�p�)H�	���T���q֏@��w�!�ٛ�=+ϛ�*��Vګgx����b�3�c��.�����p~����3������jX�+̥ٱ:�x��|�WI�\�}J������.`
;��ާ4;���-��y{�;/O�������o.^��xp��k����MNA��;xW������O�����
�¥�p���:�2�K
,�3=]կ{0���M��na
X�
���c*~��4Id��2�5<�<@jƺ
�)�V�`�����>�ʘo��zj9OQS��u�L-�3C�T|��Vt�Ps���k������wˬ����Ι��k���06�$O��iN�w1�Y��sW�?/���l�������B�{��g-�טI�|[~��w��s�2��s�k�h�ω�7ڃ�?���{��9��#�P�ӱ}��>$�����צ����Mn�@�
�
�	+n�aH�LDK���6��,Xp�^�oijj,>ebǿcGD
+��
��5X�O�SƠ�sl����
+ڧ������{`����LɄ$��Hg(��
��
���$�-Q�������/�5�}������Xy��桽�m��z9���{��k�H֚�����>���{j�#�Wk��>���
��L��X��fdv`6r���գ1m
������ꯑ���~���s
+Y��x?�u��q��_{�������i4y�}�y/�~�s���>��x��v�����MNA��
��02N���h&�0a͚�n<�W�_%ţ#,��t�t�טYc��A^���5e�ԟiA泥.�׫�'>(�'Y������`�0�!�8��`�L���>G�
o��Dy�^�wT^xU��y��=��^�j��z�^ǁ1z�K��z��g}��A��.<����s�N$�D7�g���s���<�v=W�3���xU^���c�
+�9�o�>���Ҿ��>F�g����wy��8�ޯ8o�]�uܛ�����_T�fq�9����M�0�{b(@�'Ɲ����x��i2/��_��tZBX�oJЁ#��(�&��Ԯ���rB[�����"I$R��Z�т��'x��q
#؃-X���V���z��n�`�xo~��z�s
�멟8���e�z-�FzѺR�q�?V�&��
�9��i4.�=s�n�/�_R�r��շ?S����oͽ�����z}���\t孞m\ϫ�/{�g���L�6��O��X��g���ԧ��k��Ĝ�8�Ͻ����1����m8S�����J�@D��L�L6F�]\Ae=x�<�
~�5K5�e�������g�R�Hɠ�+Ҿ{�Y�%�[p-u=�yA�9:�-�VB��������=xo�	܁x��@�#)�ՋV��6�+K�D�Ͳ����7������D��0�?�w���v��F��(B�ǘ�
+3g8p�{���?�7�������;������(r��~�m���z�����B�Ɇ{���W�O��$����g�����u\ͧׯ�h�}
��|�#�?���q6��������e°���KN�@D�cpI���@�#>(kv!��%7�Ԑ*�)�b���L�{z��i
�7��-�5�7`�01�G�r�%iS��y!=��.������;����i�?HO��Ẉxw`^ٓ�~=ײ����W��q>�'�[����[qJ���MZ���|�O����y$������O����>~���u��:;�W��<�^���ʓ5��v]>�YGթyҹ��~:���w�o��Έ��s��?VW��C���;��`���Ț6��#��������~~��k�����MNA�˽W�$�IQzf@6�?�7,H�����K�ڼ�JO`�e���~^�t�ٵ2 7��}F��d��m``��h��#�+�r�s�"%wC[aL2)�x����	��S�G��&G�-��`֬�s~�.ѹz�WzJ�%�?�|�7��W>N��}/��Ta|T��e>'�9'S�#?��������6NW���s�����-x�����u��Ǻj��z��I��3�_q���s��k�9����5]�=�4;;���o�l����E�����ϟ}���S����9jAE��Um�f׌� B�@�@ʜl9t�H��
|
�ƿ�wѣ	�TW��CW�?�f� h�F{F�/'�c�0���D}b���
l�
��D}+�<�;Ѓ��ܷ��zʄ%��I̱�K�I/F�s
cv��-5�x_�^��:4�\�0�.ޞ�W����Ӡ-s��5�����z񨖭��?ܓ��&���'x
kp+���F�py��2ѿ�o���g�^�_j>�9o����}��oAmO!\L�~�w�߅��a�}ɨS<s-�?�/J1e���Իn1P1	ٵ��&�G
�	)�C�*J�>|
_��tG�;�
�����5!����x�ӀR�S�XAS�װqˏT����p�XCb�P݂�ZT"ʼ~=�9
Y~�:~fK��0��D�g�h��Qͺ��c+8����9�[c+5�wzVC�~�y�gx��o݇�7#�,޶��sҞ(���0�o�>�^ٯ/��츷Fj뻑d��7�W��Jίr�6�ܓ���Nc�Ώ����?�?H�g���pf��B�?�?���|6�Onp�S��u��N�`��G�EJ[(�
&��'!<�}��3��N2���/��w�����QE��safT�|$�׌_��s�ˤ��r݀�
��7��:㚼�E����m�5�:s�$�VX��de{�`m����:��,ŷh=�g��ێ�>��_�3���m��s]�%[˳�}�{?���<hoԧϵ΃����~#&w���/p��>R��:������|�ϝ����9b������������5���S4���;�8~G�ݗ9}/q�����1��u_�.���7����=N�P���18} ����I�!h8D:.@IGA˅�i4r���}���}?U�T�
+�K�@V�(^��X��$uSo�Ӂ�x���7�>�	�����Z�;��n�b�����Hg�[ҙ�mЄ��p ;0�=͋�H�	��o��_^������ϑ쬆���5�e��b���:��uԞ|>������+�
n�`���Gj�3��9��uǙ��{��H��k�?�S�q�!�ݹ�&�oyNOd�󒟬q�/���|�^����E����*��T�����N�0���M���&�V
+\�� �H<W^�	���Q"��Ƴ㵝�h#��K�M�-ߛ�$�Y%��1�i�4*X���}���	��{p��n����B�1~��ҝ�_��N�+�~Ҥ5I�1��c�G�ʵ���.Q�F3SO��j�I'���Eg�َ�N:=��9i˗�V��oɆc�Ͼ��
x�8ZD�g'�g�x�����ȿѷ�����'_��8�1��|.�|��uu_<�����:�^e_��'���=ڥ��/~߽^�M�G^�����C����
ľ���u�MN�0��X�� ��rJ�m��
��Y�� !��!�ł�O&]|��v�\;3Kfփ3҂�~쉿;�;
�s��P�\��������q=}#�����p.�����׹�������u�/ў+��� 1��:+���#x/�s�܉q��D�اI��aOF�㤀��d������x�V�CM/�w=������w
��vN�vѷ�#��w��C�`?��	\�,�n�����I�cw�Y������zޥz�\��R������^=�O�����������W����5�<M �k��s�������KJADCԓ�;o"3NW��ߠ �Bĕ��\x�`�D�i�ȸxЕY��,	��,�R$���#����ݺ�H�b|~6ClIjш9#���S�wC��59�Fp>�[s��J��V�.�Ja�Xc�ǹ$�u?�w�J�T��۬�gQ	��{��Z����F1���jnkr��8��۟ϣ�-�"�kE'�#�Ї������f��3���p>�7���$�������:�x�:���zn1�Qܟ���w�z
~��2��T)�5�f����|�'r����6�Evo.����ؐ���
ۭĐ����=NQ��@���h8
J�n�7�� � AҀ�hRF����P��<i,
�C��+�wgl?{��ff6�0ܐ�����
�1���$�Ԥ	Ԓ#Q1������<�{��=5kzT|�J���O!1��{)�M^��
�2o/����������w���yx����'�;ށ�xޔ�,��s�|:����g������������o�х�ٗ������+ď`rk�߃�k�Yo�>W�y�̷��^��u�%k����M���P�������I�����3~����	�&����ܿ����	�,�{����MN�0����
��*]BHhb'�
+
+UaSq$6,�r.�8��=1�ŧ�c�����Z3k�9iHK:���;�ҭ/I� �)wzp
��
+d�ۊ^����#�^�����[���/z;�B��@�D���e��_��ѯ�߃[���GƞC�Ճ��Q}F����[��'������O�
+������o\/���
X���XT_�r��qp=��{o��|�.�1֧�����·�����~��ՇsYs���9��?�_��=�g���u|G�8c޲3�����8����3�҉��{?����%���u��NAD�o�\�۽KH	�DC��i(���Z
+>��Y4#�ѥx:�=g{m�ED3pNf�#���s�|��[��!��4M�������D�>����
�ly�-O��ZR�Q�|�O��<��!�K��zj�����������<�W�皁�]O�1F�Q�k����|E������=؁�u߁6��d�3�8P3Z
y>�MqJ򩯹�+�^�'j�#��x�,k���<���<�N�jG{������������n+���{�{�}�ڏ!�=k��~�����y>���
5�)�����Mn�0�sbT���P�(�T��ZXu�;����0�a����3�y��ɲl��y2b>7��O�
X�g��\i���	�t��9���+
�I�s���'�#_`�:k���x!�����򕆄׭~����ܗ����滚$�+�
{���p�˵+0p/�4��%36d$�k�E�~|\����|
�`����-3}��ț˞�F���GO�8�z7r�U�j���y_'����uD��~���>V
+ɸ�}	��k&�"��/b����Qk�0��bY5���X�T�m��ٱ�������{����ޛ&
!d�����������ðC�0���D����ױ	TP�Yצ�h�=�U��'����<�Z��_R��m˯t.��'�1����p�3,a&�>�|�|��
'���?�-�ro�S1g�y���]ØRzQ�o[��.�[���}�:=��ס�J��]�2�άޗh��=�G��������k��{�g~wt>�G���F�������f@wy�:�����;nAD�g�4�
+؏g?`��!��G$�SX�G�\��ZQ-�J��	�4�S=�ٞ
!�Í�0&D�f�{Ȉ����s��;{t�b��6I�9mE}�
5��GI:���x-�)\�Q�Z�'� ��5\۾%f�u{R���^����0���5Y�5؃_�G�
X�7�J���w�>��v�S�w'p������Y�گJ��4%�󫸯��iK�����ɥ�����ۼ�٬�.��M}g��̿�8E"������{K����k��?t�w�K����X����AJ�@�<���i<�M:Im�V��hw"�"�w�¥'����?<~&X\|�L��{y3IJi�~������g�I�c���ڠ��y�
+�A+��5\q�L�9�����{z|95w
��Y���.��m!�����]������&p����G������
��nXÊu����3<�-��~k"�1���^�c��)o���)�p�9گ6�yO������,�c\/���^:���<�l�w�ߓr��l���������������8���??��z~����]jA����]r�����]��	B"x�� w���Q$5�
+�f}�f�����7�0�<� #��A	��Z���h�<3ro]剹+C��J�9�>���+؂w�
N`�M^�+L~_�p���H�;�Ż,HM/&���׵~j���;�CM�����[�4�c?���x'�f
�
�@Oߑ
�?��zc��E�fe�\=W���ca������!���Ͼ/����8�˓�����<����{������ˍƒ�G�R�o�7�	]�_*���}�?�d�&������Mn�0`_��-���Up6lz�.P/�+��E}O����'�3�MJ��~=��GZ���
+3(�O9)Ny:�ߺ�B� ��y�7�C��
+���������ߪ�qR�\�TQ����0�	�Jʍ�n�7�����Gx����Χ�K��u�k~ס�)c�'��
cU�fo��Z�a�Mg�q�/��k*���й�a.ޟ�i^{��~�����}���,�W�m񪗅���������������z��uu�wt߸��%��m�KK1��}��d��2����zqԓ"�Mk�
+�2��N�:��R�i�㌜p�`pGp&Ɲ>�\���E�u3ޓ.����
+fp
����w�XO��+��('�o�;��4�C�t�[p��U�D��`ԈO��~�o�Iϻ�+�5~^�x��<�G�~��WԒυg��=Џל�^������3��O��.�?Z��;���־�y�j�Y�Q}�u�Am�9�g��s.rD�M�9W��q�Z���g������s����d���	T�����N�@���Q[iٶTDM�/�7BL4�|.y'N�9ar�x�%0;g�v�)����5�1
+p{�X��֠�}�!��J������ع�F���ށ{��]��4Ԕ!���k�������,n1�GE�%xo`��J��S�����L�r����3����?�lx�[��`>9����ϒ1�0Ӹ#�Os���M�z�s���we�=�>���)��A�X���}�����~�������߃��߻��h�=��~�!��K�jg��U<}�&�h���u��N�0��Ɛ�MS(�J�"$ Q�[_����;1�f���9|J�ٟ��*)��t�=ѹ#�1�X�-x
P@&�
�Hj�C����z��+�`�Q���	<�.���Xci9F��}�����c>�8��⤭�=�x��O�!S�3#m>�B���Op�|V]��~���(��Q/���8�>��wM<W���~(��"�Շb~>ϖ�c���Q3��x�,׼W�����δ���D=�L>���b\�1�{�|�s����~h��p������9Fְ�u��n�@���3��	����)"��p�Ì����+��7����R�����-�<P��,H�b��:�"�o,^9���V�S��Y�.���g�у��A��-�$}8��C�lՋ4��
�	ިA��k�gp�̑^��>0�_g�8���|�#xg��'p
�����0�[�i
+dƬ��o��H
��C]�/�\���u�QC.ؚ����T~��g+����&=�Li�c�S=����8ϫ�{����?>{J���\Z;����t*������MR1���*!�d�
��{�p�I8�'�|]>��*_�t:y��ta~�#���FG����#��A+� ��l���k��A�WB$>_����I���w�؃-x}c�|��V��=�L�z�$n���'��f���3� �3�,�5�^�c5=�8��׬����<0W�L��Y�f�$=�.�Q�-�o���x�k�k�lxGG�5I�K׷,w�z7�{�s��u�t���}�������5o�������{]O��$9�s�w�3��}�MR�@���xB0!$��F�X.�Yv�8g���/�{UmW&������=��Ý�ko)Y�������h����A~I�>�/c�l@	r"}�+�Vװ_P_�w��^�g�	�����������tغ�����o�~C�=��`�yV���֙Y�����S\����k�}�6�Xޜ}������Yz_9�+�����ʧ4������˜Վ}*~l�S�%�}z��c߯���s�zbq�:����I��)��?05{oӑ���w���F������;N�P�aT����g;��q @A@(�(h����`t@I�"h�Q��ȑ(��7�?��ȶ�tL�����`�9cc
�i`~��c4?�1~\F�4~s�L�^0����v���9�@�X��:������>�! �
+����:(�~�{WE�WyR~O�>�����r�V|.o�9<�Ozλ�+�wwjH9��Ckͩ��y��4	�j������N~�����m����\��]ޔ���|��^�k�ܾ^�j|d���s(����[qޮ�$ֹ�Ul�x�U�yP�|gpaۚ��Q���|�2�~�VcC����MJA�K����&ӓ̟�DM�$�o�Bw�E�	^��.����=l�A=������{�l�~���y���8�
@�hY���D{�1����$����_�E���7 C�y�`	.8�����ܘ�m����6>��Ϡm��H���:�$����\�E�'�{|��=�0�-�S��i����O�P}Bu�>;�w�M�#2!-m�\;�޸������}n��%q*�߃�9���>�3�������t�{���+���C\�w����u����޺��B��n�5�u�<�.���\g��+x/�뼣}���}����|
�z����u�=N�@�'�{Pp7Db�?��$�@ ����QRP"JnA�x��H�Q\|����웙]��P:Fd�P{�`�`
+r�RP���h��$ pm�yD�9}��voƳS�OHJ-ޯ���s�/������\�o�������%���Qdc��5hw�qA݉��84�������xNih��W���������s�<��Ei��^=��6z*�8�v�e\װ��ɡ��8m�YNGuN�^[׌�����x�}�Wp��.�k�4�ޣ��;c����[��k���A�j�:���{�|�3�τ6]��o(����o
��;���<Iwon�{K�z4��'��ȡ�����J�����KN�@D {��
�!�c���@�,���q��#��F�R�Q"O�{f��{�1�#���Q�KB��4 g�T.��|jp.��9���?
+0�o��Cyń�%sm��x��#��{I�?�}���w�6?Ͷgf[?x~Bl��o0c~AcDZ�d�ԑq]̭��UGA��t����){=b<w��P����4����D��N�U��[����ѽ�~�)����~�k�˖�P?���/����[��J���l=Ǭ���^D<���+?�������^��[�YB�����O"��Y	9]�w��=�=�6:����.��܁����<KW������/@����m�;N�PE��`
4,�e�:Db������PPR�*Z((�X[��>�^i�8�=����|bf}[��
(��C�)Aͻ9���|��t�<�rFNC�
+�tp
��=�Ҟ-A�K�U�M>g`��j~��1ud������l��l��{f�xG��m�}�S�R+qDjR1/���9}��)��<g�aJ�&}��2��)��/����qkj6��7���mC�����9��.��=�0G=�+@��
�Q/ֵ�_�C?�-���~i{Ds��y�DWv���i�{�E{���6��{����>�Y������.��|?��	���s��r�JG�ʫ�}?��%
���}�=NA�Mr.�KP!��H�l2��%�B��Hj
+�"*::��܁C�<K�
+�v����x������ ���3�S��w�i��P�,��$/`�b���
�Ds��
؂w�*���&�}���0rg�gAkb��������H�D�	_�c�����3u%�������kƩ��y��߇�yf�����=w�sM�C�G,����8%��|/S�.yw|NY�:�)Q��_0�yx�F�c���<����-u=���s0��
+��P�������q����iH������9��pFln��L�ϡ�S���
+|����ߘ
�c��zv���^�|c^�����
��*?���{����OJ1�t!.=�k�Q;��Nf2�Z�n�AD7���p��/�=�x���G�4yy��B��?+XC��-iEgT�p:���Z��w��Ox�׫k1��o'��7���G$��ij<j*�4�����,g���\��
��<�0;�8�����y��q��Q��g��j�3�uAsI.�ݣ�O{
��c�g��\�7l��c:��{he�@=�7rW�IJ��f�w�;����-��9���J>[����:�s�rV�����zҺ�﷒ulэ��ǔxV�V�~G߉��ij)�u<;���R��0���ϰ<�=�6��Ȱ����N�@��CLb�s�@�@���&B�	Q@���sʌ4Z]A�I�3��w�uJi��4de��)Y�5)kKpRAqZЁ
\�'�	����ikY��=���|�{�Z�^x--5��3�ՙ���m,o[p��<�7�
+������������d����=O����\�1�O�Q�g�v<���X_�jU�h��� �d�-�C�n�7�,���ۓ���K'�����m<�������^:�K��~r��.U�xb�%��]}��8�N����܁�~�w:�����Y<O�gh_�E�?}��U��u���@D�ň`C
+�	����Ƨ�ib��)�f=.�
����}�|��̝�s
+'w&�����6�*��<�����3�|'�G{$�M�,P��9�r�%^B��K�F�h����QfB�=>:{g)�1.����D�hjZCs�wj�n)}���9�m���3�<j���Y��jE�!_��>;����y97���q���
aX���O�=�:�q�x�t3���h�sm=�Y�n������9�����}OD��x��@k���¦��}��n�0`?q��$������T�C/���z��Ե:#
#��$Y�;)�e��h�����3��XՄ:XAbZh����E�va
+r-e�c���x~�^���h�>&���*2�3����-��5n���q�ظb�z�[㷰�:���.�Nx�y?!G����`�
�b/�l1�=~GY�n�X�/b?��[�
+?���gx�<2�F�4�s%��t��t�\�9b����d��s����{�k����签�w8�x�����w�fƿ#p��������MJ�P�+��"܍bML�<���**��8���I�Q�Ν9p
����%|��{���3���Ρ�*�O�SR��J*c���$�u,+�������T�u����1�k�s6���e�^�7�4�q�~*+ޮ�,aE�ӆx�߯%���G�[x�o��}|?�1|>3�[��U���(���
7pO�p��K�Cy���z�٨>��r�g_X�
�!�?��9���>�x5�A����c��?7��#1�=��Ɇwˋyk\�;���g�k����c�1�r���9�������r+Qٰ���=N�@�'�@������
;Nb�8��!��������\����VzO<V
�⓽��ٙ7㉈2"NA���"~~�G������;���`��܁�,gH�s2���9goA��p]d��
��/�h��������N���|���I�3��gw�-~�R�	�Y���܀���@�:;X��6�'?c�5��%k����M��5x�|�X��(�9i�V�BqH��u��w	��'����
+���}�z{_����u2���ԌI�������{��"i�&���e�w��r����kX��
���n�����͍M3 ͑rH4_��a�|
�ȉ���u�IN�@E�G� �܃��1vc3�b��ĴcϞ
�
+H�����hً����~UWu��r3���Ȑ�>p��ߗ:���G[*�E���������%���`�:c�����l0�x�ԛ���Я�Ԉ)�OZ��g��M�P1O�t�%����P���H_q]{�9n��Y�
+��
+֟��13���W窩w�ޞ�CΫ�_��h�sp^�#����R3�Xk�x�I���&
s�n����/Ԉ{�,�k�Z������Ϯyuͧd�Яw����6~?ZKKg(ؗP�3x
��\��+��S���|9���,�E�����Qu��������Ƞ��
@/�,��}�MN�@����%���i�4I����#@�.�`�
+$�6HHHl8
��Y}f�X|Jfb{�lOD�%"M�C"�Kl���u�|z;���x����)(�x�܁~o�_ڠt6��yy=}��p�`�8)c�E"��e��
+�:m��=0�����L�wD]-�OLb��._��<rb~>��y�y����g`���Hm�����38qz��r�uŸ�Ҙg�]Q[X���G�<�9���6��z��f���'=�sG��]ƺ_и���	.+���p?��T~�Y��3�*���
�O8�6��c�:=���\���󷞗���Z�����W�y��YxGmV�
+���_��u�{g����z��e����
��cH��uԹN�@��ax?���N|� .!�8$A"�!
=-/A�����2Z��S������$ι�s.�)�eZ2dS�Ņf�����G$5�0�gx�X���'��Rܑ;44^�'P�&��B��Pj�1�KL
�Јk40�9cZ�f�xcn�c��v[��
� �}s����%k��Y�zĐc�_c^9�w����=Xg�2�vna��p[�qN���>6g#q�k;����1�Z���'��+�Fj���ƶ�c�A�tl�t^�A��fp̺l��}�_?������s�mx�w��>��3���H��p�3�ܼg�燼�)�p�{)ܼ���4�}W����LLݖ���{�o�y�M|�X�r�����=N�@���[P�pNCIb;v��1�A!���4H��P!Jh�qN@�[�4š�d����ٝ]�H� 
1�H����.qv�:��v�#�/�\�9���I)����%a>�eݧ����
��kbX?�l*pD�c�;���ı�5s��_��M|��-��p�����9g�Ԡ���>5���z
+��/��o��_`��F�}
���\g����5��������׌�~B�6��������7p�z�~�k�շ����U}�ԇ�_2�j��yk���w�ދ����+��,{kN�}�;�܌��γ\p/�WzoB�)�����?n9�mi��cc�
�^ư�}�;N�@��-8���@b;v��ID		/A�x������PpJJ���W�UD�I^{g��6���
��2j��ݡ��N׃=
+�t��F»�q
�|V|B��4��SE%��f0f*���z*���G�1~?��Ռ�çYk
����p
+�4q��G��}j�!��?����x�x�/�e𽵅�7ܱ��y	��7p��]�<��7Ѿ��w��yh}�g��l�6�9��W��6�YN��c�
+�����'>7�[u��P=���>�h��&��x|շ�'w�r:➯y��ʖ�&sz�S8�wxelc˺�w��u�����vb���A{���n�WV,������J�P�G��O�iӦI�4i�V+�ZTE]�p#�7��O�Vp�z\�
+.>���g����.� %-�NtNH���>胆�����������m����y����� 9�{#�M�*���
��^�GdH[?�_1�ߛ��a�������;܃���T�K��ױ��&�j�1��c�zO��,�5���8b����
8���cMi?3�Q��Nő.��g܁w��Z��P�n�e]W��)kh�G�Q~�%��Hz��g�c
+w��X_q|�[y2�j�����ܲg�I1Ҁ{�q^'��L�~�[b�w=��M�����v�b���_�������V�j��u��.A�k�9<��c�t�L�݆��aa��6Vba�!$�֩�9q���ˤ���޺U5f�mf_p�PB]��"-�r�K=���(��ǥ��~I�i���Ρ�5毸E�G�7�s�̦�ѼX�
c�n��n�̍R�`��^�>�f�`fѾ����r���#p�
l��ű����b{ĵ��n���
^�Naӭ�c8d��̭��ȝ{��T�@}��=5\;�u	\WcKW����p�=�r�	�[�U��Z�F麅���}*y��>�	4O�����^��֞+�(����'��1�T����'suk�������ߧ���:{�fh�{�g�;X��W|տf����$Կ����Q����;N�@�	���t	a;6~�M�Ѐ����q�(�8g�_��'e׳;;�qD�"���#�a$�A)m:����(��8�'!?��<��/�G0�J������cr�gf��wR1W�֗f�=���	��+�Mdi����\2~�n��o9�Yw���\�|�Z���+=Ü�}�43�:�yv9�ς�o��5�u��iHǵ��f[��k������
���Mކ{s^=CEי�V�8�Z_�9�g:�u�������LX���'�������T�����/�o?k
�;��x�\�����n�N~z7�{�=b
c���9�?�8:�}��纰�m��.CA�)��ƽw�����iO�=U�"D$�åK/�A��O�'�����잝�=�i���VD�v�t`���&um�P€���T�b��o�>w
5U.w����r�.�?�����☒�4Ϙ{{
+פ�W���?Y�Yn��*�7�;��#���^�M`F��A�x�Д�[������
k����o�[���Ӑ}u0a�$�uN)��$�z�pK��wp����XEVW�~�˳M��{̗�sP��z��y��u�y�����`_������[SƔ�6g�̽���3���ٝ�uٽ*�7���]��s��"=B��m��NAE�*��<6�n��%!<�� ^�@���E� Q#*
+��;p�b�G�����y��}��+�
c��[�6�y���@�d\�
+4I�ہf@룎T�%PG�A���n^����
ʭu�7_AZ?;���>�#�of
�[�3[�ĸ
�
�%�:��_}֤�ܘ��)�1��U�f�đ�H�>�������7
+kK�M5}Sj�/�]�}�c�:�#pN�����ž���]��\g'ͻ���̨Iq�����38�?�����ދ�{�����G��Ρ;�9u-�+g�n���\]�ӹ��*F��K�=��]Nw�����<�3[�KTϿ����z�_(���
���}��m�MN�0�qN�a�q�	Iڤ)nZӦAˏ@H�N�ذBb�UX��Y}���.>){��xby�5h@����	I�^b��~ H��Q�$��F��՞�!����i�M>�
+��<�{��3热��\��i�IA���������Wdg���<�7��
+��#����9�p�+&ij�}j��sܟP�q�f�C��̘��`)�YY�'����S_E������䡄8�&~��%{���7Z���<s�����ԡ�����<5�E{{ͺ[��lĻ�Ľ�C����A?�F�������I������͵�m_��$7q3�k��?��ܲ���_��/x�U6�;e/��������#~G�ɶ�]߉����ϰ�m�9N�@E���3�s��`c�f�x6�1��X%��D��3p
~I�K���'����~UWwaB(@vIvH�$n-q�=�
2�F~�7��Zo�W����|������\�p�ίt�ק�܁0
}��pO�1M�^5x�!���5�?�	8���O�\��ǐ�MϜ�g���'��q��*2"ڙ�1���c�8�U��X�k�H��C����'.����-XR���W��̷�������������Q��Q�+����9k���n��p��`�g�N-����Fю���ч�7O�ȟͩ���P������4��
���s�fő�
k��p����F��oK���M�����?�����m��N�@�]fށ����$
m�&i�4i
�@��,�
!�̆XXR��
+�)�U1|r����HOD�![���
ֿA��i�`t��8}��1?0qNg@����	��#p�A"�9���IB��}i���fSR���)��S;�ӎIB�+���;��VF{Y�률V��?��
q=߂�	��>'SRp=ẢM�GD��ޒ9��.8��
�s���������F�<�x�\K��,u���)Ycl�A��9�gf�9��91��Y��nDl_�����݀o��*��ߺy�B�#�90h\W�g~@
�q����������YcŚ��I]wk
<����>��#�y6�S���o��;�������wl����3Z�/3ZoȰ�m�=N�@��jz
+n�8׀�$�Ipb� BTP��_�@	���Ppn���;bbQ<J��ϬwBh��A���ǷPC̕�.�I%_�Ws�7��#��3q�����Dn�Y��X�̋2��a��yV����2 ������(d(Gr*)��br���+y�;��.�O���fD/��uA=��1�_!,,ˊ�S�͟`H#~�okc1t�Ky�W�;u=�^��}z~�պ*K��A?9�fyl=F�Yb@\����Z7�}X_VI�n��~�K�O�l��w���ɣ��
ke9Z�}ֆ��v^L������J��>M���m��׌��_�ħ��f��=����u�?P��4̟;S�6����޳��� q��_m�w���u�;N�@�'���s����&��	��@�
+�����D���
+\��?�y����ڳ�3��>Dd ��@l�����ۻ��#���<u�$!cP�!��č9wn�x'`B���~;��8?�}��\�5��Ωi2�9�(�3�Rsn��r���Z9�c������ӱn�����R�Ґ�9��SPo�u3Ұ�Kp9^P�ŝ�׾�\���<�O��:X������u֤`�p�Rڬ�Vo)��O\M��@��{v��s�Ѽ1��孂�v�Ri�U���٬���ο����N�){ٰ�=i�[��]�l���M��`
�k֐I{M� �4���Ϳ�,���YF����n��u��J�@��{y�j�&Mb����R���EQ�O>�A��у7/�U��_����l:;3�ݍ��d�mآ�k��m����N��:�H)�������N�Na�4f�mȩO�_��3�#�Q�\%k��pHsW2g��FAZc`��̡����ሽ��}��Gx�g�����c�)��?]�.�~���������:�����o��:5����LH�{��I(g݉�yƱ����Ծ�yy�x��c��	9¹���_����s�8='1��������������=��p��DZ������:����
}j�fʹ��}/�����u�
�}��%�Q�����;N�@�al�P�VB��gb{�؎�'|Bt4Q� A�
+XK��^�1�Dqd���{���sm�t�;�e�H�i^;2���Z&~z���1�$�B_
+#h��|�p�5a�5\����!�|�\�s�1L��pGgPCż��7�<��k���y��n��3����gx��ceT�g슔�ļ/��œ��w�66a����'��s��Ѿ���1]�#���Uù��4�N�bL}?�����G5�.}��(��P�6��ڿ��ѷ�훺��������(g�O]#>����/Z�-�gb���̫a���
ny�
+�;0u�{+�u�ĭ�Ih����n�ls�ҝ�x��k������m�]N1��N\�[pCfgg�?�`P������&܌�xΉ7�_����s���9w�v��֎�����s]�ƍL��A
+r���U?�cg ��gFl-C�g�����~
+CC
+�fԒ��(�܀g�
+�����'�1�*NC�K�t�`Z�`�5xo�<�G�J/g�5s�3ޚ�ү�~�W���v��pW��?��q�\��+
�9�s��=����?b������.���Dw �����܃���W`����-�{��^˳�r�����R�W"�=��T�i��I�jZ5�yտ8%�!|g�Yk���
+�Q��-��3���l�+�������tI��^��q�v�D���q�����N�@����K���(�
+��#j��ݸ3х��k��">�1�I�	���K�sϽwf�s�霫�:�Є�?�L��k����⊏�uD&�b_�EN�-Z���'�'�h�s 
+1)�}Cf4(�
���
+��.�!E?�Z܊b�.#1c���;E��K���p)�ģx���1=���������&>���p��/����Ľx��"��і�����a�q�<u��0b��x[Jg�e����Wԙ�C}�����e	���.>4�戾��2�T쉺G�}-���s���=
�1��s	���z�;���]��'n}'m��
1k�h��[
+>a��~�����6^�^l�c��/���
�Gݎ�������}�;N�@���D�
h8-uH�؎���@$	�x	
+DAGEE���� Z:�E��a�(>9���z7�HDhP�Z���|H.�n�"��Y���kަ��ͥ0�8�(9�Q׉�]Ƶy݄�ˠ�Q0f�k���̙Qj����v��`��Ǭ�����m�naz�n���9����9��<�5kV̝�n���}�������,���^���^1����	3x�7^o�&\��?�vYk�~��
��-}�}�x���������e\�[�;+����=N8������5.�:���n���+�7	��^���:��{��@��g�h�����?kZ#1ڌ	�sN@���L~l(��v��Y��M=�;���B��7��Ѹ
���H��d��m�=N�@�(�7����c'Ώ�$v�@H��D
���@ (�
���x#=����y�vv��r3;"��]�O�ZR�˭3�ڠC�%9��h�X�G`
��%��4$.��4�3`n�>�;�q�a^�4�����z�V��D�r�m�[��	ǩ�x?��G��u(�Sp��{t(uK��9�u>�V��Vw��^������xG����M�CϿ�=k��9
�ʞ����1�r�>t?����.d��/�Y���nIB�ƝSw���R;��!c_����ӌ�s2fS�ףV���?s?�B��&9�H�B�g�׉�9��I=��w�o/�u��e]�`@�VMP
�_F���*T�ݣ���e�]#xH~
4�R��m�KNA����+x2���3<AT|$�Wİr�
��;��[����ŗ������{̬cf�8��|�!�E]4EU�DM�Kh����$�������P\�����#�ւ-��8
q���!�袷�Xï�ܼ��s���Q"��H[8�^�ŋ�-���S#����?��ˆ<�.y;m|oĻيz��j��%�����
�fh���M�fk���������`�ym���yZ��\N�Y��������ߝ���0�1|?�'qE���aB��6�1�S|=Ǡ��	1{�~B�#�V�����ǘ�Sb���{��<��x̔Zz�S��ga_����&QߓD���U��{�w�����o/G>�kt{�s�~���?��>P���uԻN1�
z:>�����	���;�d!��w�K*��h(��-5%��ܑ��%�������k�̺fV�<ȟs�F���	ԡ	)Ԡ�pM��Ɣ�����P!ۉ���� F�1+|'ޮFw��ԧ��J�y���Y�x�w��op��z���?���/��!���6�F��6nj!c�&
8fH[��}x0�Y4�]0�[�U����
�p��<L�n	�����)��6e̩�lS���pq�dQ��Ź޷˼���'4溵ޞ��zo��~�Zu���?��	�x�#�w�p��dg���F��7�`-��ü>GgUt�t��v���߶�~���{����:�������|�|�?M�V���yƉﮄ�%���5T
J��H��m��.aǧ}��
���:J��k�G�U[%����{D%�V��".ĕ��b���/��|s�vFDb)�%R&�d���_5�$`���u�vU���9���B���n�&��Ű:�Ϩ�>��j��4I�|����rȞRp�E
+�`
+�g�����k��y0��;ߨE�&�\#��
Ș+q��:�1���#�96�8
o�?��#��n�%���E��"�
+���֑2W��;����ͻe_B�|O��g�����xޠ�:��O{}����>rs`�&|�!�+c�������k|��.�؜[|{��
+܀��
���������N�9��:SW�1إ^gM�����߯I��G�	r �����1�m�K��;��~Ϫ�:���&�#ݰ�}ԻN�0��7Vx
+&��%M�Z�6�-�".�K$&���ÈXY+#;����#1|����'vE$�
+����{a�B*q\X��)����+Sdb�j�~?�
+�i|��bOB5Ob�X�o�׹�-x�o�`f�~�SB���
+��Kh��6�ի�!�t��z����tɽۄ��;��#����	��;|�-r
����
9�f�w����S����ye&�ۙ�qM����9k0��-�o�}=>�;[�3xF�2!���[3�����gva���}��5h�5c�܃�75Z�����ߦ0qz��3f�e���5q���29Sc֣�9�������ӡL�?��z��;Ѡ��CO�����U��ߙ���L.��u��J�@�q�����4^�j��D�B�.A\"]("���
\�Vܺr�?���8�⣝�9g.ͩs��kMhC��8�e�̸ab{�J	tL�p�P�:�2�8��m���`
V����O8�Z݀��n
+[pO���38�	lR
w�	p���r3��3�7��㑩'9
s��̽�2_q;p��C؃
+J؅x�oz`|νȈ��
s�k�Ņ�}ʘo�Qq͚wRp^���+y�	��?�i
+��E3��~�o�d�بhn�w�����7�ǂ�y�)kk��T$&.5s��:�\�N�t�p�濻����	���7�3�q���v �P_G��?�>>v��M�s�u�����а�u�KJA���|�+��hB�s�31�h$>AAD\�B7�э+O7���_�HS��G�{�j�&�B��?K��UYA&���E�8C�����W�̱����˿���eC:RK']ir���5���r�:�YC3�&!;r,Wr+��*�2a��=�k��1���.#�D�z��
k��M���:^�I�e��>k��5J�m��^��3!���^Jԓ;V_I��[���J���T���瘂���Q���w��=|ȧ<�!}�z�$_��J�����Ws�2�oY��'䴾,6}G�/���(�i�f{"��K���ك�<��fu�{<�Ϲ?s�\�w.���c�N,3_�7�M��u���o��:C��}�9NC1�q��9'��$$,�FH�B�- �	 �B����T�t�o��%�$?%��g�~�s�e��|�ڹ@&� =��<|ۏg#�H<?̝a� ei˅\ˮTd	�R�"�8O\o��b��x��P��4�gS��(/r#{�WѤ�}�I#c�i�Y[";��J����쓿#�r&r/G<�˹N�6���Y�C�w���M�����|�$�����3��։�PDZ���g��MX�yw.5)s2����P��|��*Wrʼ5��~��}.����΍�]L|;���9K�>��	��ll��-���}�U�`ޛb�eJ��sТv�Qbv��;��F�����e�||��w#�|[���[�t��Ut��7�w&�
N@���m�I/CQ�Ӧ�����;����*m
E̒"!��!ba!6vb+,%l�_�{�ωœs����c�Ml�ᖏ�
��)R��	�����g����'�Y�A��
ΡκH	��qm�:��k�Tr�i�C	*Ѐ�1��c+���s�f*k)P�J$e3,�1V`�cv8�|�;\�M��-rC�y�֘6i6T����⟇��:�u���¹f��X�w�Q�j1�3��~oq�-����$p��B�>��+w�N�c7�|uWU�E�y)߄W�gL�'6��ۗ��?1�6��9���������<߂ڧ2�p�1&�em�7���a��p/�L|�3�e��;+wXޣ���
���}%���sߏ}/��qߗn�s���>M�~{\sh��FH�/ҿEf���mԿNTA��l �`|
��(�@|:k#v�,fA��+�,A���!�B 44+_@KH,�����N2��⓽3wf�9sg��F-5����"�˘x�+̢�vA��4?��BFQ|^x~�%��,���
+�z�D<�	I�XcѺ��O�9��rӪu�x�=|�>�QG3�C

�inP��Ȭ�,`ﱉ��M�O�s��w�u��Jh��:3Z3���N��a�&֕��bE5TTNJ�l*΂�=�׊W����z͞WSc�n�SW��G]�B?�_�����.�s[�wx��o��C��I��]ʵ��ѷ�������M���u<6�~n���Yg�Y�)�x�}�/�78�7��M���-����*�/��C,Ʒ��:�'�}��O�7e�/YzfK��u�s8�����(Ih��~����%{�-���*Ę���]�?�hO*�?����b�S殟����K/�Q����5t�=XXK���Kw�3�aF�J�-,h*,���'�hHl-$6"}����89!���<��_΅���Yw�K����J?���4���;">����$�A�c�x�O�֜�Ȁ��N��~�~���aEF}�b���LhNV��y_�.���P�$r��շ3X�:V�ˬ��f)jI�����J��dZqr�-c׸å�.���[���]A�$�-��I�u��sS�/aQ���ǜ	�N�&.�9�|�
��}�:S��=Ļ'�����x�[���rLI�~�_�K^�˪��^>k�2ꫨ��{�\�U�1�a�k���v�s{R�9����g�{f����-(�H�˟#�N��k1��*֩����iP��Vw���vg�ݷ1�<�g��y�n:߷�~��>��q�
�����=��K�ר�鴗����1�
lڣ �����.CQ��ik&F����x�.U�P��j�K��i�HD���!f��x	��';;�/眵�^������HLD��i�;��́E��I�,X�`��=�0Ez�!��,��"8'�R3~��E-�����%&o��I���]-�`��yyP
5��~��(�Xa�����18d�So\��0/�>{�����RG�lPO}�T_��
|�G����~�ߪw:̑�?��d�-��3�@.���}����V�
Ʊ�DM�"a�����;z��(}��'p������o�U�{��4�ƹi�U��iƫݚ�xA�"w"}C�6��6�T��X�>�-����]"F+���:�[o:���йA�c/웞?s����}KZu'�qsG��,�������{�����Iz�a/2��k���l�
v��m��.CA��J���6;/`�!<�����T�����W$*�_+K6��Ζx���O�4w�˝�;sf�̌�̊H�:$���m�P�"�Eֵ�ucF��OM8���k�2v*09�_�OR���!�g�~S!�d�3����=Wa`�_[_
��/�%hA��(ql�q�k�#x�������@�Nܼ�	۰�o�p�t	����G�]p��-���N��=x�_�a��s�H�قM��ɶ8�0W�H�[$�����D��o}�����9:�C��ʵ���ʁ�o��͵�yVF�L�����-���]�
����\��M�gigkw���*���g.���5|A�~�Y���ӻhw;�֬q�����=����{�;g�5��H:��ޭ�N�e�p�&B��?�'̰�}��.Q����<���1�괔jkZ5��4B��vb!��ʆW ��?��dt����{�9�޹WD�D$1i�����C
(�4L���L�3F���4�@y�d.�Ϝg�m{��K��X����f:�)�Z��:
h�k��g`��\�<�`���Tc�\�;|���
�ëHW
+�*����N�pp�i�/�Z���9n�cw�μ
ٱ!�߆G��'8�5X���[��qXˠH��HjT��E�oOt����/�p���9��>7�
+T9�%�e�{��u�ܷ��e�+�K�wO�D�7��g�����YfL�1U�qgA�D��ճ��U���X��������~䙷h����{������tϓ���fcuT�q�>)㙺^�w�
X�W��u��JA�
+.G�B��l&��uL�6�$C4�D�݃E!("� �����Y�Ŀ�_�6�������펈E$G�(
d)��·�"�:��5̷2�@�뎳��Z/��WW���1^~ZP��
+2^�g9���F�S�Z=�s�!i\���Ad�+ܧ�ց
l�>\�;|�'<���3��
��s�uv����-؃ځ>sc����o]�\�~���qm�n�_���5��:�&��`�����-���M̉L���y��{�g1�z�����1���,#�W�A��x6M��&��T��Bڿ��p�*��S�]���XǞ�:s�N�x>�#�;0�Z��}s�������a{������;���L����8�wx1Z�����8��/Y,Ű�u��.A���,l$<������M��3��e\"q�B"�6�be�^�<���Tf_f��ԩS�Um�I�1S��7�&eB@=�Ia�1�$�4N:�n1W
f)g���-b
+)r�/�"4X[F�56f�^�uݺ��q��٢��RҸ:�do�`���qJ��1\�9]���
�`^o}�p��۴
{pOpG�	�K�6�ͮS����d۱�ڥ�3�-���Jj;�gx�G�a�_Xӥ1؋
+�U�����`���g�.�5]q�	k���g�z:�E�_��]�^5�NENn���Wɹ�V\��ճ\�Š�:�Y���sX�0���;�$O�qU����;�Bw=���;�#����X����[�{�;4�>w�z���~7~��i��u�KN�P��j���VTZ�WA
+��j|E�F&�q��7����_�O<�)�/m���܊HADbH`N�6�k�2C�qU�9�3���He�ӺG��m�N��[̡a�,�9�G��WL_Ŭ���5�8[��>�ű
m��6u�8�Wx���{�	�DB�0����.���1<���	&p	���u28�uĘz���8.�i}97���rO�!�����~L��i
�u�)2��!�]���7攙�3�5���a�O�K�<:�y�{YZ+	�u���}n���-�q��Ziz�Z+.�����c�9s�[���.y�VcҺ�3��\_!G䉹n�Y��D�wl�v���o����x���/�_Ϧ%���m��2A������Byo�d"7�MRAĥ*nE�,U������P����
��?U'�⫙>��t���HJD"�@���!�4�x��
+d9s����-��-�ųd�<Y��D�+B�k�9Vg�P�ޭ��Ux
��rl�l��λ%/s>C�bj��_��Hb&p�gp���Hr\d�t�>b��{e�
ܓ�l�6�>lAZ�a��om9�
�`��l��v���!��}���9��tٯ5n�
>����u�����$����J�3|�Ϋu֨����߀{�:n�m����k�޾	U�;k���~Sw�l��b�ՃzEG�]�'�?Ӹ��;y�{^�������w_�<�����;���C;�7�D������a����i������o�*����m��.Q����{�x��ә~�N)5UJE�R�c!V6>"V6+������IO&��%s���{��+"���P���

�(k�R�y��H�
�Is��S"�k;?`��A��D�*�9�`���c���`����Ye݊������y
+Y���ʝ�&܈d&�2�h�\�=�"c��3h�!�
+�p	t1�@��n��#���
مǯ��	a�����ZW���nq~��cZ�.l�)��-׾��ľ�`�_3`�s���1����ҵ�̾�y����L����>��o���\bN�_7�\k�g�b֍���)���Y�}��\sM��e��^���ѽӻ�v���y�{o��|�7�'����̧�5w6A�ulZ�N�^ӡ}��m��/A��"q���;��.�m��n�����J�UBS4�W\D"���A� w�I�/���'�;���ٙ5�d�1��@N�(���g�/Kn�|���"��/�<n���
5�T>�yB*1�W}
�$�~Y�^%GȾ�"�#�R��θ
+k6�u����֘�1��i<��>�mS�m��,L�~�7�Ø3�C�k�`�%e
����^3��Ѕ�1vȹ�z�=�����
��r���>w�y��&���v��W|�k�λt�gs�	��̹�b[\k�ȶ��-��\���v��g]���������<}��3��.���"{D�GW}הuٷ�GΥ�x}�4��� Oə�g� g[�#�%Nrg������?��/�9������.Q�;���+�{/et�a�cZ�*�� Q�B����H��^������$�_f�{Ϲ=u�e�sY !eȧ�ߌ�'0���=Ӥ��?��)���*,�$��s�}"�8�%*Pެ'd_*R�9k��8%�m@�l�M>+�%ƪrN��9o��X�}xA� ����p��	;Ѕm�l�4���o�=؂u��`<�{B����(����n�����ָ�xb�S�5�d=�|v�Sr��1�������e�m���v9���-3��R�*�f�k��w��[��޻�%�y�ڮq?zg�={���#�,e�)�
+��\�=�����8_s�S��� g�\�O��t�fRt^�~��w��m�?�&���lMK{�?�
R�t������.�A��A"����sx��֥Z�Z��PE\q	!DXYXX��������$����d�3s�̥3
!�CY�Ȉ$03c1��;>ͷI��x���X,>>>.�&GE�(Eڲ�3����ob^&#�R���>�
+2�|�|Ok}e�J]���ILDX�q���L�);r)��^+̻*{r*��%-�aI��Zne_�������ڕ#rn��E�ms�z��%��n����5?ɛ��#��~�i��O�����j������þ䄲�>����Y�
+{lDb���+���ؼw��y7�/��H��8O��^�=��C��K���W�c��N���X�������W3ڬ���l�
+9�
��v6��g�=G�k"��%��������s"6_�M[}�?�
j�[���mԹN�@��z*j:^�'�-� ��$8'���rp��H�$h����DI�C� Ŀ�_e����x<����ZD�Dd��C�8� 
��B�>F���g�����>%)��(�����P�*T;��`^����j�>�1BG�=ס
�sd�Ӡ
+�r��2���ǬS�"�)r�l�����	��;�y-jC�y�T�6���1�p�>DFf`�0������+��z�O�O�$��`�snq=�_�����<�%r�5�{f�jq�H=���*��XeN�ϡȽ6��W�y%��4/���>�|%2�w`bVds�Cl
+�N�3�w�@�ڼ3
+՜���3��������u�ʳ�y�I��S���3n���z��;5���,���������{PEI��m��.Q��ҕ�����"v�5m�N�I[�.��"���D���H�<V��$��^�_f��9w#"��"�!	��$�C
+|�
�-h@̑�y̛�"`�}i���Gn�b|�2_�}n�_�[��8��c��v8/p�m
�:�
+M���#��p���"�洼��%�l��ߦ������:��2������
n�6h�m���:l3^m�λ��B�&E��j�D�����\�}��ߘ;	����H���*�C���^��k�rO��a��U�4Oϩ����Y�
+���]s�m��<%�}U�5�����|'����дHb5�B�&�7ʺ�d�Z���I��)s����y�1��cM�~�S�Uϼ��E�S��wϸ������t$��f�����μ��@����u��JA���C�O>���iM&�,fsKb�w���"T�y��A��	��<����4�>z������fDdZD��k����Ƥ`rP�E��2�!��G�̹���?��cd����?��q���,��&��&�� ��=�+�G��:��W�sdxv&9�sY���8�9�Z�Z�
+�a��%Ɩ��>[�uh����B�Zp
+m��&c���-'Vs=��FDp�	a,�zF�=0̵�}N����
:p���\k68�ޡK��	�p���s՘C�D�He'��Sa�s�]��6�D�N|G
�w�V9f�T��q6�8�1��Q�z�9_a�qV7��֚֘֋�sRz��e��i��p,�yU�A�{�9	�y>���������=[l\���I�6fs�?�	�D|�Sd�Q���/%��˰�m�K/CA�sI�Fv�����
+[��.ՖV��Q�hh;B<"�J���V"���?�?�ɍ�/73s���sg���D$,Ϡ1eD`2��*���i3'$��Iƕ�#n����5�����(�&���9�B�D�>���`
��_�'N	J1��M�&*�u�/.g,A��̶S���7^�<,�*l�6l�{Ђ}h�:��C8���?�����;���mH�5骉�D�"�"��
"�9�d�7��Ox�k��5O�v{���^��Fa�%��Ȝ-�o��.ֲʶ=�S��y,�ή.gp�}�8V`���������\�[��,���V�zch��}ˌK�\�:.�;c�\��3�`_��g��.׫�/��������h~=�z����s�1����?������k{��&o��H�˹r�����/Q�C"XX�H,E�$�$�>�]E��(��T�"%,+BB,H��Zb���;qM"��̝{�;s���q�6F�d�z/�0�c���	��I������G����?���Ĝ�B�	�w\���:��+<A���)'�+DaJ:5�:�g52:©Y��T�`V�s�ϼ�</�_��ޫ0k����6�.�fT��G��.�<‡HK7�C/����"�C"m�"x��>���������>�`��
+����Kg�C8�:�N�
�K��.���
��٤:�5˺ͳ.�e�f�nZ�E֪�yk�E�myf�(��l߰�:6�.E������s7p
����`{(�l���.�{�ۚ��稲n
>�>��03������g?�k*�|ﾶkݻ���a����~�����W�>

�NU����K/CA�H|;����J�V[-���UJh�xm�"�V؈���!���IO�X��;���9sf�ι
����H��-c����0E`�"���QH�YޅIc�ȶ�P�*�g)�\�d�E�-�y3P�X�%(�[܌e�ҵ&H�島}��<E�-r�_c���a�`�}�i�9�1��J�4c�13|_!ɥ�wU�T�x�pOp
�7�y��C݀Z�h��^ ��^��{@����}��aVa.�^�
�8���9����	��>0����,5~�+�5�a�k����f�D���z��:k'��U��7�}�_�J�}��
+����>�8~����s%�iÞM�gzF�L���|��
�O������p�;k�]�9�9Mr.���?�m���"���k��������N��^��m�K/CA�i#"ai';;k_������Q�h{)��+���H�H$��k!숈O���drb�K�̜93���뜋�?1�¨!�	�R�m7F���_���Pʓ�X�:T�sP`L�˯su�y��"�)�g
雀I��sl8? �O6`
V8�����slv`�aZ�/�ė/y�i���q�ž&�5jr��/3w����
�0t�������s�s�W�t�y�_�}p��(\��=�c�;<����p����S8�c>_���=_!g/|c�W@MCrƟ$y��nXKy�%֦�ܗp�ZTY�E��9Gռ�P�g��x��4�s��ލ�7����)1F�z�tL���
��s�:����n缜�=���24>i��Zȿä��_��F��m�E������?��]��.CQ����70�����y��j�E�7�R��.%QqI���ML$�L�`�	$����e�����Zg�ӽ�����`��\����g��	{�d�#0B#Y��<a�ci渺im�3F	�h�8$�{��'�y�mZ嚖�k��\�<�`�
+n��`J읥�@��%*�����:*��
+��/����7��.�V��p
/�{E��D��F�4�����>a�ڠ:�5_�p�p���s]U>��C����
k��ۇg��W8�f�߲�)\�e��\f�{�F~���W0�S�e���i�4�X��a��Q�{$ū��R�ɲO�2&���(�8.{Z�uoF=����L�{%�������.,��?wQ�c鹶���z��\���u>�$�����
���}��uԻJA೦H��7���-K�w����M�h��E#�
+
+�/����"����������������93;{vD$.���RR���'i$H�ڸ�ɧ�)#͙�<��$���Ђ*�s��,���-��E�)��Ĺ�y-��A�����Y��6����8�N��
/�b��ʫ�/3��������_�:m‹H�}�>�%<�yP$�w�~���a���B�5����������s���u��"׶�|�O��W8�>�����Dq�'�w���-�w��@��������U�^������r�+����m~�։3!ax_25S��6Wc��2�S�*��Z�k��k��qy/��ΛC���)C�C��ڲ�����qgI܌����Q�Γo�`���}��.CA��h��3�{
v���έ�j��][�k��%"""�$��^�Z�;�&�	������?�s�1��E	{�{�W��vWϵ��Ĉ'�1�cy��y�~I��3�4J���Rz�}��ۜ&0�IOU��G\b���X��/`
�8���g\c,aAul^Yk��4FA�7�'ۨaUs���v���+��OZC��j1���	�����;�u����C�o�.�{��j�]�o�[�ת�h�/���=�ZBm�^q�}��g�r�z5��*nͶ�Z��@7Z�[����UQ�_���t����=���^���t_R����XV2^���ݳ��P@"��������خ_�YO���~;�oߡ+�%��k��GD�\��?'���j~�/>^�V��}ԹN[A��1(�B4<O��+�M�j�ۘ-!�̾�-
��""Q����(()�x�#,D���;��93s��Bk(i�v��It!�,0�/FN�S��|QG�����jeЇ^t�t5�.��I��-��p�%��ؼdU+��ES�,�XW������Id�G��C��؍���h����j[��
+�i��<V��Ή��aSs5߰�=�������W{B�S�����
+�%ثD>���'\�D��{�8™�}�渢���i"wj��%��A��y�_��Q�
�֢�nI�5��#�kP��1����͎8����� Eմwu#��S.;9}7����o*��A����.����i|N�Y�qχ�_���}���;_��t�RnN��,���c�:�ݮ�����E�(����K�3{-1���m�9KA�Icao������¯#Ys�Dݘ�#1��DC<�@�@DA�,�lm������������̛7ovG)գ<��GA� q�1�
+,�L�
ac�?�?�����C�1a�9D �gQ����~=Or��|+h��O!�ks
Y+	e؁c��'�����g<�K��!aV�J�0�e�+���i(@�f9.Ǹ�Ƙ�����5��
'pW��Z4Cڏ��:lr�;���H@�~��Fh@�n�.��`�kҖ��*�_{qo�]�ʵ;���v5�˥�-q�=��'x�;�e]�<�4�J�:��wy�yƗ��ÇW7u�<����V�;g;I	���DJ�_�uH���a�����^F���&��a>�!n0s�oK���O�,����}���󈑇������=$m}o�����8����m��*DQ����p�x��ҕg`ff0N�4Ό!�(��HI�"��p!�p%I.��]�oe7��g��{��N���1u�W/!DЈ&4#�^�`���%N��N�7 �<�y�Qܽ��}�ӊIT\���֦���n�5���U�>^5��CZS�����xE��c�'!��>L`�8�F1����E�1��S�3,��֜V�U��/��.vP�q���9�y�
����*��c�^)�/���\��5Ng�|Я%����\!�z�j?���5ω]�
��Q�Z)�Uj�������)oF�4�\�ǡ�~�W�sN�k����Ϊ? �}�޹3s�f���|�|u��w�C��ja"0ވb3j��K��,W������g�o��6��iIi	]��n�k<�۪1�
+p��]�s�^<O�b"
aq���}'��!�;���
+��6���m�KkSA��9qՕ�k��t�O��M�~���4�h/1�6=�Q�-�D�
+*���A�c[T�,�R�t�J��8ϐ!d��33�y�3s�13�9%	���P�E\���~`wp
�FRqc��JZ�s*��r2�,΢�kQk��
+�xgLt�8��{���9��i�:��;��8��.zh��Z�4_Yy�z|`�V��y�q5����;�P��+Ƣ�5d
+nM���w5��k�5����i)���.���)�;F����m�1��6�<������Q�D��q��/���ּ��@W빧�����
+�8���|�:n*�%�w����W�������j�V�lM/��ci����I]9���q�}�<:�k�y\����]W�&�ښ���v�ؽZ���j�6�^��dUs׃�|�_R��3��{
ϝ���ޟ���~�8>�=�� �����ݴ�'��a�?4�n%�
���ݰ�u��OSA��)nM��`玸1ᯀ���\�(��i��b�P�����Jh
+T�Vc���+7�v���~'7a�	�Μ9�p��s��oø�$ҁGw�-��1F�PĠ��U�D�ſ[��ꥐb��-��������}�}~�6~�֋�9)L�s�S��y���m��+w.���^�ڈ?qݼ��a�{�=�zp
]�EE3�ÔjY/��bϡ]3��G�E9����
�)�5~s���z�	z��foo��>���}"�w
8s�ߵ��p��]���b+����,WC�[��hv��P]���&��}�r;:�U��l��ߡ�OXV�u�]
�uGf4o�Pk%���BAl�/��m�~Y3.ɴ��–fYS����:���)=��d���=���gQ�i�Ɋ�'�%��������Ê����[�dp>���{}����?p��r�?�E��̰�u��JUQ����F��j���O ��@����G=^��������SD�JyAˉ(b
����D��K7|�{��_�u�fVbw��!�JT��T�+�G��F�ծ4$*��R&>�/�wx�Z$1^BqIa�hPy���	���wRq.��S��Z1�C�Hx�%�k��oQ�&���<d�=��K��生�)��*qyh�^Q����:�֓;#���)~=x�A�|�z4�.���Sr<C

+񄲟Z��a+��5��e�8�g%+n.�[�1��������w\mWo�����cK}McB}����~�\�/�Cy���k���7Ս)��_���i�G�)�kZ�k���ō�36���g���\�qX�!��s�*�v{��.�Ac���Ϩ�ݙM���u���?��]	�_W��р�bܘܙ�֜j�/.�����>&��^K�;�Xn�Q�
Yٰ�u��OSA��)V�l�ʖ?�=���ZLy#�ZAZ(B  �W��Y��(!�!Ix�$�%��{�o��MX|r;3�����u�ո�Zy*u���v�$�y">O�} ��lD+ZT�Y�fL��b���ML�:эQ|�%α���j�X�ϑ�V��
$��U�[��ݹH�s��:Wx��b��0�A�g��T��E����qcHu�Z�տU��h�U\���Ѽ�co�R��-����Y�o��Y|�6V��\f��<�;L�1}��Crzf���.cO�,�q�#|�fk57��\��5/ۓ9����F�e�Ð�sBFu�/uv��h�:ˤ�}�M�/�����tn��ޫ.�NbW�l�u��j�@:����=�Z4n�5�_�q�+�
+�EF��.������[^��������{\kMi�>>�]',Gm@8����h(�}��/���u��K[Q��НtQܸs�_�ҿ�U��jL'T�jL�q�c�g,�⬨���ƅ���]���]x}�Ň��޹��1ιZWT'�� q��#{���O�I�	)$�(��nFF��<��E/2��o�"����ChCKHJ�M;�Ї~�(�0�1�:_d+���e
��<�|5�
�kL����W}���~�NZ5���2T�Ts����m^_�M}0��@�)�k�l<�X�4f����.V��>�8�H	>j8�5�P���m�
/x�NT���X�S��L}�jT�V����y���[�Q�SV{8�w���������\�ϊ�q]���@ Ǵ�~h���ۯNW<��Ν�?;뭮x��y�1-���`��5��Ϫoy�]�|;�[�������a��\����&ܿw6�u���H\�S��{���b���������u��.Cq��?k/ 6ހ��O`����RcPc��SJ�f�b�6켆���{�������?�?��o�sqW���IkH"�'��xh��'Q�&��H~0n�閴lʩ�I�شɗs
R��'��>顾7�b���eX�$#��1$�y��j~ٳ��G���e_N�s�=�)�"��*�6Ϲ,��
+���eY�7k�D�de��u���˱�Ɂl�r�yz[�\E�bu��\�_��Į���ʻ|��^����Y���&i�Zֲ����|�|Η��e��2�����2G���M��,��\$w���3�[�<}�ٓ��]����J�Z�|[���o�*ꝫ��i�{���\�=
��qw2��(9����w���
S��&ʱ5�#s���%�)z�fo�(W��
��j���m��/CQ��[�?�/�O�5�R�PJ�C[�C�L�!�L�X�;K6��{�׸^,>y���{��=�\���L�>�*Oe �Bc�^Lu@8�Ǐ��^"R#~���bjьA��ùP
�gdЏi�0^��;�A;:Љ.��U9�^c	�1�I�٥<QiW\sX�*�q��6�k#���v1���Lh=i�ݭ�6OL5�aXu.j�yLi|8����2����1#�ʳ*[�Ǒ�w�筿�ٞ�K9Q��.��X�
n��>�s��;^��6�
+�J��+A)��(R��k�-��;͓ѺGu������z3���=��OTϺ���Ky9Sڇ�j��N+��I�?k�;���+�l�'�1��9��P��'�\6WR�&�l��ǖ��SL��ޯ��	�U-M��������ﻝ����-	+G\�H�n/��y?�O�7�W���u��OA��j�`"Áw/\<x#�C��ad�d�]�����}�a�!�(�9AH�����_e:D�tw���W���9W���%b�FT"�W��j�>���s�D�wuh�8�P{L�z���ہ�s�s\9��)�c�Ob�8�
RH���k�_�
��N�X��p�O�A��[�(-j�B&��46�
o0�9m�QLes�Q��9ޢm����#����]9ٸ�1��U[J,�i���r�\��G�Snj��m|V�7�`[X��m�{'�CZ�U�)�����Y{!���E�gSud��1~:��/�s����V�v���\��!�u�sN뷽�^�j;�q�i\���_�������+6Τ���Ψղ+��4�ݿr�o>��f�jo����dk�j|�޺���bI�[�Xִ�V�_+�;���������5.�_�]�\��@D��Q�I����o灝!�.w�D�Ïw���&���u��KTa��s��$Am���;Z�o���G�F2G3�_20�,���|CK�U��J3�A��)���{��p��vν�y�5�k�ou�G�p5!�KknV|M
j�%���F��[hF^q���}�v̢=��*�4+ۢ]K�$:ч"FpMh��]�Լv��K
��F�j\�y��W��b6i�k�N������9�ѫ�!L(�Y�_Ũ�{��z�.�	m�(�=��6��x$����
?��.��b/@mm�<#���q���)%x�i�S>_��%���S��.���j}��w�h�2}���>�f�/s�B���o�S\��	o�^E�__�vң}֙��cG�Ӳ
+�����T-C�ޓ~ǬjQ����Z�Y�|��[��z�'x����6�DgT��_�.�Et:��a}���I�wC$|g��
�_V}9;�_���$��	�\��������#�;�w o���m�;OTA��Y�A�B(��Pz:h()�|
+���r۰˲�\Y`��&�!	�j�D����DH ��V
+*��>''��sf�y�=gf�1&d�0�x刪݋K�xq��N\�'�~׊��������iS�{c��yPo�C�q}N����7�����Sה�3�z�7�8;v��Y����yY�"��N��+�ե�}>v޷�8>��O��_����N�i��5c9U����\�P��>��5��+~`G8�!v�S�Ӳ��=�	/P�Ze���g[�LaEsk�U�Oi�����qE�
+s�u���%�
8g�+�n�&��n��V�v�oz�]��s��ێ�{zk�/i�M�v�#P���������j2��$�9�ߤֲ���^͗�s�ؽ����8����1����:�hD!m��:�̶�I(��|l�=�-��9��}�'����v��Тܭ��3ֶ��GA���
8�*̰�m��K�A����J��V������ٶ=dk��y��Ԇ���v�h��DE� "��.���V���74,]|�}�y�gf�Y3�f�D �2������\?�?��&�x�p�k�ȡ7�xi���D
e|7�ޙ5��O\��2�(a�D���!������ֻ;��
+>✸�� �Mj��HQ
+������.���+���{�����Pn�ksx$��<��J�t��g��>`;��}|�.>���t�m
K�5�%^��Z���+.�&V�J��8�	�s�KUsk������Z�o���S�S�[Z����x�U
��۱�3q��5��xN�
+���	���tF�,*Z�"*�?�q�p�@^�ƈ��o�_���i���Iյ��X�9��J|F�3e��v4k_���������w�������{��w*x��b���q&�����/4�%|�4��e��u��J#A���g�(D�)����[�Mר����qCř���(�(��;zqE��z�[���4x�е��U�Um�)2)�b�
K�U��>?��'�����T�B��W9*рa<��>'��t�7Z�QԠ�#�S�1u��I1����ѡxa�mD��D3�>wL��bgc7k��xd�YH�|�q��[�5�I�V��A/�T��6����4�X�:N�N�dR~��p��c	#�B�:�1 ��lj̒r�����њ���W���������ڷ��W�<�=n��k��y��6IO^kJ9v��ҷ�KB�A�wM{�k;b�� ��ڜ\��Ю�ѡ�4��6�{�b�&uƢ���V-���&	͍+ߤ�蛏bW8�w�{^�!�5Ǟ{��)�ؼa�+L��ٻW�
�]v���jsD��y�Wܐ�٧�>������_���|$�����u�Y+�Q����F�
+�Jފ1�X��Xǖ�5{�E"�'��\H����ʍߙ��zz�ŧ�����YcL�Iȇ-��Q�ڃ>
��P"F�'^&��s�*�i�ʩ7H��ʾ���eQb�(�RI�
+Ƭ��^j�cc��[n�N4ѿ���L��#h`,�~�!aރ�#��$e%�O�=�����߅�b�e�ْ�c_l�R�ɦ1���r��r W���O�R��Z}S�-������ʱ�k�sX�6�Pn�Y^�Or&�|wL~;�{y`
78%�����+�ق��,l���#
���=kG'�`��*����=�7yg-�|e�i�:ϙE9��Qʍ����{W�Zbn^�E8�irعvK���yc�{1J�~Ʋ��ܣar����c�?�[u\ܽ��97�{��v�]��!ߘ��L���L'^��u��NSA��u�^��0��r���!�Jhiii��p��
4��0��TML��1��a�ِhXcX���w�D��'�{朙�sg�s�ے��>��;��c��;�i�bEd�V<��)��P��Tc�2*��
^�_��E����/���|eՔ�Ƣְ��9����FqW�eՖ�����m��й`!����c��:V5F
+j��b}
lj�&�┱�K�t��/���0�A�>�ޣ���7��I�ȿ��=���q^��^H[����R�*��"�o�F{�k��o���ݛ������j�w��XK�皋3�����w����x����Y/��w�š���ֱ,������[Q_�}���[(vN*��\ϊ����y党��qK�+)�����Kʫi>�O{f$�{h�ο��}��dZR��Z�����ڗ�W�r���~��xM�c������:���u�;O�A��󂕡4��ۙHGcAAE�_@����evWX���{��
+�& Xy)F
+c$�Xc�ϛ�lB��23gΜ�w3k�sM��;��[$q��ۆ� �4:Ѯ�.���w5��}����J�/�\}��[��V�S��w��I*hg��z�W2�k
�1�aL��}��!�g]C����w�u��>���e��K͝�8&0�Q��(n��C�wf��ר2+�<���}�{|1���c�8 �*jq���T�21�lG�|k`=[�{�6�E�5���g�����c���&�gQ|o�1�}k�{�=�'��܈����
��*~Z��sl3vK�~יkOu�~�����w�S̴���{^1݋)�z���Y�^����DFۯyq
9+�ͬ�YF���w��Ԕ��p��;�w�?����.���[�s=���/b/Q%�%՛�O�����:����o����)6�2���u��J\A��n7.V�q�p����AL�حm�m���JB��8�8��"�&
+ua���@\%��߅�b?�Uuϩ�1��dՅ��p{��4H���?�hAZ�{3�$&q��JB�A� ^0�Y�z0��8��*^�˓���)on�g���!�.|������!�Ė16���i���W)��S�~�%,c�Z˨��z�
h�pM\�%�iL��yϧ�}8�O9�m0��`\
jAn;�t�%8��ET#�~�Zdžr���B1�s25�9�%~�W��͢���ZӺf1��˳";x$>눖�s�pN���=��y�I�f�m+A=�R��G���-�<�4��+�gi����:�AO��ߩ�h����C1�7Z׀7�^�������)�>��'��P_P�i�w\�&��'���y����ƵkT����Zy�71/2$������d�K���^�g�`m�����KTQ�����������E�Z�+�h���c�L�hM��YJX��QD� 1���EJ/�&�E-\�&���������=�9g�s��3k�XkB�$�^�����ۧ�@g���t(��~ܯ���x�req��z��#�w>���ܜ�$��tk���^�JN�K҇x��f�I4� ���E;o�Z4�8����q������2������stc(�y�sI����Sķ����p�U|����G����%_{�p�v1����
z��X�?�kq�UTO�'�x�w �-��x��J��ĺ斵FI�<� {��1�Ģ#��w��������Lg��],���v��������(�����0�˪7<^�-K����C��5��cT�A���Zs��j��m^y�5��|������*��'��K����Q���;F��R��T�t�~���/���������Ι]K�G��}��K�Q�����m\����?�E�"7�m�L�a̗23������"T��BAM��M�#��P�+A�����>P�s_Ͻ�>�N�&�W��q�)9�р��x u��no��������>��P@�4F񼯠r,'��M��c=~�k�غ��
��zI��`��{C�PϒO�>�;�o�f��x��4F�#�k�aSQ����pH�2\�����5��g|�.v���A>�Ёl��o!\(�M�'�Y�Q�U�-��S�+��#��A�W�^��i��)�����%Uʃ�L���Y�/X+��w����;�
?���:��9��cC:�
�*�8;�
+���o{����C���@���Z������~Y3��\��]0.�Y$��þ!�$�i/��.<��9��vg��(���q�_7z4���o�߃���y{������^�,������[�w�k��H��h����?�歰����KVA����k㪕��Z��ĕ�H�	L�x�L"�B���FY�����(H�b.E�uH���78�`->̙�y�93��m�3�(w�H�Њ�8'�NՃ0.՘&I�3�UBA��]�Q�E:�ߍN�ۢ�q�|����0�i�$�r��b�k�rGq��%��&�O��j�q<V{
���?����Tycx���^���~���c�S)*Q�*C5n�����`\.O�i�Y�����
+[�/��|��dg���
^c
+/���I��7p��<e�q�:y$���U��cVV�W��;�b�q���pϵߣ��g�/9�z�^���{_�����#6��5z��`=6C�f���A����f�\0�m�;z�+���߲��g?�ݑN�3��;ճ��*?���>��1�ڋ��^�h���ݥ~��M�{g����K�����M���W:��m��KVA�����JQp]]�q'X;k���?��W�T��A�����]DJ�$Ȳ�҅$��B`�m\��;���ap�᜙y�˙9f�lf�h�i�fiQ{��E�҅� �S:����Ϸ���d�|��/�q~>N7z1���=�E�ڝ��ң|�y;��{'0�8v͒� >i�|�%����(�����x�/�X�²��a�~h�%ʧ��ĄLa��
+��^��=�_���8&o��(G�e��
�s�\睾����o������Z}�6�	�1�q߫nEk]Vy��'Sc��)�)㦕fE�̊�p��M���2}~i�Z>h��C�kфj�{x��x�<f����AN;�:
+sK.�;�k��#�bXFu��Z�o_k�Q���8	�*�;�<7+e��8��m;x�s���s�ϥ?�9��v7�Y����(�='Ox�;��=�����w����������u�KHQ���ܫ��⪍!.\�h�����mk�:�+���iR*�""�Ed��ZbEjO#�
+�Mb�}�w`<���������y����,�l�UrV�I+���
�Y�f���A<HZ$�qp�h���ۇ����Kzq/��qKu;��zu�%��6i��w��퉵�W�W��,:�G�y��a��!�`�q	Wpx�y,j�.�>&�zU�݈�cD5��s��3���m�>�'|�?ԫ�T�����_�*P�#8�Z�X��,��,Y�&�kV��x����i��+6����'��R���n��ߕd�KJ��ޘ����ߙ��#���T��-�����������ú�닸���#r8�c(ל��]�(���lЇ3��jj��:Ϊ�kZ��<'���+��1E��ngc{��=������<��߷����������c��ɟw&N��C������?�>'�w�
�(�b��u��KUQ��u��B!�A�4���,��/��3�M�j�^�Q�HE>%-{(IH (EQR��B�d&5)�X40�.�o��`������8k?�1�Z3;�s��F��-h@�J׌K��6%�s�Q�K����G�^o� &pWSy�'�%��Կ�̢J�Q����E.�
+zTvh���Oh�V�хN\L��5�)όp��WU^��!�P>}�����/���*���x��x�e���5��La\�ƿ�,��a:�C)��E8�c�K��u��K���J�mR���2�}�
꧈=�.�_�[,`���i���	d���<��fG@[
{��7��Ǭ�Y�_�=�]��
}������9?+���)��L"J#'��=�9����/e�;���|O>(6��]:w�߭3��|�|�s�&���1�IpƑ׫�-+�v��4W��
�A����'������#�O��$�����wj��-hK̛�a���r;�I��l
��c��u�MK�Q��sGň\eE���
+����w�&p%63�ڤ�ib!Y&�FI��%�"�=-��Ѕ�n
+�*$Q�{��.]�\|���w���{��1���]�4!�^��� �f\F'��.�k=+!OFr�F��t�~QZ�.�(�������E��K�4K�~.�B�>n�����J_�s������4��C5����M:�S�}��W�<�{Ǽ��O1�^���_1�A�g�������0������z����
|��;ٷ}�8�\~m!��p���x�����
��9�T�+fEf�o���d�!�;��+�y��S`ߎw�8�N�����yH��wӬ�>�dl0+�EgY��������nw���G�b~V}T߽����i;x��)��'x����{7u��]�N�q�	[R�G�����a��'�:K��k�����l�g��>��9�ņ�l����)�o����j���i-���)|_�?#{��Ց5�����KTQ��sG�\.��XH��h�	��ŜQg��i�)�i5m*�"_Ph�
A�VDAA/+qD/�~����Q�Ň{�s��sιι.��^$1�� ��ط<���B�z����ƹ(��Q���&�����)Ş�^a�0�z�=Ƌ������9/�XD�)�ikBYcZ9�qR�V9�>�rY�ZǠX�Q���6��2�x�m���??��-���*f1�ze�{�9��wl��,h,{�ዼ�
+汊����s�s�/�U��Zq�e+:�$΂�GN;�І�?"F�8m~c���z��o�[�Y����^����yp
+�?B�=��3޿c]^?��`K����>�Gq��G�'��[2�[�����{\g����չ���>��CA�K곢}����&����a�L<�s����z�&%-v�$|�M�Np7,/������^�YvG���4�������g<*��Sj�
�M�����KTQ��3��B(ZI��D�A�-��&t�g��4�V�2��Nּ���ɔ6`�HQ.�H1��E�p�"�{��.\�BZ|��s�}��<��k��o\����$0(q���,i>&	��#Q��/��o9�1�$1�I��#ֱ��Z����|	�!��ֻkL�"���}
e<�~� ���ʑV�ʗ�Zۃ�QM�tm��,/����wx�%PB�Z_�u��+�?����,�9�ZTۣ}��-�V;w���/ۼW�#7g���>U���pL]Wp�
�Rh
+�mL�����
\@3.����CM���C:Њ��������	#L�
k���_��'>��e�`C�ƞ���^��I^=�h}U����̪�6�+�g5��űy�S�a�6RS�-j�{l��))FQ�c�ט�;L���;�Z�ڞg{R�q{n
����q�߳р����C�""��b�ro��u��OA�� ��H1�bB�x������ƓG��n[Zʋ�%�(P[�B��%HQ������z�p |��M����'�����̳k��gBw%))�q_R�}CP����e$���������3��^@N��)&�0�����K��w��9V�	�\Q��}���5o@e>g[8�!���\�2�a�X���\9��a/#^+�[c)�5\��QŬ�1�zU�RQ�7XR�W*7������#�W߶��{:�������\ێ��;~�*n �xG�Z��r.��X��v��9g8�/���K��qܿ�lI�۸�^��
+���-]���}�~�glD޿&uYԽ���Y��|�>��h��h�\t�Xҙ�u�S�{b��\
��^fo̹�iL;��X6��{�'z���Qּ�r�����i棓��m>G][Ns\ɰi~Wn��>�1�o*�����?��v���o\&���������/�������m��/^A������Κ��Y4��������[���kP*��EiW"�i�n,ؔ�شbA"i�&|��ojrb��9g.�̙yf̬���cj����R�'Є��]���?��X�Z�S�t��z������v�k
+����]�$:ч!��k�K�A��oS�6�P�5�5�����]�a#x�=��161��a�cKHaB���X�
|ź�&4֘��T��O*�����7�aΏ��|W�5���}��.p�\)�g|�'l���W�j,���*Q�<A1rh{���8�i�<�P?��6�;:��+^��58�/�;Q��cE�0/s��Y��ρ��z���Zs�nT{?�}v��V{��Q�ڹ�|aNef��I6����,�Y�c��������M�CJc�\t9��6iw��4|���VK������iwyݪ~�|4�ϕ�s�P�?���h����{ŏ��~����?N����L	�ܰ�e�OH�A��y��� x�(�!��^:��Nṣ$��]w�u��2���V�j$*TB��Bx�.��Q<��w|C�����3�����:�],�d�|/!��/�	��]ϢO�ʝ69lߞC
E<�A�я^�/�7c��KNmY��L|4�F1l)�7�}�*�r.��2:y��f���>����5�c
+O����RR����=W܏�S�4B���=V�E�q�u��)�~a����#v��ޣ�hC=�]|�g�{��W�n�͸B���z���uh�,������Z#�}ı|��n�R<��|M��\�����bX�Z�)�]�ڗ�~+&^R�C��U�Y�w�zG��=Mh\%�k������s)֗��a�Ս��7~�6���<�������)Ȁ�sa�sQИ)���}?{.��{n���y
+�8�Οi��72�����(j�៓��Xg���x�x��m��KTQ���:�*"[���U�kآ���Z�����)�K������S�,5��V		Eh���;�{���.->����s�s�f�a�Nt!����x\F:�qw��湏~�EN�d�3�[;��Cx(�ރP�u'�VVc\��QPL2.��P�5�A�>����E	e|6jю&�߱���V��8��h���${�z�eՋ?��=c7�<�2�{~�q�pU��
X�[���
��
+Z(��
����&��Ne���/�\�L�����$���x���R�f�4O���f�C�w�z
��&u��1�
v��њnm���/�;�-��5�aZ�-�&U��9Ω�:{��G��r�����Y�Ū�(Gc�R�ͪ�k5�^�^O�K4��#g�ntF������=(H��roB^
+V�{����v��;�V�kN|�:%n��ڒw���Y���f�
k_�U�9�������=0��u��KUQ��u�T'��f�
�F�
:�kz�>4��+�jVAQ)e/ҁB�
+�����H ��.���ဃ����^{�}��fv�̒Vh�jb���:����Z�_G'��)�)�G�5"�fܔ��E�i�5HJ"9<�0�`�����H���|��j��7!���z�z0����`o��x�}����}��W�E�t�W����Xm^�]h�NŇs\��~o�F_�=>aJ���Y�Ņ߶�i��K��0~�f��_P�s%c���ט���N>�;V��U��2~��8�=(3+"�ɫf��і�\�5'.�{��ȕ����X�z^��yV�L�|���~M���������uvz��:�>�!ŹG��E��"�W����.us���}��-��.b��+8��j�g�ÿ��n��$+�V�ޟ>F8���t�|�&;�N�%ɟ�	���!���47�=�{iV_�?Ss��x�����u��KUQ��A����H��t�᰼W�U��#E-�b��Jm�c �o�2	*+�A�Qh�𻽿M��
>��k�}�Z�3k4�4��.�iII:R�X�b���Ϙ@�r���hE��ym�)ޢ��h�I+�s���ml`
+�Z�Y��goվ������c����+����Ő�>�+���uz���Ǵƽg�{����O4�=�G�:~�ײ�E�d�ԗO�ѻ��7���f��̒jP_w�*��cI�-c/�����������?p��uP����/�bVJ�/�䞔�㼧�����;P{�3�R������g�U���NnE��]����̩_ê}^�׹�RG�>ND}����0����F���j���*�@��"vʵ�-)����_i��{��a��
+g4��\t߉{�����gۿ�+�m��5/c���L�~F�$|�����sÜ�v��)r?J/~���u�?hSQ���"1�[W�W��u��ѭ�KG��柩�-�Ė$Q����D+���E�""8	�1��B�����~����s{ν1���%q��99+�?)��})��Y�1�����D�gpYrj�$#~M���im��
+/p�(�������wcS�"�<�/Wq��w��&*��T�����YV��Zd���Ʒ�!nimY��_��n`Q�+����;��q^c��	߱G�b�dq���x��˝���֕������U����8J��b����Z3;<a�8mD���F�
9
+�����x�Xı_�U���s�?�#��T;w>bZ7��k��,klQ�bE�ʵ�_W���H-����ݕ�r�u�vx�`�0F��j��NNK^�]�o��k
9����ϊ�vw��:�	��c��3��yi�������}���F��گ�A�+��
_�̰�u��KTa���8�ղ	�v-�����@���4s�i�4]f0���P�]� b�
+jQ:F�X��� MP7�B���w�0��}�y�w�,if}.K��o���@
+<ź����;&0�9W��� ')�%B�R�5n�~��Nk���G	5Lc
+���A\���KKF�/�5)(�]Lb?�
/Q����%�vk�����\�SU������V^��t���F0�|������'Z�shbV�]={�%�Q�.��	
ݶ�U��&~a9��s=��b��>�_s�(.�9����;8?�K��Y[�Y�o��yڗ���٣��9��)��E�|�_���^��y|�}'qZ�x�z׸��F祮ڌ㡾�������TϊjW
�k�WW]\��)��vinU{6��>�_�:G�3ܕL��>\ך��J��zQ��_����������Iۿ�%�+�ɵ��:�?�?B�`}0��}O���(9�����OA��Y��AN`��
� ��r5��h[l)��_��m���b0�K�)1JQƨ��1������~����>����g�}fv�1gM(�x�IH�?ܼ���2��"F0�FF���x���t}��#/\�:S�D�3�1=5�xnބb�xW0�:>��.i�����yy�z��UŴ�uT��j���9���Pƴ�TpS���ϱ�'����`ǘ`ߌi��^C/:��[x����{�|�g�X�x�u�ߐ��:��֍9��?Ž]4��ߌ
�܃Ϩ����`}���0������}�a<�xS�|�_ƻS'��i��wo��Pmna^���z?U�ܻ׵v�
�HY�h��6�+֢��>sԯjK�˚�����seϒ=������s����$k��1]�܂c��1��q��tX�V
����:6��~��+�Iz���<��h}���������_KTA��9��`�/�_@w]�*�/��"w�?k����Wmk��J�4�UWC7e��E���P��@��N���Ň�g���<3�Ƙ^s&��%	�@4��Iaw0����GZ�~��Ήsst�6W���gNmC�-!��K��
Ϡƅ�r��}���gx�9��Ƽ�9�b��ͯ�\��7�i<���Od���6��1%}��?;��:��=�F�j;0&h�cb��w���M��1���-��{�öԕ��q����G|#�eP��u����N�~F�h���_��D~��͸�2�t�
W$N�o��ĺ�r�\�/h�+�Ϝ�U\�rc�i�������_S����=�qeq����H����4T��X�K�׾?Й�P��꽪<��t���#�9�}#�-��eωMK��YQj���XwprZ���p�6�q�eXln{{=	O����q)s���-�����u��KTa���;��he�Ε7m�opQ�����8�X�Ԕ�S�6N9R�"ucQ��P"]A�$�i����� ��2ρ�Aμ���3f�0�nt�/w��]�r�)�� �G����H}XWH�~A���!ב��C�2j�������$#���b�YP���1�qw��׏���>A��~�<ĸ���i�cQ�UW�m�1�̱�;o��z~�7��?�����h�l�jVu��;ԑ�i��/x�Wx���ǒ2W��-e�/~b�R��<�/���|�&�6�IY~ƶC`[��h󏷀��=�<�V�C��������j�w��u���6��=���n
N�x���G`{��
��:�s�}1R��<����y��^�Pƴμ�s,�LKRy�~@w-k���_�JN}��U����甤%�w�̯썣��@��)��^�|7ᜌ������u�{OH��"q�����?�2F��m�;HA���SA�l��,�(D;��)���>z��Ө�9�'*�$� *�"ZH�mѼH�l#��~��-��Ň����3�3�ƘjcL5b�W?��XH0>+1��m�I�������
H�����;yq�:ѡx��ީ�T~\y�����r�K��6>����!�5�3f1���4��2��~�kܪ��ѭi��O�6��5l�.��
+�x
+�)7&�8��K�^�{�S��&vU���?���f\JP�|��kP��	���L�~��6�✘�k�C�Q�1�Ŭ��ͼ9܋,��_�'���7���_���Ǽ�G~�7��+Ư�k�g��l`F�a�kz�[گ���Τ_g<{��u���as��B��������Q���oCw�Cw-��&4K�r:%�~{�ƿ�Vp�����%h��GvO��j�wĎw�+���֫~‰E������>Gl��=q��e��m��K�Q���Z��r)A��&a���l�6�qg�45��mfs��jQ)�)ڕ�.�%��j��6�.�{���/��p�<�g��=ι^w��zO��c���}Q,�'�H�����ƭ�c��1��0")ŭ_I���!�}P���%�"�,���*f�O	�e��#����M�1���?�=�-`\�`s(���7T�*ʱ�%y���8��8W�
����<���	ﱎ��O|�_إ�.��]��;`�u'(�t3n�
+��B��՜�6���m2�$98ˣ����sG�Po"μ�?li�˚���V���/���N|fl{�Z���C�h/��ǻX�;��K�����b��Rҙ�OA3N������*IE�W�wp
ݻ��c�p���;�yd���g���bߍ���V��mm9�!�#Q#_<b ķ�o��{}����Uת�����K�A���h�5H����C�����-ݟ����n��?2��4"���~Q��%"=tQ;u1�v�����g�Ë���<����<����F�d@�HB�<7���<�0���~^�o�ϟB9��9�)��I+����c��l�?�"
+��FqS���1TpE&1��x����i\�3�u��2VPÂ��$�N5�܄ڪƼk��۸#K�h��Ϭ����~b�+:ʜoZ�[�K��'c-8�&����'q�a�|iYt��3�'v��z�G]{�~_\�U|���sy�ڴ�GP&�}�/;�q{�E<P��jG'��l�@��[��
�YEܞ�n{��|�3��<w~�
w'��r\�����:��+��_�~��kl`�u�úw���)����>و�ﳿ�)k|w��ۿ�]����|�#�G�d #n��w#���{�7���Z�a�����.A�����n��cx��h_f,cI�$�Xc�H�X�>����	'����v�*Z���tտ�w���1e�wUR��@��v��R*���w�;�]�ϩ�R�D�o�q���	;"�:�G#�Ђ��{<���F\z1�lbS��י��p�k�c^c:�!q�ѫ�F1��GeL�YI �Wc�bcBm�d��Bѯ>�C�[�:��A<�(gᵃ�w�9�}���9�\��F�1�ֻ�
v���>�c�oɦ��<��GNu�e��<��\���;��W���9�mF�]{ЇIl �s�3�X�tI\��v��u3��<�nR:c�5�kZy�h?��[�l�j��|ע
Ě�Ϝj(�|��Q�1?�{/l�G�o��?��U����(�~�yaͳ���R�ۣ����I+�Q���PVv��,lY�yvv���^c�<G]C"��!2$))��)ea��=��NO,,>=g�?���cL��]��"�i/W��J��9�?�׮��R�:4��Wy��5�\�Z����;�A4����d�Θ�x�!�1�v��氈Y�eT�d
+[�����~��YZ�S�0�L�l�0��a��w/ᒵf��T����������c�x�?��sb��\�#N}�ߍ�K�G�	HF��Xs�9��)�o�<�9�`_�=��ј�	�;�9�Y�����m����u�w��n�mEc&t�����,<�ly]:��wH��W��_���u�+�Qt1IH���W��}���������.U�{Ou/Vq�x���ˋ
+�3�\��w����������2O��?�ׅ��o7�寋��#��/�������J\A����[賸2���Fq�+�6�ݶ�F�Q��yĹ�N	�8 h 8!�"
+�ƅ ��Eׂ�ŏ[��SuϩncL���詖*��J�u~ԓ+Nx�h(fL�@
��f4�>����3��s�u���k�H�S�D
+�	
+����#���[D�b��CVdK��(���?��)�чo�����M���	��
R�)�^�6�8k%61���c�g�5��?0����rT����������
�U�O�E����/���$W��r�ܩ}�=�q�c`W���vtV��L��3��/�T=&1�q��5��}��Λ�<�oF0�5YT�^Ps�-i���>��t�^-��֭�v�[rR���R��꼃���&i0oﷻ�uj�9��Ş�޹�օ���{�7�W��D���>���������c��B�c�z�_�h�����K�Q��g�\�_��C��BZ�ܷQ3ǙQ����T�fI��/�%�+R�`h�6.�D.�6.��>��/S����<���Y�Eڪh��ۥZ\��
+��q�.�t�d$�"�!�ǽ�^t)�[19I+�	���[2�ߏ,�%͒�ͮ���6��lP7C�6��M��$�(���x���&��=�����P�:�U�ccMČ�|�IL��6�7�s����3���U,�^k=��m
�O6�	�p=�x�������	G`��+��Eczy���MjN���滥9~��:�����O3��u�(��R�><�}�(i��g:�V�^�j���sL�2�s+�,�L
+�+���()���7��&���W��=��e�o}�+~�����
<��^����tV��A��,Ą9d���vL�������G��
��)!G����?�h����u�9LTQ���Ğ*Z:	t$t�6TԢ0b���A6Q��
�!�d	LD�bK��5tD�-	���^�y���9��}3k��Wͣ��Y^���h�|y(��ц$:Ѓ~|�|�2�����_uS��G�*oG�x+����w����Y���I���
+���̍��(��Z�����8ß\_6�6��f�Q\�ڦ1�!qkİ�NbJ1������=
+�]�(nbE�y��|���%�>E�WP�g(F*QD�k��P���W�vO�Rԡ
�*?��%�9n`k����ۿ8�o�Y��nD1�����긳��3���Y���kߨ�WZ��YqPg4�MF�9ўq�Kܢ^�pw����|R�{�ĕ�eI�yo����s�$���[R��ާ{��m���ո�=�G��ƈ��J,�7n�!�(����_KTA���^Jx�7�ŗ�}����B�M�U�TBV�6�]���V�@
����+E�*A�Ho��7t<�x�av�<3��gf���Y�]����!�K���W��u"�^��0�X�'��,�	�'���0�I�cs�k����ѧoH�Ƒ�)�{oV��*��0���N)�+�[0�F���
[�V��Q�iqco���?cE��*��l9,�6K������˪�Yw���WlG���]
�/ ��?���('���O���s���k����5
�_VAK~�C����Qܾ��v�0�
+�������QlVu�V�����:g�,�z��|]�Lk���nj�.jW��!�:4�O��ތb�����
Ͽ�Υ;������3��ܝI��s��.�)�k^RqN�ݾ�Cү�������H��7��/�<�=�g��OD֎rkt��C��]�=h�A��{p�b#T��8vrҥ[�nqv:��I41i����AŒ*��&���B[TPDK���/`頃� �K����=2|x��������4��l�ڇĖS�HJҸ��j�ℒ�Г�\_F�
+(��9|��H0`L�1�n���@��e<�C��>�n+�ucƈ�ʫ^�q\FI*����N���_���}l�ׅ�8H}��j�u\��S[��M<�<Q�:���yEcj2+��@�Q�ܦbY�x�7x�?��z�A���,���G����w�����+6��E+_�7Q���΁��(o���������ʫQ��8�Xv�qgp�1����+G�=�A/���S���r�^U�J^���7qU�[�Ʀ��~c���5������|fs�bˣ&���\�V[Ϛ��X9��-�y9�ɪ�s���s������|w����i-�_/��a�O2������wZ����a�{��u��KUQ��u�Z(69
+�AAD��_�? M�f�zK�[)I��� �Դ��dO�B%z� ����Б�~�=�E��
>��X{���>g�Y��j���rI.J��� ��C+2�߇�{=�5i|RhkF�Ё)�6��q�,uެ����f������M�w<�S�Y�O�� 0���
�=�93��4�uܔ�����
+��p�z�)�^c��A���E���c#�,��L�O�B��W̸<���1�x��I�{�u�k�?���jpgPM���>b�j�KLQ^S�t�⸈��q�Gp��J�{��M�F����|%��A�wj�������������?��!UI�}�����@{,�:+?��s�'μG�ø_q��\�����m�a}%��+�-�I^B�*Z$#Y	m9�b���&����z�q��NK����.�y����p4�/����}]�E�غ�����G~��=�9qư�]�9O�Q���2#��@B�������b�����ufp�Yd
 !(�D1ƈ,nq�
+���

+B�������
7S�2��ν�.cfWm�	匄�e��,���5iA�Ѧ���f�x��S���^�B$/�}�el�%g�R5f���<fv`�l_-��h_���1&�c��q��w���ZG���V�u�-���\'���{�;(�k�!�c@�������� �)�C��^����4>)穨�Z��z߀=�|V��y&���f�
ȫ
+�1�$
Hkn���e��J��i�Y��}�̫챫Q�Ur��U���8�u�*�	�2��o1�ث�9*΁�)�N��
+�MXSN��|_��Y�3Ms����=P>��0�9����\:u��Rҽ��:�a��b�A#j��s+��S��87�[:p�v�+J���˒��~�������.���5G������aLN2���m�݆~��y�$S&[&��q��ݮR$��]��K�Q���}'I\-�	nm.ܷh�?R63���H"e]�EQ�)"*ސ���!]t��7���q~^f�a�sy����<g���Kh�%�o�?gЀ&�J;�у64*>#颶��Щ���Y����9�	l�Ef�K��S�R�tq���5�?�1{��a<�=O�'��
�k�ZSNkhѾ|�K�b� *�$">��o]��2 }�O���߬Gm�OsF��=�1<Ǥ��,�X�*�p�}�_�f5��u�i�sMa
�����k�q��U����\���o������kx~�����'��
+��紃#�ʼn�}�;���h��Z�ǟ����?g1?��S����o�\���7�g��]r�Kmҷ�}x�<�;������uF~���׹��!��:=$w5������|/a��'���^	���֦t�u���.��01�[��C<�׳ߥlB��9�qw$��0�(!6����w8�w8ćv�H�H�?��t�
�رx��m��K�A���j` x<K��cx0:�Gx�(�]͵�\]5��*��t(I;�K���`�!AШn��C(����gp�=���w�y���ΚY���P�Ŀ7�	q$��v<F+Z���3�Y㻐A'R��D��Ŷ)f3�nM��1+�F�Yl��[��c��=����~���]�R�t�O9��W�(�}CZOF�\�qmO1�9|_����X����1��asx��X�{�8�_�`A���[��_��M�~���&�����=.�YL�n��/��ߴ�#��+�j�QwTK�)~*.��]
��.j�����'�k��q���k�u5��B��s`#����mT�b�/�K�}�˲�k�&TC�G�����C�gu>i�i���γW���m�����	Zǂ�ߙ�X��t2���{qq�ڿ���*紾�a�u���;��d\�K��G�K�B�~�{�B�]��|�M��k�����U_���tK�����u��KTQ���:�h�&��ᮝ�j��"��N3��2���5M�-���ޥu �L!q#�B���+�E �����Mt�a�9���<�9猙����	�e�"�2�R_�ޗ���3?�Z�Q�)F�Bc�4�1��;f^	�1�;�}C;��&$����S��%�5NK�/O��i�8��Р�:�W'�/�1��ʵ��'�S~]���3�@F0�%�ѼilbS�+�+�=i�?�V��<���i�ĸY5�[5��[��ѿ����Ƭ��λ���|b����&���W��>�#rX
�"�
+�-��w��>cT��?�Kk_�-��
\EDk�)��qm�{ ��w���Y<��whϣS{�kߚt�ܞ��بߠ�U_���[�5�	��=)n����������F��7hUW�
�tAu�Yi�9�U�)Q��%!ɐ���ɘ�����Ԅrv��Z1�[/��O+���e����������e��K�Q��{���R��L���mmruޚF��&���BJ�!RӁ�2�T�Dİ�EQ�҈vA!��8��������<�美s��uU�qI �k�F
y��.�����ݡ�'#����N���9�`e��6�1�('��l�;i�n�_y9�-����U����L���"}�B͂��KA�JU���5&q�实Ǖ�����'�j<��.�<���`Z5�(�s���/���g|�݂˨�sM���.��������X�K�xl�6{�Y#�=s��o%���?�q����'q��?|S|K{k�x�9Mj.���*�7����,�%�PU{��	~b��}'vgpVcy��Ⱦ۾
�������$���
���{�>�����3Ή�+k�l��T��=�1/ig�{Rӻ)��;]����X�ޏ�����IG�s^�`w�μ�ǧ_Q���o�#�钬�;�5�j|�c�W����?���]��OA��bL�r�l�ś�^�7�b���E+���5�#B�&
+DES��� �A! �E������0��'۝>����ή1暩w=&OH
+
n��o��Zc���I���:���ǹ�vŤ�wCk�#�r�C�j�(.TN���ڡ�7�[�ǭ3��ޭ?���t͢Wu8�UO4g�Ƣ�]�]����0�a�����#���1�4N�{�(i�'�+yceLa��5���wk/2���}��.���쵽�s�laU����ec.����Ά��e����-�����z�>��O����ꡬ~��>b
�_ŋ��~���P���
�:涇p{C����+�Y���b�!/wt6��Y��H���+wLF����F�R}}�k��j�q��׳�����7~)wB��3�2��Z�9y����=	M��ɨ>��C=�]�U�L��:	o���I��
�}K\��V\���������}ԻK\A��s��]
+k;�4�'X��7�������W]u}k|"Q|��E�!�S��H �(���o`�"ŇYΝ93g�kfo,V#	��S+�hD���<w��5�wm�7��蔖 ��S'ɼ|��Һ�jK�My�0�[�K)W�jˠØ�>"�,��W�>`32���I�ƌ��c��&[��y�*��=]|	�q�s��s�A�>�X���E�Kp��w�B�xp�[�����<�B{�`�p��r�F*peVPiV��q��Y)�b���Ul�3�j��.~ʞ|��%ݑ���O��I�S|]y�T������8�-8���WT���{��u��z֧XW����(�#Y�i��@V=4������ط����G�~n�8V�W��0�E�q}~���������}/)��jҝ�QI�7v����Y��������d�7�5�y��'�٠M��]��J\A����`p�B|�@6��d��{���v_牴ġ�q�iѺ�%�9*&��A��	A�ԅ�Cʻ�q�֭�ԩ��{���N��
҈$Z%�h�@�q��MH!�4��u�qIID�������%�b�/�����o��Ӫ�S/1��Lb(������C1�wx�={5~_���U��b�Z���^�0�1��3v�����3�vZq�^S��2�7�[�x�W(�������6�-�X�N�w���|s��W�q�Q}�5�攧�g��i��1���19o�����;��)�j��pM�x��%��U��c�8�yJ��k����=d���Ow�Q
u���{X���hn���ڼrmg��s���gUOV�m._��'�X����8�x��O���W,V3�����m:�ռ��I>��rڿ��.�e����F��?"������y��<���m��KTQ��s+$f�`+7nۋ�����6����&u��q|����p��^T��	�,A��V
+Ѣ�(����..>�s�y{�9Ϲι�;u[Zp+��[ڥM�xkˠS��V�qC(�'���d�],�F��3y<@A�٠o����	d�9<T�O��(�J_�}�!�ae��Ǡ�>���~�k�.4���ű�7�z#*m�a�2ƹi�e��O�5��{��X�&>�+�X�*�c���U�h������lေWPG���'����7�ܑ��o��4wMs�����Y߰�wX�����X\U�i}�5��/�[buG���TOl7��t
�y������}Q{g��+E����|[��̫^йT��6�g:�Q���f��h���}S{T�|��]�
�9��ϼ�gk����7�S�ڣI}���!�,?�i���m(��,�ﺳ{���s�w<v��O�����O��!S��m��KUQ���"N��	5q�?���Լv��Դ�G��[�g��Y�� *�R
��
��"4'~��wpsu���\k�}�1�
+�TI%n��J�#�Y��ޖ@M l�R]�h@*���H⺤��:<�&<B���o2ƪ���G��?A�t�UڥU��ЋO8�,c]���K<�\�f9�82�͠�������Gc�C?ƣ�6����i�W�������G�y���/��7�����o��汄����u\��Oc��O]	n��c�j�YLco���m��u�`K��c?�ا���y�e/���[[�z�E�v���q#��>�2G�e��oi~_g��������gz��f;��Tש9<�/�uDg֧s���o�qˈ_JWq��ꊴ�i�͐��c����?-�,�~��Qy<��� �v�=�}�h-�7�>���c�k/|}�ʿM��;�'�~��K�ٿ����;N�C'��+���u��JA��D��
+ģ��|�.1��%Q#����[p'�E
+� ((� z=��+��49|�L�twMw��H����B�vƴ��Z��^|?
+a>�-m�ni�)�R*����u[4�����K� �0LI�c\�Z�{pJ�0Iz�|N�"��8O=T�^s~�5��%�=�l�}�a�sZt�Q�O���	�p	��<�z��<4�)�*�~�<�@�9���B
TBb��s��p�ys�MY^3�^��=�o�s�
+�;���-ۏ���VMP�\���7b�º�=����
�/��7�4õ���H�hLk�����?]�'���B�㦸�����
+��F��7$�E-8	�[���s/S�W��zպ�RD�u��955a�4�r�k�9wI�ܸ�e�cuqn�G��4�8�������g�k�jXy����7����4j"�����K�Q��g��;A������ݗ�c�h�6"��"j&�W4��"�
+A���q#J��\��q~S������{���^3�kf�H��AR���>�T�vdѩr2�� ����'%%M���}�\��HڤUmi�k���-x����uK�btJ6�V�O0(�2�)�Ăʡ~�,Q�:Ԣ��M<�0&��3ڪ����8�@Nq{�O�}O�sx��Bl{��j[P���aNE�p�w��Կ�f1�oW��}n��)��\��Z��s�x�e�cF�{��A9{�E�q~���9�����m5`o���8�|S�XF��ƝԸ;��r�����ĺ"��[�����O��
�k�_����7�P�֬�k�S���WX'ϯ_q������չo�����|��9��q�(���7A�>�߭����Ckժ�ý��8��}� ϴ�������N���}�KKBA�E_�}�>C��e�VA�쪙�aj�Ҵ�Z�������0"�hS�VA� h���`i��ޙ{�̙�w��xEāA!��A�ű�!1H��:���8��V>NJ��7�f^}�~��a�5�YOȊ�`���fô��a�7�8E)f�G��!
0�U��8�u��iȲ�)��Ĺt�>`��f ES��\˔�U�G�&h����+�ex�󌈻��]�v'���v8F�m�>��5��%�sJfme����1�׾
�,�}��̼�GGpO�ȹ��R]�Kkn
�w�vs��\p�,�Q�E�{��;P����n�I��~�̳k|g��O�dn���^���DP�����7���(�<�k�eH�g!�����,�s-25i�Q�
X�&����~Am����ĵ�9�����yv�Ӝ���=&N�S�_��^���u��.CA�9mB,lو�����hO[�R����j�X��-�Z�FB��B$�D�b���br��9�o�g�(�<J)B0L��/K�'�e?D!
cF�^���^�m� ���z��� ġK��yA�Mab~
+b\S���0E�?Q�9I�#ye�a,űt����,�@20�������+�	�P��h�
+F?y#>Ok����Ђ�8�2B�����^)W�;�z��an	6`�h��/3v\[�O}��$�va����#sx�/x�[�`�j�Wa?��|��	�����
�\q�"�<�=�b=ú)�o����C�}ȷ����=gi�ss�6W�{ޭ�17����F�[6�e�i�'gQq}��g��d�c�s�9�ٖ�f>#?Dr��k��;�sa� ��9I���~���}����X�q��	�Oy�
�J��u�K/�A���l���?E��JQ�uo��h+u����!���B���D"6�cމI�.�43s�̙�f��r)���?������$cA��^r[����ڞ:���^��B.�Nَr<hņ �4؂=�Cb��<d�˼8���`�R�ZkE���b�0�<��0��F��N��/؇M��
�a�{�"�m�`
+p������g��p�X�
�����	7�&U�2q�
��I�۠"c�$sw��^��ދ��Ф����	���8_��۬�N���o[`�rN/ܟ���s��0	�}��<�����I��4e�`.i�(}��#c�0��sJߡ����~8�wZy.��c�!�A����־��7�\�J��#����0���1�<���n4�@��U}��V��wo޻�?�����q�?��X�����u��N�A���ε;/��+�Xz
�kK��T����*��
tC�&*A����]�ʍ�����יoΙ3ә/��B8��ʣ����[=�:&g|�?�u��u�ͪs����1����x����^@�u�x��F��-�`|��K�cc��oٗ\u��(�h�8�:��>n۞0g��]��8�c�?`	۴��4N�?m|tӼ�pWO�����W���x�5��	��[�4]�#�5kZ�]O5<Čf1�y�S;��a-]8����->���5��[w]5����6�=�5k]����e�#������_*�_�{�U�����U���s�|㎍���z��ԈyƜ{����\-k�5�e\�9d�t��t���J���x��y.��b�þ��c��yc�J��m�8ǙI�_�u����G�-w{��
)���vи���?}z]��]�IJA��n��9\x�͜h�`"�ql��#qD�	A�("�A���"��2����^��<�ū� &)I#)Q�L�f�x��ٶ��8#N�5l�'O�f.��֊�M��T�q"Ӓe.q��.�|7�R�7��/��E�%wҩ�B����$�����[2��������`���eNF�5H�2�{�[ٖ=���㫏�#�R�+�9�r�R�yj��1���N6h[�m�R&&`�ǩQ�}_�X��M�\�ͽ���:�̩I��~�^>�L���e�, �\}�kdwY�"��l��|�n�e�=�C�q^ȷ|P{����-9���$�n�7�I���=^���3��=�su�أaƔ��Ĵ;��tϤ=c�κg���&&���+������Ɯ���ޥ<��"�rȘ3􍓧�~���(�w��+Rg�oB�et���]��.dA��baa�
<���ރ6�j��6!�wg�i���
3�gF"������J,fa����ĝ^|roݪ:u��S7��!�/�^��	ѧ�:%�g)�$��F��)fVm��R��~26�۞_w,v�5��U���1�#���l���.�B��g()�TLZ�1��@L*���tͼ
�a9��'���{˧�i�Qоl�.ֱ�m�m�J��\Р6���Y�/���̪��1K��[�OYs+��s��b�*O�q���ol�[�c�8o{�e�m���>ZІ&�78�79T���W��c[�A;�g�k\I���c<�N�x�aOת��},Ɠ�x��ֳ�~�{��+z��z/�p�k�i��<Yf�[-��򺰶ղեՐ���mN&�Τ�u�x�y�׬�����UT#Y�����b�8�ʳ���������������s?ϖc^�mZ�τ�����0�\�v<��m�KnA��f��AG`�d�#p�_3��q,+�
�c�$RH�B!�	$��%��
K���
+�%-�#?y�������+����Q��XF� &����X�s
��\@�+��'WAu�\E�EZ�����_�����7�Tw�� ��q=�Po
�b
o���
��Z}/uI��u�FG�7䲤ړ$�ͯ9������&�h��j*��;�7�-�����Q�P�����}ޞz��c��oy6�Tk�4��9߷彥����
^bKuz�'}�{�mLp�O���8�k�U�u��~{���`���{��|��9Qޏ�L�	,���o[}Z�?�9�j����wƏk���h��m�?k�Z�΁�;�U�
S�Dl,
$���)v��2
+�|�J0q���=��|�ƺ�����ޅZ���;��ٌ��gy��<p�{p�M��V���q����m��.�A�i�<������;д�޴Ջ-
qi�RUq���Z� �������I��_��fΜ�cB�e����� h����!�v �����I+��%��Q�ѱ�9�ۂ�k	��.1Ǡ
+u���'�l��؃I+W]C��!9�=�}ʸh{����4��>lC�mS�'9�3�l�	�:�/1�Wc<�(��g���Fe�.0n��U9�lX�����8W����9�	��I2���'h0v�����{�pļ�
+n��5��<�Hb6�^���a��I��1��~��ۋ���B�-����n�ߘO�{��6�߬�y�z�Yk��ro�L�~ʝLP�Eߊ�s\�¤��զ1b�Cۥ�󏠋�!�O�N3����3ߩ�{}�>�
�+��Y��ȽLY���=������ӿ/CQ����#�-l�X�b5�(��OiU5��V��6D��&"H0 �Dl��,�'�{��O�;��w�/�c&�/!�q����9W�g!��:G�E��.E��'�%��8�����_z,�
+,�<s3|.pl
r�`ʃ$%H�M1?EI�Ґ�<Ta����#��y���wYX��:��1�A�8�
�P�
X�ZU+.q�9�Sja���XW�/����
��f�{(s�k�i�A�C����9|"�=Ђ�v����%��-{�#�+��]{�dg��5ڡ��ߜp<KƲ�G�2�	g��O��	 ��5���0t ~����uo���W�Y�s�i�,�����wA�G�9�::�Zb�71+�5�1�sz��;�5�p������3?w2d��ϣ4Bh��_�9���\���
�
�)��}ӹJ1������"6>�/`mkg���:��x�	�-^x!�("
+ފ� b'�
+���8�@���L����O&1���HH�)I#Ԙ�@���./&��Mz�D����k�NՔ������0�gA��I���j��ߗ���7��wY)xs
b���6q�g�b�V�}�(֎?�5�q�LcR�"汆m���r��1�����uճ�K|Ԁ�������2v�|sXP
�xe����	e�=��r�'����ı�\T�7x�;^p�u��:��+�j����O�������*y�V���;�X�^�q
��٘�*��ˠ��[��S����Q�w������#�d�#�י薼w
+:3�|���KF�1�ߝ��'�~�����*>~�������ߝ����tw/~�]�Vi�6q�m�Oi�>�u$�|9�����?�p۰�mԻOTA��Yi��,)����'v�{Y�
d!A�(
�m���ȣM�Bj�2&����w�'7��{�3sf�	!���
��[z� ���eѕ��Dm칵/�����q�MwJ���\���}��!q}'����$���(I^��DZ�f���*;Ø�<V�Nq�C,�Fd�qB��xB�Wm~aK��0��X��e�X�,f�*Xr9����
��;�G_B�k�J�8��XQ����%ny߈V����ď�mxʳ8�g,�#��:�p�o��:m�����c���ms�}��7��1*ZO�no�w�D��וj��OE��W>GZ�wx���N�1�]Vm��?�j���w�c�l�Xpb�+�P��B��\޽+������)Y�i�nc]\p��;l��}uH�X�>7�w��B��л���	�
f�pذ�m�I/�Q��ۮ,-��>��m��b��k�k�1fjXH$"H�DBb%���t����sⶱ��{�=w<�s�d�K
+��F��FR�$-�����)��rtHJ�:����~�0�qj�.�N�k���g$�g�>�y ����Z�p�'
+�
|�QL霗��[��Jm�:�	,��z|;O��@j'��}��c��*��P�:e[��wC��]�F\3/������ğPP_r���=�6�(��}i�3���j�������6ߗ��np�C�ӱ��>v��q�����~4֟�����g�:�U���>ŧγ��tW3XQ��`�U����Ș�0�;7�;���Ɛ�����]��[��-��w����u���V�V�VWa}g��l��>W��#������V���?ٸd�+�~\�b~=˺��_	�|1��}��.CA�S���KH���ZmݖV��*Um��Q*>�B��`oec��Jb���I�MX�r�Ν9gfz�"R�y�B4�ylk�0)�c�a�Cf!1���?6.�8)(�>\�9	��8�d�4�mq�Ip�;o��=�I��>�S�ϴ3&�E�OP�t|
�`Na���X�w���
��t��^�
���o��ϥ
+{��Op�<�o���<�
�9��O��x�;��s߆f�=��u���_Ћo̧9�����k���e�-g=M:湬�{���}�=���3+��u�Uϥ�:�_d��]v�Z�
+���(;�ii��}�=��7��k#-�:L�Vl^�����<��tj�_˞�[���6������v��im]O�������c��?��{��!
+����Ag�͉rM�����x��u��.�A��)+��������ZUZm��V�ЈkEQq-�`#$؈���CH$��w����]|2ә3�L;35��1Y$ED��XT};6 aq���r���C<��?C�F��n�	������?��9�&���j'����c
�ˈ����w�k����j_�@-�f�XQ;�	)��w��1-�ƴ�����ۅ��&��XE	[��+�7W8�1�W����{԰����o�V��TkC�쩋���@���v�.��C�>RΊj��-k��:ǚ�^�o���Mլ*�uh�G�>���b^�����ٹ�ilYy7����iϤŝOA2:sw��sNg���ݙg5�Ӝ[�6w��1w�b�pw2�d�ͥT/�����-�w7�j�~R�t�ۗ5�������_��}�/�&����ݚ��]��/�"V��uԻNA��L|
+_�W���0�\V`
��"�x�x�Z�X5�vV���D����qŗ͞9s����HR��4�s����!
Y�!Ÿ�p�ȷ��e8�F�
+�0��T���:�p����c�T��%�}Zpd97�S�����k��q�eX�5��
+����3�8
_"CӸ����|�
ay�p��o@-��#�g�M�3��?���=@�L�q���\�	����o��1\Gq㺧p�e���^wY���a/m�8��k���zc�qk�}6a�����P��-�6�SHU��G��e�`��//����sZ�rt��yQ��9��ߤ~+��a�9��x����Ϋ���ZC�|kY�h<��K�3(3�������/�Р����p�����_c������.CA���$l$V��ŋؠT[���j���q��%D"DD���6Ć��x
�I���6������?gf�1S3�Ā�	��b�{m �4�Q�V1�scZz�jLkW���,cK���2�,�Ԗ���>�ŏ6`�<.GJ������������,��C
y��ʪw��ik�U���7s����ĝ(W^� �/�ςڷp�O��+�sc��"�5����~���چn�ǔ���^�8P��rW4������u�_�}l����x�>osi�7k�_7/y�~;�v]m�>��b���@��9���ւ[G9	�g�u���V�K��3�����)����+��]n��U=%՛ҷ1S߇��	t?��X����s�_��n��|�'Ρ_�9����u��.CA����l���-/@��k��)��]�[�oq	A\�@�@""���M29��'s����sf�c"����:�E��^�E���11�ю+x3��%<_��2L�U�nяf��<�hV�ta�j�4��P�Ҫ<�z�I�K���iYtkm����b��/�1cX�np��]�]�`��w�#��}�k��j�w{�{�e�O�rd���
�3���s��ߨ&��~��$VJ��s,j]#jm�'���<j�/q�-,a����/���>�6�qg
+g�P���kHk�j�CZS^5��Ϛĸ�]�d��|Ah��9ꔤ��{���RlP9�m��s��4�����r�g��n�ƌ���wŝww/Ғ�j��sw��ok�w<�����ߛ������9ߡ_"M��u�KKQ�O!Z����;���+���i�Xi^F-)���d*ZA�MEA�k�&hӲ�s�C�
3g�\�9gD$ ��6F(�FF-!
+�io�!�i�LA�E|����g�ų3��}'���6`f�Kటq���5�9H��E˓�N�W��$�H�Q�}��<{p��cX��ʰ%�'}�ƹi�uX�M8�K�qo�w��o�o�enU��g��)�{�h�Km1��U_3�cN:��mCN0v\�!c?2��������n��8G{�kۃxu��u���9������7l�/}
/���j���zK\G�ߦČ���:�U����"��w�zY~�8�=��Y�u8~��̳�1���3&����֘��ڰˑ6����3�f��{S�{&�Y0��-:�4�z:7�������8�f����i�G���v	��m��NSA��i�7.\��
|��ZK���B)-±R�J@�%��!�!�P�7�q�!�7��N��tr�⓹����r�cL���sIx���D���
+�H�eD��Y��5�����'�#���M�bu���(�^Fr�H�b����	y/&�vQ
+��!�ީ��ꎍ�E�a׬�2����7��RC��
`;��<{��Z����rr>�
+�X���\�x�7:�~|��d
㊵�h=e	�g���'s��=��;��h�����[��~�0��h/_pF�#�R��>�z�����gα��9���������I蝱kW�W�c#:���I�;�0�ŕu���ݓ���}VzweXg���os��[R{7ݷծ���d=�J�5�;���n݇������/w�4�� ��@{+y{q��}��@J}�$���8���º_l\z��m��JBQ�Ѡq�P�&A��[�����Ԏe��!��$]A� a4�Qэ�Y�"hРI
���6��}]{���1&h�	�,���%��1��}�#؂����s`V��߉1�t�u{P�,L�$�%�`L�)X�+��;(�_��/CiΗ`}�k�ȵ�9f��� �-c��P��=׬7e�g�
+��[�r������Љ�7��
gc�.�^Я���:�)g6�*����6�"�7Ǹ���̘7�~���=Ї�Ϸ��o�n3�����9�����������1u��3�[g��㑺�W���׬u޺���߯�|ѳ�{�K9i�sM�)�|�s��Qe�抴m3fك�Q�sN����C���}���ﲌ�>j�{��Y~c��E�����׹56��e�:��6��r��?���/s>�s�z�����ʎ��mԹ.DQ��c�4
+o���@���e��0�؃�b
!�J%!�*o ��������'w���{�:�ܷ4Z��htJ��HJz��k���fX�ɨ\:�W.�R��Y�G/}�>�'9�3�n�M����c�U?7��!`-�� =�/�-&#���޹�7�
+K�+�����dQ�e[�eMf�oZVeC։��w��gr$8�S��O�UJ�~?���M1��/'ϊ��}P�f�e����,�~߶���;�'�)�*���1r��_�j0�?�L^�_!�R��;�'��:�>��3<���G���P�����$��ɰ�8����H�I2ۜ��.��d�413��܈�a����p��}�;��E�u��kt��3��I"�lj����q�j���g���s?�Q[o#�z����;�h��o�0��e��.CQ�͕gp�m<�G����juL��S�L�c�Db�1].$$��x
��_�b�.��v���Z{:ι��뤀��!��05������49�($�
+��70Y>�)H3o��ìA���<xP�
��<��'q��/�Q�m�9�����0LásMm�5��t�{��M�:\p^ҷ�|��>L���
���p��������<-h���a��Ra}����Ƶ�5��\=�������}�+�݁U؄#���`��q�3!FM|��,��z��y~��`�8�]Xa}U�w
+f����3�T2{Zf_�</r���Y�����6��șJ4��S�ΐ�<i��:eI�w�%n��3*g8J��l���Z�s_=Ʋ1�ѼJ���6ù�[��L<[���;�w��{�������C�
��R��O����}��.CA��i<�xK��C�V��ZmO/�Z����X�6.ⶒ��΃����#,>9�����?3g�c�Ƙ�DCb��ԥ#M����p�.ט'��ۼ
��ț&���y6>�w�����Bҫ� &E����˜f�,�K��ܗ���K�)��DDs���I�dMN�U��QY�:Р}W��Y�"�/}z�!��]��\�%}�^�:��@�d�:5ƿ-/�?,�_�"#2��y�#�_�=5m�u֭A.W�I��7��gQVe_��{B��c��f?�Y���Wyno�m���ȷ����ïS ޲�����'C\v_T��C�PǶe��=>ON�\v�w�N���|�<1I���1�0�s�k`��k�%���Ϣ;O����C����Cq�!���O|K!����}�;N�@����r�@��$�$�
������£AQD<
+������/�#F+�������zbcL���#9X�"�!��d�{�J+��/+Y5n���^�㩸y%�(���[��&4!�:TXg�5V�M]8�S8�}�����po�
O|>��5%�5a�Wc&�af�v�<Z�{'�'Qut����r[S�{>��\�y�~��b�wp���0�����[�y5��j�;s$[�\��l��2�9滩�����q~��d�9���m�n+����"�u���_tI�ʼH�
�;r�}�\�l0NZk!ϵ�s�����9rr�+P���4��p,Py�|�'��,�ߍ��&5�[���
+|����ԻJA�_�ǰ�-|5�1��5���&�&D�
+���X��"Vډ�`%V��c�����̙����HVDf`feX��c�fb!�`�`�
��We�c�OY��6c��Nϑ!o�}�#���j��3��\�e��'p,���`"�)$�E���\��`�\�e�i~ס��!�G��\�ϵb�Ճ.c�MX��~	�5hp�
���g���5L���uy�W�^���k̓�٤:�s��ѼČ�<3?��O�ͳ�(�8=���xۙ?eL���w��Ux�����J�~J2�V��#��C��^�q:v������~����d^v��`����{p���˼�M��e̴-R�u}C�{�߼�G���-�����v=���u��.CA���ֻxK;�ނ��ӛK�ڣU�B�DD"��K� $"<�D����w��I��ę����̜�7�,ȼ�$-YII������˛\�%��r�O"�IR?C
�����b	o��0Nxk�|�g@�Ad�,�E,��my1fdR�DfeJ�eL��I���r(ix��'��#�`-�fY�R"�F΍��3w`k�ʦ�԰w����z�>��i1��l�v_�m�茌�yN�_��K��G����#iJUVPe]Ǯחc�\�as��߫|ɓ���#�rA�=�zv{�yBj��r&�ɸ���[�+�u��l��챀<rp� "�
���]=�^f��q�~�e�½Ke/�\�����s�wrJ}���;�K�{vܷ:�w�bCr����
�����}��.CA��X�7��^��X��^moi�Ki���ğ B��a�	ĚXYZ�I�)�Org�̙s��c�5?B)HI"I�����\�3�)�!�]���&�b��D��y䈓����+�\�i/��w�8�伜C�,�LIY��̘�Ϙ�Sc�����uCsw2,�Zs"[�5�I^�Vv���*�x^��=w���$�욺��V���Y�0��[D���˰�
�V]��(��_�w�ڕm9��e���?�9�B_��^����
+q�K�&���=��#�����ɦ�ӏ%ꈩ��\���3�Z.�y��\��߱�4Y�̸�gy^�y���w+�YNp1��Ǝ{�#�=�6��/ϳ����m.��<#b��E���Cҫ�#�ǜU�n�}g�[n����?�}�#���p��S���u��u�K/Q�3�G"_��ކ�/ �3Xh�:}�TK��z�#l4D,��R���D"�g�X����Ѵ�_f�ν��{Ν��4�A���]E 
%:�;8�2�8>ƾai�&�+J�1X�4��h�$�S���m�䲟ŷx.��#νxP�
+�ë��,҃��GD�>p?#E���)��m�`�/p5X�*Gy�[c.0i^��G��<��<���֦��?K�X���:��Z�ڇ`��p{�����
�!l1O%���h��1��<@v9���Kx�o�A�^@��8�z�FGs�������Ƚl���ucN�a��v��u��15�T���9*���W`>=�Vk�J�l�XK�Ti�X�m�y�~�6vΓ�:�9�E��7�IB��!�=5�9v���'����<��{���Z�Ǿ�hW��`��,��+L�'��Y��u��NSQ��ť��q�ء#���0�x������U�%VI�&Ł		��`������Ȉ�	�ߊ��0�%����:k�3{nw�0�ILa\�H&�=�iT��y�E)��I�pLJ{�3gP�yE���f�nL��A>y���=�t,~:�
+�U�	�����?f���}f�=f�#��3枘���>a{�������5N����.�z�'eB�߳x�E,�N��W�UE�sZ;��5%�Q�_j}o����>띪:���u��M�i���������hb[8��c��7u뢶����Y�.ud���~��;�Q~��OU�^��r�b���w~_�����%���5�����z��t��sާޓ~�~�����-����n*�(N.X��(֨�1����y���w!��M�ߨ
��������O�[7�.u�U�Y
+�9����c�&Ŀ�o��n��u��Ұ�u�;KA�'�Ieoe!؉��@�� B�Cs^^.���р��7���b�����_��������rh�cowgg�3;�"��_R r`��4��E�
��� M����eH��yV�����e|s�hQf�Ѫ��,�V9K��H[��-1�*h�m�*9�~���Ğ����>���:X:�� ���&����US�\��H��'b�*5���h�:�`���e����c��k��U�������18[�PcL�N�=p�q��Z�6G�w��9��[B�ku��0¦���7/�٦�Kp�x
ƮS�FFq�t�	|�#��{�M��k����u
���+����)Yk�t��`�s�H
+$l�Q���ܱFÕN��D{�!9��l��Fo�>0���;�E����"	�u<���Q[�w�K�?s-j�u������üO?6ߏ�.k��m��.Q�[*��s�Xx��l|tTG;�V[mi���W|�H���	���BDll�=����O�L,~�t��s�{�c�L`��9JCr��	p��j�����|�e�@f)A��$��qm�s>4_����+�R�/q�P�83&��ȷ1=o���/����r�
8���Wx��e�C��+��|yZ�f��k�5*���7�
�Ђ��\�u)Xq���K�U��p[|w]����|f��k|�2s��1\�
k�f�:5C�a�9e�j���E�h�Q�	���;�!���na��+���\�+�Q\������Pem/��Y���,>Ǵ&r�&����9����cTY�'�����u��B�Wz١p��\C����>�Tb�����Q�_l̘Aԫ��Q�
�F��<���dBuгA�='�>/k�z>�4I�3�F�Q��u��.CQ�W<������3^���-GO/�7��(���1(b�L\ffb$1�x���ӕ�|ٗ�׿�^�""�2 NVB$�ȃȁH
G��Gh����c���4Hr>�~�1S#�.�*��WC�����d����d���Hd
+L����.�0��
+��!h��Z�1��U��.8M���%�E�6�%�� ����3pv@�k���~���WT�^�Z=ƭ�u�_a-`����@i�pGL��5b�q�'�7����|#]��?�9̿���^�{pK�:�b��>���
�D��Ƌ�a�
�a4���Y3{'=��}YuO����7;��%i��]����	���
+���JÌ�]vd����&֬��󙗉��$C�p�ǧE&fE�0�
�;�T�a
�晛�þ='���G�f��`����3~
��I���}�9N�@�q��
8G����
+���	!�`��E,bA@�B�(�������G#ˡ�d���<��6�,��:-9l{X��W����<A}��-��y_Ֆ&i�Av���צVż��y:Х
���r؀BZ������x@v�M�;|�=�@߉M�F�:걦������׺�3&����zl�G�\�o����v��6��>\�s�s��'�>�sT{��g�6ƛ�Y�A�^���z\7u�;e����-�ϛ����X���N�wD�7�3��}뜨��8��{�O����k�=N�N����N���K�!��^�^����J�,�;����S���	5��r��U�W��U{�u���\�G(^�`�	��П_ĩ����ԹN�@��d�j�v�b!@�*
+�
�DA�@HT�@AG������(ő�yw�m�Y0�j�"��4�
>�
�]�B�B���!Z��&y�$ik�03f���/�cMK�P@�~C�C��Й#T�v>ټ��^����8u2��R�A�,k��]�S��3K�X�
p7p�ñMa�ks�����)c+�~{��
na�y#�u��_�ȼ��g̼Xvl{��
+��W�`퐙�\���QB�<P�C�~"睅ε��S/��)�ה뛳�o�=%�a˔{I�{Z�m]��v�wa�s���8w�����N�.Q�oH����{#���qȵ�#������u��԰�]�OK�@�|dkM�?��5���ZT
+zT<��ŋx��ū��7��<����;;;��$��A��!��)��h�q�I��L!�#�+,����A|�|f�u^�}ƔQ*2�(d���l�j)%v��� �����
��<�9̥W߿��	,`�c{�}72��x-�����p	��/p�"�?�,����C��5c����yž?���N������~��9-w�}Z�[{��[Ʈه���=.XӁ�9��=�Q�z�~J�k��{�g�3g�'��c3�X^�l����z����)ẚ=�;��Yp��W<�
�[�~/���e�#��gQ�v���X�������i�.��!��u��N�0P�1�6mӔ�y��P�P��A Ć����`��:X���3ǩsn�9ס�@"�SD=���i@:�
�u_�jHX�gh>��a�a
+)� ~��D�:����)e�S�����!��u�yt����<!�+1��N�}Nx>��s�����}��4�Q0���,Z؃��+��[��s8�9㶸��d�kA���������������^����V�C�P�s
��
��G9�M2P�>{�^�����yj���nפ�Ӽ�yϺ׊c�ۊM���;>4s�{ҹk�1�YȹOY�g�}�=���oc�^v�q��v���k��<�G�����e�X߭Ȥ��]�IJA�����s�Ƙ�t'1ck����u�".t-����\����xHz���JB�!�-�I]����:җB�d&9��Gqi���}�^R�ʑI�w�r#�r)����鑳����c�ʡ,�c��9���,�+�E�}݁���r�y��^�����j�y���6d]��e��<��u<����U�s�Y�3���\��M>䙵?a����0O�Lj�3j/P��Z�䔚��$/�*_�#��Hm��
Y���/��dmK�nIo��0�9||^|N��S�{�Għg(�g"��d�M�\ƿQ�3_���6���͊=X�7>��ٽ����3�&������yTcH\�_Ҥ�m԰�������V��m�9N�@��y8@�qlǎ��da1� �"6AACEDn@M��y��'��(>َg�ef�ܚsn6�=�K;��{T�5|��C�Ӈ��������1�r2�#��Fc�S�1�&���'�Jc�p�P�zl)k)yzV|��S�y#*L߉��y�ppS��ܹ�
+ FgϿp5s'�R�~j�(�n�9*^}�3^}
o�
?���)�L�
���,L�zd�2u���c�mد���g�y/���k�1�W{�����t�ؗ�s<q�|�=�64���^k]���=g��Y�s;ii/�w�?4Vg�һ���琵*����{���yT-���L�Il���G|Ws���b����un�6�y���Lİ�u�[J�P����N\�Kq�Z��4I��6��*��
/���%��\���2���#9gf��9�Y�E��&X�g�4��s`��LM�Y��k�
VA�FWi�н���=pvA�ZS����Y���W�Қn��
(hs�!a?9�Jjwhk��11�3je��ӧV�>#�9��>�����	�<���_��3Ol�ۺ3À�W���!ϡ�}�#p>�'x
��'g/'���[j�̝�utk�|�e���Yۙ��Ԉ�m�Zt�=j΂g�k|���}?��J����霸	���S�΄=����MB_�M�{��{m?:�aͿ!�]�w30k��ߙ������������?�p_�5bl �k����~�SPC��}��.A�����x	ZMO��ї1Cb�K���,\a1��ai�=<����Ig��K���s��㜛q���<D�
�s�w�ûsS0
��@	t����1F������ːq�Y�֩�S�����p-!�т%�.;%�Ї.�ܣ�[�;0n�}���8������O�[�\w`Vً<������֘S�ҚR�jS�3ك��S��|�O����	^��{�G����
+W�[r=g~=߲��aN�.�X��;�s�#�����qF�S�*���S��:�����gP��j���u��_Ω�;��}�&~L�����	��#�	_�x��-5M>{����b�k>]�o��b�Ѽ��h?�j�uh��ߠ��ڌ��m�O/CQů��/K�}���zZJiʂ �H��",���W�7g�L�d��/���Ν93�Na1�,;��<7A�4��
��0����� ���^bD }~M:$1��DܫO��&r�`��y��c�cCJ_B���[�������%&^��u������Ό^}E�l�9��`>�e.�xg�ߛ���ɓ��Vw����c2��o��y�����=�m�P2��/�
��R�u(k*�<�v��k���������|N4VIr�1gl9�
+>��g?�#�J���[�Wz�?k?u�v�;������-��}�]�8�P�
�VkgC�:����ym���t���{��m�~�q4���g]������L�԰�}�IN�@���cp�IO1�c��bF�,�,`��������K��œݝ�j��ܒ��<CMh�
+4 �!���CڌK c\�9dn��p{�9�c�h�#0t�mĬ��C�����^D��5|�<q�t�gd��z��⳸�usF�Ҿ�yuH��Xs'��~$�6�f]f�{j��p	o��pt�����",`�
؅}�쳧��C�Q�:b����57=������<��ِ�8d^��J9i��J�u9�Θk�{ٷ��g֔~7L��y	�����'e��6f����5�Y��̅�g_�z�u�A:_w��~K~|�����U1i�~��׫ۇ~��_�Z:\O��}�;N�@ॢ��#pN��$�;�IH'�%�W�x��p�#��r$����Q��d���3;�ua+����ԩ��d�G�Р&$����%��eX��7��	 7cNd�]c��گ���Ѓ
�n��	s�<�
���ؿ�1��%��
�}H9wb��vJ����JNS��s���]�)L~)��Cx��~�q�ŵ�����V`6���[8�z$�>�v[i]�Vg�W�넹���c]���8f�f���M���͚
+wD��1c�~b�W����MN����:m������������Y��Kޏ��݇v��ē��{����N��n��u�g�)K���k^�����/ј�l�Zv�l�YD��}��N�@�Č�s0�,��Ҕ�-IHӦ�
-110 ��l�0��, �[�-YV��ӝu>���B8
!�m!
=�8[��_
+.#�_!��p�|�'P����#3�7�Ѕ���}"�3P��|jp^�xa�
�/Y�e�U��h�
�!'C�q��s�[P{
�H�Vɵ"�ߐk�z��=?!�`������>R�����������W���b��i�ُI-}E���,�3c��P�W�Rg�}�52��"c��c��5�i�IC4W=�s`�K)��:��K�g�x]�Zb�����,ۀ����չ�9����);�#�������s$�����p.��`��u�IN�@E+\�5�#���&vll�$1	!!�H�G`�1�p$~)��JCO�Tu��:"2���	��{���D$=x�38�X��O�J��8`B�����Q_�x�������@C[���|
+�����l�3�:3��VsFM���ЯZG<kZ�#���f���lH�tLWm-�_�����x���o��Z�'�y}O�F�	c�\���c�uhN�,ٻ�,�k�定��\ҷ���:g��o�h����Yϙ�w����e��y_���︶����ǎT���я���L�l�<�L�y�e{�<67	�|�@�bFԴ��ߖ�e��R6�=?�7wZ��G���C��
UWr*��m�=N�@���KpB��I�6�C�@�P@ME�DOA�����"��ވa��SV3o�ww""}�� @��$�i<�@b��
+\��>�x'`
+�Y'1��q%��l@Ø��=L@�^��Ǧ^��^���Ԡ�~��fL}Ƶc�'g���4�35�F���r��;Kpĵ��|��-�ٙ�������}�sj�y!/-���W�[�{ԯ��������Ԭ��#��7�2=z�K��:�{�����M�j���~k�Ɍ���]��Q�=��'�
���5W�(�W�?1��Mx'�hy�K����Vߣ���2�����&%�Oj��7�?#:k���Q�oq<��Ȼ��oކ�=���5�!�S��y��ð�u�IN�@�ʎp�������`�$H� ,�`��������7�%J��x��k�"���@_��7h�CW�mJ �&ps8�#�;H)ᾈ4VLQ��W�N�y��IYC��8�/1�f���2vg��0`/?
�<ڧ��+'8�+3�F�g��c���p
7�%�[�u@ϽU�=�!t�.����j�3d�����9e�g����cTfN��1��.������=����fކ�c�֘~j�g�:J�����;����+|/�&?p����Z�������g��5�)���W���<4��ñɛ��K�߱���m���yK3;=�^|�w�
��sj�j��+����Q����6}-c��}��.Q��e�	<�0m������H��6H�DB��X ���HXI<�%O`�\s**7�ŗS���H[D���E�"��,R��Eң-']�'DcuH�}p
+^�8Ȩ�藚6����\��ϲD
+��������S�j����:S���f��7����܀[p
.�#��G�����V�:�C�������|�wp��k"=jh�~h��9
o�<��F�g�h슽�h�g��3�E]��}��9O<�L~�L��9��i��d�[;�Wr�!3���Pw�9�!g��w�cw���k��ss�;�303
+w]�P��%{��y�&?/�;���.�Ȃ8���9���w$��G�
f
+
�����JA�'���O!X�
+crwI.��h���?E����DQH+ZX�`-XYX�����
��{3�;����HE��D����L=l���A4A�4I"���T
+�UA��܁}�/�ƴT��W5*Q�i]m�-~�����|�m�r56����:5��Ь�'���i�k�
+���
[`lP�jUԷJ�m=��mp`��psg�S�4
f����<��=�1s\�7�^�)虾���>��'�)�&��
+df_��A���-29nE&�a����!�ؑ�}
I��!�r�n�kxd�����:��5�ߞ{L��e�ہ�廓�2d��
��3^����=����>�x�����6���괽r�牾m��k����h�����J�@�'_��G_��j���4�?j��?P<� �� ��œ x�
<y�,����?�l6�3�I�s��Hƪ0��*MPD7b�i���:�D�ЄR>c��z2�����\O�e\ϛ:�yj��̩��8
X�,2w���\��ག��15��4�cy�R֣����*y�=��
s
+&�Y
+�\/@�u����#5ta�8/�������!�b��r���_�VZ_��
+�6�w�h�dܟ��S`
'��|�a�w�j�@�G�A��T���'a�v\�Ǵg��[�
��/��pp�pļ����
�w������c��:_�]��><�+������s�?RW�{�2{��}������s��ߦ�#����|{cT��{�_w�N߰�m��JA�k@S_ħ�5L|�=�w���]�]�D�Dc�HL}	c�o�/�h
>������GDVE��`
d ')h��Q;��so��]�����I�:(�>�O�܂�	: �y��S����\�h��v>+��7��0���c�&D�4�.���2�3V��]m��\p��	�b��6��h~)cvLn�`F��|�x��$9�-ڏ�gh���n@�c��:߈D�{Q��励2sGzOV�j�2߾�w�p�uEºj�l�g�
��`�w�ѐ��&�9���2@M��_�2�^���W=�O������<���J^���7Pɴߴ�KƝ�N�d�Vc��Ɯ�K�3��Z�Z�w�o�;a�Vԗs�`
��s	,b�λ�[ߎj��7k����ɣ��u�9NCAD���K�r.�
l��7c��,�	�" 6	DH�-$D9w�Ʈ�Z#<��z��g�;�ι:h�l��z +�IV�S|��Y�
+P\ĠG�۹����"��dl�CZF�?=y�L���50`�^;1�l~���k;Dqm����{ܻ2:}����!eb�5��qi�.6y
+�1W_��^6He�5�')�2�!csƩ�(I�c�'��9f'��y�&^볠1��)���;�O?�NJ�1%����9݂���9������p���'�O-��|Ԑ��K�Iw߯���\�3�~Q��w�F`��SS�u��#8��Xxwr��~��a����wj�S7���߿��XK��W��z;�#|����7,/�h&��u��JAEK$+�/2q^�f�&ADD�'��p!n|l\�	"�����s/�C\�����vuטYdfm�
=���1(AR����c[Ĉ�C�_�M�9�
+������o}a��s�`
+���q�"3Y�3���C�Hq��wL=S�f��m��o�xLFԲL��oν=�74/ө\ءV�*87r��Tr�p�njQrm ]"�O���'�<�K0k䑞�Q���WI�G�u.�:��%}�����p��'����}0a�aF�j��W}�.G���?u��a˜��
+��ݷ���C�3Թ�-u�5��_g�o*0O����*������-
���Qc�x��z���/\��k�?A��vl��?���
���w��u��JQ�G������o`g�3�B���Mv���A��Q�Q�N+���|[=79��K,>�;;w��s�Y��� 	�!�h������l\��c>�F������͞��V���桥���2�}RG
+bֈ\�@���Φ�Μ*�	��X��N�c���kp��U�g� W;�w�
�	��)����6������5�9��{��җ�M��9t���e인3%��t).�ֶ��iH���ѓ
���қ��{��[\�Ԭ}�/�Ktx�c�a6����o�+��@�3����޻�W͒�Mu��܁�N�K�=����n�3xt��(v�5�=zַɻ�o&.��>�7|Y��[�{��|݀w�j��m2�zs�ʎu�u������/�XJذ�u�?/a�g"����E�*���[{��nw�C8�"�F":
+5Qk$J�B�y�31^���2���<��+"
Y$-��.�@hX�h=o=��ud`���"�#"cs"w�Cd�Sdh��`t@�:-ӧ����)�I<}�����i�����=8���d��ĤM
.�\�+p
+�Q���Ć�~e޹կ�:���������5�S�����:cWc���G�Kc�����v�>�����G;`�:+���������nM�}�׭~���>M�y0���Z
+�nj��'}/�G�^5Gk�w�9���j��"��=	��rn���ҿ�=��NdR��U�sz��{�����2د�����a
��
��m�����v��z_
ϥ��uԻ.a��J$:o��D��yv���ٙ����*�B%�P�Pi��I4�Η������|�=�e���f�A�}SD����(���}�"Z�
��k65o6�l6Ӄ
���j�h{�]�!�9#W��8��r\��y[��k�0�
��<5X�%@�=����ϟ0�\�<����yR�m���$��gҿ�>�3�\�r��P��k*d\s�2�)����~F���[sy�B�TL���=ȱ�>�n�:�Î䫢��9s9�{��>���
��S���D^�g�߁�_��Ѽ�sΥ_�/��{�`�9��'�7ܳv���Om�7�������
+���opl�w���s�wY���-���}�����q���u�9N�P�	���p
.�(�(8
$��Ď�% �����
�tZ.@KMO����hŧ�-����"��M�I��EC]H��߄cA��Pr½HcIdfMdvw����y�]@���\<�'f_jt
ͯ5o�.��c��G��z��`
}op;&Ol���B�����
+S�ݗ��9��H�um9k2��n�u�����`ފg�7�ߧSx�O��W8�m�Oɜ����֥c~��u�XӀ}�,��d.���m_�߿������ϯ��༒q�.�^�<�s���x��/)c��7c��<��^N��/]s��SO�$�_��������
+,���\��m���~S���vd�:�fn�ww=&��m�;N�0`�T��t\cK
+
+��Y'8�&l ���	DA�tPP!�@�8
��H�!�'9�=���8�ιMc�҈�v
+lA���il��Jh�^�ǹd�m��Pp��)׈��M���"S�
+�o����!s&po�k	07Y��7<�!k�u��/�9��c�Ǧ.-�οP�e\A]~SƼ�{�r�D�˰���9s��k��><c� ^�+x�
+�õjΛp/�"qK%���h�\��z�:�����H<�C����=��Ζqln���?
��e{n�:�s�q�r�3����z�^e��b�+��K�=�9�n���Oo�;�U|}v]]��_�
�֬'N�}���w�7,5�=t�c5w�B5V1��}��NAD������]lsc�!$D�8B� & &!#�ȩ�R1�OkO�t�13f�jf�d�����؏���A�o
�HB҈`�A
��>�����M�Kj��׈^%��d!�l�
�1FԞ�^J����W�>�#8d��?�+c��*����Z+u$��ӷ��8W�������=�*
�8�f���8��g�}��g(h�K�G�b͚u�ҋ��F�јy�����ؚ��ײ�{��n��_��|}~ރp�f`�~���ה=���&�{|��k�A7܍m�&ғ	�|�%�*јw'=�B�;rL��9��5nx+��з#-�ߑT���@�}�q���u��N�0�M_H�4M�Z�B�J��N\y	ހ+��Ẍ���x׳㵓�aa��g`
+2
��B��|*ϙ%�`N*Ё#p
+�`Z����ڂ���T�d~e~ƣ�#x�sC����`�ZS�ך�K����P��ǂ4̯��8���Z�S�\w��1o`�n�����5�1G�jC��W{���'ob�z����x����>�
5�ֳxF'<�>�c��ol~I|ߩ?��,��&=�/�9�i�<���
����{��[��K��}�X��5�߁w�
^��]O�����_��#��Gֹn�/�?"��4ի<�K�3��
WQ���u�MN�@��m8
+ǁ���$��
m�b��W�7@�H�H�IƤ�O�=��L�lef�䊬H
*Ђ�<����5���}Ij��@�O�kR����$�'��
�8����#m�@��:�8#��b��٤��6�ד6ب�Y�e���6��⫾;p��sj���Ěv����|�p
��f��c�'�n��}j~O��HrMy`����|x{��7�|���bd�ߑ�t����J��Ӗuh���S�9�W�b✞�[g��]�={��e-��;�.sF��
��.���P|[�	��(���_B������.���-�_��}��N1���P����n)��w@�����yN=w3�X,�O��v�5����}2#%hA�oA���8 q.�
+$�H��~I݂�ސ�(�%X����
\��
^�-}�	�����8QW{����넌��liS����2�kG��Sk�Q'�K�w��'؂wpC[r���<�gp6̻�Wc��q�ɝO���k?����QsC������V�X+��_���?�p����W���6n�����3��y�8�k`��kg02�:���y���[��k����KН�[�z����}�����~��d�����bwU�װ���AK�@�����f�6K��h� J[�xл��|���u���������&�p��e"T�(���\�s�r�L����<τ�ޏ����p4��
|�n����L���0���%��)��<�3<���1���V����^j�97^G��Ěc��sV�����
+?�o�i3�S�|��W�(��٬X����9{���'����N�����7��O��.���|K����s�񳒲���|/̣��~�K�S��w�.��T4��h��u���C���o�	�I�<�Ӱ�}�MN�0`H�&qSH���.�D�Uq
6�8
+'`ͳ����)�O����xR;��~d
+Q��s�/i�����
+Ƥ�Oq%�k��!t��a��`L͘�~'��2u�L��0od��&\k���ڑbgpŞ^�	���z�ԭ���|T7�^bV��07uZg/��q6�p
�
�I9���`ef{�ϙy7
����~:�Yw����<4O�=��W������9g�ϰ�K8b>;��<�`�9��7��ޙ�g?�O�e�+��w�
_�9pF:w����gLg�0�Z�ϔ���ڮ����{Nv��ݲG��y;MӰ�u��J�@��;��w�ЦicӦ1Vm�*hED��Q/E|
_���,��Gw�9��m�B؇=��$�B;��31���z��ڳ��^��b"NŅ8�>�U<�KQ�B������k���3q&n�Z,DE����s|j�|��Mܑ��H�=#z2J�6*�ċ���{�;ߊ��Q��mkbFIm��5�ĚK�O̺"���Z.��O���^��b��ַ�<�Ǿ된
s�3S�y"��~͌�AA��{�v����9��]�_�<%G���jh���ٿ�vĶοh�ҽJ���O��I��6�O�F����p�E�����ת��Bnw�����J�@��{I�41�%�����7�xA|
E\�K}
�\�������C���Й3gΜfBHB�Nkd�N���x
+=J%Vu)u1���2ȡ�C8�98v�p
ǰ#(�Ϛ�+����G����!t:x��)�攑���%L`����Ŝ�0����כ�ǖSɹ�5��������/X����y'����t�35��x�;x��e�Rj�~B�-���26f���d��ї�/`��)Şp������#|�'�3�bKֶ`�������b��>���{ߩ���i����{�vW�_�;mw�;���x۷��yOV�[Z��'i,��}�KNA���l��+2�Py(�h�o�W.L\��.ti<�~�����������!�v��m�����8m��A���E}�3Ǐ�El���B�r �2�����'R��eq���'N-cb<���)�%[?}ᐱ���k�׌;���X�vCm��̡BI�!�[�H.�^^�I�e��cuZ�{�y���w�~@�%y��S��Vf�M�.Y���E�c��Ӱs��]�yٷc��\.���|�1˰��1�ߛ��9�d���)&��g�b#~�V�w��7�@ޫ�:�v.�������{�'�:Y�t��;��#G�﾿�6��y_��{���|ֿ��
�÷g�����N�P�
LKBڤI�K�P
+�� $X`a`c����̱t,\���ro}}�}�+"����it�
������$�.(AEt��x##r��u��.O��,�	�0>ߢe93���Ѐ+��Ev^Dv_�;�?��N�u�_󯺇���sE��3�:wg��3W���g�S���#pV�
܃z0�e>-��Kj�s��P3���}��F���[���?��?Cǘ�N]=�7gf��
xw������}�}FŚ�����Y�8�3�O�ſ��7rw`u�{�>]Rk�;�3^���0���:m_W��Z�l2ٜ��
%ξ�t�g>��^�!OԳ����D5x"�����NAD��τ��6���-��#ABB��B�G@�P#UIMs��I�==]5=��UfV�����#s��X0
�`���r�)���8�
+qit`�Z}P����3�<�w���h6^������դ"%I�e�i�_yoB~\�P~���`l9:���}��Xc|��_��By
��I��'���Kp
��?f�z���-����2oƹ-��Q#�8�������
ܲ3���[36do�>kk�O
�&�N�'�u��qd�ϋ֛�w�������?��
�[�:%�[�]�V�Ϻ��SOԃ�6x�=���!�����ptְ���MJA�+[���2��;�d&�I&�� �E�A\z��k���n���=��.>f����^U��
ͬ2��Y`;�;��t��
�`�u��.�����m����n�=8e�~���u���#��f��
^�'���سE�*�N��G�_9[���e_�A��j0'�S�:�y��fdJ]
��yy�_�.�R�%�
�����fN����j!��Q�t5�9$���-��Y��<�k��	<0�Q��Oc���_��}�=U���{RM�NC�!��
��:��Y�*��m���E�4�wң|}������Y������ίe���-��_?w����}�;N1��Qq*.�H6���&�W�@
/!Z
+W��@4P�6-��[���$�'ye{��+"���A�6�
��.u�#6�t����\�5�QD�gtg��q��@
�/�#��u¼�{�5<�>���^�J�r�S�uR�5�Ҍ�L�Tl,�_�����F��a_e4�gvaK~�;e���W��
+�fir�s�����:��u�pŽT�����.�n��96�S���CxYZ�uX����w`�p^2�֢p��Z��u��861s�a�rw�N�0��Wa
�Oi�am�&������Vc�V��йzW���~���޼��!�����{�Z�?o�v%��}�=N�@�q��Sp9D��q��6ĀB QDI4 Q-��H��3�V�!�Q��S�;�o�v#"���Aװ��#����#�V�t�=���A�U�ڒ:�:���
����	n���>@
��-x
�`n�5�*ЂKp
������Ч A��y�]�|~9�V��Sp�u��������I�ߒu��7���R4�[{m�oٛ���9�m��z����'0c�o���qF?"[�`�Τf>A��\��^��K�������Q�u��g�^�|��Q�h���t������8�^4��NX���Uc�̹L��j��=L��7���_����ֽi��������������J�@�}cmS�l�6m�'<����R
+�*"x��������?����ff'�u�%ιm�fD�H<ߦ8^�Z�4�4ou����
�a	;��8J)�T0�C�c���q>�=�{x��s^k��+�����Ԗq�6��\c1n�(!'OϢz**(���	�M��g���Q^�S���&ľ淘��\��_p/�	�p�p�����؛G�����7��U_s�w{^�+w���Fqt~���}��&fi��=������7<��X1����{����iؓ����.sX[ʸZ��ޤ��ު�����Wu���a� ~�����JA��5���[֍�xA��
+!i���;�F��,|
�����
��a��2�!�Qa˱�|���"���}N���JЂpn�8�|l�X��:K�U�K� ��^�{�
��sw��7�S�c�����7�
o����GqS���#2�Y���q������j��]Ej�#�p��g�5��,z�u��+I�_q޷`��!��F��c3�M{U��O��	{�u��Q��w��z��TK�ﰠ��x���{ю;�a߽�y�y�9�w��b��4~�
�Oo��&��}���^8��o��W�&�����ANAE۳p�$�L"��
+�X�/�11��<�{~��c�2/������C���K.�j}/Cn�ҡ����>)HI�`n�
��k�~����D0Kp���/��+
��I������%���Og-�����kr*W�h4����˒��v�;2Lj(_e�k��?���8�f��{A߯���xd���;��T��ǜ���ȿt6i��˃�}��i�y�C��~��T��O��;������:*Ɣ圄��|��4���{Þ��D���E������Z:
+�ο!�>O
.�Ae����MN�0�́8
+W�u�64��.+�B$��X�����h��{b4J��S2��e��N�"tsI��/������C��U|C�$�
��-�����5�'��(V~��xspV�	<r>�h[}Qj\�O�>����1��!���3��;��φ�_�%Qs���5
���5�ߢ�Ie�^v$��F�%�a�kz�v`6`Mߋ�0�_���^M�Wn�C{�Uov�L������-�Cӧ�C�I�Yu���+�/��|y}�[j��AY7g�����c����w����Q�5��1�}���!��GB����u�;N1D��pε�~X���
+	�bDJ�D�8� ���J*5����v�].��1#'
��i��YBq��+� Zo�Pޒx�S�E�3Ox\:;0��th|G�D}��_��H�Y�܁7��vo���
x_h�<�s�!�uڿ���D��;Өq��������uK�~g9���H͹��!8��7x
W��g{��3x#�*�����B��tl
�R��H
c�E�'iҝ��k�x��^\S�����5���r��Swdʓ���a�/�7���F��{���ol����h�/����]J�P�����Sm���&R�� ��"E|7�|�=c
+>|�;��{&��8�����2�q����[��XY�U�!5�s(�=שnW��"kК��+�':W����5��S�؁/����sI�}��
}���{����g ���޳fk�u�}t��\��=J��q�`�����89gx�
���`���3x�N�[��}���>�G�P�S�G��fFkgN'i����y�,��u������b���k�f�X���_�;�w�w�坶����~y\�7����-�V��u�]N�0���&ı�(��
O�Kp����i�M>Uެww�v#bWd���5@����7+k�ﹷ�[pv�٥��q�Ot$����ZQ�ܓg/d$��uy��H%;�:��^�=��S}������S��#xϜiZ�;��\��O��h��|r]^���j:���5�3{�
~#..��>���7�~"G���X����,�u�������G�S��Sȷ¹��hs�Tc�����$}m�L���|v?����}.݁|����\�Z�8���c����n���}�_��0��=�M������q(��Ӂ���o�0�?�l�;�I��:��
�`�F4j��܊�W�1�����d|�V=f#T@ǥ��-�8y��1��wB<�=� o6~��x$�g4>@o�X�9�Cn��Ÿ7�h�^�@u?����	��w_k0`Og�h��$D�W���F<O��x�t|����@C���h_��Ï	k<��3�|$_]��u�|���W݄��|֘���<�F�t�_y��I��'?��廻�^o�~
+�wV��(� h����YN�@D�Đx^�#�N�� ��
8e�J*���������53)��J)��-H�r��<�i=��@�eNQ�z���j=��˸�HK�r^�|�o�>����߁s#����5��ɼگ�#�<����W�^���=
�z��C~��Ճ7��|���@�R��l-f
+���s,�'M�:�������u��[�����+��Eqٯ���Vs��M~��o��wE����Ej���*��=��zk��V��_��|��8mi����Kj�@D�ĉ��cYrdolY��
����UAQ���[L��gZJ)mRJ[�&t��A��X���P3��1�z�J���~&�K��R���y=�����Yރ���߰������`���}�׺��5&�@��܃[�#���\�h)�˷�>�3��Kp��	sZ������Ͻ�����S������5g���c�x���5�~�ܗ�+���9h��t��ι��������=��|�Z�p������Ȱ�}��n�0��Ɖ�Xr�_d,ڌd�%S�!���K������#i�)�e����o`#�����l�4geƀ�ֹ��P����>r�?�=4����`}5�����O�kp_�
���1�����p]�M�K�߄�)�n�|�{�Ϣ��X�S���>J�S�`/�q6{��\?�?~��v��+�N��D/Y���\����'ɩ;V$���M�m������Oo�ܜ���˴��.���e\��w���KT���v�J����K�0Dsc�KҖ�`��
+��pN�
+W� k���'9�c�ݤ!�&���1�V;�h�/����d��@/�_�넶�q�ϰ�����+}0^I�%��b܍��7�i����2�O����|TG�.���_�t\a��
+�T��r'�sHn?�z=�F?��W�$�3�����ڏ�zk��3�O��f>���$�����r�υ�Gc�j�[ѷ�5����;[C�i�ڿ�������Ѱ���Y�0DsbhK�.lb���\��p
+����Q���TŎ=���B4cz�AZЀ�@{7�0�Z��@u7���3{*�\��qp��}�����L ��{ŷ3���O�m|�������z�9��{��c���_��������E�h�0���It����'�'�a<��}ֳ�o&���x.��We�n�6?+}'?�����.틳i]?�(�ڮ��;���5��.��WX
��}u|
kVC�����I�0E}b(m�BK� ����p,��Z�`����;"R�H�,��5X�
+����8�k�������C�=
�Q9+;%���{�����3�n��u���奼��rA���8�{"�� 7{�BƟg��a�Ō�ϛ�S�[e��n����!����r�[s�.�g�iVk̫3q������#H��v���]�A^�t�w;�һb��?��n2���N�۵�۩����q~��?�3�{���n
+�������
+�0���jM���*E� x�<��nd�%K��AB��?���B5X;����qԯ����5�y�۳}��^�	�0"O,�_���hL`@m�"�7��`�{8w�!\QG���f�bI�k�
+�Ο���S3�o����z-b����W4~�t�;���-�kO���'x��`���=��.s^�GxO�ܰ�^UN΁�z�J{���s�>�P~;��w��U�ɿz�O-�\��_�����"����MN�0���m�v�҄���K�ܠ�
�W鎱���:�u�)vf�y~d���Ҙu����+aJ'���x6�9�E{�O��5�F����9�N��=PR���X���-3ui�	_&tK��:5��ԓ�Fj�m��0�hm-��Ѿ���|�ޮ3�\H���x3N����˸g��R�zUc��ߔ��?�'4?�w��L��=��Κu���g��fd�ɽz�N-A��D�ܜ�a�Z?����KN1D�;p�"'`&{>DR6K�B�}†KЎ���dG,�f��qW�6��̞@vB��
�NΈ�P�w�ș@�:�N/~��/��@�N���AKF_�7U88/�s�)�s�ˍ~�f��Fݲ�R�C�-}�U�W|3r��+�9�	�PW�@ݵ����8���L��s㺞��G��y�Z���|:?η��m��ɹ�=<:[g����@�La_j������:kq���Y�Sz��'���w���[���ӳk͠�w��?ō��}�Kn�@D�Mn�8Kl���
R�HQ��d�8
+j�j�(�Y<Y���]�qDT�N*�5j�~i�HFp0�ސ���Zh�[�y���ֱܽ�:�?JES��3�?������(v�����QSy����w�?�O����`:j��Zܜs֩z��Z�$�i��a&�ס=�=�����{��=�����<"V�č��W��7�
k���[�1Z^�M��[�'��O�^��?�;��=Y�w\[��~)����u-��K�'�+cP����1OA��+pܱ(�ƄPPQ�X�XYQ��,�������N�/w�;;���n)�\�!�H7����<�g�:�����������5e��ʗׅ�7d�C�Z�5XX���D��D�o�8�#ؘ?�o`G��Kc���m
i�q��gZjVoC��O��=q\O��/+�[Y���=�{��}�5��Wi_R�tT���_����J�s�Y��>���v�]O�YO�U�s|���лН�dzO��橿u�S�C�U[�w̵�wf���7~@|e����MN�@���
!�$m�@E�,X T$�3�,`�Y�,=��V��Ɍ���R��̈��H<W`V�7�<��|���&�~_0���0F��É~���+R�w
���?c!u9V�|�_p�������_��v��uP�*!�k�y�����W�~Lթe-�Ԡ��z�y�-;��[�;pG����z��)'��xk�\�l�l��~���Ӧa����|�w� 9՟QW���Ǽ��"]΃�FM�p��;�{�c:[:c=5�O��;��N�쿝���QR�����Mn�0��ꙸV��8@���
+��
+qv,Xr�^�/�u:MP����{3���"�$�c�HI
+ЀD�Ϡ��5Xs�gl���N��1[p;�̜N�'���܉/��/
9)�3R[�oK�8���Κ��U��,�r���j2�����WF[p�K�3wغ��۫�+�w�ٱ����<6��	��]5��sg^X�H/������>���zo<�5z"{1У�־�\W:W�����`�R�X�g�?~=�`��SoÎ=�nM�u�gd��}�;��O�)}�ܛ}b�/���������AO1�����߂ݥ�
+��x�D�̓	��oɛ8���×l�ә7oZ�Dd@�������ЂF����6��`V<W��p�����N��פ��пo���
	�;]��_���'�;���
���z��a}O̧u����S��h���D�Zjf���8�G�֚�Ƚ1�E���f�E�G5���g��wG��R��z���H��9�-k����o	�����rd�
��h�	I�Nt����*Ci������~��]��iM?6�1ܘ'�O)�Y}���
�A�ٰ���MJQ�;��V���L&3�?!�W�B���^A<��TA[:��`�OWw�뉈yĎ#2%ڟ҂��2q.���O��`ӟ%��'`��μα����?���ѐE|������3ֺ�ކk�=�g�^�=(�Ւ�y����ٲ7�z�k��2�ɺ]��<5�<�[�����޸1�Gk��}�;�Ny��z�y\���D���spM_W�4�W�j�3�19�39��ܥ���]Z��K�u?���+s�[�{��f[1��q�z���:Ӛ���c�c��>�Ց���\�/������AJAE+�2���q&3ݓIbE���7�W�#$�A�
�CQ����SEwuկ�1���.�"�W
�K�hAr,��2���sp{Ag��7n�HK����Oh��/[�Έ�(�VdN;�;�7��s-vO���:*�����I�o������y�f���7؂_���b�.B�D�_�7��c�b<����e�/z܂{��;'���
s:5;)�
t��xVq㬩Sf^�ip��)��g����Ms��ܿ����o���7�iF4�)���U����=Oԩ��5}��y�x����^#��u�;N1�	)8'��<���nx(
!�(�"E���)�@���������#�����1c{vbf��>��UZ;�-̨�sx6�l��`�	����@��~?�w���A�h�����6|G������
��̳���l.�>�N�
��qz�����x�
<�=����?��빢��?�o(���y�ַV��R��uL�ԧc�څ���k��j6E-���|c����c����S�{ޞ:�s�̗�,����;k}]�Q��U�?��8'����׾���9�������l�����kx�
+��^~
M��а���;KQ�'�����Gv7k��*T�J��&M E*�M҈�����3p�^->�;;�{f����o�Hɞ���5�c�6f�m|���
�{����U9^��:{�#0b�����΃D����7��ZL�����!ۘ�����uB~��~�	,�܂p^�'x��,�.�S��]��~�_~�����w���?�d�9k�r>p���]��{�>4����
�;��V���+�Gs�=���7�sJ����y����Ҩ��7�}j����q�]��Y�=��CW{�nz{����������O�����AN�@E
w�T,��L�!)E,(�M�
+���cq
+���c&�xj��|�?��Ml���!��Yy	t�����%@C��(w-5zpBf �q�祻OԟtKg���/�P3�)ѽ����s�u��M)Ԍ�Q_�$3�=i�qD4�x`
���=x�����>b��d�9b\���}���_j>Ր7=�ϜO>Ͷ^̶����"�
n��mvZ���%������N��{��j��;�]e���͚�~�����t�/c�~����3zS<�׶ٿ����6���%�����������]n�0���g)ΏI�o�Pj�x�2=Eoӱ:#-�X<|Jl�w'��"�yu,I)N륡
��l�� �/"����@=�'��BT�ts[0�����ݝi�ε�8��G��2y�r�t�Pg �{֓������VL��ij�����h߯[�}��x_g�K$��9�J�L���m��s�w��lfx�
7�>���1ϑ:�n[[˘q�y�o3𙜎�O���Ξ�����L��55��wp
�Ʒ=���7�Ǚ��x�2��7�����NA��qw`p
+Ac����w�H8�B^��U�T؍�/��W]�=�R�?F�\p��:�">�`Lj�KW�=N{on���|�5�R�"1f͵.�Ҟ�x����q��Q�܃
�7\+V��9�_�s0c>�r�<u&�{t���/������G���E�z,86��s3Ҙ�._�ݏ�KȻ��/���g���{����5z��
+��m�y�_}��=���5�z��"���KI�=���Pϖ��
|�4`�d��]|�}z����N�9����;R1D��	�d��ֲ���|"�(�@�5��
+-�.��z���~�Q�5����eB��)[g��)�cрf����|���#b���_��y��j��ֆtjO1|�rtFI�(�Ķ�y`n�
�/��5O�oCH��.���*��_�!���!M�D���[󽌬wԻ��ܓڿs�[�yҿK��=�5�\߆�_�^Q�|Ϻt����^�x��:z���3N���͵Z���5\8�5�M������#p�������خ�]�t�o]_E=톰���An�@EM�[n�Cp	�$T�U�R�]��ض;�+��J�Cla}e�œf<����LD�R��\��ܑ����/	o/@�䷠X����[d4g��������K='��J٭&+��{1��A*w��s�\_�[=M#�����I����e���y_��`����|j_kG����%5�Cu웗���<�V?�[��^����+�
;w���P?����=a��[���ֹ����#�6���������vG�"3��	�a��g_�E� ������揰���=NA��=h8H�BA�lf��(�H�P�-T4!$�
�I���ɳx�������=�cf3�Ȑ��$0�{Nc�@"�w
.H�U�+1^3�<�uN�؀s�}�+��~?��13�0W�_�u�֣�������'W7���>����}L�Wg�������W˄x<�׶/w�
|�/����I&�k/�K�����W�>/~o�1&q��o�������x�Z�o�P?t��_5�ބ�u�sj������zL�Cc��3�gn�3�i��o�xk�=��+�N[�%u��z=���?�M�"����KnAD
�C�p
��@�LB�Bb��#�5�pr��K����f4��Ic�۟j��M�lF���)��IFf����Ÿ�i"c=��{K�of�����]������<�Z��;�<�W��W��:��	�WAR����S��ߨ�_th�K���J�v�3g�"i�=8�+���2V�::g�^u���t���Y{b���'���b>ݏ�����}�Q��9T�w�:5YI��*��
������w;�_������������<����P��?g���/�@�����1n1E�{�"��5��� (ER$5 GHAC�s���(���R<�z<����l`f#R�����u]����0�XoLFB��
+����'xMДB�vM�e���3!I�p�G2�ZCA�q_��`
�AS��>����C����Xp�t5&��"|_�|�L����t?"]yz���)�^�o�	��g쯒X�m�'�ܗz�~izK���3q��7��9��z�ׅ����߂���7�>��o��8��G�^��{{�����
̬����]N1�s��6��n[�ԇ��hOQ����c�1���C6�={SJ���#h�X
���a}W����ʷ6�\��z�~`�7#�yJ�q���?g�Y�����K�]0�������'����Pg<�O�'���է,g�^��{Qj>��	���V�8�{�g;���m���#8"w�n��}e=��u;��I��f��Q]�暍�u��qo]�Bϩ�޻6�`��[���s�f���s���
���gp	��k��7�h���z�����������0D��-mӍ��!N,ߋ�f���OmǓq�BBX�
+���0��d���F4�[�^�bZ���ƈo���~!�ܹZ�;�
����;�l��>}=	��:3�A���b�5�O榎�m@�h2�꧁�͸'x�}h�G�=O���8GĤ���Ø5�}��R��������&��㾕z���K�'��n]},����xvj���\����gC&�}�؃W�e�q�|�[�I�b<�'��^|/��կ��g������K�0D}b(M��Xp
���$.���QJY<)MS{<�����*p*�ÿ�H
���j9����Mv���N�4�sFj̨�rvZԍdP�UB�Pߓ����u=A�fW=ڷ�/?�Ἔ��?ѓ�&h�����q��I
̃���׭}֧�p�hθ�'�C#={�9y^���G������5f��������"�`��X�wы��`,x��g/�_]r�m�����;�0��m}Pl���At��S�2|j����:�Vι�DC�����
O��^���G�"�
{�wG���ɭ�Q8	w�)܄=t�	�g���y��x��s'a+\��s�N��D�s��@�-|�j��O{4��1�t��Scuj}�y�}W�����l|�B�����+�'�eD�����S�mA�C7�
F/`�v����K3��=ro�(��E=O����x�f�w�/��������A
+�0Esb�m�Z�*
+�K7��!<��q��_�㐴�GIf2��3�97t�
�А���$�W_�3C<(Ia귱1X�
X�J��:�:'�HN
v�	��^�j���~�?�{"�[=�H�A�
+��
+��
�Cї����~�����
̕R?0w�w�;�|�޽��l����zo}_�O;'{�W�5zS�R�ٵ������HH��w�������߆���+
��ϋ�&6{Z�WSK����<�Y�X��c:co���|
K��O����KNA�.�<�@����q�K\zW�­�$V�ꤨ��/0W��G�
���1��(����H�=i���<�[0�N�$���k$����]�_��a�
/��N�S{��$�Z��������������;x�s-���������5�s`N+��4m�S[��z�������h��8�/;�
��{����k����(�Z1�Ff��K��f�$����<�-g�]�����{�?Y�����w��Z��o�����R���}�M
A�C9��iӔV�����,]����KI���fD:/�D��/bH�ACp�au�~��
�O`�<+cĹN��}����Qy�t�"ݻ�������	�|4��O�ǿ>2z�(��v��5�Tv�Ji���c�1���/�kA�OF����d�gy^���7���������\0��ÿ���'υu��>�����\n��g���}���n,Л����ύ��x�����i~F;���g���.p����}-1l�����m�@�����"��D��(M����%�
�hFY����'���;{N)��?��}n�������ە���_���_�]���'8�4;�T����@�x��)��O�r������7�n-~��cL�ѿ6d�Fѷe�n�/�s����[�:�_}h����G�W�!ˠQNg��܂pk����`\�c�:q��?Λ��{�
~ɉ�����������}I\_�{y�S�,�y�@TSyz���X����[�+K��������
1DM?4D|�]��'@�p�
���0AɌ6���3'1�������[��T`�=�@W�}���u]�QC�����w.�n�j�'x��^�
+���s��U�s$�)؀#8�؃��Us��C��@�w6z)��}F�}jQ�w��[����ܯ<�֙x����dz��O
+�}�^g�s�����_�a�!�#��x��=��<3��uV�ƹf��)�O�b}��[������g��YjV�;w�?�1�&V����M
+�0���ڦik
+*�� �B<�Wp�…Wq����qȈ�l�d�%�9�9�JN�gK	
������)\WO�95��c���U=����`'��^������џ�9��o�-i���w����������f���P�9D��p	{��D�O�K������xE���<�4���*:Ö~�|�������9�=0�O�?gl��O���r-���p�9���7\�,��Rg(%����}YS��T��e
k�%rXg�s|��
�Ob�����JA�;_ͷ�ٝ�I\M�
�@�c�
+y
��5P
M9#>ӝ��Y3���,���ɢA#X򷗺�넞t
��u���Uox��
|�w�M�Q�Vn:_I����<�o��98�'p��=�a�Ih���%I�]8ýV�v_�v���>׳ӽ�^���;�����T���J>k�^�p��e��uk�����s��y��DOE�w<�� s����ܸ�,5�%�߻�7T�e����������������_�Z�Z�Z����}�kNA�8
'�V����9��^BO�Oo�]���)g��e=ۏ�Z3���̉��#�
+
X�� ����4�>��ǽ�Z�ڷ�K�u�X��Z���kГ6�H!�2�k����f����/<����GG��׽�����*�g?�Op?�
�x��&+��?Tw������רS�-��3�
���O�xιbξ���zG�š;~�Yy_�Œ;X۵J{w���W��f�H��5����^���w_��O�+���
a��k��\�'����;�0D���@H�/|t�q
JJ�%�
4+��œ��zv=k�Yf_$K0"c2<>
%��D�UOשx.h�?$ς�BR}k���{�ٳk2���*��w�V߬}5�A�]�_`��(����|v���������<��X��7����X��7�o����f�7%K�a�:�P}�u�%g�`�����
���>��G!�ԏT}�w�����sb�H�D�tlF���z���5=��T�Mߺ�ӷ����!*��}�1�@
=�q��KH ���
+Q�A��v�YqSع��޳��a�%�@)0����@��ZO�\~!����A_��o�5X=�����?kgz��:)ܱq�f���x�ܝ���?��o�1V����Ҿu�����sv���p��k2y��P?�G��E�_���YKu�N�}'�W�H�!։�x�wN�߀}c�q_rscL[���B������v�߮�zS��2���z���ʻ�'�b����i
+�@�S�䵴�tZۺ�
+�W�@�^ <2��c�L�ID���h��{R����M�ⲿ-؀z$��0;���	tN�%}{�$��l-�Q9('e���o&�|D���P��Z��[�C��r
�#��ۛ���ܖ�G�1yGD�Y��\ �~f܍8�oQ}�~�_ޯɥ�+�s����_^�'���`;V��h�z�avؿ,�uWΐ'�z��s=��^�r�;턽�|D����~�/�O������Y�0D}ah�na��E
��p	>�SjK�(������ؓ���"R)�J��y�(�b�^�7U&J�q�$݇��>��{����|�U�r-�s��5��kb��g�o��
��X����}�������QQooz�D���)�{
`��������n<_I���ؿ���/��T����ֿ�c�|��4]�#����~4;�����+���Y�
�+��Qa��֬-��y0彜v����=���������
�0�	�M[T�K 8s��X��
`�[�_�z�Q�Ď����L��R�֙��R�J�ݟK|#�Dl��H�mq��O��|����
vp�
�a&�:S�1+؋%�&��{Ru��HCx��o����X�A�$G������lŜ�_q~</�<qu>�s<\?ϙׇ��^'��槑7Z���;��7x�0�~�7\���=N�m+o���8of�ܽ��z��P���������;
+�@�ѫx߂�XX	���
+6v6�+�^E�30��k��d�1�cD$�T�H"���
+���$#}մ��3��s��	���X����������	.��t��*4��-ߏ�1����yrE`���}q��渂=��k����S��/s�*��շ����OBw��s_���9�z����*k3�<EZ]XB�����[�}�;~���X�X���m!�^��
�L��6oH�����c��7���D����=AA��9��8��=�/��ӈJ�P)D�w�8��c&���(~�}������GDm"�("E�zLd4������E��-�Z���CqD'a<�C�I���\�
����
+�Lf�F�$���3v���3���
q>R;]g�����,���	��n�猭�~��;�5������~�wؼ���/h�T�35��#�mJ�}�u��ŝ)8�j�NT�c]��O�D�Q�
�ط`���
+�;W9z��������1�����?ȼ��������{��'R���ԱNA�_���&���/#�q�!�XIBK�6��!��l-l��?�I&�-��vvgwv�h��q2�+2��Ϸ�R룸���zF.����>������94�'�iBK����^b^��W�܍k���^��M�T�;z�9�d��[��94��К�d��_
+�6��<=O)���_�}�o_G�O��k%�9���B�`(�Z�]ߗ9������8k�+����\\�W@�h�0���;-�=�>����z'�������S�����x����(O�����;<�����1NBA�"x+o���O�#��$j�@�)lL�I���������O�N޲_2�;;���f
�\�+G/C�?��|�8)����F���¯�~N�����⎌�\�����݋c��d�����_�?��I��3y'�Hg꾯s�����z}����-�ԗ��'7�T�c}��g��Mu���n~�{)��2:��sJV@�tH��
����/��h��%�<[���������s�~���o�쩧M.h��HS�.���������ݰ
\ No newline at end of file
diff --git a/Tests/test_file_fits.py b/Tests/test_file_fits.py
index cce0b05cda8..1c1df0d980d 100644
--- a/Tests/test_file_fits.py
+++ b/Tests/test_file_fits.py
@@ -6,7 +6,7 @@
 
 from PIL import FitsImagePlugin, Image
 
-from .helper import assert_image_equal, hopper
+from .helper import assert_image_equal, assert_image_equal_tofile, hopper
 
 TEST_FILE = "Tests/images/hopper.fits"
 
@@ -22,6 +22,11 @@ def test_open() -> None:
         assert_image_equal(im, hopper("L"))
 
 
+def test_gzip1() -> None:
+    with Image.open("Tests/images/m13_gzip.fits") as im:
+        assert_image_equal_tofile(im, "Tests/images/m13.fits")
+
+
 def test_invalid_file() -> None:
     # Arrange
     invalid_file = "Tests/images/flower.jpg"
diff --git a/docs/handbook/image-file-formats.rst b/docs/handbook/image-file-formats.rst
index 54f983b69c8..35bc87bd9a5 100644
--- a/docs/handbook/image-file-formats.rst
+++ b/docs/handbook/image-file-formats.rst
@@ -1339,7 +1339,8 @@ FITS
 
 .. versionadded:: 9.1.0
 
-Pillow identifies and reads FITS files, commonly used for astronomy.
+Pillow identifies and reads FITS files, commonly used for astronomy. Uncompressed and
+GZIP_1 compressed images can be read.
 
 FLI, FLC
 ^^^^^^^^
diff --git a/src/PIL/FitsImagePlugin.py b/src/PIL/FitsImagePlugin.py
index e69890babcc..07191892506 100644
--- a/src/PIL/FitsImagePlugin.py
+++ b/src/PIL/FitsImagePlugin.py
@@ -10,6 +10,7 @@
 #
 from __future__ import annotations
 
+import gzip
 import math
 
 from . import Image, ImageFile
@@ -27,14 +28,32 @@ def _open(self) -> None:
         assert self.fp is not None
 
         headers: dict[bytes, bytes] = {}
+        header_in_progress = False
+        decoder_name = ""
         while True:
             header = self.fp.read(80)
             if not header:
                 msg = "Truncated FITS file"
                 raise OSError(msg)
             keyword = header[:8].strip()
-            if keyword == b"END":
+            if keyword in (b"SIMPLE", b"XTENSION"):
+                header_in_progress = True
+            elif headers and not header_in_progress:
+                # This is now a data unit
                 break
+            elif keyword == b"END":
+                # Seek to the end of the header unit
+                self.fp.seek(math.ceil(self.fp.tell() / 2880) * 2880)
+                if not decoder_name:
+                    decoder_name, offset, args = self._parse_headers(headers)
+
+                header_in_progress = False
+                continue
+
+            if decoder_name:
+                # Keep going to read past the headers
+                continue
+
             value = header[8:].split(b"/")[0].strip()
             if value.startswith(b"="):
                 value = value[1:].strip()
@@ -43,32 +62,87 @@ def _open(self) -> None:
                 raise SyntaxError(msg)
             headers[keyword] = value
 
-        naxis = int(headers[b"NAXIS"])
-        if naxis == 0:
+        if not decoder_name:
             msg = "No image data"
             raise ValueError(msg)
-        elif naxis == 1:
-            self._size = 1, int(headers[b"NAXIS1"])
+
+        offset += self.fp.tell() - 80
+        self.tile = [(decoder_name, (0, 0) + self.size, offset, args)]
+
+    def _get_size(
+        self, headers: dict[bytes, bytes], prefix: bytes
+    ) -> tuple[int, int] | None:
+        naxis = int(headers[prefix + b"NAXIS"])
+        if naxis == 0:
+            return None
+
+        if naxis == 1:
+            return 1, int(headers[prefix + b"NAXIS1"])
         else:
-            self._size = int(headers[b"NAXIS1"]), int(headers[b"NAXIS2"])
+            return int(headers[prefix + b"NAXIS1"]), int(headers[prefix + b"NAXIS2"])
+
+    def _parse_headers(
+        self, headers: dict[bytes, bytes]
+    ) -> tuple[str, int, tuple[str | int, ...]]:
+        prefix = b""
+        decoder_name = "raw"
+        offset = 0
+        if (
+            headers.get(b"XTENSION") == b"'BINTABLE'"
+            and headers.get(b"ZIMAGE") == b"T"
+            and headers[b"ZCMPTYPE"] == b"'GZIP_1  '"
+        ):
+            no_prefix_size = self._get_size(headers, prefix) or (0, 0)
+            number_of_bits = int(headers[b"BITPIX"])
+            offset = no_prefix_size[0] * no_prefix_size[1] * (number_of_bits // 8)
 
-        number_of_bits = int(headers[b"BITPIX"])
+            prefix = b"Z"
+            decoder_name = "fits_gzip"
+
+        size = self._get_size(headers, prefix)
+        if not size:
+            return "", 0, ()
+
+        self._size = size
+
+        number_of_bits = int(headers[prefix + b"BITPIX"])
         if number_of_bits == 8:
             self._mode = "L"
         elif number_of_bits == 16:
-            self._mode = "I"
+            self._mode = "I;16"
         elif number_of_bits == 32:
             self._mode = "I"
         elif number_of_bits in (-32, -64):
             self._mode = "F"
 
-        offset = math.ceil(self.fp.tell() / 2880) * 2880
-        self.tile = [("raw", (0, 0) + self.size, offset, (self.mode, 0, -1))]
+        args = (self.mode, 0, -1) if decoder_name == "raw" else (number_of_bits,)
+        return decoder_name, offset, args
+
+
+class FitsGzipDecoder(ImageFile.PyDecoder):
+    _pulls_fd = True
+
+    def decode(self, buffer):
+        assert self.fd is not None
+        value = gzip.decompress(self.fd.read())
+
+        rows = []
+        offset = 0
+        number_of_bits = min(self.args[0] // 8, 4)
+        for y in range(self.state.ysize):
+            row = bytearray()
+            for x in range(self.state.xsize):
+                row += value[offset + (4 - number_of_bits) : offset + 4]
+                offset += 4
+            rows.append(row)
+        self.set_as_raw(bytes([pixel for row in rows[::-1] for pixel in row]))
+        return -1, 0
 
 
 # --------------------------------------------------------------------
 # Registry
 
 Image.register_open(FitsImageFile.format, FitsImageFile, _accept)
+Image.register_decoder("fits_gzip", FitsGzipDecoder)
 
 Image.register_extensions(FitsImageFile.format, [".fit", ".fits"])

From 98c7d90af613a9d5e726361303ceea86b2998bda Mon Sep 17 00:00:00 2001
From: Hugo van Kemenade <1324225+hugovk@users.noreply.github.com>
Date: Wed, 27 Mar 2024 09:16:31 +0200
Subject: [PATCH 0406/1178] Variables can be None; update comment

Co-authored-by: Andrew Murray <3112309+radarhere@users.noreply.github.com>
---
 pyproject.toml      | 2 +-
 src/PIL/TiffTags.py | 8 ++++----
 2 files changed, 5 insertions(+), 5 deletions(-)

diff --git a/pyproject.toml b/pyproject.toml
index 2ef3fb2d1fd..c660752c923 100644
--- a/pyproject.toml
+++ b/pyproject.toml
@@ -117,7 +117,7 @@ ignore = [
   "E221", # Multiple spaces before operator
   "E226", # Missing whitespace around arithmetic operator
   "E241", # Multiple spaces after ','
-  "PYI034", # flake8-pyi: typing.Self added in Python 3.10
+  "PYI034", # flake8-pyi: typing.Self added in Python 3.11
 ]
 
 [tool.ruff.lint.per-file-ignores]
diff --git a/src/PIL/TiffTags.py b/src/PIL/TiffTags.py
index 3f2220c2ae9..469d4def9d5 100644
--- a/src/PIL/TiffTags.py
+++ b/src/PIL/TiffTags.py
@@ -22,11 +22,11 @@
 
 
 class _TagInfo(NamedTuple):
-    value: int
+    value: int | None
     name: str
-    type: int
-    length: int
-    enum: dict[int, str]
+    type: int | None
+    length: int | None
+    enum: dict[int, str] | None
 
 
 class TagInfo(_TagInfo):

From 73bf04474fce2bbbc89311ee4b35b4faa9ae3a8d Mon Sep 17 00:00:00 2001
From: Hugo van Kemenade <1324225+hugovk@users.noreply.github.com>
Date: Wed, 27 Mar 2024 10:35:28 +0200
Subject: [PATCH 0407/1178] enum can't be None

Co-authored-by: Andrew Murray <3112309+radarhere@users.noreply.github.com>
---
 src/PIL/TiffTags.py | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/src/PIL/TiffTags.py b/src/PIL/TiffTags.py
index 469d4def9d5..89fad703343 100644
--- a/src/PIL/TiffTags.py
+++ b/src/PIL/TiffTags.py
@@ -26,7 +26,7 @@ class _TagInfo(NamedTuple):
     name: str
     type: int | None
     length: int | None
-    enum: dict[int, str] | None
+    enum: dict[str, int]
 
 
 class TagInfo(_TagInfo):

From f05946a3904a4900226357fca3a004e88897e681 Mon Sep 17 00:00:00 2001
From: Hugo van Kemenade <1324225+hugovk@users.noreply.github.com>
Date: Wed, 27 Mar 2024 12:30:39 +0200
Subject: [PATCH 0408/1178] Skip AppVeyor builds for irrelevant files

---
 .appveyor.yml | 7 +++++++
 1 file changed, 7 insertions(+)

diff --git a/.appveyor.yml b/.appveyor.yml
index 93ed3f2dfbe..6f35a0190d4 100644
--- a/.appveyor.yml
+++ b/.appveyor.yml
@@ -1,3 +1,10 @@
+skip_commits:
+  files:
+    - ".github/**"
+    - ".gitmodules"
+    - "docs/**"
+    - "wheels/**"
+
 version: '{build}'
 clone_folder: c:\pillow
 init:

From 9c6b30560e6ac3b17e9053d1a4e2c1af3508e339 Mon Sep 17 00:00:00 2001
From: Yay295 <Yay295@gmail.com>
Date: Wed, 27 Mar 2024 10:51:33 -0500
Subject: [PATCH 0409/1178] use setup_module() to open images so they aren't
 opened if skipped

---
 Tests/test_image_fromqimage.py | 11 ++++++-----
 1 file changed, 6 insertions(+), 5 deletions(-)

diff --git a/Tests/test_image_fromqimage.py b/Tests/test_image_fromqimage.py
index c20123a1bbf..e214e58f942 100644
--- a/Tests/test_image_fromqimage.py
+++ b/Tests/test_image_fromqimage.py
@@ -16,13 +16,14 @@
     not ImageQt.qt_is_installed, reason="Qt bindings are not installed"
 )
 
-ims = [
-    hopper(),
-    Image.open("Tests/images/transparent.png"),
-    Image.open("Tests/images/7x13.png"),
-]
+ims = []
 
 
+def setup_module() -> None:
+    ims.append(hopper())
+    ims.append(Image.open("Tests/images/transparent.png"))
+    ims.append(Image.open("Tests/images/7x13.png"))
+
 def teardown_module() -> None:
     for im in ims:
         im.close()

From 26a212126f03eef8d8750911c452362df9fe1965 Mon Sep 17 00:00:00 2001
From: "pre-commit-ci[bot]"
 <66853113+pre-commit-ci[bot]@users.noreply.github.com>
Date: Wed, 27 Mar 2024 15:57:33 +0000
Subject: [PATCH 0410/1178] [pre-commit.ci] auto fixes from pre-commit.com
 hooks

for more information, see https://pre-commit.ci
---
 Tests/test_image_fromqimage.py | 1 +
 1 file changed, 1 insertion(+)

diff --git a/Tests/test_image_fromqimage.py b/Tests/test_image_fromqimage.py
index e214e58f942..7bd94cde751 100644
--- a/Tests/test_image_fromqimage.py
+++ b/Tests/test_image_fromqimage.py
@@ -24,6 +24,7 @@ def setup_module() -> None:
     ims.append(Image.open("Tests/images/transparent.png"))
     ims.append(Image.open("Tests/images/7x13.png"))
 
+
 def teardown_module() -> None:
     for im in ims:
         im.close()

From 0d86da54bcec702cf38db2c7031a218598aa5858 Mon Sep 17 00:00:00 2001
From: Yay295 <Yay295@users.noreply.github.com>
Date: Wed, 27 Mar 2024 14:02:02 -0500
Subject: [PATCH 0411/1178] add typing to "ims" in test_image_fromqimage.py
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit

Co-authored-by: Ondrej Baranovič <ondreko.tiba@gmail.com>
---
 Tests/test_image_fromqimage.py | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/Tests/test_image_fromqimage.py b/Tests/test_image_fromqimage.py
index 7bd94cde751..1149e29649e 100644
--- a/Tests/test_image_fromqimage.py
+++ b/Tests/test_image_fromqimage.py
@@ -16,7 +16,7 @@
     not ImageQt.qt_is_installed, reason="Qt bindings are not installed"
 )
 
-ims = []
+ims: list[Image.Image] = []
 
 
 def setup_module() -> None:

From 504a2e17c85221c48a81b8198b859d169e8908a8 Mon Sep 17 00:00:00 2001
From: Hugo van Kemenade <1324225+hugovk@users.noreply.github.com>
Date: Wed, 20 Mar 2024 09:49:18 +0200
Subject: [PATCH 0412/1178] Use functools.lru_cache for hopper()

---
 Tests/helper.py | 31 +++++++++++++++++--------------
 1 file changed, 17 insertions(+), 14 deletions(-)

diff --git a/Tests/helper.py b/Tests/helper.py
index 9849bf65565..dacce3fb948 100644
--- a/Tests/helper.py
+++ b/Tests/helper.py
@@ -11,6 +11,7 @@
 import sys
 import sysconfig
 import tempfile
+from functools import lru_cache
 from io import BytesIO
 from typing import Any, Callable, Sequence
 
@@ -250,25 +251,27 @@ def tostring(im: Image.Image, string_format: str, **options: Any) -> bytes:
     return out.getvalue()
 
 
-def hopper(mode: str | None = None, cache: dict[str, Image.Image] = {}) -> Image.Image:
+def hopper(mode: str | None = None) -> Image.Image:
+    # Use caching to reduce reading from disk but so an original copy is
+    # returned each time and the cached image isn't modified by tests
+    # (for fast, isolated, repeatable tests).
+    return _cached_hopper(mode).copy()
+
+
+@lru_cache(maxsize=None)
+def _cached_hopper(mode: str | None = None) -> Image.Image:
     if mode is None:
         # Always return fresh not-yet-loaded version of image.
         # Operations on not-yet-loaded images is separate class of errors
         # what we should catch.
         return Image.open("Tests/images/hopper.ppm")
-    # Use caching to reduce reading from disk but so an original copy is
-    # returned each time and the cached image isn't modified by tests
-    # (for fast, isolated, repeatable tests).
-    im = cache.get(mode)
-    if im is None:
-        if mode == "F":
-            im = hopper("L").convert(mode)
-        elif mode[:4] == "I;16":
-            im = hopper("I").convert(mode)
-        else:
-            im = hopper().convert(mode)
-        cache[mode] = im
-    return im.copy()
+    if mode == "F":
+        im = _cached_hopper("L").convert(mode)
+    elif mode[:4] == "I;16":
+        im = _cached_hopper("I").convert(mode)
+    else:
+        im = _cached_hopper().convert(mode)
+    return im
 
 
 def djpeg_available() -> bool:

From e7eea5ea306e91a29fb661be2dcaafa5d53950ee Mon Sep 17 00:00:00 2001
From: Nulano <nulano@nulano.eu>
Date: Sun, 31 Dec 2023 23:57:31 +0100
Subject: [PATCH 0413/1178] add type hints to _imagingcms

---
 src/PIL/_imagingcms.pyi | 147 +++++++++++++++++++++++++++++++++++++++-
 1 file changed, 145 insertions(+), 2 deletions(-)

diff --git a/src/PIL/_imagingcms.pyi b/src/PIL/_imagingcms.pyi
index e27843e5338..9cfd9d19143 100644
--- a/src/PIL/_imagingcms.pyi
+++ b/src/PIL/_imagingcms.pyi
@@ -1,3 +1,146 @@
-from typing import Any
+import datetime
+import sys
+from typing import Literal, TypedDict
 
-def __getattr__(name: str) -> Any: ...
+littlecms_version: str
+
+_tuple_3f = tuple[float, float, float]
+_tuple_2x3f = tuple[_tuple_3f, _tuple_3f]
+_tuple_3x3f = tuple[_tuple_3f, _tuple_3f, _tuple_3f]
+_tuple_2x3x3f = tuple[_tuple_3x3f, _tuple_3x3f]
+
+class _IccMeasurementCondition(TypedDict):
+    observer: int
+    backing: _tuple_3f
+    geo: str
+    flare: float
+    illuminant_type: str
+
+class _IccViewingCondition(TypedDict):
+    illuminant: _tuple_3f
+    surround: _tuple_3f
+    illuminant_type: str
+
+class CmsProfile:
+    @property
+    def rendering_intent(self) -> int: ...
+    @property
+    def creation_date(self) -> datetime.datetime | None: ...
+    @property
+    def copyright(self) -> str | None: ...
+    @property
+    def target(self) -> str | None: ...
+    @property
+    def manufacturer(self) -> str | None: ...
+    @property
+    def model(self) -> str | None: ...
+    @property
+    def profile_description(self) -> str | None: ...
+    @property
+    def screening_description(self) -> str | None: ...
+    @property
+    def viewing_condition(self) -> str | None: ...
+    @property
+    def version(self) -> float: ...
+    @property
+    def icc_version(self) -> int: ...
+    @property
+    def attributes(self) -> int: ...
+    @property
+    def header_flags(self) -> int: ...
+    @property
+    def header_manufacturer(self) -> str: ...
+    @property
+    def header_model(self) -> str: ...
+    @property
+    def device_class(self) -> str: ...
+    @property
+    def connection_space(self) -> str: ...
+    @property
+    def xcolor_space(self) -> str: ...
+    @property
+    def profile_id(self) -> bytes: ...
+    @property
+    def is_matrix_shaper(self) -> bool: ...
+    @property
+    def technology(self) -> str | None: ...
+    @property
+    def colorimetric_intent(self) -> str | None: ...
+    @property
+    def perceptual_rendering_intent_gamut(self) -> str | None: ...
+    @property
+    def saturation_rendering_intent_gamut(self) -> str | None: ...
+    @property
+    def red_colorant(self) -> _tuple_2x3f | None: ...
+    @property
+    def green_colorant(self) -> _tuple_2x3f | None: ...
+    @property
+    def blue_colorant(self) -> _tuple_2x3f | None: ...
+    @property
+    def red_primary(self) -> _tuple_2x3f | None: ...
+    @property
+    def green_primary(self) -> _tuple_2x3f | None: ...
+    @property
+    def blue_primary(self) -> _tuple_2x3f | None: ...
+    @property
+    def media_white_point_temperature(self) -> float | None: ...
+    @property
+    def media_white_point(self) -> _tuple_2x3f | None: ...
+    @property
+    def media_black_point(self) -> _tuple_2x3f | None: ...
+    @property
+    def luminance(self) -> _tuple_2x3f | None: ...
+    @property
+    def chromatic_adaptation(self) -> _tuple_2x3x3f | None: ...
+    @property
+    def chromaticity(self) -> _tuple_3x3f | None: ...
+    @property
+    def colorant_table(self) -> list[str] | None: ...
+    @property
+    def colorant_table_out(self) -> list[str] | None: ...
+    @property
+    def intent_supported(self) -> dict[int, tuple[bool, bool, bool]] | None: ...
+    @property
+    def clut(self) -> dict[int, tuple[bool, bool, bool]] | None: ...
+    @property
+    def icc_measurement_condition(self) -> _IccMeasurementCondition | None: ...
+    @property
+    def icc_viewing_condition(self) -> _IccViewingCondition | None: ...
+    def is_intent_supported(self, intent: int, direction: int, /) -> int: ...
+
+class CmsTransform:
+    @property
+    def inputMode(self) -> str: ...
+    @property
+    def outputMode(self) -> str: ...
+    def apply(self, id_in: int, id_out: int) -> int: ...
+
+def profile_open(profile: str, /) -> CmsProfile: ...
+def profile_frombytes(profile: bytes, /) -> CmsProfile: ...
+def profile_tobytes(profile: CmsProfile, /) -> bytes: ...
+def buildTransform(
+    input_profile: CmsProfile,
+    output_profile: CmsProfile,
+    in_mode: str,
+    out_mode: str,
+    rendering_intent: int = 0,
+    cms_flags: int = 0,
+    /,
+) -> CmsTransform: ...
+def buildProofTransform(
+    input_profile: CmsProfile,
+    output_profile: CmsProfile,
+    proof_profile: CmsProfile,
+    in_mode: str,
+    out_mode: str,
+    rendering_intent: int = 0,
+    proof_intent: int = 0,
+    cms_flags: int = 0,
+    /,
+) -> CmsTransform: ...
+def createProfile(
+    color_space: Literal["LAB", "XYZ", "sRGB"], color_temp: float = 0.0, /
+) -> CmsProfile: ...
+
+if sys.platform == "win32":
+    def get_display_profile_win32(handle: int = 0, is_dc: int = 0, /) -> str | None: ...

From 24ed5db2d117de3f8395d380372009b3ecc5baa6 Mon Sep 17 00:00:00 2001
From: Nulano <nulano@nulano.eu>
Date: Mon, 1 Jan 2024 00:48:13 +0100
Subject: [PATCH 0414/1178] check type given to ImageCms.core.profile_tobytes
 instead of crashing

---
 Tests/test_imagecms.py | 6 ++++++
 src/_imagingcms.c      | 2 +-
 2 files changed, 7 insertions(+), 1 deletion(-)

diff --git a/Tests/test_imagecms.py b/Tests/test_imagecms.py
index 6be29a70f70..c04d08806b0 100644
--- a/Tests/test_imagecms.py
+++ b/Tests/test_imagecms.py
@@ -506,6 +506,12 @@ def test_profile_typesafety() -> None:
     with pytest.raises(TypeError, match="Invalid type for Profile"):
         ImageCms.ImageCmsProfile(1).tobytes()
 
+    # also check core function
+    with pytest.raises(TypeError):
+        ImageCms.core.profile_tobytes(0)
+    with pytest.raises(TypeError):
+        ImageCms.core.profile_tobytes(1)
+
 
 def assert_aux_channel_preserved(
     mode: str, transform_in_place: bool, preserved_channel: str
diff --git a/src/_imagingcms.c b/src/_imagingcms.c
index c7728770a3e..7c7763653c7 100644
--- a/src/_imagingcms.c
+++ b/src/_imagingcms.c
@@ -143,7 +143,7 @@ cms_profile_tobytes(PyObject *self, PyObject *args) {
     cmsHPROFILE *profile;
 
     PyObject *ret;
-    if (!PyArg_ParseTuple(args, "O", &CmsProfile)) {
+    if (!PyArg_ParseTuple(args, "O!", &CmsProfile_Type, &CmsProfile)) {
         return NULL;
     }
 

From 0630ef061f532084b8705fb287b0d00a05bd2df9 Mon Sep 17 00:00:00 2001
From: Nulano <nulano@nulano.eu>
Date: Mon, 1 Jan 2024 00:46:53 +0100
Subject: [PATCH 0415/1178] =?UTF-8?q?=EF=BB=BFadd=20type=20hints=20for=20I?=
 =?UTF-8?q?mageCms.{ImageCmsProfile,ImageCmsTransform}?=
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit

---
 src/PIL/ImageCms.py | 32 ++++++++++++++++----------------
 1 file changed, 16 insertions(+), 16 deletions(-)

diff --git a/src/PIL/ImageCms.py b/src/PIL/ImageCms.py
index 39669d86919..ddfc7790413 100644
--- a/src/PIL/ImageCms.py
+++ b/src/PIL/ImageCms.py
@@ -23,7 +23,7 @@
 import sys
 from enum import IntEnum, IntFlag
 from functools import reduce
-from typing import Any
+from typing import Any, BinaryIO
 
 from . import Image, __version__
 from ._deprecate import deprecate
@@ -237,7 +237,7 @@ def GRIDPOINTS(n: int) -> Flags:
 
 
 class ImageCmsProfile:
-    def __init__(self, profile):
+    def __init__(self, profile: str | BinaryIO | core.CmsProfile) -> None:
         """
         :param profile: Either a string representing a filename,
             a file like object containing a profile or a
@@ -260,16 +260,16 @@ def __init__(self, profile):
         elif isinstance(profile, _imagingcms.CmsProfile):
             self._set(profile)
         else:
-            msg = "Invalid type for Profile"
+            msg = "Invalid type for Profile"  # type: ignore[unreachable]
             raise TypeError(msg)
 
-    def _set(self, profile, filename=None):
+    def _set(self, profile: core.CmsProfile, filename: str | None = None) -> None:
         self.profile = profile
         self.filename = filename
         self.product_name = None  # profile.product_name
         self.product_info = None  # profile.product_info
 
-    def tobytes(self):
+    def tobytes(self) -> bytes:
         """
         Returns the profile in a format suitable for embedding in
         saved images.
@@ -290,14 +290,14 @@ class ImageCmsTransform(Image.ImagePointHandler):
 
     def __init__(
         self,
-        input,
-        output,
-        input_mode,
-        output_mode,
-        intent=Intent.PERCEPTUAL,
-        proof=None,
-        proof_intent=Intent.ABSOLUTE_COLORIMETRIC,
-        flags=Flags.NONE,
+        input: ImageCmsProfile,
+        output: ImageCmsProfile,
+        input_mode: str,
+        output_mode: str,
+        intent: Intent = Intent.PERCEPTUAL,
+        proof: ImageCmsProfile | None = None,
+        proof_intent: Intent = Intent.ABSOLUTE_COLORIMETRIC,
+        flags: Flags | int = Flags.NONE,
     ):
         if proof is None:
             self.transform = core.buildTransform(
@@ -320,10 +320,10 @@ def __init__(
 
         self.output_profile = output
 
-    def point(self, im):
+    def point(self, im: Image.Image) -> Image.Image:
         return self.apply(im)
 
-    def apply(self, im, imOut=None):
+    def apply(self, im: Image.Image, imOut: Image.Image | None = None) -> Image.Image:
         im.load()
         if imOut is None:
             imOut = Image.new(self.output_mode, im.size, None)
@@ -331,7 +331,7 @@ def apply(self, im, imOut=None):
         imOut.info["icc_profile"] = self.output_profile.tobytes()
         return imOut
 
-    def apply_in_place(self, im):
+    def apply_in_place(self, im: Image.Image) -> Image.Image:
         im.load()
         if im.mode != self.output_mode:
             msg = "mode mismatch"

From a1a687c26142e56e9622ede9bd27dee73c9673c7 Mon Sep 17 00:00:00 2001
From: Nulano <nulano@nulano.eu>
Date: Mon, 1 Jan 2024 00:47:39 +0100
Subject: [PATCH 0416/1178] =?UTF-8?q?=EF=BB=BFadd=20type=20hints=20to=20Im?=
 =?UTF-8?q?ageCms.get=5Fdisplay=5Fprofile?=
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit

---
 Tests/test_imagecms.py |  7 ++++++-
 src/PIL/ImageCms.py    | 10 +++++-----
 2 files changed, 11 insertions(+), 6 deletions(-)

diff --git a/Tests/test_imagecms.py b/Tests/test_imagecms.py
index c04d08806b0..6530dc16076 100644
--- a/Tests/test_imagecms.py
+++ b/Tests/test_imagecms.py
@@ -4,13 +4,14 @@
 import os
 import re
 import shutil
+import sys
 from io import BytesIO
 from pathlib import Path
 from typing import Any
 
 import pytest
 
-from PIL import Image, ImageMode, features
+from PIL import Image, ImageMode, ImageWin, features
 
 from .helper import (
     assert_image,
@@ -213,6 +214,10 @@ def test_display_profile() -> None:
     # try fetching the profile for the current display device
     ImageCms.get_display_profile()
 
+    if sys.platform == "win32":
+        ImageCms.get_display_profile(ImageWin.HDC(0))
+        ImageCms.get_display_profile(ImageWin.HWND(0))
+
 
 def test_lab_color_profile() -> None:
     ImageCms.createProfile("LAB", 5000)
diff --git a/src/PIL/ImageCms.py b/src/PIL/ImageCms.py
index ddfc7790413..2f0f112a7c1 100644
--- a/src/PIL/ImageCms.py
+++ b/src/PIL/ImageCms.py
@@ -23,7 +23,7 @@
 import sys
 from enum import IntEnum, IntFlag
 from functools import reduce
-from typing import Any, BinaryIO
+from typing import Any, BinaryIO, SupportsInt
 
 from . import Image, __version__
 from ._deprecate import deprecate
@@ -341,7 +341,7 @@ def apply_in_place(self, im: Image.Image) -> Image.Image:
         return im
 
 
-def get_display_profile(handle=None):
+def get_display_profile(handle: SupportsInt | None = None) -> ImageCmsProfile | None:
     """
     (experimental) Fetches the profile for the current display device.
 
@@ -351,12 +351,12 @@ def get_display_profile(handle=None):
     if sys.platform != "win32":
         return None
 
-    from . import ImageWin
+    from . import ImageWin  # type: ignore[unused-ignore, unreachable]
 
     if isinstance(handle, ImageWin.HDC):
-        profile = core.get_display_profile_win32(handle, 1)
+        profile = core.get_display_profile_win32(int(handle), 1)
     else:
-        profile = core.get_display_profile_win32(handle or 0)
+        profile = core.get_display_profile_win32(int(handle or 0))
     if profile is None:
         return None
     return ImageCmsProfile(profile)

From 21566ebcdc21453bc5bcd6e4c9fdb63c559ece8a Mon Sep 17 00:00:00 2001
From: Nulano <nulano@nulano.eu>
Date: Mon, 1 Jan 2024 01:47:35 +0100
Subject: [PATCH 0417/1178] =?UTF-8?q?=EF=BB=BFadd=20type=20hints=20to=20py?=
 =?UTF-8?q?Cms=20functions=20in=20ImageCms?=
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit

---
 docs/conf.py        |  5 ++-
 src/PIL/ImageCms.py | 91 ++++++++++++++++++++++++++-------------------
 2 files changed, 56 insertions(+), 40 deletions(-)

diff --git a/docs/conf.py b/docs/conf.py
index 882e076685c..af45e5579e0 100644
--- a/docs/conf.py
+++ b/docs/conf.py
@@ -121,7 +121,10 @@
 # generating warnings in “nitpicky mode”. Note that type should include the domain name
 # if present. Example entries would be ('py:func', 'int') or
 # ('envvar', 'LD_LIBRARY_PATH').
-# nitpick_ignore = []
+nitpick_ignore = [
+    # sphinx does not understand `typing.Literal[-1]`
+    ("py:obj", "typing.Literal[-1, 1]"),
+]
 
 
 # -- Options for HTML output ----------------------------------------------
diff --git a/src/PIL/ImageCms.py b/src/PIL/ImageCms.py
index 2f0f112a7c1..c76241912f9 100644
--- a/src/PIL/ImageCms.py
+++ b/src/PIL/ImageCms.py
@@ -23,7 +23,7 @@
 import sys
 from enum import IntEnum, IntFlag
 from functools import reduce
-from typing import Any, BinaryIO, SupportsInt
+from typing import Any, BinaryIO, Literal, SupportsFloat, SupportsInt, Union
 
 from . import Image, __version__
 from ._deprecate import deprecate
@@ -366,6 +366,8 @@ def get_display_profile(handle: SupportsInt | None = None) -> ImageCmsProfile |
 # pyCMS compatible layer
 # --------------------------------------------------------------------.
 
+_CmsProfileCompatible = Union[str, BinaryIO, core.CmsProfile, ImageCmsProfile]
+
 
 class PyCMSError(Exception):
     """(pyCMS) Exception class.
@@ -375,14 +377,14 @@ class PyCMSError(Exception):
 
 
 def profileToProfile(
-    im,
-    inputProfile,
-    outputProfile,
-    renderingIntent=Intent.PERCEPTUAL,
-    outputMode=None,
-    inPlace=False,
-    flags=Flags.NONE,
-):
+    im: Image.Image,
+    inputProfile: _CmsProfileCompatible,
+    outputProfile: _CmsProfileCompatible,
+    renderingIntent: Intent = Intent.PERCEPTUAL,
+    outputMode: str | None = None,
+    inPlace: bool = False,
+    flags: Flags | int = Flags.NONE,
+) -> Image.Image | None:
     """
     (pyCMS) Applies an ICC transformation to a given image, mapping from
     ``inputProfile`` to ``outputProfile``.
@@ -470,7 +472,9 @@ def profileToProfile(
     return imOut
 
 
-def getOpenProfile(profileFilename):
+def getOpenProfile(
+    profileFilename: str | BinaryIO | core.CmsProfile,
+) -> ImageCmsProfile:
     """
     (pyCMS) Opens an ICC profile file.
 
@@ -493,13 +497,13 @@ def getOpenProfile(profileFilename):
 
 
 def buildTransform(
-    inputProfile,
-    outputProfile,
-    inMode,
-    outMode,
-    renderingIntent=Intent.PERCEPTUAL,
-    flags=Flags.NONE,
-):
+    inputProfile: _CmsProfileCompatible,
+    outputProfile: _CmsProfileCompatible,
+    inMode: str,
+    outMode: str,
+    renderingIntent: Intent = Intent.PERCEPTUAL,
+    flags: Flags | int = Flags.NONE,
+) -> ImageCmsTransform:
     """
     (pyCMS) Builds an ICC transform mapping from the ``inputProfile`` to the
     ``outputProfile``. Use applyTransform to apply the transform to a given
@@ -576,15 +580,15 @@ def buildTransform(
 
 
 def buildProofTransform(
-    inputProfile,
-    outputProfile,
-    proofProfile,
-    inMode,
-    outMode,
-    renderingIntent=Intent.PERCEPTUAL,
-    proofRenderingIntent=Intent.ABSOLUTE_COLORIMETRIC,
-    flags=Flags.SOFTPROOFING,
-):
+    inputProfile: _CmsProfileCompatible,
+    outputProfile: _CmsProfileCompatible,
+    proofProfile: _CmsProfileCompatible,
+    inMode: str,
+    outMode: str,
+    renderingIntent: Intent = Intent.PERCEPTUAL,
+    proofRenderingIntent: Intent = Intent.ABSOLUTE_COLORIMETRIC,
+    flags: Flags | int = Flags.SOFTPROOFING,
+) -> ImageCmsTransform:
     """
     (pyCMS) Builds an ICC transform mapping from the ``inputProfile`` to the
     ``outputProfile``, but tries to simulate the result that would be
@@ -692,7 +696,9 @@ def buildProofTransform(
 buildProofTransformFromOpenProfiles = buildProofTransform
 
 
-def applyTransform(im, transform, inPlace=False):
+def applyTransform(
+    im: Image.Image, transform: ImageCmsTransform, inPlace: bool = False
+) -> Image.Image | None:
     """
     (pyCMS) Applies a transform to a given image.
 
@@ -745,7 +751,9 @@ def applyTransform(im, transform, inPlace=False):
     return imOut
 
 
-def createProfile(colorSpace, colorTemp=-1):
+def createProfile(
+    colorSpace: Literal["LAB", "XYZ", "sRGB"], colorTemp: SupportsFloat = -1
+) -> core.CmsProfile:
     """
     (pyCMS) Creates a profile.
 
@@ -787,6 +795,9 @@ def createProfile(colorSpace, colorTemp=-1):
         except (TypeError, ValueError) as e:
             msg = f'Color temperature must be numeric, "{colorTemp}" not valid'
             raise PyCMSError(msg) from e
+    else:
+        # colorTemp is unused if colorSpace != "LAB"
+        colorTemp = 0.0
 
     try:
         return core.createProfile(colorSpace, colorTemp)
@@ -794,7 +805,7 @@ def createProfile(colorSpace, colorTemp=-1):
         raise PyCMSError(v) from v
 
 
-def getProfileName(profile):
+def getProfileName(profile: _CmsProfileCompatible) -> str:
     """
 
     (pyCMS) Gets the internal product name for the given profile.
@@ -828,15 +839,15 @@ def getProfileName(profile):
 
         if not (model or manufacturer):
             return (profile.profile.profile_description or "") + "\n"
-        if not manufacturer or len(model) > 30:
-            return model + "\n"
+        if not manufacturer or len(model) > 30:  # type: ignore[arg-type]
+            return model + "\n"  # type: ignore[operator]
         return f"{model} - {manufacturer}\n"
 
     except (AttributeError, OSError, TypeError, ValueError) as v:
         raise PyCMSError(v) from v
 
 
-def getProfileInfo(profile):
+def getProfileInfo(profile: _CmsProfileCompatible) -> str:
     """
     (pyCMS) Gets the internal product information for the given profile.
 
@@ -873,7 +884,7 @@ def getProfileInfo(profile):
         raise PyCMSError(v) from v
 
 
-def getProfileCopyright(profile):
+def getProfileCopyright(profile: _CmsProfileCompatible) -> str:
     """
     (pyCMS) Gets the copyright for the given profile.
 
@@ -901,7 +912,7 @@ def getProfileCopyright(profile):
         raise PyCMSError(v) from v
 
 
-def getProfileManufacturer(profile):
+def getProfileManufacturer(profile: _CmsProfileCompatible) -> str:
     """
     (pyCMS) Gets the manufacturer for the given profile.
 
@@ -929,7 +940,7 @@ def getProfileManufacturer(profile):
         raise PyCMSError(v) from v
 
 
-def getProfileModel(profile):
+def getProfileModel(profile: _CmsProfileCompatible) -> str:
     """
     (pyCMS) Gets the model for the given profile.
 
@@ -958,7 +969,7 @@ def getProfileModel(profile):
         raise PyCMSError(v) from v
 
 
-def getProfileDescription(profile):
+def getProfileDescription(profile: _CmsProfileCompatible) -> str:
     """
     (pyCMS) Gets the description for the given profile.
 
@@ -987,7 +998,7 @@ def getProfileDescription(profile):
         raise PyCMSError(v) from v
 
 
-def getDefaultIntent(profile):
+def getDefaultIntent(profile: _CmsProfileCompatible) -> int:
     """
     (pyCMS) Gets the default intent name for the given profile.
 
@@ -1026,7 +1037,9 @@ def getDefaultIntent(profile):
         raise PyCMSError(v) from v
 
 
-def isIntentSupported(profile, intent, direction):
+def isIntentSupported(
+    profile: _CmsProfileCompatible, intent: Intent, direction: Direction
+) -> Literal[-1, 1]:
     """
     (pyCMS) Checks if a given intent is supported.
 
@@ -1077,7 +1090,7 @@ def isIntentSupported(profile, intent, direction):
         raise PyCMSError(v) from v
 
 
-def versions():
+def versions() -> tuple[str, str, str, str]:
     """
     (pyCMS) Fetches versions.
     """

From afd6e1fa297d60696f05923097c01b1846de4b49 Mon Sep 17 00:00:00 2001
From: Nulano <nulano@nulano.eu>
Date: Mon, 1 Jan 2024 02:36:46 +0100
Subject: [PATCH 0418/1178] import _imagingcms as core

---
 src/PIL/ImageCms.py | 7 +++----
 1 file changed, 3 insertions(+), 4 deletions(-)

diff --git a/src/PIL/ImageCms.py b/src/PIL/ImageCms.py
index c76241912f9..022967025aa 100644
--- a/src/PIL/ImageCms.py
+++ b/src/PIL/ImageCms.py
@@ -29,13 +29,13 @@
 from ._deprecate import deprecate
 
 try:
-    from . import _imagingcms
+    from . import _imagingcms as core
 except ImportError as ex:
     # Allow error import for doc purposes, but error out when accessing
     # anything in core.
     from ._util import DeferredError
 
-    _imagingcms = DeferredError.new(ex)
+    core = DeferredError.new(ex)
 
 _DESCRIPTION = """
 pyCMS
@@ -119,7 +119,6 @@ def __getattr__(name: str) -> Any:
 
 # --------------------------------------------------------------------.
 
-core = _imagingcms
 
 #
 # intent/direction values
@@ -257,7 +256,7 @@ def __init__(self, profile: str | BinaryIO | core.CmsProfile) -> None:
             self._set(core.profile_open(profile), profile)
         elif hasattr(profile, "read"):
             self._set(core.profile_frombytes(profile.read()))
-        elif isinstance(profile, _imagingcms.CmsProfile):
+        elif isinstance(profile, core.CmsProfile):
             self._set(profile)
         else:
             msg = "Invalid type for Profile"  # type: ignore[unreachable]

From 047a0d2a64b135ce5f912814777e4b5862ade07b Mon Sep 17 00:00:00 2001
From: Nulano <nulano@nulano.eu>
Date: Tue, 2 Jan 2024 00:25:39 +0100
Subject: [PATCH 0419/1178] do not allow ImageCms.core.CmsProfile to be
 instantiated directly

---
 Tests/test_imagecms.py | 14 +++++++++-----
 src/_imagingcms.c      |  2 --
 2 files changed, 9 insertions(+), 7 deletions(-)

diff --git a/Tests/test_imagecms.py b/Tests/test_imagecms.py
index 6530dc16076..821443e393f 100644
--- a/Tests/test_imagecms.py
+++ b/Tests/test_imagecms.py
@@ -19,6 +19,7 @@
     assert_image_similar,
     assert_image_similar_tofile,
     hopper,
+    is_pypy,
 )
 
 try:
@@ -501,11 +502,7 @@ def test_non_ascii_path(tmp_path: Path) -> None:
 
 
 def test_profile_typesafety() -> None:
-    """Profile init type safety
-
-    prepatch, these would segfault, postpatch they should emit a typeerror
-    """
-
+    # does not segfault
     with pytest.raises(TypeError, match="Invalid type for Profile"):
         ImageCms.ImageCmsProfile(0).tobytes()
     with pytest.raises(TypeError, match="Invalid type for Profile"):
@@ -517,6 +514,13 @@ def test_profile_typesafety() -> None:
     with pytest.raises(TypeError):
         ImageCms.core.profile_tobytes(1)
 
+    if not is_pypy():
+        # core profile should not be directly instantiable
+        with pytest.raises(TypeError):
+            ImageCms.core.CmsProfile()
+        with pytest.raises(TypeError):
+            ImageCms.core.CmsProfile(0)
+
 
 def assert_aux_channel_preserved(
     mode: str, transform_in_place: bool, preserved_channel: str
diff --git a/src/_imagingcms.c b/src/_imagingcms.c
index 7c7763653c7..5ffb20a6aa5 100644
--- a/src/_imagingcms.c
+++ b/src/_imagingcms.c
@@ -1511,8 +1511,6 @@ setup_module(PyObject *m) {
     PyObject *v;
     int vn;
 
-    CmsProfile_Type.tp_new = PyType_GenericNew;
-
     /* Ready object types */
     PyType_Ready(&CmsProfile_Type);
     PyType_Ready(&CmsTransform_Type);

From 0015e9ce6821d4c4c6313d28eb3e0d1e58078078 Mon Sep 17 00:00:00 2001
From: Nulano <nulano@nulano.eu>
Date: Tue, 2 Jan 2024 00:25:57 +0100
Subject: [PATCH 0420/1178] expose ImageCms.core.CmsTransform

---
 Tests/test_imagecms.py | 9 +++++++++
 src/_imagingcms.c      | 3 +++
 2 files changed, 12 insertions(+)

diff --git a/Tests/test_imagecms.py b/Tests/test_imagecms.py
index 821443e393f..c80fab75b67 100644
--- a/Tests/test_imagecms.py
+++ b/Tests/test_imagecms.py
@@ -522,6 +522,15 @@ def test_profile_typesafety() -> None:
             ImageCms.core.CmsProfile(0)
 
 
+@pytest.mark.skipif(is_pypy(), reason="fails on PyPy")
+def test_transform_typesafety() -> None:
+    # core transform should not be directly instantiable
+    with pytest.raises(TypeError):
+        ImageCms.core.CmsProfile()
+    with pytest.raises(TypeError):
+        ImageCms.core.CmsProfile(0)
+
+
 def assert_aux_channel_preserved(
     mode: str, transform_in_place: bool, preserved_channel: str
 ) -> None:
diff --git a/src/_imagingcms.c b/src/_imagingcms.c
index 5ffb20a6aa5..b50c577d834 100644
--- a/src/_imagingcms.c
+++ b/src/_imagingcms.c
@@ -1518,6 +1518,9 @@ setup_module(PyObject *m) {
     Py_INCREF(&CmsProfile_Type);
     PyModule_AddObject(m, "CmsProfile", (PyObject *)&CmsProfile_Type);
 
+    Py_INCREF(&CmsTransform_Type);
+    PyModule_AddObject(m, "CmsTransform", (PyObject *)&CmsTransform_Type);
+
     d = PyModule_GetDict(m);
 
     /* this check is also in PIL.features.pilinfo() */

From abb73b5b86a8509a370bae8fd0181ebf8721a1df Mon Sep 17 00:00:00 2001
From: Nulano <nulano@nulano.eu>
Date: Sat, 20 Jan 2024 14:06:02 +0100
Subject: [PATCH 0421/1178] use PIL.ImageCms.core as module for PIL._imagingcms
 classes

---
 src/_imagingcms.c | 12 ++++++------
 1 file changed, 6 insertions(+), 6 deletions(-)

diff --git a/src/_imagingcms.c b/src/_imagingcms.c
index b50c577d834..4d66dcc1085 100644
--- a/src/_imagingcms.c
+++ b/src/_imagingcms.c
@@ -1421,9 +1421,9 @@ static struct PyGetSetDef cms_profile_getsetters[] = {
     {NULL}};
 
 static PyTypeObject CmsProfile_Type = {
-    PyVarObject_HEAD_INIT(NULL, 0) "PIL._imagingcms.CmsProfile", /*tp_name*/
-    sizeof(CmsProfileObject),                                    /*tp_basicsize*/
-    0,                                                           /*tp_itemsize*/
+    PyVarObject_HEAD_INIT(NULL, 0) "PIL.ImageCms.core.CmsProfile", /*tp_name*/
+    sizeof(CmsProfileObject),                                      /*tp_basicsize*/
+    0,                                                             /*tp_itemsize*/
     /* methods */
     (destructor)cms_profile_dealloc, /*tp_dealloc*/
     0,                               /*tp_vectorcall_offset*/
@@ -1473,9 +1473,9 @@ static struct PyGetSetDef cms_transform_getsetters[] = {
     {NULL}};
 
 static PyTypeObject CmsTransform_Type = {
-    PyVarObject_HEAD_INIT(NULL, 0) "CmsTransform", /*tp_name*/
-    sizeof(CmsTransformObject),                    /*tp_basicsize*/
-    0,                                             /*tp_itemsize*/
+    PyVarObject_HEAD_INIT(NULL, 0) "PIL.ImageCms.core.CmsTransform", /*tp_name*/
+    sizeof(CmsTransformObject),                                      /*tp_basicsize*/
+    0,                                                               /*tp_itemsize*/
     /* methods */
     (destructor)cms_transform_dealloc, /*tp_dealloc*/
     0,                                 /*tp_vectorcall_offset*/

From a81b945129451839b666533543d8643f4e29c260 Mon Sep 17 00:00:00 2001
From: Nulano <nulano@nulano.eu>
Date: Sat, 20 Jan 2024 22:33:58 +0100
Subject: [PATCH 0422/1178] Update CmsProfile docs to match _imagingcms type
 stubs

---
 docs/reference/ImageCms.rst | 52 ++++++++++++++++++-------------------
 1 file changed, 26 insertions(+), 26 deletions(-)

diff --git a/docs/reference/ImageCms.rst b/docs/reference/ImageCms.rst
index c4484cbe22a..96bd14dd32c 100644
--- a/docs/reference/ImageCms.rst
+++ b/docs/reference/ImageCms.rst
@@ -73,7 +73,7 @@ can be easily displayed in a chromaticity diagram, for example).
     :canonical: PIL._imagingcms.CmsProfile
 
     .. py:attribute:: creation_date
-        :type: Optional[datetime.datetime]
+        :type: datetime.datetime | None
 
         Date and time this profile was first created (see 7.2.1 of ICC.1:2010).
 
@@ -156,58 +156,58 @@ can be easily displayed in a chromaticity diagram, for example).
         not been calculated (see 7.2.18 of ICC.1:2010).
 
     .. py:attribute:: copyright
-        :type: Optional[str]
+        :type: str | None
 
         The text copyright information for the profile (see 9.2.21 of ICC.1:2010).
 
     .. py:attribute:: manufacturer
-        :type: Optional[str]
+        :type: str | None
 
         The (English) display string for the device manufacturer (see
         9.2.22 of ICC.1:2010).
 
     .. py:attribute:: model
-        :type: Optional[str]
+        :type: str | None
 
         The (English) display string for the device model of the device
         for which this profile is created (see 9.2.23 of ICC.1:2010).
 
     .. py:attribute:: profile_description
-        :type: Optional[str]
+        :type: str | None
 
         The (English) display string for the profile description (see
         9.2.41 of ICC.1:2010).
 
     .. py:attribute:: target
-        :type: Optional[str]
+        :type: str | None
 
         The name of the registered characterization data set, or the
         measurement data for a characterization target (see 9.2.14 of
         ICC.1:2010).
 
     .. py:attribute:: red_colorant
-        :type: Optional[tuple[tuple[float]]]
+        :type: tuple[tuple[float, float, float], tuple[float, float, float]] | None
 
         The first column in the matrix used in matrix/TRC transforms (see 9.2.44 of ICC.1:2010).
 
         The value is in the format ``((X, Y, Z), (x, y, Y))``, if available.
 
     .. py:attribute:: green_colorant
-        :type: Optional[tuple[tuple[float]]]
+        :type: tuple[tuple[float, float, float], tuple[float, float, float]] | None
 
         The second column in the matrix used in matrix/TRC transforms (see 9.2.30 of ICC.1:2010).
 
         The value is in the format ``((X, Y, Z), (x, y, Y))``, if available.
 
     .. py:attribute:: blue_colorant
-        :type: Optional[tuple[tuple[float]]]
+        :type: tuple[tuple[float, float, float], tuple[float, float, float]] | None
 
         The third column in the matrix used in matrix/TRC transforms (see 9.2.4 of ICC.1:2010).
 
         The value is in the format ``((X, Y, Z), (x, y, Y))``, if available.
 
     .. py:attribute:: luminance
-        :type: Optional[tuple[tuple[float]]]
+        :type: tuple[tuple[float, float, float], tuple[float, float, float]] | None
 
         The absolute luminance of emissive devices in candelas per square
         metre as described by the Y channel (see 9.2.32 of ICC.1:2010).
@@ -215,7 +215,7 @@ can be easily displayed in a chromaticity diagram, for example).
         The value is in the format ``((X, Y, Z), (x, y, Y))``, if available.
 
     .. py:attribute:: chromaticity
-        :type: Optional[tuple[tuple[float]]]
+        :type: tuple[tuple[float, float, float], tuple[float, float, float], tuple[float, float, float]] | None
 
         The data of the phosphor/colorant chromaticity set used (red,
         green and blue channels, see 9.2.16 of ICC.1:2010).
@@ -223,7 +223,7 @@ can be easily displayed in a chromaticity diagram, for example).
         The value is in the format ``((x, y, Y), (x, y, Y), (x, y, Y))``, if available.
 
     .. py:attribute:: chromatic_adaption
-        :type: tuple[tuple[float]]
+        :type: tuple[tuple[tuple[float, float, float], tuple[float, float, float], tuple[float, float, float]], tuple[tuple[float, float, float], tuple[float, float, float], tuple[float, float, float]]] | None
 
         The chromatic adaption matrix converts a color measured using the
         actual illumination conditions and relative to the actual adopted
@@ -249,34 +249,34 @@ can be easily displayed in a chromaticity diagram, for example).
         9.2.19 of ICC.1:2010).
 
     .. py:attribute:: colorimetric_intent
-        :type: Optional[str]
+        :type: str | None
 
         4-character string (padded with whitespace) identifying the image
         state of PCS colorimetry produced using the colorimetric intent
         transforms (see 9.2.20 of ICC.1:2010 for details).
 
     .. py:attribute:: perceptual_rendering_intent_gamut
-        :type: Optional[str]
+        :type: str | None
 
         4-character string (padded with whitespace) identifying the (one)
         standard reference medium gamut (see 9.2.37 of ICC.1:2010 for
         details).
 
     .. py:attribute:: saturation_rendering_intent_gamut
-        :type: Optional[str]
+        :type: str | None
 
         4-character string (padded with whitespace) identifying the (one)
         standard reference medium gamut (see 9.2.37 of ICC.1:2010 for
         details).
 
     .. py:attribute:: technology
-        :type: Optional[str]
+        :type: str | None
 
         4-character string (padded with whitespace) identifying the device
         technology (see 9.2.47 of ICC.1:2010 for details).
 
     .. py:attribute:: media_black_point
-        :type: Optional[tuple[tuple[float]]]
+        :type: tuple[tuple[float, float, float], tuple[float, float, float]] | None
 
         This tag specifies the media black point and is used for
         generating absolute colorimetry.
@@ -287,19 +287,19 @@ can be easily displayed in a chromaticity diagram, for example).
         The value is in the format ``((X, Y, Z), (x, y, Y))``, if available.
 
     .. py:attribute:: media_white_point_temperature
-        :type: Optional[float]
+        :type: float | None
 
         Calculates the white point temperature (see the LCMS documentation
         for more information).
 
     .. py:attribute:: viewing_condition
-        :type: Optional[str]
+        :type: str | None
 
         The (English) display string for the viewing conditions (see
         9.2.48 of ICC.1:2010).
 
     .. py:attribute:: screening_description
-        :type: Optional[str]
+        :type: str | None
 
         The (English) display string for the screening conditions.
 
@@ -307,21 +307,21 @@ can be easily displayed in a chromaticity diagram, for example).
         version 4.
 
     .. py:attribute:: red_primary
-        :type: Optional[tuple[tuple[float]]]
+        :type: tuple[tuple[float, float, float], tuple[float, float, float]] | None
 
         The XYZ-transformed of the RGB primary color red (1, 0, 0).
 
         The value is in the format ``((X, Y, Z), (x, y, Y))``, if available.
 
     .. py:attribute:: green_primary
-        :type: Optional[tuple[tuple[float]]]
+        :type: tuple[tuple[float, float, float], tuple[float, float, float]] | None
 
         The XYZ-transformed of the RGB primary color green (0, 1, 0).
 
         The value is in the format ``((X, Y, Z), (x, y, Y))``, if available.
 
     .. py:attribute:: blue_primary
-        :type: Optional[tuple[tuple[float]]]
+        :type: tuple[tuple[float, float, float], tuple[float, float, float]] | None
 
         The XYZ-transformed of the RGB primary color blue (0, 0, 1).
 
@@ -334,7 +334,7 @@ can be easily displayed in a chromaticity diagram, for example).
         documentation on LCMS).
 
     .. py:attribute:: clut
-        :type: dict[tuple[bool]]
+        :type: dict[int, tuple[bool, bool, bool]] | None
 
         Returns a dictionary of all supported intents and directions for
         the CLUT model.
@@ -353,7 +353,7 @@ can be easily displayed in a chromaticity diagram, for example).
         that intent is supported for that direction.
 
     .. py:attribute:: intent_supported
-        :type: dict[tuple[bool]]
+        :type: dict[int, tuple[bool, bool, bool]] | None
 
         Returns a dictionary of all supported intents and directions.
 
@@ -372,7 +372,7 @@ can be easily displayed in a chromaticity diagram, for example).
 
     There is one function defined on the class:
 
-    .. py:method:: is_intent_supported(intent, direction)
+    .. py:method:: is_intent_supported(intent: int, direction: int, /)
 
         Returns if the intent is supported for the given direction.
 

From ff523e3009c4621d43072eebdc93977214d33f26 Mon Sep 17 00:00:00 2001
From: =?UTF-8?q?Ondrej=20Baranovi=C4=8D?= <nulano@nulano.eu>
Date: Thu, 28 Mar 2024 17:52:15 +0100
Subject: [PATCH 0423/1178] Update .github/ISSUE_TEMPLATE/ISSUE_REPORT.md

Co-authored-by: Hugo van Kemenade <1324225+hugovk@users.noreply.github.com>
---
 .github/ISSUE_TEMPLATE/ISSUE_REPORT.md | 11 +++++++++--
 1 file changed, 9 insertions(+), 2 deletions(-)

diff --git a/.github/ISSUE_TEMPLATE/ISSUE_REPORT.md b/.github/ISSUE_TEMPLATE/ISSUE_REPORT.md
index a895c55da0d..ea4c0e92b8e 100644
--- a/.github/ISSUE_TEMPLATE/ISSUE_REPORT.md
+++ b/.github/ISSUE_TEMPLATE/ISSUE_REPORT.md
@@ -49,9 +49,16 @@ Thank you.
 * Pillow: 
 
 ```text
-Please paste here the output of running `python3 -m PIL --report`,
-or the output of the following Python code:
+Please paste here the output of running:
 
+python3 -m PIL.report
+or
+python3 -m PIL --report
+
+Or the output of the following Python code:
+
+from PIL import report
+# or
 from PIL import features
 features.pilinfo(supported_formats=False)
 ```

From d3665ea0ea42791293bb4b566a2661798bae9af6 Mon Sep 17 00:00:00 2001
From: Nulano <nulano@nulano.eu>
Date: Thu, 28 Mar 2024 18:20:32 +0100
Subject: [PATCH 0424/1178] fix lint

---
 pyproject.toml          |  1 +
 src/PIL/_imagingcms.pyi | 35 +++++++++++++++++------------------
 2 files changed, 18 insertions(+), 18 deletions(-)

diff --git a/pyproject.toml b/pyproject.toml
index e6fd0516709..740b0ebeac6 100644
--- a/pyproject.toml
+++ b/pyproject.toml
@@ -117,6 +117,7 @@ ignore = [
   "E221", # Multiple spaces before operator
   "E226", # Missing whitespace around arithmetic operator
   "E241", # Multiple spaces after ','
+  "PYI026", # flake8-pyi: typing.TypeAlias added in Python 3.10
   "PYI034", # flake8-pyi: typing.Self added in Python 3.11
 ]
 
diff --git a/src/PIL/_imagingcms.pyi b/src/PIL/_imagingcms.pyi
index 9cfd9d19143..723f80481d5 100644
--- a/src/PIL/_imagingcms.pyi
+++ b/src/PIL/_imagingcms.pyi
@@ -4,21 +4,20 @@ from typing import Literal, TypedDict
 
 littlecms_version: str
 
-_tuple_3f = tuple[float, float, float]
-_tuple_2x3f = tuple[_tuple_3f, _tuple_3f]
-_tuple_3x3f = tuple[_tuple_3f, _tuple_3f, _tuple_3f]
-_tuple_2x3x3f = tuple[_tuple_3x3f, _tuple_3x3f]
+_Tuple3f = tuple[float, float, float]
+_Tuple2x3f = tuple[_Tuple3f, _Tuple3f]
+_Tuple3x3f = tuple[_Tuple3f, _Tuple3f, _Tuple3f]
 
 class _IccMeasurementCondition(TypedDict):
     observer: int
-    backing: _tuple_3f
+    backing: _Tuple3f
     geo: str
     flare: float
     illuminant_type: str
 
 class _IccViewingCondition(TypedDict):
-    illuminant: _tuple_3f
-    surround: _tuple_3f
+    illuminant: _Tuple3f
+    surround: _Tuple3f
     illuminant_type: str
 
 class CmsProfile:
@@ -71,29 +70,29 @@ class CmsProfile:
     @property
     def saturation_rendering_intent_gamut(self) -> str | None: ...
     @property
-    def red_colorant(self) -> _tuple_2x3f | None: ...
+    def red_colorant(self) -> _Tuple2x3f | None: ...
     @property
-    def green_colorant(self) -> _tuple_2x3f | None: ...
+    def green_colorant(self) -> _Tuple2x3f | None: ...
     @property
-    def blue_colorant(self) -> _tuple_2x3f | None: ...
+    def blue_colorant(self) -> _Tuple2x3f | None: ...
     @property
-    def red_primary(self) -> _tuple_2x3f | None: ...
+    def red_primary(self) -> _Tuple2x3f | None: ...
     @property
-    def green_primary(self) -> _tuple_2x3f | None: ...
+    def green_primary(self) -> _Tuple2x3f | None: ...
     @property
-    def blue_primary(self) -> _tuple_2x3f | None: ...
+    def blue_primary(self) -> _Tuple2x3f | None: ...
     @property
     def media_white_point_temperature(self) -> float | None: ...
     @property
-    def media_white_point(self) -> _tuple_2x3f | None: ...
+    def media_white_point(self) -> _Tuple2x3f | None: ...
     @property
-    def media_black_point(self) -> _tuple_2x3f | None: ...
+    def media_black_point(self) -> _Tuple2x3f | None: ...
     @property
-    def luminance(self) -> _tuple_2x3f | None: ...
+    def luminance(self) -> _Tuple2x3f | None: ...
     @property
-    def chromatic_adaptation(self) -> _tuple_2x3x3f | None: ...
+    def chromatic_adaptation(self) -> tuple[_Tuple3x3f, _Tuple3x3f] | None: ...
     @property
-    def chromaticity(self) -> _tuple_3x3f | None: ...
+    def chromaticity(self) -> _Tuple3x3f | None: ...
     @property
     def colorant_table(self) -> list[str] | None: ...
     @property

From aef7ccda3ad4f9e224bf4b4728aa1063cba11e42 Mon Sep 17 00:00:00 2001
From: Nulano <nulano@nulano.eu>
Date: Thu, 28 Mar 2024 18:35:20 +0100
Subject: [PATCH 0425/1178] use SupportsRead instead of BinaryIO

---
 src/PIL/ImageCms.py | 11 +++++++----
 1 file changed, 7 insertions(+), 4 deletions(-)

diff --git a/src/PIL/ImageCms.py b/src/PIL/ImageCms.py
index 022967025aa..52937ce8377 100644
--- a/src/PIL/ImageCms.py
+++ b/src/PIL/ImageCms.py
@@ -23,10 +23,11 @@
 import sys
 from enum import IntEnum, IntFlag
 from functools import reduce
-from typing import Any, BinaryIO, Literal, SupportsFloat, SupportsInt, Union
+from typing import Any, Literal, SupportsFloat, SupportsInt, Union
 
 from . import Image, __version__
 from ._deprecate import deprecate
+from ._typing import SupportsRead
 
 try:
     from . import _imagingcms as core
@@ -236,7 +237,7 @@ def GRIDPOINTS(n: int) -> Flags:
 
 
 class ImageCmsProfile:
-    def __init__(self, profile: str | BinaryIO | core.CmsProfile) -> None:
+    def __init__(self, profile: str | SupportsRead[bytes] | core.CmsProfile) -> None:
         """
         :param profile: Either a string representing a filename,
             a file like object containing a profile or a
@@ -365,7 +366,9 @@ def get_display_profile(handle: SupportsInt | None = None) -> ImageCmsProfile |
 # pyCMS compatible layer
 # --------------------------------------------------------------------.
 
-_CmsProfileCompatible = Union[str, BinaryIO, core.CmsProfile, ImageCmsProfile]
+_CmsProfileCompatible = Union[
+    str, SupportsRead[bytes], core.CmsProfile, ImageCmsProfile
+]
 
 
 class PyCMSError(Exception):
@@ -472,7 +475,7 @@ def profileToProfile(
 
 
 def getOpenProfile(
-    profileFilename: str | BinaryIO | core.CmsProfile,
+    profileFilename: str | SupportsRead[bytes] | core.CmsProfile,
 ) -> ImageCmsProfile:
     """
     (pyCMS) Opens an ICC profile file.

From e6fa5dff631d7da4020889d889a42c835a4c8e70 Mon Sep 17 00:00:00 2001
From: Andrew Murray <radarhere@users.noreply.github.com>
Date: Tue, 19 Mar 2024 19:14:17 +1100
Subject: [PATCH 0426/1178] Append custom parameter to the end of sys.argv

---
 _custom_build/backend.py | 4 +---
 setup.py                 | 5 ++---
 2 files changed, 3 insertions(+), 6 deletions(-)

diff --git a/_custom_build/backend.py b/_custom_build/backend.py
index 2c670ff0ac3..44ec6efe5c6 100644
--- a/_custom_build/backend.py
+++ b/_custom_build/backend.py
@@ -11,14 +11,12 @@
 class _CustomBuildMetaBackend(backend_class):
     def run_setup(self, setup_script="setup.py"):
         if self.config_settings:
-            params = []
             for key, values in self.config_settings.items():
                 if not isinstance(values, list):
                     values = [values]
                 for value in values:
-                    params.append(f"--pillow-configuration={key}={value}")
+                    sys.argv.append(f"--pillow-configuration={key}={value}")
 
-            sys.argv = sys.argv[:1] + params + sys.argv[1:]
         return super().run_setup(setup_script)
 
     def build_wheel(
diff --git a/setup.py b/setup.py
index 9eb95771675..5effe657fe2 100644
--- a/setup.py
+++ b/setup.py
@@ -998,10 +998,9 @@ def debug_build():
 
 
 # parse configuration from _custom_build/backend.py
-while len(sys.argv[1]) >= 2 and sys.argv[1].startswith("--pillow-configuration="):
-    _, key, value = sys.argv[1].split("=", 2)
+while sys.argv[-1].startswith("--pillow-configuration="):
+    _, key, value = sys.argv.pop().split("=", 2)
     configuration.setdefault(key, []).append(value)
-    del sys.argv[1]
 
 try:
     setup(

From f0767ee4da4634af78c14b54a6f185535cd3429a Mon Sep 17 00:00:00 2001
From: Andrew Murray <radarhere@users.noreply.github.com>
Date: Fri, 29 Mar 2024 06:41:44 +1100
Subject: [PATCH 0427/1178] Update CHANGES.rst [ci skip]

---
 CHANGES.rst | 9 +++++++++
 1 file changed, 9 insertions(+)

diff --git a/CHANGES.rst b/CHANGES.rst
index 64f41a6a3ed..f753bcdc1ce 100644
--- a/CHANGES.rst
+++ b/CHANGES.rst
@@ -5,6 +5,15 @@ Changelog (Pillow)
 10.3.0 (unreleased)
 -------------------
 
+- Determine MPO size from markers, not EXIF data #7884
+  [radarhere]
+
+- Improved conversion from RGB to RGBa, LA and La #7888
+  [radarhere]
+
+- Support FITS images with GZIP_1 compression #7894
+  [radarhere]
+
 - Use I;16 mode for 9-bit JPEG 2000 images #7900
   [scaramallion, radarhere]
 

From d131f1c513d7c46017f1ab159ac8e371d609f5b4 Mon Sep 17 00:00:00 2001
From: Hugo van Kemenade <1324225+hugovk@users.noreply.github.com>
Date: Thu, 28 Mar 2024 22:13:09 +0200
Subject: [PATCH 0428/1178] Clarify comments

---
 Tests/helper.py | 4 ++--
 1 file changed, 2 insertions(+), 2 deletions(-)

diff --git a/Tests/helper.py b/Tests/helper.py
index dacce3fb948..8baaf4c428b 100644
--- a/Tests/helper.py
+++ b/Tests/helper.py
@@ -252,8 +252,8 @@ def tostring(im: Image.Image, string_format: str, **options: Any) -> bytes:
 
 
 def hopper(mode: str | None = None) -> Image.Image:
-    # Use caching to reduce reading from disk but so an original copy is
-    # returned each time and the cached image isn't modified by tests
+    # Use caching to reduce reading from disk, but return a copy
+    # so that the cached image isn't modified by the tests
     # (for fast, isolated, repeatable tests).
     return _cached_hopper(mode).copy()
 

From f8825d3736a58f5f5124e705926574ef384b4192 Mon Sep 17 00:00:00 2001
From: Andrew Murray <radarhere@users.noreply.github.com>
Date: Sat, 30 Mar 2024 09:20:45 +1100
Subject: [PATCH 0429/1178] Updated harfbuzz to 8.4.0

---
 .github/workflows/wheels-dependencies.sh | 2 +-
 winbuild/build_prepare.py                | 2 +-
 2 files changed, 2 insertions(+), 2 deletions(-)

diff --git a/.github/workflows/wheels-dependencies.sh b/.github/workflows/wheels-dependencies.sh
index 797f4613ae7..0d45d5a209d 100755
--- a/.github/workflows/wheels-dependencies.sh
+++ b/.github/workflows/wheels-dependencies.sh
@@ -16,7 +16,7 @@ ARCHIVE_SDIR=pillow-depends-main
 
 # Package versions for fresh source builds
 FREETYPE_VERSION=2.13.2
-HARFBUZZ_VERSION=8.3.1
+HARFBUZZ_VERSION=8.4.0
 LIBPNG_VERSION=1.6.43
 JPEGTURBO_VERSION=3.0.2
 OPENJPEG_VERSION=2.5.2
diff --git a/winbuild/build_prepare.py b/winbuild/build_prepare.py
index 43d710055b9..0d6da77549f 100644
--- a/winbuild/build_prepare.py
+++ b/winbuild/build_prepare.py
@@ -113,7 +113,7 @@ def cmd_msbuild(
     "BROTLI": "1.1.0",
     "FREETYPE": "2.13.2",
     "FRIBIDI": "1.0.13",
-    "HARFBUZZ": "8.3.1",
+    "HARFBUZZ": "8.4.0",
     "JPEGTURBO": "3.0.2",
     "LCMS2": "2.16",
     "LIBPNG": "1.6.43",

From fb6b8601721da507f590c85a1b9f426f6c45cca6 Mon Sep 17 00:00:00 2001
From: Andrew Murray <radarhere@users.noreply.github.com>
Date: Sat, 30 Mar 2024 11:33:55 +1100
Subject: [PATCH 0430/1178] Added RGB to I;16, I;16L and I;16B conversion

---
 Tests/helper.py          |  2 --
 src/libImaging/Convert.c | 23 +++++++++++++++++++++++
 2 files changed, 23 insertions(+), 2 deletions(-)

diff --git a/Tests/helper.py b/Tests/helper.py
index 9849bf65565..bdd195bf048 100644
--- a/Tests/helper.py
+++ b/Tests/helper.py
@@ -263,8 +263,6 @@ def hopper(mode: str | None = None, cache: dict[str, Image.Image] = {}) -> Image
     if im is None:
         if mode == "F":
             im = hopper("L").convert(mode)
-        elif mode[:4] == "I;16":
-            im = hopper("I").convert(mode)
         else:
             im = hopper().convert(mode)
         cache[mode] = im
diff --git a/src/libImaging/Convert.c b/src/libImaging/Convert.c
index 0b84aa1ba73..75fdab820e5 100644
--- a/src/libImaging/Convert.c
+++ b/src/libImaging/Convert.c
@@ -250,6 +250,26 @@ rgb2i(UINT8 *out_, const UINT8 *in, int xsize) {
     }
 }
 
+static void
+rgb2i16l(UINT8 *out_, const UINT8 *in, int xsize) {
+    int x;
+    for (x = 0; x < xsize; x++, in += 4) {
+        UINT8 v = CLIP16(L24(in) >> 16);
+        *out_++ = v;
+        *out_++ = v >> 8;
+    }
+}
+
+static void
+rgb2i16b(UINT8 *out_, const UINT8 *in, int xsize) {
+    int x;
+    for (x = 0; x < xsize; x++, in += 4) {
+        UINT8 v = CLIP16(L24(in) >> 16);
+        *out_++ = v >> 8;
+        *out_++ = v;
+    }
+}
+
 static void
 rgb2f(UINT8 *out_, const UINT8 *in, int xsize) {
     int x;
@@ -944,6 +964,9 @@ static struct {
     {"RGB", "LA", rgb2la},
     {"RGB", "La", rgb2la},
     {"RGB", "I", rgb2i},
+    {"RGB", "I;16", rgb2i16l},
+    {"RGB", "I;16L", rgb2i16l},
+    {"RGB", "I;16B", rgb2i16b},
     {"RGB", "F", rgb2f},
     {"RGB", "BGR;15", rgb2bgr15},
     {"RGB", "BGR;16", rgb2bgr16},

From 7e71621671f552d3b61e448b67602627fd395bc1 Mon Sep 17 00:00:00 2001
From: =?UTF-8?q?Ondrej=20Baranovi=C4=8D?= <nulano@nulano.eu>
Date: Sat, 30 Mar 2024 08:13:44 +0100
Subject: [PATCH 0431/1178] Update src/PIL/features.py

Co-authored-by: Andrew Murray <3112309+radarhere@users.noreply.github.com>
---
 src/PIL/features.py | 6 +++---
 1 file changed, 3 insertions(+), 3 deletions(-)

diff --git a/src/PIL/features.py b/src/PIL/features.py
index a7384a0a0e9..8a0b140049d 100644
--- a/src/PIL/features.py
+++ b/src/PIL/features.py
@@ -230,9 +230,9 @@ def pilinfo(out=None, supported_formats=True):
     """
     Prints information about this installation of Pillow.
     This function can be called with ``python3 -m PIL``.
-    It can also be called with ``python3 -m PIL --report`` to have
-    "supported_formats" set to ``False``, omitting the list of all supported image
-    file formats.
+    It can also be called with ``python3 -m PIL.report`` or ``python3 -m PIL --report``
+    to have "supported_formats" set to ``False``, omitting the list of all supported
+    image file formats.
 
     :param out:
         The output stream to print to. Defaults to ``sys.stdout`` if ``None``.

From 1ac1540fe348bb7e64f4ad4132a10f64762c5380 Mon Sep 17 00:00:00 2001
From: Andrew Murray <radarhere@users.noreply.github.com>
Date: Sat, 30 Mar 2024 14:22:00 +1100
Subject: [PATCH 0432/1178] Combined test_report.py into test_main.py

---
 Tests/test_main.py   | 11 ++++++-----
 Tests/test_report.py | 27 ---------------------------
 2 files changed, 6 insertions(+), 32 deletions(-)
 delete mode 100644 Tests/test_report.py

diff --git a/Tests/test_main.py b/Tests/test_main.py
index 9ed7fa3d662..5ed3ecd7a8a 100644
--- a/Tests/test_main.py
+++ b/Tests/test_main.py
@@ -7,11 +7,12 @@
 import pytest
 
 
-@pytest.mark.parametrize("report", (False, True))
-def test_main(report) -> None:
-    args = [sys.executable, "-m", "PIL"]
-    if report:
-        args.append("--report")
+@pytest.mark.parametrize(
+    "args, report",
+    ((["PIL.report"], True), (["PIL", "--report"], True), (["PIL"], False)),
+)
+def test_main(args, report) -> None:
+    args = [sys.executable, "-m"] + args
     out = subprocess.check_output(args).decode("utf-8")
     lines = out.splitlines()
     assert lines[0] == "-" * 68
diff --git a/Tests/test_report.py b/Tests/test_report.py
deleted file mode 100644
index d0fc528860d..00000000000
--- a/Tests/test_report.py
+++ /dev/null
@@ -1,27 +0,0 @@
-from __future__ import annotations
-
-import subprocess
-import sys
-
-
-def test_main() -> None:
-    args = [sys.executable, "-m", "PIL.report"]
-    out = subprocess.check_output(args).decode("utf-8")
-    lines = out.splitlines()
-    assert lines[0] == "-" * 68
-    assert lines[1].startswith("Pillow ")
-    assert lines[2].startswith("Python ")
-    lines = lines[3:]
-    while lines[0].startswith("    "):
-        lines = lines[1:]
-    assert lines[0] == "-" * 68
-    assert lines[1].startswith("Python executable is")
-    lines = lines[2:]
-    if lines[0].startswith("Environment Python files loaded from"):
-        lines = lines[1:]
-    assert lines[0].startswith("System Python files loaded from")
-    assert lines[1] == "-" * 68
-    assert lines[2].startswith("Python Pillow modules loaded from ")
-    assert lines[3].startswith("Binary Pillow modules loaded from ")
-    assert lines[4] == "-" * 68
-    assert "JPEG image/jpeg" not in out

From 6b0a79ce5706183374bf1855ecea1adb4d5b6ac8 Mon Sep 17 00:00:00 2001
From: =?UTF-8?q?Ondrej=20Baranovi=C4=8D?= <ondreko.tiba@gmail.com>
Date: Sat, 30 Mar 2024 08:33:14 +0100
Subject: [PATCH 0433/1178] sort the parameters

---
 Tests/test_main.py | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/Tests/test_main.py b/Tests/test_main.py
index 5ed3ecd7a8a..e9e12b24a79 100644
--- a/Tests/test_main.py
+++ b/Tests/test_main.py
@@ -9,7 +9,7 @@
 
 @pytest.mark.parametrize(
     "args, report",
-    ((["PIL.report"], True), (["PIL", "--report"], True), (["PIL"], False)),
+    ((["PIL"], False), (["PIL", "--report"], True), (["PIL.report"], True)),
 )
 def test_main(args, report) -> None:
     args = [sys.executable, "-m"] + args

From 5355af0ddd83d912d6fd12950428becfe44ec2c1 Mon Sep 17 00:00:00 2001
From: Nulano <nulano@nulano.eu>
Date: Sat, 30 Mar 2024 09:11:15 +0100
Subject: [PATCH 0434/1178] use SupportsFloat instead of float in
 _imagingcms.pyi

---
 src/PIL/ImageCms.py     | 3 ---
 src/PIL/_imagingcms.pyi | 4 ++--
 2 files changed, 2 insertions(+), 5 deletions(-)

diff --git a/src/PIL/ImageCms.py b/src/PIL/ImageCms.py
index 52937ce8377..b6e5b9e8fc3 100644
--- a/src/PIL/ImageCms.py
+++ b/src/PIL/ImageCms.py
@@ -797,9 +797,6 @@ def createProfile(
         except (TypeError, ValueError) as e:
             msg = f'Color temperature must be numeric, "{colorTemp}" not valid'
             raise PyCMSError(msg) from e
-    else:
-        # colorTemp is unused if colorSpace != "LAB"
-        colorTemp = 0.0
 
     try:
         return core.createProfile(colorSpace, colorTemp)
diff --git a/src/PIL/_imagingcms.pyi b/src/PIL/_imagingcms.pyi
index 723f80481d5..036521b0e5e 100644
--- a/src/PIL/_imagingcms.pyi
+++ b/src/PIL/_imagingcms.pyi
@@ -1,6 +1,6 @@
 import datetime
 import sys
-from typing import Literal, TypedDict
+from typing import Literal, SupportsFloat, TypedDict
 
 littlecms_version: str
 
@@ -138,7 +138,7 @@ def buildProofTransform(
     /,
 ) -> CmsTransform: ...
 def createProfile(
-    color_space: Literal["LAB", "XYZ", "sRGB"], color_temp: float = 0.0, /
+    color_space: Literal["LAB", "XYZ", "sRGB"], color_temp: SupportsFloat = 0.0, /
 ) -> CmsProfile: ...
 
 if sys.platform == "win32":

From c4114adc413b3deb85f58c87559f656233f8ba19 Mon Sep 17 00:00:00 2001
From: Nulano <nulano@nulano.eu>
Date: Sat, 30 Mar 2024 09:14:48 +0100
Subject: [PATCH 0435/1178] use Flags not Flags|int

---
 src/PIL/ImageCms.py | 8 ++++----
 1 file changed, 4 insertions(+), 4 deletions(-)

diff --git a/src/PIL/ImageCms.py b/src/PIL/ImageCms.py
index b6e5b9e8fc3..3a45572a128 100644
--- a/src/PIL/ImageCms.py
+++ b/src/PIL/ImageCms.py
@@ -297,7 +297,7 @@ def __init__(
         intent: Intent = Intent.PERCEPTUAL,
         proof: ImageCmsProfile | None = None,
         proof_intent: Intent = Intent.ABSOLUTE_COLORIMETRIC,
-        flags: Flags | int = Flags.NONE,
+        flags: Flags = Flags.NONE,
     ):
         if proof is None:
             self.transform = core.buildTransform(
@@ -385,7 +385,7 @@ def profileToProfile(
     renderingIntent: Intent = Intent.PERCEPTUAL,
     outputMode: str | None = None,
     inPlace: bool = False,
-    flags: Flags | int = Flags.NONE,
+    flags: Flags = Flags.NONE,
 ) -> Image.Image | None:
     """
     (pyCMS) Applies an ICC transformation to a given image, mapping from
@@ -504,7 +504,7 @@ def buildTransform(
     inMode: str,
     outMode: str,
     renderingIntent: Intent = Intent.PERCEPTUAL,
-    flags: Flags | int = Flags.NONE,
+    flags: Flags = Flags.NONE,
 ) -> ImageCmsTransform:
     """
     (pyCMS) Builds an ICC transform mapping from the ``inputProfile`` to the
@@ -589,7 +589,7 @@ def buildProofTransform(
     outMode: str,
     renderingIntent: Intent = Intent.PERCEPTUAL,
     proofRenderingIntent: Intent = Intent.ABSOLUTE_COLORIMETRIC,
-    flags: Flags | int = Flags.SOFTPROOFING,
+    flags: Flags = Flags.SOFTPROOFING,
 ) -> ImageCmsTransform:
     """
     (pyCMS) Builds an ICC transform mapping from the ``inputProfile`` to the

From 838bb6c49307e617a5e152c6f30a0a12645b3379 Mon Sep 17 00:00:00 2001
From: Andrew Murray <radarhere@users.noreply.github.com>
Date: Sat, 30 Mar 2024 20:22:50 +1100
Subject: [PATCH 0436/1178] Added RGB to I;16N conversion

---
 src/libImaging/Convert.c | 5 +++++
 1 file changed, 5 insertions(+)

diff --git a/src/libImaging/Convert.c b/src/libImaging/Convert.c
index 75fdab820e5..7e60a960c1b 100644
--- a/src/libImaging/Convert.c
+++ b/src/libImaging/Convert.c
@@ -967,6 +967,11 @@ static struct {
     {"RGB", "I;16", rgb2i16l},
     {"RGB", "I;16L", rgb2i16l},
     {"RGB", "I;16B", rgb2i16b},
+#ifdef WORDS_BIGENDIAN
+    {"RGB", "I;16N", rgb2i16b},
+#else
+    {"RGB", "I;16N", rgb2i16l},
+#endif
     {"RGB", "F", rgb2f},
     {"RGB", "BGR;15", rgb2bgr15},
     {"RGB", "BGR;16", rgb2bgr16},

From 94732782d0e69a86486025159c3ed94a06cd19e4 Mon Sep 17 00:00:00 2001
From: =?UTF-8?q?Ondrej=20Baranovi=C4=8D?= <nulano@nulano.eu>
Date: Sat, 30 Mar 2024 10:26:39 +0100
Subject: [PATCH 0437/1178] link to sphinx issue

Co-authored-by: Hugo van Kemenade <1324225+hugovk@users.noreply.github.com>
---
 docs/conf.py | 4 +++-
 1 file changed, 3 insertions(+), 1 deletion(-)

diff --git a/docs/conf.py b/docs/conf.py
index af45e5579e0..483535f9650 100644
--- a/docs/conf.py
+++ b/docs/conf.py
@@ -122,7 +122,9 @@
 # if present. Example entries would be ('py:func', 'int') or
 # ('envvar', 'LD_LIBRARY_PATH').
 nitpick_ignore = [
-    # sphinx does not understand `typing.Literal[-1]`
+    # Sphinx does not understand typing.Literal[-1]
+    # Will be fixed in a future version.
+    # https://github.com/sphinx-doc/sphinx/pull/11904
     ("py:obj", "typing.Literal[-1, 1]"),
 ]
 

From ed5cd18d9cbcb03494cfc1e90b264e35987c569a Mon Sep 17 00:00:00 2001
From: Hugo van Kemenade <1324225+hugovk@users.noreply.github.com>
Date: Sun, 31 Mar 2024 15:07:15 +0300
Subject: [PATCH 0438/1178] Always return fresh not-yet-loaded image for
 hopper(None)

---
 Tests/helper.py | 14 ++++++++------
 1 file changed, 8 insertions(+), 6 deletions(-)

diff --git a/Tests/helper.py b/Tests/helper.py
index 2ce9bdfafcd..aa6fa2ba12d 100644
--- a/Tests/helper.py
+++ b/Tests/helper.py
@@ -255,20 +255,22 @@ def hopper(mode: str | None = None) -> Image.Image:
     # Use caching to reduce reading from disk, but return a copy
     # so that the cached image isn't modified by the tests
     # (for fast, isolated, repeatable tests).
-    return _cached_hopper(mode).copy()
-
 
-@lru_cache(maxsize=None)
-def _cached_hopper(mode: str | None = None) -> Image.Image:
     if mode is None:
         # Always return fresh not-yet-loaded version of image.
         # Operations on not-yet-loaded images is separate class of errors
         # what we should catch.
         return Image.open("Tests/images/hopper.ppm")
+
+    return _cached_hopper(mode).copy()
+
+
+@lru_cache(maxsize=None)
+def _cached_hopper(mode: str | None = None) -> Image.Image:
     if mode == "F":
-        im = _cached_hopper("L").convert(mode)
+        im = hopper("L").convert(mode)
     else:
-        im = _cached_hopper().convert(mode)
+        im = hopper().convert(mode)
     return im
 
 

From edd620a352556b3b6e49db399e9d4a20c67a5283 Mon Sep 17 00:00:00 2001
From: Hugo van Kemenade <1324225+hugovk@users.noreply.github.com>
Date: Sun, 31 Mar 2024 15:56:57 +0300
Subject: [PATCH 0439/1178] Add type hints to release notes

---
 docs/releasenotes/10.3.0.rst | 6 ++++++
 1 file changed, 6 insertions(+)

diff --git a/docs/releasenotes/10.3.0.rst b/docs/releasenotes/10.3.0.rst
index 446ad211de5..36c5f5f5ff0 100644
--- a/docs/releasenotes/10.3.0.rst
+++ b/docs/releasenotes/10.3.0.rst
@@ -104,3 +104,9 @@ Release GIL when fetching WebP frames
 
 Python's Global Interpreter Lock is now released when fetching WebP frames from
 the libwebp decoder.
+
+Type hints
+^^^^^^^^^^
+
+Pillow now has type hints, and the package includes a ``py.typed`` file and the
+``Typing :: Typed`` Trove classifier.

From 7b2320b50fd44f54637752ebb0c7c365c4430085 Mon Sep 17 00:00:00 2001
From: Hugo van Kemenade <1324225+hugovk@users.noreply.github.com>
Date: Sun, 31 Mar 2024 15:57:20 +0300
Subject: [PATCH 0440/1178] Fix typos

---
 CHANGES.rst                 | 4 ++--
 Tests/test_locale.py        | 2 +-
 src/libImaging/JpegDecode.c | 2 +-
 3 files changed, 4 insertions(+), 4 deletions(-)

diff --git a/CHANGES.rst b/CHANGES.rst
index f753bcdc1ce..9dae34a1f92 100644
--- a/CHANGES.rst
+++ b/CHANGES.rst
@@ -4325,7 +4325,7 @@ Changelog (Pillow)
 - Documentation changes, URL update, transpose, release checklist
   [radarhere]
 
-- Fixed saving to nonexistant files specified by pathlib.Path objects #1748 (fixes #1747)
+- Fixed saving to nonexistent files specified by pathlib.Path objects #1748 (fixes #1747)
   [radarhere]
 
 - Round Image.crop arguments to the nearest integer #1745 (fixes #1744)
@@ -7536,7 +7536,7 @@ The test suite includes 400 individual tests.
 - A handbook is available (distributed separately).
 
 - The coordinate system is changed so that (0,0) is now located
-  in the upper left corner.  This is in compliancy with ISO 12087
+  in the upper left corner.  This is in compliance with ISO 12087
   and 90% of all other image processing and graphics libraries.
 
 - Modes "1" (bilevel) and "P" (palette) have been introduced.  Note
diff --git a/Tests/test_locale.py b/Tests/test_locale.py
index 1c8b84a2b41..386c57cc01f 100644
--- a/Tests/test_locale.py
+++ b/Tests/test_locale.py
@@ -19,7 +19,7 @@
 # 7
 # 160
 
-# one of string.whitespace is not freely convertable into ascii.
+# one of string.whitespace is not freely convertible into ascii.
 
 path = "Tests/images/hopper.jpg"
 
diff --git a/src/libImaging/JpegDecode.c b/src/libImaging/JpegDecode.c
index 55d10a81aec..6f75d867068 100644
--- a/src/libImaging/JpegDecode.c
+++ b/src/libImaging/JpegDecode.c
@@ -180,7 +180,7 @@ ImagingJpegDecode(Imaging im, ImagingCodecState state, UINT8 *buf, Py_ssize_t by
 
             /* Decoder settings */
 
-            /* jpegmode indicates whats in the file; if not set, we'll
+            /* jpegmode indicates what's in the file; if not set, we'll
                trust the decoder */
             if (strcmp(context->jpegmode, "L") == 0) {
                 context->cinfo.jpeg_color_space = JCS_GRAYSCALE;

From 6d57e8823791368ab7b2c8a426935bb14e6b26f2 Mon Sep 17 00:00:00 2001
From: Hugo van Kemenade <1324225+hugovk@users.noreply.github.com>
Date: Sun, 31 Mar 2024 17:41:46 +0300
Subject: [PATCH 0441/1178] Improve wording
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit

Co-authored-by: Ondrej Baranovič <ondreko.tiba@gmail.com>
---
 docs/releasenotes/10.3.0.rst | 4 ++--
 1 file changed, 2 insertions(+), 2 deletions(-)

diff --git a/docs/releasenotes/10.3.0.rst b/docs/releasenotes/10.3.0.rst
index 36c5f5f5ff0..a73efcee418 100644
--- a/docs/releasenotes/10.3.0.rst
+++ b/docs/releasenotes/10.3.0.rst
@@ -108,5 +108,5 @@ the libwebp decoder.
 Type hints
 ^^^^^^^^^^
 
-Pillow now has type hints, and the package includes a ``py.typed`` file and the
-``Typing :: Typed`` Trove classifier.
+Pillow now has type hints for a large part of its modules, and the package
+includes a ``py.typed`` file and the ``Typing :: Typed`` Trove classifier.

From 9f5d6e0c3136ed71fca08f7574b26541f226b60b Mon Sep 17 00:00:00 2001
From: Hugo van Kemenade <1324225+hugovk@users.noreply.github.com>
Date: Sun, 31 Mar 2024 10:02:23 -0600
Subject: [PATCH 0442/1178] Fix type hint
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit

Co-authored-by: Ondrej Baranovič <ondreko.tiba@gmail.com>
---
 Tests/helper.py | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/Tests/helper.py b/Tests/helper.py
index aa6fa2ba12d..863bd87cfcb 100644
--- a/Tests/helper.py
+++ b/Tests/helper.py
@@ -266,7 +266,7 @@ def hopper(mode: str | None = None) -> Image.Image:
 
 
 @lru_cache(maxsize=None)
-def _cached_hopper(mode: str | None = None) -> Image.Image:
+def _cached_hopper(mode: str = None) -> Image.Image:
     if mode == "F":
         im = hopper("L").convert(mode)
     else:

From b6c755df3204f625cb9761edea98a59d604aa153 Mon Sep 17 00:00:00 2001
From: Hugo van Kemenade <1324225+hugovk@users.noreply.github.com>
Date: Sun, 31 Mar 2024 17:28:00 +0300
Subject: [PATCH 0443/1178] Add type hints
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit

Co-authored-by: Ondrej Baranovič <ondreko.tiba@gmail.com>
---
 src/PIL/Image.py | 100 +++++++++++++++++++++++++----------------------
 1 file changed, 54 insertions(+), 46 deletions(-)

diff --git a/src/PIL/Image.py b/src/PIL/Image.py
index 41981d77ce1..ccbfe2a6fd4 100644
--- a/src/PIL/Image.py
+++ b/src/PIL/Image.py
@@ -55,6 +55,7 @@
     _plugins,
 )
 from ._binary import i32le, o32be, o32le
+from ._typing import TypeGuard
 from ._util import DeferredError, is_path
 
 ElementTree: ModuleType | None
@@ -120,7 +121,7 @@ class DecompressionBombError(Exception):
     cffi = None
 
 
-def isImageType(t):
+def isImageType(t: Any) -> TypeGuard[Image]:
     """
     Checks if an object is an image object.
 
@@ -267,7 +268,7 @@ def getmodebase(mode: str) -> str:
     return ImageMode.getmode(mode).basemode
 
 
-def getmodetype(mode):
+def getmodetype(mode: str) -> str:
     """
     Gets the storage type mode.  Given a mode, this function returns a
     single-layer mode suitable for storing individual bands.
@@ -279,7 +280,7 @@ def getmodetype(mode):
     return ImageMode.getmode(mode).basetype
 
 
-def getmodebandnames(mode):
+def getmodebandnames(mode: str) -> tuple[str, ...]:
     """
     Gets a list of individual band names.  Given a mode, this function returns
     a tuple containing the names of individual bands (use
@@ -311,7 +312,7 @@ def getmodebands(mode: str) -> int:
 _initialized = 0
 
 
-def preinit():
+def preinit() -> None:
     """
     Explicitly loads BMP, GIF, JPEG, PPM and PPM file format drivers.
 
@@ -437,7 +438,7 @@ def _getencoder(mode, encoder_name, args, extra=()):
 
 
 class _E:
-    def __init__(self, scale, offset):
+    def __init__(self, scale, offset) -> None:
         self.scale = scale
         self.offset = offset
 
@@ -508,22 +509,22 @@ def __init__(self):
         self._exif = None
 
     @property
-    def width(self):
+    def width(self) -> int:
         return self.size[0]
 
     @property
-    def height(self):
+    def height(self) -> int:
         return self.size[1]
 
     @property
-    def size(self):
+    def size(self) -> tuple[int, int]:
         return self._size
 
     @property
     def mode(self):
         return self._mode
 
-    def _new(self, im):
+    def _new(self, im: Image) -> Image:
         new = Image()
         new.im = im
         new._mode = im.mode
@@ -556,7 +557,7 @@ def __exit__(self, *args):
                 self._close_fp()
             self.fp = None
 
-    def close(self):
+    def close(self) -> None:
         """
         Closes the file pointer, if possible.
 
@@ -589,7 +590,7 @@ def _copy(self) -> None:
         self.pyaccess = None
         self.readonly = 0
 
-    def _ensure_mutable(self):
+    def _ensure_mutable(self) -> None:
         if self.readonly:
             self._copy()
         else:
@@ -629,7 +630,7 @@ def __eq__(self, other):
             and self.tobytes() == other.tobytes()
         )
 
-    def __repr__(self):
+    def __repr__(self) -> str:
         return "<%s.%s image mode=%s size=%dx%d at 0x%X>" % (
             self.__class__.__module__,
             self.__class__.__name__,
@@ -639,7 +640,7 @@ def __repr__(self):
             id(self),
         )
 
-    def _repr_pretty_(self, p, cycle):
+    def _repr_pretty_(self, p, cycle) -> None:
         """IPython plain text display support"""
 
         # Same as __repr__ but without unpredictable id(self),
@@ -711,7 +712,7 @@ def __getstate__(self):
         im_data = self.tobytes()  # load image first
         return [self.info, self.mode, self.size, self.getpalette(), im_data]
 
-    def __setstate__(self, state):
+    def __setstate__(self, state) -> None:
         Image.__init__(self)
         info, mode, size, palette, data = state
         self.info = info
@@ -774,7 +775,7 @@ def tobytes(self, encoder_name: str = "raw", *args) -> bytes:
 
         return b"".join(output)
 
-    def tobitmap(self, name="image"):
+    def tobitmap(self, name: str = "image") -> bytes:
         """
         Returns the image converted to an X11 bitmap.
 
@@ -886,7 +887,12 @@ def verify(self):
         pass
 
     def convert(
-        self, mode=None, matrix=None, dither=None, palette=Palette.WEB, colors=256
+        self,
+        mode: str | None = None,
+        matrix: tuple[float, ...] | None = None,
+        dither: Dither | None = None,
+        palette: Palette = Palette.WEB,
+        colors: int = 256,
     ) -> Image:
         """
         Returns a converted copy of this image. For the "P" mode, this
@@ -1117,12 +1123,12 @@ def convert_transparency(m, v):
 
     def quantize(
         self,
-        colors=256,
-        method=None,
-        kmeans=0,
+        colors: int = 256,
+        method: Quantize | None = None,
+        kmeans: int = 0,
         palette=None,
-        dither=Dither.FLOYDSTEINBERG,
-    ):
+        dither: Dither = Dither.FLOYDSTEINBERG,
+    ) -> Image:
         """
         Convert the image to 'P' mode with the specified number
         of colors.
@@ -1210,7 +1216,7 @@ def copy(self) -> Image:
 
     __copy__ = copy
 
-    def crop(self, box=None) -> Image:
+    def crop(self, box: tuple[int, int, int, int] | None = None) -> Image:
         """
         Returns a rectangular region from this image. The box is a
         4-tuple defining the left, upper, right, and lower pixel
@@ -1341,7 +1347,7 @@ def getbbox(self, *, alpha_only: bool = True) -> tuple[int, int, int, int]:
         self.load()
         return self.im.getbbox(alpha_only)
 
-    def getcolors(self, maxcolors=256):
+    def getcolors(self, maxcolors: int = 256) -> list[tuple[int, int]] | None:
         """
         Returns a list of colors used in this image.
 
@@ -1364,7 +1370,7 @@ def getcolors(self, maxcolors=256):
             return out
         return self.im.getcolors(maxcolors)
 
-    def getdata(self, band=None):
+    def getdata(self, band: int | None = None) -> Image:
         """
         Returns the contents of this image as a sequence object
         containing pixel values.  The sequence object is flattened, so
@@ -1387,7 +1393,7 @@ def getdata(self, band=None):
             return self.im.getband(band)
         return self.im  # could be abused
 
-    def getextrema(self):
+    def getextrema(self) -> tuple[float, float] | tuple[tuple[float, float], ...]:
         """
         Gets the minimum and maximum pixel values for each band in
         the image.
@@ -1468,7 +1474,7 @@ def getexif(self) -> Exif:
 
         return self._exif
 
-    def _reload_exif(self):
+    def _reload_exif(self) -> None:
         if self._exif is None or not self._exif._loaded:
             return
         self._exif._loaded = False
@@ -1605,7 +1611,7 @@ def getpixel(self, xy):
             return self.pyaccess.getpixel(xy)
         return self.im.getpixel(tuple(xy))
 
-    def getprojection(self):
+    def getprojection(self) -> tuple[list[int], list[int]]:
         """
         Get projection to x and y axes
 
@@ -1617,7 +1623,7 @@ def getprojection(self):
         x, y = self.im.getprojection()
         return list(x), list(y)
 
-    def histogram(self, mask=None, extrema=None) -> list[int]:
+    def histogram(self, mask: Image | None = None, extrema=None) -> list[int]:
         """
         Returns a histogram for the image. The histogram is returned as a
         list of pixel counts, one for each pixel value in the source
@@ -2463,7 +2469,7 @@ def save(self, fp, format=None, **params) -> None:
         if open_fp:
             fp.close()
 
-    def seek(self, frame) -> None:
+    def seek(self, frame: int) -> None:
         """
         Seeks to the given frame in this sequence file. If you seek
         beyond the end of the sequence, the method raises an
@@ -2485,7 +2491,7 @@ def seek(self, frame) -> None:
             msg = "no more images in file"
             raise EOFError(msg)
 
-    def show(self, title=None):
+    def show(self, title: str | None = None) -> None:
         """
         Displays this image. This method is mainly intended for debugging purposes.
 
@@ -2526,7 +2532,7 @@ def split(self) -> tuple[Image, ...]:
             return (self.copy(),)
         return tuple(map(self._new, self.im.split()))
 
-    def getchannel(self, channel):
+    def getchannel(self, channel: int | str) -> Image:
         """
         Returns an image containing a single channel of the source image.
 
@@ -2601,13 +2607,13 @@ def thumbnail(self, size, resample=Resampling.BICUBIC, reducing_gap=2.0):
 
         provided_size = tuple(map(math.floor, size))
 
-        def preserve_aspect_ratio():
+        def preserve_aspect_ratio() -> tuple[int, int] | None:
             def round_aspect(number, key):
                 return max(min(math.floor(number), math.ceil(number), key=key), 1)
 
             x, y = provided_size
             if x >= self.width and y >= self.height:
-                return
+                return None
 
             aspect = self.width / self.height
             if x / y >= aspect:
@@ -2927,7 +2933,9 @@ def _check_size(size):
     return True
 
 
-def new(mode, size, color=0) -> Image:
+def new(
+    mode: str, size: tuple[int, int], color: float | tuple[float, ...] | str | None = 0
+) -> Image:
     """
     Creates a new image with the given mode and size.
 
@@ -3193,7 +3201,7 @@ def fromqpixmap(im):
 }
 
 
-def _decompression_bomb_check(size):
+def _decompression_bomb_check(size: tuple[int, int]) -> None:
     if MAX_IMAGE_PIXELS is None:
         return
 
@@ -3335,7 +3343,7 @@ def _open_core(fp, filename, prefix, formats):
 # Image processing.
 
 
-def alpha_composite(im1, im2):
+def alpha_composite(im1: Image, im2: Image) -> Image:
     """
     Alpha composite im2 over im1.
 
@@ -3350,7 +3358,7 @@ def alpha_composite(im1, im2):
     return im1._new(core.alpha_composite(im1.im, im2.im))
 
 
-def blend(im1, im2, alpha):
+def blend(im1: Image, im2: Image, alpha: float) -> Image:
     """
     Creates a new image by interpolating between two input images, using
     a constant alpha::
@@ -3373,7 +3381,7 @@ def blend(im1, im2, alpha):
     return im1._new(core.blend(im1.im, im2.im, alpha))
 
 
-def composite(image1, image2, mask):
+def composite(image1: Image, image2: Image, mask: Image) -> Image:
     """
     Create composite image by blending images using a transparency mask.
 
@@ -3483,7 +3491,7 @@ def register_save(id: str, driver) -> None:
     SAVE[id.upper()] = driver
 
 
-def register_save_all(id, driver):
+def register_save_all(id, driver) -> None:
     """
     Registers an image function to save all the frames
     of a multiframe format.  This function should not be
@@ -3557,7 +3565,7 @@ def register_encoder(name: str, encoder: type[ImageFile.PyEncoder]) -> None:
 # Simple display support.
 
 
-def _show(image, **options):
+def _show(image, **options) -> None:
     from . import ImageShow
 
     ImageShow.show(image, **options)
@@ -3613,7 +3621,7 @@ def radial_gradient(mode):
 # Resources
 
 
-def _apply_env_variables(env=None):
+def _apply_env_variables(env=None) -> None:
     if env is None:
         env = os.environ
 
@@ -3928,13 +3936,13 @@ def get_ifd(self, tag):
             }
         return ifd
 
-    def hide_offsets(self):
+    def hide_offsets(self) -> None:
         for tag in (ExifTags.IFD.Exif, ExifTags.IFD.GPSInfo):
             if tag in self:
                 self._hidden_data[tag] = self[tag]
                 del self[tag]
 
-    def __str__(self):
+    def __str__(self) -> str:
         if self._info is not None:
             # Load all keys into self._data
             for tag in self._info:
@@ -3942,7 +3950,7 @@ def __str__(self):
 
         return str(self._data)
 
-    def __len__(self):
+    def __len__(self) -> int:
         keys = set(self._data)
         if self._info is not None:
             keys.update(self._info)
@@ -3954,10 +3962,10 @@ def __getitem__(self, tag):
             del self._info[tag]
         return self._data[tag]
 
-    def __contains__(self, tag):
+    def __contains__(self, tag) -> bool:
         return tag in self._data or (self._info is not None and tag in self._info)
 
-    def __setitem__(self, tag, value):
+    def __setitem__(self, tag, value) -> None:
         if self._info is not None and tag in self._info:
             del self._info[tag]
         self._data[tag] = value

From d31148bb86ad33cfb5bd9952775d5aaede028c44 Mon Sep 17 00:00:00 2001
From: Andrew Murray <radarhere@users.noreply.github.com>
Date: Mon, 1 Apr 2024 13:51:55 +1100
Subject: [PATCH 0444/1178] Update CHANGES.rst [ci skip]

---
 CHANGES.rst | 12 ++++++++++++
 1 file changed, 12 insertions(+)

diff --git a/CHANGES.rst b/CHANGES.rst
index 9dae34a1f92..fd4a27d869b 100644
--- a/CHANGES.rst
+++ b/CHANGES.rst
@@ -5,6 +5,18 @@ Changelog (Pillow)
 10.3.0 (unreleased)
 -------------------
 
+- Add --report argument to __main__.py to omit supported formats #7818
+  [nulano, radarhere, hugovk]
+
+- Added RGB to I;16, I;16L, I;16B and I;16N conversion #7918, #7920
+  [radarhere]
+
+- Fix editable installation with custom build backend and configuration options #7658
+  [nulano, radarhere]
+
+- Fix putdata() for I;16N on big-endian #7209
+  [Yay295, hugovk, radarhere]
+
 - Determine MPO size from markers, not EXIF data #7884
   [radarhere]
 

From f69168523e531f27e034a828835990c6f9b73b19 Mon Sep 17 00:00:00 2001
From: Andrew Murray <radarhere@users.noreply.github.com>
Date: Mon, 1 Apr 2024 15:24:10 +1100
Subject: [PATCH 0445/1178] Do not calculate destination length each time

---
 src/PIL/BmpImagePlugin.py | 3 ++-
 src/PIL/DdsImagePlugin.py | 3 ++-
 src/PIL/PpmImagePlugin.py | 3 ++-
 src/PIL/QoiImagePlugin.py | 3 ++-
 4 files changed, 8 insertions(+), 4 deletions(-)

diff --git a/src/PIL/BmpImagePlugin.py b/src/PIL/BmpImagePlugin.py
index 6f730cfef16..9947f439b07 100644
--- a/src/PIL/BmpImagePlugin.py
+++ b/src/PIL/BmpImagePlugin.py
@@ -291,7 +291,8 @@ def decode(self, buffer):
         rle4 = self.args[1]
         data = bytearray()
         x = 0
-        while len(data) < self.state.xsize * self.state.ysize:
+        dest_length = self.state.xsize * self.state.ysize
+        while len(data) < dest_length:
             pixels = self.fd.read(1)
             byte = self.fd.read(1)
             if not pixels or not byte:
diff --git a/src/PIL/DdsImagePlugin.py b/src/PIL/DdsImagePlugin.py
index be17f4223aa..b89502d1fb6 100644
--- a/src/PIL/DdsImagePlugin.py
+++ b/src/PIL/DdsImagePlugin.py
@@ -497,7 +497,8 @@ def decode(self, buffer):
 
         data = bytearray()
         bytecount = bitcount // 8
-        while len(data) < self.state.xsize * self.state.ysize * len(masks):
+        dest_length = self.state.xsize * self.state.ysize * len(masks)
+        while len(data) < dest_length:
             value = int.from_bytes(self.fd.read(bytecount), "little")
             for i, mask in enumerate(masks):
                 masked_value = value & mask
diff --git a/src/PIL/PpmImagePlugin.py b/src/PIL/PpmImagePlugin.py
index bca3018c36f..94bf430b825 100644
--- a/src/PIL/PpmImagePlugin.py
+++ b/src/PIL/PpmImagePlugin.py
@@ -307,7 +307,8 @@ def decode(self, buffer: bytes) -> tuple[int, int]:
         out_byte_count = 4 if self.mode == "I" else 1
         out_max = 65535 if self.mode == "I" else 255
         bands = Image.getmodebands(self.mode)
-        while len(data) < self.state.xsize * self.state.ysize * bands * out_byte_count:
+        dest_length = self.state.xsize * self.state.ysize * bands * out_byte_count
+        while len(data) < dest_length:
             pixels = self.fd.read(in_byte_count * bands)
             if len(pixels) < in_byte_count * bands:
                 # eof
diff --git a/src/PIL/QoiImagePlugin.py b/src/PIL/QoiImagePlugin.py
index a7b9d4a9e3a..1a2a4d388c9 100644
--- a/src/PIL/QoiImagePlugin.py
+++ b/src/PIL/QoiImagePlugin.py
@@ -53,7 +53,8 @@ def decode(self, buffer):
 
         data = bytearray()
         bands = Image.getmodebands(self.mode)
-        while len(data) < self.state.xsize * self.state.ysize * bands:
+        dest_length = self.state.xsize * self.state.ysize * bands
+        while len(data) < dest_length:
             byte = self.fd.read(1)[0]
             if byte == 0b11111110:  # QOI_OP_RGB
                 value = self.fd.read(3) + self._previous_pixel[3:]

From badc92079d40ae74e3a343ababdaca442e43b2dd Mon Sep 17 00:00:00 2001
From: Andrew Murray <radarhere@users.noreply.github.com>
Date: Mon, 1 Apr 2024 15:24:40 +1100
Subject: [PATCH 0446/1178] Do not cast to bytes for set_as_raw()

---
 src/PIL/BlpImagePlugin.py | 4 ++--
 src/PIL/DdsImagePlugin.py | 2 +-
 src/PIL/QoiImagePlugin.py | 2 +-
 3 files changed, 4 insertions(+), 4 deletions(-)

diff --git a/src/PIL/BlpImagePlugin.py b/src/PIL/BlpImagePlugin.py
index f0fbc8cc28a..95e8077811d 100644
--- a/src/PIL/BlpImagePlugin.py
+++ b/src/PIL/BlpImagePlugin.py
@@ -341,7 +341,7 @@ def _load(self):
             if self._blp_encoding in (4, 5):
                 palette = self._read_palette()
                 data = self._read_bgra(palette)
-                self.set_as_raw(bytes(data))
+                self.set_as_raw(data)
             else:
                 msg = f"Unsupported BLP encoding {repr(self._blp_encoding)}"
                 raise BLPFormatError(msg)
@@ -412,7 +412,7 @@ def _load(self):
             msg = f"Unknown BLP compression {repr(self._blp_compression)}"
             raise BLPFormatError(msg)
 
-        self.set_as_raw(bytes(data))
+        self.set_as_raw(data)
 
 
 class BLPEncoder(ImageFile.PyEncoder):
diff --git a/src/PIL/DdsImagePlugin.py b/src/PIL/DdsImagePlugin.py
index b89502d1fb6..93c8e341d44 100644
--- a/src/PIL/DdsImagePlugin.py
+++ b/src/PIL/DdsImagePlugin.py
@@ -506,7 +506,7 @@ def decode(self, buffer):
                 data += o8(
                     int(((masked_value >> mask_offsets[i]) / mask_totals[i]) * 255)
                 )
-        self.set_as_raw(bytes(data))
+        self.set_as_raw(data)
         return -1, 0
 
 
diff --git a/src/PIL/QoiImagePlugin.py b/src/PIL/QoiImagePlugin.py
index 1a2a4d388c9..e9fef37a936 100644
--- a/src/PIL/QoiImagePlugin.py
+++ b/src/PIL/QoiImagePlugin.py
@@ -98,7 +98,7 @@ def decode(self, buffer):
             if bands == 3:
                 value = value[:3]
             data += value
-        self.set_as_raw(bytes(data))
+        self.set_as_raw(data)
         return -1, 0
 
 

From b7d0908dc5a175ecc097c152199ee62695fb9efe Mon Sep 17 00:00:00 2001
From: Andrew Murray <radarhere@users.noreply.github.com>
Date: Mon, 1 Apr 2024 15:31:44 +1100
Subject: [PATCH 0447/1178] Increase use of bytearrays to improve loading speed

---
 src/PIL/QoiImagePlugin.py | 36 ++++++++++++++++++++----------------
 1 file changed, 20 insertions(+), 16 deletions(-)

diff --git a/src/PIL/QoiImagePlugin.py b/src/PIL/QoiImagePlugin.py
index e9fef37a936..f8aa720c134 100644
--- a/src/PIL/QoiImagePlugin.py
+++ b/src/PIL/QoiImagePlugin.py
@@ -11,7 +11,6 @@
 
 from . import Image, ImageFile
 from ._binary import i32be as i32
-from ._binary import o8
 
 
 def _accept(prefix):
@@ -49,7 +48,7 @@ def _add_to_previous_pixels(self, value):
     def decode(self, buffer):
         self._previously_seen_pixels = {}
         self._previous_pixel = None
-        self._add_to_previous_pixels(b"".join(o8(i) for i in (0, 0, 0, 255)))
+        self._add_to_previous_pixels(bytearray((0, 0, 0, 255)))
 
         data = bytearray()
         bands = Image.getmodebands(self.mode)
@@ -57,34 +56,40 @@ def decode(self, buffer):
         while len(data) < dest_length:
             byte = self.fd.read(1)[0]
             if byte == 0b11111110:  # QOI_OP_RGB
-                value = self.fd.read(3) + self._previous_pixel[3:]
+                value = bytearray(self.fd.read(3)) + self._previous_pixel[3:]
             elif byte == 0b11111111:  # QOI_OP_RGBA
                 value = self.fd.read(4)
             else:
                 op = byte >> 6
                 if op == 0:  # QOI_OP_INDEX
                     op_index = byte & 0b00111111
-                    value = self._previously_seen_pixels.get(op_index, (0, 0, 0, 0))
+                    value = self._previously_seen_pixels.get(
+                        op_index, bytearray((0, 0, 0, 0))
+                    )
                 elif op == 1:  # QOI_OP_DIFF
-                    value = (
-                        (self._previous_pixel[0] + ((byte & 0b00110000) >> 4) - 2)
-                        % 256,
-                        (self._previous_pixel[1] + ((byte & 0b00001100) >> 2) - 2)
-                        % 256,
-                        (self._previous_pixel[2] + (byte & 0b00000011) - 2) % 256,
+                    value = bytearray(
+                        (
+                            (self._previous_pixel[0] + ((byte & 0b00110000) >> 4) - 2)
+                            % 256,
+                            (self._previous_pixel[1] + ((byte & 0b00001100) >> 2) - 2)
+                            % 256,
+                            (self._previous_pixel[2] + (byte & 0b00000011) - 2) % 256,
+                            self._previous_pixel[3],
+                        )
                     )
-                    value += (self._previous_pixel[3],)
                 elif op == 2:  # QOI_OP_LUMA
                     second_byte = self.fd.read(1)[0]
                     diff_green = (byte & 0b00111111) - 32
                     diff_red = ((second_byte & 0b11110000) >> 4) - 8
                     diff_blue = (second_byte & 0b00001111) - 8
 
-                    value = tuple(
-                        (self._previous_pixel[i] + diff_green + diff) % 256
-                        for i, diff in enumerate((diff_red, 0, diff_blue))
+                    value = bytearray(
+                        tuple(
+                            (self._previous_pixel[i] + diff_green + diff) % 256
+                            for i, diff in enumerate((diff_red, 0, diff_blue))
+                        )
                     )
-                    value += (self._previous_pixel[3],)
+                    value += self._previous_pixel[3:]
                 elif op == 3:  # QOI_OP_RUN
                     run_length = (byte & 0b00111111) + 1
                     value = self._previous_pixel
@@ -92,7 +97,6 @@ def decode(self, buffer):
                         value = value[:3]
                     data += value * run_length
                     continue
-                value = b"".join(o8(i) for i in value)
             self._add_to_previous_pixels(value)
 
             if bands == 3:

From 512ee3ff9b25cdc74ab7ab3dc6ff96f65c160aca Mon Sep 17 00:00:00 2001
From: Hugo van Kemenade <1324225+hugovk@users.noreply.github.com>
Date: Sun, 31 Mar 2024 23:13:30 -0600
Subject: [PATCH 0448/1178] Simplify code and update comments

Co-authored-by: Andrew Murray <3112309+radarhere@users.noreply.github.com>
---
 Tests/helper.py | 14 +++++++-------
 1 file changed, 7 insertions(+), 7 deletions(-)

diff --git a/Tests/helper.py b/Tests/helper.py
index 863bd87cfcb..5d477144d2f 100644
--- a/Tests/helper.py
+++ b/Tests/helper.py
@@ -258,20 +258,20 @@ def hopper(mode: str | None = None) -> Image.Image:
 
     if mode is None:
         # Always return fresh not-yet-loaded version of image.
-        # Operations on not-yet-loaded images is separate class of errors
-        # what we should catch.
+        # Operations on not-yet-loaded images are a separate class of errors
+        # that we should catch.
         return Image.open("Tests/images/hopper.ppm")
 
     return _cached_hopper(mode).copy()
 
 
-@lru_cache(maxsize=None)
-def _cached_hopper(mode: str = None) -> Image.Image:
+@lru_cache
+def _cached_hopper(mode: str) -> Image.Image:
     if mode == "F":
-        im = hopper("L").convert(mode)
+        im = hopper("L")
     else:
-        im = hopper().convert(mode)
-    return im
+        im = hopper()
+    return im.convert(mode)
 
 
 def djpeg_available() -> bool:

From 008b28eb0caffb8a54fd043686cae996f0a842b6 Mon Sep 17 00:00:00 2001
From: Hugo van Kemenade <1324225+hugovk@users.noreply.github.com>
Date: Sun, 31 Mar 2024 23:20:11 -0600
Subject: [PATCH 0449/1178] Add type hints

Co-authored-by: Andrew Murray <3112309+radarhere@users.noreply.github.com>
---
 src/PIL/Image.py | 10 ++++++----
 1 file changed, 6 insertions(+), 4 deletions(-)

diff --git a/src/PIL/Image.py b/src/PIL/Image.py
index ccbfe2a6fd4..b92c0bb43b8 100644
--- a/src/PIL/Image.py
+++ b/src/PIL/Image.py
@@ -524,7 +524,7 @@ def size(self) -> tuple[int, int]:
     def mode(self):
         return self._mode
 
-    def _new(self, im: Image) -> Image:
+    def _new(self, im: Image):
         new = Image()
         new.im = im
         new._mode = im.mode
@@ -1347,7 +1347,9 @@ def getbbox(self, *, alpha_only: bool = True) -> tuple[int, int, int, int]:
         self.load()
         return self.im.getbbox(alpha_only)
 
-    def getcolors(self, maxcolors: int = 256) -> list[tuple[int, int]] | None:
+    def getcolors(
+        self, maxcolors: int = 256
+    ) -> list[tuple[int, int | tuple[int, ...]]] | None:
         """
         Returns a list of colors used in this image.
 
@@ -1370,7 +1372,7 @@ def getcolors(self, maxcolors: int = 256) -> list[tuple[int, int]] | None:
             return out
         return self.im.getcolors(maxcolors)
 
-    def getdata(self, band: int | None = None) -> Image:
+    def getdata(self, band: int | None = None):
         """
         Returns the contents of this image as a sequence object
         containing pixel values.  The sequence object is flattened, so
@@ -1393,7 +1395,7 @@ def getdata(self, band: int | None = None) -> Image:
             return self.im.getband(band)
         return self.im  # could be abused
 
-    def getextrema(self) -> tuple[float, float] | tuple[tuple[float, float], ...]:
+    def getextrema(self) -> tuple[float, float] | tuple[tuple[int, int], ...]:
         """
         Gets the minimum and maximum pixel values for each band in
         the image.

From 7c5d0b9284144e785ee17cb9395063747d4ab180 Mon Sep 17 00:00:00 2001
From: Hugo van Kemenade <1324225+hugovk@users.noreply.github.com>
Date: Sun, 31 Mar 2024 23:44:27 -0600
Subject: [PATCH 0450/1178] Add type hints

Co-authored-by: Andrew Murray <3112309+radarhere@users.noreply.github.com>
---
 src/PIL/Image.py | 6 ++----
 1 file changed, 2 insertions(+), 4 deletions(-)

diff --git a/src/PIL/Image.py b/src/PIL/Image.py
index b92c0bb43b8..baef0aa112e 100644
--- a/src/PIL/Image.py
+++ b/src/PIL/Image.py
@@ -524,7 +524,7 @@ def size(self) -> tuple[int, int]:
     def mode(self):
         return self._mode
 
-    def _new(self, im: Image):
+    def _new(self, im) -> Image:
         new = Image()
         new.im = im
         new._mode = im.mode
@@ -1347,9 +1347,7 @@ def getbbox(self, *, alpha_only: bool = True) -> tuple[int, int, int, int]:
         self.load()
         return self.im.getbbox(alpha_only)
 
-    def getcolors(
-        self, maxcolors: int = 256
-    ) -> list[tuple[int, int | tuple[int, ...]]] | None:
+    def getcolors(self, maxcolors: int = 256):
         """
         Returns a list of colors used in this image.
 

From 27b10c4bd8956e8e6a5486bafe8433791dfcc2c4 Mon Sep 17 00:00:00 2001
From: Andrew Murray <radarhere@users.noreply.github.com>
Date: Mon, 25 Mar 2024 20:38:52 +1100
Subject: [PATCH 0451/1178] Deprecate eval(), replacing it with lambda_eval()
 and unsafe_eval()

---
 Tests/helper.py                     |   4 +-
 Tests/test_image_reduce.py          |   4 +-
 Tests/test_imagemath.py             | 214 ------------
 Tests/test_imagemath_lambda_eval.py | 498 ++++++++++++++++++++++++++++
 Tests/test_imagemath_unsafe_eval.py | 221 ++++++++++++
 docs/reference/ImageMath.rst        |  62 +++-
 docs/releasenotes/10.2.0.rst        |   2 +-
 docs/releasenotes/9.0.0.rst         |   2 +-
 docs/releasenotes/9.0.1.rst         |   2 +-
 src/PIL/GifImagePlugin.py           |  18 +-
 src/PIL/ImageMath.py                |  82 ++++-
 11 files changed, 869 insertions(+), 240 deletions(-)
 delete mode 100644 Tests/test_imagemath.py
 create mode 100644 Tests/test_imagemath_lambda_eval.py
 create mode 100644 Tests/test_imagemath_unsafe_eval.py

diff --git a/Tests/helper.py b/Tests/helper.py
index 5d477144d2f..c1399e89bf8 100644
--- a/Tests/helper.py
+++ b/Tests/helper.py
@@ -115,7 +115,9 @@ def assert_image_similar(
 
     diff = 0
     for ach, bch in zip(a.split(), b.split()):
-        chdiff = ImageMath.eval("abs(a - b)", a=ach, b=bch).convert("L")
+        chdiff = ImageMath.lambda_eval(
+            lambda args: abs(args["a"] - args["b"]), a=ach, b=bch
+        ).convert("L")
         diff += sum(i * num for i, num in enumerate(chdiff.histogram()))
 
     ave_diff = diff / (a.size[0] * a.size[1])
diff --git a/Tests/test_image_reduce.py b/Tests/test_image_reduce.py
index 33b33d6b7fc..fcf671daace 100644
--- a/Tests/test_image_reduce.py
+++ b/Tests/test_image_reduce.py
@@ -186,7 +186,9 @@ def assert_compare_images(
 
     bands = ImageMode.getmode(a.mode).bands
     for band, ach, bch in zip(bands, a.split(), b.split()):
-        ch_diff = ImageMath.eval("convert(abs(a - b), 'L')", a=ach, b=bch)
+        ch_diff = ImageMath.lambda_eval(
+            lambda args: args["convert"](abs(args["a"] - args["b"]), "L"), a=ach, b=bch
+        )
         ch_hist = ch_diff.histogram()
 
         average_diff = sum(i * num for i, num in enumerate(ch_hist)) / (
diff --git a/Tests/test_imagemath.py b/Tests/test_imagemath.py
deleted file mode 100644
index a21e2307d5f..00000000000
--- a/Tests/test_imagemath.py
+++ /dev/null
@@ -1,214 +0,0 @@
-from __future__ import annotations
-
-import pytest
-
-from PIL import Image, ImageMath
-
-
-def pixel(im: Image.Image | int) -> str | int:
-    if isinstance(im, int):
-        return int(im)  # hack to deal with booleans
-
-    return f"{im.mode} {repr(im.getpixel((0, 0)))}"
-
-
-A = Image.new("L", (1, 1), 1)
-B = Image.new("L", (1, 1), 2)
-Z = Image.new("L", (1, 1), 0)  # Z for zero
-F = Image.new("F", (1, 1), 3)
-I = Image.new("I", (1, 1), 4)  # noqa: E741
-
-A2 = A.resize((2, 2))
-B2 = B.resize((2, 2))
-
-images = {"A": A, "B": B, "F": F, "I": I}
-
-
-def test_sanity() -> None:
-    assert ImageMath.eval("1") == 1
-    assert ImageMath.eval("1+A", A=2) == 3
-    assert pixel(ImageMath.eval("A+B", A=A, B=B)) == "I 3"
-    assert pixel(ImageMath.eval("A+B", images)) == "I 3"
-    assert pixel(ImageMath.eval("float(A)+B", images)) == "F 3.0"
-    assert pixel(ImageMath.eval("int(float(A)+B)", images)) == "I 3"
-
-
-def test_ops() -> None:
-    assert pixel(ImageMath.eval("-A", images)) == "I -1"
-    assert pixel(ImageMath.eval("+B", images)) == "L 2"
-
-    assert pixel(ImageMath.eval("A+B", images)) == "I 3"
-    assert pixel(ImageMath.eval("A-B", images)) == "I -1"
-    assert pixel(ImageMath.eval("A*B", images)) == "I 2"
-    assert pixel(ImageMath.eval("A/B", images)) == "I 0"
-    assert pixel(ImageMath.eval("B**2", images)) == "I 4"
-    assert pixel(ImageMath.eval("B**33", images)) == "I 2147483647"
-
-    assert pixel(ImageMath.eval("float(A)+B", images)) == "F 3.0"
-    assert pixel(ImageMath.eval("float(A)-B", images)) == "F -1.0"
-    assert pixel(ImageMath.eval("float(A)*B", images)) == "F 2.0"
-    assert pixel(ImageMath.eval("float(A)/B", images)) == "F 0.5"
-    assert pixel(ImageMath.eval("float(B)**2", images)) == "F 4.0"
-    assert pixel(ImageMath.eval("float(B)**33", images)) == "F 8589934592.0"
-
-
-@pytest.mark.parametrize(
-    "expression",
-    (
-        "exec('pass')",
-        "(lambda: exec('pass'))()",
-        "(lambda: (lambda: exec('pass'))())()",
-    ),
-)
-def test_prevent_exec(expression: str) -> None:
-    with pytest.raises(ValueError):
-        ImageMath.eval(expression)
-
-
-def test_prevent_double_underscores() -> None:
-    with pytest.raises(ValueError):
-        ImageMath.eval("1", {"__": None})
-
-
-def test_prevent_builtins() -> None:
-    with pytest.raises(ValueError):
-        ImageMath.eval("(lambda: exec('exit()'))()", {"exec": None})
-
-
-def test_logical() -> None:
-    assert pixel(ImageMath.eval("not A", images)) == 0
-    assert pixel(ImageMath.eval("A and B", images)) == "L 2"
-    assert pixel(ImageMath.eval("A or B", images)) == "L 1"
-
-
-def test_convert() -> None:
-    assert pixel(ImageMath.eval("convert(A+B, 'L')", images)) == "L 3"
-    assert pixel(ImageMath.eval("convert(A+B, '1')", images)) == "1 0"
-    assert pixel(ImageMath.eval("convert(A+B, 'RGB')", images)) == "RGB (3, 3, 3)"
-
-
-def test_compare() -> None:
-    assert pixel(ImageMath.eval("min(A, B)", images)) == "I 1"
-    assert pixel(ImageMath.eval("max(A, B)", images)) == "I 2"
-    assert pixel(ImageMath.eval("A == 1", images)) == "I 1"
-    assert pixel(ImageMath.eval("A == 2", images)) == "I 0"
-
-
-def test_one_image_larger() -> None:
-    assert pixel(ImageMath.eval("A+B", A=A2, B=B)) == "I 3"
-    assert pixel(ImageMath.eval("A+B", A=A, B=B2)) == "I 3"
-
-
-def test_abs() -> None:
-    assert pixel(ImageMath.eval("abs(A)", A=A)) == "I 1"
-    assert pixel(ImageMath.eval("abs(B)", B=B)) == "I 2"
-
-
-def test_binary_mod() -> None:
-    assert pixel(ImageMath.eval("A%A", A=A)) == "I 0"
-    assert pixel(ImageMath.eval("B%B", B=B)) == "I 0"
-    assert pixel(ImageMath.eval("A%B", A=A, B=B)) == "I 1"
-    assert pixel(ImageMath.eval("B%A", A=A, B=B)) == "I 0"
-    assert pixel(ImageMath.eval("Z%A", A=A, Z=Z)) == "I 0"
-    assert pixel(ImageMath.eval("Z%B", B=B, Z=Z)) == "I 0"
-
-
-def test_bitwise_invert() -> None:
-    assert pixel(ImageMath.eval("~Z", Z=Z)) == "I -1"
-    assert pixel(ImageMath.eval("~A", A=A)) == "I -2"
-    assert pixel(ImageMath.eval("~B", B=B)) == "I -3"
-
-
-def test_bitwise_and() -> None:
-    assert pixel(ImageMath.eval("Z&Z", A=A, Z=Z)) == "I 0"
-    assert pixel(ImageMath.eval("Z&A", A=A, Z=Z)) == "I 0"
-    assert pixel(ImageMath.eval("A&Z", A=A, Z=Z)) == "I 0"
-    assert pixel(ImageMath.eval("A&A", A=A, Z=Z)) == "I 1"
-
-
-def test_bitwise_or() -> None:
-    assert pixel(ImageMath.eval("Z|Z", A=A, Z=Z)) == "I 0"
-    assert pixel(ImageMath.eval("Z|A", A=A, Z=Z)) == "I 1"
-    assert pixel(ImageMath.eval("A|Z", A=A, Z=Z)) == "I 1"
-    assert pixel(ImageMath.eval("A|A", A=A, Z=Z)) == "I 1"
-
-
-def test_bitwise_xor() -> None:
-    assert pixel(ImageMath.eval("Z^Z", A=A, Z=Z)) == "I 0"
-    assert pixel(ImageMath.eval("Z^A", A=A, Z=Z)) == "I 1"
-    assert pixel(ImageMath.eval("A^Z", A=A, Z=Z)) == "I 1"
-    assert pixel(ImageMath.eval("A^A", A=A, Z=Z)) == "I 0"
-
-
-def test_bitwise_leftshift() -> None:
-    assert pixel(ImageMath.eval("Z<<0", Z=Z)) == "I 0"
-    assert pixel(ImageMath.eval("Z<<1", Z=Z)) == "I 0"
-    assert pixel(ImageMath.eval("A<<0", A=A)) == "I 1"
-    assert pixel(ImageMath.eval("A<<1", A=A)) == "I 2"
-
-
-def test_bitwise_rightshift() -> None:
-    assert pixel(ImageMath.eval("Z>>0", Z=Z)) == "I 0"
-    assert pixel(ImageMath.eval("Z>>1", Z=Z)) == "I 0"
-    assert pixel(ImageMath.eval("A>>0", A=A)) == "I 1"
-    assert pixel(ImageMath.eval("A>>1", A=A)) == "I 0"
-
-
-def test_logical_eq() -> None:
-    assert pixel(ImageMath.eval("A==A", A=A)) == "I 1"
-    assert pixel(ImageMath.eval("B==B", B=B)) == "I 1"
-    assert pixel(ImageMath.eval("A==B", A=A, B=B)) == "I 0"
-    assert pixel(ImageMath.eval("B==A", A=A, B=B)) == "I 0"
-
-
-def test_logical_ne() -> None:
-    assert pixel(ImageMath.eval("A!=A", A=A)) == "I 0"
-    assert pixel(ImageMath.eval("B!=B", B=B)) == "I 0"
-    assert pixel(ImageMath.eval("A!=B", A=A, B=B)) == "I 1"
-    assert pixel(ImageMath.eval("B!=A", A=A, B=B)) == "I 1"
-
-
-def test_logical_lt() -> None:
-    assert pixel(ImageMath.eval("A<A", A=A)) == "I 0"
-    assert pixel(ImageMath.eval("B<B", B=B)) == "I 0"
-    assert pixel(ImageMath.eval("A<B", A=A, B=B)) == "I 1"
-    assert pixel(ImageMath.eval("B<A", A=A, B=B)) == "I 0"
-
-
-def test_logical_le() -> None:
-    assert pixel(ImageMath.eval("A<=A", A=A)) == "I 1"
-    assert pixel(ImageMath.eval("B<=B", B=B)) == "I 1"
-    assert pixel(ImageMath.eval("A<=B", A=A, B=B)) == "I 1"
-    assert pixel(ImageMath.eval("B<=A", A=A, B=B)) == "I 0"
-
-
-def test_logical_gt() -> None:
-    assert pixel(ImageMath.eval("A>A", A=A)) == "I 0"
-    assert pixel(ImageMath.eval("B>B", B=B)) == "I 0"
-    assert pixel(ImageMath.eval("A>B", A=A, B=B)) == "I 0"
-    assert pixel(ImageMath.eval("B>A", A=A, B=B)) == "I 1"
-
-
-def test_logical_ge() -> None:
-    assert pixel(ImageMath.eval("A>=A", A=A)) == "I 1"
-    assert pixel(ImageMath.eval("B>=B", B=B)) == "I 1"
-    assert pixel(ImageMath.eval("A>=B", A=A, B=B)) == "I 0"
-    assert pixel(ImageMath.eval("B>=A", A=A, B=B)) == "I 1"
-
-
-def test_logical_equal() -> None:
-    assert pixel(ImageMath.eval("equal(A, A)", A=A)) == "I 1"
-    assert pixel(ImageMath.eval("equal(B, B)", B=B)) == "I 1"
-    assert pixel(ImageMath.eval("equal(Z, Z)", Z=Z)) == "I 1"
-    assert pixel(ImageMath.eval("equal(A, B)", A=A, B=B)) == "I 0"
-    assert pixel(ImageMath.eval("equal(B, A)", A=A, B=B)) == "I 0"
-    assert pixel(ImageMath.eval("equal(A, Z)", A=A, Z=Z)) == "I 0"
-
-
-def test_logical_not_equal() -> None:
-    assert pixel(ImageMath.eval("notequal(A, A)", A=A)) == "I 0"
-    assert pixel(ImageMath.eval("notequal(B, B)", B=B)) == "I 0"
-    assert pixel(ImageMath.eval("notequal(Z, Z)", Z=Z)) == "I 0"
-    assert pixel(ImageMath.eval("notequal(A, B)", A=A, B=B)) == "I 1"
-    assert pixel(ImageMath.eval("notequal(B, A)", A=A, B=B)) == "I 1"
-    assert pixel(ImageMath.eval("notequal(A, Z)", A=A, Z=Z)) == "I 1"
diff --git a/Tests/test_imagemath_lambda_eval.py b/Tests/test_imagemath_lambda_eval.py
new file mode 100644
index 00000000000..3915e64aae1
--- /dev/null
+++ b/Tests/test_imagemath_lambda_eval.py
@@ -0,0 +1,498 @@
+from __future__ import annotations
+
+import pytest
+
+from PIL import Image, ImageMath
+
+
+def pixel(im: Image.Image | int) -> str | int:
+    if isinstance(im, int):
+        return int(im)  # hack to deal with booleans
+
+    return f"{im.mode} {repr(im.getpixel((0, 0)))}"
+
+
+A = Image.new("L", (1, 1), 1)
+B = Image.new("L", (1, 1), 2)
+Z = Image.new("L", (1, 1), 0)  # Z for zero
+F = Image.new("F", (1, 1), 3)
+I = Image.new("I", (1, 1), 4)  # noqa: E741
+
+A2 = A.resize((2, 2))
+B2 = B.resize((2, 2))
+
+images = {"A": A, "B": B, "F": F, "I": I}
+
+
+def test_sanity() -> None:
+    assert ImageMath.lambda_eval(lambda args: 1) == 1
+    assert ImageMath.lambda_eval(lambda args: 1 + args["A"], A=2) == 3
+    assert (
+        pixel(ImageMath.lambda_eval(lambda args: args["A"] + args["B"], A=A, B=B))
+        == "I 3"
+    )
+    assert (
+        pixel(ImageMath.lambda_eval(lambda args: args["A"] + args["B"], images))
+        == "I 3"
+    )
+    assert (
+        pixel(
+            ImageMath.lambda_eval(
+                lambda args: args["float"](args["A"]) + args["B"], images
+            )
+        )
+        == "F 3.0"
+    )
+    assert (
+        pixel(
+            ImageMath.lambda_eval(
+                lambda args: args["int"](args["float"](args["A"]) + args["B"]), images
+            )
+        )
+        == "I 3"
+    )
+
+
+def test_ops() -> None:
+    assert pixel(ImageMath.lambda_eval(lambda args: args["A"] * -1, images)) == "I -1"
+
+    assert (
+        pixel(ImageMath.lambda_eval(lambda args: args["A"] + args["B"], images))
+        == "I 3"
+    )
+    assert (
+        pixel(ImageMath.lambda_eval(lambda args: args["A"] - args["B"], images))
+        == "I -1"
+    )
+    assert (
+        pixel(ImageMath.lambda_eval(lambda args: args["A"] * args["B"], images))
+        == "I 2"
+    )
+    assert (
+        pixel(ImageMath.lambda_eval(lambda args: args["A"] / args["B"], images))
+        == "I 0"
+    )
+    assert pixel(ImageMath.lambda_eval(lambda args: args["B"] ** 2, images)) == "I 4"
+    assert (
+        pixel(ImageMath.lambda_eval(lambda args: args["B"] ** 33, images))
+        == "I 2147483647"
+    )
+
+    assert (
+        pixel(
+            ImageMath.lambda_eval(
+                lambda args: args["float"](args["A"]) + args["B"], images
+            )
+        )
+        == "F 3.0"
+    )
+    assert (
+        pixel(
+            ImageMath.lambda_eval(
+                lambda args: args["float"](args["A"]) - args["B"], images
+            )
+        )
+        == "F -1.0"
+    )
+    assert (
+        pixel(
+            ImageMath.lambda_eval(
+                lambda args: args["float"](args["A"]) * args["B"], images
+            )
+        )
+        == "F 2.0"
+    )
+    assert (
+        pixel(
+            ImageMath.lambda_eval(
+                lambda args: args["float"](args["A"]) / args["B"], images
+            )
+        )
+        == "F 0.5"
+    )
+    assert (
+        pixel(ImageMath.lambda_eval(lambda args: args["float"](args["B"]) ** 2, images))
+        == "F 4.0"
+    )
+    assert (
+        pixel(
+            ImageMath.lambda_eval(lambda args: args["float"](args["B"]) ** 33, images)
+        )
+        == "F 8589934592.0"
+    )
+
+
+def test_logical() -> None:
+    assert pixel(ImageMath.lambda_eval(lambda args: not args["A"], images)) == 0
+    assert (
+        pixel(ImageMath.lambda_eval(lambda args: args["A"] and args["B"], images))
+        == "L 2"
+    )
+    assert (
+        pixel(ImageMath.lambda_eval(lambda args: args["A"] or args["B"], images))
+        == "L 1"
+    )
+
+
+def test_convert() -> None:
+    assert (
+        pixel(
+            ImageMath.lambda_eval(
+                lambda args: args["convert"](args["A"] + args["B"], "L"), images
+            )
+        )
+        == "L 3"
+    )
+    assert (
+        pixel(
+            ImageMath.lambda_eval(
+                lambda args: args["convert"](args["A"] + args["B"], "1"), images
+            )
+        )
+        == "1 0"
+    )
+    assert (
+        pixel(
+            ImageMath.lambda_eval(
+                lambda args: args["convert"](args["A"] + args["B"], "RGB"), images
+            )
+        )
+        == "RGB (3, 3, 3)"
+    )
+
+
+def test_compare() -> None:
+    assert (
+        pixel(
+            ImageMath.lambda_eval(
+                lambda args: args["min"](args["A"], args["B"]), images
+            )
+        )
+        == "I 1"
+    )
+    assert (
+        pixel(
+            ImageMath.lambda_eval(
+                lambda args: args["max"](args["A"], args["B"]), images
+            )
+        )
+        == "I 2"
+    )
+    assert pixel(ImageMath.lambda_eval(lambda args: args["A"] == 1, images)) == "I 1"
+    assert pixel(ImageMath.lambda_eval(lambda args: args["A"] == 2, images)) == "I 0"
+
+
+def test_one_image_larger() -> None:
+    assert (
+        pixel(ImageMath.lambda_eval(lambda args: args["A"] + args["B"], A=A2, B=B))
+        == "I 3"
+    )
+    assert (
+        pixel(ImageMath.lambda_eval(lambda args: args["A"] + args["B"], A=A, B=B2))
+        == "I 3"
+    )
+
+
+def test_abs() -> None:
+    assert pixel(ImageMath.lambda_eval(lambda args: abs(args["A"]), A=A)) == "I 1"
+    assert pixel(ImageMath.lambda_eval(lambda args: abs(args["B"]), B=B)) == "I 2"
+
+
+def test_binary_mod() -> None:
+    assert (
+        pixel(ImageMath.lambda_eval(lambda args: args["A"] % args["A"], A=A)) == "I 0"
+    )
+    assert (
+        pixel(ImageMath.lambda_eval(lambda args: args["B"] % args["B"], B=B)) == "I 0"
+    )
+    assert (
+        pixel(ImageMath.lambda_eval(lambda args: args["A"] % args["B"], A=A, B=B))
+        == "I 1"
+    )
+    assert (
+        pixel(ImageMath.lambda_eval(lambda args: args["B"] % args["A"], A=A, B=B))
+        == "I 0"
+    )
+    assert (
+        pixel(ImageMath.lambda_eval(lambda args: args["Z"] % args["A"], A=A, Z=Z))
+        == "I 0"
+    )
+    assert (
+        pixel(ImageMath.lambda_eval(lambda args: args["Z"] % args["B"], B=B, Z=Z))
+        == "I 0"
+    )
+
+
+def test_bitwise_invert() -> None:
+    assert pixel(ImageMath.lambda_eval(lambda args: ~args["Z"], Z=Z)) == "I -1"
+    assert pixel(ImageMath.lambda_eval(lambda args: ~args["A"], A=A)) == "I -2"
+    assert pixel(ImageMath.lambda_eval(lambda args: ~args["B"], B=B)) == "I -3"
+
+
+def test_bitwise_and() -> None:
+    assert (
+        pixel(ImageMath.lambda_eval(lambda args: args["Z"] & args["Z"], A=A, Z=Z))
+        == "I 0"
+    )
+    assert (
+        pixel(ImageMath.lambda_eval(lambda args: args["Z"] & args["A"], A=A, Z=Z))
+        == "I 0"
+    )
+    assert (
+        pixel(ImageMath.lambda_eval(lambda args: args["A"] & args["Z"], A=A, Z=Z))
+        == "I 0"
+    )
+    assert (
+        pixel(ImageMath.lambda_eval(lambda args: args["A"] & args["A"], A=A, Z=Z))
+        == "I 1"
+    )
+
+
+def test_bitwise_or() -> None:
+    assert (
+        pixel(ImageMath.lambda_eval(lambda args: args["Z"] | args["Z"], A=A, Z=Z))
+        == "I 0"
+    )
+    assert (
+        pixel(ImageMath.lambda_eval(lambda args: args["Z"] | args["A"], A=A, Z=Z))
+        == "I 1"
+    )
+    assert (
+        pixel(ImageMath.lambda_eval(lambda args: args["A"] | args["Z"], A=A, Z=Z))
+        == "I 1"
+    )
+    assert (
+        pixel(ImageMath.lambda_eval(lambda args: args["A"] | args["A"], A=A, Z=Z))
+        == "I 1"
+    )
+
+
+def test_bitwise_xor() -> None:
+    assert (
+        pixel(ImageMath.lambda_eval(lambda args: args["Z"] ^ args["Z"], A=A, Z=Z))
+        == "I 0"
+    )
+    assert (
+        pixel(ImageMath.lambda_eval(lambda args: args["Z"] ^ args["A"], A=A, Z=Z))
+        == "I 1"
+    )
+    assert (
+        pixel(ImageMath.lambda_eval(lambda args: args["A"] ^ args["Z"], A=A, Z=Z))
+        == "I 1"
+    )
+    assert (
+        pixel(ImageMath.lambda_eval(lambda args: args["A"] ^ args["A"], A=A, Z=Z))
+        == "I 0"
+    )
+
+
+def test_bitwise_leftshift() -> None:
+    assert pixel(ImageMath.lambda_eval(lambda args: args["Z"] << 0, Z=Z)) == "I 0"
+    assert pixel(ImageMath.lambda_eval(lambda args: args["Z"] << 1, Z=Z)) == "I 0"
+    assert pixel(ImageMath.lambda_eval(lambda args: args["A"] << 0, A=A)) == "I 1"
+    assert pixel(ImageMath.lambda_eval(lambda args: args["A"] << 1, A=A)) == "I 2"
+
+
+def test_bitwise_rightshift() -> None:
+    assert pixel(ImageMath.lambda_eval(lambda args: args["Z"] >> 0, Z=Z)) == "I 0"
+    assert pixel(ImageMath.lambda_eval(lambda args: args["Z"] >> 1, Z=Z)) == "I 0"
+    assert pixel(ImageMath.lambda_eval(lambda args: args["A"] >> 0, A=A)) == "I 1"
+    assert pixel(ImageMath.lambda_eval(lambda args: args["A"] >> 1, A=A)) == "I 0"
+
+
+def test_logical_eq() -> None:
+    assert (
+        pixel(ImageMath.lambda_eval(lambda args: args["A"] == args["A"], A=A)) == "I 1"
+    )
+    assert (
+        pixel(ImageMath.lambda_eval(lambda args: args["B"] == args["B"], B=B)) == "I 1"
+    )
+    assert (
+        pixel(ImageMath.lambda_eval(lambda args: args["A"] == args["B"], A=A, B=B))
+        == "I 0"
+    )
+    assert (
+        pixel(ImageMath.lambda_eval(lambda args: args["B"] == args["A"], A=A, B=B))
+        == "I 0"
+    )
+
+
+def test_logical_ne() -> None:
+    assert (
+        pixel(ImageMath.lambda_eval(lambda args: args["A"] != args["A"], A=A)) == "I 0"
+    )
+    assert (
+        pixel(ImageMath.lambda_eval(lambda args: args["B"] != args["B"], B=B)) == "I 0"
+    )
+    assert (
+        pixel(ImageMath.lambda_eval(lambda args: args["A"] != args["B"], A=A, B=B))
+        == "I 1"
+    )
+    assert (
+        pixel(ImageMath.lambda_eval(lambda args: args["B"] != args["A"], A=A, B=B))
+        == "I 1"
+    )
+
+
+def test_logical_lt() -> None:
+    assert (
+        pixel(ImageMath.lambda_eval(lambda args: args["A"] < args["A"], A=A)) == "I 0"
+    )
+    assert (
+        pixel(ImageMath.lambda_eval(lambda args: args["B"] < args["B"], B=B)) == "I 0"
+    )
+    assert (
+        pixel(ImageMath.lambda_eval(lambda args: args["A"] < args["B"], A=A, B=B))
+        == "I 1"
+    )
+    assert (
+        pixel(ImageMath.lambda_eval(lambda args: args["B"] < args["A"], A=A, B=B))
+        == "I 0"
+    )
+
+
+def test_logical_le() -> None:
+    assert (
+        pixel(ImageMath.lambda_eval(lambda args: args["A"] <= args["A"], A=A)) == "I 1"
+    )
+    assert (
+        pixel(ImageMath.lambda_eval(lambda args: args["B"] <= args["B"], B=B)) == "I 1"
+    )
+    assert (
+        pixel(ImageMath.lambda_eval(lambda args: args["A"] <= args["B"], A=A, B=B))
+        == "I 1"
+    )
+    assert (
+        pixel(ImageMath.lambda_eval(lambda args: args["B"] <= args["A"], A=A, B=B))
+        == "I 0"
+    )
+
+
+def test_logical_gt() -> None:
+    assert (
+        pixel(ImageMath.lambda_eval(lambda args: args["A"] > args["A"], A=A)) == "I 0"
+    )
+    assert (
+        pixel(ImageMath.lambda_eval(lambda args: args["B"] > args["B"], B=B)) == "I 0"
+    )
+    assert (
+        pixel(ImageMath.lambda_eval(lambda args: args["A"] > args["B"], A=A, B=B))
+        == "I 0"
+    )
+    assert (
+        pixel(ImageMath.lambda_eval(lambda args: args["B"] > args["A"], A=A, B=B))
+        == "I 1"
+    )
+
+
+def test_logical_ge() -> None:
+    assert (
+        pixel(ImageMath.lambda_eval(lambda args: args["A"] >= args["A"], A=A)) == "I 1"
+    )
+    assert (
+        pixel(ImageMath.lambda_eval(lambda args: args["B"] >= args["B"], B=B)) == "I 1"
+    )
+    assert (
+        pixel(ImageMath.lambda_eval(lambda args: args["A"] >= args["B"], A=A, B=B))
+        == "I 0"
+    )
+    assert (
+        pixel(ImageMath.lambda_eval(lambda args: args["B"] >= args["A"], A=A, B=B))
+        == "I 1"
+    )
+
+
+def test_logical_equal() -> None:
+    assert (
+        pixel(
+            ImageMath.lambda_eval(lambda args: args["equal"](args["A"], args["A"]), A=A)
+        )
+        == "I 1"
+    )
+    assert (
+        pixel(
+            ImageMath.lambda_eval(lambda args: args["equal"](args["B"], args["B"]), B=B)
+        )
+        == "I 1"
+    )
+    assert (
+        pixel(
+            ImageMath.lambda_eval(lambda args: args["equal"](args["Z"], args["Z"]), Z=Z)
+        )
+        == "I 1"
+    )
+    assert (
+        pixel(
+            ImageMath.lambda_eval(
+                lambda args: args["equal"](args["A"], args["B"]), A=A, B=B
+            )
+        )
+        == "I 0"
+    )
+    assert (
+        pixel(
+            ImageMath.lambda_eval(
+                lambda args: args["equal"](args["B"], args["A"]), A=A, B=B
+            )
+        )
+        == "I 0"
+    )
+    assert (
+        pixel(
+            ImageMath.lambda_eval(
+                lambda args: args["equal"](args["A"], args["Z"]), A=A, Z=Z
+            )
+        )
+        == "I 0"
+    )
+
+
+def test_logical_not_equal() -> None:
+    assert (
+        pixel(
+            ImageMath.lambda_eval(
+                lambda args: args["notequal"](args["A"], args["A"]), A=A
+            )
+        )
+        == "I 0"
+    )
+    assert (
+        pixel(
+            ImageMath.lambda_eval(
+                lambda args: args["notequal"](args["B"], args["B"]), B=B
+            )
+        )
+        == "I 0"
+    )
+    assert (
+        pixel(
+            ImageMath.lambda_eval(
+                lambda args: args["notequal"](args["Z"], args["Z"]), Z=Z
+            )
+        )
+        == "I 0"
+    )
+    assert (
+        pixel(
+            ImageMath.lambda_eval(
+                lambda args: args["notequal"](args["A"], args["B"]), A=A, B=B
+            )
+        )
+        == "I 1"
+    )
+    assert (
+        pixel(
+            ImageMath.lambda_eval(
+                lambda args: args["notequal"](args["B"], args["A"]), A=A, B=B
+            )
+        )
+        == "I 1"
+    )
+    assert (
+        pixel(
+            ImageMath.lambda_eval(
+                lambda args: args["notequal"](args["A"], args["Z"]), A=A, Z=Z
+            )
+        )
+        == "I 1"
+    )
diff --git a/Tests/test_imagemath_unsafe_eval.py b/Tests/test_imagemath_unsafe_eval.py
new file mode 100644
index 00000000000..7b8a562d739
--- /dev/null
+++ b/Tests/test_imagemath_unsafe_eval.py
@@ -0,0 +1,221 @@
+from __future__ import annotations
+
+import pytest
+
+from PIL import Image, ImageMath
+
+
+def pixel(im: Image.Image | int) -> str | int:
+    if isinstance(im, int):
+        return int(im)  # hack to deal with booleans
+
+    return f"{im.mode} {repr(im.getpixel((0, 0)))}"
+
+
+A = Image.new("L", (1, 1), 1)
+B = Image.new("L", (1, 1), 2)
+Z = Image.new("L", (1, 1), 0)  # Z for zero
+F = Image.new("F", (1, 1), 3)
+I = Image.new("I", (1, 1), 4)  # noqa: E741
+
+A2 = A.resize((2, 2))
+B2 = B.resize((2, 2))
+
+images = {"A": A, "B": B, "F": F, "I": I}
+
+
+def test_sanity() -> None:
+    assert ImageMath.unsafe_eval("1") == 1
+    assert ImageMath.unsafe_eval("1+A", A=2) == 3
+    assert pixel(ImageMath.unsafe_eval("A+B", A=A, B=B)) == "I 3"
+    assert pixel(ImageMath.unsafe_eval("A+B", images)) == "I 3"
+    assert pixel(ImageMath.unsafe_eval("float(A)+B", images)) == "F 3.0"
+    assert pixel(ImageMath.unsafe_eval("int(float(A)+B)", images)) == "I 3"
+
+
+def test_eval_deprecated() -> None:
+    with pytest.warns(DeprecationWarning):
+        assert ImageMath.eval("1") == 1
+
+
+def test_ops() -> None:
+    assert pixel(ImageMath.unsafe_eval("-A", images)) == "I -1"
+    assert pixel(ImageMath.unsafe_eval("+B", images)) == "L 2"
+
+    assert pixel(ImageMath.unsafe_eval("A+B", images)) == "I 3"
+    assert pixel(ImageMath.unsafe_eval("A-B", images)) == "I -1"
+    assert pixel(ImageMath.unsafe_eval("A*B", images)) == "I 2"
+    assert pixel(ImageMath.unsafe_eval("A/B", images)) == "I 0"
+    assert pixel(ImageMath.unsafe_eval("B**2", images)) == "I 4"
+    assert pixel(ImageMath.unsafe_eval("B**33", images)) == "I 2147483647"
+
+    assert pixel(ImageMath.unsafe_eval("float(A)+B", images)) == "F 3.0"
+    assert pixel(ImageMath.unsafe_eval("float(A)-B", images)) == "F -1.0"
+    assert pixel(ImageMath.unsafe_eval("float(A)*B", images)) == "F 2.0"
+    assert pixel(ImageMath.unsafe_eval("float(A)/B", images)) == "F 0.5"
+    assert pixel(ImageMath.unsafe_eval("float(B)**2", images)) == "F 4.0"
+    assert pixel(ImageMath.unsafe_eval("float(B)**33", images)) == "F 8589934592.0"
+
+
+@pytest.mark.parametrize(
+    "expression",
+    (
+        "exec('pass')",
+        "(lambda: exec('pass'))()",
+        "(lambda: (lambda: exec('pass'))())()",
+    ),
+)
+def test_prevent_exec(expression: str) -> None:
+    with pytest.raises(ValueError):
+        ImageMath.unsafe_eval(expression)
+
+
+def test_prevent_double_underscores() -> None:
+    with pytest.raises(ValueError):
+        ImageMath.unsafe_eval("1", {"__": None})
+
+
+def test_prevent_builtins() -> None:
+    with pytest.raises(ValueError):
+        ImageMath.unsafe_eval("(lambda: exec('exit()'))()", {"exec": None})
+
+
+def test_logical() -> None:
+    assert pixel(ImageMath.unsafe_eval("not A", images)) == 0
+    assert pixel(ImageMath.unsafe_eval("A and B", images)) == "L 2"
+    assert pixel(ImageMath.unsafe_eval("A or B", images)) == "L 1"
+
+
+def test_convert() -> None:
+    assert pixel(ImageMath.unsafe_eval("convert(A+B, 'L')", images)) == "L 3"
+    assert pixel(ImageMath.unsafe_eval("convert(A+B, '1')", images)) == "1 0"
+    assert (
+        pixel(ImageMath.unsafe_eval("convert(A+B, 'RGB')", images)) == "RGB (3, 3, 3)"
+    )
+
+
+def test_compare() -> None:
+    assert pixel(ImageMath.unsafe_eval("min(A, B)", images)) == "I 1"
+    assert pixel(ImageMath.unsafe_eval("max(A, B)", images)) == "I 2"
+    assert pixel(ImageMath.unsafe_eval("A == 1", images)) == "I 1"
+    assert pixel(ImageMath.unsafe_eval("A == 2", images)) == "I 0"
+
+
+def test_one_image_larger() -> None:
+    assert pixel(ImageMath.unsafe_eval("A+B", A=A2, B=B)) == "I 3"
+    assert pixel(ImageMath.unsafe_eval("A+B", A=A, B=B2)) == "I 3"
+
+
+def test_abs() -> None:
+    assert pixel(ImageMath.unsafe_eval("abs(A)", A=A)) == "I 1"
+    assert pixel(ImageMath.unsafe_eval("abs(B)", B=B)) == "I 2"
+
+
+def test_binary_mod() -> None:
+    assert pixel(ImageMath.unsafe_eval("A%A", A=A)) == "I 0"
+    assert pixel(ImageMath.unsafe_eval("B%B", B=B)) == "I 0"
+    assert pixel(ImageMath.unsafe_eval("A%B", A=A, B=B)) == "I 1"
+    assert pixel(ImageMath.unsafe_eval("B%A", A=A, B=B)) == "I 0"
+    assert pixel(ImageMath.unsafe_eval("Z%A", A=A, Z=Z)) == "I 0"
+    assert pixel(ImageMath.unsafe_eval("Z%B", B=B, Z=Z)) == "I 0"
+
+
+def test_bitwise_invert() -> None:
+    assert pixel(ImageMath.unsafe_eval("~Z", Z=Z)) == "I -1"
+    assert pixel(ImageMath.unsafe_eval("~A", A=A)) == "I -2"
+    assert pixel(ImageMath.unsafe_eval("~B", B=B)) == "I -3"
+
+
+def test_bitwise_and() -> None:
+    assert pixel(ImageMath.unsafe_eval("Z&Z", A=A, Z=Z)) == "I 0"
+    assert pixel(ImageMath.unsafe_eval("Z&A", A=A, Z=Z)) == "I 0"
+    assert pixel(ImageMath.unsafe_eval("A&Z", A=A, Z=Z)) == "I 0"
+    assert pixel(ImageMath.unsafe_eval("A&A", A=A, Z=Z)) == "I 1"
+
+
+def test_bitwise_or() -> None:
+    assert pixel(ImageMath.unsafe_eval("Z|Z", A=A, Z=Z)) == "I 0"
+    assert pixel(ImageMath.unsafe_eval("Z|A", A=A, Z=Z)) == "I 1"
+    assert pixel(ImageMath.unsafe_eval("A|Z", A=A, Z=Z)) == "I 1"
+    assert pixel(ImageMath.unsafe_eval("A|A", A=A, Z=Z)) == "I 1"
+
+
+def test_bitwise_xor() -> None:
+    assert pixel(ImageMath.unsafe_eval("Z^Z", A=A, Z=Z)) == "I 0"
+    assert pixel(ImageMath.unsafe_eval("Z^A", A=A, Z=Z)) == "I 1"
+    assert pixel(ImageMath.unsafe_eval("A^Z", A=A, Z=Z)) == "I 1"
+    assert pixel(ImageMath.unsafe_eval("A^A", A=A, Z=Z)) == "I 0"
+
+
+def test_bitwise_leftshift() -> None:
+    assert pixel(ImageMath.unsafe_eval("Z<<0", Z=Z)) == "I 0"
+    assert pixel(ImageMath.unsafe_eval("Z<<1", Z=Z)) == "I 0"
+    assert pixel(ImageMath.unsafe_eval("A<<0", A=A)) == "I 1"
+    assert pixel(ImageMath.unsafe_eval("A<<1", A=A)) == "I 2"
+
+
+def test_bitwise_rightshift() -> None:
+    assert pixel(ImageMath.unsafe_eval("Z>>0", Z=Z)) == "I 0"
+    assert pixel(ImageMath.unsafe_eval("Z>>1", Z=Z)) == "I 0"
+    assert pixel(ImageMath.unsafe_eval("A>>0", A=A)) == "I 1"
+    assert pixel(ImageMath.unsafe_eval("A>>1", A=A)) == "I 0"
+
+
+def test_logical_eq() -> None:
+    assert pixel(ImageMath.unsafe_eval("A==A", A=A)) == "I 1"
+    assert pixel(ImageMath.unsafe_eval("B==B", B=B)) == "I 1"
+    assert pixel(ImageMath.unsafe_eval("A==B", A=A, B=B)) == "I 0"
+    assert pixel(ImageMath.unsafe_eval("B==A", A=A, B=B)) == "I 0"
+
+
+def test_logical_ne() -> None:
+    assert pixel(ImageMath.unsafe_eval("A!=A", A=A)) == "I 0"
+    assert pixel(ImageMath.unsafe_eval("B!=B", B=B)) == "I 0"
+    assert pixel(ImageMath.unsafe_eval("A!=B", A=A, B=B)) == "I 1"
+    assert pixel(ImageMath.unsafe_eval("B!=A", A=A, B=B)) == "I 1"
+
+
+def test_logical_lt() -> None:
+    assert pixel(ImageMath.unsafe_eval("A<A", A=A)) == "I 0"
+    assert pixel(ImageMath.unsafe_eval("B<B", B=B)) == "I 0"
+    assert pixel(ImageMath.unsafe_eval("A<B", A=A, B=B)) == "I 1"
+    assert pixel(ImageMath.unsafe_eval("B<A", A=A, B=B)) == "I 0"
+
+
+def test_logical_le() -> None:
+    assert pixel(ImageMath.unsafe_eval("A<=A", A=A)) == "I 1"
+    assert pixel(ImageMath.unsafe_eval("B<=B", B=B)) == "I 1"
+    assert pixel(ImageMath.unsafe_eval("A<=B", A=A, B=B)) == "I 1"
+    assert pixel(ImageMath.unsafe_eval("B<=A", A=A, B=B)) == "I 0"
+
+
+def test_logical_gt() -> None:
+    assert pixel(ImageMath.unsafe_eval("A>A", A=A)) == "I 0"
+    assert pixel(ImageMath.unsafe_eval("B>B", B=B)) == "I 0"
+    assert pixel(ImageMath.unsafe_eval("A>B", A=A, B=B)) == "I 0"
+    assert pixel(ImageMath.unsafe_eval("B>A", A=A, B=B)) == "I 1"
+
+
+def test_logical_ge() -> None:
+    assert pixel(ImageMath.unsafe_eval("A>=A", A=A)) == "I 1"
+    assert pixel(ImageMath.unsafe_eval("B>=B", B=B)) == "I 1"
+    assert pixel(ImageMath.unsafe_eval("A>=B", A=A, B=B)) == "I 0"
+    assert pixel(ImageMath.unsafe_eval("B>=A", A=A, B=B)) == "I 1"
+
+
+def test_logical_equal() -> None:
+    assert pixel(ImageMath.unsafe_eval("equal(A, A)", A=A)) == "I 1"
+    assert pixel(ImageMath.unsafe_eval("equal(B, B)", B=B)) == "I 1"
+    assert pixel(ImageMath.unsafe_eval("equal(Z, Z)", Z=Z)) == "I 1"
+    assert pixel(ImageMath.unsafe_eval("equal(A, B)", A=A, B=B)) == "I 0"
+    assert pixel(ImageMath.unsafe_eval("equal(B, A)", A=A, B=B)) == "I 0"
+    assert pixel(ImageMath.unsafe_eval("equal(A, Z)", A=A, Z=Z)) == "I 0"
+
+
+def test_logical_not_equal() -> None:
+    assert pixel(ImageMath.unsafe_eval("notequal(A, A)", A=A)) == "I 0"
+    assert pixel(ImageMath.unsafe_eval("notequal(B, B)", B=B)) == "I 0"
+    assert pixel(ImageMath.unsafe_eval("notequal(Z, Z)", Z=Z)) == "I 0"
+    assert pixel(ImageMath.unsafe_eval("notequal(A, B)", A=A, B=B)) == "I 1"
+    assert pixel(ImageMath.unsafe_eval("notequal(B, A)", A=A, B=B)) == "I 1"
+    assert pixel(ImageMath.unsafe_eval("notequal(A, Z)", A=A, Z=Z)) == "I 1"
diff --git a/docs/reference/ImageMath.rst b/docs/reference/ImageMath.rst
index ee07efa0132..026c7cd9e07 100644
--- a/docs/reference/ImageMath.rst
+++ b/docs/reference/ImageMath.rst
@@ -4,9 +4,12 @@
 :py:mod:`~PIL.ImageMath` Module
 ===============================
 
-The :py:mod:`~PIL.ImageMath` module can be used to evaluate “image expressions”. The
-module provides a single :py:meth:`~PIL.ImageMath.eval` function, which takes
-an expression string and one or more images.
+The :py:mod:`~PIL.ImageMath` module can be used to evaluate “image expressions”, that
+can take a number of images and generate a result.
+
+In the current version, :py:mod:`~PIL.ImageMath` only supports single-layer images. To
+process multi-band images, use the :py:meth:`~PIL.Image.Image.split` method or
+:py:func:`~PIL.Image.merge` function.
 
 Example: Using the :py:mod:`~PIL.ImageMath` module
 --------------------------------------------------
@@ -17,13 +20,36 @@ Example: Using the :py:mod:`~PIL.ImageMath` module
 
     with Image.open("image1.jpg") as im1:
         with Image.open("image2.jpg") as im2:
+            out = ImageMath.lambda_eval(
+              lambda args: args["convert"](args["min"](args["a"], args["b"]), 'L'),
+              a=im1,
+              b=im2
+            )
+            out = ImageMath.unsafe_eval(
+              "convert(min(a, b), 'L')",
+              a=im1,
+              b=im2
+            )
+
+.. py:function:: lambda_eval(expression, environment)
+
+    Returns the result of an image function.
+
+    :param expression: A function that receives a dictionary.
+    :param options: Values to add to the function's dictionary, mapping image
+                    names to Image instances. You can use one or more keyword
+                    arguments instead of a dictionary, as shown in the above
+                    example. Note that the names must be valid Python
+                    identifiers.
+    :return: An image, an integer value, a floating point value,
+             or a pixel tuple, depending on the expression.
 
-            out = ImageMath.eval("convert(min(a, b), 'L')", a=im1, b=im2)
-            out.save("result.png")
-
-.. py:function:: eval(expression, environment)
+.. py:function:: unsafe_eval(expression, environment)
 
-    Evaluate expression in the given environment.
+    Evaluates an image expression. This uses Python's ``eval()`` function to process
+    the expression string, and carries the security risks of doing so. It is not
+    recommended to process expressions without considering this.
+    :py:meth:`~lambda_eval` is a more secure alternative.
 
     In the current version, :py:mod:`~PIL.ImageMath` only supports
     single-layer images. To process multi-band images, use the
@@ -33,19 +59,25 @@ Example: Using the :py:mod:`~PIL.ImageMath` module
     :param expression: A string which uses the standard Python expression
                        syntax. In addition to the standard operators, you can
                        also use the functions described below.
-    :param environment: A dictionary that maps image names to Image instances.
-                        You can use one or more keyword arguments instead of a
-                        dictionary, as shown in the above example. Note that
-                        the names must be valid Python identifiers.
+    :param options: Values to add to the function's dictionary, mapping image
+                    names to Image instances. You can use one or more keyword
+                    arguments instead of a dictionary, as shown in the above
+                    example. Note that the names must be valid Python
+                    identifiers.
     :return: An image, an integer value, a floating point value,
              or a pixel tuple, depending on the expression.
 
 Expression syntax
 -----------------
 
-Expressions are standard Python expressions, but they’re evaluated in a
-non-standard environment. You can use PIL methods as usual, plus the following
-set of operators and functions:
+:py:meth:`~lambda_eval` expressions are functions that receive a dictionary containing
+images and operators.
+
+:py:meth:`~unsafe_eval` expressions are standard Python expressions, but they’re
+evaluated in a non-standard environment.
+
+In both cases, you can use Pillow methods as usual, plus the following set of operators
+and functions.
 
 Standard Operators
 ^^^^^^^^^^^^^^^^^^
diff --git a/docs/releasenotes/10.2.0.rst b/docs/releasenotes/10.2.0.rst
index 0ffad2e8a1c..1c6b78b0841 100644
--- a/docs/releasenotes/10.2.0.rst
+++ b/docs/releasenotes/10.2.0.rst
@@ -29,7 +29,7 @@ they do not extend beyond the bitmap image.
 ^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
 
 If an attacker has control over the keys passed to the
-``environment`` argument of :py:meth:`PIL.ImageMath.eval`, they may be able to execute
+``environment`` argument of :py:meth:`!PIL.ImageMath.eval`, they may be able to execute
 arbitrary code. To prevent this, keys matching the names of builtins and keys
 containing double underscores will now raise a :py:exc:`ValueError`.
 
diff --git a/docs/releasenotes/9.0.0.rst b/docs/releasenotes/9.0.0.rst
index 8d59aef3029..fee66b6d0b5 100644
--- a/docs/releasenotes/9.0.0.rst
+++ b/docs/releasenotes/9.0.0.rst
@@ -47,7 +47,7 @@ Google's `OSS-Fuzz`_ project for finding this issue.
 ^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
 
 To limit :py:class:`PIL.ImageMath` to working with images, Pillow
-will now restrict the builtins available to :py:meth:`PIL.ImageMath.eval`. This will
+will now restrict the builtins available to :py:meth:`!PIL.ImageMath.eval`. This will
 help prevent problems arising if users evaluate arbitrary expressions, such as
 ``ImageMath.eval("exec(exit())")``.
 
diff --git a/docs/releasenotes/9.0.1.rst b/docs/releasenotes/9.0.1.rst
index a25e3f5ac66..f65e3bcc2ec 100644
--- a/docs/releasenotes/9.0.1.rst
+++ b/docs/releasenotes/9.0.1.rst
@@ -18,7 +18,7 @@ has been present since PIL.
 ^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
 
 While Pillow 9.0 restricted top-level builtins available to
-:py:meth:`PIL.ImageMath.eval`, it did not prevent builtins
+:py:meth:`!PIL.ImageMath.eval`, it did not prevent builtins
 available to lambda expressions. These are now also restricted.
 
 Other Changes
diff --git a/src/PIL/GifImagePlugin.py b/src/PIL/GifImagePlugin.py
index b8671068d59..6b415d2384a 100644
--- a/src/PIL/GifImagePlugin.py
+++ b/src/PIL/GifImagePlugin.py
@@ -652,8 +652,17 @@ def _write_multiple_frames(im, fp, palette):
                         fill = Image.new("P", delta.size, encoderinfo["transparency"])
                         if delta.mode == "RGBA":
                             r, g, b, a = delta.split()
-                            mask = ImageMath.eval(
-                                "convert(max(max(max(r, g), b), a) * 255, '1')",
+                            mask = ImageMath.lambda_eval(
+                                lambda args: args["convert"](
+                                    args["max"](
+                                        args["max"](
+                                            args["max"](args["r"], args["g"]), args["b"]
+                                        ),
+                                        args["a"],
+                                    )
+                                    * 255,
+                                    "1",
+                                ),
                                 r=r,
                                 g=g,
                                 b=b,
@@ -665,7 +674,10 @@ def _write_multiple_frames(im, fp, palette):
                                 delta_l = Image.new("L", delta.size)
                                 delta_l.putdata(delta.getdata())
                                 delta = delta_l
-                            mask = ImageMath.eval("convert(im * 255, '1')", im=delta)
+                            mask = ImageMath.lambda_eval(
+                                lambda args: args["convert"](args["im"] * 255, "1"),
+                                im=delta,
+                            )
                         diff_frame.paste(fill, mask=ImageOps.invert(mask))
             else:
                 bbox = None
diff --git a/src/PIL/ImageMath.py b/src/PIL/ImageMath.py
index a7652f237ed..5ed9e08ad3f 100644
--- a/src/PIL/ImageMath.py
+++ b/src/PIL/ImageMath.py
@@ -18,9 +18,10 @@
 
 import builtins
 from types import CodeType
-from typing import Any
+from typing import Any, Callable
 
 from . import Image, _imagingmath
+from ._deprecate import deprecate
 
 
 class _Operand:
@@ -235,9 +236,55 @@ def imagemath_convert(self: _Operand, mode: str) -> _Operand:
 }
 
 
-def eval(expression: str, _dict: dict[str, Any] = {}, **kw: Any) -> Any:
+def lambda_eval(expression: Callable[[dict[str, Any]], Any],
+    _dict: dict[str, Any] = {},
+    **kw: Any,) -> Any:
     """
-    Evaluates an image expression.
+    Returns the result of an image function.
+
+    In the current version, :py:mod:`~PIL.ImageMath` only supports
+    single-layer images. To process multi-band images, use the
+    :py:meth:`~PIL.Image.Image.split` method or :py:func:`~PIL.Image.merge`
+    function.
+
+    :param expression: A function that receives a dictionary.
+    :param options: Values to add to the function's dictionary. You
+                    can either use a dictionary, or one or more keyword
+                    arguments.
+    :return: The expression result. This is usually an image object, but can
+             also be an integer, a floating point value, or a pixel tuple,
+             depending on the expression.
+    """
+
+    args: dict[str, Any] = ops.copy()
+    args.update(_dict)
+    args.update(kw)
+    for k, v in args.items():
+        if hasattr(v, "im"):
+            args[k] = _Operand(v)
+
+    out = expression(args)
+    try:
+        return out.im
+    except AttributeError:
+        return out
+
+
+def unsafe_eval(
+    expression: str,
+    _dict: dict[str, Any] = {},
+    **kw: Any,
+) -> Any:
+    """
+    Evaluates an image expression. This uses Python's ``eval()`` function to process
+    the expression string, and carries the security risks of doing so. It is not
+    recommended to process expressions without considering this.
+    :py:meth:`~lambda_eval` is a more secure alternative.
+
+    In the current version, :py:mod:`~PIL.ImageMath` only supports
+    single-layer images. To process multi-band images, use the
+    :py:meth:`~PIL.Image.Image.split` method or :py:func:`~PIL.Image.merge`
+    function.
 
     :param expression: A string containing a Python-style expression.
     :param options: Values to add to the evaluation context.  You
@@ -279,3 +326,32 @@ def scan(code: CodeType) -> None:
         return out.im
     except AttributeError:
         return out
+
+
+def eval(
+    expression: str,
+    _dict: dict[str, Any] = {},
+    **kw: Any,
+) -> Any:
+    """
+    Evaluates an image expression.
+
+    Deprecated. Use lambda_eval() or unsafe_eval() instead.
+
+    :param expression: A string containing a Python-style expression.
+    :param options: Values to add to the evaluation context.  You
+                    can either use a dictionary, or one or more keyword
+                    arguments.
+    :return: The evaluated expression. This is usually an image object, but can
+             also be an integer, a floating point value, or a pixel tuple,
+             depending on the expression.
+
+    ..  deprecated:: 10.3.0
+    """
+
+    deprecate(
+        "ImageMath.eval",
+        12,
+        "ImageMath.lambda_eval or ImageMath.unsafe_eval",
+    )
+    return unsafe_eval(expression, _dict, **kw)

From a7e82cbe9a2ecc17311d4d69091992a741360677 Mon Sep 17 00:00:00 2001
From: Andrew Murray <radarhere@users.noreply.github.com>
Date: Tue, 26 Mar 2024 05:50:08 +1100
Subject: [PATCH 0452/1178] Removed "In the current version"

---
 docs/reference/ImageMath.rst | 13 ++++++-------
 src/PIL/ImageMath.py         | 14 ++++++--------
 2 files changed, 12 insertions(+), 15 deletions(-)

diff --git a/docs/reference/ImageMath.rst b/docs/reference/ImageMath.rst
index 026c7cd9e07..5fd61f881f7 100644
--- a/docs/reference/ImageMath.rst
+++ b/docs/reference/ImageMath.rst
@@ -7,9 +7,9 @@
 The :py:mod:`~PIL.ImageMath` module can be used to evaluate “image expressions”, that
 can take a number of images and generate a result.
 
-In the current version, :py:mod:`~PIL.ImageMath` only supports single-layer images. To
-process multi-band images, use the :py:meth:`~PIL.Image.Image.split` method or
-:py:func:`~PIL.Image.merge` function.
+:py:mod:`~PIL.ImageMath` only supports single-layer images. To process multi-band
+images, use the :py:meth:`~PIL.Image.Image.split` method or :py:func:`~PIL.Image.merge`
+function.
 
 Example: Using the :py:mod:`~PIL.ImageMath` module
 --------------------------------------------------
@@ -51,10 +51,9 @@ Example: Using the :py:mod:`~PIL.ImageMath` module
     recommended to process expressions without considering this.
     :py:meth:`~lambda_eval` is a more secure alternative.
 
-    In the current version, :py:mod:`~PIL.ImageMath` only supports
-    single-layer images. To process multi-band images, use the
-    :py:meth:`~PIL.Image.Image.split` method or :py:func:`~PIL.Image.merge`
-    function.
+    :py:mod:`~PIL.ImageMath` only supports single-layer images. To process multi-band
+    images, use the :py:meth:`~PIL.Image.Image.split` method or
+    :py:func:`~PIL.Image.merge` function.
 
     :param expression: A string which uses the standard Python expression
                        syntax. In addition to the standard operators, you can
diff --git a/src/PIL/ImageMath.py b/src/PIL/ImageMath.py
index 5ed9e08ad3f..2ffebbe71c5 100644
--- a/src/PIL/ImageMath.py
+++ b/src/PIL/ImageMath.py
@@ -242,10 +242,9 @@ def lambda_eval(expression: Callable[[dict[str, Any]], Any],
     """
     Returns the result of an image function.
 
-    In the current version, :py:mod:`~PIL.ImageMath` only supports
-    single-layer images. To process multi-band images, use the
-    :py:meth:`~PIL.Image.Image.split` method or :py:func:`~PIL.Image.merge`
-    function.
+    :py:mod:`~PIL.ImageMath` only supports single-layer images. To process multi-band
+    images, use the :py:meth:`~PIL.Image.Image.split` method or
+    :py:func:`~PIL.Image.merge` function.
 
     :param expression: A function that receives a dictionary.
     :param options: Values to add to the function's dictionary. You
@@ -281,10 +280,9 @@ def unsafe_eval(
     recommended to process expressions without considering this.
     :py:meth:`~lambda_eval` is a more secure alternative.
 
-    In the current version, :py:mod:`~PIL.ImageMath` only supports
-    single-layer images. To process multi-band images, use the
-    :py:meth:`~PIL.Image.Image.split` method or :py:func:`~PIL.Image.merge`
-    function.
+    :py:mod:`~PIL.ImageMath` only supports single-layer images. To process multi-band
+    images, use the :py:meth:`~PIL.Image.Image.split` method or
+    :py:func:`~PIL.Image.merge` function.
 
     :param expression: A string containing a Python-style expression.
     :param options: Values to add to the evaluation context.  You

From f932cb895fcfa369461e6829230a0e22dace8a31 Mon Sep 17 00:00:00 2001
From: Andrew Murray <radarhere@users.noreply.github.com>
Date: Tue, 26 Mar 2024 06:16:09 +1100
Subject: [PATCH 0453/1178] Added danger alerts

---
 docs/reference/ImageMath.rst | 26 ++++++++++++++++----------
 1 file changed, 16 insertions(+), 10 deletions(-)

diff --git a/docs/reference/ImageMath.rst b/docs/reference/ImageMath.rst
index 5fd61f881f7..703b2f5b943 100644
--- a/docs/reference/ImageMath.rst
+++ b/docs/reference/ImageMath.rst
@@ -46,10 +46,13 @@ Example: Using the :py:mod:`~PIL.ImageMath` module
 
 .. py:function:: unsafe_eval(expression, environment)
 
-    Evaluates an image expression. This uses Python's ``eval()`` function to process
-    the expression string, and carries the security risks of doing so. It is not
-    recommended to process expressions without considering this.
-    :py:meth:`~lambda_eval` is a more secure alternative.
+    Evaluates an image expression.
+
+    .. danger::
+        This uses Python's ``eval()`` function to process the expression string,
+        and carries the security risks of doing so. It is not
+        recommended to process expressions without considering this.
+        :py:meth:`lambda_eval` is a more secure alternative.
 
     :py:mod:`~PIL.ImageMath` only supports single-layer images. To process multi-band
     images, use the :py:meth:`~PIL.Image.Image.split` method or
@@ -69,14 +72,17 @@ Example: Using the :py:mod:`~PIL.ImageMath` module
 Expression syntax
 -----------------
 
-:py:meth:`~lambda_eval` expressions are functions that receive a dictionary containing
-images and operators.
+* :py:meth:`lambda_eval` expressions are functions that receive a dictionary
+  containing images and operators.
 
-:py:meth:`~unsafe_eval` expressions are standard Python expressions, but they’re
-evaluated in a non-standard environment.
+* :py:meth:`unsafe_eval` expressions are standard Python expressions,
+  but they’re evaluated in a non-standard environment.
 
-In both cases, you can use Pillow methods as usual, plus the following set of operators
-and functions.
+.. danger::
+  :py:meth:`unsafe_eval` uses Python's ``eval()`` function to process the
+  expression string, and carries the security risks of doing so.
+  It is not recommended to process expressions without considering this.
+  :py:meth:`lambda_eval` is a more secure alternative.
 
 Standard Operators
 ^^^^^^^^^^^^^^^^^^

From f6596d529399a80fb89daf2675987f1fd92cbd64 Mon Sep 17 00:00:00 2001
From: Andrew Murray <radarhere@users.noreply.github.com>
Date: Tue, 26 Mar 2024 06:32:42 +1100
Subject: [PATCH 0454/1178] Added release notes and document deprecation

---
 docs/deprecations.rst        |  8 ++++++++
 docs/releasenotes/10.3.0.rst | 18 +++++++++++++++---
 2 files changed, 23 insertions(+), 3 deletions(-)

diff --git a/docs/deprecations.rst b/docs/deprecations.rst
index 33bc141877f..c3d1ba4f028 100644
--- a/docs/deprecations.rst
+++ b/docs/deprecations.rst
@@ -92,6 +92,14 @@ Deprecated                                    Use instead
                                               :py:data:`sys.version_info`, and ``PIL.__version__``
 ============================================  ====================================================
 
+ImageMath eval()
+^^^^^^^^^^^^^^^^
+
+.. deprecated:: 10.3.0
+
+``ImageMath.eval()`` has been deprecated. Use :py:meth:`~PIL.ImageMath.lambda_eval` or
+:py:meth:`~PIL.ImageMath.unsafe_eval` instead.
+
 Removed features
 ----------------
 
diff --git a/docs/releasenotes/10.3.0.rst b/docs/releasenotes/10.3.0.rst
index a73efcee418..607f0b2620a 100644
--- a/docs/releasenotes/10.3.0.rst
+++ b/docs/releasenotes/10.3.0.rst
@@ -4,10 +4,15 @@
 Security
 ========
 
-TODO
-^^^^
+ImageMath eval()
+^^^^^^^^^^^^^^^^
 
-TODO
+.. danger::
+  ``ImageMath.eval()`` uses Python's ``eval()`` function to process the expression
+  string, and carries the security risks of doing so. A direct replacement for this is
+  the new :py:meth:`~PIL.ImageMath.unsafe_eval`, but that carries the same risks. It is
+  not recommended to process expressions without considering this.
+  :py:meth:`~PIL.ImageMath.lambda_eval` is a more secure alternative.
 
 :cve:`YYYY-XXXXX`: TODO
 ^^^^^^^^^^^^^^^^^^^^^^^
@@ -58,6 +63,13 @@ Deprecated                                    Use instead
                                               :py:data:`sys.version_info`, and ``PIL.__version__``
 ============================================  ====================================================
 
+ImageMath.eval()
+^^^^^^^^^^^^^^^^
+
+``ImageMath.eval()`` has been deprecated. Use :py:meth:`~PIL.ImageMath.lambda_eval` or
+:py:meth:`~PIL.ImageMath.unsafe_eval` instead. See earlier security notes for more
+information.
+
 API Changes
 ===========
 

From 8f3860c29ba4b3de97fa1b22dad6b123bf2f7bad Mon Sep 17 00:00:00 2001
From: "pre-commit-ci[bot]"
 <66853113+pre-commit-ci[bot]@users.noreply.github.com>
Date: Mon, 1 Apr 2024 06:17:00 +0000
Subject: [PATCH 0455/1178] [pre-commit.ci] auto fixes from pre-commit.com
 hooks

for more information, see https://pre-commit.ci
---
 Tests/test_imagemath_lambda_eval.py | 2 --
 src/PIL/ImageMath.py                | 6 ++++--
 2 files changed, 4 insertions(+), 4 deletions(-)

diff --git a/Tests/test_imagemath_lambda_eval.py b/Tests/test_imagemath_lambda_eval.py
index 3915e64aae1..5769c903e49 100644
--- a/Tests/test_imagemath_lambda_eval.py
+++ b/Tests/test_imagemath_lambda_eval.py
@@ -1,7 +1,5 @@
 from __future__ import annotations
 
-import pytest
-
 from PIL import Image, ImageMath
 
 
diff --git a/src/PIL/ImageMath.py b/src/PIL/ImageMath.py
index 2ffebbe71c5..5d83929dc0a 100644
--- a/src/PIL/ImageMath.py
+++ b/src/PIL/ImageMath.py
@@ -236,9 +236,11 @@ def imagemath_convert(self: _Operand, mode: str) -> _Operand:
 }
 
 
-def lambda_eval(expression: Callable[[dict[str, Any]], Any],
+def lambda_eval(
+    expression: Callable[[dict[str, Any]], Any],
     _dict: dict[str, Any] = {},
-    **kw: Any,) -> Any:
+    **kw: Any,
+) -> Any:
     """
     Returns the result of an image function.
 

From a670597bc30e9d489656fc9d807170b8f3d7ca57 Mon Sep 17 00:00:00 2001
From: Andrew Murray <radarhere@users.noreply.github.com>
Date: Mon, 1 Apr 2024 17:21:04 +1100
Subject: [PATCH 0456/1178] Update CHANGES.rst [ci skip]

---
 CHANGES.rst | 3 +++
 1 file changed, 3 insertions(+)

diff --git a/CHANGES.rst b/CHANGES.rst
index fd4a27d869b..5d08940ca3b 100644
--- a/CHANGES.rst
+++ b/CHANGES.rst
@@ -5,6 +5,9 @@ Changelog (Pillow)
 10.3.0 (unreleased)
 -------------------
 
+- Raise ValueError if seeking to greater than offset-sized integer in TIFF #7883
+  [radarhere]
+
 - Add --report argument to __main__.py to omit supported formats #7818
   [nulano, radarhere, hugovk]
 

From 2a93aba5cfcf6e241ab4f9392c13e3b74032c061 Mon Sep 17 00:00:00 2001
From: Andrew Murray <radarhere@users.noreply.github.com>
Date: Thu, 22 Feb 2024 18:56:26 +1100
Subject: [PATCH 0457/1178] Use strncpy to avoid buffer overflow

---
 Tests/icc/sGrey-v2-nano.icc | Bin 0 -> 290 bytes
 Tests/test_imagecms.py      |   5 +++++
 src/_imagingcms.c           |   9 ++++-----
 3 files changed, 9 insertions(+), 5 deletions(-)
 create mode 100644 Tests/icc/sGrey-v2-nano.icc

diff --git a/Tests/icc/sGrey-v2-nano.icc b/Tests/icc/sGrey-v2-nano.icc
new file mode 100644
index 0000000000000000000000000000000000000000..0e9edfd403182dd3ca815935cc85f33ec5dbd746
GIT binary patch
literal 290
zcmZQzU{uOU&MjsVU|`72D=Bgha*T|Kj8b5K#K6oT!obPE#~_=STwLHA>=wcR1jUKv
z#mOZ_IUqIye7nZL2;yDV%}C5k;hV$Xm^N{`e8QEs#kOw0V-V`FvRG15i<5yeTYxye
zyriH6NM8VAk?fElXCVCqh)t3Uih$yb5<oT=R6UT%z?$b?R0(3h0LbkS_U90=n;6AT
zCYKhKLFGk&X0S7DWzFU^;|mbkDAS;N!eF7Tq_;z~dd}^J?5U5}1{^!|$ngLFlGF;2
II~WWY0A|-bu>b%7

literal 0
HcmV?d00001

diff --git a/Tests/test_imagecms.py b/Tests/test_imagecms.py
index c80fab75b67..fbd78032e59 100644
--- a/Tests/test_imagecms.py
+++ b/Tests/test_imagecms.py
@@ -661,6 +661,11 @@ def test_auxiliary_channels_isolated() -> None:
                 assert_image_equal(test_image.convert(dst_format[2]), reference_image)
 
 
+def test_long_modes() -> None:
+    p = ImageCms.getOpenProfile("Tests/icc/sGrey-v2-nano.icc")
+    ImageCms.buildTransform(p, p, "ABCDEFGHI", "ABCDEFGHI")
+
+
 @pytest.mark.parametrize("mode", ("RGB", "RGBA", "RGBX"))
 def test_rgb_lab(mode: str) -> None:
     im = Image.new(mode, (1, 1))
diff --git a/src/_imagingcms.c b/src/_imagingcms.c
index 4d66dcc1085..84b8a7e71f9 100644
--- a/src/_imagingcms.c
+++ b/src/_imagingcms.c
@@ -201,8 +201,8 @@ cms_transform_new(cmsHTRANSFORM transform, char *mode_in, char *mode_out) {
 
     self->transform = transform;
 
-    strcpy(self->mode_in, mode_in);
-    strcpy(self->mode_out, mode_out);
+    strncpy(self->mode_in, mode_in, 8);
+    strncpy(self->mode_out, mode_out, 8);
 
     return (PyObject *)self;
 }
@@ -242,10 +242,9 @@ findLCMStype(char *PILmode) {
         // LabX equivalent like ALab, but not reversed -- no #define in lcms2
         return (COLORSPACE_SH(PT_LabV2) | CHANNELS_SH(3) | BYTES_SH(1) | EXTRA_SH(1));
     }
-
     else {
-        /* take a wild guess... but you probably should fail instead. */
-        return TYPE_GRAY_8; /* so there's no buffer overrun... */
+        /* take a wild guess... */
+        return TYPE_GRAY_8;
     }
 }
 

From facf3af93dabcbdd8cdbda8c3b50eefafa3bb04c Mon Sep 17 00:00:00 2001
From: Andrew Murray <radarhere@users.noreply.github.com>
Date: Tue, 26 Mar 2024 05:34:31 +1100
Subject: [PATCH 0458/1178] Added release notes

---
 docs/releasenotes/10.3.0.rst | 18 ++++--------------
 1 file changed, 4 insertions(+), 14 deletions(-)

diff --git a/docs/releasenotes/10.3.0.rst b/docs/releasenotes/10.3.0.rst
index a73efcee418..e5a47b28142 100644
--- a/docs/releasenotes/10.3.0.rst
+++ b/docs/releasenotes/10.3.0.rst
@@ -4,21 +4,11 @@
 Security
 ========
 
-TODO
-^^^^
+:cve:`2024-28219`: Fix buffer overflow in ``_imagingcms.c``
+^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
 
-TODO
-
-:cve:`YYYY-XXXXX`: TODO
-^^^^^^^^^^^^^^^^^^^^^^^
-
-TODO
-
-Backwards Incompatible Changes
-==============================
-
-TODO
-^^^^
+In ``_imagingcms.c``, two ``strcpy`` calls were able to copy too much data into fixed
+length strings. This has been fixed by using ``strncpy`` instead.
 
 Deprecations
 ============

From f5eeeacf7539eaa0d93a677d7666bc7c142c8d1c Mon Sep 17 00:00:00 2001
From: Hugo van Kemenade <1324225+hugovk@users.noreply.github.com>
Date: Mon, 1 Apr 2024 09:35:49 +0300
Subject: [PATCH 0459/1178] Name as 'options' in lambda_eval and unsafe_eval,
 but '_dict' in deprecated eval

---
 src/PIL/ImageMath.py | 16 ++++++++--------
 1 file changed, 8 insertions(+), 8 deletions(-)

diff --git a/src/PIL/ImageMath.py b/src/PIL/ImageMath.py
index 5d83929dc0a..77472a24c68 100644
--- a/src/PIL/ImageMath.py
+++ b/src/PIL/ImageMath.py
@@ -238,7 +238,7 @@ def imagemath_convert(self: _Operand, mode: str) -> _Operand:
 
 def lambda_eval(
     expression: Callable[[dict[str, Any]], Any],
-    _dict: dict[str, Any] = {},
+    options: dict[str, Any] = {},
     **kw: Any,
 ) -> Any:
     """
@@ -258,7 +258,7 @@ def lambda_eval(
     """
 
     args: dict[str, Any] = ops.copy()
-    args.update(_dict)
+    args.update(options)
     args.update(kw)
     for k, v in args.items():
         if hasattr(v, "im"):
@@ -273,7 +273,7 @@ def lambda_eval(
 
 def unsafe_eval(
     expression: str,
-    _dict: dict[str, Any] = {},
+    options: dict[str, Any] = {},
     **kw: Any,
 ) -> Any:
     """
@@ -297,12 +297,12 @@ def unsafe_eval(
 
     # build execution namespace
     args: dict[str, Any] = ops.copy()
-    for k in list(_dict.keys()) + list(kw.keys()):
+    for k in list(options.keys()) + list(kw.keys()):
         if "__" in k or hasattr(builtins, k):
             msg = f"'{k}' not allowed"
             raise ValueError(msg)
 
-    args.update(_dict)
+    args.update(options)
     args.update(kw)
     for k, v in args.items():
         if hasattr(v, "im"):
@@ -339,9 +339,9 @@ def eval(
     Deprecated. Use lambda_eval() or unsafe_eval() instead.
 
     :param expression: A string containing a Python-style expression.
-    :param options: Values to add to the evaluation context.  You
-                    can either use a dictionary, or one or more keyword
-                    arguments.
+    :param _dict: Values to add to the evaluation context.  You
+                  can either use a dictionary, or one or more keyword
+                  arguments.
     :return: The evaluated expression. This is usually an image object, but can
              also be an integer, a floating point value, or a pixel tuple,
              depending on the expression.

From 5beb0b66648db8b542bb5260eed79b25e33d643b Mon Sep 17 00:00:00 2001
From: Andrew Murray <radarhere@users.noreply.github.com>
Date: Mon, 1 Apr 2024 19:24:44 +1100
Subject: [PATCH 0460/1178]  Update CHANGES.rst [ci skip]

---
 CHANGES.rst | 3 +++
 1 file changed, 3 insertions(+)

diff --git a/CHANGES.rst b/CHANGES.rst
index 5d08940ca3b..d314ac4e96b 100644
--- a/CHANGES.rst
+++ b/CHANGES.rst
@@ -5,6 +5,9 @@ Changelog (Pillow)
 10.3.0 (unreleased)
 -------------------
 
+- Deprecate eval(), replacing it with lambda_eval() and unsafe_eval() #7927
+  [radarhere, hugovk]
+
 - Raise ValueError if seeking to greater than offset-sized integer in TIFF #7883
   [radarhere]
 

From 63cbfcfdea2d163ec93bae8d283fcfe4b73b5dc7 Mon Sep 17 00:00:00 2001
From: Andrew Murray <radarhere@users.noreply.github.com>
Date: Mon, 1 Apr 2024 20:19:46 +1100
Subject: [PATCH 0461/1178] Update CHANGES.rst [ci skip]

---
 CHANGES.rst | 3 +++
 1 file changed, 3 insertions(+)

diff --git a/CHANGES.rst b/CHANGES.rst
index d314ac4e96b..86d1e349c12 100644
--- a/CHANGES.rst
+++ b/CHANGES.rst
@@ -5,6 +5,9 @@ Changelog (Pillow)
 10.3.0 (unreleased)
 -------------------
 
+- CVE-2024-28219: Use strncpy to avoid buffer overflow #7928
+  [radarhere, hugovk]
+
 - Deprecate eval(), replacing it with lambda_eval() and unsafe_eval() #7927
   [radarhere, hugovk]
 

From 5c89d88eee199ba53f64581ea39b6a1bc52feb1a Mon Sep 17 00:00:00 2001
From: Hugo van Kemenade <1324225+hugovk@users.noreply.github.com>
Date: Mon, 1 Apr 2024 12:22:36 +0300
Subject: [PATCH 0462/1178] 10.3.0 version bump

---
 CHANGES.rst         | 10 +++++-----
 src/PIL/_version.py |  2 +-
 2 files changed, 6 insertions(+), 6 deletions(-)

diff --git a/CHANGES.rst b/CHANGES.rst
index 86d1e349c12..9fae613a5ae 100644
--- a/CHANGES.rst
+++ b/CHANGES.rst
@@ -2,19 +2,19 @@
 Changelog (Pillow)
 ==================
 
-10.3.0 (unreleased)
+10.3.0 (2024-04-01)
 -------------------
 
-- CVE-2024-28219: Use strncpy to avoid buffer overflow #7928
+- CVE-2024-28219: Use ``strncpy`` to avoid buffer overflow #7928
   [radarhere, hugovk]
 
-- Deprecate eval(), replacing it with lambda_eval() and unsafe_eval() #7927
+- Deprecate ``eval()``, replacing it with ``lambda_eval()`` and ``unsafe_eval()`` #7927
   [radarhere, hugovk]
 
-- Raise ValueError if seeking to greater than offset-sized integer in TIFF #7883
+- Raise ``ValueError`` if seeking to greater than offset-sized integer in TIFF #7883
   [radarhere]
 
-- Add --report argument to __main__.py to omit supported formats #7818
+- Add ``--report`` argument to ``__main__.py`` to omit supported formats #7818
   [nulano, radarhere, hugovk]
 
 - Added RGB to I;16, I;16L, I;16B and I;16N conversion #7918, #7920
diff --git a/src/PIL/_version.py b/src/PIL/_version.py
index 0568943b52b..dbed769edc7 100644
--- a/src/PIL/_version.py
+++ b/src/PIL/_version.py
@@ -1,4 +1,4 @@
 # Master version for Pillow
 from __future__ import annotations
 
-__version__ = "10.3.0.dev0"
+__version__ = "10.3.0"

From e4a10051b600eb1211e944225570be72013c72f5 Mon Sep 17 00:00:00 2001
From: Andrew Murray <radarhere@users.noreply.github.com>
Date: Mon, 1 Apr 2024 19:00:19 +1100
Subject: [PATCH 0463/1178] Corrected test

---
 Tests/test_imagecms.py | 4 ++--
 1 file changed, 2 insertions(+), 2 deletions(-)

diff --git a/Tests/test_imagecms.py b/Tests/test_imagecms.py
index fbd78032e59..bf629fa79cc 100644
--- a/Tests/test_imagecms.py
+++ b/Tests/test_imagecms.py
@@ -526,9 +526,9 @@ def test_profile_typesafety() -> None:
 def test_transform_typesafety() -> None:
     # core transform should not be directly instantiable
     with pytest.raises(TypeError):
-        ImageCms.core.CmsProfile()
+        ImageCms.core.CmsTransform()
     with pytest.raises(TypeError):
-        ImageCms.core.CmsProfile(0)
+        ImageCms.core.CmsTransform(0)
 
 
 def assert_aux_channel_preserved(

From 2f28ebbb6d0bab2a878051f9f7dc48f2e7a88ec1 Mon Sep 17 00:00:00 2001
From: Hugo van Kemenade <1324225+hugovk@users.noreply.github.com>
Date: Mon, 1 Apr 2024 15:35:42 +0300
Subject: [PATCH 0464/1178] 10.4.0.dev0 version bump

---
 src/PIL/_version.py | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/src/PIL/_version.py b/src/PIL/_version.py
index dbed769edc7..12d7412eaa1 100644
--- a/src/PIL/_version.py
+++ b/src/PIL/_version.py
@@ -1,4 +1,4 @@
 # Master version for Pillow
 from __future__ import annotations
 
-__version__ = "10.3.0"
+__version__ = "10.4.0.dev0"

From 8e96748aeab2e081b1ca6a50ee5ac0c25cc90513 Mon Sep 17 00:00:00 2001
From: Yay295 <Yay295@gmail.com>
Date: Mon, 1 Apr 2024 09:35:56 -0500
Subject: [PATCH 0465/1178] correct property names in method documentation

---
 src/PIL/ImageCms.py | 12 ++++++------
 1 file changed, 6 insertions(+), 6 deletions(-)

diff --git a/src/PIL/ImageCms.py b/src/PIL/ImageCms.py
index 3a45572a128..162db628c8a 100644
--- a/src/PIL/ImageCms.py
+++ b/src/PIL/ImageCms.py
@@ -704,12 +704,12 @@ def applyTransform(
     """
     (pyCMS) Applies a transform to a given image.
 
-    If ``im.mode != transform.inMode``, a :exc:`PyCMSError` is raised.
+    If ``im.mode != transform.input_mode``, a :exc:`PyCMSError` is raised.
 
-    If ``inPlace`` is ``True`` and ``transform.inMode != transform.outMode``, a
+    If ``inPlace`` is ``True`` and ``transform.input_mode != transform.output_mode``, a
     :exc:`PyCMSError` is raised.
 
-    If ``im.mode``, ``transform.inMode`` or ``transform.outMode`` is not
+    If ``im.mode``, ``transform.input_mode`` or ``transform.output_mode`` is not
     supported by pyCMSdll or the profiles you used for the transform, a
     :exc:`PyCMSError` is raised.
 
@@ -723,10 +723,10 @@ def applyTransform(
 
     If you want to modify im in-place instead of receiving a new image as
     the return value, set ``inPlace`` to ``True``.  This can only be done if
-    ``transform.inMode`` and ``transform.outMode`` are the same, because we can't
-    change the mode in-place (the buffer sizes for some modes are
+    ``transform.input_mode`` and ``transform.output_mode`` are the same, because we
+    can't change the mode in-place (the buffer sizes for some modes are
     different).  The default behavior is to return a new :py:class:`~PIL.Image.Image`
-    object of the same dimensions in mode ``transform.outMode``.
+    object of the same dimensions in mode ``transform.output_mode``.
 
     :param im: An :py:class:`~PIL.Image.Image` object, and im.mode must be the same
         as the ``inMode`` supported by the transform.

From 16ce3da0a4befe5c905da205962c18c2b1fe0ed9 Mon Sep 17 00:00:00 2001
From: Yay295 <Yay295@gmail.com>
Date: Mon, 1 Apr 2024 09:45:52 -0500
Subject: [PATCH 0466/1178] remove unused mode properties from
 CmsTransformObject/PIL.ImageCms.core.CmsTransform

---
 src/_imagingcms.c | 29 +++++------------------------
 1 file changed, 5 insertions(+), 24 deletions(-)

diff --git a/src/_imagingcms.c b/src/_imagingcms.c
index 84b8a7e71f9..b0ef2469c0a 100644
--- a/src/_imagingcms.c
+++ b/src/_imagingcms.c
@@ -181,8 +181,7 @@ cms_profile_dealloc(CmsProfileObject *self) {
 /* a transform represents the mapping between two profiles */
 
 typedef struct {
-    PyObject_HEAD char mode_in[8];
-    char mode_out[8];
+    PyObject_HEAD
     cmsHTRANSFORM transform;
 } CmsTransformObject;
 
@@ -191,7 +190,7 @@ static PyTypeObject CmsTransform_Type;
 #define CmsTransform_Check(op) (Py_TYPE(op) == &CmsTransform_Type)
 
 static PyObject *
-cms_transform_new(cmsHTRANSFORM transform, char *mode_in, char *mode_out) {
+cms_transform_new(cmsHTRANSFORM transform) {
     CmsTransformObject *self;
 
     self = PyObject_New(CmsTransformObject, &CmsTransform_Type);
@@ -201,9 +200,6 @@ cms_transform_new(cmsHTRANSFORM transform, char *mode_in, char *mode_out) {
 
     self->transform = transform;
 
-    strncpy(self->mode_in, mode_in, 8);
-    strncpy(self->mode_out, mode_out, 8);
-
     return (PyObject *)self;
 }
 
@@ -476,7 +472,7 @@ buildTransform(PyObject *self, PyObject *args) {
         return NULL;
     }
 
-    return cms_transform_new(transform, sInMode, sOutMode);
+    return cms_transform_new(transform);
 }
 
 static PyObject *
@@ -523,7 +519,7 @@ buildProofTransform(PyObject *self, PyObject *args) {
         return NULL;
     }
 
-    return cms_transform_new(transform, sInMode, sOutMode);
+    return cms_transform_new(transform);
 }
 
 static PyObject *
@@ -1456,21 +1452,6 @@ static struct PyMethodDef cms_transform_methods[] = {
     {"apply", (PyCFunction)cms_transform_apply, 1}, {NULL, NULL} /* sentinel */
 };
 
-static PyObject *
-cms_transform_getattr_inputMode(CmsTransformObject *self, void *closure) {
-    return PyUnicode_FromString(self->mode_in);
-}
-
-static PyObject *
-cms_transform_getattr_outputMode(CmsTransformObject *self, void *closure) {
-    return PyUnicode_FromString(self->mode_out);
-}
-
-static struct PyGetSetDef cms_transform_getsetters[] = {
-    {"inputMode", (getter)cms_transform_getattr_inputMode},
-    {"outputMode", (getter)cms_transform_getattr_outputMode},
-    {NULL}};
-
 static PyTypeObject CmsTransform_Type = {
     PyVarObject_HEAD_INIT(NULL, 0) "PIL.ImageCms.core.CmsTransform", /*tp_name*/
     sizeof(CmsTransformObject),                                      /*tp_basicsize*/
@@ -1501,7 +1482,7 @@ static PyTypeObject CmsTransform_Type = {
     0,                                 /*tp_iternext*/
     cms_transform_methods,             /*tp_methods*/
     0,                                 /*tp_members*/
-    cms_transform_getsetters,          /*tp_getset*/
+    0,                                 /*tp_getset*/
 };
 
 static int

From 7a9b57ce0896e2f95126cba22bbca184d1a677f0 Mon Sep 17 00:00:00 2001
From: Yay295 <Yay295@gmail.com>
Date: Mon, 1 Apr 2024 10:16:23 -0500
Subject: [PATCH 0467/1178] remove mode properties from CmsTransform interface

---
 src/PIL/_imagingcms.pyi | 4 ----
 1 file changed, 4 deletions(-)

diff --git a/src/PIL/_imagingcms.pyi b/src/PIL/_imagingcms.pyi
index 036521b0e5e..f704047be3f 100644
--- a/src/PIL/_imagingcms.pyi
+++ b/src/PIL/_imagingcms.pyi
@@ -108,10 +108,6 @@ class CmsProfile:
     def is_intent_supported(self, intent: int, direction: int, /) -> int: ...
 
 class CmsTransform:
-    @property
-    def inputMode(self) -> str: ...
-    @property
-    def outputMode(self) -> str: ...
     def apply(self, id_in: int, id_out: int) -> int: ...
 
 def profile_open(profile: str, /) -> CmsProfile: ...

From 793bb7fb6faf6029f995e6f53b6ecd03f07ff8c0 Mon Sep 17 00:00:00 2001
From: "pre-commit-ci[bot]"
 <66853113+pre-commit-ci[bot]@users.noreply.github.com>
Date: Mon, 1 Apr 2024 17:24:09 +0000
Subject: [PATCH 0468/1178] [pre-commit.ci] pre-commit autoupdate
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit

updates:
- [github.com/astral-sh/ruff-pre-commit: v0.2.0 → v0.3.4](https://github.com/astral-sh/ruff-pre-commit/compare/v0.2.0...v0.3.4)
- [github.com/psf/black-pre-commit-mirror: 24.1.1 → 24.3.0](https://github.com/psf/black-pre-commit-mirror/compare/24.1.1...24.3.0)
- [github.com/PyCQA/bandit: 1.7.7 → 1.7.8](https://github.com/PyCQA/bandit/compare/1.7.7...1.7.8)
- [github.com/Lucas-C/pre-commit-hooks: v1.5.4 → v1.5.5](https://github.com/Lucas-C/pre-commit-hooks/compare/v1.5.4...v1.5.5)
---
 .pre-commit-config.yaml | 8 ++++----
 1 file changed, 4 insertions(+), 4 deletions(-)

diff --git a/.pre-commit-config.yaml b/.pre-commit-config.yaml
index c52fdcb552d..7e3fd3e1841 100644
--- a/.pre-commit-config.yaml
+++ b/.pre-commit-config.yaml
@@ -1,24 +1,24 @@
 repos:
   - repo: https://github.com/astral-sh/ruff-pre-commit
-    rev: v0.2.0
+    rev: v0.3.4
     hooks:
       - id: ruff
         args: [--fix, --exit-non-zero-on-fix]
 
   - repo: https://github.com/psf/black-pre-commit-mirror
-    rev: 24.1.1
+    rev: 24.3.0
     hooks:
       - id: black
 
   - repo: https://github.com/PyCQA/bandit
-    rev: 1.7.7
+    rev: 1.7.8
     hooks:
     - id: bandit
       args: [--severity-level=high]
       files: ^src/
 
   - repo: https://github.com/Lucas-C/pre-commit-hooks
-    rev: v1.5.4
+    rev: v1.5.5
     hooks:
       - id: remove-tabs
         exclude: (Makefile$|\.bat$|\.cmake$|\.eps$|\.fits$|\.gd$|\.opt$)

From 88ddcde8d858b48a5361a2f00f3c989ab32c7f67 Mon Sep 17 00:00:00 2001
From: "pre-commit-ci[bot]"
 <66853113+pre-commit-ci[bot]@users.noreply.github.com>
Date: Mon, 1 Apr 2024 17:24:28 +0000
Subject: [PATCH 0469/1178] [pre-commit.ci] auto fixes from pre-commit.com
 hooks

for more information, see https://pre-commit.ci
---
 Tests/bench_cffi_access.py | 4 +---
 1 file changed, 1 insertion(+), 3 deletions(-)

diff --git a/Tests/bench_cffi_access.py b/Tests/bench_cffi_access.py
index c4ab3bdccb3..1d66b6636b1 100644
--- a/Tests/bench_cffi_access.py
+++ b/Tests/bench_cffi_access.py
@@ -32,9 +32,7 @@ def timer(func, label, *args) -> None:
             break
     endtime = time.time()
     print(
-        "{}: completed {} iterations in {:.4f}s, {:.6f}s per iteration".format(
-            label, x + 1, endtime - starttime, (endtime - starttime) / (x + 1.0)
-        )
+        f"{label}: completed {x + 1} iterations in {endtime - starttime:.4f}s, {(endtime - starttime) / (x + 1.0):.6f}s per iteration"
     )
 
 

From 97c6e46f34c53ad9780e32ce8b1978ad01bc2d5d Mon Sep 17 00:00:00 2001
From: Hugo van Kemenade <1324225+hugovk@users.noreply.github.com>
Date: Mon, 1 Apr 2024 20:49:19 +0300
Subject: [PATCH 0470/1178] Fix lint

---
 Tests/bench_cffi_access.py | 3 ++-
 1 file changed, 2 insertions(+), 1 deletion(-)

diff --git a/Tests/bench_cffi_access.py b/Tests/bench_cffi_access.py
index 1d66b6636b1..d2a08c07bc4 100644
--- a/Tests/bench_cffi_access.py
+++ b/Tests/bench_cffi_access.py
@@ -32,7 +32,8 @@ def timer(func, label, *args) -> None:
             break
     endtime = time.time()
     print(
-        f"{label}: completed {x + 1} iterations in {endtime - starttime:.4f}s, {(endtime - starttime) / (x + 1.0):.6f}s per iteration"
+        f"{label}: completed {x + 1} iterations in {endtime - starttime:.4f}s, "
+        f"{(endtime - starttime) / (x + 1.0):.6f}s per iteration"
     )
 
 

From 55b8f9126bd5b0dd11c6cbe76b6b91c0d7630f5b Mon Sep 17 00:00:00 2001
From: Hugo van Kemenade <1324225+hugovk@users.noreply.github.com>
Date: Mon, 1 Apr 2024 20:49:47 +0300
Subject: [PATCH 0471/1178] Move Ruff's fix=true up from pre-commit to
 pyproject

---
 .pre-commit-config.yaml | 2 +-
 pyproject.toml          | 3 +++
 2 files changed, 4 insertions(+), 1 deletion(-)

diff --git a/.pre-commit-config.yaml b/.pre-commit-config.yaml
index 7e3fd3e1841..c7156d93722 100644
--- a/.pre-commit-config.yaml
+++ b/.pre-commit-config.yaml
@@ -3,7 +3,7 @@ repos:
     rev: v0.3.4
     hooks:
       - id: ruff
-        args: [--fix, --exit-non-zero-on-fix]
+        args: [--exit-non-zero-on-fix]
 
   - repo: https://github.com/psf/black-pre-commit-mirror
     rev: 24.3.0
diff --git a/pyproject.toml b/pyproject.toml
index 740b0ebeac6..3ce082fb980 100644
--- a/pyproject.toml
+++ b/pyproject.toml
@@ -96,6 +96,9 @@ config-settings = "raqm=enable raqm=vendor fribidi=vendor imagequant=disable"
 test-command = "cd {project} && .github/workflows/wheels-test.sh"
 test-extras = "tests"
 
+[tool.ruff]
+fix = true
+
 [tool.ruff.lint]
 select = [
   "C4", # flake8-comprehensions

From 78670404862642a37d9895af56ba2003165f6871 Mon Sep 17 00:00:00 2001
From: Hugo van Kemenade <1324225+hugovk@users.noreply.github.com>
Date: Mon, 1 Apr 2024 20:55:19 +0300
Subject: [PATCH 0472/1178] Check GHA, RTD and Renovate config with pre-commit

---
 .pre-commit-config.yaml | 12 ++++++++++++
 1 file changed, 12 insertions(+)

diff --git a/.pre-commit-config.yaml b/.pre-commit-config.yaml
index c7156d93722..51625eb4c89 100644
--- a/.pre-commit-config.yaml
+++ b/.pre-commit-config.yaml
@@ -42,6 +42,13 @@ repos:
       - id: trailing-whitespace
         exclude: ^.github/.*TEMPLATE|^Tests/(fonts|images)/
 
+  - repo: https://github.com/python-jsonschema/check-jsonschema
+    rev: 0.28.1
+    hooks:
+      - id: check-github-workflows
+      - id: check-readthedocs
+      - id: check-renovate
+
   - repo: https://github.com/sphinx-contrib/sphinx-lint
     rev: v0.9.1
     hooks:
@@ -62,5 +69,10 @@ repos:
     hooks:
       - id: tox-ini-fmt
 
+  - repo: meta
+    hooks:
+      - id: check-hooks-apply
+      - id: check-useless-excludes
+
 ci:
   autoupdate_schedule: monthly

From b37279a29cf29a66f86a99de6ce46d6226999c75 Mon Sep 17 00:00:00 2001
From: jbjd <jimdemetris@yahoo.com>
Date: Mon, 1 Apr 2024 20:09:02 -0500
Subject: [PATCH 0473/1178] fix parameter name in ImageMath docs

---
 docs/reference/ImageMath.rst | 4 ++--
 1 file changed, 2 insertions(+), 2 deletions(-)

diff --git a/docs/reference/ImageMath.rst b/docs/reference/ImageMath.rst
index 703b2f5b943..2535db7113c 100644
--- a/docs/reference/ImageMath.rst
+++ b/docs/reference/ImageMath.rst
@@ -31,7 +31,7 @@ Example: Using the :py:mod:`~PIL.ImageMath` module
               b=im2
             )
 
-.. py:function:: lambda_eval(expression, environment)
+.. py:function:: lambda_eval(expression, options)
 
     Returns the result of an image function.
 
@@ -44,7 +44,7 @@ Example: Using the :py:mod:`~PIL.ImageMath` module
     :return: An image, an integer value, a floating point value,
              or a pixel tuple, depending on the expression.
 
-.. py:function:: unsafe_eval(expression, environment)
+.. py:function:: unsafe_eval(expression, options)
 
     Evaluates an image expression.
 

From 75454646f4bd3eb21e4585702286e8e8841cdc89 Mon Sep 17 00:00:00 2001
From: Andrew Murray <radarhere@users.noreply.github.com>
Date: Tue, 2 Apr 2024 15:34:46 +1100
Subject: [PATCH 0474/1178] Moved code onto single line

---
 src/_imagingcms.c | 3 +--
 1 file changed, 1 insertion(+), 2 deletions(-)

diff --git a/src/_imagingcms.c b/src/_imagingcms.c
index b0ef2469c0a..fd487d9da8a 100644
--- a/src/_imagingcms.c
+++ b/src/_imagingcms.c
@@ -181,8 +181,7 @@ cms_profile_dealloc(CmsProfileObject *self) {
 /* a transform represents the mapping between two profiles */
 
 typedef struct {
-    PyObject_HEAD
-    cmsHTRANSFORM transform;
+    PyObject_HEAD cmsHTRANSFORM transform;
 } CmsTransformObject;
 
 static PyTypeObject CmsTransform_Type;

From 38e81126508974b506d6d61914f5efd303958760 Mon Sep 17 00:00:00 2001
From: Andrew Murray <radarhere@users.noreply.github.com>
Date: Tue, 2 Apr 2024 17:58:49 +1100
Subject: [PATCH 0475/1178] Updated macOS tested Pillow versions

---
 docs/installation/platform-support.rst | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/docs/installation/platform-support.rst b/docs/installation/platform-support.rst
index 59fc312ab0b..bc60eeed445 100644
--- a/docs/installation/platform-support.rst
+++ b/docs/installation/platform-support.rst
@@ -81,7 +81,7 @@ These platforms have been reported to work at the versions mentioned.
 | Operating system                 | | Tested Python            | | Latest tested  | | Tested     |
 |                                  | | versions                 | | Pillow version | | processors |
 +==================================+============================+==================+==============+
-| macOS 14 Sonoma                  | 3.8, 3.9, 3.10, 3.11, 3.12 | 10.2.0           |arm           |
+| macOS 14 Sonoma                  | 3.8, 3.9, 3.10, 3.11, 3.12 | 10.3.0           |arm           |
 +----------------------------------+----------------------------+------------------+--------------+
 | macOS 13 Ventura                 | 3.8, 3.9, 3.10, 3.11       | 10.0.1           |arm           |
 |                                  +----------------------------+------------------+              |

From 4915f19b1370c17036cb3f4c3cbe12bbf23bc43c Mon Sep 17 00:00:00 2001
From: "Adam J. Stewart" <ajstewart426@gmail.com>
Date: Tue, 2 Apr 2024 17:45:06 +0200
Subject: [PATCH 0476/1178] fromarray: add type hints

---
 src/PIL/Image.py | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/src/PIL/Image.py b/src/PIL/Image.py
index baef0aa112e..0dfccd9b030 100644
--- a/src/PIL/Image.py
+++ b/src/PIL/Image.py
@@ -3069,7 +3069,7 @@ def frombuffer(mode, size, data, decoder_name="raw", *args):
     return frombytes(mode, size, data, decoder_name, args)
 
 
-def fromarray(obj, mode=None):
+def fromarray(obj: "numpy.typing.ArrayLike", mode: Optional[str] = None) -> Image:
     """
     Creates an image memory from an object exporting the array interface
     (using the buffer protocol)::

From 8e47a6f2c82b696f6b96bb8fff350a937ea195b9 Mon Sep 17 00:00:00 2001
From: "pre-commit-ci[bot]"
 <66853113+pre-commit-ci[bot]@users.noreply.github.com>
Date: Tue, 2 Apr 2024 15:46:25 +0000
Subject: [PATCH 0477/1178] [pre-commit.ci] auto fixes from pre-commit.com
 hooks

for more information, see https://pre-commit.ci
---
 src/PIL/Image.py | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/src/PIL/Image.py b/src/PIL/Image.py
index 0dfccd9b030..a2723756fef 100644
--- a/src/PIL/Image.py
+++ b/src/PIL/Image.py
@@ -3069,7 +3069,7 @@ def frombuffer(mode, size, data, decoder_name="raw", *args):
     return frombytes(mode, size, data, decoder_name, args)
 
 
-def fromarray(obj: "numpy.typing.ArrayLike", mode: Optional[str] = None) -> Image:
+def fromarray(obj: numpy.typing.ArrayLike, mode: Optional[str] = None) -> Image:
     """
     Creates an image memory from an object exporting the array interface
     (using the buffer protocol)::

From 37ed8c337de3617bb0b17b721c0cef08e502dc3b Mon Sep 17 00:00:00 2001
From: "Adam J. Stewart" <ajstewart426@gmail.com>
Date: Tue, 2 Apr 2024 17:53:11 +0200
Subject: [PATCH 0478/1178] Try type comment

---
 src/PIL/Image.py | 7 +++++--
 1 file changed, 5 insertions(+), 2 deletions(-)

diff --git a/src/PIL/Image.py b/src/PIL/Image.py
index a2723756fef..c932f1932ac 100644
--- a/src/PIL/Image.py
+++ b/src/PIL/Image.py
@@ -41,7 +41,7 @@
 from collections.abc import Callable, MutableMapping
 from enum import IntEnum
 from types import ModuleType
-from typing import IO, TYPE_CHECKING, Any
+from typing import IO, Optional, TYPE_CHECKING, Any
 
 # VERSION was removed in Pillow 6.0.0.
 # PILLOW_VERSION was removed in Pillow 9.0.0.
@@ -3069,7 +3069,10 @@ def frombuffer(mode, size, data, decoder_name="raw", *args):
     return frombytes(mode, size, data, decoder_name, args)
 
 
-def fromarray(obj: numpy.typing.ArrayLike, mode: Optional[str] = None) -> Image:
+def fromarray(
+    obj,  # type: numpy.typing.ArrayLike
+    mode: Optional[str] = None
+) -> Image:
     """
     Creates an image memory from an object exporting the array interface
     (using the buffer protocol)::

From 8a63980e393e0ffc9fc9ae4337d97b5bbfb95524 Mon Sep 17 00:00:00 2001
From: "pre-commit-ci[bot]"
 <66853113+pre-commit-ci[bot]@users.noreply.github.com>
Date: Tue, 2 Apr 2024 15:53:39 +0000
Subject: [PATCH 0479/1178] [pre-commit.ci] auto fixes from pre-commit.com
 hooks

for more information, see https://pre-commit.ci
---
 src/PIL/Image.py | 4 ++--
 1 file changed, 2 insertions(+), 2 deletions(-)

diff --git a/src/PIL/Image.py b/src/PIL/Image.py
index c932f1932ac..a4043c620d0 100644
--- a/src/PIL/Image.py
+++ b/src/PIL/Image.py
@@ -41,7 +41,7 @@
 from collections.abc import Callable, MutableMapping
 from enum import IntEnum
 from types import ModuleType
-from typing import IO, Optional, TYPE_CHECKING, Any
+from typing import IO, TYPE_CHECKING, Any, Optional
 
 # VERSION was removed in Pillow 6.0.0.
 # PILLOW_VERSION was removed in Pillow 9.0.0.
@@ -3071,7 +3071,7 @@ def frombuffer(mode, size, data, decoder_name="raw", *args):
 
 def fromarray(
     obj,  # type: numpy.typing.ArrayLike
-    mode: Optional[str] = None
+    mode: Optional[str] = None,
 ) -> Image:
     """
     Creates an image memory from an object exporting the array interface

From 5d19151cd31951754dc284db7434c4e6e7fbc240 Mon Sep 17 00:00:00 2001
From: "Adam J. Stewart" <ajstewart426@gmail.com>
Date: Tue, 2 Apr 2024 17:56:52 +0200
Subject: [PATCH 0480/1178] Python 3.10+

---
 src/PIL/Image.py | 4 ++--
 1 file changed, 2 insertions(+), 2 deletions(-)

diff --git a/src/PIL/Image.py b/src/PIL/Image.py
index a4043c620d0..245fadd6b3f 100644
--- a/src/PIL/Image.py
+++ b/src/PIL/Image.py
@@ -41,7 +41,7 @@
 from collections.abc import Callable, MutableMapping
 from enum import IntEnum
 from types import ModuleType
-from typing import IO, TYPE_CHECKING, Any, Optional
+from typing import IO, TYPE_CHECKING, Any
 
 # VERSION was removed in Pillow 6.0.0.
 # PILLOW_VERSION was removed in Pillow 9.0.0.
@@ -3071,7 +3071,7 @@ def frombuffer(mode, size, data, decoder_name="raw", *args):
 
 def fromarray(
     obj,  # type: numpy.typing.ArrayLike
-    mode: Optional[str] = None,
+    mode: str | None = None,
 ) -> Image:
     """
     Creates an image memory from an object exporting the array interface

From 8c57cd56a5107fe8957f8a753dbe15f3da33e5d9 Mon Sep 17 00:00:00 2001
From: Andrew Murray <radarhere@users.noreply.github.com>
Date: Wed, 3 Apr 2024 12:00:02 +1100
Subject: [PATCH 0481/1178] QoiImagePlugin uses PyDecoder

---
 docs/handbook/image-file-formats.rst | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/docs/handbook/image-file-formats.rst b/docs/handbook/image-file-formats.rst
index f3f0499f052..c171705c287 100644
--- a/docs/handbook/image-file-formats.rst
+++ b/docs/handbook/image-file-formats.rst
@@ -1488,7 +1488,7 @@ QOI
 
 .. versionadded:: 9.5.0
 
-Pillow identifies and reads images in Quite OK Image format.
+Pillow reads images in Quite OK Image format, using a Python decoder.
 
 SUN
 ^^^

From a6793bba5e4a3c0e102359545507828966960cc1 Mon Sep 17 00:00:00 2001
From: Andrew Murray <radarhere@users.noreply.github.com>
Date: Wed, 3 Apr 2024 12:19:45 +1100
Subject: [PATCH 0482/1178] Updated pattern for skipping builds based on file
 changes

---
 .appveyor.yml | 6 +++---
 1 file changed, 3 insertions(+), 3 deletions(-)

diff --git a/.appveyor.yml b/.appveyor.yml
index 6f35a0190d4..57a8fa5a06d 100644
--- a/.appveyor.yml
+++ b/.appveyor.yml
@@ -1,9 +1,9 @@
 skip_commits:
   files:
-    - ".github/**"
+    - ".github/**/*"
     - ".gitmodules"
-    - "docs/**"
-    - "wheels/**"
+    - "docs/**/*"
+    - "wheels/**/*"
 
 version: '{build}'
 clone_folder: c:\pillow

From e85a84baa7ebee1b458cabbeb23b8d497c735175 Mon Sep 17 00:00:00 2001
From: Andrew Murray <radarhere@users.noreply.github.com>
Date: Wed, 3 Apr 2024 20:00:40 +1100
Subject: [PATCH 0483/1178] Added SupportsArrayInterface

---
 Tests/test_image_array.py | 10 ++++++++++
 docs/reference/Image.rst  |  2 ++
 src/PIL/Image.py          | 22 +++++++++++++++-------
 3 files changed, 27 insertions(+), 7 deletions(-)

diff --git a/Tests/test_image_array.py b/Tests/test_image_array.py
index cf85ee4fa1c..342bd8654e1 100644
--- a/Tests/test_image_array.py
+++ b/Tests/test_image_array.py
@@ -91,6 +91,16 @@ def test(mode: str) -> tuple[str, tuple[int, int], bool]:
         Image.fromarray(wrapped)
 
 
+def test_fromarray_strides_without_tobytes() -> None:
+    class Wrapper:
+        def __init__(self, arr_params: dict[str, Any]) -> None:
+            self.__array_interface__ = arr_params
+
+    with pytest.raises(ValueError):
+        wrapped = Wrapper({"shape": (1, 1), "strides": (1, 1)})
+        Image.fromarray(wrapped, "L")
+
+
 def test_fromarray_palette() -> None:
     # Arrange
     i = im.convert("L")
diff --git a/docs/reference/Image.rst b/docs/reference/Image.rst
index 4281b182ce7..0d9b4d93d77 100644
--- a/docs/reference/Image.rst
+++ b/docs/reference/Image.rst
@@ -78,6 +78,8 @@ Constructing images
 ^^^^^^^^^^^^^^^^^^^
 
 .. autofunction:: new
+.. autoclass:: SupportsArrayInterface
+    :show-inheritance:
 .. autofunction:: fromarray
 .. autofunction:: frombytes
 .. autofunction:: frombuffer
diff --git a/src/PIL/Image.py b/src/PIL/Image.py
index 245fadd6b3f..7e68ee3cb40 100644
--- a/src/PIL/Image.py
+++ b/src/PIL/Image.py
@@ -41,7 +41,7 @@
 from collections.abc import Callable, MutableMapping
 from enum import IntEnum
 from types import ModuleType
-from typing import IO, TYPE_CHECKING, Any
+from typing import IO, TYPE_CHECKING, Any, Protocol
 
 # VERSION was removed in Pillow 6.0.0.
 # PILLOW_VERSION was removed in Pillow 9.0.0.
@@ -3013,7 +3013,7 @@ def frombytes(mode, size, data, decoder_name="raw", *args) -> Image:
     return im
 
 
-def frombuffer(mode, size, data, decoder_name="raw", *args):
+def frombuffer(mode, size, data, decoder_name="raw", *args) -> Image:
     """
     Creates an image memory referencing pixel data in a byte buffer.
 
@@ -3069,10 +3069,15 @@ def frombuffer(mode, size, data, decoder_name="raw", *args):
     return frombytes(mode, size, data, decoder_name, args)
 
 
-def fromarray(
-    obj,  # type: numpy.typing.ArrayLike
-    mode: str | None = None,
-) -> Image:
+class SupportsArrayInterface(Protocol):
+    """
+    An object that has an ``__array_interface__`` dictionary.
+    """
+
+    __array_interface__: dict[str, Any]
+
+
+def fromarray(obj: SupportsArrayInterface, mode: str | None = None) -> Image:
     """
     Creates an image memory from an object exporting the array interface
     (using the buffer protocol)::
@@ -3151,8 +3156,11 @@ def fromarray(
     if strides is not None:
         if hasattr(obj, "tobytes"):
             obj = obj.tobytes()
-        else:
+        elif hasattr(obj, "tostring"):
             obj = obj.tostring()
+        else:
+            msg = "'strides' requires either tobytes() or tostring()"
+            raise ValueError(msg)
 
     return frombuffer(mode, size, obj, "raw", rawmode, 0, 1)
 

From 0cc5de4e0949b8e5ef810465cde7332bde825c72 Mon Sep 17 00:00:00 2001
From: Andrew Murray <radarhere@users.noreply.github.com>
Date: Thu, 4 Apr 2024 12:17:02 +1100
Subject: [PATCH 0484/1178] Link to https://pypi.org/project/qoi

---
 docs/handbook/image-file-formats.rst | 4 +++-
 1 file changed, 3 insertions(+), 1 deletion(-)

diff --git a/docs/handbook/image-file-formats.rst b/docs/handbook/image-file-formats.rst
index c171705c287..bff056b75d7 100644
--- a/docs/handbook/image-file-formats.rst
+++ b/docs/handbook/image-file-formats.rst
@@ -1488,7 +1488,9 @@ QOI
 
 .. versionadded:: 9.5.0
 
-Pillow reads images in Quite OK Image format, using a Python decoder.
+Pillow reads images in Quite OK Image format, using a Python decoder. If you wish to
+write code specifically for this format, https://pypi.org/project/qoi is an alternative
+library that uses C to decode the image, and interfaces with NumPy.
 
 SUN
 ^^^

From 8c14a394c1d3ca9c06f356ebfbf2acaa634da25e Mon Sep 17 00:00:00 2001
From: Nulano <nulano@nulano.eu>
Date: Thu, 4 Apr 2024 19:54:07 +0200
Subject: [PATCH 0485/1178] add type hints for Image.open and Image.init

---
 src/PIL/Image.py | 40 ++++++++++++++++++++++++++--------------
 1 file changed, 26 insertions(+), 14 deletions(-)

diff --git a/src/PIL/Image.py b/src/PIL/Image.py
index baef0aa112e..09ddc770f28 100644
--- a/src/PIL/Image.py
+++ b/src/PIL/Image.py
@@ -41,7 +41,7 @@
 from collections.abc import Callable, MutableMapping
 from enum import IntEnum
 from types import ModuleType
-from typing import IO, TYPE_CHECKING, Any
+from typing import IO, TYPE_CHECKING, Any, Literal, cast
 
 # VERSION was removed in Pillow 6.0.0.
 # PILLOW_VERSION was removed in Pillow 9.0.0.
@@ -55,7 +55,7 @@
     _plugins,
 )
 from ._binary import i32le, o32be, o32le
-from ._typing import TypeGuard
+from ._typing import StrOrBytesPath, TypeGuard
 from ._util import DeferredError, is_path
 
 ElementTree: ModuleType | None
@@ -357,7 +357,7 @@ def preinit() -> None:
     _initialized = 1
 
 
-def init():
+def init() -> bool:
     """
     Explicitly initializes the Python Imaging Library. This function
     loads all available file format drivers.
@@ -368,7 +368,7 @@ def init():
 
     global _initialized
     if _initialized >= 2:
-        return 0
+        return False
 
     parent_name = __name__.rpartition(".")[0]
     for plugin in _plugins:
@@ -380,7 +380,8 @@ def init():
 
     if OPEN or SAVE:
         _initialized = 2
-        return 1
+        return True
+    return False
 
 
 # --------------------------------------------------------------------
@@ -3222,7 +3223,11 @@ def _decompression_bomb_check(size: tuple[int, int]) -> None:
         )
 
 
-def open(fp, mode="r", formats=None) -> Image:
+def open(
+    fp: StrOrBytesPath | IO[bytes],
+    mode: Literal["r"] = "r",
+    formats: list[str] | tuple[str, ...] | None = None,
+) -> ImageFile.ImageFile:
     """
     Opens and identifies the given image file.
 
@@ -3253,10 +3258,10 @@ def open(fp, mode="r", formats=None) -> Image:
     """
 
     if mode != "r":
-        msg = f"bad mode {repr(mode)}"
+        msg = f"bad mode {repr(mode)}"  # type: ignore[unreachable]
         raise ValueError(msg)
     elif isinstance(fp, io.StringIO):
-        msg = (
+        msg = (  # type: ignore[unreachable]
             "StringIO cannot be used to open an image. "
             "Binary data must be used instead."
         )
@@ -3265,7 +3270,7 @@ def open(fp, mode="r", formats=None) -> Image:
     if formats is None:
         formats = ID
     elif not isinstance(formats, (list, tuple)):
-        msg = "formats must be a list or tuple"
+        msg = "formats must be a list or tuple"  # type: ignore[unreachable]
         raise TypeError(msg)
 
     exclusive_fp = False
@@ -3276,6 +3281,8 @@ def open(fp, mode="r", formats=None) -> Image:
     if filename:
         fp = builtins.open(filename, "rb")
         exclusive_fp = True
+    else:
+        fp = cast(IO[bytes], fp)
 
     try:
         fp.seek(0)
@@ -3287,9 +3294,14 @@ def open(fp, mode="r", formats=None) -> Image:
 
     preinit()
 
-    accept_warnings = []
+    accept_warnings: list[str | bytes] = []
 
-    def _open_core(fp, filename, prefix, formats):
+    def _open_core(
+        fp: IO[bytes],
+        filename: str | bytes,
+        prefix: bytes,
+        formats: list[str] | tuple[str, ...],
+    ) -> ImageFile.ImageFile | None:
         for i in formats:
             i = i.upper()
             if i not in OPEN:
@@ -3298,7 +3310,7 @@ def _open_core(fp, filename, prefix, formats):
                 factory, accept = OPEN[i]
                 result = not accept or accept(prefix)
                 if type(result) in [str, bytes]:
-                    accept_warnings.append(result)
+                    accept_warnings.append(result)  # type: ignore[arg-type]
                 elif result:
                     fp.seek(0)
                     im = factory(fp, filename)
@@ -3318,7 +3330,7 @@ def _open_core(fp, filename, prefix, formats):
     im = _open_core(fp, filename, prefix, formats)
 
     if im is None and formats is ID:
-        checked_formats = formats.copy()
+        checked_formats = ID.copy()
         if init():
             im = _open_core(
                 fp,
@@ -3334,7 +3346,7 @@ def _open_core(fp, filename, prefix, formats):
     if exclusive_fp:
         fp.close()
     for message in accept_warnings:
-        warnings.warn(message)
+        warnings.warn(message)  # type: ignore[arg-type]
     msg = "cannot identify image file %r" % (filename if filename else fp)
     raise UnidentifiedImageError(msg)
 

From 2a2588d5df13c329d442b613960bc0ba7e606543 Mon Sep 17 00:00:00 2001
From: Andrew Murray <3112309+radarhere@users.noreply.github.com>
Date: Fri, 5 Apr 2024 05:09:11 +1100
Subject: [PATCH 0486/1178] Use extlink

Co-authored-by: Hugo van Kemenade <1324225+hugovk@users.noreply.github.com>
---
 docs/handbook/image-file-formats.rst | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/docs/handbook/image-file-formats.rst b/docs/handbook/image-file-formats.rst
index bff056b75d7..fbef08bcecc 100644
--- a/docs/handbook/image-file-formats.rst
+++ b/docs/handbook/image-file-formats.rst
@@ -1489,7 +1489,7 @@ QOI
 .. versionadded:: 9.5.0
 
 Pillow reads images in Quite OK Image format, using a Python decoder. If you wish to
-write code specifically for this format, https://pypi.org/project/qoi is an alternative
+write code specifically for this format, :pypi:`qoi` is an alternative
 library that uses C to decode the image, and interfaces with NumPy.
 
 SUN

From 0702f704fa147ea583eb61ca01280c9e59665264 Mon Sep 17 00:00:00 2001
From: Andrew Murray <3112309+radarhere@users.noreply.github.com>
Date: Fri, 5 Apr 2024 05:16:41 +1100
Subject: [PATCH 0487/1178] Remove commas
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit

Co-authored-by: Ondrej Baranovič <ondreko.tiba@gmail.com>
---
 docs/handbook/image-file-formats.rst | 4 ++--
 1 file changed, 2 insertions(+), 2 deletions(-)

diff --git a/docs/handbook/image-file-formats.rst b/docs/handbook/image-file-formats.rst
index fbef08bcecc..06716255bff 100644
--- a/docs/handbook/image-file-formats.rst
+++ b/docs/handbook/image-file-formats.rst
@@ -1488,9 +1488,9 @@ QOI
 
 .. versionadded:: 9.5.0
 
-Pillow reads images in Quite OK Image format, using a Python decoder. If you wish to
+Pillow reads images in Quite OK Image format using a Python decoder. If you wish to
 write code specifically for this format, :pypi:`qoi` is an alternative
-library that uses C to decode the image, and interfaces with NumPy.
+library that uses C to decode the image and interfaces with NumPy.
 
 SUN
 ^^^

From 059b8e91717c04e2827a937c1c5bfd7d5d947548 Mon Sep 17 00:00:00 2001
From: Andrew Murray <radarhere@users.noreply.github.com>
Date: Fri, 5 Apr 2024 06:52:36 +1100
Subject: [PATCH 0488/1178] Updated line formatting

---
 docs/handbook/image-file-formats.rst | 4 ++--
 1 file changed, 2 insertions(+), 2 deletions(-)

diff --git a/docs/handbook/image-file-formats.rst b/docs/handbook/image-file-formats.rst
index 06716255bff..1ec97214900 100644
--- a/docs/handbook/image-file-formats.rst
+++ b/docs/handbook/image-file-formats.rst
@@ -1489,8 +1489,8 @@ QOI
 .. versionadded:: 9.5.0
 
 Pillow reads images in Quite OK Image format using a Python decoder. If you wish to
-write code specifically for this format, :pypi:`qoi` is an alternative
-library that uses C to decode the image and interfaces with NumPy.
+write code specifically for this format, :pypi:`qoi` is an alternative library that
+uses C to decode the image and interfaces with NumPy.
 
 SUN
 ^^^

From 819e1b9dd2bfeb6455524053b6d76b65d77bd66c Mon Sep 17 00:00:00 2001
From: Nulano <nulano@nulano.eu>
Date: Thu, 4 Apr 2024 23:38:50 +0200
Subject: [PATCH 0489/1178] add type hints for Image.save

---
 src/PIL/Image.py | 6 +++++-
 1 file changed, 5 insertions(+), 1 deletion(-)

diff --git a/src/PIL/Image.py b/src/PIL/Image.py
index 09ddc770f28..8bae2974c11 100644
--- a/src/PIL/Image.py
+++ b/src/PIL/Image.py
@@ -2374,7 +2374,9 @@ def transform(x, y, matrix):
             (w, h), Transform.AFFINE, matrix, resample, fillcolor=fillcolor
         )
 
-    def save(self, fp, format=None, **params) -> None:
+    def save(
+        self, fp: StrOrBytesPath | IO[bytes], format: str | None = None, **params: Any
+    ) -> None:
         """
         Saves this image under the given filename.  If no format is
         specified, the format to use is determined from the filename
@@ -2455,6 +2457,8 @@ def save(self, fp, format=None, **params) -> None:
                 fp = builtins.open(filename, "r+b")
             else:
                 fp = builtins.open(filename, "w+b")
+        else:
+            fp = cast(IO[bytes], fp)
 
         try:
             save_handler(self, fp, filename)

From c61a4810289e6283e2d20cc5d4941f4c57b19a64 Mon Sep 17 00:00:00 2001
From: Andrew Murray <radarhere@users.noreply.github.com>
Date: Sat, 6 Apr 2024 13:40:39 +1100
Subject: [PATCH 0490/1178] Support reading CMYK JPEG2000 images

---
 Tests/test_file_jpeg2k.py     | 10 ++++++++++
 src/PIL/Jpeg2KImagePlugin.py  |  4 ++++
 src/libImaging/Jpeg2KDecode.c |  1 +
 3 files changed, 15 insertions(+)

diff --git a/Tests/test_file_jpeg2k.py b/Tests/test_file_jpeg2k.py
index 81f75cc72cf..a7cae563adb 100644
--- a/Tests/test_file_jpeg2k.py
+++ b/Tests/test_file_jpeg2k.py
@@ -289,6 +289,16 @@ def test_rgba(ext: str) -> None:
         assert im.mode == "RGBA"
 
 
+@pytest.mark.skipif(
+    not os.path.exists(EXTRA_DIR), reason="Extra image files not installed"
+)
+@skip_unless_feature_version("jpg_2000", "2.5.1")
+def test_cmyk() -> None:
+    with Image.open(f"{EXTRA_DIR}/issue205.jp2") as im:
+        assert im.mode == "CMYK"
+        assert im.getpixel((0, 0)) == (185, 134, 0, 0)
+
+
 @pytest.mark.parametrize("ext", (".j2k", ".jp2"))
 def test_16bit_monochrome_has_correct_mode(ext: str) -> None:
     with Image.open("Tests/images/16bit.cropped" + ext) as im:
diff --git a/src/PIL/Jpeg2KImagePlugin.py b/src/PIL/Jpeg2KImagePlugin.py
index be000c351b6..51b29bca2c9 100644
--- a/src/PIL/Jpeg2KImagePlugin.py
+++ b/src/PIL/Jpeg2KImagePlugin.py
@@ -176,6 +176,10 @@ def _parse_jp2_header(fp):
                 mode = "RGB"
             elif nc == 4:
                 mode = "RGBA"
+        elif tbox == b"colr" and nc == 4:
+            meth, _, _, enumcs = header.read_fields(">BBBI")
+            if meth == 1 and enumcs == 12:
+                mode = "CMYK"
         elif tbox == b"pclr" and mode in ("L", "LA"):
             ne, npc = header.read_fields(">HB")
             bitdepths = header.read_fields(">" + ("B" * npc))
diff --git a/src/libImaging/Jpeg2KDecode.c b/src/libImaging/Jpeg2KDecode.c
index 13f363422da..78a09bb8333 100644
--- a/src/libImaging/Jpeg2KDecode.c
+++ b/src/libImaging/Jpeg2KDecode.c
@@ -632,6 +632,7 @@ static const struct j2k_decode_unpacker j2k_unpackers[] = {
     {"RGBA", OPJ_CLRSPC_SYCC, 3, 1, j2ku_sycc_rgb},
     {"RGBA", OPJ_CLRSPC_SRGB, 4, 1, j2ku_srgba_rgba},
     {"RGBA", OPJ_CLRSPC_SYCC, 4, 1, j2ku_sycca_rgba},
+    {"CMYK", OPJ_CLRSPC_CMYK, 4, 1, j2ku_srgba_rgba},
 };
 
 /* -------------------------------------------------------------------- */

From 1c2a323a90fabf8cedb4229c8864aac8d6a24ed5 Mon Sep 17 00:00:00 2001
From: Andrew Murray <radarhere@users.noreply.github.com>
Date: Sat, 6 Apr 2024 15:18:43 +1100
Subject: [PATCH 0491/1178] Corrected variable name

---
 src/PIL/ImageCms.py | 4 ++--
 1 file changed, 2 insertions(+), 2 deletions(-)

diff --git a/src/PIL/ImageCms.py b/src/PIL/ImageCms.py
index 162db628c8a..4af1b79e2e3 100644
--- a/src/PIL/ImageCms.py
+++ b/src/PIL/ImageCms.py
@@ -728,8 +728,8 @@ def applyTransform(
     different).  The default behavior is to return a new :py:class:`~PIL.Image.Image`
     object of the same dimensions in mode ``transform.output_mode``.
 
-    :param im: An :py:class:`~PIL.Image.Image` object, and im.mode must be the same
-        as the ``inMode`` supported by the transform.
+    :param im: An :py:class:`~PIL.Image.Image` object, and ``im.mode`` must be the same
+        as the ``input_mode`` supported by the transform.
     :param transform: A valid CmsTransform class object
     :param inPlace: Bool.  If ``True``, ``im`` is modified in place and ``None`` is
         returned, if ``False``, a new :py:class:`~PIL.Image.Image` object with the

From 7eee479ce5f52e0aec8e08f9380ec528bda84c72 Mon Sep 17 00:00:00 2001
From: Andrew Murray <radarhere@users.noreply.github.com>
Date: Sat, 6 Apr 2024 14:28:33 +1100
Subject: [PATCH 0492/1178] Corrected indentation

---
 src/_imagingcms.c | 4 ++--
 1 file changed, 2 insertions(+), 2 deletions(-)

diff --git a/src/_imagingcms.c b/src/_imagingcms.c
index fd487d9da8a..f18d55a5718 100644
--- a/src/_imagingcms.c
+++ b/src/_imagingcms.c
@@ -390,7 +390,7 @@ _buildTransform(
 
     Py_END_ALLOW_THREADS
 
-        if (!hTransform) {
+    if (!hTransform) {
         PyErr_SetString(PyExc_ValueError, "cannot build transform");
     }
 
@@ -424,7 +424,7 @@ _buildProofTransform(
 
     Py_END_ALLOW_THREADS
 
-        if (!hTransform) {
+    if (!hTransform) {
         PyErr_SetString(PyExc_ValueError, "cannot build proof transform");
     }
 

From 2245df0ac30976960781f291bc45a2ad56cee064 Mon Sep 17 00:00:00 2001
From: Andrew Murray <radarhere@users.noreply.github.com>
Date: Sat, 6 Apr 2024 20:59:06 +1100
Subject: [PATCH 0493/1178] Only preserve IPTC_NAA_CHUNK tag if type is BYTE or
 UNDEFINED

---
 Tests/test_file_tiff.py    | 13 +++++++++++++
 src/PIL/TiffImagePlugin.py | 30 ++++++++++++++++++------------
 2 files changed, 31 insertions(+), 12 deletions(-)

diff --git a/Tests/test_file_tiff.py b/Tests/test_file_tiff.py
index 8821fb46a84..0bc1e2d0e6b 100644
--- a/Tests/test_file_tiff.py
+++ b/Tests/test_file_tiff.py
@@ -621,6 +621,19 @@ def test_roundtrip_tiff_uint16(self, tmp_path: Path) -> None:
 
             assert_image_equal_tofile(im, tmpfile)
 
+    def test_iptc(self, tmp_path: Path) -> None:
+        # Do not preserve IPTC_NAA_CHUNK by default if type is LONG
+        outfile = str(tmp_path / "temp.tif")
+        im = hopper()
+        ifd = TiffImagePlugin.ImageFileDirectory_v2()
+        ifd[33723] = 1
+        ifd.tagtype[33723] = 4
+        im.tag_v2 = ifd
+        im.save(outfile)
+
+        with Image.open(outfile) as im:
+            assert 33723 not in im.tag_v2
+
     def test_rowsperstrip(self, tmp_path: Path) -> None:
         outfile = str(tmp_path / "temp.tif")
         im = hopper()
diff --git a/src/PIL/TiffImagePlugin.py b/src/PIL/TiffImagePlugin.py
index 8bfcd29075e..c3683efb35e 100644
--- a/src/PIL/TiffImagePlugin.py
+++ b/src/PIL/TiffImagePlugin.py
@@ -1653,6 +1653,16 @@ def _save(im, fp, filename):
         except Exception:
             pass  # might not be an IFD. Might not have populated type
 
+    legacy_ifd = {}
+    if hasattr(im, "tag"):
+        legacy_ifd = im.tag.to_v2()
+
+    supplied_tags = {**legacy_ifd, **getattr(im, "tag_v2", {})}
+    if SAMPLEFORMAT in supplied_tags:
+        # SAMPLEFORMAT is determined by the image format and should not be copied
+        # from legacy_ifd.
+        del supplied_tags[SAMPLEFORMAT]
+
     # additions written by Greg Couch, gregc@cgl.ucsf.edu
     # inspired by image-sig posting from Kevin Cazabon, kcazabon@home.com
     if hasattr(im, "tag_v2"):
@@ -1666,8 +1676,14 @@ def _save(im, fp, filename):
             XMP,
         ):
             if key in im.tag_v2:
-                ifd[key] = im.tag_v2[key]
-                ifd.tagtype[key] = im.tag_v2.tagtype[key]
+                if key == IPTC_NAA_CHUNK and im.tag_v2.tagtype[key] not in (
+                    TiffTags.BYTE,
+                    TiffTags.UNDEFINED,
+                ):
+                    del supplied_tags[key]
+                else:
+                    ifd[key] = im.tag_v2[key]
+                    ifd.tagtype[key] = im.tag_v2.tagtype[key]
 
     # preserve ICC profile (should also work when saving other formats
     # which support profiles as TIFF) -- 2008-06-06 Florian Hoech
@@ -1807,16 +1823,6 @@ def _save(im, fp, filename):
         # Merge the ones that we have with (optional) more bits from
         # the original file, e.g x,y resolution so that we can
         # save(load('')) == original file.
-        legacy_ifd = {}
-        if hasattr(im, "tag"):
-            legacy_ifd = im.tag.to_v2()
-
-        # SAMPLEFORMAT is determined by the image format and should not be copied
-        # from legacy_ifd.
-        supplied_tags = {**getattr(im, "tag_v2", {}), **legacy_ifd}
-        if SAMPLEFORMAT in supplied_tags:
-            del supplied_tags[SAMPLEFORMAT]
-
         for tag, value in itertools.chain(ifd.items(), supplied_tags.items()):
             # Libtiff can only process certain core items without adding
             # them to the custom dictionary.

From 6a255de24fadfb2daf52f1fa86849611078127ab Mon Sep 17 00:00:00 2001
From: Yay295 <Yay295@users.noreply.github.com>
Date: Sat, 6 Apr 2024 11:14:38 -0500
Subject: [PATCH 0494/1178] Rename test_roundtrip() to test_hopper()

This test isn't actually roundtripping anything.
---
 Tests/test_image_getdata.py | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/Tests/test_image_getdata.py b/Tests/test_image_getdata.py
index ac27400be94..9181b24095b 100644
--- a/Tests/test_image_getdata.py
+++ b/Tests/test_image_getdata.py
@@ -14,7 +14,7 @@ def test_sanity() -> None:
     assert data[0] == (20, 20, 70)
 
 
-def test_roundtrip() -> None:
+def test_hopper() -> None:
     def getdata(mode: str) -> tuple[float | tuple[int, ...], int, int]:
         im = hopper(mode).resize((32, 30), Image.Resampling.NEAREST)
         data = im.getdata()

From 48b270590c61abf77547dc17b1ee5303ef6f4283 Mon Sep 17 00:00:00 2001
From: Andrew Murray <radarhere@users.noreply.github.com>
Date: Sat, 6 Apr 2024 13:58:53 +1100
Subject: [PATCH 0495/1178] accept returns bool or str

---
 src/PIL/BlpImagePlugin.py      |  2 +-
 src/PIL/BmpImagePlugin.py      |  2 +-
 src/PIL/BufrStubImagePlugin.py |  2 +-
 src/PIL/CurImagePlugin.py      |  2 +-
 src/PIL/DcxImagePlugin.py      |  2 +-
 src/PIL/DdsImagePlugin.py      |  2 +-
 src/PIL/EpsImagePlugin.py      |  2 +-
 src/PIL/FliImagePlugin.py      |  2 +-
 src/PIL/FpxImagePlugin.py      |  2 +-
 src/PIL/FtexImagePlugin.py     |  2 +-
 src/PIL/GbrImagePlugin.py      |  2 +-
 src/PIL/GifImagePlugin.py      |  2 +-
 src/PIL/GribStubImagePlugin.py |  2 +-
 src/PIL/Hdf5StubImagePlugin.py |  2 +-
 src/PIL/IcnsImagePlugin.py     |  2 +-
 src/PIL/IcoImagePlugin.py      |  2 +-
 src/PIL/Image.py               | 12 ++++++------
 src/PIL/Jpeg2KImagePlugin.py   |  2 +-
 src/PIL/JpegImagePlugin.py     |  2 +-
 src/PIL/MicImagePlugin.py      |  2 +-
 src/PIL/PngImagePlugin.py      |  2 +-
 src/PIL/PsdImagePlugin.py      |  2 +-
 src/PIL/QoiImagePlugin.py      |  2 +-
 src/PIL/TiffImagePlugin.py     |  2 +-
 src/PIL/WebPImagePlugin.py     |  3 ++-
 src/PIL/WmfImagePlugin.py      |  2 +-
 src/PIL/XpmImagePlugin.py      |  2 +-
 27 files changed, 33 insertions(+), 32 deletions(-)

diff --git a/src/PIL/BlpImagePlugin.py b/src/PIL/BlpImagePlugin.py
index 95e8077811d..8d351ce9100 100644
--- a/src/PIL/BlpImagePlugin.py
+++ b/src/PIL/BlpImagePlugin.py
@@ -241,7 +241,7 @@ class BLPFormatError(NotImplementedError):
     pass
 
 
-def _accept(prefix):
+def _accept(prefix: bytes) -> bool:
     return prefix[:4] in (b"BLP1", b"BLP2")
 
 
diff --git a/src/PIL/BmpImagePlugin.py b/src/PIL/BmpImagePlugin.py
index 9947f439b07..6643ac39bc5 100644
--- a/src/PIL/BmpImagePlugin.py
+++ b/src/PIL/BmpImagePlugin.py
@@ -48,7 +48,7 @@
 }
 
 
-def _accept(prefix):
+def _accept(prefix: bytes) -> bool:
     return prefix[:2] == b"BM"
 
 
diff --git a/src/PIL/BufrStubImagePlugin.py b/src/PIL/BufrStubImagePlugin.py
index 60f3ec25b38..1cbd50d1997 100644
--- a/src/PIL/BufrStubImagePlugin.py
+++ b/src/PIL/BufrStubImagePlugin.py
@@ -29,7 +29,7 @@ def register_handler(handler):
 # Image adapter
 
 
-def _accept(prefix):
+def _accept(prefix: bytes) -> bool:
     return prefix[:4] == b"BUFR" or prefix[:4] == b"ZCZC"
 
 
diff --git a/src/PIL/CurImagePlugin.py b/src/PIL/CurImagePlugin.py
index 5fb2b0193ca..b8790e20963 100644
--- a/src/PIL/CurImagePlugin.py
+++ b/src/PIL/CurImagePlugin.py
@@ -25,7 +25,7 @@
 # --------------------------------------------------------------------
 
 
-def _accept(prefix):
+def _accept(prefix: bytes) -> bool:
     return prefix[:4] == b"\0\0\2\0"
 
 
diff --git a/src/PIL/DcxImagePlugin.py b/src/PIL/DcxImagePlugin.py
index f7344df44a7..b24c16329d3 100644
--- a/src/PIL/DcxImagePlugin.py
+++ b/src/PIL/DcxImagePlugin.py
@@ -29,7 +29,7 @@
 MAGIC = 0x3ADE68B1  # QUIZ: what's this value, then?
 
 
-def _accept(prefix):
+def _accept(prefix: bytes) -> bool:
     return len(prefix) >= 4 and i32(prefix) == MAGIC
 
 
diff --git a/src/PIL/DdsImagePlugin.py b/src/PIL/DdsImagePlugin.py
index 93c8e341d44..3032e4aec52 100644
--- a/src/PIL/DdsImagePlugin.py
+++ b/src/PIL/DdsImagePlugin.py
@@ -562,7 +562,7 @@ def _save(im, fp, filename):
     )
 
 
-def _accept(prefix):
+def _accept(prefix: bytes) -> bool:
     return prefix[:4] == b"DDS "
 
 
diff --git a/src/PIL/EpsImagePlugin.py b/src/PIL/EpsImagePlugin.py
index 523ffcbf7ee..ec6705742ab 100644
--- a/src/PIL/EpsImagePlugin.py
+++ b/src/PIL/EpsImagePlugin.py
@@ -195,7 +195,7 @@ def readline(self):
         return b"".join(s).decode("latin-1")
 
 
-def _accept(prefix):
+def _accept(prefix: bytes) -> bool:
     return prefix[:4] == b"%!PS" or (len(prefix) >= 4 and i32(prefix) == 0xC6D3D0C5)
 
 
diff --git a/src/PIL/FliImagePlugin.py b/src/PIL/FliImagePlugin.py
index f9e4c731c88..7a233d01584 100644
--- a/src/PIL/FliImagePlugin.py
+++ b/src/PIL/FliImagePlugin.py
@@ -27,7 +27,7 @@
 # decoder
 
 
-def _accept(prefix):
+def _accept(prefix: bytes) -> bool:
     return (
         len(prefix) >= 6
         and i16(prefix, 4) in [0xAF11, 0xAF12]
diff --git a/src/PIL/FpxImagePlugin.py b/src/PIL/FpxImagePlugin.py
index 75680a94e02..cfaf862399d 100644
--- a/src/PIL/FpxImagePlugin.py
+++ b/src/PIL/FpxImagePlugin.py
@@ -41,7 +41,7 @@
 # --------------------------------------------------------------------
 
 
-def _accept(prefix):
+def _accept(prefix: bytes) -> bool:
     return prefix[:8] == olefile.MAGIC
 
 
diff --git a/src/PIL/FtexImagePlugin.py b/src/PIL/FtexImagePlugin.py
index b4488e6ee9c..a746959a3a8 100644
--- a/src/PIL/FtexImagePlugin.py
+++ b/src/PIL/FtexImagePlugin.py
@@ -107,7 +107,7 @@ def load_seek(self, pos):
         pass
 
 
-def _accept(prefix):
+def _accept(prefix: bytes) -> bool:
     return prefix[:4] == MAGIC
 
 
diff --git a/src/PIL/GbrImagePlugin.py b/src/PIL/GbrImagePlugin.py
index 6722fa2b144..62197e36c98 100644
--- a/src/PIL/GbrImagePlugin.py
+++ b/src/PIL/GbrImagePlugin.py
@@ -29,7 +29,7 @@
 from ._binary import i32be as i32
 
 
-def _accept(prefix):
+def _accept(prefix: bytes) -> bool:
     return len(prefix) >= 8 and i32(prefix, 0) >= 20 and i32(prefix, 4) in (1, 2)
 
 
diff --git a/src/PIL/GifImagePlugin.py b/src/PIL/GifImagePlugin.py
index 6b415d2384a..93be7fefb86 100644
--- a/src/PIL/GifImagePlugin.py
+++ b/src/PIL/GifImagePlugin.py
@@ -60,7 +60,7 @@ class LoadingStrategy(IntEnum):
 # Identify/read GIF files
 
 
-def _accept(prefix):
+def _accept(prefix: bytes) -> bool:
     return prefix[:6] in [b"GIF87a", b"GIF89a"]
 
 
diff --git a/src/PIL/GribStubImagePlugin.py b/src/PIL/GribStubImagePlugin.py
index f8106800c42..a80fe0a234a 100644
--- a/src/PIL/GribStubImagePlugin.py
+++ b/src/PIL/GribStubImagePlugin.py
@@ -29,7 +29,7 @@ def register_handler(handler):
 # Image adapter
 
 
-def _accept(prefix):
+def _accept(prefix: bytes) -> bool:
     return prefix[:4] == b"GRIB" and prefix[7] == 1
 
 
diff --git a/src/PIL/Hdf5StubImagePlugin.py b/src/PIL/Hdf5StubImagePlugin.py
index 65409e269fc..f50e6bf1625 100644
--- a/src/PIL/Hdf5StubImagePlugin.py
+++ b/src/PIL/Hdf5StubImagePlugin.py
@@ -29,7 +29,7 @@ def register_handler(handler):
 # Image adapter
 
 
-def _accept(prefix):
+def _accept(prefix: bytes) -> bool:
     return prefix[:8] == b"\x89HDF\r\n\x1a\n"
 
 
diff --git a/src/PIL/IcnsImagePlugin.py b/src/PIL/IcnsImagePlugin.py
index d877b4ecba6..c2c9508633d 100644
--- a/src/PIL/IcnsImagePlugin.py
+++ b/src/PIL/IcnsImagePlugin.py
@@ -374,7 +374,7 @@ def _save(im, fp, filename):
         fp.flush()
 
 
-def _accept(prefix):
+def _accept(prefix: bytes) -> bool:
     return prefix[:4] == MAGIC
 
 
diff --git a/src/PIL/IcoImagePlugin.py b/src/PIL/IcoImagePlugin.py
index d66fbc28797..82b190eb8f4 100644
--- a/src/PIL/IcoImagePlugin.py
+++ b/src/PIL/IcoImagePlugin.py
@@ -114,7 +114,7 @@ def _save(im, fp, filename):
         fp.seek(current)
 
 
-def _accept(prefix):
+def _accept(prefix: bytes) -> bool:
     return prefix[:4] == _MAGIC
 
 
diff --git a/src/PIL/Image.py b/src/PIL/Image.py
index 8bae2974c11..3ae90106087 100644
--- a/src/PIL/Image.py
+++ b/src/PIL/Image.py
@@ -223,7 +223,7 @@ class Quantize(IntEnum):
     str,
     tuple[
         Callable[[IO[bytes], str | bytes], ImageFile.ImageFile],
-        Callable[[bytes], bool] | None,
+        Callable[[bytes], bool | str] | None,
     ],
 ] = {}
 MIME: dict[str, str] = {}
@@ -3298,7 +3298,7 @@ def open(
 
     preinit()
 
-    accept_warnings: list[str | bytes] = []
+    accept_warnings: list[str] = []
 
     def _open_core(
         fp: IO[bytes],
@@ -3313,8 +3313,8 @@ def _open_core(
             try:
                 factory, accept = OPEN[i]
                 result = not accept or accept(prefix)
-                if type(result) in [str, bytes]:
-                    accept_warnings.append(result)  # type: ignore[arg-type]
+                if isinstance(result, str):
+                    accept_warnings.append(result)
                 elif result:
                     fp.seek(0)
                     im = factory(fp, filename)
@@ -3350,7 +3350,7 @@ def _open_core(
     if exclusive_fp:
         fp.close()
     for message in accept_warnings:
-        warnings.warn(message)  # type: ignore[arg-type]
+        warnings.warn(message)
     msg = "cannot identify image file %r" % (filename if filename else fp)
     raise UnidentifiedImageError(msg)
 
@@ -3464,7 +3464,7 @@ def merge(mode, bands):
 def register_open(
     id,
     factory: Callable[[IO[bytes], str | bytes], ImageFile.ImageFile],
-    accept: Callable[[bytes], bool] | None = None,
+    accept: Callable[[bytes], bool | str] | None = None,
 ) -> None:
     """
     Register an image file plugin.  This function should not be used
diff --git a/src/PIL/Jpeg2KImagePlugin.py b/src/PIL/Jpeg2KImagePlugin.py
index be000c351b6..f28de5c4da0 100644
--- a/src/PIL/Jpeg2KImagePlugin.py
+++ b/src/PIL/Jpeg2KImagePlugin.py
@@ -313,7 +313,7 @@ def load(self):
         return ImageFile.ImageFile.load(self)
 
 
-def _accept(prefix):
+def _accept(prefix: bytes) -> bool:
     return (
         prefix[:4] == b"\xff\x4f\xff\x51"
         or prefix[:12] == b"\x00\x00\x00\x0cjP  \x0d\x0a\x87\x0a"
diff --git a/src/PIL/JpegImagePlugin.py b/src/PIL/JpegImagePlugin.py
index 81b8749a332..e3c0083e944 100644
--- a/src/PIL/JpegImagePlugin.py
+++ b/src/PIL/JpegImagePlugin.py
@@ -344,7 +344,7 @@ def DQT(self, marker):
 }
 
 
-def _accept(prefix):
+def _accept(prefix: bytes) -> bool:
     # Magic number was taken from https://en.wikipedia.org/wiki/JPEG
     return prefix[:3] == b"\xFF\xD8\xFF"
 
diff --git a/src/PIL/MicImagePlugin.py b/src/PIL/MicImagePlugin.py
index f4529d9ae74..96de386a851 100644
--- a/src/PIL/MicImagePlugin.py
+++ b/src/PIL/MicImagePlugin.py
@@ -25,7 +25,7 @@
 # --------------------------------------------------------------------
 
 
-def _accept(prefix):
+def _accept(prefix: bytes) -> bool:
     return prefix[:8] == olefile.MAGIC
 
 
diff --git a/src/PIL/PngImagePlugin.py b/src/PIL/PngImagePlugin.py
index d922bacfb9c..8b81e54ea77 100644
--- a/src/PIL/PngImagePlugin.py
+++ b/src/PIL/PngImagePlugin.py
@@ -689,7 +689,7 @@ def chunk_fdAT(self, pos, length):
 # PNG reader
 
 
-def _accept(prefix):
+def _accept(prefix: bytes) -> bool:
     return prefix[:8] == _MAGIC
 
 
diff --git a/src/PIL/PsdImagePlugin.py b/src/PIL/PsdImagePlugin.py
index d29bcf9970c..b15918313be 100644
--- a/src/PIL/PsdImagePlugin.py
+++ b/src/PIL/PsdImagePlugin.py
@@ -44,7 +44,7 @@
 # read PSD images
 
 
-def _accept(prefix):
+def _accept(prefix: bytes) -> bool:
     return prefix[:4] == b"8BPS"
 
 
diff --git a/src/PIL/QoiImagePlugin.py b/src/PIL/QoiImagePlugin.py
index f8aa720c134..2875b8d752b 100644
--- a/src/PIL/QoiImagePlugin.py
+++ b/src/PIL/QoiImagePlugin.py
@@ -13,7 +13,7 @@
 from ._binary import i32be as i32
 
 
-def _accept(prefix):
+def _accept(prefix: bytes) -> bool:
     return prefix[:4] == b"qoif"
 
 
diff --git a/src/PIL/TiffImagePlugin.py b/src/PIL/TiffImagePlugin.py
index 8bfcd29075e..10ac9ea3a2a 100644
--- a/src/PIL/TiffImagePlugin.py
+++ b/src/PIL/TiffImagePlugin.py
@@ -277,7 +277,7 @@
 ]
 
 
-def _accept(prefix):
+def _accept(prefix: bytes) -> bool:
     return prefix[:4] in PREFIXES
 
 
diff --git a/src/PIL/WebPImagePlugin.py b/src/PIL/WebPImagePlugin.py
index c07abcaf928..9c8d53336ef 100644
--- a/src/PIL/WebPImagePlugin.py
+++ b/src/PIL/WebPImagePlugin.py
@@ -23,7 +23,7 @@
 }
 
 
-def _accept(prefix):
+def _accept(prefix: bytes) -> bool | str:
     is_riff_file_format = prefix[:4] == b"RIFF"
     is_webp_file = prefix[8:12] == b"WEBP"
     is_valid_vp8_mode = prefix[12:16] in _VP8_MODES_BY_IDENTIFIER
@@ -34,6 +34,7 @@ def _accept(prefix):
                 "image file could not be identified because WEBP support not installed"
             )
         return True
+    return False
 
 
 class WebPImageFile(ImageFile.ImageFile):
diff --git a/src/PIL/WmfImagePlugin.py b/src/PIL/WmfImagePlugin.py
index b5b8c69b171..7f045ec7da4 100644
--- a/src/PIL/WmfImagePlugin.py
+++ b/src/PIL/WmfImagePlugin.py
@@ -65,7 +65,7 @@ def load(self, im):
 # Read WMF file
 
 
-def _accept(prefix):
+def _accept(prefix: bytes) -> bool:
     return (
         prefix[:6] == b"\xd7\xcd\xc6\x9a\x00\x00" or prefix[:4] == b"\x01\x00\x00\x00"
     )
diff --git a/src/PIL/XpmImagePlugin.py b/src/PIL/XpmImagePlugin.py
index 3125f8d52c6..a638547af61 100644
--- a/src/PIL/XpmImagePlugin.py
+++ b/src/PIL/XpmImagePlugin.py
@@ -24,7 +24,7 @@
 xpm_head = re.compile(b'"([0-9]*) ([0-9]*) ([0-9]*) ([0-9]*)')
 
 
-def _accept(prefix):
+def _accept(prefix: bytes) -> bool:
     return prefix[:9] == b"/* XPM */"
 
 

From 1635e7a5714243cfe762b1dfaf3709bdf8a25118 Mon Sep 17 00:00:00 2001
From: Yay295 <Yay295@users.noreply.github.com>
Date: Sat, 6 Apr 2024 15:18:16 -0500
Subject: [PATCH 0496/1178] Update Tests/test_image_getdata.py

Co-authored-by: Andrew Murray <3112309+radarhere@users.noreply.github.com>
---
 Tests/test_image_getdata.py | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/Tests/test_image_getdata.py b/Tests/test_image_getdata.py
index 9181b24095b..dd3d70b3450 100644
--- a/Tests/test_image_getdata.py
+++ b/Tests/test_image_getdata.py
@@ -14,7 +14,7 @@ def test_sanity() -> None:
     assert data[0] == (20, 20, 70)
 
 
-def test_hopper() -> None:
+def test_mode() -> None:
     def getdata(mode: str) -> tuple[float | tuple[int, ...], int, int]:
         im = hopper(mode).resize((32, 30), Image.Resampling.NEAREST)
         data = im.getdata()

From 05d231460600f485dd954cca88f73967b4fdd790 Mon Sep 17 00:00:00 2001
From: Yay295 <Yay295@users.noreply.github.com>
Date: Sat, 6 Apr 2024 15:52:17 -0500
Subject: [PATCH 0497/1178] Make ModeDescriptor a NamedTuple

---
 src/PIL/ImageMode.py | 21 +++++++--------------
 1 file changed, 7 insertions(+), 14 deletions(-)

diff --git a/src/PIL/ImageMode.py b/src/PIL/ImageMode.py
index 0b31f608174..b0c84655323 100644
--- a/src/PIL/ImageMode.py
+++ b/src/PIL/ImageMode.py
@@ -16,24 +16,17 @@
 
 import sys
 from functools import lru_cache
+from typing import NamedTuple
 
 
-class ModeDescriptor:
+class ModeDescriptor(NamedTuple):
     """Wrapper for mode strings."""
 
-    def __init__(
-        self,
-        mode: str,
-        bands: tuple[str, ...],
-        basemode: str,
-        basetype: str,
-        typestr: str,
-    ) -> None:
-        self.mode = mode
-        self.bands = bands
-        self.basemode = basemode
-        self.basetype = basetype
-        self.typestr = typestr
+    mode: str
+    bands: tuple[str, ...]
+    basemode: str
+    basetype: str
+    typestr: str
 
     def __str__(self) -> str:
         return self.mode

From a25a1aef059911d29765406c37b1a92797bac3e3 Mon Sep 17 00:00:00 2001
From: Andrew Murray <radarhere@users.noreply.github.com>
Date: Sun, 7 Apr 2024 08:38:43 +1000
Subject: [PATCH 0498/1178] Update CHANGES.rst [ci skip]

---
 CHANGES.rst | 6 ++++++
 1 file changed, 6 insertions(+)

diff --git a/CHANGES.rst b/CHANGES.rst
index 9fae613a5ae..e39031aea4a 100644
--- a/CHANGES.rst
+++ b/CHANGES.rst
@@ -2,6 +2,12 @@
 Changelog (Pillow)
 ==================
 
+10.4.0 (unreleased)
+-------------------
+
+- Support reading CMYK JPEG2000 images #7947
+  [radarhere]
+
 10.3.0 (2024-04-01)
 -------------------
 

From bcb2db6a871189160ce619ad581411e30d9b0b63 Mon Sep 17 00:00:00 2001
From: Nulano <nulano@nulano.eu>
Date: Sun, 7 Apr 2024 00:44:53 +0200
Subject: [PATCH 0499/1178] ImageStat: use functools.cached_property and add
 type hints

---
 docs/reference/ImageStat.rst |  67 ++---------------------
 src/PIL/ImageStat.py         | 102 +++++++++++++++++++++++------------
 2 files changed, 71 insertions(+), 98 deletions(-)

diff --git a/docs/reference/ImageStat.rst b/docs/reference/ImageStat.rst
index f61d123131a..f694663828a 100644
--- a/docs/reference/ImageStat.rst
+++ b/docs/reference/ImageStat.rst
@@ -7,67 +7,6 @@
 The :py:mod:`~PIL.ImageStat` module calculates global statistics for an image, or
 for a region of an image.
 
-.. py:class:: Stat(image_or_list, mask=None)
-
-    Calculate statistics for the given image. If a mask is included,
-    only the regions covered by that mask are included in the
-    statistics. You can also pass in a previously calculated histogram.
-
-    :param image: A PIL image, or a precalculated histogram.
-
-        .. note::
-
-            For a PIL image, calculations rely on the
-            :py:meth:`~PIL.Image.Image.histogram` method. The pixel counts are
-            grouped into 256 bins, even if the image has more than 8 bits per
-            channel. So ``I`` and ``F`` mode images have a maximum ``mean``,
-            ``median`` and ``rms`` of 255, and cannot have an ``extrema`` maximum
-            of more than 255.
-
-    :param mask: An optional mask.
-
-    .. py:attribute:: extrema
-
-        Min/max values for each band in the image.
-
-        .. note::
-
-            This relies on the :py:meth:`~PIL.Image.Image.histogram` method, and
-            simply returns the low and high bins used. This is correct for
-            images with 8 bits per channel, but fails for other modes such as
-            ``I`` or ``F``. Instead, use :py:meth:`~PIL.Image.Image.getextrema` to
-            return per-band extrema for the image. This is more correct and
-            efficient because, for non-8-bit modes, the histogram method uses
-            :py:meth:`~PIL.Image.Image.getextrema` to determine the bins used.
-
-    .. py:attribute:: count
-
-        Total number of pixels for each band in the image.
-
-    .. py:attribute:: sum
-
-        Sum of all pixels for each band in the image.
-
-    .. py:attribute:: sum2
-
-        Squared sum of all pixels for each band in the image.
-
-    .. py:attribute:: mean
-
-        Average (arithmetic mean) pixel level for each band in the image.
-
-    .. py:attribute:: median
-
-        Median pixel level for each band in the image.
-
-    .. py:attribute:: rms
-
-        RMS (root-mean-square) for each band in the image.
-
-    .. py:attribute:: var
-
-        Variance for each band in the image.
-
-    .. py:attribute:: stddev
-
-        Standard deviation for each band in the image.
+.. autoclass:: Stat
+    :members:
+    :special-members: __init__
diff --git a/src/PIL/ImageStat.py b/src/PIL/ImageStat.py
index 13864e59cfc..07ea76e6faf 100644
--- a/src/PIL/ImageStat.py
+++ b/src/PIL/ImageStat.py
@@ -23,35 +23,61 @@
 from __future__ import annotations
 
 import math
+from functools import cached_property
+
+from . import Image
 
 
 class Stat:
-    def __init__(self, image_or_list, mask=None):
-        try:
+    def __init__(
+        self, image_or_list: Image.Image | list[int], mask: Image.Image | None = None
+    ) -> None:
+        """
+        Calculate statistics for the given image. If a mask is included,
+        only the regions covered by that mask are included in the
+        statistics. You can also pass in a previously calculated histogram.
+
+        :param image: A PIL image, or a precalculated histogram.
+
+            .. note::
+
+                For a PIL image, calculations rely on the
+                :py:meth:`~PIL.Image.Image.histogram` method. The pixel counts are
+                grouped into 256 bins, even if the image has more than 8 bits per
+                channel. So ``I`` and ``F`` mode images have a maximum ``mean``,
+                ``median`` and ``rms`` of 255, and cannot have an ``extrema`` maximum
+                of more than 255.
+
+        :param mask: An optional mask.
+        """
+        if isinstance(image_or_list, Image.Image):
             if mask:
                 self.h = image_or_list.histogram(mask)
             else:
                 self.h = image_or_list.histogram()
-        except AttributeError:
-            self.h = image_or_list  # assume it to be a histogram list
+        else:
+            self.h = image_or_list
         if not isinstance(self.h, list):
-            msg = "first argument must be image or list"
+            msg = "first argument must be image or list"  # type: ignore[unreachable]
             raise TypeError(msg)
         self.bands = list(range(len(self.h) // 256))
 
-    def __getattr__(self, id):
-        """Calculate missing attribute"""
-        if id[:4] == "_get":
-            raise AttributeError(id)
-        # calculate missing attribute
-        v = getattr(self, "_get" + id)()
-        setattr(self, id, v)
-        return v
-
-    def _getextrema(self):
-        """Get min/max values for each band in the image"""
-
-        def minmax(histogram):
+    @cached_property
+    def extrema(self) -> list[tuple[int, int]]:
+        """
+        Min/max values for each band in the image.
+
+        .. note::
+            This relies on the :py:meth:`~PIL.Image.Image.histogram` method, and
+            simply returns the low and high bins used. This is correct for
+            images with 8 bits per channel, but fails for other modes such as
+            ``I`` or ``F``. Instead, use :py:meth:`~PIL.Image.Image.getextrema` to
+            return per-band extrema for the image. This is more correct and
+            efficient because, for non-8-bit modes, the histogram method uses
+            :py:meth:`~PIL.Image.Image.getextrema` to determine the bins used.
+        """
+
+        def minmax(histogram: list[int]) -> tuple[int, int]:
             res_min, res_max = 255, 0
             for i in range(256):
                 if histogram[i]:
@@ -65,12 +91,14 @@ def minmax(histogram):
 
         return [minmax(self.h[i:]) for i in range(0, len(self.h), 256)]
 
-    def _getcount(self):
-        """Get total number of pixels in each layer"""
+    @cached_property
+    def count(self) -> list[int]:
+        """Total number of pixels for each band in the image."""
         return [sum(self.h[i : i + 256]) for i in range(0, len(self.h), 256)]
 
-    def _getsum(self):
-        """Get sum of all pixels in each layer"""
+    @cached_property
+    def sum(self) -> list[float]:
+        """Sum of all pixels for each band in the image."""
 
         v = []
         for i in range(0, len(self.h), 256):
@@ -80,8 +108,9 @@ def _getsum(self):
             v.append(layer_sum)
         return v
 
-    def _getsum2(self):
-        """Get squared sum of all pixels in each layer"""
+    @cached_property
+    def sum2(self) -> list[float]:
+        """Squared sum of all pixels for each band in the image."""
 
         v = []
         for i in range(0, len(self.h), 256):
@@ -91,12 +120,14 @@ def _getsum2(self):
             v.append(sum2)
         return v
 
-    def _getmean(self):
-        """Get average pixel level for each layer"""
+    @cached_property
+    def mean(self) -> list[float]:
+        """Average (arithmetic mean) pixel level for each band in the image."""
         return [self.sum[i] / self.count[i] for i in self.bands]
 
-    def _getmedian(self):
-        """Get median pixel level for each layer"""
+    @cached_property
+    def median(self) -> list[int]:
+        """Median pixel level for each band in the image."""
 
         v = []
         for i in self.bands:
@@ -110,19 +141,22 @@ def _getmedian(self):
             v.append(j)
         return v
 
-    def _getrms(self):
-        """Get RMS for each layer"""
+    @cached_property
+    def rms(self) -> list[float]:
+        """RMS (root-mean-square) for each band in the image."""
         return [math.sqrt(self.sum2[i] / self.count[i]) for i in self.bands]
 
-    def _getvar(self):
-        """Get variance for each layer"""
+    @cached_property
+    def var(self) -> list[float]:
+        """Variance for each band in the image."""
         return [
             (self.sum2[i] - (self.sum[i] ** 2.0) / self.count[i]) / self.count[i]
             for i in self.bands
         ]
 
-    def _getstddev(self):
-        """Get standard deviation for each layer"""
+    @cached_property
+    def stddev(self) -> list[float]:
+        """Standard deviation for each band in the image."""
         return [math.sqrt(self.var[i]) for i in self.bands]
 
 

From 76fb002dd4d7bac29407c532dc119ed8ba07dd10 Mon Sep 17 00:00:00 2001
From: Andrew Murray <3112309+radarhere@users.noreply.github.com>
Date: Sun, 7 Apr 2024 16:14:41 +1000
Subject: [PATCH 0500/1178] Removed outdated comment

---
 src/PIL/ImageMode.py | 1 -
 1 file changed, 1 deletion(-)

diff --git a/src/PIL/ImageMode.py b/src/PIL/ImageMode.py
index 0b31f608174..f6524f44bb4 100644
--- a/src/PIL/ImageMode.py
+++ b/src/PIL/ImageMode.py
@@ -42,7 +42,6 @@ def __str__(self) -> str:
 @lru_cache
 def getmode(mode: str) -> ModeDescriptor:
     """Gets a mode descriptor for the given mode."""
-    # initialize mode cache
     endian = "<" if sys.byteorder == "little" else ">"
 
     modes = {

From 2f3281dcda446c0a5b4121ee8e17feb312192c1e Mon Sep 17 00:00:00 2001
From: Jonah Jeleniewski <cirrasbu@hotmail.com>
Date: Mon, 8 Apr 2024 21:14:19 +1000
Subject: [PATCH 0501/1178] Add support for bitmaps with header size 52

Size 52 is the undocumented `BITMAPV2INFOHEADER`.
It adds the RGB bit masks.

The format is known to be supported by:
- Adobe Photoshop
- Popular web browsers
---
 Tests/images/bmp/q/rgb32h52.bmp | Bin 0 -> 32578 bytes
 Tests/test_bmp_reference.py     |   1 +
 src/PIL/BmpImagePlugin.py       |  15 +++++++++------
 3 files changed, 10 insertions(+), 6 deletions(-)
 create mode 100644 Tests/images/bmp/q/rgb32h52.bmp

diff --git a/Tests/images/bmp/q/rgb32h52.bmp b/Tests/images/bmp/q/rgb32h52.bmp
new file mode 100644
index 0000000000000000000000000000000000000000..db6e4538ef84f48baf706603bd919223d372444b
GIT binary patch
literal 32578
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
B3Bv#Y

literal 0
HcmV?d00001

diff --git a/Tests/test_bmp_reference.py b/Tests/test_bmp_reference.py
index 0ad49613553..5398664b88f 100644
--- a/Tests/test_bmp_reference.py
+++ b/Tests/test_bmp_reference.py
@@ -44,6 +44,7 @@ def test_questionable() -> None:
         "pal8os2sp.bmp",
         "pal8rletrns.bmp",
         "rgb32bf-xbgr.bmp",
+        "rgb32h52.bmp",
     ]
     for f in get_files("q"):
         try:
diff --git a/src/PIL/BmpImagePlugin.py b/src/PIL/BmpImagePlugin.py
index 6643ac39bc5..dd8c06f4d49 100644
--- a/src/PIL/BmpImagePlugin.py
+++ b/src/PIL/BmpImagePlugin.py
@@ -53,7 +53,7 @@ def _accept(prefix: bytes) -> bool:
 
 
 def _dib_accept(prefix):
-    return i32(prefix) in [12, 40, 64, 108, 124]
+    return i32(prefix) in [12, 40, 52, 64, 108, 124]
 
 
 # =============================================================================
@@ -95,7 +95,7 @@ def _bitmap(self, header=0, offset=0):
 
         # --------------------------------------------- Windows Bitmap v2 to v5
         # v3, OS/2 v2, v4, v5
-        elif file_info["header_size"] in (40, 64, 108, 124):
+        elif file_info["header_size"] in (40, 52, 64, 108, 124):
             file_info["y_flip"] = header_data[7] == 0xFF
             file_info["direction"] = 1 if file_info["y_flip"] else -1
             file_info["width"] = i32(header_data, 0)
@@ -117,10 +117,13 @@ def _bitmap(self, header=0, offset=0):
             file_info["palette_padding"] = 4
             self.info["dpi"] = tuple(x / 39.3701 for x in file_info["pixels_per_meter"])
             if file_info["compression"] == self.BITFIELDS:
-                if len(header_data) >= 52:
-                    for idx, mask in enumerate(
-                        ["r_mask", "g_mask", "b_mask", "a_mask"]
-                    ):
+                if len(header_data) >= 48:
+                    masks = ["r_mask", "g_mask", "b_mask"]
+                    if len(header_data) >= 52:
+                        masks.append("a_mask")
+                    else:
+                        file_info["a_mask"] = 0x0
+                    for idx, mask in enumerate(masks):
                         file_info[mask] = i32(header_data, 36 + idx * 4)
                 else:
                     # 40 byte headers only have the three components in the

From a1a2202ebec15c6ba4c77e0eaf94bb698ab81530 Mon Sep 17 00:00:00 2001
From: Jonah Jeleniewski <cirrasbu@hotmail.com>
Date: Mon, 8 Apr 2024 21:16:39 +1000
Subject: [PATCH 0502/1178] Add support for bitmaps with header size 56

Size 56 is the undocumented `BITMAPV3INFOHEADER`.
It adds the alpha bit mask.

The format is known to be supported by:
- Windows (MS paint, etc.)
- Adobe Photoshop
- Popular web browsers
---
 Tests/images/bmp/q/rgba32h56.bmp | Bin 0 -> 32582 bytes
 Tests/test_bmp_reference.py      |   1 +
 src/PIL/BmpImagePlugin.py        |   4 ++--
 3 files changed, 3 insertions(+), 2 deletions(-)
 create mode 100644 Tests/images/bmp/q/rgba32h56.bmp

diff --git a/Tests/images/bmp/q/rgba32h56.bmp b/Tests/images/bmp/q/rgba32h56.bmp
new file mode 100644
index 0000000000000000000000000000000000000000..343baa3300f331aaeabeb40d8fcd2f232393e815
GIT binary patch
literal 32582
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
ar8e|C{a#<Gq(A77`WKb;ulgVQlm37Fm=Rq7

literal 0
HcmV?d00001

diff --git a/Tests/test_bmp_reference.py b/Tests/test_bmp_reference.py
index 5398664b88f..a5a4283e3bb 100644
--- a/Tests/test_bmp_reference.py
+++ b/Tests/test_bmp_reference.py
@@ -45,6 +45,7 @@ def test_questionable() -> None:
         "pal8rletrns.bmp",
         "rgb32bf-xbgr.bmp",
         "rgb32h52.bmp",
+        "rgba32h56.bmp",
     ]
     for f in get_files("q"):
         try:
diff --git a/src/PIL/BmpImagePlugin.py b/src/PIL/BmpImagePlugin.py
index dd8c06f4d49..82a9c47dbd5 100644
--- a/src/PIL/BmpImagePlugin.py
+++ b/src/PIL/BmpImagePlugin.py
@@ -53,7 +53,7 @@ def _accept(prefix: bytes) -> bool:
 
 
 def _dib_accept(prefix):
-    return i32(prefix) in [12, 40, 52, 64, 108, 124]
+    return i32(prefix) in [12, 40, 52, 56, 64, 108, 124]
 
 
 # =============================================================================
@@ -95,7 +95,7 @@ def _bitmap(self, header=0, offset=0):
 
         # --------------------------------------------- Windows Bitmap v2 to v5
         # v3, OS/2 v2, v4, v5
-        elif file_info["header_size"] in (40, 52, 64, 108, 124):
+        elif file_info["header_size"] in (40, 52, 56, 64, 108, 124):
             file_info["y_flip"] = header_data[7] == 0xFF
             file_info["direction"] = 1 if file_info["y_flip"] else -1
             file_info["width"] = i32(header_data, 0)

From 9e5b9fb18fdb2fe957346424432163cdb5fe3b00 Mon Sep 17 00:00:00 2001
From: Jonah Jeleniewski <cirrasbu@hotmail.com>
Date: Mon, 8 Apr 2024 21:33:24 +1000
Subject: [PATCH 0503/1178] Improve comments around bitmap info headers

---
 src/PIL/BmpImagePlugin.py | 12 +++++++++---
 1 file changed, 9 insertions(+), 3 deletions(-)

diff --git a/src/PIL/BmpImagePlugin.py b/src/PIL/BmpImagePlugin.py
index 82a9c47dbd5..ddc6b3fccf9 100644
--- a/src/PIL/BmpImagePlugin.py
+++ b/src/PIL/BmpImagePlugin.py
@@ -83,8 +83,9 @@ def _bitmap(self, header=0, offset=0):
         # read the rest of the bmp header, without its size
         header_data = ImageFile._safe_read(self.fp, file_info["header_size"] - 4)
 
-        # -------------------------------------------------- IBM OS/2 Bitmap v1
+        # ------------------------------- Windows Bitmap v2, IBM OS/2 Bitmap v1
         # ----- This format has different offsets because of width/height types
+        # 12: BITMAPCOREHEADER/OS21XBITMAPHEADER
         if file_info["header_size"] == 12:
             file_info["width"] = i16(header_data, 0)
             file_info["height"] = i16(header_data, 2)
@@ -93,8 +94,13 @@ def _bitmap(self, header=0, offset=0):
             file_info["compression"] = self.RAW
             file_info["palette_padding"] = 3
 
-        # --------------------------------------------- Windows Bitmap v2 to v5
-        # v3, OS/2 v2, v4, v5
+        # --------------------------------------------- Windows Bitmap v3 to v5
+        #  40: BITMAPINFOHEADER
+        #  52: BITMAPV2HEADER
+        #  56: BITMAPV3HEADER
+        #  64: BITMAPCOREHEADER2/OS22XBITMAPHEADER
+        # 108: BITMAPV4HEADER
+        # 124: BITMAPV5HEADER
         elif file_info["header_size"] in (40, 52, 56, 64, 108, 124):
             file_info["y_flip"] = header_data[7] == 0xFF
             file_info["direction"] = 1 if file_info["y_flip"] else -1

From 98ae91a65deb6ab0790c042ca1f0ebc478f88df0 Mon Sep 17 00:00:00 2001
From: Andrew Murray <radarhere@users.noreply.github.com>
Date: Mon, 8 Apr 2024 23:58:03 +1000
Subject: [PATCH 0504/1178] Added BGXR and BGAR unpackers

---
 src/PIL/BmpImagePlugin.py |  4 ++++
 src/libImaging/Unpack.c   | 24 ++++++++++++++++++++++++
 2 files changed, 28 insertions(+)

diff --git a/src/PIL/BmpImagePlugin.py b/src/PIL/BmpImagePlugin.py
index ddc6b3fccf9..fa337f6ebfc 100644
--- a/src/PIL/BmpImagePlugin.py
+++ b/src/PIL/BmpImagePlugin.py
@@ -184,9 +184,11 @@ def _bitmap(self, header=0, offset=0):
                 32: [
                     (0xFF0000, 0xFF00, 0xFF, 0x0),
                     (0xFF000000, 0xFF0000, 0xFF00, 0x0),
+                    (0xFF000000, 0xFF00, 0xFF, 0x0),
                     (0xFF000000, 0xFF0000, 0xFF00, 0xFF),
                     (0xFF, 0xFF00, 0xFF0000, 0xFF000000),
                     (0xFF0000, 0xFF00, 0xFF, 0xFF000000),
+                    (0xFF000000, 0xFF00, 0xFF, 0xFF0000),
                     (0x0, 0x0, 0x0, 0x0),
                 ],
                 24: [(0xFF0000, 0xFF00, 0xFF)],
@@ -195,9 +197,11 @@ def _bitmap(self, header=0, offset=0):
             MASK_MODES = {
                 (32, (0xFF0000, 0xFF00, 0xFF, 0x0)): "BGRX",
                 (32, (0xFF000000, 0xFF0000, 0xFF00, 0x0)): "XBGR",
+                (32, (0xFF000000, 0xFF00, 0xFF, 0x0)): "BGXR",
                 (32, (0xFF000000, 0xFF0000, 0xFF00, 0xFF)): "ABGR",
                 (32, (0xFF, 0xFF00, 0xFF0000, 0xFF000000)): "RGBA",
                 (32, (0xFF0000, 0xFF00, 0xFF, 0xFF000000)): "BGRA",
+                (32, (0xFF000000, 0xFF00, 0xFF, 0xFF0000)): "BGAR",
                 (32, (0x0, 0x0, 0x0, 0x0)): "BGRA",
                 (24, (0xFF0000, 0xFF00, 0xFF)): "BGR",
                 (16, (0xF800, 0x7E0, 0x1F)): "BGR;16",
diff --git a/src/libImaging/Unpack.c b/src/libImaging/Unpack.c
index 6c7d52f58d1..a84dc0a6fd2 100644
--- a/src/libImaging/Unpack.c
+++ b/src/libImaging/Unpack.c
@@ -790,6 +790,17 @@ ImagingUnpackBGRX(UINT8 *_out, const UINT8 *in, int pixels) {
     }
 }
 
+static void
+ImagingUnpackBGXR(UINT8 *_out, const UINT8 *in, int pixels) {
+    int i;
+    for (i = 0; i < pixels; i++) {
+        UINT32 iv = MAKE_UINT32(in[3], in[1], in[0], 255);
+        memcpy(_out, &iv, sizeof(iv));
+        in += 4;
+        _out += 4;
+    }
+}
+
 static void
 ImagingUnpackXRGB(UINT8 *_out, const UINT8 *in, int pixels) {
     int i;
@@ -1090,6 +1101,17 @@ unpackBGRA16B(UINT8 *_out, const UINT8 *in, int pixels) {
     }
 }
 
+static void
+unpackBGAR(UINT8 *_out, const UINT8 *in, int pixels) {
+    int i;
+    for (i = 0; i < pixels; i++) {
+        UINT32 iv = MAKE_UINT32(in[3], in[1], in[0], in[2]);
+        memcpy(_out, &iv, sizeof(iv));
+        in += 4;
+        _out += 4;
+    }
+}
+
 /* Unpack to "CMYK" image */
 
 static void
@@ -1584,6 +1606,7 @@ static struct {
     {"RGB", "RGBA;L", 32, unpackRGBAL},
     {"RGB", "RGBA;15", 16, ImagingUnpackRGBA15},
     {"RGB", "BGRX", 32, ImagingUnpackBGRX},
+    {"RGB", "BGXR", 32, ImagingUnpackBGXR},
     {"RGB", "XRGB", 32, ImagingUnpackXRGB},
     {"RGB", "XBGR", 32, ImagingUnpackXBGR},
     {"RGB", "YCC;P", 24, ImagingUnpackYCC},
@@ -1624,6 +1647,7 @@ static struct {
     {"RGBA", "BGRA", 32, unpackBGRA},
     {"RGBA", "BGRA;16L", 64, unpackBGRA16L},
     {"RGBA", "BGRA;16B", 64, unpackBGRA16B},
+    {"RGBA", "BGAR", 32, unpackBGAR},
     {"RGBA", "ARGB", 32, unpackARGB},
     {"RGBA", "ABGR", 32, unpackABGR},
     {"RGBA", "YCCA;P", 32, ImagingUnpackYCCA},

From 40504bb49007974658d19e32aa62cc93b9160fd8 Mon Sep 17 00:00:00 2001
From: Hugo van Kemenade <1324225+hugovk@users.noreply.github.com>
Date: Mon, 8 Apr 2024 22:15:51 +0300
Subject: [PATCH 0505/1178] No more eggs

---
 Makefile | 1 -
 1 file changed, 1 deletion(-)

diff --git a/Makefile b/Makefile
index ad0a1adab50..5547b2e3caf 100644
--- a/Makefile
+++ b/Makefile
@@ -78,7 +78,6 @@ release-test:
 	python3 selftest.py
 	python3 -m pytest Tests
 	python3 -m pip install .
-	-rm dist/*.egg
 	-rmdir dist
 	python3 -m pytest -qq
 	python3 -m check_manifest

From bf463c25dfa75ef715470e65206eedde087323d2 Mon Sep 17 00:00:00 2001
From: Hugo van Kemenade <1324225+hugovk@users.noreply.github.com>
Date: Mon, 8 Apr 2024 22:48:08 +0300
Subject: [PATCH 0506/1178] Inline the 'Source and Binary Distributions' step

---
 RELEASING.md | 20 ++++++++++----------
 1 file changed, 10 insertions(+), 10 deletions(-)

diff --git a/RELEASING.md b/RELEASING.md
index b013d8288ff..9e6ec5dd4c1 100644
--- a/RELEASING.md
+++ b/RELEASING.md
@@ -20,8 +20,10 @@ Released quarterly on January 2nd, April 1st, July 1st and October 15th.
   git tag 5.2.0
   git push --tags
   ```
-* [ ] Create and upload all [source and binary distributions](https://github.com/python-pillow/Pillow/blob/main/RELEASING.md#source-and-binary-distributions)
-* [ ] Publish the [release on GitHub](https://github.com/python-pillow/Pillow/releases)
+* [ ] Check the [GitHub Actions "Wheels" workflow](https://github.com/python-pillow/Pillow/actions/workflows/wheels.yml)
+  has passed, including the "Upload release to PyPI" job. This will have been triggered
+  by the new tag.
+* [ ] Publish the [release on GitHub](https://github.com/python-pillow/Pillow/releases).
 * [ ] In compliance with [PEP 440](https://peps.python.org/pep-0440/),
       increment and append `.dev0` to version identifier in `src/PIL/_version.py` and then:
   ```bash
@@ -50,7 +52,9 @@ Released as needed for security, installation or critical bug fixes.
   ```bash
   make sdist
   ```
-* [ ] Create and upload all [source and binary distributions](https://github.com/python-pillow/Pillow/blob/main/RELEASING.md#source-and-binary-distributions)
+* [ ] Check the [GitHub Actions "Wheels" workflow](https://github.com/python-pillow/Pillow/actions/workflows/wheels.yml)
+  has passed, including the "Upload release to PyPI" job. This will have been triggered
+  by the new tag.
 * [ ] Publish the [release on GitHub](https://github.com/python-pillow/Pillow/releases) and then:
   ```bash
   git push
@@ -72,18 +76,14 @@ Released as needed privately to individual vendors for critical security-related
   git tag 2.5.3
   git push origin --tags
   ```
-* [ ] Create and upload all [source and binary distributions](https://github.com/python-pillow/Pillow/blob/main/RELEASING.md#source-and-binary-distributions)
+* [ ] Check the [GitHub Actions "Wheels" workflow](https://github.com/python-pillow/Pillow/actions/workflows/wheels.yml)
+  has passed, including the "Upload release to PyPI" job. This will have been triggered
+  by the new tag.
 * [ ] Publish the [release on GitHub](https://github.com/python-pillow/Pillow/releases) and then:
   ```bash
   git push origin 2.5.x
   ```
 
-## Source and Binary Distributions
-
-* [ ] Check the [GitHub Actions "Wheels" workflow](https://github.com/python-pillow/Pillow/actions/workflows/wheels.yml)
-  has passed, including the "Upload release to PyPI" job. This will have been triggered
-  by the new tag.
-
 ## Publicize Release
 
 * [ ] Announce release availability via [Mastodon](https://fosstodon.org/@pillow) e.g. https://fosstodon.org/@pillow/110639450470725321

From 3a92d4af0162d80bc13ae15efbc2e47483870d3b Mon Sep 17 00:00:00 2001
From: Andrew Murray <radarhere@users.noreply.github.com>
Date: Tue, 9 Apr 2024 07:34:52 +1000
Subject: [PATCH 0507/1178] Replace ImageMath.eval with ImageMath.lambda_eval

---
 selftest.py | 4 +++-
 1 file changed, 3 insertions(+), 1 deletion(-)

diff --git a/selftest.py b/selftest.py
index ed5252c4464..661abcddb74 100755
--- a/selftest.py
+++ b/selftest.py
@@ -139,7 +139,9 @@ def testimage() -> None:
     In 1.1.6, you can use the ImageMath module to do image
     calculations.
 
-    >>> im = ImageMath.eval("float(im + 20)", im=im.convert("L"))
+    >>> im = ImageMath.lambda_eval( \
+      lambda args: args["float"](args["im"] + 20), im=im.convert("L") \
+    )
     >>> im.mode, im.size
     ('F', (128, 128))
 

From 4b4cdbd40c865cd932329f1ace42f0d42ce1cb71 Mon Sep 17 00:00:00 2001
From: Andrew Murray <radarhere@users.noreply.github.com>
Date: Wed, 10 Apr 2024 19:01:34 +1000
Subject: [PATCH 0508/1178] Added image to supported list

---
 Tests/test_bmp_reference.py | 1 +
 1 file changed, 1 insertion(+)

diff --git a/Tests/test_bmp_reference.py b/Tests/test_bmp_reference.py
index a5a4283e3bb..7f848792131 100644
--- a/Tests/test_bmp_reference.py
+++ b/Tests/test_bmp_reference.py
@@ -44,6 +44,7 @@ def test_questionable() -> None:
         "pal8os2sp.bmp",
         "pal8rletrns.bmp",
         "rgb32bf-xbgr.bmp",
+        "rgba32.bmp",
         "rgb32h52.bmp",
         "rgba32h56.bmp",
     ]

From e2a57263c72cd0e55822b78aaf1faa246a8d6895 Mon Sep 17 00:00:00 2001
From: Andrew Murray <radarhere@users.noreply.github.com>
Date: Wed, 10 Apr 2024 19:17:20 +1000
Subject: [PATCH 0509/1178] Reduced duplicate code

---
 src/PIL/BmpImagePlugin.py | 4 ++--
 1 file changed, 2 insertions(+), 2 deletions(-)

diff --git a/src/PIL/BmpImagePlugin.py b/src/PIL/BmpImagePlugin.py
index fa337f6ebfc..9ce0fed88fe 100644
--- a/src/PIL/BmpImagePlugin.py
+++ b/src/PIL/BmpImagePlugin.py
@@ -123,8 +123,8 @@ def _bitmap(self, header=0, offset=0):
             file_info["palette_padding"] = 4
             self.info["dpi"] = tuple(x / 39.3701 for x in file_info["pixels_per_meter"])
             if file_info["compression"] == self.BITFIELDS:
+                masks = ["r_mask", "g_mask", "b_mask"]
                 if len(header_data) >= 48:
-                    masks = ["r_mask", "g_mask", "b_mask"]
                     if len(header_data) >= 52:
                         masks.append("a_mask")
                     else:
@@ -141,7 +141,7 @@ def _bitmap(self, header=0, offset=0):
                     # location, but it is listed as a reserved component,
                     # and it is not generally an alpha channel
                     file_info["a_mask"] = 0x0
-                    for mask in ["r_mask", "g_mask", "b_mask"]:
+                    for mask in masks:
                         file_info[mask] = i32(read(4))
                 file_info["rgb_mask"] = (
                     file_info["r_mask"],

From 94fe670c0bc9ad88c8d7d55491cb1c55f7ed14dc Mon Sep 17 00:00:00 2001
From: Andrew Murray <radarhere@users.noreply.github.com>
Date: Wed, 10 Apr 2024 21:50:17 +1000
Subject: [PATCH 0510/1178] Test DIB header size

---
 Tests/test_file_bmp.py | 25 ++++++++++++++++++++++++-
 1 file changed, 24 insertions(+), 1 deletion(-)

diff --git a/Tests/test_file_bmp.py b/Tests/test_file_bmp.py
index 1eaff0c7df0..c7c9b24e763 100644
--- a/Tests/test_file_bmp.py
+++ b/Tests/test_file_bmp.py
@@ -5,7 +5,7 @@
 
 import pytest
 
-from PIL import BmpImagePlugin, Image
+from PIL import BmpImagePlugin, Image, _binary
 
 from .helper import (
     assert_image_equal,
@@ -128,6 +128,29 @@ def test_load_dib() -> None:
         assert_image_equal_tofile(im, "Tests/images/clipboard_target.png")
 
 
+@pytest.mark.parametrize(
+    "header_size, path",
+    (
+        (12, "g/pal8os2.bmp"),
+        (40, "g/pal1.bmp"),
+        (52, "q/rgb32h52.bmp"),
+        (56, "q/rgba32h56.bmp"),
+        (64, "q/pal8os2v2.bmp"),
+        (108, "g/pal8v4.bmp"),
+        (124, "g/pal8v5.bmp"),
+    ),
+)
+def test_dib_header_size(header_size, path):
+    image_path = "Tests/images/bmp/" + path
+    with open(image_path, "rb") as fp:
+        data = fp.read()[14:]
+    assert _binary.i32le(data) == header_size
+
+    dib = io.BytesIO(data)
+    with Image.open(dib) as im:
+        im.load()
+
+
 def test_save_dib(tmp_path: Path) -> None:
     outfile = str(tmp_path / "temp.dib")
 

From 34b3cb519c3235366c3881f4e8a59ef3bf2c22b2 Mon Sep 17 00:00:00 2001
From: Andrew Murray <radarhere@users.noreply.github.com>
Date: Wed, 10 Apr 2024 23:37:38 +1000
Subject: [PATCH 0511/1178] Converted example images to WebP

---
 docs/deprecations.rst              |   2 +-
 docs/example/anchors.png           | Bin 9726 -> 0 bytes
 docs/example/anchors.py            |   2 +-
 docs/example/anchors.webp          | Bin 0 -> 6350 bytes
 docs/example/image_thumbnail.png   | Bin 19241 -> 0 bytes
 docs/example/image_thumbnail.webp  | Bin 0 -> 2560 bytes
 docs/example/imageops_contain.png  | Bin 19241 -> 0 bytes
 docs/example/imageops_contain.webp | Bin 0 -> 2560 bytes
 docs/example/imageops_cover.png    | Bin 38843 -> 0 bytes
 docs/example/imageops_cover.webp   | Bin 0 -> 4164 bytes
 docs/example/imageops_fit.png      | Bin 28146 -> 0 bytes
 docs/example/imageops_fit.webp     | Bin 0 -> 3234 bytes
 docs/example/imageops_pad.png      | Bin 19499 -> 0 bytes
 docs/example/imageops_pad.webp     | Bin 0 -> 2566 bytes
 docs/example/size_vs_bbox.png      | Bin 12934 -> 0 bytes
 docs/example/size_vs_bbox.webp     | Bin 0 -> 4948 bytes
 docs/handbook/text-anchors.rst     |   2 +-
 docs/handbook/tutorial.rst         |  32 ++++++++++++++---------------
 docs/reference/ImageOps.rst        |  32 ++++++++++++++---------------
 docs/releasenotes/9.2.0.rst        |   2 +-
 20 files changed, 36 insertions(+), 36 deletions(-)
 delete mode 100644 docs/example/anchors.png
 create mode 100644 docs/example/anchors.webp
 delete mode 100644 docs/example/image_thumbnail.png
 create mode 100644 docs/example/image_thumbnail.webp
 delete mode 100644 docs/example/imageops_contain.png
 create mode 100644 docs/example/imageops_contain.webp
 delete mode 100644 docs/example/imageops_cover.png
 create mode 100644 docs/example/imageops_cover.webp
 delete mode 100644 docs/example/imageops_fit.png
 create mode 100644 docs/example/imageops_fit.webp
 delete mode 100644 docs/example/imageops_pad.png
 create mode 100644 docs/example/imageops_pad.webp
 delete mode 100644 docs/example/size_vs_bbox.png
 create mode 100644 docs/example/size_vs_bbox.webp

diff --git a/docs/deprecations.rst b/docs/deprecations.rst
index c3d1ba4f028..f530d5741c9 100644
--- a/docs/deprecations.rst
+++ b/docs/deprecations.rst
@@ -264,7 +264,7 @@ Previously, the ``size`` methods returned a ``height`` that included the vertica
 offset of the text, while the new ``bbox`` methods distinguish this as a ``top``
 offset.
 
-.. image:: ./example/size_vs_bbox.png
+.. image:: ./example/size_vs_bbox.webp
     :alt: In bbox methods, top measures the vertical distance above the text, while bottom measures that plus the vertical distance of the text itself. In size methods, height also measures the vertical distance above the text plus the vertical distance of the text itself.
     :align: center
 
diff --git a/docs/example/anchors.png b/docs/example/anchors.png
deleted file mode 100644
index 40476b0922b4494b8d154a81bf3788798b078d75..0000000000000000000000000000000000000000
GIT binary patch
literal 0
HcmV?d00001

literal 9726
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
Awg3PC

diff --git a/docs/example/anchors.py b/docs/example/anchors.py
index b5d76b4fe40..2ee11103f1a 100644
--- a/docs/example/anchors.py
+++ b/docs/example/anchors.py
@@ -26,5 +26,5 @@ def test(anchor: str) -> Image.Image:
                 d.line(((x * 200, y * 100), (x * 200, (y + 1) * 100)), "black", 3)
             if y != 0:
                 d.line(((x * 200, y * 100), ((x + 1) * 200, y * 100)), "black", 3)
-    im.save("docs/example/anchors.png")
+    im.save("docs/example/anchors.webp")
     im.show()
diff --git a/docs/example/anchors.webp b/docs/example/anchors.webp
new file mode 100644
index 0000000000000000000000000000000000000000..216b6c235a26b7515e3b756e38bc26b2c16a9c56
GIT binary patch
literal 6350
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
Q)Yh+1e63w>000000CfdR{r~^~

literal 0
HcmV?d00001

diff --git a/docs/example/image_thumbnail.png b/docs/example/image_thumbnail.png
deleted file mode 100644
index 293b05794659734d56726ce7c21310f16773e0b2..0000000000000000000000000000000000000000
GIT binary patch
literal 0
HcmV?d00001

literal 19241
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
QfB*mh07*qoM6N<$f=X7t3;+NC

diff --git a/docs/example/image_thumbnail.webp b/docs/example/image_thumbnail.webp
new file mode 100644
index 0000000000000000000000000000000000000000..9780f2852fe434eaaf8e3daf43fff9cca3799c29
GIT binary patch
literal 2560
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
WTqlomeNcSFZn48Lu{OAY0002oNf6xt

literal 0
HcmV?d00001

diff --git a/docs/example/imageops_contain.png b/docs/example/imageops_contain.png
deleted file mode 100644
index 293b05794659734d56726ce7c21310f16773e0b2..0000000000000000000000000000000000000000
GIT binary patch
literal 0
HcmV?d00001

literal 19241
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
QfB*mh07*qoM6N<$f=X7t3;+NC

diff --git a/docs/example/imageops_contain.webp b/docs/example/imageops_contain.webp
new file mode 100644
index 0000000000000000000000000000000000000000..9780f2852fe434eaaf8e3daf43fff9cca3799c29
GIT binary patch
literal 2560
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
WTqlomeNcSFZn48Lu{OAY0002oNf6xt

literal 0
HcmV?d00001

diff --git a/docs/example/imageops_cover.png b/docs/example/imageops_cover.png
deleted file mode 100644
index 929e1d874035f42e92017a43dcccc751ea50234b..0000000000000000000000000000000000000000
GIT binary patch
literal 0
HcmV?d00001

literal 38843
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%0AJS<ov`z6
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
Ta2hb800000NkvXXu0mjfV0nW_

diff --git a/docs/example/imageops_cover.webp b/docs/example/imageops_cover.webp
new file mode 100644
index 0000000000000000000000000000000000000000..a0b6c10bf2ffc5c6686eba10c7065780313b1c3e
GIT binary patch
literal 4164
zcmV-K5WDYENk&FI5C8yIMM6+kP&gnk5C8xWK>(crDwY7206uLllSQN=p_i&v#6Skb
zp(+3@&OnsS_uh9GR{7DSwl}3M!K_n$ANc<EC%Rt48Sm^HQV*K`8U8Pt-WdFm)H~VV
z==aw^ALpOk{M!EO&Cj$xZ5(8@1@U#!@7Dgo|C(e1QpWkqYhugNH=&>CuY!j)f+&*w
zl4DeCF)Hzl#N(Y*iG#X{H-ccb2pGbwXIQrFA;&J@kNt+|1PNaGM!_JUCod6Bb{<!N
zGjZW@L7+=;t~|8#WLx@Dhai_xak2(GW;X5Y8oR68N8DU2mHS>KM}FM6pxo>gsRE{y
zZ%Pdz&z%if*PPMM3p>8x@qw<-XQ5s)eR@9`pZ8bWbX?6U4meUdkH@M19~|rk%P9<q
zAI)Wq3`a!kJY_SBmfi+igLauj@0pZjSwkoe5$1erJsFUo@?lztd*Lq<E^0W6cD%~g
zg+oiUCtKk$2}*k&EI{JJ<fZ<C5Uh%nU^}%R&r(DbhCrJLs{UR~uo%?qd!Je%)dtNz
z*$f?TS?~H1Lwxpq0(@iHvL%Fa@3rd@F><;%LeW+6I+F45l=0t!M<^{g^6Vo)QBpy_
z0nyd=kFvFp<~+P|m_GFDr`<tlmKncHhBQ}zdhg<p_>hco>wjBTp7((s2=jS#9qBf6
zd0L$_>n0Xlsky_y&+B#;({8}pHCT<RE)kRz$ppUlVqJa!0RH|?9##$^0g~;eu10iO
zG>`wHceQyV1_!ABMu(BA5Qpd})iLiQcd?FGO`K!XF<V<YqQOdkG9N52|A6$Iri(g!
zk)6_oM;{xE1<Q;*>*$vWPS1$*6Np>ao;UfQLq7z+`3>p6=CVY(<sbR7f_Cf9@qBXg
z2#iIqW6uz7^oyn@a}vi-rG+izhJcUkhb2onANs{chvi?b*di-Q>XcWn&;68kTz>|>
zde~2NtLAdSUg^D!?rR#@(Qw|PHXd^b>$@(Orme5NR1JWU0zx~o4hau8Z@k|lT_&d&
zL|A<R{Z$F0a|jQF4{EGfo*dm6W7E5KtVqt^#1Q)$2PJik7Zk^emXrSE{C*X+A?|v`
z;R%4di(W%e<sU_!N{uLQo^kjUJX(yu^A>sPZ9EVSETa~4;Mki{j<<$_mCJDa1HG;a
znaTDK)ok<!33x3FFJG!)zgk^hW-)19d~xU?z%zLosR1oy;KIHe-omZ~3bY$^k8ONs
zJq_2}2)}`y=JDHV93QEyz_{1x%r4>ZMjYUaedk%@+0ndWcL^LL4L14`KCCDWh~!ZL
zE~ssbh15g_zw-OJJZ7Z#hAb?!&ioInIuj^sO<}*oDEed28k9DGPu%11{fJ^ud-F3U
z?OrW)JjE(vO!9uj8Ml>d?h{VKnekq9;RVf!5=k(`HQMJjRGs`5_UzTk3|tTCG*05U
z9nX*W?(T0kZA#!JXAbOtpRpS?*q^`lg>>Gm3GtRTW${kj8oQ>(ZY;ib8a%sWG;-mn
zAAr8GsH~8ryVq{Q5c<4uN`$>C9P6n=pn6n4AAaUf?=Ag8OZ(81P%xlWrpUf)Cvv=}
zZL6v$fk`IcGiRqEt?yWhK_zc+e1yS_*yJzb_P6sWR85^J%2e1;SpH6kZY2(RU&mu!
z#LK7y@pw=LolEQiHdBi;V&|$#@6#*TttwQSJ!EUR0Yw0KkmbtE!&q7NcIp@T<Zq9z
zn!qU^@k(U~G+GA^&uo1ror$}()neuQpsfOsA-tUg5qy0JQ+|tw*Pq2Oii3=yj%c%K
zi8HF%i;~ui`mYe|G2%%WH8>pUE(iOtaZ(gE?zN}o`ZByx?}-%d<=!L$(}IxI9e>o&
z9=$fGJ}PVq7jKOg+K&-CYin!$zANzl{~f4E>7X#jGNi@l`&G0G*+Q+7gLXu(h2xhR
z?L+2kDdtOJj;|Kb@p4PO9<y4OQnI$|M4<vvOPr!yE9fZDOV2C3eA?f_?3bbfX;bUw
z@|yW{e2p(kHx(d~%K_si-0XXl{XvLDLCpSuq9}cjm4B&7wprtocJDjg91{s>K7%}D
zDfw)xxO8a+STi_oZ<Pdb7I-hP5E9jkjH=a}0g7M^6Aoddh@B?k$j1KA;;6*EBc0<u
zs%pg!Bl5aVL@Y}Gw)l#w%>#y-5H+~x`jC){auevk!e9HY+R>7j_ElBT?(WCJ&K1T=
zp(}Cq;yEAv&NbQ`)>`<m!k7;2)XQcxFY_vT8h!d-I;iUvA3wWKSi0=GDjPtc(s4hm
zX869ydG1uKj!UNEX&^8lNLd%yIzKG4I7h|NaDdqB9ASZ?`MY*!K@-G0PJ=O$Bk(yp
zaOuKV71d3DU)?E}=EMz`On834DK||s0QCCq^K2e^xmPUs%bta~#gxVGkRTWtQ_c)p
z9OT*cl-az2NK*u>F}4OLb75}%n^9H8@9fuPhw8(6%n+tfEE+&NX1bWb@HXEcMdP<r
zm6qGXPaC*}Ipdd{5TH=gDZ1Zo+c$8EZqMg;3rmJ>_L}q^T~*Lq{wiPA9+W8Vm5vjc
z@*L4=dOy>OFnUDMk@mDHshgjv*T*&sB(gS6NtIhFUz@bZ8cdK|BSx;$4QRw+|7#qJ
z4WJa;sL4W+KkVFpl^w!@TJ>@OK3;I=*Tg9;kRnFen>-aJc-BIf^dokiqX@^&7qZ7~
zw`8B+iffIq?;b>`expOz)=E>bj5HL8uC_+2VF>flSy~N~Y&$njGxpAn6_bvt_FD6=
zDl;Qx8I)H3B_OcnqYlRqE)YNh<*fT8ez<vwAfkfj2;~p&%Pxf*<P~JzQV2-+I241V
zq`|6dC>mKs!j~D03{DhR|LS#vQ1;NAPMsWqd@KyiIE%l5UB3u6O@c}`o1BW3f3J@Z
zQoI5O1QpEMa%SrS=o?pHKzljJJ<{yp@=t-N1>nZH0|AlXF;HC^<UT|cSGnn!g+3(V
zHlzXYsv_wKG}+`V#nMy5=TfP4yikGE)1GB3H^bRz?|ZV{zGzZe2;sV#If%FxIGqE5
zaEj}I!om8YDV0D94A7~-X6WZM8&W)YK~w*<zhCn?lP%a%6SrGKm2r3O`kT?}W5=bz
z=m0-4(v?r(V*(yntk!^u@bL+KAw0}qj6_@T2Dywr6#y+kQc5^cu%a@hGr_3vQ*lAa
ze2nMS;TQ1+m6LT>h{6PvU$}i564MPx$CUVqj^p94S9z4}45PE4SCm(Xbi%33w;a61
zBL20JR6O-A+scVMBFW>fkve$9p3<BR#DfIZX0B1RJ75L7prDZ-sAP!@BldIUJVYym
zY3;Xi+n0m^j^PCsuL?}Qx7XB6rpE<ylPM9py&=BRv<D>#X`MGNG__MJaM4Z_(;Bq|
ze?iZMRO*htl-L{T=g1YLT*;FCMJ21??I;E+u9g3Rju;%#cK_j}2`WL7`LLW~$<TF9
ztX5RHH$b0QQKO!;^^#roEa4val~t6<vH%@w$IRr*9I<vn&iqRqvk%X|-WUqDv}moU
zsixQ^9XjSCjnZ1_lgl=W4*aXHvrHW=SW7G4*7<`+xTvn>M`+qnY~3#(PLPRVjO>}<
zawNaC%aVXVE$+p}23|$d?e(``8i(PNAv~5BYgUk`-VWonLdts(oKz{~Vo?{s|K2C3
zZmuUqY0BLRN!#R2$@13&5d-Cc{8Fq>b*au>RsYjO73S~0A%+W1fu|Ci5rBU!d?cq%
zj$e|9tH@f?Pi>Wie;(FscCW@J=6U)QL~VZzlk~(!i~Bv4nAWqEDBZO)&Q41Grl}Wr
zk;sB2y)mI0WF*PNPotsEK;aj7;{?S8zFncymO$(H5?$L(nHpSHqe&^$w0$LR=9eDn
z4SunGau=`uo+q-vfoP!SS^ew<fL69x<Qgsqv0!<#1b&;*BhDTe>Nhs*CJ<gT<jrEn
zs@#zG{Lv+kp(q%F^**iFc}H{D;Wj3y=N|2L5jpy^T@ZyLb4l9`io65uw;MeT^mR%L
z8HnvJT>AQ8+Zb95F%&>ZDx!C;x~(3L{|C6{ge6HUSi&3D9Q;^fmB#QD2ZZQ)O4``=
zA^yMj@*a5bJQ=k(T{{>J+@!am<(=vs4~xT>Ifdmw1Gl}OX3>7j8{(L{4eEFW5hxu7
zFE2my#<N;Or(VB=42}(zV(ZySB(FrC^>cL!7F)D35M3k0PIdmCm8Qfh{}6IN*jfOc
zz7q9v4ZA;8myT)9N;!#4A%GpWjm?puNw6-E7TDK-QBqza7Z12$*;uumzy=PluFBNk
z8$GZd7#|XLeW{ACc&A(bl-ks$_6Z%wVU#%MF}_gGWH@DSQWaixoXDcqWaT)G+#RH|
zE>c6w&RDLOY|fVZ_JVhO7XDJ1h2`_^78PoJdp}IwyI=|^%)sX4a&Wp-iSVeSiH&OJ
zW+q#ihk0qu%nc!(A07sPh|!Mo8$vwHSlxbt&oB(WgNotVMv~JvNbpY6vYU6wHPp`~
zf8k6ZSJgN`Lk-W^|4!%zfFPEXubK!Y3Y$L3n^R{>GW0MacXNG9qaV&KQd3Hqs<e-R
z|9-2~)0|Y&Wst`pSuvj0!b}x@hacY<Qo8HouxacEaT5HsKSvzLlH7B5(%qrfjUF-K
z3cr9ul3CgOrrF!(ge0X_S*EE0sA+9VgCLyi5VRidd4px|F=~})NgS%sjGVn3*vL7Z
zm{-XcYO8H=<gRWywwMQB-5dwr7SvYssE7+v40@GHWvzbkt*d5yA5)dzwKB1!KG=VA
z+^fU-r~-@df*2ti{!;8{9l@2lW&YyyQ70U#-7jX$oNt+qX_7h02KeW+srt?TnY9K^
zoj5Q^+iE$9qsb4umc`47b743wJ%<xw<_N+y{%Dn@%U{+t${AnTOXrR6xanWUWIz#P
z7~Q>#Fq7fX>L!Lr-MN0(4ev{nps}^T9oa_H=_VAgv8x-}VHWC%@)fB>awy9+MniE!
zQVDnu@e=~#9z++j_xV!AV2Da9a#WzttQkuZPusvK)ju@$-NZXY@6baQPZ&(0e}-qR
z!oWE`8%>Kx@D(dY<%NlN)u%a7Uyacz`Kli(yDwjr<03ilD0Gn+Ge7Yxp`gW>@Zske
zHR8DcKlih@ddKjS2cKi|q8)6?qX#Yv6xloqFL7_CTN~-><fwnV?WQ7p8ku{^)1FHn
zuF3F}fj7t*0`5af+RvR`gYlaP=yp44`3xc$6}&KoMDo}M$Up6oAL)t=TK^_E9Ys{W
zZ%8G2&`E8ZN1}-03MQ<SUmz}jzdF$>!GGS}vW&{!8>OQ)^2Z`p^{y7w7YfK;fYxN7
z?PASHbWfyXLhPb&XG%m@RKFglhS;xuS7ec?7*EpEV0Hsk&hnCNw+M0R)Y3wi>$cr(
zb9@9APs@z_G8In4mR}x*+Hm74M)Mj`BJ2JD=F4LtmwDu2&HJG7XH0o_e+i|vfu=tu
z+fF6KgQI7f%5tq!3&!Z|w^Jg(PBQNuSlR2#efpOC5aIv4l_Y<6gX6=2Hn6E#LjhS1
O3znKIDw7Iy0000#)g(Cp

literal 0
HcmV?d00001

diff --git a/docs/example/imageops_fit.png b/docs/example/imageops_fit.png
deleted file mode 100644
index 13a3d5e3febdf3cc465f2bcc45dacfb817a5e7f7..0000000000000000000000000000000000000000
GIT binary patch
literal 0
HcmV?d00001

literal 28146
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

diff --git a/docs/example/imageops_fit.webp b/docs/example/imageops_fit.webp
new file mode 100644
index 0000000000000000000000000000000000000000..803ee66d244a69103a26f0cacd4071dc2c10d66d
GIT binary patch
literal 3234
zcmV;T3|;e5Nk&GR3;+OEMM6+kP&got3;+O7FaVtaDr5kb06uLnltv^YA|WagJotbO
zi9i}fh5_OGzp-z53%7r`<U-?b(;vU|UK9An_l|*?H?*Iv55n_XzyFV#fqOgsR{015
z`q9MJnjHfFM*2GF_v`Or18xKMYhzqxR<=#vnfNMc62ih}e3xQIU!hCRPR5{pJmYDL
zVY<*%AmMx5VuQWS%K&$@?3SGVZ;Y*-pgx@BzD;v1;X2Cyu=Xhi{1BDJ-J)4EUUh-k
zZ@+%_huwg})zNlRgAux{1ct}wJV$`4f(Jru2?gZ&Ou(85xwrcqJK77@ZqM1CebvGg
zklOOP;ejd(KGX>0d7fFsobcRg4|=keyL1%2-4%$$9^2Lzx*atVL)~9Cj1*s5eyQ&e
zUC;i;V2WHAH&rS((KpWXSLR<&r=ie9k+b4^M2Qbs+eY=5=BE=GW_gf2i+s+?R~NwL
zGB?VG_WKz%G`@)(4N$d$tDT^QvPjcFC{cHS;4#LPBM}<)tDfPXy?k1f&sfcg-R-b&
zVuovX(EtGc{vVkMnqD{Q{mjfZz&EzWGgGq0UIl+$W8u49W7WtuRpI`E<f0GV3(+=?
zf&}N|QUCHi^A7zmDnt|Bv{=WwPty&-ht3n(+x4k`>4_<LU7-jg$PfmIH#R9P>y=59
zGj52OHD@P}*2R_~Lzg*>86KmU1blcgE3(m>-oBYPZS&><h-g&W%WWcQb0V^{(Wwv8
zr)oA))6IM|Iu7@pd0RgZT}IyjA$S>`EzNt24kt8u?(cbhNGGvsXd!W}c2xbH?2pZr
zkY(HFPG)v$<>~Va;@*f4Ofbw)rrCzg&o?4c-<p;PUJKg?a;L<&l{M)||E8(p<WAXd
z@xHFfmdV?JyAMsg3W`4Bi!pM3<C^lR&Y&>xHk#M?F*N*cAgz#OBBJI!RGRu6ovYt<
zrIZdBy9s^BLBMA@6hTk@a?Q}dsjlrf4!-Ux)oWW(9i*((#fqL`8=hXp<BW9;X#$}O
zs$>9Y`Dur!rfo$Gj*+iPqbjp*V38In-HZ)MXG=tK!tPofWS%HJJ}xOYHaT8^ZYw*i
zuMh0chV<3%OpD|+`eXk2rjiPN-mCO7yrv$aUUoxiW!w75IH<_&$0STfm!9f}$b%VY
zbdhxfvp~UR6??5?4nUOvZPieQ7~b+HYWKD9%+;Z;ee~bOdQ5t?Qr<R+IcinuxksoK
zbGYuwfd-}yxO)|^@3dBQ?ces%&h=jM@9b?q__}u;HnSUa`#b{Vgkc(NbI%qyt8M6*
zc38MmD@d9$JWMva(dUbFA>W3!i%xTKPP08V5lJ$G-2#MOjQ}ri==j{^^C%~;9-wl|
z6PW&7PIc^km+}D4l`4Nhf>4&A_~I(nY<6<~GW4(b6CA5?A`~A|X<bdGghs(f*ua%w
z5;==2Lo4N*g&Us6NEI<8_7{UyKE^M|{!3FE>*MFNaFaPcap43vU|}UNb%Z^}<Qd4#
zob2i`jop-6gTab+H`lCq$PWL9ZZiJd1*f9w5jlDE`R2uZ3lta7L1`7b?)a!mp*>~3
zNGPD*H)E6Br&hA3o!M`YcQ|VGDa#|lHh9lqqq!9}x~b!M7I!lo3M$-2xn-T;PTTou
z0>Yir=9&Frc9<O#==F_vO@iAuF`cMu3=v#ZZnh`~dmw4pI5C>j8IQLBy%{X+uy*uN
z5p{VT5FN&`Xo~6XgIOo-blUFlYl!tKE*F&+<l9Kjz|_gC!vQN?>JEcCwl+nY8_~vl
zmaH;*)Uf>Q(q=0YI$>9D4WFWCq)F%Dk<KW?(eu**78+yZ2}q#lm*`SK04{O)O9E9e
zfhQaTdd3etNxeyti3?x%@KhntIyg|SO{qLnG1Gw;mggeBY82~h60vL*gZ}7F*2*z(
z06p-(7RZR7V5SY0LDH%D-gvM<x6uHXELkJ}@~zCqI9h#gz=61*^gCnA4SEURI2E|O
zktHpW0(93pdyjnoZIAxw81UrX`sjfg%6Rj}z_u&-h=8d^TvVo3T~%N|{6{-};E8!&
zNL(eY4wMB0YSC)j+JN`{iTYi}A<}mO?yO=cK{=h0e&jh*Saz2DH8UXPi$5754^M(F
za_EyqnWgEs0q^}hwAOb=iAz=tgZ>o_7&<9i=l74uj2ZV9V2_U&89+y11V|?D-Zx$2
zm-{9rM&n@@9f!j);tP)c{@9qSi_|3)CIMo>6+u(SC=4Hu^5VOj$WHNB&b~(3D^c9O
zL9^WZag<AZeH>f1gW`>Yb&YNa4Z=I6s}v(9{lmc&SjX`eqrHQ_`e4q{F%EyYvvyis
zJsiiMbZ?TpOAa}k_Bce*m_;ZlvW>tN`ZGwy!SO4`!d_%zG_I(UEF_mf0bTQ!?6ov^
z2Tyuc`7;3{dnLUoNJAK?bxD2<tU@#mu-#Qy@W-*5(E?DSY(VkF0X5Z58D)siNaq`G
zuq?P+wDkeBr=kQ2tCA`nYn7`%Q8PR>&v}7?uOl0bOD-yjyIgV~6H<J24HJ3yb6cuH
z6RESHC37>-Hd_+Fy0KXn<d0wVL%XgQnY((92Z$X@P<MTgL!wIpE9K8E;l2&`s{`he
zBPn5w0B|$2b%ZJu*2B~~CRKBccuqI9PDME0#U8@WKMQ@B_y)sCg#*9$V1gRKAjTqB
zm|(t|;A@M#W`*tQ+{xxt5|4GkQNJzuZ~^70N{6Pnlf*J8hUzw3G$o6T_G`zb7~b^w
zb<Af(vcHP`2kZgiL_~q6TVE!B@&D7j2nd+K&jF^Ibt*@$mv&Y)mM+uR0Kua@^3&s(
zZm_^}nJJy@O3UB@v1K+=InZu#3%bODO`VmNh8?`}ZwBH5L9p)JpH_@WB57s2sD2ME
z)`Y(p!n1Bi;R#$i1jWa5oi`Tg2O^YHQFlH4HQGO~ATJ(1&65gBLiGXI@Vx1C{ABun
z9VD7C4O6{A{~|qk4|WKf8KoTw(UU;$-Nc#kIu5Hkhp2eYzf$kUUC$C5RZ@OVS-@9X
z+r-|mA_3->$gFIq_9F$XZ<QNfaS}7n=?jpvF<wBa@vx~f`XHVdR0RRw|9m5e?~nmW
zln8uEIzra>WMA3;G{1y-Df3B|XTo|Is;P}4xrOgG-K8xw(<0{6o&@T#dCQHDH)^xD
z!B3#GQqKQ*7)I7wFZzMcZm9P{0XN|n2VLzmIBxvnJ6u-iGkcK=d^9si>kx5C-m>{8
z|H8_P{CfGtFyiJwa&=#r#ooDl8gzS!2Lqa`&t^W18DLe*zUR>`(9_SziPU?vs46Zn
z`H{Y*m3>oVasP0p#8WC5qK2??ICdxh;t|$|wGWBs4;#T&m?1~cq<D%=Tr1`gQGv_t
zsp}o@jN|DyBAS=C%fOC&quWa67?%=fyJJ32J<_rJEXDN^(X%ni=ha6&$NS3otp`A+
zA9wkZ?+IL{ZcgD#^i;m`x%Ks<6>J9Kyy&aMts8~An%uz<a*3wzb!?mpwXCEMGf1sm
zwDXUA;<-mr_6AB+rDF1#L9g84(59xEi&04I7cYoN+1&JEy^vZbR=7|O+!7ii5O%?M
zC<i<VO@67+$CIs9k;W!X>aFb?i3{|Qugb|~0+#7$SI4Z!e%`$ch711C3ckn_TetZ-
zO+3Kq$1(1BgXGtePcRk5td@#13ST;Qv!iT!83bW3c|PFe08;v(tK5XPqA}HuFEjJH
zPi<1}raqcSo|JrXos@0p8R!p@??$I)bFtA@@lR{&%6##^jqn_dda1s|+wtjkKKhDu
z?}*PL0)<9#8$10=MHp8X|5ix;Z`e+xBimEr%0sd9`gC*1o|bm9ecNju2&5$Ow_ims
z{rn}rGHUo&AYsY^f33Ub+%U>_ZP+eR3`(P(4xOPXI|mYUnqSP<+mrOjx7#zF5G`^n
zbLIBFI<eDnBkG@Wv8bw?TWhnedEx^ERpN7!jnm3;|7-)1cpyxwa{07vmJ1%uJY+W@
zjhDwzKDEGp?Pdw5TSs)U76sRUBG|m~q+0x=y*MDn`HT;WIASfOXE)hdw-?<&%+=2C
zIzd@ER~LNwETMU*TiBgyv-XW#*vI{)6o*_0?W#-NBlU|bPeDQr5D$RAC6pzMCJU}n
zXtL7h^9wlT2Q6e@<O}X_fvU=_2W0w6$?txnW}^#Tz5YB|9LH~m!v^y?=-HRXX0G78
zcs-&dW`!R%>bH?#zZ|?QfNl<*u75HIh6>GXdzXCFXnUY~v$D&bX&nFncx{sVV1Lvn
UY|ak18$7Luuv>?D<lX=P0C-eY3;+NC

literal 0
HcmV?d00001

diff --git a/docs/example/imageops_pad.png b/docs/example/imageops_pad.png
deleted file mode 100644
index 69649d6e5fcdfa57f013d9d8a0a9dcccc98080e5..0000000000000000000000000000000000000000
GIT binary patch
literal 0
HcmV?d00001

literal 19499
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

diff --git a/docs/example/imageops_pad.webp b/docs/example/imageops_pad.webp
new file mode 100644
index 0000000000000000000000000000000000000000..0ab63ef42e02a5408d79beba6ea393c4d5fe47c0
GIT binary patch
literal 2566
zcmV+h3i<U?Nk&Hg2><|BMM6+kP&gp+2><}_EdZSXDr5kb06uLpl}4l^B%vx5+bEC?
ziDCfJ^$Pz0JO96@p!|sO^wR&E<61D*$p2CPtJy}~Uo*e2KdxTxx^!FARqKC<@bAfg
zt$n@zwa+#qUn%?L`tBkA6lw+RZ}nULU<2!i{67tyQ+y+?AwUn#9*DXS`n%XerD4+<
zQ|GBD@`~w4cb-`8tjKJTIG>#v(h#tC0HU`tHuSEr5um=c?B99snuwqhCR(fzwAd0y
z96<e}5Kk2+I#X<+5W}wCvx%s*S(rbEwxg2pKGQz^p!P|)qLZ_oeO<*;CE9l?+ZKc<
zh6m50g@AuGVMpbJ)idH&mXu#E^6-tiz5ODyleXc+xw)BKH7OkmO*%rsvN#8_@gc%6
zHb>j;-Wv!>kNeVL$C!_%uyb<e6(ugY7W;f!%r1m{s8)txmzg7$^ZXlr953H>1UiXy
zj^FbH<c%+V%I|3t#dlW$vgR`j!hUb{#+$sOAw>jQsST>1KDqz^{_-MOLzAlY_i66m
zKcK_?1|Rwf001=n(Gq-R#)X%}qx8Eigd-x&&G0vJlJWRO9?Ow;M-Zs~Uf0@?454U*
zN|HXmM3zUg$O?9TdB2saWp<XqLQV}p%W(JRtv=wMKd%J$VB;lMO#4isu*>0&jraQ2
zyM9YgPIT@Y^=S)AETbZC*=K+5cEM!!S3K5%Bpc9{k+W6(i5MpM{67Pa7ykaQd&TsD
zD_Rm<M2Sp6qS#PRoIZ60C-ibV$4CY6BCoM&=A(|<0uQ`O%jRy)&U&Z?u-@%>i9ZJo
zPP)~Ucg)k3_f0+0RT#Eyg4WxjnN$iPzOouG&+cF4H3PRr_0jYxeog*WX*(OhI33CN
zQgp(h*CICFcfve#+^qhF8$}TfIYn4Ui~p<6#)sKoGg|893UV;D$yx9d{+3=d#gfg<
z**#~URZSapb8Ddej+@i3=p4db--wyhiP<1Ng+>NHyQBOZYeKz$Y*7tPa>vLK5!kV_
zpXbTb>@>2+lO*k+zDANfvHid`qoQ>)`^r#+@UnfZZ@gIU4Cw4dYFne!+!i`H<{)Qr
z`-s%zp*B2moab{)4V5PC`CRPX*_?y^e|`eJ9cVE8*0c$laytL1h-fz}QztIs$|9I7
z4<&l;OL8Y6WgElZc00>W!y-2onzYX{2e!|}8zp6njQx;<Sc`4}2qG}85-y?j->ISs
zl=VGg)rz)$2GE7FD$MY0@X}tNtzENFxcg*oe99#p=#%I-y0ebp2G)Tg=u|<<6B)sc
zyvEJ9S6uDV{j-7o6m7tsSj42?7w{9Y-F)<T9<v6$=0{#y8<g8sykUb);X9z!hC3dd
z7$%yk?Wb~V5Mft0D$VXMKo`roV@-u_LfJB`Kd<7O?7Q(#bqCDmGRCUJz1PzlYA0O{
zy4lQ&!B(i2Wl`hG#QiFbNat|;HOVPPdlL&@x@rUDuQD~X%A9a9u!hZVhbtNlDhry<
z<*To(1FJF|TQk%p0Wvf@`2=GRu!`z0G{Y6yE%vKEN+XG5?WQ<}(k{h8XEdA3LBckW
zuiphcq6b@r{%QYo>&yf<pVM)vm67qbNe5Ju4b5)8F)8g?sISJv3`Mp?_@f`gWWp#n
zW7O?8lJSQ)py9Jzcs$~Y<DOQaXC(WM`zTS{od~k3mTQ&F{c$3>NFChlRS4uhp$zpp
zNRgn^YXz>9*dy9d7fO~gObFD451h8zcCJLv=aV+epP@7q{EJD0pmGz0wgC+@YiCbj
zwxF+)u37X7H&a;kn9J*g(7qkLFVxLgNgD)NmE?gF>qLElP*d)aP<;!6W+uDG`pqxT
z+|e4wQO3pe%f^FSA9ln>zM87ejd1Re`eQRb{1XXoS<r}v$S#_wVyLtGr38OvspTFw
zEwM9{3bzhK?EOCbLL4vfrU<g}49nb_1{JtW(k+Fkl<cxMaw%?TCJ<6Lq{9G=?8xLQ
zadNXFTr}G~Ime<)RC9RCv;ROiK$oytcdhgv4UO-3%;=7tVWY@E(J)`%W4*{lxSF3F
z5KxB=YQDJI=g(aYHRC`&fVv$MWe4I|a-kmTZrG4#kqfL;F?o7izs8@<!#Y<h6651|
zAvqk#*-Y{AO?9sFu!QveIk;X1^~HT;g_$KdZU8P-EZUIwp%?ULkL-Y8fe*b~jLItM
zTM6vgtrmwWo#p@LgUa?&WC``uxL}cUB_aJ68`r>G+bjqAXqxlLMqKGmxzN#J(AS%$
z`H4eb)Q+`og&|+8H7JQ~sV10(QEWQGYJR3`HciMsU6&$Z#~omu#YRJyRT3sUgo>sJ
z#f8o7`jcB3^;_Pr7sv&M@JdMeAU4<Nf<afXIwpWYHL`yNI4nkdwZSDoa5})#gOwK@
zJ7&+k+D2Y|Ers80=@bw>ePi1Q$AIh<VF$I&H^ddRQGRRdla;|He)3@b48d%~_nQlj
zNsEwa8k4!Hxn}-`t}?$$OMKA51N(fqzZvj!`GrO<Kw5X%?v3E&ff_eON{v!OCjvct
zc(HIeT-?PW*vxWSWRtb=^uQ6xfYhK!ga)`9RavDgX6t>CQ2$|o^=*Psu@~|+Bgoq3
z0O(5S7rM72!E@>JCs|z^Mgr9br9R~WMhR%te?zH>jYJySivKXdZc;U8C=(P0dDG8r
z0p4cdv0ytUwwQygUW@Q&B`ba#Z^2))rh(Oj=0sY<EkZE8<V`@&GL>KXq`A!xCAmde
z&%Tf0=P(iiaA~RJ@aQ*fg#xDUTy|K6tvHNgUsJZvFKhrveSM&M-*^KHJ3Gt*%Y>$V
zhL4ZqLsI4}Y$O=J5f;WUCVv7ZI_e$cq^92s6+3AErIJZteo6Zr+Sk^bn|*lGmq?aj
zYshZ=iVk)q5guk5`_)8=7o!;Omcx~&(OPz4*{o-P3jkt$9_Vwm9vEu5`k_;t{H=qP
zb>Mb-rgDhKF~NfgD$<4isav)!BIC1d=btt+<n29gPPQCAF#kj^Q{-2`?bC3o9sC;m
z!Rkr2x~1OTL#^iLy138y1EVyzx5C9c43_*l&2RI^w)GM~DatV}h^(1uK2Xqom>i`q
z4eIg(WC%3=z_Zf|Hy8gk+P+5J1p})EmQ%-DQ||BzCvmb+Np&xEO&q9`3LI<hkUi&A
z<`SKKU@SX62q>YY|Gt<nnzgjw8RJg7G8}B<1y?up4mY>k6X}gz$1@`h#_IZxf+QSH
zPuHqPPE@El=s?46&UXO>PFfD9L`-YzaB`iakyKLs&nk%c=3?b9e^?*07J%lYp;eDF
zaZu;qkSNax=dC8gjkF%4FZA&Q8kY2+7tm%m5j9VkKGRKZfC05Ljs--Rm=@+E%u5d!
cs5@GC(gS8<O*t4<R8Ge@00000000000I0D8lK=n!

literal 0
HcmV?d00001

diff --git a/docs/example/size_vs_bbox.png b/docs/example/size_vs_bbox.png
deleted file mode 100644
index 11a05d2a8146a612741c7e4ec4d3cf0ce05a35a0..0000000000000000000000000000000000000000
GIT binary patch
literal 0
HcmV?d00001

literal 12934
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
S1_tO*7#T?giAu0x(EkB>8JTGS

diff --git a/docs/example/size_vs_bbox.webp b/docs/example/size_vs_bbox.webp
new file mode 100644
index 0000000000000000000000000000000000000000..391162d2d4ba02f3ebf4d866a7fdf458c5612faf
GIT binary patch
literal 4948
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
SC^AeeSg-&9000000000w&A&VV

literal 0
HcmV?d00001

diff --git a/docs/handbook/text-anchors.rst b/docs/handbook/text-anchors.rst
index 3a9572ab221..48de4bc9531 100644
--- a/docs/handbook/text-anchors.rst
+++ b/docs/handbook/text-anchors.rst
@@ -132,7 +132,7 @@ of the two lines.
 
 .. comment: Image generated with ../example/anchors.py
 
-.. image:: ../example/anchors.png
+.. image:: ../example/anchors.webp
     :alt: Text anchor examples
     :align: center
 
diff --git a/docs/handbook/tutorial.rst b/docs/handbook/tutorial.rst
index 523e2ad7494..6cb1e26392c 100644
--- a/docs/handbook/tutorial.rst
+++ b/docs/handbook/tutorial.rst
@@ -278,26 +278,26 @@ choose to resize relative to a given size.
 
     from PIL import Image, ImageOps
     size = (100, 150)
-    with Image.open("Tests/images/hopper.png") as im:
-        ImageOps.contain(im, size).save("imageops_contain.png")
-        ImageOps.cover(im, size).save("imageops_cover.png")
-        ImageOps.fit(im, size).save("imageops_fit.png")
-        ImageOps.pad(im, size, color="#f00").save("imageops_pad.png")
+    with Image.open("Tests/images/hopper.webp") as im:
+        ImageOps.contain(im, size).save("imageops_contain.webp")
+        ImageOps.cover(im, size).save("imageops_cover.webp")
+        ImageOps.fit(im, size).save("imageops_fit.webp")
+        ImageOps.pad(im, size, color="#f00").save("imageops_pad.webp")
 
         # thumbnail() can also be used,
         # but will modify the image object in place
         im.thumbnail(size)
-        im.save("imageops_thumbnail.png")
-
-+----------------+-------------------------------------------+--------------------------------------------+------------------------------------------+----------------------------------------+----------------------------------------+
-|                | :py:meth:`~PIL.Image.Image.thumbnail`     | :py:meth:`~PIL.ImageOps.contain`           | :py:meth:`~PIL.ImageOps.cover`           | :py:meth:`~PIL.ImageOps.fit`           | :py:meth:`~PIL.ImageOps.pad`           |
-+================+===========================================+============================================+==========================================+========================================+========================================+
-|Given size      | ``(100, 150)``                            | ``(100, 150)``                             | ``(100, 150)``                           | ``(100, 150)``                         | ``(100, 150)``                         |
-+----------------+-------------------------------------------+--------------------------------------------+------------------------------------------+----------------------------------------+----------------------------------------+
-|Resulting image | .. image:: ../example/image_thumbnail.png | .. image:: ../example/imageops_contain.png | .. image:: ../example/imageops_cover.png | .. image:: ../example/imageops_fit.png | .. image:: ../example/imageops_pad.png |
-+----------------+-------------------------------------------+--------------------------------------------+------------------------------------------+----------------------------------------+----------------------------------------+
-|Resulting size  | ``100×100``                               | ``100×100``                                | ``150×150``                              | ``100×150``                            | ``100×150``                            |
-+----------------+-------------------------------------------+--------------------------------------------+------------------------------------------+----------------------------------------+----------------------------------------+
+        im.save("image_thumbnail.webp")
+
++----------------+--------------------------------------------+---------------------------------------------+-------------------------------------------+-----------------------------------------+-----------------------------------------+
+|                | :py:meth:`~PIL.Image.Image.thumbnail`      | :py:meth:`~PIL.ImageOps.contain`            | :py:meth:`~PIL.ImageOps.cover`            | :py:meth:`~PIL.ImageOps.fit`            | :py:meth:`~PIL.ImageOps.pad`            |
++================+============================================+=============================================+===========================================+=========================================+=========================================+
+|Given size      | ``(100, 150)``                             | ``(100, 150)``                              | ``(100, 150)``                            | ``(100, 150)``                          | ``(100, 150)``                          |
++----------------+--------------------------------------------+---------------------------------------------+-------------------------------------------+-----------------------------------------+-----------------------------------------+
+|Resulting image | .. image:: ../example/image_thumbnail.webp | .. image:: ../example/imageops_contain.webp | .. image:: ../example/imageops_cover.webp | .. image:: ../example/imageops_fit.webp | .. image:: ../example/imageops_pad.webp |
++----------------+--------------------------------------------+---------------------------------------------+-------------------------------------------+-----------------------------------------+-----------------------------------------+
+|Resulting size  | ``100×100``                                | ``100×100``                                 | ``150×150``                               | ``100×150``                             | ``100×150``                             |
++----------------+--------------------------------------------+---------------------------------------------+-------------------------------------------+-----------------------------------------+-----------------------------------------+
 
 .. _color-transforms:
 
diff --git a/docs/reference/ImageOps.rst b/docs/reference/ImageOps.rst
index 051fdcfc987..fcaa3c8f675 100644
--- a/docs/reference/ImageOps.rst
+++ b/docs/reference/ImageOps.rst
@@ -36,26 +36,26 @@ Resize relative to a given size
 
     from PIL import Image, ImageOps
     size = (100, 150)
-    with Image.open("Tests/images/hopper.png") as im:
-        ImageOps.contain(im, size).save("imageops_contain.png")
-        ImageOps.cover(im, size).save("imageops_cover.png")
-        ImageOps.fit(im, size).save("imageops_fit.png")
-        ImageOps.pad(im, size, color="#f00").save("imageops_pad.png")
+    with Image.open("Tests/images/hopper.webp") as im:
+        ImageOps.contain(im, size).save("imageops_contain.webp")
+        ImageOps.cover(im, size).save("imageops_cover.webp")
+        ImageOps.fit(im, size).save("imageops_fit.webp")
+        ImageOps.pad(im, size, color="#f00").save("imageops_pad.webp")
 
         # thumbnail() can also be used,
         # but will modify the image object in place
         im.thumbnail(size)
-        im.save("imageops_thumbnail.png")
-
-+----------------+-------------------------------------------+--------------------------------------------+------------------------------------------+----------------------------------------+----------------------------------------+
-|                | :py:meth:`~PIL.Image.Image.thumbnail`     | :py:meth:`~PIL.ImageOps.contain`           | :py:meth:`~PIL.ImageOps.cover`           | :py:meth:`~PIL.ImageOps.fit`           | :py:meth:`~PIL.ImageOps.pad`           |
-+================+===========================================+============================================+==========================================+========================================+========================================+
-|Given size      | ``(100, 150)``                            | ``(100, 150)``                             | ``(100, 150)``                           | ``(100, 150)``                         | ``(100, 150)``                         |
-+----------------+-------------------------------------------+--------------------------------------------+------------------------------------------+----------------------------------------+----------------------------------------+
-|Resulting image | .. image:: ../example/image_thumbnail.png | .. image:: ../example/imageops_contain.png | .. image:: ../example/imageops_cover.png | .. image:: ../example/imageops_fit.png | .. image:: ../example/imageops_pad.png |
-+----------------+-------------------------------------------+--------------------------------------------+------------------------------------------+----------------------------------------+----------------------------------------+
-|Resulting size  | ``100×100``                               | ``100×100``                                | ``150×150``                              | ``100×150``                            | ``100×150``                            |
-+----------------+-------------------------------------------+--------------------------------------------+------------------------------------------+----------------------------------------+----------------------------------------+
+        im.save("image_thumbnail.webp")
+
++----------------+--------------------------------------------+---------------------------------------------+-------------------------------------------+-----------------------------------------+-----------------------------------------+
+|                | :py:meth:`~PIL.Image.Image.thumbnail`      | :py:meth:`~PIL.ImageOps.contain`            | :py:meth:`~PIL.ImageOps.cover`            | :py:meth:`~PIL.ImageOps.fit`            | :py:meth:`~PIL.ImageOps.pad`            |
++================+============================================+=============================================+===========================================+=========================================+=========================================+
+|Given size      | ``(100, 150)``                             | ``(100, 150)``                              | ``(100, 150)``                            | ``(100, 150)``                          | ``(100, 150)``                          |
++----------------+--------------------------------------------+---------------------------------------------+-------------------------------------------+-----------------------------------------+-----------------------------------------+
+|Resulting image | .. image:: ../example/image_thumbnail.webp | .. image:: ../example/imageops_contain.webp | .. image:: ../example/imageops_cover.webp | .. image:: ../example/imageops_fit.webp | .. image:: ../example/imageops_pad.webp |
++----------------+--------------------------------------------+---------------------------------------------+-------------------------------------------+-----------------------------------------+-----------------------------------------+
+|Resulting size  | ``100×100``                                | ``100×100``                                 | ``150×150``                               | ``100×150``                             | ``100×150``                             |
++----------------+--------------------------------------------+---------------------------------------------+-------------------------------------------+-----------------------------------------+-----------------------------------------+
 
 .. autofunction:: contain
 .. autofunction:: cover
diff --git a/docs/releasenotes/9.2.0.rst b/docs/releasenotes/9.2.0.rst
index fe29f2e4f05..6e064734391 100644
--- a/docs/releasenotes/9.2.0.rst
+++ b/docs/releasenotes/9.2.0.rst
@@ -98,7 +98,7 @@ Previously, the ``size`` methods returned a ``height`` that included the vertica
 offset of the text, while the new ``bbox`` methods distinguish this as a ``top``
 offset.
 
-.. image:: ../example/size_vs_bbox.png
+.. image:: ../example/size_vs_bbox.webp
     :alt: In bbox methods, top measures the vertical distance above the text, while bottom measures that plus the vertical distance of the text itself. In size methods, height also measures the vertical distance above the text plus the vertical distance of the text itself.
     :align: center
 

From 82b7b8a9ee1c474f1f78132d4de61e80c2f434a8 Mon Sep 17 00:00:00 2001
From: Yay295 <Yay295@users.noreply.github.com>
Date: Thu, 11 Apr 2024 00:29:31 -0500
Subject: [PATCH 0512/1178] Fix some comments

---
 src/libImaging/Pack.c | 4 ++--
 1 file changed, 2 insertions(+), 2 deletions(-)

diff --git a/src/libImaging/Pack.c b/src/libImaging/Pack.c
index d47344245cc..f3b71421595 100644
--- a/src/libImaging/Pack.c
+++ b/src/libImaging/Pack.c
@@ -339,7 +339,7 @@ ImagingPackXBGR(UINT8 *out, const UINT8 *in, int pixels) {
 void
 ImagingPackBGRA(UINT8 *out, const UINT8 *in, int pixels) {
     int i;
-    /* BGRX, reversed bytes with right padding */
+    /* BGRA, reversed bytes with right alpha */
     for (i = 0; i < pixels; i++) {
         out[0] = in[B];
         out[1] = in[G];
@@ -353,7 +353,7 @@ ImagingPackBGRA(UINT8 *out, const UINT8 *in, int pixels) {
 void
 ImagingPackABGR(UINT8 *out, const UINT8 *in, int pixels) {
     int i;
-    /* XBGR, reversed bytes with left padding */
+    /* ABGR, reversed bytes with left alpha */
     for (i = 0; i < pixels; i++) {
         out[0] = in[A];
         out[1] = in[B];

From c1f6abbd3746d8332b6f9aae69f1fd262a246257 Mon Sep 17 00:00:00 2001
From: Yay295 <Yay295@users.noreply.github.com>
Date: Thu, 11 Apr 2024 14:07:07 -0500
Subject: [PATCH 0513/1178] Fix test error message grammar

---
 Tests/test_image_resample.py | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/Tests/test_image_resample.py b/Tests/test_image_resample.py
index dbe19380831..9b3bdf3306f 100644
--- a/Tests/test_image_resample.py
+++ b/Tests/test_image_resample.py
@@ -284,7 +284,7 @@ def run_levels_case(self, i: Image.Image) -> None:
             used_colors = {px[x, y][0] for x in range(i.size[0])}
             assert 256 == len(used_colors), (
                 "All colors should be present in resized image. "
-                f"Only {len(used_colors)} on {y} line."
+                f"Only {len(used_colors)} on line {y}."
             )
 
     @pytest.mark.xfail(reason="Current implementation isn't precise enough")

From 7b9a276c7f2dcba699bb2d9c7530f70bb499fa00 Mon Sep 17 00:00:00 2001
From: Andrew Murray <radarhere@users.noreply.github.com>
Date: Sat, 13 Apr 2024 13:47:52 +1000
Subject: [PATCH 0514/1178] Updated libwebp to 1.4.0

---
 .github/workflows/wheels-dependencies.sh | 2 +-
 depends/install_webp.sh                  | 2 +-
 winbuild/build_prepare.py                | 2 +-
 3 files changed, 3 insertions(+), 3 deletions(-)

diff --git a/.github/workflows/wheels-dependencies.sh b/.github/workflows/wheels-dependencies.sh
index 0d45d5a209d..0cf5c58ab8b 100755
--- a/.github/workflows/wheels-dependencies.sh
+++ b/.github/workflows/wheels-dependencies.sh
@@ -33,7 +33,7 @@ if [[ -n "$IS_MACOS" ]] || [[ "$MB_ML_VER" != 2014 ]]; then
 else
     ZLIB_VERSION=1.2.8
 fi
-LIBWEBP_VERSION=1.3.2
+LIBWEBP_VERSION=1.4.0
 BZIP2_VERSION=1.0.8
 LIBXCB_VERSION=1.16.1
 BROTLI_VERSION=1.1.0
diff --git a/depends/install_webp.sh b/depends/install_webp.sh
index 6f867ab3788..c47fb35f125 100755
--- a/depends/install_webp.sh
+++ b/depends/install_webp.sh
@@ -1,7 +1,7 @@
 #!/bin/bash
 # install webp
 
-archive=libwebp-1.3.2
+archive=libwebp-1.4.0
 
 ./download-and-extract.sh $archive https://raw.githubusercontent.com/python-pillow/pillow-depends/main/$archive.tar.gz
 
diff --git a/winbuild/build_prepare.py b/winbuild/build_prepare.py
index 0d6da77549f..7ff645fc9ef 100644
--- a/winbuild/build_prepare.py
+++ b/winbuild/build_prepare.py
@@ -117,7 +117,7 @@ def cmd_msbuild(
     "JPEGTURBO": "3.0.2",
     "LCMS2": "2.16",
     "LIBPNG": "1.6.43",
-    "LIBWEBP": "1.3.2",
+    "LIBWEBP": "1.4.0",
     "OPENJPEG": "2.5.2",
     "TIFF": "4.6.0",
     "XZ": "5.4.5",

From 77e2c38aea9d88adb3e3f6a9dd8bc56f85b2a075 Mon Sep 17 00:00:00 2001
From: Andrew Murray <radarhere@users.noreply.github.com>
Date: Sat, 13 Apr 2024 15:54:42 +1000
Subject: [PATCH 0515/1178] dist directory is no longer created

---
 Makefile | 1 -
 1 file changed, 1 deletion(-)

diff --git a/Makefile b/Makefile
index 5547b2e3caf..477d92609d1 100644
--- a/Makefile
+++ b/Makefile
@@ -78,7 +78,6 @@ release-test:
 	python3 selftest.py
 	python3 -m pytest Tests
 	python3 -m pip install .
-	-rmdir dist
 	python3 -m pytest -qq
 	python3 -m check_manifest
 	python3 -m pyroma .

From e58cccfc2322ccba038af77d48a269681867a277 Mon Sep 17 00:00:00 2001
From: Andrew Murray <radarhere@users.noreply.github.com>
Date: Sat, 13 Apr 2024 16:28:29 +1000
Subject: [PATCH 0516/1178] Update CHANGES.rst [ci skip]

---
 CHANGES.rst | 3 +++
 1 file changed, 3 insertions(+)

diff --git a/CHANGES.rst b/CHANGES.rst
index e39031aea4a..196f8ed2020 100644
--- a/CHANGES.rst
+++ b/CHANGES.rst
@@ -5,6 +5,9 @@ Changelog (Pillow)
 10.4.0 (unreleased)
 -------------------
 
+- Add support for reading BITMAPV2INFOHEADER and BITMAPV3INFOHEADER #7956
+  [Cirras, radarhere]
+
 - Support reading CMYK JPEG2000 images #7947
   [radarhere]
 

From 71029803e74c2148567a1a2dda7f8e0e3c49d27c Mon Sep 17 00:00:00 2001
From: Andrew Murray <radarhere@users.noreply.github.com>
Date: Sun, 14 Apr 2024 21:57:29 +1000
Subject: [PATCH 0517/1178] Corrected check for libtiff feature

---
 Tests/test_tiff_ifdrational.py | 31 ++++++++++++++++---------------
 1 file changed, 16 insertions(+), 15 deletions(-)

diff --git a/Tests/test_tiff_ifdrational.py b/Tests/test_tiff_ifdrational.py
index f6adae3e6e7..7cbc1a2660a 100644
--- a/Tests/test_tiff_ifdrational.py
+++ b/Tests/test_tiff_ifdrational.py
@@ -3,10 +3,12 @@
 from fractions import Fraction
 from pathlib import Path
 
-from PIL import Image, TiffImagePlugin, features
+import pytest
+
+from PIL import Image, TiffImagePlugin
 from PIL.TiffImagePlugin import IFDRational
 
-from .helper import hopper
+from .helper import hopper, skip_unless_feature
 
 
 def _test_equal(num, denom, target) -> None:
@@ -52,18 +54,17 @@ def test_nonetype() -> None:
     assert xres and yres
 
 
-def test_ifd_rational_save(tmp_path: Path) -> None:
-    methods = [True]
-    if features.check("libtiff"):
-        methods.append(False)
-
-    for libtiff in methods:
-        TiffImagePlugin.WRITE_LIBTIFF = libtiff
+@pytest.mark.parametrize(
+    "libtiff", (pytest.param(True, marks=skip_unless_feature("libtiff")), False)
+)
+def test_ifd_rational_save(tmp_path: Path, libtiff: bool) -> None:
+    im = hopper()
+    out = str(tmp_path / "temp.tiff")
+    res = IFDRational(301, 1)
 
-        im = hopper()
-        out = str(tmp_path / "temp.tiff")
-        res = IFDRational(301, 1)
-        im.save(out, dpi=(res, res), compression="raw")
+    TiffImagePlugin.WRITE_LIBTIFF = libtiff
+    im.save(out, dpi=(res, res), compression="raw")
+    TiffImagePlugin.WRITE_LIBTIFF = False
 
-        with Image.open(out) as reloaded:
-            assert float(IFDRational(301, 1)) == float(reloaded.tag_v2[282])
+    with Image.open(out) as reloaded:
+        assert float(IFDRational(301, 1)) == float(reloaded.tag_v2[282])

From 3e1df0afeb13041b132939b28d53860093e5f3d6 Mon Sep 17 00:00:00 2001
From: Andrew Murray <radarhere@users.noreply.github.com>
Date: Sun, 14 Apr 2024 22:28:28 +1000
Subject: [PATCH 0518/1178] Removed CentOS 7

---
 .github/workflows/test-docker.yml      | 1 -
 docs/installation/platform-support.rst | 2 --
 2 files changed, 3 deletions(-)

diff --git a/.github/workflows/test-docker.yml b/.github/workflows/test-docker.yml
index f40286fe434..4b8041f9daf 100644
--- a/.github/workflows/test-docker.yml
+++ b/.github/workflows/test-docker.yml
@@ -43,7 +43,6 @@ jobs:
           amazon-2-amd64,
           amazon-2023-amd64,
           arch,
-          centos-7-amd64,
           centos-stream-8-amd64,
           centos-stream-9-amd64,
           debian-11-bullseye-amd64,
diff --git a/docs/installation/platform-support.rst b/docs/installation/platform-support.rst
index bc60eeed445..5b52105d219 100644
--- a/docs/installation/platform-support.rst
+++ b/docs/installation/platform-support.rst
@@ -25,8 +25,6 @@ These platforms are built and tested for every change.
 +----------------------------------+----------------------------+---------------------+
 | Arch                             | 3.9                        | x86-64              |
 +----------------------------------+----------------------------+---------------------+
-| CentOS 7                         | 3.9                        | x86-64              |
-+----------------------------------+----------------------------+---------------------+
 | CentOS Stream 8                  | 3.9                        | x86-64              |
 +----------------------------------+----------------------------+---------------------+
 | CentOS Stream 9                  | 3.9                        | x86-64              |

From 25b46523246a7908959615ccab547f3b9345dd62 Mon Sep 17 00:00:00 2001
From: Andrew Murray <radarhere@users.noreply.github.com>
Date: Sun, 14 Apr 2024 22:45:14 +1000
Subject: [PATCH 0519/1178] Removed CentOS Stream 8

---
 .github/workflows/test-docker.yml      | 1 -
 docs/installation/platform-support.rst | 2 --
 2 files changed, 3 deletions(-)

diff --git a/.github/workflows/test-docker.yml b/.github/workflows/test-docker.yml
index 4b8041f9daf..70426d7b509 100644
--- a/.github/workflows/test-docker.yml
+++ b/.github/workflows/test-docker.yml
@@ -43,7 +43,6 @@ jobs:
           amazon-2-amd64,
           amazon-2023-amd64,
           arch,
-          centos-stream-8-amd64,
           centos-stream-9-amd64,
           debian-11-bullseye-amd64,
           debian-12-bookworm-x86,
diff --git a/docs/installation/platform-support.rst b/docs/installation/platform-support.rst
index 5b52105d219..af205a4e8cc 100644
--- a/docs/installation/platform-support.rst
+++ b/docs/installation/platform-support.rst
@@ -25,8 +25,6 @@ These platforms are built and tested for every change.
 +----------------------------------+----------------------------+---------------------+
 | Arch                             | 3.9                        | x86-64              |
 +----------------------------------+----------------------------+---------------------+
-| CentOS Stream 8                  | 3.9                        | x86-64              |
-+----------------------------------+----------------------------+---------------------+
 | CentOS Stream 9                  | 3.9                        | x86-64              |
 +----------------------------------+----------------------------+---------------------+
 | Debian 11 Bullseye               | 3.9                        | x86-64              |

From d431c97ba3b19d40d4090763ca25499536287141 Mon Sep 17 00:00:00 2001
From: Andrew Murray <radarhere@users.noreply.github.com>
Date: Mon, 15 Apr 2024 19:28:52 +1000
Subject: [PATCH 0520/1178] Deprecate BGR;15, BGR;16 and BGR;24

---
 Tests/helper.py             |  7 ++++++-
 Tests/test_image.py         | 30 +++++++++++++++++++++++++-----
 Tests/test_image_access.py  |  6 +++++-
 Tests/test_image_putdata.py |  3 ++-
 Tests/test_lib_pack.py      | 13 ++++++++-----
 docs/deprecations.rst       |  7 +++++++
 docs/handbook/concepts.rst  |  3 ---
 src/PIL/Image.py            |  7 +++++++
 src/PIL/ImageMode.py        |  4 ++++
 9 files changed, 64 insertions(+), 16 deletions(-)

diff --git a/Tests/helper.py b/Tests/helper.py
index c1399e89bf8..213d994270d 100644
--- a/Tests/helper.py
+++ b/Tests/helper.py
@@ -273,7 +273,12 @@ def _cached_hopper(mode: str) -> Image.Image:
         im = hopper("L")
     else:
         im = hopper()
-    return im.convert(mode)
+    if mode.startswith("BGR;"):
+        with pytest.warns(DeprecationWarning):
+            im = im.convert(mode)
+    else:
+        im = im.convert(mode)
+    return im
 
 
 def djpeg_available() -> bool:
diff --git a/Tests/test_image.py b/Tests/test_image.py
index 941ec40d9bc..ed80be503fb 100644
--- a/Tests/test_image.py
+++ b/Tests/test_image.py
@@ -66,7 +66,11 @@
 class TestImage:
     @pytest.mark.parametrize("mode", image_mode_names)
     def test_image_modes_success(self, mode: str) -> None:
-        Image.new(mode, (1, 1))
+        if mode.startswith("BGR;"):
+            with pytest.warns(DeprecationWarning):
+                Image.new(mode, (1, 1))
+        else:
+            Image.new(mode, (1, 1))
 
     @pytest.mark.parametrize("mode", ("", "bad", "very very long"))
     def test_image_modes_fail(self, mode: str) -> None:
@@ -1050,7 +1054,11 @@ def test_roundtrip_bytes_constructor(self, mode: str) -> None:
         im = hopper(mode)
         source_bytes = im.tobytes()
 
-        reloaded = Image.frombytes(mode, im.size, source_bytes)
+        if mode.startswith("BGR;"):
+            with pytest.warns(DeprecationWarning):
+                reloaded = Image.frombytes(mode, im.size, source_bytes)
+        else:
+            reloaded = Image.frombytes(mode, im.size, source_bytes)
         assert reloaded.tobytes() == source_bytes
 
     @pytest.mark.parametrize("mode", image_mode_names)
@@ -1058,17 +1066,29 @@ def test_roundtrip_bytes_method(self, mode: str) -> None:
         im = hopper(mode)
         source_bytes = im.tobytes()
 
-        reloaded = Image.new(mode, im.size)
+        if mode.startswith("BGR;"):
+            with pytest.warns(DeprecationWarning):
+                reloaded = Image.new(mode, im.size)
+        else:
+            reloaded = Image.new(mode, im.size)
         reloaded.frombytes(source_bytes)
         assert reloaded.tobytes() == source_bytes
 
     @pytest.mark.parametrize(("mode", "pixelsize"), image_modes)
     def test_getdata_putdata(self, mode: str, pixelsize: int) -> None:
-        im = Image.new(mode, (2, 2))
+        if mode.startswith("BGR;"):
+            with pytest.warns(DeprecationWarning):
+                im = Image.new(mode, (2, 2))
+        else:
+            im = Image.new(mode, (2, 2))
         source_bytes = bytes(range(im.width * im.height * pixelsize))
         im.frombytes(source_bytes)
 
-        reloaded = Image.new(mode, im.size)
+        if mode.startswith("BGR;"):
+            with pytest.warns(DeprecationWarning):
+                reloaded = Image.new(mode, im.size)
+        else:
+            reloaded = Image.new(mode, im.size)
         reloaded.putdata(im.getdata())
         assert_image_equal(im, reloaded)
 
diff --git a/Tests/test_image_access.py b/Tests/test_image_access.py
index 8c42da57a37..8bb90710aa3 100644
--- a/Tests/test_image_access.py
+++ b/Tests/test_image_access.py
@@ -229,7 +229,11 @@ def check(self, mode: str, expected_color_int: int | None = None) -> None:
         ),
     )
     def test_basic(self, mode: str) -> None:
-        self.check(mode)
+        if mode.startswith("BGR;"):
+            with pytest.warns(DeprecationWarning):
+                self.check(mode)
+        else:
+            self.check(mode)
 
     def test_list(self) -> None:
         im = hopper()
diff --git a/Tests/test_image_putdata.py b/Tests/test_image_putdata.py
index 73145faac15..dad26ef144c 100644
--- a/Tests/test_image_putdata.py
+++ b/Tests/test_image_putdata.py
@@ -81,7 +81,8 @@ def test_mode_F() -> None:
 @pytest.mark.parametrize("mode", ("BGR;15", "BGR;16", "BGR;24"))
 def test_mode_BGR(mode: str) -> None:
     data = [(16, 32, 49), (32, 32, 98)]
-    im = Image.new(mode, (1, 2))
+    with pytest.warns(DeprecationWarning):
+        im = Image.new(mode, (1, 2))
     im.putdata(data)
 
     assert list(im.getdata()) == data
diff --git a/Tests/test_lib_pack.py b/Tests/test_lib_pack.py
index 6a0e704b89a..f80c5b78c9c 100644
--- a/Tests/test_lib_pack.py
+++ b/Tests/test_lib_pack.py
@@ -359,11 +359,14 @@ def test_RGB(self) -> None:
         )
 
     def test_BGR(self) -> None:
-        self.assert_unpack("BGR;15", "BGR;15", 3, (8, 131, 0), (24, 0, 8), (41, 131, 8))
-        self.assert_unpack(
-            "BGR;16", "BGR;16", 3, (8, 64, 0), (24, 129, 0), (41, 194, 0)
-        )
-        self.assert_unpack("BGR;24", "BGR;24", 3, (1, 2, 3), (4, 5, 6), (7, 8, 9))
+        with pytest.warns(DeprecationWarning):
+            self.assert_unpack(
+                "BGR;15", "BGR;15", 3, (8, 131, 0), (24, 0, 8), (41, 131, 8)
+            )
+            self.assert_unpack(
+                "BGR;16", "BGR;16", 3, (8, 64, 0), (24, 129, 0), (41, 194, 0)
+            )
+            self.assert_unpack("BGR;24", "BGR;24", 3, (1, 2, 3), (4, 5, 6), (7, 8, 9))
 
     def test_RGBA(self) -> None:
         self.assert_unpack("RGBA", "LA", 2, (1, 1, 1, 2), (3, 3, 3, 4), (5, 5, 5, 6))
diff --git a/docs/deprecations.rst b/docs/deprecations.rst
index c3d1ba4f028..da4e9e597f5 100644
--- a/docs/deprecations.rst
+++ b/docs/deprecations.rst
@@ -100,6 +100,13 @@ ImageMath eval()
 ``ImageMath.eval()`` has been deprecated. Use :py:meth:`~PIL.ImageMath.lambda_eval` or
 :py:meth:`~PIL.ImageMath.unsafe_eval` instead.
 
+BGR;15, BGR 16 and BGR;24
+^^^^^^^^^^^^^^^^^^^^^^^^^
+
+.. deprecated:: 10.4.0
+
+The experimental BGR;15, BGR;16 and BGR;24 modes have been deprecated.
+
 Removed features
 ----------------
 
diff --git a/docs/handbook/concepts.rst b/docs/handbook/concepts.rst
index e0975a12132..5094dbf3f27 100644
--- a/docs/handbook/concepts.rst
+++ b/docs/handbook/concepts.rst
@@ -59,9 +59,6 @@ Pillow also provides limited support for a few additional modes, including:
     * ``I;16L`` (16-bit little endian unsigned integer pixels)
     * ``I;16B`` (16-bit big endian unsigned integer pixels)
     * ``I;16N`` (16-bit native endian unsigned integer pixels)
-    * ``BGR;15`` (15-bit reversed true colour)
-    * ``BGR;16`` (16-bit reversed true colour)
-    * ``BGR;24`` (24-bit reversed true colour)
 
 Premultiplied alpha is where the values for each other channel have been
 multiplied by the alpha. For example, an RGBA pixel of ``(10, 20, 30, 127)``
diff --git a/src/PIL/Image.py b/src/PIL/Image.py
index 3ae90106087..26be427798a 100644
--- a/src/PIL/Image.py
+++ b/src/PIL/Image.py
@@ -55,6 +55,7 @@
     _plugins,
 )
 from ._binary import i32le, o32be, o32le
+from ._deprecate import deprecate
 from ._typing import StrOrBytesPath, TypeGuard
 from ._util import DeferredError, is_path
 
@@ -939,6 +940,9 @@ def convert(
         :returns: An :py:class:`~PIL.Image.Image` object.
         """
 
+        if mode in ("BGR;15", "BGR;16", "BGR;24"):
+            deprecate(mode, 12)
+
         self.load()
 
         has_transparency = "transparency" in self.info
@@ -2956,6 +2960,9 @@ def new(
     :returns: An :py:class:`~PIL.Image.Image` object.
     """
 
+    if mode in ("BGR;15", "BGR;16", "BGR;24"):
+        deprecate(mode, 12)
+
     _check_size(size)
 
     if color is None:
diff --git a/src/PIL/ImageMode.py b/src/PIL/ImageMode.py
index 5e05c5f43ed..7bd2afcf2fa 100644
--- a/src/PIL/ImageMode.py
+++ b/src/PIL/ImageMode.py
@@ -18,6 +18,8 @@
 from functools import lru_cache
 from typing import NamedTuple
 
+from ._deprecate import deprecate
+
 
 class ModeDescriptor(NamedTuple):
     """Wrapper for mode strings."""
@@ -63,6 +65,8 @@ def getmode(mode: str) -> ModeDescriptor:
         "PA": ("RGB", "L", ("P", "A"), "|u1"),
     }
     if mode in modes:
+        if mode in ("BGR;15", "BGR;16", "BGR;24"):
+            deprecate(mode, 12)
         base_mode, base_type, bands, type_str = modes[mode]
         return ModeDescriptor(mode, bands, base_mode, base_type, type_str)
 

From 66d32a7dffe1b859bbcc33a43a6a8ea4d1de7c4d Mon Sep 17 00:00:00 2001
From: Andrew Murray <radarhere@users.noreply.github.com>
Date: Tue, 16 Apr 2024 07:03:56 +1000
Subject: [PATCH 0521/1178] Updated installation links

---
 README.md | 2 +-
 setup.py  | 2 +-
 2 files changed, 2 insertions(+), 2 deletions(-)

diff --git a/README.md b/README.md
index 823ea76d0c5..b4c6d2987ff 100644
--- a/README.md
+++ b/README.md
@@ -101,7 +101,7 @@ The core image library is designed for fast access to data stored in a few basic
 ## More Information
 
 - [Documentation](https://pillow.readthedocs.io/)
-  - [Installation](https://pillow.readthedocs.io/en/latest/installation.html)
+  - [Installation](https://pillow.readthedocs.io/en/latest/installation/basic-installation.html)
   - [Handbook](https://pillow.readthedocs.io/en/latest/handbook/index.html)
 - [Contribute](https://github.com/python-pillow/Pillow/blob/main/.github/CONTRIBUTING.md)
   - [Issues](https://github.com/python-pillow/Pillow/issues)
diff --git a/setup.py b/setup.py
index ac401dde754..7d8e1c1ee21 100644
--- a/setup.py
+++ b/setup.py
@@ -1018,7 +1018,7 @@ def debug_build():
 a required dependency when compiling Pillow from source.
 
 Please see the install instructions at:
-   https://pillow.readthedocs.io/en/latest/installation.html
+   https://pillow.readthedocs.io/en/latest/installation/basic-installation.html
 
 """
     sys.stderr.write(msg)

From 1af66df732f1842494d4eb8470f81c4c1e94b5b9 Mon Sep 17 00:00:00 2001
From: Andrew Murray <radarhere@users.noreply.github.com>
Date: Tue, 16 Apr 2024 07:13:40 +1000
Subject: [PATCH 0522/1178] Updated xcb-proto to 1.17.0

---
 .github/workflows/wheels-dependencies.sh | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/.github/workflows/wheels-dependencies.sh b/.github/workflows/wheels-dependencies.sh
index 0d45d5a209d..2d5e174ce82 100755
--- a/.github/workflows/wheels-dependencies.sh
+++ b/.github/workflows/wheels-dependencies.sh
@@ -70,7 +70,7 @@ function build {
     fi
     build_new_zlib
 
-    build_simple xcb-proto 1.16.0 https://xorg.freedesktop.org/archive/individual/proto
+    build_simple xcb-proto 1.17.0 https://xorg.freedesktop.org/archive/individual/proto
     if [ -n "$IS_MACOS" ]; then
         build_simple xorgproto 2024.1 https://www.x.org/pub/individual/proto
         build_simple libXau 1.0.11 https://www.x.org/pub/individual/lib

From 712aa994f27aba19209e33be382f1a8c85ade82f Mon Sep 17 00:00:00 2001
From: Andrew Murray <radarhere@users.noreply.github.com>
Date: Tue, 16 Apr 2024 07:14:04 +1000
Subject: [PATCH 0523/1178] Updated libxcb to 1.17.0

---
 .github/workflows/wheels-dependencies.sh | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/.github/workflows/wheels-dependencies.sh b/.github/workflows/wheels-dependencies.sh
index 2d5e174ce82..e140665fe7d 100755
--- a/.github/workflows/wheels-dependencies.sh
+++ b/.github/workflows/wheels-dependencies.sh
@@ -35,7 +35,7 @@ else
 fi
 LIBWEBP_VERSION=1.3.2
 BZIP2_VERSION=1.0.8
-LIBXCB_VERSION=1.16.1
+LIBXCB_VERSION=1.17.0
 BROTLI_VERSION=1.1.0
 
 if [[ -n "$IS_MACOS" ]] && [[ "$CIBW_ARCHS" == "x86_64" ]]; then

From c655dc0c6b6257ffecb7fa8464ac51d19347e651 Mon Sep 17 00:00:00 2001
From: "Adam J. Stewart" <ajstewart426@gmail.com>
Date: Tue, 16 Apr 2024 17:53:48 +0200
Subject: [PATCH 0524/1178] Use a property
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit

Co-authored-by: Ondrej Baranovič <ondreko.tiba@gmail.com>
---
 src/PIL/Image.py | 4 +++-
 1 file changed, 3 insertions(+), 1 deletion(-)

diff --git a/src/PIL/Image.py b/src/PIL/Image.py
index b64133cbc36..c65cf38500a 100644
--- a/src/PIL/Image.py
+++ b/src/PIL/Image.py
@@ -3079,7 +3079,9 @@ class SupportsArrayInterface(Protocol):
     An object that has an ``__array_interface__`` dictionary.
     """
 
-    __array_interface__: dict[str, Any]
+    @property
+    def __array_interface__(self) -> dict[str, Any]:
+        raise NotImplementedError()
 
 
 def fromarray(obj: SupportsArrayInterface, mode: str | None = None) -> Image:

From 8b6253861766dbb0ac0aa896be1f1845e1e9a00f Mon Sep 17 00:00:00 2001
From: =?UTF-8?q?Ondrej=20Baranovi=C4=8D?= <nulano@nulano.eu>
Date: Tue, 16 Apr 2024 18:27:48 +0200
Subject: [PATCH 0525/1178] ImageStat: simplify call to Image.histogram(mask)

Co-authored-by: Hugo van Kemenade <1324225+hugovk@users.noreply.github.com>
---
 src/PIL/ImageStat.py | 5 +----
 1 file changed, 1 insertion(+), 4 deletions(-)

diff --git a/src/PIL/ImageStat.py b/src/PIL/ImageStat.py
index 07ea76e6faf..2cb841eef34 100644
--- a/src/PIL/ImageStat.py
+++ b/src/PIL/ImageStat.py
@@ -51,10 +51,7 @@ def __init__(
         :param mask: An optional mask.
         """
         if isinstance(image_or_list, Image.Image):
-            if mask:
-                self.h = image_or_list.histogram(mask)
-            else:
-                self.h = image_or_list.histogram()
+            self.h = image_or_list.histogram(mask)
         else:
             self.h = image_or_list
         if not isinstance(self.h, list):

From 2e73bed053a14e28ac4e8dd4f93db02a58630140 Mon Sep 17 00:00:00 2001
From: =?UTF-8?q?Ondrej=20Baranovi=C4=8D?= <nulano@nulano.eu>
Date: Tue, 16 Apr 2024 18:34:48 +0200
Subject: [PATCH 0526/1178] ImageStat: simplify if block

Co-authored-by: Andrew Murray <3112309+radarhere@users.noreply.github.com>
---
 src/PIL/ImageStat.py | 4 ++--
 1 file changed, 2 insertions(+), 2 deletions(-)

diff --git a/src/PIL/ImageStat.py b/src/PIL/ImageStat.py
index 2cb841eef34..8bc504526f0 100644
--- a/src/PIL/ImageStat.py
+++ b/src/PIL/ImageStat.py
@@ -52,9 +52,9 @@ def __init__(
         """
         if isinstance(image_or_list, Image.Image):
             self.h = image_or_list.histogram(mask)
-        else:
+        elif isinstance(image_or_list, list):
             self.h = image_or_list
-        if not isinstance(self.h, list):
+        else:
             msg = "first argument must be image or list"  # type: ignore[unreachable]
             raise TypeError(msg)
         self.bands = list(range(len(self.h) // 256))

From cd179541b11277caed1168f0a2d7f0870eed6545 Mon Sep 17 00:00:00 2001
From: Andrew Murray <radarhere@users.noreply.github.com>
Date: Wed, 17 Apr 2024 11:47:35 +1000
Subject: [PATCH 0527/1178] Removed nitpick_ignore by updating Sphinx to 7.3

---
 docs/conf.py   | 9 ++-------
 pyproject.toml | 2 +-
 2 files changed, 3 insertions(+), 8 deletions(-)

diff --git a/docs/conf.py b/docs/conf.py
index 483535f9650..8b879d1e4b5 100644
--- a/docs/conf.py
+++ b/docs/conf.py
@@ -22,7 +22,7 @@
 # -- General configuration ------------------------------------------------
 
 # If your documentation needs a minimal Sphinx version, state it here.
-needs_sphinx = "2.4"
+needs_sphinx = "7.3"
 
 # Add any Sphinx extension module names here, as strings. They can be
 # extensions coming with Sphinx (named 'sphinx.ext.*') or your custom
@@ -121,12 +121,7 @@
 # generating warnings in “nitpicky mode”. Note that type should include the domain name
 # if present. Example entries would be ('py:func', 'int') or
 # ('envvar', 'LD_LIBRARY_PATH').
-nitpick_ignore = [
-    # Sphinx does not understand typing.Literal[-1]
-    # Will be fixed in a future version.
-    # https://github.com/sphinx-doc/sphinx/pull/11904
-    ("py:obj", "typing.Literal[-1, 1]"),
-]
+# nitpick_ignore = []
 
 
 # -- Options for HTML output ----------------------------------------------
diff --git a/pyproject.toml b/pyproject.toml
index 3ce082fb980..328088e0533 100644
--- a/pyproject.toml
+++ b/pyproject.toml
@@ -42,7 +42,7 @@ dynamic = [
 docs = [
   "furo",
   "olefile",
-  "sphinx>=2.4",
+  "sphinx>=7.3",
   "sphinx-copybutton",
   "sphinx-inline-tabs",
   "sphinx-removed-in",

From 03835ce6f52cd51d232469025a66fe197f6efed8 Mon Sep 17 00:00:00 2001
From: Andrew Murray <radarhere@users.noreply.github.com>
Date: Wed, 17 Apr 2024 14:51:12 +1000
Subject: [PATCH 0528/1178] Corrected UnixViewer command

---
 src/PIL/ImageShow.py | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/src/PIL/ImageShow.py b/src/PIL/ImageShow.py
index 4e505f2eea5..f60b1e11e18 100644
--- a/src/PIL/ImageShow.py
+++ b/src/PIL/ImageShow.py
@@ -199,7 +199,7 @@ def get_command_ex(self, file: str, **options: Any) -> tuple[str, str]:
 
     def get_command(self, file: str, **options: Any) -> str:
         command = self.get_command_ex(file, **options)[0]
-        return f"({command} {quote(file)}"
+        return f"{command} {quote(file)}"
 
 
 class XDGViewer(UnixViewer):

From a64f4cf68587b4adb375bb70933fcf3e3283b749 Mon Sep 17 00:00:00 2001
From: Hugo van Kemenade <1324225+hugovk@users.noreply.github.com>
Date: Wed, 17 Apr 2024 09:22:22 +0300
Subject: [PATCH 0529/1178] Remove sphinx-removed-in, now Sphinx 7.3.0 adds
 versionremoved

---
 docs/Makefile  | 2 +-
 docs/conf.py   | 1 -
 pyproject.toml | 1 -
 3 files changed, 1 insertion(+), 3 deletions(-)

diff --git a/docs/Makefile b/docs/Makefile
index 3b4deb9bf9d..6495e5866ff 100644
--- a/docs/Makefile
+++ b/docs/Makefile
@@ -46,7 +46,7 @@ clean:
 	-rm -rf $(BUILDDIR)/*
 
 install-sphinx:
-	$(PYTHON) -m pip install --quiet furo olefile sphinx sphinx-copybutton sphinx-inline-tabs sphinx-removed-in sphinxext-opengraph
+	$(PYTHON) -m pip install --quiet furo olefile sphinx sphinx-copybutton sphinx-inline-tabs sphinxext-opengraph
 
 .PHONY: html
 html:
diff --git a/docs/conf.py b/docs/conf.py
index 8b879d1e4b5..392cf317e5f 100644
--- a/docs/conf.py
+++ b/docs/conf.py
@@ -34,7 +34,6 @@
     "sphinx.ext.viewcode",
     "sphinx_copybutton",
     "sphinx_inline_tabs",
-    "sphinx_removed_in",
     "sphinxext.opengraph",
 ]
 
diff --git a/pyproject.toml b/pyproject.toml
index 328088e0533..20e87ad327d 100644
--- a/pyproject.toml
+++ b/pyproject.toml
@@ -45,7 +45,6 @@ docs = [
   "sphinx>=7.3",
   "sphinx-copybutton",
   "sphinx-inline-tabs",
-  "sphinx-removed-in",
   "sphinxext-opengraph",
 ]
 fpx = [

From 2c0b2dceba4f72694221f8a1acb2efb16e761047 Mon Sep 17 00:00:00 2001
From: Andrew Murray <radarhere@users.noreply.github.com>
Date: Thu, 18 Apr 2024 08:33:37 +1000
Subject: [PATCH 0530/1178] Updated nasm to 2.16.03

---
 .appveyor.yml | 4 ++--
 1 file changed, 2 insertions(+), 2 deletions(-)

diff --git a/.appveyor.yml b/.appveyor.yml
index 57a8fa5a06d..dfa548548b3 100644
--- a/.appveyor.yml
+++ b/.appveyor.yml
@@ -32,10 +32,10 @@ install:
 - curl -fsSL -o pillow-test-images.zip https://github.com/python-pillow/test-images/archive/main.zip
 - 7z x pillow-test-images.zip -oc:\
 - xcopy /S /Y c:\test-images-main\* c:\pillow\tests\images
-- curl -fsSL -o nasm-win64.zip https://raw.githubusercontent.com/python-pillow/pillow-depends/main/nasm-2.16.01-win64.zip
+- curl -fsSL -o nasm-win64.zip https://raw.githubusercontent.com/python-pillow/pillow-depends/main/nasm-2.16.03-win64.zip
 - 7z x nasm-win64.zip -oc:\
 - choco install ghostscript --version=10.3.0
-- path c:\nasm-2.16.01;C:\Program Files\gs\gs10.00.0\bin;%PATH%
+- path c:\nasm-2.16.03;C:\Program Files\gs\gs10.00.0\bin;%PATH%
 - cd c:\pillow\winbuild\
 - ps: |
         c:\python38\python.exe c:\pillow\winbuild\build_prepare.py -v --depends=C:\pillow-depends\

From 28f436c94d21c445230c50bd5d16e898e12febd5 Mon Sep 17 00:00:00 2001
From: Andrew Murray <radarhere@users.noreply.github.com>
Date: Thu, 18 Apr 2024 17:57:40 +1000
Subject: [PATCH 0531/1178] Use monkeypatch to set READ_LIBTIFF and
 WRITE_LIBTIFF

---
 Tests/test_file_libtiff.py     | 100 +++++++++++++++------------------
 Tests/test_imagesequence.py    |   5 +-
 Tests/test_tiff_ifdrational.py |   7 ++-
 3 files changed, 51 insertions(+), 61 deletions(-)

diff --git a/Tests/test_file_libtiff.py b/Tests/test_file_libtiff.py
index 6c32b5ad427..4db0bfed581 100644
--- a/Tests/test_file_libtiff.py
+++ b/Tests/test_file_libtiff.py
@@ -185,7 +185,9 @@ def test_write_metadata(self, legacy_api: bool, tmp_path: Path) -> None:
             assert field in reloaded, f"{field} not in metadata"
 
     @pytest.mark.valgrind_known_error(reason="Known invalid metadata")
-    def test_additional_metadata(self, tmp_path: Path) -> None:
+    def test_additional_metadata(
+        self, monkeypatch: pytest.MonkeyPatch, tmp_path: Path
+    ) -> None:
         # these should not crash. Seriously dummy data, most of it doesn't make
         # any sense, so we're running up against limits where we're asking
         # libtiff to do stupid things.
@@ -236,12 +238,10 @@ def test_additional_metadata(self, tmp_path: Path) -> None:
             del new_ifd[338]
 
             out = str(tmp_path / "temp.tif")
-            TiffImagePlugin.WRITE_LIBTIFF = True
+            monkeypatch.setattr(TiffImagePlugin, "WRITE_LIBTIFF", True)
 
             im.save(out, tiffinfo=new_ifd)
 
-        TiffImagePlugin.WRITE_LIBTIFF = False
-
     def test_custom_metadata(self, tmp_path: Path) -> None:
         class Tc(NamedTuple):
             value: Any
@@ -343,24 +343,24 @@ def test_subifd(self, tmp_path: Path) -> None:
             # Should not segfault
             im.save(outfile)
 
-    def test_xmlpacket_tag(self, tmp_path: Path) -> None:
-        TiffImagePlugin.WRITE_LIBTIFF = True
+    def test_xmlpacket_tag(
+        self, monkeypatch: pytest.MonkeyPatch, tmp_path: Path
+    ) -> None:
+        monkeypatch.setattr(TiffImagePlugin, "WRITE_LIBTIFF", True)
 
         out = str(tmp_path / "temp.tif")
         hopper().save(out, tiffinfo={700: b"xmlpacket tag"})
-        TiffImagePlugin.WRITE_LIBTIFF = False
 
         with Image.open(out) as reloaded:
             if 700 in reloaded.tag_v2:
                 assert reloaded.tag_v2[700] == b"xmlpacket tag"
 
-    def test_int_dpi(self, tmp_path: Path) -> None:
+    def test_int_dpi(self, monkeypatch: pytest.MonkeyPatch, tmp_path: Path) -> None:
         # issue #1765
         im = hopper("RGB")
         out = str(tmp_path / "temp.tif")
-        TiffImagePlugin.WRITE_LIBTIFF = True
+        monkeypatch.setattr(TiffImagePlugin, "WRITE_LIBTIFF", True)
         im.save(out, dpi=(72, 72))
-        TiffImagePlugin.WRITE_LIBTIFF = False
         with Image.open(out) as reloaded:
             assert reloaded.info["dpi"] == (72.0, 72.0)
 
@@ -422,13 +422,13 @@ def test_g4_string_info(self, tmp_path: Path) -> None:
             assert "temp.tif" == reread.tag_v2[269]
             assert "temp.tif" == reread.tag[269][0]
 
-    def test_12bit_rawmode(self) -> None:
+    def test_12bit_rawmode(self, monkeypatch: pytest.MonkeyPatch) -> None:
         """Are we generating the same interpretation
         of the image as Imagemagick is?"""
-        TiffImagePlugin.READ_LIBTIFF = True
+        monkeypatch.setattr(TiffImagePlugin, "READ_LIBTIFF", True)
         with Image.open("Tests/images/12bit.cropped.tif") as im:
             im.load()
-            TiffImagePlugin.READ_LIBTIFF = False
+            monkeypatch.setattr(TiffImagePlugin, "READ_LIBTIFF", False)
             # to make the target --
             # convert 12bit.cropped.tif -depth 16 tmp.tif
             # convert tmp.tif -evaluate RightShift 4 12in16bit2.tif
@@ -514,12 +514,13 @@ def test_cmyk_save(self, tmp_path: Path) -> None:
         assert_image_equal_tofile(im, out)
 
     @pytest.mark.parametrize("im", (hopper("P"), Image.new("P", (1, 1), "#000")))
-    def test_palette_save(self, im: Image.Image, tmp_path: Path) -> None:
+    def test_palette_save(
+        self, im: Image.Image, monkeypatch: pytest.MonkeyPatch, tmp_path: Path
+    ) -> None:
         out = str(tmp_path / "temp.tif")
 
-        TiffImagePlugin.WRITE_LIBTIFF = True
+        monkeypatch.setattr(TiffImagePlugin, "WRITE_LIBTIFF", True)
         im.save(out)
-        TiffImagePlugin.WRITE_LIBTIFF = False
 
         with Image.open(out) as reloaded:
             # colormap/palette tag
@@ -548,9 +549,9 @@ def test_fp_leak(self) -> None:
         with pytest.raises(OSError):
             os.close(fn)
 
-    def test_multipage(self) -> None:
+    def test_multipage(self, monkeypatch: pytest.MonkeyPatch) -> None:
         # issue #862
-        TiffImagePlugin.READ_LIBTIFF = True
+        monkeypatch.setattr(TiffImagePlugin, "READ_LIBTIFF", True)
         with Image.open("Tests/images/multipage.tiff") as im:
             # file is a multipage tiff,  10x10 green, 10x10 red, 20x20 blue
 
@@ -569,11 +570,9 @@ def test_multipage(self) -> None:
             assert im.size == (20, 20)
             assert im.convert("RGB").getpixel((0, 0)) == (0, 0, 255)
 
-        TiffImagePlugin.READ_LIBTIFF = False
-
-    def test_multipage_nframes(self) -> None:
+    def test_multipage_nframes(self, monkeypatch: pytest.MonkeyPatch) -> None:
         # issue #862
-        TiffImagePlugin.READ_LIBTIFF = True
+        monkeypatch.setattr(TiffImagePlugin, "READ_LIBTIFF", True)
         with Image.open("Tests/images/multipage.tiff") as im:
             frames = im.n_frames
             assert frames == 3
@@ -582,10 +581,8 @@ def test_multipage_nframes(self) -> None:
                 # Should not raise ValueError: I/O operation on closed file
                 im.load()
 
-        TiffImagePlugin.READ_LIBTIFF = False
-
-    def test_multipage_seek_backwards(self) -> None:
-        TiffImagePlugin.READ_LIBTIFF = True
+    def test_multipage_seek_backwards(self, monkeypatch: pytest.MonkeyPatch) -> None:
+        monkeypatch.setattr(TiffImagePlugin, "READ_LIBTIFF", True)
         with Image.open("Tests/images/multipage.tiff") as im:
             im.seek(1)
             im.load()
@@ -593,24 +590,21 @@ def test_multipage_seek_backwards(self) -> None:
             im.seek(0)
             assert im.convert("RGB").getpixel((0, 0)) == (0, 128, 0)
 
-        TiffImagePlugin.READ_LIBTIFF = False
-
-    def test__next(self) -> None:
-        TiffImagePlugin.READ_LIBTIFF = True
+    def test__next(self, monkeypatch: pytest.MonkeyPatch) -> None:
+        monkeypatch.setattr(TiffImagePlugin, "READ_LIBTIFF", True)
         with Image.open("Tests/images/hopper.tif") as im:
             assert not im.tag.next
             im.load()
             assert not im.tag.next
 
-    def test_4bit(self) -> None:
+    def test_4bit(self, monkeypatch: pytest.MonkeyPatch) -> None:
         # Arrange
         test_file = "Tests/images/hopper_gray_4bpp.tif"
         original = hopper("L")
 
         # Act
-        TiffImagePlugin.READ_LIBTIFF = True
+        monkeypatch.setattr(TiffImagePlugin, "READ_LIBTIFF", True)
         with Image.open(test_file) as im:
-            TiffImagePlugin.READ_LIBTIFF = False
 
             # Assert
             assert im.size == (128, 128)
@@ -650,12 +644,12 @@ def test_gray_semibyte_per_pixel(self) -> None:
                     assert im2.mode == "L"
                     assert_image_equal(im, im2)
 
-    def test_save_bytesio(self) -> None:
+    def test_save_bytesio(self, monkeypatch: pytest.MonkeyPatch) -> None:
         # PR 1011
         # Test TIFF saving to io.BytesIO() object.
 
-        TiffImagePlugin.WRITE_LIBTIFF = True
-        TiffImagePlugin.READ_LIBTIFF = True
+        monkeypatch.setattr(TiffImagePlugin, "WRITE_LIBTIFF", True)
+        monkeypatch.setattr(TiffImagePlugin, "READ_LIBTIFF", True)
 
         # Generate test image
         pilim = hopper()
@@ -672,9 +666,6 @@ def save_bytesio(compression: str | None = None) -> None:
         save_bytesio("packbits")
         save_bytesio("tiff_lzw")
 
-        TiffImagePlugin.WRITE_LIBTIFF = False
-        TiffImagePlugin.READ_LIBTIFF = False
-
     def test_save_ycbcr(self, tmp_path: Path) -> None:
         im = hopper("YCbCr")
         outfile = str(tmp_path / "temp.tif")
@@ -694,15 +685,16 @@ def test_exif_ifd(self, tmp_path: Path) -> None:
             if Image.core.libtiff_support_custom_tags:
                 assert reloaded.tag_v2[34665] == 125456
 
-    def test_crashing_metadata(self, tmp_path: Path) -> None:
+    def test_crashing_metadata(
+        self, monkeypatch: pytest.MonkeyPatch, tmp_path: Path
+    ) -> None:
         # issue 1597
         with Image.open("Tests/images/rdf.tif") as im:
             out = str(tmp_path / "temp.tif")
 
-            TiffImagePlugin.WRITE_LIBTIFF = True
+            monkeypatch.setattr(TiffImagePlugin, "WRITE_LIBTIFF", True)
             # this shouldn't crash
             im.save(out, format="TIFF")
-        TiffImagePlugin.WRITE_LIBTIFF = False
 
     def test_page_number_x_0(self, tmp_path: Path) -> None:
         # Issue 973
@@ -733,20 +725,19 @@ def test_fd_duplication(self, tmp_path: Path) -> None:
         # Should not raise PermissionError.
         os.remove(tmpfile)
 
-    def test_read_icc(self) -> None:
+    def test_read_icc(self, monkeypatch: pytest.MonkeyPatch) -> None:
         with Image.open("Tests/images/hopper.iccprofile.tif") as img:
             icc = img.info.get("icc_profile")
             assert icc is not None
-        TiffImagePlugin.READ_LIBTIFF = True
+        monkeypatch.setattr(TiffImagePlugin, "READ_LIBTIFF", True)
         with Image.open("Tests/images/hopper.iccprofile.tif") as img:
             icc_libtiff = img.info.get("icc_profile")
             assert icc_libtiff is not None
-        TiffImagePlugin.READ_LIBTIFF = False
         assert icc == icc_libtiff
 
-    def test_write_icc(self, tmp_path: Path) -> None:
+    def test_write_icc(self, monkeypatch: pytest.MonkeyPatch, tmp_path: Path) -> None:
         def check_write(libtiff: bool) -> None:
-            TiffImagePlugin.WRITE_LIBTIFF = libtiff
+            monkeypatch.setattr(TiffImagePlugin, "WRITE_LIBTIFF", libtiff)
 
             with Image.open("Tests/images/hopper.iccprofile.tif") as img:
                 icc_profile = img.info["icc_profile"]
@@ -756,10 +747,9 @@ def check_write(libtiff: bool) -> None:
             with Image.open(out) as reloaded:
                 assert icc_profile == reloaded.info["icc_profile"]
 
-        libtiffs = []
+        libtiffs = [False]
         if Image.core.libtiff_support_custom_tags:
             libtiffs.append(True)
-        libtiffs.append(False)
 
         for libtiff in libtiffs:
             check_write(libtiff)
@@ -840,12 +830,13 @@ def test_sampleformat(self) -> None:
 
             assert_image_equal_tofile(im, "Tests/images/copyleft.png", mode="RGB")
 
-    def test_sampleformat_write(self, tmp_path: Path) -> None:
+    def test_sampleformat_write(
+        self, monkeypatch: pytest.MonkeyPatch, tmp_path: Path
+    ) -> None:
         im = Image.new("F", (1, 1))
         out = str(tmp_path / "temp.tif")
-        TiffImagePlugin.WRITE_LIBTIFF = True
+        monkeypatch.setattr(TiffImagePlugin, "WRITE_LIBTIFF", True)
         im.save(out)
-        TiffImagePlugin.WRITE_LIBTIFF = False
 
         with Image.open(out) as reloaded:
             assert reloaded.mode == "F"
@@ -1091,15 +1082,14 @@ def test_sampleformat_not_corrupted(self) -> None:
         with Image.open(out) as im:
             im.load()
 
-    def test_realloc_overflow(self) -> None:
-        TiffImagePlugin.READ_LIBTIFF = True
+    def test_realloc_overflow(self, monkeypatch: pytest.MonkeyPatch) -> None:
+        monkeypatch.setattr(TiffImagePlugin, "READ_LIBTIFF", True)
         with Image.open("Tests/images/tiff_overflow_rows_per_strip.tif") as im:
             with pytest.raises(OSError) as e:
                 im.load()
 
             # Assert that the error code is IMAGING_CODEC_MEMORY
             assert str(e.value) == "-9"
-        TiffImagePlugin.READ_LIBTIFF = False
 
     @pytest.mark.parametrize("compression", ("tiff_adobe_deflate", "jpeg"))
     def test_save_multistrip(self, compression: str, tmp_path: Path) -> None:
diff --git a/Tests/test_imagesequence.py b/Tests/test_imagesequence.py
index 7f3a3d14181..18070377fa7 100644
--- a/Tests/test_imagesequence.py
+++ b/Tests/test_imagesequence.py
@@ -60,10 +60,9 @@ def test_tiff() -> None:
 
 
 @skip_unless_feature("libtiff")
-def test_libtiff() -> None:
-    TiffImagePlugin.READ_LIBTIFF = True
+def test_libtiff(monkeypatch: pytest.MonkeyPatch) -> None:
+    monkeypatch.setattr(TiffImagePlugin, "READ_LIBTIFF", True)
     _test_multipage_tiff()
-    TiffImagePlugin.READ_LIBTIFF = False
 
 
 def test_consecutive() -> None:
diff --git a/Tests/test_tiff_ifdrational.py b/Tests/test_tiff_ifdrational.py
index 7cbc1a2660a..ae80b98b84d 100644
--- a/Tests/test_tiff_ifdrational.py
+++ b/Tests/test_tiff_ifdrational.py
@@ -57,14 +57,15 @@ def test_nonetype() -> None:
 @pytest.mark.parametrize(
     "libtiff", (pytest.param(True, marks=skip_unless_feature("libtiff")), False)
 )
-def test_ifd_rational_save(tmp_path: Path, libtiff: bool) -> None:
+def test_ifd_rational_save(
+    monkeypatch: pytest.MonkeyPatch, tmp_path: Path, libtiff: bool
+) -> None:
     im = hopper()
     out = str(tmp_path / "temp.tiff")
     res = IFDRational(301, 1)
 
-    TiffImagePlugin.WRITE_LIBTIFF = libtiff
+    monkeypatch.setattr(TiffImagePlugin, "WRITE_LIBTIFF", libtiff)
     im.save(out, dpi=(res, res), compression="raw")
-    TiffImagePlugin.WRITE_LIBTIFF = False
 
     with Image.open(out) as reloaded:
         assert float(IFDRational(301, 1)) == float(reloaded.tag_v2[282])

From 533f78e0a255c77357e2694419d6b0f5ea6bcd05 Mon Sep 17 00:00:00 2001
From: Andrew Murray <radarhere@users.noreply.github.com>
Date: Fri, 19 Apr 2024 07:47:14 +1000
Subject: [PATCH 0532/1178] Parametrize test

---
 Tests/test_file_libtiff.py | 39 ++++++++++++++++++++++----------------
 1 file changed, 23 insertions(+), 16 deletions(-)

diff --git a/Tests/test_file_libtiff.py b/Tests/test_file_libtiff.py
index 4db0bfed581..71f1b6f1def 100644
--- a/Tests/test_file_libtiff.py
+++ b/Tests/test_file_libtiff.py
@@ -735,24 +735,31 @@ def test_read_icc(self, monkeypatch: pytest.MonkeyPatch) -> None:
             assert icc_libtiff is not None
         assert icc == icc_libtiff
 
-    def test_write_icc(self, monkeypatch: pytest.MonkeyPatch, tmp_path: Path) -> None:
-        def check_write(libtiff: bool) -> None:
-            monkeypatch.setattr(TiffImagePlugin, "WRITE_LIBTIFF", libtiff)
-
-            with Image.open("Tests/images/hopper.iccprofile.tif") as img:
-                icc_profile = img.info["icc_profile"]
-
-                out = str(tmp_path / "temp.tif")
-                img.save(out, icc_profile=icc_profile)
-            with Image.open(out) as reloaded:
-                assert icc_profile == reloaded.info["icc_profile"]
+    @pytest.mark.parametrize(
+        "libtiff",
+        (
+            pytest.param(
+                True,
+                marks=pytest.mark.skipif(
+                    not Image.core.libtiff_support_custom_tags,
+                    reason="Custom tags not supported by older libtiff",
+                ),
+            ),
+            False,
+        ),
+    )
+    def test_write_icc(
+        self, monkeypatch: pytest.MonkeyPatch, tmp_path: Path, libtiff: bool
+    ) -> None:
+        monkeypatch.setattr(TiffImagePlugin, "WRITE_LIBTIFF", libtiff)
 
-        libtiffs = [False]
-        if Image.core.libtiff_support_custom_tags:
-            libtiffs.append(True)
+        with Image.open("Tests/images/hopper.iccprofile.tif") as img:
+            icc_profile = img.info["icc_profile"]
 
-        for libtiff in libtiffs:
-            check_write(libtiff)
+            out = str(tmp_path / "temp.tif")
+            img.save(out, icc_profile=icc_profile)
+        with Image.open(out) as reloaded:
+            assert icc_profile == reloaded.info["icc_profile"]
 
     def test_multipage_compression(self) -> None:
         with Image.open("Tests/images/compression.tif") as im:

From 11ac0c1703cb9f46f9de9ac692f008255222d7b8 Mon Sep 17 00:00:00 2001
From: Andrew Murray <radarhere@users.noreply.github.com>
Date: Fri, 19 Apr 2024 17:15:10 +1000
Subject: [PATCH 0533/1178] Combine tests through parametrization

---
 Tests/test_imagesequence.py | 16 +++++-----------
 1 file changed, 5 insertions(+), 11 deletions(-)

diff --git a/Tests/test_imagesequence.py b/Tests/test_imagesequence.py
index 18070377fa7..9b37435eb61 100644
--- a/Tests/test_imagesequence.py
+++ b/Tests/test_imagesequence.py
@@ -47,7 +47,11 @@ def test_iterator_min_frame() -> None:
             assert i[index] == next(i)
 
 
-def _test_multipage_tiff() -> None:
+@pytest.mark.parametrize(
+    "libtiff", (pytest.param(True, marks=skip_unless_feature("libtiff")), False)
+)
+def test_multipage_tiff(monkeypatch: pytest.MonkeyPatch, libtiff: bool) -> None:
+    monkeypatch.setattr(TiffImagePlugin, "READ_LIBTIFF", libtiff)
     with Image.open("Tests/images/multipage.tiff") as im:
         for index, frame in enumerate(ImageSequence.Iterator(im)):
             frame.load()
@@ -55,16 +59,6 @@ def _test_multipage_tiff() -> None:
             frame.convert("RGB")
 
 
-def test_tiff() -> None:
-    _test_multipage_tiff()
-
-
-@skip_unless_feature("libtiff")
-def test_libtiff(monkeypatch: pytest.MonkeyPatch) -> None:
-    monkeypatch.setattr(TiffImagePlugin, "READ_LIBTIFF", True)
-    _test_multipage_tiff()
-
-
 def test_consecutive() -> None:
     with Image.open("Tests/images/multipage.tiff") as im:
         first_frame = None

From 139245a3db00cf4cc6de4ed726eba4561dcd5cec Mon Sep 17 00:00:00 2001
From: Yay295 <Yay295@gmail.com>
Date: Wed, 27 Mar 2024 10:29:19 -0500
Subject: [PATCH 0534/1178] use namedtuple for image mode info

---
 Tests/test_image.py | 67 ++++++++++++++++++++++++---------------------
 1 file changed, 36 insertions(+), 31 deletions(-)

diff --git a/Tests/test_image.py b/Tests/test_image.py
index 941ec40d9bc..779785c5345 100644
--- a/Tests/test_image.py
+++ b/Tests/test_image.py
@@ -8,7 +8,7 @@
 import tempfile
 import warnings
 from pathlib import Path
-from typing import IO
+from typing import IO, NamedTuple
 
 import pytest
 
@@ -33,34 +33,39 @@
     skip_unless_feature,
 )
 
-# name, pixel size
+
+class ImageModeInfo(NamedTuple):
+    name: str
+    pixel_size: int
+
+
 image_modes = (
-    ("1", 1),
-    ("L", 1),
-    ("LA", 4),
-    ("La", 4),
-    ("P", 1),
-    ("PA", 4),
-    ("F", 4),
-    ("I", 4),
-    ("I;16", 2),
-    ("I;16L", 2),
-    ("I;16B", 2),
-    ("I;16N", 2),
-    ("RGB", 4),
-    ("RGBA", 4),
-    ("RGBa", 4),
-    ("RGBX", 4),
-    ("BGR;15", 2),
-    ("BGR;16", 2),
-    ("BGR;24", 3),
-    ("CMYK", 4),
-    ("YCbCr", 4),
-    ("HSV", 4),
-    ("LAB", 4),
+    ImageModeInfo("1", 1),
+    ImageModeInfo("L", 1),
+    ImageModeInfo("LA", 4),
+    ImageModeInfo("La", 4),
+    ImageModeInfo("P", 1),
+    ImageModeInfo("PA", 4),
+    ImageModeInfo("F", 4),
+    ImageModeInfo("I", 4),
+    ImageModeInfo("I;16", 2),
+    ImageModeInfo("I;16L", 2),
+    ImageModeInfo("I;16B", 2),
+    ImageModeInfo("I;16N", 2),
+    ImageModeInfo("RGB", 4),
+    ImageModeInfo("RGBA", 4),
+    ImageModeInfo("RGBa", 4),
+    ImageModeInfo("RGBX", 4),
+    ImageModeInfo("BGR;15", 2),
+    ImageModeInfo("BGR;16", 2),
+    ImageModeInfo("BGR;24", 3),
+    ImageModeInfo("CMYK", 4),
+    ImageModeInfo("YCbCr", 4),
+    ImageModeInfo("HSV", 4),
+    ImageModeInfo("LAB", 4),
 )
 
-image_mode_names = [name for name, _ in image_modes]
+image_mode_names = [mode.name for mode in image_modes]
 
 
 class TestImage:
@@ -1062,13 +1067,13 @@ def test_roundtrip_bytes_method(self, mode: str) -> None:
         reloaded.frombytes(source_bytes)
         assert reloaded.tobytes() == source_bytes
 
-    @pytest.mark.parametrize(("mode", "pixelsize"), image_modes)
-    def test_getdata_putdata(self, mode: str, pixelsize: int) -> None:
-        im = Image.new(mode, (2, 2))
-        source_bytes = bytes(range(im.width * im.height * pixelsize))
+    @pytest.mark.parametrize("mode", image_modes)
+    def test_getdata_putdata(self, mode: ImageModeInfo) -> None:
+        im = Image.new(mode.name, (2, 2))
+        source_bytes = bytes(range(im.width * im.height * mode.pixel_size))
         im.frombytes(source_bytes)
 
-        reloaded = Image.new(mode, im.size)
+        reloaded = Image.new(mode.name, im.size)
         reloaded.putdata(im.getdata())
         assert_image_equal(im, reloaded)
 

From 5a4b771fb00389a43dbf32a4c13d73c9b39e3f5d Mon Sep 17 00:00:00 2001
From: Yay295 <Yay295@gmail.com>
Date: Mon, 2 Jan 2023 16:55:31 -0600
Subject: [PATCH 0535/1178] move image mode info variables to helper.py

---
 Tests/helper.py     | 36 +++++++++++++++++++++++++++++++++++-
 Tests/test_image.py | 39 ++++-----------------------------------
 2 files changed, 39 insertions(+), 36 deletions(-)

diff --git a/Tests/helper.py b/Tests/helper.py
index c1399e89bf8..32ea99fdd9e 100644
--- a/Tests/helper.py
+++ b/Tests/helper.py
@@ -13,7 +13,7 @@
 import tempfile
 from functools import lru_cache
 from io import BytesIO
-from typing import Any, Callable, Sequence
+from typing import Any, Callable, NamedTuple, Sequence
 
 import pytest
 from packaging.version import parse as parse_version
@@ -29,6 +29,40 @@
     uploader = "github_actions"
 
 
+class ImageModeInfo(NamedTuple):
+    name: str
+    pixel_size: int
+
+
+image_modes = (
+    ImageModeInfo("1", 1),
+    ImageModeInfo("L", 1),
+    ImageModeInfo("LA", 4),
+    ImageModeInfo("La", 4),
+    ImageModeInfo("P", 1),
+    ImageModeInfo("PA", 4),
+    ImageModeInfo("F", 4),
+    ImageModeInfo("I", 4),
+    ImageModeInfo("I;16", 2),
+    ImageModeInfo("I;16L", 2),
+    ImageModeInfo("I;16B", 2),
+    ImageModeInfo("I;16N", 2),
+    ImageModeInfo("RGB", 4),
+    ImageModeInfo("RGBA", 4),
+    ImageModeInfo("RGBa", 4),
+    ImageModeInfo("RGBX", 4),
+    ImageModeInfo("BGR;15", 2),
+    ImageModeInfo("BGR;16", 2),
+    ImageModeInfo("BGR;24", 3),
+    ImageModeInfo("CMYK", 4),
+    ImageModeInfo("YCbCr", 4),
+    ImageModeInfo("HSV", 4),
+    ImageModeInfo("LAB", 4),
+)
+
+image_mode_names = [mode.name for mode in image_modes]
+
+
 def upload(a: Image.Image, b: Image.Image) -> str | None:
     if uploader == "show":
         # local img.show for errors.
diff --git a/Tests/test_image.py b/Tests/test_image.py
index 779785c5345..5654307f1c4 100644
--- a/Tests/test_image.py
+++ b/Tests/test_image.py
@@ -8,7 +8,7 @@
 import tempfile
 import warnings
 from pathlib import Path
-from typing import IO, NamedTuple
+from typing import IO
 
 import pytest
 
@@ -23,51 +23,20 @@
 )
 
 from .helper import (
+    ImageModeInfo,
     assert_image_equal,
     assert_image_equal_tofile,
     assert_image_similar_tofile,
     assert_not_all_same,
     hopper,
+    image_mode_names,
+    image_modes,
     is_win32,
     mark_if_feature_version,
     skip_unless_feature,
 )
 
 
-class ImageModeInfo(NamedTuple):
-    name: str
-    pixel_size: int
-
-
-image_modes = (
-    ImageModeInfo("1", 1),
-    ImageModeInfo("L", 1),
-    ImageModeInfo("LA", 4),
-    ImageModeInfo("La", 4),
-    ImageModeInfo("P", 1),
-    ImageModeInfo("PA", 4),
-    ImageModeInfo("F", 4),
-    ImageModeInfo("I", 4),
-    ImageModeInfo("I;16", 2),
-    ImageModeInfo("I;16L", 2),
-    ImageModeInfo("I;16B", 2),
-    ImageModeInfo("I;16N", 2),
-    ImageModeInfo("RGB", 4),
-    ImageModeInfo("RGBA", 4),
-    ImageModeInfo("RGBa", 4),
-    ImageModeInfo("RGBX", 4),
-    ImageModeInfo("BGR;15", 2),
-    ImageModeInfo("BGR;16", 2),
-    ImageModeInfo("BGR;24", 3),
-    ImageModeInfo("CMYK", 4),
-    ImageModeInfo("YCbCr", 4),
-    ImageModeInfo("HSV", 4),
-    ImageModeInfo("LAB", 4),
-)
-
-image_mode_names = [mode.name for mode in image_modes]
-
-
 class TestImage:
     @pytest.mark.parametrize("mode", image_mode_names)
     def test_image_modes_success(self, mode: str) -> None:

From 0fed6a5fbcbe40aff7540693a438d18d825c839e Mon Sep 17 00:00:00 2001
From: Yay295 <Yay295@gmail.com>
Date: Sun, 31 Mar 2024 23:29:01 -0500
Subject: [PATCH 0536/1178] use common image mode list for TestImageGetPixel
 tests

---
 Tests/test_image_access.py | 38 ++++++++------------------------------
 1 file changed, 8 insertions(+), 30 deletions(-)

diff --git a/Tests/test_image_access.py b/Tests/test_image_access.py
index 8c42da57a37..96afc87a475 100644
--- a/Tests/test_image_access.py
+++ b/Tests/test_image_access.py
@@ -10,7 +10,7 @@
 
 from PIL import Image
 
-from .helper import assert_image_equal, hopper, is_win32
+from .helper import assert_image_equal, hopper, image_mode_names, is_win32
 
 # CFFI imports pycparser which doesn't support PYTHONOPTIMIZE=2
 # https://github.com/eliben/pycparser/pull/198#issuecomment-317001670
@@ -138,8 +138,8 @@ def color(mode: str) -> int | tuple[int, ...]:
         if bands == 1:
             return 1
         if mode in ("BGR;15", "BGR;16"):
-            # These modes have less than 8 bits per band
-            # So (1, 2, 3) cannot be roundtripped
+            # These modes have less than 8 bits per band,
+            # so (1, 2, 3) cannot be roundtripped.
             return (16, 32, 49)
         return tuple(range(1, bands + 1))
 
@@ -168,16 +168,15 @@ def check(self, mode: str, expected_color_int: int | None = None) -> None:
             f"expected {expected_color} got {actual_color}"
         )
 
-        # Check 0
+        # check 0x0 image with None initial color
         im = Image.new(mode, (0, 0), None)
         assert im.load() is not None
-
         error = ValueError if self._need_cffi_access else IndexError
         with pytest.raises(error):
             im.putpixel((0, 0), expected_color)
         with pytest.raises(error):
             im.getpixel((0, 0))
-        # Check 0 negative index
+        # check negative index
         with pytest.raises(error):
             im.putpixel((-1, -1), expected_color)
         with pytest.raises(error):
@@ -198,36 +197,15 @@ def check(self, mode: str, expected_color_int: int | None = None) -> None:
             f"expected {expected_color} got {actual_color}"
         )
 
-        # Check 0
+        # check 0x0 image with initial color
         im = Image.new(mode, (0, 0), expected_color)
         with pytest.raises(error):
             im.getpixel((0, 0))
-        # Check 0 negative index
+        # check negative index
         with pytest.raises(error):
             im.getpixel((-1, -1))
 
-    @pytest.mark.parametrize(
-        "mode",
-        (
-            "1",
-            "L",
-            "LA",
-            "I",
-            "I;16",
-            "I;16B",
-            "F",
-            "P",
-            "PA",
-            "BGR;15",
-            "BGR;16",
-            "BGR;24",
-            "RGB",
-            "RGBA",
-            "RGBX",
-            "CMYK",
-            "YCbCr",
-        ),
-    )
+    @pytest.mark.parametrize("mode", image_mode_names)
     def test_basic(self, mode: str) -> None:
         self.check(mode)
 

From da7198c98740e9607dac0bf97ae073cf21510634 Mon Sep 17 00:00:00 2001
From: Yay295 <Yay295@gmail.com>
Date: Sat, 30 Mar 2024 14:32:45 -0500
Subject: [PATCH 0537/1178] fix ImagingAccess for I;16N on big-endian

---
 src/libImaging/Access.c | 12 +++++-------
 1 file changed, 5 insertions(+), 7 deletions(-)

diff --git a/src/libImaging/Access.c b/src/libImaging/Access.c
index 091c84e18fa..04618df0965 100644
--- a/src/libImaging/Access.c
+++ b/src/libImaging/Access.c
@@ -81,12 +81,6 @@ get_pixel_16B(Imaging im, int x, int y, void *color) {
 #endif
 }
 
-static void
-get_pixel_16(Imaging im, int x, int y, void *color) {
-    UINT8 *in = (UINT8 *)&im->image[y][x + x];
-    memcpy(color, in, sizeof(UINT16));
-}
-
 static void
 get_pixel_BGR15(Imaging im, int x, int y, void *color) {
     UINT8 *in = (UINT8 *)&im->image8[y][x * 2];
@@ -207,7 +201,11 @@ ImagingAccessInit() {
     ADD("I;16", get_pixel_16L, put_pixel_16L);
     ADD("I;16L", get_pixel_16L, put_pixel_16L);
     ADD("I;16B", get_pixel_16B, put_pixel_16B);
-    ADD("I;16N", get_pixel_16, put_pixel_16L);
+#ifdef WORDS_BIGENDIAN
+    ADD("I;16N", get_pixel_16B, put_pixel_16B);
+#else
+    ADD("I;16N", get_pixel_16L, put_pixel_16L);
+#endif
     ADD("I;32L", get_pixel_32L, put_pixel_32L);
     ADD("I;32B", get_pixel_32B, put_pixel_32B);
     ADD("F", get_pixel_32, put_pixel_32);

From 5dabc6cf14c78d397d2b31d81d6a7fe9e10dbd3b Mon Sep 17 00:00:00 2001
From: Yay295 <Yay295@gmail.com>
Date: Sat, 30 Mar 2024 15:10:04 -0500
Subject: [PATCH 0538/1178] fix I;16N lib pack test

---
 Tests/test_lib_pack.py | 5 ++++-
 1 file changed, 4 insertions(+), 1 deletion(-)

diff --git a/Tests/test_lib_pack.py b/Tests/test_lib_pack.py
index 6a0e704b89a..f34ff7d0230 100644
--- a/Tests/test_lib_pack.py
+++ b/Tests/test_lib_pack.py
@@ -216,7 +216,10 @@ def test_I(self) -> None:
             )
 
     def test_I16(self) -> None:
-        self.assert_pack("I;16N", "I;16N", 2, 0x0201, 0x0403, 0x0605)
+        if sys.byteorder == "little":
+            self.assert_pack("I;16N", "I;16N", 2, 0x0201, 0x0403, 0x0605)
+        else:
+            self.assert_pack("I;16N", "I;16N", 2, 0x0102, 0x0304, 0x0506)
 
     def test_F_float(self) -> None:
         self.assert_pack("F", "F;32F", 4, 1.539989614439558e-36, 4.063216068939723e-34)

From fe79ae5653e42e5b5c42ff5428eeef36e4bbe7a6 Mon Sep 17 00:00:00 2001
From: Yay295 <Yay295@gmail.com>
Date: Sat, 6 Apr 2024 10:48:38 -0500
Subject: [PATCH 0539/1178] get pixel size by counting bytes in 1x1 image

---
 Tests/helper.py     | 57 ++++++++++++++++++++-------------------------
 Tests/test_image.py | 19 +++++++++------
 2 files changed, 37 insertions(+), 39 deletions(-)

diff --git a/Tests/helper.py b/Tests/helper.py
index 32ea99fdd9e..f0bb8af00ba 100644
--- a/Tests/helper.py
+++ b/Tests/helper.py
@@ -13,7 +13,7 @@
 import tempfile
 from functools import lru_cache
 from io import BytesIO
-from typing import Any, Callable, NamedTuple, Sequence
+from typing import Any, Callable, Sequence
 
 import pytest
 from packaging.version import parse as parse_version
@@ -29,39 +29,32 @@
     uploader = "github_actions"
 
 
-class ImageModeInfo(NamedTuple):
-    name: str
-    pixel_size: int
-
-
-image_modes = (
-    ImageModeInfo("1", 1),
-    ImageModeInfo("L", 1),
-    ImageModeInfo("LA", 4),
-    ImageModeInfo("La", 4),
-    ImageModeInfo("P", 1),
-    ImageModeInfo("PA", 4),
-    ImageModeInfo("F", 4),
-    ImageModeInfo("I", 4),
-    ImageModeInfo("I;16", 2),
-    ImageModeInfo("I;16L", 2),
-    ImageModeInfo("I;16B", 2),
-    ImageModeInfo("I;16N", 2),
-    ImageModeInfo("RGB", 4),
-    ImageModeInfo("RGBA", 4),
-    ImageModeInfo("RGBa", 4),
-    ImageModeInfo("RGBX", 4),
-    ImageModeInfo("BGR;15", 2),
-    ImageModeInfo("BGR;16", 2),
-    ImageModeInfo("BGR;24", 3),
-    ImageModeInfo("CMYK", 4),
-    ImageModeInfo("YCbCr", 4),
-    ImageModeInfo("HSV", 4),
-    ImageModeInfo("LAB", 4),
+image_mode_names = (
+    "1",
+    "L",
+    "LA",
+    "La",
+    "P",
+    "PA",
+    "F",
+    "I",
+    "I;16",
+    "I;16L",
+    "I;16B",
+    "I;16N",
+    "RGB",
+    "RGBA",
+    "RGBa",
+    "RGBX",
+    "BGR;15",
+    "BGR;16",
+    "BGR;24",
+    "CMYK",
+    "YCbCr",
+    "HSV",
+    "LAB",
 )
 
-image_mode_names = [mode.name for mode in image_modes]
-
 
 def upload(a: Image.Image, b: Image.Image) -> str | None:
     if uploader == "show":
diff --git a/Tests/test_image.py b/Tests/test_image.py
index 5654307f1c4..8b20de0a908 100644
--- a/Tests/test_image.py
+++ b/Tests/test_image.py
@@ -23,14 +23,12 @@
 )
 
 from .helper import (
-    ImageModeInfo,
     assert_image_equal,
     assert_image_equal_tofile,
     assert_image_similar_tofile,
     assert_not_all_same,
     hopper,
     image_mode_names,
-    image_modes,
     is_win32,
     mark_if_feature_version,
     skip_unless_feature,
@@ -1036,13 +1034,20 @@ def test_roundtrip_bytes_method(self, mode: str) -> None:
         reloaded.frombytes(source_bytes)
         assert reloaded.tobytes() == source_bytes
 
-    @pytest.mark.parametrize("mode", image_modes)
-    def test_getdata_putdata(self, mode: ImageModeInfo) -> None:
-        im = Image.new(mode.name, (2, 2))
-        source_bytes = bytes(range(im.width * im.height * mode.pixel_size))
+    @pytest.mark.parametrize("mode", image_mode_names)
+    def test_getdata_putdata(self, mode: str) -> None:
+        # create an image with 1 pixel to get its pixel size
+        im = Image.new(mode, (1, 1))
+        pixel_size = len(im.tobytes())
+
+        # create a new image with incrementing byte values
+        im = Image.new(mode, (2, 2))
+        source_bytes = bytes(range(im.width * im.height * pixel_size))
         im.frombytes(source_bytes)
 
-        reloaded = Image.new(mode.name, im.size)
+        # copy the data from the previous image to a new image
+        # and check that they are the same
+        reloaded = Image.new(mode, im.size)
         reloaded.putdata(im.getdata())
         assert_image_equal(im, reloaded)
 

From 5573ec74901945c58e700b2becb34ac800607bbe Mon Sep 17 00:00:00 2001
From: Andrew Murray <radarhere@users.noreply.github.com>
Date: Sun, 7 Apr 2024 22:54:47 +1000
Subject: [PATCH 0540/1178] use hopper() for test_getdata_putdata()

---
 Tests/test_image.py | 12 +-----------
 1 file changed, 1 insertion(+), 11 deletions(-)

diff --git a/Tests/test_image.py b/Tests/test_image.py
index 8b20de0a908..090b80f87ce 100644
--- a/Tests/test_image.py
+++ b/Tests/test_image.py
@@ -1036,17 +1036,7 @@ def test_roundtrip_bytes_method(self, mode: str) -> None:
 
     @pytest.mark.parametrize("mode", image_mode_names)
     def test_getdata_putdata(self, mode: str) -> None:
-        # create an image with 1 pixel to get its pixel size
-        im = Image.new(mode, (1, 1))
-        pixel_size = len(im.tobytes())
-
-        # create a new image with incrementing byte values
-        im = Image.new(mode, (2, 2))
-        source_bytes = bytes(range(im.width * im.height * pixel_size))
-        im.frombytes(source_bytes)
-
-        # copy the data from the previous image to a new image
-        # and check that they are the same
+        im = hopper(mode)
         reloaded = Image.new(mode, im.size)
         reloaded.putdata(im.getdata())
         assert_image_equal(im, reloaded)

From 5c960d6abc25aa94044a0831743e061383d3f486 Mon Sep 17 00:00:00 2001
From: Andrew Murray <radarhere@users.noreply.github.com>
Date: Sun, 7 Apr 2024 23:01:51 +1000
Subject: [PATCH 0541/1178] rename "image_mode_names" to "modes"

---
 Tests/helper.py            |  2 +-
 Tests/test_image.py        | 10 +++++-----
 Tests/test_image_access.py |  4 ++--
 3 files changed, 8 insertions(+), 8 deletions(-)

diff --git a/Tests/helper.py b/Tests/helper.py
index f0bb8af00ba..5d206f6449a 100644
--- a/Tests/helper.py
+++ b/Tests/helper.py
@@ -29,7 +29,7 @@
     uploader = "github_actions"
 
 
-image_mode_names = (
+modes = (
     "1",
     "L",
     "LA",
diff --git a/Tests/test_image.py b/Tests/test_image.py
index 090b80f87ce..9985f23469b 100644
--- a/Tests/test_image.py
+++ b/Tests/test_image.py
@@ -28,15 +28,15 @@
     assert_image_similar_tofile,
     assert_not_all_same,
     hopper,
-    image_mode_names,
     is_win32,
     mark_if_feature_version,
+    modes,
     skip_unless_feature,
 )
 
 
 class TestImage:
-    @pytest.mark.parametrize("mode", image_mode_names)
+    @pytest.mark.parametrize("mode", modes)
     def test_image_modes_success(self, mode: str) -> None:
         Image.new(mode, (1, 1))
 
@@ -1017,7 +1017,7 @@ def test_close_graceful(self, caplog: pytest.LogCaptureFixture) -> None:
 
 
 class TestImageBytes:
-    @pytest.mark.parametrize("mode", image_mode_names)
+    @pytest.mark.parametrize("mode", modes)
     def test_roundtrip_bytes_constructor(self, mode: str) -> None:
         im = hopper(mode)
         source_bytes = im.tobytes()
@@ -1025,7 +1025,7 @@ def test_roundtrip_bytes_constructor(self, mode: str) -> None:
         reloaded = Image.frombytes(mode, im.size, source_bytes)
         assert reloaded.tobytes() == source_bytes
 
-    @pytest.mark.parametrize("mode", image_mode_names)
+    @pytest.mark.parametrize("mode", modes)
     def test_roundtrip_bytes_method(self, mode: str) -> None:
         im = hopper(mode)
         source_bytes = im.tobytes()
@@ -1034,7 +1034,7 @@ def test_roundtrip_bytes_method(self, mode: str) -> None:
         reloaded.frombytes(source_bytes)
         assert reloaded.tobytes() == source_bytes
 
-    @pytest.mark.parametrize("mode", image_mode_names)
+    @pytest.mark.parametrize("mode", modes)
     def test_getdata_putdata(self, mode: str) -> None:
         im = hopper(mode)
         reloaded = Image.new(mode, im.size)
diff --git a/Tests/test_image_access.py b/Tests/test_image_access.py
index 96afc87a475..50afb2a2368 100644
--- a/Tests/test_image_access.py
+++ b/Tests/test_image_access.py
@@ -10,7 +10,7 @@
 
 from PIL import Image
 
-from .helper import assert_image_equal, hopper, image_mode_names, is_win32
+from .helper import assert_image_equal, hopper, is_win32, modes
 
 # CFFI imports pycparser which doesn't support PYTHONOPTIMIZE=2
 # https://github.com/eliben/pycparser/pull/198#issuecomment-317001670
@@ -205,7 +205,7 @@ def check(self, mode: str, expected_color_int: int | None = None) -> None:
         with pytest.raises(error):
             im.getpixel((-1, -1))
 
-    @pytest.mark.parametrize("mode", image_mode_names)
+    @pytest.mark.parametrize("mode", modes)
     def test_basic(self, mode: str) -> None:
         self.check(mode)
 

From 98510570e6a54398c7975f1128b3de91fd8aad1f Mon Sep 17 00:00:00 2001
From: Yay295 <Yay295@gmail.com>
Date: Sat, 20 Apr 2024 09:19:20 -0500
Subject: [PATCH 0542/1178] ignore BGR;15/16 test failure on big-endian

---
 Tests/test_image.py | 3 +++
 1 file changed, 3 insertions(+)

diff --git a/Tests/test_image.py b/Tests/test_image.py
index 9985f23469b..4a056df4083 100644
--- a/Tests/test_image.py
+++ b/Tests/test_image.py
@@ -28,6 +28,7 @@
     assert_image_similar_tofile,
     assert_not_all_same,
     hopper,
+    is_big_endian,
     is_win32,
     mark_if_feature_version,
     modes,
@@ -1036,6 +1037,8 @@ def test_roundtrip_bytes_method(self, mode: str) -> None:
 
     @pytest.mark.parametrize("mode", modes)
     def test_getdata_putdata(self, mode: str) -> None:
+        if is_big_endian and mode in ("BGR;15", "BGR;16"):
+            pytest.xfail(f"Known failure of {mode} on big-endian")
         im = hopper(mode)
         reloaded = Image.new(mode, im.size)
         reloaded.putdata(im.getdata())

From 98a0515494bc4cb43f2ede5fd80af82ee8f4fc59 Mon Sep 17 00:00:00 2001
From: Andrew Murray <radarhere@users.noreply.github.com>
Date: Mon, 22 Apr 2024 08:05:59 +1000
Subject: [PATCH 0543/1178] Read images as RGB, rather than RGBX

---
 src/PIL/ImImagePlugin.py   |  2 +-
 src/PIL/TiffImagePlugin.py | 16 ++++++++--------
 src/libImaging/Unpack.c    |  4 ++++
 3 files changed, 13 insertions(+), 9 deletions(-)

diff --git a/src/PIL/ImImagePlugin.py b/src/PIL/ImImagePlugin.py
index 4613e40b60f..6463572f5c2 100644
--- a/src/PIL/ImImagePlugin.py
+++ b/src/PIL/ImImagePlugin.py
@@ -78,7 +78,7 @@
     "LA image": ("LA", "LA;L"),
     "PA image": ("LA", "PA;L"),
     "RGBA image": ("RGBA", "RGBA;L"),
-    "RGBX image": ("RGBX", "RGBX;L"),
+    "RGBX image": ("RGB", "RGBX;L"),
     "CMYK image": ("CMYK", "CMYK;L"),
     "YCC image": ("YCbCr", "YCbCr;L"),
 }
diff --git a/src/PIL/TiffImagePlugin.py b/src/PIL/TiffImagePlugin.py
index 10ac9ea3a2a..e3714059088 100644
--- a/src/PIL/TiffImagePlugin.py
+++ b/src/PIL/TiffImagePlugin.py
@@ -200,12 +200,12 @@
     (MM, 2, (1,), 2, (8, 8, 8), ()): ("RGB", "RGB;R"),
     (II, 2, (1,), 1, (8, 8, 8, 8), ()): ("RGBA", "RGBA"),  # missing ExtraSamples
     (MM, 2, (1,), 1, (8, 8, 8, 8), ()): ("RGBA", "RGBA"),  # missing ExtraSamples
-    (II, 2, (1,), 1, (8, 8, 8, 8), (0,)): ("RGBX", "RGBX"),
-    (MM, 2, (1,), 1, (8, 8, 8, 8), (0,)): ("RGBX", "RGBX"),
-    (II, 2, (1,), 1, (8, 8, 8, 8, 8), (0, 0)): ("RGBX", "RGBXX"),
-    (MM, 2, (1,), 1, (8, 8, 8, 8, 8), (0, 0)): ("RGBX", "RGBXX"),
-    (II, 2, (1,), 1, (8, 8, 8, 8, 8, 8), (0, 0, 0)): ("RGBX", "RGBXXX"),
-    (MM, 2, (1,), 1, (8, 8, 8, 8, 8, 8), (0, 0, 0)): ("RGBX", "RGBXXX"),
+    (II, 2, (1,), 1, (8, 8, 8, 8), (0,)): ("RGB", "RGBX"),
+    (MM, 2, (1,), 1, (8, 8, 8, 8), (0,)): ("RGB", "RGBX"),
+    (II, 2, (1,), 1, (8, 8, 8, 8, 8), (0, 0)): ("RGB", "RGBXX"),
+    (MM, 2, (1,), 1, (8, 8, 8, 8, 8), (0, 0)): ("RGB", "RGBXX"),
+    (II, 2, (1,), 1, (8, 8, 8, 8, 8, 8), (0, 0, 0)): ("RGB", "RGBXXX"),
+    (MM, 2, (1,), 1, (8, 8, 8, 8, 8, 8), (0, 0, 0)): ("RGB", "RGBXXX"),
     (II, 2, (1,), 1, (8, 8, 8, 8), (1,)): ("RGBA", "RGBa"),
     (MM, 2, (1,), 1, (8, 8, 8, 8), (1,)): ("RGBA", "RGBa"),
     (II, 2, (1,), 1, (8, 8, 8, 8, 8), (1, 0)): ("RGBA", "RGBaX"),
@@ -224,8 +224,8 @@
     (MM, 2, (1,), 1, (16, 16, 16), ()): ("RGB", "RGB;16B"),
     (II, 2, (1,), 1, (16, 16, 16, 16), ()): ("RGBA", "RGBA;16L"),
     (MM, 2, (1,), 1, (16, 16, 16, 16), ()): ("RGBA", "RGBA;16B"),
-    (II, 2, (1,), 1, (16, 16, 16, 16), (0,)): ("RGBX", "RGBX;16L"),
-    (MM, 2, (1,), 1, (16, 16, 16, 16), (0,)): ("RGBX", "RGBX;16B"),
+    (II, 2, (1,), 1, (16, 16, 16, 16), (0,)): ("RGB", "RGBX;16L"),
+    (MM, 2, (1,), 1, (16, 16, 16, 16), (0,)): ("RGB", "RGBX;16B"),
     (II, 2, (1,), 1, (16, 16, 16, 16), (1,)): ("RGBA", "RGBa;16L"),
     (MM, 2, (1,), 1, (16, 16, 16, 16), (1,)): ("RGBA", "RGBa;16B"),
     (II, 2, (1,), 1, (16, 16, 16, 16), (2,)): ("RGBA", "RGBA;16L"),
diff --git a/src/libImaging/Unpack.c b/src/libImaging/Unpack.c
index a84dc0a6fd2..f15769c4359 100644
--- a/src/libImaging/Unpack.c
+++ b/src/libImaging/Unpack.c
@@ -1599,10 +1599,14 @@ static struct {
     {"RGB", "BGR;15", 16, ImagingUnpackBGR15},
     {"RGB", "RGB;16", 16, ImagingUnpackRGB16},
     {"RGB", "BGR;16", 16, ImagingUnpackBGR16},
+    {"RGB", "RGBX;16L", 64, unpackRGBA16L},
+    {"RGB", "RGBX;16B", 64, unpackRGBA16B},
     {"RGB", "RGB;4B", 16, ImagingUnpackRGB4B},
     {"RGB", "BGR;5", 16, ImagingUnpackBGR15}, /* compat */
     {"RGB", "RGBX", 32, copy4},
     {"RGB", "RGBX;L", 32, unpackRGBAL},
+    {"RGB", "RGBXX", 40, copy4skip1},
+    {"RGB", "RGBXXX", 48, copy4skip2},
     {"RGB", "RGBA;L", 32, unpackRGBAL},
     {"RGB", "RGBA;15", 16, ImagingUnpackRGBA15},
     {"RGB", "BGRX", 32, ImagingUnpackBGRX},

From bb2411dd01197d0a393dbcfdccfdd487a8c6d7be Mon Sep 17 00:00:00 2001
From: Andrew Murray <radarhere@users.noreply.github.com>
Date: Mon, 22 Apr 2024 08:11:45 +1000
Subject: [PATCH 0544/1178] Support reading P mode TIFF images with padding

---
 src/PIL/TiffImagePlugin.py | 1 +
 src/libImaging/Unpack.c    | 1 +
 2 files changed, 2 insertions(+)

diff --git a/src/PIL/TiffImagePlugin.py b/src/PIL/TiffImagePlugin.py
index 10ac9ea3a2a..106f09c2dde 100644
--- a/src/PIL/TiffImagePlugin.py
+++ b/src/PIL/TiffImagePlugin.py
@@ -244,6 +244,7 @@
     (MM, 3, (1,), 2, (4,), ()): ("P", "P;4R"),
     (II, 3, (1,), 1, (8,), ()): ("P", "P"),
     (MM, 3, (1,), 1, (8,), ()): ("P", "P"),
+    (II, 3, (1,), 1, (8, 8), (0,)): ("P", "PX"),
     (II, 3, (1,), 1, (8, 8), (2,)): ("PA", "PA"),
     (MM, 3, (1,), 1, (8, 8), (2,)): ("PA", "PA"),
     (II, 3, (1,), 2, (8,), ()): ("P", "P;R"),
diff --git a/src/libImaging/Unpack.c b/src/libImaging/Unpack.c
index a84dc0a6fd2..e351aa2f19b 100644
--- a/src/libImaging/Unpack.c
+++ b/src/libImaging/Unpack.c
@@ -1582,6 +1582,7 @@ static struct {
     {"P", "P", 8, copy1},
     {"P", "P;R", 8, unpackLR},
     {"P", "L", 8, copy1},
+    {"P", "PX", 16, unpackL16B},
 
     /* palette w. alpha */
     {"PA", "PA", 16, unpackLA},

From d5c1ff4b43b0b17d2379939cf941b06e3b0c3464 Mon Sep 17 00:00:00 2001
From: Andrew Murray <radarhere@users.noreply.github.com>
Date: Tue, 16 Apr 2024 22:22:25 +1000
Subject: [PATCH 0545/1178] Removed type hint ignores

---
 src/PIL/ImageCms.py | 4 ++--
 1 file changed, 2 insertions(+), 2 deletions(-)

diff --git a/src/PIL/ImageCms.py b/src/PIL/ImageCms.py
index 4af1b79e2e3..5f5c5df54e7 100644
--- a/src/PIL/ImageCms.py
+++ b/src/PIL/ImageCms.py
@@ -838,8 +838,8 @@ def getProfileName(profile: _CmsProfileCompatible) -> str:
 
         if not (model or manufacturer):
             return (profile.profile.profile_description or "") + "\n"
-        if not manufacturer or len(model) > 30:  # type: ignore[arg-type]
-            return model + "\n"  # type: ignore[operator]
+        if not manufacturer or (model and len(model) > 30):
+            return f"{model}\n"
         return f"{model} - {manufacturer}\n"
 
     except (AttributeError, OSError, TypeError, ValueError) as v:

From 4171435db45822f6ebf696e36a7edfacdb1e6756 Mon Sep 17 00:00:00 2001
From: Andrew Murray <radarhere@users.noreply.github.com>
Date: Mon, 15 Apr 2024 18:25:03 +1000
Subject: [PATCH 0546/1178] Added more modes

---
 src/PIL/Image.py | 23 ++++++++++++++++++++++-
 1 file changed, 22 insertions(+), 1 deletion(-)

diff --git a/src/PIL/Image.py b/src/PIL/Image.py
index c65cf38500a..8efaf8b784f 100644
--- a/src/PIL/Image.py
+++ b/src/PIL/Image.py
@@ -248,7 +248,28 @@ def _conv_type_shape(im):
     return shape, m.typestr
 
 
-MODES = ["1", "CMYK", "F", "HSV", "I", "L", "LAB", "P", "RGB", "RGBA", "RGBX", "YCbCr"]
+MODES = [
+    "1",
+    "CMYK",
+    "F",
+    "HSV",
+    "I",
+    "I;16",
+    "I;16B",
+    "I;16L",
+    "I;16N",
+    "L",
+    "LA",
+    "La",
+    "LAB",
+    "P",
+    "PA",
+    "RGB",
+    "RGBA",
+    "RGBa",
+    "RGBX",
+    "YCbCr",
+]
 
 # raw modes that may be memory mapped.  NOTE: if you change this, you
 # may have to modify the stride calculation in map.c too!

From 745eb23a87b40707af9474ad732fc6d13b94628f Mon Sep 17 00:00:00 2001
From: Andrew Murray <radarhere@users.noreply.github.com>
Date: Mon, 15 Apr 2024 22:22:40 +1000
Subject: [PATCH 0547/1178] Use LAB hopper file if conversion is not supported

---
 Tests/helper.py | 9 ++++++++-
 1 file changed, 8 insertions(+), 1 deletion(-)

diff --git a/Tests/helper.py b/Tests/helper.py
index c1399e89bf8..680825d4be7 100644
--- a/Tests/helper.py
+++ b/Tests/helper.py
@@ -273,7 +273,14 @@ def _cached_hopper(mode: str) -> Image.Image:
         im = hopper("L")
     else:
         im = hopper()
-    return im.convert(mode)
+    try:
+        im = im.convert(mode)
+    except ImportError:
+        if mode == "LAB":
+            im = Image.open("Tests/images/hopper.Lab.tif")
+        else:
+            raise
+    return im
 
 
 def djpeg_available() -> bool:

From f690b7f6915ed0cfee0b1b4246741d17aa2e70b1 Mon Sep 17 00:00:00 2001
From: Andrew Murray <radarhere@users.noreply.github.com>
Date: Mon, 22 Apr 2024 13:39:35 +1000
Subject: [PATCH 0548/1178] Added MPEG accept function

---
 Tests/test_file_mpeg.py    | 39 ++++++++++++++++++++++++++++++++++++++
 src/PIL/MpegImagePlugin.py |  6 +++++-
 2 files changed, 44 insertions(+), 1 deletion(-)
 create mode 100644 Tests/test_file_mpeg.py

diff --git a/Tests/test_file_mpeg.py b/Tests/test_file_mpeg.py
new file mode 100644
index 00000000000..468aef8a950
--- /dev/null
+++ b/Tests/test_file_mpeg.py
@@ -0,0 +1,39 @@
+from __future__ import annotations
+
+from io import BytesIO
+
+import pytest
+
+from PIL import Image, MpegImagePlugin
+
+
+def test_identify() -> None:
+    # Arrange
+    b = BytesIO(b"\x00\x00\x01\xb3\x01\x00\x01")
+
+    # Act
+    with Image.open(b) as im:
+        # Assert
+        assert im.format == "MPEG"
+
+        assert im.mode == "RGB"
+        assert im.size == (16, 1)
+
+
+def test_invalid_file() -> None:
+    # Arrange
+    invalid_file = "Tests/images/flower.jpg"
+
+    # Act / Assert
+    with pytest.raises(SyntaxError):
+        MpegImagePlugin.MpegImageFile(invalid_file)
+
+
+def test_load() -> None:
+    # Arrange
+    b = BytesIO(b"\x00\x00\x01\xb3\x01\x00\x01")
+
+    with Image.open(b) as im:
+        # Act / Assert: cannot load
+        with pytest.raises(OSError):
+            im.load()
diff --git a/src/PIL/MpegImagePlugin.py b/src/PIL/MpegImagePlugin.py
index 1565612f869..ad4d3e93768 100644
--- a/src/PIL/MpegImagePlugin.py
+++ b/src/PIL/MpegImagePlugin.py
@@ -53,6 +53,10 @@ def read(self, bits: int) -> int:
         return v
 
 
+def _accept(prefix: bytes) -> bool:
+    return prefix[:4] == b"\x00\x00\x01\xb3"
+
+
 ##
 # Image plugin for MPEG streams.  This plugin can identify a stream,
 # but it cannot read it.
@@ -77,7 +81,7 @@ def _open(self) -> None:
 # --------------------------------------------------------------------
 # Registry stuff
 
-Image.register_open(MpegImageFile.format, MpegImageFile)
+Image.register_open(MpegImageFile.format, MpegImageFile, _accept)
 
 Image.register_extensions(MpegImageFile.format, [".mpg", ".mpeg"])
 

From 023d017da00f8adb8de86719509145c405369ac8 Mon Sep 17 00:00:00 2001
From: Andrew Murray <radarhere@users.noreply.github.com>
Date: Mon, 22 Apr 2024 18:26:20 +1000
Subject: [PATCH 0549/1178] Deprecate libtiff < 4

---
 docs/deprecations.rst      | 8 ++++++++
 src/PIL/TiffImagePlugin.py | 4 ++++
 2 files changed, 12 insertions(+)

diff --git a/docs/deprecations.rst b/docs/deprecations.rst
index c3d1ba4f028..91bc150b342 100644
--- a/docs/deprecations.rst
+++ b/docs/deprecations.rst
@@ -100,6 +100,14 @@ ImageMath eval()
 ``ImageMath.eval()`` has been deprecated. Use :py:meth:`~PIL.ImageMath.lambda_eval` or
 :py:meth:`~PIL.ImageMath.unsafe_eval` instead.
 
+Support for libtiff earlier than 4
+^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
+
+.. deprecated:: 10.4.0
+
+Support for libtiff earlier than 4 has been deprecated. Upgrade to a newer version of
+libtiff instead.
+
 Removed features
 ----------------
 
diff --git a/src/PIL/TiffImagePlugin.py b/src/PIL/TiffImagePlugin.py
index 10ac9ea3a2a..13bcf5d8606 100644
--- a/src/PIL/TiffImagePlugin.py
+++ b/src/PIL/TiffImagePlugin.py
@@ -56,6 +56,7 @@
 from ._binary import i16be as i16
 from ._binary import i32be as i32
 from ._binary import o8
+from ._deprecate import deprecate
 from .TiffTags import TYPES
 
 logger = logging.getLogger(__name__)
@@ -276,6 +277,9 @@
     b"II\x2B\x00",  # BigTIFF with little-endian byte order
 ]
 
+if not getattr(Image.core, "libtiff_support_custom_tags", True):
+    deprecate("Support for libtiff earlier than 4", 12)
+
 
 def _accept(prefix: bytes) -> bool:
     return prefix[:4] in PREFIXES

From c7bb152ed94002a83d648d2a1b9703c2bf27e8e6 Mon Sep 17 00:00:00 2001
From: Andrew Murray <radarhere@users.noreply.github.com>
Date: Mon, 22 Apr 2024 18:30:00 +1000
Subject: [PATCH 0550/1178] support_custom_tags attribute is not present if
 libtiff is not supported

---
 Tests/test_file_libtiff.py | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/Tests/test_file_libtiff.py b/Tests/test_file_libtiff.py
index 71f1b6f1def..e1867cffb3a 100644
--- a/Tests/test_file_libtiff.py
+++ b/Tests/test_file_libtiff.py
@@ -741,7 +741,7 @@ def test_read_icc(self, monkeypatch: pytest.MonkeyPatch) -> None:
             pytest.param(
                 True,
                 marks=pytest.mark.skipif(
-                    not Image.core.libtiff_support_custom_tags,
+                    not getattr(Image.core, "libtiff_support_custom_tags", False),
                     reason="Custom tags not supported by older libtiff",
                 ),
             ),

From 0df8796e1910619741a36bb1a2d334bdb941e440 Mon Sep 17 00:00:00 2001
From: Andrew Murray <radarhere@users.noreply.github.com>
Date: Mon, 22 Apr 2024 18:45:41 +1000
Subject: [PATCH 0551/1178] Parametrized test

---
 Tests/test_file_libtiff.py | 103 ++++++++++++++++++++-----------------
 1 file changed, 55 insertions(+), 48 deletions(-)

diff --git a/Tests/test_file_libtiff.py b/Tests/test_file_libtiff.py
index e1867cffb3a..11883ad24aa 100644
--- a/Tests/test_file_libtiff.py
+++ b/Tests/test_file_libtiff.py
@@ -242,7 +242,24 @@ def test_additional_metadata(
 
             im.save(out, tiffinfo=new_ifd)
 
-    def test_custom_metadata(self, tmp_path: Path) -> None:
+    @pytest.mark.parametrize(
+        "libtiff",
+        (
+            pytest.param(
+                True,
+                marks=pytest.mark.skipif(
+                    not getattr(Image.core, "libtiff_support_custom_tags", False),
+                    reason="Custom tags not supported by older libtiff",
+                ),
+            ),
+            False,
+        ),
+    )
+    def test_custom_metadata(
+        self, monkeypatch: pytest.MonkeyPatch, tmp_path: Path, libtiff: bool
+    ) -> None:
+        monkeypatch.setattr(TiffImagePlugin, "WRITE_LIBTIFF", libtiff)
+
         class Tc(NamedTuple):
             value: Any
             type: int
@@ -281,53 +298,43 @@ class Tc(NamedTuple):
             )
         }
 
-        libtiffs = [False]
-        if Image.core.libtiff_support_custom_tags:
-            libtiffs.append(True)
-
-        for libtiff in libtiffs:
-            TiffImagePlugin.WRITE_LIBTIFF = libtiff
-
-            def check_tags(
-                tiffinfo: TiffImagePlugin.ImageFileDirectory_v2 | dict[int, str]
-            ) -> None:
-                im = hopper()
-
-                out = str(tmp_path / "temp.tif")
-                im.save(out, tiffinfo=tiffinfo)
-
-                with Image.open(out) as reloaded:
-                    for tag, value in tiffinfo.items():
-                        reloaded_value = reloaded.tag_v2[tag]
-                        if (
-                            isinstance(reloaded_value, TiffImagePlugin.IFDRational)
-                            and libtiff
-                        ):
-                            # libtiff does not support real RATIONALS
-                            assert (
-                                round(abs(float(reloaded_value) - float(value)), 7) == 0
-                            )
-                            continue
-
-                        assert reloaded_value == value
-
-            # Test with types
-            ifd = TiffImagePlugin.ImageFileDirectory_v2()
-            for tag, tagdata in custom.items():
-                ifd[tag] = tagdata.value
-                ifd.tagtype[tag] = tagdata.type
-            check_tags(ifd)
-
-            # Test without types. This only works for some types, int for example are
-            # always encoded as LONG and not SIGNED_LONG.
-            check_tags(
-                {
-                    tag: tagdata.value
-                    for tag, tagdata in custom.items()
-                    if tagdata.supported_by_default
-                }
-            )
-        TiffImagePlugin.WRITE_LIBTIFF = False
+        def check_tags(
+            tiffinfo: TiffImagePlugin.ImageFileDirectory_v2 | dict[int, str]
+        ) -> None:
+            im = hopper()
+
+            out = str(tmp_path / "temp.tif")
+            im.save(out, tiffinfo=tiffinfo)
+
+            with Image.open(out) as reloaded:
+                for tag, value in tiffinfo.items():
+                    reloaded_value = reloaded.tag_v2[tag]
+                    if (
+                        isinstance(reloaded_value, TiffImagePlugin.IFDRational)
+                        and libtiff
+                    ):
+                        # libtiff does not support real RATIONALS
+                        assert round(abs(float(reloaded_value) - float(value)), 7) == 0
+                        continue
+
+                    assert reloaded_value == value
+
+        # Test with types
+        ifd = TiffImagePlugin.ImageFileDirectory_v2()
+        for tag, tagdata in custom.items():
+            ifd[tag] = tagdata.value
+            ifd.tagtype[tag] = tagdata.type
+        check_tags(ifd)
+
+        # Test without types. This only works for some types, int for example are
+        # always encoded as LONG and not SIGNED_LONG.
+        check_tags(
+            {
+                tag: tagdata.value
+                for tag, tagdata in custom.items()
+                if tagdata.supported_by_default
+            }
+        )
 
     def test_osubfiletype(self, tmp_path: Path) -> None:
         outfile = str(tmp_path / "temp.tif")

From e144e418791eb205765b74da793487a038675984 Mon Sep 17 00:00:00 2001
From: Andrew Murray <3112309+radarhere@users.noreply.github.com>
Date: Mon, 22 Apr 2024 19:14:23 +1000
Subject: [PATCH 0552/1178] Updated wording

Co-authored-by: Hugo van Kemenade <1324225+hugovk@users.noreply.github.com>
---
 docs/deprecations.rst | 6 +++---
 1 file changed, 3 insertions(+), 3 deletions(-)

diff --git a/docs/deprecations.rst b/docs/deprecations.rst
index 91bc150b342..7882ec5ee2b 100644
--- a/docs/deprecations.rst
+++ b/docs/deprecations.rst
@@ -100,13 +100,13 @@ ImageMath eval()
 ``ImageMath.eval()`` has been deprecated. Use :py:meth:`~PIL.ImageMath.lambda_eval` or
 :py:meth:`~PIL.ImageMath.unsafe_eval` instead.
 
-Support for libtiff earlier than 4
+Support for LibTIFF earlier than 4
 ^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
 
 .. deprecated:: 10.4.0
 
-Support for libtiff earlier than 4 has been deprecated. Upgrade to a newer version of
-libtiff instead.
+Support for LibTIFF earlier than version 4 has been deprecated.
+Upgrade to a newer version of LibTIFF instead.
 
 Removed features
 ----------------

From 2e1d2b2029eefe7255c1c11f81a53f862a7861e1 Mon Sep 17 00:00:00 2001
From: Andrew Murray <radarhere@users.noreply.github.com>
Date: Mon, 22 Apr 2024 19:15:38 +1000
Subject: [PATCH 0553/1178] Updated deprecation message

---
 src/PIL/TiffImagePlugin.py | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/src/PIL/TiffImagePlugin.py b/src/PIL/TiffImagePlugin.py
index 13bcf5d8606..82ac47647fa 100644
--- a/src/PIL/TiffImagePlugin.py
+++ b/src/PIL/TiffImagePlugin.py
@@ -278,7 +278,7 @@
 ]
 
 if not getattr(Image.core, "libtiff_support_custom_tags", True):
-    deprecate("Support for libtiff earlier than 4", 12)
+    deprecate("Support for LibTIFF earlier than version 4", 12)
 
 
 def _accept(prefix: bytes) -> bool:

From 5a0a288dd048097d2ffa62fb2d5a24cf5727bbb9 Mon Sep 17 00:00:00 2001
From: Andrew Murray <radarhere@users.noreply.github.com>
Date: Mon, 22 Apr 2024 19:16:55 +1000
Subject: [PATCH 0554/1178] Added release notes

---
 docs/releasenotes/10.4.0.rst | 54 ++++++++++++++++++++++++++++++++++++
 docs/releasenotes/index.rst  |  1 +
 2 files changed, 55 insertions(+)
 create mode 100644 docs/releasenotes/10.4.0.rst

diff --git a/docs/releasenotes/10.4.0.rst b/docs/releasenotes/10.4.0.rst
new file mode 100644
index 00000000000..0c2926732e4
--- /dev/null
+++ b/docs/releasenotes/10.4.0.rst
@@ -0,0 +1,54 @@
+10.4.0
+------
+
+Security
+========
+
+TODO
+^^^^
+
+TODO
+
+:cve:`YYYY-XXXXX`: TODO
+^^^^^^^^^^^^^^^^^^^^^^^
+
+TODO
+
+Backwards Incompatible Changes
+==============================
+
+TODO
+^^^^
+
+Deprecations
+============
+
+Support for LibTIFF earlier than 4
+^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
+
+Support for LibTIFF earlier than version 4 has been deprecated.
+Upgrade to a newer version of LibTIFF instead.
+
+API Changes
+===========
+
+TODO
+^^^^
+
+TODO
+
+API Additions
+=============
+
+TODO
+^^^^
+
+TODO
+
+Other Changes
+=============
+
+TODO
+^^^^
+
+TODO
diff --git a/docs/releasenotes/index.rst b/docs/releasenotes/index.rst
index 089d44b9075..6ee5fb6c8f4 100644
--- a/docs/releasenotes/index.rst
+++ b/docs/releasenotes/index.rst
@@ -14,6 +14,7 @@ expected to be backported to earlier versions.
 .. toctree::
   :maxdepth: 2
 
+  10.4.0
   10.3.0
   10.2.0
   10.1.0

From d4a4b59ee39dcf2e8dddafebfecccaaf709ec8bb Mon Sep 17 00:00:00 2001
From: Hugo van Kemenade <1324225+hugovk@users.noreply.github.com>
Date: Mon, 22 Apr 2024 14:43:48 +0300
Subject: [PATCH 0555/1178] Sphinx extension to add dates to release notes

Co-authored-by: Jason R. Coombs <jaraco@jaraco.com>
---
 docs/conf.py  |  1 +
 docs/dater.py | 52 +++++++++++++++++++++++++++++++++++++++++++++++++++
 2 files changed, 53 insertions(+)
 create mode 100644 docs/dater.py

diff --git a/docs/conf.py b/docs/conf.py
index 392cf317e5f..f12b30e65fb 100644
--- a/docs/conf.py
+++ b/docs/conf.py
@@ -28,6 +28,7 @@
 # extensions coming with Sphinx (named 'sphinx.ext.*') or your custom
 # ones.
 extensions = [
+    "dater",
     "sphinx.ext.autodoc",
     "sphinx.ext.extlinks",
     "sphinx.ext.intersphinx",
diff --git a/docs/dater.py b/docs/dater.py
new file mode 100644
index 00000000000..d9e583547bd
--- /dev/null
+++ b/docs/dater.py
@@ -0,0 +1,52 @@
+"""
+Sphinx extension to add timestamps to release notes based on Git versions.
+
+Based on https://github.com/jaraco/rst.linker, with thanks to Jason R. Coombs.
+"""
+
+from __future__ import annotations
+
+import datetime as dt
+import os
+import re
+import subprocess
+from typing import TYPE_CHECKING
+
+if TYPE_CHECKING:
+    from sphinx.application import Sphinx
+
+DOC_NAME_REGEX = re.compile(r"releasenotes/\d+\.\d+\.\d+")
+VERSION_TITLE_REGEX = re.compile(r"^(\d+\.\d+\.\d+)\n-+\n")
+
+
+def get_date_for(git_version: str) -> dt.datetime | None:
+    cmd = ["git", "log", "-1", "--format=%ai", git_version]
+    try:
+        with open(os.devnull, "w", encoding="utf-8") as devnull:
+            out = subprocess.check_output(
+                cmd, stderr=devnull, text=True, encoding="utf-8"
+            )
+            ts = out.strip()
+        return dt.datetime.fromisoformat(ts)
+    except subprocess.CalledProcessError:
+        return None
+
+
+def add_date(app: Sphinx, doc_name: str, source: list[str]) -> None:
+    if DOC_NAME_REGEX.match(doc_name) and (m := VERSION_TITLE_REGEX.match(source[0])):
+        old_title = m.group(1)
+
+        if tag_datetime := get_date_for(old_title):
+            new_title = f"{old_title} ({tag_datetime:%Y-%m-%d})"
+        else:
+            new_title = f"{old_title} (unreleased)"
+
+        new_underline = "-" * len(new_title)
+
+        result = source[0].replace(m.group(0), f"{new_title}\n{new_underline}\n", 1)
+        source[0] = result
+
+
+def setup(app: Sphinx) -> dict[str, bool]:
+    app.connect("source-read", add_date)
+    return {"parallel_read_safe": True}

From 35003343386f3d2d40f179e0c18f96e0b58ce102 Mon Sep 17 00:00:00 2001
From: Hugo van Kemenade <1324225+hugovk@users.noreply.github.com>
Date: Mon, 22 Apr 2024 14:58:44 +0300
Subject: [PATCH 0556/1178] Fetch tags on Read the Docs

---
 .readthedocs.yml | 4 ++++
 1 file changed, 4 insertions(+)

diff --git a/.readthedocs.yml b/.readthedocs.yml
index 0c8f935d58c..b83ba05b128 100644
--- a/.readthedocs.yml
+++ b/.readthedocs.yml
@@ -6,6 +6,10 @@ build:
   os: ubuntu-22.04
   tools:
     python: "3"
+  jobs:
+    post_checkout:
+    - git remote add upstream https://github.com/python-pillow/Pillow.git # For forks
+    - git fetch upstream --tags
 
 python:
   install:

From 7f6ad116d1213948b318423cfd58990ec1e85c07 Mon Sep 17 00:00:00 2001
From: Andrew Murray <radarhere@users.noreply.github.com>
Date: Tue, 23 Apr 2024 08:02:42 +1000
Subject: [PATCH 0557/1178] Update CHANGES.rst [ci skip]

---
 CHANGES.rst | 12 ++++++++++++
 1 file changed, 12 insertions(+)

diff --git a/CHANGES.rst b/CHANGES.rst
index 196f8ed2020..85dc0b43c24 100644
--- a/CHANGES.rst
+++ b/CHANGES.rst
@@ -5,6 +5,18 @@ Changelog (Pillow)
 10.4.0 (unreleased)
 -------------------
 
+- Support reading P mode TIFF images with padding #7996
+  [radarhere]
+
+- Deprecate support for libtiff < 4 #7998
+  [radarhere, hugovk]
+
+- Corrected ImageShow UnixViewer command #7987
+  [radarhere]
+
+- Use functools.cached_property in ImageStat #7952
+  [nulano, hugovk, radarhere]
+
 - Add support for reading BITMAPV2INFOHEADER and BITMAPV3INFOHEADER #7956
   [Cirras, radarhere]
 

From 4a4eb0f3eeb76f59c9c890bf74c91a910e98a3eb Mon Sep 17 00:00:00 2001
From: Yay295 <Yay295@users.noreply.github.com>
Date: Tue, 23 Apr 2024 01:08:42 -0500
Subject: [PATCH 0558/1178] remove semicolon after function definition

---
 src/_imaging.c | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/src/_imaging.c b/src/_imaging.c
index 520e5079346..9b521f552cc 100644
--- a/src/_imaging.c
+++ b/src/_imaging.c
@@ -3737,7 +3737,7 @@ _getattr_unsafe_ptrs(ImagingObject *self, void *closure) {
         self->image->image32,
         "image",
         self->image->image);
-};
+}
 
 static struct PyGetSetDef getsetters[] = {
     {"mode", (getter)_getattr_mode},

From b9307f08d14e499e75edf574ff15c9b5c1f62a7d Mon Sep 17 00:00:00 2001
From: Yay295 <Yay295@users.noreply.github.com>
Date: Tue, 23 Apr 2024 12:02:25 -0500
Subject: [PATCH 0559/1178] remove unused variable

---
 src/display.c | 1 -
 1 file changed, 1 deletion(-)

diff --git a/src/display.c b/src/display.c
index ef2ff3754f1..6b66ddafb87 100644
--- a/src/display.c
+++ b/src/display.c
@@ -427,7 +427,6 @@ PyImaging_GrabScreenWin32(PyObject *self, PyObject *args) {
 
 PyObject *
 PyImaging_GrabClipboardWin32(PyObject *self, PyObject *args) {
-    int clip;
     HANDLE handle = NULL;
     int size;
     void *data;

From eee53ba6647b75bbecc56e98a6a99d7c2360d1ca Mon Sep 17 00:00:00 2001
From: Yay295 <Yay295@users.noreply.github.com>
Date: Tue, 23 Apr 2024 13:06:22 -0500
Subject: [PATCH 0560/1178] extract band count check

---
 src/libImaging/Matrix.c | 6 +++---
 1 file changed, 3 insertions(+), 3 deletions(-)

diff --git a/src/libImaging/Matrix.c b/src/libImaging/Matrix.c
index 182eb62a7e6..ec7f4d93e06 100644
--- a/src/libImaging/Matrix.c
+++ b/src/libImaging/Matrix.c
@@ -24,11 +24,11 @@ ImagingConvertMatrix(Imaging im, const char *mode, float m[]) {
     ImagingSectionCookie cookie;
 
     /* Assume there's enough data in the buffer */
-    if (!im) {
+    if (!im || im->bands != 3) {
         return (Imaging)ImagingError_ModeError();
     }
 
-    if (strcmp(mode, "L") == 0 && im->bands == 3) {
+    if (strcmp(mode, "L") == 0) {
         imOut = ImagingNewDirty("L", im->xsize, im->ysize);
         if (!imOut) {
             return NULL;
@@ -47,7 +47,7 @@ ImagingConvertMatrix(Imaging im, const char *mode, float m[]) {
         }
         ImagingSectionLeave(&cookie);
 
-    } else if (strlen(mode) == 3 && im->bands == 3) {
+    } else if (strlen(mode) == 3) {
         imOut = ImagingNewDirty(mode, im->xsize, im->ysize);
         if (!imOut) {
             return NULL;

From 46b85e6ab4eb1a5f1781acca2fb085826b328c3b Mon Sep 17 00:00:00 2001
From: Andrew Murray <radarhere@users.noreply.github.com>
Date: Wed, 24 Apr 2024 11:02:56 +1000
Subject: [PATCH 0561/1178] Simplified code

---
 src/libImaging/Convert.c | 10 ++++------
 1 file changed, 4 insertions(+), 6 deletions(-)

diff --git a/src/libImaging/Convert.c b/src/libImaging/Convert.c
index 7e60a960c1b..64840d08c94 100644
--- a/src/libImaging/Convert.c
+++ b/src/libImaging/Convert.c
@@ -254,9 +254,8 @@ static void
 rgb2i16l(UINT8 *out_, const UINT8 *in, int xsize) {
     int x;
     for (x = 0; x < xsize; x++, in += 4) {
-        UINT8 v = CLIP16(L24(in) >> 16);
-        *out_++ = v;
-        *out_++ = v >> 8;
+        *out_++ = L24(in) >> 16;
+        *out_++ = 0;
     }
 }
 
@@ -264,9 +263,8 @@ static void
 rgb2i16b(UINT8 *out_, const UINT8 *in, int xsize) {
     int x;
     for (x = 0; x < xsize; x++, in += 4) {
-        UINT8 v = CLIP16(L24(in) >> 16);
-        *out_++ = v >> 8;
-        *out_++ = v;
+        *out_++ = 0;
+        *out_++ = L24(in) >> 16;
     }
 }
 

From 03627d92a739d31269de0af61714b45db04069de Mon Sep 17 00:00:00 2001
From: Hugo van Kemenade <1324225+hugovk@users.noreply.github.com>
Date: Wed, 24 Apr 2024 11:23:44 +0300
Subject: [PATCH 0562/1178] GitHub Actions: Python 3.8 and 3.9 are on macos-13
 but not macos-14

---
 .github/workflows/test.yml | 4 ++--
 1 file changed, 2 insertions(+), 2 deletions(-)

diff --git a/.github/workflows/test.yml b/.github/workflows/test.yml
index 643273e58b3..4573fde906d 100644
--- a/.github/workflows/test.yml
+++ b/.github/workflows/test.yml
@@ -57,9 +57,9 @@ jobs:
         - python-version: "3.10"
           PYTHONOPTIMIZE: 2
         # M1 only available for 3.10+
-        - os: "macos-latest"
+        - os: "macos-13"
           python-version: "3.9"
-        - os: "macos-latest"
+        - os: "macos-13"
           python-version: "3.8"
         exclude:
         - os: "macos-14"

From 76c17a10f0563f2343c7dada04af217093d3ef67 Mon Sep 17 00:00:00 2001
From: Hugo van Kemenade <1324225+hugovk@users.noreply.github.com>
Date: Wed, 24 Apr 2024 11:24:23 +0300
Subject: [PATCH 0563/1178] GitHub Actions: macos-13 is Intel but macos-latest
 will be M1

---
 .github/workflows/wheels.yml | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/.github/workflows/wheels.yml b/.github/workflows/wheels.yml
index 36bb5405026..b2fbd314083 100644
--- a/.github/workflows/wheels.yml
+++ b/.github/workflows/wheels.yml
@@ -97,7 +97,7 @@ jobs:
       matrix:
         include:
           - name: "macOS x86_64"
-            os: macos-latest
+            os: macos-13
             cibw_arch: x86_64
             macosx_deployment_target: "10.10"
           - name: "macOS arm64"

From ccf1efb3efb371818455289b8c04aa21f18d4c4d Mon Sep 17 00:00:00 2001
From: Andrew Murray <radarhere@users.noreply.github.com>
Date: Wed, 24 Apr 2024 23:06:06 +1000
Subject: [PATCH 0564/1178] Use subprocess.DEVNULL

---
 docs/dater.py | 10 ++++------
 1 file changed, 4 insertions(+), 6 deletions(-)

diff --git a/docs/dater.py b/docs/dater.py
index d9e583547bd..04855956beb 100644
--- a/docs/dater.py
+++ b/docs/dater.py
@@ -7,7 +7,6 @@
 from __future__ import annotations
 
 import datetime as dt
-import os
 import re
 import subprocess
 from typing import TYPE_CHECKING
@@ -22,11 +21,10 @@
 def get_date_for(git_version: str) -> dt.datetime | None:
     cmd = ["git", "log", "-1", "--format=%ai", git_version]
     try:
-        with open(os.devnull, "w", encoding="utf-8") as devnull:
-            out = subprocess.check_output(
-                cmd, stderr=devnull, text=True, encoding="utf-8"
-            )
-            ts = out.strip()
+        out = subprocess.check_output(
+            cmd, stderr=subprocess.DEVNULL, text=True, encoding="utf-8"
+        )
+        ts = out.strip()
         return dt.datetime.fromisoformat(ts)
     except subprocess.CalledProcessError:
         return None

From 4af831e70c41441dbe0cdebf9e2cbd46ae71eb92 Mon Sep 17 00:00:00 2001
From: Andrew Murray <radarhere@users.noreply.github.com>
Date: Wed, 24 Apr 2024 23:45:25 +1000
Subject: [PATCH 0565/1178] Accept '.zlib-ng' suffix to zlib version

---
 Tests/test_features.py | 2 ++
 Tests/test_file_png.py | 4 +++-
 2 files changed, 5 insertions(+), 1 deletion(-)

diff --git a/Tests/test_features.py b/Tests/test_features.py
index 3a528a7c8c6..2d402ca9114 100644
--- a/Tests/test_features.py
+++ b/Tests/test_features.py
@@ -37,6 +37,8 @@ def test(name: str, function: Callable[[str], bool]) -> None:
         else:
             assert function(name) == version
             if name != "PIL":
+                if name == "zlib" and version is not None:
+                    version = version.replace(".zlib-ng", "")
                 assert version is None or re.search(r"\d+(\.\d+)*$", version)
 
     for module in features.modules:
diff --git a/Tests/test_file_png.py b/Tests/test_file_png.py
index 30fb14c44c4..19462dcb5a4 100644
--- a/Tests/test_file_png.py
+++ b/Tests/test_file_png.py
@@ -85,7 +85,9 @@ def get_chunks(self, filename: str) -> list[bytes]:
 
     def test_sanity(self, tmp_path: Path) -> None:
         # internal version number
-        assert re.search(r"\d+(\.\d+){1,3}$", features.version_codec("zlib"))
+        assert re.search(
+            r"\d+(\.\d+){1,3}(\.zlib\-ng)?$", features.version_codec("zlib")
+        )
 
         test_file = str(tmp_path / "temp.png")
 

From 03bcf03567ae934feaa737ee9128c19136cb7803 Mon Sep 17 00:00:00 2001
From: Andrew Murray <radarhere@users.noreply.github.com>
Date: Thu, 25 Apr 2024 08:41:15 +1000
Subject: [PATCH 0566/1178] Removed Fedora 38 and added Fedora 40

---
 .github/workflows/test-docker.yml      | 2 +-
 docs/installation/platform-support.rst | 4 ++--
 2 files changed, 3 insertions(+), 3 deletions(-)

diff --git a/.github/workflows/test-docker.yml b/.github/workflows/test-docker.yml
index 70426d7b509..8f4a4d09009 100644
--- a/.github/workflows/test-docker.yml
+++ b/.github/workflows/test-docker.yml
@@ -47,8 +47,8 @@ jobs:
           debian-11-bullseye-amd64,
           debian-12-bookworm-x86,
           debian-12-bookworm-amd64,
-          fedora-38-amd64,
           fedora-39-amd64,
+          fedora-40-amd64,
           gentoo,
           ubuntu-20.04-focal-amd64,
           ubuntu-22.04-jammy-amd64,
diff --git a/docs/installation/platform-support.rst b/docs/installation/platform-support.rst
index af205a4e8cc..c08a53a4329 100644
--- a/docs/installation/platform-support.rst
+++ b/docs/installation/platform-support.rst
@@ -31,10 +31,10 @@ These platforms are built and tested for every change.
 +----------------------------------+----------------------------+---------------------+
 | Debian 12 Bookworm               | 3.11                       | x86, x86-64         |
 +----------------------------------+----------------------------+---------------------+
-| Fedora 38                        | 3.11                       | x86-64              |
-+----------------------------------+----------------------------+---------------------+
 | Fedora 39                        | 3.12                       | x86-64              |
 +----------------------------------+----------------------------+---------------------+
+| Fedora 40                        | 3.12                       | x86-64              |
++----------------------------------+----------------------------+---------------------+
 | Gentoo                           | 3.9                        | x86-64              |
 +----------------------------------+----------------------------+---------------------+
 | macOS 12 Monterey                | 3.8, 3.9                   | x86-64              |

From 02db41119018f313df060c254a22f44a95057e15 Mon Sep 17 00:00:00 2001
From: Andrew Murray <radarhere@users.noreply.github.com>
Date: Thu, 25 Apr 2024 09:14:48 +1000
Subject: [PATCH 0567/1178] Added release notes

---
 docs/releasenotes/10.4.0.rst | 5 +++++
 1 file changed, 5 insertions(+)

diff --git a/docs/releasenotes/10.4.0.rst b/docs/releasenotes/10.4.0.rst
index 0c2926732e4..3150bf4e02f 100644
--- a/docs/releasenotes/10.4.0.rst
+++ b/docs/releasenotes/10.4.0.rst
@@ -23,6 +23,11 @@ TODO
 Deprecations
 ============
 
+BGR;15, BGR 16 and BGR;24
+^^^^^^^^^^^^^^^^^^^^^^^^^
+
+The experimental BGR;15, BGR;16 and BGR;24 modes have been deprecated.
+
 Support for LibTIFF earlier than 4
 ^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
 

From 35ffbdc9cde567ae629ae01ddce3116a35f3483d Mon Sep 17 00:00:00 2001
From: "renovate[bot]" <29139614+renovate[bot]@users.noreply.github.com>
Date: Thu, 25 Apr 2024 01:38:43 +0000
Subject: [PATCH 0568/1178] Update dependency mypy to v1.10.0

---
 .ci/requirements-mypy.txt | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/.ci/requirements-mypy.txt b/.ci/requirements-mypy.txt
index 6b0535fc1cf..a0dcb92d22d 100644
--- a/.ci/requirements-mypy.txt
+++ b/.ci/requirements-mypy.txt
@@ -1 +1 @@
-mypy==1.9.0
+mypy==1.10.0

From 5faebadd56ab3ec66139d123fcee54d3ff89ad30 Mon Sep 17 00:00:00 2001
From: Andrew Murray <radarhere@users.noreply.github.com>
Date: Thu, 25 Apr 2024 11:06:04 +1000
Subject: [PATCH 0569/1178] BGR;16 does not fail on big-endian

---
 Tests/test_image.py | 4 ++--
 1 file changed, 2 insertions(+), 2 deletions(-)

diff --git a/Tests/test_image.py b/Tests/test_image.py
index 4a056df4083..8e7e40c05da 100644
--- a/Tests/test_image.py
+++ b/Tests/test_image.py
@@ -1037,8 +1037,8 @@ def test_roundtrip_bytes_method(self, mode: str) -> None:
 
     @pytest.mark.parametrize("mode", modes)
     def test_getdata_putdata(self, mode: str) -> None:
-        if is_big_endian and mode in ("BGR;15", "BGR;16"):
-            pytest.xfail(f"Known failure of {mode} on big-endian")
+        if is_big_endian and mode == "BGR;15":
+            pytest.xfail("Known failure of BGR;15 on big-endian")
         im = hopper(mode)
         reloaded = Image.new(mode, im.size)
         reloaded.putdata(im.getdata())

From bc35bf0c9e2b3c0a5702a21daa02d5982932f8d7 Mon Sep 17 00:00:00 2001
From: Andrew Murray <radarhere@users.noreply.github.com>
Date: Thu, 25 Apr 2024 13:10:45 +1000
Subject: [PATCH 0570/1178] Use split instead of datetime

---
 docs/dater.py | 10 ++++------
 1 file changed, 4 insertions(+), 6 deletions(-)

diff --git a/docs/dater.py b/docs/dater.py
index 04855956beb..f9fb0c1da6e 100644
--- a/docs/dater.py
+++ b/docs/dater.py
@@ -6,7 +6,6 @@
 
 from __future__ import annotations
 
-import datetime as dt
 import re
 import subprocess
 from typing import TYPE_CHECKING
@@ -18,24 +17,23 @@
 VERSION_TITLE_REGEX = re.compile(r"^(\d+\.\d+\.\d+)\n-+\n")
 
 
-def get_date_for(git_version: str) -> dt.datetime | None:
+def get_date_for(git_version: str) -> str | None:
     cmd = ["git", "log", "-1", "--format=%ai", git_version]
     try:
         out = subprocess.check_output(
             cmd, stderr=subprocess.DEVNULL, text=True, encoding="utf-8"
         )
-        ts = out.strip()
-        return dt.datetime.fromisoformat(ts)
     except subprocess.CalledProcessError:
         return None
+    return out.split()[0]
 
 
 def add_date(app: Sphinx, doc_name: str, source: list[str]) -> None:
     if DOC_NAME_REGEX.match(doc_name) and (m := VERSION_TITLE_REGEX.match(source[0])):
         old_title = m.group(1)
 
-        if tag_datetime := get_date_for(old_title):
-            new_title = f"{old_title} ({tag_datetime:%Y-%m-%d})"
+        if tag_date := get_date_for(old_title):
+            new_title = f"{old_title} ({tag_date})"
         else:
             new_title = f"{old_title} (unreleased)"
 

From bbd5a87e6046bd0c0eb9ad105102a0d019277eb5 Mon Sep 17 00:00:00 2001
From: Andrew Murray <radarhere@users.noreply.github.com>
Date: Thu, 25 Apr 2024 16:16:33 +1000
Subject: [PATCH 0571/1178] Combined conditions

---
 src/_imagingcms.c | 41 ++++++++++++++++++++++-------------------
 1 file changed, 22 insertions(+), 19 deletions(-)

diff --git a/src/_imagingcms.c b/src/_imagingcms.c
index f18d55a5718..63d78f84daa 100644
--- a/src/_imagingcms.c
+++ b/src/_imagingcms.c
@@ -213,34 +213,37 @@ cms_transform_dealloc(CmsTransformObject *self) {
 
 static cmsUInt32Number
 findLCMStype(char *PILmode) {
-    if (strcmp(PILmode, "RGB") == 0) {
+    if (
+        strcmp(PILmode, "RGB") == 0 ||
+        strcmp(PILmode, "RGBA") == 0 ||
+        strcmp(PILmode, "RGBX") == 0
+    ) {
         return TYPE_RGBA_8;
-    } else if (strcmp(PILmode, "RGBA") == 0) {
-        return TYPE_RGBA_8;
-    } else if (strcmp(PILmode, "RGBX") == 0) {
-        return TYPE_RGBA_8;
-    } else if (strcmp(PILmode, "RGBA;16B") == 0) {
+    }
+    if (strcmp(PILmode, "RGBA;16B") == 0) {
         return TYPE_RGBA_16;
-    } else if (strcmp(PILmode, "CMYK") == 0) {
+    }
+    if (strcmp(PILmode, "CMYK") == 0) {
         return TYPE_CMYK_8;
-    } else if (strcmp(PILmode, "L") == 0) {
-        return TYPE_GRAY_8;
-    } else if (strcmp(PILmode, "L;16") == 0) {
+    }
+    if (strcmp(PILmode, "L;16") == 0) {
         return TYPE_GRAY_16;
-    } else if (strcmp(PILmode, "L;16B") == 0) {
+    }
+    if (strcmp(PILmode, "L;16B") == 0) {
         return TYPE_GRAY_16_SE;
-    } else if (strcmp(PILmode, "YCCA") == 0) {
-        return TYPE_YCbCr_8;
-    } else if (strcmp(PILmode, "YCC") == 0) {
+    }
+    if (
+        strcmp(PILmode, "YCCA") == 0 ||
+        strcmp(PILmode, "YCC") == 0
+    ) {
         return TYPE_YCbCr_8;
-    } else if (strcmp(PILmode, "LAB") == 0) {
+    }
+    if (strcmp(PILmode, "LAB") == 0) {
         // LabX equivalent like ALab, but not reversed -- no #define in lcms2
         return (COLORSPACE_SH(PT_LabV2) | CHANNELS_SH(3) | BYTES_SH(1) | EXTRA_SH(1));
     }
-    else {
-        /* take a wild guess... */
-        return TYPE_GRAY_8;
-    }
+    /* presume "L" by default */
+    return TYPE_GRAY_8;
 }
 
 #define Cms_Min(a, b) ((a) < (b) ? (a) : (b))

From 1b1c825f7ba5ffe6b62fbffdad4d094f13e254e8 Mon Sep 17 00:00:00 2001
From: Hugo van Kemenade <1324225+hugovk@users.noreply.github.com>
Date: Thu, 25 Apr 2024 14:39:51 +0300
Subject: [PATCH 0572/1178] Add ClangFormat to pre-commit

---
 .pre-commit-config.yaml | 17 ++++++++++++-----
 1 file changed, 12 insertions(+), 5 deletions(-)

diff --git a/.pre-commit-config.yaml b/.pre-commit-config.yaml
index 51625eb4c89..f81f03da16e 100644
--- a/.pre-commit-config.yaml
+++ b/.pre-commit-config.yaml
@@ -1,12 +1,12 @@
 repos:
   - repo: https://github.com/astral-sh/ruff-pre-commit
-    rev: v0.3.4
+    rev: v0.4.1
     hooks:
       - id: ruff
         args: [--exit-non-zero-on-fix]
 
   - repo: https://github.com/psf/black-pre-commit-mirror
-    rev: 24.3.0
+    rev: 24.4.1
     hooks:
       - id: black
 
@@ -23,13 +23,20 @@ repos:
       - id: remove-tabs
         exclude: (Makefile$|\.bat$|\.cmake$|\.eps$|\.fits$|\.gd$|\.opt$)
 
+  - repo: https://github.com/pre-commit/mirrors-clang-format
+    rev: v18.1.4
+    hooks:
+      - id: clang-format
+        types: [c]
+        exclude: ^src/thirdparty/
+
   - repo: https://github.com/pre-commit/pygrep-hooks
     rev: v1.10.0
     hooks:
       - id: rst-backticks
 
   - repo: https://github.com/pre-commit/pre-commit-hooks
-    rev: v4.5.0
+    rev: v4.6.0
     hooks:
       - id: check-executables-have-shebangs
       - id: check-shebang-scripts-are-executable
@@ -43,7 +50,7 @@ repos:
         exclude: ^.github/.*TEMPLATE|^Tests/(fonts|images)/
 
   - repo: https://github.com/python-jsonschema/check-jsonschema
-    rev: 0.28.1
+    rev: 0.28.2
     hooks:
       - id: check-github-workflows
       - id: check-readthedocs
@@ -55,7 +62,7 @@ repos:
       - id: sphinx-lint
 
   - repo: https://github.com/tox-dev/pyproject-fmt
-    rev: 1.7.0
+    rev: 1.8.0
     hooks:
       - id: pyproject-fmt
 

From 617e7295a80f2067f4be2861c43fc9e2345455e5 Mon Sep 17 00:00:00 2001
From: "pre-commit-ci[bot]"
 <66853113+pre-commit-ci[bot]@users.noreply.github.com>
Date: Thu, 25 Apr 2024 12:51:20 +0000
Subject: [PATCH 0573/1178] [pre-commit.ci] auto fixes from pre-commit.com
 hooks

for more information, see https://pre-commit.ci
---
 src/Tk/tkImaging.c            |  19 +-
 src/_imaging.c                |  54 +++---
 src/_imagingcms.c             |  16 +-
 src/_imagingft.c              | 127 +++++++++-----
 src/encode.c                  |  10 +-
 src/libImaging/Access.c       |  10 +-
 src/libImaging/BcnDecode.c    |  24 +--
 src/libImaging/BoxBlur.c      |  14 +-
 src/libImaging/Convert.c      |  26 +--
 src/libImaging/Draw.c         |  66 +++++--
 src/libImaging/Filter.c       |   9 +-
 src/libImaging/FliDecode.c    |   5 +-
 src/libImaging/Geometry.c     |  16 +-
 src/libImaging/GetBBox.c      |  10 +-
 src/libImaging/Gif.h          |   8 +-
 src/libImaging/GifEncode.c    | 316 ++++++++++++++++++----------------
 src/libImaging/Imaging.h      |  20 ++-
 src/libImaging/ImagingUtils.h |   2 +-
 src/libImaging/Jpeg2KDecode.c |  10 +-
 src/libImaging/Jpeg2KEncode.c |   6 +-
 src/libImaging/JpegEncode.c   |  12 +-
 src/libImaging/Paste.c        |   9 +-
 src/libImaging/Point.c        |   2 +-
 src/libImaging/Quant.c        |  63 +++----
 src/libImaging/QuantOctree.c  |   4 +-
 src/libImaging/Reduce.c       |   2 +-
 src/libImaging/Resample.c     |   2 +-
 src/libImaging/SgiRleDecode.c |   9 +-
 src/libImaging/Storage.c      |   5 +-
 src/libImaging/TiffDecode.c   | 136 +++++++++------
 src/libImaging/TiffDecode.h   |   2 +-
 src/libImaging/Unpack.c       |  49 +++---
 src/path.c                    |  36 ++--
 33 files changed, 607 insertions(+), 492 deletions(-)

diff --git a/src/Tk/tkImaging.c b/src/Tk/tkImaging.c
index bd3cafe9596..ef1c00a94e8 100644
--- a/src/Tk/tkImaging.c
+++ b/src/Tk/tkImaging.c
@@ -128,14 +128,7 @@ PyImagingPhotoPut(
     block.pixelPtr = (unsigned char *)im->block;
 
     TK_PHOTO_PUT_BLOCK(
-        interp,
-        photo,
-        &block,
-        0,
-        0,
-        block.width,
-        block.height,
-        TK_PHOTO_COMPOSITE_SET);
+        interp, photo, &block, 0, 0, block.width, block.height, TK_PHOTO_COMPOSITE_SET);
 
     return TCL_OK;
 }
@@ -287,7 +280,7 @@ load_tkinter_funcs(void) {
      * Return 0 for success, non-zero for failure.
      */
 
-    HMODULE* hMods = NULL;
+    HMODULE *hMods = NULL;
     HANDLE hProcess;
     DWORD cbNeeded;
     unsigned int i;
@@ -313,7 +306,7 @@ load_tkinter_funcs(void) {
 #endif
         return 1;
     }
-    if (!(hMods = (HMODULE*) malloc(cbNeeded))) {
+    if (!(hMods = (HMODULE *)malloc(cbNeeded))) {
         PyErr_NoMemory();
         return 1;
     }
@@ -345,7 +338,7 @@ load_tkinter_funcs(void) {
     } else if (found_tk == 0) {
         PyErr_SetString(PyExc_RuntimeError, "Could not find Tk routines");
     }
-    return (int) ((found_tcl != 1) || (found_tk != 1));
+    return (int)((found_tcl != 1) || (found_tk != 1));
 }
 
 #else /* not Windows */
@@ -400,8 +393,8 @@ _func_loader(void *lib) {
         return 1;
     }
     return (
-        (TK_PHOTO_PUT_BLOCK =
-             (Tk_PhotoPutBlock_t)_dfunc(lib, "Tk_PhotoPutBlock")) == NULL);
+        (TK_PHOTO_PUT_BLOCK = (Tk_PhotoPutBlock_t)_dfunc(lib, "Tk_PhotoPutBlock")) ==
+        NULL);
 }
 
 int
diff --git a/src/_imaging.c b/src/_imaging.c
index 9b521f552cc..c565c21bb15 100644
--- a/src/_imaging.c
+++ b/src/_imaging.c
@@ -110,7 +110,7 @@
 
 #define B16(p, i) ((((int)p[(i)]) << 8) + p[(i) + 1])
 #define L16(p, i) ((((int)p[(i) + 1]) << 8) + p[(i)])
-#define S16(v) ((v) < 32768 ? (v) : ((v)-65536))
+#define S16(v) ((v) < 32768 ? (v) : ((v) - 65536))
 
 /* -------------------------------------------------------------------- */
 /* OBJECT ADMINISTRATION                        */
@@ -533,7 +533,9 @@ getink(PyObject *color, Imaging im, char *ink) {
                 /* unsigned integer, single layer */
                 if (rIsInt != 1) {
                     if (tupleSize != 1) {
-                        PyErr_SetString(PyExc_TypeError, "color must be int or single-element tuple");
+                        PyErr_SetString(
+                            PyExc_TypeError,
+                            "color must be int or single-element tuple");
                         return NULL;
                     } else if (!PyArg_ParseTuple(color, "L", &r)) {
                         return NULL;
@@ -552,7 +554,9 @@ getink(PyObject *color, Imaging im, char *ink) {
                     a = 255;
                     if (im->bands == 2) {
                         if (tupleSize != 1 && tupleSize != 2) {
-                            PyErr_SetString(PyExc_TypeError, "color must be int, or tuple of one or two elements");
+                            PyErr_SetString(
+                                PyExc_TypeError,
+                                "color must be int, or tuple of one or two elements");
                             return NULL;
                         } else if (!PyArg_ParseTuple(color, "L|i", &r, &a)) {
                             return NULL;
@@ -560,7 +564,10 @@ getink(PyObject *color, Imaging im, char *ink) {
                         g = b = r;
                     } else {
                         if (tupleSize != 3 && tupleSize != 4) {
-                            PyErr_SetString(PyExc_TypeError, "color must be int, or tuple of one, three or four elements");
+                            PyErr_SetString(
+                                PyExc_TypeError,
+                                "color must be int, or tuple of one, three or four "
+                                "elements");
                             return NULL;
                         } else if (!PyArg_ParseTuple(color, "Lii|i", &r, &g, &b, &a)) {
                             return NULL;
@@ -599,7 +606,9 @@ getink(PyObject *color, Imaging im, char *ink) {
                     g = (UINT8)(r >> 8);
                     r = (UINT8)r;
                 } else if (tupleSize != 3) {
-                    PyErr_SetString(PyExc_TypeError, "color must be int, or tuple of one or three elements");
+                    PyErr_SetString(
+                        PyExc_TypeError,
+                        "color must be int, or tuple of one or three elements");
                     return NULL;
                 } else if (!PyArg_ParseTuple(color, "iiL", &b, &g, &r)) {
                     return NULL;
@@ -1537,14 +1546,14 @@ _putdata(ImagingObject *self, PyObject *args) {
         return NULL;
     }
 
-#define set_value_to_item(seq, i) \
-op = PySequence_Fast_GET_ITEM(seq, i); \
-if (PySequence_Check(op)) { \
-    PyErr_SetString(PyExc_TypeError, "sequence must be flattened"); \
-    return NULL; \
-} else { \
-    value = PyFloat_AsDouble(op); \
-}
+#define set_value_to_item(seq, i)                                       \
+    op = PySequence_Fast_GET_ITEM(seq, i);                              \
+    if (PySequence_Check(op)) {                                         \
+        PyErr_SetString(PyExc_TypeError, "sequence must be flattened"); \
+        return NULL;                                                    \
+    } else {                                                            \
+        value = PyFloat_AsDouble(op);                                   \
+    }
     if (image->image8) {
         if (PyBytes_Check(data)) {
             unsigned char *p;
@@ -1596,8 +1605,10 @@ if (PySequence_Check(op)) { \
                         value = value * scale + offset;
                     }
                     if (image->type == IMAGING_TYPE_SPECIAL) {
-                        image->image8[y][x * 2 + (bigendian ? 1 : 0)] = CLIP8((int)value % 256);
-                        image->image8[y][x * 2 + (bigendian ? 0 : 1)] = CLIP8((int)value >> 8);
+                        image->image8[y][x * 2 + (bigendian ? 1 : 0)] =
+                            CLIP8((int)value % 256);
+                        image->image8[y][x * 2 + (bigendian ? 0 : 1)] =
+                            CLIP8((int)value >> 8);
                     } else {
                         image->image8[y][x] = (UINT8)CLIP8(value);
                     }
@@ -1639,8 +1650,7 @@ if (PySequence_Check(op)) { \
                 for (i = x = y = 0; i < n; i++) {
                     double value;
                     set_value_to_item(seq, i);
-                    IMAGING_PIXEL_INT32(image, x, y) =
-                        (INT32)(value * scale + offset);
+                    IMAGING_PIXEL_INT32(image, x, y) = (INT32)(value * scale + offset);
                     if (++x >= (int)image->xsize) {
                         x = 0, y++;
                     }
@@ -2785,8 +2795,8 @@ _font_getmask(ImagingFontObject *self, PyObject *args) {
         glyph = &self->glyphs[text[i]];
         if (i == 0 || text[i] != text[i - 1]) {
             ImagingDelete(bitmap);
-            bitmap =
-                ImagingCrop(self->bitmap, glyph->sx0, glyph->sy0, glyph->sx1, glyph->sy1);
+            bitmap = ImagingCrop(
+                self->bitmap, glyph->sx0, glyph->sy0, glyph->sx1, glyph->sy1);
             if (!bitmap) {
                 goto failed;
             }
@@ -3315,7 +3325,8 @@ _draw_polygon(ImagingDrawObject *self, PyObject *args) {
 
     free(xy);
 
-    if (ImagingDrawPolygon(self->image->image, n, ixy, &ink, fill, width, self->blend) < 0) {
+    if (ImagingDrawPolygon(self->image->image, n, ixy, &ink, fill, width, self->blend) <
+        0) {
         free(ixy);
         return NULL;
     }
@@ -4411,7 +4422,8 @@ setup_module(PyObject *m) {
     PyModule_AddObject(m, "HAVE_XCB", have_xcb);
 
     PyObject *pillow_version = PyUnicode_FromString(version);
-    PyDict_SetItemString(d, "PILLOW_VERSION", pillow_version ? pillow_version : Py_None);
+    PyDict_SetItemString(
+        d, "PILLOW_VERSION", pillow_version ? pillow_version : Py_None);
     Py_XDECREF(pillow_version);
 
     return 0;
diff --git a/src/_imagingcms.c b/src/_imagingcms.c
index 63d78f84daa..ba8c810057b 100644
--- a/src/_imagingcms.c
+++ b/src/_imagingcms.c
@@ -213,11 +213,8 @@ cms_transform_dealloc(CmsTransformObject *self) {
 
 static cmsUInt32Number
 findLCMStype(char *PILmode) {
-    if (
-        strcmp(PILmode, "RGB") == 0 ||
-        strcmp(PILmode, "RGBA") == 0 ||
-        strcmp(PILmode, "RGBX") == 0
-    ) {
+    if (strcmp(PILmode, "RGB") == 0 || strcmp(PILmode, "RGBA") == 0 ||
+        strcmp(PILmode, "RGBX") == 0) {
         return TYPE_RGBA_8;
     }
     if (strcmp(PILmode, "RGBA;16B") == 0) {
@@ -232,10 +229,7 @@ findLCMStype(char *PILmode) {
     if (strcmp(PILmode, "L;16B") == 0) {
         return TYPE_GRAY_16_SE;
     }
-    if (
-        strcmp(PILmode, "YCCA") == 0 ||
-        strcmp(PILmode, "YCC") == 0
-    ) {
+    if (strcmp(PILmode, "YCCA") == 0 || strcmp(PILmode, "YCC") == 0) {
         return TYPE_YCbCr_8;
     }
     if (strcmp(PILmode, "LAB") == 0) {
@@ -393,7 +387,7 @@ _buildTransform(
 
     Py_END_ALLOW_THREADS
 
-    if (!hTransform) {
+        if (!hTransform) {
         PyErr_SetString(PyExc_ValueError, "cannot build transform");
     }
 
@@ -427,7 +421,7 @@ _buildProofTransform(
 
     Py_END_ALLOW_THREADS
 
-    if (!hTransform) {
+        if (!hTransform) {
         PyErr_SetString(PyExc_ValueError, "cannot build proof transform");
     }
 
diff --git a/src/_imagingft.c b/src/_imagingft.c
index 6e24fcf95ed..e83ddfec122 100644
--- a/src/_imagingft.c
+++ b/src/_imagingft.c
@@ -47,17 +47,17 @@
     ;
 
 #ifdef HAVE_RAQM
-# ifdef HAVE_RAQM_SYSTEM
-#  include <raqm.h>
-# else
-#  include "thirdparty/raqm/raqm.h"
-#  ifdef HAVE_FRIBIDI_SYSTEM
-#   include <fribidi.h>
-#  else
-#   include "thirdparty/fribidi-shim/fribidi.h"
-#   include <hb.h>
-#  endif
-# endif
+#ifdef HAVE_RAQM_SYSTEM
+#include <raqm.h>
+#else
+#include "thirdparty/raqm/raqm.h"
+#ifdef HAVE_FRIBIDI_SYSTEM
+#include <fribidi.h>
+#else
+#include "thirdparty/fribidi-shim/fribidi.h"
+#include <hb.h>
+#endif
+#endif
 #endif
 
 static int have_raqm = 0;
@@ -490,8 +490,7 @@ text_layout(
     size_t count;
 #ifdef HAVE_RAQM
     if (have_raqm && self->layout_engine == LAYOUT_RAQM) {
-        count = text_layout_raqm(
-            string, self, dir, features, lang, glyph_info);
+        count = text_layout_raqm(string, self, dir, features, lang, glyph_info);
     } else
 #endif
     {
@@ -550,7 +549,17 @@ font_getlength(FontObject *self, PyObject *args) {
 }
 
 static int
-bounding_box_and_anchors(FT_Face face, const char *anchor, int horizontal_dir, GlyphInfo *glyph_info, size_t count, int load_flags, int *width, int *height, int *x_offset, int *y_offset) {
+bounding_box_and_anchors(
+    FT_Face face,
+    const char *anchor,
+    int horizontal_dir,
+    GlyphInfo *glyph_info,
+    size_t count,
+    int load_flags,
+    int *width,
+    int *height,
+    int *x_offset,
+    int *y_offset) {
     int position; /* pen position along primary axis, in 26.6 precision */
     int advanced; /* pen position along primary axis, in pixels */
     int px, py;   /* position of current glyph, in pixels */
@@ -558,8 +567,8 @@ bounding_box_and_anchors(FT_Face face, const char *anchor, int horizontal_dir, G
     int x_anchor, y_anchor;         /* offset of point drawn at (0, 0), in pixels */
     int error;
     FT_Glyph glyph;
-    FT_BBox bbox;                   /* glyph bounding box */
-    size_t i;                       /* glyph_info index */
+    FT_BBox bbox; /* glyph bounding box */
+    size_t i;     /* glyph_info index */
     /*
      * text bounds are given by:
      *   - bounding boxes of individual glyphs
@@ -654,8 +663,7 @@ bounding_box_and_anchors(FT_Face face, const char *anchor, int horizontal_dir, G
                     break;
                 case 'm':  // middle (ascender + descender) / 2
                     y_anchor = PIXEL(
-                        (face->size->metrics.ascender +
-                         face->size->metrics.descender) /
+                        (face->size->metrics.ascender + face->size->metrics.descender) /
                         2);
                     break;
                 case 's':  // horizontal baseline
@@ -719,7 +727,7 @@ bounding_box_and_anchors(FT_Face face, const char *anchor, int horizontal_dir, G
 static PyObject *
 font_getsize(FontObject *self, PyObject *args) {
     int width, height, x_offset, y_offset;
-    int load_flags;               /* FreeType load_flags parameter */
+    int load_flags; /* FreeType load_flags parameter */
     int error;
     GlyphInfo *glyph_info = NULL; /* computed text layout */
     size_t count;                 /* glyph_info length */
@@ -758,7 +766,17 @@ font_getsize(FontObject *self, PyObject *args) {
         load_flags |= FT_LOAD_COLOR;
     }
 
-    error = bounding_box_and_anchors(self->face, anchor, horizontal_dir, glyph_info, count, load_flags, &width, &height, &x_offset, &y_offset);
+    error = bounding_box_and_anchors(
+        self->face,
+        anchor,
+        horizontal_dir,
+        glyph_info,
+        count,
+        load_flags,
+        &width,
+        &height,
+        &x_offset,
+        &y_offset);
     if (glyph_info) {
         PyMem_Free(glyph_info);
         glyph_info = NULL;
@@ -767,12 +785,7 @@ font_getsize(FontObject *self, PyObject *args) {
         return NULL;
     }
 
-    return Py_BuildValue(
-        "(ii)(ii)",
-        width,
-        height,
-        x_offset,
-        y_offset);
+    return Py_BuildValue("(ii)(ii)", width, height, x_offset, y_offset);
 }
 
 static PyObject *
@@ -869,7 +882,17 @@ font_render(FontObject *self, PyObject *args) {
 
     horizontal_dir = dir && strcmp(dir, "ttb") == 0 ? 0 : 1;
 
-    error = bounding_box_and_anchors(self->face, anchor, horizontal_dir, glyph_info, count, load_flags, &width, &height, &x_offset, &y_offset);
+    error = bounding_box_and_anchors(
+        self->face,
+        anchor,
+        horizontal_dir,
+        glyph_info,
+        count,
+        load_flags,
+        &width,
+        &height,
+        &x_offset,
+        &y_offset);
     if (error) {
         PyMem_Del(glyph_info);
         return NULL;
@@ -1066,17 +1089,26 @@ font_render(FontObject *self, PyObject *args) {
                         /* paste only if source has data */
                         if (src_alpha > 0) {
                             /* unpremultiply BGRa */
-                            int src_red = CLIP8((255 * (int)source[k * 4 + 2]) / src_alpha);
-                            int src_green = CLIP8((255 * (int)source[k * 4 + 1]) / src_alpha);
-                            int src_blue = CLIP8((255 * (int)source[k * 4 + 0]) / src_alpha);
+                            int src_red =
+                                CLIP8((255 * (int)source[k * 4 + 2]) / src_alpha);
+                            int src_green =
+                                CLIP8((255 * (int)source[k * 4 + 1]) / src_alpha);
+                            int src_blue =
+                                CLIP8((255 * (int)source[k * 4 + 0]) / src_alpha);
 
                             /* blend required if target has data */
                             if (target[k * 4 + 3] > 0) {
                                 /* blend RGBA colors */
-                                target[k * 4 + 0] = BLEND(src_alpha, target[k * 4 + 0], src_red, tmp);
-                                target[k * 4 + 1] = BLEND(src_alpha, target[k * 4 + 1], src_green, tmp);
-                                target[k * 4 + 2] = BLEND(src_alpha, target[k * 4 + 2], src_blue, tmp);
-                                target[k * 4 + 3] = CLIP8(src_alpha + MULDIV255(target[k * 4 + 3], (255 - src_alpha), tmp));
+                                target[k * 4 + 0] =
+                                    BLEND(src_alpha, target[k * 4 + 0], src_red, tmp);
+                                target[k * 4 + 1] =
+                                    BLEND(src_alpha, target[k * 4 + 1], src_green, tmp);
+                                target[k * 4 + 2] =
+                                    BLEND(src_alpha, target[k * 4 + 2], src_blue, tmp);
+                                target[k * 4 + 3] = CLIP8(
+                                    src_alpha +
+                                    MULDIV255(
+                                        target[k * 4 + 3], (255 - src_alpha), tmp));
                             } else {
                                 /* paste unpremultiplied RGBA values */
                                 target[k * 4 + 0] = src_red;
@@ -1093,10 +1125,16 @@ font_render(FontObject *self, PyObject *args) {
                             unsigned int src_alpha = source[k] * convert_scale;
                             if (src_alpha > 0) {
                                 if (target[k * 4 + 3] > 0) {
-                                    target[k * 4 + 0] = BLEND(src_alpha, target[k * 4 + 0], ink[0], tmp);
-                                    target[k * 4 + 1] = BLEND(src_alpha, target[k * 4 + 1], ink[1], tmp);
-                                    target[k * 4 + 2] = BLEND(src_alpha, target[k * 4 + 2], ink[2], tmp);
-                                    target[k * 4 + 3] = CLIP8(src_alpha + MULDIV255(target[k * 4 + 3], (255 - src_alpha), tmp));
+                                    target[k * 4 + 0] = BLEND(
+                                        src_alpha, target[k * 4 + 0], ink[0], tmp);
+                                    target[k * 4 + 1] = BLEND(
+                                        src_alpha, target[k * 4 + 1], ink[1], tmp);
+                                    target[k * 4 + 2] = BLEND(
+                                        src_alpha, target[k * 4 + 2], ink[2], tmp);
+                                    target[k * 4 + 3] = CLIP8(
+                                        src_alpha +
+                                        MULDIV255(
+                                            target[k * 4 + 3], (255 - src_alpha), tmp));
                                 } else {
                                     target[k * 4 + 0] = ink[0];
                                     target[k * 4 + 1] = ink[1];
@@ -1109,7 +1147,13 @@ font_render(FontObject *self, PyObject *args) {
                         for (k = x0; k < x1; k++) {
                             unsigned int src_alpha = source[k] * convert_scale;
                             if (src_alpha > 0) {
-                                target[k] = target[k] > 0 ? CLIP8(src_alpha + MULDIV255(target[k], (255 - src_alpha), tmp)) : src_alpha;
+                                target[k] =
+                                    target[k] > 0
+                                        ? CLIP8(
+                                              src_alpha +
+                                              MULDIV255(
+                                                  target[k], (255 - src_alpha), tmp))
+                                        : src_alpha;
                             }
                         }
                     }
@@ -1249,7 +1293,8 @@ font_getvaraxes(FontObject *self) {
 
             if (name.name_id == axis.strid) {
                 axis_name = Py_BuildValue("y#", name.string, name.string_len);
-                PyDict_SetItemString(list_axis, "name", axis_name ? axis_name : Py_None);
+                PyDict_SetItemString(
+                    list_axis, "name", axis_name ? axis_name : Py_None);
                 Py_XDECREF(axis_name);
                 break;
             }
@@ -1299,7 +1344,7 @@ font_setvaraxes(FontObject *self, PyObject *args) {
     }
 
     num_coords = PyObject_Length(axes);
-    coords = (FT_Fixed*)malloc(num_coords * sizeof(FT_Fixed));
+    coords = (FT_Fixed *)malloc(num_coords * sizeof(FT_Fixed));
     if (coords == NULL) {
         return PyErr_NoMemory();
     }
diff --git a/src/encode.c b/src/encode.c
index c7dd510150e..442b5d04f88 100644
--- a/src/encode.c
+++ b/src/encode.c
@@ -1163,8 +1163,10 @@ PyImaging_JpegEncoderNew(PyObject *self, PyObject *args) {
     ((JPEGENCODERSTATE *)encoder->state.context)->streamtype = streamtype;
     ((JPEGENCODERSTATE *)encoder->state.context)->xdpi = xdpi;
     ((JPEGENCODERSTATE *)encoder->state.context)->ydpi = ydpi;
-    ((JPEGENCODERSTATE *)encoder->state.context)->restart_marker_blocks = restart_marker_blocks;
-    ((JPEGENCODERSTATE *)encoder->state.context)->restart_marker_rows = restart_marker_rows;
+    ((JPEGENCODERSTATE *)encoder->state.context)->restart_marker_blocks =
+        restart_marker_blocks;
+    ((JPEGENCODERSTATE *)encoder->state.context)->restart_marker_rows =
+        restart_marker_rows;
     ((JPEGENCODERSTATE *)encoder->state.context)->comment = comment;
     ((JPEGENCODERSTATE *)encoder->state.context)->comment_size = comment_size;
     ((JPEGENCODERSTATE *)encoder->state.context)->extra = extra;
@@ -1333,9 +1335,7 @@ PyImaging_Jpeg2KEncoderNew(PyObject *self, PyObject *args) {
     if (comment && comment_size > 0) {
         /* Size is stored as as an uint16, subtract 4 bytes for the header */
         if (comment_size >= 65532) {
-            PyErr_SetString(
-                PyExc_ValueError,
-                "JPEG 2000 comment is too long");
+            PyErr_SetString(PyExc_ValueError, "JPEG 2000 comment is too long");
             Py_DECREF(encoder);
             return NULL;
         }
diff --git a/src/libImaging/Access.c b/src/libImaging/Access.c
index 091c84e18fa..97d21034ac3 100644
--- a/src/libImaging/Access.c
+++ b/src/libImaging/Access.c
@@ -191,11 +191,11 @@ put_pixel_32(Imaging im, int x, int y, const void *color) {
 
 void
 ImagingAccessInit() {
-#define ADD(mode_, get_pixel_, put_pixel_)        \
-    {                                             \
-        ImagingAccess access = add_item(mode_);   \
-        access->get_pixel = get_pixel_;           \
-        access->put_pixel = put_pixel_;           \
+#define ADD(mode_, get_pixel_, put_pixel_)      \
+    {                                           \
+        ImagingAccess access = add_item(mode_); \
+        access->get_pixel = get_pixel_;         \
+        access->put_pixel = put_pixel_;         \
     }
 
     /* populate access table */
diff --git a/src/libImaging/BcnDecode.c b/src/libImaging/BcnDecode.c
index 5e4296eeba1..72f478d8d60 100644
--- a/src/libImaging/BcnDecode.c
+++ b/src/libImaging/BcnDecode.c
@@ -83,7 +83,6 @@ decode_bc1_color(rgba *dst, const UINT8 *src, int separate_alpha) {
     g1 = p[1].g;
     b1 = p[1].b;
 
-
     /* NOTE: BC2 and BC3 reuse BC1 color blocks but always act like c0 > c1 */
     if (col.c0 > col.c1 || separate_alpha) {
         p[2].r = (2 * r0 + 1 * r1) / 3;
@@ -354,8 +353,7 @@ decode_bc7_block(rgba *col, const UINT8 *src) {
         }
         return;
     }
-    while (!(mode & (1 << bit++)))
-        ;
+    while (!(mode & (1 << bit++)));
     mode = bit - 1;
     info = &bc7_modes[mode];
     /* color selection bits: {subset}{endpoint} */
@@ -546,7 +544,7 @@ static const UINT8 bc6_bit_packings[][75] = {
      21,  22,  23,  24,  25,  32,  33,  34,  35,  36,  37,  38,  39,  40,  41,
      48,  49,  50,  51,  52,  10,  112, 113, 114, 115, 64,  65,  66,  67,  26,
      176, 160, 161, 162, 163, 80,  81,  82,  83,  42,  177, 128, 129, 130, 131,
-     96,  97, 98,  99,  100, 178, 144, 145, 146, 147, 148, 179},
+     96,  97,  98,  99,  100, 178, 144, 145, 146, 147, 148, 179},
     {0,  1,   2,   3,   4,   5,   6,   7,   8,   9,   16,  17,  18,  19,  20,
      21, 22,  23,  24,  25,  32,  33,  34,  35,  36,  37,  38,  39,  40,  41,
      48, 49,  50,  51,  10,  164, 112, 113, 114, 115, 64,  65,  66,  67,  68,
@@ -684,7 +682,7 @@ bc6_clamp(float value) {
     } else if (value > 1.0f) {
         return 255;
     } else {
-        return (UINT8) (value * 255.0f);
+        return (UINT8)(value * 255.0f);
     }
 }
 
@@ -826,7 +824,13 @@ put_block(Imaging im, ImagingCodecState state, const char *col, int sz, int C) {
 
 static int
 decode_bcn(
-    Imaging im, ImagingCodecState state, const UINT8 *src, int bytes, int N, int C, char *pixel_format) {
+    Imaging im,
+    ImagingCodecState state,
+    const UINT8 *src,
+    int bytes,
+    int N,
+    int C,
+    char *pixel_format) {
     int ymax = state->ysize + state->yoff;
     const UINT8 *ptr = src;
     switch (N) {
@@ -849,8 +853,7 @@ decode_bcn(
         DECODE_LOOP(2, 16, rgba);
         DECODE_LOOP(3, 16, rgba);
         DECODE_LOOP(4, 8, lum);
-        case 5:
-        {
+        case 5: {
             int sign = strcmp(pixel_format, "BC5S") == 0 ? 1 : 0;
             while (bytes >= 16) {
                 rgba col[16];
@@ -865,8 +868,7 @@ decode_bcn(
             }
             break;
         }
-        case 6:
-        {
+        case 6: {
             int sign = strcmp(pixel_format, "BC6HS") == 0 ? 1 : 0;
             while (bytes >= 16) {
                 rgba col[16];
@@ -880,7 +882,7 @@ decode_bcn(
             }
             break;
         }
-        DECODE_LOOP(7, 16, rgba);
+            DECODE_LOOP(7, 16, rgba);
 #undef DECODE_LOOP
     }
     return (int)(ptr - src);
diff --git a/src/libImaging/BoxBlur.c b/src/libImaging/BoxBlur.c
index adf425d0dbd..4ea9c77178a 100644
--- a/src/libImaging/BoxBlur.c
+++ b/src/libImaging/BoxBlur.c
@@ -313,12 +313,12 @@ _gaussian_blur_radius(float radius, int passes) {
 }
 
 Imaging
-ImagingGaussianBlur(Imaging imOut, Imaging imIn, float xradius, float yradius, int passes) {
+ImagingGaussianBlur(
+    Imaging imOut, Imaging imIn, float xradius, float yradius, int passes) {
     return ImagingBoxBlur(
-      imOut,
-      imIn,
-      _gaussian_blur_radius(xradius, passes),
-      _gaussian_blur_radius(yradius, passes),
-      passes
-    );
+        imOut,
+        imIn,
+        _gaussian_blur_radius(xradius, passes),
+        _gaussian_blur_radius(yradius, passes),
+        passes);
 }
diff --git a/src/libImaging/Convert.c b/src/libImaging/Convert.c
index 64840d08c94..fcb5f7ad95e 100644
--- a/src/libImaging/Convert.c
+++ b/src/libImaging/Convert.c
@@ -518,8 +518,8 @@ rgba2rgb_(UINT8 *out, const UINT8 *in, int xsize) {
 
 /*
  * Conversion of RGB + single transparent color either to
- * RGBA or LA, where any pixel matching the color will have the alpha channel set to 0, or
- * RGBa or La, where any pixel matching the color will have all channels set to 0
+ * RGBA or LA, where any pixel matching the color will have the alpha channel set to 0,
+ * or RGBa or La, where any pixel matching the color will have all channels set to 0
  */
 
 static void
@@ -1676,7 +1676,8 @@ convert(
         return (Imaging)ImagingError_ValueError("conversion not supported");
 #else
         static char buf[100];
-        snprintf(buf, 100, "conversion from %.10s to %.10s not supported", imIn->mode, mode);
+        snprintf(
+            buf, 100, "conversion from %.10s to %.10s not supported", imIn->mode, mode);
         return (Imaging)ImagingError_ValueError(buf);
 #endif
     }
@@ -1720,25 +1721,24 @@ ImagingConvertTransparent(Imaging imIn, const char *mode, int r, int g, int b) {
         return (Imaging)ImagingError_ModeError();
     }
 
-    if (strcmp(imIn->mode, "RGB") == 0 && (strcmp(mode, "RGBA") == 0 || strcmp(mode, "RGBa") == 0)) {
+    if (strcmp(imIn->mode, "RGB") == 0 &&
+        (strcmp(mode, "RGBA") == 0 || strcmp(mode, "RGBa") == 0)) {
         convert = rgb2rgba;
         if (strcmp(mode, "RGBa") == 0) {
             premultiplied = 1;
         }
-    } else if (strcmp(imIn->mode, "RGB") == 0 && (strcmp(mode, "LA") == 0 || strcmp(mode, "La") == 0)) {
+    } else if (
+        strcmp(imIn->mode, "RGB") == 0 &&
+        (strcmp(mode, "LA") == 0 || strcmp(mode, "La") == 0)) {
         convert = rgb2la;
         source_transparency = 1;
         if (strcmp(mode, "La") == 0) {
             premultiplied = 1;
         }
-    } else if ((strcmp(imIn->mode, "1") == 0 ||
-                strcmp(imIn->mode, "I") == 0 ||
-                strcmp(imIn->mode, "I;16") == 0 ||
-                strcmp(imIn->mode, "L") == 0
-               ) && (
-                strcmp(mode, "RGBA") == 0 ||
-                strcmp(mode, "LA") == 0
-               )) {
+    } else if (
+        (strcmp(imIn->mode, "1") == 0 || strcmp(imIn->mode, "I") == 0 ||
+         strcmp(imIn->mode, "I;16") == 0 || strcmp(imIn->mode, "L") == 0) &&
+        (strcmp(mode, "RGBA") == 0 || strcmp(mode, "LA") == 0)) {
         if (strcmp(imIn->mode, "1") == 0) {
             convert = bit2rgb;
         } else if (strcmp(imIn->mode, "I") == 0) {
diff --git a/src/libImaging/Draw.c b/src/libImaging/Draw.c
index 0ccf22d58dd..133696dd86f 100644
--- a/src/libImaging/Draw.c
+++ b/src/libImaging/Draw.c
@@ -48,7 +48,7 @@
  * This guarantees that ROUND_UP|DOWN(f) == -ROUND_UP|DOWN(-f)
  */
 #define ROUND_UP(f) ((int)((f) >= 0.0 ? floor((f) + 0.5F) : -floor(fabs(f) + 0.5F)))
-#define ROUND_DOWN(f) ((int)((f) >= 0.0 ? ceil((f)-0.5F) : -ceil(fabs(f) - 0.5F)))
+#define ROUND_DOWN(f) ((int)((f) >= 0.0 ? ceil((f) - 0.5F) : -ceil(fabs(f) - 0.5F)))
 
 /* -------------------------------------------------------------------- */
 /* Primitives                                                           */
@@ -439,7 +439,14 @@ draw_horizontal_lines(
  * Filled polygon draw function using scan line algorithm.
  */
 static inline int
-polygon_generic(Imaging im, int n, Edge *e, int ink, int eofill, hline_handler hline, int hasAlpha) {
+polygon_generic(
+    Imaging im,
+    int n,
+    Edge *e,
+    int ink,
+    int eofill,
+    hline_handler hline,
+    int hasAlpha) {
     Edge **edge_table;
     float *xx;
     int edge_count = 0;
@@ -499,7 +506,7 @@ polygon_generic(Imaging im, int n, Edge *e, int ink, int eofill, hline_handler h
                     // Needed to draw consistent polygons
                     xx[j] = xx[j - 1];
                     j++;
-                } else if (current->dx != 0 && roundf(xx[j-1]) == xx[j-1]) {
+                } else if (current->dx != 0 && roundf(xx[j - 1]) == xx[j - 1]) {
                     // Connect discontiguous corners
                     for (k = 0; k < i; k++) {
                         Edge *other_edge = edge_table[k];
@@ -510,23 +517,38 @@ polygon_generic(Imaging im, int n, Edge *e, int ink, int eofill, hline_handler h
                         // Check if the two edges join to make a corner
                         if (((ymin == current->ymin && ymin == other_edge->ymin) ||
                              (ymin == current->ymax && ymin == other_edge->ymax)) &&
-                            xx[j-1] == (ymin - other_edge->y0) * other_edge->dx + other_edge->x0) {
+                            xx[j - 1] == (ymin - other_edge->y0) * other_edge->dx +
+                                             other_edge->x0) {
                             // Determine points from the edges on the next row
                             // Or if this is the last row, check the previous row
                             int offset = ymin == ymax ? -1 : 1;
-                            adjacent_line_x = (ymin + offset - current->y0) * current->dx + current->x0;
-                            adjacent_line_x_other_edge = (ymin + offset - other_edge->y0) * other_edge->dx + other_edge->x0;
+                            adjacent_line_x =
+                                (ymin + offset - current->y0) * current->dx +
+                                current->x0;
+                            adjacent_line_x_other_edge =
+                                (ymin + offset - other_edge->y0) * other_edge->dx +
+                                other_edge->x0;
                             if (ymin == current->ymax) {
                                 if (current->dx > 0) {
-                                    xx[k] = fmax(adjacent_line_x, adjacent_line_x_other_edge) + 1;
+                                    xx[k] = fmax(
+                                                adjacent_line_x,
+                                                adjacent_line_x_other_edge) +
+                                            1;
                                 } else {
-                                    xx[k] = fmin(adjacent_line_x, adjacent_line_x_other_edge) - 1;
+                                    xx[k] = fmin(
+                                                adjacent_line_x,
+                                                adjacent_line_x_other_edge) -
+                                            1;
                                 }
                             } else {
                                 if (current->dx > 0) {
-                                    xx[k] = fmin(adjacent_line_x, adjacent_line_x_other_edge);
+                                    xx[k] = fmin(
+                                        adjacent_line_x, adjacent_line_x_other_edge);
                                 } else {
-                                    xx[k] = fmax(adjacent_line_x, adjacent_line_x_other_edge) + 1;
+                                    xx[k] = fmax(
+                                                adjacent_line_x,
+                                                adjacent_line_x_other_edge) +
+                                            1;
                                 }
                             }
                             break;
@@ -552,7 +574,8 @@ polygon_generic(Imaging im, int n, Edge *e, int ink, int eofill, hline_handler h
 
                 int x_start = ROUND_UP(xx[i - 1]);
                 if (x_pos > x_start) {
-                    // Line would be partway through x_pos, so increase the starting point
+                    // Line would be partway through x_pos, so increase the starting
+                    // point
                     x_start = x_pos;
                     if (x_end < x_start) {
                         // Line would now end before it started
@@ -776,7 +799,8 @@ ImagingDrawRectangle(
 }
 
 int
-ImagingDrawPolygon(Imaging im, int count, int *xy, const void *ink_, int fill, int width, int op) {
+ImagingDrawPolygon(
+    Imaging im, int count, int *xy, const void *ink_, int fill, int width, int op) {
     int i, n, x0, y0, x1, y1;
     DRAW *draw;
     INT32 ink;
@@ -803,7 +827,7 @@ ImagingDrawPolygon(Imaging im, int count, int *xy, const void *ink_, int fill, i
             if (y0 == y1 && i != 0 && y0 == xy[i * 2 - 1]) {
                 // This is a horizontal line,
                 // that immediately follows another horizontal line
-                Edge *last_e = &e[n-1];
+                Edge *last_e = &e[n - 1];
                 if (x1 > x0 && x0 > xy[i * 2 - 2]) {
                     // They are both increasing in x
                     last_e->xmax = x1;
@@ -826,14 +850,24 @@ ImagingDrawPolygon(Imaging im, int count, int *xy, const void *ink_, int fill, i
         /* Outline */
         if (width == 1) {
             for (i = 0; i < count - 1; i++) {
-                draw->line(im, xy[i * 2], xy[i * 2 + 1], xy[i * 2 + 2], xy[i * 2 + 3], ink);
+                draw->line(
+                    im, xy[i * 2], xy[i * 2 + 1], xy[i * 2 + 2], xy[i * 2 + 3], ink);
             }
             draw->line(im, xy[i * 2], xy[i * 2 + 1], xy[0], xy[1], ink);
         } else {
             for (i = 0; i < count - 1; i++) {
-                ImagingDrawWideLine(im, xy[i * 2], xy[i * 2 + 1], xy[i * 2 + 2], xy[i * 2 + 3], ink_, width, op);
+                ImagingDrawWideLine(
+                    im,
+                    xy[i * 2],
+                    xy[i * 2 + 1],
+                    xy[i * 2 + 2],
+                    xy[i * 2 + 3],
+                    ink_,
+                    width,
+                    op);
             }
-            ImagingDrawWideLine(im, xy[i * 2], xy[i * 2 + 1], xy[0], xy[1], ink_, width, op);
+            ImagingDrawWideLine(
+                im, xy[i * 2], xy[i * 2 + 1], xy[0], xy[1], ink_, width, op);
         }
     }
 
diff --git a/src/libImaging/Filter.c b/src/libImaging/Filter.c
index 4dcd368ca80..85de77fcbbc 100644
--- a/src/libImaging/Filter.c
+++ b/src/libImaging/Filter.c
@@ -106,7 +106,7 @@ ImagingExpand(Imaging imIn, int xmargin, int ymargin) {
 
 void
 ImagingFilter3x3(Imaging imOut, Imaging im, const float *kernel, float offset) {
-#define KERNEL1x3(in0, x, kernel, d)                                             \
+#define KERNEL1x3(in0, x, kernel, d)                               \
     (_i2f(in0[x - d]) * (kernel)[0] + _i2f(in0[x]) * (kernel)[1] + \
      _i2f(in0[x + d]) * (kernel)[2])
 
@@ -224,10 +224,9 @@ ImagingFilter3x3(Imaging imOut, Imaging im, const float *kernel, float offset) {
 
 void
 ImagingFilter5x5(Imaging imOut, Imaging im, const float *kernel, float offset) {
-#define KERNEL1x5(in0, x, kernel, d)                                             \
-    (_i2f(in0[x - d - d]) * (kernel)[0] +                                 \
-     _i2f(in0[x - d]) * (kernel)[1] + _i2f(in0[x]) * (kernel)[2] + \
-     _i2f(in0[x + d]) * (kernel)[3] +                                     \
+#define KERNEL1x5(in0, x, kernel, d)                                       \
+    (_i2f(in0[x - d - d]) * (kernel)[0] + _i2f(in0[x - d]) * (kernel)[1] + \
+     _i2f(in0[x]) * (kernel)[2] + _i2f(in0[x + d]) * (kernel)[3] +         \
      _i2f(in0[x + d + d]) * (kernel)[4])
 
     int x = 0, y = 0;
diff --git a/src/libImaging/FliDecode.c b/src/libImaging/FliDecode.c
index d6e4ea0ff9d..debe7ddd82a 100644
--- a/src/libImaging/FliDecode.c
+++ b/src/libImaging/FliDecode.c
@@ -232,7 +232,8 @@ ImagingFliDecode(Imaging im, ImagingCodecState state, UINT8 *buf, Py_ssize_t byt
                 /* Note, have to check Data + size, not just ptr + size) */
                 if (data + (state->xsize * state->ysize) > ptr + bytes) {
                     /* not enough data for frame */
-                    /* UNDONE Unclear that we're actually going to leave the buffer at the right place. */
+                    /* UNDONE Unclear that we're actually going to leave the buffer at
+                     * the right place. */
                     return ptr - buf; /* bytes consumed */
                 }
                 for (y = 0; y < state->ysize; y++) {
@@ -251,7 +252,7 @@ ImagingFliDecode(Imaging im, ImagingCodecState state, UINT8 *buf, Py_ssize_t byt
                 return -1;
         }
         advance = I32(ptr);
-        if (advance == 0 ) {
+        if (advance == 0) {
             // If there's no advance, we're in an infinite loop
             state->errcode = IMAGING_CODEC_BROKEN;
             return -1;
diff --git a/src/libImaging/Geometry.c b/src/libImaging/Geometry.c
index 0c591579217..cf3bc997942 100644
--- a/src/libImaging/Geometry.c
+++ b/src/libImaging/Geometry.c
@@ -565,13 +565,13 @@ bilinear_filter32RGB(void *out, Imaging im, double xin, double yin) {
 #undef BILINEAR_HEAD
 #undef BILINEAR_BODY
 
-#define BICUBIC(v, v1, v2, v3, v4, d)              \
-    {                                              \
-        double p1 = v2;                            \
-        double p2 = -v1 + v3;                      \
-        double p3 = 2 * (v1 - v2) + v3 - v4;       \
-        double p4 = -v1 + v2 - v3 + v4;            \
-        v = p1 + (d) * (p2 + (d) * (p3 + (d)*p4)); \
+#define BICUBIC(v, v1, v2, v3, v4, d)                \
+    {                                                \
+        double p1 = v2;                              \
+        double p2 = -v1 + v3;                        \
+        double p3 = 2 * (v1 - v2) + v3 - v4;         \
+        double p4 = -v1 + v2 - v3 + v4;              \
+        v = p1 + (d) * (p2 + (d) * (p3 + (d) * p4)); \
     }
 
 #define BICUBIC_HEAD(type)                                                \
@@ -966,7 +966,7 @@ affine_fixed(
     ysize = (int)imIn->ysize;
 
 /* use 16.16 fixed point arithmetics */
-#define FIX(v) FLOOR((v)*65536.0 + 0.5)
+#define FIX(v) FLOOR((v) * 65536.0 + 0.5)
 
     a0 = FIX(a[0]);
     a1 = FIX(a[1]);
diff --git a/src/libImaging/GetBBox.c b/src/libImaging/GetBBox.c
index 86c687ca0a8..bd2a2778cdb 100644
--- a/src/libImaging/GetBBox.c
+++ b/src/libImaging/GetBBox.c
@@ -58,11 +58,11 @@ ImagingGetBBox(Imaging im, int bbox[4], int alpha_only) {
         INT32 mask = 0xffffffff;
         if (im->bands == 3) {
             ((UINT8 *)&mask)[3] = 0;
-        } else if (alpha_only && (
-            strcmp(im->mode, "RGBa") == 0 || strcmp(im->mode, "RGBA") == 0 ||
-            strcmp(im->mode, "La") == 0 || strcmp(im->mode, "LA") == 0 ||
-            strcmp(im->mode, "PA") == 0
-        )) {
+        } else if (
+            alpha_only &&
+            (strcmp(im->mode, "RGBa") == 0 || strcmp(im->mode, "RGBA") == 0 ||
+             strcmp(im->mode, "La") == 0 || strcmp(im->mode, "LA") == 0 ||
+             strcmp(im->mode, "PA") == 0)) {
 #ifdef WORDS_BIGENDIAN
             mask = 0x000000ff;
 #else
diff --git a/src/libImaging/Gif.h b/src/libImaging/Gif.h
index 5d7e2bdaa96..8edfbc2edc0 100644
--- a/src/libImaging/Gif.h
+++ b/src/libImaging/Gif.h
@@ -9,10 +9,10 @@
 
 /* Max size for a LZW code word. */
 
-#define GIFBITS     12
+#define GIFBITS 12
 
-#define GIFTABLE    (1<<GIFBITS)
-#define GIFBUFFER   (1<<GIFBITS)
+#define GIFTABLE (1 << GIFBITS)
+#define GIFBUFFER (1 << GIFBITS)
 
 typedef struct {
     /* CONFIGURATION */
@@ -66,7 +66,7 @@ typedef struct {
 } GIFDECODERSTATE;
 
 /* For GIF LZW encoder. */
-#define TABLE_SIZE  8192
+#define TABLE_SIZE 8192
 
 typedef struct {
     /* CONFIGURATION */
diff --git a/src/libImaging/GifEncode.c b/src/libImaging/GifEncode.c
index e37301df765..831ce432c31 100644
--- a/src/libImaging/GifEncode.c
+++ b/src/libImaging/GifEncode.c
@@ -34,28 +34,36 @@ enum { INIT, ENCODE, FINISH };
  */
 
 /* Return values */
-#define GLZW_OK                 0
-#define GLZW_NO_INPUT_AVAIL     1
-#define GLZW_NO_OUTPUT_AVAIL    2
-#define GLZW_INTERNAL_ERROR     3
+#define GLZW_OK 0
+#define GLZW_NO_INPUT_AVAIL 1
+#define GLZW_NO_OUTPUT_AVAIL 2
+#define GLZW_INTERNAL_ERROR 3
 
-#define CODE_LIMIT              4096
+#define CODE_LIMIT 4096
 
 /* Values of entry_state */
-enum { LZW_INITIAL, LZW_TRY_IN1, LZW_TRY_IN2, LZW_TRY_OUT1, LZW_TRY_OUT2,
-    LZW_FINISHED };
+enum {
+    LZW_INITIAL,
+    LZW_TRY_IN1,
+    LZW_TRY_IN2,
+    LZW_TRY_OUT1,
+    LZW_TRY_OUT2,
+    LZW_FINISHED
+};
 
 /* Values of control_state */
 enum { PUT_HEAD, PUT_INIT_CLEAR, PUT_CLEAR, PUT_LAST_HEAD, PUT_END };
 
-static void glzwe_reset(GIFENCODERSTATE *st) {
+static void
+glzwe_reset(GIFENCODERSTATE *st) {
     st->next_code = st->end_code + 1;
     st->max_code = 2 * st->clear_code - 1;
     st->code_width = st->bits + 1;
     memset(st->codes, 0, sizeof(st->codes));
 }
 
-static void glzwe_init(GIFENCODERSTATE *st) {
+static void
+glzwe_init(GIFENCODERSTATE *st) {
     st->clear_code = 1 << st->bits;
     st->end_code = st->clear_code + 1;
     glzwe_reset(st);
@@ -64,156 +72,157 @@ static void glzwe_init(GIFENCODERSTATE *st) {
     st->code_buffer = 0;
 }
 
-static int glzwe(GIFENCODERSTATE *st, const UINT8 *in_ptr, UINT8 *out_ptr,
-        UINT32 *in_avail, UINT32 *out_avail,
-        UINT32 end_of_data) {
+static int
+glzwe(
+    GIFENCODERSTATE *st,
+    const UINT8 *in_ptr,
+    UINT8 *out_ptr,
+    UINT32 *in_avail,
+    UINT32 *out_avail,
+    UINT32 end_of_data) {
     switch (st->entry_state) {
-
-    case LZW_TRY_IN1:
-get_first_byte:
-        if (!*in_avail) {
-            if (end_of_data) {
-                goto end_of_data;
-            }
-            st->entry_state = LZW_TRY_IN1;
-            return GLZW_NO_INPUT_AVAIL;
-        }
-        st->head = *in_ptr++;
-        (*in_avail)--;
-
-    case LZW_TRY_IN2:
-encode_loop:
-        if (!*in_avail) {
-            if (end_of_data) {
-                st->code = st->head;
-                st->put_state = PUT_LAST_HEAD;
-                goto put_code;
+        case LZW_TRY_IN1:
+        get_first_byte:
+            if (!*in_avail) {
+                if (end_of_data) {
+                    goto end_of_data;
+                }
+                st->entry_state = LZW_TRY_IN1;
+                return GLZW_NO_INPUT_AVAIL;
             }
-            st->entry_state = LZW_TRY_IN2;
-            return GLZW_NO_INPUT_AVAIL;
-        }
-        st->tail = *in_ptr++;
-        (*in_avail)--;
-
-        /* Knuth TAOCP vol 3 sec. 6.4 algorithm D. */
-        /* Hash found experimentally to be pretty good. */
-        /* This works ONLY with TABLE_SIZE a power of 2. */
-        st->probe = ((st->head ^ (st->tail << 6)) * 31) & (TABLE_SIZE - 1);
-        while (st->codes[st->probe]) {
-            if ((st->codes[st->probe] & 0xFFFFF) ==
-                                        ((st->head << 8) | st->tail)) {
-                st->head = st->codes[st->probe] >> 20;
-                goto encode_loop;
-            } else {
-        /* Reprobe decrement must be non-zero and relatively prime to table
-         * size. So, any odd positive number for power-of-2 size. */
-                if ((st->probe -= ((st->tail << 2) | 1)) < 0) {
-                    st->probe += TABLE_SIZE;
+            st->head = *in_ptr++;
+            (*in_avail)--;
+
+        case LZW_TRY_IN2:
+        encode_loop:
+            if (!*in_avail) {
+                if (end_of_data) {
+                    st->code = st->head;
+                    st->put_state = PUT_LAST_HEAD;
+                    goto put_code;
                 }
+                st->entry_state = LZW_TRY_IN2;
+                return GLZW_NO_INPUT_AVAIL;
             }
-        }
-        /* Key not found, probe is at empty slot. */
-        st->code = st->head;
-        st->put_state = PUT_HEAD;
-        goto put_code;
-insert_code_or_clear: /* jump here after put_code */
-        if (st->next_code < CODE_LIMIT) {
-            st->codes[st->probe] = (st->next_code << 20) |
-                                    (st->head << 8) | st->tail;
-            if (st->next_code > st->max_code) {
-                st->max_code = st->max_code * 2 + 1;
-                st->code_width++;
+            st->tail = *in_ptr++;
+            (*in_avail)--;
+
+            /* Knuth TAOCP vol 3 sec. 6.4 algorithm D. */
+            /* Hash found experimentally to be pretty good. */
+            /* This works ONLY with TABLE_SIZE a power of 2. */
+            st->probe = ((st->head ^ (st->tail << 6)) * 31) & (TABLE_SIZE - 1);
+            while (st->codes[st->probe]) {
+                if ((st->codes[st->probe] & 0xFFFFF) == ((st->head << 8) | st->tail)) {
+                    st->head = st->codes[st->probe] >> 20;
+                    goto encode_loop;
+                } else {
+                    /* Reprobe decrement must be non-zero and relatively prime to table
+                     * size. So, any odd positive number for power-of-2 size. */
+                    if ((st->probe -= ((st->tail << 2) | 1)) < 0) {
+                        st->probe += TABLE_SIZE;
+                    }
+                }
             }
-            st->next_code++;
-        } else {
-            st->code = st->clear_code;
-            st->put_state = PUT_CLEAR;
+            /* Key not found, probe is at empty slot. */
+            st->code = st->head;
+            st->put_state = PUT_HEAD;
             goto put_code;
-reset_after_clear: /* jump here after put_code */
-            glzwe_reset(st);
-        }
-        st->head = st->tail;
-        goto encode_loop;
-
-    case LZW_INITIAL:
-        glzwe_reset(st);
-        st->code = st->clear_code;
-        st->put_state = PUT_INIT_CLEAR;
-put_code:
-        st->code_bits_left = st->code_width;
-check_buf_bits:
-        if (!st->buf_bits_left) {   /* out buffer full */
-
-    case LZW_TRY_OUT1:
-            if (!*out_avail) {
-                st->entry_state = LZW_TRY_OUT1;
-                return GLZW_NO_OUTPUT_AVAIL;
+        insert_code_or_clear: /* jump here after put_code */
+            if (st->next_code < CODE_LIMIT) {
+                st->codes[st->probe] =
+                    (st->next_code << 20) | (st->head << 8) | st->tail;
+                if (st->next_code > st->max_code) {
+                    st->max_code = st->max_code * 2 + 1;
+                    st->code_width++;
+                }
+                st->next_code++;
+            } else {
+                st->code = st->clear_code;
+                st->put_state = PUT_CLEAR;
+                goto put_code;
+            reset_after_clear: /* jump here after put_code */
+                glzwe_reset(st);
             }
-            *out_ptr++ = st->code_buffer;
-            (*out_avail)--;
-            st->code_buffer = 0;
-            st->buf_bits_left = 8;
-        }
-        /* code bits to pack */
-        UINT32 n = st->buf_bits_left < st->code_bits_left
-                        ? st->buf_bits_left : st->code_bits_left;
-        st->code_buffer |=
-                        (st->code & ((1 << n) - 1)) << (8 - st->buf_bits_left);
-        st->code >>= n;
-        st->buf_bits_left -= n;
-        st->code_bits_left -= n;
-        if (st->code_bits_left) {
-            goto check_buf_bits;
-        }
-        switch (st->put_state) {
-        case PUT_INIT_CLEAR:
-            goto get_first_byte;
-        case PUT_HEAD:
-            goto insert_code_or_clear;
-        case PUT_CLEAR:
-            goto reset_after_clear;
-        case PUT_LAST_HEAD:
-            goto end_of_data;
-        case PUT_END:
-            goto flush_code_buffer;
-        default:
-            return GLZW_INTERNAL_ERROR;
-        }
+            st->head = st->tail;
+            goto encode_loop;
 
-end_of_data:
-        st->code = st->end_code;
-        st->put_state = PUT_END;
-        goto put_code;
-flush_code_buffer: /* jump here after put_code */
-        if (st->buf_bits_left < 8) {
+        case LZW_INITIAL:
+            glzwe_reset(st);
+            st->code = st->clear_code;
+            st->put_state = PUT_INIT_CLEAR;
+        put_code:
+            st->code_bits_left = st->code_width;
+        check_buf_bits:
+            if (!st->buf_bits_left) { /* out buffer full */
+
+                case LZW_TRY_OUT1:
+                    if (!*out_avail) {
+                        st->entry_state = LZW_TRY_OUT1;
+                        return GLZW_NO_OUTPUT_AVAIL;
+                    }
+                    *out_ptr++ = st->code_buffer;
+                    (*out_avail)--;
+                    st->code_buffer = 0;
+                    st->buf_bits_left = 8;
+            }
+            /* code bits to pack */
+            UINT32 n = st->buf_bits_left < st->code_bits_left ? st->buf_bits_left
+                                                              : st->code_bits_left;
+            st->code_buffer |= (st->code & ((1 << n) - 1)) << (8 - st->buf_bits_left);
+            st->code >>= n;
+            st->buf_bits_left -= n;
+            st->code_bits_left -= n;
+            if (st->code_bits_left) {
+                goto check_buf_bits;
+            }
+            switch (st->put_state) {
+                case PUT_INIT_CLEAR:
+                    goto get_first_byte;
+                case PUT_HEAD:
+                    goto insert_code_or_clear;
+                case PUT_CLEAR:
+                    goto reset_after_clear;
+                case PUT_LAST_HEAD:
+                    goto end_of_data;
+                case PUT_END:
+                    goto flush_code_buffer;
+                default:
+                    return GLZW_INTERNAL_ERROR;
+            }
 
-    case LZW_TRY_OUT2:
-            if (!*out_avail) {
-                st->entry_state = LZW_TRY_OUT2;
-                return GLZW_NO_OUTPUT_AVAIL;
+        end_of_data:
+            st->code = st->end_code;
+            st->put_state = PUT_END;
+            goto put_code;
+        flush_code_buffer: /* jump here after put_code */
+            if (st->buf_bits_left < 8) {
+                case LZW_TRY_OUT2:
+                    if (!*out_avail) {
+                        st->entry_state = LZW_TRY_OUT2;
+                        return GLZW_NO_OUTPUT_AVAIL;
+                    }
+                    *out_ptr++ = st->code_buffer;
+                    (*out_avail)--;
             }
-            *out_ptr++ = st->code_buffer;
-            (*out_avail)--;
-        }
-        st->entry_state = LZW_FINISHED;
-        return GLZW_OK;
+            st->entry_state = LZW_FINISHED;
+            return GLZW_OK;
 
-    case LZW_FINISHED:
-        return GLZW_OK;
+        case LZW_FINISHED:
+            return GLZW_OK;
 
-    default:
-        return GLZW_INTERNAL_ERROR;
+        default:
+            return GLZW_INTERNAL_ERROR;
     }
 }
 /* -END- GIF LZW encoder. */
 
 int
-ImagingGifEncode(Imaging im, ImagingCodecState state, UINT8* buf, int bytes) {
-    UINT8* ptr;
-    UINT8* sub_block_ptr;
-    UINT8* sub_block_limit;
-    UINT8* buf_limit;
-    GIFENCODERSTATE *context = (GIFENCODERSTATE*) state->context;
+ImagingGifEncode(Imaging im, ImagingCodecState state, UINT8 *buf, int bytes) {
+    UINT8 *ptr;
+    UINT8 *sub_block_ptr;
+    UINT8 *sub_block_limit;
+    UINT8 *buf_limit;
+    GIFENCODERSTATE *context = (GIFENCODERSTATE *)state->context;
     int r;
 
     UINT32 in_avail, in_used;
@@ -278,9 +287,9 @@ ImagingGifEncode(Imaging im, ImagingCodecState state, UINT8* buf, int bytes) {
                 return ptr - buf;
             }
             sub_block_ptr = ptr;
-            sub_block_limit = sub_block_ptr +
-                (256 < buf_limit - sub_block_ptr ?
-                 256 : buf_limit - sub_block_ptr);
+            sub_block_limit =
+                sub_block_ptr +
+                (256 < buf_limit - sub_block_ptr ? 256 : buf_limit - sub_block_ptr);
             *ptr++ = 0;
         }
 
@@ -301,9 +310,9 @@ ImagingGifEncode(Imaging im, ImagingCodecState state, UINT8* buf, int bytes) {
             /* get another line of data */
             state->shuffle(
                 state->buffer,
-                (UINT8*) im->image[state->y + state->yoff] +
-                state->xoff * im->pixelsize, state->xsize
-            );
+                (UINT8 *)im->image[state->y + state->yoff] +
+                    state->xoff * im->pixelsize,
+                state->xsize);
             state->x = 0;
 
             /* step forward, according to the interlace settings */
@@ -331,10 +340,15 @@ ImagingGifEncode(Imaging im, ImagingCodecState state, UINT8* buf, int bytes) {
             }
         }
 
-        in_avail = state->xsize - state->x;   /* bytes left in line */
+        in_avail = state->xsize - state->x; /* bytes left in line */
         out_avail = sub_block_limit - ptr;  /* bytes left in sub-block */
-        r = glzwe(context, &state->buffer[state->x], ptr, &in_avail,
-                &out_avail, state->state == FINISH);
+        r = glzwe(
+            context,
+            &state->buffer[state->x],
+            ptr,
+            &in_avail,
+            &out_avail,
+            state->state == FINISH);
         out_used = sub_block_limit - ptr - out_avail;
         *sub_block_ptr += out_used;
         ptr += out_used;
diff --git a/src/libImaging/Imaging.h b/src/libImaging/Imaging.h
index afcd2229bde..1f2c03e934f 100644
--- a/src/libImaging/Imaging.h
+++ b/src/libImaging/Imaging.h
@@ -108,15 +108,15 @@ struct ImagingMemoryInstance {
 
 #define IMAGING_PIXEL_1(im, x, y) ((im)->image8[(y)][(x)])
 #define IMAGING_PIXEL_L(im, x, y) ((im)->image8[(y)][(x)])
-#define IMAGING_PIXEL_LA(im, x, y) ((im)->image[(y)][(x)*4])
+#define IMAGING_PIXEL_LA(im, x, y) ((im)->image[(y)][(x) * 4])
 #define IMAGING_PIXEL_P(im, x, y) ((im)->image8[(y)][(x)])
-#define IMAGING_PIXEL_PA(im, x, y) ((im)->image[(y)][(x)*4])
+#define IMAGING_PIXEL_PA(im, x, y) ((im)->image[(y)][(x) * 4])
 #define IMAGING_PIXEL_I(im, x, y) ((im)->image32[(y)][(x)])
 #define IMAGING_PIXEL_F(im, x, y) (((FLOAT32 *)(im)->image32[y])[x])
-#define IMAGING_PIXEL_RGB(im, x, y) ((im)->image[(y)][(x)*4])
-#define IMAGING_PIXEL_RGBA(im, x, y) ((im)->image[(y)][(x)*4])
-#define IMAGING_PIXEL_CMYK(im, x, y) ((im)->image[(y)][(x)*4])
-#define IMAGING_PIXEL_YCbCr(im, x, y) ((im)->image[(y)][(x)*4])
+#define IMAGING_PIXEL_RGB(im, x, y) ((im)->image[(y)][(x) * 4])
+#define IMAGING_PIXEL_RGBA(im, x, y) ((im)->image[(y)][(x) * 4])
+#define IMAGING_PIXEL_CMYK(im, x, y) ((im)->image[(y)][(x) * 4])
+#define IMAGING_PIXEL_YCbCr(im, x, y) ((im)->image[(y)][(x) * 4])
 
 #define IMAGING_PIXEL_UINT8(im, x, y) ((im)->image8[(y)][(x)])
 #define IMAGING_PIXEL_INT32(im, x, y) ((im)->image32[(y)][(x)])
@@ -161,7 +161,7 @@ typedef struct ImagingMemoryArena {
     int stats_reallocated_blocks; /* Number of blocks which were actually reallocated
                                      after retrieving */
     int stats_freed_blocks;       /* Number of freed blocks */
-} * ImagingMemoryArena;
+} *ImagingMemoryArena;
 
 /* Objects */
 /* ------- */
@@ -309,7 +309,8 @@ ImagingFlipLeftRight(Imaging imOut, Imaging imIn);
 extern Imaging
 ImagingFlipTopBottom(Imaging imOut, Imaging imIn);
 extern Imaging
-ImagingGaussianBlur(Imaging imOut, Imaging imIn, float xradius, float yradius, int passes);
+ImagingGaussianBlur(
+    Imaging imOut, Imaging imIn, float xradius, float yradius, int passes);
 extern Imaging
 ImagingGetBand(Imaging im, int band);
 extern Imaging
@@ -487,7 +488,8 @@ ImagingDrawPieslice(
 extern int
 ImagingDrawPoint(Imaging im, int x, int y, const void *ink, int op);
 extern int
-ImagingDrawPolygon(Imaging im, int points, int *xy, const void *ink, int fill, int width, int op);
+ImagingDrawPolygon(
+    Imaging im, int points, int *xy, const void *ink, int fill, int width, int op);
 extern int
 ImagingDrawRectangle(
     Imaging im,
diff --git a/src/libImaging/ImagingUtils.h b/src/libImaging/ImagingUtils.h
index 0c0c1eda917..714458ad02a 100644
--- a/src/libImaging/ImagingUtils.h
+++ b/src/libImaging/ImagingUtils.h
@@ -21,7 +21,7 @@
 
 #define DIV255(a, tmp) (tmp = (a) + 128, SHIFTFORDIV255(tmp))
 
-#define BLEND(mask, in1, in2, tmp1) DIV255(in1 *(255 - mask) + in2 * mask, tmp1)
+#define BLEND(mask, in1, in2, tmp1) DIV255(in1 * (255 - mask) + in2 * mask, tmp1)
 
 #define PREBLEND(mask, in1, in2, tmp1) (MULDIV255(in1, (255 - mask), tmp1) + in2)
 
diff --git a/src/libImaging/Jpeg2KDecode.c b/src/libImaging/Jpeg2KDecode.c
index 78a09bb8333..dd066c10b7a 100644
--- a/src/libImaging/Jpeg2KDecode.c
+++ b/src/libImaging/Jpeg2KDecode.c
@@ -183,9 +183,9 @@ j2ku_gray_i(
                 UINT16 *row = (UINT16 *)im->image[y0 + y] + x0;
                 for (x = 0; x < w; ++x) {
                     UINT16 pixel = j2ku_shift(offset + *data++, shift);
-                    #ifdef WORDS_BIGENDIAN
-                        pixel = (pixel >> 8) | (pixel << 8);
-                    #endif
+#ifdef WORDS_BIGENDIAN
+                    pixel = (pixel >> 8) | (pixel << 8);
+#endif
                     *row++ = pixel;
                 }
             }
@@ -778,7 +778,7 @@ j2k_decode_entry(Imaging im, ImagingCodecState state) {
                         color_space = OPJ_CLRSPC_SYCC;
                         break;
                 }
-            break;
+                break;
         }
     }
 
@@ -864,7 +864,7 @@ j2k_decode_entry(Imaging im, ImagingCodecState state) {
          a, and then a malicious file could have a smaller tile_bytes
         */
 
-        for (n=0; n < tile_info.nb_comps; n++) {
+        for (n = 0; n < tile_info.nb_comps; n++) {
             // see csize /acsize calcs
             int csize = (image->comps[n].prec + 7) >> 3;
             csize = (csize == 3) ? 4 : csize;
diff --git a/src/libImaging/Jpeg2KEncode.c b/src/libImaging/Jpeg2KEncode.c
index 3295373fd64..7f1aeaddb9b 100644
--- a/src/libImaging/Jpeg2KEncode.c
+++ b/src/libImaging/Jpeg2KEncode.c
@@ -383,8 +383,7 @@ j2k_encode_entry(Imaging im, ImagingCodecState state) {
         float *pq;
 
         if (len > 0) {
-            if ((size_t)len >
-                sizeof(params.tcp_rates) / sizeof(params.tcp_rates[0])) {
+            if ((size_t)len > sizeof(params.tcp_rates) / sizeof(params.tcp_rates[0])) {
                 len = sizeof(params.tcp_rates) / sizeof(params.tcp_rates[0]);
             }
 
@@ -464,7 +463,8 @@ j2k_encode_entry(Imaging im, ImagingCodecState state) {
     }
 
     if (!context->num_resolutions) {
-        while (tile_width < (1U << (params.numresolution - 1U)) || tile_height < (1U << (params.numresolution - 1U))) {
+        while (tile_width < (1U << (params.numresolution - 1U)) ||
+               tile_height < (1U << (params.numresolution - 1U))) {
             params.numresolution -= 1;
         }
     }
diff --git a/src/libImaging/JpegEncode.c b/src/libImaging/JpegEncode.c
index 00f3d5f74db..bcbe65aa4d6 100644
--- a/src/libImaging/JpegEncode.c
+++ b/src/libImaging/JpegEncode.c
@@ -145,8 +145,8 @@ ImagingJpegEncode(Imaging im, ImagingCodecState state, UINT8 *buf, int bytes) {
                     case JCS_EXT_RGBX:
 #endif
                         switch (context->subsampling) {
-                            case -1:  /* Default */
-                            case 0:   /* No subsampling */
+                            case -1: /* Default */
+                            case 0:  /* No subsampling */
                                 break;
                             default:
                                 /* Would subsample the green and blue
@@ -305,7 +305,11 @@ ImagingJpegEncode(Imaging im, ImagingCodecState state, UINT8 *buf, int bytes) {
         case 4:
 
             if (context->comment) {
-                jpeg_write_marker(&context->cinfo, JPEG_COM, (unsigned char *)context->comment, context->comment_size);
+                jpeg_write_marker(
+                    &context->cinfo,
+                    JPEG_COM,
+                    (unsigned char *)context->comment,
+                    context->comment_size);
             }
             state->state++;
 
@@ -342,7 +346,7 @@ ImagingJpegEncode(Imaging im, ImagingCodecState state, UINT8 *buf, int bytes) {
             }
             jpeg_finish_compress(&context->cinfo);
 
-cleanup:
+        cleanup:
             /* Clean up */
             if (context->comment) {
                 free(context->comment);
diff --git a/src/libImaging/Paste.c b/src/libImaging/Paste.c
index 6684b11efe3..a018225b26e 100644
--- a/src/libImaging/Paste.c
+++ b/src/libImaging/Paste.c
@@ -432,11 +432,10 @@ fill_mask_L(
         }
 
     } else {
-        int alpha_channel = strcmp(imOut->mode, "RGBa") == 0 ||
-                            strcmp(imOut->mode, "RGBA") == 0 ||
-                            strcmp(imOut->mode, "La") == 0 ||
-                            strcmp(imOut->mode, "LA") == 0 ||
-                            strcmp(imOut->mode, "PA") == 0;
+        int alpha_channel =
+            strcmp(imOut->mode, "RGBa") == 0 || strcmp(imOut->mode, "RGBA") == 0 ||
+            strcmp(imOut->mode, "La") == 0 || strcmp(imOut->mode, "LA") == 0 ||
+            strcmp(imOut->mode, "PA") == 0;
         for (y = 0; y < ysize; y++) {
             UINT8 *out = (UINT8 *)imOut->image[y + dy] + dx * pixelsize;
             UINT8 *mask = (UINT8 *)imMask->image[y + sy] + sx;
diff --git a/src/libImaging/Point.c b/src/libImaging/Point.c
index 8883578cbff..dd06f3940d1 100644
--- a/src/libImaging/Point.c
+++ b/src/libImaging/Point.c
@@ -134,7 +134,7 @@ ImagingPoint(Imaging imIn, const char *mode, const void *table) {
     ImagingSectionCookie cookie;
     Imaging imOut;
     im_point_context context;
-    void (*point)(Imaging imIn, Imaging imOut, im_point_context * context);
+    void (*point)(Imaging imIn, Imaging imOut, im_point_context *context);
 
     if (!imIn) {
         return (Imaging)ImagingError_ModeError();
diff --git a/src/libImaging/Quant.c b/src/libImaging/Quant.c
index 2582830c4a4..cdc614536da 100644
--- a/src/libImaging/Quant.c
+++ b/src/libImaging/Quant.c
@@ -260,8 +260,7 @@ mergesort_pixels(PixelList *head, int i) {
         return head;
     }
     for (c = t = head; c && t;
-         c = c->next[i], t = (t->next[i]) ? t->next[i]->next[i] : NULL)
-        ;
+         c = c->next[i], t = (t->next[i]) ? t->next[i]->next[i] : NULL);
     if (c) {
         if (c->prev[i]) {
             c->prev[i]->next[i] = NULL;
@@ -354,12 +353,10 @@ splitlists(
         for (_i = 0; _i < 3; _i++) {
             for (_nextCount[_i] = 0, _nextTest = h[_i];
                  _nextTest && _nextTest->next[_i];
-                 _nextTest = _nextTest->next[_i], _nextCount[_i]++)
-                ;
+                 _nextTest = _nextTest->next[_i], _nextCount[_i]++);
             for (_prevCount[_i] = 0, _prevTest = t[_i];
                  _prevTest && _prevTest->prev[_i];
-                 _prevTest = _prevTest->prev[_i], _prevCount[_i]++)
-                ;
+                 _prevTest = _prevTest->prev[_i], _prevCount[_i]++);
             if (_nextTest != t[_i]) {
                 printf("next-list of axis %d does not end at tail\n", _i);
                 exit(1);
@@ -368,10 +365,8 @@ splitlists(
                 printf("prev-list of axis %d does not end at head\n", _i);
                 exit(1);
             }
-            for (; _nextTest && _nextTest->prev[_i]; _nextTest = _nextTest->prev[_i])
-                ;
-            for (; _prevTest && _prevTest->next[_i]; _prevTest = _prevTest->next[_i])
-                ;
+            for (; _nextTest && _nextTest->prev[_i]; _nextTest = _nextTest->prev[_i]);
+            for (; _prevTest && _prevTest->next[_i]; _prevTest = _prevTest->next[_i]);
             if (_nextTest != h[_i]) {
                 printf("next-list of axis %d does not loop back to head\n", _i);
                 exit(1);
@@ -548,22 +543,18 @@ split(BoxNode *node) {
         for (_i = 0; _i < 3; _i++) {
             for (_nextCount[_i] = 0, _nextTest = node->head[_i];
                  _nextTest && _nextTest->next[_i];
-                 _nextTest = _nextTest->next[_i], _nextCount[_i]++)
-                ;
+                 _nextTest = _nextTest->next[_i], _nextCount[_i]++);
             for (_prevCount[_i] = 0, _prevTest = node->tail[_i];
                  _prevTest && _prevTest->prev[_i];
-                 _prevTest = _prevTest->prev[_i], _prevCount[_i]++)
-                ;
+                 _prevTest = _prevTest->prev[_i], _prevCount[_i]++);
             if (_nextTest != node->tail[_i]) {
                 printf("next-list of axis %d does not end at tail\n", _i);
             }
             if (_prevTest != node->head[_i]) {
                 printf("prev-list of axis %d does not end at head\n", _i);
             }
-            for (; _nextTest && _nextTest->prev[_i]; _nextTest = _nextTest->prev[_i])
-                ;
-            for (; _prevTest && _prevTest->next[_i]; _prevTest = _prevTest->next[_i])
-                ;
+            for (; _nextTest && _nextTest->prev[_i]; _nextTest = _nextTest->prev[_i]);
+            for (; _prevTest && _prevTest->next[_i]; _prevTest = _prevTest->next[_i]);
             if (_nextTest != node->head[_i]) {
                 printf("next-list of axis %d does not loop back to head\n", _i);
             }
@@ -668,8 +659,7 @@ median_cut(PixelList *hl[3], uint32_t imPixelCount, int nPixels) {
         return NULL;
     }
     for (i = 0; i < 3; i++) {
-        for (tl[i] = hl[i]; tl[i] && tl[i]->next[i]; tl[i] = tl[i]->next[i])
-            ;
+        for (tl[i] = hl[i]; tl[i] && tl[i]->next[i]; tl[i] = tl[i]->next[i]);
         root->head[i] = hl[i];
         root->tail[i] = tl[i];
     }
@@ -832,16 +822,9 @@ build_distance_tables(
     }
     for (i = 0; i < nEntries; i++) {
         for (j = 0; j < nEntries; j++) {
-            dwi[j] = (DistanceWithIndex){
-                &(avgDist[i * nEntries + j]),
-                j
-            };
+            dwi[j] = (DistanceWithIndex){&(avgDist[i * nEntries + j]), j};
         }
-        qsort(
-            dwi,
-            nEntries,
-            sizeof(DistanceWithIndex),
-            _distance_index_cmp);
+        qsort(dwi, nEntries, sizeof(DistanceWithIndex), _distance_index_cmp);
         for (j = 0; j < nEntries; j++) {
             avgDistSortKey[i * nEntries + j] = dwi[j].distance;
         }
@@ -1213,7 +1196,7 @@ k_means(
             compute_palette_from_quantized_pixels(
                 pixelData, nPixels, paletteData, nPaletteEntries, avg, count, qp);
             if (!build_distance_tables(
-                avgDist, avgDistSortKey, paletteData, nPaletteEntries)) {
+                    avgDist, avgDistSortKey, paletteData, nPaletteEntries)) {
                 goto error_3;
             }
             built = 1;
@@ -1452,15 +1435,17 @@ quantize(
                 hashtable_insert(h2, pixelData[i], bestmatch);
             }
             if (qp[i] != bestmatch) {
-                printf ("discrepancy in matching algorithms pixel %d [%d %d] %f %f\n",
-                    i,qp[i],bestmatch,
-                    sqrt((double)(_SQR(pixelData[i].c.r-p[qp[i]].c.r)+
-                                  _SQR(pixelData[i].c.g-p[qp[i]].c.g)+
-                                  _SQR(pixelData[i].c.b-p[qp[i]].c.b))),
-                    sqrt((double)(_SQR(pixelData[i].c.r-p[bestmatch].c.r)+
-                                  _SQR(pixelData[i].c.g-p[bestmatch].c.g)+
-                                  _SQR(pixelData[i].c.b-p[bestmatch].c.b)))
-                   );
+                printf(
+                    "discrepancy in matching algorithms pixel %d [%d %d] %f %f\n",
+                    i,
+                    qp[i],
+                    bestmatch,
+                    sqrt((double)(_SQR(pixelData[i].c.r - p[qp[i]].c.r) +
+                                  _SQR(pixelData[i].c.g - p[qp[i]].c.g) +
+                                  _SQR(pixelData[i].c.b - p[qp[i]].c.b))),
+                    sqrt((double)(_SQR(pixelData[i].c.r - p[bestmatch].c.r) +
+                                  _SQR(pixelData[i].c.g - p[bestmatch].c.g) +
+                                  _SQR(pixelData[i].c.b - p[bestmatch].c.b))));
             }
         }
         hashtable_free(h2);
diff --git a/src/libImaging/QuantOctree.c b/src/libImaging/QuantOctree.c
index 5e79bce358a..1331a30ad45 100644
--- a/src/libImaging/QuantOctree.c
+++ b/src/libImaging/QuantOctree.c
@@ -38,7 +38,7 @@ typedef struct _ColorBucket {
     uint64_t g;
     uint64_t b;
     uint64_t a;
-} * ColorBucket;
+} *ColorBucket;
 
 typedef struct _ColorCube {
     unsigned int rBits, gBits, bBits, aBits;
@@ -47,7 +47,7 @@ typedef struct _ColorCube {
 
     unsigned long size;
     ColorBucket buckets;
-} * ColorCube;
+} *ColorCube;
 
 #define MAX(a, b) (a) > (b) ? (a) : (b)
 
diff --git a/src/libImaging/Reduce.c b/src/libImaging/Reduce.c
index 60928d2bc36..61566f0c506 100644
--- a/src/libImaging/Reduce.c
+++ b/src/libImaging/Reduce.c
@@ -2,7 +2,7 @@
 
 #include <math.h>
 
-#define ROUND_UP(f) ((int)((f) >= 0.0 ? (f) + 0.5F : (f)-0.5F))
+#define ROUND_UP(f) ((int)((f) >= 0.0 ? (f) + 0.5F : (f) - 0.5F))
 
 UINT32
 division_UINT32(int divider, int result_bits) {
diff --git a/src/libImaging/Resample.c b/src/libImaging/Resample.c
index cf79d8a4e4d..59c27b3f421 100644
--- a/src/libImaging/Resample.c
+++ b/src/libImaging/Resample.c
@@ -2,7 +2,7 @@
 
 #include <math.h>
 
-#define ROUND_UP(f) ((int)((f) >= 0.0 ? (f) + 0.5F : (f)-0.5F))
+#define ROUND_UP(f) ((int)((f) >= 0.0 ? (f) + 0.5F : (f) - 0.5F))
 
 struct filter {
     double (*filter)(double x);
diff --git a/src/libImaging/SgiRleDecode.c b/src/libImaging/SgiRleDecode.c
index 4eef44ba510..89dedb5252f 100644
--- a/src/libImaging/SgiRleDecode.c
+++ b/src/libImaging/SgiRleDecode.c
@@ -113,7 +113,8 @@ expandrow(UINT8 *dest, UINT8 *src, int n, int z, int xsize, UINT8 *end_of_buffer
 }
 
 static int
-expandrow2(UINT8 *dest, const UINT8 *src, int n, int z, int xsize, UINT8 *end_of_buffer) {
+expandrow2(
+    UINT8 *dest, const UINT8 *src, int n, int z, int xsize, UINT8 *end_of_buffer) {
     UINT8 pixel, count;
     int x = 0;
 
@@ -197,7 +198,6 @@ ImagingSgiRleDecode(Imaging im, ImagingCodecState state, UINT8 *buf, Py_ssize_t
         return -1;
     }
 
-
     /* decoder initialization */
     state->count = 0;
     state->y = 0;
@@ -252,7 +252,7 @@ ImagingSgiRleDecode(Imaging im, ImagingCodecState state, UINT8 *buf, Py_ssize_t
                     c->rlelength,
                     im->bands,
                     im->xsize,
-                    &ptr[c->bufsize-1]);
+                    &ptr[c->bufsize - 1]);
             } else {
                 status = expandrow2(
                     &state->buffer[c->channo * 2],
@@ -260,7 +260,7 @@ ImagingSgiRleDecode(Imaging im, ImagingCodecState state, UINT8 *buf, Py_ssize_t
                     c->rlelength,
                     im->bands,
                     im->xsize,
-                    &ptr[c->bufsize-1]);
+                    &ptr[c->bufsize - 1]);
             }
             if (status == -1) {
                 state->errcode = IMAGING_CODEC_OVERRUN;
@@ -268,7 +268,6 @@ ImagingSgiRleDecode(Imaging im, ImagingCodecState state, UINT8 *buf, Py_ssize_t
             } else if (status == 1) {
                 goto sgi_finish_decode;
             }
-
         }
 
         /* store decompressed data in image */
diff --git a/src/libImaging/Storage.c b/src/libImaging/Storage.c
index b1b03c515ad..b27195a3587 100644
--- a/src/libImaging/Storage.c
+++ b/src/libImaging/Storage.c
@@ -418,9 +418,8 @@ ImagingAllocateArray(Imaging im, int dirty, int block_size) {
             }
             im->blocks[current_block] = block;
             /* Bulletproof code from libc _int_memalign */
-            aligned_ptr = (char *)(
-                ((size_t) (block.ptr + arena->alignment - 1)) &
-                -((Py_ssize_t) arena->alignment));
+            aligned_ptr = (char *)(((size_t)(block.ptr + arena->alignment - 1)) &
+                                   -((Py_ssize_t)arena->alignment));
         }
 
         im->image[y] = aligned_ptr + aligned_linesize * line_in_block;
diff --git a/src/libImaging/TiffDecode.c b/src/libImaging/TiffDecode.c
index e3b81590ec2..858de9332f5 100644
--- a/src/libImaging/TiffDecode.c
+++ b/src/libImaging/TiffDecode.c
@@ -60,7 +60,11 @@ _tiffReadProc(thandle_t hdata, tdata_t buf, tsize_t size) {
     dump_state(state);
 
     if (state->loc > state->eof) {
-        TIFFError("_tiffReadProc", "Invalid Read at loc %" PRIu64 ", eof: %" PRIu64, state->loc, state->eof);
+        TIFFError(
+            "_tiffReadProc",
+            "Invalid Read at loc %" PRIu64 ", eof: %" PRIu64,
+            state->loc,
+            state->eof);
         return 0;
     }
     to_read = min(size, min(state->size, (tsize_t)state->eof) - (tsize_t)state->loc);
@@ -217,7 +221,12 @@ ImagingLibTiffInit(ImagingCodecState state, int fp, uint32_t offset) {
 }
 
 int
-_pickUnpackers(Imaging im, ImagingCodecState state, TIFF *tiff, uint16_t planarconfig, ImagingShuffler *unpackers) {
+_pickUnpackers(
+    Imaging im,
+    ImagingCodecState state,
+    TIFF *tiff,
+    uint16_t planarconfig,
+    ImagingShuffler *unpackers) {
     // if number of bands is 1, there is no difference with contig case
     if (planarconfig == PLANARCONFIG_SEPARATE && im->bands > 1) {
         uint16_t bits_per_sample = 8;
@@ -232,10 +241,14 @@ _pickUnpackers(Imaging im, ImagingCodecState state, TIFF *tiff, uint16_t planarc
         // We'll pick appropriate set of unpackers depending on planar_configuration
         // It does not matter if data is RGB(A), CMYK or LUV really,
         // we just copy it plane by plane
-        unpackers[0] = ImagingFindUnpacker("RGBA", bits_per_sample == 16 ? "R;16N" : "R", NULL);
-        unpackers[1] = ImagingFindUnpacker("RGBA", bits_per_sample == 16 ? "G;16N" : "G", NULL);
-        unpackers[2] = ImagingFindUnpacker("RGBA", bits_per_sample == 16 ? "B;16N" : "B", NULL);
-        unpackers[3] = ImagingFindUnpacker("RGBA", bits_per_sample == 16 ? "A;16N" : "A", NULL);
+        unpackers[0] =
+            ImagingFindUnpacker("RGBA", bits_per_sample == 16 ? "R;16N" : "R", NULL);
+        unpackers[1] =
+            ImagingFindUnpacker("RGBA", bits_per_sample == 16 ? "G;16N" : "G", NULL);
+        unpackers[2] =
+            ImagingFindUnpacker("RGBA", bits_per_sample == 16 ? "B;16N" : "B", NULL);
+        unpackers[3] =
+            ImagingFindUnpacker("RGBA", bits_per_sample == 16 ? "A;16N" : "A", NULL);
 
         return im->bands;
     } else {
@@ -247,10 +260,10 @@ _pickUnpackers(Imaging im, ImagingCodecState state, TIFF *tiff, uint16_t planarc
 
 int
 _decodeAsRGBA(Imaging im, ImagingCodecState state, TIFF *tiff) {
-    // To avoid dealing with YCbCr subsampling and other complications, let libtiff handle it
-    // Use a TIFFRGBAImage wrapping the tiff image, and let libtiff handle
-    // all of the conversion. Metadata read from the TIFFRGBAImage could
-    // be different from the metadata that the base tiff returns.
+    // To avoid dealing with YCbCr subsampling and other complications, let libtiff
+    // handle it Use a TIFFRGBAImage wrapping the tiff image, and let libtiff handle all
+    // of the conversion. Metadata read from the TIFFRGBAImage could be different from
+    // the metadata that the base tiff returns.
 
     INT32 current_row;
     UINT8 *new_data;
@@ -259,17 +272,16 @@ _decodeAsRGBA(Imaging im, ImagingCodecState state, TIFF *tiff) {
     TIFFRGBAImage img;
     char emsg[1024] = "";
 
-    // Since using TIFFRGBAImage* functions, we can read whole tiff into rastrr in one call
-    // Let's select smaller block size. Multiplying image width by (tile length OR rows per strip)
-    // gives us manageable block size in pixels
+    // Since using TIFFRGBAImage* functions, we can read whole tiff into rastrr in one
+    // call Let's select smaller block size. Multiplying image width by (tile length OR
+    // rows per strip) gives us manageable block size in pixels
     if (TIFFIsTiled(tiff)) {
         ret = TIFFGetFieldDefaulted(tiff, TIFFTAG_TILELENGTH, &rows_per_block);
-    }
-    else {
+    } else {
         ret = TIFFGetFieldDefaulted(tiff, TIFFTAG_ROWSPERSTRIP, &rows_per_block);
     }
 
-    if (ret != 1 || rows_per_block==(UINT32)(-1)) {
+    if (ret != 1 || rows_per_block == (UINT32)(-1)) {
         rows_per_block = state->ysize;
     }
 
@@ -357,7 +369,12 @@ _decodeAsRGBA(Imaging im, ImagingCodecState state, TIFF *tiff) {
 }
 
 int
-_decodeTile(Imaging im, ImagingCodecState state, TIFF *tiff, int planes, ImagingShuffler *unpackers) {
+_decodeTile(
+    Imaging im,
+    ImagingCodecState state,
+    TIFF *tiff,
+    int planes,
+    ImagingShuffler *unpackers) {
     INT32 x, y, tile_y, current_tile_length, current_tile_width;
     UINT32 tile_width, tile_length;
     tsize_t tile_bytes_size, row_byte_size;
@@ -396,7 +413,8 @@ _decodeTile(Imaging im, ImagingCodecState state, TIFF *tiff, int planes, Imaging
 
     if (tile_bytes_size > ((tile_length * state->bits / planes + 7) / 8) * tile_width) {
         // If the tile size as expected by LibTiff isn't what we're expecting, abort.
-        // man:   TIFFTileSize returns the equivalent size for a tile of data as it would be returned in a
+        // man:   TIFFTileSize returns the equivalent size for a tile of data as it
+        // would be returned in a
         //        call to TIFFReadTile ...
         state->errcode = IMAGING_CODEC_BROKEN;
         return -1;
@@ -428,19 +446,24 @@ _decodeTile(Imaging im, ImagingCodecState state, TIFF *tiff, int planes, Imaging
 
                 TRACE(("Read tile at %dx%d; \n\n", x, y));
 
-                current_tile_width = min((INT32) tile_width, state->xsize - x);
-                current_tile_length =  min((INT32) tile_length, state->ysize - y);
+                current_tile_width = min((INT32)tile_width, state->xsize - x);
+                current_tile_length = min((INT32)tile_length, state->ysize - y);
                 // iterate over each line in the tile and stuff data into image
                 for (tile_y = 0; tile_y < current_tile_length; tile_y++) {
-                    TRACE(("Writing tile data at %dx%d using tile_width: %d; \n", tile_y + y, x, current_tile_width));
+                    TRACE(
+                        ("Writing tile data at %dx%d using tile_width: %d; \n",
+                         tile_y + y,
+                         x,
+                         current_tile_width));
 
                     // UINT8 * bbb = state->buffer + tile_y * row_byte_size;
-                    // TRACE(("chars: %x%x%x%x\n", ((UINT8 *)bbb)[0], ((UINT8 *)bbb)[1], ((UINT8 *)bbb)[2], ((UINT8 *)bbb)[3]));
+                    // TRACE(("chars: %x%x%x%x\n", ((UINT8 *)bbb)[0], ((UINT8 *)bbb)[1],
+                    // ((UINT8 *)bbb)[2], ((UINT8 *)bbb)[3]));
 
-                    shuffler((UINT8*) im->image[tile_y + y] + x * im->pixelsize,
-                             state->buffer + tile_y * row_byte_size,
-                             current_tile_width
-                             );
+                    shuffler(
+                        (UINT8 *)im->image[tile_y + y] + x * im->pixelsize,
+                        state->buffer + tile_y * row_byte_size,
+                        current_tile_width);
                 }
             }
         }
@@ -450,7 +473,12 @@ _decodeTile(Imaging im, ImagingCodecState state, TIFF *tiff, int planes, Imaging
 }
 
 int
-_decodeStrip(Imaging im, ImagingCodecState state, TIFF *tiff, int planes, ImagingShuffler *unpackers) {
+_decodeStrip(
+    Imaging im,
+    ImagingCodecState state,
+    TIFF *tiff,
+    int planes,
+    ImagingShuffler *unpackers) {
     INT32 strip_row = 0;
     UINT8 *new_data;
     UINT32 rows_per_strip;
@@ -458,7 +486,7 @@ _decodeStrip(Imaging im, ImagingCodecState state, TIFF *tiff, int planes, Imagin
     tsize_t strip_size, row_byte_size, unpacker_row_byte_size;
 
     ret = TIFFGetField(tiff, TIFFTAG_ROWSPERSTRIP, &rows_per_strip);
-    if (ret != 1 || rows_per_strip==(UINT32)(-1)) {
+    if (ret != 1 || rows_per_strip == (UINT32)(-1)) {
         rows_per_strip = state->ysize;
     }
 
@@ -478,7 +506,8 @@ _decodeStrip(Imaging im, ImagingCodecState state, TIFF *tiff, int planes, Imagin
     unpacker_row_byte_size = (state->xsize * state->bits / planes + 7) / 8;
     if (strip_size > (unpacker_row_byte_size * rows_per_strip)) {
         // If the strip size as expected by LibTiff isn't what we're expecting, abort.
-        // man:   TIFFStripSize returns the equivalent size for a strip of data as it would be returned in a
+        // man:   TIFFStripSize returns the equivalent size for a strip of data as it
+        // would be returned in a
         //        call to TIFFReadEncodedStrip ...
         state->errcode = IMAGING_CODEC_BROKEN;
         return -1;
@@ -513,8 +542,13 @@ _decodeStrip(Imaging im, ImagingCodecState state, TIFF *tiff, int planes, Imagin
         int plane;
         for (plane = 0; plane < planes; plane++) {
             ImagingShuffler shuffler = unpackers[plane];
-            if (TIFFReadEncodedStrip(tiff, TIFFComputeStrip(tiff, state->y, plane), (tdata_t)state->buffer, strip_size) == -1) {
-                TRACE(("Decode Error, strip %d\n", TIFFComputeStrip(tiff, state->y, 0)));
+            if (TIFFReadEncodedStrip(
+                    tiff,
+                    TIFFComputeStrip(tiff, state->y, plane),
+                    (tdata_t)state->buffer,
+                    strip_size) == -1) {
+                TRACE(
+                    ("Decode Error, strip %d\n", TIFFComputeStrip(tiff, state->y, 0)));
                 state->errcode = IMAGING_CODEC_BROKEN;
                 return -1;
             }
@@ -523,16 +557,17 @@ _decodeStrip(Imaging im, ImagingCodecState state, TIFF *tiff, int planes, Imagin
 
             // iterate over each row in the strip and stuff data into image
             for (strip_row = 0;
-                 strip_row < min((INT32) rows_per_strip, state->ysize - state->y);
+                 strip_row < min((INT32)rows_per_strip, state->ysize - state->y);
                  strip_row++) {
                 TRACE(("Writing data into line %d ; \n", state->y + strip_row));
 
-                // UINT8 * bbb = state->buffer + strip_row * (state->bytes / rows_per_strip);
-                // TRACE(("chars: %x %x %x %x\n", ((UINT8 *)bbb)[0], ((UINT8 *)bbb)[1], ((UINT8 *)bbb)[2], ((UINT8 *)bbb)[3]));
+                // UINT8 * bbb = state->buffer + strip_row * (state->bytes /
+                // rows_per_strip); TRACE(("chars: %x %x %x %x\n", ((UINT8 *)bbb)[0],
+                // ((UINT8 *)bbb)[1], ((UINT8 *)bbb)[2], ((UINT8 *)bbb)[3]));
 
                 shuffler(
-                    (UINT8*) im->image[state->y + state->yoff + strip_row] +
-                    state->xoff * im->pixelsize,
+                    (UINT8 *)im->image[state->y + state->yoff + strip_row] +
+                        state->xoff * im->pixelsize,
                     state->buffer + strip_row * row_byte_size,
                     state->xsize);
             }
@@ -666,7 +701,6 @@ ImagingLibTiffDecode(
         goto decode_err;
     }
 
-
     TIFFGetField(tiff, TIFFTAG_PHOTOMETRIC, &photometric);
     TIFFGetField(tiff, TIFFTAG_COMPRESSION, &compression);
     TIFFGetFieldDefaulted(tiff, TIFFTAG_PLANARCONFIG, &planarconfig);
@@ -675,16 +709,17 @@ ImagingLibTiffDecode(
     // Let LibTiff read them as RGBA
     readAsRGBA = photometric == PHOTOMETRIC_YCBCR;
 
-    if (readAsRGBA && compression == COMPRESSION_JPEG && planarconfig == PLANARCONFIG_CONTIG) {
-        // If using new JPEG compression, let libjpeg do RGB conversion for performance reasons
+    if (readAsRGBA && compression == COMPRESSION_JPEG &&
+        planarconfig == PLANARCONFIG_CONTIG) {
+        // If using new JPEG compression, let libjpeg do RGB conversion for performance
+        // reasons
         TIFFSetField(tiff, TIFFTAG_JPEGCOLORMODE, JPEGCOLORMODE_RGB);
         readAsRGBA = 0;
     }
 
     if (readAsRGBA) {
         _decodeAsRGBA(im, state, tiff);
-    }
-    else {
+    } else {
         planes = _pickUnpackers(im, state, tiff, planarconfig, unpackers);
         if (planes <= 0) {
             goto decode_err;
@@ -692,8 +727,7 @@ ImagingLibTiffDecode(
 
         if (TIFFIsTiled(tiff)) {
             _decodeTile(im, state, tiff, planes, unpackers);
-        }
-        else {
+        } else {
             _decodeStrip(im, state, tiff, planes, unpackers);
         }
 
@@ -702,20 +736,20 @@ ImagingLibTiffDecode(
             // so we have to convert it to RGBA
             if (planes > 3 && strcmp(im->mode, "RGBA") == 0) {
                 uint16_t extrasamples;
-                uint16_t* sampleinfo;
+                uint16_t *sampleinfo;
                 ImagingShuffler shuffle;
                 INT32 y;
 
-                TIFFGetFieldDefaulted(tiff, TIFFTAG_EXTRASAMPLES, &extrasamples, &sampleinfo);
+                TIFFGetFieldDefaulted(
+                    tiff, TIFFTAG_EXTRASAMPLES, &extrasamples, &sampleinfo);
 
-                if (extrasamples >= 1 &&
-                    (sampleinfo[0] == EXTRASAMPLE_UNSPECIFIED || sampleinfo[0] == EXTRASAMPLE_ASSOCALPHA)
-                    ) {
+                if (extrasamples >= 1 && (sampleinfo[0] == EXTRASAMPLE_UNSPECIFIED ||
+                                          sampleinfo[0] == EXTRASAMPLE_ASSOCALPHA)) {
                     shuffle = ImagingFindUnpacker("RGBA", "RGBa", NULL);
 
                     for (y = state->yoff; y < state->ysize; y++) {
-                        UINT8* ptr = (UINT8*) im->image[y + state->yoff] +
-                            state->xoff * im->pixelsize;
+                        UINT8 *ptr = (UINT8 *)im->image[y + state->yoff] +
+                                     state->xoff * im->pixelsize;
                         shuffle(ptr, ptr, state->xsize);
                     }
                 }
@@ -723,7 +757,7 @@ ImagingLibTiffDecode(
         }
     }
 
- decode_err:
+decode_err:
     // TIFFClose in libtiff calls tif_closeproc and TIFFCleanup
     if (clientstate->fp) {
         // Pillow will manage the closing of the file rather than libtiff
diff --git a/src/libImaging/TiffDecode.h b/src/libImaging/TiffDecode.h
index 02454ba0396..212b7dee6b0 100644
--- a/src/libImaging/TiffDecode.h
+++ b/src/libImaging/TiffDecode.h
@@ -30,7 +30,7 @@ typedef struct {
                    * Should be uint32 for libtiff 3.9.x
                    * uint64 for libtiff 4.0.x
                    */
-    TIFF *tiff; /* Used in write */
+    TIFF *tiff;   /* Used in write */
     toff_t eof;
     int flrealloc; /* may we realloc */
 } TIFFSTATE;
diff --git a/src/libImaging/Unpack.c b/src/libImaging/Unpack.c
index e351aa2f19b..1b84cd68f85 100644
--- a/src/libImaging/Unpack.c
+++ b/src/libImaging/Unpack.c
@@ -1437,90 +1437,90 @@ band3I(UINT8 *out, const UINT8 *in, int pixels) {
 }
 
 static void
-band016B(UINT8* out, const UINT8* in, int pixels)
-{
+band016B(UINT8 *out, const UINT8 *in, int pixels) {
     int i;
     /* band 0 only, big endian */
     for (i = 0; i < pixels; i++) {
         out[0] = in[0];
-        out += 4; in += 2;
+        out += 4;
+        in += 2;
     }
 }
 
 static void
-band116B(UINT8* out, const UINT8* in, int pixels)
-{
+band116B(UINT8 *out, const UINT8 *in, int pixels) {
     int i;
     /* band 1 only, big endian */
     for (i = 0; i < pixels; i++) {
         out[1] = in[0];
-        out += 4; in += 2;
+        out += 4;
+        in += 2;
     }
 }
 
 static void
-band216B(UINT8* out, const UINT8* in, int pixels)
-{
+band216B(UINT8 *out, const UINT8 *in, int pixels) {
     int i;
     /* band 2 only, big endian */
     for (i = 0; i < pixels; i++) {
         out[2] = in[0];
-        out += 4; in += 2;
+        out += 4;
+        in += 2;
     }
 }
 
 static void
-band316B(UINT8* out, const UINT8* in, int pixels)
-{
+band316B(UINT8 *out, const UINT8 *in, int pixels) {
     int i;
     /* band 3 only, big endian */
     for (i = 0; i < pixels; i++) {
         out[3] = in[0];
-        out += 4; in += 2;
+        out += 4;
+        in += 2;
     }
 }
 
 static void
-band016L(UINT8* out, const UINT8* in, int pixels)
-{
+band016L(UINT8 *out, const UINT8 *in, int pixels) {
     int i;
     /* band 0 only, little endian */
     for (i = 0; i < pixels; i++) {
         out[0] = in[1];
-        out += 4; in += 2;
+        out += 4;
+        in += 2;
     }
 }
 
 static void
-band116L(UINT8* out, const UINT8* in, int pixels)
-{
+band116L(UINT8 *out, const UINT8 *in, int pixels) {
     int i;
     /* band 1 only, little endian */
     for (i = 0; i < pixels; i++) {
         out[1] = in[1];
-        out += 4; in += 2;
+        out += 4;
+        in += 2;
     }
 }
 
 static void
-band216L(UINT8* out, const UINT8* in, int pixels)
-{
+band216L(UINT8 *out, const UINT8 *in, int pixels) {
     int i;
     /* band 2 only, little endian */
     for (i = 0; i < pixels; i++) {
         out[2] = in[1];
-        out += 4; in += 2;
+        out += 4;
+        in += 2;
     }
 }
 
 static void
-band316L(UINT8* out, const UINT8* in, int pixels)
-{
+band316L(UINT8 *out, const UINT8 *in, int pixels) {
     int i;
     /* band 3 only, little endian */
     for (i = 0; i < pixels; i++) {
         out[3] = in[1];
-        out += 4; in += 2;
+        out += 4;
+        in += 2;
     }
 }
 
@@ -1687,7 +1687,6 @@ static struct {
     {"RGB", "G;16N", 16, band116L},
     {"RGB", "B;16N", 16, band216L},
 
-
     {"RGBA", "R;16N", 16, band016L},
     {"RGBA", "G;16N", 16, band116L},
     {"RGBA", "B;16N", 16, band216L},
diff --git a/src/path.c b/src/path.c
index cc0698c4d2a..6bc90abed86 100644
--- a/src/path.c
+++ b/src/path.c
@@ -162,24 +162,24 @@ PyPath_Flatten(PyObject *data, double **pxy) {
         return -1;
     }
 
-#define assign_item_to_array(op, decref) \
-if (PyFloat_Check(op)) { \
-    xy[j++] = PyFloat_AS_DOUBLE(op); \
-} else if (PyLong_Check(op)) { \
-    xy[j++] = (float)PyLong_AS_LONG(op); \
-} else if (PyNumber_Check(op)) { \
-    xy[j++] = PyFloat_AsDouble(op); \
-} else if (PyArg_ParseTuple(op, "dd", &x, &y)) { \
-    xy[j++] = x; \
-    xy[j++] = y; \
-} else { \
-    PyErr_SetString(PyExc_ValueError, "incorrect coordinate type"); \
-    if (decref) { \
-        Py_DECREF(op); \
-    } \
-    free(xy); \
-    return -1; \
-}
+#define assign_item_to_array(op, decref)                                \
+    if (PyFloat_Check(op)) {                                            \
+        xy[j++] = PyFloat_AS_DOUBLE(op);                                \
+    } else if (PyLong_Check(op)) {                                      \
+        xy[j++] = (float)PyLong_AS_LONG(op);                            \
+    } else if (PyNumber_Check(op)) {                                    \
+        xy[j++] = PyFloat_AsDouble(op);                                 \
+    } else if (PyArg_ParseTuple(op, "dd", &x, &y)) {                    \
+        xy[j++] = x;                                                    \
+        xy[j++] = y;                                                    \
+    } else {                                                            \
+        PyErr_SetString(PyExc_ValueError, "incorrect coordinate type"); \
+        if (decref) {                                                   \
+            Py_DECREF(op);                                              \
+        }                                                               \
+        free(xy);                                                       \
+        return -1;                                                      \
+    }
 
     /* Copy table to path array */
     if (PyList_Check(data)) {

From 0099de0ed904c2021850fbb5a19908c36f908890 Mon Sep 17 00:00:00 2001
From: Hugo van Kemenade <1324225+hugovk@users.noreply.github.com>
Date: Thu, 25 Apr 2024 16:00:14 +0300
Subject: [PATCH 0574/1178] Add deprecation helper for Image.new with BGR;
 modes

---
 Tests/test_image.py | 33 +++++++++++++--------------------
 1 file changed, 13 insertions(+), 20 deletions(-)

diff --git a/Tests/test_image.py b/Tests/test_image.py
index ed80be503fb..e8339424d99 100644
--- a/Tests/test_image.py
+++ b/Tests/test_image.py
@@ -63,14 +63,19 @@
 image_mode_names = [name for name, _ in image_modes]
 
 
+# Deprecation helper
+def helper_image_new(mode: str, size: tuple[int, int]) -> Image.Image:
+    if mode.startswith("BGR;"):
+        with pytest.warns(DeprecationWarning):
+            return Image.new(mode, size)
+    else:
+        return Image.new(mode, size)
+
+
 class TestImage:
     @pytest.mark.parametrize("mode", image_mode_names)
     def test_image_modes_success(self, mode: str) -> None:
-        if mode.startswith("BGR;"):
-            with pytest.warns(DeprecationWarning):
-                Image.new(mode, (1, 1))
-        else:
-            Image.new(mode, (1, 1))
+        helper_image_new(mode, (1, 1))
 
     @pytest.mark.parametrize("mode", ("", "bad", "very very long"))
     def test_image_modes_fail(self, mode: str) -> None:
@@ -1066,29 +1071,17 @@ def test_roundtrip_bytes_method(self, mode: str) -> None:
         im = hopper(mode)
         source_bytes = im.tobytes()
 
-        if mode.startswith("BGR;"):
-            with pytest.warns(DeprecationWarning):
-                reloaded = Image.new(mode, im.size)
-        else:
-            reloaded = Image.new(mode, im.size)
+        reloaded = helper_image_new(mode, im.size)
         reloaded.frombytes(source_bytes)
         assert reloaded.tobytes() == source_bytes
 
     @pytest.mark.parametrize(("mode", "pixelsize"), image_modes)
     def test_getdata_putdata(self, mode: str, pixelsize: int) -> None:
-        if mode.startswith("BGR;"):
-            with pytest.warns(DeprecationWarning):
-                im = Image.new(mode, (2, 2))
-        else:
-            im = Image.new(mode, (2, 2))
+        im = helper_image_new(mode, (2, 2))
         source_bytes = bytes(range(im.width * im.height * pixelsize))
         im.frombytes(source_bytes)
 
-        if mode.startswith("BGR;"):
-            with pytest.warns(DeprecationWarning):
-                reloaded = Image.new(mode, im.size)
-        else:
-            reloaded = Image.new(mode, im.size)
+        reloaded = helper_image_new(mode, im.size)
         reloaded.putdata(im.getdata())
         assert_image_equal(im, reloaded)
 

From a4080a72494042183cff6fbadeba3026fb6fa711 Mon Sep 17 00:00:00 2001
From: Yay295 <Yay295@gmail.com>
Date: Thu, 25 Apr 2024 08:51:33 -0500
Subject: [PATCH 0575/1178] clean up comments in test_image_access.py

---
 Tests/test_image_access.py | 40 +++++++++++++-------------------------
 1 file changed, 14 insertions(+), 26 deletions(-)

diff --git a/Tests/test_image_access.py b/Tests/test_image_access.py
index 50afb2a2368..2cd2e0c34e5 100644
--- a/Tests/test_image_access.py
+++ b/Tests/test_image_access.py
@@ -33,7 +33,7 @@
 
 
 class AccessTest:
-    # initial value
+    # Initial value
     _init_cffi_access = Image.USE_CFFI_ACCESS
     _need_cffi_access = False
 
@@ -151,7 +151,7 @@ def check(self, mode: str, expected_color_int: int | None = None) -> None:
             self.color(mode) if expected_color_int is None else expected_color_int
         )
 
-        # check putpixel
+        # Check putpixel
         im = Image.new(mode, (1, 1), None)
         im.putpixel((0, 0), expected_color)
         actual_color = im.getpixel((0, 0))
@@ -160,7 +160,7 @@ def check(self, mode: str, expected_color_int: int | None = None) -> None:
             f"expected {expected_color} got {actual_color}"
         )
 
-        # check putpixel negative index
+        # Check putpixel negative index
         im.putpixel((-1, -1), expected_color)
         actual_color = im.getpixel((-1, -1))
         assert actual_color == expected_color, (
@@ -168,7 +168,7 @@ def check(self, mode: str, expected_color_int: int | None = None) -> None:
             f"expected {expected_color} got {actual_color}"
         )
 
-        # check 0x0 image with None initial color
+        # Check 0x0 image with None initial color
         im = Image.new(mode, (0, 0), None)
         assert im.load() is not None
         error = ValueError if self._need_cffi_access else IndexError
@@ -176,13 +176,13 @@ def check(self, mode: str, expected_color_int: int | None = None) -> None:
             im.putpixel((0, 0), expected_color)
         with pytest.raises(error):
             im.getpixel((0, 0))
-        # check negative index
+        # Check negative index
         with pytest.raises(error):
             im.putpixel((-1, -1), expected_color)
         with pytest.raises(error):
             im.getpixel((-1, -1))
 
-        # check initial color
+        # Check initial color
         im = Image.new(mode, (1, 1), expected_color)
         actual_color = im.getpixel((0, 0))
         assert actual_color == expected_color, (
@@ -190,18 +190,18 @@ def check(self, mode: str, expected_color_int: int | None = None) -> None:
             f"expected {expected_color} got {actual_color}"
         )
 
-        # check initial color negative index
+        # Check initial color negative index
         actual_color = im.getpixel((-1, -1))
         assert actual_color == expected_color, (
             f"initial color failed with negative index for mode {mode}, "
             f"expected {expected_color} got {actual_color}"
         )
 
-        # check 0x0 image with initial color
+        # Check 0x0 image with initial color
         im = Image.new(mode, (0, 0), expected_color)
         with pytest.raises(error):
             im.getpixel((0, 0))
-        # check negative index
+        # Check negative index
         with pytest.raises(error):
             im.getpixel((-1, -1))
 
@@ -216,7 +216,7 @@ def test_list(self) -> None:
     @pytest.mark.parametrize("mode", ("I;16", "I;16B"))
     @pytest.mark.parametrize("expected_color", (2**15 - 1, 2**15, 2**15 + 1, 2**16 - 1))
     def test_signedness(self, mode: str, expected_color: int) -> None:
-        # see https://github.com/python-pillow/Pillow/issues/452
+        # See https://github.com/python-pillow/Pillow/issues/452
         # pixelaccess is using signed int* instead of uint*
         self.check(mode, expected_color)
 
@@ -276,13 +276,6 @@ def test_get_vs_c(self) -> None:
                 im = Image.new(mode, (10, 10), 40000)
                 self._test_get_access(im)
 
-        # These don't actually appear to be modes that I can actually make,
-        # as unpack sets them directly into the I mode.
-        # im = Image.new('I;32L', (10, 10), -2**10)
-        # self._test_get_access(im)
-        # im = Image.new('I;32B', (10, 10), 2**10)
-        # self._test_get_access(im)
-
     def _test_set_access(self, im: Image.Image, color: tuple[int, ...] | float) -> None:
         """Are we writing the correct bits into the image?
 
@@ -314,23 +307,18 @@ def test_set_vs_c(self) -> None:
         self._test_set_access(hopper("LA"), (128, 128))
         self._test_set_access(hopper("1"), 255)
         self._test_set_access(hopper("P"), 128)
-        # self._test_set_access(i, (128, 128))  #PA  -- undone how to make
+        self._test_set_access(hopper("PA"), (128, 128))
         self._test_set_access(hopper("F"), 1024.0)
 
         for mode in ("I;16", "I;16L", "I;16B", "I;16N", "I"):
             im = Image.new(mode, (10, 10), 40000)
             self._test_set_access(im, 45000)
 
-        # im = Image.new('I;32L', (10, 10), -(2**10))
-        # self._test_set_access(im, -(2**13)+1)
-        # im = Image.new('I;32B', (10, 10), 2**10)
-        # self._test_set_access(im, 2**13-1)
-
     @pytest.mark.filterwarnings("ignore::DeprecationWarning")
     def test_not_implemented(self) -> None:
         assert PyAccess.new(hopper("BGR;15")) is None
 
-    # ref https://github.com/python-pillow/Pillow/pull/2009
+    # Ref https://github.com/python-pillow/Pillow/pull/2009
     def test_reference_counting(self) -> None:
         size = 10
 
@@ -339,7 +327,7 @@ def test_reference_counting(self) -> None:
             with pytest.warns(DeprecationWarning):
                 px = Image.new("L", (size, 1), 0).load()
             for i in range(size):
-                # pixels can contain garbage if image is released
+                # Pixels can contain garbage if image is released
                 assert px[i, 0] == 0
 
     @pytest.mark.parametrize("mode", ("P", "PA"))
@@ -456,7 +444,7 @@ def test_embeddable(self) -> None:
         env = os.environ.copy()
         env["PATH"] = sys.prefix + ";" + env["PATH"]
 
-        # do not display the Windows Error Reporting dialog
+        # Do not display the Windows Error Reporting dialog
         getattr(ctypes, "windll").kernel32.SetErrorMode(0x0002)
 
         process = subprocess.Popen(["embed_pil.exe"], env=env)

From c0cb417a44ac705e573e56582e7d9979dccf93ec Mon Sep 17 00:00:00 2001
From: Hugo van Kemenade <1324225+hugovk@users.noreply.github.com>
Date: Thu, 25 Apr 2024 21:08:24 +0300
Subject: [PATCH 0576/1178] Add semicolons to fix indent

---
 src/_imagingcms.c | 4 ++--
 1 file changed, 2 insertions(+), 2 deletions(-)

diff --git a/src/_imagingcms.c b/src/_imagingcms.c
index ba8c810057b..dbf7057c572 100644
--- a/src/_imagingcms.c
+++ b/src/_imagingcms.c
@@ -385,7 +385,7 @@ _buildTransform(
             iRenderingIntent,
             cmsFLAGS);
 
-    Py_END_ALLOW_THREADS
+    Py_END_ALLOW_THREADS;
 
         if (!hTransform) {
         PyErr_SetString(PyExc_ValueError, "cannot build transform");
@@ -419,7 +419,7 @@ _buildProofTransform(
             iProofIntent,
             cmsFLAGS);
 
-    Py_END_ALLOW_THREADS
+    Py_END_ALLOW_THREADS;
 
         if (!hTransform) {
         PyErr_SetString(PyExc_ValueError, "cannot build proof transform");

From 1420e725664114680ce72ad5b9542229faa39a0f Mon Sep 17 00:00:00 2001
From: "pre-commit-ci[bot]"
 <66853113+pre-commit-ci[bot]@users.noreply.github.com>
Date: Thu, 25 Apr 2024 18:08:50 +0000
Subject: [PATCH 0577/1178] [pre-commit.ci] auto fixes from pre-commit.com
 hooks

for more information, see https://pre-commit.ci
---
 src/_imagingcms.c | 4 ++--
 1 file changed, 2 insertions(+), 2 deletions(-)

diff --git a/src/_imagingcms.c b/src/_imagingcms.c
index dbf7057c572..1a18525d071 100644
--- a/src/_imagingcms.c
+++ b/src/_imagingcms.c
@@ -387,7 +387,7 @@ _buildTransform(
 
     Py_END_ALLOW_THREADS;
 
-        if (!hTransform) {
+    if (!hTransform) {
         PyErr_SetString(PyExc_ValueError, "cannot build transform");
     }
 
@@ -421,7 +421,7 @@ _buildProofTransform(
 
     Py_END_ALLOW_THREADS;
 
-        if (!hTransform) {
+    if (!hTransform) {
         PyErr_SetString(PyExc_ValueError, "cannot build proof transform");
     }
 

From c3ded3abdaa64d4ba75445b43d09d4fcf3129d73 Mon Sep 17 00:00:00 2001
From: Andrew Murray <radarhere@users.noreply.github.com>
Date: Fri, 26 Apr 2024 09:13:00 +1000
Subject: [PATCH 0578/1178] Update CHANGES.rst [ci skip]

---
 CHANGES.rst | 6 ++++++
 1 file changed, 6 insertions(+)

diff --git a/CHANGES.rst b/CHANGES.rst
index 85dc0b43c24..c5df1f8f7c4 100644
--- a/CHANGES.rst
+++ b/CHANGES.rst
@@ -5,6 +5,12 @@ Changelog (Pillow)
 10.4.0 (unreleased)
 -------------------
 
+- Deprecate BGR;15, BGR;16 and BGR;24 modes #7978
+  [radarhere, hugovk]
+
+- Fix ImagingAccess for I;16N on big-endian #7921
+  [Yay295, radarhere]
+
 - Support reading P mode TIFF images with padding #7996
   [radarhere]
 

From 8cc48b24fe83dc81e6a5e6a83f287d333d74a44f Mon Sep 17 00:00:00 2001
From: Cees Timmerman <CTimmerman@users.noreply.github.com>
Date: Fri, 26 Apr 2024 17:17:44 +0200
Subject: [PATCH 0579/1178] Update ExifTags.py

Fixed typo. No other instances in this repo.
---
 src/PIL/ExifTags.py | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/src/PIL/ExifTags.py b/src/PIL/ExifTags.py
index 60a4d9774ae..39b4aa55262 100644
--- a/src/PIL/ExifTags.py
+++ b/src/PIL/ExifTags.py
@@ -346,7 +346,7 @@ class Interop(IntEnum):
     InteropVersion = 2
     RelatedImageFileFormat = 4096
     RelatedImageWidth = 4097
-    RleatedImageHeight = 4098
+    RelatedImageHeight = 4098
 
 
 class IFD(IntEnum):

From 86fb383739597acafc5e452e38eb3b87370d5eb1 Mon Sep 17 00:00:00 2001
From: Andrew Murray <radarhere@users.noreply.github.com>
Date: Sat, 27 Apr 2024 14:08:36 +1000
Subject: [PATCH 0580/1178] Corrected big-endian check

---
 Tests/test_image.py | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/Tests/test_image.py b/Tests/test_image.py
index b7f81408000..e1490d6a083 100644
--- a/Tests/test_image.py
+++ b/Tests/test_image.py
@@ -1050,7 +1050,7 @@ def test_roundtrip_bytes_method(self, mode: str) -> None:
 
     @pytest.mark.parametrize("mode", modes)
     def test_getdata_putdata(self, mode: str) -> None:
-        if is_big_endian and mode == "BGR;15":
+        if is_big_endian() and mode == "BGR;15":
             pytest.xfail("Known failure of BGR;15 on big-endian")
         im = hopper(mode)
         reloaded = helper_image_new(mode, im.size)

From 39da704c61b4ae5ec9c4117d34a8eda8f058a18e Mon Sep 17 00:00:00 2001
From: Andrew Murray <radarhere@users.noreply.github.com>
Date: Sun, 28 Apr 2024 07:10:15 +1000
Subject: [PATCH 0581/1178] Updated libimagequant to 4.3.1

---
 depends/install_imagequant.sh              | 2 +-
 docs/installation/building-from-source.rst | 2 +-
 2 files changed, 2 insertions(+), 2 deletions(-)

diff --git a/depends/install_imagequant.sh b/depends/install_imagequant.sh
index 973b4374fed..9dd7742ed34 100755
--- a/depends/install_imagequant.sh
+++ b/depends/install_imagequant.sh
@@ -2,7 +2,7 @@
 # install libimagequant
 
 archive_name=libimagequant
-archive_version=4.3.0
+archive_version=4.3.1
 
 archive=$archive_name-$archive_version
 
diff --git a/docs/installation/building-from-source.rst b/docs/installation/building-from-source.rst
index 961312b14ad..7f7dfa6ff24 100644
--- a/docs/installation/building-from-source.rst
+++ b/docs/installation/building-from-source.rst
@@ -68,7 +68,7 @@ Many of Pillow's features require external libraries:
 
 * **libimagequant** provides improved color quantization
 
-  * Pillow has been tested with libimagequant **2.6-4.3**
+  * Pillow has been tested with libimagequant **2.6-4.3.1**
   * Libimagequant is licensed GPLv3, which is more restrictive than
     the Pillow license, therefore we will not be distributing binaries
     with libimagequant support enabled.

From fd8c6a629594968d02b845a4fa2fa52540a86c7e Mon Sep 17 00:00:00 2001
From: Andrew Murray <radarhere@users.noreply.github.com>
Date: Sun, 28 Apr 2024 13:51:32 +1000
Subject: [PATCH 0582/1178] Do not indent goto labels

---
 .clang-format               |  1 +
 src/libImaging/GifEncode.c  | 16 ++++++++--------
 src/libImaging/JpegEncode.c |  2 +-
 3 files changed, 10 insertions(+), 9 deletions(-)

diff --git a/.clang-format b/.clang-format
index be32e6d1a8a..3199e330b96 100644
--- a/.clang-format
+++ b/.clang-format
@@ -9,6 +9,7 @@ BinPackParameters: false
 BreakBeforeBraces: Attach
 ColumnLimit: 88
 DerivePointerAlignment: false
+IndentGotoLabels: false
 IndentWidth: 4
 Language: Cpp
 PointerAlignment: Right
diff --git a/src/libImaging/GifEncode.c b/src/libImaging/GifEncode.c
index 831ce432c31..9e91944fecf 100644
--- a/src/libImaging/GifEncode.c
+++ b/src/libImaging/GifEncode.c
@@ -82,7 +82,7 @@ glzwe(
     UINT32 end_of_data) {
     switch (st->entry_state) {
         case LZW_TRY_IN1:
-        get_first_byte:
+get_first_byte:
             if (!*in_avail) {
                 if (end_of_data) {
                     goto end_of_data;
@@ -94,7 +94,7 @@ glzwe(
             (*in_avail)--;
 
         case LZW_TRY_IN2:
-        encode_loop:
+encode_loop:
             if (!*in_avail) {
                 if (end_of_data) {
                     st->code = st->head;
@@ -127,7 +127,7 @@ glzwe(
             st->code = st->head;
             st->put_state = PUT_HEAD;
             goto put_code;
-        insert_code_or_clear: /* jump here after put_code */
+insert_code_or_clear: /* jump here after put_code */
             if (st->next_code < CODE_LIMIT) {
                 st->codes[st->probe] =
                     (st->next_code << 20) | (st->head << 8) | st->tail;
@@ -140,7 +140,7 @@ glzwe(
                 st->code = st->clear_code;
                 st->put_state = PUT_CLEAR;
                 goto put_code;
-            reset_after_clear: /* jump here after put_code */
+reset_after_clear: /* jump here after put_code */
                 glzwe_reset(st);
             }
             st->head = st->tail;
@@ -150,9 +150,9 @@ glzwe(
             glzwe_reset(st);
             st->code = st->clear_code;
             st->put_state = PUT_INIT_CLEAR;
-        put_code:
+put_code:
             st->code_bits_left = st->code_width;
-        check_buf_bits:
+check_buf_bits:
             if (!st->buf_bits_left) { /* out buffer full */
 
                 case LZW_TRY_OUT1:
@@ -190,11 +190,11 @@ glzwe(
                     return GLZW_INTERNAL_ERROR;
             }
 
-        end_of_data:
+end_of_data:
             st->code = st->end_code;
             st->put_state = PUT_END;
             goto put_code;
-        flush_code_buffer: /* jump here after put_code */
+flush_code_buffer: /* jump here after put_code */
             if (st->buf_bits_left < 8) {
                 case LZW_TRY_OUT2:
                     if (!*out_avail) {
diff --git a/src/libImaging/JpegEncode.c b/src/libImaging/JpegEncode.c
index bcbe65aa4d6..ba8353c2d86 100644
--- a/src/libImaging/JpegEncode.c
+++ b/src/libImaging/JpegEncode.c
@@ -346,7 +346,7 @@ ImagingJpegEncode(Imaging im, ImagingCodecState state, UINT8 *buf, int bytes) {
             }
             jpeg_finish_compress(&context->cinfo);
 
-        cleanup:
+cleanup:
             /* Clean up */
             if (context->comment) {
                 free(context->comment);

From 5597f618a3b5cf8e208dded44a2107313c47122d Mon Sep 17 00:00:00 2001
From: Hugo van Kemenade <1324225+hugovk@users.noreply.github.com>
Date: Sun, 28 Apr 2024 02:49:42 -0600
Subject: [PATCH 0583/1178] Change comment style

Co-authored-by: Andrew Murray <3112309+radarhere@users.noreply.github.com>
---
 src/libImaging/GifEncode.c  | 4 ++--
 src/libImaging/TiffDecode.c | 6 ++----
 2 files changed, 4 insertions(+), 6 deletions(-)

diff --git a/src/libImaging/GifEncode.c b/src/libImaging/GifEncode.c
index 9e91944fecf..45b67616d47 100644
--- a/src/libImaging/GifEncode.c
+++ b/src/libImaging/GifEncode.c
@@ -116,8 +116,8 @@ glzwe(
                     st->head = st->codes[st->probe] >> 20;
                     goto encode_loop;
                 } else {
-                    /* Reprobe decrement must be non-zero and relatively prime to table
-                     * size. So, any odd positive number for power-of-2 size. */
+                    // Reprobe decrement must be non-zero and relatively prime to table
+                    // size. So, any odd positive number for power-of-2 size.
                     if ((st->probe -= ((st->tail << 2) | 1)) < 0) {
                         st->probe += TABLE_SIZE;
                     }
diff --git a/src/libImaging/TiffDecode.c b/src/libImaging/TiffDecode.c
index 858de9332f5..e6b57e0a796 100644
--- a/src/libImaging/TiffDecode.c
+++ b/src/libImaging/TiffDecode.c
@@ -414,8 +414,7 @@ _decodeTile(
     if (tile_bytes_size > ((tile_length * state->bits / planes + 7) / 8) * tile_width) {
         // If the tile size as expected by LibTiff isn't what we're expecting, abort.
         // man:   TIFFTileSize returns the equivalent size for a tile of data as it
-        // would be returned in a
-        //        call to TIFFReadTile ...
+        // would be returned in a call to TIFFReadTile ...
         state->errcode = IMAGING_CODEC_BROKEN;
         return -1;
     }
@@ -507,8 +506,7 @@ _decodeStrip(
     if (strip_size > (unpacker_row_byte_size * rows_per_strip)) {
         // If the strip size as expected by LibTiff isn't what we're expecting, abort.
         // man:   TIFFStripSize returns the equivalent size for a strip of data as it
-        // would be returned in a
-        //        call to TIFFReadEncodedStrip ...
+        // would be returned in a call to TIFFReadEncodedStrip ...
         state->errcode = IMAGING_CODEC_BROKEN;
         return -1;
     }

From 996c053d8995893bcdac7673f0469091990c8f25 Mon Sep 17 00:00:00 2001
From: Andrew Murray <radarhere@users.noreply.github.com>
Date: Sun, 28 Apr 2024 22:49:56 +1000
Subject: [PATCH 0584/1178] Change comment style

---
 src/libImaging/FliDecode.c | 6 +++---
 1 file changed, 3 insertions(+), 3 deletions(-)

diff --git a/src/libImaging/FliDecode.c b/src/libImaging/FliDecode.c
index debe7ddd82a..6b2518d35ce 100644
--- a/src/libImaging/FliDecode.c
+++ b/src/libImaging/FliDecode.c
@@ -231,9 +231,9 @@ ImagingFliDecode(Imaging im, ImagingCodecState state, UINT8 *buf, Py_ssize_t byt
                 }
                 /* Note, have to check Data + size, not just ptr + size) */
                 if (data + (state->xsize * state->ysize) > ptr + bytes) {
-                    /* not enough data for frame */
-                    /* UNDONE Unclear that we're actually going to leave the buffer at
-                     * the right place. */
+                    // not enough data for frame
+                    // UNDONE Unclear that we're actually going to leave the buffer at
+                    // the right place.
                     return ptr - buf; /* bytes consumed */
                 }
                 for (y = 0; y < state->ysize; y++) {

From d01e43e796e3d35e6c562145cef13f3e1ffc646d Mon Sep 17 00:00:00 2001
From: Andrew Murray <radarhere@users.noreply.github.com>
Date: Mon, 29 Apr 2024 09:11:33 +1000
Subject: [PATCH 0585/1178] Removed direct invocation of setup.py

---
 Makefile | 1 -
 1 file changed, 1 deletion(-)

diff --git a/Makefile b/Makefile
index 477d92609d1..1f9b4a370df 100644
--- a/Makefile
+++ b/Makefile
@@ -2,7 +2,6 @@
 
 .PHONY: clean
 clean:
-	python3 setup.py clean
 	rm src/PIL/*.so || true
 	rm -r build || true
 	find . -name __pycache__ | xargs rm -r || true

From 36869833c723a6ff54de74ec5c5d630a770d6d1d Mon Sep 17 00:00:00 2001
From: Andrew Murray <radarhere@users.noreply.github.com>
Date: Sun, 28 Apr 2024 23:06:39 +1000
Subject: [PATCH 0586/1178] Added Ubuntu 24.04

---
 .github/workflows/test-docker.yml      | 13 +++++++------
 .github/workflows/test-valgrind.yml    |  4 ++--
 docs/installation/platform-support.rst |  4 +++-
 3 files changed, 12 insertions(+), 9 deletions(-)

diff --git a/.github/workflows/test-docker.yml b/.github/workflows/test-docker.yml
index 8f4a4d09009..c53f23a9f28 100644
--- a/.github/workflows/test-docker.yml
+++ b/.github/workflows/test-docker.yml
@@ -36,8 +36,8 @@ jobs:
         docker: [
           # Run slower jobs first to give them a headstart and reduce waiting time
           ubuntu-22.04-jammy-arm64v8,
-          ubuntu-22.04-jammy-ppc64le,
-          ubuntu-22.04-jammy-s390x,
+          ubuntu-24.04-noble-ppc64le,
+          ubuntu-24.04-noble-s390x,
           # Then run the remainder
           alpine,
           amazon-2-amd64,
@@ -52,14 +52,15 @@ jobs:
           gentoo,
           ubuntu-20.04-focal-amd64,
           ubuntu-22.04-jammy-amd64,
+          ubuntu-24.04-noble-amd64,
         ]
         dockerTag: [main]
         include:
           - docker: "ubuntu-22.04-jammy-arm64v8"
             qemu-arch: "aarch64"
-          - docker: "ubuntu-22.04-jammy-ppc64le"
+          - docker: "ubuntu-24.04-noble-ppc64le"
             qemu-arch: "ppc64le"
-          - docker: "ubuntu-22.04-jammy-s390x"
+          - docker: "ubuntu-24.04-noble-s390x"
             qemu-arch: "s390x"
 
     name: ${{ matrix.docker }}
@@ -81,8 +82,8 @@ jobs:
 
     - name: Docker build
       run: |
-        # The Pillow user in the docker container is UID 1000
-        sudo chown -R 1000 $GITHUB_WORKSPACE
+        # The Pillow user in the docker container is UID 1001
+        sudo chown -R 1001 $GITHUB_WORKSPACE
         docker run --name pillow_container  -v $GITHUB_WORKSPACE:/Pillow pythonpillow/${{ matrix.docker }}:${{ matrix.dockerTag }}
         sudo chown -R runner $GITHUB_WORKSPACE
 
diff --git a/.github/workflows/test-valgrind.yml b/.github/workflows/test-valgrind.yml
index 59bb958ec1c..63aec586b79 100644
--- a/.github/workflows/test-valgrind.yml
+++ b/.github/workflows/test-valgrind.yml
@@ -50,7 +50,7 @@ jobs:
 
     - name: Build and Run Valgrind
       run: |
-        # The Pillow user in the docker container is UID 1000
-        sudo chown -R 1000 $GITHUB_WORKSPACE
+        # The Pillow user in the docker container is UID 1001
+        sudo chown -R 1001 $GITHUB_WORKSPACE
         docker run --name pillow_container -e "PILLOW_VALGRIND_TEST=true" -v $GITHUB_WORKSPACE:/Pillow pythonpillow/${{ matrix.docker }}:${{ matrix.dockerTag }}
         sudo chown -R runner $GITHUB_WORKSPACE
diff --git a/docs/installation/platform-support.rst b/docs/installation/platform-support.rst
index c08a53a4329..888966c51cb 100644
--- a/docs/installation/platform-support.rst
+++ b/docs/installation/platform-support.rst
@@ -47,7 +47,9 @@ These platforms are built and tested for every change.
 | Ubuntu Linux 22.04 LTS (Jammy)   | 3.8, 3.9, 3.10, 3.11,      | x86-64              |
 |                                  | 3.12, 3.13, PyPy3          |                     |
 |                                  +----------------------------+---------------------+
-|                                  | 3.10                       | arm64v8, ppc64le,   |
+|                                  | 3.10                       | arm64v8             |
++----------------------------------+----------------------------+---------------------+
+| Ubuntu Linux 24.04 LTS (Noble)   | 3.12                       | x86-64, ppc64le,    |
 |                                  |                            | s390x               |
 +----------------------------------+----------------------------+---------------------+
 | Windows Server 2016              | 3.8                        | x86-64              |

From 65d73ea970c31c33e23a55273dbdea24376efe04 Mon Sep 17 00:00:00 2001
From: Andrew Murray <radarhere@users.noreply.github.com>
Date: Mon, 29 Apr 2024 18:54:16 +1000
Subject: [PATCH 0587/1178] Python 3.8 and 3.9 are tested on macOS 13

---
 docs/installation/platform-support.rst | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/docs/installation/platform-support.rst b/docs/installation/platform-support.rst
index c08a53a4329..02c4093564c 100644
--- a/docs/installation/platform-support.rst
+++ b/docs/installation/platform-support.rst
@@ -37,7 +37,7 @@ These platforms are built and tested for every change.
 +----------------------------------+----------------------------+---------------------+
 | Gentoo                           | 3.9                        | x86-64              |
 +----------------------------------+----------------------------+---------------------+
-| macOS 12 Monterey                | 3.8, 3.9                   | x86-64              |
+| macOS 13 Ventura                 | 3.8, 3.9                   | x86-64              |
 +----------------------------------+----------------------------+---------------------+
 | macOS 14 Sonoma                  | 3.10, 3.11, 3.12, 3.13,    | arm64               |
 |                                  | PyPy3                      |                     |

From 2250fbeb9a8a1b61c9ec8e7df0902a0c35bc495e Mon Sep 17 00:00:00 2001
From: Andrew Murray <radarhere@users.noreply.github.com>
Date: Mon, 29 Apr 2024 20:19:05 +1000
Subject: [PATCH 0588/1178] Added type hints

---
 src/PIL/Image.py           | 12 +++++++-----
 src/PIL/ImageFile.py       |  2 +-
 src/PIL/JpegImagePlugin.py |  8 +++++---
 src/PIL/PngImagePlugin.py  |  2 +-
 4 files changed, 14 insertions(+), 10 deletions(-)

diff --git a/src/PIL/Image.py b/src/PIL/Image.py
index a17edfa391c..33b3da9a615 100644
--- a/src/PIL/Image.py
+++ b/src/PIL/Image.py
@@ -41,7 +41,7 @@
 from collections.abc import Callable, MutableMapping
 from enum import IntEnum
 from types import ModuleType
-from typing import IO, TYPE_CHECKING, Any, Literal, Protocol, cast
+from typing import IO, TYPE_CHECKING, Any, Literal, Protocol, Sequence, cast
 
 # VERSION was removed in Pillow 6.0.0.
 # PILLOW_VERSION was removed in Pillow 9.0.0.
@@ -877,7 +877,7 @@ def load(self):
                     return self.pyaccess
             return self.im.pixel_access(self.readonly)
 
-    def verify(self):
+    def verify(self) -> None:
         """
         Verifies the contents of a file. For data read from a file, this
         method attempts to determine if the file is broken, without
@@ -1267,7 +1267,9 @@ def _crop(self, im, box):
 
         return im.crop((x0, y0, x1, y1))
 
-    def draft(self, mode, size):
+    def draft(
+        self, mode: str, size: tuple[int, int]
+    ) -> tuple[str, tuple[int, int, float, float]] | None:
         """
         Configures the image file loader so it returns a version of the
         image that as closely as possible matches the given mode and
@@ -1290,7 +1292,7 @@ def draft(self, mode, size):
         """
         pass
 
-    def _expand(self, xmargin, ymargin=None):
+    def _expand(self, xmargin: int, ymargin: int | None = None) -> Image:
         if ymargin is None:
             ymargin = xmargin
         self.load()
@@ -3450,7 +3452,7 @@ def eval(image, *args):
     return image.point(args[0])
 
 
-def merge(mode, bands):
+def merge(mode: str, bands: Sequence[Image]) -> Image:
     """
     Merge a set of single band images into a new multiband image.
 
diff --git a/src/PIL/ImageFile.py b/src/PIL/ImageFile.py
index 0283fa2fd42..27885e654eb 100644
--- a/src/PIL/ImageFile.py
+++ b/src/PIL/ImageFile.py
@@ -163,7 +163,7 @@ def __setstate__(self, state):
         self.tile = []
         super().__setstate__(state)
 
-    def verify(self):
+    def verify(self) -> None:
         """Check file integrity"""
 
         # raise exception if something's wrong.  must be called
diff --git a/src/PIL/JpegImagePlugin.py b/src/PIL/JpegImagePlugin.py
index e3c0083e944..715a358a3b7 100644
--- a/src/PIL/JpegImagePlugin.py
+++ b/src/PIL/JpegImagePlugin.py
@@ -424,13 +424,15 @@ def load_read(self, read_bytes):
 
         return s
 
-    def draft(self, mode, size):
+    def draft(
+        self, mode: str, size: tuple[int, int]
+    ) -> tuple[str, tuple[int, int, float, float]] | None:
         if len(self.tile) != 1:
-            return
+            return None
 
         # Protect from second call
         if self.decoderconfig:
-            return
+            return None
 
         d, e, o, a = self.tile[0]
         scale = 1
diff --git a/src/PIL/PngImagePlugin.py b/src/PIL/PngImagePlugin.py
index 8b81e54ea77..012e0b61bff 100644
--- a/src/PIL/PngImagePlugin.py
+++ b/src/PIL/PngImagePlugin.py
@@ -783,7 +783,7 @@ def text(self):
                 self.seek(frame)
         return self._text
 
-    def verify(self):
+    def verify(self) -> None:
         """Verify PNG file"""
 
         if self.fp is None:

From 5f805c39cccd6ccc5c695a885e274f8a2b4624f9 Mon Sep 17 00:00:00 2001
From: Nulano <nulano@nulano.eu>
Date: Mon, 29 Apr 2024 23:19:36 +0200
Subject: [PATCH 0589/1178] Added type hints for PixelAccess methods and others

---
 docs/reference/ImageDraw.rst   | 18 +-----------
 docs/reference/PixelAccess.rst | 41 ++------------------------
 docs/reference/PyAccess.rst    |  1 +
 src/PIL/Image.py               | 53 +++++++++++++++++++++++++---------
 src/PIL/ImageDraw.py           | 13 +++++++--
 src/PIL/ImageGrab.py           | 15 +++++++---
 src/PIL/PyAccess.py            | 48 ++++++++++++++++++------------
 7 files changed, 97 insertions(+), 92 deletions(-)

diff --git a/docs/reference/ImageDraw.rst b/docs/reference/ImageDraw.rst
index 4ccfacae75e..e7339ecbe03 100644
--- a/docs/reference/ImageDraw.rst
+++ b/docs/reference/ImageDraw.rst
@@ -679,23 +679,7 @@ Methods
     :param hints: An optional list of hints.
     :returns: A (drawing context, drawing resource factory) tuple.
 
-.. py:method:: floodfill(image, xy, value, border=None, thresh=0)
-
-    .. warning:: This method is experimental.
-
-    Fills a bounded region with a given color.
-
-    :param image: Target image.
-    :param xy: Seed position (a 2-item coordinate tuple).
-    :param value: Fill color.
-    :param border: Optional border value.  If given, the region consists of
-        pixels with a color different from the border color.  If not given,
-        the region consists of pixels having the same color as the seed
-        pixel.
-    :param thresh: Optional threshold value which specifies a maximum
-        tolerable difference of a pixel value from the 'background' in
-        order for it to be replaced. Useful for filling regions of non-
-        homogeneous, but similar, colors.
+.. autofunction:: PIL.ImageDraw.floodfill
 
 .. _BCP 47 language code: https://www.w3.org/International/articles/language-tags/
 .. _OpenType docs: https://learn.microsoft.com/en-us/typography/opentype/spec/featurelist
diff --git a/docs/reference/PixelAccess.rst b/docs/reference/PixelAccess.rst
index 04d6f5dcd58..026f488d8e1 100644
--- a/docs/reference/PixelAccess.rst
+++ b/docs/reference/PixelAccess.rst
@@ -44,42 +44,7 @@ Access using negative indexes is also possible. ::
 -----------------------------
 
 .. class:: PixelAccess
+  :canonical: PIL.Image.PixelAccess
 
-  .. method:: __setitem__(self, xy, color):
-
-        Modifies the pixel at x,y. The color is given as a single
-        numerical value for single band images, and a tuple for
-        multi-band images
-
-        :param xy: The pixel coordinate, given as (x, y).
-        :param color: The pixel value according to its mode. e.g. tuple (r, g, b) for RGB mode)
-
-  .. method:: __getitem__(self, xy):
-
-       Returns the pixel at x,y. The pixel is returned as a single
-        value for single band images or a tuple for multiple band
-        images
-
-        :param xy: The pixel coordinate, given as (x, y).
-        :returns: a pixel value for single band images, a tuple of
-          pixel values for multiband images.
-
-  .. method:: putpixel(self, xy, color):
-
-        Modifies the pixel at x,y. The color is given as a single
-        numerical value for single band images, and a tuple for
-        multi-band images. In addition to this, RGB and RGBA tuples
-        are accepted for P and PA images.
-
-        :param xy: The pixel coordinate, given as (x, y).
-        :param color: The pixel value according to its mode. e.g. tuple (r, g, b) for RGB mode)
-
-  .. method:: getpixel(self, xy):
-
-       Returns the pixel at x,y. The pixel is returned as a single
-        value for single band images or a tuple for multiple band
-        images
-
-        :param xy: The pixel coordinate, given as (x, y).
-        :returns: a pixel value for single band images, a tuple of
-          pixel values for multiband images.
+  .. automethod:: PIL.Image.PixelAccess.__getitem__
+  .. automethod:: PIL.Image.PixelAccess.__setitem__
diff --git a/docs/reference/PyAccess.rst b/docs/reference/PyAccess.rst
index ed58ca3a591..04b2a47eed3 100644
--- a/docs/reference/PyAccess.rst
+++ b/docs/reference/PyAccess.rst
@@ -44,3 +44,4 @@ Access using negative indexes is also possible. ::
 
 .. autoclass:: PIL.PyAccess.PyAccess()
     :members:
+    :special-members: __getitem__, __setitem__
diff --git a/src/PIL/Image.py b/src/PIL/Image.py
index a17edfa391c..c1b8a2b2faf 100644
--- a/src/PIL/Image.py
+++ b/src/PIL/Image.py
@@ -41,7 +41,7 @@
 from collections.abc import Callable, MutableMapping
 from enum import IntEnum
 from types import ModuleType
-from typing import IO, TYPE_CHECKING, Any, Literal, Protocol, cast
+from typing import IO, TYPE_CHECKING, Any, Literal, Protocol, SupportsInt, cast
 
 # VERSION was removed in Pillow 6.0.0.
 # PILLOW_VERSION was removed in Pillow 9.0.0.
@@ -482,6 +482,31 @@ def _getscaleoffset(expr):
 # Implementation wrapper
 
 
+class PixelAccess(Protocol):
+    def __getitem__(self, xy: tuple[int, int]) -> float | tuple[int, ...]:
+        """
+        Returns the pixel at x,y. The pixel is returned as a single
+        value for single band images or a tuple for multi-band images.
+
+        :param xy: The pixel coordinate, given as (x, y).
+        :returns: a pixel value for single band images, a tuple of
+                  pixel values for multiband images.
+        """
+        raise NotImplementedError()
+
+    def __setitem__(self, xy: tuple[int, int], color: float | tuple[int, ...]) -> None:
+        """
+        Modifies the pixel at x,y. The color is given as a single
+        numerical value for single band images, and a tuple for
+        multi-band images.
+
+        :param xy: The pixel coordinate, given as (x, y).
+        :param color: The pixel value according to its mode,
+                      e.g. tuple (r, g, b) for RGB mode.
+        """
+        raise NotImplementedError()
+
+
 class Image:
     """
     This class represents an image object.  To create
@@ -834,7 +859,7 @@ def frombytes(self, data: bytes, decoder_name: str = "raw", *args) -> None:
             msg = "cannot decode image data"
             raise ValueError(msg)
 
-    def load(self):
+    def load(self) -> PixelAccess | None:
         """
         Allocates storage for the image and loads the pixel data.  In
         normal cases, you don't need to call this method, since the
@@ -847,7 +872,7 @@ def load(self):
         operations. See :ref:`file-handling` for more information.
 
         :returns: An image access object.
-        :rtype: :ref:`PixelAccess` or :py:class:`PIL.PyAccess`
+        :rtype: :py:class:`.PixelAccess` or :py:class:`.PyAccess`
         """
         if self.im is not None and self.palette and self.palette.dirty:
             # realize palette
@@ -876,6 +901,7 @@ def load(self):
                 if self.pyaccess:
                     return self.pyaccess
             return self.im.pixel_access(self.readonly)
+        return None
 
     def verify(self):
         """
@@ -1485,7 +1511,7 @@ def _reload_exif(self) -> None:
         self._exif._loaded = False
         self.getexif()
 
-    def get_child_images(self):
+    def get_child_images(self) -> list[ImageFile.ImageFile]:
         child_images = []
         exif = self.getexif()
         ifds = []
@@ -1509,10 +1535,7 @@ def get_child_images(self):
             fp = self.fp
             thumbnail_offset = ifd.get(513)
             if thumbnail_offset is not None:
-                try:
-                    thumbnail_offset += self._exif_offset
-                except AttributeError:
-                    pass
+                thumbnail_offset += getattr(self, "_exif_offset", 0)
                 self.fp.seek(thumbnail_offset)
                 data = self.fp.read(ifd.get(514))
                 fp = io.BytesIO(data)
@@ -1578,7 +1601,7 @@ def has_transparency_data(self) -> bool:
             or "transparency" in self.info
         )
 
-    def apply_transparency(self):
+    def apply_transparency(self) -> None:
         """
         If a P mode image has a "transparency" key in the info dictionary,
         remove the key and instead apply the transparency to the palette.
@@ -1590,6 +1613,7 @@ def apply_transparency(self):
         from . import ImagePalette
 
         palette = self.getpalette("RGBA")
+        assert palette is not None
         transparency = self.info["transparency"]
         if isinstance(transparency, bytes):
             for i, alpha in enumerate(transparency):
@@ -1601,7 +1625,9 @@ def apply_transparency(self):
 
         del self.info["transparency"]
 
-    def getpixel(self, xy):
+    def getpixel(
+        self, xy: tuple[SupportsInt, SupportsInt]
+    ) -> float | tuple[int, ...] | None:
         """
         Returns the pixel value at a given position.
 
@@ -1865,7 +1891,7 @@ def point(self, data):
             lut = [round(i) for i in lut]
         return self._new(self.im.point(lut, mode))
 
-    def putalpha(self, alpha):
+    def putalpha(self, alpha: Image | int) -> None:
         """
         Adds or replaces the alpha layer in this image.  If the image
         does not have an alpha layer, it's converted to "LA" or "RGBA".
@@ -1912,6 +1938,7 @@ def putalpha(self, alpha):
                 alpha = alpha.convert("L")
         else:
             # constant alpha
+            alpha = cast(int, alpha)  # see python/typing#1013
             try:
                 self.im.fillband(band, alpha)
             except (AttributeError, ValueError):
@@ -1975,7 +2002,7 @@ def putpalette(self, data, rawmode="RGB") -> None:
         self.palette.mode = "RGB"
         self.load()  # install new palette
 
-    def putpixel(self, xy, value):
+    def putpixel(self, xy: tuple[int, int], value: float | tuple[int, ...]) -> None:
         """
         Modifies the pixel at the given position. The color is given as
         a single numerical value for single-band images, and a tuple for
@@ -2015,7 +2042,7 @@ def putpixel(self, xy, value):
                 value = value[:3]
             value = self.palette.getcolor(value, self)
             if self.mode == "PA":
-                value = (value, alpha)
+                value = (value, alpha)  # type: ignore[assignment]
         return self.im.putpixel(xy, value)
 
     def remap_palette(self, dest_map, source_palette=None):
diff --git a/src/PIL/ImageDraw.py b/src/PIL/ImageDraw.py
index d3efe64865e..5c179000c97 100644
--- a/src/PIL/ImageDraw.py
+++ b/src/PIL/ImageDraw.py
@@ -898,9 +898,17 @@ def getdraw(im=None, hints=None):
     return im, handler
 
 
-def floodfill(image: Image.Image, xy, value, border=None, thresh=0) -> None:
+def floodfill(
+    image: Image.Image,
+    xy: tuple[int, int],
+    value: float | tuple[int, ...],
+    border: float | tuple[int, ...] | None = None,
+    thresh: float = 0,
+) -> None:
     """
-    (experimental) Fills a bounded region with a given color.
+    .. warning:: This method is experimental.
+
+    Fills a bounded region with a given color.
 
     :param image: Target image.
     :param xy: Seed position (a 2-item coordinate tuple). See
@@ -918,6 +926,7 @@ def floodfill(image: Image.Image, xy, value, border=None, thresh=0) -> None:
     # based on an implementation by Eric S. Raymond
     # amended by yo1995 @20180806
     pixel = image.load()
+    assert pixel is not None
     x, y = xy
     try:
         background = pixel[x, y]
diff --git a/src/PIL/ImageGrab.py b/src/PIL/ImageGrab.py
index 3f3be706d96..f52dd301d14 100644
--- a/src/PIL/ImageGrab.py
+++ b/src/PIL/ImageGrab.py
@@ -22,11 +22,17 @@
 import subprocess
 import sys
 import tempfile
+from typing import Union, cast
 
 from . import Image
 
 
-def grab(bbox=None, include_layered_windows=False, all_screens=False, xdisplay=None):
+def grab(
+    bbox: tuple[int, int, int, int] | None = None,
+    include_layered_windows: bool = False,
+    all_screens: bool = False,
+    xdisplay: str | None = None,
+) -> Image.Image:
     if xdisplay is None:
         if sys.platform == "darwin":
             fh, filepath = tempfile.mkstemp(".png")
@@ -36,7 +42,7 @@ def grab(bbox=None, include_layered_windows=False, all_screens=False, xdisplay=N
                 left, top, right, bottom = bbox
                 args += ["-R", f"{left},{top},{right-left},{bottom-top}"]
             subprocess.call(args + ["-x", filepath])
-            im = Image.open(filepath)
+            im: Image.Image = Image.open(filepath)
             im.load()
             os.unlink(filepath)
             if bbox:
@@ -63,6 +69,7 @@ def grab(bbox=None, include_layered_windows=False, all_screens=False, xdisplay=N
                 left, top, right, bottom = bbox
                 im = im.crop((left - x0, top - y0, right - x0, bottom - y0))
             return im
+    xdisplay = cast(Union[str, None], xdisplay)  # type: ignore[redundant-cast, unused-ignore]
     try:
         if not Image.core.HAVE_XCB:
             msg = "Pillow was built without XCB support"
@@ -77,7 +84,7 @@ def grab(bbox=None, include_layered_windows=False, all_screens=False, xdisplay=N
             fh, filepath = tempfile.mkstemp(".png")
             os.close(fh)
             subprocess.call(["gnome-screenshot", "-f", filepath])
-            im = Image.open(filepath)
+            im: Image.Image = Image.open(filepath)
             im.load()
             os.unlink(filepath)
             if bbox:
@@ -94,7 +101,7 @@ def grab(bbox=None, include_layered_windows=False, all_screens=False, xdisplay=N
         return im
 
 
-def grabclipboard():
+def grabclipboard() -> Image.Image | list[str] | None:
     if sys.platform == "darwin":
         fh, filepath = tempfile.mkstemp(".png")
         os.close(fh)
diff --git a/src/PIL/PyAccess.py b/src/PIL/PyAccess.py
index 2c831913d69..af95956662d 100644
--- a/src/PIL/PyAccess.py
+++ b/src/PIL/PyAccess.py
@@ -22,6 +22,7 @@
 
 import logging
 import sys
+from typing import TYPE_CHECKING
 
 from ._deprecate import deprecate
 
@@ -50,7 +51,7 @@
 
 
 class PyAccess:
-    def __init__(self, img, readonly=False):
+    def __init__(self, img: Image.Image, readonly: bool = False) -> None:
         deprecate("PyAccess", 11)
         vals = dict(img.im.unsafe_ptrs)
         self.readonly = readonly
@@ -70,14 +71,15 @@ def __init__(self, img, readonly=False):
         # logger.debug("%s", vals)
         self._post_init()
 
-    def _post_init(self):
+    def _post_init(self) -> None:
         pass
 
-    def __setitem__(self, xy, color):
+    def __setitem__(self, xy: tuple[int, int], color: float | tuple[int, ...]) -> None:
         """
         Modifies the pixel at x,y. The color is given as a single
         numerical value for single band images, and a tuple for
-        multi-band images
+        multi-band images. In addition to this, RGB and RGBA tuples
+        are accepted for P and PA images.
 
         :param xy: The pixel coordinate, given as (x, y). See
            :ref:`coordinate-system`.
@@ -104,11 +106,11 @@ def __setitem__(self, xy, color):
                 color = color[:3]
             color = self._palette.getcolor(color, self._img)
             if self._im.mode == "PA":
-                color = (color, alpha)
+                color = (color, alpha)  # type: ignore[assignment]
 
         return self.set_pixel(x, y, color)
 
-    def __getitem__(self, xy):
+    def __getitem__(self, xy: tuple[int, int]) -> float | tuple[int, ...]:
         """
         Returns the pixel at x,y. The pixel is returned as a single
         value for single band images or a tuple for multiple band
@@ -130,13 +132,19 @@ def __getitem__(self, xy):
     putpixel = __setitem__
     getpixel = __getitem__
 
-    def check_xy(self, xy):
+    def check_xy(self, xy: tuple[int, int]) -> tuple[int, int]:
         (x, y) = xy
         if not (0 <= x < self.xsize and 0 <= y < self.ysize):
             msg = "pixel location out of range"
             raise ValueError(msg)
         return xy
 
+    def get_pixel(self, x: int, y: int) -> float | tuple[int, ...]:
+        raise NotImplementedError()
+
+    def set_pixel(self, x: int, y: int, color: float | tuple[int, ...]) -> None:
+        raise NotImplementedError()
+
 
 class _PyAccess32_2(PyAccess):
     """PA, LA, stored in first and last bytes of a 32 bit word"""
@@ -144,7 +152,7 @@ class _PyAccess32_2(PyAccess):
     def _post_init(self, *args, **kwargs):
         self.pixels = ffi.cast("struct Pixel_RGBA **", self.image32)
 
-    def get_pixel(self, x, y):
+    def get_pixel(self, x: int, y: int) -> tuple[int, int]:
         pixel = self.pixels[y][x]
         return pixel.r, pixel.a
 
@@ -161,7 +169,7 @@ class _PyAccess32_3(PyAccess):
     def _post_init(self, *args, **kwargs):
         self.pixels = ffi.cast("struct Pixel_RGBA **", self.image32)
 
-    def get_pixel(self, x, y):
+    def get_pixel(self, x: int, y: int) -> tuple[int, int, int]:
         pixel = self.pixels[y][x]
         return pixel.r, pixel.g, pixel.b
 
@@ -180,7 +188,7 @@ class _PyAccess32_4(PyAccess):
     def _post_init(self, *args, **kwargs):
         self.pixels = ffi.cast("struct Pixel_RGBA **", self.image32)
 
-    def get_pixel(self, x, y):
+    def get_pixel(self, x: int, y: int) -> tuple[int, int, int, int]:
         pixel = self.pixels[y][x]
         return pixel.r, pixel.g, pixel.b, pixel.a
 
@@ -199,7 +207,7 @@ class _PyAccess8(PyAccess):
     def _post_init(self, *args, **kwargs):
         self.pixels = self.image8
 
-    def get_pixel(self, x, y):
+    def get_pixel(self, x: int, y: int) -> int:
         return self.pixels[y][x]
 
     def set_pixel(self, x, y, color):
@@ -217,7 +225,7 @@ class _PyAccessI16_N(PyAccess):
     def _post_init(self, *args, **kwargs):
         self.pixels = ffi.cast("unsigned short **", self.image)
 
-    def get_pixel(self, x, y):
+    def get_pixel(self, x: int, y: int) -> int:
         return self.pixels[y][x]
 
     def set_pixel(self, x, y, color):
@@ -235,7 +243,7 @@ class _PyAccessI16_L(PyAccess):
     def _post_init(self, *args, **kwargs):
         self.pixels = ffi.cast("struct Pixel_I16 **", self.image)
 
-    def get_pixel(self, x, y):
+    def get_pixel(self, x: int, y: int) -> int:
         pixel = self.pixels[y][x]
         return pixel.l + pixel.r * 256
 
@@ -256,7 +264,7 @@ class _PyAccessI16_B(PyAccess):
     def _post_init(self, *args, **kwargs):
         self.pixels = ffi.cast("struct Pixel_I16 **", self.image)
 
-    def get_pixel(self, x, y):
+    def get_pixel(self, x: int, y: int) -> int:
         pixel = self.pixels[y][x]
         return pixel.l * 256 + pixel.r
 
@@ -277,7 +285,7 @@ class _PyAccessI32_N(PyAccess):
     def _post_init(self, *args, **kwargs):
         self.pixels = self.image32
 
-    def get_pixel(self, x, y):
+    def get_pixel(self, x: int, y: int) -> int:
         return self.pixels[y][x]
 
     def set_pixel(self, x, y, color):
@@ -296,7 +304,7 @@ def reverse(self, i):
         chars[0], chars[1], chars[2], chars[3] = chars[3], chars[2], chars[1], chars[0]
         return ffi.cast("int *", chars)[0]
 
-    def get_pixel(self, x, y):
+    def get_pixel(self, x: int, y: int) -> int:
         return self.reverse(self.pixels[y][x])
 
     def set_pixel(self, x, y, color):
@@ -309,7 +317,7 @@ class _PyAccessF(PyAccess):
     def _post_init(self, *args, **kwargs):
         self.pixels = ffi.cast("float **", self.image32)
 
-    def get_pixel(self, x, y):
+    def get_pixel(self, x: int, y: int) -> float:
         return self.pixels[y][x]
 
     def set_pixel(self, x, y, color):
@@ -357,9 +365,13 @@ def set_pixel(self, x, y, color):
     mode_map["I;32B"] = _PyAccessI32_N
 
 
-def new(img, readonly=False):
+def new(img: Image.Image, readonly: bool = False) -> PyAccess | None:
     access_type = mode_map.get(img.mode, None)
     if not access_type:
         logger.debug("PyAccess Not Implemented: %s", img.mode)
         return None
     return access_type(img, readonly)
+
+
+if TYPE_CHECKING:
+    from . import Image

From 74b87ae7486e475c032044a648c33605514844ed Mon Sep 17 00:00:00 2001
From: Nulano <nulano@nulano.eu>
Date: Tue, 30 Apr 2024 16:32:29 +0200
Subject: [PATCH 0590/1178] Move import to top of file

---
 src/PIL/PyAccess.py | 7 +++----
 1 file changed, 3 insertions(+), 4 deletions(-)

diff --git a/src/PIL/PyAccess.py b/src/PIL/PyAccess.py
index af95956662d..cc8e2e35958 100644
--- a/src/PIL/PyAccess.py
+++ b/src/PIL/PyAccess.py
@@ -49,6 +49,9 @@
 
 logger = logging.getLogger(__name__)
 
+if TYPE_CHECKING:
+    from . import Image
+
 
 class PyAccess:
     def __init__(self, img: Image.Image, readonly: bool = False) -> None:
@@ -371,7 +374,3 @@ def new(img: Image.Image, readonly: bool = False) -> PyAccess | None:
         logger.debug("PyAccess Not Implemented: %s", img.mode)
         return None
     return access_type(img, readonly)
-
-
-if TYPE_CHECKING:
-    from . import Image

From c2cb9445141476283ff0a94be06ad70d4422e535 Mon Sep 17 00:00:00 2001
From: Nulano <nulano@nulano.eu>
Date: Tue, 30 Apr 2024 16:32:44 +0200
Subject: [PATCH 0591/1178] Ignore incorrect mypy warning

---
 src/PIL/ImageGrab.py | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/src/PIL/ImageGrab.py b/src/PIL/ImageGrab.py
index f52dd301d14..f16e9554433 100644
--- a/src/PIL/ImageGrab.py
+++ b/src/PIL/ImageGrab.py
@@ -84,7 +84,7 @@ def grab(
             fh, filepath = tempfile.mkstemp(".png")
             os.close(fh)
             subprocess.call(["gnome-screenshot", "-f", filepath])
-            im: Image.Image = Image.open(filepath)
+            im: Image.Image = Image.open(filepath)  # type: ignore[no-redef, unused-ignore]
             im.load()
             os.unlink(filepath)
             if bbox:

From e8cddfbc6a2a6167e395fc8cfad9ea29a38f108b Mon Sep 17 00:00:00 2001
From: Andrew Murray <radarhere@users.noreply.github.com>
Date: Fri, 3 May 2024 08:45:39 +1000
Subject: [PATCH 0592/1178] Updated codecov/codecov-action to v4

---
 .github/workflows/test-cygwin.yml  | 3 ++-
 .github/workflows/test-docker.yml  | 3 ++-
 .github/workflows/test-mingw.yml   | 3 ++-
 .github/workflows/test-windows.yml | 3 ++-
 .github/workflows/test.yml         | 3 ++-
 5 files changed, 10 insertions(+), 5 deletions(-)

diff --git a/.github/workflows/test-cygwin.yml b/.github/workflows/test-cygwin.yml
index 9674a466570..7972730ca3a 100644
--- a/.github/workflows/test-cygwin.yml
+++ b/.github/workflows/test-cygwin.yml
@@ -132,11 +132,12 @@ jobs:
           bash.exe .ci/after_success.sh
 
       - name: Upload coverage
-        uses: codecov/codecov-action@v3.1.5
+        uses: codecov/codecov-action@v4
         with:
           file: ./coverage.xml
           flags: GHA_Cygwin
           name: Cygwin Python 3.${{ matrix.python-minor-version }}
+          token: ${{ secrets.CODECOV_ORG_TOKEN }}
 
   success:
     permissions:
diff --git a/.github/workflows/test-docker.yml b/.github/workflows/test-docker.yml
index c53f23a9f28..6afed74db31 100644
--- a/.github/workflows/test-docker.yml
+++ b/.github/workflows/test-docker.yml
@@ -100,11 +100,12 @@ jobs:
         MATRIX_DOCKER: ${{ matrix.docker }}
 
     - name: Upload coverage
-      uses: codecov/codecov-action@v3.1.5
+      uses: codecov/codecov-action@v4
       with:
         flags: GHA_Docker
         name: ${{ matrix.docker }}
         gcov: true
+        token: ${{ secrets.CODECOV_ORG_TOKEN }}
 
   success:
     permissions:
diff --git a/.github/workflows/test-mingw.yml b/.github/workflows/test-mingw.yml
index a07a27c4631..a773ca45304 100644
--- a/.github/workflows/test-mingw.yml
+++ b/.github/workflows/test-mingw.yml
@@ -85,8 +85,9 @@ jobs:
           python3 -m pytest -vx --cov PIL --cov Tests --cov-report term --cov-report xml Tests
 
       - name: Upload coverage
-        uses: codecov/codecov-action@v3.1.5
+        uses: codecov/codecov-action@v4
         with:
           file: ./coverage.xml
           flags: GHA_Windows
           name: "MSYS2 MinGW"
+          token: ${{ secrets.CODECOV_ORG_TOKEN }}
diff --git a/.github/workflows/test-windows.yml b/.github/workflows/test-windows.yml
index 40994c60a8d..9edc1517350 100644
--- a/.github/workflows/test-windows.yml
+++ b/.github/workflows/test-windows.yml
@@ -213,11 +213,12 @@ jobs:
       shell: pwsh
 
     - name: Upload coverage
-      uses: codecov/codecov-action@v3.1.5
+      uses: codecov/codecov-action@v4
       with:
         file: ./coverage.xml
         flags: GHA_Windows
         name: ${{ runner.os }} Python ${{ matrix.python-version }}
+        token: ${{ secrets.CODECOV_ORG_TOKEN }}
 
   success:
     permissions:
diff --git a/.github/workflows/test.yml b/.github/workflows/test.yml
index 4573fde906d..aa5646caf44 100644
--- a/.github/workflows/test.yml
+++ b/.github/workflows/test.yml
@@ -150,11 +150,12 @@ jobs:
         .ci/after_success.sh
 
     - name: Upload coverage
-      uses: codecov/codecov-action@v3.1.5
+      uses: codecov/codecov-action@v4
       with:
         flags: ${{ matrix.os == 'ubuntu-latest' && 'GHA_Ubuntu' || 'GHA_macOS' }}
         name: ${{ matrix.os }} Python ${{ matrix.python-version }}
         gcov: true
+        token: ${{ secrets.CODECOV_ORG_TOKEN }}
 
   success:
     permissions:

From ac1eb57c03e182752e1207cd477300650fce4dc0 Mon Sep 17 00:00:00 2001
From: Andrew Murray <radarhere@users.noreply.github.com>
Date: Fri, 3 May 2024 09:43:50 +1000
Subject: [PATCH 0593/1178] Install git

---
 .github/workflows/test-cygwin.yml | 1 +
 1 file changed, 1 insertion(+)

diff --git a/.github/workflows/test-cygwin.yml b/.github/workflows/test-cygwin.yml
index 7972730ca3a..1269ef8cb4a 100644
--- a/.github/workflows/test-cygwin.yml
+++ b/.github/workflows/test-cygwin.yml
@@ -55,6 +55,7 @@ jobs:
           packages: >
             gcc-g++
             ghostscript
+            git
             ImageMagick
             jpeg
             libfreetype-devel

From 6036d81d973e7b0a4613bb06d4a2d79310eef799 Mon Sep 17 00:00:00 2001
From: Andrew Murray <radarhere@users.noreply.github.com>
Date: Sat, 4 May 2024 20:51:54 +1000
Subject: [PATCH 0594/1178] Added type hints

---
 src/PIL/BlpImagePlugin.py      |  6 +++---
 src/PIL/BmpImagePlugin.py      |  4 ++--
 src/PIL/DcxImagePlugin.py      |  4 ++--
 src/PIL/DdsImagePlugin.py      |  2 +-
 src/PIL/EpsImagePlugin.py      |  4 ++--
 src/PIL/FliImagePlugin.py      |  4 ++--
 src/PIL/GifImagePlugin.py      | 12 ++++++------
 src/PIL/Hdf5StubImagePlugin.py |  2 +-
 src/PIL/IcnsImagePlugin.py     |  2 +-
 src/PIL/IcoImagePlugin.py      |  2 +-
 src/PIL/ImImagePlugin.py       |  4 ++--
 src/PIL/Image.py               |  7 +++++--
 src/PIL/ImageFile.py           | 10 +++++-----
 src/PIL/ImageFilter.py         |  5 ++++-
 src/PIL/ImageWin.py            |  4 ++--
 src/PIL/MicImagePlugin.py      |  4 ++--
 src/PIL/MpoImagePlugin.py      |  4 ++--
 src/PIL/PngImagePlugin.py      |  8 ++++----
 src/PIL/PsdImagePlugin.py      |  9 ++++-----
 src/PIL/SpiderImagePlugin.py   |  6 +++---
 src/PIL/TiffImagePlugin.py     | 20 ++++++++++----------
 src/PIL/WalImageFile.py        |  2 +-
 src/PIL/WebPImagePlugin.py     |  4 ++--
 23 files changed, 67 insertions(+), 62 deletions(-)

diff --git a/src/PIL/BlpImagePlugin.py b/src/PIL/BlpImagePlugin.py
index 8d351ce9100..bdf54baae13 100644
--- a/src/PIL/BlpImagePlugin.py
+++ b/src/PIL/BlpImagePlugin.py
@@ -253,7 +253,7 @@ class BlpImageFile(ImageFile.ImageFile):
     format = "BLP"
     format_description = "Blizzard Mipmap Format"
 
-    def _open(self):
+    def _open(self) -> None:
         self.magic = self.fp.read(4)
 
         self.fp.seek(5, os.SEEK_CUR)
@@ -333,7 +333,7 @@ def _read_bgra(self, palette):
 
 
 class BLP1Decoder(_BLPBaseDecoder):
-    def _load(self):
+    def _load(self) -> None:
         if self._blp_compression == Format.JPEG:
             self._decode_jpeg_stream()
 
@@ -418,7 +418,7 @@ def _load(self):
 class BLPEncoder(ImageFile.PyEncoder):
     _pushes_fd = True
 
-    def _write_palette(self):
+    def _write_palette(self) -> bytes:
         data = b""
         palette = self.im.getpalette("RGBA", "RGBA")
         for i in range(len(palette) // 4):
diff --git a/src/PIL/BmpImagePlugin.py b/src/PIL/BmpImagePlugin.py
index 9ce0fed88fe..c5d1cd40d3b 100644
--- a/src/PIL/BmpImagePlugin.py
+++ b/src/PIL/BmpImagePlugin.py
@@ -283,7 +283,7 @@ def _bitmap(self, header=0, offset=0):
             )
         ]
 
-    def _open(self):
+    def _open(self) -> None:
         """Open file, check magic number and read header"""
         # read 14 bytes: magic number, filesize, reserved, header final offset
         head_data = self.fp.read(14)
@@ -376,7 +376,7 @@ class DibImageFile(BmpImageFile):
     format = "DIB"
     format_description = "Windows Bitmap"
 
-    def _open(self):
+    def _open(self) -> None:
         self._bitmap()
 
 
diff --git a/src/PIL/DcxImagePlugin.py b/src/PIL/DcxImagePlugin.py
index b24c16329d3..1c455b032cd 100644
--- a/src/PIL/DcxImagePlugin.py
+++ b/src/PIL/DcxImagePlugin.py
@@ -63,7 +63,7 @@ def _open(self):
         self.is_animated = self.n_frames > 1
         self.seek(0)
 
-    def seek(self, frame):
+    def seek(self, frame: int) -> None:
         if not self._seek_check(frame):
             return
         self.frame = frame
@@ -71,7 +71,7 @@ def seek(self, frame):
         self.fp.seek(self._offset[frame])
         PcxImageFile._open(self)
 
-    def tell(self):
+    def tell(self) -> int:
         return self.frame
 
 
diff --git a/src/PIL/DdsImagePlugin.py b/src/PIL/DdsImagePlugin.py
index 3032e4aec52..59ee0f8a06d 100644
--- a/src/PIL/DdsImagePlugin.py
+++ b/src/PIL/DdsImagePlugin.py
@@ -331,7 +331,7 @@ class DdsImageFile(ImageFile.ImageFile):
     format = "DDS"
     format_description = "DirectDraw Surface"
 
-    def _open(self):
+    def _open(self) -> None:
         if not _accept(self.fp.read(4)):
             msg = "not a DDS file"
             raise SyntaxError(msg)
diff --git a/src/PIL/EpsImagePlugin.py b/src/PIL/EpsImagePlugin.py
index ec6705742ab..b57daca56d4 100644
--- a/src/PIL/EpsImagePlugin.py
+++ b/src/PIL/EpsImagePlugin.py
@@ -178,7 +178,7 @@ def seek(self, offset, whence=io.SEEK_SET):
         self.char = None
         self.fp.seek(offset, whence)
 
-    def readline(self):
+    def readline(self) -> str:
         s = [self.char or b""]
         self.char = None
 
@@ -212,7 +212,7 @@ class EpsImageFile(ImageFile.ImageFile):
 
     mode_map = {1: "L", 2: "LAB", 3: "RGB", 4: "CMYK"}
 
-    def _open(self):
+    def _open(self) -> None:
         (length, offset) = self._find_offset(self.fp)
 
         # go to offset - start of "%!PS"
diff --git a/src/PIL/FliImagePlugin.py b/src/PIL/FliImagePlugin.py
index 7a233d01584..eea2c0c951f 100644
--- a/src/PIL/FliImagePlugin.py
+++ b/src/PIL/FliImagePlugin.py
@@ -123,7 +123,7 @@ def _palette(self, palette, shift):
                 palette[i] = (r, g, b)
                 i += 1
 
-    def seek(self, frame):
+    def seek(self, frame: int) -> None:
         if not self._seek_check(frame):
             return
         if frame < self.__frame:
@@ -162,7 +162,7 @@ def _seek(self, frame):
 
         self.__offset += framesize
 
-    def tell(self):
+    def tell(self) -> int:
         return self.__frame
 
 
diff --git a/src/PIL/GifImagePlugin.py b/src/PIL/GifImagePlugin.py
index 93be7fefb86..26e5958191b 100644
--- a/src/PIL/GifImagePlugin.py
+++ b/src/PIL/GifImagePlugin.py
@@ -76,7 +76,7 @@ class GifImageFile(ImageFile.ImageFile):
 
     global_palette = None
 
-    def data(self):
+    def data(self) -> bytes | None:
         s = self.fp.read(1)
         if s and s[0]:
             return self.fp.read(s[0])
@@ -88,7 +88,7 @@ def _is_palette_needed(self, p):
                 return True
         return False
 
-    def _open(self):
+    def _open(self) -> None:
         # Screen
         s = self.fp.read(13)
         if not _accept(s):
@@ -147,7 +147,7 @@ def is_animated(self):
                     self.seek(current)
         return self._is_animated
 
-    def seek(self, frame):
+    def seek(self, frame: int) -> None:
         if not self._seek_check(frame):
             return
         if frame < self.__frame:
@@ -417,7 +417,7 @@ def _rgb(color):
             elif k in self.info:
                 del self.info[k]
 
-    def load_prepare(self):
+    def load_prepare(self) -> None:
         temp_mode = "P" if self._frame_palette else "L"
         self._prev_im = None
         if self.__frame == 0:
@@ -437,7 +437,7 @@ def load_prepare(self):
 
         super().load_prepare()
 
-    def load_end(self):
+    def load_end(self) -> None:
         if self.__frame == 0:
             if self.mode == "P" and LOADING_STRATEGY == LoadingStrategy.RGB_ALWAYS:
                 if self._frame_transparency is not None:
@@ -463,7 +463,7 @@ def load_end(self):
         else:
             self.im.paste(frame_im, self.dispose_extent)
 
-    def tell(self):
+    def tell(self) -> int:
         return self.__frame
 
 
diff --git a/src/PIL/Hdf5StubImagePlugin.py b/src/PIL/Hdf5StubImagePlugin.py
index f50e6bf1625..afbfd16393c 100644
--- a/src/PIL/Hdf5StubImagePlugin.py
+++ b/src/PIL/Hdf5StubImagePlugin.py
@@ -37,7 +37,7 @@ class HDF5StubImageFile(ImageFile.StubImageFile):
     format = "HDF5"
     format_description = "HDF5"
 
-    def _open(self):
+    def _open(self) -> None:
         offset = self.fp.tell()
 
         if not _accept(self.fp.read(8)):
diff --git a/src/PIL/IcnsImagePlugin.py b/src/PIL/IcnsImagePlugin.py
index c2c9508633d..0a86ba883f1 100644
--- a/src/PIL/IcnsImagePlugin.py
+++ b/src/PIL/IcnsImagePlugin.py
@@ -252,7 +252,7 @@ class IcnsImageFile(ImageFile.ImageFile):
     format = "ICNS"
     format_description = "Mac OS icns resource"
 
-    def _open(self):
+    def _open(self) -> None:
         self.icns = IcnsFile(self.fp)
         self._mode = "RGBA"
         self.info["sizes"] = self.icns.itersizes()
diff --git a/src/PIL/IcoImagePlugin.py b/src/PIL/IcoImagePlugin.py
index 82b190eb8f4..eacffbae645 100644
--- a/src/PIL/IcoImagePlugin.py
+++ b/src/PIL/IcoImagePlugin.py
@@ -302,7 +302,7 @@ class IcoImageFile(ImageFile.ImageFile):
     format = "ICO"
     format_description = "Windows Icon"
 
-    def _open(self):
+    def _open(self) -> None:
         self.ico = IcoFile(self.fp)
         self.info["sizes"] = self.ico.sizes()
         self.size = self.ico.entry[0]["dim"]
diff --git a/src/PIL/ImImagePlugin.py b/src/PIL/ImImagePlugin.py
index 4613e40b60f..0de7d6492b1 100644
--- a/src/PIL/ImImagePlugin.py
+++ b/src/PIL/ImImagePlugin.py
@@ -278,7 +278,7 @@ def n_frames(self):
     def is_animated(self):
         return self.info[FRAMES] > 1
 
-    def seek(self, frame):
+    def seek(self, frame: int) -> None:
         if not self._seek_check(frame):
             return
 
@@ -296,7 +296,7 @@ def seek(self, frame):
 
         self.tile = [("raw", (0, 0) + self.size, offs, (self.rawmode, 0, -1))]
 
-    def tell(self):
+    def tell(self) -> int:
         return self.frame
 
 
diff --git a/src/PIL/Image.py b/src/PIL/Image.py
index 33b3da9a615..0f2e146bb5d 100644
--- a/src/PIL/Image.py
+++ b/src/PIL/Image.py
@@ -1298,7 +1298,10 @@ def _expand(self, xmargin: int, ymargin: int | None = None) -> Image:
         self.load()
         return self._new(self.im.expand(xmargin, ymargin))
 
-    def filter(self, filter):
+    if TYPE_CHECKING:
+        from . import ImageFilter
+
+    def filter(self, filter: ImageFilter.Filter | type[ImageFilter.Filter]) -> Image:
         """
         Filters this image using the given filter.  For a list of
         available filters, see the :py:mod:`~PIL.ImageFilter` module.
@@ -1310,7 +1313,7 @@ def filter(self, filter):
 
         self.load()
 
-        if isinstance(filter, Callable):
+        if callable(filter):
             filter = filter()
         if not hasattr(filter, "filter"):
             msg = "filter argument should be ImageFilter.Filter instance or class"
diff --git a/src/PIL/ImageFile.py b/src/PIL/ImageFile.py
index 27885e654eb..b93e2ad2ce6 100644
--- a/src/PIL/ImageFile.py
+++ b/src/PIL/ImageFile.py
@@ -311,7 +311,7 @@ def load(self):
 
         return Image.Image.load(self)
 
-    def load_prepare(self):
+    def load_prepare(self) -> None:
         # create image memory if necessary
         if not self.im or self.im.mode != self.mode or self.im.size != self.size:
             self.im = Image.core.new(self.mode, self.size)
@@ -319,7 +319,7 @@ def load_prepare(self):
         if self.mode == "P":
             Image.Image.load(self)
 
-    def load_end(self):
+    def load_end(self) -> None:
         # may be overridden
         pass
 
@@ -390,7 +390,7 @@ class Parser:
     offset = 0
     finished = 0
 
-    def reset(self):
+    def reset(self) -> None:
         """
         (Consumer) Reset the parser.  Note that you can only call this
         method immediately after you've created a parser; parser
@@ -605,7 +605,7 @@ def _safe_read(fp, size):
 
 
 class PyCodecState:
-    def __init__(self):
+    def __init__(self) -> None:
         self.xsize = 0
         self.ysize = 0
         self.xoff = 0
@@ -634,7 +634,7 @@ def init(self, args):
         """
         self.args = args
 
-    def cleanup(self):
+    def cleanup(self) -> None:
         """
         Override to perform codec specific cleanup
 
diff --git a/src/PIL/ImageFilter.py b/src/PIL/ImageFilter.py
index b2c4950d6a9..fa9ebd9defb 100644
--- a/src/PIL/ImageFilter.py
+++ b/src/PIL/ImageFilter.py
@@ -16,11 +16,14 @@
 #
 from __future__ import annotations
 
+import abc
 import functools
 
 
 class Filter:
-    pass
+    @abc.abstractmethod
+    def filter(self, image):
+        pass
 
 
 class MultibandFilter(Filter):
diff --git a/src/PIL/ImageWin.py b/src/PIL/ImageWin.py
index 75910d2d9ab..2c439038dde 100644
--- a/src/PIL/ImageWin.py
+++ b/src/PIL/ImageWin.py
@@ -204,7 +204,7 @@ def ui_handle_clear(self, dc, x0, y0, x1, y1):
     def ui_handle_damage(self, x0, y0, x1, y1):
         pass
 
-    def ui_handle_destroy(self):
+    def ui_handle_destroy(self) -> None:
         pass
 
     def ui_handle_repair(self, dc, x0, y0, x1, y1):
@@ -213,7 +213,7 @@ def ui_handle_repair(self, dc, x0, y0, x1, y1):
     def ui_handle_resize(self, width, height):
         pass
 
-    def mainloop(self):
+    def mainloop(self) -> None:
         Image.core.eventloop()
 
 
diff --git a/src/PIL/MicImagePlugin.py b/src/PIL/MicImagePlugin.py
index 96de386a851..5aef94dfbff 100644
--- a/src/PIL/MicImagePlugin.py
+++ b/src/PIL/MicImagePlugin.py
@@ -38,7 +38,7 @@ class MicImageFile(TiffImagePlugin.TiffImageFile):
     format_description = "Microsoft Image Composer"
     _close_exclusive_fp_after_loading = False
 
-    def _open(self):
+    def _open(self) -> None:
         # read the OLE directory and see if this is a likely
         # to be a Microsoft Image Composer file
 
@@ -88,7 +88,7 @@ def seek(self, frame):
     def tell(self):
         return self.frame
 
-    def close(self):
+    def close(self) -> None:
         self.__fp.close()
         self.ole.close()
         super().close()
diff --git a/src/PIL/MpoImagePlugin.py b/src/PIL/MpoImagePlugin.py
index ac9820bbf68..fb6620e7563 100644
--- a/src/PIL/MpoImagePlugin.py
+++ b/src/PIL/MpoImagePlugin.py
@@ -127,7 +127,7 @@ def _after_jpeg_open(self, mpheader=None):
     def load_seek(self, pos):
         self._fp.seek(pos)
 
-    def seek(self, frame):
+    def seek(self, frame: int) -> None:
         if not self._seek_check(frame):
             return
         self.fp = self._fp
@@ -149,7 +149,7 @@ def seek(self, frame):
         self.tile = [("jpeg", (0, 0) + self.size, self.offset, self.tile[0][-1])]
         self.__frame = frame
 
-    def tell(self):
+    def tell(self) -> int:
         return self.__frame
 
     @staticmethod
diff --git a/src/PIL/PngImagePlugin.py b/src/PIL/PngImagePlugin.py
index 012e0b61bff..39faa0f78b1 100644
--- a/src/PIL/PngImagePlugin.py
+++ b/src/PIL/PngImagePlugin.py
@@ -800,7 +800,7 @@ def verify(self) -> None:
             self.fp.close()
         self.fp = None
 
-    def seek(self, frame):
+    def seek(self, frame: int) -> None:
         if not self._seek_check(frame):
             return
         if frame < self.__frame:
@@ -909,10 +909,10 @@ def _seek(self, frame, rewind=False):
         else:
             self.dispose = None
 
-    def tell(self):
+    def tell(self) -> int:
         return self.__frame
 
-    def load_prepare(self):
+    def load_prepare(self) -> None:
         """internal: prepare to read PNG file"""
 
         if self.info.get("interlace"):
@@ -954,7 +954,7 @@ def load_read(self, read_bytes):
 
         return self.fp.read(read_bytes)
 
-    def load_end(self):
+    def load_end(self) -> None:
         """internal: finished reading image data"""
         if self.__idat != 0:
             self.fp.read(self.__idat)
diff --git a/src/PIL/PsdImagePlugin.py b/src/PIL/PsdImagePlugin.py
index b15918313be..86c1a67630e 100644
--- a/src/PIL/PsdImagePlugin.py
+++ b/src/PIL/PsdImagePlugin.py
@@ -57,7 +57,7 @@ class PsdImageFile(ImageFile.ImageFile):
     format_description = "Adobe Photoshop"
     _close_exclusive_fp_after_loading = False
 
-    def _open(self):
+    def _open(self) -> None:
         read = self.fp.read
 
         #
@@ -141,23 +141,22 @@ def _open(self):
         self.frame = 1
         self._min_frame = 1
 
-    def seek(self, layer):
+    def seek(self, layer: int) -> None:
         if not self._seek_check(layer):
             return
 
         # seek to given layer (1..max)
         try:
-            name, mode, bbox, tile = self.layers[layer - 1]
+            _, mode, _, tile = self.layers[layer - 1]
             self._mode = mode
             self.tile = tile
             self.frame = layer
             self.fp = self._fp
-            return name, bbox
         except IndexError as e:
             msg = "no such layer"
             raise EOFError(msg) from e
 
-    def tell(self):
+    def tell(self) -> int:
         # return layer number (0=image, 1..max=layers)
         return self.frame
 
diff --git a/src/PIL/SpiderImagePlugin.py b/src/PIL/SpiderImagePlugin.py
index 86582fb128c..01a39e97c6d 100644
--- a/src/PIL/SpiderImagePlugin.py
+++ b/src/PIL/SpiderImagePlugin.py
@@ -97,7 +97,7 @@ class SpiderImageFile(ImageFile.ImageFile):
     format_description = "Spider 2D image"
     _close_exclusive_fp_after_loading = False
 
-    def _open(self):
+    def _open(self) -> None:
         # check header
         n = 27 * 4  # read 27 float values
         f = self.fp.read(n)
@@ -165,13 +165,13 @@ def is_animated(self):
         return self._nimages > 1
 
     # 1st image index is zero (although SPIDER imgnumber starts at 1)
-    def tell(self):
+    def tell(self) -> int:
         if self.imgnumber < 1:
             return 0
         else:
             return self.imgnumber - 1
 
-    def seek(self, frame):
+    def seek(self, frame: int) -> None:
         if self.istack == 0:
             msg = "attempt to seek in a non-stack file"
             raise EOFError(msg)
diff --git a/src/PIL/TiffImagePlugin.py b/src/PIL/TiffImagePlugin.py
index c78c223b365..1be717de1cb 100644
--- a/src/PIL/TiffImagePlugin.py
+++ b/src/PIL/TiffImagePlugin.py
@@ -1143,7 +1143,7 @@ def n_frames(self):
             self.seek(current)
         return self._n_frames
 
-    def seek(self, frame):
+    def seek(self, frame: int) -> None:
         """Select a given frame as current image"""
         if not self._seek_check(frame):
             return
@@ -1198,7 +1198,7 @@ def _seek(self, frame):
         self.__frame = frame
         self._setup()
 
-    def tell(self):
+    def tell(self) -> int:
         """Return the current frame number"""
         return self.__frame
 
@@ -1237,7 +1237,7 @@ def load(self):
             return self._load_libtiff()
         return super().load()
 
-    def load_end(self):
+    def load_end(self) -> None:
         # allow closing if we're on the first frame, there's no next
         # This is the ImageFile.load path only, libtiff specific below.
         if not self.is_animated:
@@ -1942,7 +1942,7 @@ def __init__(self, fn, new=False):
         self.beginning = self.f.tell()
         self.setup()
 
-    def setup(self):
+    def setup(self) -> None:
         # Reset everything.
         self.f.seek(self.beginning, os.SEEK_SET)
 
@@ -1967,7 +1967,7 @@ def setup(self):
         self.skipIFDs()
         self.goToEnd()
 
-    def finalize(self):
+    def finalize(self) -> None:
         if self.isFirst:
             return
 
@@ -1990,7 +1990,7 @@ def finalize(self):
         self.f.seek(ifd_offset)
         self.fixIFD()
 
-    def newFrame(self):
+    def newFrame(self) -> None:
         # Call this to finish a frame.
         self.finalize()
         self.setup()
@@ -2013,7 +2013,7 @@ def seek(self, offset, whence=io.SEEK_SET):
         self.f.seek(offset, whence)
         return self.tell()
 
-    def goToEnd(self):
+    def goToEnd(self) -> None:
         self.f.seek(0, os.SEEK_END)
         pos = self.f.tell()
 
@@ -2029,7 +2029,7 @@ def setEndian(self, endian):
         self.shortFmt = self.endian + "H"
         self.tagFormat = self.endian + "HHL"
 
-    def skipIFDs(self):
+    def skipIFDs(self) -> None:
         while True:
             ifd_offset = self.readLong()
             if ifd_offset == 0:
@@ -2084,11 +2084,11 @@ def writeLong(self, value):
             msg = f"wrote only {bytes_written} bytes but wanted 4"
             raise RuntimeError(msg)
 
-    def close(self):
+    def close(self) -> None:
         self.finalize()
         self.f.close()
 
-    def fixIFD(self):
+    def fixIFD(self) -> None:
         num_tags = self.readShort()
 
         for i in range(num_tags):
diff --git a/src/PIL/WalImageFile.py b/src/PIL/WalImageFile.py
index c5bf3e04cf7..fbd7be6ed5c 100644
--- a/src/PIL/WalImageFile.py
+++ b/src/PIL/WalImageFile.py
@@ -32,7 +32,7 @@ class WalImageFile(ImageFile.ImageFile):
     format = "WAL"
     format_description = "Quake2 Texture"
 
-    def _open(self):
+    def _open(self) -> None:
         self._mode = "P"
 
         # read header fields
diff --git a/src/PIL/WebPImagePlugin.py b/src/PIL/WebPImagePlugin.py
index 9c8d53336ef..61ae9eae500 100644
--- a/src/PIL/WebPImagePlugin.py
+++ b/src/PIL/WebPImagePlugin.py
@@ -109,7 +109,7 @@ def getxmp(self):
         """
         return self._getxmp(self.info["xmp"]) if "xmp" in self.info else {}
 
-    def seek(self, frame):
+    def seek(self, frame: int) -> None:
         if not self._seek_check(frame):
             return
 
@@ -174,7 +174,7 @@ def load(self):
     def load_seek(self, pos):
         pass
 
-    def tell(self):
+    def tell(self) -> int:
         if not _webp.HAVE_WEBPANIM:
             return super().tell()
 

From 74063feadca98b847ee8e239531d2cfb73de12e5 Mon Sep 17 00:00:00 2001
From: mrKazzila <mrkazzila@gmail.com>
Date: Sat, 4 May 2024 19:21:49 +0300
Subject: [PATCH 0595/1178] chore: add f-string formatting

---
 src/PIL/DdsImagePlugin.py    |  8 ++++----
 src/PIL/ImImagePlugin.py     |  2 +-
 src/PIL/Image.py             | 14 +++++++-------
 src/PIL/ImageMath.py         |  4 ++--
 src/PIL/ImageMode.py         |  8 ++++----
 src/PIL/ImageMorph.py        |  2 +-
 src/PIL/ImageWin.py          |  2 +-
 src/PIL/PalmImagePlugin.py   |  2 +-
 src/PIL/PdfParser.py         |  4 ++--
 src/PIL/PngImagePlugin.py    |  2 +-
 src/PIL/SpiderImagePlugin.py | 10 +++++-----
 src/PIL/TiffImagePlugin.py   | 12 ++++++------
 src/PIL/features.py          |  4 ++--
 13 files changed, 37 insertions(+), 37 deletions(-)

diff --git a/src/PIL/DdsImagePlugin.py b/src/PIL/DdsImagePlugin.py
index 3032e4aec52..2496088af41 100644
--- a/src/PIL/DdsImagePlugin.py
+++ b/src/PIL/DdsImagePlugin.py
@@ -271,16 +271,16 @@ class D3DFMT(IntEnum):
 module = sys.modules[__name__]
 for item in DDSD:
     assert item.name is not None
-    setattr(module, "DDSD_" + item.name, item.value)
+    setattr(module, f"DDSD_{item.name}", item.value)
 for item1 in DDSCAPS:
     assert item1.name is not None
-    setattr(module, "DDSCAPS_" + item1.name, item1.value)
+    setattr(module, f"DDSCAPS_{item1.name}", item1.value)
 for item2 in DDSCAPS2:
     assert item2.name is not None
-    setattr(module, "DDSCAPS2_" + item2.name, item2.value)
+    setattr(module, f"DDSCAPS2_{item2.name}", item2.value)
 for item3 in DDPF:
     assert item3.name is not None
-    setattr(module, "DDPF_" + item3.name, item3.value)
+    setattr(module, f"DDPF_{item3.name}", item3.value)
 
 DDS_FOURCC = DDPF.FOURCC
 DDS_RGB = DDPF.RGB
diff --git a/src/PIL/ImImagePlugin.py b/src/PIL/ImImagePlugin.py
index 4613e40b60f..77b3963871d 100644
--- a/src/PIL/ImImagePlugin.py
+++ b/src/PIL/ImImagePlugin.py
@@ -196,7 +196,7 @@ def _open(self):
                     n += 1
 
             else:
-                msg = "Syntax error in IM header: " + s.decode("ascii", "replace")
+                msg = f"Syntax error in IM header: {s.decode('ascii', 'replace')}"
                 raise SyntaxError(msg)
 
         if not n:
diff --git a/src/PIL/Image.py b/src/PIL/Image.py
index 33b3da9a615..2184ef8ea9e 100644
--- a/src/PIL/Image.py
+++ b/src/PIL/Image.py
@@ -405,7 +405,7 @@ def _getdecoder(mode, decoder_name, args, extra=()):
 
     try:
         # get decoder
-        decoder = getattr(core, decoder_name + "_decoder")
+        decoder = getattr(core, f"{decoder_name}_decoder")
     except AttributeError as e:
         msg = f"decoder {decoder_name} not available"
         raise OSError(msg) from e
@@ -428,7 +428,7 @@ def _getencoder(mode, encoder_name, args, extra=()):
 
     try:
         # get encoder
-        encoder = getattr(core, encoder_name + "_encoder")
+        encoder = getattr(core, f"{encoder_name}_encoder")
     except AttributeError as e:
         msg = f"encoder {encoder_name} not available"
         raise OSError(msg) from e
@@ -603,7 +603,7 @@ def _dump(
     ) -> str:
         suffix = ""
         if format:
-            suffix = "." + format
+            suffix = f".{format}"
 
         if not file:
             f, filename = tempfile.mkstemp(suffix)
@@ -2180,7 +2180,7 @@ def resize(self, size, resample=None, box=None, reducing_gap=None) -> Image:
                     (Resampling.HAMMING, "Image.Resampling.HAMMING"),
                 )
             ]
-            msg += " Use " + ", ".join(filters[:-1]) + " or " + filters[-1]
+            msg += f" Use {', '.join(filters[:-1])} or {filters[-1]}"
             raise ValueError(msg)
 
         if reducing_gap is not None and reducing_gap < 1.0:
@@ -2825,7 +2825,7 @@ def __transformer(
                     (Resampling.BICUBIC, "Image.Resampling.BICUBIC"),
                 )
             ]
-            msg += " Use " + ", ".join(filters[:-1]) + " or " + filters[-1]
+            msg += f" Use {', '.join(filters[:-1])} or {filters[-1]}"
             raise ValueError(msg)
 
         image.load()
@@ -3223,8 +3223,8 @@ def fromqpixmap(im):
     ((1, 1, 3), "|u1"): ("RGB", "RGB"),
     ((1, 1, 4), "|u1"): ("RGBA", "RGBA"),
     # shortcuts:
-    ((1, 1), _ENDIAN + "i4"): ("I", "I"),
-    ((1, 1), _ENDIAN + "f4"): ("F", "F"),
+    ((1, 1), f"{_ENDIAN}i4"): ("I", "I"),
+    ((1, 1), f"{_ENDIAN}f4"): ("F", "F"),
 }
 
 
diff --git a/src/PIL/ImageMath.py b/src/PIL/ImageMath.py
index 77472a24c68..6664434ea45 100644
--- a/src/PIL/ImageMath.py
+++ b/src/PIL/ImageMath.py
@@ -61,7 +61,7 @@ def apply(
             out = Image.new(mode or im_1.mode, im_1.size, None)
             im_1.load()
             try:
-                op = getattr(_imagingmath, op + "_" + im_1.mode)
+                op = getattr(_imagingmath, f"{op}_{im_1.mode}")
             except AttributeError as e:
                 msg = f"bad operand type for '{op}'"
                 raise TypeError(msg) from e
@@ -89,7 +89,7 @@ def apply(
             im_1.load()
             im_2.load()
             try:
-                op = getattr(_imagingmath, op + "_" + im_1.mode)
+                op = getattr(_imagingmath, f"{op}_{im_1.mode}")
             except AttributeError as e:
                 msg = f"bad operand type for '{op}'"
                 raise TypeError(msg) from e
diff --git a/src/PIL/ImageMode.py b/src/PIL/ImageMode.py
index 7bd2afcf2fa..92a08d2cbcb 100644
--- a/src/PIL/ImageMode.py
+++ b/src/PIL/ImageMode.py
@@ -44,8 +44,8 @@ def getmode(mode: str) -> ModeDescriptor:
         # Bits need to be extended to bytes
         "1": ("L", "L", ("1",), "|b1"),
         "L": ("L", "L", ("L",), "|u1"),
-        "I": ("L", "I", ("I",), endian + "i4"),
-        "F": ("L", "F", ("F",), endian + "f4"),
+        "I": ("L", "I", ("I",), f"{endian}i4"),
+        "F": ("L", "F", ("F",), f"{endian}f4"),
         "P": ("P", "L", ("P",), "|u1"),
         "RGB": ("RGB", "L", ("R", "G", "B"), "|u1"),
         "RGBX": ("RGB", "L", ("R", "G", "B", "X"), "|u1"),
@@ -78,8 +78,8 @@ def getmode(mode: str) -> ModeDescriptor:
         "I;16LS": "<i2",
         "I;16B": ">u2",
         "I;16BS": ">i2",
-        "I;16N": endian + "u2",
-        "I;16NS": endian + "i2",
+        "I;16N": f"{endian}u2",
+        "I;16NS": f"{endian}i2",
         "I;32": "<u4",
         "I;32B": ">u4",
         "I;32L": "<u4",
diff --git a/src/PIL/ImageMorph.py b/src/PIL/ImageMorph.py
index 534c6291a02..6ee8c4f253d 100644
--- a/src/PIL/ImageMorph.py
+++ b/src/PIL/ImageMorph.py
@@ -84,7 +84,7 @@ def __init__(
                 ],
             }
             if op_name not in known_patterns:
-                msg = "Unknown pattern " + op_name + "!"
+                msg = f"Unknown pattern {op_name}!"
                 raise Exception(msg)
 
             self.patterns = known_patterns[op_name]
diff --git a/src/PIL/ImageWin.py b/src/PIL/ImageWin.py
index 75910d2d9ab..f6ea138bcaf 100644
--- a/src/PIL/ImageWin.py
+++ b/src/PIL/ImageWin.py
@@ -196,7 +196,7 @@ def __init__(self, title="PIL", width=None, height=None):
         )
 
     def __dispatcher(self, action, *args):
-        return getattr(self, "ui_handle_" + action)(*args)
+        return getattr(self, f"ui_handle_{action}")(*args)
 
     def ui_handle_clear(self, dc, x0, y0, x1, y1):
         pass
diff --git a/src/PIL/PalmImagePlugin.py b/src/PIL/PalmImagePlugin.py
index 65be7fef7b1..85f9fe1bf61 100644
--- a/src/PIL/PalmImagePlugin.py
+++ b/src/PIL/PalmImagePlugin.py
@@ -142,7 +142,7 @@ def _save(im, fp, filename):
 
         # we ignore the palette here
         im.mode = "P"
-        rawmode = "P;" + str(bpp)
+        rawmode = f"P;{bpp}"
         version = 1
 
     elif im.mode == "1":
diff --git a/src/PIL/PdfParser.py b/src/PIL/PdfParser.py
index 2542d4e9127..d6f2ebd44c0 100644
--- a/src/PIL/PdfParser.py
+++ b/src/PIL/PdfParser.py
@@ -145,7 +145,7 @@ def __delitem__(self, key):
             generation = self.deleted_entries[key]
         else:
             msg = (
-                "object ID " + str(key) + " cannot be deleted because it doesn't exist"
+                f"object ID {key} cannot be deleted because it doesn't exist"
             )
             raise IndexError(msg)
 
@@ -884,7 +884,7 @@ def get_value(cls, data, offset, expect_indirect=None, max_nesting=-1):
         if m:
             return cls.get_literal_string(data, m.end())
         # return None, offset  # fallback (only for debugging)
-        msg = "unrecognized object: " + repr(data[offset : offset + 32])
+        msg = f"unrecognized object: {repr(data[offset : offset + 32])}"
         raise PdfFormatError(msg)
 
     re_lit_str_token = re.compile(
diff --git a/src/PIL/PngImagePlugin.py b/src/PIL/PngImagePlugin.py
index 012e0b61bff..ff8f5fcc98b 100644
--- a/src/PIL/PngImagePlugin.py
+++ b/src/PIL/PngImagePlugin.py
@@ -189,7 +189,7 @@ def call(self, cid, pos, length):
         """Call the appropriate chunk handler"""
 
         logger.debug("STREAM %r %s %s", cid, pos, length)
-        return getattr(self, "chunk_" + cid.decode("ascii"))(pos, length)
+        return getattr(self, f"chunk_{cid.decode('ascii')}")(pos, length)
 
     def crc(self, cid, data):
         """Read and verify checksum"""
diff --git a/src/PIL/SpiderImagePlugin.py b/src/PIL/SpiderImagePlugin.py
index 86582fb128c..69b27dc9d32 100644
--- a/src/PIL/SpiderImagePlugin.py
+++ b/src/PIL/SpiderImagePlugin.py
@@ -218,7 +218,7 @@ def loadImageSeries(filelist=None):
                 im = im.convert2byte()
         except Exception:
             if not isSpiderImage(img):
-                print(img + " is not a Spider image file")
+                print(f"{img} is not a Spider image file")
             continue
         im.info["filename"] = img
         imglist.append(im)
@@ -299,10 +299,10 @@ def _save_spider(im, fp, filename):
         sys.exit()
 
     with Image.open(filename) as im:
-        print("image: " + str(im))
-        print("format: " + str(im.format))
-        print("size: " + str(im.size))
-        print("mode: " + str(im.mode))
+        print(f"image: {im}")
+        print(f"format: {im.format}")
+        print(f"size: {im.size}")
+        print(f"mode: {im.mode}")
         print("max, min: ", end=" ")
         print(im.getextrema())
 
diff --git a/src/PIL/TiffImagePlugin.py b/src/PIL/TiffImagePlugin.py
index c78c223b365..13069ce757a 100644
--- a/src/PIL/TiffImagePlugin.py
+++ b/src/PIL/TiffImagePlugin.py
@@ -469,7 +469,7 @@ def _register_basic(idx_fmt_name):
 
     idx, fmt, name = idx_fmt_name
     TYPES[idx] = name
-    size = struct.calcsize("=" + fmt)
+    size = struct.calcsize(f"={fmt}")
     _load_dispatch[idx] = (  # noqa: F821
         size,
         lambda self, data, legacy_api=True: (
@@ -987,8 +987,8 @@ def save(self, fp):
 ImageFileDirectory_v2._write_dispatch = _write_dispatch
 for idx, name in TYPES.items():
     name = name.replace(" ", "_")
-    setattr(ImageFileDirectory_v2, "load_" + name, _load_dispatch[idx][1])
-    setattr(ImageFileDirectory_v2, "write_" + name, _write_dispatch[idx])
+    setattr(ImageFileDirectory_v2, f"load_{name}", _load_dispatch[idx][1])
+    setattr(ImageFileDirectory_v2, f"write_{name}", _write_dispatch[idx])
 del _load_dispatch, _write_dispatch, idx, name
 
 
@@ -2025,9 +2025,9 @@ def goToEnd(self):
 
     def setEndian(self, endian):
         self.endian = endian
-        self.longFmt = self.endian + "L"
-        self.shortFmt = self.endian + "H"
-        self.tagFormat = self.endian + "HHL"
+        self.longFmt = f"{self.endian}L"
+        self.shortFmt = f"{self.endian}H"
+        self.tagFormat = f"{self.endian}HHL"
 
     def skipIFDs(self):
         while True:
diff --git a/src/PIL/features.py b/src/PIL/features.py
index 8a0b140049d..95c6c84cce3 100644
--- a/src/PIL/features.py
+++ b/src/PIL/features.py
@@ -89,7 +89,7 @@ def check_codec(feature):
 
     codec, lib = codecs[feature]
 
-    return codec + "_encoder" in dir(Image.core)
+    return f"{codec}_encoder" in dir(Image.core)
 
 
 def version_codec(feature):
@@ -105,7 +105,7 @@ def version_codec(feature):
 
     codec, lib = codecs[feature]
 
-    version = getattr(Image.core, lib + "_version")
+    version = getattr(Image.core, f"{lib}_version")
 
     if feature == "libtiff":
         return version.split("\n")[0].split("Version ")[1]

From 984c2e7f30918d3024e74f707ed644b78fc596c8 Mon Sep 17 00:00:00 2001
From: mrKazzila <mrkazzila@gmail.com>
Date: Sat, 4 May 2024 19:26:22 +0300
Subject: [PATCH 0596/1178] chore: update __repr__ for PdfName

---
 src/PIL/PdfParser.py | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/src/PIL/PdfParser.py b/src/PIL/PdfParser.py
index d6f2ebd44c0..1485cafe0ac 100644
--- a/src/PIL/PdfParser.py
+++ b/src/PIL/PdfParser.py
@@ -225,7 +225,7 @@ def __hash__(self):
         return hash(self.name)
 
     def __repr__(self):
-        return f"PdfName({repr(self.name)})"
+        return f"{self.__class__.__name__}({repr(self.name)})"
 
     @classmethod
     def from_pdf_stream(cls, data):

From 71b8d99b3699bab3e7217af7453199853671409f Mon Sep 17 00:00:00 2001
From: "pre-commit-ci[bot]"
 <66853113+pre-commit-ci[bot]@users.noreply.github.com>
Date: Sat, 4 May 2024 19:27:42 +0000
Subject: [PATCH 0597/1178] [pre-commit.ci] auto fixes from pre-commit.com
 hooks

for more information, see https://pre-commit.ci
---
 src/PIL/PdfParser.py | 4 +---
 1 file changed, 1 insertion(+), 3 deletions(-)

diff --git a/src/PIL/PdfParser.py b/src/PIL/PdfParser.py
index 1485cafe0ac..c1ed7879741 100644
--- a/src/PIL/PdfParser.py
+++ b/src/PIL/PdfParser.py
@@ -144,9 +144,7 @@ def __delitem__(self, key):
         elif key in self.deleted_entries:
             generation = self.deleted_entries[key]
         else:
-            msg = (
-                f"object ID {key} cannot be deleted because it doesn't exist"
-            )
+            msg = f"object ID {key} cannot be deleted because it doesn't exist"
             raise IndexError(msg)
 
     def __contains__(self, key):

From b8e3e0a43059dc2c1a1b410ac87fca0772de3af1 Mon Sep 17 00:00:00 2001
From: "pre-commit-ci[bot]"
 <66853113+pre-commit-ci[bot]@users.noreply.github.com>
Date: Mon, 6 May 2024 17:25:18 +0000
Subject: [PATCH 0598/1178] [pre-commit.ci] pre-commit autoupdate
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit

updates:
- [github.com/astral-sh/ruff-pre-commit: v0.3.4 → v0.4.3](https://github.com/astral-sh/ruff-pre-commit/compare/v0.3.4...v0.4.3)
- [github.com/psf/black-pre-commit-mirror: 24.3.0 → 24.4.2](https://github.com/psf/black-pre-commit-mirror/compare/24.3.0...24.4.2)
- [github.com/pre-commit/pre-commit-hooks: v4.5.0 → v4.6.0](https://github.com/pre-commit/pre-commit-hooks/compare/v4.5.0...v4.6.0)
- [github.com/python-jsonschema/check-jsonschema: 0.28.1 → 0.28.2](https://github.com/python-jsonschema/check-jsonschema/compare/0.28.1...0.28.2)
- [github.com/tox-dev/pyproject-fmt: 1.7.0 → 1.8.0](https://github.com/tox-dev/pyproject-fmt/compare/1.7.0...1.8.0)
---
 .pre-commit-config.yaml | 10 +++++-----
 1 file changed, 5 insertions(+), 5 deletions(-)

diff --git a/.pre-commit-config.yaml b/.pre-commit-config.yaml
index 51625eb4c89..1272913c9cc 100644
--- a/.pre-commit-config.yaml
+++ b/.pre-commit-config.yaml
@@ -1,12 +1,12 @@
 repos:
   - repo: https://github.com/astral-sh/ruff-pre-commit
-    rev: v0.3.4
+    rev: v0.4.3
     hooks:
       - id: ruff
         args: [--exit-non-zero-on-fix]
 
   - repo: https://github.com/psf/black-pre-commit-mirror
-    rev: 24.3.0
+    rev: 24.4.2
     hooks:
       - id: black
 
@@ -29,7 +29,7 @@ repos:
       - id: rst-backticks
 
   - repo: https://github.com/pre-commit/pre-commit-hooks
-    rev: v4.5.0
+    rev: v4.6.0
     hooks:
       - id: check-executables-have-shebangs
       - id: check-shebang-scripts-are-executable
@@ -43,7 +43,7 @@ repos:
         exclude: ^.github/.*TEMPLATE|^Tests/(fonts|images)/
 
   - repo: https://github.com/python-jsonschema/check-jsonschema
-    rev: 0.28.1
+    rev: 0.28.2
     hooks:
       - id: check-github-workflows
       - id: check-readthedocs
@@ -55,7 +55,7 @@ repos:
       - id: sphinx-lint
 
   - repo: https://github.com/tox-dev/pyproject-fmt
-    rev: 1.7.0
+    rev: 1.8.0
     hooks:
       - id: pyproject-fmt
 

From b17f1e507b1e44246b89938e5e4b5d53716751f0 Mon Sep 17 00:00:00 2001
From: Andrew Murray <radarhere@users.noreply.github.com>
Date: Tue, 7 May 2024 14:01:08 +1000
Subject: [PATCH 0599/1178] Use f-strings

---
 Tests/test_file_eps.py     | 4 +---
 selftest.py                | 4 ++--
 src/PIL/IptcImagePlugin.py | 2 +-
 src/PIL/PdfParser.py       | 5 +++--
 4 files changed, 7 insertions(+), 8 deletions(-)

diff --git a/Tests/test_file_eps.py b/Tests/test_file_eps.py
index d01884f96c5..1c21aa8ca67 100644
--- a/Tests/test_file_eps.py
+++ b/Tests/test_file_eps.py
@@ -336,9 +336,7 @@ def test_readline_psfile(tmp_path: Path) -> None:
     strings = ["something", "else", "baz", "bif"]
 
     def _test_readline(t: EpsImagePlugin.PSFile, ending: str) -> None:
-        ending = "Failure with line ending: %s" % (
-            "".join("%s" % ord(s) for s in ending)
-        )
+        ending = f"Failure with line ending: {''.join(str(ord(s)) for s in ending)}"
         assert t.readline().strip("\r\n") == "something", ending
         assert t.readline().strip("\r\n") == "else", ending
         assert t.readline().strip("\r\n") == "baz", ending
diff --git a/selftest.py b/selftest.py
index 661abcddb74..9e049367edc 100755
--- a/selftest.py
+++ b/selftest.py
@@ -165,9 +165,9 @@ def testimage() -> None:
     print("Running selftest:")
     status = doctest.testmod(sys.modules[__name__])
     if status[0]:
-        print("*** %s tests of %d failed." % status)
+        print(f"*** {status[0]} tests of {status[1]} failed.")
         exit_status = 1
     else:
-        print("--- %s tests passed." % status[1])
+        print(f"--- {status[1]} tests passed.")
 
     sys.exit(exit_status)
diff --git a/src/PIL/IptcImagePlugin.py b/src/PIL/IptcImagePlugin.py
index 4096094348a..73df83bfb31 100644
--- a/src/PIL/IptcImagePlugin.py
+++ b/src/PIL/IptcImagePlugin.py
@@ -57,7 +57,7 @@ def dump(c: Sequence[int | bytes]) -> None:
     """.. deprecated:: 10.2.0"""
     deprecate("IptcImagePlugin.dump", 12)
     for i in c:
-        print("%02x" % _i8(i), end=" ")
+        print(f"{_i8(i):02x}", end=" ")
     print()
 
 
diff --git a/src/PIL/PdfParser.py b/src/PIL/PdfParser.py
index c1ed7879741..65db70e133f 100644
--- a/src/PIL/PdfParser.py
+++ b/src/PIL/PdfParser.py
@@ -825,8 +825,9 @@ def get_value(cls, data, offset, expect_indirect=None, max_nesting=-1):
                 try:
                     stream_len = int(result[b"Length"])
                 except (TypeError, KeyError, ValueError) as e:
-                    msg = "bad or missing Length in stream dict (%r)" % result.get(
-                        b"Length", None
+                    msg = (
+                        "bad or missing Length in stream dict "
+                        f"({result.get(b'Length')})"
                     )
                     raise PdfFormatError(msg) from e
                 stream_data = data[m.end() : m.end() + stream_len]

From 7d81cbd0ede0dd9e516f7c3b5e2a42988dd105b5 Mon Sep 17 00:00:00 2001
From: Andrew Murray <radarhere@users.noreply.github.com>
Date: Tue, 7 May 2024 13:59:30 +1000
Subject: [PATCH 0600/1178] Do not use percent format

---
 Tests/test_image_access.py | 5 +++--
 1 file changed, 3 insertions(+), 2 deletions(-)

diff --git a/Tests/test_image_access.py b/Tests/test_image_access.py
index 02c75073add..f37ae60960b 100644
--- a/Tests/test_image_access.py
+++ b/Tests/test_image_access.py
@@ -415,7 +415,9 @@ def test_embeddable(self) -> None:
 
 int main(int argc, char* argv[])
 {
-    char *home = "%s";
+    char *home = \""""
+                + sys.prefix.replace("\\", "\\\\")
+                + """\";
     wchar_t *whome = Py_DecodeLocale(home, NULL);
     Py_SetPythonHome(whome);
 
@@ -432,7 +434,6 @@ def test_embeddable(self) -> None:
     return 0;
 }
         """
-                % sys.prefix.replace("\\", "\\\\")
             )
 
         compiler = getattr(build_ext, "new_compiler")()

From c92f59d758e0a1e308b148f31dd3b7f3f68f94b4 Mon Sep 17 00:00:00 2001
From: Sebastian Rittau <srittau@rittau.biz>
Date: Tue, 7 May 2024 14:30:34 +0200
Subject: [PATCH 0601/1178] Add various type annotations

---
 src/PIL/Image.py       | 58 +++++++++++++++++++++++++++++-------------
 src/PIL/ImageDraw.py   | 19 +++++++-------
 src/PIL/ImageFont.py   | 31 ++++++++++++----------
 src/PIL/_imagingft.pyi | 37 ++++++++++++++++++++++++++-
 4 files changed, 104 insertions(+), 41 deletions(-)

diff --git a/src/PIL/Image.py b/src/PIL/Image.py
index 2184ef8ea9e..f81e95695a8 100644
--- a/src/PIL/Image.py
+++ b/src/PIL/Image.py
@@ -41,7 +41,7 @@
 from collections.abc import Callable, MutableMapping
 from enum import IntEnum
 from types import ModuleType
-from typing import IO, TYPE_CHECKING, Any, Literal, Protocol, Sequence, cast
+from typing import IO, TYPE_CHECKING, Any, Literal, Protocol, Sequence, cast, overload
 
 # VERSION was removed in Pillow 6.0.0.
 # PILLOW_VERSION was removed in Pillow 9.0.0.
@@ -481,6 +481,8 @@ def _getscaleoffset(expr):
 # --------------------------------------------------------------------
 # Implementation wrapper
 
+class _GetDataTransform(Protocol):
+    def getdata(self) -> tuple[Transform, Sequence[int]]: ...
 
 class Image:
     """
@@ -1687,7 +1689,7 @@ def entropy(self, mask=None, extrema=None):
             return self.im.entropy(extrema)
         return self.im.entropy()
 
-    def paste(self, im, box=None, mask=None) -> None:
+    def paste(self, im: Image | str | int | tuple[int, ...], box: tuple[int, int, int, int] | tuple[int, int] | None = None, mask: Image | None = None) -> None:
         """
         Pastes another image into this image. The box argument is either
         a 2-tuple giving the upper left corner, a 4-tuple defining the
@@ -2122,7 +2124,7 @@ def _get_safe_box(self, size, resample, box):
             min(self.size[1], math.ceil(box[3] + support_y)),
         )
 
-    def resize(self, size, resample=None, box=None, reducing_gap=None) -> Image:
+    def resize(self, size: tuple[int, int], resample: Resampling | None = None, box: tuple[float, float, float, float] | None = None, reducing_gap: float | None = None) -> Image:
         """
         Returns a resized copy of this image.
 
@@ -2228,7 +2230,7 @@ def resize(self, size, resample=None, box=None, reducing_gap=None) -> Image:
 
         return self._new(self.im.resize(size, resample, box))
 
-    def reduce(self, factor, box=None):
+    def reduce(self, factor: int | tuple[int, int], box: tuple[int, int, int, int] | None = None) -> Image:
         """
         Returns a copy of the image reduced ``factor`` times.
         If the size of the image is not dividable by ``factor``,
@@ -2263,13 +2265,13 @@ def reduce(self, factor, box=None):
 
     def rotate(
         self,
-        angle,
-        resample=Resampling.NEAREST,
-        expand=0,
-        center=None,
-        translate=None,
-        fillcolor=None,
-    ):
+        angle: float,
+        resample: Resampling = Resampling.NEAREST,
+        expand: bool = False,
+        center: tuple[int, int] | None = None,
+        translate: tuple[int, int] | None = None,
+        fillcolor: float | tuple[float, ...] | str | None = None,
+    ) -> Image:
         """
         Returns a rotated copy of this image.  This method returns a
         copy of this image, rotated the given number of degrees counter
@@ -2576,7 +2578,7 @@ def tell(self) -> int:
         """
         return 0
 
-    def thumbnail(self, size, resample=Resampling.BICUBIC, reducing_gap=2.0):
+    def thumbnail(self, size: tuple[int, int], resample: Resampling = Resampling.BICUBIC, reducing_gap: float = 2.0) -> None:
         """
         Make this image into a thumbnail.  This method modifies the
         image to contain a thumbnail version of itself, no larger than
@@ -2664,14 +2666,34 @@ def round_aspect(number, key):
 
     # FIXME: the different transform methods need further explanation
     # instead of bloating the method docs, add a separate chapter.
+    @overload
+    def transform(
+        self,
+        size: tuple[int, int],
+        method: Transform | ImageTransformHandler,
+        data: Sequence[int],
+        resample: Resampling = Resampling.NEAREST,
+        fill: int = 1,
+        fillcolor: float | tuple[float, ...] | str | None = None,
+    ) -> Image: ...
+    @overload
     def transform(
         self,
-        size,
-        method,
-        data=None,
-        resample=Resampling.NEAREST,
-        fill=1,
-        fillcolor=None,
+        size: tuple[int, int],
+        method: _GetDataTransform,
+        data: None = None,
+        resample: Resampling = Resampling.NEAREST,
+        fill: int = 1,
+        fillcolor: float | tuple[float, ...] | str | None = None,
+    ) -> Image: ...
+    def transform(
+        self,
+        size: tuple[int, int],
+        method: Transform | ImageTransformHandler | _GetDataTransform,
+        data: Sequence[int] | None = None,
+        resample: Resampling = Resampling.NEAREST,
+        fill: int = 1,
+        fillcolor: float | tuple[float, ...] | str | None = None,
     ) -> Image:
         """
         Transforms this image.  This method creates a new image with the
diff --git a/src/PIL/ImageDraw.py b/src/PIL/ImageDraw.py
index d3efe64865e..579489fdeed 100644
--- a/src/PIL/ImageDraw.py
+++ b/src/PIL/ImageDraw.py
@@ -34,10 +34,11 @@
 import math
 import numbers
 import struct
-from typing import Sequence, cast
+from typing import AnyStr, Sequence, cast
 
 from . import Image, ImageColor
 from ._typing import Coords
+from .ImageFont import FreeTypeFont, ImageFont
 
 """
 A simple 2D drawing interface for PIL images.
@@ -92,7 +93,7 @@ def __init__(self, im: Image.Image, mode: str | None = None) -> None:
             self.fontmode = "L"  # aliasing is okay for other modes
         self.fill = False
 
-    def getfont(self):
+    def getfont(self) -> FreeTypeFont | ImageFont:
         """
         Get the current default font.
 
@@ -450,12 +451,12 @@ def draw_corners(pieslice) -> None:
                     right[3] -= r + 1
                 self.draw.draw_rectangle(right, ink, 1)
 
-    def _multiline_check(self, text) -> bool:
+    def _multiline_check(self, text: str | bytes) -> bool:
         split_character = "\n" if isinstance(text, str) else b"\n"
 
         return split_character in text
 
-    def _multiline_split(self, text) -> list[str | bytes]:
+    def _multiline_split(self, text: AnyStr) -> list[AnyStr]:
         split_character = "\n" if isinstance(text, str) else b"\n"
 
         return text.split(split_character)
@@ -469,7 +470,7 @@ def _multiline_spacing(self, font, spacing, stroke_width):
 
     def text(
         self,
-        xy,
+        xy: tuple[int, int],
         text,
         fill=None,
         font=None,
@@ -591,7 +592,7 @@ def draw_text(ink, stroke_width=0, stroke_offset=None) -> None:
 
     def multiline_text(
         self,
-        xy,
+        xy: tuple[int, int],
         text,
         fill=None,
         font=None,
@@ -678,15 +679,15 @@ def multiline_text(
 
     def textlength(
         self,
-        text,
-        font=None,
+        text: str,
+        font: FreeTypeFont | ImageFont | None = None,
         direction=None,
         features=None,
         language=None,
         embedded_color=False,
         *,
         font_size=None,
-    ):
+    ) -> float:
         """Get the length of a given string, in pixels with 1/64 precision."""
         if self._multiline_check(text):
             msg = "can't measure length of multiline text"
diff --git a/src/PIL/ImageFont.py b/src/PIL/ImageFont.py
index 256c581df0c..536ee5fe607 100644
--- a/src/PIL/ImageFont.py
+++ b/src/PIL/ImageFont.py
@@ -33,12 +33,15 @@
 import warnings
 from enum import IntEnum
 from io import BytesIO
-from typing import BinaryIO
+from typing import TYPE_CHECKING, BinaryIO
 
 from . import Image
 from ._typing import StrOrBytesPath
 from ._util import is_directory, is_path
 
+if TYPE_CHECKING:
+    from _imagingft import Font
+
 
 class Layout(IntEnum):
     BASIC = 0
@@ -56,7 +59,7 @@ class Layout(IntEnum):
     core = DeferredError.new(ex)
 
 
-def _string_length_check(text):
+def _string_length_check(text: str | bytes) -> None:
     if MAX_STRING_LENGTH is not None and len(text) > MAX_STRING_LENGTH:
         msg = "too many characters in string"
         raise ValueError(msg)
@@ -81,7 +84,9 @@ def _string_length_check(text):
 class ImageFont:
     """PIL font wrapper"""
 
-    def _load_pilfont(self, filename):
+    font: Font
+
+    def _load_pilfont(self, filename: str) -> None:
         with open(filename, "rb") as fp:
             image = None
             for ext in (".png", ".gif", ".pbm"):
@@ -153,7 +158,7 @@ def getmask(self, text, mode="", *args, **kwargs):
         Image._decompression_bomb_check(self.font.getsize(text))
         return self.font.getmask(text, mode)
 
-    def getbbox(self, text, *args, **kwargs):
+    def getbbox(self, text: str, *args: object, **kwargs: object) -> tuple[int, int, int, int]:
         """
         Returns bounding box (in pixels) of given text.
 
@@ -171,7 +176,7 @@ def getbbox(self, text, *args, **kwargs):
         width, height = self.font.getsize(text)
         return 0, 0, width, height
 
-    def getlength(self, text, *args, **kwargs):
+    def getlength(self, text: str, *args: object, **kwargs: object) -> int:
         """
         Returns length (in pixels) of given text.
         This is the amount by which following text should be offset.
@@ -254,7 +259,7 @@ def __setstate__(self, state):
         path, size, index, encoding, layout_engine = state
         self.__init__(path, size, index, encoding, layout_engine)
 
-    def getname(self):
+    def getname(self) -> tuple[str, str]:
         """
         :return: A tuple of the font family (e.g. Helvetica) and the font style
             (e.g. Bold)
@@ -269,7 +274,7 @@ def getmetrics(self):
         """
         return self.font.ascent, self.font.descent
 
-    def getlength(self, text, mode="", direction=None, features=None, language=None):
+    def getlength(self, text: str, mode="", direction=None, features=None, language=None) -> float:
         """
         Returns length (in pixels with 1/64 precision) of given text when rendered
         in font with provided direction, features, and language.
@@ -343,14 +348,14 @@ def getlength(self, text, mode="", direction=None, features=None, language=None)
 
     def getbbox(
         self,
-        text,
+        text: str,
         mode="",
         direction=None,
         features=None,
         language=None,
         stroke_width=0,
         anchor=None,
-    ):
+    ) -> tuple[int, int, int, int]:
         """
         Returns bounding box (in pixels) of given text relative to given anchor
         when rendered in font with provided direction, features, and language.
@@ -725,7 +730,7 @@ def getlength(self, text, *args, **kwargs):
         return self.font.getlength(text, *args, **kwargs)
 
 
-def load(filename):
+def load(filename: str) -> ImageFont:
     """
     Load a font file.  This function loads a font object from the given
     bitmap font file, and returns the corresponding font object.
@@ -739,7 +744,7 @@ def load(filename):
     return f
 
 
-def truetype(font=None, size=10, index=0, encoding="", layout_engine=None):
+def truetype(font: StrOrBytesPath | BinaryIO | None = None, size: float = 10, index: int = 0, encoding: str = "", layout_engine: Layout | None = None) -> FreeTypeFont:
     """
     Load a TrueType or OpenType font from a file or file-like object,
     and create a font object.
@@ -800,7 +805,7 @@ def truetype(font=None, size=10, index=0, encoding="", layout_engine=None):
     :exception ValueError: If the font size is not greater than zero.
     """
 
-    def freetype(font):
+    def freetype(font: StrOrBytesPath | BinaryIO | None) -> FreeTypeFont:
         return FreeTypeFont(font, size, index, encoding, layout_engine)
 
     try:
@@ -850,7 +855,7 @@ def freetype(font):
         raise
 
 
-def load_path(filename):
+def load_path(filename: str | bytes) -> ImageFont:
     """
     Load font file. Same as :py:func:`~PIL.ImageFont.load`, but searches for a
     bitmap font along the Python path.
diff --git a/src/PIL/_imagingft.pyi b/src/PIL/_imagingft.pyi
index e27843e5338..2c2ea9a54a7 100644
--- a/src/PIL/_imagingft.pyi
+++ b/src/PIL/_imagingft.pyi
@@ -1,3 +1,38 @@
-from typing import Any
+from typing import Any, TypedDict
+
+class _Axis(TypedDict):
+    minimum: int | None
+    default: int | None
+    maximum: int | None
+    name: str | None
+
+
+class Font:
+    @property
+    def family(self) -> str | None: ...
+    @property
+    def style(self) -> str | None: ...
+    @property
+    def ascent(self) -> int: ...
+    @property
+    def descent(self) -> int: ...
+    @property
+    def height(self) -> int: ...
+    @property
+    def x_ppem(self) -> int: ...
+    @property
+    def y_ppem(self) -> int: ...
+    @property
+    def glyphs(self) -> int: ...
+
+    def render(self, string: str, fill, mode = ..., dir = ..., features = ..., lang = ..., stroke_width = ..., anchor = ..., foreground_ink_long = ..., x_start = ..., y_start = ..., /) -> tuple[Any, tuple[int, int]]: ...
+    def getsize(self, string: str, mode = ..., dir = ..., features = ..., lang = ..., anchor = ..., /) -> tuple[tuple[int, int], tuple[int, int]]: ...
+    def getlength(self, string: str, mode = ..., dir = ..., features = ..., lang = ..., /) -> int: ...
+    def getvarnames(self) -> list[str]: ...
+    def getvaraxes(self) -> list[_Axis]: ...
+    def setvarname(self, instance_index: int, /) -> None: ...
+    def setvaraxes(self, axes: list[float], /) -> None: ...
+
+def getfont(filename: str | bytes | bytearray, size, index = ..., encoding = ..., font_bytes = ..., layout_engine = ...) -> Font: ...
 
 def __getattr__(name: str) -> Any: ...

From 1aa3886ed76b3f8fc60d604a34dffe573b491c20 Mon Sep 17 00:00:00 2001
From: "pre-commit-ci[bot]"
 <66853113+pre-commit-ci[bot]@users.noreply.github.com>
Date: Tue, 7 May 2024 12:33:59 +0000
Subject: [PATCH 0602/1178] [pre-commit.ci] auto fixes from pre-commit.com
 hooks

for more information, see https://pre-commit.ci
---
 src/PIL/Image.py       | 30 ++++++++++++++++++++++++++----
 src/PIL/ImageFont.py   | 16 +++++++++++++---
 src/PIL/_imagingft.pyi | 36 +++++++++++++++++++++++++++++-------
 3 files changed, 68 insertions(+), 14 deletions(-)

diff --git a/src/PIL/Image.py b/src/PIL/Image.py
index f81e95695a8..9f55ea9242c 100644
--- a/src/PIL/Image.py
+++ b/src/PIL/Image.py
@@ -481,9 +481,11 @@ def _getscaleoffset(expr):
 # --------------------------------------------------------------------
 # Implementation wrapper
 
+
 class _GetDataTransform(Protocol):
     def getdata(self) -> tuple[Transform, Sequence[int]]: ...
 
+
 class Image:
     """
     This class represents an image object.  To create
@@ -1689,7 +1691,12 @@ def entropy(self, mask=None, extrema=None):
             return self.im.entropy(extrema)
         return self.im.entropy()
 
-    def paste(self, im: Image | str | int | tuple[int, ...], box: tuple[int, int, int, int] | tuple[int, int] | None = None, mask: Image | None = None) -> None:
+    def paste(
+        self,
+        im: Image | str | int | tuple[int, ...],
+        box: tuple[int, int, int, int] | tuple[int, int] | None = None,
+        mask: Image | None = None,
+    ) -> None:
         """
         Pastes another image into this image. The box argument is either
         a 2-tuple giving the upper left corner, a 4-tuple defining the
@@ -2124,7 +2131,13 @@ def _get_safe_box(self, size, resample, box):
             min(self.size[1], math.ceil(box[3] + support_y)),
         )
 
-    def resize(self, size: tuple[int, int], resample: Resampling | None = None, box: tuple[float, float, float, float] | None = None, reducing_gap: float | None = None) -> Image:
+    def resize(
+        self,
+        size: tuple[int, int],
+        resample: Resampling | None = None,
+        box: tuple[float, float, float, float] | None = None,
+        reducing_gap: float | None = None,
+    ) -> Image:
         """
         Returns a resized copy of this image.
 
@@ -2230,7 +2243,11 @@ def resize(self, size: tuple[int, int], resample: Resampling | None = None, box:
 
         return self._new(self.im.resize(size, resample, box))
 
-    def reduce(self, factor: int | tuple[int, int], box: tuple[int, int, int, int] | None = None) -> Image:
+    def reduce(
+        self,
+        factor: int | tuple[int, int],
+        box: tuple[int, int, int, int] | None = None,
+    ) -> Image:
         """
         Returns a copy of the image reduced ``factor`` times.
         If the size of the image is not dividable by ``factor``,
@@ -2578,7 +2595,12 @@ def tell(self) -> int:
         """
         return 0
 
-    def thumbnail(self, size: tuple[int, int], resample: Resampling = Resampling.BICUBIC, reducing_gap: float = 2.0) -> None:
+    def thumbnail(
+        self,
+        size: tuple[int, int],
+        resample: Resampling = Resampling.BICUBIC,
+        reducing_gap: float = 2.0,
+    ) -> None:
         """
         Make this image into a thumbnail.  This method modifies the
         image to contain a thumbnail version of itself, no larger than
diff --git a/src/PIL/ImageFont.py b/src/PIL/ImageFont.py
index 536ee5fe607..fb7e1d8b614 100644
--- a/src/PIL/ImageFont.py
+++ b/src/PIL/ImageFont.py
@@ -158,7 +158,9 @@ def getmask(self, text, mode="", *args, **kwargs):
         Image._decompression_bomb_check(self.font.getsize(text))
         return self.font.getmask(text, mode)
 
-    def getbbox(self, text: str, *args: object, **kwargs: object) -> tuple[int, int, int, int]:
+    def getbbox(
+        self, text: str, *args: object, **kwargs: object
+    ) -> tuple[int, int, int, int]:
         """
         Returns bounding box (in pixels) of given text.
 
@@ -274,7 +276,9 @@ def getmetrics(self):
         """
         return self.font.ascent, self.font.descent
 
-    def getlength(self, text: str, mode="", direction=None, features=None, language=None) -> float:
+    def getlength(
+        self, text: str, mode="", direction=None, features=None, language=None
+    ) -> float:
         """
         Returns length (in pixels with 1/64 precision) of given text when rendered
         in font with provided direction, features, and language.
@@ -744,7 +748,13 @@ def load(filename: str) -> ImageFont:
     return f
 
 
-def truetype(font: StrOrBytesPath | BinaryIO | None = None, size: float = 10, index: int = 0, encoding: str = "", layout_engine: Layout | None = None) -> FreeTypeFont:
+def truetype(
+    font: StrOrBytesPath | BinaryIO | None = None,
+    size: float = 10,
+    index: int = 0,
+    encoding: str = "",
+    layout_engine: Layout | None = None,
+) -> FreeTypeFont:
     """
     Load a TrueType or OpenType font from a file or file-like object,
     and create a font object.
diff --git a/src/PIL/_imagingft.pyi b/src/PIL/_imagingft.pyi
index 2c2ea9a54a7..987e7fd6f49 100644
--- a/src/PIL/_imagingft.pyi
+++ b/src/PIL/_imagingft.pyi
@@ -6,7 +6,6 @@ class _Axis(TypedDict):
     maximum: int | None
     name: str | None
 
-
 class Font:
     @property
     def family(self) -> str | None: ...
@@ -24,15 +23,38 @@ class Font:
     def y_ppem(self) -> int: ...
     @property
     def glyphs(self) -> int: ...
-
-    def render(self, string: str, fill, mode = ..., dir = ..., features = ..., lang = ..., stroke_width = ..., anchor = ..., foreground_ink_long = ..., x_start = ..., y_start = ..., /) -> tuple[Any, tuple[int, int]]: ...
-    def getsize(self, string: str, mode = ..., dir = ..., features = ..., lang = ..., anchor = ..., /) -> tuple[tuple[int, int], tuple[int, int]]: ...
-    def getlength(self, string: str, mode = ..., dir = ..., features = ..., lang = ..., /) -> int: ...
+    def render(
+        self,
+        string: str,
+        fill,
+        mode=...,
+        dir=...,
+        features=...,
+        lang=...,
+        stroke_width=...,
+        anchor=...,
+        foreground_ink_long=...,
+        x_start=...,
+        y_start=...,
+        /,
+    ) -> tuple[Any, tuple[int, int]]: ...
+    def getsize(
+        self, string: str, mode=..., dir=..., features=..., lang=..., anchor=..., /
+    ) -> tuple[tuple[int, int], tuple[int, int]]: ...
+    def getlength(
+        self, string: str, mode=..., dir=..., features=..., lang=..., /
+    ) -> int: ...
     def getvarnames(self) -> list[str]: ...
     def getvaraxes(self) -> list[_Axis]: ...
     def setvarname(self, instance_index: int, /) -> None: ...
     def setvaraxes(self, axes: list[float], /) -> None: ...
 
-def getfont(filename: str | bytes | bytearray, size, index = ..., encoding = ..., font_bytes = ..., layout_engine = ...) -> Font: ...
-
+def getfont(
+    filename: str | bytes | bytearray,
+    size,
+    index=...,
+    encoding=...,
+    font_bytes=...,
+    layout_engine=...,
+) -> Font: ...
 def __getattr__(name: str) -> Any: ...

From d44e9fccb16c63005fbffce06c16a0afc2b26667 Mon Sep 17 00:00:00 2001
From: Sebastian Rittau <srittau@rittau.biz>
Date: Tue, 7 May 2024 14:53:26 +0200
Subject: [PATCH 0603/1178] Various fixes

---
 src/PIL/Image.py     | 46 ++++++++++++++++++++++++++++----------------
 src/PIL/ImageFont.py |  2 +-
 2 files changed, 30 insertions(+), 18 deletions(-)

diff --git a/src/PIL/Image.py b/src/PIL/Image.py
index 9f55ea9242c..f6f070feef3 100644
--- a/src/PIL/Image.py
+++ b/src/PIL/Image.py
@@ -483,7 +483,7 @@ def _getscaleoffset(expr):
 
 
 class _GetDataTransform(Protocol):
-    def getdata(self) -> tuple[Transform, Sequence[int]]: ...
+    def getdata(self) -> tuple[Transform, Sequence[float]]: ...
 
 
 class Image:
@@ -2134,7 +2134,7 @@ def _get_safe_box(self, size, resample, box):
     def resize(
         self,
         size: tuple[int, int],
-        resample: Resampling | None = None,
+        resample: int | None = None,
         box: tuple[float, float, float, float] | None = None,
         reducing_gap: float | None = None,
     ) -> Image:
@@ -2202,13 +2202,13 @@ def resize(
             msg = "reducing_gap must be 1.0 or greater"
             raise ValueError(msg)
 
-        size = tuple(size)
+        size = cast(tuple[int, int], tuple(size))
 
         self.load()
         if box is None:
             box = (0, 0) + self.size
         else:
-            box = tuple(box)
+            box = cast(tuple[float, float, float, float], tuple(box))
 
         if self.size == size and box == (0, 0) + self.size:
             return self.copy()
@@ -2266,7 +2266,7 @@ def reduce(
         if box is None:
             box = (0, 0) + self.size
         else:
-            box = tuple(box)
+            box = cast(tuple[int, int, int, int], tuple(box))
 
         if factor == (1, 1) and box == (0, 0) + self.size:
             return self.copy()
@@ -2283,7 +2283,7 @@ def reduce(
     def rotate(
         self,
         angle: float,
-        resample: Resampling = Resampling.NEAREST,
+        resample: int = Resampling.NEAREST,
         expand: bool = False,
         center: tuple[int, int] | None = None,
         translate: tuple[int, int] | None = None,
@@ -2598,7 +2598,7 @@ def tell(self) -> int:
     def thumbnail(
         self,
         size: tuple[int, int],
-        resample: Resampling = Resampling.BICUBIC,
+        resample: int = Resampling.BICUBIC,
         reducing_gap: float = 2.0,
     ) -> None:
         """
@@ -2661,20 +2661,22 @@ def round_aspect(number, key):
 
         box = None
         if reducing_gap is not None:
-            size = preserve_aspect_ratio()
-            if size is None:
+            preserved_size = preserve_aspect_ratio()
+            if preserved_size is None:
                 return
+            size = preserved_size
 
-            res = self.draft(None, (size[0] * reducing_gap, size[1] * reducing_gap))
+            res = self.draft(None, (size[0] * reducing_gap, size[1] * reducing_gap))  # type: ignore[arg-type]
             if res is not None:
                 box = res[1]
         if box is None:
             self.load()
 
             # load() may have changed the size of the image
-            size = preserve_aspect_ratio()
-            if size is None:
+            preserved_size = preserve_aspect_ratio()
+            if preserved_size is None:
                 return
+            size = preserved_size
 
         if self.size != size:
             im = self.resize(size, resample, box=box, reducing_gap=reducing_gap)
@@ -2693,8 +2695,8 @@ def transform(
         self,
         size: tuple[int, int],
         method: Transform | ImageTransformHandler,
-        data: Sequence[int],
-        resample: Resampling = Resampling.NEAREST,
+        data: Sequence[float],
+        resample: int = Resampling.NEAREST,
         fill: int = 1,
         fillcolor: float | tuple[float, ...] | str | None = None,
     ) -> Image: ...
@@ -2704,7 +2706,17 @@ def transform(
         size: tuple[int, int],
         method: _GetDataTransform,
         data: None = None,
-        resample: Resampling = Resampling.NEAREST,
+        resample: int = Resampling.NEAREST,
+        fill: int = 1,
+        fillcolor: float | tuple[float, ...] | str | None = None,
+    ) -> Image: ...
+    @overload
+    def transform(
+        self,
+        size: tuple[int, int],
+        method: Transform | ImageTransformHandler | _GetDataTransform,
+        data: Sequence[float] | None = None,
+        resample: int = Resampling.NEAREST,
         fill: int = 1,
         fillcolor: float | tuple[float, ...] | str | None = None,
     ) -> Image: ...
@@ -2712,8 +2724,8 @@ def transform(
         self,
         size: tuple[int, int],
         method: Transform | ImageTransformHandler | _GetDataTransform,
-        data: Sequence[int] | None = None,
-        resample: Resampling = Resampling.NEAREST,
+        data: Sequence[float] | None = None,
+        resample: int = Resampling.NEAREST,
         fill: int = 1,
         fillcolor: float | tuple[float, ...] | str | None = None,
     ) -> Image:
diff --git a/src/PIL/ImageFont.py b/src/PIL/ImageFont.py
index fb7e1d8b614..a1b722765a3 100644
--- a/src/PIL/ImageFont.py
+++ b/src/PIL/ImageFont.py
@@ -40,7 +40,7 @@
 from ._util import is_directory, is_path
 
 if TYPE_CHECKING:
-    from _imagingft import Font
+    from ._imagingft import Font
 
 
 class Layout(IntEnum):

From d63caf266d2561b1646ed378761332e0855dd73d Mon Sep 17 00:00:00 2001
From: Sebastian Rittau <srittau@rittau.biz>
Date: Tue, 7 May 2024 15:59:20 +0200
Subject: [PATCH 0604/1178] Various fixes

---
 src/PIL/Image.py          | 44 +++++++--------------------------------
 src/PIL/ImageDraw.py      | 24 ++++++++++-----------
 src/PIL/ImageFont.py      | 13 +++++++++---
 src/PIL/ImageTransform.py |  4 ++--
 src/PIL/_imaging.pyi      | 15 +++++++++++++
 5 files changed, 47 insertions(+), 53 deletions(-)

diff --git a/src/PIL/Image.py b/src/PIL/Image.py
index f6f070feef3..9b0c24ec09a 100644
--- a/src/PIL/Image.py
+++ b/src/PIL/Image.py
@@ -41,7 +41,7 @@
 from collections.abc import Callable, MutableMapping
 from enum import IntEnum
 from types import ModuleType
-from typing import IO, TYPE_CHECKING, Any, Literal, Protocol, Sequence, cast, overload
+from typing import IO, TYPE_CHECKING, Any, Literal, Protocol, Sequence, cast
 
 # VERSION was removed in Pillow 6.0.0.
 # PILLOW_VERSION was removed in Pillow 9.0.0.
@@ -483,7 +483,9 @@ def _getscaleoffset(expr):
 
 
 class _GetDataTransform(Protocol):
-    def getdata(self) -> tuple[Transform, Sequence[float]]: ...
+    def getdata(
+        self,
+    ) -> tuple[Transform, Sequence[Any]]: ...
 
 
 class Image:
@@ -2690,41 +2692,11 @@ def round_aspect(number, key):
 
     # FIXME: the different transform methods need further explanation
     # instead of bloating the method docs, add a separate chapter.
-    @overload
-    def transform(
-        self,
-        size: tuple[int, int],
-        method: Transform | ImageTransformHandler,
-        data: Sequence[float],
-        resample: int = Resampling.NEAREST,
-        fill: int = 1,
-        fillcolor: float | tuple[float, ...] | str | None = None,
-    ) -> Image: ...
-    @overload
-    def transform(
-        self,
-        size: tuple[int, int],
-        method: _GetDataTransform,
-        data: None = None,
-        resample: int = Resampling.NEAREST,
-        fill: int = 1,
-        fillcolor: float | tuple[float, ...] | str | None = None,
-    ) -> Image: ...
-    @overload
-    def transform(
-        self,
-        size: tuple[int, int],
-        method: Transform | ImageTransformHandler | _GetDataTransform,
-        data: Sequence[float] | None = None,
-        resample: int = Resampling.NEAREST,
-        fill: int = 1,
-        fillcolor: float | tuple[float, ...] | str | None = None,
-    ) -> Image: ...
     def transform(
         self,
         size: tuple[int, int],
         method: Transform | ImageTransformHandler | _GetDataTransform,
-        data: Sequence[float] | None = None,
+        data: Sequence[Any] | None = None,
         resample: int = Resampling.NEAREST,
         fill: int = 1,
         fillcolor: float | tuple[float, ...] | str | None = None,
@@ -2803,7 +2775,7 @@ def getdata(self):
         im.info = self.info.copy()
         if method == Transform.MESH:
             # list of quads
-            for box, quad in data:
+            for box, quad in cast(Sequence[tuple[float, float]], data):
                 im.__transformer(
                     box, self, Transform.QUAD, quad, resample, fillcolor is None
                 )
@@ -2961,7 +2933,7 @@ def transform(
         self,
         size: tuple[int, int],
         image: Image,
-        **options: dict[str, str | int | tuple[int, ...] | list[int]],
+        **options: dict[str, str | int | tuple[int, ...] | list[int]] | int,
     ) -> Image:
         pass
 
@@ -3830,7 +3802,7 @@ def _get_ifd_dict(self, offset, group=None):
             return self._fixup_dict(info)
 
     def _get_head(self):
-        version = b"\x2B" if self.bigtiff else b"\x2A"
+        version = b"\x2b" if self.bigtiff else b"\x2a"
         if self.endian == "<":
             head = b"II" + version + b"\x00" + o32le(8)
         else:
diff --git a/src/PIL/ImageDraw.py b/src/PIL/ImageDraw.py
index 579489fdeed..ec8a9a67d5f 100644
--- a/src/PIL/ImageDraw.py
+++ b/src/PIL/ImageDraw.py
@@ -118,7 +118,7 @@ def getfont(self) -> FreeTypeFont | ImageFont:
             self.font = ImageFont.load_default()
         return self.font
 
-    def _getfont(self, font_size: float | None):
+    def _getfont(self, font_size: float | None) -> FreeTypeFont | ImageFont:
         if font_size is not None:
             from . import ImageFont
 
@@ -451,13 +451,13 @@ def draw_corners(pieslice) -> None:
                     right[3] -= r + 1
                 self.draw.draw_rectangle(right, ink, 1)
 
-    def _multiline_check(self, text: str | bytes) -> bool:
-        split_character = "\n" if isinstance(text, str) else b"\n"
+    def _multiline_check(self, text: AnyStr) -> bool:
+        split_character = cast(AnyStr, "\n" if isinstance(text, str) else b"\n")
 
         return split_character in text
 
     def _multiline_split(self, text: AnyStr) -> list[AnyStr]:
-        split_character = "\n" if isinstance(text, str) else b"\n"
+        split_character = cast(AnyStr, "\n" if isinstance(text, str) else b"\n")
 
         return text.split(split_character)
 
@@ -470,10 +470,10 @@ def _multiline_spacing(self, font, spacing, stroke_width):
 
     def text(
         self,
-        xy: tuple[int, int],
-        text,
+        xy: tuple[float, float],
+        text: str,
         fill=None,
-        font=None,
+        font: FreeTypeFont | ImageFont | None = None,
         anchor=None,
         spacing=4,
         align="left",
@@ -527,7 +527,7 @@ def draw_text(ink, stroke_width=0, stroke_offset=None) -> None:
                 coord.append(int(xy[i]))
                 start.append(math.modf(xy[i])[0])
             try:
-                mask, offset = font.getmask2(
+                mask, offset = font.getmask2(  # type: ignore[union-attr,misc]
                     text,
                     mode,
                     direction=direction,
@@ -543,7 +543,7 @@ def draw_text(ink, stroke_width=0, stroke_offset=None) -> None:
                 coord = [coord[0] + offset[0], coord[1] + offset[1]]
             except AttributeError:
                 try:
-                    mask = font.getmask(
+                    mask = font.getmask(  # type: ignore[misc]
                         text,
                         mode,
                         direction,
@@ -592,7 +592,7 @@ def draw_text(ink, stroke_width=0, stroke_offset=None) -> None:
 
     def multiline_text(
         self,
-        xy: tuple[int, int],
+        xy: tuple[float, float],
         text,
         fill=None,
         font=None,
@@ -625,7 +625,7 @@ def multiline_text(
             font = self._getfont(font_size)
 
         widths = []
-        max_width = 0
+        max_width: float = 0
         lines = self._multiline_split(text)
         line_spacing = self._multiline_spacing(font, spacing, stroke_width)
         for line in lines:
@@ -779,7 +779,7 @@ def multiline_textbbox(
             font = self._getfont(font_size)
 
         widths = []
-        max_width = 0
+        max_width: float = 0
         lines = self._multiline_split(text)
         line_spacing = self._multiline_spacing(font, spacing, stroke_width)
         for line in lines:
diff --git a/src/PIL/ImageFont.py b/src/PIL/ImageFont.py
index a1b722765a3..9eca3bc9877 100644
--- a/src/PIL/ImageFont.py
+++ b/src/PIL/ImageFont.py
@@ -35,11 +35,14 @@
 from io import BytesIO
 from typing import TYPE_CHECKING, BinaryIO
 
+from PIL import ImageFile
+
 from . import Image
 from ._typing import StrOrBytesPath
 from ._util import is_directory, is_path
 
 if TYPE_CHECKING:
+    from ._imaging import ImagingFont
     from ._imagingft import Font
 
 
@@ -84,11 +87,11 @@ def _string_length_check(text: str | bytes) -> None:
 class ImageFont:
     """PIL font wrapper"""
 
-    font: Font
+    font: ImagingFont
 
     def _load_pilfont(self, filename: str) -> None:
         with open(filename, "rb") as fp:
-            image = None
+            image: ImageFile.ImageFile | None = None
             for ext in (".png", ".gif", ".pbm"):
                 if image:
                     image.close()
@@ -198,6 +201,8 @@ def getlength(self, text: str, *args: object, **kwargs: object) -> int:
 class FreeTypeFont:
     """FreeType font wrapper (requires _imagingft service)"""
 
+    font: Font
+
     def __init__(
         self,
         font: StrOrBytesPath | BinaryIO | None = None,
@@ -261,7 +266,7 @@ def __setstate__(self, state):
         path, size, index, encoding, layout_engine = state
         self.__init__(path, size, index, encoding, layout_engine)
 
-    def getname(self) -> tuple[str, str]:
+    def getname(self) -> tuple[str | None, str | None]:
         """
         :return: A tuple of the font family (e.g. Helvetica) and the font style
             (e.g. Bold)
@@ -876,6 +881,7 @@ def load_path(filename: str | bytes) -> ImageFont:
     """
     for directory in sys.path:
         if is_directory(directory):
+            assert isinstance(directory, str)
             if not isinstance(filename, str):
                 filename = filename.decode("utf-8")
             try:
@@ -900,6 +906,7 @@ def load_default(size: float | None = None) -> FreeTypeFont | ImageFont:
 
     :return: A font object.
     """
+    f: FreeTypeFont | ImageFont
     if core.__class__.__name__ == "module" or size is not None:
         f = truetype(
             BytesIO(
diff --git a/src/PIL/ImageTransform.py b/src/PIL/ImageTransform.py
index 6aa82dadd9c..80a6116b7cf 100644
--- a/src/PIL/ImageTransform.py
+++ b/src/PIL/ImageTransform.py
@@ -14,7 +14,7 @@
 #
 from __future__ import annotations
 
-from typing import Sequence
+from typing import Any, Sequence
 
 from . import Image
 
@@ -34,7 +34,7 @@ def transform(
         self,
         size: tuple[int, int],
         image: Image.Image,
-        **options: dict[str, str | int | tuple[int, ...] | list[int]],
+        **options: Any,
     ) -> Image.Image:
         """Perform the transform. Called from :py:meth:`.Image.transform`."""
         # can be overridden
diff --git a/src/PIL/_imaging.pyi b/src/PIL/_imaging.pyi
index e27843e5338..d85eb84fa69 100644
--- a/src/PIL/_imaging.pyi
+++ b/src/PIL/_imaging.pyi
@@ -1,3 +1,18 @@
 from typing import Any
 
+from typing_extensions import Buffer
+
+class ImagingCore:
+    def __getattr__(self, name: str) -> Any: ...
+
+class ImagingFont:
+    def __getattr__(self, name: str) -> Any: ...
+
+class ImagingDraw:
+    def __getattr__(self, name: str) -> Any: ...
+
+class PixelAccess:
+    def __getattr__(self, name: str) -> Any: ...
+
+def font(image, glyphdata: Buffer) -> ImagingFont: ...
 def __getattr__(name: str) -> Any: ...

From ed0867abecd7f4ce8eb300c4896229fcedeee6c4 Mon Sep 17 00:00:00 2001
From: Andrew Murray <radarhere@users.noreply.github.com>
Date: Wed, 8 May 2024 06:30:43 +1000
Subject: [PATCH 0605/1178] Set stream length for later use

---
 src/PIL/PdfParser.py | 10 ++++------
 1 file changed, 4 insertions(+), 6 deletions(-)

diff --git a/src/PIL/PdfParser.py b/src/PIL/PdfParser.py
index 65db70e133f..c43f2da7baa 100644
--- a/src/PIL/PdfParser.py
+++ b/src/PIL/PdfParser.py
@@ -823,12 +823,10 @@ def get_value(cls, data, offset, expect_indirect=None, max_nesting=-1):
             m = cls.re_stream_start.match(data, offset)
             if m:
                 try:
-                    stream_len = int(result[b"Length"])
-                except (TypeError, KeyError, ValueError) as e:
-                    msg = (
-                        "bad or missing Length in stream dict "
-                        f"({result.get(b'Length')})"
-                    )
+                    stream_len_str = result.get(b"Length")
+                    stream_len = int(stream_len_str)
+                except (TypeError, ValueError) as e:
+                    msg = f"bad or missing Length in stream dict ({stream_len_str})"
                     raise PdfFormatError(msg) from e
                 stream_data = data[m.end() : m.end() + stream_len]
                 m = cls.re_stream_end.match(data, m.end() + stream_len)

From a3356879fd5b0685b3741d6f43802626a3f5d2e0 Mon Sep 17 00:00:00 2001
From: Andrew Murray <radarhere@users.noreply.github.com>
Date: Wed, 8 May 2024 17:57:36 +1000
Subject: [PATCH 0606/1178] Use f-string

---
 Tests/test_image_access.py | 11 +++++------
 1 file changed, 5 insertions(+), 6 deletions(-)

diff --git a/Tests/test_image_access.py b/Tests/test_image_access.py
index f37ae60960b..e55a4d9c1fb 100644
--- a/Tests/test_image_access.py
+++ b/Tests/test_image_access.py
@@ -409,15 +409,14 @@ def test_embeddable(self) -> None:
         from setuptools.command import build_ext
 
         with open("embed_pil.c", "w", encoding="utf-8") as fh:
+            home = sys.prefix.replace("\\", "\\\\")
             fh.write(
-                """
+                f"""
 #include "Python.h"
 
 int main(int argc, char* argv[])
-{
-    char *home = \""""
-                + sys.prefix.replace("\\", "\\\\")
-                + """\";
+{{
+    char *home = "{home}";
     wchar_t *whome = Py_DecodeLocale(home, NULL);
     Py_SetPythonHome(whome);
 
@@ -432,7 +431,7 @@ def test_embeddable(self) -> None:
     PyMem_RawFree(whome);
 
     return 0;
-}
+}}
         """
             )
 

From ef35d7926439e6fe8c36abc0846f859aaf3a893d Mon Sep 17 00:00:00 2001
From: Sebastian Rittau <srittau@rittau.biz>
Date: Wed, 8 May 2024 12:14:37 +0200
Subject: [PATCH 0607/1178] Python 3.8 compatibility

---
 src/PIL/Image.py | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/src/PIL/Image.py b/src/PIL/Image.py
index 9b0c24ec09a..31e6fdb83a8 100644
--- a/src/PIL/Image.py
+++ b/src/PIL/Image.py
@@ -2204,7 +2204,7 @@ def resize(
             msg = "reducing_gap must be 1.0 or greater"
             raise ValueError(msg)
 
-        size = cast(tuple[int, int], tuple(size))
+        size = cast("tuple[int, int]", tuple(size))
 
         self.load()
         if box is None:

From 7ae8d37138c8678e4a84210aa899df422fadaab1 Mon Sep 17 00:00:00 2001
From: Sebastian Rittau <srittau@rittau.biz>
Date: Wed, 8 May 2024 12:14:59 +0200
Subject: [PATCH 0608/1178] Make `GetDataTransform` public

---
 src/PIL/Image.py | 4 ++--
 1 file changed, 2 insertions(+), 2 deletions(-)

diff --git a/src/PIL/Image.py b/src/PIL/Image.py
index 31e6fdb83a8..ed1621e6244 100644
--- a/src/PIL/Image.py
+++ b/src/PIL/Image.py
@@ -482,7 +482,7 @@ def _getscaleoffset(expr):
 # Implementation wrapper
 
 
-class _GetDataTransform(Protocol):
+class GetDataTransform(Protocol):
     def getdata(
         self,
     ) -> tuple[Transform, Sequence[Any]]: ...
@@ -2695,7 +2695,7 @@ def round_aspect(number, key):
     def transform(
         self,
         size: tuple[int, int],
-        method: Transform | ImageTransformHandler | _GetDataTransform,
+        method: Transform | ImageTransformHandler | GetDataTransform,
         data: Sequence[Any] | None = None,
         resample: int = Resampling.NEAREST,
         fill: int = 1,

From 296050f3823c4648e6e7eb351e433343eddc9cee Mon Sep 17 00:00:00 2001
From: Sebastian Rittau <srittau@rittau.biz>
Date: Wed, 8 May 2024 12:26:45 +0200
Subject: [PATCH 0609/1178] More Python 3.8 compatibility

---
 src/PIL/Image.py | 4 ++--
 1 file changed, 2 insertions(+), 2 deletions(-)

diff --git a/src/PIL/Image.py b/src/PIL/Image.py
index ed1621e6244..8348ea257d8 100644
--- a/src/PIL/Image.py
+++ b/src/PIL/Image.py
@@ -2210,7 +2210,7 @@ def resize(
         if box is None:
             box = (0, 0) + self.size
         else:
-            box = cast(tuple[float, float, float, float], tuple(box))
+            box = cast("tuple[float, float, float, float]", tuple(box))
 
         if self.size == size and box == (0, 0) + self.size:
             return self.copy()
@@ -2268,7 +2268,7 @@ def reduce(
         if box is None:
             box = (0, 0) + self.size
         else:
-            box = cast(tuple[int, int, int, int], tuple(box))
+            box = cast("tuple[int, int, int, int]", tuple(box))
 
         if factor == (1, 1) and box == (0, 0) + self.size:
             return self.copy()

From bb8718e58162cdcd6a9b80eca45f7b2c8321bca9 Mon Sep 17 00:00:00 2001
From: Sebastian Rittau <srittau@rittau.biz>
Date: Wed, 8 May 2024 12:54:44 +0200
Subject: [PATCH 0610/1178] Hopefully the last Python 3.8 instance :/

---
 src/PIL/Image.py | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/src/PIL/Image.py b/src/PIL/Image.py
index 8348ea257d8..f39580996a3 100644
--- a/src/PIL/Image.py
+++ b/src/PIL/Image.py
@@ -2775,7 +2775,7 @@ def getdata(self):
         im.info = self.info.copy()
         if method == Transform.MESH:
             # list of quads
-            for box, quad in cast(Sequence[tuple[float, float]], data):
+            for box, quad in cast("Sequence[tuple[float, float]]", data):
                 im.__transformer(
                     box, self, Transform.QUAD, quad, resample, fillcolor is None
                 )

From 47580f257b1ae7c9b461108d1bf4ba7d2b65f1ac Mon Sep 17 00:00:00 2001
From: Andrew Murray <radarhere@users.noreply.github.com>
Date: Thu, 9 May 2024 08:51:12 +1000
Subject: [PATCH 0611/1178] Updated libjpeg-turbo to 3.0.3

---
 .github/workflows/wheels-dependencies.sh | 2 +-
 winbuild/build_prepare.py                | 2 +-
 2 files changed, 2 insertions(+), 2 deletions(-)

diff --git a/.github/workflows/wheels-dependencies.sh b/.github/workflows/wheels-dependencies.sh
index 0d45d5a209d..930289c2ace 100755
--- a/.github/workflows/wheels-dependencies.sh
+++ b/.github/workflows/wheels-dependencies.sh
@@ -18,7 +18,7 @@ ARCHIVE_SDIR=pillow-depends-main
 FREETYPE_VERSION=2.13.2
 HARFBUZZ_VERSION=8.4.0
 LIBPNG_VERSION=1.6.43
-JPEGTURBO_VERSION=3.0.2
+JPEGTURBO_VERSION=3.0.3
 OPENJPEG_VERSION=2.5.2
 XZ_VERSION=5.4.5
 TIFF_VERSION=4.6.0
diff --git a/winbuild/build_prepare.py b/winbuild/build_prepare.py
index 0d6da77549f..9875d71e7b6 100644
--- a/winbuild/build_prepare.py
+++ b/winbuild/build_prepare.py
@@ -114,7 +114,7 @@ def cmd_msbuild(
     "FREETYPE": "2.13.2",
     "FRIBIDI": "1.0.13",
     "HARFBUZZ": "8.4.0",
-    "JPEGTURBO": "3.0.2",
+    "JPEGTURBO": "3.0.3",
     "LCMS2": "2.16",
     "LIBPNG": "1.6.43",
     "LIBWEBP": "1.3.2",

From 431fe0dcc8ff8a28fbe89c1668d7090f247aaed8 Mon Sep 17 00:00:00 2001
From: Sebastian Rittau <srittau@rittau.biz>
Date: Fri, 10 May 2024 11:46:35 +0200
Subject: [PATCH 0612/1178] Rename protocol to SupportsGetData

---
 src/PIL/Image.py | 4 ++--
 1 file changed, 2 insertions(+), 2 deletions(-)

diff --git a/src/PIL/Image.py b/src/PIL/Image.py
index f39580996a3..154862a6fbc 100644
--- a/src/PIL/Image.py
+++ b/src/PIL/Image.py
@@ -482,7 +482,7 @@ def _getscaleoffset(expr):
 # Implementation wrapper
 
 
-class GetDataTransform(Protocol):
+class SupportsGetData(Protocol):
     def getdata(
         self,
     ) -> tuple[Transform, Sequence[Any]]: ...
@@ -2695,7 +2695,7 @@ def round_aspect(number, key):
     def transform(
         self,
         size: tuple[int, int],
-        method: Transform | ImageTransformHandler | GetDataTransform,
+        method: Transform | ImageTransformHandler | SupportsGetData,
         data: Sequence[Any] | None = None,
         resample: int = Resampling.NEAREST,
         fill: int = 1,

From 9b44abb6b7f77043ac337fe8171d0ecdbb4b7882 Mon Sep 17 00:00:00 2001
From: Sebastian Rittau <srittau@rittau.biz>
Date: Fri, 10 May 2024 11:48:36 +0200
Subject: [PATCH 0613/1178] Add SupportsGetData to documentation

---
 docs/reference/Image.rst | 6 ++++++
 1 file changed, 6 insertions(+)

diff --git a/docs/reference/Image.rst b/docs/reference/Image.rst
index 0d9b4d93d77..c0d9095cd3c 100644
--- a/docs/reference/Image.rst
+++ b/docs/reference/Image.rst
@@ -365,6 +365,12 @@ Classes
 .. autoclass:: PIL.Image.ImagePointHandler
 .. autoclass:: PIL.Image.ImageTransformHandler
 
+Protocols
+---------
+
+.. autoclass:: SupportsGetData
+    :show-inheritance:
+
 Constants
 ---------
 

From 57399ce204d79c74c80612c622bb788e20d786e8 Mon Sep 17 00:00:00 2001
From: Andrew Murray <radarhere@users.noreply.github.com>
Date: Fri, 10 May 2024 22:43:56 +1000
Subject: [PATCH 0614/1178] Parse _version contents instead of using exec()

---
 setup.py | 3 +--
 1 file changed, 1 insertion(+), 2 deletions(-)

diff --git a/setup.py b/setup.py
index 7d8e1c1ee21..abdd87ea252 100644
--- a/setup.py
+++ b/setup.py
@@ -23,8 +23,7 @@
 def get_version():
     version_file = "src/PIL/_version.py"
     with open(version_file, encoding="utf-8") as f:
-        exec(compile(f.read(), version_file, "exec"))
-    return locals()["__version__"]
+        return f.read().split('"')[1]
 
 
 configuration = {}

From 18b87c8515941f7131b764d4293e3cdf638ba2ff Mon Sep 17 00:00:00 2001
From: Andrew Murray <radarhere@users.noreply.github.com>
Date: Sat, 11 May 2024 10:48:09 +1000
Subject: [PATCH 0615/1178] Added type hints

---
 src/PIL/BufrStubImagePlugin.py |  2 +-
 src/PIL/CurImagePlugin.py      |  2 +-
 src/PIL/FpxImagePlugin.py      |  2 +-
 src/PIL/FtexImagePlugin.py     |  2 +-
 src/PIL/GbrImagePlugin.py      |  2 +-
 src/PIL/GribStubImagePlugin.py |  2 +-
 src/PIL/ImImagePlugin.py       |  2 +-
 src/PIL/ImageTk.py             |  4 ++--
 src/PIL/Jpeg2KImagePlugin.py   |  4 ++--
 src/PIL/JpegImagePlugin.py     |  2 +-
 src/PIL/MpoImagePlugin.py      |  2 +-
 src/PIL/PSDraw.py              |  2 +-
 src/PIL/PdfParser.py           | 16 ++++++++--------
 src/PIL/PngImagePlugin.py      |  6 +++---
 src/PIL/PyAccess.py            |  2 +-
 src/PIL/QoiImagePlugin.py      |  2 +-
 src/PIL/WebPImagePlugin.py     |  2 +-
 src/PIL/WmfImagePlugin.py      |  2 +-
 src/PIL/XpmImagePlugin.py      |  2 +-
 19 files changed, 30 insertions(+), 30 deletions(-)

diff --git a/src/PIL/BufrStubImagePlugin.py b/src/PIL/BufrStubImagePlugin.py
index 1cbd50d1997..271db725852 100644
--- a/src/PIL/BufrStubImagePlugin.py
+++ b/src/PIL/BufrStubImagePlugin.py
@@ -37,7 +37,7 @@ class BufrStubImageFile(ImageFile.StubImageFile):
     format = "BUFR"
     format_description = "BUFR"
 
-    def _open(self):
+    def _open(self) -> None:
         offset = self.fp.tell()
 
         if not _accept(self.fp.read(4)):
diff --git a/src/PIL/CurImagePlugin.py b/src/PIL/CurImagePlugin.py
index b8790e20963..85e2145e766 100644
--- a/src/PIL/CurImagePlugin.py
+++ b/src/PIL/CurImagePlugin.py
@@ -37,7 +37,7 @@ class CurImageFile(BmpImagePlugin.BmpImageFile):
     format = "CUR"
     format_description = "Windows Cursor"
 
-    def _open(self):
+    def _open(self) -> None:
         offset = self.fp.tell()
 
         # check magic
diff --git a/src/PIL/FpxImagePlugin.py b/src/PIL/FpxImagePlugin.py
index cfaf862399d..4ba93bb3912 100644
--- a/src/PIL/FpxImagePlugin.py
+++ b/src/PIL/FpxImagePlugin.py
@@ -237,7 +237,7 @@ def load(self):
 
         return ImageFile.ImageFile.load(self)
 
-    def close(self):
+    def close(self) -> None:
         self.ole.close()
         super().close()
 
diff --git a/src/PIL/FtexImagePlugin.py b/src/PIL/FtexImagePlugin.py
index a746959a3a8..7fcf8137684 100644
--- a/src/PIL/FtexImagePlugin.py
+++ b/src/PIL/FtexImagePlugin.py
@@ -71,7 +71,7 @@ class FtexImageFile(ImageFile.ImageFile):
     format = "FTEX"
     format_description = "Texture File Format (IW2:EOC)"
 
-    def _open(self):
+    def _open(self) -> None:
         if not _accept(self.fp.read(4)):
             msg = "not an FTEX file"
             raise SyntaxError(msg)
diff --git a/src/PIL/GbrImagePlugin.py b/src/PIL/GbrImagePlugin.py
index 62197e36c98..93e89b1e655 100644
--- a/src/PIL/GbrImagePlugin.py
+++ b/src/PIL/GbrImagePlugin.py
@@ -41,7 +41,7 @@ class GbrImageFile(ImageFile.ImageFile):
     format = "GBR"
     format_description = "GIMP brush file"
 
-    def _open(self):
+    def _open(self) -> None:
         header_size = i32(self.fp.read(4))
         if header_size < 20:
             msg = "not a GIMP brush"
diff --git a/src/PIL/GribStubImagePlugin.py b/src/PIL/GribStubImagePlugin.py
index a80fe0a234a..13bdfa616e8 100644
--- a/src/PIL/GribStubImagePlugin.py
+++ b/src/PIL/GribStubImagePlugin.py
@@ -37,7 +37,7 @@ class GribStubImageFile(ImageFile.StubImageFile):
     format = "GRIB"
     format_description = "GRIB"
 
-    def _open(self):
+    def _open(self) -> None:
         offset = self.fp.tell()
 
         if not _accept(self.fp.read(8)):
diff --git a/src/PIL/ImImagePlugin.py b/src/PIL/ImImagePlugin.py
index 9c16159e958..a325f8552d5 100644
--- a/src/PIL/ImImagePlugin.py
+++ b/src/PIL/ImImagePlugin.py
@@ -119,7 +119,7 @@ class ImImageFile(ImageFile.ImageFile):
     format_description = "IFUNC Image Memory"
     _close_exclusive_fp_after_loading = False
 
-    def _open(self):
+    def _open(self) -> None:
         # Quick rejection: if there's not an LF among the first
         # 100 bytes, this is (probably) not a text header.
 
diff --git a/src/PIL/ImageTk.py b/src/PIL/ImageTk.py
index 10b2cc69a1e..2f9d7f505ba 100644
--- a/src/PIL/ImageTk.py
+++ b/src/PIL/ImageTk.py
@@ -128,7 +128,7 @@ def __init__(self, image=None, size=None, **kw):
         if image:
             self.paste(image)
 
-    def __del__(self):
+    def __del__(self) -> None:
         name = self.__photo.name
         self.__photo.name = None
         try:
@@ -219,7 +219,7 @@ def __init__(self, image=None, **kw):
             kw["data"] = image.tobitmap()
         self.__photo = tkinter.BitmapImage(**kw)
 
-    def __del__(self):
+    def __del__(self) -> None:
         name = self.__photo.name
         self.__photo.name = None
         try:
diff --git a/src/PIL/Jpeg2KImagePlugin.py b/src/PIL/Jpeg2KImagePlugin.py
index 697bad22120..81ef32253bd 100644
--- a/src/PIL/Jpeg2KImagePlugin.py
+++ b/src/PIL/Jpeg2KImagePlugin.py
@@ -215,7 +215,7 @@ class Jpeg2KImageFile(ImageFile.ImageFile):
     format = "JPEG2000"
     format_description = "JPEG 2000 (ISO 15444)"
 
-    def _open(self):
+    def _open(self) -> None:
         sig = self.fp.read(4)
         if sig == b"\xff\x4f\xff\x51":
             self.codec = "j2k"
@@ -267,7 +267,7 @@ def _open(self):
             )
         ]
 
-    def _parse_comment(self):
+    def _parse_comment(self) -> None:
         hdr = self.fp.read(2)
         length = _binary.i16be(hdr)
         self.fp.seek(length - 2, os.SEEK_CUR)
diff --git a/src/PIL/JpegImagePlugin.py b/src/PIL/JpegImagePlugin.py
index 715a358a3b7..7a3c99b6c30 100644
--- a/src/PIL/JpegImagePlugin.py
+++ b/src/PIL/JpegImagePlugin.py
@@ -462,7 +462,7 @@ def draft(
         box = (0, 0, original_size[0] / scale, original_size[1] / scale)
         return self.mode, box
 
-    def load_djpeg(self):
+    def load_djpeg(self) -> None:
         # ALTERNATIVE: handle JPEGs via the IJG command line utilities
 
         f, path = tempfile.mkstemp()
diff --git a/src/PIL/MpoImagePlugin.py b/src/PIL/MpoImagePlugin.py
index fb6620e7563..eba35fb4d8d 100644
--- a/src/PIL/MpoImagePlugin.py
+++ b/src/PIL/MpoImagePlugin.py
@@ -100,7 +100,7 @@ class MpoImageFile(JpegImagePlugin.JpegImageFile):
     format_description = "MPO (CIPA DC-007)"
     _close_exclusive_fp_after_loading = False
 
-    def _open(self):
+    def _open(self) -> None:
         self.fp.seek(0)  # prep the fp in order to pass the JPEG test
         JpegImagePlugin.JpegImageFile._open(self)
         self._after_jpeg_open()
diff --git a/src/PIL/PSDraw.py b/src/PIL/PSDraw.py
index 848fc2f716a..49c06ce1363 100644
--- a/src/PIL/PSDraw.py
+++ b/src/PIL/PSDraw.py
@@ -54,7 +54,7 @@ def begin_document(self, id=None):
         self.fp.write(b"%%EndProlog\n")
         self.isofont = {}
 
-    def end_document(self):
+    def end_document(self) -> None:
         """Ends printing. (Write PostScript DSC footer.)"""
         self.fp.write(b"%%EndDocument\nrestore showpage\n%%End\n")
         if hasattr(self.fp, "flush"):
diff --git a/src/PIL/PdfParser.py b/src/PIL/PdfParser.py
index c43f2da7baa..077c9ec8ba7 100644
--- a/src/PIL/PdfParser.py
+++ b/src/PIL/PdfParser.py
@@ -409,28 +409,28 @@ def __exit__(self, exc_type, exc_value, traceback):
         self.close()
         return False  # do not suppress exceptions
 
-    def start_writing(self):
+    def start_writing(self) -> None:
         self.close_buf()
         self.seek_end()
 
-    def close_buf(self):
+    def close_buf(self) -> None:
         try:
             self.buf.close()
         except AttributeError:
             pass
         self.buf = None
 
-    def close(self):
+    def close(self) -> None:
         if self.should_close_buf:
             self.close_buf()
         if self.f is not None and self.should_close_file:
             self.f.close()
             self.f = None
 
-    def seek_end(self):
+    def seek_end(self) -> None:
         self.f.seek(0, os.SEEK_END)
 
-    def write_header(self):
+    def write_header(self) -> None:
         self.f.write(b"%PDF-1.4\n")
 
     def write_comment(self, s):
@@ -450,7 +450,7 @@ def write_catalog(self):
         )
         return self.root_ref
 
-    def rewrite_pages(self):
+    def rewrite_pages(self) -> None:
         pages_tree_nodes_to_delete = []
         for i, page_ref in enumerate(self.orig_pages):
             page_info = self.cached_objects[page_ref]
@@ -529,7 +529,7 @@ def write_obj(self, ref, *objs, **dict_obj):
         f.write(b"endobj\n")
         return ref
 
-    def del_root(self):
+    def del_root(self) -> None:
         if self.root_ref is None:
             return
         del self.xref_table[self.root_ref.object_id]
@@ -547,7 +547,7 @@ def get_buf_from_file(f):
             except ValueError:  # cannot mmap an empty file
                 return b""
 
-    def read_pdf_info(self):
+    def read_pdf_info(self) -> None:
         self.file_size_total = len(self.buf)
         self.file_size_this = self.file_size_total - self.start_offset
         self.read_trailer()
diff --git a/src/PIL/PngImagePlugin.py b/src/PIL/PngImagePlugin.py
index 1547edde5b1..76e0abc317f 100644
--- a/src/PIL/PngImagePlugin.py
+++ b/src/PIL/PngImagePlugin.py
@@ -179,7 +179,7 @@ def __enter__(self):
     def __exit__(self, *args):
         self.close()
 
-    def close(self):
+    def close(self) -> None:
         self.queue = self.fp = None
 
     def push(self, cid, pos, length):
@@ -370,14 +370,14 @@ def check_text_memory(self, chunklen):
             )
             raise ValueError(msg)
 
-    def save_rewind(self):
+    def save_rewind(self) -> None:
         self.rewind_state = {
             "info": self.im_info.copy(),
             "tile": self.im_tile,
             "seq_num": self._seq_num,
         }
 
-    def rewind(self):
+    def rewind(self) -> None:
         self.im_info = self.rewind_state["info"].copy()
         self.im_tile = self.rewind_state["tile"]
         self._seq_num = self.rewind_state["seq_num"]
diff --git a/src/PIL/PyAccess.py b/src/PIL/PyAccess.py
index 2c831913d69..a9da90613e7 100644
--- a/src/PIL/PyAccess.py
+++ b/src/PIL/PyAccess.py
@@ -70,7 +70,7 @@ def __init__(self, img, readonly=False):
         # logger.debug("%s", vals)
         self._post_init()
 
-    def _post_init(self):
+    def _post_init(self) -> None:
         pass
 
     def __setitem__(self, xy, color):
diff --git a/src/PIL/QoiImagePlugin.py b/src/PIL/QoiImagePlugin.py
index 2875b8d752b..cea8b60da81 100644
--- a/src/PIL/QoiImagePlugin.py
+++ b/src/PIL/QoiImagePlugin.py
@@ -21,7 +21,7 @@ class QoiImageFile(ImageFile.ImageFile):
     format = "QOI"
     format_description = "Quite OK Image"
 
-    def _open(self):
+    def _open(self) -> None:
         if not _accept(self.fp.read(4)):
             msg = "not a QOI file"
             raise SyntaxError(msg)
diff --git a/src/PIL/WebPImagePlugin.py b/src/PIL/WebPImagePlugin.py
index 61ae9eae500..052f253cf4e 100644
--- a/src/PIL/WebPImagePlugin.py
+++ b/src/PIL/WebPImagePlugin.py
@@ -43,7 +43,7 @@ class WebPImageFile(ImageFile.ImageFile):
     __loaded = 0
     __logical_frame = 0
 
-    def _open(self):
+    def _open(self) -> None:
         if not _webp.HAVE_WEBPANIM:
             # Legacy mode
             data, width, height, self._mode, icc_profile, exif = _webp.WebPDecode(
diff --git a/src/PIL/WmfImagePlugin.py b/src/PIL/WmfImagePlugin.py
index 7f045ec7da4..b0328657b03 100644
--- a/src/PIL/WmfImagePlugin.py
+++ b/src/PIL/WmfImagePlugin.py
@@ -79,7 +79,7 @@ class WmfStubImageFile(ImageFile.StubImageFile):
     format = "WMF"
     format_description = "Windows Metafile"
 
-    def _open(self):
+    def _open(self) -> None:
         self._inch = None
 
         # check placable header
diff --git a/src/PIL/XpmImagePlugin.py b/src/PIL/XpmImagePlugin.py
index a638547af61..88d14e9c2bd 100644
--- a/src/PIL/XpmImagePlugin.py
+++ b/src/PIL/XpmImagePlugin.py
@@ -36,7 +36,7 @@ class XpmImageFile(ImageFile.ImageFile):
     format = "XPM"
     format_description = "X11 Pixel Map"
 
-    def _open(self):
+    def _open(self) -> None:
         if not _accept(self.fp.read(9)):
             msg = "not an XPM file"
             raise SyntaxError(msg)

From 13cf2bc70f4bb5de7c0a083303d4a232104d7852 Mon Sep 17 00:00:00 2001
From: Andrew Murray <radarhere@users.noreply.github.com>
Date: Sat, 11 May 2024 11:16:52 +1000
Subject: [PATCH 0616/1178] Moved SupportsArrayInterface under Protocols
 heading

---
 docs/reference/Image.rst | 4 ++--
 1 file changed, 2 insertions(+), 2 deletions(-)

diff --git a/docs/reference/Image.rst b/docs/reference/Image.rst
index c0d9095cd3c..d917a3c9271 100644
--- a/docs/reference/Image.rst
+++ b/docs/reference/Image.rst
@@ -78,8 +78,6 @@ Constructing images
 ^^^^^^^^^^^^^^^^^^^
 
 .. autofunction:: new
-.. autoclass:: SupportsArrayInterface
-    :show-inheritance:
 .. autofunction:: fromarray
 .. autofunction:: frombytes
 .. autofunction:: frombuffer
@@ -368,6 +366,8 @@ Classes
 Protocols
 ---------
 
+.. autoclass:: SupportsArrayInterface
+    :show-inheritance:
 .. autoclass:: SupportsGetData
     :show-inheritance:
 

From 6310280428a49ea5495953a824b1dfa85a4d5223 Mon Sep 17 00:00:00 2001
From: Sebastian Rittau <srittau@rittau.biz>
Date: Sat, 11 May 2024 10:44:52 +0200
Subject: [PATCH 0617/1178] Move an import behind the TYPE_CHECKING flag

Co-authored-by: Andrew Murray <3112309+radarhere@users.noreply.github.com>
---
 src/PIL/ImageFont.py | 3 +--
 1 file changed, 1 insertion(+), 2 deletions(-)

diff --git a/src/PIL/ImageFont.py b/src/PIL/ImageFont.py
index 9eca3bc9877..f2936bae67d 100644
--- a/src/PIL/ImageFont.py
+++ b/src/PIL/ImageFont.py
@@ -35,13 +35,12 @@
 from io import BytesIO
 from typing import TYPE_CHECKING, BinaryIO
 
-from PIL import ImageFile
-
 from . import Image
 from ._typing import StrOrBytesPath
 from ._util import is_directory, is_path
 
 if TYPE_CHECKING:
+    from . import ImageFile
     from ._imaging import ImagingFont
     from ._imagingft import Font
 

From 6d6dfd176cf00a864a62dff6dd881099cc3bcec8 Mon Sep 17 00:00:00 2001
From: Sebastian Rittau <srittau@rittau.biz>
Date: Sat, 11 May 2024 10:46:20 +0200
Subject: [PATCH 0618/1178] Revert unnecessary formatting change

---
 src/PIL/Image.py | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/src/PIL/Image.py b/src/PIL/Image.py
index 154862a6fbc..53f38f0b241 100644
--- a/src/PIL/Image.py
+++ b/src/PIL/Image.py
@@ -3802,7 +3802,7 @@ def _get_ifd_dict(self, offset, group=None):
             return self._fixup_dict(info)
 
     def _get_head(self):
-        version = b"\x2b" if self.bigtiff else b"\x2a"
+        version = b"\x2B" if self.bigtiff else b"\x2A"
         if self.endian == "<":
             head = b"II" + version + b"\x00" + o32le(8)
         else:

From db4714c280c96ea4b61f1b3360c55e730ffaf62d Mon Sep 17 00:00:00 2001
From: Andrew Murray <radarhere@users.noreply.github.com>
Date: Sun, 12 May 2024 21:20:46 +1000
Subject: [PATCH 0619/1178] Removed helper.py modes

---
 Tests/helper.py            | 27 ---------------------------
 Tests/test_image.py        |  9 ++++-----
 Tests/test_image_access.py | 13 +++++++------
 3 files changed, 11 insertions(+), 38 deletions(-)

diff --git a/Tests/helper.py b/Tests/helper.py
index 1297c1c4309..5fd4fe3327e 100644
--- a/Tests/helper.py
+++ b/Tests/helper.py
@@ -29,33 +29,6 @@
     uploader = "github_actions"
 
 
-modes = (
-    "1",
-    "L",
-    "LA",
-    "La",
-    "P",
-    "PA",
-    "F",
-    "I",
-    "I;16",
-    "I;16L",
-    "I;16B",
-    "I;16N",
-    "RGB",
-    "RGBA",
-    "RGBa",
-    "RGBX",
-    "BGR;15",
-    "BGR;16",
-    "BGR;24",
-    "CMYK",
-    "YCbCr",
-    "HSV",
-    "LAB",
-)
-
-
 def upload(a: Image.Image, b: Image.Image) -> str | None:
     if uploader == "show":
         # local img.show for errors.
diff --git a/Tests/test_image.py b/Tests/test_image.py
index e1490d6a083..742d0dfe406 100644
--- a/Tests/test_image.py
+++ b/Tests/test_image.py
@@ -31,7 +31,6 @@
     is_big_endian,
     is_win32,
     mark_if_feature_version,
-    modes,
     skip_unless_feature,
 )
 
@@ -46,7 +45,7 @@ def helper_image_new(mode: str, size: tuple[int, int]) -> Image.Image:
 
 
 class TestImage:
-    @pytest.mark.parametrize("mode", modes)
+    @pytest.mark.parametrize("mode", Image.MODES + ["BGR;15", "BGR;16", "BGR;24"])
     def test_image_modes_success(self, mode: str) -> None:
         helper_image_new(mode, (1, 1))
 
@@ -1027,7 +1026,7 @@ def test_close_graceful(self, caplog: pytest.LogCaptureFixture) -> None:
 
 
 class TestImageBytes:
-    @pytest.mark.parametrize("mode", modes)
+    @pytest.mark.parametrize("mode", Image.MODES + ["BGR;15", "BGR;16", "BGR;24"])
     def test_roundtrip_bytes_constructor(self, mode: str) -> None:
         im = hopper(mode)
         source_bytes = im.tobytes()
@@ -1039,7 +1038,7 @@ def test_roundtrip_bytes_constructor(self, mode: str) -> None:
             reloaded = Image.frombytes(mode, im.size, source_bytes)
         assert reloaded.tobytes() == source_bytes
 
-    @pytest.mark.parametrize("mode", modes)
+    @pytest.mark.parametrize("mode", Image.MODES + ["BGR;15", "BGR;16", "BGR;24"])
     def test_roundtrip_bytes_method(self, mode: str) -> None:
         im = hopper(mode)
         source_bytes = im.tobytes()
@@ -1048,7 +1047,7 @@ def test_roundtrip_bytes_method(self, mode: str) -> None:
         reloaded.frombytes(source_bytes)
         assert reloaded.tobytes() == source_bytes
 
-    @pytest.mark.parametrize("mode", modes)
+    @pytest.mark.parametrize("mode", Image.MODES + ["BGR;15", "BGR;16", "BGR;24"])
     def test_getdata_putdata(self, mode: str) -> None:
         if is_big_endian() and mode == "BGR;15":
             pytest.xfail("Known failure of BGR;15 on big-endian")
diff --git a/Tests/test_image_access.py b/Tests/test_image_access.py
index e55a4d9c1fb..9d600667937 100644
--- a/Tests/test_image_access.py
+++ b/Tests/test_image_access.py
@@ -10,7 +10,7 @@
 
 from PIL import Image
 
-from .helper import assert_image_equal, hopper, is_win32, modes
+from .helper import assert_image_equal, hopper, is_win32
 
 # CFFI imports pycparser which doesn't support PYTHONOPTIMIZE=2
 # https://github.com/eliben/pycparser/pull/198#issuecomment-317001670
@@ -205,12 +205,13 @@ def check(self, mode: str, expected_color_int: int | None = None) -> None:
         with pytest.raises(error):
             im.getpixel((-1, -1))
 
-    @pytest.mark.parametrize("mode", modes)
+    @pytest.mark.parametrize("mode", Image.MODES)
     def test_basic(self, mode: str) -> None:
-        if mode.startswith("BGR;"):
-            with pytest.warns(DeprecationWarning):
-                self.check(mode)
-        else:
+        self.check(mode)
+
+    @pytest.mark.parametrize("mode", ("BGR;15", "BGR;16", "BGR;24"))
+    def test_deprecated(self, mode: str) -> None:
+        with pytest.warns(DeprecationWarning):
             self.check(mode)
 
     def test_list(self) -> None:

From 00e5e43da42ec9cd4da6c80ae269536a975f1217 Mon Sep 17 00:00:00 2001
From: "renovate[bot]" <29139614+renovate[bot]@users.noreply.github.com>
Date: Sun, 12 May 2024 11:43:08 +0000
Subject: [PATCH 0620/1178] chore(deps): update dependency cibuildwheel to
 v2.18.0

---
 .ci/requirements-cibw.txt | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/.ci/requirements-cibw.txt b/.ci/requirements-cibw.txt
index 45c2af975ae..8d39ea9bbab 100644
--- a/.ci/requirements-cibw.txt
+++ b/.ci/requirements-cibw.txt
@@ -1 +1 @@
-cibuildwheel==2.17.0
+cibuildwheel==2.18.0

From a8d154877d92d549f1d18411383441d1c9238e7c Mon Sep 17 00:00:00 2001
From: Andrew Murray <radarhere@users.noreply.github.com>
Date: Mon, 13 May 2024 18:47:51 +1000
Subject: [PATCH 0621/1178] Added type hints

---
 src/PIL/FliImagePlugin.py    |  2 +-
 src/PIL/GifImagePlugin.py    | 10 +++++-----
 src/PIL/GimpPaletteFile.py   |  2 +-
 src/PIL/ImImagePlugin.py     |  4 ++--
 src/PIL/ImageDraw.py         |  7 +++++--
 src/PIL/ImageFilter.py       |  2 +-
 src/PIL/ImagePalette.py      |  6 +++---
 src/PIL/ImageTk.py           | 12 ++++++------
 src/PIL/Jpeg2KImagePlugin.py |  4 ++--
 src/PIL/PdfParser.py         | 20 ++++++++++----------
 src/PIL/SpiderImagePlugin.py | 10 +++++++---
 src/PIL/TiffImagePlugin.py   | 14 +++++++-------
 src/PIL/WebPImagePlugin.py   |  2 +-
 13 files changed, 51 insertions(+), 44 deletions(-)

diff --git a/src/PIL/FliImagePlugin.py b/src/PIL/FliImagePlugin.py
index eea2c0c951f..dceb839279a 100644
--- a/src/PIL/FliImagePlugin.py
+++ b/src/PIL/FliImagePlugin.py
@@ -132,7 +132,7 @@ def seek(self, frame: int) -> None:
         for f in range(self.__frame + 1, frame + 1):
             self._seek(f)
 
-    def _seek(self, frame):
+    def _seek(self, frame: int) -> None:
         if frame == 0:
             self.__frame = -1
             self._fp.seek(self.__rewind)
diff --git a/src/PIL/GifImagePlugin.py b/src/PIL/GifImagePlugin.py
index 26e5958191b..eede4154994 100644
--- a/src/PIL/GifImagePlugin.py
+++ b/src/PIL/GifImagePlugin.py
@@ -82,7 +82,7 @@ def data(self) -> bytes | None:
             return self.fp.read(s[0])
         return None
 
-    def _is_palette_needed(self, p):
+    def _is_palette_needed(self, p: bytes) -> bool:
         for i in range(0, len(p), 3):
             if not (i // 3 == p[i] == p[i + 1] == p[i + 2]):
                 return True
@@ -474,7 +474,7 @@ def tell(self) -> int:
 RAWMODE = {"1": "L", "L": "L", "P": "P"}
 
 
-def _normalize_mode(im):
+def _normalize_mode(im: Image.Image) -> Image.Image:
     """
     Takes an image (or frame), returns an image in a mode that is appropriate
     for saving in a Gif.
@@ -887,7 +887,7 @@ def _get_optimize(im, info):
                 return used_palette_colors
 
 
-def _get_color_table_size(palette_bytes):
+def _get_color_table_size(palette_bytes: bytes) -> int:
     # calculate the palette size for the header
     if not palette_bytes:
         return 0
@@ -897,7 +897,7 @@ def _get_color_table_size(palette_bytes):
         return math.ceil(math.log(len(palette_bytes) // 3, 2)) - 1
 
 
-def _get_header_palette(palette_bytes):
+def _get_header_palette(palette_bytes: bytes) -> bytes:
     """
     Returns the palette, null padded to the next power of 2 (*3) bytes
     suitable for direct inclusion in the GIF header
@@ -915,7 +915,7 @@ def _get_header_palette(palette_bytes):
     return palette_bytes
 
 
-def _get_palette_bytes(im):
+def _get_palette_bytes(im: Image.Image) -> bytes:
     """
     Gets the palette for inclusion in the gif header
 
diff --git a/src/PIL/GimpPaletteFile.py b/src/PIL/GimpPaletteFile.py
index a3109ebaa1b..2274f1a8bfe 100644
--- a/src/PIL/GimpPaletteFile.py
+++ b/src/PIL/GimpPaletteFile.py
@@ -53,5 +53,5 @@ def __init__(self, fp):
 
         self.palette = b"".join(self.palette)
 
-    def getpalette(self):
+    def getpalette(self) -> tuple[bytes, str]:
         return self.palette, self.rawmode
diff --git a/src/PIL/ImImagePlugin.py b/src/PIL/ImImagePlugin.py
index a325f8552d5..8e949ebaf9d 100644
--- a/src/PIL/ImImagePlugin.py
+++ b/src/PIL/ImImagePlugin.py
@@ -271,11 +271,11 @@ def _open(self) -> None:
             self.tile = [("raw", (0, 0) + self.size, offs, (self.rawmode, 0, -1))]
 
     @property
-    def n_frames(self):
+    def n_frames(self) -> int:
         return self.info[FRAMES]
 
     @property
-    def is_animated(self):
+    def is_animated(self) -> bool:
         return self.info[FRAMES] > 1
 
     def seek(self, frame: int) -> None:
diff --git a/src/PIL/ImageDraw.py b/src/PIL/ImageDraw.py
index d3efe64865e..42f2ee8c799 100644
--- a/src/PIL/ImageDraw.py
+++ b/src/PIL/ImageDraw.py
@@ -34,7 +34,7 @@
 import math
 import numbers
 import struct
-from typing import Sequence, cast
+from typing import TYPE_CHECKING, Sequence, cast
 
 from . import Image, ImageColor
 from ._typing import Coords
@@ -92,7 +92,10 @@ def __init__(self, im: Image.Image, mode: str | None = None) -> None:
             self.fontmode = "L"  # aliasing is okay for other modes
         self.fill = False
 
-    def getfont(self):
+    if TYPE_CHECKING:
+        from . import ImageFont
+
+    def getfont(self) -> ImageFont.FreeTypeFont | ImageFont.ImageFont:
         """
         Get the current default font.
 
diff --git a/src/PIL/ImageFilter.py b/src/PIL/ImageFilter.py
index fa9ebd9defb..678bd29a2d7 100644
--- a/src/PIL/ImageFilter.py
+++ b/src/PIL/ImageFilter.py
@@ -544,7 +544,7 @@ def transform(self, callback, with_normals=False, channels=None, target_mode=Non
             _copy_table=False,
         )
 
-    def __repr__(self):
+    def __repr__(self) -> str:
         r = [
             f"{self.__class__.__name__} from {self.table.__class__.__name__}",
             "size={:d}x{:d}x{:d}".format(*self.size),
diff --git a/src/PIL/ImagePalette.py b/src/PIL/ImagePalette.py
index 770d10025c8..ae5c5dec0da 100644
--- a/src/PIL/ImagePalette.py
+++ b/src/PIL/ImagePalette.py
@@ -66,7 +66,7 @@ def colors(self):
     def colors(self, colors):
         self._colors = colors
 
-    def copy(self):
+    def copy(self) -> ImagePalette:
         new = ImagePalette()
 
         new.mode = self.mode
@@ -77,7 +77,7 @@ def copy(self):
 
         return new
 
-    def getdata(self):
+    def getdata(self) -> tuple[str, bytes]:
         """
         Get palette contents in format suitable for the low-level
         ``im.putpalette`` primitive.
@@ -88,7 +88,7 @@ def getdata(self):
             return self.rawmode, self.palette
         return self.mode, self.tobytes()
 
-    def tobytes(self):
+    def tobytes(self) -> bytes:
         """Convert palette to bytes.
 
         .. warning:: This method is experimental.
diff --git a/src/PIL/ImageTk.py b/src/PIL/ImageTk.py
index 2f9d7f505ba..6e2e7db1e19 100644
--- a/src/PIL/ImageTk.py
+++ b/src/PIL/ImageTk.py
@@ -136,7 +136,7 @@ def __del__(self) -> None:
         except Exception:
             pass  # ignore internal errors
 
-    def __str__(self):
+    def __str__(self) -> str:
         """
         Get the Tkinter photo image identifier.  This method is automatically
         called by Tkinter whenever a PhotoImage object is passed to a Tkinter
@@ -146,7 +146,7 @@ def __str__(self):
         """
         return str(self.__photo)
 
-    def width(self):
+    def width(self) -> int:
         """
         Get the width of the image.
 
@@ -154,7 +154,7 @@ def width(self):
         """
         return self.__size[0]
 
-    def height(self):
+    def height(self) -> int:
         """
         Get the height of the image.
 
@@ -227,7 +227,7 @@ def __del__(self) -> None:
         except Exception:
             pass  # ignore internal errors
 
-    def width(self):
+    def width(self) -> int:
         """
         Get the width of the image.
 
@@ -235,7 +235,7 @@ def width(self):
         """
         return self.__size[0]
 
-    def height(self):
+    def height(self) -> int:
         """
         Get the height of the image.
 
@@ -243,7 +243,7 @@ def height(self):
         """
         return self.__size[1]
 
-    def __str__(self):
+    def __str__(self) -> str:
         """
         Get the Tkinter bitmap image identifier.  This method is automatically
         called by Tkinter whenever a BitmapImage object is passed to a Tkinter
diff --git a/src/PIL/Jpeg2KImagePlugin.py b/src/PIL/Jpeg2KImagePlugin.py
index 81ef32253bd..ce6342bdba2 100644
--- a/src/PIL/Jpeg2KImagePlugin.py
+++ b/src/PIL/Jpeg2KImagePlugin.py
@@ -63,12 +63,12 @@ def read_fields(self, field_format):
         data = self._read_bytes(size)
         return struct.unpack(field_format, data)
 
-    def read_boxes(self):
+    def read_boxes(self) -> BoxReader:
         size = self.remaining_in_box
         data = self._read_bytes(size)
         return BoxReader(io.BytesIO(data), size)
 
-    def has_next_box(self):
+    def has_next_box(self) -> bool:
         if self.has_length:
             return self.fp.tell() + self.remaining_in_box < self.length
         else:
diff --git a/src/PIL/PdfParser.py b/src/PIL/PdfParser.py
index 077c9ec8ba7..68501d625d4 100644
--- a/src/PIL/PdfParser.py
+++ b/src/PIL/PdfParser.py
@@ -87,10 +87,10 @@ class IndirectReferenceTuple(NamedTuple):
 
 
 class IndirectReference(IndirectReferenceTuple):
-    def __str__(self):
+    def __str__(self) -> str:
         return f"{self.object_id} {self.generation} R"
 
-    def __bytes__(self):
+    def __bytes__(self) -> bytes:
         return self.__str__().encode("us-ascii")
 
     def __eq__(self, other):
@@ -108,7 +108,7 @@ def __hash__(self):
 
 
 class IndirectObjectDef(IndirectReference):
-    def __str__(self):
+    def __str__(self) -> str:
         return f"{self.object_id} {self.generation} obj"
 
 
@@ -150,7 +150,7 @@ def __delitem__(self, key):
     def __contains__(self, key):
         return key in self.existing_entries or key in self.new_entries
 
-    def __len__(self):
+    def __len__(self) -> int:
         return len(
             set(self.existing_entries.keys())
             | set(self.new_entries.keys())
@@ -211,7 +211,7 @@ def __init__(self, name):
         else:
             self.name = name.encode("us-ascii")
 
-    def name_as_str(self):
+    def name_as_str(self) -> str:
         return self.name.decode("us-ascii")
 
     def __eq__(self, other):
@@ -222,7 +222,7 @@ def __eq__(self, other):
     def __hash__(self):
         return hash(self.name)
 
-    def __repr__(self):
+    def __repr__(self) -> str:
         return f"{self.__class__.__name__}({repr(self.name)})"
 
     @classmethod
@@ -231,7 +231,7 @@ def from_pdf_stream(cls, data):
 
     allowed_chars = set(range(33, 127)) - {ord(c) for c in "#%/()<>[]{}"}
 
-    def __bytes__(self):
+    def __bytes__(self) -> bytes:
         result = bytearray(b"/")
         for b in self.name:
             if b in self.allowed_chars:
@@ -242,7 +242,7 @@ def __bytes__(self):
 
 
 class PdfArray(List[Any]):
-    def __bytes__(self):
+    def __bytes__(self) -> bytes:
         return b"[ " + b" ".join(pdf_repr(x) for x in self) + b" ]"
 
 
@@ -286,7 +286,7 @@ def __getattr__(self, key):
                 value = time.gmtime(calendar.timegm(value) + offset)
         return value
 
-    def __bytes__(self):
+    def __bytes__(self) -> bytes:
         out = bytearray(b"<<")
         for key, value in self.items():
             if value is None:
@@ -304,7 +304,7 @@ class PdfBinary:
     def __init__(self, data):
         self.data = data
 
-    def __bytes__(self):
+    def __bytes__(self) -> bytes:
         return b"<%s>" % b"".join(b"%02X" % b for b in self.data)
 
 
diff --git a/src/PIL/SpiderImagePlugin.py b/src/PIL/SpiderImagePlugin.py
index 21509b2d99f..5b8ad47f0cd 100644
--- a/src/PIL/SpiderImagePlugin.py
+++ b/src/PIL/SpiderImagePlugin.py
@@ -37,6 +37,7 @@
 import os
 import struct
 import sys
+from typing import TYPE_CHECKING
 
 from . import Image, ImageFile
 
@@ -157,11 +158,11 @@ def _open(self) -> None:
         self._fp = self.fp  # FIXME: hack
 
     @property
-    def n_frames(self):
+    def n_frames(self) -> int:
         return self._nimages
 
     @property
-    def is_animated(self):
+    def is_animated(self) -> bool:
         return self._nimages > 1
 
     # 1st image index is zero (although SPIDER imgnumber starts at 1)
@@ -191,8 +192,11 @@ def convert2byte(self, depth=255):
         b = -m * minimum
         return self.point(lambda i, m=m, b=b: i * m + b).convert("L")
 
+    if TYPE_CHECKING:
+        from . import ImageTk
+
     # returns a ImageTk.PhotoImage object, after rescaling to 0..255
-    def tkPhotoImage(self):
+    def tkPhotoImage(self) -> ImageTk.PhotoImage:
         from . import ImageTk
 
         return ImageTk.PhotoImage(self.convert2byte(), palette=256)
diff --git a/src/PIL/TiffImagePlugin.py b/src/PIL/TiffImagePlugin.py
index a7a7e28bdbc..54faa59c55f 100644
--- a/src/PIL/TiffImagePlugin.py
+++ b/src/PIL/TiffImagePlugin.py
@@ -381,7 +381,7 @@ def limit_rational(self, max_denominator):
         f = self._val.limit_denominator(max_denominator)
         return f.numerator, f.denominator
 
-    def __repr__(self):
+    def __repr__(self) -> str:
         return str(float(self._val))
 
     def __hash__(self):
@@ -603,7 +603,7 @@ def reset(self):
         self._next = None
         self._offset = None
 
-    def __str__(self):
+    def __str__(self) -> str:
         return str(dict(self))
 
     def named(self):
@@ -617,7 +617,7 @@ def named(self):
             for code, value in self.items()
         }
 
-    def __len__(self):
+    def __len__(self) -> int:
         return len(set(self._tagdata) | set(self._tags_v2))
 
     def __getitem__(self, tag):
@@ -1041,7 +1041,7 @@ def from_v2(cls, original):
         ifd.next = original.next  # an indicator for multipage tiffs
         return ifd
 
-    def to_v2(self):
+    def to_v2(self) -> ImageFileDirectory_v2:
         """Returns an
         :py:class:`~PIL.TiffImagePlugin.ImageFileDirectory_v2`
         instance with the same data as is contained in the original
@@ -1061,7 +1061,7 @@ def to_v2(self):
     def __contains__(self, tag):
         return tag in self._tags_v1 or tag in self._tagdata
 
-    def __len__(self):
+    def __len__(self) -> int:
         return len(set(self._tagdata) | set(self._tags_v1))
 
     def __iter__(self):
@@ -1154,7 +1154,7 @@ def seek(self, frame: int) -> None:
         Image._decompression_bomb_check(self.size)
         self.im = Image.core.new(self.mode, self.size)
 
-    def _seek(self, frame):
+    def _seek(self, frame: int) -> None:
         self.fp = self._fp
 
         # reset buffered io handle in case fp
@@ -2003,7 +2003,7 @@ def __exit__(self, exc_type, exc_value, traceback):
             self.close()
         return False
 
-    def tell(self):
+    def tell(self) -> int:
         return self.f.tell() - self.offsetOfNewPage
 
     def seek(self, offset, whence=io.SEEK_SET):
diff --git a/src/PIL/WebPImagePlugin.py b/src/PIL/WebPImagePlugin.py
index 052f253cf4e..4b8cfe65c7e 100644
--- a/src/PIL/WebPImagePlugin.py
+++ b/src/PIL/WebPImagePlugin.py
@@ -144,7 +144,7 @@ def _get_next(self):
         timestamp -= duration
         return data, timestamp, duration
 
-    def _seek(self, frame):
+    def _seek(self, frame: int) -> None:
         if self.__physical_frame == frame:
             return  # Nothing to do
         if frame < self.__physical_frame:

From b15ce5a4bce4c5ec5d2816e271e0496e7198ae06 Mon Sep 17 00:00:00 2001
From: Andrew Murray <radarhere@users.noreply.github.com>
Date: Mon, 13 May 2024 21:51:16 +1000
Subject: [PATCH 0622/1178] Do not detect Ultra HDR images as MPO

---
 Tests/images/ultrahdr.jpg  | Bin 0 -> 520842 bytes
 Tests/test_file_mpo.py     |   5 +++++
 src/PIL/JpegImagePlugin.py |   4 ++++
 3 files changed, 9 insertions(+)
 create mode 100644 Tests/images/ultrahdr.jpg

diff --git a/Tests/images/ultrahdr.jpg b/Tests/images/ultrahdr.jpg
new file mode 100644
index 0000000000000000000000000000000000000000..1c5cc4adfe07ff4bbf80e79a784caf287c3b867f
GIT binary patch
literal 520842
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%0AWLXd`zuo~
z_C_vbh^Qkx70)>K$6B<@=U*}yh8dgXZcj$S;-w<ss4<BH2EZxQZW!b6sck>Ajm@gu
ze{CcmXkR)=04^7}MLk-WvZ=qm^6f7K0`bBm%nX}*9P!BSiWv@i*nAPRZvZg`!jtqh
zuW2miVB63Y&ImnyjZi?QMZyp{;MJd$2m-Wf-Sbk$nP_ejNXxjEa!=IKNNyx+L@byO
zl5x;fZ7cl2e$Ti8oSrj^NS<7~mKh-Tsj*iq#9|imC}-WjoQ^8a;PAqUa8wBaZaUUd
z$bQoK+k)q%TMrNjP?5pT;ndL8fin8MORZXwZj!28BNTk?Y!Gm8bA!;})W%nRLr}y}
zMy)$C#}FY?C+?^@I2{KjsH?BpW^Kx^+n!IYK(aWPu%0~Qk^VI{xYp*^o0%X5hEahd
z6y}mME4P&@{M`BvN~06P&nvJz5w%^qpYWi%<xB1$p55v!S%1w^NZv+AbJnD0lWHhY
zjB}4_g4pSDHnACPU(S6T{gK&K5oheOZphks$p`7ysX-<5ekF`c6StP-JifuPj(xlJ
zqQX+StX!C_$JyiMfEYioG^fm2xRyc5=QTxTxi=f8u!1ro!jwz~13ZuZw-qM$W=8Xd
zHt;b_Ot_49w&y1_j>;!apq_wL2_<C;1ji(BG1h?6mR-g26S<<oG=U~xyuWg#+{6!%
zaa58-+DjMCDa$J~z#X7q0Z0phm<IWCp17u*g)DkhYa*4p0!V-gMty2CBY7-0uinOJ
z9fbu5oU*48lT=9_VEKs|=~FiDnH-8|l`9Z|p&1*pPB@@WRzr&t@g1Y?@l)GP2lj(T
z&9+UPG5fsqA5%#ct--jljNAd4#u)S%_4cXCMfQP)wQaKGGJrw%6;?dT*sHrHOd^0<
zNIuhe@@_eKPbB^r82l=z5-BQJee;Y~fKt}%#UH0N7Q>R}A+=yE%*UtUMT?_}zKp0!
z?*kxmDe(x6+bfmHa-nm}9B1_FP(T_@ei+5MbM}MRq4lYuy7RnitwfeK-b5NnWu1Do
zu5d@t07W|+I;p!N)A?!%$m{D>cRNWwNhC-BIPFtN5n(K3-~bI#mC#ItI}k=jD6w&7
ziIsn|qZ`;Ux>J$VW8c!FcFe^$#x}7BZZLiLtp5PC7US%wFr1w8P;bfF%F4z=j2@z;
z7NRVN6F=R+kmH(&%$pnqey1lC$KAGEukjwHsJm^E&gLH{Pg=BUk#Xm5F@V|!mOB2m
zS?&-<>GpBB@VGtdnSb5#ha~Y-=5ysnRhvEY+Nl~wH!LBO?E8z1l6c2MO<T7YQlVGC
zlLU&a(n;mVnU_0<xv1R8(>p1~Pat$AsUn&+mPcu=BaY@E&oYhj5*0_O#!d%X=`5wv
zzu{%r{jXfoKeBBYA#$H1w!xNe3w-TdXkr#34?6{HTij_0re47Q9J+CJ5m%6rx<2_)
z^&IAoQ<k;bv8&=~w2Q4sU0BPcm@V$2ge+&~B0x^@oDwoI=qr{x_n{~QG6De|yBZ!Q
zOTUt0K)?*Wa63^U%g4FckhmD_O(3NnNTqv>lm$?X${Awei0VHNTBb-PhEMvx%+&3I
z@)GaU7;j(Cr9|KcO`sg?#~n^N{b|_MNUYh~-D)Do{gZ{Mr6bOKfsmZ-90OEdNIuHj
zUH5tT`c))EnLhF(W4b(J9EwQ<DPyF{FKs0ARmntbl)=Ca?t1+yM6|wr8s<=R<WX)N
zMAIsn0XX>qIc#^wN~~?!Z7vLp7YUvm6Z&SE4U#9@E^cgL7wi>n@SbboRYz=^WU&30
zUy3`AGDU4TGPDu}8Fk8>k<+0db@i%_pvSblpb^;M){Jw(Eta1gw=XLs07>QoTWH`8
zdG@NYgy$=(Y*WLOapp3%c&hA;v4LhgUz47-a!HHLyh9rQ00;vdV~VetH%vD#%!D32
zX{0A2RpuLimjDiw;@>a;DEbO$+_0xTsZ=3jyC);oor!Eh^5p*bkPS4q50-AVERDDp
zE}MYH0{&G18Q-|L`FOzUY1qlJ=LRu@+MF0{03LBtgn@MVAI$`?0YD><tyCL#9uHpi
zNg25gd~O`lF7gfyHL<_FNVxLB&p4)L*&tN=IAeDPOvG#e?ilWP$3Ig+`@^2q7x7~U
ztvmy{aqHfbA+lryGM&RXt14T|BPW*Ts~|pWaB9#8j!39vlPEY*xOB}}MNP7vyi_Uc
z$7-2zwT64vOc<dC;CG&tcGfp-XGTGcolYPRr_3q@0Jl%#?^~KICH^3IK|H7DUx%Uh
zscy-fc%OxzYj|n`nhuUR`E68JaufGp>?fMR&{YPXr;n5USkI+(MN^C@`@Jj6XN4&l
z%%dk5rtCa(#a?9@Jt`u+o;b;*PcdHy)`6U!2U?t}?a0M2j(Qpj<{7k962gq1G6T<3
zR=<m(qaQC`)Wr2UYyCDhR>TR(^sX-ZPGypB^kN4!>tr3tmCaGQwT0mS09S*axUPy=
zhZb>H!p3Ou+ly>3`jhF>vZc3R7v(uM>l%ifN1KaW@zf6W$X(g6c|Uj2x?;VW7`yd6
z3{D2u(Bg`)W*8%yPII0=I@+Gxfi7Y_c{r@cjfU@(*QZXRk>pgQ;>dw)brmA8{{U;H
zMf_bFm!>!!YfG6T*dr(CJJiZfPBYgPNgIXW{o__po!vzYq+C<aQ^i<T`B3gXDw6*I
z56x347##PhY^009hC07NnttK5ayd0oJ<l7d`;QsNTFz26iY6`d1IJ2ka^!z1Z`3bZ
zJ$iMnIlG;3L%})w&DNeVk}`VKT<#opr?1}`$KCB*(mG;HJ$JFE9Gvu~4Y?mF{OSI@
z_N?q!)6?*zBaWw~FH(4*{nJ`O8O)CzIsPhX>S^chnrEk4>Vi2Y$k=?RjQrID4`b4-
zG5L=@suPZQ?OicB<X1mK)|MnMbr=fWMrrsZfCzat(CIcVWJ1xeCpe{6s)TNBhQqqE
zNo;Lswt-R~-7a(1y#mrKMHt#~S(X;zRXswCj8{bx0E@?J`FvG=W_{KN4apR&T8II#
zpYGMgKOy3(rb2z*)h2j2-P*jlJD$X2Vsb~R>rLYwM_P<yE5lQ`^8WDaP+07oefnwp
zr>|O!k+}TSxjPS9r4m~nJ92&Le~W>hl)=z*+MF?vaz6E1h^{-+Aa$hUo+u;`KD2S3
z-D^~cY+n6;N;`C<=O>=@p1<!^SVEKXjzvUC9RR1Fx_)Yjx_$25sg#KM+}~O$dFF~m
z-08sta1L=#Tpr^&s=>z}F%<pWk{kG|mewtzbNAN(Pzl^J1tPF3oUU<B$m8zx?M%&q
z0QAK$kPZ$hLjZbH9E_ajtu!IW7y~1%Mo9kaRC&Vzp45bl=MB`=Ay{#5o3DRbVf)1H
z2BYV3=e;i(1CI2^Vcc`WQI2_9V9t8fs@!t4(1v68p4(^u=kA`BI0{!hQVa(lFM4ST
z<3Jlb{pxlH9Ir}NBX`|BDkdNz65wUJQ(%XmqjaX7fjS<w5tAo{Jv!89aUgDLgFtuW
z;g3p$?j-&0l{Ue*pIUa%BRo>ES2Nu*PY2%>G%yXk`ubG+e|ga6u0n?c<UMI#z~n@T
zK28^fsluo|4NMdco|GDgAtEdc^fa4!KPddFTpxN*Po+)DA}jKAsE9cHD#0h;rABd)
z^0h0JKzjD0vEX&7O7!5<3Y;EID}bDF_qtK*z@TUQl<uT(J5h01Xa^^na04{(zbWUp
zdUidJN;!yRWPGFLG=O})Dns{20)T#$`Gg<?2kSr>?B9Bw{6mH7P8d6QA9|@WSl)I6
zwA4o!JdU+s?brv_p=CK8_@{9ZbM4ZYbMoUgD-V~C=TVKhe6Z<Mh9>WqpGskWmw<ZH
zjtf7`DS<|M9+d7Oxjb?@{&e--f%12y+BwK>l<*j1oQzYrn*uuU2Oa6S;QYO+OcKW#
z{Ar|ca(h!E;&IQ*+M03bdQ#`70+5ln?+%`{6jQqY0FQR#_$$FYZnmT1hK>8f=C_7i
z>?`+?U+-tW3B`N#i@GU3TJql<X^_63ZGI5>w$Qrg);Ay#^zJ?CqV+eUEm7c_kp^3W
zRYwF4J6ANo0;i5&wRHNbsFqwi9J%_6=A;9A4c#$bjvsT@PeSFOPc*Sp!eX}KQgrTI
z0Jz5$gKEG{2;6<MTk1*EpON>J53PMR5*LZ(;-_X}YY8A^$cT{+NF6Jey}!1y@Xobx
z7ffek91)3tAiMH-?|?b3&r~brN*t(R5a5oW*PZIN(A-#<-LMkmx@=L@<CE`Ei=f)F
zGmDi-**i0uxwwu=14U}crVvOy10JAzdRAP7d1ru0deWUDjS2|Zji(;9n<)pMDka1~
zVSA82nXf)j<wwzB+fi5SGb!bOSP!YBQbAL<BRuD!tz8FCwY$C5Wx9KWwuaj*c?F!1
z6$iQN>?t*?7PPywFcg-~ea17pEfX*BH-Dk;T+))gjTSDOpC$D(QK1&jTIF|rpr0*r
z2_I2b43NH#@&5p5U4}C&qLMZf)8@~yI5kzG%rUm`K1`g`*(2X(#_0esHV6kfUNC(#
zO2+)@noA9!@K&{p*&}#v?bs`@K5LdE<pYwTPEV$Om3bgZt@KG@@jUBxF4i@QXqltg
z-HQzO;4Th(R#mjRV0*~!Ev72g4zav)ZP_OnVlYDv#2j#VB9d`3PkxYVw$8C%21)J1
zfY<<nyS9<Z=Z>P4j(Odd?~&v2ABrGf5qK)##eEuy^pXCJAlL~Dm0m`6wiIE3sz{^B
zQhe4vW(jO(^z^G5bLdlQ*8c$7I<B#1udC*3i+BSl-otb49P!B@0!ip9Rhl?;pAs#$
zwW!N%`jymhTuW{eSA^vODn?g&^%w@52ur77sH=$h190eR&w&|Z3|%-msHBo3IQ{7u
z01WgUvzm>g+Lr_SPR>K;e9IFPw4Z*Tkv{a2HMt=hl<>cIsHnkxj0C5ztwij}6C87n
zlxAUa%JI4tBPzoLXQ#b82Qn@G_(N{SGy`Tb2VefZT!74CXhx53BT2W*Cp*ChCur|k
z@k#sXHzdr1jk~df>MG=Sa>Wj(<=o6S+J#ptJjlmzt<-0banw?JjWJo+$+KwPo^wia
z6-Mw*I*yd|w!a<|zrA&^5UM1Dbm%2yCvNpj?kW!i;}sYitYwtm*+URgR$H8`ZhyL`
z9JV<Fy-tJYUC9%d8E^mtsjDjKu!eKAxX#>X0Q=P?Hjk*rtEpl$BC5$Cz+>y|D&%m=
z`d7qMT`^wf(${i`=1~xgV3`XyQH}r^IW(Fp+9b6e0v|LacT6{uHV!}?GuQE^lXNu_
zvsqlEjkSP~9mIBTq3v1ACGXgv;xtJuha0}|KEB*ljn^-GZceI~5<ENwk(rPv>4V4s
zbjKK}u~#)MzQ_H&r5mkJSB~6HqDQs?qzT-jw*-$)Ge}xbwOy8Jxws_n033EC4gn(s
ziljJLn9OoH1a>tz`Jh5(VoMUlo=NwhMUudUJOU3GsRNHDPxV<WxF@zc;;BXEHlY-2
zHLgtHWS$4srn`n{bz7zLV_>QW2O~Y`u`R3ElXhg2k&f7@OQ^Mo2;c8@^%X;S5NB+8
zGL_m-PkMIpQ9)@J<mgA~Nuxv%u{wpsepS!QZ@e6EK|M3;S4S?Nym9k)s!UtYv}nXZ
z*SiieR+WI3E`NfH1<UCl3&}jyO<p+v0O1>mJ@t?uZ9uAXxtr6EPQI0PCy3jUA2=PV
zj-ws4z8`SUa#%_oSq4htnmOj~Z0WKy_yfb?qzxj#@kqy=+eyLCxX0yFc_>lFKpS}4
zI#(fMs3H`H>^G2zrV2CH>cIN-uBr=$eKr#9WxSvHW^$xeSn#nCah3WPm2N+?bo3I$
zN*|bo``*;cg^g?{^DnI9LkP){z!~)V)rbpua^`XOxCB-{vu~wIec`#TwRof1ERjU6
za<0rXfW6q`ifs;ruF;((+!hyhCMz3@o4NLzGlAvv-#(v8v!=s5dOW69v}@_E%iNgG
zSE)DypvR!B_I*4_Y+}<O4HctD8}pS?az;7~pUSDsZiC0<>z8mbKQpgfXOYjXB#%xp
zwx+$qlRet`oNwqoYLkZqmWEsy1`lt}p?Mf8AGE{|8_Nzbf30T|a4sYRThz=(V!|TF
zXeZEiqQ=p>YRJ)2q&oxAkK<6!A!#khlme*Sj(P1+hG7WgVDnIyjCtH9N*<<!j+DhO
zCg};fC+6IHbf!+p<=eg=7^b_xE#km!+i*{6r!y8d2#G5*T&gOl$t+F)6j-a1rpL<(
z<Hp{MaZpHwr(7!R3^IFr)|k_E2>dy(nS3+i1~F;T-ZZwcG=dv&LbFH^5ULn}OJD=X
zaalKT$rZ#O>13lQAgSQhBx6q*P0Nu>RnVy*QF|~9agmN{Xz<ZMNjTnmcd9o|Ma`)D
zGmXply=uyFrvhXPw>i%ktJvvv4R|77wh`np+Wd!M{&7-;Q3UD&j7}MI*B!^x(xiPe
z#TIsc18qmby2YC6UJ@FHnzvDvmg3O;$yGrlBMwx!P0Ps0r|gVd+#exJy^;_D<0Ggg
zx%`Dm$m%DmcPgP^IJp3MB}$wg4FEr%3oHoVJ}}^5pQn1eZwOh^Lup|uH;3hPH!J(8
zSOQr=2P?31pI=&Rp_jv&P!C|cr7MJ!FS`Mii0gtnHZW=2PGvilj7>HzA;STVp@Ac&
z525K*Zcr_O-KpDofTAoRPVflMat7bmJoKpvh{ZPPCp~-TB!Bhls36A=%Of4!?Fank
zuEJ7dZfDR_!+I16;jLY6M>iL3ag==Lff)q)bDzSP&uI^ZSzAc7c6-I)upb{@zvEF)
z98z0cIhj<efS~v1xAm(0nKJ5J`5*vC105>TC6(rm*gRfbw*-XA;DOI>Nj)kkn%qTv
z)6I0Tq&t{KGQ?-F?rO}ccPV51T!B>&{Cq;|D<h<;%2eQjry%|ZrCNy-ljU~Nl1(m|
zC61nLq}KN>#EUXqz)-0jFi&4`)EbQK+m%DRXwGTM_jfv`vn;n$$tRt;+1o74dz0Rq
z^X?oDyzxz?(8iOJic@!C`>n0X$!yd9UNEMj!Wo!uJQGM;Y@2+tc<n`txhCh!0?E>p
zV9OW}jFXc~2v@ta{{U5ww5TDE9eev#o1}srSLM93awQ~)&Q*Sgxb&xEHzF5R0z5W&
z88p+6Ae^t~QL{4%N$yTDOhDdlcOSdnnnXDcZ2YH@pIT0L9zZnqISMd`=FV|ZoNXuO
z>p?Axj(UobS=K9n9xOVjAgCvgL)3l;nu~Jm93GSm<L@3vdJN>rz+9i3wLA_7UbPDS
z;hohu{=Sr%C5XrX{HLW#56ZlM6+*oL_NmivBWq_pYc|DlbPi)UhF%EC#{#E7e8mKI
z=Zc!v;ziIk3x6UFt*RugAsJ%Iqy-+-)j64X<MphWH!Q-xzmJiP)!X<&+{y7z!JoV7
zs{(WAIj%kc4ay!*%q!Kt9oq-^nWnjoPnR1v^sai+vS&Ua+AR9BNCa5g;Yj_$^{$64
zxxR1Vtc^KwX&1_)5sKC0B;;2K^YeO+&jaQZhjGsWlw$;tI#ThG_qtF>%y52`(l|UC
zoDRJyLZ4AZ%0+#=bfwyH_*I~Xlf^r4vh<?pWnI4@`37-OlyC0wn!XTmz@^v@?hO|~
zYnf6*8%2VE^IZM*nv5hO-G1rkZ#CJJ7$X9i<*CoeO=%jOrgNgDx;%FKPLX`f+c&R0
ztC_g7kV!x84t+&?{Ps{fk>#f&u&k+cYf^;$m3sPDeH?Eo=GV(Pwmb>!?lOOMAm*X_
z9nSB$FVel;v`cK~?8{OA0AbqhKj>qx71*;Qh2+fe^s~9#K3NYwm1%6J+P}M$b6(QA
zEwF4GKVH=@_C2>h=x41T+C?mxo-Qor$@wLz1*G^NB)x0dPLFS&`0^BoN4Mks6TeJS
z{?SE$V>8D^wA;8zI(Mb=CiU%JwAwTTpY(Ic?kWe-lji>bM?HNiUOh2?WVCr-l`enP
zxfH%!gCDwT^oP<pZ`^v0dsR2mm}e0;zA7FmGS*!raC=`We5UD77z#gje*s-|nq+{V
z+&50Rs<K#0sDE(Zd(xxZ#fQ}9x*X^{j-J%HJagW(-qH7es*@i|s?abe<!Yr-GbvG$
z=vVdPkp0v2sY*B}fs9mpWh_95*3f9@oL^!l`=n%bsL35F$CEK*`?4v*+TgJsUw=yI
zjYzJiJgCj|DI9atr85l90;3#`)wd3vaAZuyE;0Gm^`@ArV<rRl{{UJijD!~E)N<OD
z9;(Q~({%TFV`quF_OC&)vsH>e-4D1sRQ9&9s-_`P@_JUhXaFB8bgvr|jB`Gp1D8gU
z9||ape7MGH^7qa<RdL2R9Vy$+2g*fxQ<H4>VHFb2>}Rj%M(zjARSWwLln49V_NY-b
zxo|KY!Qz7d05Ro%3Z`G>UQHn<*S%7JoQoUAdY+WK#(JKes-bQTE>2G)t!ko)E$<$y
z_qtFd=b1?F(yHw}nYz*uCp<q&s|dawc=^ZP9qGZw<I4VZmxl8P4f)fFU{B0?)mSWP
znHM9Hd88}}>bx4w^BiNRUbNF81pe^;6s#6CHw=C5^n{H4>dX?iKRrk#8<XcBjVlF<
z;2iX#ph-S&Yzio`EZ0|U-1>E?gC9|hbTvzH+n;`vyN&@3-;rF`I~p`Y;ky3-4N2x@
zM<=akhR=S~<z@}{jRZKCw~V$$G_b(=yL#1K<KL}0PDgrnA)-dfBc5?UBnAbk0p#*%
zJq1!kump30Ii`HxV|As#_3ci_9QqneEI0$l(xf1HW3F>ij{J_a<BjR_8fl8cjpK}t
zz3EFX7;YbOnDQuzha}_DsJW4w8NjO-DI}8&fG~Ne{&rwXH|I<M4mX+%iUI(=>DXlJ
zjE)c9s{@4SI`yh(!?~%I`TN45luyPpflVZn!8Cy6oHa`tlHCPMU_K;W+2^fX01x1%
zC;)WrQfDWpZuOY1CO8}pv>f^ll)aBMr*1mb*e*tTib4iE^r<nx<We?v{nOTq0%Rpd
zKKFWQ11FBu{(V16c0N<nrA>=Whp8O)r7CxHT95(q{Hsbcmg|gA;x1w>g9EK5!MmLG
zsk8EqpLe}9o=*mqg5x%Tr>z~2J*nM?(xV+u2dx4c*}&lSsPXTPYE~qX$sE%^gz`F5
zNCTfNbKa0{$9|N(0r{z=xF4-CF?S8$c+!>_A2;V!*pHjNKwp-~{Hdlj63JncmK|y~
zJU1)Spz{YmG3nBic_*l<QXeTM<HrN7J8<+h8us9Q>JBs2x>LBCECyYJpU#{cfHB4@
zn9k#a-kb@~Q^De$%-l<bhRy)%OeAd?H5#9%CW1%HPUP5W;g2oWqhrYA)6Yy|qdDEl
zJtzRr-WlMU=QY??Uk&RKlaSUfG5o8d?oMki`AN2y1$m6sElPv4K2O#W(@?rbQSzrh
zT;SI&E(D4&yw`o=i#eh3ZnTBnw@)O4KizgDeqAeon<C~s<Acq5I9IAYs&4TmhaYK(
zY#IJl(83TRoHty7T-<Ix*$D{4_oBK6bxbK>R||$va7H@*74{epgz_<$xu2+G$hZUy
zG+q5Gi@VsiolbThf0cFD<xQ#$z@IptoSNe=$ino-NUFr5u$>M{?Z0^-<PfJGgw>r2
z!%Mr@*j@Od%H2}g+;4mr+6lnm^T+GZ)oZe*PvSdd{3{+#E;0jgC_H+K@v0u%jHOMe
zyFTX5qpE5D0NU2jS=ry(+rtwDR5&s*{w61qefw5D(ba#nVl!S`m>j&Rm&kYSPkfJl
zwVx?zB$?cfzrwXYpL6|*EKi06j2HeKdRHg2v$^Ns^662ZJf+Obk=zgLj}S*Cxsjx?
zjbd`&>WFNT2Yxuk7Y0_-GzV#H*nOHrJ8`&R@tV&;`?x-5%S=G2<T2vyMZ`_FP*vPI
z5Tl>gosVTJ4I4|2593!+&zFs)ot>(vRQotPi92)0^QeLOly2|qLq#)2HQKiX#0tE4
zK4K5kH05$-&cU>H6)l~PvvY4bw9+pp^5EqIfKRgLsrDS2hIlnAd7xX54S1T|G{ggQ
zY|5D(equ5D{uQ0|Gxm|auC6)un55kloTdmJNTg<sZLp|=o`7Q?l~*#BxLint1jYwW
zl+suh`C~jDy(-cv$mp~iTN&<kd)wVcW{TESA`uZ|Gx`&p06Lzz^sQeL+s4*@AJrmd
z**)NakCb`9;FH@OIr>&+fp=n_1Ng0PCDZxO4Ybzr0l_Fv?tQ_>8LgIu^*@L3Y4CWf
zUb88$d9cMJD=gsS3gBao{CDRDvZ<t(W5Jd#P{moj4pP~%9PQ=AL6bN>ql$Z#WpE-O
z^{Nmo$*f*OBW0kvc;y48<v2BEoA>NhNf_d-A3+&i8dk7*8cdpn-kl7PvOT;BE1XJ3
zepK#4^&oLq?Dgxv_(r@@46tbt+e@UF1R~NWWmY34ODQ3{Zd^B^9M&c5T7-965V*C}
z6dg5Q5i?{6*ykuSfDhrCh5WX)x=*l1O8^7x$xe7R4mUX~P>ofq`;9$GbS2SK$?)Bt
z>yHYwYQJf6u-q$*oxZG}cX7sZ#}$<owyHE6<@+18t;OtU*90*L%g)fi;1(PZz~yPy
z^Ib(W!dP$SiBw2pUCX(XATh$R!sjQ{b;nwKI3^gy++hviX53rLEuXx~I{sP5N>(?+
z!NNSP-_*R<8Y$GgE#&FfQO_Jvr0Fc9%lQutyF3Ch$7-4=p*}5|S-e>lqC8SNNw@BX
z&H|hg!?#YAloL<>)|IDluPyrw#-nKCjt@S=+P5s9Mvucb?;2?rmw(zNQX7RXsTn`r
z_3y!<=v_*R2#3wKdEsd!F{jy=g<ek4fxzQ)cjFX+)JG=KDPD0=N^V<Ul18+QZkLpd
zU=N`5so|Wbjr8F@lNgOG+skPXsxb$KIKU)()D2hD^dOC8TatD!GZGY^oARqICCe)Y
zGk>c91J@qaMt70CWvon-qsH3IhBgR5E9-;n)~Aw25&*8paO9EFtryLGY%1+C!}5cI
zI(mw@<QsT-UK=$;a1RalI#a-tV8p5Sf#lL?r6R(y4~z_Xl`F{zLJKGYKnW(I8+@GP
zj(sVGq22*&Vpx6M!*)G!*B^x|1Ce05t-%X($Z#72jCbd~PA7pTj5A#P&N(9^ny3OX
zPn6>ws>Ck>>UJhuOIcMUW93VokB~+V+#WNL$mCIDHpbsX9my8ft0{Pbm0(1P&UyCj
zP(h|^v&-<(EepjOE~~0)PcpuXWem|?+e(e{#=?EE%F>LK@|})GFi8~kF{P|(l3X()
zVV+UfKA+6eSl#Njemd}Wp<}M!TIw2qi>>c0uOcAHZ*dcbNf#iDf(KAVTvEQf95|Y8
zQEofg+qL}5nr5M_&8z%DhWgW1w>Hxj@}!NHOH!@1p&@{6>OllIA+j++)@FTnc+Z0b
zwtr~=Nph>bTl>Isjy)?IRef6j0OCK3HCz7x6>HZQdY_9f^*iaAl}y)D$ju{=fGEon
zcmR3;DT3n8EgIEin&WfdGNH#o$IMT!Z>3i)_Bj-xK_^k#_Fpqra~Z$6XrPQPI0&Z|
z2k%T0A1sg%la9bu7MV<vg_-t)jFZ-tC2?&gE+kXD{nn|qk5w%di9T~8ZOHj^OpvbV
zy)oDM)m`jZ;z!Og#X}=7bOndq^`ge8v?OB?257Umk@U?)Czc^Ob;&$tq7tZr^)qaD
zs$`V~hB+8Lz46wmvwXucXPzp#OGVO9KnCoRI^wHN&WQ`8%&r)1ar`anew7h-^3MYq
zrn95lgew04d}NAtDeQNaTK>0dp!lBJOPLq#9vYiYyAaM*Zmivr+BtTgnOT)jQTIh+
zNo%Oyd_C0l6!6?J*<1MHI|h^O36;2HE{o;v-;KTTx3+U!%Sz^Hhucd9LNZ1_N=ti~
z1d5~1+*EEj>PB!)H528Y60IuEaqenGYX1Olf$j{OSCFbl-tE*LGuD(u9O^~y?BW6`
zn=>3MFa(8O4=i|Je&U`djia|OEWJ)bk?F-%n&MyV+n826J(64_yD$a8T;K!fbCdr7
z>ZN9P{cdvHx|cU^sanlHiF`?LW72Ky(p#ydl&mnW*y2*;kcc={909-;(?cUe;ak;v
z>t<;$;V-%@1j?V8c=yM>a<;R7rfH}nxMf=-^6cnOPp_?QB+;dn*PCG!g}l9}>C43-
z>fO(x9F4x5Q<P4~tqm!J52W~n+iRDS7_{hT-uBy3mE49^Q<Atj`r@+MC1a+T&YWND
z!5B#=I~Sf$YzzP@(+FkMZx$UxPEal5%xf;dsuwsU<0seO>sZp3Xs5{xH%GLgzzRBp
z_3uPtHtbuPAsgKSXHc%7VTRQtbH_dTtfefAbXMWW`&rt0Wct;a%!|DJzfFAHld<H>
z;~jD6YL4THet7UP@|EN8t5F<TP%akfgC_NVn2yJ|s-U|hm|1$&*D4f|7*NH&q;%$)
z6z>(bvlzF4iLFAC$_W@Cj1oBK(zS{lq-U`r6>mKJt&X(|7|N~?dy!L05ZI<AZQ^i3
z?aH5g{{Z!>-luyd%+D;E4~C&;)8j%ct%PbyjBYABp60H`4sPaTQW*6}8aQp;hJIGg
z)5me%oc{poZWxpd<gieBXPSj#K2#2=dQLEL_d%vAyG+E~$a(>qIYrKeg`@r{hI8r7
zNsuIC<({4Dc8g72DWv|?Pc&XCi1^&#_w>awWkr(AtA-D38y&?73!O2lM%TtcK9qo{
zW+Y~i^!v@ykp01sDy(MNCgm|U5l&n2q|PnKC^>A<3Ih=_hWW-pIM1~s51f({1mpqQ
zku8cg?Hu){pS?+w^7QFQ58vR>O~)Oew_cPIN=N&%O~=-yPr7*QDKc3q0k%AW{c6Ai
zD}Z`bDUt`uzk004j5o?T9jhr5amkOH<{fHr_Y~v<oK!;`VO0FpF#C(^nufrcdI7h$
zdb1Lou1V`vz#re}YUD?U;B>6mjVnR>#^hra?%xaT*ZWISl%OO+sy`F|0M@S&vs|+9
zI#<$P46T)X6Xy9044RYYBd*>CD~`L_9GIzlr?^@iT1Ut5RjvG<I`dVb$h41+cA8R7
zdH(Hl*zsDqZ+iT_Y5RtHRRG)$y(#Md0PPwqE>vg+83W#?UY$o;&PK@}GgXCupQx#5
ze5K{+a%x-+zj#$uVdbaFbDEGpy-7(Ha5nVqM;m$$l@|5D`Oj)n+ztgIk`(;~0~kCC
zZbu(lU(2l*Eg{@`(&cuy?$`0C&f?t-Av_KZ2&EEUIQzY5J8(W!{Aw(mw>^a!8%Nfz
z;Nna+?msGYr0#eX4o*)dq+H>$+-Ig~i<EdBeo^^S5I6nNK|e3v?@Zh>c{!;n!@wCo
zBJ`n=3m=g`5m5#kkIuyB)}9!1(u<8mjiZc%@+V(PuJA@!e(idCRjiD^%s%x88&4vm
znVKjr#$($=TkbDI+NwRAM?brd@~xr<Pt&b1udwS!J1f~m^f|e7^eXs`dLC;geJ~Ul
zOdaPn-0fVR2jfg=(2uyaO0<!b@Q{~7&;J0jKY7r86=^hxaHGin5!;&WL}`xIBE=q8
zj`eF5BM+!UvBxHpZ-M)k98}At#H0}b`@<YpU?Yz|aVh&F!TC~;tVxuxa9s{nEL3CU
z1D?XJM{EE9Dt=YARe!p@eJI#7_gAl_X6iO;8Zkz4!a!~fN+UQp!K>Q`_gAe*5q6%R
zcB58mos8{`gTVW}>Aq9(T7^c{`BspHB=CAsVCOQ7ZIj0trWAic(zS{%NZNW+e6i2U
zXh?kKL08?;`qQx3=-AJC)e-P|QRS{1<XW_YoXHFG4k}dxA9uZId2#ddEiacI!G#@Z
zhdEV1<Av!`Y+icwsX~A{d(?mo;~lE5OOap7T(`)h-kM??Tjc#J?{W2@0lWBmQWrZj
zj6-Sp2j2ASP_zeW{o8&uu0ZF3Q4lcQdeAjCVo4Kc__|eANdXvFt@cn+zUehtqZuHB
z_qeJwQ!`PV4oh{Sw0xC0{oZ)*MHe43FLZIi=}VFusHTDl<n=U}0FX~=;yTH*@{AUx
z+;hntY692;gVL2wRj}Qv#LEhPWaId%$01G|@~WzSMLyLaKPVvgszy>Q4B&D)Q^Crf
zPHGi7Bah*y9QyY4pv-aW->o-y%m8fh)|yGj-amBHK>>i<&gx9jM4LRfUX+Z-2kA&N
z=sHr6GBQO7Z4Bxd?L9lxY*a5_T9J-709P5R(*FR*yPo^%lNE^F#@GA3I@Af1Df_)@
zCoE)MTkm3~hiG-<_-d{VSrZHl6X{a`eqXI93Rjgw>5)^$g`GVqGA>IBa7iQYX0M<g
zl+;iaDsBgJS+QQ>gS7HG({sq{(u0g1X^cR@<E1MN56=f6b)^Jk^V*`%Ba!!MrH8M2
zRtpmo$5#9(3<iE<_j+Qh@9Xl@3myIFu+&RMlRtEG??_0`3@W)Np1mnSJaTGmI}>y3
z+Ja8f0jToX9MTikm4pS38-qsWz|W;b<oRrQ``(>u47Lx<deLH%C)_uazr7~mwa(%_
zDzR=z#U}1YUJrUja+X7L&#gJLg{t9{u;dDuG1`7%K`jbM+IT%G7CBS%b~P#Jc^xVi
z$3HLd&?G>_;l5#>)mgKX^B$FK^gkf$Q7|O2?TTfhsn1+ulrb63I@8EFIKla976<#U
z(t(o)`@c78c#z~|o|RXC!=BW+T#uW*0<m)=90Agt2;6u8;;IJ0IBJwKmiworJDIdt
z8RwJImm@tp)LVrvMi0$YnVUqX9-^3Wf(Y$R7%a4`50=LVrBWe`INJPG8-Pp)<!+d(
znfXuBn7|m@pW&)Px$~dIJ3UH2h}wPNnN6&|6OspC?o6+_NdEwNNzc-}j_Uy!<0XOS
zzMb*qp_}24h{8mr<5ihG${dmSjMvO}gMotF57N4@^VIfma^`_XHX?Yi!-lQcS-#Bd
z^C2M)(nslB@{lCS&*4_S(BX1Zb~*uHS(nyHYGI0`*xUD&OA`3`NL{?2f6ln;$ICt>
z1gORbLG4{F<dQv^VjvtG06F5hOSWM&nN<6=*IH?r;p1Z#S93nW9AA5u?!@-|D?fOT
zP??RZFik;5+;NpT#ap-_OAcK*VsYt9s9Gv`XG)&m#5!F0v`dSq*oBrh<ZWM2I+4`y
zYssq8JxJ71vVBZhUwpc&eV)}snuAC}3<b$21FsZFPWv=LD-&p(0nSfhRalaPj<R&5
z4>C;*i0rJg22whL4+rzCtaKW1!FtWCgJrbZ*tD~UbzO=voaByjdJcW6nz(CiyCMtr
z&ESE_&%HzDPSa`(_Y$*8>|KviNy#Vit2k7G#Ca{50|neL4m#lU;-R6Y`j3&LFxjk6
zFvJ6X@;Pjtp4i7;^zavI?%C6t&jtMJj3zML;-^6?{h4EqW|gkO1sw=K)|G+G(R<xY
zTUkMCuio0EQ<qkSm_L|*i*WCbD#TjvjH9rg8;>1o_mF*(MOZILWd(s7fyQz(p0$S|
zl0AO@Gv$_w=%cEf;fGK?YFAa4M$}{lRicDGF~J!C^Xp5Ib~&d;5_fA-XmYkQF=%%)
z<SO(Y)CP7kW%<SiDzIex9kwTww&EBOz~hV`{<TiNSh8l^+k+kldUiKmiwv`)$K~n+
z%y_^o4{u7?)32{B=9n~AJO0g&GDyMLbN8bs?zdoi)^)A5<;;^bMi7w39$8tySk!eS
z`U+t%8C)&ptjaD(+%vVn?lX=*3YjF%TKHOZUEb)qH1`why41|1G}oDC+Mu>L&mO&M
z5?o%|Al>s$KQ8rd@&u0WO?1AsG0cIT7C=m700`~HRSg)tgepamcz_n^!Otht)}b9K
z`<fcwC5}k^S>bdRdV;6?BBS?`uqILu1PtT>&;yFiwzbsmH3Rl&A8<tsckROFuK0!Z
z89pJ!CEtnkdD*nZWJ^eb!y29dPFS9qB%bx2(#|ce(mSi<W()I2AzTjqIj3z5=_e{t
zzUHfW_LD5OelMCyjk`g1O0t-Xw=ssvAg~=&gVbiT&JE=4nMUh@fxA6Va(^>bkU<o)
zfo~&k8DP>J7RL;I$7-Bs?Ee694o7p^r<J3wnzAiFk#Bou^J&(XOkM|745lKA*>sUc
zTMd9ZsUtmWpx69D`qs1J9a3+G-v}(O8^U^4nQodaZ)+WrTK@pcNMhb{@-9)2Ba(PE
z%|#RD;zYB%Si=@#PW_|Zh+O_cn9M|sRUlG$+^RE*mjv0I=|)XAx+RWXK<Tik)h8ie
zAs+{!&r&nn*0m?Ox0gY;S@f&*XGeI6A1((69mW{+$4bpE7HbWU4&w`M`E!HV{xsJv
zXJ$7NG2@d%f)uGH(=9^e=(b?SHwJ9+hV9q-QXY(cZlkBIM2#n!Ga`Sg=ZcgMmpysS
z4OrbV$ViUhyT^^(XSGV8G<ow+E0Ixw2}M_iL!1l)ij*`e6-=ZJm>YWjGz^|KV{U_I
zAx?8qvcfN-Y%W6MIQ=SU-(WbMaM2Yc^TG7bf2Bnu#pg-6qr%(ZE<1YCu`Pp0-@PhS
z4fx`vM}rDWkM$h(=Bc4plOV^m#mBB{K?9t&ap*f!v6Ew3KqQw0;J12Wx_RtMoOxco
z>NZ(KM=1dYV}K4%6vkyx%GReLLHz2GB0DOJ!X<87oSNfx8^n`V@V&GemBit-7m>oL
z%xbyF=NyxsE30V%mG?rKAPm+8v|4*>+MMfQv4zQ39P&r;0q<JVX*;vX%<vBrDr)vg
zn`y<m9j%>%f_hL%@*S`S2TFoQ3h9ClVh0r#_9d{b$gJAA?bDAeQtU{wIhY;lIHhgH
ziQY0WI@K^-O@Sse>DG~CVS370x}Lph*wl~)!R52O=Ak70p}u~NPLarN_}Y0Ml>yp9
zm1gJE)uEQy=H4<K<DArSlD=rdVTd&e$@2bV!qh-X_M9}F5OGC;vS*JopWcC*wG2@$
zo}vDe2oI;SK5$s{BOa95j4|23T15@zkH)Dqu5O7}95D9=jm~NN<*8*v;VqrNba9^G
zVw)G*C6evTE)qL&ziQ=r{{R+7KT%Y}5d^uMlaY^M{uOHsZKB&e`yS6@V4bI&oQ(FW
zGgKnF8p>{4P(${6XK7tbe`Rfn@{Uv}7~ppGt%oxUR8RC2!l4YE_{i^$_0KGqM)G%k
zQdTko2^dfg2Ot0d>DUUm^KQ1XTuJi5w{)@-$K%`EwJTh<Ut?x(QKPY)f6!v{Op=qj
zY<$i*;YsK@;B~84Q|a%lYfhG^U9X10<dBM?KwY^fl5@e%KN`bnN0M;F0KDRy?o3El
z+0MpO@{^Jee0HXyOG9o*eL_hM$Sg_aR|E3nr%H4R7|f4r9$MU$V%>+eL_Y9Uwj^&+
z^L^|dzmccDP~<Q?cdep~rdA5is;UVfAL$_hX2OC`dV%-vZ<R-Ej+HV4wcE<i@3Yhl
z(D?F#l>RJ%+*YcXoXTvc$vE4b<mRC%Gg;j>V!|lMECKulTy<dy%x~9>)RJ4+{{Ur2
zG=4C(GJUHJZ7gMF0~rTAsU5hc;zOB{6s*2_v||NZ810&SzL>VUQpa&}XJ&6XTwzxy
z<pBLU`cw}bvRuvO{zHr!fs#apcflb$Pb?}esS3^RO3*OWuaq^DZM|{192IYH!>`t*
zEBoS0{{Rj-rrQm+dGeHHszO(ssOwI{avH`w;BM*oRC&o?txmp4xQMm7u=3mG+(%K@
zBhs475S4<589V}Lu@@RdXUprsr~I3~^B<SJB8~?KtuIDAo|PeSxICYittbN-+18G^
z>rMa_9cc(}866EdPtFDpT2Kb_^A43FM$Pty5&hf_NbgeFEstCcn8!+;0qeKx#aB#%
z*<v}XDt_qCQ(4GE)BSKYHy<wpuWDuhAY@dE0pR*pYzfpKmxbhWR^tQ$IpwOfWQk)T
zMneKK?N?yrWRw20pL&K(&D}i-mLatL^#ki)UHC@d$?#8x;wS-I1P30Zb6+udPS{+0
zLD1sb3X6qi2hn*o^`4dyY~aFU2rJL3{o~HYOQF^7Q3OM9`<<zUhI*0psy<-d{<P;5
z8F_4;{c2A(#iGM;JB<q5uOk&qzChp(X?KheGmOz<k~GziY+|g&!{+&ytz;~iQ}Y^-
zO1^|p%CWK=r_3r{z=YtBddNu*SNDdjtNerahc%l;q-cg;R_jj;F~ffiP**q~cb{66
z6Oq!Os~5o;P7mFuWpaLD(yJ?R_eOTnxN-CI??@3jINi=U^`>shj{Nae*@%>U#-12_
zyoza-kvBYYM-<==-n?d`4VDAu=}#;JC?2#7KZy0E1myLkCxOYP=a0PIDcmeSaL4gf
zZPTqO&z34P$UGe8mBx^~V0?m%^V_FtXa@{2-k-E!{M_P;l!GT8_@v3e=9dQ_dXpUV
zG>by#(Tyn14>X)(pzBT@_%xa*4mtIsxcO+uC#5LrDnKwXNAa&pb`KpX+eQx@&;iar
z3Q?Sn1ui;tr2~=01Tnbdzgm$;&EKUw1=w;x`Kdu%91-t|WQ@lhDKquyPbY)O>r6Pq
z@l6PBTWfsuqdamtQfIGDw1l09rB#JuLC~D`qdcCK4&(EDyi<Wb^duG@NamVzla@Vb
z$FZg7(wJCj>Uix*lb(j3gHHqI9XnBR*o1B@zbkd8^Slfml`hrCZnU5s{{X|%i-?bp
z?$USv0D#n>a(MhHa52-hF%TY&!KmA*=eVmU7(XfNP_{GBPz7=i&DW7l?%c7!sZV|m
zGwDp}p1mrHLV>~Nic}+>4_=g1jDsZYAouA{-IBcas>;KE;ZkwOU%TsE);q39cM#kU
zyFkcchCL_;<!(E1KqHa!AD6u}1fh=gA%{+CbtC0DU%S$(1M>`e)71Runr3Xe4+j{h
zsp0z7WhZam&ow9~j!)g8vQi!VO~If8<`1nZ^dIk2SmI6?b);&Eh6nKqYd6d}sEPRw
zM>QE?yYCEUi;lyX{LS<gT1F=WpS@3!hR(R=t1}T90YN^rCO%L*dHHE#{{UT{I#fS5
zaDKHk3QfrC!K+M(qe3t;xdiiC5hw)p>rf((lY!E$Cjg9&O*YI)hBp2*@tvKzRABVy
znpP)oL(-w3LKE{ZJ?V^cy-!*RIq1K7kw$lLIj3TV1Hs_+r(>r|L&L2EjGkx!$2@w{
z75RY4>p^UH9chKvj!#;W(j)@|mhVfClRc^(*<sq3b~E!FRJ0Z($jc1VNf<nHOvvX2
zX@u}|*L4;P3dcF=-lFyEkF5la!-l4kIpp-EVv-p6$;Nur1pe^jBZ`rW5IR(C)OF1#
z64D$xj=cp<xqv(xtPjq;Doo^k<JOglXq3n{k8?;}Ok*_(>Uwnbs95~$3lT+yV$SZo
z3T{;64hI!jH_Ul7yN(acI?@Xha38fXv6J!+y+t%PUzuqb@P2XDnq-i_0R1YyPJZ`l
zo$zz>Rd(um9FEk}DF*ZX@6MHEJBKHwL_ykl6$#u4`HeJ!#)y!B2qy$n%!4a}YcqQT
z-=#Q8zb;SZPQ*Bxt02l?_vWNBe(3z`ipvf#4o@beE~Kx|O&CcRi>}Ey?dw$@LKVJq
z*QG|z*z4M=O5i?s4wY#c*vQt0nWAcFK>6)iPvS9OE9)>#4~TWh8F`NJhv#2XUrL7F
z<M)HDeE$IBTXkO*EyAum)e8RSvHYt_PR#VMGqbVhEUaD?0zz6q0;tI(`U-?dJh6=8
zop4=QnPnh}2O#vv)AX#e?lb$gJf8LL;j40<g;;YE+)Mk5j0Wm@_WD;ha_m^;pBV32
zk~^3rIX&wV<b&pZ^P<<H>fIdir)Ff#z|AL5xm3<%fW{?q1LP>`eQH_35<Xbq^Tkyo
z3P_NHjxk)*cRJKj452*06**QRvr!UuHZjP@(xd>Hm;f?zPEV()sLtF2&IzbBOjT=j
zk`U5$VUy?&f5Nr(TfIJQV@HPA%xr8lsS*Z$9f@9YI~Hz#O2BXnx#JwuPU0g2pl)$W
z#&eC@eT#lw+RdXWv%HPww*^FqR63K4u6q6zx@|RmFIm%WUDSa(v~qc83hUdRI6QZ&
z`a^4a*Nn6zk+j6L)1fyrWx}_W3XQ-M>IOLKO;GU#>)dGijE7fpruF1V*@!APaJb}j
zscEZuo^4!rEm+ficRAdL)%A%9e9L^&oScwNT8Z(c>Sz%OlHX~_?VjG1p9?0_hRzRM
zRMDAD(*4YC=B~%0nDqch$mb`uTY$&0zHyMeR3xD+0<Q+5Rsp2pvM9C2rDLhHzS9T8
z&34H&YwxvO+{)9)UjdO<5vqQ<2d!f)WLiVR4Y<!855Ll>tLAt}0Z2VZtzX(jv;ppc
z&G0$TVOhA?RN|uB?rqs>I&%19Q?a=4&6Ke|kU(aAtdjytNFN2hT=F_F;MOZ7f-DKQ
z11C}M{xqT(+C557HAH9>eBD^L01w8u+TX*gqG(8bOp9>ZRB}5O45^WlrAKkos5K8l
zm7x7hi>UO})wH1kt{200{$a_<n2fhyP6anVF~c=L?HRe4tnj$ra8MD)(9&-_aC5k0
znyVVeL|Z(Fhyx&0ia|R~%t~|Bj{>2Lz9Jr3<$F`vWAcIA-+u?1Ry0hzBixM^))v;L
z*xP0Dmm7Kz2|aQ#)84A7K740m914xc`Y`4C@y!X4r|13}Rs>rzVkcp4NduEh9`7u+
z;qzvoX8!<1#?o@Vs<2=kesi22^pXQavg{u*Cp3}DqW2zr*j35nJk>>FS#VF*pCZVB
zozbv8cCbADbXXB-T|>qLPQ%RT$B|Yhnh&(5EM0L11`mIF&W=nM$m$2_Rm|y@+_HIv
zodS-SJrChalulOM+m?2Q+dwkgG9}KQW{JZqZcxP=AxSDh2dD?WDYF=gL$&SP7{=nQ
zpTe?YhTUwpnB0~G{Ku)Mvs^=YaU8Hq42VYbkZok|$UP1!QYV={rGQvX76iZxrEWb(
zZ>3v_<}=Pb&Ndv?G?86Z*6u8G^ABnkZ!P3+BRn3x593b4(6K8Iw>k3;0)c_p<DM$J
zzuqOf$@)|eC}sp>kT_9LNPa}jeEOPc4I@QN9%KIf7;Gn{XSt7b<NyI2ao6in5=2Rf
zaB<qJ%JLZG3j<*x+{H)TUYS0En8{0Io_~g`i9+2lFZ>;;4*viuJV<a*bKarMVqB63
z&s32}mD@W`?n$Ivo4zG>Z2tfobNbXQ%l3hT#yfYV1ON|~bLpC^4&|+`$WH#fDVR`4
z-oO=HNW$h5^J8}+ule@tX)74u&M<iCMTF;K1Gu3flLz#s>|lsYi^oc2R}r(%^2E4q
zJ?STrHj%k_IO3lxCCcPZ?(;a2!N=YDQ$Pd$TQ&-u{#6!!bvPUvkz59S!Xxq?8mI{)
zNFHQY)fy4@X~=&hzFAPRuFyx{BW`nnoYa=HBHBulTR=kvA&z$;_U(hynyADW;}|3N
zs(3xeO1Cr<e`DLp_E<KJQB`q`#4?=cz6LNTv6nNseHt$$5ZO}r2BlVD8!US9=xT%k
z7f&k1cVUh}?^;%Z&7-+l8MprcXS=QsJBL6%w9*uqtais7ia{ztz@ggiOT98UAdXv$
zi^YNnw}m1{U=TAl6e%YeBmv&3&*uLCX3Tt{xj@^-DoY70q`aALA=g&k1t#UK6%4o_
zg$uvs$vErVrD&ku##5D(FKW=Gm&8qK%{*gadY0=PGh9NrLpT_fQ?BJnGJ%H-2H<c-
zH*q0%C<A!UwN!M`AK|^7z|{OsnunPt#C@V86l_BrV4c{;21kCqr?*S5?2R?#lFhd<
zP|>zVM?CsxwQmY`Ibl)CI_Sw<952eDNd0J&%~skh<!17iJaVJCtB{*Cj@9RbQFTpL
z1~I_fOD62P?jY?XbT~MtUKV|GT%H|1=^&QtbV)SgNl^}dMsbbXdS?TQ(MIftP|uaz
z>GmpaZAu1WFr#oM)b;ub&y&hXZkWay_6@$?znxx@NR@$$<t@P@r><(Vs*=E=<Z(&F
zeAglJ^;kuk-Dwx`2DXk=E&xVBxxRx8jxwY&@NzxsjEwJoR0Y}=v~MN3kKy-$R!v>z
zf#tYim1Qx=xKkJmPImf?4`Eog;!}A$h~H&rDA|!t_idL{k0C}tDmqYh>?dny9q3?z
zl!iRgU~`A=IH0?Y9SPcKJBnu<{V7`?DGYkj=O=|cjx$mNK7FsBT2&3Wl7|@LorAdK
zcc*|j%!BWG)HW9*!xBDD0jG_;;yHfjQhJ(P5Tpj<6yKk3Z@W^#v2***A3Rfo0Oyi2
z26>|qdGEGKii5#ngZO|?^EGDDSR>Xg-J^m30MkO4*>Vb={{UaYrI}Tzp%(iL1Qt=V
zoOh{^0k`Jpdeg2DE&KeV{bAyf0mwQ25uDa?Dl)oEllX_qYIVj3A5Lm9o<3fcAnFe|
z#X|yR-R2Aq)u(R1G$SXiXT`V87|$eTwk<$6P=U85KnE3+-HE-AUifijTUFF<S|foU
zmZu%T=DvosK(;IMo<OfQ@J*0|!TLD+I0dbiMn317^ytcnP;5L`n%&zxj6|;@esaHi
z?$dza@!pyU+9}x^k5A5-&PH?Q0lU3BBq;h)HVYh@Xe-amGny`1CIpf`ZuKzeIW-EA
z=)G!n#=*rG87drY7&Rz7^&^^tjD7C(;gf;1_3Khmbzgz=4_cjE<Z`u1cJ1g-y-c{r
zQ%DP<Pndj$oLKOC=Bgp<$*U?jT$4(}OkPTkwDkvS{NJ4cP8TF}sT2=U(v^zl95@Y(
z^rackU(SQn^WKmVk;O1Xnd)~^6Uh3~V?V@tQPBqnlTyn=i)0#%ljaVT;&@zoQe%_I
z`_x>k4g_(?{OR5L9+c2H98<^K9CoBMCvo+pC4EI9-GleKQ!vH48dohL;ekC5T9jiA
z&uWKm1~b}}94FyOWTUC$y)PSw2BHT8wJ1L@$uxrG-B=HLb_mBksvyJEbo8Y!%JWXd
zHcWaiPLzQBhu1X;ZkPkDH*v}5t5qaPKJEuJp}tT!s^yMHzqKwi{B&3e%Y5B?(i84F
z(+6I?>2b;6pPH(`DDTsy9Ot)Mb_fHCPIHWQpa2ef3VsGU(?RF%p0w=!I?-@Q0QrYn
zlLKk%(wMzpijzMpaYADlIv$ke9Irpa+MWQx;C<Q-eqImOfeXe52dy+`cUn$&514hN
zBmy}UfPO|#2dy5IfTtXs)42ZdJX0iL2cEy3BQLL|N->emI|FY(XiP;mL-PEhqGdb5
z!K=h@I26*LuS%<pGd~0t=8Cdc40Gv4B8(((MsrguoE}AHqxJdCPONr}Vz9B-b3=E^
zX}RS5#;Plj=bqIrRD{7J9dkevDLFijm0@wm-Kt>noQ}0Nco;qC0@}AvnDpkXFG0zw
zN_utaQwQmc^{E7lxfnevCSkn%wHEJ?e9iZ1o4F?@i<&5oa(5G+HqsuQXxs{(4@zeR
z$EUqb%SdBxFMto;r)*HEmVEkB<#!Hy(~md<G|)04xpf0PkZVTXC0rb2^~tEBPzrI)
zXhuFk!0A?uB`b~q?i^I04WqA02N>hAraNLmhCDB7qcUEFa(hz?a@cWE7yaLSnuwAK
z!wi~s8Y~tYM^2R&m~q>!RxH5dBP8>hKu-RrG*}CJvb_#{X{7Pr-xR^Z4!PS%bB?{~
z@{J)0V<P7`#}y|VN8PCT$>Nj(R2-U38l*9f0r`zC?1ko#sq40y1_<lYq_l}M^Cm+M
zX&jQ{kKv}|<EwO_ADCozpqmZJ&UvIH6+J3$GxvC=;R$X}UYMXn4n9@n^{AMfHwUFy
zVb|qsW};=`y7cWwDAOSg^K=w}*KqpKM+c78UCtQv>r-O)EVP3hW35Kar)a^>Dyeaf
zpT$N-e)npgP~{{ncN~M$wI=RQ-Kg`|<uu&&IpUWnoJ#@u>S!!B_WRXPx6YimLr5E_
z$)#c%EtVN00-|6%&b_KF$DVsq7Z^W!m4rL9b4)lm$Q>x$G55PuN#JtTXf8(J<EbK{
zAniOFvVQ_8gbcO_`coy429O`U-kc<C=Wy>xz-O;&tm6P2)gl_XYtH#c$}zjOR-R9h
zh$?cmRo%R{<PJ?|PcsOZZv1mpnVX49_EY7_^A5aMn)s$Am&5m&0F_<JdyH3Ubs;8S
zo4s<nh!1aa2?b15aW<s+T0BZ{O0tr89cvy@``5$v>MNnvW0D^ckcfsN8z(%2+wiV(
zT<vquEP7X?NuJasq>3_b@}~Xq<!c^(5^tM4=C!2&1M{)trDad|<~uW-3hso&<Ef1y
zB!wsVs+54M9)F6j$_SL4j2f)_OsYvAO18^IR#WBY9af@ZqBR8<8>)F&?E?b=`_)$r
zLlAm?w2BzTcbqpK^bNl^4V+SdJfreAPV~{Y%ac3vjwzyBC$W}jyh{sxuIW&w7)EeN
zJ$||OtqYqtWYP-6W?1FClgMTV3`aO8*0Iq%&o?Xv*vT0<&+?^7F4IVr68`KB&GLsh
z=h}v^vFBp2ilpN;q>%G(sY9f*wu^WXSO#zb9-XOIK2qW?q+=A2-f9C!h7)k@7;m`8
zjCxe|{{U!{TS)9|Z)K1vXx9U9AY`9TDA%de88o#bK{3B0EDD}MCalTjrlSE^!RSbC
zhtyS*XX1gW#dC4tjYI=JWRR+r9CaXc{Hr(2M!u60<#*sVI6q1gOsLIEW?4WU>rj2M
zpj@^T5(hm6Tam5)%i-jWZyHks?=P5e1`o@Q-7}tQ8)vbPQPsof`kSfIWL>KK?qTwu
zpgfV@mRPPA!#V_$#DmYWcZBZ*x`xAWIT$<~(92RSMHSQN*0K|BBbQrPfoTBCfu5d&
zJo;2p+ns^R+mP3?qLpm!DZ%ycO(xJy;qTquJW*OE^mBmC{8-08c=xFyVdS{`Fv2-y
z+71wBI28{<xr(5uR#1#sH)^*GtdDTf&mYZZQ*i+82d`e0(|CTzM*jeWGUHX2@!NL1
z_In)gl3*OSUZbT|@ePKP7nyl!;wY9mFBHvdDCJqZqx2!YDjfB(&m43eM^CAc&Y@#b
zD{z2tY1`8&h6g=p)8e!~7V%a6-OHG5rHvK{h8jnF-~-zoO;e4nyqL<o{F9B~XCH+-
z9k8gR+U!pAH=OH%v>K2wJ8(y8tWf!b4V=9w<0A|{YAk4(E4$`p2&d&7k<yWv3ur!6
zJP>_q4ae;x1+lyied%3T+)Ogq;{?%QxgtnOVz9~v?rK0oF<qmT>rvagjYT7Cc}f)|
zl|p)bC}vQzVb=mfg1*!W<+$D^5JoKBU11^Fo9~~cJ#EC7v1OuATWb@+<lqtXs%Y|g
zi0ZNA58~<g)$41eeNt6u(Q#|IWBKNxrgPVB&c)*jTj*C1v)@V(xcS>8FQ@+iuCpY)
z)F<&quXY3s%YO?oWKhMTP^fW%k^uaAoYt#IO^o|Y1Q_s1=DBv<y2bEcx=wgBqK<4j
zz0Ij^BcD-cks*Pa>=!oBs>BEJ5g5P+>48yOUg|d2*K$Fq5KK&id`dwbj@HQctl-a=
zJRGJDKC}iWXe<EDQb%Hnv0yP^PSgz2?qWN!?@_UhiOthw5(<-0yDEkG-1X^I*|}eo
z{pxBaiIY2g;}Y?j(6PUk+Sge{Ny^P_wbTKI2dE_WHIyD7vBC^f?&l{wW}_@jpL-lr
zaR!u?hDh_9*%$=?%y6sF3Q1cL$Ov5GtqBAdR<cDT4t#=0b;#skf(>Sg3AvQAt_-HB
zA>3F<0f=%5Jm#Gve)N9$9H(k&QM_$n0X01K@C_!$Sm&31;<Cg>O5lCqeF>@)m4+c9
z235H|F;Z=ISqGHeYCAY@CYI<V6OfUyW(r6ctpti+IPWYMY0D3%r3N)BrRryhHqNfn
z90uT1WN3}Gz!o6C+DQ&c`?%?f(P*V;<Wd-(#1V{EY^f?<vJh|&I26SiibN#218T85
zIxk<snuUvwTk)iDR^g84`~Lthxcn+f<hKx5>`SnI!~4zn``+H4jZvpDFetMjA$UCG
z)%9gIvn+`rLk2>YAZM`zdR9DZA-1<~CGqCtrfW@vgHA)fEzLhT><9SLXy>atGB)`y
zqD`tWGDtnD>~exf&yYqkr<%`{FflgfKQ1#)hB;W?NS<NxVp$s);W7q)Guo;pDP0<v
z#hkgFPGmghm&sPMmzhT8UEm%Y9Wp!Px1}*zTHP1{g4q>r+-6i#c`d*-(G+7hVYaA%
zpbDg{q^|59ayuR?M{^j%eWp#vQAJ_21vx!<0;7%;Gf9&f0(Apv<Tt%qja6lgH=4*?
zXV6zvAaT^FJVg`gHj#qZHw;N*$IJAnzR{&OiS=7}?d}oMNkJ^QM=RGK=Zd#(6YWmy
z0yJtGB0)RJ``@Q}rz8@skB680R%eReTe!H1HjT>i9(OlZ0Cdf2<78pYavO}6afiSe
zQfh%C$v-H_$oy*j$Nd$u(toV(IjSWT!p-I!amFhdnnjrRF$cMWCAcRG+dc7DV%r_O
zzvvcEy59gc?60`N1M|%!ibTV&K9tbM1B3T#7L7=o1~HiV-P^S@7!q)LRL37b1GPkd
z<)_l2jSU#t)u|40zcK69ozBn>DY%o&0~`^>Lm4N{j!5fE&JO~H53xQ|_o)VU9-V78
z0`us8?H$kZr*VZFmzrD*{xvO%;JDgySFJ81`$TLq2q20>jkFByUOUt>TDfN|W(2-T
zIXOJk%eQ9(wO3Ko=kHU1ayjo%!(u>i-3}^Yw4_{js6ZL~YRWInzLgA?%W*FQ<O80<
zy5A33yxu9%QEl_O^$TQlT=IVk=IxM~q8{Icdl$p|7J2V3$T;8SMgsK%sr>k^TGG(U
ztodSlK9rj+EWkhl+kgksx&>p;%~WjTL28G~Z@XFnMmfhy;YjjjE3wMw2a(p7Ew~ch
zs8t?=r8^7nOc2s?2h4g>uijo-kdK(~I#Q@Rhs-|kprl+-20oQA=)X#;t&a6FxY{}G
zKoewS@U-y2ZTXMhs@u67j8b#$){|u<TvqGPdYm^Od3uV@1+n+L)aZU*t=5q2Xe$7J
zhpkE_UF*w!6+ub)feqHA0OV!6QE;)OBpE!dJAVV_9eY-8@0*qtDlz%6M^55_q+eFf
zIXx;+IvwM!Q%2{i^r^uakLK@4s}_MA@+l56&fb+6BfqU7BiFxrO^pv2=dW4`<n^fc
z4mwh2ErCe1Oc-s!QA)pifl&H$-<ne2CIKA<A(I}zd{avS{B;KA#~G!-+CFZ6l&lvY
zyOufcM;Se7gBZshY5lv?uyY7o`O)(k7acQB3U{tl^{0gSf!uo2u?|Br+>CLGemESH
z^r<$EITY}z#RBFbAnh2)!1bisayai+Hu89Hy-SbtiU)EvQ^(3W)VTIqTyxa@-t-Qq
z=}zMm07$_dY1kXO&<7-Z)b2Ca^`hW3^NeS$E(fIt9;2loCnJW%A=ofWbo}XreEs-p
zmp+7k6oia*GyvaEoARlL`n2g$WigKV=9f7BBifk9=N&WG)_{2#J-unU>%r?l+s0{J
zRuq-oesR*7#^aGrBO$&@kDQ*A?jge;`1MFT{Jp9$I`VqcvT`}&Z80=T2*Bgtnm~Ve
zc;ht|P8){lN*HbXr|V2CPsblJ_Mr4N2p}H+0D7bhIQf?p2u4wa&S<9+IOI`CcRcDT
zSLFm8?5oJ<3&{NIpNaVU{{X{R<9=iLo9^>dW2WZ7VUk8VQ-iP|jQ!f8k_;cc(xq1C
zJBX>UT)d|^=eJ6n6T7WYRwrp5wQe)O=B1*OEv|4rW7el%yUjwF`FRJLwgB2WUX=`_
z#t_@Op0thkM>Sw$Z%)+Bq{*H!wx;HaL?CcEG`xJ>YF)VLo|Ov*$p8<%NYdk1@3$3g
z1|!d?rX*k?Bo37@1cVqk+$qG)Y?cwr9lyoWub>zlcdF<yvw>Dq>MLYm$FUgc+N%{M
z$;rh}*F5&5=V=%nX^5&p2R-SXSo8SRh8fQytF~2$0CVapg>ozdDCBWcD9pSs@b#ky
z%VV^4s|Wyxukg?`#$aQ;CJs9HsYWyRd(?`&u`AEL7c7JUgY>73p-xm|H1fQYgGg5)
zatBV8B@w<dHn70!Rh#d1In7(Z`H3f~#}yj^hC4=a%_5U3^M>P`&_T#J9co~su18*J
z4ma=yDURbt>~-%=KYV>D=Q#U|O)7Dmo|K3qE;gU7H1pE{`_Z)SJQ{dYmE(+48CAo3
z)mKtaQ=HbD08<-<R&-n(Fyv8Tre+W~9FB&W(>$+AxXGN1j<pGmfFHXZDOlH-u1oGY
zFV=wB@7|@6epKPVDynyHIO)w65hg}YT0{3w&G=P)-#ZL7C@r{i+LeiDl()ZXZt;*d
zk9<=ONE|QSs7^uZd*+phv121V7R4^%&po@<P2?BL_NIA+D}2MZ6)h8D@P55IRD>Zy
zL*V*WS&(^)^!1=k^BgyRDA-Ocw!q}_Y6l=L40#lJ`CJk+iizX_a&SgDs!W>{ZU`KL
zG1nD?cPPZ2e(9~7pbT@eKg+c7T!rMg5)7WEw6LsFxR*0I$QWN*#hrnUPjYG3G6K)f
zdd_)HPI1uHM0Pm;01!c&c73A&9&z5h{lf_e#~V$0<?5qpS1Ll4XwL_l^6RBlySiK)
z$8uG;{6%(AeGdFI?u=O#mDrqMlgX@kmorQAA8OjTV%HYnO?S0pIYz-5J;i0*h4Z)v
z8*8pIvDlr=X@T4UKsn7)a5?8EHK{V?LCNV<SO6Ft{#CM(MF#tlf)}CbP;70F^W){?
zHDQ&$ZX56QsHDy?Ks?o4S1V-alb$Kc@cC>obDose;g2V+OeB%*t<|k8%Ez6o7Y;|J
zdy29f8dLoW;e?R|TXVdU2YRb8BkaI5xH1q(86Nd_exR0a$Sz`zNnHb>!6$-7del=r
z&-Oc+HQQFq$ULwBKVCm0LT=_xPX0w=22R)cK;X9-t9o_C&Ay>5(40siW!>!D5mlBu
zchhEbs+DDLmOOR*X|OA@Oc7+j8=Qb}qtyFV38dDiQEjc>ETwKPrc`M$AVaxb4+RKr
z#Bgz1zGuV0p&#L_DwEr^o^(=3rWQRKFr)y!-=%Pc6vX4^IBwM>mpAXH+o9Aa3mjVz
z0fHA8$I`QOyJ&D#!n>zVT)oXCo)N8hlghhyf$j`xBd5#|a2WcZUX@vm!^NiW)s{%&
zk;G~SHiB|Twof%$Cq%XiVHn&qQbs{}`hZ^`Rq~#cG)m>zUL&Z&4WkqdjjDgGTezPR
zIE&>{gdBCO)CwJdk#f?4e+soCBE^zq`@^89Xwc}bA5M?qUG=Ow-QzsoEK9qAG>Rik
zAyo^Wa(_zYuBU0_F$<|4HJB6E86COm1yqzHNj^&T98jPHU85gLYC7GVaKS<~J*QJf
z(X9rtpha`5%$B25^XF7tf)Hc^JClrlG^-udmY26}WgIXzq}v7v02bj_rvPzO0*#53
zY?kgTMji8M?-c$lTX-$>+2)NHWIK+E21h27M`~7gCRq`9GA?#gJj5+0%-9Q5)JWP~
zlk`w_ox`c@0q;!(ys|Ky;+2h5%L>cqebazxj`DrJG9~$ZycMa{hxR1Jgkx-gays)=
z-<f0}9iX0riV(TW(M>wZl$&d9U|4qtx6+*u{o{PVWx3;u&WW4N;$io@nw_1)x$~Ii
z`Na(m<=dkQ>CuShpMUWUync02T0w3;QMr_Yd*jlWSnx!rIUQ<3z`sCnw5&-iQ!+vo
zAe^y&Lw(waG|j1;+2M<T7u24V-Q13V=Am|Dd66N=1CV*5#H5j7#EUH4I*}m+9>jG9
zp)T9GIrjpGX9zMu+)1cGIbJ(cNV}6WxQhp#Y9PtxN0M+`6yQK<erV2psenRm95ulh
zVgVIa0@_;LG=3?PF#|<w<&wmon|EQyQQosulXVF4*^4j$4tcBF?;y}G(k)ux!8WC_
zfjpg~rBi{ty-Q7)@BP*CxZCQdB7`K~qa@t3O05*=%O=-HLKq)#MMN{^5JQgRaO+wZ
zw{l7G3&a<ZB<^Ls60h19kk}k!JpmkhRFbrJnvH|pOK)m^Q1X&?^z`gAKzmDWjJ@9>
z<E1yulWTtQ{{YqCjML|gN2p(->Nb+1&H~99%CI02imXq~_j-!7t~=b(x0suKGBwmL
zVn)?7Fh(PGIRKH{I5?!5;`jST>}8M7+xgaVk`;j+{b@_gT?v!;arLKT4`P&@yP7au
zFt~&@$p?4d&qGT0Hs5QTGnV;=Yb2=JNq^#|9tx0$8KTH;2-%flHZzkH!GX$S)Bgak
z_*Oyl82#4iirMoc`!1O6ZrEtR>+QyBoJpJehTNe^$P^?(scV*Pk;asvr<a*?v>u|Z
z?uAtT-~r`e<kAg-DF~B=wmBH8O>(kC$}E&~fO{G_ZeXuBau<18;mAn}Z^uf|w0$7M
ztTn~Xq!{Tl2!s*kjG%mjB!Cxp-pD+38LFd%LAYY2+Mj1Zv!gNm>u5yMPfHeT+ZGTj
zWIrH*(0XFE;|c>X1TvmDJl1WvQw-a;1G6~*cIL0EIgkR!g*<`Qw~Dcp<#OWf-D$UQ
zCPm)FWc&XB^{VRzFy&g^7jVjFf$TF`=rGQF#^q|%V=?8jRJl-8@(wGiClvQCq2Fr?
zvw^l%EAsU9=iZwt0ku?0%*+Cf+;VzUaj))2@7Vm<A1R_%4Ct&A<%2o(=C$Z$eM)nA
zjU4LM?Z52`0b_sw<DYK%s#1wp&r(-%+-*BfLC0`=gI8yBh!jSkZ9O@xw=4<+yaN0y
z3~^kO(B2Zc6K*7N`P6+#`Fqr?K{0_MWP*P#w9k}7Au74w&V4HuXc86j&<kc<AO}6q
ztydp^JBLwHoEfau?{*_fGVRSe<_O@ux=-ymWaSzsLBk;#=g^9V!<}B;O6R%Bp+U$$
zF~A)~AH&d7^5J^@MQ0{hXXNPJX+Zf01Eo9yQE-e&IK>0*F9Nb`1S30e2OhMX=kE8V
zAmnwXlKZ*}kPe`H*yg27ZX9&?sE1L&sT6Q9O(JecPB`bSOq}^+aWx3)wP8A^1aVNr
z**cHjFU)a{YUFE>I`s6a$_{?_QQov710a>a!0B1ZklCkg8weshFkgTx=?@6o2s|I*
z^cJk8Z3ad;$>i6HctXrw_~l*W9!wD_0QD{OucWlt)okJ+7dvrWHC@@~;;M8vW8yfv
z{lQiPboqxBRahK-YGoYstXepeECO@<KX#WVCnvoi=)YQ+50|&y=A^X70L4cKr8^i=
z>xz(c18q1c$9h&B$U*-AdZZl(9qHS7`=g~l1G()*i{=0_KZ>8mdNm;HpK6c-Na;m^
zF`yid7p+c!XOcS8c7Qtbp7h~?x8<c`u2>&;JHI*!`FaXs=V9l)DBI3)Kp{BK@l=bQ
zhn2>CYP-LoUbNlBo~DZyi{X$J{pdf9N+cOvWAUuzExVTO-lt!^oEiZd3d~h=o}DU1
z&fZvcs%rlLFsZ{0zkKwmD&+iR^G(S0?@{j<I0B<AGNT5NT%5Pw>DGaR>C&Od+TSqg
zM)b$}#p_PO<}7C!;C14i^KQvC0AfhsV{J&M*EFmg#eh0xX~Xz<6&~-DeAI5|gV0m3
zu2~r3oHLV90!oeu=e0-);CW}Q0b)`2o9^|c$jIiS=YIm7$v?%@t|<*7LU>#r^z|7X
z`cz{Z&lM_@ynM}y2Vr*dxgDt5IXUm%o=+l^E4Xkv&@?A=O+4p@rysn$clD$>%JD%+
zXFPIxQ%-Ve<EY?L;c$L#)D%WDv9J$XQ=E6}PXnH`z4{K62#f={xF33-jyiVjOVb}H
z>qdTh07cFSCYK!bJ!x_<K2g?}1D>1;08xRAjPXr9dUmG_am552AD)3UHy<eGjy5mL
z%`Z3uXr>+8hbEoGDaO;!Y7Q~ewKL}VxbICQ)41#*C+7K$ASZWI*VdSNo_o@O0|UJ0
z-k9u68S~I}G*l$8Uu@AqHawCk2vhSg?ZK<j%kwT}Zd7-yIN$E_de!Kgk@HpZmZWdS
z<K-L8TSo<yRwQzBjMc<^75Rlji0*5tJPeF(tC6=Wh82{qHm6LQy9xP}ZXIhTicHyv
z@SQW7wx@yhs!@H_0GhP9%Jcj+lS5J`@6)|5eW?NY2hG}=NWj6UHB50l8bnf9axf}9
zoc-#wm=T{`P>SZTe*yVNrCEhOURI-xa`?x3yr2bNrEM6QN@8Gc98<D5z#V8K<~=b<
z{6miQOc3Fn$LULu6Yln)ZRe#i&Q#&LP=v%{0-m`dpl!JW-jtt|XF00pag-eKx~Ntq
z1E0KcQs?9x8h~eKL(-;C;N*1aKq2XqgU8;f$4|U^QvmCVlLHCTrIdpsYK}8aIOBnu
zT&N5N37~DmZXcB*(Hm{a0CUGR6C7^m_-aN2%YT&h<C=wl+6P)_X^`$A56US47>wZZ
zXkh!Xv9VE{hCp{<nk-o{?Tx)@q@17YO*zAm-RU<S<aFYli5DlFkxkw{Zj{D9H(F^U
z2Z7Ry2pN|o;-O|kyMQTNjydmDSbW?!dSxU$k(0pbnr2CJ^A5BC*avVtQ%-sLO(BvT
zVX_qQ-l@o`hvbi+r)qn@%1<?1xF@4^^`V7^G-RM4jtxXX1pK6PQ|E#6R8Ct1_k)U7
z9mtCiypvHD89mK8$idHCcB*c1pP7d=SXLFA=Wmo?H8qdQxb&!wGD$t^Heu*-iYyit
z*zGwctFs;F4&6Ib*yRozHC2fYIQ8pN&=Pr#{q`Kx(abPG-P570=Wb6Ur9#fZbC$=o
zB!tnUK0eJeB!K+9t#SH>#uA(m+j$1I8g~kRdFxoW#y3JkkoZ0LHCG`ckhpdaE<=6d
zD>bAbKhM<ub*FMvv#DR=BQ=dWI4^=o*;_zzLta8rfjJe&YY-@%qzZ7$g1~<|=vmGW
z%)^S!y8-OxLKK3BIj)F>Ir2*93nBp19mnq0T)RnsrET1)S+3VT39N}$F=ksgJH)6L
z7~7BH&*_Tki#=Gh^)jUk^W|~HP>?B${abadIhQTFBkt8H7w_`ldbUivm6lgs8(N3S
zgo(sKiw;0X4l($SeXBNAIZhAaD*J}s#|ze=bZxmLiqSF(n-h4-H(GAro=hBIaf4PE
zH<EsS+~%0c@}HdYoMNuzkcE)I=gVdyTmVm6X2|^L{M{yHjo6RFz7MFY2(pMt5+DbI
zx}lI3*cyAEmB|A<W}0SF)T3~=iL2iWcbvog8`~!p*l8M0n{n`_>Pw65Iw>Xb6D(3i
zlQM-*m^OIZy99lCu1qLh*^Kj^eX7(qnv5C^{1M38UhNnY{3LLHF;y$uLmIJ@icw@+
zWQSV5ji!jSR~QVuhWDX<X`2W#(w;F)RdXq4nc1DPOH}DJ5y(M~GmL}kM@}i4uQDPB
zog(cA4N8i4OTovjG&;2NFh&5*ag$dfjg5u;hVxEX(5PVUcM^I4qm%rp+_b{pEZoPI
z=zCVHExNt2k*)-0;X@Vb7d)I+WvhRrxKd9&{VMg#FW3e`=QyZlhIQxIhNpUM<GB%i
zsEGW)Hx(VuJ!%jD$0Mam5E$iRMgnxI#gCS8jFCbv<c#NN9XkqX!B7|yH*=bZmh%wc
zU>ZhtJQN)}Q?OjWb#U`XV3FJGwYPy00UVacB>Lu~3~?SCos~&TZ7aNi=I8RM@&-vf
z`CtrEu$F^&%Gc$06S?t^dfA43IW+4Sn%dwN-R6><XFa`Z2r*mBcM7=@=BF%%G0ExE
z6gZPDOVZmFvXXe@CNp-!1oAV|p~%?04AU*H8aY{HMQDni8@JMgTbG9ZNbGM+ae!Td
z94IFPC!nQZjGEk?N6RlxRAQJoXZe>Ud(<l<@^E-P%^@;vcJkjIa9n}h(PHjTmh!<K
zl?z~QA-Tmfa`V(=b)<3fWFB!vg5s|7vk=4OT=H>J7X8xw+|(-2h+I9axg#Kk#ti~M
zP~}q@7&Hwr*$N!>$m>jOd9!YG$b=kv=9=WRL?W>vc;>hM$7u$EqPd#Z;pT}RR%o!P
zkWRtRBzK{^5jv_izf+%YGwk-H%P*E>EEk>|r%uM6T0bs4JcsvZIrXWfjF-47k*aMt
z1Epq{%8!@$s*<@%cP8EkL(gBOPO``LTZNJraMAKu@C8vA^Kx^_)tF^S?-zBV$eVs-
zJq-;7$mWQyo21IOwkA26O{%hG*J;7rJ9{4WSZ*cou5eCpD#h%pHl(b&ZLA>1fn!W<
z0=k5@vQGiq#`8pEHs^aLI+`zHCs{(*>T+29(w)?ux{fM0EVow(E>YDk-9s-!gVa-w
z?<gK|pGvfiIj$MWZgIzY0XPGKF+!BVBo363q_SVIj@Iph!dd*ZEwx8danO67DU&H!
zf1P*s6^rdH<%^x+Na%5l)UY!P@JYxkoMx8lDAlaYQ(UsOy5z9O&5V#ezO@W&L%VHr
z`?G;UMsCd=Ar`Xe7l^v8oF$MCm>l%a9lfgyFO*idKtLT0KxUZvMBF&UgB<Zz9Jy;&
z`36_>tBSFVA;?Y{Frdasz|C1fna^>wRUDn<;MDOm`R;cQyILW(XbkL>0zuo(eJa=>
z%LmWFBb?PWENxWm9H7bW52ag3Zw8I0TotepNqZt7G7aRf-aC4M?s}TmCJmQ?B4+|m
zl#zmcDem(Kpu~@ZI6XS&jQ*8WHez9g>A}rPti~V=Yr<l>5ziw|IUGY6%%uS&jocqz
zDU9StX5cEYxdZ|~F11b<VGY;sVF&v_fS{1vfOGWCIfEU{(v0r)tuA2oB9COgFw?B}
zSs5-S3mB4d5Dv!!=3)RJQ&pPUKeTEw%<UZU-m<roCRYR8_2Q~sM=9|(nK}devl+-4
z8B>r*`qhvh%+%j=7LwuQatEp8{W5EYrQ12$s_LsdM5H{>_R4NI1h{Rd*wf|4)6Y{<
zpD$v4&_bGH?J=p!<O-I0XkiL%afj*C{3<uvN&y3mMh7li`PAsHZSKg_bhIlFJ7r=S
zzun-DJLHOs(+UA2n$5AIG1LHiREh@Cf_OaUlW)#B?@s^)J$W3~Qe_S$wvU)_DW|7V
z){`f5bm(d7B_3HZE;r<6vkQ$Uh53(KPfls<#I%IBCG*mgjy_)0gdqFN*R4u1&N@;6
z1~N}h^zJsVE7p@@5COaI3bvoag*_?-T(XR)<EiOa6K|53T8R-RSd4IknzX)SNQkOQ
z+t^i6yD9<i>0NGtV$Z8-uInDvlXGqyliU1j8M`AYld?TK!8&=i(f2WPB(LT<BiEoF
zz<*lx%Vz@KF~IpnaJpVrD6r!JMRgFl%8Z_s$n`vWl5%H4uhR$6Rk+-f--^kJzGTY(
z00muEIb3HI43ugq;dmULD#$zzYc&|-@2>`}qkO|IxTt8N(E9eNM?urCHCuY%eCtx9
z3=^7=CGXU9qzm(PG{D(>?IVhRIRFmS6p5E^RA!|fn^vlhgq9TW-~-h0K}nVlG1PRX
z62B-J=}?w9I32sxMUMWY{L~bgYjX!9dF0X(+~vDedFXr7hp7kd(P5@E<g)(&yH8Pr
z)b#I3^6nivP)Hr}XdTH0F`dUbsY86Z=cQ6F^BzA6Ycmx;GY%;<JDLJO58fY2kV&4b
zde%~~9B$7Y=|qpcu=vGD?rQHFe)*=BU{4~bt9-dEGrFY?F~b6A*jkpu5{Cp*t^o&%
zfd@~R_2#D-$mC#BNMy*($)|#Mx7MQo?cq&KpzR$qT3D+SE_Q>vik3WYY~vW>pk2U@
z4_cUKY2Z|j#j&&w2t4(mu_eAi)3sMp`%muw0E(wv^UW&`!<TUY<kX{)_lHVF18y=p
z^G*RlKD4Ymi-Gd+DpkhLr>#Sif!3T3KZ=maeqKP%b4TzGyV9BppW(+H>3ejb2ITG^
zPfC79(VTKApn<xRE9yE>G&qlHF@n7R01Y=IXH!P*+j~$nJY#YDz33!l@lg}O=}axc
zjm_4O>`9)zdi10R<~$y>0gyWV+IB}g3Sc`8xjFArVBquKqX*<X9+dEYQS*AxAqYLQ
z_qz&S<YT|B8@OIiT95#8b3m>%54+2AOSk4Z9Cpn~jt5S(;z5l@IiQ=Bh&X-)S9NT4
z?^ej*^{Bx4j{~oI3QVbt4pq9-!u+FwQ;<Gykaec*KQ=ScnqzE-oG{pa^%W)#{2y8=
z+%A0o035$_kyqoB=3lLIkx0KU%z3Q{q+mxaU5+O@k<v!rxKojx*sGDhsTF}7pCWUQ
zn~*C)IS)c{+pT3JX&D=kzF(f1t!N*S)2FR-aY&%Vdsf6U4Xcf(@vLPNOPvHxeojYP
zzK#n0>cfftQHQH*CO_q;VOU8Nja}mhlT0nx5mdyPQ}YUXo_eoJ$)i}7(*{M)tyxlh
z*v326Bw#W4@mDSWYqj}!tAuV6W~3^?3t&`){Nt`ONytDr=|RTTt?guDwH>%%e4>*p
zxsN?5rx+aerw*M5T83(ay7D>eNca()XCzab_;5RRs9f+4JJ19SP7hq>qh?*mxfva3
zbNj~m$4=D}jLc5qz@~t-y$9B$TyMrlN`N1fpL%*84o`ZZMa<xg<EIpxn1hA`j%u-d
zw=8jvDd6#p=Zcn#S`vTDMgyig)ABr{$7+ut#D0|v7Q+1B#p_VYT9f1zA28`m!Q6R2
zg+w>*7$dDrr0?!NwMb7vj;(>y)~m2PMpWc<tIkOv1Y7~usz_UNjyS3kky|Vnbm`K9
zGtTbZVuO>=ihAc^1W;AR0rJVo`?Q$k@+xqxlk%RF&5h4oW`SI)zyjPFiM+gh-fGjS
z*w`cSs6ql8=N)LVNs)lNdQ=kRNyDC?Rj`Z!J3ET6C_g{QbB^@d8f7U63HO1|TC4yp
z*q4mdt`1u({8bW<-i&ktq|kTGkT#B;sy6_K<YyITA)C3mKaDn2P#@;+OosI{m@tut
z`!!jE8OH~&YP`yKck9L}3~sj49DXzo=6r*L^6{Fg-TswoP5EQDKT4$`9Q>y{sA3}|
z@y~jV&mD~;F*~{d2j@_;9lZrbfMX2p8Shn`;oKbHnw+2WnvM3AJAnJWX{091xycdB
zf-zV(QW2g{Q(MxhB2IYEt#jAlY$F)woYSz8gFKmTLT=CLR9XK3d(P516tnIZGG&ii
zp(CB=Aw~^r6cQVDtClEN8OZ~!WJ`i186)Mb2XTh$)4fxbLntAm2hz5Qi)S&ZMgVtG
z*#H7D*17pGRQ$YcuEOXIvgR|&;PG6I+B|pX<vSQ<PxP(ecHygE-DXSUe4HM=4Ofu=
z0HdmehwtYgb5`X8&HKQNbrnWU!I*A5j<vcwimnF7{{VZnM8!f8v^O1UetGA;Lj6w|
z;<QXn70RIx@|<G^p<#sp0zmF+ax=dkl@op8!Q@q3mPDub*w_y}5Av$)aU+8hf@JAd
za6!%wPJq;N0^~LyH~{C`n%vEiTp1*pWNBe6QAQO27y}&!2iAgD?6L#tOa}x8Q}=~T
z-bsN-Z^Eoaaz~L57&Rg;oElc1E6EFKa(QV10IUB131Y(pdV$-xsK{;Op7iVztBhm{
zVk1Ew!df{xZ~&o{e(Z^uWR4GNkbkRTfDZ3UWTkNsEIQG0lP85(T&~<6f~?-OLjBPu
zE&{Gtj;9>)^{kfrTErMfakI=^zSFdN4D|dnPu%SLjH^Y8Qq*~pJ(Fd-delpjjfHNs
zr)Qp-g!ShYF$3)Hh2w8(qOL#*Q=cdv4+Qa=jY#x4-S|?U^@+=L=9A?zpPRR80Dcz^
zcOSV-1Qc>*Pyy;_BxK|dyVk7OC9#s>-YDD&3V_`PXnGSl@~g6$Dr8Z(ecrWWfgEgG
z_$yBREg{mO^7QR6v583~LFd-8w-#k$Njq`Cz@a;lPO7M`kQOBe?)%l4rPP;7)UDH8
z)T6h!k~1_&aI$SV8TG|eW*J_7n5TyQ+5O|wv7@sd9zQbWaQ^@)<2~u^CF8*aX7GsP
zl(M3z11Ew`I-jjn+xy~k-!#^f_ow%*_j?*SN-eewV<d2T(vSw2=OmLQRo=c?7=Bij
z9F6%S8)<TbVD1c7;PoB-snW+f*{d`x7ib`!^;quAoa3!s49%mYY|;_50h62nX$j86
z5X=SKIDq5~{cBQLu1=S1rdJ5Ni1s96ph)dfDcx;O;<)+xas53iC%TjDlg0LUNM^?a
zr7Iap^Rz~iOg4c&?mLRCiE!698G>8|B;a%uyn;S#{VBd=yBjwW<9AH;t4P$7052?h
zcBq}cT=_@X)rsJ{k3-O|WHzEZlKxun8^~VeeJY7PM*Q<l4Kc?jA2A$N`6Rd=7qj`?
z2674A$*l2`jmuEQ{FGBG;2s8Ou%wf->?j#AfT!@M=0OyL3*R}Y)R0CEKP0nqwMeUu
zFkXLTB<D`M5S!x=mv72k43*EW4r*H)tw!2yQ|$M<4EkF`CI{X_$sYdz%AnmRkgN8I
zN`sxdjz2F`PJ<tAA2?jD0d9hZM3#fhb0(V*bsz_3Cq2zVHw6qck20s9%p?PLtTzrv
zdSZ)V6rj&8On)c?q4lPSi?Sq^aQ3l8w%cM!nSdZ<u^f|+rxj}5W0J~MXF$j@q@F&e
zvdG}nu^ARlkAiusK-Pt&+)=*n1cYXstOSanHVcFJ(#Em0Zl+aUNeo*9j=WR+xWkke
zF}KP0hJQMwX4!T#{*3vZdUPkPNUnUA0CS!XYN#F%w(1zR)ceGDH9TbOiz~r6tzyh%
zi^}6_;BnY@sh~NLj`NVC^QzI345w<~uX>qC0Z0dqc&(z$q>F?P-EzM&W}M6x)yw_g
zF+nZRWc8{nSkDpIf7dS{@&;<;rF^vDws`B>wC1`paUv3NegT9ql&RQqqz;50;M7Es
z9JrILcr>MfTnNCZxZK}4_pBu%;}R}F>Uz^Kz~=zdiT&pUbu_|Te`@BGjZzV_yyQ1p
z2UGIWjFucyVY0)D$+Cr9Z%mw1n`kGT@kzQbvrG-5hupYePe3^zk6K{K2ZpTJn;tgf
zH0-tx2OmmABtJpWj+|1r47}7a3UTuMzr#QTu=#s-q!`KIQ<Q+m<x}!w=|~tHe7y1o
zDagOPVS(#Nr0+d`_G)OuVb0#XQfx!`+l&EIqPEg^U=Fm3xso%3n$)+4GRKuUVb49Q
zHzPSa4zY`QiP;LLmB1sD>0W`Nt0LRyInGa|bMQu@NPvlWj2z>su8z@)h`n*w6@=Z-
zI=x<pqiL=RCLHHH{VS}u1ISagdRL$6van(F72H}#4Xj`_U~x8V#!s2|k4mzv{Bl15
zRb$<O!5=MIQG^)u??XWnaP6PGdewz<j;v~+R?lPfs|utk`A1rYjT0`R8;8yOHF7px
ztMaE)$*ja2j!#Ox8391YZgWv!W!2_Rz3M{WDETU`@EJg0YE9WIjP#{oxhU#QGmY5K
z@lnp+TndbG=aY&O9mz=;0D4k@2Hq)y85k^c>MB8xE~>*!cpobgN3f$HDd)XMlarI%
zwKq6p@`_CraplI*#ws%T9Bv<4Z#&5}-KRYdT9U3PBXeLHLR&w1x>J;V=b)#MFu&H7
zg5*Ga-+1Pv3)7#@gZ}MEp@`&xMTRGH^7f@0vz@)^_~me?-lht>M*}oiq`?WmC5Yrz
z#KzO}5KTm?Hzs{M)wJ8V{^bwU(Xh!PRwzF2UiE2E@$#O6nt<+HW3OtmyF%czcf~7|
zGh*}93VsIM00$J|(YWnS8$Nu2oc5q-MNzc%r;KsOdPOUqM|zNL+PJ~U>p;Xp;K`DI
z3YROi=M>D1r>9CW!9O=jKr0o`RqIX9UJWQ8F!@bCj1C7%Llr}Q?40mwL5%nODWh>x
zGeOU%dT9#dj@~$?kU8Xi>OxOI1xCc>zGL~&FfD>P=qbCi+w!Q(6Wj5o?riWDlSQIa
z?%3m{JQdnLM&_$;IRpK^wKC&!{KAmgFg%}^BOR(vFb+pfl@DgaccnSV<o()qBzZUo
zj`W+k98@iwb$*_-(Ve|}(9p|^*Y7P(qk+?{Pz*Wwg-)(^ugr0pL`bwx9lHKB!g}*a
z3hnFpRA(E3+<H(Xhi>`*019a*o@qGG{{UK$^cVtxfIOU$)4c%v{b@1s<c@PrBw+G7
zQD795B=g#eXLIvWKp!keAPS#4@+$mOe4rB_D_q2Ku#~GI1V4Jbl8lZrGAq}VPd+m`
zh@}4jRr}s|R;+RYKKRb%#d0xBJlMW*j>kOKtWurnnMvo?u#`=dj+!TJqn`Dv447zs
zWBJ!N45Kmp!#U|%vA-+xpIX9EHBvfQBt1C6HFwM&V96hHup*QFUOh!$5`4pv_iG8n
z+A=j&#!t+8RfKPp4u0>gWg`rZe~Z$tM&EeuC!Q+@6Lif)VoD60=hnAuka=W~J*%96
zlQdj)VO?dg+hrdet7=ft%B;E)G5zTsX*=~DXgJ>8deeW1eQC^40)Ao0>rw;LuTE++
z*Qol^srgR>n#|RXasW6zxu_0yF~R(4=bhY+z3MkOUaO3Dq$JA3e)WbAwIYHKIG~@D
zlgBj^GXcwVsznnV=kAPW)|tHJ`CjyZ=0Ch@E<>KU-QKiFXtbw+*RCqk;{%bMwNgG^
zM;&VT3+0TbVN$`!L-z^VYBC1=<GHEW0|*%UR6qdjk}4V+kmUev$UM@VXSFcDQN=*d
z@_q4~(1m8p1&AZ%7^s}7QbPCUq2A{MIO3NhXHnPItsw|ieq3j*OU4uTLYdA%;+H<-
zr4}mWg!CJS(xY;sGxKwbP0P3+dTSU;oSco+fg&7_FC?hXK~Roleh(F9Q)n&vzU{nv
z(jbduU}FV(=AFtQ#G8Qx;}ryj_P+rA1!=I0Yhmh*!H6_?a7bJ?y$ys}n&0Z>;AaM*
zP@xIHt6#fm<m-V^I8%8Nh8XT^JDS`hC={OisyVii7S?iib4fc!3I${Lh@{M7-464f
zaw?M*gjG<gOL7HQoS!WI^|>cCF(k*+y;PVtlye~a{i)oOI#y-J%n$Xf=~x}u1RU0k
zfR{hJI1AdMXn{kR0LZ0sxs0YHASV?T;kfcURP$Thvm9>5dv~hF3&0o{PCaQRE1)}e
z{qfSEk-A{<ijbtCMst7%N>dTodi1AqTSW)P&%8R;9rCZ0A=<r2u8E@KsrptW^f`)r
zI}hGfA}(<En?$e9J@Z)7I)3nP2b$Wyjl_g*2cGrL&W*Y8yYE)98)Oo<Pu>iBRW_II
zjpn3~9ga61wL(C^6NA@^+9oZJl0<l=UP0P$YYy@idubH21G^yA<|m#<6$`devZV7`
z#aNX$7j$v1NS<_H!Iit!8CYce!0}xkqYn7lmL&5QKBta74RVgnx?o4l9E0s!$5Ys&
zT}^q2TP%6U(xYN90afWtX2U4J<E<v;{`fpri5px)p2yd%NBkg_Cz@TupOo`X`My!L
zae+)j1~$pS`?S!?757IGIO8W3KOfy4O;?di1|d3krbLSJfMN#&p4A$tF{mhd)s$SM
zfd2q@iiv}QryOFfG6>sp<15B`(^q!c3a?7BxOrd@4>Y8JiH(Ei<O*WBSYvQvr#pMp
za;mf^g~@&Z?N*pB#m3%!x>SKJPM13vh+!rH1krKxSczKpO(RaWhf%SQ%hkiW%tpst
zVC0@FG$fgBgAQufmV-D4gPv$aJD8EjZfPcE3Q99_PjQMqL?w?Wy-J`nl?=Grdemi?
z&5d_pZXo8RU7^X^zjmnT<_Qutw*jVue(n`H82XMXqirz`6FK7*cXAk5G&s&V#Z_fb
zFp!6X-kKU?9dm0J$<InyoujsyRuwsv9%)G*CRFk5P99&Bq$tkw)|i^Q)UPAWB+!;~
zfc*ta{{SpU4flHr4$`bJGnz6)U~L=<0V`}Ux9-R*9t4@_Gn{($sDW=S_JQ~6U*l!k
zzJoO+2!~O1k+Fs#k9uNqwx)lW;LfF6k<L2)zu{52KQHdv@fEoxrHFYS&z#|h$`1yk
zbXRx+TEY=qr+Qq*PY}8p(S~T75-xW4p-J*&2dI83d1Hb#Bu6;Taf8KD2ZPV8R_2O#
zM99O<ZikwbpY*-UD|P4(6;GY*i4RJd2nI~Zgy3{Ov{)OtERsK(!Ap=>ANUt~j5BUi
zw=}!gBw+yBdsE|6nJ|cY_324yH0(yrkKpRG(0)hEXQeh(WxdAHjev|$8<*hbs^zI%
za~U2K4K&TM2tZHW9@TPbG#2odfU#)Tab8BjW^lx;qnxqNewYKLQv>BZii>M*Y!39S
zCOd$528R2?r%C`D`EK3mKJ=Ir#@K_09XizO_CK;+Z)@G=MA#D>ao;DdeJKn;X+~3d
zAN+)bVFzBBB-A`_>rD#d!BITBNh5a|>rG~2SZo;jQh+kwJtE^WeJP<fG-m_lBZ^<*
z2R-T8${%4#hWUO@)WxW|J6{>;Q^I6n3M_IKX~L)-Nj(KY^I@<%RI!p^z{Yc$1jm<<
z2-K@!6VOzM>@Fia0U&fe>NU>LH~#<+HDWc0ou+48LP>FqkHft*$a)Ul{*=rh3JLqY
zs&;2E3>OWaIPFx~z)`uF;Xnj+Ca**0r1uFegz-s^R#m|n6-q=h)E;TmiED_<2F3?^
znM{FH=lH6sXUro5txv!1aDMkSqM4T|WnY8x4kGJIyzQ4Ic@+u_$Uu@XaoqK$GXl%$
z%?_ZsNeg^~=B6=iy+>MOo`5mrQW6S8Gt;eODcq|LINCb?6r2}albnig@SaUQ3JX_0
zNi5TlS&v1>VfF7>HaDPgo*Nv~Sn>CdT6RVoC$%vB{s^eJhVoccfRC4hNC)o^BdE?P
z`1!|LKsXPW{HLur<6`hSQGv(ap|j<IxZoOr4EeVl4z%%(KX;4{XdMB`^rwK^M*@q9
zgkv&&-1Aq}K!}WilTk*vZ@RT-YM91AI3SA2vRf=diSl7`PpxXe00fpf#s{@$MnZ%*
zA9Pgk77^j3ke@TDH7Ykau@#gNy9>7E>G)Q>4nxPt9QUq%CL5EQ)`7TQy=r8SFPi6H
zVLOSFGI5@j-D&cYk$_t}hHK31+Y%|>e+uq&sXx?>t<$}8v^$;L1<6mG^sO`>D)F9u
zYa-PAv3$dUTd^)e;y36!QX`tf)E%a$0Pa!zs0zVHAH`Nwahy~!sS#ieojOyF?5{0S
zouWMObL&h!&p%2EOnQ(HIW(;x1BN-rN{bmJob;$%g>rJ-nhQms?X>03Pg;;jyH}A|
z?IU@;T;%kptI5CkzJ`kxV_-KUp4BGfpT284Hg7C)x$o^(6psG2Ed`5Ulb@LM^{0$r
z9Ez>Gl?0x(I+eoZhyswug~=R_l;f}h04L?|OfEL@{oXmK@(E&C^rc`8%6b#llP8ax
z(vXav1ppFzQn5*rulmu~rA>$1%7M)?J^;Yy6)z_lZuHVA5+>Xqz1F2rIQdEDqFe*~
zU3yi8#t+ZmwMj^DC*?TrinSQRoPqe%BcSWnrd)B7+!_i+m0}cClp~Y$s(Xi)KXeZ@
zDl=eXA4-yoIpw}n)}4Wj?(I!L3OCQ&r7u4(Gz||J!Rx}}oCn_I_4T9}0ebZ2r5M}y
zLFbW4A+dxUk%s&!!CPiJ3V1KQ{{VMJK|LvetBj1XA2mug?HEx|HgnNwp_{gIp45a{
z86@F*(j4NWR&9%(xu+6xO#xw~;lAf;jfl&9wB{s%fI3tpoHt&y#)gyfpWX4zKy%o&
zONJoxfu7Y9<SSw`jl9rmhKvH=y~(MQf;kw+dZm(FbKa~g5EmfzrDB<RdBz*?ryiXb
ztyEVzA21a!n7=Mq=Wl8(W=crO<F!Ul9Vw-<Pb*Fgn^P!B{U{a08Qi%e?|v07;f@OQ
zs2PUyfH*m%3~+b@28#;ipx-FqectpIY;`|+t8OHB#Ynlrj2z?AivcJnY02$I?gtdr
z1mmCLr|tOx<E0i8kk2!xC#^^bDb!RfKiC~<0qemWQ?RaB;|GyNSKrV9%@kNJe95U;
zg7UgVK?gr5u6uNeGpnHo9=OeVeZ&L_Pn5i=?Oe_MjBg1(Rt|ctd$Olv=IG+J)WV8S
zl{sA2q%!iEe)WSScQDMsk+$yRinSb^CLHFu=L6D(OPxehbKlsC+P9xEjJjtX>y3(2
zwm+Fq&FfmQOPm7Ou4zQ+jE>GJIZvE*>}yIk`H9G`R^CCrFPwJkTQN()8U7q~tYrge
z$lZyudXAN)2l}JUU_k!>>i%}*R>UpB4b9rI<TmFz8x;n4xbIys6rKAc)9?Sr=Q!k$
zQ%&YLVW`Y;bCwKqJ|8Qmh>)4HlCx;e=b0hrV-z7NggKK_a;{-HpLq*?zWe?G`*HW{
zzMs$QdOYB|eZ~v*uZ%lWZW{%2H#}Z$s86=n2DLrR$QU4ZNH;D7^LYw?6WlF#k390T
zYg<izeS>k7Rp;6WPj@<fNI5}>rmZsaYCdVPM)`&Tuf#MsDH9A^FA=+TmR}*)J!s4d
zFLRo80e^x2E^#?b2HIImC}Q?{rD@h0MP|}87UQYE-UT050nXWI${yq{!E3~+?qpa^
zC#;KNsn)=SpOh>+L*2O_T&Jpdu1rCRCB`w{d~+AjRecDC@op3+vyGT4DDpp(wTOec
z;4@4PgTS0-2vA>Wq96ADic6W9Hp1qnn%%*OG7rr=yPG8xvz0Q$V`HXva0O^)Pw@z`
z4QVM3B5(3k^5o&^?&#%kLDQ^X@vN6T>>Zd}=zvG0j$|9<0R_qoV%`LZ`52?}aolbx
zS7O-+QlwD|&Dv6j@}!^P$k0t?Ye?i$N#@QcM?T&NzX}L0Ke4wNFd(?l>AhupCU~cx
zH^t~`^E{ZYx$%hJNY+w><8$?crxsw?7%EQ}QfzC9<BSC`JxvM`Ea<uZQevGgr%4P{
zL90<h9_VFs0AoqOB{wHihRDSu{|!5%Xc`Xa2{&uECSrr|w(0@F&B`QNvWetwS0e#s
zmPUVSV)6|~8(eSKmC@y`PUjv@%7rr-t8QunY0#?AOga@?`eg~?Fuk<Hd#D$0{bUH@
zr(m7&pz6cEc3^+_j+dOl^?!fX-@*{cVfQ*^CbG(b&e(2sjUaOmGIZv$aYbN}zx+d~
zF&@vKrO;@fdnlY9ZZw^PVFDGd3i!`#M_+mLx(=n!F3gSzSBuR4YL;}gGtgcjC6aap
zeaGVXjOja&2f$1W$JrP+ak)G9`NGM19c=dZ?W7ig9H4x@48NLb7g_$hgAnWTJ^tx5
z1r_27Nwg*54(L!&jmTGB0;T)1E@^ns-eOmFk3*4U4`JlumlHN`x*E2=Q}uJLB3+(>
z>7=O(NDeoG%~Tn1oj`W~TD^wO_%DvZ#|9V9ws2U2@$llaXJ#KHC5JffGRONRFKgO7
zkai&dSM#);(5tlR`3KK^{yxlns(iF!4}Dx6;{7$OvI3HJDRNTXSOI(5un>LixQy0K
zL-t39wfRw$b+j>aM7<we^bJr(M9}MbJ^>o<(>Hj+l}{2jO-E3^3dIcPpH9ou?z~m4
zY3KJ$_B1IOjfVB<0N>H$zSvrU1NOAiZ!uGK?pWxaTG}Tt#NDRdry|Lv%ba_bg9d$Q
zBbQRM5dD1gEb<X^=K&i_sW`#3w-*mq=^lu<6prFn*!hQ2HS05H{|xQV^dUo5KV{hK
zF^Vw>Gihq>+5_dsj8Emm+!7$P3p-E9>W@6i(ck!ZEKWlgn$CjvIcGm6v4$^*=tb~G
zj)uSo1d>cNUKF9;EmpKFvEVPimWjCujfv(hayzxr9)pf6XZd!BJQbL$8M)n8t)b@H
zS)(XLnu<Dky@8df(RVSt#*6E@-{{qNE1Yn}SZ9Td_T%!^ED*&;=F!6`@aVV_n2nJP
zDq{GU)S0^IK@7^ZA9k8d4Jo7iqZ3O0`?s+*A|0BuLJ(_iU1-et8QuCflqq&u>eqe0
zFRj(TG}4lnFa~Pwa}0}x2B%ex(QoTDC6$f1bN82;c_pe__Tuf@PMz&T+8#SlfJJt7
zm{VUtQ|A2lHjO@PzpV1~>JonnD55O?yu|bZd}yw>7#lT-za)VK?4AgA9Z}f*wc2ut
z2Os;tIFKlVSitQ*J<+VRmcm?@0HG!s9cL;MLOm9#cOL3r^}xUZaK0K))a{oWxHYOx
z-4V;veY|1xKR|XgD>`}V7nq>??c4E)f;4j{CsA&w6@hIS*6*J3{3hdkdjmUFTco})
zHiOGIm~i6)2XayIh)F1d-Ef_|VE$&wNOC=U{4XT02S{!_??$+z0(-A2lB?hw*UD%A
z%T3)cwzq%1no5<S>I-k`UWM#oWu{6hf8*|Z1L(J`m{51Tmxq)Mux*sKzT@w7=Qj4f
zfrg4=u8rFt{|!%Y%YD?by4oTO#W(b-)6VtZuK;Zr&e;t+DX)G<tLlm9To;m7Q1D>}
zI$TVl1lGj@0e?Iv4V7(di{tK8!byL>A6}Pjhi_;P7@kP73?mn4`q)}G>?TLpr!8?|
z?NQ!8WQ-zU&h)`Ndy}{d(AC!O#T)>K$1lxP_cGdMzn3I2#+DS6uiFyqtHkKS4>AlZ
z5a09HtKo7}0<zeDnQgIyw*AVi#s=%r--9<L)MU@vC-CRd*;`A=PBwwojE84ih9W*R
z$xVBtQT4dI2xZphJJ?6Zzb>^PWrF_$*tGF*{ST0->-%OBJM~eYr7rnx4v3HQ9a{e=
zd`~1Y@sV^0VnqMC`<i+?7Bg$M<{Kh6%uhl6m4XicT0~SEv8ir^JA2T>mI^Y)=p$h(
zFXGowS-yzwWC^;9Zy9D-blP#1tAd@@A(T|6*9N@(Bid5&9XJ&>gR6Mi{VShp^A3io
z*@F9LQ9Pz<0fzf})AH}Mcpt+#5!J>k?sS%-mQ|gUwlZBymc*IvE&xzd(Y`8){Rv|O
z6ycU`%dWwY?EsV1AFsjlgh?z0x9v~l_folM_p2_K9<?du`b{$mjay4|ueMPMcYpv2
znkTx$9}M*AI5~*s!wx5zVT9%x`+fs=DY!gg-J4f1Mao&|N5|b=gyoirkl&jr^isJg
z*7a=1?5F8XDGRJQDgx<BreGc~nRFf*kILeZX~J#}{yuRv3a6N}6xHgV=1t@YJSUTH
z1bS+sty=tbM21)fE|;e1Mf^Lv_m#y7Qj8<ewK#~Jf+>SZBde!rAvA<$ZA=);5ytQF
z-#JihzjQWcY-FN*$QJ;d%Z)z6lliBe*joq|%mMN@Ib9f(C)aoM7p`{c4DRnJyNtDg
zCl!)*CJMS>CI9KMomF?!5wDrXt^{(6_i0e56tUk}*749Ha>#j-3eBHTiwNlRPf7=x
zp7$TvKcffk@f+KH#DASKw^AVmfv3wXmMVO=CdzV##Z9cMz>}RDN0CIk3_#@JLE^)j
zluw~%P}m?n;^+9(LFJg%l!ZqNWVP$8Mz4z}$-^dyoBP8g4Y$H~ii1!?rSe*eXVCr`
znDPr4agk5w5p<Jv?N{i9xsC*q&CX2i5znV_7@30P6eMKE;IFn1^rCc@dI8E(p|DYp
z&06+<7GqVEFoo|=dc5ty&@JlU(vF)3LxrBfjsru5eQ!y4Hc#Kji-mcOEzQ)e+rFX4
zTe_B^mu(}`vQ$aLIwNLnok7e;95n~)QU8_+sx)rhG^>y9VYipVJNOP#&FN5_KND6p
zJILOk5`Avkd=?pP=PE?p)wXuj!tzHaYFFn-M8?si8wFRf8y)IB?<?!-zi5LrgXvTV
zO>{jpYn?<pkI|*_g4}(D_QL%CK26$Cq$T*j<3b&ZFNkHb>7*@G(fPN#O8&i)z~u<#
zX-=nam0f%i51c+fu|`y8xz1tOH;lhgt5L?I4Y~q7AwDp(=-j{LgUXveN|bcbfy)m$
zQT_XhiyJB3Z#P44<%kvHa18t%PrW#V9TlMz#1qtb=~boxE>TP6i|gb3Nm>`~EGZ_N
z!h1FT^$FiYR+Du%EOGL8{nWwMlOKKyZ=-Xp(&WtIlGNE9l12)qWOPkkpYV*TN>01A
zIH=Pe*=EcYCmIN<5PsHHTq|gjY$afrD}qOVrI77X`{6_U9aVG51;PU=X*JjuNn2RE
zRQn_0y7uCF#H6aHrMc4V?SA8>drM$)RbAy1UgBu@4tn39-DF2V(>{9=8Y#WpyI}+8
zGtHZ^Z`l*3C2(0?wf&a;H;tY-6j%)3f4OaK?%7$^aK@D-t7Ecrhv7m*?T@5}z?$uK
z#of9%oki|qUXI1EX(J^jj;VrtvS~CbCQnCIg4G~C8DmufO8JUfMJr{-H}+Q^MMfuQ
zV%iTXU7ZMvhEBI#o^DEVSQ(dDEfo!7&U8XOGDD2?_ADs`GOCn2CP`jKSldIrPR|d8
z88m#Jw@rkZfJT&QcD0@tHN5UO)|DvUMY~=Lh43NdS%Xv7_VhcDYG{k;;qQ>br2tiE
z(V?2pY$e~3AOeiL28bbnXT13sZ@hWY5oWHZX0l3>cTmt_F%~;}6-<@*=9Z0#$i@A?
zoK{BE%<gsf84uatE17FWRjm1B=~7}UHTQ;9H)LMEN-WmuBAR$~9xmJ6mE^eYH}#no
zZn}&&54!vPD6mv&_O|}<dJgQZ<Z#bt7m9*UclVz`@HQS};MJ6rhBar(5C*&gA6G7X
zXO>Cxv>t@4ZC!3s@1=4ZYg#RYuO^j%E;kyHGBz}+D=u>%(p}cIG_EL$=v0Yd=llV6
z*$8_P%bs}uu8+*Fmd&PZ@2w*(K@NQZOkpsFU!Tl%AC?r0Sgtdf{PLBZc?&C_9LBRY
zS0g>ODWcKng1!uw>zAiB%1E81iv^26Z-xX=PkF_qXyIbR>WYA4Zm4nlMRQHXQ(%>{
z=ZA)C(-d>;$j8C$L@mCOG76zSz^9}7m8zy-bwK6gXOi5RSKB0&38<*`?S^p73|2h{
zZ{A56eb%W&_E}Xi7Yi%v8V^%?AC*HlKnF`7MeeNOSr;XhOy+rSzt^UeD*ABr&MS_X
z5%&T5>0B>9$x@rn*OxsRGnK>9GJLg0Y+QaRxum<!uY_MMo~k}e>xeTJ)k;N@9wksR
z2dP<){sYzf?TTXo=TdbU^HI=JGnKy8>ywx9ySK;{#BAbmJ=rWGB!|YCRkpKUW>dvM
z?<{=h*$vBjtS!UQ&2@)q4-Hr&aIO|rWH9S;T%D}D*wqD|IY5v(V&Z98N}?_KS~ryr
ztVPX4PKjVEuj)>=+><)fn73Ai9+ZPIYhd%n?2(;XY=Y$8&O^D_7Iprt`(7MB`&1=u
z61g8L`lHV~0feg!D)OFH?6w%@lLT2MaY*Wd;SN?&xY>?SM!AQt<{w(GZ<vc^j~17F
z71SV|J=EMfw`5fmz#mx^ztHy6TB^E1%$=nv?5qBkNvyh`zT@{z;C1<~CL?&g8bY=H
zVk}CQa9(Bk#dJ*BkWSQq%?zCA*SO&Kv+_MbXOYAQ{b8mt*BjmIn)dEARI>VbK{*Ap
z^d>qBXC*~*=nuYS`oU%0i|@0m<;$V=y@0a{4w+nFq;?XgsNNnuK7m|p3Kis^Hg;)V
z-5nCp>a3CYCV7}Ln3lk>@Gk&riys2gna|mq=JGqZh}A)VHo_mNLh1d~eEtV0fJpkl
z`3!AmVisCe*!m)j*5Q1?Wv_QWeQ^7b_~0g!EpG`R6l`7!Q>du=92(lo>yVyC7SbuB
z0rjMRJ~G|DZ7jpASivpMvcTUo!Mgoi&cRvE`dWn+#P%Tr<&xm=Zg7}h7dXpq5{v21
z+El_dj7fiB4>{LF__Dc}L?@F}%v&AYN66PLSfR6`7QCJRnic7&=ID?l=J+7F$!keZ
zly%0IihY0f11rE&BcH1;OVqlv&}$8XFX!m{E&i>24PN$NwHR4_nK+#kBgFwIQQd^3
zoUg<1W=?M$ZxG99{nBoZ=?8#M%kf^2A%mT&Jl&*!0b-Em2bky>o_T|}a$;$n@b##|
z4F(3E4$ZQ;i+PFY6jTn#Rgkln*}1;=+Qr!K_0kt1PM?>e4=P`qZTiyPqeV|nq`v-v
z4quej?OgShB{Y%eI3bj^(pMOhADg@;nyE1<MBOh9IJk&0uc=IWk0q)&=LY6ufBje|
z3%`l&!|$x}7kET}G$Fi{=*id6YCW9lM27#_((d&&G0@5cIrR!jw*Hp;<EimIR)jDO
zg5_B&#~I$F*G+@Q=8tGbNUOf|Ncz_(J#0*X69GXLZDxtp_L0jSjAweYR9y8!RH;1D
ztJJOVGBfH_040w9*~cMyaihO%O;G%|jNTZi0?h#2?c?oGPLtp(sX#eIH$Z`ex1|o}
z222%?QFm!$3rdnON!8HJ=w!CV%Krh@stXoK70t$REA-%sI?+z;&ZBUj<7(h2CdE^m
zfpOq3MnCILY8`6ju3C8JXEJ0aqo8%*(vSvz(djs~U|^d1O=MhGjAzGK2tA!Lv|tge
z=6D`9F7$0{u5???G2HGsh*Cl`qKPFR6j^~`DPKIoGDZOYl=~{W?`FnCS!|q3*0~{^
zt*}F&01!#=;2<9SzXVE?H-%()XUfsP@@KNnFblnRHdQAW=X12K2uaSeX`2fst8R*g
zBf(()sahwix2Ww_o9w<|qP(BLCm0X+{W}Y5k9W^%zGpPiBu+>WqZ4{Abe=T6WSH|K
z?oGG89$R?Sj4SndT=ys`x9B`htw}cTmT5-oFCElmyqbSVIFr=__w^J?IOVNmn_tiM
zFe@4Pgbu2!-<QkX=!Y!PY%=^dKVVc8;|Zufs=rW)Upa9-@4e1jkC?rbvuIHL=+BHZ
zhel96r-Aw>nvnX5@s>26`MCzpgs;3$a?<8%cOSuddfkWxg9d~=>N-i51*CDamg8Fo
zET_biQ*1zm!WgW9_n<N&HPt4PNSz}n<3d45K8=NlteVFyiyw<{&gANKABLKTN}sol
zNM<IehMH*k0x^1*`U4y0;#Vu@jLJ{jv^2b^h^WvSzFC?r9ij6_R}$I~zOaebSc~VG
zc#9YqvmbyMs-fvL6tH2e?!S+jOO4_ENI)A5o{t<>7#+*<Z5$#HE9Nmq3fW8uif*k`
zkT<WNJ*BGRScR0$6;ZHA<RYEv(3Cxl2v(OkUa!D{q4S28kA?Jn(4AF3l$DM?rhXS3
z{qMc8R%caI<>+Jlz64c+mvWcLt>F1KJ?G#Riw_oWUL)yHu(%b@WQhnb#5t~(-sL(`
z%$u$<n+hSuw`p<j^Xk6<JC!(*41BW0_^VuJ*twZRFTUW-p+KE7ULe!LDK~2r$aOHd
z|4PY#*7+PX_GpS;jOMv#&{!*lrb876rVIqQ(X*fdx3LcS1UlauY!KJ)@LhVpshQQt
z#Ow8R@i}L49{1Y-D<qY10PT|q_>P&R`iqll?mlm!FMH^v!qLeHwFrxN+USh4mmYOz
zI*|QhY8T)9E)oA76hO+?x=i|@umd~!1MD)BaV?!HdLoKS)lgir=}5==5=zAh9hD9>
z^X^n(t25GN3KlJa&n-;27}SzD_}NfSkF!4glXpBEB5E0_U;)u<D&PGk#nYlX#Ji&@
zpB|LBGlLj`1!>v>`yH9~?r!kT`Bbqk1#k(qlmYsvN<6V<yb{;w=@kDg&~7N<t9-On
z*7<K^Ll>Pfa#OSi<V{(l`Pid*Nb(5Uv<PURIL(w<>o(=s5Al5FqQY*LuH@1oSI?~r
z*`O?eBGB_?T>pG!Q`)taBfBym8FxSgVefWx>h#jmCd*U=QZJ+Ttfva8{PJ~<Qc|y$
zQMCt2#It8f6&;={j#m<*rj1`7`FhCewu9HETMu2&Eyx|{PlSS2Whq_IJ<vP7EUKhd
zzE={1ZLu~2i$bJ{M!Zkp_v-JfgGV|65_<SJ@Otx3StlqE{CB3jq(Vn9D@KO86rfS>
zTf4uo9lYAN%g8+>K6|_|^GW%dt@RlqW3nS4+w86r1kD>~^la?TZRMMH8T#S%_1!L?
z?k(vgEig}Fy`GO@ChAs285(o|R+--21?0WJdbdIIwQonv-h5l$4j~T8?y69W$TGyO
zw6tY}jAd6r-H);-ovT9v!tZ>Pd;JXgV9p=dr!1koXGz&4yv2lcKkreRWg)-$>JfIm
zbv@7=+CTC+VmsWk(We!V1*#ObdX~{uM<)OU{mFtMKV)UaF3@!g<kSA0BHc?i0&JML
z2!%h2Dm94g+Ox}LGJ<Ub?P3R0L#NVRBRf|t-ABy{gv@T`h&wr3lxnWuPtCT*L=9u`
z-*L+K_>SIt*T!_=jNRkkWh@s2%E?}LDQQ+OtwzX_Y8q&9hQ-0>$EThyw}tc8$wI<e
zLrQ6%JEi?dyx-`7`W5bk%P7nwBf!&7XhH<vsZIMyt#Br$I$?FvdoUBYQs(F;0AocP
zZK{KFRhya*cjS4a$?W*A^ofFwCu8yw)e#lX4%_5Ko*mYscg(7lNAdf-8Fu1%ZCN5u
zdm<R}-<c^}RyzOEHJu75)6FVR&7w@G;%R36<-N5enO!j(=0lZbs#14Zx4kI+xu{AY
z1RN-L<GigGoCSoG+1_Bw#CpNYFN+lWL*#z5vdZom3{el7L{l)tpckcu>1rJtNnb-F
zIMei#ZzfOmb<*UFZeGWM&OyBKk336PpCG{pv(tH0EA;9~mH{C3FnNtcR<_)5t(j62
zMJS7zwAah;6S-V#=Yr!82mS{LXxg<}Buo`^#rzMTOIFLGj_+sI5vxPVrX5kd$0(r$
zVF0TL7K^d?X<6_^GjgULfh`F?TVF4JSd7$NtB&Ntvq|qT;>sje^<R$$Sy9G#b1@E4
zieS9?lKA^rH#3TJsZI!CvvyZlbjEZ|+_9vxKJakiJOl#aYqu^oeBLIe<_cgh%*R?W
zpHA>12erR}F*A9ld22bRZRr|9Vr%l<o(dmChzhI8MTw{Ovmgguwc(Og`F_tptV_n3
zVS0RJX_Jx*q~AU1gKr?SJO4?(uwDzo!MlFubfD*MHxE2BI?`dPVW^`MOE7x*>}kJW
z;?w>Di=RDyRM!%R^6b?&KOCOcRZaR#4{YGZ{2mng`pY-jj);TIQ<elWN#1V#aFtts
z?y}qXFev#+N?4rdud6E0G`h>JI1g59U3MfnF7&}tqm^sQ@)%THiZ^V{lfT}B_j=!O
zEL}N9Y$uIn{W0e1HXb=7<I-2yRc6Qjj(V0~-Z*c!s@$$fF#Eo%w_GJ450~{p0HZBi
zp5*LKkpJOWGq?REVmnu}zVV}RVP1#dLUQGGVZ3ed5nWJ-R@Hh|lI4RTEg!0Zs_Tc#
zft9;n1l=m`*Pyevy~rRrDjsm+!;#h~SxeLRL!*c)(B(=r4!N<AnQFWko|y+X@Y(4V
zr+mmODpbZ-L!tq{BNt3S55DY7O}zN>{1@t4+O6sU@Y<_7d4up5#bttYJ{n`HRn+M>
z)x#nuGSu&p=8{WE&*dtUM+7;#OYc+iWaHo-#|nI>bbp_=d?t_DKXC-}0(NHy#guy#
zjXy2F$;kw9YWuJjaCTBEm^-z4wdA2euZvNT6}{#HFSdF4b|c6Y2v>WH11+W1gC<VF
zW_S)?bsEF2eo~>Q3rO>LPro5%^xxZ@^@ULMo-RC<b0XrFOX}5l#g?geKx&*GcjF{q
z^?X{RMuvc*se!LP^+X$-Mjd5M{o&r=S9Q1?{#>Q1>U3Z&qdD~NgdS)XEla|>Z%{IR
zt50j)qXjX%{HpY_mm7zWTJcUN+y7{f3{(6bEK?p&{GRUa!Ec$_XeM#Yt8-5RXcMS<
zwWIjr)x(-?d^Za>XJ352m4s>5b29MAF3H_tzaosi{*=i>i4G||N&2XWU;uJ6Mcf8@
z#q3t)7yt3|;2f#~F?f@&Hu|+C6i!YqtHDVX@9grT0qQ|r+>F2s!tr1$_p3W>nP^<v
zb%vv6*&n#;sl0$Rvr0eXeqUox+Qr147M!p0aTOOwiDY#0w3p6BQkTxco?cP|6h{5C
z_vUR2Z7YFxo;wAfnFzP}wc<D&%UN0U8x3BM6n>J1F8BNo0CCP5?C9UujDKoa!w(>C
z>8I=RP-ptc_`^q(udNs2-b7ik)B{9?=|iVlA4~3~v>OgUlP=APlA^+5jOj0-4$j`D
zK5RgoAGt7fDy`IwX#TvpPeG=-O6B8A^*VW4!Xy1+<uIoEM!(e;QdSWIW2zp&i;hhP
z*JNdLBY;X!=`4%_w2+q%dQJgO3yx*`l_+}vAH}_S4d897Qjc*=bbo9Iw4?}V&};(1
z7?dvUi=}3Em0L-<2S-7r26-^C<N_$RlYdb{m^h?v7t=T!?r=FZ0n1F#{|FS$wT(0S
zHBr+}0#ZUbrZ>ItX=h>Py6ZI$H9d_UzEK=jnrd9}B8kZx>OZFp{n64eq65ZGoNxoe
zwW%)rw-94xaoDV<M|`yCITa!lvZpy{pYrE?j5}QD3=?U=85q1c(NyAq{3<=-4$;kV
zW@&n<JQKs@_tVLOL|dy48x6CHK?SkpG`omC=knA5upcT}>p6oytFV1RaK}<t9X2Ls
zP0b>Mda>@2BN)T{-lu^|HdGcnw4|@7ZSUyZ5;b?eXZXpI*E$UBt~)%cUnRB#A1^|K
zXvTx;-Fk-5)W%kSlq~-{6}}4)>oC6`CQ7et*&`wRcrlVv+MJz`dO=J_A5NmPf4x$2
za{92x-?a8TEBx#iYRv`>V0QK2F%-<YWYOyj4cL~@pr?|eS7Oq7fGVn2bJW|iGI7$S
z`xGFCd(FKNyn_OTH^n<60cwhvWJASuu@pO#(nC#}6M2clPC)DYTx7(Yu!;hDYP<?U
zF98SArJ#bb*@!gs*P<#$Wk5g8TqHxjg#vZ<nE4e{QxtjrDfzf-!Cg!h`i<tF9mnh+
ziL^UxLP1oY`9n^s#&udU&9r{My@utKp-Hg|WxTdRgFWfB>~(&X5z5lBX%tMYwv;*S
z3lM{^;xeUYfnV*kdjSrL;*5}rGDQ6D-*;+J<<|r<Wql*OE)C&choci6p%kmh17R`o
z+F`)9@^3smD}2A=x;`>IJd^Z6^7Sk}NKVc(PdK9~UDh0Fe<zEimc{IH<z_Jzt>%t4
z8y`X;F+`&iK@sx$qmF7^+?}(FDM~cs`Lc>d>>B~N=J4YrD8i!4^rW1c>2Mgnr5|B(
z*&Wfq5$XjOtM@?4gdHrUzFdN(Ob}W{esO-Ch!GWl@(HMAE*u7XhA@L%@5xOPf~&9R
z=lY9PAgUCLt;j89_j>~=H()FQE~(w!8z)GJ-!HnZ9>eN+olNUZdt^kUbl!%{R?QOb
zhGM2B-_ySQJEd{?b?auGihGdeL|JlA^|zrl3KrI>OSwI$bZlrmT&~S5`m82Va}bHh
zpb-e0DFe9h8l#Le1wIu#eb{#&lN>f~(yj*-tI*VoZn`YkG|r(R%heT1M$bh+On<DZ
zYODV@HrNbWY>dQA<OaE>z^WW-IA8+X0hP&mK-KdSAO+r;_M!2d@1=*si;_6{a4*wV
zd_>!Eb<9v(>kGFshi$+I6E!p6o9_GTDH(vh$D?m052M%ln<8F}WXpY5Dc!uu2Xy#u
zN{&)w`y^g2$sZ2F90gSX$$R%uWnVY``~EdOh`;${M4&+QDUg2=dQM9y2%8B`_1cs$
z6`Y^4GFXzzA`ULxTi&xMrCB=%LYi&e9$p#S#h$LLoL0G2%?=TyD6e^o@bIX%`FZ(Z
z_p2ErS-iEwMW8_Htzrr0jK&%Sl5D8-QDx7y!J**i{JM*L`xE#PL@3^Cx@O2Vc%9#D
z-$>R*;{7-O&XN^HyOBQPOQjZ7MZ?ToPL6wj8(#gL{!SG2jvqOZCx>eHFSCjsUv4$G
zq@e`xFDWQiorefMmi+Yqo}Gzihlmb(w8Kuu{{ZDwxEa6M=V#B7n~VmHwx21uW4gXs
z+#Plmbjy>ZgMM=>pw7-gFD6Zsn*)Q&)7yNmTgjb=uHp*Qkz8gw=g#WeQ<0iRKsm~J
z7su>lx?|i4@Kc)dE+7e>6wlJXDf}h3EwT%w*BYo!_Z>S5s?t{+4s$8=tnJ}p8%awn
zO}Y`~4pgqf3<m?#OtQQJLer?eVMdqNw6x4_pC>N?QD!~&jFy^Ne=8i9%X0L1%jYX5
zh@K9;gdVI=_BT@!tV>rC0a9FSIc56dAKM@3q@8(Myjr|&Rpm2C_!?N|aQ?V=;)C<k
z_dOi4g2YFjTys7RfWCiUruvx8_<9@0u$GnV8km+sPYCaOF-hUU$cR8nk*zB3fkdky
zKEt%SV32;(L{BjL&w|yuq*?bq(BU_p=7!3#{H?;A>f;eZ0p)$=sVpZD%eTnM4(-p>
zul$ySDr<nsaT+x6EfY9G;2swa%9_-<WVApvKItkp?AO)8PUsMS(v8&kBRe83eRnO_
z{2Ghj1KTmrr%TTFb<4s{_7~m_0%r=E6XvdQcK*f*rE-o*W#*d?iuC<!cD9VsD2lL2
zp0>@8HG51mQN4<Vh^$#hn!b+$4u($E6?7)&S1}G6&!4#q*wI_VnUKLWW%uo2Cq4pl
zWS}ELaJ|UvL1CD>yru_(k&Pq81&qwNo@x<rT$NaF?Me7N9r*7~SNJ~!x0VPtrBE<n
z<yJ$-O(rfjR7qP)+x&7v&A3c6{%f1M1i8)*hP&z6*lI2)(7t19&91YiAM+x*_nE@P
zf=o&V&yMBbZ-nMIN{zJKEw6u3D>fIdf{i9<I}PwQ`NYl9gH%@B_v>eN7tWu&7V-IK
znc2W{##}RtXCE;fA*r$<rkehX(tG_W18;pZpgblE-}g;I1JoOKXS)3Z+X6m^EZh)q
zO_vw@4$KebMY_i={wx>y_2Em~#TzrlyCSrhk<gugc~ILyyB6~!mooH^8BE+7QpavW
z)+NxrV1QThYyTD6qJYY3*!ZNro?_~);EnkGK_sE`c^*1?RI*$~28YlqIk$N|A35Uc
z@F4tos(*c-%|CN2rq^XbC+cUSdi$mPXIH;bAPeTEj2rB%hRM}QlBHtnVaJpy#ml+O
zQy=*IUS8w%i_4jVv>|vCrnlb@)M95sdb%1=v7mLa5q^pxWM%INx2=*?5*H;?8}IVs
z2EPdehjYt(%GD9%n@-MvnyK{C2G%fK!T0n^szJF!Zk|zrRda0oO)DYX_Yu57rYWcf
zfi;lj*?M_jp$%G!^9ahih^V50%^#gs{{)R1qe3$ZzcoWXCItxpZeWlJA=c^IXObqW
zsTmM(3OP7s$Y40sqTt03xuhXpWlNh$IE9gsWqIFgmD%+~o^?f*^4?;Rc+b~{Ms@26
z_ko0^oAW)yfP5YmgSXKlUpM<G){4#RJ-SBc(nhchb8#)+)U>FZ?Ivcz&QyKVWpnot
zEPXn1MKAF04g$F*^zKu^M`Zd^(OqNV(BP%7m`GGBt?R)@LMNR_hzN(0qRO~(S}J|$
zaXBW+Z|drsAjKuBVG4;By2veZr1nb9$xwSd2z=LZpOTJXC1gpne37nP&6p@r$;jx3
z3*)HhmA2JG@yna@w7zZsGV^%ZxRzwpoD8hNk(U*#EBt6f_z{;YDL{oP?uzt}{;f}Z
zq(;5+vqt6Xc)ypi0N9-))*ETAX_lw`$l(6H2Vs}Qq3aAq2G*EWY&INJy@?Fp3vCyQ
zEx}6ZL`E6O7+TLgz`ygn%U~3Ug>IqFK?qgo3b-(*8QN){$|eVhh>PbP)u=pWzN>!-
zT>%(@{3J}&{WSx+R9S9Pi@=f8(nuwopR%~v)4t%p6W}<f*e#U3M4k}_wc2FEahY&Y
zyf-4Zd!Zq!p81ZOI@x$>M6azexx`x-;iX;$zw=|JjCKdz4C}pLv8obD^h{-rjPp^q
zyJp8~shqpZr)*(}Z}|3dGc;X2fhgB{KK7{N4}BkNL0C}L{RV6reAS;Tm#%YGX)1T4
zb4%lO!+*~+4;QO_?fW$klRY{*{&Wo>_@45JhMURGMIc|TSd23|#cq2H$}C+Tn922$
zoG7?Hoyx5l!Uc^qo6yF5#{(k3SIMj)Uxbcom7rPbI4^^uB9L+QV}}96nPMq@)(S#-
z0k%SHyx?bqk*BB#-DpUqe#3k}nBXZxUcdbz(hveQ$ZeZNhD{j@QJ&t-7U>Q!A);O7
zVPoL=7^;~w@e5S*hV6jMKt*)=XZ|chR$D5UnR+otm|f-U{xfGjomJcWv&LCr{xzPU
zw48tZS+q8DYL;8p?2iR^_&j8}Q1L%MP4^S`UcCWTnj)#@M;;}GTdw-=*nafjGG<lt
zDGY2D2D&1&t4%AH3h$M9^r_ZBWuHE1x!wtWXC#SYKe|gFd|VBq`uyZ8)AtB4!B{>f
z@3U#$(+c0N^>)>}H)S-B0E(=3ZO^zVGYfDa_a7w(*`{l;-76S}_o0*wM<9yZnnop{
z*PoqUT2u?$5<2`b>BenQq{v_YI&Cou&z<t$aPE@K8IOpDZ;YG2LC|EYO`C%Dj5;JH
z3UkWgl}{>X{jxhpDKYzXxrC&mP(tRkl{EP|Xwy(^ggETM{7EG?DX=|zm-3vFFyUnl
zx(=I~4!(@-x&whd0y=56^8hGtZ6=Y}aW#b&dEqPuz4`ReP)mi*`B9^gUQ~qRjWpuN
zkfM6C-)jlO#Tu%{70ovELL57b8+hj$akK9}M*y0)xG;*aqmzDlFv{+>6>ol_!=%1|
z^dYp8(ds;SEEGA0i{Ljj)6&fdobt2J7<b2MyD_(J>c}PWGYt1M@~rrmVPUEJp(k=g
zR~w7ePuczbB=qV(Zb!~mah45BYLpMXolytII>+;U8sq4wEiPIifn@qgb%K3NbEaJQ
zo?Ij~$wx=tR^LYewmS9Mm19^#Rh*XRMawQy5xuABb{omieO$WGXBPg5(rvDN6^<t*
zPt`u-(3pr&f7z>!rV7R5q6P8vdovZ<0{|U@(xg-YBk_6r>~txhXyF|`u+qh(L?{xp
zXI{fX-V4|;>wAL|b^%@Y>OS<?;fHmpn1Z}FZQ~8F7V}?&J2{gUH<;F(m3)^@1m|2f
zk|mJP=*}(E7rB3yQQ2nHT>fK5$NQKjFMxAiG7w$@dUCb5p=rgx{7Q_ks@3dK$(^If
zrhuyHuN0q@XW-de3Z2Qq>yOeT)5me?)~ajRkAA`166&y^2-zRafDAB~IFA>8GKw?m
zi9;xpwqP6GSEcvN>Wf|^{6xcvWR}4@U}6a5DXCdC@?M`fq#UDLio_&G^OSl4;M}61
zN@@jl#WEE!mNwwxan%!1i-Dt?WH0A3W?j3~qORdry&6osyYJ*|g0y6O7ZmM+#TbuR
zJH)#vnO|*M--SDZ^y<*_3-jO=AJv!Q|ELb%J<2S)EJS-y@uCU#b+WXi%BoJ<v=9GP
zF%^tNlsZS%OLKP6cMbkEKgB8zLaoy&0Ty}0<E&sVj-U3=fzbv|R<kS}bPr5!T%714
zUcXw)@E;YgVp5QyAV^Go+g6cUY3V?&iK`G*&o^xg#2`=iT=*9D$85U*4x)>gKO0-D
zNI+^Vga+2Wg9TsBjv9xWin1A<#Iz_mHNF=)x0Y%J9#kn-Jt7J>ejZh#^grr!-@nKk
z3(dc^FnK%h-mp4TOyq~%f6WhF>Ed`o14i`Q*8~(pt!_QhGuh3F2+zt_VcKWzl(t6H
zWnYy33O|)#<o;ZF&eK)pxxQcJf=jp^ZEhgBvpf>`(fmeBY)o{S^ZOTvd^KlbxR>p(
z*VSQN=>II{wZ=>Aws&h?1w0*E4lwq4qEE<0+{9U3=7U1Gi;A^5Z}^{r?l#XF{yHdY
zW{pwsAJ3Ck%a&eKja!>)uacYDLodI<cN|nYj9OHs45)^K!%yG?pr0ujb@IT08z!e!
zGRi@Go(B06YHFBN-)56^YY~Fy_PpjRbYl6!ed79-W-WcA3vV(k*&~*V$WP50#+1rZ
zv^vSE$cBFjU1*Q&PXVb1;ioiTyL9~l^y(Ue$aTEPn{i`xEJ@r4M}!i>V%2tT8e$9d
zcdAPxgBFeIHE?0<SF!Sw$HqCL<0xCIie(k1rvh-0$}I{uCtUTJ!ZY+{e2`d+XCug|
zH49{JTCpSm+p>Bs;ErzmWY(CU#^d`#kl`<d8dw8)Z9+3TSIM@QFc;#PuPzRrX+WBV
zW?R0F{o<qBr!AM(LNnPc_p*y}E`@9yQW+K(nVf4&?s`s8tzl(d)H<p~`_s+a-VXxD
zEgJW0Wz=?!Jb7G+j#$2(NvvhiT_LZJAs|v2;%AJl5Sv(WwV9E<WCD^+kO|0T*oLDz
zdePfJ?;%2~=anCMTPeffb;NtVZ&gGR>H=Winh`zvRM(7p@b1)e5lNRwv(h3)P|2=j
zWb{N0^KaRvAoT*c_dS8J%NNt7ZUgkocin>gdVlbL>(CN@myRO57+u`x!M80b;XLM7
z8)XzQv0U4?i*M1dIQoX2mcF_t6_n~Ht?KEhX4Rz%GaUrj>?g{sutK@4GSzyi7(oNQ
zreniM<r!?+dmYagXWxh!SDqhYEzPu~7Y87J6RqyZh<GuF)D2=%P@pHHmMJQ?T>GT%
zLq7TjF(0LR4hkt~ex6<lgq)P8$plJzn^NNoPh!C4mYtZxR@#;6C{WeakNu-a6Pd%d
zmJCF%sbX6Rqo(7m#qC0x4P(oc?Kio}FD5Xy)wd6GX}#zB;B}SMxxZbatRTxEwa=y)
zo*J&QWOi?K9xrdGl>u7o<Dc~Zp1@D*B(vd9q<V5z|4tdSwnT7yxn&VK2?T|sT^MIZ
zvb3bI{?k$05<X>Xlg<ADyd3K<P=3JwrewQoykZ_)!ue!%r%^;sG}j}Cl5NTwiRt%=
zKAj_Z0G$bkG>69aAX;-geRaI7Sf*%PBPvG5=&QK$ek%sj(Z<@N7eariqpzK_T)aMr
zF7!O*-BJu*op%9sZA3`EncC(N%~@T+u2`jIz4=aXM|0A9y)*BVyk&X26olIGDHbZ@
zw@+*T>e)%SeMj&@@@ktr_Xz?)JXkAlF{?Gu+WkAj(%Z@+#Li#dt|x?eSxNfHSUdlk
z5%~*~GWrpV6{8vRDLPL$jDPfu&=$R(apotGnf53lfI8}2XJf-g@dgod`7WuV*}vPJ
z#m-vg&_B)hMFn_LxHTYvr8TMhlYYMY+)wPjuO#*Fh4_p$Kb@lb$^qG-DkJ~J-*$=X
zH_{Ml_~|t9rNAh}mc!>a!e7}a0TU5xbID3)-4XK&wE6I@3HQfb(d#T?@GbMGpsO`?
z6j`V(q48fDKW4f4sgC-Hz#g58xLj!N3yUCwAB&lMN|RX;i<1Y{dXyV!hqCz@b?}qQ
z#;wVoat9e#s-|0^4W$3KjRgBKQZ9Fc2fGe^i^{iHb1e<V&2t{7I+~>`!kIBU6IJmv
zuUN2XGvv_MD)58?St{zEEx%Vm$a-u)X6!l2Id?4YVzO7_Nca~ecdg~86`dy2GU$6w
z8Eqp{28^@xdDAJg!%!Fgjw91XY9zIp&P0iu`aPOG%AmP-*oN%Mw{?Dmy2isee`!0S
z(K@I0<YHQoB^gB8($cQtq^61PXeB3NckT&EwcW)edfXWsh8ZFTkBfr1$m(IqnXUW|
zA!3D^x~Lruo=?nI9u|jfrZaJp$xl{x3L($$!x9sMT=zqd%sCYO?Hv35#n(wjaXAhQ
zzWi>cz^qj<Q34;M^{;UC=EEdv`kD~zUwl(;AGbZbI=N`A98eA3(1j5NvXm(eMymK>
zaW{w5`vi~pJti~GL3Mc1U2vEg*t>7@DFnDSBC4ap+C)d8^#tL3M<>wBiSFnTunRb#
zls38qGnbQ8V2pA{tWctTM7~O@tshmCBnB`Nds<29LxF#nE?#`?ix3?fE^S1}m0o@W
zO#31!MTM6hYi$skG9k8wAb)u&pRfqeRxvT!mviA7Sb<PL6DnSXkeT<$ciN$C4$1k>
zPGc6xwiMyj#6Z<$u`wXef7G!bJm>ea8kl<S$ir2zNGF{=xF71z#pyQ*E)x0?yE?^;
zv}YL|Lq(Qel!$S&yOA4;Mn;5@KH&$Id7XSfR4o3*vTRWGE@^#rTEt1I>IP4%v;BXb
z_zWlG;bt?BeGsDsuH4~+AImckKT=HE^pmmKQ2+ejvn>=Ooc!*jdd0T@(_|R~^gOP+
z<3cR3HC)Ul(Krt9d2T-dgg-jbQ*yzzgXnU@EE=?Di6b|~it1>AOp4Q>PnClHH3wH=
zGhW|?=O}xKlbXiLO~wt&5*k7D*)vTbUl>!IH<w+4&Jf=67$DfSUfEY6MwTz;D9l-_
zbsbrGgJ%A;W{jF@5kOF}p~{%rp75e)T55MnWs7Ff4u@_B32kLX7X~~JRG5>e|D38h
z>H2E$DzRn_c+9-tjo8*;3XuP4TgfhXL`A_Ej0qFUrzDEm5X#m20`~;{e^)-}dBw1?
z)KskZ&{<s~X*uLW;y@B(x<D+MuiC<crd;pR)4L&-H{5M(+37MCsrB5)zRYceQ>r$m
zdX;=o=GKF(j;g^%Pn3dO>4xYQJNXQ0bZK<;X!yw!<;yXh*9z?-e+G)10Q%6l6qWx0
zZi=S8)oyGZ{H*Si6=2Pn&7+oA4f~>S2ppQJM_PR1*IQhQvXkn$#(7i(2&&R}NW@Rl
zYyRnwc$#j-o6Jq)n6bQJFp^k2r%_!2BGZ%^aERQAu-RF~;k|5L>z0@pi|`vtV`W~H
z)G4RmXMfKqAtO6eyTW<B&$wBl=&sQ^I2squRK%o9Atx+2)6&$w`B7BntWt}oBv+D=
znz{DbD?t^RPU6fB87b`q3e8#geUt+SJ@s)F{W|F^!o8(Tg{|P+?ByrZ1S5thN^1se
z4v^&7nGdW*j{<3qDnm!o57}|SG-D8_mA@9VRIh1Nl}yZdZ_$V?KoZ+Q>WikwmE+P7
zCZ(VnT^Zm|3NC6=L|a*xGJg-I!yNX7$HmO2D}vWEfcHALrV_Iq^w{Hm+nrGT?4Ih1
z92=EQ&dMBo@uRy@gd)Ymv5RMjHEiIry|=%Y^|9Kw7);8*yQwBSq!k!ecY6^DeIXmV
z`7D?tnlD=0hSH5hz;SsaCMA{Kj5<m-H<>a~dc&-lY&?R(bdAtr1u~iiX(O|FF>_JK
ze+RkDOySdX0MkM{G=M64Dbo?VC&#*~BQ(4A<&0~MqL(t(S}KJPVaCnrUyRnxWbk<C
zd#9XzW(sji`Rpl;>={JsZcFRZ?3aqf@69(QFo-Rca==`UpzD=jS8~uq0k5>r*IwN(
zT3UYTs(};UyvD;4biSBwa*$mH<XT3bs)w+*Q)nPbt`D8khu7zV_sN>>2q>PE_Qmot
zinR4X^&BD~J2P()%m_ZHwX$pfzq=kH%A71;N{&is_;eoIVFi{PVH<k=ffvUNc#_k4
z28NC&{9hJG?All;+LbK1H4(|AyPg>UW^KNKT-Xx`O+|2gMDT{Z{pCD1sIaf}-2jj(
zD++ApdYB$en@q#`wb{bMTF|ADEcdgJ?(aWt+yq8UjQjMC&E+pyUHu;%=(NJ_(jz15
zv*;GPUfb|M-qsQ0^`z*+iL!icTn%*KoVd8_i53HMPBf%z5$ev`En{;C_8o?A6uA$M
z7ue*L1`Y|Kgp=3rIn@46$EIGEpf90vawAEdeM)G<J7eJz>HX5W>UAm<mQo5T|3)6<
zy8Sz!6B?4hi*SqBHkHKJ4GT))+;{los%>$fUbMC+7_p5?wnja;5O(?>Anx;o*pt@#
zfYIH)_B#sqXA-gpPU}M(KdIKL>X%eE^Z4qiV(h;E4^XE8++RJgoq@o<4x;USg?}Y5
zGuo|YDMRX}_@V%$|2%k=bryel_HhZWptmd?K8o-j%(cxiv}Z1?YvHf<?3}jn?|w_@
zsqHlUymUx2^ud$%%Up_eqpU9SB)2S=X?3tyo7S|0#$!?c1C+s;1$ltD@+PRX0ZI8K
zbd{jiQ~+^l+Hbz0M+Q5;cdINE?EVUIO~dj_$hPX9`xHQBmc^I*kkGOZ5cE<RPMZ_(
z1+9Ex!lTu|OtEQR?{STsBPe92WSpIsDh#o=0N*Y3I=CBus2FDKwFJ{$&2AZ!g3swJ
zvAYPJF$Fym-aXPxTsht-)SQd&kaa$?#wpw+__BIpe5Aqr$f6o8M!{EfuVUt#b#v{X
z#SiYzA08!p$Yk6S8LssWeu3Gs7IInFOO4^~V|l`P(Kn=^HzxWHY130EgT0l1!{|@h
zIsl-sdJ$&stZi9<Wg@x{r4gs54kAqZbe6c%y)GQ)?=omd_;tFr_yWscp`_#?D!?O=
z!Bzf{vr_-7|4a+pGRz&{i23>Hb4bGyW0climiyJurm4NOTD8PY3MGzx@>D%lJ83~)
zd5r2w2uv*Rsz{X^Vo#S-4NZb?S-j>CeC-SNxi>z6LI*toX{E+|)S*!o$GU0sT+R7G
zse>T5SNl&-DQ>_OpUvf<W*Ku(TZ?(SuV4%R+rsv>7>3cnqyH@3c*&n!d}Vy}hRhl!
zuSHQf(511?NM$R-Z_(5dpz8=8)n~fkc4j!aP|I>P=EcZrpQg&+tEY`9JuW|k@zjcI
z)NEBmc^Tax*fS8A5y3;0halBPTU#TjXF+6vEb9l?s(!U(Iv0I}+SHUk=0JLnvNE1_
z{WVvA@x7olgFq!$=G|l5=z4C<voWHVXC*@Cbv`h7a_Nz(@#w|ft659Se!l8C-!qT(
z!jskg5Q=g>v-Lvi>*ubcHd>26y%AmtzqyS&gx#7%+Vo#3jhFzs4vjGXS(wN2Ki<>p
zzU(fWTYf4a1Lj~;-Mn!>0F)sTf%NrIK=Cp|TofjUI8z>bCO(l6ks#6fvDNuVCwcF<
z=(|2_T+5}_`%7_>)JXU;d&i_+o?m*TmjyZw+}xerb=X~hUy*zxwNMbx+FJM18DH~}
z6LeBLvsC{LaAYWJ;rBzKw=Cl+p81H7HMIPbCH;9)KcZ{r;niT93>7bH*m137>~mp9
z>m#tGsF~NHA+l#T<4MhGI*_~nk?r6Izg+lnZ<yt<M?;z?=D6P7q>%&i@6XH8>Sx-L
z+#?v`dJJPJZ_e(~Np0I(1I7OH`rW@>GbHNivB40vtOWVeZwPi5)z@_-m>gQRlgIUH
z$d#YPb%1g9zn1>9`lVoDhSj`L^Z!Dvq#D`o9QeGN0lU{d<FO&*S^3w;Q!gvGrUL52
z*T0{tGfwhJj+0xI9}BfT?`z!kCe4NGY|MQUG9%tb1*yE>UHl-v;v!b&GC<=P0RB<t
zVDtPa+<d|6c3<H~gqp8!M{huP)#{J#$L29k!UJ8;>x{Xls;e2yWDt9HK{u8m|F*9-
z2eNr+E3U(Sw;1Xkk{Kt0kUiF>AkzN;C=+!5uEgI##e0HBQ@2RTE958^L$1SOnvlLQ
zoKe=P64cG?%~|qKTRmEDm2gW%fxG-|ub+n)7lN67#QoxF6IaU`lknzW5|A~M(^L+d
zj8wMSd&FYR91l-D-a{Hu+Qn?ngxh*IA-*E_kw}TN0!Cj{kMw76fPbxtrccGYI=w<G
zRq>}kE!O3Rx|;YRj>auyKH7mb65E5j#LlM;%D*4U^X5Naf*-%_t(t9>wqX8<o+~$;
zpY?H;mUx}k2MFY$DbxRAoWT(}0?{`47_1lm1P-3!%}n|7ipi7XeTffkJju7e$~DM^
zSNc8Bo!6Z9$^+PRt2Rhr5%xPrtevv#O?neSS(1>_tmZCxUu!CS6^G(mj{i;yAXq~l
zHLV!2(bvSAz$QxX8a$N-%xlM$+nALeZqh@sw~y4P+xQaCsw)r<D77p~bUp>}&PelZ
z*D!A%*c&lW9OUXG06t2@zTb6ex+3*g#3{qb{GX|x-jpWIlgV6p5I5tAw;~BS*wu*-
zPeRQEU=mqUe!;zv>#`Fy*}fLLd;0AntE>f;x6)kI2Mh12**!Lo-7ul1CW#!N*u)A4
z-*A<pK(1F%Edj-<i{|TdvWJs#vZ-Mfu|)jeMA`oJT>G_6rAa+f<=ZYlFZ?^<D544n
zyz)aQxkEJM4|JASlzCPFPASmesPO^sD@_I!km4?%HnM7`cA`paT=<}mv>|I&Ak}L6
zIaA$$vw<R|IL)<knWv2$d7{YB6>^<WYE%f%i9B;M{8auS-W7jV3_(~nI<}0Z&#o6`
zYf{V_xZ1;Cpge2dXEM*QG*QOf)sbtzVQJCrPfiP{GVXRL&sh9;FxaKH)iq+8wurlL
zvtGhOId1KdIGyO%!xiS*Z|_9ub5i(G-ToA4NUeQP<k#lM8ez~at?{+^&#IWeOiiul
zO2_5Giaa#bwbgjBp`~*215+uNyULb-rgjBTanfoAR5R}$)OLoi{<CCWg5B0A{=}bE
z!f;!&>#qf@N18%rV!(?DG6&YKjzBn`=B(4YY<gZk%Ub*T25;$V8Uv7jiu@XsIB2lM
ze&>G4Zp@BdDpKLzBSVvj7sP9$K-9v=<olZ{AHhsyeDdqJi%lA10!teY{|`7p$G)DK
zYTF`b3I^PcIjr42-9yH9t7jbIy8CF`YGgS1N9A17W~JM7`=AvAwrgrItL23(Pkt(#
zFp^ZU+M!2Yr|DWyd1H1KQ_oXbwiYkIBN%6K*M+O*M`lidZ5$4jlsR=cZ@u29Rv?kj
zPC2Z>8kr+*U$+#9(mm)zjoFHx2Vv@JqU5Gd?mbOeNgZQgtc$n++f)qwX)@9*NgOF3
z{Ct*tcIZ8RwOEo_PtS^w1>4MooO<&{0YUTk;}s^65ON!X*S%UqQyxlor~-fndV^P^
z!9+Vr`Fr%Gafq?}>B9B=D#9J9jhQ*@IjJKV04zX!y=ztvB0DRQ_E;KMAAN`29@G-q
z3{Xq<C6-4;%!Dc*ynWBLO_Ek2=Hvl@Jt{NIhjgd!Q?SE0Mx-kfakQRtJJjnDC>i8n
zF~=O5WIzlSjFY#4SCAdbSTW!oq|tI3u^NG}0H+w~ijV{V<y7(bRGeUAX(h3R?N9QU
zH_e}Q?@r{91a=1!vae0Xo#jFmK$2p2cJEe3NFYQNK_F5n0p%ECNbD)57b^t;+Yw_6
z_5EoHnVvke5Dq!$2en-huy!n<dm3Y-5}c^O7z3qR70QKJbXEJ^X~3`m2#}m`aaOh;
zEc}P3S`-XmFY#oWV^SD^`kdmXLVVBQ>rV<mC(B?x>SO~PL`Hg@wJnzxG!eXlQ}U?*
zZTR2}b*V&a@)C`TYh*D2O-ZU_N`OJ+9Q3B+47ejW^rw-S&&qmr%|xNI!DI7sX<XS8
z0Hs)xpy!H0r0vOUden-F6-k|QjsP8MObw?v=}1>0+P+94Y~Xb1QJm!b#Pd_P3NWLm
z6$#HcQTL4iAjvD0Jol$@xbW2(b^{sy8j)HOh<7%6P%92o%VY|Wd1F5<Mhfk5v5D=9
zkyQXW8RNO63<w2}7~+@Z{^;q}mv93jBaG59`7^+v1GYAvo|KqTpWZKCl);>R{{YIH
z&ze5>N=&4LY<a*ExXnqlY~U?8?bx8kGw)41vOYtKMJ5Y@x9SZ{0V*<0HFoahSEWio
z`AB*|*sJx&<4t@4{uF1}^q?^0ow%e)7#y5~j0$Tg{oWhDtxfXrftq0)k`cc5tq5t2
z1A+Ic!*&L6dG(~{XvjFDao7MALJ^J_aDNJfu_x}fJ&irL?&P;hZ#X|7rD357I8nwa
zN8Mf*ujNWW^3Te1ieV=oceg`QGS2o8fG}~=im0qNedov4iUrDi>v170-!UICthprT
zuXBo?;kc6>O=HOT2PAjz{{ZW+vwEMIBFf4H$M>t(CaeiQWvn3M%s)0hY}Lebf%6K6
zjbP1C{{S;`DrJ70_Vlcf_y-$*I<O=>^XpS%RB4C#f!sO@u#$b;<E><g2Xp*YFnp2M
zr>!P5Z6p2fob{>JOsM(m8DuyEar?DpBsd%o&ZG?@!#%oGWwVh`2l-Q<;WUM~>a?tD
z7Ft8|uP5(UO{GXgs-c1T1}l_C860&ZrEXZZ*%gB~P)F9HNc1rEY|m2D$QEOPoby}A
zPm-Ji^7CAtkmaL<Z}hIAS$0W-#{TuqRcLxjS1bZH6N;xM1mo|2tEt(5L%^!?43Kf2
zD}qN=G7S98ao71%7#to?Dk^M!DRKLi$|iSlQjLm1SQAJ`Jc^ix4#ynltuj&bN5@s>
zhRQ?){G^kPI#U<0-BLa{;Pj|-g@2|iCeE1bDPSCM+!~P(GmfK<^$KHm+#M?Hc*xEH
z^fatDD-Co&Q|04rIw--Ao`V#-cWzMCA}azhgX@l!Nf9Y%JZ;?Ensx@uet9#G%e^26
z*S$H&^A&P35}Oo6{{Wtt1M;g%z#+)!f~&6+%buI5c@p5O;ISb3(?XGLHk|YvQb+;v
zRFG6>kFTvphcgaG4Nhr4(q+kCx-s;m(2*M$+Uh~&FUoi)uhOK6z}z<sd({SJ26AOW
zT2}AP1>4AsVR=1hNYv6Yk_IH`)Zj@hT4Rm8W~ju&YyRwTwKzLsk(eKu2pH)~!$jHM
zSOz;l>FZUDkgdy(Kh=?sdU#;AF|d~o6d%X@DuEMCa|4^0zE&py4!-mx1;s29Q@bRO
z(ww`MI<YKys3Rq#X3RlUoaFPxIgFlMtQ6yD{3`5Z*<d*{C=u`ymQBJ)z;Bo9Q9{FX
z&Abd_y*Y{biErYf<c~QK$Uz@+qfi;t@yxvaDZmqNCnK6zk%gtt%GvYqKN<;gu#BI*
zkmWF^85I<(DTOd3{{UCWtt>{XYI21`atBk#_|<6CwZ+C+f`lwidIA1$DcF@GE@dek
zJRD>*V08L=)p-LLkonwg6{T~z?wom&03*N*bF@@&`Ct(uAyP;^@<00ZEZ#3d6>F5X
zALw^rkKx<H4_^FGjU!y2kpna&jEao3qGu7lA`^UwPeGmqJfHaYaV{BS!Ckc%EQ)>R
zHOLtZ0X3s+5ms_~C4gWv)sF(H$+e-r8;%N$eQIlFceS=$9up`0DG@D+0<lDF$(+;R
zLN8R{mM?)zmk%a(DDsKv+N|1c9&3%cBLhD4Ze=HAOiPAn(WEWA=YHA$01B$bl1Vm&
zFXm%+TCn0^q$?h$b7TykYJyny#Gmmx(et-)Rg-f8?~e6GaWQ6AHxK*Ra!KN{CkQ2c
z?kAjMrENNfyuiA(1j+z1953VTS=X@veJ<TcPG-*{A@X}*(y`GK4rXkhkY^nQW=$C@
zC&&*RgWk6qIX6s1N=`Y&Wy|Mpmk~HSPdK3#bCV&&nHU?rIjp(kUoaJj9IbB70hO|{
z6OO&Asf_OcMh`WjU~)GWitQ$2Bd<#3FZA#?Vi`_z$Q)Ou&1?vfy!IV%pjI@{CRhk0
zW3--nR*FMMkWU1QB%ngTVDngWKt;nA3O=5d>UXw5!~X6?JBc_I$X;0#k%)pu`qqj<
zYUdkq3YbY)Pu{Fat=X93)Z=$r?#;M3-2nsBHCB5<B9Q%^00WGiR<WpIC|uwqx56;;
z$JZ5)b#0VCxs3JgUA4`*^A01JeBDPPvnGK+A&y8Dx|xLO9&vYOa^Jg)uVLD`+p9)V
zD9&-58ufXt!HnYCEN7hetQ(t1%ScRdk{6CEqBU8=TMnN?%B8kBbFqo6*NQ;R@}9Nn
z7Z!suZMGt?ZmfVp+n=vYV!ESL@@wF`9Dh0MQlzu13{L+5onD&Uhj1e~-&7qONZ-0{
zJ*#BXJlR52-O;5L>uv#*50|JltqsyNasK@eIO|-V4tvvsI-VKF<5KCSb<oUeQ+n!l
zd)JIeKJ7>toxe45vE9tFCRGUA>CI@xc?o12&U4?2$<t`|XlAjK)!5z7$}>`o6(2Co
zW-Q|>GNe@gWMs#Q2;g)zn~CYe7a4Ugs8D%oe&yPFR(XGze(;}jPF5e@ezdG>8s+`V
zuzcy)6uXAgh9u*yQv{cPnw`J{_lGpBZyLy)7vuMo@X>zr<~i7KN$KxZ0}S;PxgXvg
zD6xLfutIqa`}f`UoZ&|saZ9)qT<19Jny<L*I3Jw=f>$FP_MknXZ3Vx~TJ^>cMH$UT
zcKNc9-!AHi{o%x&JJ1RA;}jIC6RE=e<HL8QcP%V=^70cIQH=ip_39IhjzuPUJf4&f
zoU<pFzCEVn9!lqaKKFcMx1}Poh#Qfe-jx>r0NnwWCp5x%{{UFDtT!@Dl1L-HCp>(;
z`_d`qJfRsU85H6r5&&Z&fqOyV;hR2`xn1LvQ8$<mE-3?LNcnpArDFY|K1Zz^zF~vL
zDgwj*0M$<CV`Cq4y%rB>Nx1XRdI1?fFzf43ZuX@I=IP#m_K2GxI^?z~82rbsGf<Y}
z@1C@wmjLAb-&!n8s-i=T9-S#T!Q^zPOr3ZgX@*6?IUj{SQx{z>q~*v~`Pc7ybg0aL
zXXo!!-c{Ky4@Bm(rn|!cu%Efq)u<db^9WPjn$IBlzj&Z}lUdSTMiyWgla38#yt6!~
zE^tn9Ou^oMQ}=5{Oz~^xa-NaUveQb$10WpKcyFJ-<3Lhz)~u=zL(;EAdF{$?R#(}_
z-0CU22R|{b0Dv&-_)|<{ao|$sAF?aPzr0=rX+#?%({)xw{p>?v<oZ^;F^#M8jNo8Y
zNt@Du_><&Z@8+!{b>sM|WKpq32Li1uY<B(8S-Blii5zjJ^*CzKjZXkXM;?^1#(rOy
zwO)=k%7dP@4o0zvMy<yHaaUtbLBnG-EN!)ZQPaI#jSg2Vde&{4#v_qNSEpLP8Zq1Q
zraqL|lZHD-Ty(7{Vv)9i8S7Y1M)8R(3I4ANGoMQ8Y%QIH1n$NMYNugro@9AIPDVW|
zxv;g!7(tDrl5hocPG;K{>@9zD2uns|fn7blyh{i&PFb)%Rr{mysI8JT5vt^XI^&aC
zu>=gH+o|WF=~)WoByhjGZ@a}g7uDD4Q!r+m?=fQh1sVM+!dtL%Wqr6mbakn0q!6xK
zXg#{ttRmhx$qR1oe~H(D^d8kq<P4!<Mfo}t{OVN63x#4p&QEHF%26gGbdrAXeN8iB
zf)4V2YH?w;03)cW<BX7`$P|9Gu2~YO-a2O=kf}=_Bw{GWIO)l$F%~ctxII|%YIu@7
zhLSfc<(;U#%}XgVvPC<_<ZMtnv-CetTD2OS#;OUz<27I{%#y}}0H7ei$O;GJQ>w<O
z$|Oc0{Kb8KwJdigiGo`&@?vKvt}~CNJsLvY2+w>}XgP1X4(gXIXXZvE;Ab=n#LCbt
z@fBy0_wkhAA76U5ssfVE#zt(M_Rp<H8YFudWt@%=VN!uM?uRVh2U9?U4Y`S#dvotn
z!R9=;&IWmA=sy}k78n^MZpUam)TUBe1Zf`tVL+riT%0^n%HdVri2yf2`Bcp$U?PVs
zNy{I4sKOsD{zfg_`h6+tk`eMj5Wwq2#Ndg6l*j;y$-y`Rr-+3tS^!(OwMMeCTLfL1
z-^-4t{{XF1E(|#=GJ9sJGdV<7WX4H+=YdWFGaCN&M;SS&!C=f(0@(D<DNr07;C$c3
zRdY8HPSXw+Kt}9mxur<XP7Y2x_Mu9bRajyGbt(=|xy@TtVE7xlXFjxCora<v$XVmy
z@CoZveBwj}Qy!S74ZA_ubDj=q>#&B(4cX(G3q(>E+L#<tWbGfh8OM5@hT48y5z`{8
z?KwM)hnh^<1Al?CtH|w17>!G2LzC-H!QY+BjC7=te&O6YR5N5N72Gi+8fy|1@JY=?
zHyM>dU^|?1Rse}({{UXO&oo@3A_-5JjP2>#lWT1lVbjvAghB}tsp6ZoXXTYo;Xqud
z$fb!n=}p+Bh9%lQm2Ae@1fI0q5Ps@VK4BF?hQ!an{x0<>3|Fb^(we*XXKLfxtghde
zBc9X|CPEc<jOVQ(0OuZ+Gwt2b<Qir(9|Q_unO_Z_{V70f@XgP9nF4QZ-e*6RJOBp^
z+NQ;G4Mgda-kwJ|!NxlZIQd7GI`tx~gkLCNr%u$GCzz}h6+bEIOd|`_)a}4Mb5Ndh
zmNX4Wk2wTj3S$=Io+;Z-3CSNdG=|(bIK>5AW?fj~Z0EI3j=K&+XB5DwbASQe+|v&5
z{i)b(l0NK#o(U9y0D845vj8*C9qGkEKtqh?kv9{9q=r2zGmLdTY5Z+G^Nwkl;N+gP
z3~1xI>qvPyE%eExC!X|t#zo`3NWduFlNrag6()P}MFP3<?a3ZwfJQ!`*Eu_%HGwCo
z{A+6I{#ia&&p}+>!5jLp!96SOG-u{)a=9)}{`sqj!)PJ9);clVPET6Cjg(AhttN_z
zq8MYpT6lkye8Z(u3^G2Rw7arD3eB4)XseB@^L}+GbC0|}_pN3IKBMrdQN~9Z=e;Wq
z=Ca6lFHGXCEQ4s|^{j<+>z{K|E8s6L*SD=hLrm9KJBL$Jh8+Fs%tmbEcNy(gRl0n~
zts;{&QNCgKx^}I5XTgj2mCvJaK7RG3Zy^OvSMsFMy(!tAoubU3N5f}tPg?9_Afe#(
z&MVBcdC0l7`MQB#jSHQzj4$07&2rU8vqF5xz17Fe!-{Jw2~R7GRIwl2$VeI6nopRX
zr@e5>Cv0R_ZWMgxm`i-UDa;9G&fIP_8Q`8f)@MXTJeB_ddzy+xK6oIEZS|`PxrzB5
zJDP>_y+<E=(z9&VBn3ePW~;ny^5mRn6@O^?vU}5IU-V(fKR>5xlGKVyFzR#bij*+k
z2J@WMWS#)W-J&%nbpHT<G|^1Fm{=U-WU%Mjq(U~gsWiz39y}hS)}DlO@`|H3xi;49
zM+8v8csp`Sa%sTg7r;GfPx_@Be~P8DksBz<8I$klj<k-%BOD$NN|fi%ZcYdvrB$5#
z^I&Co;8RRM9k+DA+uD{xy4;^LoM2Ub*te0h$4X#k+aEd4y-?B>^R@wl_|uqT^mEeP
zYAxBmZlm{f7CB-`BQzvgWf%)dJ;^z%21F|Y7j6MRjZs!paR>(^xWzQT`ee<t3`#&0
zID%!@E3|+cJ9|@3+$aT<k;w*<C;i%!3jYABJ!w!mQg@6N&*Mo2$rJ%;77F08z#VFI
z1X@d&&-#|n6&mpy4aYk$Fe%`<z#xp^6YWE0Y=KpXU=_jhG1HoIx9??5rz;@@{VG^w
zD?QAOZjM9n823FodR1^3Tukh%mdW6Ephb{SCNdArPeM)9Lvj136-*PEj`+aGQ%{OQ
zOR!eP2nX7WlHy;LlgxyN;6g#oIg0&?H4;8q^6Cc!4ukw^m~r-df)hOe9`!FK;v!0q
zQS_m*EJZ4*B<|$NkI(!n4UOdmG0bwf;C8FwcQW+AlP09hs*i^Q<iG-vqLGm_YPae_
zuvUW@1EH$O@SCfEWB`s22CiHgHUeaiuWE`olglbC;tunIOLqs}p|fbc2;_J?g$h?C
z>ixWEnmq58CyakurtKR&ykZMgNRh}fkG$u;d-_$`TW!9T2$nYg06<4}Usf48`ck<Q
zA!8|tK4r|T1~Jh={{R}&1Pgm~U7=P#-ZAb^rDnuS>IgwNRr!9EW%*dpNg!W4oOk~K
z^;3zQ(DHwF82O*Yw<P|RO^ldeBPT6Z%9A33?5ZCbV@T3kppVP3k(+7G{z>%5rD#er
z9yvVH!3oRq7PF-VZlwce1LT_4xO;|$Rqta#=Hw<o8TUQwA%Wh*5EHwC4-~9yic@af
z#1~w-JQ|>P`HnF$`FmEB!2uzkoum+^smjDfI0#1Q@j+&6i4a#fU!gTdT$p}aX9pd7
zR)Z<ra=GT9lXn0G#>%9JV<qD|Uo&Ur%~O^#RPDDx^7D^c*<?TlPEKk!R46gIPCDa?
zcM~~TZPa<hmL~^_$GOwmOSu7$01inN-X*+8%q7*c+=_yGc{Uufa=oZd!aSzyPDQ<4
zkTVc*S(jFG1skD|^Uw<QRJBIbw*8q0%y}ZK-PkAZN0bY5+O0^<$ng7{Sqn+JGJqcA
zn!vfX#E<)saywVC-syOTS7VT41Oh9Ky|j}JwgvzaI&`gLGPgX^NSJwmkU8mDvcv<n
zAzq%9+1*<0Gm^aS{OcY_T<*#!8Lo)bGnG4>RPd5#K3a2F(^-~TH%Gud4R@15rGl-u
zexkEww{6dpz&zH`nZ;6x=d;<zx?Dk?D-z<xi$73z9zd^3p4u>Su{rtcGHXUV^7yUc
zRN<+IPod@#+RCoqD)sGD3OIgKzk2jZts?WK9!$LtYQ?#-0Ft)Z;~Wa;jZ@64gY0re
zNIeB6Is4VMEvqj4pzFY@jRO$BxFhRZDcs_f28wGW;EY^J$GuyQ>A+pcdi50xMnkaL
z^%+Cx)LAf$=M9;&9o#2wWdojutqGNtHn8d1xsndvhphm}3gSscOM*J#m{gAER<9^u
z^@LM|gt*JKb1QRnHiI(}?^crV;BJ8D9jYBOt{Ix^q0sIa98<$_pL)Yv$VptYj%vWT
zh`$#p)1fsE4DF|w#q~8yj4l}a(gx}K&ecFmmHWzhr>p$q=27_6xSOnMeN6>?78%Zc
zX~EAt9AnnA#Dj6euS$?O$UBEmr4~1iDR(UwIXsMJo(~z^af+lIWc<UeNUm^4wJR2}
zE4gcuqoAj!mM}{xJGcxus-9uoqbEDM3PUH(eq+<UD-YZGmmS%q&z}~4yb5V%48OfY
z&tp`>uJQBtr7|wwSoQRx!S#jQx4$k)Bz)A?KQ{}H#;S+paxp-ad%E@OPQmq++_sKZ
zU`%lz_l9v!d2=B-PETsiX;*3akKU+^@Z^5^PZTJb%NrHc)7%C*9cir~1a+*YxsL<}
zZ0@KU=0e{rdFV1}`!-=b&I_rq(hQ80`_&6i7z{kXIOeh1Tapj&KMIJ4EOR6Et5nV^
znWUb`(vt2l-|F1++Nn!(D>Gwy{N0U3v-gSf9Ac(emj@}><BFvejvAP%wK|aQkna8D
zoSJ6VEy+D<;EelJsSwKLAEz8sy^MJrw<)A-S@VqMtgL)sCqd0ySpH?iWAApW2^i;|
z{VH6IV??B=Hi5LCY*nN|j)N!Ktcd=2@##~?6K@|N6)r~6rd0{Z{ofevLq;}#t36M8
z(h=fNe6de4h9GUhspd6MG8GQ=8%Hf#@GmR!j-XPA4(0g|Pr|O-MnP}gfz3puX&4qF
ziE;OTI=qn{KXz(JP=4(3S_q6m;B~B=jpG8UMt2TRPL*~z`5E2Pr&#b85RQA*lux)e
z_7$6vv|uq40eC$s(kk(kCyex|6#xstJXNHO?Hmui-m`Kwj0anwC+?hPx*IqPZ224T
zs&=r-Sw2oOJ6CC@+Dgd=B0w?xTnfTcHc_!XjiL`DcHzL_44UjMZO@evWn^8W3Ob*y
zEtEEK$HlLh`*FR;%0Jx|s(|2S+pncy*taH(Mj?-Fkq2jUlTw6yw&|4yGmfqKRBA|W
z4K7^21e1>5l^~I3HdWjsLJr<s{p0xdsT6>`sLt<Ntf2XP%szl|R-#}CK1v)8ty3dJ
ziP0UDVl^K(EZqf5n8K9~al4;W{{Ysgvm-hUt=E7m%EY*lOiW)Ro!kNMS+bEdO%B`$
zqa6BjYQhI#NJhpn(}7S%k*&|)-+|PO55ljYVgcQNJ*iw75~8fgOltT)cePHAOrUux
zJuo_bDe8kRcdk9fJrR7-g*e;>eLd*74j`2vdF1yZl>uGfA?ig<gc3H{B_lm?fN2|l
z$@Aor08z~=4F(Q!3uK%My%c2(Ea5jEi<%&eLeA4zlOfts4{uD=&9e`=UwP|;!1nwp
z1;KXtp!~%7ndhLZJGRJ$T{1^fJ5?<F-~h+z)YY|8BSPrGif|8F0>ZfhP2VXcKLJvR
z%ETC?MaprW)W8uuqDEVAJoc#+yBGV!<Q$p?hNqa)0kn1L>F-tp60xF?09+G}rinxf
zh!S$dsNCJN=suMYV5%@A-TF|F_a`d~>>hY#-N_vXwE(}(h}WLvbf!fc7Y_F*7p?)z
zA8$&O<gvg3b4?P_EMy4?1&b8xnwJC3k$%uvjFvdyRd8e40;J=fx$8~>;ZjYaMNPRm
z?^I^uSd5~~en~NoduQqIQ?WVY%>#}J=kcn6<z!L1HOF&LK--*)tnzrKkq#x;+!g@G
z^ffjH<>Q{%swhvGgUVt_<o2sT;OBE^JxvU06B6NxW<5VDft>#Ua34xj<`CY1a%sQE
zg+hG|LuRl;OD^NV>C%N)C68}&QYsHIi$RmlNe7CMg&^USel-o7A~BF~AyRSbDA>D+
zD8y~gTA5<xA2frXN<-!e8yM-*fVlFptP8b<2<&P+D1W<;#+V(poWsa-+N2F0)ZD+7
zJBq_jcN4ha4@zq*6=S&tOSO)0yifq{$L{*o2&z6=LEKN$q%FomMm>S%l!W=X$Jf19
zVE$<#z|XA%waNE`l4OsQ>p*qdM)j)1wn!`dJ!z^4576^LT&1Jc@>`#3UCa~^Nf@XB
zY%k8<ooV5Ydt>QHELm1kihQ@{r!^wU!2t>Ps*1#&p*YP<3iQ~1w25e+<v7aq6wjA)
zW+wb82M0MHdyXl0e8&Z7B#(ml3P7g-ps>Ir-jtpR1#_O%&!1`e>D*&oPSyZpp0t}E
zXwJ@^smkYR$S0ppX?K8~RFAC)F35J_N!(909!~L&D#7Gu0|uaQpqyhEp`oTXb_w8Q
z)PQAjS$b7*fWY~j)0DR6JbfxgPl3lMIi%V!esPjbDl|oh%Gt-IJm7Zc98gW{Myf$O
zh&*@gML#D8gGB*z<U5H288YYY<kke_@8>;zYf?rSljd%<jXC|}a(HiA`$VjMZpe_6
zC#79RJ6GoYYdr|uc<t*}knz+|(4xzMxckSgJU1VBRXmNqd%ZXwM^DbPaW+i48~vfu
zrB>sodZGv{es0w=vB>$_rJ>xq4{*k;D*~hGR29Be<o)WIN#l{$m5NN!Ryba2$~PTr
zF<alYSw`S<Qqf78io<Z`uR`Mp1NZM)2*Yap!|v6%-0{|>qe!#2(%dZ8gt`9!SS!-4
zWX-j)^A!H*SB=@sL&b^v4hgS8(ym>tV$H*Gfr`eWx$5C&wma~D&|>+zpry&!-|h;d
z1dPzd@~_<;D(=EOuvlcaYmRU|2uNqm@79fjaOCu<+h~hCXCPEZJ4e#E=B#zXS0jJ8
zpl3KW7#W{AJplYFL)G(-y-^&4_rFTXoe>;PWLyR5QMn=}>G!EgIBXO3rZ(nf8&{~Q
zxuQf{OG-ZP-m4L)1^!WzYE(tb5>IZGF45-31YgBeiEM$_Gekaa5`Yf;bJwj*>P5-_
z0C%UoAlr`JD!LM$q@!=xzWS5qew5JJSN-7o;-F=9v;fF5WXZw)8X_Qe6(y6gZ<~&b
z#Z`03CkH03e(wODgdEi_SqcI<IH4dY%fBN8Z7)G2FkRgitVjpj;zCe>!#Jp1N9Wyb
zSH{nlsSU7FPnt;_B{1j9A1Uj{H00vKeg`X>h?WLU2*h|FQ&y2TB~}S+?X>5SP=fox
zIpwqX(y(SrVYqVUf)CpxUFns6angn>mlUyN8R(T_GxA`m<Z=CKq-B28$2|`<aI%~P
zh>g9^QcX)mCP*=p$)}e2LELyIp(hG5F~=0wWdb4QFFopZ8zn>YrhkfXe<~(+^VLB-
zp7g8D%KW1NNAl}VZXlh!xXT0pW{`?)%rXvoeze`}u-d40$wT?}rm@?17tfHy1L>1d
zwp&zAMg)WoeJL7pm(=CBl!N7r;;aT3Y@!^tYb+DgvB{9t^f`ff=Vb;`iFO?MEJUX{
z;-q&#vlblrOUJG%D4sR9+CpT<*EL>tCPw9X>r8}*WL@^_h)5#f9-L#+mUfy+8*0L=
z$f^SIwMTqZ#e&+(!3q7*z#ZGQK+5ZH9{A8n<ov@Os#&Z^Wg$}4JjB|p2SK056iDh)
zXWUL?SjXkbs!Yt&!asI1CI`}{QX1tHHb9*4J5*e^68sog=3yVqW5WG<ewATImu(J9
zmmuJEBmV%eOhC&%26Biw^fdUxA2vqoziO5|eQRi~4rx6@=GdgV<S#%foXl3?3eOlm
zUuv|#h$UhH&tiL2I6_s+z_`HAmJc6FqzRbP?rV7@ep_>3WYtc7$mh)fbIBE_a`~EI
z&uVsqw_*j)<yop*WzImsPUoc~WXfBVT*Z{i`J9ky38YgY%tHX4hNgD{?%iXCED1T>
zxy@IVV^))NZZO}(IVb5sX%Rn=K_WY~`8gZ7&*V6&GOV6j;nRcCtQH<|$r#51qmyw1
z<?ltyQ7GW;Z1K-}XC_bx;8mAbB`}AjF=8t*CMRwV6jE$_pa&_0AYgMy$@|9zfvG-X
znDUr<U{Y;9S^ejKN>?Y8hB(*l4~?1f$)qa@g}>1<dC3Qwy=sW8?obkPIi)*B;IIz8
zg*42i4Nh+2(gs7iSL73e(z$I$!JNnz-XOaVHRv)#xRHoranh(sZtof0fC$A>WUUVt
zzp&WLvfP#|dWz(3Z6q@}k^nH|9M`*FTSMerD%*m^h7LMc4X9XS%q-D$InVgkibji5
z%I1WDI;FTg9@URDBg`bY>&P85UWIXQ%PL!dM^lRDr?e|HtjG^Nt9Z<rLgybWYli|M
zj@hi)A?8BCdiE97&l3{CVO(dhtl3~*OBU-}#%C=`M=3ljkM&E*#%nTLRN8Vm>Nu{(
zNYuo@Ml-vuXH5nbNej(y8Ju+~96a`<l1eTBHJ3aNV;~}c8?ASeKwJJ<r``1JS<_oC
z#~xYxy>Z^PjLtfgP95OFsboER(@nCN$y626&1y!`wR&?^gl>l_6X}fBs-ep&3$e_#
zvCDj&>a)OhoPpN60+Bv4k%C8IP)Te<C+^7yrYh9TC5J~KZQCc2P?(=D*QIr@Z-rtb
zUV9$3RpI$R)&7-S<}$+^xmL&BJ!r#xzk0V?-Ae#CIqyvSDsLlaKU%JIW$YP}reV7h
zNILhY32sOHyh+lu3>bWQZTH0^Lx|t^d{J~Y2`;5!J=P=Uq!%-WKe|uGo#h>?!RzTk
zi{@Y5o|I@(l-E`_?K5v*+^62`YEg3he2vzl@|%JXccc-VspgfC{iROiqT#&Ejl-YD
zo%WXBovrt}nt;ZBd}pB~Q+79_bf;uLZBw~9x_>os2*&SPV_eU;kfW_fwDIyN;+o1s
zeba&{vJ<USxi6n^NXz5p?MvoLN&V^RO+_AGzB*K!a*Oi!6s&`uZ>XO!kC~r6>7g3~
ztxJxW%~?P(9%IP$G_Ew8DylZ&)2&RXG6qN9Ju28$JFtSKL>b1>(9&`=jWVZ{cZ0<|
zN6P$ztzYu^Kf9-_XKQdVnx11-NTKEQ%tNh6v77_6@NrkxA-e<)hMuwf&M@C}_N3%!
zsg%|tWa`+*N|hqzv!A<HQYIKUsn#KboMf7pBSiv;j0}yeYIKX`Y$H|Wjc}hR=~IZu
zA1CnoRC5|A6jD3{`B<FQwU4GFJes-XrpWjmJt|d<m*{``)h<Sg1z`x|k<z3{NXfzL
z>DsS|zV99C!l1zUe~P8ZwE}>M;9xJ(oUpKNy-jMYXCHBTRNhy}epTyPxf&=H;8TRo
zIBL>G7#xbKibJkgV|8dnf={=4i8E-xl~mw-y{f_|%)cq==~Bj@AmH??k;X>Tv{q7)
zykJI=l78suD^lLwn8)`(-BMe?##H^=oSN!vtdGcifz#5ml#MxTHpb02L$)mZqa=>?
z*x1{Upt;XX3{qO#ZH_#Mz}xBlD{c@t+aGGpvR<Un#sq8YfmVVsDytlfPe7p4P$qKH
z{sOL}Oki;oNg4r{a@?O_f5NkDT%>+PiwQFPhxk)JG5o3^4%SsjfY0Oj)UI5(`PlK)
zngX`&6qAlgq*_)8l0Co|B$Ls20<Ole<Y&wapSq_f@ikdMRtM*1JpepbyfK*4+2t1I
zL(0V65PF~RsACo++ZulFXgq*NIH`s?<aPY%tj^LgGOH5ZYDj`_B!W&j=ZaPV>VT$L
z{{R;N4z*@Jt(M>p1vB`%ifd#rA<lYnQo`3Rs6rQ?%B+<J$w!_5R?gI1erBoL5M}w^
zK)bnMKb2l*Le3Q(R4E@fQ}0O*#AHc@`8p1sm3j~%i_Cj?Jko<=^~brWVG*J`NgFZU
z@+t52rDiX2mUIBOrvic4ae1D350x{>-{&;!BESLO&R>(B2e;Ow42y3nMH7O{hLD~}
z^b{bCVt<fsBLJS%hDjFGf;PkNJqhjfrxPHNSb#|!6Hq%o;CLr@O0c3&EVQAA7*ziN
zA8H1W^(@12SH|!OBduCp?y#z%#?$w4{OX`A@*<a$9^$Skh+$SkfI6P^hR})-$TFGs
zpzZrlRVO_Zew83n!z$yiG`l3;!55R%`if!{q<M>PEJjYzz^C8_Qa~dZr)>)e;!NY7
zIjOw4e3WBugFOa8Kdn+Bv8te}9H0S*1W}eGW=Gl%G6r)>$iOG>CBa@!Kb1^}<csA^
zp)dw2kt~DB+*5CuK5Cs%s}bce<I<)9zET9E<m@q4k+T@wpkX)^HbZ1egUZMx@tT)o
z7!x4?+t<0KbMhZB0l4I2sHs$kL>N$`jw%}(A;T96812nmjurBEEYWd{f_bUZHB>vS
zWyX5v`qXW+B&=i)ey8hDQe#LyRDcjT=Zb_y$R*p_o=X`M4N{&EXLrz2Eiwbssn4w;
zCj*|{>A?wO!vVUS$^cW6MtjmJG6q=~f=3t}p46f=3O{+s=B3XK&up4w9IJBFCRN1w
zfNVbpsHW$Wz^3K5o(STRw{H9@kPU67M&p`mC@ab_`A>QneBk8gAC)yDVkII-_&GIT
zB7(kVW6o+ar*I$~Zsw*0@CvuzrnW(BVu9R=lL?*5Iq6LS&VE+KIk%8b?t`UB8GNyl
zDHNF0Bpw-sIJeKi?M!pi?se-x&t>gJgiNdooW4F@X`8=z-#---AD@sw`qE``F}FCP
z!D4*jl=+AAsRMkYE;`j<P>;O4Q^!3IerP42b_C-CuTf3F1$pmJD}>~)T8o|Ra-*6o
zD~=5ybC3wfN_g5=ml-G4p$u|zMmKh$i0TQ(I?#Y?Cq28<PDk+PBfU9YSm2TOv7FKn
zL$Uc!9SNkygyan4o;p;KzbqZ!*wO)(P7h8+ImCWIB1JhLh@?A`v*3}rjTKyOP%=8L
z6bSh7i09@VD<<RbzXz7$uCsmbo2abolk>;OueP!IlaU&I<JYZQQ`4W}s)_fy9+hAd
zv~k*t4lI8gPfBnnjz{58<+3<#wD3mWz3MD#nJ_(n-R)B=9ix@|)l@efX~6vFttN+Z
z@{kD2FIt&flT<<Feq++7R_7nip`w#6so?!;!nZ3_6#I&uPY6NnQqf78XxuN&R?&$5
zA=0vAW06-C*JwHZ8kUPp+qaN;k$lJw;mEGzMYtbnRREl*&&|gl;a+bWa&q1CT^5})
zEzP#sF~|qrp`)`8J2TlVWy8cfkO)1iZCteA?_MLtahhbL$7W2xorAq~cHFy@$9`)W
zQ_%IJBHI?+qaEqQFty1m*NR~y?H<FuE3-1jHVi6uuR5d-+H8oCwB&ZETRH2K-k!j2
zW4W=KZy5W-t#e5oagYE?k<Z<!Q9e>U!O5a93b!LU=~h)h#|N!NjX8u>Zh1@qDpXhV
zxIs=B*xU+GNLM5Kw5}qwp^e1H+*1dZWI^V>K<SFHgR#ju&$UIdg0TpC9@S}xQc%2P
zsrf+b?NMQNOhTvLJ*j!xcyG#_=l5|SMIR<l6cmVwakOM}P%c*L?Bsppihn+ApFcs2
zP{FWBQ_A{N7{v?ZOj$?Qq0K|I`D77>8LL}=<J|#0GI;Mu;C;1DKY#;Ma&A!|V;DTA
zI5l1O{{W;7&CH^-Hvazn?D>4MLG-EtTh5T~1bwJr`wG%5On=NJUy;5`e@>a;ezYhp
zZ7cb0xMPvrQjsPu@Bsz$oYUix1(fTB1gRXZMN=Z<0V2`P(UL_?5pAk+{X11t=6M*v
zIFRzAw`#o*A7hWP$LUccNRs50=Le3p6EE)&jpSr<eQ9~xzk88DIJi(p1dIdiP-u&4
z>9mc<K3Jt}ZBSW>Jo0LgbN0D7UJhzV*_!QGliX04nl3uU<pN=hZG@bW`C_xmFjr;)
zNJHD#t!OEYrBGx%bNN+UsS#mwfJ-6TGwa5G3M4qTK${K78-@aMYIxakxHDil&T6V|
z7Lt+<8-QudTkJ|X&ivp~Ly|A<Qz62r0DiRZlv~WjNy))E=}^K5w?aqo_o(KPcQ62)
z#s^-)n`ER+9}t1l=FV!Ava=cR#O6XX+|-h8FvdbJ`o2juN+Fqw?jthsx}r?hF-4>?
ztP?TXK!~XKV^ctiv&4AavnL*>x8dHRj~{4x2u~^~P6w;wjy|<&5%LCU21|amDP5CM
z*tMKVh2)mWH1!+SLU#p7$vEgwYJhJt9LdQ80Cp8+a&5vc04zDrYTV?Iii+~4MBzvG
zM<jk#4aU;~s;r?z#Eklyw#I)n#Iqc<KzyVC2iBmu5hj@u38N<kn`r0Tp7au)ra1FV
zcPK2EcbY?BWZ-+%K`X;BkuY0004OAVLE^Pz4s1{F)d3`&9C2ClukP-Mjc^Ybpx!LX
z0#j_L_SWHk&|d^|l6vN=I4^R{+Iuu%$iQyDjcL9MI~5=5@V?bgY^x?d(gE3>qKlg%
zsEC<>j?<n%Q_00sVELbNpv0tSwnbh(XWAW$KioWuf<o{16=#sD#>11IO)Huro9-S+
z-PRCzsQKy?XB}%sWnV1_jX)g_WAv)d7h(XX?{&>fDG&}5J@R_e<1vg8lH-a~jm?58
z)r=*zn_cpJttb?(4?<P9Ce|V6sKg|k)pER*SXgoQj}^DJ(QaoA=E;O$okEI@g9y_W
zHhXsQyCk3GOy{|T>&p#}#~pFSQ<)zeuU_5jW>S3O0SD&j7XqtDk_3>kiyuyD+-Es7
zT(;O3C3(oKJF7Kv<ipVNF<pejZWy<6N_G`V(U>+o#XEX|RG3)vi@iESxUGQ;yQu(v
zmCash@hETJvE!ycm3q9kr1_y|osLddy<$&i8wbo%<P(FAD@e$e&lSD3aN}%6LC;ZK
z{O~BrZO4ON%c<$STxBCHJ1DLa?!r*gW){G6irO<1vp7aTQNV;_J!+%E51G3slU*dx
zxFmUPfhGtdsYwtS$WkkK$ii?rw~GwHKqD1ONDkrqjQ$nUG-G+f1Nc>EjP$`A`c|q(
zG@x>`Tdqc89^6)J*2{)IOALEgWh^V@H!4nRK1gyHc}E!Ltx25Hrg4%&eDAoxVx1oF
zKx9(6u8L>|QE|molH3gZrx@>AshrZLX0$Q5B}(+^j%t*UuKa9pM@}nDt1QEY6(~`;
zH$+I!QC6g8;$XeD03tAQwNay7ozbx8t#xk<WgBke-`=T77}!;<`(q$<r_M`(&-r76
z<%9TBOgY{1{VQk4a9?SU81$wrZMlJrQ@K2bBSZIw&@rCW-zVhY4z<7KN4(}K56j+~
zV*TL)6dd|f<`=Ut3_l}$hd9MU<s7%}&OPgWp*x%y&t7UX7IFr9cNB9H=_3e7j=AgU
zO=#2;g*|)L=a86Rym;e^h{6N^0IH|VFJxr-FO%{p`Fm3&gn{>lG0kqY8HES~IHoit
zD&<Gr^rM_!#Kev<$345%ffonmZk2IjP59gVb!<etRAV1n9ETc4QpC9*CvFW$B5poj
zD^to*A<7SGkVZ16$~3vlRFRqGoG%U1q(p440Vg%4A|a5NhCOO%<54=FAu;bs$k9Ni
zk;%1wRmaw*RU7(utEB;zj@)zUPY|)r41F_G%vyn2BVRGGx1~-ZZKr|OrdZC-o%>aU
zSHb#Jxf&>yL?`9SoK))y?ik0^)ukMAr>$5-Qp<vRdQ`a<qEZnbn<08sf<8ye-90Ns
zQ|34W?$n-G{_6Cp<~2|#Bu8@mwQXV>mxI=)RQ~{ARg^=wr}0v`N(FU|bN5eP)n#KF
zN%F_tt0^A?2s(~&Q;3gt1XgZFiUm}R{JlQyP34S{-!*X~`Bw{51Q`36{&ky?qKTT&
z0+|7`p48~omUH{QGg}E5+PRIoQ~u6>x%A?*b2f|!t-&sXXL{eYw`MDty2;0_QM7_j
zwJ+|^-tS$;n{J*=B&f+eR#KIXR7A3~JEK2m{X5rNYi@!h$papOrMH0uR^wnK4x+SU
zj0Qg`0<z{4R~WIb6AF9Osv9E<+;A#o10$39RKOen69d>%Y!pO|Q_M~8C;O^-srP+A
z$4ZQ^Ob&5Q`LF<tl6|UfK2gQJHjX;tjOEosu_S>;#tb)04oC!n&MH7qM#4L6J7X@*
zllXd53l<|QZFG(0MI@wu8R0$g>r*VdrI56YOEykVdZqxu<T1~BmLNmONWy{F*V?2k
zX)7kt&UnYtr;Op0;GSx{cqSY`!EwfF+MENBohTD6B24?XBxe!ilE7enPAX!k5jOyH
zk&t-ErX+9nSXsg-B$Wj6-uR%Y+_-G<fl9(dH$R_)8kG`c0ywP*C1qA7I2_~U-nmu$
zIvS)=dKr#SrAg2tfZZ@^ENg3)ndEzxc9D4}@E(+;v6?&~IXndwT~0_CIjf13Nbw?W
z`s9zTCWm5mRal1RkiOx-=qgr69zililZ+@o&Y=#)7Z4!FwOEH{)?xu8pglht2(aP`
z7|y_7VC&F*1w*=Xam!3eZl<lF+}K-f#0;~Mz^OvS8ZeSVSV(t1GNbAAplOVaPnH6!
zJf+Cn=}y?<QRXiI@&U*4sr<qv^5D0OWk7i`^D*`I{3-GXgV`dRg5&SI_diNj9mPUg
zTnP63fCL8|dexD&R{}ywJ&i$xSx~FH6ZeV!m1-qY(lZ`+aHstCpq5J>0!UgIPGi6W
zvGu2@Eax)Gw;ifPjh(<40~yUt<*$}NEwo93!@2aPV%cA8%^u$}A_E<{9G|5;MxroE
z;ke^9E)*&I!=5or<jK*`9OkJo6wfB|3~PV}Fep5QEI>Hvnqw667ci+f<BEDIGmNWe
zZg6{2Y%EC<XJbC_ySM_aGDYPs8L@-Xlmq2NH)G_e&h72<0yEI{sAEK{HORHu_M44>
z@CoLSeAxNaeBJ6IcqFODI28EeoycJW?b?3nscfqQ^6{$0CmrfkL;Os+#z!?UI}j<f
zlN)$A=9t(gh?_ac%}u~@Z;^pfnyzw4`TA0mfrbr|diVTj`9l+vO%#yAzcAo|wxe&p
z2Gi51shP5b1t5Xmn06Rf_hUGqWNZf2{pd9l5x4IjyH0HGa1ed&xu}K&skk3{qK2yQ
z#L7=SjXQGx0J1rt=ge)Pk2K#Ya!D=z6-Z(nAK}Lx%_9Z!(*)*+AV(e-J+Nvq<_0Hc
ze)KS~t&ARfb*M(&&4~_bM#oa8r9k+`S3L(x5*imLBoHVC*C))#&p}L5-cib&gGfo_
zsqNfVSY)NQCPQcCsD5uSa(Og`foSl~7!i@!ijbK11LiMEU^!IeA8M4i*?`zJ60ti1
zgVK<&-bTZm(y<aH$id4uT8!Y%0AY+$XPg|+!x-g$?IKAqKf1W~s7`#x<b|k&r_I5U
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%0DOKpqS0Wvm>(AhsZs&$
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

literal 0
HcmV?d00001

diff --git a/Tests/test_file_mpo.py b/Tests/test_file_mpo.py
index a5018870058..39b9c60b756 100644
--- a/Tests/test_file_mpo.py
+++ b/Tests/test_file_mpo.py
@@ -226,6 +226,11 @@ def test_eoferror() -> None:
         im.seek(n_frames - 1)
 
 
+def test_ultra_hdr() -> None:
+    with Image.open("Tests/images/ultrahdr.jpg") as im:
+        assert im.format == "JPEG"
+
+
 @pytest.mark.parametrize("test_file", test_files)
 def test_image_grab(test_file: str) -> None:
     with Image.open(test_file) as im:
diff --git a/src/PIL/JpegImagePlugin.py b/src/PIL/JpegImagePlugin.py
index 7a3c99b6c30..10940179a12 100644
--- a/src/PIL/JpegImagePlugin.py
+++ b/src/PIL/JpegImagePlugin.py
@@ -843,6 +843,10 @@ def jpeg_factory(fp=None, filename=None):
     try:
         mpheader = im._getmp()
         if mpheader[45057] > 1:
+            for segment, content in im.applist:
+                if segment == "APP1" and b' hdrgm:Version="' in content:
+                    # Ultra HDR images are not yet supported
+                    return im
             # It's actually an MPO
             from .MpoImagePlugin import MpoImageFile
 

From e9b15f8091431de34d1a5f82cc0cf954d2cf2d6c Mon Sep 17 00:00:00 2001
From: Andrew Murray <radarhere@users.noreply.github.com>
Date: Tue, 14 May 2024 10:09:44 +1000
Subject: [PATCH 0623/1178] Updated harfbuzz to 8.5.0

---
 .github/workflows/wheels-dependencies.sh | 2 +-
 winbuild/build_prepare.py                | 2 +-
 2 files changed, 2 insertions(+), 2 deletions(-)

diff --git a/.github/workflows/wheels-dependencies.sh b/.github/workflows/wheels-dependencies.sh
index 0d45d5a209d..c5b279a339d 100755
--- a/.github/workflows/wheels-dependencies.sh
+++ b/.github/workflows/wheels-dependencies.sh
@@ -16,7 +16,7 @@ ARCHIVE_SDIR=pillow-depends-main
 
 # Package versions for fresh source builds
 FREETYPE_VERSION=2.13.2
-HARFBUZZ_VERSION=8.4.0
+HARFBUZZ_VERSION=8.5.0
 LIBPNG_VERSION=1.6.43
 JPEGTURBO_VERSION=3.0.2
 OPENJPEG_VERSION=2.5.2
diff --git a/winbuild/build_prepare.py b/winbuild/build_prepare.py
index 0d6da77549f..b654ee8da97 100644
--- a/winbuild/build_prepare.py
+++ b/winbuild/build_prepare.py
@@ -113,7 +113,7 @@ def cmd_msbuild(
     "BROTLI": "1.1.0",
     "FREETYPE": "2.13.2",
     "FRIBIDI": "1.0.13",
-    "HARFBUZZ": "8.4.0",
+    "HARFBUZZ": "8.5.0",
     "JPEGTURBO": "3.0.2",
     "LCMS2": "2.16",
     "LIBPNG": "1.6.43",

From e419fd7ab4a71bc269a9c624c92d8955b372aaed Mon Sep 17 00:00:00 2001
From: Andrew Murray <radarhere@users.noreply.github.com>
Date: Wed, 15 May 2024 20:19:09 +1000
Subject: [PATCH 0624/1178] Added type hints

---
 src/PIL/DdsImagePlugin.py  |  2 +-
 src/PIL/EpsImagePlugin.py  |  4 +--
 src/PIL/FtexImagePlugin.py |  2 +-
 src/PIL/IcoImagePlugin.py  |  2 +-
 src/PIL/ImageFile.py       |  4 +--
 src/PIL/JpegImagePlugin.py |  2 +-
 src/PIL/MpoImagePlugin.py  |  2 +-
 src/PIL/PngImagePlugin.py  | 74 +++++++++++++++++++++-----------------
 src/PIL/WebPImagePlugin.py |  2 +-
 src/PIL/XpmImagePlugin.py  |  7 ++--
 src/PIL/features.py        | 27 +++++++-------
 11 files changed, 65 insertions(+), 63 deletions(-)

diff --git a/src/PIL/DdsImagePlugin.py b/src/PIL/DdsImagePlugin.py
index b2ddbe44fdc..1575f2d88b6 100644
--- a/src/PIL/DdsImagePlugin.py
+++ b/src/PIL/DdsImagePlugin.py
@@ -472,7 +472,7 @@ def _open(self) -> None:
         else:
             self.tile = [ImageFile._Tile("raw", extents, 0, rawmode or self.mode)]
 
-    def load_seek(self, pos):
+    def load_seek(self, pos: int) -> None:
         pass
 
 
diff --git a/src/PIL/EpsImagePlugin.py b/src/PIL/EpsImagePlugin.py
index b57daca56d4..5a44baa491e 100644
--- a/src/PIL/EpsImagePlugin.py
+++ b/src/PIL/EpsImagePlugin.py
@@ -42,7 +42,7 @@
 gs_windows_binary = None
 
 
-def has_ghostscript():
+def has_ghostscript() -> bool:
     global gs_binary, gs_windows_binary
     if gs_binary is None:
         if sys.platform.startswith("win"):
@@ -404,7 +404,7 @@ def load(self, scale=1, transparency=False):
             self.tile = []
         return Image.Image.load(self)
 
-    def load_seek(self, pos):
+    def load_seek(self, pos: int) -> None:
         # we can't incrementally load, so force ImageFile.parser to
         # use our custom load method by defining this method.
         pass
diff --git a/src/PIL/FtexImagePlugin.py b/src/PIL/FtexImagePlugin.py
index 7fcf8137684..5acbb4912f7 100644
--- a/src/PIL/FtexImagePlugin.py
+++ b/src/PIL/FtexImagePlugin.py
@@ -103,7 +103,7 @@ def _open(self) -> None:
         self.fp.close()
         self.fp = BytesIO(data)
 
-    def load_seek(self, pos):
+    def load_seek(self, pos: int) -> None:
         pass
 
 
diff --git a/src/PIL/IcoImagePlugin.py b/src/PIL/IcoImagePlugin.py
index eacffbae645..cea093f9c6c 100644
--- a/src/PIL/IcoImagePlugin.py
+++ b/src/PIL/IcoImagePlugin.py
@@ -341,7 +341,7 @@ def load(self):
 
             self.size = im.size
 
-    def load_seek(self, pos):
+    def load_seek(self, pos: int) -> None:
         # Flag the ImageFile.Parser so that it
         # just does all the decode at the end.
         pass
diff --git a/src/PIL/ImageFile.py b/src/PIL/ImageFile.py
index b93e2ad2ce6..33467fc4fbe 100644
--- a/src/PIL/ImageFile.py
+++ b/src/PIL/ImageFile.py
@@ -324,11 +324,11 @@ def load_end(self) -> None:
         pass
 
     # may be defined for contained formats
-    # def load_seek(self, pos):
+    # def load_seek(self, pos: int) -> None:
     #     pass
 
     # may be defined for blocked formats (e.g. PNG)
-    # def load_read(self, read_bytes):
+    # def load_read(self, read_bytes: int) -> bytes:
     #     pass
 
     def _seek_check(self, frame):
diff --git a/src/PIL/JpegImagePlugin.py b/src/PIL/JpegImagePlugin.py
index 7a3c99b6c30..909911dfe37 100644
--- a/src/PIL/JpegImagePlugin.py
+++ b/src/PIL/JpegImagePlugin.py
@@ -408,7 +408,7 @@ def _open(self):
                 msg = "no marker found"
                 raise SyntaxError(msg)
 
-    def load_read(self, read_bytes):
+    def load_read(self, read_bytes: int) -> bytes:
         """
         internal: read more image data
         For premature EOF and LOAD_TRUNCATED_IMAGES adds EOI marker
diff --git a/src/PIL/MpoImagePlugin.py b/src/PIL/MpoImagePlugin.py
index eba35fb4d8d..766e1290ced 100644
--- a/src/PIL/MpoImagePlugin.py
+++ b/src/PIL/MpoImagePlugin.py
@@ -124,7 +124,7 @@ def _after_jpeg_open(self, mpheader=None):
         # for now we can only handle reading and individual frame extraction
         self.readonly = 1
 
-    def load_seek(self, pos):
+    def load_seek(self, pos: int) -> None:
         self._fp.seek(pos)
 
     def seek(self, frame: int) -> None:
diff --git a/src/PIL/PngImagePlugin.py b/src/PIL/PngImagePlugin.py
index 76e0abc317f..c74cbccf1bf 100644
--- a/src/PIL/PngImagePlugin.py
+++ b/src/PIL/PngImagePlugin.py
@@ -39,6 +39,7 @@
 import warnings
 import zlib
 from enum import IntEnum
+from typing import IO
 
 from . import Image, ImageChops, ImageFile, ImagePalette, ImageSequence
 from ._binary import i16be as i16
@@ -149,14 +150,15 @@ def _crc32(data, seed=0):
 
 
 class ChunkStream:
-    def __init__(self, fp):
-        self.fp = fp
-        self.queue = []
+    def __init__(self, fp: IO[bytes]) -> None:
+        self.fp: IO[bytes] | None = fp
+        self.queue: list[tuple[bytes, int, int]] | None = []
 
-    def read(self):
+    def read(self) -> tuple[bytes, int, int]:
         """Fetch a new chunk. Returns header information."""
         cid = None
 
+        assert self.fp is not None
         if self.queue:
             cid, pos, length = self.queue.pop()
             self.fp.seek(pos)
@@ -173,7 +175,7 @@ def read(self):
 
         return cid, pos, length
 
-    def __enter__(self):
+    def __enter__(self) -> ChunkStream:
         return self
 
     def __exit__(self, *args):
@@ -182,7 +184,8 @@ def __exit__(self, *args):
     def close(self) -> None:
         self.queue = self.fp = None
 
-    def push(self, cid, pos, length):
+    def push(self, cid: bytes, pos: int, length: int) -> None:
+        assert self.queue is not None
         self.queue.append((cid, pos, length))
 
     def call(self, cid, pos, length):
@@ -191,7 +194,7 @@ def call(self, cid, pos, length):
         logger.debug("STREAM %r %s %s", cid, pos, length)
         return getattr(self, f"chunk_{cid.decode('ascii')}")(pos, length)
 
-    def crc(self, cid, data):
+    def crc(self, cid: bytes, data: bytes) -> None:
         """Read and verify checksum"""
 
         # Skip CRC checks for ancillary chunks if allowed to load truncated
@@ -201,6 +204,7 @@ def crc(self, cid, data):
             self.crc_skip(cid, data)
             return
 
+        assert self.fp is not None
         try:
             crc1 = _crc32(data, _crc32(cid))
             crc2 = i32(self.fp.read(4))
@@ -211,12 +215,13 @@ def crc(self, cid, data):
             msg = f"broken PNG file (incomplete checksum in {repr(cid)})"
             raise SyntaxError(msg) from e
 
-    def crc_skip(self, cid, data):
+    def crc_skip(self, cid: bytes, data: bytes) -> None:
         """Read checksum"""
 
+        assert self.fp is not None
         self.fp.read(4)
 
-    def verify(self, endchunk=b"IEND"):
+    def verify(self, endchunk: bytes = b"IEND") -> list[bytes]:
         # Simple approach; just calculate checksum for all remaining
         # blocks.  Must be called directly after open.
 
@@ -361,7 +366,7 @@ def __init__(self, fp):
 
         self.text_memory = 0
 
-    def check_text_memory(self, chunklen):
+    def check_text_memory(self, chunklen: int) -> None:
         self.text_memory += chunklen
         if self.text_memory > MAX_TEXT_MEMORY:
             msg = (
@@ -382,7 +387,7 @@ def rewind(self) -> None:
         self.im_tile = self.rewind_state["tile"]
         self._seq_num = self.rewind_state["seq_num"]
 
-    def chunk_iCCP(self, pos, length):
+    def chunk_iCCP(self, pos: int, length: int) -> bytes:
         # ICC profile
         s = ImageFile._safe_read(self.fp, length)
         # according to PNG spec, the iCCP chunk contains:
@@ -409,7 +414,7 @@ def chunk_iCCP(self, pos, length):
         self.im_info["icc_profile"] = icc_profile
         return s
 
-    def chunk_IHDR(self, pos, length):
+    def chunk_IHDR(self, pos: int, length: int) -> bytes:
         # image header
         s = ImageFile._safe_read(self.fp, length)
         if length < 13:
@@ -446,14 +451,14 @@ def chunk_IEND(self, pos, length):
         msg = "end of PNG image"
         raise EOFError(msg)
 
-    def chunk_PLTE(self, pos, length):
+    def chunk_PLTE(self, pos: int, length: int) -> bytes:
         # palette
         s = ImageFile._safe_read(self.fp, length)
         if self.im_mode == "P":
             self.im_palette = "RGB", s
         return s
 
-    def chunk_tRNS(self, pos, length):
+    def chunk_tRNS(self, pos: int, length: int) -> bytes:
         # transparency
         s = ImageFile._safe_read(self.fp, length)
         if self.im_mode == "P":
@@ -473,13 +478,13 @@ def chunk_tRNS(self, pos, length):
             self.im_info["transparency"] = i16(s), i16(s, 2), i16(s, 4)
         return s
 
-    def chunk_gAMA(self, pos, length):
+    def chunk_gAMA(self, pos: int, length: int) -> bytes:
         # gamma setting
         s = ImageFile._safe_read(self.fp, length)
         self.im_info["gamma"] = i32(s) / 100000.0
         return s
 
-    def chunk_cHRM(self, pos, length):
+    def chunk_cHRM(self, pos: int, length: int) -> bytes:
         # chromaticity, 8 unsigned ints, actual value is scaled by 100,000
         # WP x,y, Red x,y, Green x,y Blue x,y
 
@@ -488,7 +493,7 @@ def chunk_cHRM(self, pos, length):
         self.im_info["chromaticity"] = tuple(elt / 100000.0 for elt in raw_vals)
         return s
 
-    def chunk_sRGB(self, pos, length):
+    def chunk_sRGB(self, pos: int, length: int) -> bytes:
         # srgb rendering intent, 1 byte
         # 0 perceptual
         # 1 relative colorimetric
@@ -504,7 +509,7 @@ def chunk_sRGB(self, pos, length):
         self.im_info["srgb"] = s[0]
         return s
 
-    def chunk_pHYs(self, pos, length):
+    def chunk_pHYs(self, pos: int, length: int) -> bytes:
         # pixels per unit
         s = ImageFile._safe_read(self.fp, length)
         if length < 9:
@@ -521,7 +526,7 @@ def chunk_pHYs(self, pos, length):
             self.im_info["aspect"] = px, py
         return s
 
-    def chunk_tEXt(self, pos, length):
+    def chunk_tEXt(self, pos: int, length: int) -> bytes:
         # text
         s = ImageFile._safe_read(self.fp, length)
         try:
@@ -540,7 +545,7 @@ def chunk_tEXt(self, pos, length):
 
         return s
 
-    def chunk_zTXt(self, pos, length):
+    def chunk_zTXt(self, pos: int, length: int) -> bytes:
         # compressed text
         s = ImageFile._safe_read(self.fp, length)
         try:
@@ -574,7 +579,7 @@ def chunk_zTXt(self, pos, length):
 
         return s
 
-    def chunk_iTXt(self, pos, length):
+    def chunk_iTXt(self, pos: int, length: int) -> bytes:
         # international text
         r = s = ImageFile._safe_read(self.fp, length)
         try:
@@ -614,13 +619,13 @@ def chunk_iTXt(self, pos, length):
 
         return s
 
-    def chunk_eXIf(self, pos, length):
+    def chunk_eXIf(self, pos: int, length: int) -> bytes:
         s = ImageFile._safe_read(self.fp, length)
         self.im_info["exif"] = b"Exif\x00\x00" + s
         return s
 
     # APNG chunks
-    def chunk_acTL(self, pos, length):
+    def chunk_acTL(self, pos: int, length: int) -> bytes:
         s = ImageFile._safe_read(self.fp, length)
         if length < 8:
             if ImageFile.LOAD_TRUNCATED_IMAGES:
@@ -640,7 +645,7 @@ def chunk_acTL(self, pos, length):
         self.im_custom_mimetype = "image/apng"
         return s
 
-    def chunk_fcTL(self, pos, length):
+    def chunk_fcTL(self, pos: int, length: int) -> bytes:
         s = ImageFile._safe_read(self.fp, length)
         if length < 26:
             if ImageFile.LOAD_TRUNCATED_IMAGES:
@@ -669,7 +674,7 @@ def chunk_fcTL(self, pos, length):
         self.im_info["blend"] = s[25]
         return s
 
-    def chunk_fdAT(self, pos, length):
+    def chunk_fdAT(self, pos: int, length: int) -> bytes:
         if length < 4:
             if ImageFile.LOAD_TRUNCATED_IMAGES:
                 s = ImageFile._safe_read(self.fp, length)
@@ -701,7 +706,7 @@ class PngImageFile(ImageFile.ImageFile):
     format = "PNG"
     format_description = "Portable network graphics"
 
-    def _open(self):
+    def _open(self) -> None:
         if not _accept(self.fp.read(8)):
             msg = "not a PNG file"
             raise SyntaxError(msg)
@@ -711,8 +716,8 @@ def _open(self):
         #
         # Parse headers up to the first IDAT or fDAT chunk
 
-        self.private_chunks = []
-        self.png = PngStream(self.fp)
+        self.private_chunks: list[tuple[bytes, bytes] | tuple[bytes, bytes, bool]] = []
+        self.png: PngStream | None = PngStream(self.fp)
 
         while True:
             #
@@ -793,6 +798,7 @@ def verify(self) -> None:
         # back up to beginning of IDAT block
         self.fp.seek(self.tile[0][2] - 8)
 
+        assert self.png is not None
         self.png.verify()
         self.png.close()
 
@@ -921,9 +927,10 @@ def load_prepare(self) -> None:
         self.__idat = self.__prepare_idat  # used by load_read()
         ImageFile.ImageFile.load_prepare(self)
 
-    def load_read(self, read_bytes):
+    def load_read(self, read_bytes: int) -> bytes:
         """internal: read more image data"""
 
+        assert self.png is not None
         while self.__idat == 0:
             # end of chunk, skip forward to next one
 
@@ -956,6 +963,7 @@ def load_read(self, read_bytes):
 
     def load_end(self) -> None:
         """internal: finished reading image data"""
+        assert self.png is not None
         if self.__idat != 0:
             self.fp.read(self.__idat)
         while True:
@@ -1079,7 +1087,7 @@ def __init__(self, fp, chunk):
         self.fp = fp
         self.chunk = chunk
 
-    def write(self, data):
+    def write(self, data: bytes) -> None:
         self.chunk(self.fp, b"IDAT", data)
 
 
@@ -1091,7 +1099,7 @@ def __init__(self, fp, chunk, seq_num):
         self.chunk = chunk
         self.seq_num = seq_num
 
-    def write(self, data):
+    def write(self, data: bytes) -> None:
         self.chunk(self.fp, b"fdAT", o32(self.seq_num), data)
         self.seq_num += 1
 
@@ -1436,10 +1444,10 @@ def getchunks(im, **params):
     class collector:
         data = []
 
-        def write(self, data):
+        def write(self, data: bytes) -> None:
             pass
 
-        def append(self, chunk):
+        def append(self, chunk: bytes) -> None:
             self.data.append(chunk)
 
     def append(fp, cid, *data):
diff --git a/src/PIL/WebPImagePlugin.py b/src/PIL/WebPImagePlugin.py
index 4b8cfe65c7e..cae124e9f4c 100644
--- a/src/PIL/WebPImagePlugin.py
+++ b/src/PIL/WebPImagePlugin.py
@@ -171,7 +171,7 @@ def load(self):
 
         return super().load()
 
-    def load_seek(self, pos):
+    def load_seek(self, pos: int) -> None:
         pass
 
     def tell(self) -> int:
diff --git a/src/PIL/XpmImagePlugin.py b/src/PIL/XpmImagePlugin.py
index 88d14e9c2bd..8d56331e6aa 100644
--- a/src/PIL/XpmImagePlugin.py
+++ b/src/PIL/XpmImagePlugin.py
@@ -103,16 +103,13 @@ def _open(self) -> None:
 
         self.tile = [("raw", (0, 0) + self.size, self.fp.tell(), ("P", 0, 1))]
 
-    def load_read(self, read_bytes):
+    def load_read(self, read_bytes: int) -> bytes:
         #
         # load all image data in one chunk
 
         xsize, ysize = self.size
 
-        s = [None] * ysize
-
-        for i in range(ysize):
-            s[i] = self.fp.readline()[1 : xsize + 1].ljust(xsize)
+        s = [self.fp.readline()[1 : xsize + 1].ljust(xsize) for i in range(ysize)]
 
         return b"".join(s)
 
diff --git a/src/PIL/features.py b/src/PIL/features.py
index 95c6c84cce3..16c749f148b 100644
--- a/src/PIL/features.py
+++ b/src/PIL/features.py
@@ -18,7 +18,7 @@
 }
 
 
-def check_module(feature):
+def check_module(feature: str) -> bool:
     """
     Checks if a module is available.
 
@@ -42,7 +42,7 @@ def check_module(feature):
         return False
 
 
-def version_module(feature):
+def version_module(feature: str) -> str | None:
     """
     :param feature: The module to check for.
     :returns:
@@ -54,13 +54,10 @@ def version_module(feature):
 
     module, ver = modules[feature]
 
-    if ver is None:
-        return None
-
     return getattr(__import__(module, fromlist=[ver]), ver)
 
 
-def get_supported_modules():
+def get_supported_modules() -> list[str]:
     """
     :returns: A list of all supported modules.
     """
@@ -75,7 +72,7 @@ def get_supported_modules():
 }
 
 
-def check_codec(feature):
+def check_codec(feature: str) -> bool:
     """
     Checks if a codec is available.
 
@@ -92,7 +89,7 @@ def check_codec(feature):
     return f"{codec}_encoder" in dir(Image.core)
 
 
-def version_codec(feature):
+def version_codec(feature: str) -> str | None:
     """
     :param feature: The codec to check for.
     :returns:
@@ -113,7 +110,7 @@ def version_codec(feature):
     return version
 
 
-def get_supported_codecs():
+def get_supported_codecs() -> list[str]:
     """
     :returns: A list of all supported codecs.
     """
@@ -133,7 +130,7 @@ def get_supported_codecs():
 }
 
 
-def check_feature(feature):
+def check_feature(feature: str) -> bool | None:
     """
     Checks if a feature is available.
 
@@ -157,7 +154,7 @@ def check_feature(feature):
         return None
 
 
-def version_feature(feature):
+def version_feature(feature: str) -> str | None:
     """
     :param feature: The feature to check for.
     :returns: The version number as a string, or ``None`` if not available.
@@ -174,14 +171,14 @@ def version_feature(feature):
     return getattr(__import__(module, fromlist=[ver]), ver)
 
 
-def get_supported_features():
+def get_supported_features() -> list[str]:
     """
     :returns: A list of all supported features.
     """
     return [f for f in features if check_feature(f)]
 
 
-def check(feature):
+def check(feature: str) -> bool | None:
     """
     :param feature: A module, codec, or feature name.
     :returns:
@@ -199,7 +196,7 @@ def check(feature):
     return False
 
 
-def version(feature):
+def version(feature: str) -> str | None:
     """
     :param feature:
         The module, codec, or feature to check for.
@@ -215,7 +212,7 @@ def version(feature):
     return None
 
 
-def get_supported():
+def get_supported() -> list[str]:
     """
     :returns: A list of all supported modules, features, and codecs.
     """

From 1036aa74a7d91eda68d3f3f0bf4f59a87c020b0b Mon Sep 17 00:00:00 2001
From: Andrew Murray <radarhere@users.noreply.github.com>
Date: Thu, 16 May 2024 17:47:35 +1000
Subject: [PATCH 0625/1178] Added Image.WARN_POSSIBLE_FORMATS

---
 Tests/test_image.py      | 11 +++++++++++
 docs/reference/Image.rst |  5 +++++
 src/PIL/Image.py         | 15 ++++++++-------
 3 files changed, 24 insertions(+), 7 deletions(-)

diff --git a/Tests/test_image.py b/Tests/test_image.py
index 742d0dfe406..7ec4195e5cf 100644
--- a/Tests/test_image.py
+++ b/Tests/test_image.py
@@ -116,6 +116,17 @@ def test_open_formats(self) -> None:
                 assert im.mode == "RGB"
                 assert im.size == (128, 128)
 
+    def test_open_verbose_failure(self) -> None:
+        im = io.BytesIO(b"")
+        Image.WARN_POSSIBLE_FORMATS = True
+        try:
+            with pytest.warns(UserWarning):
+                with pytest.raises(UnidentifiedImageError):
+                    with Image.open(im):
+                        pass
+        finally:
+            Image.WARN_POSSIBLE_FORMATS = False
+
     def test_width_height(self) -> None:
         im = Image.new("RGB", (1, 2))
         assert im.width == 1
diff --git a/docs/reference/Image.rst b/docs/reference/Image.rst
index 0d9b4d93d77..f25c9cd9d46 100644
--- a/docs/reference/Image.rst
+++ b/docs/reference/Image.rst
@@ -374,6 +374,11 @@ Constants
     Set to 89,478,485, approximately 0.25GB for a 24-bit (3 bpp) image.
     See :py:meth:`~PIL.Image.open` for more information about how this is used.
 
+.. data:: WARN_POSSIBLE_FORMATS
+
+    Set to false. If true, when an image cannot be identified, warnings will be raised
+    from formats that attempted to read the data.
+
 Transpose methods
 ^^^^^^^^^^^^^^^^^
 
diff --git a/src/PIL/Image.py b/src/PIL/Image.py
index 958b95e3b0f..89c64998141 100644
--- a/src/PIL/Image.py
+++ b/src/PIL/Image.py
@@ -76,6 +76,8 @@ class DecompressionBombError(Exception):
     pass
 
 
+WARN_POSSIBLE_FORMATS: bool = False
+
 # Limit to around a quarter gigabyte for a 24-bit (3 bpp) image
 MAX_IMAGE_PIXELS: int | None = int(1024 * 1024 * 1024 // 4 // 3)
 
@@ -3344,7 +3346,7 @@ def open(
 
     preinit()
 
-    accept_warnings: list[str] = []
+    warning_messages: list[str] = []
 
     def _open_core(
         fp: IO[bytes],
@@ -3360,16 +3362,15 @@ def _open_core(
                 factory, accept = OPEN[i]
                 result = not accept or accept(prefix)
                 if isinstance(result, str):
-                    accept_warnings.append(result)
+                    warning_messages.append(result)
                 elif result:
                     fp.seek(0)
                     im = factory(fp, filename)
                     _decompression_bomb_check(im.size)
                     return im
-            except (SyntaxError, IndexError, TypeError, struct.error):
-                # Leave disabled by default, spams the logs with image
-                # opening failures that are entirely expected.
-                # logger.debug("", exc_info=True)
+            except (SyntaxError, IndexError, TypeError, struct.error) as e:
+                if WARN_POSSIBLE_FORMATS:
+                    warning_messages.append(i + " opening failed. " + str(e))
                 continue
             except BaseException:
                 if exclusive_fp:
@@ -3395,7 +3396,7 @@ def _open_core(
 
     if exclusive_fp:
         fp.close()
-    for message in accept_warnings:
+    for message in warning_messages:
         warnings.warn(message)
     msg = "cannot identify image file %r" % (filename if filename else fp)
     raise UnidentifiedImageError(msg)

From 3062ec4dd2343258e91c240645d20d1c5b6cecf1 Mon Sep 17 00:00:00 2001
From: Andrew Murray <radarhere@users.noreply.github.com>
Date: Thu, 16 May 2024 22:55:03 +1000
Subject: [PATCH 0626/1178] Fix type errors

---
 src/_imagingcms.c           | 2 +-
 src/display.c               | 2 +-
 src/libImaging/Dib.c        | 2 +-
 src/libImaging/TiffDecode.c | 2 +-
 4 files changed, 4 insertions(+), 4 deletions(-)

diff --git a/src/_imagingcms.c b/src/_imagingcms.c
index 63d78f84daa..4b0e21d7a4e 100644
--- a/src/_imagingcms.c
+++ b/src/_imagingcms.c
@@ -622,7 +622,7 @@ cms_profile_is_intent_supported(CmsProfileObject *self, PyObject *args) {
 static PyObject *
 cms_get_display_profile_win32(PyObject *self, PyObject *args) {
     char filename[MAX_PATH];
-    cmsUInt32Number filename_size;
+    DWORD filename_size;
     BOOL ok;
 
     HANDLE handle = 0;
diff --git a/src/display.c b/src/display.c
index 6b66ddafb87..abf94f1e1a7 100644
--- a/src/display.c
+++ b/src/display.c
@@ -716,7 +716,7 @@ PyImaging_DrawWmf(PyObject *self, PyObject *args) {
     HDC dc;
     RECT rect;
     PyObject *buffer = NULL;
-    char *ptr;
+    void *ptr;
 
     char *data;
     Py_ssize_t datasize;
diff --git a/src/libImaging/Dib.c b/src/libImaging/Dib.c
index 1b5bfe1324e..5194bfca3cb 100644
--- a/src/libImaging/Dib.c
+++ b/src/libImaging/Dib.c
@@ -95,7 +95,7 @@ ImagingNewDIB(const char *mode, int xsize, int ysize) {
     }
 
     dib->bitmap =
-        CreateDIBSection(dib->dc, dib->info, DIB_RGB_COLORS, &dib->bits, NULL, 0);
+        CreateDIBSection(dib->dc, dib->info, DIB_RGB_COLORS, (void **)&dib->bits, NULL, 0);
     if (!dib->bitmap) {
         free(dib->info);
         free(dib);
diff --git a/src/libImaging/TiffDecode.c b/src/libImaging/TiffDecode.c
index e3b81590ec2..4874dd26ab5 100644
--- a/src/libImaging/TiffDecode.c
+++ b/src/libImaging/TiffDecode.c
@@ -973,7 +973,7 @@ ImagingLibTiffEncode(Imaging im, ImagingCodecState state, UINT8 *buffer, int byt
     }
 
     if (state->state == 1 && !clientstate->fp) {
-        int read = (int)_tiffReadProc(clientstate, (tdata_t)buffer, (tsize_t)bytes);
+        int read = (int)_tiffReadProc((thandle_t)clientstate, (tdata_t)buffer, (tsize_t)bytes);
         TRACE(
             ("Buffer: %p: %c%c%c%c\n",
              buffer,

From 2a703a2d4c94eefb224de1cbd7c2209af643a258 Mon Sep 17 00:00:00 2001
From: Andrew Murray <radarhere@users.noreply.github.com>
Date: Fri, 17 May 2024 08:04:20 +1000
Subject: [PATCH 0627/1178] Removed continue

---
 src/PIL/Image.py | 1 -
 1 file changed, 1 deletion(-)

diff --git a/src/PIL/Image.py b/src/PIL/Image.py
index 89c64998141..514a543c2d3 100644
--- a/src/PIL/Image.py
+++ b/src/PIL/Image.py
@@ -3371,7 +3371,6 @@ def _open_core(
             except (SyntaxError, IndexError, TypeError, struct.error) as e:
                 if WARN_POSSIBLE_FORMATS:
                     warning_messages.append(i + " opening failed. " + str(e))
-                continue
             except BaseException:
                 if exclusive_fp:
                     fp.close()

From 7554e2cfbf25ea3a9b2da322a36b06be2a840b56 Mon Sep 17 00:00:00 2001
From: Andrew Murray <radarhere@users.noreply.github.com>
Date: Fri, 17 May 2024 08:44:04 +1000
Subject: [PATCH 0628/1178] Use monkeypatch

---
 Tests/test_image.py | 16 +++++++---------
 1 file changed, 7 insertions(+), 9 deletions(-)

diff --git a/Tests/test_image.py b/Tests/test_image.py
index 7ec4195e5cf..a03e5eced07 100644
--- a/Tests/test_image.py
+++ b/Tests/test_image.py
@@ -116,16 +116,14 @@ def test_open_formats(self) -> None:
                 assert im.mode == "RGB"
                 assert im.size == (128, 128)
 
-    def test_open_verbose_failure(self) -> None:
+    def test_open_verbose_failure(self, monkeypatch: pytest.MonkeyPatch) -> None:
+        monkeypatch.setattr(Image, "WARN_POSSIBLE_FORMATS", True)
+
         im = io.BytesIO(b"")
-        Image.WARN_POSSIBLE_FORMATS = True
-        try:
-            with pytest.warns(UserWarning):
-                with pytest.raises(UnidentifiedImageError):
-                    with Image.open(im):
-                        pass
-        finally:
-            Image.WARN_POSSIBLE_FORMATS = False
+        with pytest.warns(UserWarning):
+            with pytest.raises(UnidentifiedImageError):
+                with Image.open(im):
+                    pass
 
     def test_width_height(self) -> None:
         im = Image.new("RGB", (1, 2))

From 8a3a72e51d57360df6e91f6f73e73707f181069f Mon Sep 17 00:00:00 2001
From: Andrew Murray <radarhere@users.noreply.github.com>
Date: Sat, 18 May 2024 16:06:50 +1000
Subject: [PATCH 0629/1178] Added type hints

---
 docs/reference/ImageFile.rst   |  4 ++++
 src/PIL/BlpImagePlugin.py      | 22 +++++++++---------
 src/PIL/BufrStubImagePlugin.py |  4 ++--
 src/PIL/DcxImagePlugin.py      |  4 ++--
 src/PIL/GimpPaletteFile.py     |  9 ++++----
 src/PIL/GribStubImagePlugin.py |  4 ++--
 src/PIL/Hdf5StubImagePlugin.py |  8 ++++---
 src/PIL/Image.py               |  4 +++-
 src/PIL/ImageFile.py           | 10 +++++++++
 src/PIL/ImageFilter.py         | 17 ++++++++------
 src/PIL/ImageFont.py           |  4 ++--
 src/PIL/ImagePalette.py        | 14 ++++++------
 src/PIL/ImageWin.py            | 22 ++++++++++--------
 src/PIL/JpegImagePlugin.py     | 15 +++++++------
 src/PIL/PSDraw.py              | 41 ++++++++++++++++++++--------------
 src/PIL/PdfParser.py           | 10 ++++-----
 src/PIL/PngImagePlugin.py      |  8 +++----
 src/PIL/PyAccess.py            | 12 ++++++----
 src/PIL/TiffImagePlugin.py     |  2 +-
 src/PIL/WebPImagePlugin.py     |  5 +++--
 src/PIL/WmfImagePlugin.py      | 10 ++++-----
 21 files changed, 135 insertions(+), 94 deletions(-)

diff --git a/docs/reference/ImageFile.rst b/docs/reference/ImageFile.rst
index 047990f1c2a..e59c7311a99 100644
--- a/docs/reference/ImageFile.rst
+++ b/docs/reference/ImageFile.rst
@@ -57,6 +57,10 @@ Classes
     :undoc-members:
     :show-inheritance:
 
+.. autoclass:: PIL.ImageFile.StubHandler()
+    :members:
+    :show-inheritance:
+
 .. autoclass:: PIL.ImageFile.StubImageFile()
     :members:
     :show-inheritance:
diff --git a/src/PIL/BlpImagePlugin.py b/src/PIL/BlpImagePlugin.py
index bdf54baae13..782e28cf5df 100644
--- a/src/PIL/BlpImagePlugin.py
+++ b/src/PIL/BlpImagePlugin.py
@@ -55,7 +55,7 @@ class AlphaEncoding(IntEnum):
     DXT5 = 7
 
 
-def unpack_565(i):
+def unpack_565(i: int) -> tuple[int, int, int]:
     return ((i >> 11) & 0x1F) << 3, ((i >> 5) & 0x3F) << 2, (i & 0x1F) << 3
 
 
@@ -284,7 +284,8 @@ def decode(self, buffer):
             raise OSError(msg) from e
         return -1, 0
 
-    def _read_blp_header(self):
+    def _read_blp_header(self) -> None:
+        assert self.fd is not None
         self.fd.seek(4)
         (self._blp_compression,) = struct.unpack("<i", self._safe_read(4))
 
@@ -303,10 +304,10 @@ def _read_blp_header(self):
         self._blp_offsets = struct.unpack("<16I", self._safe_read(16 * 4))
         self._blp_lengths = struct.unpack("<16I", self._safe_read(16 * 4))
 
-    def _safe_read(self, length):
+    def _safe_read(self, length: int) -> bytes:
         return ImageFile._safe_read(self.fd, length)
 
-    def _read_palette(self):
+    def _read_palette(self) -> list[tuple[int, int, int, int]]:
         ret = []
         for i in range(256):
             try:
@@ -349,29 +350,30 @@ def _load(self) -> None:
             msg = f"Unsupported BLP compression {repr(self._blp_encoding)}"
             raise BLPFormatError(msg)
 
-    def _decode_jpeg_stream(self):
+    def _decode_jpeg_stream(self) -> None:
         from .JpegImagePlugin import JpegImageFile
 
         (jpeg_header_size,) = struct.unpack("<I", self._safe_read(4))
         jpeg_header = self._safe_read(jpeg_header_size)
+        assert self.fd is not None
         self._safe_read(self._blp_offsets[0] - self.fd.tell())  # What IS this?
         data = self._safe_read(self._blp_lengths[0])
         data = jpeg_header + data
-        data = BytesIO(data)
-        image = JpegImageFile(data)
+        image = JpegImageFile(BytesIO(data))
         Image._decompression_bomb_check(image.size)
         if image.mode == "CMYK":
             decoder_name, extents, offset, args = image.tile[0]
             image.tile = [(decoder_name, extents, offset, (args[0], "CMYK"))]
         r, g, b = image.convert("RGB").split()
-        image = Image.merge("RGB", (b, g, r))
-        self.set_as_raw(image.tobytes())
+        reversed_image = Image.merge("RGB", (b, g, r))
+        self.set_as_raw(reversed_image.tobytes())
 
 
 class BLP2Decoder(_BLPBaseDecoder):
-    def _load(self):
+    def _load(self) -> None:
         palette = self._read_palette()
 
+        assert self.fd is not None
         self.fd.seek(self._blp_offsets[0])
 
         if self._blp_compression == 1:
diff --git a/src/PIL/BufrStubImagePlugin.py b/src/PIL/BufrStubImagePlugin.py
index 271db725852..826e89dafea 100644
--- a/src/PIL/BufrStubImagePlugin.py
+++ b/src/PIL/BufrStubImagePlugin.py
@@ -15,7 +15,7 @@
 _handler = None
 
 
-def register_handler(handler):
+def register_handler(handler: ImageFile.StubHandler) -> None:
     """
     Install application-specific BUFR image handler.
 
@@ -54,7 +54,7 @@ def _open(self) -> None:
         if loader:
             loader.open(self)
 
-    def _load(self):
+    def _load(self) -> ImageFile.StubHandler | None:
         return _handler
 
 
diff --git a/src/PIL/DcxImagePlugin.py b/src/PIL/DcxImagePlugin.py
index 1c455b032cd..f67f27d73bb 100644
--- a/src/PIL/DcxImagePlugin.py
+++ b/src/PIL/DcxImagePlugin.py
@@ -42,7 +42,7 @@ class DcxImageFile(PcxImageFile):
     format_description = "Intel DCX"
     _close_exclusive_fp_after_loading = False
 
-    def _open(self):
+    def _open(self) -> None:
         # Header
         s = self.fp.read(4)
         if not _accept(s):
@@ -58,7 +58,7 @@ def _open(self):
             self._offset.append(offset)
 
         self._fp = self.fp
-        self.frame = None
+        self.frame = -1
         self.n_frames = len(self._offset)
         self.is_animated = self.n_frames > 1
         self.seek(0)
diff --git a/src/PIL/GimpPaletteFile.py b/src/PIL/GimpPaletteFile.py
index 2274f1a8bfe..4cad0ebeea1 100644
--- a/src/PIL/GimpPaletteFile.py
+++ b/src/PIL/GimpPaletteFile.py
@@ -16,6 +16,7 @@
 from __future__ import annotations
 
 import re
+from typing import IO
 
 from ._binary import o8
 
@@ -25,8 +26,8 @@ class GimpPaletteFile:
 
     rawmode = "RGB"
 
-    def __init__(self, fp):
-        self.palette = [o8(i) * 3 for i in range(256)]
+    def __init__(self, fp: IO[bytes]) -> None:
+        palette = [o8(i) * 3 for i in range(256)]
 
         if fp.readline()[:12] != b"GIMP Palette":
             msg = "not a GIMP palette file"
@@ -49,9 +50,9 @@ def __init__(self, fp):
                 msg = "bad palette entry"
                 raise ValueError(msg)
 
-            self.palette[i] = o8(v[0]) + o8(v[1]) + o8(v[2])
+            palette[i] = o8(v[0]) + o8(v[1]) + o8(v[2])
 
-        self.palette = b"".join(self.palette)
+        self.palette = b"".join(palette)
 
     def getpalette(self) -> tuple[bytes, str]:
         return self.palette, self.rawmode
diff --git a/src/PIL/GribStubImagePlugin.py b/src/PIL/GribStubImagePlugin.py
index 13bdfa616e8..c27cffab63e 100644
--- a/src/PIL/GribStubImagePlugin.py
+++ b/src/PIL/GribStubImagePlugin.py
@@ -15,7 +15,7 @@
 _handler = None
 
 
-def register_handler(handler):
+def register_handler(handler: ImageFile.StubHandler) -> None:
     """
     Install application-specific GRIB image handler.
 
@@ -54,7 +54,7 @@ def _open(self) -> None:
         if loader:
             loader.open(self)
 
-    def _load(self):
+    def _load(self) -> ImageFile.StubHandler | None:
         return _handler
 
 
diff --git a/src/PIL/Hdf5StubImagePlugin.py b/src/PIL/Hdf5StubImagePlugin.py
index afbfd16393c..c8d7866a312 100644
--- a/src/PIL/Hdf5StubImagePlugin.py
+++ b/src/PIL/Hdf5StubImagePlugin.py
@@ -10,12 +10,14 @@
 #
 from __future__ import annotations
 
+from typing import IO
+
 from . import Image, ImageFile
 
 _handler = None
 
 
-def register_handler(handler):
+def register_handler(handler: ImageFile.StubHandler) -> None:
     """
     Install application-specific HDF5 image handler.
 
@@ -54,11 +56,11 @@ def _open(self) -> None:
         if loader:
             loader.open(self)
 
-    def _load(self):
+    def _load(self) -> ImageFile.StubHandler | None:
         return _handler
 
 
-def _save(im, fp, filename):
+def _save(im: Image.Image, fp: IO[bytes], filename: str) -> None:
     if _handler is None or not hasattr(_handler, "save"):
         msg = "HDF5 save handler not installed"
         raise OSError(msg)
diff --git a/src/PIL/Image.py b/src/PIL/Image.py
index 958b95e3b0f..38ff0bfe4d6 100644
--- a/src/PIL/Image.py
+++ b/src/PIL/Image.py
@@ -1948,7 +1948,9 @@ def putalpha(self, alpha):
 
         self.im.putband(alpha.im, band)
 
-    def putdata(self, data, scale=1.0, offset=0.0):
+    def putdata(
+        self, data: Sequence[float], scale: float = 1.0, offset: float = 0.0
+    ) -> None:
         """
         Copies pixel data from a flattened sequence object into the image. The
         values should start at the upper left corner (0, 0), continue to the
diff --git a/src/PIL/ImageFile.py b/src/PIL/ImageFile.py
index 33467fc4fbe..f0e49238760 100644
--- a/src/PIL/ImageFile.py
+++ b/src/PIL/ImageFile.py
@@ -28,6 +28,7 @@
 #
 from __future__ import annotations
 
+import abc
 import io
 import itertools
 import struct
@@ -347,6 +348,15 @@ def _seek_check(self, frame):
         return self.tell() != frame
 
 
+class StubHandler:
+    def open(self, im: StubImageFile) -> None:
+        pass
+
+    @abc.abstractmethod
+    def load(self, im: StubImageFile) -> Image.Image:
+        pass
+
+
 class StubImageFile(ImageFile):
     """
     Base class for stub image loaders.
diff --git a/src/PIL/ImageFilter.py b/src/PIL/ImageFilter.py
index 678bd29a2d7..43e700b7b30 100644
--- a/src/PIL/ImageFilter.py
+++ b/src/PIL/ImageFilter.py
@@ -18,6 +18,7 @@
 
 import abc
 import functools
+from typing import Sequence
 
 
 class Filter:
@@ -79,7 +80,7 @@ class RankFilter(Filter):
 
     name = "Rank"
 
-    def __init__(self, size, rank):
+    def __init__(self, size: int, rank: int) -> None:
         self.size = size
         self.rank = rank
 
@@ -101,7 +102,7 @@ class MedianFilter(RankFilter):
 
     name = "Median"
 
-    def __init__(self, size=3):
+    def __init__(self, size: int = 3) -> None:
         self.size = size
         self.rank = size * size // 2
 
@@ -116,7 +117,7 @@ class MinFilter(RankFilter):
 
     name = "Min"
 
-    def __init__(self, size=3):
+    def __init__(self, size: int = 3) -> None:
         self.size = size
         self.rank = 0
 
@@ -131,7 +132,7 @@ class MaxFilter(RankFilter):
 
     name = "Max"
 
-    def __init__(self, size=3):
+    def __init__(self, size: int = 3) -> None:
         self.size = size
         self.rank = size * size - 1
 
@@ -147,7 +148,7 @@ class ModeFilter(Filter):
 
     name = "Mode"
 
-    def __init__(self, size=3):
+    def __init__(self, size: int = 3) -> None:
         self.size = size
 
     def filter(self, image):
@@ -165,7 +166,7 @@ class GaussianBlur(MultibandFilter):
 
     name = "GaussianBlur"
 
-    def __init__(self, radius=2):
+    def __init__(self, radius: float | Sequence[float] = 2) -> None:
         self.radius = radius
 
     def filter(self, image):
@@ -228,7 +229,9 @@ class UnsharpMask(MultibandFilter):
 
     name = "UnsharpMask"
 
-    def __init__(self, radius=2, percent=150, threshold=3):
+    def __init__(
+        self, radius: float = 2, percent: int = 150, threshold: int = 3
+    ) -> None:
         self.radius = radius
         self.percent = percent
         self.threshold = threshold
diff --git a/src/PIL/ImageFont.py b/src/PIL/ImageFont.py
index 256c581df0c..5446bc0c09b 100644
--- a/src/PIL/ImageFont.py
+++ b/src/PIL/ImageFont.py
@@ -261,7 +261,7 @@ def getname(self):
         """
         return self.font.family, self.font.style
 
-    def getmetrics(self):
+    def getmetrics(self) -> tuple[int, int]:
         """
         :return: A tuple of the font ascent (the distance from the baseline to
             the highest outline point) and descent (the distance from the
@@ -628,7 +628,7 @@ def font_variant(
             layout_engine=layout_engine or self.layout_engine,
         )
 
-    def get_variation_names(self):
+    def get_variation_names(self) -> list[bytes]:
         """
         :returns: A list of the named styles in a variation font.
         :exception OSError: If the font is not a variation font.
diff --git a/src/PIL/ImagePalette.py b/src/PIL/ImagePalette.py
index ae5c5dec0da..057ccd1d7c4 100644
--- a/src/PIL/ImagePalette.py
+++ b/src/PIL/ImagePalette.py
@@ -18,7 +18,7 @@
 from __future__ import annotations
 
 import array
-from typing import Sequence
+from typing import IO, Sequence
 
 from . import GimpGradientFile, GimpPaletteFile, ImageColor, PaletteFile
 
@@ -166,7 +166,7 @@ def getcolor(self, color, image=None) -> int:
             msg = f"unknown color specifier: {repr(color)}"
             raise ValueError(msg)
 
-    def save(self, fp):
+    def save(self, fp: str | IO[str]) -> None:
         """Save palette to text file.
 
         .. warning:: This method is experimental.
@@ -213,29 +213,29 @@ def make_linear_lut(black, white):
     raise NotImplementedError(msg)  # FIXME
 
 
-def make_gamma_lut(exp):
+def make_gamma_lut(exp: float) -> list[int]:
     return [int(((i / 255.0) ** exp) * 255.0 + 0.5) for i in range(256)]
 
 
-def negative(mode="RGB"):
+def negative(mode: str = "RGB") -> ImagePalette:
     palette = list(range(256 * len(mode)))
     palette.reverse()
     return ImagePalette(mode, [i // len(mode) for i in palette])
 
 
-def random(mode="RGB"):
+def random(mode: str = "RGB") -> ImagePalette:
     from random import randint
 
     palette = [randint(0, 255) for _ in range(256 * len(mode))]
     return ImagePalette(mode, palette)
 
 
-def sepia(white="#fff0c0"):
+def sepia(white: str = "#fff0c0") -> ImagePalette:
     bands = [make_linear_lut(0, band) for band in ImageColor.getrgb(white)]
     return ImagePalette("RGB", [bands[i % 3][i // 3] for i in range(256 * 3)])
 
 
-def wedge(mode="RGB"):
+def wedge(mode: str = "RGB") -> ImagePalette:
     palette = list(range(256 * len(mode)))
     return ImagePalette(mode, [i // len(mode) for i in palette])
 
diff --git a/src/PIL/ImageWin.py b/src/PIL/ImageWin.py
index 77e57a4157b..6c29e2590cf 100644
--- a/src/PIL/ImageWin.py
+++ b/src/PIL/ImageWin.py
@@ -28,10 +28,10 @@ class HDC:
     methods.
     """
 
-    def __init__(self, dc):
+    def __init__(self, dc: int) -> None:
         self.dc = dc
 
-    def __int__(self):
+    def __int__(self) -> int:
         return self.dc
 
 
@@ -42,10 +42,10 @@ class HWND:
     methods, instead of a DC.
     """
 
-    def __init__(self, wnd):
+    def __init__(self, wnd: int) -> None:
         self.wnd = wnd
 
-    def __int__(self):
+    def __int__(self) -> int:
         return self.wnd
 
 
@@ -149,7 +149,9 @@ def query_palette(self, handle):
             result = self.image.query_palette(handle)
         return result
 
-    def paste(self, im, box=None):
+    def paste(
+        self, im: Image.Image, box: tuple[int, int, int, int] | None = None
+    ) -> None:
         """
         Paste a PIL image into the bitmap image.
 
@@ -169,16 +171,16 @@ def paste(self, im, box=None):
         else:
             self.image.paste(im.im)
 
-    def frombytes(self, buffer):
+    def frombytes(self, buffer: bytes) -> None:
         """
         Load display memory contents from byte data.
 
         :param buffer: A buffer containing display data (usually
                        data returned from :py:func:`~PIL.ImageWin.Dib.tobytes`)
         """
-        return self.image.frombytes(buffer)
+        self.image.frombytes(buffer)
 
-    def tobytes(self):
+    def tobytes(self) -> bytes:
         """
         Copy display memory contents to bytes object.
 
@@ -190,7 +192,9 @@ def tobytes(self):
 class Window:
     """Create a Window with the given title size."""
 
-    def __init__(self, title="PIL", width=None, height=None):
+    def __init__(
+        self, title: str = "PIL", width: int | None = None, height: int | None = None
+    ) -> None:
         self.hwnd = Image.core.createwindow(
             title, self.__dispatcher, width or 0, height or 0
         )
diff --git a/src/PIL/JpegImagePlugin.py b/src/PIL/JpegImagePlugin.py
index 909911dfe37..9fea4e7d133 100644
--- a/src/PIL/JpegImagePlugin.py
+++ b/src/PIL/JpegImagePlugin.py
@@ -42,6 +42,7 @@
 import sys
 import tempfile
 import warnings
+from typing import Any
 
 from . import Image, ImageFile
 from ._binary import i16be as i16
@@ -54,7 +55,7 @@
 # Parser
 
 
-def Skip(self, marker):
+def Skip(self: JpegImageFile, marker: int) -> None:
     n = i16(self.fp.read(2)) - 2
     ImageFile._safe_read(self.fp, n)
 
@@ -191,7 +192,7 @@ def APP(self, marker):
             self.info["dpi"] = 72, 72
 
 
-def COM(self, marker):
+def COM(self: JpegImageFile, marker: int) -> None:
     #
     # Comment marker.  Store these in the APP dictionary.
     n = i16(self.fp.read(2)) - 2
@@ -202,7 +203,7 @@ def COM(self, marker):
     self.applist.append(("COM", s))
 
 
-def SOF(self, marker):
+def SOF(self: JpegImageFile, marker: int) -> None:
     #
     # Start of frame marker.  Defines the size and mode of the
     # image.  JPEG is colour blind, so we use some simple
@@ -250,7 +251,7 @@ def SOF(self, marker):
         self.layer.append((t[0], t[1] // 16, t[1] & 15, t[2]))
 
 
-def DQT(self, marker):
+def DQT(self: JpegImageFile, marker: int) -> None:
     #
     # Define quantization table.  Note that there might be more
     # than one table in each marker.
@@ -493,13 +494,13 @@ def load_djpeg(self) -> None:
 
         self.tile = []
 
-    def _getexif(self):
+    def _getexif(self) -> dict[str, Any] | None:
         return _getexif(self)
 
     def _getmp(self):
         return _getmp(self)
 
-    def getxmp(self):
+    def getxmp(self) -> dict[str, Any]:
         """
         Returns a dictionary containing the XMP tags.
         Requires defusedxml to be installed.
@@ -515,7 +516,7 @@ def getxmp(self):
         return {}
 
 
-def _getexif(self):
+def _getexif(self) -> dict[str, Any] | None:
     if "exif" not in self.info:
         return None
     return self.getexif()._get_merged_dict()
diff --git a/src/PIL/PSDraw.py b/src/PIL/PSDraw.py
index 49c06ce1363..4e2b9788ef3 100644
--- a/src/PIL/PSDraw.py
+++ b/src/PIL/PSDraw.py
@@ -17,6 +17,7 @@
 from __future__ import annotations
 
 import sys
+from typing import TYPE_CHECKING
 
 from . import EpsImagePlugin
 
@@ -38,7 +39,7 @@ def __init__(self, fp=None):
                 fp = sys.stdout
         self.fp = fp
 
-    def begin_document(self, id=None):
+    def begin_document(self, id: str | None = None) -> None:
         """Set up printing of a document. (Write PostScript DSC header.)"""
         # FIXME: incomplete
         self.fp.write(
@@ -52,7 +53,7 @@ def begin_document(self, id=None):
         self.fp.write(EDROFF_PS)
         self.fp.write(VDI_PS)
         self.fp.write(b"%%EndProlog\n")
-        self.isofont = {}
+        self.isofont: dict[bytes, int] = {}
 
     def end_document(self) -> None:
         """Ends printing. (Write PostScript DSC footer.)"""
@@ -60,22 +61,24 @@ def end_document(self) -> None:
         if hasattr(self.fp, "flush"):
             self.fp.flush()
 
-    def setfont(self, font, size):
+    def setfont(self, font: str, size: int) -> None:
         """
         Selects which font to use.
 
         :param font: A PostScript font name
         :param size: Size in points.
         """
-        font = bytes(font, "UTF-8")
-        if font not in self.isofont:
+        font_bytes = bytes(font, "UTF-8")
+        if font_bytes not in self.isofont:
             # reencode font
-            self.fp.write(b"/PSDraw-%s ISOLatin1Encoding /%s E\n" % (font, font))
-            self.isofont[font] = 1
+            self.fp.write(
+                b"/PSDraw-%s ISOLatin1Encoding /%s E\n" % (font_bytes, font_bytes)
+            )
+            self.isofont[font_bytes] = 1
         # rough
-        self.fp.write(b"/F0 %d /PSDraw-%s F\n" % (size, font))
+        self.fp.write(b"/F0 %d /PSDraw-%s F\n" % (size, font_bytes))
 
-    def line(self, xy0, xy1):
+    def line(self, xy0: tuple[int, int], xy1: tuple[int, int]) -> None:
         """
         Draws a line between the two points. Coordinates are given in
         PostScript point coordinates (72 points per inch, (0, 0) is the lower
@@ -83,7 +86,7 @@ def line(self, xy0, xy1):
         """
         self.fp.write(b"%d %d %d %d Vl\n" % (*xy0, *xy1))
 
-    def rectangle(self, box):
+    def rectangle(self, box: tuple[int, int, int, int]) -> None:
         """
         Draws a rectangle.
 
@@ -92,18 +95,22 @@ def rectangle(self, box):
         """
         self.fp.write(b"%d %d M 0 %d %d Vr\n" % box)
 
-    def text(self, xy, text):
+    def text(self, xy: tuple[int, int], text: str) -> None:
         """
         Draws text at the given position. You must use
         :py:meth:`~PIL.PSDraw.PSDraw.setfont` before calling this method.
         """
-        text = bytes(text, "UTF-8")
-        text = b"\\(".join(text.split(b"("))
-        text = b"\\)".join(text.split(b")"))
-        xy += (text,)
-        self.fp.write(b"%d %d M (%s) S\n" % xy)
+        text_bytes = bytes(text, "UTF-8")
+        text_bytes = b"\\(".join(text_bytes.split(b"("))
+        text_bytes = b"\\)".join(text_bytes.split(b")"))
+        self.fp.write(b"%d %d M (%s) S\n" % (xy + (text_bytes,)))
 
-    def image(self, box, im, dpi=None):
+    if TYPE_CHECKING:
+        from . import Image
+
+    def image(
+        self, box: tuple[int, int, int, int], im: Image.Image, dpi: int | None = None
+    ) -> None:
         """Draw a PIL image, centered in the given box."""
         # default resolution depends on mode
         if not dpi:
diff --git a/src/PIL/PdfParser.py b/src/PIL/PdfParser.py
index 68501d625d4..a6c24e67179 100644
--- a/src/PIL/PdfParser.py
+++ b/src/PIL/PdfParser.py
@@ -13,7 +13,7 @@
 
 # see 7.9.2.2 Text String Type on page 86 and D.3 PDFDocEncoding Character Set
 # on page 656
-def encode_text(s):
+def encode_text(s: str) -> bytes:
     return codecs.BOM_UTF16_BE + s.encode("utf_16_be")
 
 
@@ -103,7 +103,7 @@ def __eq__(self, other):
     def __ne__(self, other):
         return not (self == other)
 
-    def __hash__(self):
+    def __hash__(self) -> int:
         return hash((self.object_id, self.generation))
 
 
@@ -219,7 +219,7 @@ def __eq__(self, other):
             isinstance(other, PdfName) and other.name == self.name
         ) or other == self.name
 
-    def __hash__(self):
+    def __hash__(self) -> int:
         return hash(self.name)
 
     def __repr__(self) -> str:
@@ -402,7 +402,7 @@ def __init__(self, filename=None, f=None, buf=None, start_offset=0, mode="rb"):
         if f:
             self.seek_end()
 
-    def __enter__(self):
+    def __enter__(self) -> PdfParser:
         return self
 
     def __exit__(self, exc_type, exc_value, traceback):
@@ -436,7 +436,7 @@ def write_header(self) -> None:
     def write_comment(self, s):
         self.f.write(f"% {s}\n".encode())
 
-    def write_catalog(self):
+    def write_catalog(self) -> IndirectReference:
         self.del_root()
         self.root_ref = self.next_object_id(self.f.tell())
         self.pages_ref = self.next_object_id(0)
diff --git a/src/PIL/PngImagePlugin.py b/src/PIL/PngImagePlugin.py
index c74cbccf1bf..f7ccc8381fa 100644
--- a/src/PIL/PngImagePlugin.py
+++ b/src/PIL/PngImagePlugin.py
@@ -39,7 +39,7 @@
 import warnings
 import zlib
 from enum import IntEnum
-from typing import IO
+from typing import IO, Any
 
 from . import Image, ImageChops, ImageFile, ImagePalette, ImageSequence
 from ._binary import i16be as i16
@@ -1019,7 +1019,7 @@ def load_end(self) -> None:
                 if self.pyaccess:
                     self.pyaccess = None
 
-    def _getexif(self):
+    def _getexif(self) -> dict[str, Any] | None:
         if "exif" not in self.info:
             self.load()
         if "exif" not in self.info and "Raw profile type exif" not in self.info:
@@ -1032,7 +1032,7 @@ def getexif(self):
 
         return super().getexif()
 
-    def getxmp(self):
+    def getxmp(self) -> dict[str, Any]:
         """
         Returns a dictionary containing the XMP tags.
         Requires defusedxml to be installed.
@@ -1234,7 +1234,7 @@ def _write_multiple_frames(im, fp, chunk, rawmode, default_image, append_images)
             seq_num = fdat_chunks.seq_num
 
 
-def _save_all(im, fp, filename):
+def _save_all(im: Image.Image, fp: IO[bytes], filename: str) -> None:
     _save(im, fp, filename, save_all=True)
 
 
diff --git a/src/PIL/PyAccess.py b/src/PIL/PyAccess.py
index a9da90613e7..f476713ca7e 100644
--- a/src/PIL/PyAccess.py
+++ b/src/PIL/PyAccess.py
@@ -22,6 +22,7 @@
 
 import logging
 import sys
+from typing import TYPE_CHECKING
 
 from ._deprecate import deprecate
 
@@ -48,9 +49,12 @@
 
 logger = logging.getLogger(__name__)
 
+if TYPE_CHECKING:
+    from . import Image
+
 
 class PyAccess:
-    def __init__(self, img, readonly=False):
+    def __init__(self, img: Image.Image, readonly: bool = False) -> None:
         deprecate("PyAccess", 11)
         vals = dict(img.im.unsafe_ptrs)
         self.readonly = readonly
@@ -130,7 +134,7 @@ def __getitem__(self, xy):
     putpixel = __setitem__
     getpixel = __getitem__
 
-    def check_xy(self, xy):
+    def check_xy(self, xy: tuple[int, int]) -> tuple[int, int]:
         (x, y) = xy
         if not (0 <= x < self.xsize and 0 <= y < self.ysize):
             msg = "pixel location out of range"
@@ -161,7 +165,7 @@ class _PyAccess32_3(PyAccess):
     def _post_init(self, *args, **kwargs):
         self.pixels = ffi.cast("struct Pixel_RGBA **", self.image32)
 
-    def get_pixel(self, x, y):
+    def get_pixel(self, x: int, y: int) -> tuple[int, int, int]:
         pixel = self.pixels[y][x]
         return pixel.r, pixel.g, pixel.b
 
@@ -180,7 +184,7 @@ class _PyAccess32_4(PyAccess):
     def _post_init(self, *args, **kwargs):
         self.pixels = ffi.cast("struct Pixel_RGBA **", self.image32)
 
-    def get_pixel(self, x, y):
+    def get_pixel(self, x: int, y: int) -> tuple[int, int, int, int]:
         pixel = self.pixels[y][x]
         return pixel.r, pixel.g, pixel.b, pixel.a
 
diff --git a/src/PIL/TiffImagePlugin.py b/src/PIL/TiffImagePlugin.py
index 54faa59c55f..f3fa3c24ccd 100644
--- a/src/PIL/TiffImagePlugin.py
+++ b/src/PIL/TiffImagePlugin.py
@@ -1202,7 +1202,7 @@ def tell(self) -> int:
         """Return the current frame number"""
         return self.__frame
 
-    def getxmp(self):
+    def getxmp(self) -> dict[str, Any]:
         """
         Returns a dictionary containing the XMP tags.
         Requires defusedxml to be installed.
diff --git a/src/PIL/WebPImagePlugin.py b/src/PIL/WebPImagePlugin.py
index cae124e9f4c..ff7402dca32 100644
--- a/src/PIL/WebPImagePlugin.py
+++ b/src/PIL/WebPImagePlugin.py
@@ -1,6 +1,7 @@
 from __future__ import annotations
 
 from io import BytesIO
+from typing import Any
 
 from . import Image, ImageFile
 
@@ -95,12 +96,12 @@ def _open(self) -> None:
         # Initialize seek state
         self._reset(reset=False)
 
-    def _getexif(self):
+    def _getexif(self) -> dict[str, Any] | None:
         if "exif" not in self.info:
             return None
         return self.getexif()._get_merged_dict()
 
-    def getxmp(self):
+    def getxmp(self) -> dict[str, Any]:
         """
         Returns a dictionary containing the XMP tags.
         Requires defusedxml to be installed.
diff --git a/src/PIL/WmfImagePlugin.py b/src/PIL/WmfImagePlugin.py
index b0328657b03..fab3e26c587 100644
--- a/src/PIL/WmfImagePlugin.py
+++ b/src/PIL/WmfImagePlugin.py
@@ -28,7 +28,7 @@
 _handler = None
 
 
-def register_handler(handler):
+def register_handler(handler: ImageFile.StubHandler) -> None:
     """
     Install application-specific WMF image handler.
 
@@ -41,12 +41,12 @@ def register_handler(handler):
 if hasattr(Image.core, "drawwmf"):
     # install default handler (windows only)
 
-    class WmfHandler:
-        def open(self, im):
+    class WmfHandler(ImageFile.StubHandler):
+        def open(self, im: ImageFile.StubImageFile) -> None:
             im._mode = "RGB"
             self.bbox = im.info["wmf_bbox"]
 
-        def load(self, im):
+        def load(self, im: ImageFile.StubImageFile) -> Image.Image:
             im.fp.seek(0)  # rewind
             return Image.frombytes(
                 "RGB",
@@ -147,7 +147,7 @@ def _open(self) -> None:
         if loader:
             loader.open(self)
 
-    def _load(self):
+    def _load(self) -> ImageFile.StubHandler | None:
         return _handler
 
     def load(self, dpi=None):

From b2316f46cb4fc084fc15cb2848eca8b19cbc4329 Mon Sep 17 00:00:00 2001
From: Sebastian Rittau <srittau@rittau.biz>
Date: Sat, 18 May 2024 11:22:57 +0200
Subject: [PATCH 0630/1178] Use just `str` for `_string_length_check`

Co-authored-by: Andrew Murray <3112309+radarhere@users.noreply.github.com>
---
 src/PIL/ImageFont.py | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/src/PIL/ImageFont.py b/src/PIL/ImageFont.py
index f2936bae67d..747c0c05077 100644
--- a/src/PIL/ImageFont.py
+++ b/src/PIL/ImageFont.py
@@ -61,7 +61,7 @@ class Layout(IntEnum):
     core = DeferredError.new(ex)
 
 
-def _string_length_check(text: str | bytes) -> None:
+def _string_length_check(text: str) -> None:
     if MAX_STRING_LENGTH is not None and len(text) > MAX_STRING_LENGTH:
         msg = "too many characters in string"
         raise ValueError(msg)

From 82910a5e4f1f12472dd85ce31090e7abeefe9814 Mon Sep 17 00:00:00 2001
From: Andrew Murray <radarhere@users.noreply.github.com>
Date: Sun, 19 May 2024 22:00:45 +1000
Subject: [PATCH 0631/1178] Lint fixes

---
 src/libImaging/Dib.c        | 4 ++--
 src/libImaging/TiffDecode.c | 3 ++-
 2 files changed, 4 insertions(+), 3 deletions(-)

diff --git a/src/libImaging/Dib.c b/src/libImaging/Dib.c
index 5194bfca3cb..269be10587b 100644
--- a/src/libImaging/Dib.c
+++ b/src/libImaging/Dib.c
@@ -94,8 +94,8 @@ ImagingNewDIB(const char *mode, int xsize, int ysize) {
         return (ImagingDIB)ImagingError_MemoryError();
     }
 
-    dib->bitmap =
-        CreateDIBSection(dib->dc, dib->info, DIB_RGB_COLORS, (void **)&dib->bits, NULL, 0);
+    dib->bitmap = CreateDIBSection(
+        dib->dc, dib->info, DIB_RGB_COLORS, (void **)&dib->bits, NULL, 0);
     if (!dib->bitmap) {
         free(dib->info);
         free(dib);
diff --git a/src/libImaging/TiffDecode.c b/src/libImaging/TiffDecode.c
index 8b4d7aeacd1..abffdeabcd5 100644
--- a/src/libImaging/TiffDecode.c
+++ b/src/libImaging/TiffDecode.c
@@ -1005,7 +1005,8 @@ ImagingLibTiffEncode(Imaging im, ImagingCodecState state, UINT8 *buffer, int byt
     }
 
     if (state->state == 1 && !clientstate->fp) {
-        int read = (int)_tiffReadProc((thandle_t)clientstate, (tdata_t)buffer, (tsize_t)bytes);
+        int read =
+            (int)_tiffReadProc((thandle_t)clientstate, (tdata_t)buffer, (tsize_t)bytes);
         TRACE(
             ("Buffer: %p: %c%c%c%c\n",
              buffer,

From fb21c50fb664cefff2ef68ea972f5079d49f227e Mon Sep 17 00:00:00 2001
From: Andrew Murray <radarhere@users.noreply.github.com>
Date: Fri, 17 May 2024 10:46:32 +1000
Subject: [PATCH 0632/1178] Restore original thread state

---
 src/display.c | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/src/display.c b/src/display.c
index abf94f1e1a7..990f4b0a5c9 100644
--- a/src/display.c
+++ b/src/display.c
@@ -618,7 +618,7 @@ windowCallback(HWND wnd, UINT message, WPARAM wParam, LPARAM lParam) {
     if (callback) {
         /* restore thread state */
         PyEval_SaveThread();
-        PyThreadState_Swap(threadstate);
+        PyThreadState_Swap(current_threadstate);
     }
 
     return status;

From 0f1a0fc5018cfda48a1e9368d4f421734eca4a18 Mon Sep 17 00:00:00 2001
From: Andrew Murray <radarhere@users.noreply.github.com>
Date: Mon, 20 May 2024 23:11:50 +1000
Subject: [PATCH 0633/1178] Improved consistency of XMP handling

---
 Tests/test_file_jpeg.py          |  1 +
 Tests/test_file_png.py           |  1 +
 Tests/test_file_tiff.py          |  1 +
 Tests/test_file_webp_metadata.py |  1 +
 Tests/test_image.py              |  4 ++++
 docs/reference/Image.rst         |  1 +
 docs/releasenotes/8.3.0.rst      |  6 +++---
 src/PIL/Image.py                 | 16 ++++++++++++----
 src/PIL/ImageOps.py              |  3 +++
 src/PIL/JpegImagePlugin.py       | 17 ++---------------
 src/PIL/PngImagePlugin.py        | 15 ++-------------
 src/PIL/TiffImagePlugin.py       | 13 ++++---------
 src/PIL/WebPImagePlugin.py       |  9 ---------
 13 files changed, 35 insertions(+), 53 deletions(-)

diff --git a/Tests/test_file_jpeg.py b/Tests/test_file_jpeg.py
index 5d2157651df..c895c3a8d06 100644
--- a/Tests/test_file_jpeg.py
+++ b/Tests/test_file_jpeg.py
@@ -943,6 +943,7 @@ def test_getxmp(self) -> None:
                 ):
                     assert im.getxmp() == {}
             else:
+                assert "xmp" in im.info
                 xmp = im.getxmp()
 
                 description = xmp["xmpmeta"]["RDF"]["Description"]
diff --git a/Tests/test_file_png.py b/Tests/test_file_png.py
index 19462dcb5a4..eb2c8a5f145 100644
--- a/Tests/test_file_png.py
+++ b/Tests/test_file_png.py
@@ -683,6 +683,7 @@ def test_getxmp(self) -> None:
                 ):
                     assert im.getxmp() == {}
             else:
+                assert "xmp" in im.info
                 xmp = im.getxmp()
 
                 description = xmp["xmpmeta"]["RDF"]["Description"]
diff --git a/Tests/test_file_tiff.py b/Tests/test_file_tiff.py
index 8821fb46a84..56b9148d167 100644
--- a/Tests/test_file_tiff.py
+++ b/Tests/test_file_tiff.py
@@ -759,6 +759,7 @@ def test_getxmp(self) -> None:
                 ):
                     assert im.getxmp() == {}
             else:
+                assert "xmp" in im.info
                 xmp = im.getxmp()
 
                 description = xmp["xmpmeta"]["RDF"]["Description"]
diff --git a/Tests/test_file_webp_metadata.py b/Tests/test_file_webp_metadata.py
index 8759412408c..c3df4ad7bcb 100644
--- a/Tests/test_file_webp_metadata.py
+++ b/Tests/test_file_webp_metadata.py
@@ -129,6 +129,7 @@ def test_getxmp() -> None:
             ):
                 assert im.getxmp() == {}
         else:
+            assert "xmp" in im.info
             assert (
                 im.getxmp()["xmpmeta"]["xmptk"]
                 == "Adobe XMP Core 5.3-c011 66.145661, 2012/02/06-14:56:27        "
diff --git a/Tests/test_image.py b/Tests/test_image.py
index 742d0dfe406..042c0dccbb4 100644
--- a/Tests/test_image.py
+++ b/Tests/test_image.py
@@ -897,6 +897,10 @@ def test_exif_hide_offsets(self) -> None:
                     assert tag not in exif.get_ifd(0x8769)
                 assert exif.get_ifd(0xA005)
 
+    def test_empty_xmp(self) -> None:
+        with Image.open("Tests/images/hopper.gif") as im:
+            assert im.getxmp() == {}
+
     @pytest.mark.parametrize("size", ((1, 0), (0, 1), (0, 0)))
     def test_zero_tobytes(self, size: tuple[int, int]) -> None:
         im = Image.new("RGB", size)
diff --git a/docs/reference/Image.rst b/docs/reference/Image.rst
index 0d9b4d93d77..767c833b39c 100644
--- a/docs/reference/Image.rst
+++ b/docs/reference/Image.rst
@@ -197,6 +197,7 @@ This helps to get the bounding box coordinates of the input image::
 .. automethod:: PIL.Image.Image.getpalette
 .. automethod:: PIL.Image.Image.getpixel
 .. automethod:: PIL.Image.Image.getprojection
+.. automethod:: PIL.Image.Image.getxmp
 .. automethod:: PIL.Image.Image.histogram
 .. automethod:: PIL.Image.Image.paste
 .. automethod:: PIL.Image.Image.point
diff --git a/docs/releasenotes/8.3.0.rst b/docs/releasenotes/8.3.0.rst
index 9f46cc1e9e9..4ef914f6471 100644
--- a/docs/releasenotes/8.3.0.rst
+++ b/docs/releasenotes/8.3.0.rst
@@ -18,9 +18,9 @@ is not secure.
 
 - :py:meth:`~PIL.Image.Image.getexif` has used ``xml`` to potentially retrieve
   orientation data since Pillow 7.2.0. It has been refactored to use ``re`` instead.
-- :py:meth:`~PIL.JpegImagePlugin.JpegImageFile.getxmp` was added in Pillow 8.2.0. It
-  will now use ``defusedxml`` instead. If the dependency is not present, an empty
-  dictionary will be returned and a warning raised.
+- ``getxmp()`` was added to :py:class:`~PIL.JpegImagePlugin.JpegImageFile` in Pillow
+  8.2.0. It will now use ``defusedxml`` instead. If the dependency is not present, an
+  empty dictionary will be returned and a warning raised.
 
 Deprecations
 ============
diff --git a/src/PIL/Image.py b/src/PIL/Image.py
index 958b95e3b0f..7d54b124bc0 100644
--- a/src/PIL/Image.py
+++ b/src/PIL/Image.py
@@ -1439,7 +1439,14 @@ def getextrema(self) -> tuple[float, float] | tuple[tuple[int, int], ...]:
             return tuple(self.im.getband(i).getextrema() for i in range(self.im.bands))
         return self.im.getextrema()
 
-    def _getxmp(self, xmp_tags):
+    def getxmp(self):
+        """
+        Returns a dictionary containing the XMP tags.
+        Requires defusedxml to be installed.
+
+        :returns: XMP tags in a dictionary.
+        """
+
         def get_name(tag):
             return re.sub("^{[^}]+}", "", tag)
 
@@ -1466,9 +1473,10 @@ def get_value(element):
         if ElementTree is None:
             warnings.warn("XMP data cannot be read without defusedxml dependency")
             return {}
-        else:
-            root = ElementTree.fromstring(xmp_tags)
-            return {get_name(root.tag): get_value(root)}
+        if "xmp" not in self.info:
+            return {}
+        root = ElementTree.fromstring(self.info["xmp"])
+        return {get_name(root.tag): get_value(root)}
 
     def getexif(self) -> Exif:
         """
diff --git a/src/PIL/ImageOps.py b/src/PIL/ImageOps.py
index 33db8fa50c7..48bde39fe26 100644
--- a/src/PIL/ImageOps.py
+++ b/src/PIL/ImageOps.py
@@ -717,6 +717,9 @@ def exif_transpose(image: Image.Image, *, in_place: bool = False) -> Image.Image
                     exif_image.info["XML:com.adobe.xmp"] = re.sub(
                         pattern, "", exif_image.info["XML:com.adobe.xmp"]
                     )
+                    exif_image.info["xmp"] = re.sub(
+                        pattern.encode(), b"", exif_image.info["xmp"]
+                    )
         if not in_place:
             return transposed_image
     elif not in_place:
diff --git a/src/PIL/JpegImagePlugin.py b/src/PIL/JpegImagePlugin.py
index 909911dfe37..be6b6959a09 100644
--- a/src/PIL/JpegImagePlugin.py
+++ b/src/PIL/JpegImagePlugin.py
@@ -94,6 +94,8 @@ def APP(self, marker):
         else:
             self.info["exif"] = s
             self._exif_offset = self.fp.tell() - n + 6
+    elif marker == 0xFFE1 and s[:29] == b"http://ns.adobe.com/xap/1.0/\x00":
+        self.info["xmp"] = s.split(b"\x00")[1]
     elif marker == 0xFFE2 and s[:5] == b"FPXR\0":
         # extract FlashPix information (incomplete)
         self.info["flashpix"] = s  # FIXME: value will change
@@ -499,21 +501,6 @@ def _getexif(self):
     def _getmp(self):
         return _getmp(self)
 
-    def getxmp(self):
-        """
-        Returns a dictionary containing the XMP tags.
-        Requires defusedxml to be installed.
-
-        :returns: XMP tags in a dictionary.
-        """
-
-        for segment, content in self.applist:
-            if segment == "APP1":
-                marker, xmp_tags = content.split(b"\x00")[:2]
-                if marker == b"http://ns.adobe.com/xap/1.0/":
-                    return self._getxmp(xmp_tags)
-        return {}
-
 
 def _getexif(self):
     if "exif" not in self.info:
diff --git a/src/PIL/PngImagePlugin.py b/src/PIL/PngImagePlugin.py
index c74cbccf1bf..14622349b81 100644
--- a/src/PIL/PngImagePlugin.py
+++ b/src/PIL/PngImagePlugin.py
@@ -606,6 +606,8 @@ def chunk_iTXt(self, pos: int, length: int) -> bytes:
                     return s
             else:
                 return s
+        if k == b"XML:com.adobe.xmp":
+            self.im_info["xmp"] = v
         try:
             k = k.decode("latin-1", "strict")
             lang = lang.decode("utf-8", "strict")
@@ -1032,19 +1034,6 @@ def getexif(self):
 
         return super().getexif()
 
-    def getxmp(self):
-        """
-        Returns a dictionary containing the XMP tags.
-        Requires defusedxml to be installed.
-
-        :returns: XMP tags in a dictionary.
-        """
-        return (
-            self._getxmp(self.info["XML:com.adobe.xmp"])
-            if "XML:com.adobe.xmp" in self.info
-            else {}
-        )
-
 
 # --------------------------------------------------------------------
 # PNG writer
diff --git a/src/PIL/TiffImagePlugin.py b/src/PIL/TiffImagePlugin.py
index 54faa59c55f..7ba71b58edd 100644
--- a/src/PIL/TiffImagePlugin.py
+++ b/src/PIL/TiffImagePlugin.py
@@ -1192,6 +1192,10 @@ def _seek(self, frame: int) -> None:
             self.__frame += 1
         self.fp.seek(self._frame_pos[frame])
         self.tag_v2.load(self.fp)
+        if XMP in self.tag_v2:
+            self.info["xmp"] = self.tag_v2[XMP]
+        elif "xmp" in self.info:
+            del self.info["xmp"]
         self._reload_exif()
         # fill the legacy tag/ifd entries
         self.tag = self.ifd = ImageFileDirectory_v1.from_v2(self.tag_v2)
@@ -1202,15 +1206,6 @@ def tell(self) -> int:
         """Return the current frame number"""
         return self.__frame
 
-    def getxmp(self):
-        """
-        Returns a dictionary containing the XMP tags.
-        Requires defusedxml to be installed.
-
-        :returns: XMP tags in a dictionary.
-        """
-        return self._getxmp(self.tag_v2[XMP]) if XMP in self.tag_v2 else {}
-
     def get_photoshop_blocks(self):
         """
         Returns a dictionary of Photoshop "Image Resource Blocks".
diff --git a/src/PIL/WebPImagePlugin.py b/src/PIL/WebPImagePlugin.py
index cae124e9f4c..43e1410c7a4 100644
--- a/src/PIL/WebPImagePlugin.py
+++ b/src/PIL/WebPImagePlugin.py
@@ -100,15 +100,6 @@ def _getexif(self):
             return None
         return self.getexif()._get_merged_dict()
 
-    def getxmp(self):
-        """
-        Returns a dictionary containing the XMP tags.
-        Requires defusedxml to be installed.
-
-        :returns: XMP tags in a dictionary.
-        """
-        return self._getxmp(self.info["xmp"]) if "xmp" in self.info else {}
-
     def seek(self, frame: int) -> None:
         if not self._seek_check(frame):
             return

From ea9dc1e4a5c5c508bbb5c7cbd29f207836e77007 Mon Sep 17 00:00:00 2001
From: "renovate[bot]" <29139614+renovate[bot]@users.noreply.github.com>
Date: Mon, 20 May 2024 21:30:03 +0000
Subject: [PATCH 0634/1178] chore(deps): update dependency cibuildwheel to
 v2.18.1

---
 .ci/requirements-cibw.txt | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/.ci/requirements-cibw.txt b/.ci/requirements-cibw.txt
index 8d39ea9bbab..7e257b75cf3 100644
--- a/.ci/requirements-cibw.txt
+++ b/.ci/requirements-cibw.txt
@@ -1 +1 @@
-cibuildwheel==2.18.0
+cibuildwheel==2.18.1

From 3cc26e9ea614def5a5efdcbcfd646ff50e3936e2 Mon Sep 17 00:00:00 2001
From: Andrew Murray <radarhere@users.noreply.github.com>
Date: Tue, 21 May 2024 12:55:48 +1000
Subject: [PATCH 0635/1178] Added Python 3.13 wheels

---
 .github/workflows/wheels-test.sh | 2 +-
 .github/workflows/wheels.yml     | 4 ++++
 2 files changed, 5 insertions(+), 1 deletion(-)

diff --git a/.github/workflows/wheels-test.sh b/.github/workflows/wheels-test.sh
index 3fbf3be695b..a3376ac929c 100755
--- a/.github/workflows/wheels-test.sh
+++ b/.github/workflows/wheels-test.sh
@@ -12,7 +12,7 @@ elif [ "${AUDITWHEEL_POLICY::9}" == "musllinux" ]; then
 else
     yum install -y fribidi
 fi
-if [ "${AUDITWHEEL_POLICY::9}" != "musllinux" ]; then
+if [ "${AUDITWHEEL_POLICY::9}" != "musllinux" ] && !([[ "$OSTYPE" == "darwin"* ]] && [[ $(python3 --version) == *"3.13."* ]]); then
     python3 -m pip install numpy
 fi
 
diff --git a/.github/workflows/wheels.yml b/.github/workflows/wheels.yml
index b2fbd314083..3d6099c1cf5 100644
--- a/.github/workflows/wheels.yml
+++ b/.github/workflows/wheels.yml
@@ -46,6 +46,7 @@ jobs:
           - cp310
           - cp311
           - cp312
+          - cp313
         spec:
           - manylinux2014
           - manylinux_2_28
@@ -80,6 +81,7 @@ jobs:
           CIBW_ARCHS: "aarch64"
           # Likewise, select only one Python version per job to speed this up.
           CIBW_BUILD: "${{ matrix.python-version }}-${{ matrix.spec == 'musllinux' && 'musllinux' || 'manylinux' }}*"
+          CIBW_PRERELEASE_PYTHONS: True
           # Extra options for manylinux.
           CIBW_MANYLINUX_AARCH64_IMAGE: ${{ matrix.spec }}
           CIBW_MANYLINUX_PYPY_AARCH64_IMAGE: ${{ matrix.spec }}
@@ -133,6 +135,7 @@ jobs:
           CIBW_BUILD: ${{ matrix.build }}
           CIBW_MANYLINUX_PYPY_X86_64_IMAGE: ${{ matrix.manylinux }}
           CIBW_MANYLINUX_X86_64_IMAGE: ${{ matrix.manylinux }}
+          CIBW_PRERELEASE_PYTHONS: True
           CIBW_SKIP: pp38-*
           CIBW_TEST_SKIP: cp38-macosx_arm64
           MACOSX_DEPLOYMENT_TARGET: ${{ matrix.macosx_deployment_target }}
@@ -204,6 +207,7 @@ jobs:
           CIBW_ARCHS: ${{ matrix.cibw_arch }}
           CIBW_BEFORE_ALL: "{package}\\winbuild\\build\\build_dep_all.cmd"
           CIBW_CACHE_PATH: "C:\\cibw"
+          CIBW_PRERELEASE_PYTHONS: True
           CIBW_SKIP: pp38-*
           CIBW_TEST_SKIP: "*-win_arm64"
           CIBW_TEST_COMMAND: 'docker run --rm

From d461ff8cef83116abffbd24145459ee1300c520d Mon Sep 17 00:00:00 2001
From: Andrew Murray <radarhere@users.noreply.github.com>
Date: Wed, 22 May 2024 11:50:10 +1000
Subject: [PATCH 0636/1178] Added release notes

---
 docs/releasenotes/10.4.0.rst | 8 +++++---
 1 file changed, 5 insertions(+), 3 deletions(-)

diff --git a/docs/releasenotes/10.4.0.rst b/docs/releasenotes/10.4.0.rst
index 3150bf4e02f..41f33102fdd 100644
--- a/docs/releasenotes/10.4.0.rst
+++ b/docs/releasenotes/10.4.0.rst
@@ -53,7 +53,9 @@ TODO
 Other Changes
 =============
 
-TODO
-^^^^
+Python 3.13 beta
+^^^^^^^^^^^^^^^^
 
-TODO
+To help others prepare for Python 3.13, wheels have been built against the 3.13 beta as
+a preview. This is not official support for Python 3.13, but simply an opportunity for
+users to test how Pillow works with the beta and report any problems.

From 33e304ed66851ed7cbd6e9018764ec9ec089c25f Mon Sep 17 00:00:00 2001
From: Andrew Murray <radarhere@users.noreply.github.com>
Date: Wed, 22 May 2024 19:43:00 +1000
Subject: [PATCH 0637/1178] Use @cached_property

---
 src/PIL/GifImagePlugin.py | 39 +++++++++++++++++++--------------------
 1 file changed, 19 insertions(+), 20 deletions(-)

diff --git a/src/PIL/GifImagePlugin.py b/src/PIL/GifImagePlugin.py
index eede4154994..962a9283464 100644
--- a/src/PIL/GifImagePlugin.py
+++ b/src/PIL/GifImagePlugin.py
@@ -30,6 +30,7 @@
 import os
 import subprocess
 from enum import IntEnum
+from functools import cached_property
 
 from . import (
     Image,
@@ -112,8 +113,7 @@ def _open(self) -> None:
 
         self._fp = self.fp  # FIXME: hack
         self.__rewind = self.fp.tell()
-        self._n_frames = None
-        self._is_animated = None
+        self._n_frames: int | None = None
         self._seek(0)  # get ready to read first frame
 
     @property
@@ -128,24 +128,23 @@ def n_frames(self):
             self.seek(current)
         return self._n_frames
 
-    @property
-    def is_animated(self):
-        if self._is_animated is None:
-            if self._n_frames is not None:
-                self._is_animated = self._n_frames != 1
-            else:
-                current = self.tell()
-                if current:
-                    self._is_animated = True
-                else:
-                    try:
-                        self._seek(1, False)
-                        self._is_animated = True
-                    except EOFError:
-                        self._is_animated = False
-
-                    self.seek(current)
-        return self._is_animated
+    @cached_property
+    def is_animated(self) -> bool:
+        if self._n_frames is not None:
+            return self._n_frames != 1
+
+        current = self.tell()
+        if current:
+            return True
+
+        try:
+            self._seek(1, False)
+            is_animated = True
+        except EOFError:
+            is_animated = False
+
+        self.seek(current)
+        return is_animated
 
     def seek(self, frame: int) -> None:
         if not self._seek_check(frame):

From 2dedeef832eb170dd8490ca12aa496ade95de478 Mon Sep 17 00:00:00 2001
From: Andrew Murray <radarhere@users.noreply.github.com>
Date: Wed, 22 May 2024 20:05:07 +1000
Subject: [PATCH 0638/1178] Support unpacking more rawmodes to RGBA palette

---
 Tests/test_image_putpalette.py |  1 +
 src/PIL/DdsImagePlugin.py      |  1 +
 src/PIL/GifImagePlugin.py      |  2 +-
 src/PIL/Image.py               | 12 ++++++------
 src/_imaging.c                 |  6 +++---
 5 files changed, 12 insertions(+), 10 deletions(-)

diff --git a/Tests/test_image_putpalette.py b/Tests/test_image_putpalette.py
index cc7cf58f0fc..75d9d2fc116 100644
--- a/Tests/test_image_putpalette.py
+++ b/Tests/test_image_putpalette.py
@@ -79,6 +79,7 @@ def test_putpalette_with_alpha_values() -> None:
     (
         ("RGBA", (1, 2, 3, 4)),
         ("RGBAX", (1, 2, 3, 4, 0)),
+        ("ARGB", (4, 1, 2, 3)),
     ),
 )
 def test_rgba_palette(mode: str, palette: tuple[int, ...]) -> None:
diff --git a/src/PIL/DdsImagePlugin.py b/src/PIL/DdsImagePlugin.py
index 1575f2d88b6..285e4b9db92 100644
--- a/src/PIL/DdsImagePlugin.py
+++ b/src/PIL/DdsImagePlugin.py
@@ -379,6 +379,7 @@ def _open(self) -> None:
         elif pfflags & DDPF.PALETTEINDEXED8:
             self._mode = "P"
             self.palette = ImagePalette.raw("RGBA", self.fp.read(1024))
+            self.palette.mode = "RGBA"
         elif pfflags & DDPF.FOURCC:
             offset = header_size + 4
             if fourcc == D3DFMT.DXT1:
diff --git a/src/PIL/GifImagePlugin.py b/src/PIL/GifImagePlugin.py
index eede4154994..151feb17d9f 100644
--- a/src/PIL/GifImagePlugin.py
+++ b/src/PIL/GifImagePlugin.py
@@ -429,7 +429,7 @@ def load_prepare(self) -> None:
             self._prev_im = self.im
             if self._frame_palette:
                 self.im = Image.core.fill("P", self.size, self._frame_transparency or 0)
-                self.im.putpalette(*self._frame_palette.getdata())
+                self.im.putpalette("RGB", *self._frame_palette.getdata())
             else:
                 self.im = None
         self._mode = temp_mode
diff --git a/src/PIL/Image.py b/src/PIL/Image.py
index 958b95e3b0f..7a957e76960 100644
--- a/src/PIL/Image.py
+++ b/src/PIL/Image.py
@@ -873,7 +873,7 @@ def load(self):
         if self.im is not None and self.palette and self.palette.dirty:
             # realize palette
             mode, arr = self.palette.getdata()
-            self.im.putpalette(mode, arr)
+            self.im.putpalette(self.palette.mode, mode, arr)
             self.palette.dirty = 0
             self.palette.rawmode = None
             if "transparency" in self.info and mode in ("LA", "PA"):
@@ -883,9 +883,9 @@ def load(self):
                     self.im.putpalettealphas(self.info["transparency"])
                 self.palette.mode = "RGBA"
             else:
-                palette_mode = "RGBA" if mode.startswith("RGBA") else "RGB"
-                self.palette.mode = palette_mode
-                self.palette.palette = self.im.getpalette(palette_mode, palette_mode)
+                self.palette.palette = self.im.getpalette(
+                    self.palette.mode, self.palette.mode
+                )
 
         if self.im is not None:
             if cffi and USE_CFFI_ACCESS:
@@ -1998,7 +1998,7 @@ def putpalette(self, data, rawmode="RGB") -> None:
             palette = ImagePalette.raw(rawmode, data)
         self._mode = "PA" if "A" in self.mode else "P"
         self.palette = palette
-        self.palette.mode = "RGB"
+        self.palette.mode = "RGBA" if "A" in rawmode else "RGB"
         self.load()  # install new palette
 
     def putpixel(self, xy, value):
@@ -2113,7 +2113,7 @@ def remap_palette(self, dest_map, source_palette=None):
         # m_im.putpalette(mapping_palette, 'L')  # converts to 'P'
         # or just force it.
         # UNDONE -- this is part of the general issue with palettes
-        m_im.im.putpalette(palette_mode + ";L", m_im.palette.tobytes())
+        m_im.im.putpalette(palette_mode, palette_mode + ";L", m_im.palette.tobytes())
 
         m_im = m_im.convert("L")
 
diff --git a/src/_imaging.c b/src/_imaging.c
index c565c21bb15..d2d29bfdf04 100644
--- a/src/_imaging.c
+++ b/src/_imaging.c
@@ -1725,10 +1725,11 @@ _putpalette(ImagingObject *self, PyObject *args) {
     ImagingShuffler unpack;
     int bits;
 
-    char *rawmode, *palette_mode;
+    char *palette_mode, *rawmode;
     UINT8 *palette;
     Py_ssize_t palettesize;
-    if (!PyArg_ParseTuple(args, "sy#", &rawmode, &palette, &palettesize)) {
+    if (!PyArg_ParseTuple(
+            args, "ssy#", &palette_mode, &rawmode, &palette, &palettesize)) {
         return NULL;
     }
 
@@ -1738,7 +1739,6 @@ _putpalette(ImagingObject *self, PyObject *args) {
         return NULL;
     }
 
-    palette_mode = strncmp("RGBA", rawmode, 4) == 0 ? "RGBA" : "RGB";
     unpack = ImagingFindUnpacker(palette_mode, rawmode, &bits);
     if (!unpack) {
         PyErr_SetString(PyExc_ValueError, wrong_raw_mode);

From 804fe7bbf86826a34067846b8ca29837ccc8d2af Mon Sep 17 00:00:00 2001
From: Andrew Murray <radarhere@users.noreply.github.com>
Date: Thu, 23 May 2024 17:50:50 +1000
Subject: [PATCH 0639/1178] Do not read layers when opening

---
 Tests/test_file_psd.py    | 24 +++++++++++++++---------
 src/PIL/PsdImagePlugin.py | 30 +++++++++++++++++++++++++-----
 2 files changed, 40 insertions(+), 14 deletions(-)

diff --git a/Tests/test_file_psd.py b/Tests/test_file_psd.py
index 484a1be8f83..91539e0e4a3 100644
--- a/Tests/test_file_psd.py
+++ b/Tests/test_file_psd.py
@@ -4,7 +4,7 @@
 
 import pytest
 
-from PIL import Image, PsdImagePlugin, UnidentifiedImageError
+from PIL import Image, PsdImagePlugin
 
 from .helper import assert_image_equal_tofile, assert_image_similar, hopper, is_pypy
 
@@ -150,14 +150,6 @@ def test_combined_larger_than_size() -> None:
 @pytest.mark.parametrize(
     "test_file,raises",
     [
-        (
-            "Tests/images/timeout-1ee28a249896e05b83840ae8140622de8e648ba9.psd",
-            UnidentifiedImageError,
-        ),
-        (
-            "Tests/images/timeout-598843abc37fc080ec36a2699ebbd44f795d3a6f.psd",
-            UnidentifiedImageError,
-        ),
         ("Tests/images/timeout-c8efc3fded6426986ba867a399791bae544f59bc.psd", OSError),
         ("Tests/images/timeout-dedc7a4ebd856d79b4359bbcc79e8ef231ce38f6.psd", OSError),
     ],
@@ -167,3 +159,17 @@ def test_crashes(test_file: str, raises) -> None:
         with pytest.raises(raises):
             with Image.open(f):
                 pass
+
+
+@pytest.mark.parametrize(
+    "test_file",
+    [
+        "Tests/images/timeout-1ee28a249896e05b83840ae8140622de8e648ba9.psd",
+        "Tests/images/timeout-598843abc37fc080ec36a2699ebbd44f795d3a6f.psd",
+    ],
+)
+def test_layer_crashes(test_file: str) -> None:
+    with open(test_file, "rb") as f:
+        with Image.open(f) as im:
+            with pytest.raises(SyntaxError):
+                im.layers
diff --git a/src/PIL/PsdImagePlugin.py b/src/PIL/PsdImagePlugin.py
index 86c1a67630e..edf698bf02d 100644
--- a/src/PIL/PsdImagePlugin.py
+++ b/src/PIL/PsdImagePlugin.py
@@ -18,6 +18,7 @@
 from __future__ import annotations
 
 import io
+from functools import cached_property
 
 from . import Image, ImageFile, ImagePalette
 from ._binary import i8
@@ -118,18 +119,17 @@ def _open(self) -> None:
         #
         # layer and mask information
 
-        self.layers = []
+        self._layers_position = None
 
         size = i32(read(4))
         if size:
             end = self.fp.tell() + size
             size = i32(read(4))
             if size:
-                _layer_data = io.BytesIO(ImageFile._safe_read(self.fp, size))
-                self.layers = _layerinfo(_layer_data, size)
+                self._layers_position = self.fp.tell()
+                self._layers_size = size
             self.fp.seek(end)
-        self.n_frames = len(self.layers)
-        self.is_animated = self.n_frames > 1
+        self._n_frames: int | None = None
 
         #
         # image descriptor
@@ -141,6 +141,26 @@ def _open(self) -> None:
         self.frame = 1
         self._min_frame = 1
 
+    @cached_property
+    def layers(self):
+        layers = []
+        if self._layers_position is not None:
+            self._fp.seek(self._layers_position)
+            _layer_data = io.BytesIO(ImageFile._safe_read(self._fp, self._layers_size))
+            layers = _layerinfo(_layer_data, self._layers_size)
+        self._n_frames = len(layers)
+        return layers
+
+    @property
+    def n_frames(self) -> int:
+        if self._n_frames is None:
+            self._n_frames = len(self.layers)
+        return self._n_frames
+
+    @property
+    def is_animated(self) -> bool:
+        return len(self.layers) > 1
+
     def seek(self, layer: int) -> None:
         if not self._seek_check(layer):
             return

From 92d1879a776be3b109a26786d6611cab9ef6181c Mon Sep 17 00:00:00 2001
From: Yay295 <Yay295@users.noreply.github.com>
Date: Thu, 23 May 2024 13:27:53 -0500
Subject: [PATCH 0640/1178] add mypy task to makefile

---
 Makefile | 5 +++++
 1 file changed, 5 insertions(+)

diff --git a/Makefile b/Makefile
index 1f9b4a370df..94f7565d826 100644
--- a/Makefile
+++ b/Makefile
@@ -118,3 +118,8 @@ lint-fix:
 	python3 -m black .
 	python3 -c "import ruff" > /dev/null 2>&1 || python3 -m pip install ruff
 	python3 -m ruff --fix .
+
+.PHONY: mypy
+mypy:
+	python3 -c "import tox" > /dev/null 2>&1 || python3 -m pip install tox
+	python3 -m tox -e mypy

From 16cd3584548d8b5f4cd81d8460805b6604530a6f Mon Sep 17 00:00:00 2001
From: Andrew Murray <radarhere@users.noreply.github.com>
Date: Fri, 24 May 2024 20:32:52 +1000
Subject: [PATCH 0641/1178] Update CHANGES.rst [ci skip]

---
 CHANGES.rst | 6 ++++++
 1 file changed, 6 insertions(+)

diff --git a/CHANGES.rst b/CHANGES.rst
index c5df1f8f7c4..8a531d1e2a9 100644
--- a/CHANGES.rst
+++ b/CHANGES.rst
@@ -5,6 +5,12 @@ Changelog (Pillow)
 10.4.0 (unreleased)
 -------------------
 
+- Add mypy target to Makefile #8077
+  [Yay295]
+
+- Added more modes to Image.MODES #7984
+  [radarhere]
+
 - Deprecate BGR;15, BGR;16 and BGR;24 modes #7978
   [radarhere, hugovk]
 

From 2c9b5f03607d083665f5880506197405197f34ae Mon Sep 17 00:00:00 2001
From: Andrew Murray <radarhere@users.noreply.github.com>
Date: Sat, 25 May 2024 06:20:03 +1000
Subject: [PATCH 0642/1178] Updated Ghostscript to 10.3.1

---
 .appveyor.yml                      | 2 +-
 .github/workflows/test-windows.yml | 2 +-
 2 files changed, 2 insertions(+), 2 deletions(-)

diff --git a/.appveyor.yml b/.appveyor.yml
index 57a8fa5a06d..6470dbc4c67 100644
--- a/.appveyor.yml
+++ b/.appveyor.yml
@@ -34,7 +34,7 @@ install:
 - xcopy /S /Y c:\test-images-main\* c:\pillow\tests\images
 - curl -fsSL -o nasm-win64.zip https://raw.githubusercontent.com/python-pillow/pillow-depends/main/nasm-2.16.01-win64.zip
 - 7z x nasm-win64.zip -oc:\
-- choco install ghostscript --version=10.3.0
+- choco install ghostscript --version=10.3.1
 - path c:\nasm-2.16.01;C:\Program Files\gs\gs10.00.0\bin;%PATH%
 - cd c:\pillow\winbuild\
 - ps: |
diff --git a/.github/workflows/test-windows.yml b/.github/workflows/test-windows.yml
index 9edc1517350..ee265774b2e 100644
--- a/.github/workflows/test-windows.yml
+++ b/.github/workflows/test-windows.yml
@@ -86,7 +86,7 @@ jobs:
         choco install nasm --no-progress
         echo "C:\Program Files\NASM" >> $env:GITHUB_PATH
 
-        choco install ghostscript --version=10.3.0 --no-progress
+        choco install ghostscript --version=10.3.1 --no-progress
         echo "C:\Program Files\gs\gs10.00.0\bin" >> $env:GITHUB_PATH
 
         # Install extra test images

From 1a6b0bb6b5423dba1607dfee6d4ea437a58cc246 Mon Sep 17 00:00:00 2001
From: Andrew Murray <radarhere@users.noreply.github.com>
Date: Sat, 25 May 2024 19:30:20 +1000
Subject: [PATCH 0643/1178] Removed documentation of unused argument

---
 src/PIL/ImageFont.py | 4 ----
 1 file changed, 4 deletions(-)

diff --git a/src/PIL/ImageFont.py b/src/PIL/ImageFont.py
index 256c581df0c..ad5f7545925 100644
--- a/src/PIL/ImageFont.py
+++ b/src/PIL/ImageFont.py
@@ -160,10 +160,6 @@ def getbbox(self, text, *args, **kwargs):
         .. versionadded:: 9.2.0
 
         :param text: Text to render.
-        :param mode: Used by some graphics drivers to indicate what mode the
-                     driver prefers; if empty, the renderer may return either
-                     mode. Note that the mode is always a string, to simplify
-                     C-level implementations.
 
         :return: ``(left, top, right, bottom)`` bounding box
         """

From 1b878189d857bcc823f887cf94650a5f0eaa182a Mon Sep 17 00:00:00 2001
From: Yay295 <Yay295@users.noreply.github.com>
Date: Sun, 26 May 2024 02:25:45 -0500
Subject: [PATCH 0644/1178] don't reuse variable name

---
 src/PIL/PngImagePlugin.py | 4 ++--
 1 file changed, 2 insertions(+), 2 deletions(-)

diff --git a/src/PIL/PngImagePlugin.py b/src/PIL/PngImagePlugin.py
index c74cbccf1bf..31706cef96b 100644
--- a/src/PIL/PngImagePlugin.py
+++ b/src/PIL/PngImagePlugin.py
@@ -1294,7 +1294,7 @@ def _save(im, fp, filename, chunk=putchunk, save_all=False):
 
     # get the corresponding PNG mode
     try:
-        rawmode, mode = _OUTMODES[mode]
+        rawmode, rawmode_depth_type = _OUTMODES[mode]
     except KeyError as e:
         msg = f"cannot write mode {mode} as PNG"
         raise OSError(msg) from e
@@ -1309,7 +1309,7 @@ def _save(im, fp, filename, chunk=putchunk, save_all=False):
         b"IHDR",
         o32(size[0]),  # 0: size
         o32(size[1]),
-        mode,  # 8: depth/type
+        rawmode_depth_type,  # 8: depth/type
         b"\0",  # 10: compression
         b"\0",  # 11: filter category
         b"\0",  # 12: interlace flag

From 82d992690572a270f4a8280cf48318fb8f70f2c2 Mon Sep 17 00:00:00 2001
From: Andrew Murray <radarhere@users.noreply.github.com>
Date: Sun, 26 May 2024 21:18:14 +1000
Subject: [PATCH 0645/1178] Split depth/type into bit depth and color type

---
 src/PIL/PngImagePlugin.py | 37 +++++++++++++++++++------------------
 1 file changed, 19 insertions(+), 18 deletions(-)

diff --git a/src/PIL/PngImagePlugin.py b/src/PIL/PngImagePlugin.py
index 31706cef96b..0d5751962c0 100644
--- a/src/PIL/PngImagePlugin.py
+++ b/src/PIL/PngImagePlugin.py
@@ -1050,22 +1050,22 @@ def getxmp(self):
 # PNG writer
 
 _OUTMODES = {
-    # supported PIL modes, and corresponding rawmodes/bits/color combinations
-    "1": ("1", b"\x01\x00"),
-    "L;1": ("L;1", b"\x01\x00"),
-    "L;2": ("L;2", b"\x02\x00"),
-    "L;4": ("L;4", b"\x04\x00"),
-    "L": ("L", b"\x08\x00"),
-    "LA": ("LA", b"\x08\x04"),
-    "I": ("I;16B", b"\x10\x00"),
-    "I;16": ("I;16B", b"\x10\x00"),
-    "I;16B": ("I;16B", b"\x10\x00"),
-    "P;1": ("P;1", b"\x01\x03"),
-    "P;2": ("P;2", b"\x02\x03"),
-    "P;4": ("P;4", b"\x04\x03"),
-    "P": ("P", b"\x08\x03"),
-    "RGB": ("RGB", b"\x08\x02"),
-    "RGBA": ("RGBA", b"\x08\x06"),
+    # supported PIL modes, and corresponding rawmode, bit depth and color type
+    "1": ("1", b"\x01", b"\x00"),
+    "L;1": ("L;1", b"\x01", b"\x00"),
+    "L;2": ("L;2", b"\x02", b"\x00"),
+    "L;4": ("L;4", b"\x04", b"\x00"),
+    "L": ("L", b"\x08", b"\x00"),
+    "LA": ("LA", b"\x08", b"\x04"),
+    "I": ("I;16B", b"\x10", b"\x00"),
+    "I;16": ("I;16B", b"\x10", b"\x00"),
+    "I;16B": ("I;16B", b"\x10", b"\x00"),
+    "P;1": ("P;1", b"\x01", b"\x03"),
+    "P;2": ("P;2", b"\x02", b"\x03"),
+    "P;4": ("P;4", b"\x04", b"\x03"),
+    "P": ("P", b"\x08", b"\x03"),
+    "RGB": ("RGB", b"\x08", b"\x02"),
+    "RGBA": ("RGBA", b"\x08", b"\x06"),
 }
 
 
@@ -1294,7 +1294,7 @@ def _save(im, fp, filename, chunk=putchunk, save_all=False):
 
     # get the corresponding PNG mode
     try:
-        rawmode, rawmode_depth_type = _OUTMODES[mode]
+        rawmode, bit_depth, color_type = _OUTMODES[mode]
     except KeyError as e:
         msg = f"cannot write mode {mode} as PNG"
         raise OSError(msg) from e
@@ -1309,7 +1309,8 @@ def _save(im, fp, filename, chunk=putchunk, save_all=False):
         b"IHDR",
         o32(size[0]),  # 0: size
         o32(size[1]),
-        rawmode_depth_type,  # 8: depth/type
+        bit_depth,
+        color_type,
         b"\0",  # 10: compression
         b"\0",  # 11: filter category
         b"\0",  # 12: interlace flag

From 2c4a6e1179a7e2460d3dae9f4558173c547996a7 Mon Sep 17 00:00:00 2001
From: void4 <void4.noreply@github.com>
Date: Mon, 27 May 2024 00:23:16 +0200
Subject: [PATCH 0646/1178] Add function and documentation to draw circle

---
 docs/reference/ImageDraw.rst | 13 +++++++++++++
 src/PIL/ImageDraw.py         |  9 +++++++++
 2 files changed, 22 insertions(+)

diff --git a/docs/reference/ImageDraw.rst b/docs/reference/ImageDraw.rst
index 4ccfacae75e..6987adc881c 100644
--- a/docs/reference/ImageDraw.rst
+++ b/docs/reference/ImageDraw.rst
@@ -240,6 +240,19 @@ Methods
 
         .. versionadded:: 5.3.0
 
+.. py:method:: ImageDraw.circle(xy, radius, fill=None, outline=None, width=1)
+
+    Draws a circle given the center coordinates and a radius.
+
+    :param xy: One point to define the circle center. Sequence:
+        ``[x, y]``
+    :param radius: Radius of the circle
+    :param outline: Color to use for the outline.
+    :param fill: Color to use for the fill.
+    :param width: The line width, in pixels.
+
+        .. versionadded:: ?.?.?
+
 .. py:method:: ImageDraw.line(xy, fill=None, width=0, joint=None)
 
     Draws a line between the coordinates in the ``xy`` list.
diff --git a/src/PIL/ImageDraw.py b/src/PIL/ImageDraw.py
index 42f2ee8c799..4b42b32d0d3 100644
--- a/src/PIL/ImageDraw.py
+++ b/src/PIL/ImageDraw.py
@@ -181,6 +181,15 @@ def ellipse(self, xy: Coords, fill=None, outline=None, width=1) -> None:
         if ink is not None and ink != fill and width != 0:
             self.draw.draw_ellipse(xy, ink, 0, width)
 
+    def circle(self, xy: Coords, radius, fill=None, outline=None, width=1) -> None:
+        """Draw a circle given center coordinates and a radius."""
+        ink, fill = self._getink(outline, fill)
+        ellipse_xy = (xy[0]-radius, xy[1]-radius, xy[0]+radius, xy[1]+radius)
+        if fill is not None:
+            self.draw.draw_ellipse(ellipse_xy, fill, 1)
+        if ink is not None and ink != fill and width != 0:
+            self.draw.draw_ellipse(ellipse_xy, ink, 0, width)
+
     def line(self, xy: Coords, fill=None, width=0, joint=None) -> None:
         """Draw a line, or a connected sequence of line segments."""
         ink = self._getink(fill)[0]

From 2ee3cef50ef6b1917ea3c03ad06849a2a599ee8a Mon Sep 17 00:00:00 2001
From: "pre-commit-ci[bot]"
 <66853113+pre-commit-ci[bot]@users.noreply.github.com>
Date: Sun, 26 May 2024 22:25:13 +0000
Subject: [PATCH 0647/1178] [pre-commit.ci] auto fixes from pre-commit.com
 hooks

for more information, see https://pre-commit.ci
---
 src/PIL/ImageDraw.py | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/src/PIL/ImageDraw.py b/src/PIL/ImageDraw.py
index 4b42b32d0d3..03f2637aefc 100644
--- a/src/PIL/ImageDraw.py
+++ b/src/PIL/ImageDraw.py
@@ -184,7 +184,7 @@ def ellipse(self, xy: Coords, fill=None, outline=None, width=1) -> None:
     def circle(self, xy: Coords, radius, fill=None, outline=None, width=1) -> None:
         """Draw a circle given center coordinates and a radius."""
         ink, fill = self._getink(outline, fill)
-        ellipse_xy = (xy[0]-radius, xy[1]-radius, xy[0]+radius, xy[1]+radius)
+        ellipse_xy = (xy[0] - radius, xy[1] - radius, xy[0] + radius, xy[1] + radius)
         if fill is not None:
             self.draw.draw_ellipse(ellipse_xy, fill, 1)
         if ink is not None and ink != fill and width != 0:

From 930c423db1b4d571755768b0502067676b30eb58 Mon Sep 17 00:00:00 2001
From: Andrew Murray <radarhere@users.noreply.github.com>
Date: Mon, 27 May 2024 17:08:13 +1000
Subject: [PATCH 0648/1178] Added ImageFont.load_default_imagefont()

---
 Tests/test_imagefontpil.py   |  47 +++---
 docs/reference/ImageFont.rst |   1 +
 src/PIL/ImageFont.py         | 273 ++++++++++++++++++-----------------
 3 files changed, 164 insertions(+), 157 deletions(-)

diff --git a/Tests/test_imagefontpil.py b/Tests/test_imagefontpil.py
index 3b1c14b4e18..acbaecab27b 100644
--- a/Tests/test_imagefontpil.py
+++ b/Tests/test_imagefontpil.py
@@ -9,51 +9,54 @@
 
 from .helper import assert_image_equal_tofile
 
-original_core = ImageFont.core
-
-
-def setup_module() -> None:
-    if features.check_module("freetype2"):
-        ImageFont.core = _util.DeferredError(ImportError)
-
-
-def teardown_module() -> None:
-    ImageFont.core = original_core
+fonts = [ImageFont.load_default_imagefont()]
+if not features.check_module("freetype2"):
+    default_font = ImageFont.load_default()
+    if isinstance(default_font, ImageFont.ImageFont):
+        fonts.append(default_font)
 
 
-def test_default_font() -> None:
+@pytest.mark.parametrize("font", fonts)
+def test_default_font(font: ImageFont.ImageFont) -> None:
     # Arrange
     txt = 'This is a "better than nothing" default font.'
     im = Image.new(mode="RGB", size=(300, 100))
     draw = ImageDraw.Draw(im)
 
     # Act
-    default_font = ImageFont.load_default()
-    draw.text((10, 10), txt, font=default_font)
+    draw.text((10, 10), txt, font=font)
 
     # Assert
     assert_image_equal_tofile(im, "Tests/images/default_font.png")
 
 
-def test_size_without_freetype() -> None:
-    with pytest.raises(ImportError):
-        ImageFont.load_default(size=14)
+def test_without_freetype() -> None:
+    original_core = ImageFont.core
+    if features.check_module("freetype2"):
+        ImageFont.core = _util.DeferredError(ImportError)
+    try:
+        assert isinstance(ImageFont.load_default(), ImageFont.ImageFont)
+
+        with pytest.raises(ImportError):
+            ImageFont.load_default(size=14)
+    finally:
+        ImageFont.core = original_core
 
 
-def test_unicode() -> None:
+@pytest.mark.parametrize("font", fonts)
+def test_unicode(font: ImageFont.ImageFont) -> None:
     # should not segfault, should return UnicodeDecodeError
     # issue #2826
-    font = ImageFont.load_default()
     with pytest.raises(UnicodeEncodeError):
         font.getbbox("’")
 
 
-def test_textbbox() -> None:
+@pytest.mark.parametrize("font", fonts)
+def test_textbbox(font: ImageFont.ImageFont) -> None:
     im = Image.new("RGB", (200, 200))
     d = ImageDraw.Draw(im)
-    default_font = ImageFont.load_default()
-    assert d.textlength("test", font=default_font) == 24
-    assert d.textbbox((0, 0), "test", font=default_font) == (0, 0, 24, 11)
+    assert d.textlength("test", font=font) == 24
+    assert d.textbbox((0, 0), "test", font=font) == (0, 0, 24, 11)
 
 
 def test_decompression_bomb() -> None:
diff --git a/docs/reference/ImageFont.rst b/docs/reference/ImageFont.rst
index 6edf4b05c55..edbdd9a32a6 100644
--- a/docs/reference/ImageFont.rst
+++ b/docs/reference/ImageFont.rst
@@ -53,6 +53,7 @@ Functions
 .. autofunction:: PIL.ImageFont.load_path
 .. autofunction:: PIL.ImageFont.truetype
 .. autofunction:: PIL.ImageFont.load_default
+.. autofunction:: PIL.ImageFont.load_default_imagefont
 
 Methods
 -------
diff --git a/src/PIL/ImageFont.py b/src/PIL/ImageFont.py
index ad5f7545925..87ff8315ecb 100644
--- a/src/PIL/ImageFont.py
+++ b/src/PIL/ImageFont.py
@@ -867,6 +867,142 @@ def load_path(filename):
     raise OSError(msg)
 
 
+def load_default_imagefont() -> ImageFont:
+    f = ImageFont()
+    f._load_pilfont_data(
+        # courB08
+        BytesIO(
+            base64.b64decode(
+                b"""
+UElMZm9udAo7Ozs7OzsxMDsKREFUQQoAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAA
+AAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAA
+AAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAA
+AAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAA
+AAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAA
+AAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAA
+AAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAA
+AAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAA
+AAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAA
+AAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAA
+AAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAA
+AAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAYAAAAA//8AAQAAAAAAAAABAAEA
+BgAAAAH/+gADAAAAAQAAAAMABgAGAAAAAf/6AAT//QADAAAABgADAAYAAAAA//kABQABAAYAAAAL
+AAgABgAAAAD/+AAFAAEACwAAABAACQAGAAAAAP/5AAUAAAAQAAAAFQAHAAYAAP////oABQAAABUA
+AAAbAAYABgAAAAH/+QAE//wAGwAAAB4AAwAGAAAAAf/5AAQAAQAeAAAAIQAIAAYAAAAB//kABAAB
+ACEAAAAkAAgABgAAAAD/+QAE//0AJAAAACgABAAGAAAAAP/6AAX//wAoAAAALQAFAAYAAAAB//8A
+BAACAC0AAAAwAAMABgAAAAD//AAF//0AMAAAADUAAQAGAAAAAf//AAMAAAA1AAAANwABAAYAAAAB
+//kABQABADcAAAA7AAgABgAAAAD/+QAFAAAAOwAAAEAABwAGAAAAAP/5AAYAAABAAAAARgAHAAYA
+AAAA//kABQAAAEYAAABLAAcABgAAAAD/+QAFAAAASwAAAFAABwAGAAAAAP/5AAYAAABQAAAAVgAH
+AAYAAAAA//kABQAAAFYAAABbAAcABgAAAAD/+QAFAAAAWwAAAGAABwAGAAAAAP/5AAUAAABgAAAA
+ZQAHAAYAAAAA//kABQAAAGUAAABqAAcABgAAAAD/+QAFAAAAagAAAG8ABwAGAAAAAf/8AAMAAABv
+AAAAcQAEAAYAAAAA//wAAwACAHEAAAB0AAYABgAAAAD/+gAE//8AdAAAAHgABQAGAAAAAP/7AAT/
+/gB4AAAAfAADAAYAAAAB//oABf//AHwAAACAAAUABgAAAAD/+gAFAAAAgAAAAIUABgAGAAAAAP/5
+AAYAAQCFAAAAiwAIAAYAAP////oABgAAAIsAAACSAAYABgAA////+gAFAAAAkgAAAJgABgAGAAAA
+AP/6AAUAAACYAAAAnQAGAAYAAP////oABQAAAJ0AAACjAAYABgAA////+gAFAAAAowAAAKkABgAG
+AAD////6AAUAAACpAAAArwAGAAYAAAAA//oABQAAAK8AAAC0AAYABgAA////+gAGAAAAtAAAALsA
+BgAGAAAAAP/6AAQAAAC7AAAAvwAGAAYAAP////oABQAAAL8AAADFAAYABgAA////+gAGAAAAxQAA
+AMwABgAGAAD////6AAUAAADMAAAA0gAGAAYAAP////oABQAAANIAAADYAAYABgAA////+gAGAAAA
+2AAAAN8ABgAGAAAAAP/6AAUAAADfAAAA5AAGAAYAAP////oABQAAAOQAAADqAAYABgAAAAD/+gAF
+AAEA6gAAAO8ABwAGAAD////6AAYAAADvAAAA9gAGAAYAAAAA//oABQAAAPYAAAD7AAYABgAA////
++gAFAAAA+wAAAQEABgAGAAD////6AAYAAAEBAAABCAAGAAYAAP////oABgAAAQgAAAEPAAYABgAA
+////+gAGAAABDwAAARYABgAGAAAAAP/6AAYAAAEWAAABHAAGAAYAAP////oABgAAARwAAAEjAAYA
+BgAAAAD/+gAFAAABIwAAASgABgAGAAAAAf/5AAQAAQEoAAABKwAIAAYAAAAA//kABAABASsAAAEv
+AAgABgAAAAH/+QAEAAEBLwAAATIACAAGAAAAAP/5AAX//AEyAAABNwADAAYAAAAAAAEABgACATcA
+AAE9AAEABgAAAAH/+QAE//wBPQAAAUAAAwAGAAAAAP/7AAYAAAFAAAABRgAFAAYAAP////kABQAA
+AUYAAAFMAAcABgAAAAD/+wAFAAABTAAAAVEABQAGAAAAAP/5AAYAAAFRAAABVwAHAAYAAAAA//sA
+BQAAAVcAAAFcAAUABgAAAAD/+QAFAAABXAAAAWEABwAGAAAAAP/7AAYAAgFhAAABZwAHAAYAAP//
+//kABQAAAWcAAAFtAAcABgAAAAD/+QAGAAABbQAAAXMABwAGAAAAAP/5AAQAAgFzAAABdwAJAAYA
+AP////kABgAAAXcAAAF+AAcABgAAAAD/+QAGAAABfgAAAYQABwAGAAD////7AAUAAAGEAAABigAF
+AAYAAP////sABQAAAYoAAAGQAAUABgAAAAD/+wAFAAABkAAAAZUABQAGAAD////7AAUAAgGVAAAB
+mwAHAAYAAAAA//sABgACAZsAAAGhAAcABgAAAAD/+wAGAAABoQAAAacABQAGAAAAAP/7AAYAAAGn
+AAABrQAFAAYAAAAA//kABgAAAa0AAAGzAAcABgAA////+wAGAAABswAAAboABQAGAAD////7AAUA
+AAG6AAABwAAFAAYAAP////sABgAAAcAAAAHHAAUABgAAAAD/+wAGAAABxwAAAc0ABQAGAAD////7
+AAYAAgHNAAAB1AAHAAYAAAAA//sABQAAAdQAAAHZAAUABgAAAAH/+QAFAAEB2QAAAd0ACAAGAAAA
+Av/6AAMAAQHdAAAB3gAHAAYAAAAA//kABAABAd4AAAHiAAgABgAAAAD/+wAF//0B4gAAAecAAgAA
+AAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAA
+AAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAA
+AAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAA
+AAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAA
+AAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAA
+AAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAA
+AAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAA
+AAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAA
+AAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAA
+AAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAA
+AAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAA
+AAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAYAAAAB
+//sAAwACAecAAAHpAAcABgAAAAD/+QAFAAEB6QAAAe4ACAAGAAAAAP/5AAYAAAHuAAAB9AAHAAYA
+AAAA//oABf//AfQAAAH5AAUABgAAAAD/+QAGAAAB+QAAAf8ABwAGAAAAAv/5AAMAAgH/AAACAAAJ
+AAYAAAAA//kABQABAgAAAAIFAAgABgAAAAH/+gAE//sCBQAAAggAAQAGAAAAAP/5AAYAAAIIAAAC
+DgAHAAYAAAAB//kABf/+Ag4AAAISAAUABgAA////+wAGAAACEgAAAhkABQAGAAAAAP/7AAX//gIZ
+AAACHgADAAYAAAAA//wABf/9Ah4AAAIjAAEABgAAAAD/+QAHAAACIwAAAioABwAGAAAAAP/6AAT/
++wIqAAACLgABAAYAAAAA//kABP/8Ai4AAAIyAAMABgAAAAD/+gAFAAACMgAAAjcABgAGAAAAAf/5
+AAT//QI3AAACOgAEAAYAAAAB//kABP/9AjoAAAI9AAQABgAAAAL/+QAE//sCPQAAAj8AAgAGAAD/
+///7AAYAAgI/AAACRgAHAAYAAAAA//kABgABAkYAAAJMAAgABgAAAAH//AAD//0CTAAAAk4AAQAG
+AAAAAf//AAQAAgJOAAACUQADAAYAAAAB//kABP/9AlEAAAJUAAQABgAAAAH/+QAF//4CVAAAAlgA
+BQAGAAD////7AAYAAAJYAAACXwAFAAYAAP////kABgAAAl8AAAJmAAcABgAA////+QAGAAACZgAA
+Am0ABwAGAAD////5AAYAAAJtAAACdAAHAAYAAAAA//sABQACAnQAAAJ5AAcABgAA////9wAGAAAC
+eQAAAoAACQAGAAD////3AAYAAAKAAAAChwAJAAYAAP////cABgAAAocAAAKOAAkABgAA////9wAG
+AAACjgAAApUACQAGAAD////4AAYAAAKVAAACnAAIAAYAAP////cABgAAApwAAAKjAAkABgAA////
++gAGAAACowAAAqoABgAGAAAAAP/6AAUAAgKqAAACrwAIAAYAAP////cABQAAAq8AAAK1AAkABgAA
+////9wAFAAACtQAAArsACQAGAAD////3AAUAAAK7AAACwQAJAAYAAP////gABQAAAsEAAALHAAgA
+BgAAAAD/9wAEAAACxwAAAssACQAGAAAAAP/3AAQAAALLAAACzwAJAAYAAAAA//cABAAAAs8AAALT
+AAkABgAAAAD/+AAEAAAC0wAAAtcACAAGAAD////6AAUAAALXAAAC3QAGAAYAAP////cABgAAAt0A
+AALkAAkABgAAAAD/9wAFAAAC5AAAAukACQAGAAAAAP/3AAUAAALpAAAC7gAJAAYAAAAA//cABQAA
+Au4AAALzAAkABgAAAAD/9wAFAAAC8wAAAvgACQAGAAAAAP/4AAUAAAL4AAAC/QAIAAYAAAAA//oA
+Bf//Av0AAAMCAAUABgAA////+gAGAAADAgAAAwkABgAGAAD////3AAYAAAMJAAADEAAJAAYAAP//
+//cABgAAAxAAAAMXAAkABgAA////9wAGAAADFwAAAx4ACQAGAAD////4AAYAAAAAAAoABwASAAYA
+AP////cABgAAAAcACgAOABMABgAA////+gAFAAAADgAKABQAEAAGAAD////6AAYAAAAUAAoAGwAQ
+AAYAAAAA//gABgAAABsACgAhABIABgAAAAD/+AAGAAAAIQAKACcAEgAGAAAAAP/4AAYAAAAnAAoA
+LQASAAYAAAAA//gABgAAAC0ACgAzABIABgAAAAD/+QAGAAAAMwAKADkAEQAGAAAAAP/3AAYAAAA5
+AAoAPwATAAYAAP////sABQAAAD8ACgBFAA8ABgAAAAD/+wAFAAIARQAKAEoAEQAGAAAAAP/4AAUA
+AABKAAoATwASAAYAAAAA//gABQAAAE8ACgBUABIABgAAAAD/+AAFAAAAVAAKAFkAEgAGAAAAAP/5
+AAUAAABZAAoAXgARAAYAAAAA//gABgAAAF4ACgBkABIABgAAAAD/+AAGAAAAZAAKAGoAEgAGAAAA
+AP/4AAYAAABqAAoAcAASAAYAAAAA//kABgAAAHAACgB2ABEABgAAAAD/+AAFAAAAdgAKAHsAEgAG
+AAD////4AAYAAAB7AAoAggASAAYAAAAA//gABQAAAIIACgCHABIABgAAAAD/+AAFAAAAhwAKAIwA
+EgAGAAAAAP/4AAUAAACMAAoAkQASAAYAAAAA//gABQAAAJEACgCWABIABgAAAAD/+QAFAAAAlgAK
+AJsAEQAGAAAAAP/6AAX//wCbAAoAoAAPAAYAAAAA//oABQABAKAACgClABEABgAA////+AAGAAAA
+pQAKAKwAEgAGAAD////4AAYAAACsAAoAswASAAYAAP////gABgAAALMACgC6ABIABgAA////+QAG
+AAAAugAKAMEAEQAGAAD////4AAYAAgDBAAoAyAAUAAYAAP////kABQACAMgACgDOABMABgAA////
++QAGAAIAzgAKANUAEw==
+"""
+            )
+        ),
+        Image.open(
+            BytesIO(
+                base64.b64decode(
+                    b"""
+iVBORw0KGgoAAAANSUhEUgAAAx4AAAAUAQAAAAArMtZoAAAEwElEQVR4nABlAJr/AHVE4czCI/4u
+Mc4b7vuds/xzjz5/3/7u/n9vMe7vnfH/9++vPn/xyf5zhxzjt8GHw8+2d83u8x27199/nxuQ6Od9
+M43/5z2I+9n9ZtmDBwMQECDRQw/eQIQohJXxpBCNVE6QCCAAAAD//wBlAJr/AgALyj1t/wINwq0g
+LeNZUworuN1cjTPIzrTX6ofHWeo3v336qPzfEwRmBnHTtf95/fglZK5N0PDgfRTslpGBvz7LFc4F
+IUXBWQGjQ5MGCx34EDFPwXiY4YbYxavpnhHFrk14CDAAAAD//wBlAJr/AgKqRooH2gAgPeggvUAA
+Bu2WfgPoAwzRAABAAAAAAACQgLz/3Uv4Gv+gX7BJgDeeGP6AAAD1NMDzKHD7ANWr3loYbxsAD791
+NAADfcoIDyP44K/jv4Y63/Z+t98Ovt+ub4T48LAAAAD//wBlAJr/AuplMlADJAAAAGuAphWpqhMx
+in0A/fRvAYBABPgBwBUgABBQ/sYAyv9g0bCHgOLoGAAAAAAAREAAwI7nr0ArYpow7aX8//9LaP/9
+SjdavWA8ePHeBIKB//81/83ndznOaXx379wAAAD//wBlAJr/AqDxW+D3AABAAbUh/QMnbQag/gAY
+AYDAAACgtgD/gOqAAAB5IA/8AAAk+n9w0AAA8AAAmFRJuPo27ciC0cD5oeW4E7KA/wD3ECMAn2tt
+y8PgwH8AfAxFzC0JzeAMtratAsC/ffwAAAD//wBlAJr/BGKAyCAA4AAAAvgeYTAwHd1kmQF5chkG
+ABoMIHcL5xVpTfQbUqzlAAAErwAQBgAAEOClA5D9il08AEh/tUzdCBsXkbgACED+woQg8Si9VeqY
+lODCn7lmF6NhnAEYgAAA/NMIAAAAAAD//2JgjLZgVGBg5Pv/Tvpc8hwGBjYGJADjHDrAwPzAjv/H
+/Wf3PzCwtzcwHmBgYGcwbZz8wHaCAQMDOwMDQ8MCBgYOC3W7mp+f0w+wHOYxO3OG+e376hsMZjk3
+AAAAAP//YmCMY2A4wMAIN5e5gQETPD6AZisDAwMDgzSDAAPjByiHcQMDAwMDg1nOze1lByRu5/47
+c4859311AYNZzg0AAAAA//9iYGDBYihOIIMuwIjGL39/fwffA8b//xv/P2BPtzzHwCBjUQAAAAD/
+/yLFBrIBAAAA//9i1HhcwdhizX7u8NZNzyLbvT97bfrMf/QHI8evOwcSqGUJAAAA//9iYBB81iSw
+pEE170Qrg5MIYydHqwdDQRMrAwcVrQAAAAD//2J4x7j9AAMDn8Q/BgYLBoaiAwwMjPdvMDBYM1Tv
+oJodAAAAAP//Yqo/83+dxePWlxl3npsel9lvLfPcqlE9725C+acfVLMEAAAA//9i+s9gwCoaaGMR
+evta/58PTEWzr21hufPjA8N+qlnBwAAAAAD//2JiWLci5v1+HmFXDqcnULE/MxgYGBj+f6CaJQAA
+AAD//2Ji2FrkY3iYpYC5qDeGgeEMAwPDvwQBBoYvcTwOVLMEAAAA//9isDBgkP///0EOg9z35v//
+Gc/eeW7BwPj5+QGZhANUswMAAAD//2JgqGBgYGBgqEMXlvhMPUsAAAAA//8iYDd1AAAAAP//AwDR
+w7IkEbzhVQAAAABJRU5ErkJggg==
+"""
+                )
+            )
+        ),
+    )
+    return f
+
+
 def load_default(size: float | None = None) -> FreeTypeFont | ImageFont:
     """If FreeType support is available, load a version of Aileron Regular,
     https://dotcolon.net/font/aileron, with a more limited character set.
@@ -882,7 +1018,7 @@ def load_default(size: float | None = None) -> FreeTypeFont | ImageFont:
     :return: A font object.
     """
     if core.__class__.__name__ == "module" or size is not None:
-        f = truetype(
+        return truetype(
             BytesIO(
                 base64.b64decode(
                     b"""
@@ -1112,137 +1248,4 @@ def load_default(size: float | None = None) -> FreeTypeFont | ImageFont:
             10 if size is None else size,
             layout_engine=Layout.BASIC,
         )
-    else:
-        f = ImageFont()
-        f._load_pilfont_data(
-            # courB08
-            BytesIO(
-                base64.b64decode(
-                    b"""
-UElMZm9udAo7Ozs7OzsxMDsKREFUQQoAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAA
-AAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAA
-AAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAA
-AAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAA
-AAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAA
-AAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAA
-AAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAA
-AAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAA
-AAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAA
-AAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAA
-AAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAA
-AAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAYAAAAA//8AAQAAAAAAAAABAAEA
-BgAAAAH/+gADAAAAAQAAAAMABgAGAAAAAf/6AAT//QADAAAABgADAAYAAAAA//kABQABAAYAAAAL
-AAgABgAAAAD/+AAFAAEACwAAABAACQAGAAAAAP/5AAUAAAAQAAAAFQAHAAYAAP////oABQAAABUA
-AAAbAAYABgAAAAH/+QAE//wAGwAAAB4AAwAGAAAAAf/5AAQAAQAeAAAAIQAIAAYAAAAB//kABAAB
-ACEAAAAkAAgABgAAAAD/+QAE//0AJAAAACgABAAGAAAAAP/6AAX//wAoAAAALQAFAAYAAAAB//8A
-BAACAC0AAAAwAAMABgAAAAD//AAF//0AMAAAADUAAQAGAAAAAf//AAMAAAA1AAAANwABAAYAAAAB
-//kABQABADcAAAA7AAgABgAAAAD/+QAFAAAAOwAAAEAABwAGAAAAAP/5AAYAAABAAAAARgAHAAYA
-AAAA//kABQAAAEYAAABLAAcABgAAAAD/+QAFAAAASwAAAFAABwAGAAAAAP/5AAYAAABQAAAAVgAH
-AAYAAAAA//kABQAAAFYAAABbAAcABgAAAAD/+QAFAAAAWwAAAGAABwAGAAAAAP/5AAUAAABgAAAA
-ZQAHAAYAAAAA//kABQAAAGUAAABqAAcABgAAAAD/+QAFAAAAagAAAG8ABwAGAAAAAf/8AAMAAABv
-AAAAcQAEAAYAAAAA//wAAwACAHEAAAB0AAYABgAAAAD/+gAE//8AdAAAAHgABQAGAAAAAP/7AAT/
-/gB4AAAAfAADAAYAAAAB//oABf//AHwAAACAAAUABgAAAAD/+gAFAAAAgAAAAIUABgAGAAAAAP/5
-AAYAAQCFAAAAiwAIAAYAAP////oABgAAAIsAAACSAAYABgAA////+gAFAAAAkgAAAJgABgAGAAAA
-AP/6AAUAAACYAAAAnQAGAAYAAP////oABQAAAJ0AAACjAAYABgAA////+gAFAAAAowAAAKkABgAG
-AAD////6AAUAAACpAAAArwAGAAYAAAAA//oABQAAAK8AAAC0AAYABgAA////+gAGAAAAtAAAALsA
-BgAGAAAAAP/6AAQAAAC7AAAAvwAGAAYAAP////oABQAAAL8AAADFAAYABgAA////+gAGAAAAxQAA
-AMwABgAGAAD////6AAUAAADMAAAA0gAGAAYAAP////oABQAAANIAAADYAAYABgAA////+gAGAAAA
-2AAAAN8ABgAGAAAAAP/6AAUAAADfAAAA5AAGAAYAAP////oABQAAAOQAAADqAAYABgAAAAD/+gAF
-AAEA6gAAAO8ABwAGAAD////6AAYAAADvAAAA9gAGAAYAAAAA//oABQAAAPYAAAD7AAYABgAA////
-+gAFAAAA+wAAAQEABgAGAAD////6AAYAAAEBAAABCAAGAAYAAP////oABgAAAQgAAAEPAAYABgAA
-////+gAGAAABDwAAARYABgAGAAAAAP/6AAYAAAEWAAABHAAGAAYAAP////oABgAAARwAAAEjAAYA
-BgAAAAD/+gAFAAABIwAAASgABgAGAAAAAf/5AAQAAQEoAAABKwAIAAYAAAAA//kABAABASsAAAEv
-AAgABgAAAAH/+QAEAAEBLwAAATIACAAGAAAAAP/5AAX//AEyAAABNwADAAYAAAAAAAEABgACATcA
-AAE9AAEABgAAAAH/+QAE//wBPQAAAUAAAwAGAAAAAP/7AAYAAAFAAAABRgAFAAYAAP////kABQAA
-AUYAAAFMAAcABgAAAAD/+wAFAAABTAAAAVEABQAGAAAAAP/5AAYAAAFRAAABVwAHAAYAAAAA//sA
-BQAAAVcAAAFcAAUABgAAAAD/+QAFAAABXAAAAWEABwAGAAAAAP/7AAYAAgFhAAABZwAHAAYAAP//
-//kABQAAAWcAAAFtAAcABgAAAAD/+QAGAAABbQAAAXMABwAGAAAAAP/5AAQAAgFzAAABdwAJAAYA
-AP////kABgAAAXcAAAF+AAcABgAAAAD/+QAGAAABfgAAAYQABwAGAAD////7AAUAAAGEAAABigAF
-AAYAAP////sABQAAAYoAAAGQAAUABgAAAAD/+wAFAAABkAAAAZUABQAGAAD////7AAUAAgGVAAAB
-mwAHAAYAAAAA//sABgACAZsAAAGhAAcABgAAAAD/+wAGAAABoQAAAacABQAGAAAAAP/7AAYAAAGn
-AAABrQAFAAYAAAAA//kABgAAAa0AAAGzAAcABgAA////+wAGAAABswAAAboABQAGAAD////7AAUA
-AAG6AAABwAAFAAYAAP////sABgAAAcAAAAHHAAUABgAAAAD/+wAGAAABxwAAAc0ABQAGAAD////7
-AAYAAgHNAAAB1AAHAAYAAAAA//sABQAAAdQAAAHZAAUABgAAAAH/+QAFAAEB2QAAAd0ACAAGAAAA
-Av/6AAMAAQHdAAAB3gAHAAYAAAAA//kABAABAd4AAAHiAAgABgAAAAD/+wAF//0B4gAAAecAAgAA
-AAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAA
-AAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAA
-AAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAA
-AAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAA
-AAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAA
-AAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAA
-AAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAA
-AAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAA
-AAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAA
-AAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAA
-AAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAA
-AAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAYAAAAB
-//sAAwACAecAAAHpAAcABgAAAAD/+QAFAAEB6QAAAe4ACAAGAAAAAP/5AAYAAAHuAAAB9AAHAAYA
-AAAA//oABf//AfQAAAH5AAUABgAAAAD/+QAGAAAB+QAAAf8ABwAGAAAAAv/5AAMAAgH/AAACAAAJ
-AAYAAAAA//kABQABAgAAAAIFAAgABgAAAAH/+gAE//sCBQAAAggAAQAGAAAAAP/5AAYAAAIIAAAC
-DgAHAAYAAAAB//kABf/+Ag4AAAISAAUABgAA////+wAGAAACEgAAAhkABQAGAAAAAP/7AAX//gIZ
-AAACHgADAAYAAAAA//wABf/9Ah4AAAIjAAEABgAAAAD/+QAHAAACIwAAAioABwAGAAAAAP/6AAT/
-+wIqAAACLgABAAYAAAAA//kABP/8Ai4AAAIyAAMABgAAAAD/+gAFAAACMgAAAjcABgAGAAAAAf/5
-AAT//QI3AAACOgAEAAYAAAAB//kABP/9AjoAAAI9AAQABgAAAAL/+QAE//sCPQAAAj8AAgAGAAD/
-///7AAYAAgI/AAACRgAHAAYAAAAA//kABgABAkYAAAJMAAgABgAAAAH//AAD//0CTAAAAk4AAQAG
-AAAAAf//AAQAAgJOAAACUQADAAYAAAAB//kABP/9AlEAAAJUAAQABgAAAAH/+QAF//4CVAAAAlgA
-BQAGAAD////7AAYAAAJYAAACXwAFAAYAAP////kABgAAAl8AAAJmAAcABgAA////+QAGAAACZgAA
-Am0ABwAGAAD////5AAYAAAJtAAACdAAHAAYAAAAA//sABQACAnQAAAJ5AAcABgAA////9wAGAAAC
-eQAAAoAACQAGAAD////3AAYAAAKAAAAChwAJAAYAAP////cABgAAAocAAAKOAAkABgAA////9wAG
-AAACjgAAApUACQAGAAD////4AAYAAAKVAAACnAAIAAYAAP////cABgAAApwAAAKjAAkABgAA////
-+gAGAAACowAAAqoABgAGAAAAAP/6AAUAAgKqAAACrwAIAAYAAP////cABQAAAq8AAAK1AAkABgAA
-////9wAFAAACtQAAArsACQAGAAD////3AAUAAAK7AAACwQAJAAYAAP////gABQAAAsEAAALHAAgA
-BgAAAAD/9wAEAAACxwAAAssACQAGAAAAAP/3AAQAAALLAAACzwAJAAYAAAAA//cABAAAAs8AAALT
-AAkABgAAAAD/+AAEAAAC0wAAAtcACAAGAAD////6AAUAAALXAAAC3QAGAAYAAP////cABgAAAt0A
-AALkAAkABgAAAAD/9wAFAAAC5AAAAukACQAGAAAAAP/3AAUAAALpAAAC7gAJAAYAAAAA//cABQAA
-Au4AAALzAAkABgAAAAD/9wAFAAAC8wAAAvgACQAGAAAAAP/4AAUAAAL4AAAC/QAIAAYAAAAA//oA
-Bf//Av0AAAMCAAUABgAA////+gAGAAADAgAAAwkABgAGAAD////3AAYAAAMJAAADEAAJAAYAAP//
-//cABgAAAxAAAAMXAAkABgAA////9wAGAAADFwAAAx4ACQAGAAD////4AAYAAAAAAAoABwASAAYA
-AP////cABgAAAAcACgAOABMABgAA////+gAFAAAADgAKABQAEAAGAAD////6AAYAAAAUAAoAGwAQ
-AAYAAAAA//gABgAAABsACgAhABIABgAAAAD/+AAGAAAAIQAKACcAEgAGAAAAAP/4AAYAAAAnAAoA
-LQASAAYAAAAA//gABgAAAC0ACgAzABIABgAAAAD/+QAGAAAAMwAKADkAEQAGAAAAAP/3AAYAAAA5
-AAoAPwATAAYAAP////sABQAAAD8ACgBFAA8ABgAAAAD/+wAFAAIARQAKAEoAEQAGAAAAAP/4AAUA
-AABKAAoATwASAAYAAAAA//gABQAAAE8ACgBUABIABgAAAAD/+AAFAAAAVAAKAFkAEgAGAAAAAP/5
-AAUAAABZAAoAXgARAAYAAAAA//gABgAAAF4ACgBkABIABgAAAAD/+AAGAAAAZAAKAGoAEgAGAAAA
-AP/4AAYAAABqAAoAcAASAAYAAAAA//kABgAAAHAACgB2ABEABgAAAAD/+AAFAAAAdgAKAHsAEgAG
-AAD////4AAYAAAB7AAoAggASAAYAAAAA//gABQAAAIIACgCHABIABgAAAAD/+AAFAAAAhwAKAIwA
-EgAGAAAAAP/4AAUAAACMAAoAkQASAAYAAAAA//gABQAAAJEACgCWABIABgAAAAD/+QAFAAAAlgAK
-AJsAEQAGAAAAAP/6AAX//wCbAAoAoAAPAAYAAAAA//oABQABAKAACgClABEABgAA////+AAGAAAA
-pQAKAKwAEgAGAAD////4AAYAAACsAAoAswASAAYAAP////gABgAAALMACgC6ABIABgAA////+QAG
-AAAAugAKAMEAEQAGAAD////4AAYAAgDBAAoAyAAUAAYAAP////kABQACAMgACgDOABMABgAA////
-+QAGAAIAzgAKANUAEw==
-"""
-                )
-            ),
-            Image.open(
-                BytesIO(
-                    base64.b64decode(
-                        b"""
-iVBORw0KGgoAAAANSUhEUgAAAx4AAAAUAQAAAAArMtZoAAAEwElEQVR4nABlAJr/AHVE4czCI/4u
-Mc4b7vuds/xzjz5/3/7u/n9vMe7vnfH/9++vPn/xyf5zhxzjt8GHw8+2d83u8x27199/nxuQ6Od9
-M43/5z2I+9n9ZtmDBwMQECDRQw/eQIQohJXxpBCNVE6QCCAAAAD//wBlAJr/AgALyj1t/wINwq0g
-LeNZUworuN1cjTPIzrTX6ofHWeo3v336qPzfEwRmBnHTtf95/fglZK5N0PDgfRTslpGBvz7LFc4F
-IUXBWQGjQ5MGCx34EDFPwXiY4YbYxavpnhHFrk14CDAAAAD//wBlAJr/AgKqRooH2gAgPeggvUAA
-Bu2WfgPoAwzRAABAAAAAAACQgLz/3Uv4Gv+gX7BJgDeeGP6AAAD1NMDzKHD7ANWr3loYbxsAD791
-NAADfcoIDyP44K/jv4Y63/Z+t98Ovt+ub4T48LAAAAD//wBlAJr/AuplMlADJAAAAGuAphWpqhMx
-in0A/fRvAYBABPgBwBUgABBQ/sYAyv9g0bCHgOLoGAAAAAAAREAAwI7nr0ArYpow7aX8//9LaP/9
-SjdavWA8ePHeBIKB//81/83ndznOaXx379wAAAD//wBlAJr/AqDxW+D3AABAAbUh/QMnbQag/gAY
-AYDAAACgtgD/gOqAAAB5IA/8AAAk+n9w0AAA8AAAmFRJuPo27ciC0cD5oeW4E7KA/wD3ECMAn2tt
-y8PgwH8AfAxFzC0JzeAMtratAsC/ffwAAAD//wBlAJr/BGKAyCAA4AAAAvgeYTAwHd1kmQF5chkG
-ABoMIHcL5xVpTfQbUqzlAAAErwAQBgAAEOClA5D9il08AEh/tUzdCBsXkbgACED+woQg8Si9VeqY
-lODCn7lmF6NhnAEYgAAA/NMIAAAAAAD//2JgjLZgVGBg5Pv/Tvpc8hwGBjYGJADjHDrAwPzAjv/H
-/Wf3PzCwtzcwHmBgYGcwbZz8wHaCAQMDOwMDQ8MCBgYOC3W7mp+f0w+wHOYxO3OG+e376hsMZjk3
-AAAAAP//YmCMY2A4wMAIN5e5gQETPD6AZisDAwMDgzSDAAPjByiHcQMDAwMDg1nOze1lByRu5/47
-c4859311AYNZzg0AAAAA//9iYGDBYihOIIMuwIjGL39/fwffA8b//xv/P2BPtzzHwCBjUQAAAAD/
-/yLFBrIBAAAA//9i1HhcwdhizX7u8NZNzyLbvT97bfrMf/QHI8evOwcSqGUJAAAA//9iYBB81iSw
-pEE170Qrg5MIYydHqwdDQRMrAwcVrQAAAAD//2J4x7j9AAMDn8Q/BgYLBoaiAwwMjPdvMDBYM1Tv
-oJodAAAAAP//Yqo/83+dxePWlxl3npsel9lvLfPcqlE9725C+acfVLMEAAAA//9i+s9gwCoaaGMR
-evta/58PTEWzr21hufPjA8N+qlnBwAAAAAD//2JiWLci5v1+HmFXDqcnULE/MxgYGBj+f6CaJQAA
-AAD//2Ji2FrkY3iYpYC5qDeGgeEMAwPDvwQBBoYvcTwOVLMEAAAA//9isDBgkP///0EOg9z35v//
-Gc/eeW7BwPj5+QGZhANUswMAAAD//2JgqGBgYGBgqEMXlvhMPUsAAAAA//8iYDd1AAAAAP//AwDR
-w7IkEbzhVQAAAABJRU5ErkJggg==
-"""
-                    )
-                )
-            ),
-        )
-    return f
+    return load_default_imagefont()

From f34360d1e3c8f29f1a0b0ccae62b5f7c95700440 Mon Sep 17 00:00:00 2001
From: Andrew Murray <radarhere@users.noreply.github.com>
Date: Mon, 27 May 2024 18:09:46 +1000
Subject: [PATCH 0649/1178] When saving multiple frames, convert to mode rather
 than raw mode

---
 Tests/test_file_png.py    |  5 +++--
 src/PIL/PngImagePlugin.py | 17 +++++++++--------
 2 files changed, 12 insertions(+), 10 deletions(-)

diff --git a/Tests/test_file_png.py b/Tests/test_file_png.py
index 19462dcb5a4..55db5ef852f 100644
--- a/Tests/test_file_png.py
+++ b/Tests/test_file_png.py
@@ -655,11 +655,12 @@ def test_truncated_chunks(self, cid: bytes) -> None:
             png.call(cid, 0, 0)
             ImageFile.LOAD_TRUNCATED_IMAGES = False
 
-    def test_specify_bits(self, tmp_path: Path) -> None:
+    @pytest.mark.parametrize("save_all", (True, False))
+    def test_specify_bits(self, save_all: bool, tmp_path: Path) -> None:
         im = hopper("P")
 
         out = str(tmp_path / "temp.png")
-        im.save(out, bits=4)
+        im.save(out, bits=4, save_all=save_all)
 
         with Image.open(out) as reloaded:
             assert len(reloaded.png.im_palette[1]) == 48
diff --git a/src/PIL/PngImagePlugin.py b/src/PIL/PngImagePlugin.py
index 0d5751962c0..6b6c01d1b8e 100644
--- a/src/PIL/PngImagePlugin.py
+++ b/src/PIL/PngImagePlugin.py
@@ -1104,7 +1104,7 @@ def write(self, data: bytes) -> None:
         self.seq_num += 1
 
 
-def _write_multiple_frames(im, fp, chunk, rawmode, default_image, append_images):
+def _write_multiple_frames(im, fp, chunk, mode, rawmode, default_image, append_images):
     duration = im.encoderinfo.get("duration", im.info.get("duration", 0))
     loop = im.encoderinfo.get("loop", im.info.get("loop", 0))
     disposal = im.encoderinfo.get("disposal", im.info.get("disposal", Disposal.OP_NONE))
@@ -1119,10 +1119,10 @@ def _write_multiple_frames(im, fp, chunk, rawmode, default_image, append_images)
     frame_count = 0
     for im_seq in chain:
         for im_frame in ImageSequence.Iterator(im_seq):
-            if im_frame.mode == rawmode:
+            if im_frame.mode == mode:
                 im_frame = im_frame.copy()
             else:
-                im_frame = im_frame.convert(rawmode)
+                im_frame = im_frame.convert(mode)
             encoderinfo = im.encoderinfo.copy()
             if isinstance(duration, (list, tuple)):
                 encoderinfo["duration"] = duration[frame_count]
@@ -1184,8 +1184,8 @@ def _write_multiple_frames(im, fp, chunk, rawmode, default_image, append_images)
 
     # default image IDAT (if it exists)
     if default_image:
-        if im.mode != rawmode:
-            im = im.convert(rawmode)
+        if im.mode != mode:
+            im = im.convert(mode)
         ImageFile._save(im, _idat(fp, chunk), [("zip", (0, 0) + im.size, 0, rawmode)])
 
     seq_num = 0
@@ -1262,6 +1262,7 @@ def _save(im, fp, filename, chunk=putchunk, save_all=False):
         size = im.size
         mode = im.mode
 
+    outmode = mode
     if mode == "P":
         #
         # attempt to minimize storage requirements for palette images
@@ -1282,7 +1283,7 @@ def _save(im, fp, filename, chunk=putchunk, save_all=False):
                 bits = 2
             else:
                 bits = 4
-            mode = f"{mode};{bits}"
+            outmode += f";{bits}"
 
     # encoder options
     im.encoderconfig = (
@@ -1294,7 +1295,7 @@ def _save(im, fp, filename, chunk=putchunk, save_all=False):
 
     # get the corresponding PNG mode
     try:
-        rawmode, bit_depth, color_type = _OUTMODES[mode]
+        rawmode, bit_depth, color_type = _OUTMODES[outmode]
     except KeyError as e:
         msg = f"cannot write mode {mode} as PNG"
         raise OSError(msg) from e
@@ -1415,7 +1416,7 @@ def _save(im, fp, filename, chunk=putchunk, save_all=False):
 
     if save_all:
         im = _write_multiple_frames(
-            im, fp, chunk, rawmode, default_image, append_images
+            im, fp, chunk, mode, rawmode, default_image, append_images
         )
     if im:
         ImageFile._save(im, _idat(fp, chunk), [("zip", (0, 0) + im.size, 0, rawmode)])

From 8d9a4dda980f02ff93fa2301d906ef32602c5e07 Mon Sep 17 00:00:00 2001
From: void4 <void4@users.noreply.github.com>
Date: Mon, 27 May 2024 12:57:50 +0200
Subject: [PATCH 0650/1178] Update docs/reference/ImageDraw.rst - Set
 versionadded

Co-authored-by: Hugo van Kemenade <1324225+hugovk@users.noreply.github.com>
---
 docs/reference/ImageDraw.rst | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/docs/reference/ImageDraw.rst b/docs/reference/ImageDraw.rst
index 6987adc881c..51d5965dbca 100644
--- a/docs/reference/ImageDraw.rst
+++ b/docs/reference/ImageDraw.rst
@@ -251,7 +251,7 @@ Methods
     :param fill: Color to use for the fill.
     :param width: The line width, in pixels.
 
-        .. versionadded:: ?.?.?
+        .. versionadded:: 10.4.0
 
 .. py:method:: ImageDraw.line(xy, fill=None, width=0, joint=None)
 

From 38e6913579c3c7c04bb40384cd7eb797130c5dd8 Mon Sep 17 00:00:00 2001
From: void4 <void4@users.noreply.github.com>
Date: Mon, 27 May 2024 13:01:10 +0200
Subject: [PATCH 0651/1178] Simplify circle() by reusing ellipse()

---
 src/PIL/ImageDraw.py | 6 +-----
 1 file changed, 1 insertion(+), 5 deletions(-)

diff --git a/src/PIL/ImageDraw.py b/src/PIL/ImageDraw.py
index 03f2637aefc..b270cc6baf8 100644
--- a/src/PIL/ImageDraw.py
+++ b/src/PIL/ImageDraw.py
@@ -183,12 +183,8 @@ def ellipse(self, xy: Coords, fill=None, outline=None, width=1) -> None:
 
     def circle(self, xy: Coords, radius, fill=None, outline=None, width=1) -> None:
         """Draw a circle given center coordinates and a radius."""
-        ink, fill = self._getink(outline, fill)
         ellipse_xy = (xy[0] - radius, xy[1] - radius, xy[0] + radius, xy[1] + radius)
-        if fill is not None:
-            self.draw.draw_ellipse(ellipse_xy, fill, 1)
-        if ink is not None and ink != fill and width != 0:
-            self.draw.draw_ellipse(ellipse_xy, ink, 0, width)
+        self.ellipse(ellipse_xy, fill, outline, width)
 
     def line(self, xy: Coords, fill=None, width=0, joint=None) -> None:
         """Draw a line, or a connected sequence of line segments."""

From 35a700a1d4b2de51c8e13d4b60736f765b8b816b Mon Sep 17 00:00:00 2001
From: void4 <void4@users.noreply.github.com>
Date: Mon, 27 May 2024 13:14:04 +0200
Subject: [PATCH 0652/1178] Update 10.4.0.rst - Add PIL.ImageDraw.circle() API
 addition

---
 docs/releasenotes/10.4.0.rst | 4 ++++
 1 file changed, 4 insertions(+)

diff --git a/docs/releasenotes/10.4.0.rst b/docs/releasenotes/10.4.0.rst
index 41f33102fdd..3c42588014c 100644
--- a/docs/releasenotes/10.4.0.rst
+++ b/docs/releasenotes/10.4.0.rst
@@ -45,6 +45,10 @@ TODO
 API Additions
 =============
 
+Added PIL.ImageDraw.circle()
+^^^^^^^^^^^^^^^^^^^^^^^^^^^^
+Given the circle center coordinate pair and a radius, plots a circle using PIL.ImageDraw.ellipse()
+
 TODO
 ^^^^
 

From 773ff20b762247a9fa717683f5e89349830def7e Mon Sep 17 00:00:00 2001
From: void4 <void4@users.noreply.github.com>
Date: Mon, 27 May 2024 13:18:47 +0200
Subject: [PATCH 0653/1178] Update docs/reference/ImageDraw.rst - move circle
 method up to indicate it is new

Co-authored-by: Hugo van Kemenade <1324225+hugovk@users.noreply.github.com>
---
 docs/reference/ImageDraw.rst | 2 ++
 1 file changed, 2 insertions(+)

diff --git a/docs/reference/ImageDraw.rst b/docs/reference/ImageDraw.rst
index 51d5965dbca..ed762c8d69c 100644
--- a/docs/reference/ImageDraw.rst
+++ b/docs/reference/ImageDraw.rst
@@ -243,6 +243,8 @@ Methods
 .. py:method:: ImageDraw.circle(xy, radius, fill=None, outline=None, width=1)
 
     Draws a circle given the center coordinates and a radius.
+    
+    .. versionadded:: 10.4.0
 
     :param xy: One point to define the circle center. Sequence:
         ``[x, y]``

From 034f3cbed522b862b07bf938bbce0a599018bc57 Mon Sep 17 00:00:00 2001
From: "pre-commit-ci[bot]"
 <66853113+pre-commit-ci[bot]@users.noreply.github.com>
Date: Mon, 27 May 2024 11:19:09 +0000
Subject: [PATCH 0654/1178] [pre-commit.ci] auto fixes from pre-commit.com
 hooks

for more information, see https://pre-commit.ci
---
 docs/reference/ImageDraw.rst | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/docs/reference/ImageDraw.rst b/docs/reference/ImageDraw.rst
index ed762c8d69c..4996acf7160 100644
--- a/docs/reference/ImageDraw.rst
+++ b/docs/reference/ImageDraw.rst
@@ -243,7 +243,7 @@ Methods
 .. py:method:: ImageDraw.circle(xy, radius, fill=None, outline=None, width=1)
 
     Draws a circle given the center coordinates and a radius.
-    
+
     .. versionadded:: 10.4.0
 
     :param xy: One point to define the circle center. Sequence:

From 9b7556228e0f045495f6b3dd2fd22e84b65ab0eb Mon Sep 17 00:00:00 2001
From: void4 <void4@users.noreply.github.com>
Date: Mon, 27 May 2024 13:21:41 +0200
Subject: [PATCH 0655/1178] Update docs/reference/ImageDraw.rst - move
 versionadded

Co-authored-by: Hugo van Kemenade <1324225+hugovk@users.noreply.github.com>
---
 docs/reference/ImageDraw.rst | 2 --
 1 file changed, 2 deletions(-)

diff --git a/docs/reference/ImageDraw.rst b/docs/reference/ImageDraw.rst
index 4996acf7160..c4ce76cc07a 100644
--- a/docs/reference/ImageDraw.rst
+++ b/docs/reference/ImageDraw.rst
@@ -253,8 +253,6 @@ Methods
     :param fill: Color to use for the fill.
     :param width: The line width, in pixels.
 
-        .. versionadded:: 10.4.0
-
 .. py:method:: ImageDraw.line(xy, fill=None, width=0, joint=None)
 
     Draws a line between the coordinates in the ``xy`` list.

From 8db5fbead1955ed6f1f4810e3b36c46483dcc62e Mon Sep 17 00:00:00 2001
From: void4 <void4@users.noreply.github.com>
Date: Mon, 27 May 2024 13:27:56 +0200
Subject: [PATCH 0656/1178] Update src/PIL/ImageDraw.py - set circle argument
 xy to type Sequence[float] instead of Coords, radius to float

Co-authored-by: Andrew Murray <3112309+radarhere@users.noreply.github.com>
---
 src/PIL/ImageDraw.py | 4 +++-
 1 file changed, 3 insertions(+), 1 deletion(-)

diff --git a/src/PIL/ImageDraw.py b/src/PIL/ImageDraw.py
index b270cc6baf8..17c17643066 100644
--- a/src/PIL/ImageDraw.py
+++ b/src/PIL/ImageDraw.py
@@ -181,7 +181,9 @@ def ellipse(self, xy: Coords, fill=None, outline=None, width=1) -> None:
         if ink is not None and ink != fill and width != 0:
             self.draw.draw_ellipse(xy, ink, 0, width)
 
-    def circle(self, xy: Coords, radius, fill=None, outline=None, width=1) -> None:
+    def circle(
+        self, xy: Sequence[float], radius: float, fill=None, outline=None, width=1
+    ) -> None:
         """Draw a circle given center coordinates and a radius."""
         ellipse_xy = (xy[0] - radius, xy[1] - radius, xy[0] + radius, xy[1] + radius)
         self.ellipse(ellipse_xy, fill, outline, width)

From 12cefd798e7b28d05af4a39abd601bc862081881 Mon Sep 17 00:00:00 2001
From: Andrew Murray <radarhere@users.noreply.github.com>
Date: Mon, 27 May 2024 21:48:38 +1000
Subject: [PATCH 0657/1178] Added method links to release notes

---
 docs/reference/ImageDraw.rst | 25 ++++++++++++-------------
 docs/releasenotes/10.4.0.rst |  9 ++++++---
 2 files changed, 18 insertions(+), 16 deletions(-)

diff --git a/docs/reference/ImageDraw.rst b/docs/reference/ImageDraw.rst
index c4ce76cc07a..1404869ca6c 100644
--- a/docs/reference/ImageDraw.rst
+++ b/docs/reference/ImageDraw.rst
@@ -227,6 +227,18 @@ Methods
 
         .. versionadded:: 5.3.0
 
+.. py:method:: ImageDraw.circle(xy, radius, fill=None, outline=None, width=1)
+
+    Draws a circle with a given radius centering on a point.
+
+    .. versionadded:: 10.4.0
+
+    :param xy: The point for the center of the circle, e.g. ``(x, y)``.
+    :param radius: Radius of the circle.
+    :param outline: Color to use for the outline.
+    :param fill: Color to use for the fill.
+    :param width: The line width, in pixels.
+
 .. py:method:: ImageDraw.ellipse(xy, fill=None, outline=None, width=1)
 
     Draws an ellipse inside the given bounding box.
@@ -240,19 +252,6 @@ Methods
 
         .. versionadded:: 5.3.0
 
-.. py:method:: ImageDraw.circle(xy, radius, fill=None, outline=None, width=1)
-
-    Draws a circle given the center coordinates and a radius.
-
-    .. versionadded:: 10.4.0
-
-    :param xy: One point to define the circle center. Sequence:
-        ``[x, y]``
-    :param radius: Radius of the circle
-    :param outline: Color to use for the outline.
-    :param fill: Color to use for the fill.
-    :param width: The line width, in pixels.
-
 .. py:method:: ImageDraw.line(xy, fill=None, width=0, joint=None)
 
     Draws a line between the coordinates in the ``xy`` list.
diff --git a/docs/releasenotes/10.4.0.rst b/docs/releasenotes/10.4.0.rst
index 3c42588014c..e0d695a8bba 100644
--- a/docs/releasenotes/10.4.0.rst
+++ b/docs/releasenotes/10.4.0.rst
@@ -45,9 +45,12 @@ TODO
 API Additions
 =============
 
-Added PIL.ImageDraw.circle()
-^^^^^^^^^^^^^^^^^^^^^^^^^^^^
-Given the circle center coordinate pair and a radius, plots a circle using PIL.ImageDraw.ellipse()
+ImageDraw.circle
+^^^^^^^^^^^^^^^^
+
+Added :py:meth:`~PIL.ImageDraw.ImageDraw.circle`. It provides the same functionality as
+:py:meth:`~PIL.ImageDraw.ImageDraw.ellipse`, but instead of taking a bounding box, it
+takes a center point and radius.
 
 TODO
 ^^^^

From cac1a04329a2bb0864075f0aca4ff6e2c48a45cf Mon Sep 17 00:00:00 2001
From: Andrew Murray <radarhere@users.noreply.github.com>
Date: Mon, 27 May 2024 21:59:32 +1000
Subject: [PATCH 0658/1178] Added test

---
 Tests/test_imagedraw.py | 16 ++++++++++++++++
 1 file changed, 16 insertions(+)

diff --git a/Tests/test_imagedraw.py b/Tests/test_imagedraw.py
index 0a699e2ab6a..69d09e03d86 100644
--- a/Tests/test_imagedraw.py
+++ b/Tests/test_imagedraw.py
@@ -2,6 +2,7 @@
 
 import contextlib
 import os.path
+from typing import Sequence
 
 import pytest
 
@@ -265,6 +266,21 @@ def test_chord_too_fat() -> None:
     assert_image_equal_tofile(im, "Tests/images/imagedraw_chord_too_fat.png")
 
 
+@pytest.mark.parametrize("mode", ("RGB", "L"))
+@pytest.mark.parametrize("xy", ((W / 2, H / 2), [W / 2, H / 2]))
+def test_circle(mode: str, xy: Sequence[float]) -> None:
+    # Arrange
+    im = Image.new(mode, (W, H))
+    draw = ImageDraw.Draw(im)
+    expected = f"Tests/images/imagedraw_ellipse_{mode}.png"
+
+    # Act
+    draw.circle(xy, 25, fill="green", outline="blue")
+
+    # Assert
+    assert_image_similar_tofile(im, expected, 1)
+
+
 @pytest.mark.parametrize("mode", ("RGB", "L"))
 @pytest.mark.parametrize("bbox", BBOX)
 def test_ellipse(mode: str, bbox: Coords) -> None:

From 759ab28757430d0661cdbd32410c30f663b4ca9c Mon Sep 17 00:00:00 2001
From: Andrew Murray <radarhere@users.noreply.github.com>
Date: Tue, 28 May 2024 22:16:04 +1000
Subject: [PATCH 0659/1178] Update CHANGES.rst [ci skip]

---
 CHANGES.rst | 3 +++
 1 file changed, 3 insertions(+)

diff --git a/CHANGES.rst b/CHANGES.rst
index 8a531d1e2a9..dc4016d76f6 100644
--- a/CHANGES.rst
+++ b/CHANGES.rst
@@ -5,6 +5,9 @@ Changelog (Pillow)
 10.4.0 (unreleased)
 -------------------
 
+- Added ImageDraw circle() #8085
+  [void4, hugovk, radarhere]
+
 - Add mypy target to Makefile #8077
   [Yay295]
 

From a6d1daeb4b5e2797a393492d82333870ba7660a7 Mon Sep 17 00:00:00 2001
From: Andrew Murray <radarhere@users.noreply.github.com>
Date: Wed, 29 May 2024 22:51:02 +1000
Subject: [PATCH 0660/1178] Added type hints

---
 Tests/helper.py                  | 25 +++++++++++--------------
 Tests/test_file_webp_animated.py | 10 ++++++----
 Tests/test_imagecms.py           | 19 ++++++++++++++-----
 Tests/test_imagefile.py          |  6 ++++++
 Tests/test_imagefont.py          | 23 +++++++++++++++--------
 5 files changed, 52 insertions(+), 31 deletions(-)

diff --git a/Tests/helper.py b/Tests/helper.py
index 5fd4fe3327e..fe337c09f5c 100644
--- a/Tests/helper.py
+++ b/Tests/helper.py
@@ -174,12 +174,13 @@ def skip_unless_feature(feature: str) -> pytest.MarkDecorator:
 def skip_unless_feature_version(
     feature: str, required: str, reason: str | None = None
 ) -> pytest.MarkDecorator:
-    if not features.check(feature):
+    version = features.version(feature)
+    if version is None:
         return pytest.mark.skip(f"{feature} not available")
     if reason is None:
         reason = f"{feature} is older than {required}"
     version_required = parse_version(required)
-    version_available = parse_version(features.version(feature))
+    version_available = parse_version(version)
     return pytest.mark.skipif(version_available < version_required, reason=reason)
 
 
@@ -189,12 +190,13 @@ def mark_if_feature_version(
     version_blacklist: str,
     reason: str | None = None,
 ) -> pytest.MarkDecorator:
-    if not features.check(feature):
+    version = features.version(feature)
+    if version is None:
         return pytest.mark.pil_noop_mark()
     if reason is None:
         reason = f"{feature} is {version_blacklist}"
     version_required = parse_version(version_blacklist)
-    version_available = parse_version(features.version(feature))
+    version_available = parse_version(version)
     if (
         version_available.major == version_required.major
         and version_available.minor == version_required.minor
@@ -220,16 +222,11 @@ def _get_mem_usage(self) -> float:
         from resource import RUSAGE_SELF, getrusage
 
         mem = getrusage(RUSAGE_SELF).ru_maxrss
-        if sys.platform == "darwin":
-            # man 2 getrusage:
-            #     ru_maxrss
-            # This is the maximum resident set size utilized (in bytes).
-            return mem / 1024  # Kb
-        # linux
-        # man 2 getrusage
-        #        ru_maxrss (since Linux 2.6.32)
-        #  This is the maximum resident set size used (in kilobytes).
-        return mem  # Kb
+        # man 2 getrusage:
+        #     ru_maxrss
+        # This is the maximum resident set size utilized
+        # in bytes on macOS, in kilobytes on Linux
+        return mem / 1024 if sys.platform == "darwin" else mem
 
     def _test_leak(self, core: Callable[[], None]) -> None:
         start_mem = self._get_mem_usage()
diff --git a/Tests/test_file_webp_animated.py b/Tests/test_file_webp_animated.py
index 6a9337fa57f..ba931f8643c 100644
--- a/Tests/test_file_webp_animated.py
+++ b/Tests/test_file_webp_animated.py
@@ -52,8 +52,9 @@ def test_write_animation_L(tmp_path: Path) -> None:
             assert_image_similar(im, orig.convert("RGBA"), 32.9)
 
             if is_big_endian():
-                webp = parse_version(features.version_module("webp"))
-                if webp < parse_version("1.2.2"):
+                version = features.version_module("webp")
+                assert version is not None
+                if parse_version(version) < parse_version("1.2.2"):
                     pytest.skip("Fails with libwebp earlier than 1.2.2")
             orig.seek(orig.n_frames - 1)
             im.seek(im.n_frames - 1)
@@ -78,8 +79,9 @@ def check(temp_file) -> None:
 
             # Compare second frame to original
             if is_big_endian():
-                webp = parse_version(features.version_module("webp"))
-                if webp < parse_version("1.2.2"):
+                version = features.version_module("webp")
+                assert version is not None
+                if parse_version(version) < parse_version("1.2.2"):
                     pytest.skip("Fails with libwebp earlier than 1.2.2")
             im.seek(1)
             im.load()
diff --git a/Tests/test_imagecms.py b/Tests/test_imagecms.py
index bf629fa79cc..8d2029c2183 100644
--- a/Tests/test_imagecms.py
+++ b/Tests/test_imagecms.py
@@ -60,10 +60,13 @@ def test_sanity() -> None:
     assert list(map(type, v)) == [str, str, str, str]
 
     # internal version number
-    assert re.search(r"\d+\.\d+(\.\d+)?$", features.version_module("littlecms2"))
+    version = features.version_module("littlecms2")
+    assert version is not None
+    assert re.search(r"\d+\.\d+(\.\d+)?$", version)
 
     skip_missing()
     i = ImageCms.profileToProfile(hopper(), SRGB, SRGB)
+    assert i is not None
     assert_image(i, "RGB", (128, 128))
 
     i = hopper()
@@ -72,23 +75,27 @@ def test_sanity() -> None:
 
     t = ImageCms.buildTransform(SRGB, SRGB, "RGB", "RGB")
     i = ImageCms.applyTransform(hopper(), t)
+    assert i is not None
     assert_image(i, "RGB", (128, 128))
 
     with hopper() as i:
         t = ImageCms.buildTransform(SRGB, SRGB, "RGB", "RGB")
         ImageCms.applyTransform(hopper(), t, inPlace=True)
+        assert i is not None
         assert_image(i, "RGB", (128, 128))
 
     p = ImageCms.createProfile("sRGB")
     o = ImageCms.getOpenProfile(SRGB)
     t = ImageCms.buildTransformFromOpenProfiles(p, o, "RGB", "RGB")
     i = ImageCms.applyTransform(hopper(), t)
+    assert i is not None
     assert_image(i, "RGB", (128, 128))
 
     t = ImageCms.buildProofTransform(SRGB, SRGB, SRGB, "RGB", "RGB")
     assert t.inputMode == "RGB"
     assert t.outputMode == "RGB"
     i = ImageCms.applyTransform(hopper(), t)
+    assert i is not None
     assert_image(i, "RGB", (128, 128))
 
     # test PointTransform convenience API
@@ -260,7 +267,7 @@ def test_simple_lab() -> None:
     t = ImageCms.buildTransform(psRGB, pLab, "RGB", "LAB")
 
     i_lab = ImageCms.applyTransform(i, t)
-
+    assert i_lab is not None
     assert i_lab.mode == "LAB"
 
     k = i_lab.getpixel((0, 0))
@@ -284,6 +291,7 @@ def test_lab_color() -> None:
     # Need to add a type mapping for some PIL type to TYPE_Lab_8 in findLCMSType, and
     # have that mapping work back to a PIL mode (likely RGB).
     i = ImageCms.applyTransform(hopper(), t)
+    assert i is not None
     assert_image(i, "LAB", (128, 128))
 
     # i.save('temp.lab.tif')  # visually verified vs PS.
@@ -298,6 +306,7 @@ def test_lab_srgb() -> None:
 
     with Image.open("Tests/images/hopper.Lab.tif") as img:
         img_srgb = ImageCms.applyTransform(img, t)
+    assert img_srgb is not None
 
     # img_srgb.save('temp.srgb.tif') # visually verified vs ps.
 
@@ -317,11 +326,11 @@ def test_lab_roundtrip() -> None:
     t2 = ImageCms.buildTransform(pLab, psRGB, "LAB", "RGB")
 
     i = ImageCms.applyTransform(hopper(), t)
-
+    assert i is not None
     assert i.info["icc_profile"] == ImageCmsProfile(pLab).tobytes()
 
     out = ImageCms.applyTransform(i, t2)
-
+    assert out is not None
     assert_image_similar(hopper(), out, 2)
 
 
@@ -657,7 +666,7 @@ def test_auxiliary_channels_isolated() -> None:
                 reference_image = ImageCms.applyTransform(
                     source_image.convert(src_format[2]), reference_transform
                 )
-
+                assert reference_image is not None
                 assert_image_equal(test_image.convert(dst_format[2]), reference_image)
 
 
diff --git a/Tests/test_imagefile.py b/Tests/test_imagefile.py
index ddcae80d68e..c9dba294359 100644
--- a/Tests/test_imagefile.py
+++ b/Tests/test_imagefile.py
@@ -202,6 +202,8 @@ def test_broken_datastream_without_errors(self) -> None:
 
 
 class MockPyDecoder(ImageFile.PyDecoder):
+    last: MockPyDecoder
+
     def __init__(self, mode: str, *args: Any) -> None:
         MockPyDecoder.last = self
 
@@ -213,6 +215,8 @@ def decode(self, buffer):
 
 
 class MockPyEncoder(ImageFile.PyEncoder):
+    last: MockPyEncoder | None
+
     def __init__(self, mode: str, *args: Any) -> None:
         MockPyEncoder.last = self
 
@@ -315,6 +319,7 @@ def test_setimage(self) -> None:
             im, fp, [("MOCK", (xoff, yoff, xoff + xsize, yoff + ysize), 0, "RGB")]
         )
 
+        assert MockPyEncoder.last
         assert MockPyEncoder.last.state.xoff == xoff
         assert MockPyEncoder.last.state.yoff == yoff
         assert MockPyEncoder.last.state.xsize == xsize
@@ -329,6 +334,7 @@ def test_extents_none(self) -> None:
         fp = BytesIO()
         ImageFile._save(im, fp, [("MOCK", None, 0, "RGB")])
 
+        assert MockPyEncoder.last
         assert MockPyEncoder.last.state.xoff == 0
         assert MockPyEncoder.last.state.yoff == 0
         assert MockPyEncoder.last.state.xsize == 200
diff --git a/Tests/test_imagefont.py b/Tests/test_imagefont.py
index 05b5d471691..4398f8a3055 100644
--- a/Tests/test_imagefont.py
+++ b/Tests/test_imagefont.py
@@ -34,7 +34,9 @@
 
 
 def test_sanity() -> None:
-    assert re.search(r"\d+\.\d+\.\d+$", features.version_module("freetype2"))
+    version = features.version_module("freetype2")
+    assert version is not None
+    assert re.search(r"\d+\.\d+\.\d+$", version)
 
 
 @pytest.fixture(
@@ -547,11 +549,10 @@ def _test_fake_loading_font(path_to_fake: str, fontname: str) -> None:
             def loadable_font(
                 filepath: str, size: int, index: int, encoding: str, *args: Any
             ):
+                _freeTypeFont = getattr(ImageFont, "_FreeTypeFont")
                 if filepath == path_to_fake:
-                    return ImageFont._FreeTypeFont(
-                        FONT_PATH, size, index, encoding, *args
-                    )
-                return ImageFont._FreeTypeFont(filepath, size, index, encoding, *args)
+                    return _freeTypeFont(FONT_PATH, size, index, encoding, *args)
+                return _freeTypeFont(filepath, size, index, encoding, *args)
 
             m.setattr(ImageFont, "FreeTypeFont", loadable_font)
             font = ImageFont.truetype(fontname)
@@ -630,7 +631,9 @@ def test_complex_font_settings() -> None:
 
 
 def test_variation_get(font: ImageFont.FreeTypeFont) -> None:
-    freetype = parse_version(features.version_module("freetype2"))
+    version = features.version_module("freetype2")
+    assert version is not None
+    freetype = parse_version(version)
     if freetype < parse_version("2.9.1"):
         with pytest.raises(NotImplementedError):
             font.get_variation_names()
@@ -700,7 +703,9 @@ def _check_text(font: ImageFont.FreeTypeFont, path: str, epsilon: float) -> None
 
 
 def test_variation_set_by_name(font: ImageFont.FreeTypeFont) -> None:
-    freetype = parse_version(features.version_module("freetype2"))
+    version = features.version_module("freetype2")
+    assert version is not None
+    freetype = parse_version(version)
     if freetype < parse_version("2.9.1"):
         with pytest.raises(NotImplementedError):
             font.set_variation_by_name("Bold")
@@ -725,7 +730,9 @@ def test_variation_set_by_name(font: ImageFont.FreeTypeFont) -> None:
 
 
 def test_variation_set_by_axes(font: ImageFont.FreeTypeFont) -> None:
-    freetype = parse_version(features.version_module("freetype2"))
+    version = features.version_module("freetype2")
+    assert version is not None
+    freetype = parse_version(version)
     if freetype < parse_version("2.9.1"):
         with pytest.raises(NotImplementedError):
             font.set_variation_by_axes([100])

From 7f977f65229cd7037bfc4896fccc22b2c279d749 Mon Sep 17 00:00:00 2001
From: Andrew Murray <radarhere@users.noreply.github.com>
Date: Thu, 30 May 2024 09:10:28 +1000
Subject: [PATCH 0661/1178] Updated xz to 5.6.2

---
 .github/workflows/wheels-dependencies.sh | 2 +-
 winbuild/build_prepare.py                | 2 +-
 2 files changed, 2 insertions(+), 2 deletions(-)

diff --git a/.github/workflows/wheels-dependencies.sh b/.github/workflows/wheels-dependencies.sh
index 0d45d5a209d..0df3bf17930 100755
--- a/.github/workflows/wheels-dependencies.sh
+++ b/.github/workflows/wheels-dependencies.sh
@@ -20,7 +20,7 @@ HARFBUZZ_VERSION=8.4.0
 LIBPNG_VERSION=1.6.43
 JPEGTURBO_VERSION=3.0.2
 OPENJPEG_VERSION=2.5.2
-XZ_VERSION=5.4.5
+XZ_VERSION=5.6.2
 TIFF_VERSION=4.6.0
 LCMS2_VERSION=2.16
 if [[ -n "$IS_MACOS" ]]; then
diff --git a/winbuild/build_prepare.py b/winbuild/build_prepare.py
index 0d6da77549f..1df8db17bc7 100644
--- a/winbuild/build_prepare.py
+++ b/winbuild/build_prepare.py
@@ -120,7 +120,7 @@ def cmd_msbuild(
     "LIBWEBP": "1.3.2",
     "OPENJPEG": "2.5.2",
     "TIFF": "4.6.0",
-    "XZ": "5.4.5",
+    "XZ": "5.6.2",
     "ZLIB": "1.3.1",
 }
 V["LIBPNG_DOTLESS"] = V["LIBPNG"].replace(".", "")

From e68cec640a0b0698fbfea9493089727edaf03379 Mon Sep 17 00:00:00 2001
From: Andrew Murray <radarhere@users.noreply.github.com>
Date: Thu, 30 May 2024 12:00:50 +1000
Subject: [PATCH 0662/1178] Added type hints

---
 Tests/oss-fuzz/test_fuzzers.py |  5 +++--
 Tests/test_features.py         | 10 +++++++---
 Tests/test_file_jpeg.py        |  4 +++-
 Tests/test_file_jpeg2k.py      |  4 +++-
 Tests/test_file_libtiff.py     |  4 +++-
 Tests/test_file_png.py         |  6 +++---
 Tests/test_file_webp.py        |  4 +++-
 Tests/test_image_quantize.py   |  5 +++--
 Tests/test_image_reduce.py     |  2 +-
 Tests/test_imageops_usm.py     | 14 +++++++-------
 10 files changed, 36 insertions(+), 22 deletions(-)

diff --git a/Tests/oss-fuzz/test_fuzzers.py b/Tests/oss-fuzz/test_fuzzers.py
index 58d0213e85d..90eb8713a8b 100644
--- a/Tests/oss-fuzz/test_fuzzers.py
+++ b/Tests/oss-fuzz/test_fuzzers.py
@@ -12,8 +12,9 @@
 
 if sys.platform.startswith("win32"):
     pytest.skip("Fuzzer is linux only", allow_module_level=True)
-if features.check("libjpeg_turbo"):
-    version = packaging.version.parse(features.version("libjpeg_turbo"))
+libjpeg_turbo_version = features.version("libjpeg_turbo")
+if libjpeg_turbo_version is not None:
+    version = packaging.version.parse(libjpeg_turbo_version)
     if version.major == 2 and version.minor == 0:
         pytestmark = pytest.mark.valgrind_known_error(
             reason="Known failing with libjpeg_turbo 2.0"
diff --git a/Tests/test_features.py b/Tests/test_features.py
index 2d402ca9114..59fb4980923 100644
--- a/Tests/test_features.py
+++ b/Tests/test_features.py
@@ -30,7 +30,7 @@ def test_version() -> None:
     # Check the correctness of the convenience function
     # and the format of version numbers
 
-    def test(name: str, function: Callable[[str], bool]) -> None:
+    def test(name: str, function: Callable[[str], str | None]) -> None:
         version = features.version(name)
         if not features.check(name):
             assert version is None
@@ -67,12 +67,16 @@ def test_webp_anim() -> None:
 
 @skip_unless_feature("libjpeg_turbo")
 def test_libjpeg_turbo_version() -> None:
-    assert re.search(r"\d+\.\d+\.\d+$", features.version("libjpeg_turbo"))
+    version = features.version("libjpeg_turbo")
+    assert version is not None
+    assert re.search(r"\d+\.\d+\.\d+$", version)
 
 
 @skip_unless_feature("libimagequant")
 def test_libimagequant_version() -> None:
-    assert re.search(r"\d+\.\d+\.\d+$", features.version("libimagequant"))
+    version = features.version("libimagequant")
+    assert version is not None
+    assert re.search(r"\d+\.\d+\.\d+$", version)
 
 
 @pytest.mark.parametrize("feature", features.modules)
diff --git a/Tests/test_file_jpeg.py b/Tests/test_file_jpeg.py
index 5d2157651df..f24faecaab2 100644
--- a/Tests/test_file_jpeg.py
+++ b/Tests/test_file_jpeg.py
@@ -70,7 +70,9 @@ def gen_random_image(self, size: tuple[int, int], mode: str = "RGB") -> Image.Im
 
     def test_sanity(self) -> None:
         # internal version number
-        assert re.search(r"\d+\.\d+$", features.version_codec("jpg"))
+        version = features.version_codec("jpg")
+        assert version is not None
+        assert re.search(r"\d+\.\d+$", version)
 
         with Image.open(TEST_FILE) as im:
             im.load()
diff --git a/Tests/test_file_jpeg2k.py b/Tests/test_file_jpeg2k.py
index a7cae563adb..5a208739f70 100644
--- a/Tests/test_file_jpeg2k.py
+++ b/Tests/test_file_jpeg2k.py
@@ -48,7 +48,9 @@ def roundtrip(im: Image.Image, **options: Any) -> Image.Image:
 
 def test_sanity() -> None:
     # Internal version number
-    assert re.search(r"\d+\.\d+\.\d+$", features.version_codec("jpg_2000"))
+    version = features.version_codec("jpg_2000")
+    assert version is not None
+    assert re.search(r"\d+\.\d+\.\d+$", version)
 
     with Image.open("Tests/images/test-card-lossless.jp2") as im:
         px = im.load()
diff --git a/Tests/test_file_libtiff.py b/Tests/test_file_libtiff.py
index 11883ad24aa..6c13999a50a 100644
--- a/Tests/test_file_libtiff.py
+++ b/Tests/test_file_libtiff.py
@@ -52,7 +52,9 @@ def _assert_noerr(self, tmp_path: Path, im: TiffImagePlugin.TiffImageFile) -> No
 
 class TestFileLibTiff(LibTiffTestCase):
     def test_version(self) -> None:
-        assert re.search(r"\d+\.\d+\.\d+$", features.version_codec("libtiff"))
+        version = features.version_codec("libtiff")
+        assert version is not None
+        assert re.search(r"\d+\.\d+\.\d+$", version)
 
     def test_g4_tiff(self, tmp_path: Path) -> None:
         """Test the ordinary file path load path"""
diff --git a/Tests/test_file_png.py b/Tests/test_file_png.py
index 19462dcb5a4..c7c9f6fab0b 100644
--- a/Tests/test_file_png.py
+++ b/Tests/test_file_png.py
@@ -85,9 +85,9 @@ def get_chunks(self, filename: str) -> list[bytes]:
 
     def test_sanity(self, tmp_path: Path) -> None:
         # internal version number
-        assert re.search(
-            r"\d+(\.\d+){1,3}(\.zlib\-ng)?$", features.version_codec("zlib")
-        )
+        version = features.version_codec("zlib")
+        assert version is not None
+        assert re.search(r"\d+(\.\d+){1,3}(\.zlib\-ng)?$", version)
 
         test_file = str(tmp_path / "temp.png")
 
diff --git a/Tests/test_file_webp.py b/Tests/test_file_webp.py
index 249846da481..e2de84c71a1 100644
--- a/Tests/test_file_webp.py
+++ b/Tests/test_file_webp.py
@@ -49,7 +49,9 @@ def setup_method(self) -> None:
     def test_version(self) -> None:
         _webp.WebPDecoderVersion()
         _webp.WebPDecoderBuggyAlpha()
-        assert re.search(r"\d+\.\d+\.\d+$", features.version_module("webp"))
+        version = features.version_module("webp")
+        assert version is not None
+        assert re.search(r"\d+\.\d+\.\d+$", version)
 
     def test_read_rgb(self) -> None:
         """
diff --git a/Tests/test_image_quantize.py b/Tests/test_image_quantize.py
index e1aa6252b7a..2daaf5c3cbb 100644
--- a/Tests/test_image_quantize.py
+++ b/Tests/test_image_quantize.py
@@ -24,8 +24,9 @@ def test_sanity() -> None:
 def test_libimagequant_quantize() -> None:
     image = hopper()
     if is_ppc64le():
-        libimagequant = parse_version(features.version_feature("libimagequant"))
-        if libimagequant < parse_version("4"):
+        version = features.version_feature("libimagequant")
+        assert version is not None
+        if parse_version(version) < parse_version("4"):
             pytest.skip("Fails with libimagequant earlier than 4.0.0 on ppc64le")
     converted = image.quantize(100, Image.Quantize.LIBIMAGEQUANT)
     assert converted.mode == "P"
diff --git a/Tests/test_image_reduce.py b/Tests/test_image_reduce.py
index fcf671daace..f6609a1a054 100644
--- a/Tests/test_image_reduce.py
+++ b/Tests/test_image_reduce.py
@@ -102,7 +102,7 @@ def test_unsupported_modes(mode: str) -> None:
 def get_image(mode: str) -> Image.Image:
     mode_info = ImageMode.getmode(mode)
     if mode_info.basetype == "L":
-        bands = [gradients_image]
+        bands: list[Image.Image] = [gradients_image]
         for _ in mode_info.bands[1:]:
             # rotate previous image
             band = bands[-1].transpose(Image.Transpose.ROTATE_90)
diff --git a/Tests/test_imageops_usm.py b/Tests/test_imageops_usm.py
index c15907a554a..104c620de01 100644
--- a/Tests/test_imageops_usm.py
+++ b/Tests/test_imageops_usm.py
@@ -4,11 +4,11 @@
 
 import pytest
 
-from PIL import Image, ImageFilter
+from PIL import Image, ImageFile, ImageFilter
 
 
 @pytest.fixture
-def test_images() -> Generator[dict[str, Image.Image], None, None]:
+def test_images() -> Generator[dict[str, ImageFile.ImageFile], None, None]:
     ims = {
         "im": Image.open("Tests/images/hopper.ppm"),
         "snakes": Image.open("Tests/images/color_snakes.png"),
@@ -20,7 +20,7 @@ def test_images() -> Generator[dict[str, Image.Image], None, None]:
             im.close()
 
 
-def test_filter_api(test_images: dict[str, Image.Image]) -> None:
+def test_filter_api(test_images: dict[str, ImageFile.ImageFile]) -> None:
     im = test_images["im"]
 
     test_filter = ImageFilter.GaussianBlur(2.0)
@@ -34,7 +34,7 @@ def test_filter_api(test_images: dict[str, Image.Image]) -> None:
     assert i.size == (128, 128)
 
 
-def test_usm_formats(test_images: dict[str, Image.Image]) -> None:
+def test_usm_formats(test_images: dict[str, ImageFile.ImageFile]) -> None:
     im = test_images["im"]
 
     usm = ImageFilter.UnsharpMask
@@ -52,7 +52,7 @@ def test_usm_formats(test_images: dict[str, Image.Image]) -> None:
         im.convert("YCbCr").filter(usm)
 
 
-def test_blur_formats(test_images: dict[str, Image.Image]) -> None:
+def test_blur_formats(test_images: dict[str, ImageFile.ImageFile]) -> None:
     im = test_images["im"]
 
     blur = ImageFilter.GaussianBlur
@@ -70,7 +70,7 @@ def test_blur_formats(test_images: dict[str, Image.Image]) -> None:
         im.convert("YCbCr").filter(blur)
 
 
-def test_usm_accuracy(test_images: dict[str, Image.Image]) -> None:
+def test_usm_accuracy(test_images: dict[str, ImageFile.ImageFile]) -> None:
     snakes = test_images["snakes"]
 
     src = snakes.convert("RGB")
@@ -79,7 +79,7 @@ def test_usm_accuracy(test_images: dict[str, Image.Image]) -> None:
     assert i.tobytes() == src.tobytes()
 
 
-def test_blur_accuracy(test_images: dict[str, Image.Image]) -> None:
+def test_blur_accuracy(test_images: dict[str, ImageFile.ImageFile]) -> None:
     snakes = test_images["snakes"]
 
     i = snakes.filter(ImageFilter.GaussianBlur(0.4))

From afc7d8d0b012b8be86e00411c5cb69de62478ee5 Mon Sep 17 00:00:00 2001
From: Andrew Murray <radarhere@users.noreply.github.com>
Date: Thu, 30 May 2024 17:17:22 +1000
Subject: [PATCH 0663/1178] Added type hints

---
 Tests/test_font_leaks.py |  2 +-
 Tests/test_image.py      | 20 +++++++++++++++-----
 Tests/test_imagecms.py   | 26 ++++++++++++++------------
 Tests/test_imagestat.py  |  4 ++--
 4 files changed, 32 insertions(+), 20 deletions(-)

diff --git a/Tests/test_font_leaks.py b/Tests/test_font_leaks.py
index 08a0e743100..3fb92a62edb 100644
--- a/Tests/test_font_leaks.py
+++ b/Tests/test_font_leaks.py
@@ -12,7 +12,7 @@ class TestTTypeFontLeak(PillowLeakTestCase):
     iterations = 10
     mem_limit = 4096  # k
 
-    def _test_font(self, font: ImageFont.FreeTypeFont) -> None:
+    def _test_font(self, font: ImageFont.FreeTypeFont | ImageFont.ImageFont) -> None:
         im = Image.new("RGB", (255, 255), "white")
         draw = ImageDraw.ImageDraw(im)
         self._test_leak(
diff --git a/Tests/test_image.py b/Tests/test_image.py
index 742d0dfe406..c7694a0efda 100644
--- a/Tests/test_image.py
+++ b/Tests/test_image.py
@@ -99,10 +99,18 @@ def test_open_formats(self) -> None:
         JPGFILE = "Tests/images/hopper.jpg"
 
         with pytest.raises(TypeError):
-            with Image.open(PNGFILE, formats=123):
+            with Image.open(PNGFILE, formats=123):  # type: ignore[arg-type]
                 pass
 
-        for formats in [["JPEG"], ("JPEG",), ["jpeg"], ["Jpeg"], ["jPeG"], ["JpEg"]]:
+        format_list: list[list[str] | tuple[str, ...]] = [
+            ["JPEG"],
+            ("JPEG",),
+            ["jpeg"],
+            ["Jpeg"],
+            ["jPeG"],
+            ["JpEg"],
+        ]
+        for formats in format_list:
             with pytest.raises(UnidentifiedImageError):
                 with Image.open(PNGFILE, formats=formats):
                     pass
@@ -138,7 +146,7 @@ def test_invalid_image(self) -> None:
 
     def test_bad_mode(self) -> None:
         with pytest.raises(ValueError):
-            with Image.open("filename", "bad mode"):
+            with Image.open("filename", "bad mode"):  # type: ignore[arg-type]
                 pass
 
     def test_stringio(self) -> None:
@@ -497,9 +505,11 @@ def test_effect_spread_zero(self) -> None:
     def test_check_size(self) -> None:
         # Checking that the _check_size function throws value errors when we want it to
         with pytest.raises(ValueError):
-            Image.new("RGB", 0)  # not a tuple
+            # not a tuple
+            Image.new("RGB", 0)  # type: ignore[arg-type]
         with pytest.raises(ValueError):
-            Image.new("RGB", (0,))  # Tuple too short
+            # tuple too short
+            Image.new("RGB", (0,))  # type: ignore[arg-type]
         with pytest.raises(ValueError):
             Image.new("RGB", (-1, -1))  # w,h < 0
 
diff --git a/Tests/test_imagecms.py b/Tests/test_imagecms.py
index 8d2029c2183..082eb8162e4 100644
--- a/Tests/test_imagecms.py
+++ b/Tests/test_imagecms.py
@@ -7,7 +7,7 @@
 import sys
 from io import BytesIO
 from pathlib import Path
-from typing import Any
+from typing import Any, Literal, cast
 
 import pytest
 
@@ -209,13 +209,13 @@ def test_exceptions() -> None:
         ImageCms.buildTransform("foo", "bar", "RGB", "RGB")
 
     with pytest.raises(ImageCms.PyCMSError, match="Invalid type for Profile"):
-        ImageCms.getProfileName(None)
+        ImageCms.getProfileName(None)  # type: ignore[arg-type]
     skip_missing()
 
     # Python <= 3.9: "an integer is required (got type NoneType)"
     # Python > 3.9: "'NoneType' object cannot be interpreted as an integer"
     with pytest.raises(ImageCms.PyCMSError, match="integer"):
-        ImageCms.isIntentSupported(SRGB, None, None)
+        ImageCms.isIntentSupported(SRGB, None, None)  # type: ignore[arg-type]
 
 
 def test_display_profile() -> None:
@@ -239,7 +239,7 @@ def test_unsupported_color_space() -> None:
             "Color space not supported for on-the-fly profile creation (unsupported)"
         ),
     ):
-        ImageCms.createProfile("unsupported")
+        ImageCms.createProfile("unsupported")  # type: ignore[arg-type]
 
 
 def test_invalid_color_temperature() -> None:
@@ -352,7 +352,7 @@ def test_extended_information() -> None:
     p = o.profile
 
     def assert_truncated_tuple_equal(
-        tup1: tuple[Any, ...], tup2: tuple[Any, ...], digits: int = 10
+        tup1: tuple[Any, ...] | None, tup2: tuple[Any, ...], digits: int = 10
     ) -> None:
         # Helper function to reduce precision of tuples of floats
         # recursively and then check equality.
@@ -368,6 +368,7 @@ def truncate_tuple(tuple_value: tuple[Any, ...]) -> tuple[Any, ...]:
                 for val in tuple_value
             )
 
+        assert tup1 is not None
         assert truncate_tuple(tup1) == truncate_tuple(tup2)
 
     assert p.attributes == 4294967296
@@ -513,22 +514,22 @@ def test_non_ascii_path(tmp_path: Path) -> None:
 def test_profile_typesafety() -> None:
     # does not segfault
     with pytest.raises(TypeError, match="Invalid type for Profile"):
-        ImageCms.ImageCmsProfile(0).tobytes()
+        ImageCms.ImageCmsProfile(0)  # type: ignore[arg-type]
     with pytest.raises(TypeError, match="Invalid type for Profile"):
-        ImageCms.ImageCmsProfile(1).tobytes()
+        ImageCms.ImageCmsProfile(1)  # type: ignore[arg-type]
 
     # also check core function
     with pytest.raises(TypeError):
-        ImageCms.core.profile_tobytes(0)
+        ImageCms.core.profile_tobytes(0)  # type: ignore[arg-type]
     with pytest.raises(TypeError):
-        ImageCms.core.profile_tobytes(1)
+        ImageCms.core.profile_tobytes(1)  # type: ignore[arg-type]
 
     if not is_pypy():
         # core profile should not be directly instantiable
         with pytest.raises(TypeError):
             ImageCms.core.CmsProfile()
         with pytest.raises(TypeError):
-            ImageCms.core.CmsProfile(0)
+            ImageCms.core.CmsProfile(0)  # type: ignore[call-arg]
 
 
 @pytest.mark.skipif(is_pypy(), reason="fails on PyPy")
@@ -537,7 +538,7 @@ def test_transform_typesafety() -> None:
     with pytest.raises(TypeError):
         ImageCms.core.CmsTransform()
     with pytest.raises(TypeError):
-        ImageCms.core.CmsTransform(0)
+        ImageCms.core.CmsTransform(0)  # type: ignore[call-arg]
 
 
 def assert_aux_channel_preserved(
@@ -637,7 +638,8 @@ def test_auxiliary_channels_isolated() -> None:
                     continue
 
                 # convert with and without AUX data, test colors are equal
-                source_profile = ImageCms.createProfile(src_format[1])
+                src_colorSpace = cast(Literal["LAB", "XYZ", "sRGB"], src_format[1])
+                source_profile = ImageCms.createProfile(src_colorSpace)
                 destination_profile = ImageCms.createProfile(dst_format[1])
                 source_image = src_format[3]
                 test_transform = ImageCms.buildTransform(
diff --git a/Tests/test_imagestat.py b/Tests/test_imagestat.py
index b1c1306c1ec..0dfbc5a2abb 100644
--- a/Tests/test_imagestat.py
+++ b/Tests/test_imagestat.py
@@ -25,10 +25,10 @@ def test_sanity() -> None:
     st.stddev
 
     with pytest.raises(AttributeError):
-        st.spam()
+        st.spam()  # type: ignore[attr-defined]
 
     with pytest.raises(TypeError):
-        ImageStat.Stat(1)
+        ImageStat.Stat(1)  # type: ignore[arg-type]
 
 
 def test_hopper() -> None:

From 66ab7e0de22251b32eccd8938ac7f985579dc0ac Mon Sep 17 00:00:00 2001
From: Andrew Murray <radarhere@users.noreply.github.com>
Date: Sat, 1 Jun 2024 21:31:53 +1000
Subject: [PATCH 0664/1178] Added type hints

---
 Tests/test_file_gif.py         |  5 +++--
 Tests/test_file_jpeg.py        |  4 ++--
 Tests/test_file_libtiff.py     |  3 ++-
 Tests/test_image.py            |  4 +++-
 Tests/test_image_array.py      |  2 +-
 Tests/test_image_crop.py       | 26 +++++++++++++-------------
 Tests/test_image_filter.py     |  4 ++--
 Tests/test_image_getextrema.py |  2 +-
 Tests/test_imagecms.py         |  8 ++++++--
 Tests/test_imagedraw.py        |  2 +-
 10 files changed, 34 insertions(+), 26 deletions(-)

diff --git a/Tests/test_file_gif.py b/Tests/test_file_gif.py
index 48c70db8a89..4e790926bfc 100644
--- a/Tests/test_file_gif.py
+++ b/Tests/test_file_gif.py
@@ -1252,10 +1252,11 @@ def test_palette_save_L(tmp_path: Path) -> None:
 
     im = hopper("P")
     im_l = Image.frombytes("L", im.size, im.tobytes())
-    palette = bytes(im.getpalette())
+    palette = im.getpalette()
+    assert palette is not None
 
     out = str(tmp_path / "temp.gif")
-    im_l.save(out, palette=palette)
+    im_l.save(out, palette=bytes(palette))
 
     with Image.open(out) as reloaded:
         assert_image_equal(reloaded.convert("RGB"), im.convert("RGB"))
diff --git a/Tests/test_file_jpeg.py b/Tests/test_file_jpeg.py
index f24faecaab2..33f9ce00edc 100644
--- a/Tests/test_file_jpeg.py
+++ b/Tests/test_file_jpeg.py
@@ -154,7 +154,7 @@ def test_cmyk(self) -> None:
             assert k > 0.9
 
     def test_rgb(self) -> None:
-        def getchannels(im: Image.Image) -> tuple[int, int, int]:
+        def getchannels(im: JpegImagePlugin.JpegImageFile) -> tuple[int, int, int]:
             return tuple(v[0] for v in im.layer)
 
         im = hopper()
@@ -443,7 +443,7 @@ def test_smooth(self) -> None:
         assert_image(im1, im2.mode, im2.size)
 
     def test_subsampling(self) -> None:
-        def getsampling(im: Image.Image):
+        def getsampling(im: JpegImagePlugin.JpegImageFile):
             layer = im.layer
             return layer[0][1:3] + layer[1][1:3] + layer[2][1:3]
 
diff --git a/Tests/test_file_libtiff.py b/Tests/test_file_libtiff.py
index 6c13999a50a..22bcd285622 100644
--- a/Tests/test_file_libtiff.py
+++ b/Tests/test_file_libtiff.py
@@ -668,7 +668,8 @@ def save_bytesio(compression: str | None = None) -> None:
             pilim.save(buffer_io, format="tiff", compression=compression)
             buffer_io.seek(0)
 
-            assert_image_similar_tofile(pilim, buffer_io, 0)
+            with Image.open(buffer_io) as saved_im:
+                assert_image_similar(pilim, saved_im, 0)
 
         save_bytesio()
         save_bytesio("raw")
diff --git a/Tests/test_image.py b/Tests/test_image.py
index c7694a0efda..d6a739c79df 100644
--- a/Tests/test_image.py
+++ b/Tests/test_image.py
@@ -25,6 +25,7 @@
 from .helper import (
     assert_image_equal,
     assert_image_equal_tofile,
+    assert_image_similar,
     assert_image_similar_tofile,
     assert_not_all_same,
     hopper,
@@ -193,7 +194,8 @@ def test_tempfile(self) -> None:
         with tempfile.TemporaryFile() as fp:
             im.save(fp, "JPEG")
             fp.seek(0)
-            assert_image_similar_tofile(im, fp, 20)
+            with Image.open(fp) as reloaded:
+                assert_image_similar(im, reloaded, 20)
 
     def test_unknown_extension(self, tmp_path: Path) -> None:
         im = hopper()
diff --git a/Tests/test_image_array.py b/Tests/test_image_array.py
index 342bd8654e1..d7e6c562c39 100644
--- a/Tests/test_image_array.py
+++ b/Tests/test_image_array.py
@@ -86,8 +86,8 @@ def test(mode: str) -> tuple[str, tuple[int, int], bool]:
     assert test("RGBX") == ("RGBA", (128, 100), True)
 
     # Test mode is None with no "typestr" in the array interface
+    wrapped = Wrapper(hopper("L"), {"shape": (100, 128)})
     with pytest.raises(TypeError):
-        wrapped = Wrapper(test("L"), {"shape": (100, 128)})
         Image.fromarray(wrapped)
 
 
diff --git a/Tests/test_image_crop.py b/Tests/test_image_crop.py
index d095364ba75..07fec2e64af 100644
--- a/Tests/test_image_crop.py
+++ b/Tests/test_image_crop.py
@@ -18,7 +18,7 @@ def test_crop(mode: str) -> None:
 
 
 def test_wide_crop() -> None:
-    def crop(*bbox: int) -> tuple[int, ...]:
+    def crop(bbox: tuple[int, int, int, int]) -> tuple[int, ...]:
         i = im.crop(bbox)
         h = i.histogram()
         while h and not h[-1]:
@@ -27,23 +27,23 @@ def crop(*bbox: int) -> tuple[int, ...]:
 
     im = Image.new("L", (100, 100), 1)
 
-    assert crop(0, 0, 100, 100) == (0, 10000)
-    assert crop(25, 25, 75, 75) == (0, 2500)
+    assert crop((0, 0, 100, 100)) == (0, 10000)
+    assert crop((25, 25, 75, 75)) == (0, 2500)
 
     # sides
-    assert crop(-25, 0, 25, 50) == (1250, 1250)
-    assert crop(0, -25, 50, 25) == (1250, 1250)
-    assert crop(75, 0, 125, 50) == (1250, 1250)
-    assert crop(0, 75, 50, 125) == (1250, 1250)
+    assert crop((-25, 0, 25, 50)) == (1250, 1250)
+    assert crop((0, -25, 50, 25)) == (1250, 1250)
+    assert crop((75, 0, 125, 50)) == (1250, 1250)
+    assert crop((0, 75, 50, 125)) == (1250, 1250)
 
-    assert crop(-25, 25, 125, 75) == (2500, 5000)
-    assert crop(25, -25, 75, 125) == (2500, 5000)
+    assert crop((-25, 25, 125, 75)) == (2500, 5000)
+    assert crop((25, -25, 75, 125)) == (2500, 5000)
 
     # corners
-    assert crop(-25, -25, 25, 25) == (1875, 625)
-    assert crop(75, -25, 125, 25) == (1875, 625)
-    assert crop(75, 75, 125, 125) == (1875, 625)
-    assert crop(-25, 75, 25, 125) == (1875, 625)
+    assert crop((-25, -25, 25, 25)) == (1875, 625)
+    assert crop((75, -25, 125, 25)) == (1875, 625)
+    assert crop((75, 75, 125, 125)) == (1875, 625)
+    assert crop((-25, 75, 25, 125)) == (1875, 625)
 
 
 @pytest.mark.parametrize("box", ((8, 2, 2, 8), (2, 8, 8, 2), (8, 8, 2, 2)))
diff --git a/Tests/test_image_filter.py b/Tests/test_image_filter.py
index 47f9ffa3db8..1f0644471ee 100644
--- a/Tests/test_image_filter.py
+++ b/Tests/test_image_filter.py
@@ -46,9 +46,9 @@ def test_sanity(filter_to_apply: ImageFilter.Filter, mode: str) -> None:
 
 @pytest.mark.parametrize("mode", ("L", "I", "RGB", "CMYK"))
 def test_sanity_error(mode: str) -> None:
+    im = hopper(mode)
     with pytest.raises(TypeError):
-        im = hopper(mode)
-        im.filter("hello")
+        im.filter("hello")  # type: ignore[arg-type]
 
 
 # crashes on small images
diff --git a/Tests/test_image_getextrema.py b/Tests/test_image_getextrema.py
index a5b974459a6..de5956f3e7e 100644
--- a/Tests/test_image_getextrema.py
+++ b/Tests/test_image_getextrema.py
@@ -6,7 +6,7 @@
 
 
 def test_extrema() -> None:
-    def extrema(mode: str) -> tuple[int, int] | tuple[tuple[int, int], ...]:
+    def extrema(mode: str) -> tuple[float, float] | tuple[tuple[int, int], ...]:
         return hopper(mode).getextrema()
 
     assert extrema("1") == (0, 255)
diff --git a/Tests/test_imagecms.py b/Tests/test_imagecms.py
index 082eb8162e4..55f72c3b95c 100644
--- a/Tests/test_imagecms.py
+++ b/Tests/test_imagecms.py
@@ -247,7 +247,7 @@ def test_invalid_color_temperature() -> None:
         ImageCms.PyCMSError,
         match='Color temperature must be numeric, "invalid" not valid',
     ):
-        ImageCms.createProfile("LAB", "invalid")
+        ImageCms.createProfile("LAB", "invalid")  # type: ignore[arg-type]
 
 
 @pytest.mark.parametrize("flag", ("my string", -1))
@@ -256,7 +256,7 @@ def test_invalid_flag(flag: str | int) -> None:
         with pytest.raises(
             ImageCms.PyCMSError, match="flags must be an integer between 0 and "
         ):
-            ImageCms.profileToProfile(im, "foo", "bar", flags=flag)
+            ImageCms.profileToProfile(im, "foo", "bar", flags=flag)  # type: ignore[arg-type]
 
 
 def test_simple_lab() -> None:
@@ -588,11 +588,13 @@ def create_test_image() -> Image.Image:
     )
 
     # apply transform
+    result_image: Image.Image | None
     if transform_in_place:
         ImageCms.applyTransform(source_image, t, inPlace=True)
         result_image = source_image
     else:
         result_image = ImageCms.applyTransform(source_image, t, inPlace=False)
+    assert result_image is not None
     result_image_aux = result_image.getchannel(preserved_channel)
 
     assert_image_equal(source_image_aux, result_image_aux)
@@ -650,6 +652,7 @@ def test_auxiliary_channels_isolated() -> None:
                 )
 
                 # test conversion from aux-ful source
+                test_image: Image.Image | None
                 if transform_in_place:
                     test_image = source_image.copy()
                     ImageCms.applyTransform(test_image, test_transform, inPlace=True)
@@ -657,6 +660,7 @@ def test_auxiliary_channels_isolated() -> None:
                     test_image = ImageCms.applyTransform(
                         source_image, test_transform, inPlace=False
                     )
+                assert test_image is not None
 
                 # reference conversion from aux-less source
                 reference_transform = ImageCms.buildTransform(
diff --git a/Tests/test_imagedraw.py b/Tests/test_imagedraw.py
index 69d09e03d86..c221fe00829 100644
--- a/Tests/test_imagedraw.py
+++ b/Tests/test_imagedraw.py
@@ -1083,8 +1083,8 @@ def test_line_horizontal() -> None:
     )
 
 
+@pytest.mark.xfail(reason="failing test")
 def test_line_h_s1_w2() -> None:
-    pytest.skip("failing")
     img, draw = create_base_image_draw((20, 20))
     draw.line((5, 5, 14, 6), BLACK, 2)
     assert_image_equal_tofile(

From 54150f2061fa87cb5f629f28958d53c293ea4b90 Mon Sep 17 00:00:00 2001
From: Andrew Murray <radarhere@users.noreply.github.com>
Date: Sun, 2 Jun 2024 16:26:35 +1000
Subject: [PATCH 0665/1178] Corrected docstring

---
 src/PIL/ImageCms.py | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/src/PIL/ImageCms.py b/src/PIL/ImageCms.py
index 5f5c5df54e7..5915cc944c3 100644
--- a/src/PIL/ImageCms.py
+++ b/src/PIL/ImageCms.py
@@ -777,7 +777,7 @@ def createProfile(
     :param colorSpace: String, the color space of the profile you wish to
         create.
         Currently only "LAB", "XYZ", and "sRGB" are supported.
-    :param colorTemp: Positive integer for the white point for the profile, in
+    :param colorTemp: Positive number for the white point for the profile, in
         degrees Kelvin (i.e. 5000, 6500, 9600, etc.).  The default is for D50
         illuminant if omitted (5000k).  colorTemp is ONLY applied to LAB
         profiles, and is ignored for XYZ and sRGB.

From 4aba0b8238db501b5f498fee9335f380a7d08f88 Mon Sep 17 00:00:00 2001
From: Andrew Murray <radarhere@users.noreply.github.com>
Date: Sun, 2 Jun 2024 16:27:05 +1000
Subject: [PATCH 0666/1178] Changed default colorTemp

---
 src/PIL/ImageCms.py | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/src/PIL/ImageCms.py b/src/PIL/ImageCms.py
index 5915cc944c3..ec9471f84b4 100644
--- a/src/PIL/ImageCms.py
+++ b/src/PIL/ImageCms.py
@@ -754,7 +754,7 @@ def applyTransform(
 
 
 def createProfile(
-    colorSpace: Literal["LAB", "XYZ", "sRGB"], colorTemp: SupportsFloat = -1
+    colorSpace: Literal["LAB", "XYZ", "sRGB"], colorTemp: SupportsFloat = 0
 ) -> core.CmsProfile:
     """
     (pyCMS) Creates a profile.

From 8dae9b618f39b8afd9ae2177dcce6a02ea227006 Mon Sep 17 00:00:00 2001
From: Andrew Murray <radarhere@users.noreply.github.com>
Date: Sun, 2 Jun 2024 17:53:52 +1000
Subject: [PATCH 0667/1178] Corrected type hint

---
 src/PIL/ImageCms.py     | 2 +-
 src/PIL/_imagingcms.pyi | 2 +-
 2 files changed, 2 insertions(+), 2 deletions(-)

diff --git a/src/PIL/ImageCms.py b/src/PIL/ImageCms.py
index ec9471f84b4..19a79facc24 100644
--- a/src/PIL/ImageCms.py
+++ b/src/PIL/ImageCms.py
@@ -1089,7 +1089,7 @@ def isIntentSupported(
         raise PyCMSError(v) from v
 
 
-def versions() -> tuple[str, str, str, str]:
+def versions() -> tuple[str, str | None, str, str]:
     """
     (pyCMS) Fetches versions.
     """
diff --git a/src/PIL/_imagingcms.pyi b/src/PIL/_imagingcms.pyi
index f704047be3f..2abd6d0f7a9 100644
--- a/src/PIL/_imagingcms.pyi
+++ b/src/PIL/_imagingcms.pyi
@@ -2,7 +2,7 @@ import datetime
 import sys
 from typing import Literal, SupportsFloat, TypedDict
 
-littlecms_version: str
+littlecms_version: str | None
 
 _Tuple3f = tuple[float, float, float]
 _Tuple2x3f = tuple[_Tuple3f, _Tuple3f]

From d566c04d5b9b2f7587015b110e588b073a24cf2d Mon Sep 17 00:00:00 2001
From: Andrew Murray <radarhere@users.noreply.github.com>
Date: Mon, 3 Jun 2024 14:20:01 +1000
Subject: [PATCH 0668/1178] Updated type hints

---
 src/PIL/Image.py           | 22 +++++++---------
 src/PIL/ImageDraw.py       | 29 +++++++++++++++------
 src/PIL/ImageFont.py       | 53 +++++++++++++++++++-------------------
 src/PIL/JpegImagePlugin.py |  2 +-
 src/PIL/_imaging.pyi       |  4 +--
 src/PIL/_imagingft.pyi     | 23 ++++++++++++-----
 6 files changed, 75 insertions(+), 58 deletions(-)

diff --git a/src/PIL/Image.py b/src/PIL/Image.py
index c02c7d6b6bf..2ea26877d13 100644
--- a/src/PIL/Image.py
+++ b/src/PIL/Image.py
@@ -506,7 +506,7 @@ def _getscaleoffset(expr):
 class SupportsGetData(Protocol):
     def getdata(
         self,
-    ) -> tuple[Transform, Sequence[Any]]: ...
+    ) -> tuple[Transform, Sequence[int]]: ...
 
 
 class Image:
@@ -1295,7 +1295,7 @@ def _crop(self, im, box):
         return im.crop((x0, y0, x1, y1))
 
     def draft(
-        self, mode: str, size: tuple[int, int]
+        self, mode: str | None, size: tuple[int, int]
     ) -> tuple[str, tuple[int, int, float, float]] | None:
         """
         Configures the image file loader so it returns a version of the
@@ -1719,7 +1719,7 @@ def entropy(self, mask=None, extrema=None):
 
     def paste(
         self,
-        im: Image | str | int | tuple[int, ...],
+        im: Image | str | float | tuple[int, ...],
         box: tuple[int, int, int, int] | tuple[int, int] | None = None,
         mask: Image | None = None,
     ) -> None:
@@ -1750,7 +1750,7 @@ def paste(
         See :py:meth:`~PIL.Image.Image.alpha_composite` if you want to
         combine images with respect to their alpha channels.
 
-        :param im: Source image or pixel value (integer or tuple).
+        :param im: Source image or pixel value (integer, float or tuple).
         :param box: An optional 4-tuple giving the region to paste into.
            If a 2-tuple is used instead, it's treated as the upper left
            corner.  If omitted or None, the source is pasted into the
@@ -2228,13 +2228,9 @@ def resize(
             msg = "reducing_gap must be 1.0 or greater"
             raise ValueError(msg)
 
-        size = cast("tuple[int, int]", tuple(size))
-
         self.load()
         if box is None:
             box = (0, 0) + self.size
-        else:
-            box = cast("tuple[float, float, float, float]", tuple(box))
 
         if self.size == size and box == (0, 0) + self.size:
             return self.copy()
@@ -2291,8 +2287,6 @@ def reduce(
 
         if box is None:
             box = (0, 0) + self.size
-        else:
-            box = cast("tuple[int, int, int, int]", tuple(box))
 
         if factor == (1, 1) and box == (0, 0) + self.size:
             return self.copy()
@@ -2692,7 +2686,9 @@ def round_aspect(number, key):
                 return
             size = preserved_size
 
-            res = self.draft(None, (size[0] * reducing_gap, size[1] * reducing_gap))  # type: ignore[arg-type]
+            res = self.draft(
+                None, (int(size[0] * reducing_gap), int(size[1] * reducing_gap))
+            )
             if res is not None:
                 box = res[1]
         if box is None:
@@ -2799,7 +2795,7 @@ def getdata(self):
         im.info = self.info.copy()
         if method == Transform.MESH:
             # list of quads
-            for box, quad in cast("Sequence[tuple[float, float]]", data):
+            for box, quad in data:
                 im.__transformer(
                     box, self, Transform.QUAD, quad, resample, fillcolor is None
                 )
@@ -2957,7 +2953,7 @@ def transform(
         self,
         size: tuple[int, int],
         image: Image,
-        **options: dict[str, str | int | tuple[int, ...] | list[int]] | int,
+        **options: str | int | tuple[int, ...] | list[int],
     ) -> Image:
         pass
 
diff --git a/src/PIL/ImageDraw.py b/src/PIL/ImageDraw.py
index 1887a393352..0663d9ddf85 100644
--- a/src/PIL/ImageDraw.py
+++ b/src/PIL/ImageDraw.py
@@ -456,14 +456,12 @@ def draw_corners(pieslice) -> None:
                 self.draw.draw_rectangle(right, ink, 1)
 
     def _multiline_check(self, text: AnyStr) -> bool:
-        split_character = cast(AnyStr, "\n" if isinstance(text, str) else b"\n")
+        split_character = "\n" if isinstance(text, str) else b"\n"
 
         return split_character in text
 
     def _multiline_split(self, text: AnyStr) -> list[AnyStr]:
-        split_character = cast(AnyStr, "\n" if isinstance(text, str) else b"\n")
-
-        return text.split(split_character)
+        return text.split("\n" if isinstance(text, str) else b"\n")
 
     def _multiline_spacing(self, font, spacing, stroke_width):
         return (
@@ -477,7 +475,12 @@ def text(
         xy: tuple[float, float],
         text: str,
         fill=None,
-        font: ImageFont.FreeTypeFont | ImageFont.ImageFont | None = None,
+        font: (
+            ImageFont.ImageFont
+            | ImageFont.FreeTypeFont
+            | ImageFont.TransposedFont
+            | None
+        ) = None,
         anchor=None,
         spacing=4,
         align="left",
@@ -597,9 +600,14 @@ def draw_text(ink, stroke_width=0, stroke_offset=None) -> None:
     def multiline_text(
         self,
         xy: tuple[float, float],
-        text,
+        text: str,
         fill=None,
-        font=None,
+        font: (
+            ImageFont.ImageFont
+            | ImageFont.FreeTypeFont
+            | ImageFont.TransposedFont
+            | None
+        ) = None,
         anchor=None,
         spacing=4,
         align="left",
@@ -684,7 +692,12 @@ def multiline_text(
     def textlength(
         self,
         text: str,
-        font: ImageFont.FreeTypeFont | ImageFont.ImageFont | None = None,
+        font: (
+            ImageFont.ImageFont
+            | ImageFont.FreeTypeFont
+            | ImageFont.TransposedFont
+            | None
+        ) = None,
         direction=None,
         features=None,
         language=None,
diff --git a/src/PIL/ImageFont.py b/src/PIL/ImageFont.py
index 747c0c05077..a9925483e40 100644
--- a/src/PIL/ImageFont.py
+++ b/src/PIL/ImageFont.py
@@ -33,11 +33,11 @@
 import warnings
 from enum import IntEnum
 from io import BytesIO
-from typing import TYPE_CHECKING, BinaryIO
+from typing import IO, TYPE_CHECKING, Any, BinaryIO
 
 from . import Image
 from ._typing import StrOrBytesPath
-from ._util import is_directory, is_path
+from ._util import is_path
 
 if TYPE_CHECKING:
     from . import ImageFile
@@ -61,7 +61,7 @@ class Layout(IntEnum):
     core = DeferredError.new(ex)
 
 
-def _string_length_check(text: str) -> None:
+def _string_length_check(text: str | bytes | bytearray) -> None:
     if MAX_STRING_LENGTH is not None and len(text) > MAX_STRING_LENGTH:
         msg = "too many characters in string"
         raise ValueError(msg)
@@ -113,7 +113,7 @@ def _load_pilfont(self, filename: str) -> None:
             self._load_pilfont_data(fp, image)
             image.close()
 
-    def _load_pilfont_data(self, file, image):
+    def _load_pilfont_data(self, file: IO[bytes], image: Image.Image) -> None:
         # read PILfont header
         if file.readline() != b"PILfont\n":
             msg = "Not a PILfont file"
@@ -161,7 +161,7 @@ def getmask(self, text, mode="", *args, **kwargs):
         return self.font.getmask(text, mode)
 
     def getbbox(
-        self, text: str, *args: object, **kwargs: object
+        self, text: str | bytes | bytearray, *args: Any, **kwargs: Any
     ) -> tuple[int, int, int, int]:
         """
         Returns bounding box (in pixels) of given text.
@@ -180,7 +180,9 @@ def getbbox(
         width, height = self.font.getsize(text)
         return 0, 0, width, height
 
-    def getlength(self, text: str, *args: object, **kwargs: object) -> int:
+    def getlength(
+        self, text: str | bytes | bytearray, *args: Any, **kwargs: Any
+    ) -> int:
         """
         Returns length (in pixels) of given text.
         This is the amount by which following text should be offset.
@@ -357,13 +359,13 @@ def getlength(
     def getbbox(
         self,
         text: str,
-        mode="",
-        direction=None,
-        features=None,
-        language=None,
-        stroke_width=0,
-        anchor=None,
-    ) -> tuple[int, int, int, int]:
+        mode: str = "",
+        direction: str | None = None,
+        features: str | None = None,
+        language: str | None = None,
+        stroke_width: float = 0,
+        anchor: str | None = None,
+    ) -> tuple[float, float, float, float]:
         """
         Returns bounding box (in pixels) of given text relative to given anchor
         when rendered in font with provided direction, features, and language.
@@ -513,7 +515,7 @@ def getmask(
 
     def getmask2(
         self,
-        text,
+        text: str,
         mode="",
         direction=None,
         features=None,
@@ -641,7 +643,7 @@ def font_variant(
             layout_engine=layout_engine or self.layout_engine,
         )
 
-    def get_variation_names(self):
+    def get_variation_names(self) -> list[bytes]:
         """
         :returns: A list of the named styles in a variation font.
         :exception OSError: If the font is not a variation font.
@@ -683,10 +685,11 @@ def get_variation_axes(self):
             msg = "FreeType 2.9.1 or greater is required"
             raise NotImplementedError(msg) from e
         for axis in axes:
-            axis["name"] = axis["name"].replace(b"\x00", b"")
+            if axis["name"]:
+                axis["name"] = axis["name"].replace(b"\x00", b"")
         return axes
 
-    def set_variation_by_axes(self, axes):
+    def set_variation_by_axes(self, axes: list[float]) -> None:
         """
         :param axes: A list of values for each axis.
         :exception OSError: If the font is not a variation font.
@@ -731,7 +734,7 @@ def getbbox(self, text, *args, **kwargs):
             return 0, 0, height, width
         return 0, 0, width, height
 
-    def getlength(self, text, *args, **kwargs):
+    def getlength(self, text: str, *args, **kwargs) -> float:
         if self.orientation in (Image.Transpose.ROTATE_90, Image.Transpose.ROTATE_270):
             msg = "text length is undefined for text rotated by 90 or 270 degrees"
             raise ValueError(msg)
@@ -878,15 +881,13 @@ def load_path(filename: str | bytes) -> ImageFont:
     :return: A font object.
     :exception OSError: If the file could not be read.
     """
+    if not isinstance(filename, str):
+        filename = filename.decode("utf-8")
     for directory in sys.path:
-        if is_directory(directory):
-            assert isinstance(directory, str)
-            if not isinstance(filename, str):
-                filename = filename.decode("utf-8")
-            try:
-                return load(os.path.join(directory, filename))
-            except OSError:
-                pass
+        try:
+            return load(os.path.join(directory, filename))
+        except OSError:
+            pass
     msg = "cannot find font file"
     raise OSError(msg)
 
diff --git a/src/PIL/JpegImagePlugin.py b/src/PIL/JpegImagePlugin.py
index 909911dfe37..e1c61f991c5 100644
--- a/src/PIL/JpegImagePlugin.py
+++ b/src/PIL/JpegImagePlugin.py
@@ -425,7 +425,7 @@ def load_read(self, read_bytes: int) -> bytes:
         return s
 
     def draft(
-        self, mode: str, size: tuple[int, int]
+        self, mode: str | None, size: tuple[int, int]
     ) -> tuple[str, tuple[int, int, float, float]] | None:
         if len(self.tile) != 1:
             return None
diff --git a/src/PIL/_imaging.pyi b/src/PIL/_imaging.pyi
index d85eb84fa69..1fe95441715 100644
--- a/src/PIL/_imaging.pyi
+++ b/src/PIL/_imaging.pyi
@@ -1,7 +1,5 @@
 from typing import Any
 
-from typing_extensions import Buffer
-
 class ImagingCore:
     def __getattr__(self, name: str) -> Any: ...
 
@@ -14,5 +12,5 @@ class ImagingDraw:
 class PixelAccess:
     def __getattr__(self, name: str) -> Any: ...
 
-def font(image, glyphdata: Buffer) -> ImagingFont: ...
+def font(image, glyphdata: bytes) -> ImagingFont: ...
 def __getattr__(name: str) -> Any: ...
diff --git a/src/PIL/_imagingft.pyi b/src/PIL/_imagingft.pyi
index 987e7fd6f49..b023efe0110 100644
--- a/src/PIL/_imagingft.pyi
+++ b/src/PIL/_imagingft.pyi
@@ -1,5 +1,7 @@
 from typing import Any, TypedDict
 
+from . import _imaging
+
 class _Axis(TypedDict):
     minimum: int | None
     default: int | None
@@ -37,21 +39,28 @@ class Font:
         x_start=...,
         y_start=...,
         /,
-    ) -> tuple[Any, tuple[int, int]]: ...
+    ) -> tuple[_imaging.ImagingCore, tuple[int, int]]: ...
     def getsize(
-        self, string: str, mode=..., dir=..., features=..., lang=..., anchor=..., /
+        self,
+        string: str | bytes | bytearray,
+        mode=...,
+        dir=...,
+        features=...,
+        lang=...,
+        anchor=...,
+        /,
     ) -> tuple[tuple[int, int], tuple[int, int]]: ...
     def getlength(
         self, string: str, mode=..., dir=..., features=..., lang=..., /
-    ) -> int: ...
-    def getvarnames(self) -> list[str]: ...
-    def getvaraxes(self) -> list[_Axis]: ...
+    ) -> float: ...
+    def getvarnames(self) -> list[bytes]: ...
+    def getvaraxes(self) -> list[_Axis] | None: ...
     def setvarname(self, instance_index: int, /) -> None: ...
     def setvaraxes(self, axes: list[float], /) -> None: ...
 
 def getfont(
-    filename: str | bytes | bytearray,
-    size,
+    filename: str | bytes,
+    size: float,
     index=...,
     encoding=...,
     font_bytes=...,

From f5da04adb07f19bd79aededb2be7291d445e4f96 Mon Sep 17 00:00:00 2001
From: Andrew Murray <radarhere@users.noreply.github.com>
Date: Mon, 3 Jun 2024 21:58:02 +1000
Subject: [PATCH 0669/1178] Added type hints

Co-authored-by: Nulano <nulano@nulano.eu>
---
 src/PIL/Image.py     | 10 ++++------
 src/PIL/ImageDraw.py |  8 +++++++-
 src/PIL/PyAccess.py  | 41 ++++++++++++++++++++++++++---------------
 3 files changed, 37 insertions(+), 22 deletions(-)

diff --git a/src/PIL/Image.py b/src/PIL/Image.py
index 958b95e3b0f..dd6984020b0 100644
--- a/src/PIL/Image.py
+++ b/src/PIL/Image.py
@@ -1511,7 +1511,7 @@ def _reload_exif(self) -> None:
         self._exif._loaded = False
         self.getexif()
 
-    def get_child_images(self):
+    def get_child_images(self) -> list[ImageFile.ImageFile]:
         child_images = []
         exif = self.getexif()
         ifds = []
@@ -1535,10 +1535,7 @@ def get_child_images(self):
             fp = self.fp
             thumbnail_offset = ifd.get(513)
             if thumbnail_offset is not None:
-                try:
-                    thumbnail_offset += self._exif_offset
-                except AttributeError:
-                    pass
+                thumbnail_offset += getattr(self, "_exif_offset", 0)
                 self.fp.seek(thumbnail_offset)
                 data = self.fp.read(ifd.get(514))
                 fp = io.BytesIO(data)
@@ -1604,7 +1601,7 @@ def has_transparency_data(self) -> bool:
             or "transparency" in self.info
         )
 
-    def apply_transparency(self):
+    def apply_transparency(self) -> None:
         """
         If a P mode image has a "transparency" key in the info dictionary,
         remove the key and instead apply the transparency to the palette.
@@ -1616,6 +1613,7 @@ def apply_transparency(self):
         from . import ImagePalette
 
         palette = self.getpalette("RGBA")
+        assert palette is not None
         transparency = self.info["transparency"]
         if isinstance(transparency, bytes):
             for i, alpha in enumerate(transparency):
diff --git a/src/PIL/ImageDraw.py b/src/PIL/ImageDraw.py
index 17c17643066..8fe179dd591 100644
--- a/src/PIL/ImageDraw.py
+++ b/src/PIL/ImageDraw.py
@@ -908,7 +908,13 @@ def getdraw(im=None, hints=None):
     return im, handler
 
 
-def floodfill(image: Image.Image, xy, value, border=None, thresh=0) -> None:
+def floodfill(
+    image: Image.Image,
+    xy: tuple[int, int],
+    value: float | tuple[int, ...],
+    border: float | tuple[int, ...] | None = None,
+    thresh: float = 0,
+) -> None:
     """
     (experimental) Fills a bounded region with a given color.
 
diff --git a/src/PIL/PyAccess.py b/src/PIL/PyAccess.py
index a9da90613e7..fe12cb641e1 100644
--- a/src/PIL/PyAccess.py
+++ b/src/PIL/PyAccess.py
@@ -22,6 +22,7 @@
 
 import logging
 import sys
+from typing import TYPE_CHECKING
 
 from ._deprecate import deprecate
 
@@ -48,9 +49,12 @@
 
 logger = logging.getLogger(__name__)
 
+if TYPE_CHECKING:
+    from . import Image
+
 
 class PyAccess:
-    def __init__(self, img, readonly=False):
+    def __init__(self, img: Image.Image, readonly: bool = False) -> None:
         deprecate("PyAccess", 11)
         vals = dict(img.im.unsafe_ptrs)
         self.readonly = readonly
@@ -77,7 +81,8 @@ def __setitem__(self, xy, color):
         """
         Modifies the pixel at x,y. The color is given as a single
         numerical value for single band images, and a tuple for
-        multi-band images
+        multi-band images. In addition to this, RGB and RGBA tuples
+        are accepted for P and PA images.
 
         :param xy: The pixel coordinate, given as (x, y). See
            :ref:`coordinate-system`.
@@ -108,7 +113,7 @@ def __setitem__(self, xy, color):
 
         return self.set_pixel(x, y, color)
 
-    def __getitem__(self, xy):
+    def __getitem__(self, xy: tuple[int, int]) -> float | tuple[int, ...]:
         """
         Returns the pixel at x,y. The pixel is returned as a single
         value for single band images or a tuple for multiple band
@@ -130,13 +135,19 @@ def __getitem__(self, xy):
     putpixel = __setitem__
     getpixel = __getitem__
 
-    def check_xy(self, xy):
+    def check_xy(self, xy: tuple[int, int]) -> tuple[int, int]:
         (x, y) = xy
         if not (0 <= x < self.xsize and 0 <= y < self.ysize):
             msg = "pixel location out of range"
             raise ValueError(msg)
         return xy
 
+    def get_pixel(self, x: int, y: int) -> float | tuple[int, ...]:
+        raise NotImplementedError()
+
+    def set_pixel(self, x: int, y: int, color: float | tuple[int, ...]) -> None:
+        raise NotImplementedError()
+
 
 class _PyAccess32_2(PyAccess):
     """PA, LA, stored in first and last bytes of a 32 bit word"""
@@ -144,7 +155,7 @@ class _PyAccess32_2(PyAccess):
     def _post_init(self, *args, **kwargs):
         self.pixels = ffi.cast("struct Pixel_RGBA **", self.image32)
 
-    def get_pixel(self, x, y):
+    def get_pixel(self, x: int, y: int) -> tuple[int, int]:
         pixel = self.pixels[y][x]
         return pixel.r, pixel.a
 
@@ -161,7 +172,7 @@ class _PyAccess32_3(PyAccess):
     def _post_init(self, *args, **kwargs):
         self.pixels = ffi.cast("struct Pixel_RGBA **", self.image32)
 
-    def get_pixel(self, x, y):
+    def get_pixel(self, x: int, y: int) -> tuple[int, int, int]:
         pixel = self.pixels[y][x]
         return pixel.r, pixel.g, pixel.b
 
@@ -180,7 +191,7 @@ class _PyAccess32_4(PyAccess):
     def _post_init(self, *args, **kwargs):
         self.pixels = ffi.cast("struct Pixel_RGBA **", self.image32)
 
-    def get_pixel(self, x, y):
+    def get_pixel(self, x: int, y: int) -> tuple[int, int, int, int]:
         pixel = self.pixels[y][x]
         return pixel.r, pixel.g, pixel.b, pixel.a
 
@@ -199,7 +210,7 @@ class _PyAccess8(PyAccess):
     def _post_init(self, *args, **kwargs):
         self.pixels = self.image8
 
-    def get_pixel(self, x, y):
+    def get_pixel(self, x: int, y: int) -> int:
         return self.pixels[y][x]
 
     def set_pixel(self, x, y, color):
@@ -217,7 +228,7 @@ class _PyAccessI16_N(PyAccess):
     def _post_init(self, *args, **kwargs):
         self.pixels = ffi.cast("unsigned short **", self.image)
 
-    def get_pixel(self, x, y):
+    def get_pixel(self, x: int, y: int) -> int:
         return self.pixels[y][x]
 
     def set_pixel(self, x, y, color):
@@ -235,7 +246,7 @@ class _PyAccessI16_L(PyAccess):
     def _post_init(self, *args, **kwargs):
         self.pixels = ffi.cast("struct Pixel_I16 **", self.image)
 
-    def get_pixel(self, x, y):
+    def get_pixel(self, x: int, y: int) -> int:
         pixel = self.pixels[y][x]
         return pixel.l + pixel.r * 256
 
@@ -256,7 +267,7 @@ class _PyAccessI16_B(PyAccess):
     def _post_init(self, *args, **kwargs):
         self.pixels = ffi.cast("struct Pixel_I16 **", self.image)
 
-    def get_pixel(self, x, y):
+    def get_pixel(self, x: int, y: int) -> int:
         pixel = self.pixels[y][x]
         return pixel.l * 256 + pixel.r
 
@@ -277,7 +288,7 @@ class _PyAccessI32_N(PyAccess):
     def _post_init(self, *args, **kwargs):
         self.pixels = self.image32
 
-    def get_pixel(self, x, y):
+    def get_pixel(self, x: int, y: int) -> int:
         return self.pixels[y][x]
 
     def set_pixel(self, x, y, color):
@@ -296,7 +307,7 @@ def reverse(self, i):
         chars[0], chars[1], chars[2], chars[3] = chars[3], chars[2], chars[1], chars[0]
         return ffi.cast("int *", chars)[0]
 
-    def get_pixel(self, x, y):
+    def get_pixel(self, x: int, y: int) -> int:
         return self.reverse(self.pixels[y][x])
 
     def set_pixel(self, x, y, color):
@@ -309,7 +320,7 @@ class _PyAccessF(PyAccess):
     def _post_init(self, *args, **kwargs):
         self.pixels = ffi.cast("float **", self.image32)
 
-    def get_pixel(self, x, y):
+    def get_pixel(self, x: int, y: int) -> float:
         return self.pixels[y][x]
 
     def set_pixel(self, x, y, color):
@@ -357,7 +368,7 @@ def set_pixel(self, x, y, color):
     mode_map["I;32B"] = _PyAccessI32_N
 
 
-def new(img, readonly=False):
+def new(img: Image.Image, readonly: bool = False) -> PyAccess | None:
     access_type = mode_map.get(img.mode, None)
     if not access_type:
         logger.debug("PyAccess Not Implemented: %s", img.mode)

From 322814d7ce8d48bcbf45ac912aecef445f6743b2 Mon Sep 17 00:00:00 2001
From: "pre-commit-ci[bot]"
 <66853113+pre-commit-ci[bot]@users.noreply.github.com>
Date: Mon, 3 Jun 2024 17:24:10 +0000
Subject: [PATCH 0670/1178] [pre-commit.ci] pre-commit autoupdate
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit

updates:
- [github.com/astral-sh/ruff-pre-commit: v0.4.3 → v0.4.7](https://github.com/astral-sh/ruff-pre-commit/compare/v0.4.3...v0.4.7)
- [github.com/pre-commit/mirrors-clang-format: v18.1.4 → v18.1.5](https://github.com/pre-commit/mirrors-clang-format/compare/v18.1.4...v18.1.5)
- [github.com/python-jsonschema/check-jsonschema: 0.28.2 → 0.28.4](https://github.com/python-jsonschema/check-jsonschema/compare/0.28.2...0.28.4)
- [github.com/abravalheri/validate-pyproject: v0.16 → v0.18](https://github.com/abravalheri/validate-pyproject/compare/v0.16...v0.18)
---
 .pre-commit-config.yaml | 8 ++++----
 1 file changed, 4 insertions(+), 4 deletions(-)

diff --git a/.pre-commit-config.yaml b/.pre-commit-config.yaml
index e848eb67080..6a76e8c00cb 100644
--- a/.pre-commit-config.yaml
+++ b/.pre-commit-config.yaml
@@ -1,6 +1,6 @@
 repos:
   - repo: https://github.com/astral-sh/ruff-pre-commit
-    rev: v0.4.3
+    rev: v0.4.7
     hooks:
       - id: ruff
         args: [--exit-non-zero-on-fix]
@@ -24,7 +24,7 @@ repos:
         exclude: (Makefile$|\.bat$|\.cmake$|\.eps$|\.fits$|\.gd$|\.opt$)
 
   - repo: https://github.com/pre-commit/mirrors-clang-format
-    rev: v18.1.4
+    rev: v18.1.5
     hooks:
       - id: clang-format
         types: [c]
@@ -50,7 +50,7 @@ repos:
         exclude: ^.github/.*TEMPLATE|^Tests/(fonts|images)/
 
   - repo: https://github.com/python-jsonschema/check-jsonschema
-    rev: 0.28.2
+    rev: 0.28.4
     hooks:
       - id: check-github-workflows
       - id: check-readthedocs
@@ -67,7 +67,7 @@ repos:
       - id: pyproject-fmt
 
   - repo: https://github.com/abravalheri/validate-pyproject
-    rev: v0.16
+    rev: v0.18
     hooks:
       - id: validate-pyproject
 

From e9c9f19c26c3a361c4fa17947b6b5d860e516c2c Mon Sep 17 00:00:00 2001
From: Andrew Murray <radarhere@users.noreply.github.com>
Date: Tue, 4 Jun 2024 18:46:35 +1000
Subject: [PATCH 0671/1178] Do not use first frame duration for other frames
 when saving

---
 Tests/test_file_apng.py   | 15 +++++++++++++--
 src/PIL/PngImagePlugin.py | 13 ++++++-------
 2 files changed, 19 insertions(+), 9 deletions(-)

diff --git a/Tests/test_file_apng.py b/Tests/test_file_apng.py
index 1b393a3ff5d..e95850212a5 100644
--- a/Tests/test_file_apng.py
+++ b/Tests/test_file_apng.py
@@ -706,10 +706,21 @@ def test_different_modes_in_later_frames(
         assert reloaded.mode == mode
 
 
-def test_apng_repeated_seeks_give_correct_info() -> None:
+def test_different_durations(tmp_path: Path) -> None:
+    test_file = str(tmp_path / "temp.png")
+
     with Image.open("Tests/images/apng/different_durations.png") as im:
-        for i in range(3):
+        for _ in range(3):
             im.seek(0)
             assert im.info["duration"] == 4000
+
             im.seek(1)
             assert im.info["duration"] == 1000
+
+        im.save(test_file, save_all=True)
+
+    with Image.open(test_file) as reloaded:
+        assert reloaded.info["duration"] == 4000
+
+        reloaded.seek(1)
+        assert reloaded.info["duration"] == 1000
diff --git a/src/PIL/PngImagePlugin.py b/src/PIL/PngImagePlugin.py
index 0d5751962c0..dde45e587e1 100644
--- a/src/PIL/PngImagePlugin.py
+++ b/src/PIL/PngImagePlugin.py
@@ -1105,7 +1105,7 @@ def write(self, data: bytes) -> None:
 
 
 def _write_multiple_frames(im, fp, chunk, rawmode, default_image, append_images):
-    duration = im.encoderinfo.get("duration", im.info.get("duration", 0))
+    duration = im.encoderinfo.get("duration")
     loop = im.encoderinfo.get("loop", im.info.get("loop", 0))
     disposal = im.encoderinfo.get("disposal", im.info.get("disposal", Disposal.OP_NONE))
     blend = im.encoderinfo.get("blend", im.info.get("blend", Blend.OP_SOURCE))
@@ -1126,6 +1126,8 @@ def _write_multiple_frames(im, fp, chunk, rawmode, default_image, append_images)
             encoderinfo = im.encoderinfo.copy()
             if isinstance(duration, (list, tuple)):
                 encoderinfo["duration"] = duration[frame_count]
+            elif duration is None and "duration" in im_frame.info:
+                encoderinfo["duration"] = im_frame.info["duration"]
             if isinstance(disposal, (list, tuple)):
                 encoderinfo["disposal"] = disposal[frame_count]
             if isinstance(blend, (list, tuple)):
@@ -1160,15 +1162,12 @@ def _write_multiple_frames(im, fp, chunk, rawmode, default_image, append_images)
                     not bbox
                     and prev_disposal == encoderinfo.get("disposal")
                     and prev_blend == encoderinfo.get("blend")
+                    and "duration" in encoderinfo
                 ):
-                    previous["encoderinfo"]["duration"] += encoderinfo.get(
-                        "duration", duration
-                    )
+                    previous["encoderinfo"]["duration"] += encoderinfo["duration"]
                     continue
             else:
                 bbox = None
-            if "duration" not in encoderinfo:
-                encoderinfo["duration"] = duration
             im_frames.append({"im": im_frame, "bbox": bbox, "encoderinfo": encoderinfo})
 
     if len(im_frames) == 1 and not default_image:
@@ -1198,7 +1197,7 @@ def _write_multiple_frames(im, fp, chunk, rawmode, default_image, append_images)
             im_frame = im_frame.crop(bbox)
         size = im_frame.size
         encoderinfo = frame_data["encoderinfo"]
-        frame_duration = int(round(encoderinfo["duration"]))
+        frame_duration = int(round(encoderinfo.get("duration", 0)))
         frame_disposal = encoderinfo.get("disposal", disposal)
         frame_blend = encoderinfo.get("blend", blend)
         # frame control

From 6e40601f69875e0734dce467e4a3b969649f65bf Mon Sep 17 00:00:00 2001
From: Andrew Murray <radarhere@users.noreply.github.com>
Date: Tue, 4 Jun 2024 20:37:09 +1000
Subject: [PATCH 0672/1178] Added type hints

---
 src/PIL/BlpImagePlugin.py    |  3 ++-
 src/PIL/EpsImagePlugin.py    |  2 +-
 src/PIL/FpxImagePlugin.py    |  6 +++---
 src/PIL/ImageEnhance.py      | 13 ++++++++-----
 src/PIL/ImageFilter.py       | 25 ++++++++++++++++---------
 src/PIL/ImageMorph.py        |  6 +++---
 src/PIL/Jpeg2KImagePlugin.py |  6 +++---
 src/PIL/PaletteFile.py       |  2 +-
 src/PIL/QoiImagePlugin.py    |  2 +-
 src/PIL/SpiderImagePlugin.py |  2 +-
 src/PIL/WebPImagePlugin.py   |  2 +-
 11 files changed, 40 insertions(+), 29 deletions(-)

diff --git a/src/PIL/BlpImagePlugin.py b/src/PIL/BlpImagePlugin.py
index 782e28cf5df..2db115ccc4f 100644
--- a/src/PIL/BlpImagePlugin.py
+++ b/src/PIL/BlpImagePlugin.py
@@ -35,6 +35,7 @@
 import struct
 from enum import IntEnum
 from io import BytesIO
+from typing import IO
 
 from . import Image, ImageFile
 
@@ -448,7 +449,7 @@ def encode(self, bufsize):
         return len(data), 0, data
 
 
-def _save(im, fp, filename):
+def _save(im: Image.Image, fp: IO[bytes], filename: str) -> None:
     if im.mode != "P":
         msg = "Unsupported BLP image mode"
         raise ValueError(msg)
diff --git a/src/PIL/EpsImagePlugin.py b/src/PIL/EpsImagePlugin.py
index 5a44baa491e..d24a2ba80f0 100644
--- a/src/PIL/EpsImagePlugin.py
+++ b/src/PIL/EpsImagePlugin.py
@@ -228,7 +228,7 @@ def _open(self) -> None:
         reading_trailer_comments = False
         trailer_reached = False
 
-        def check_required_header_comments():
+        def check_required_header_comments() -> None:
             if "PS-Adobe" not in self.info:
                 msg = 'EPS header missing "%!PS-Adobe" comment'
                 raise SyntaxError(msg)
diff --git a/src/PIL/FpxImagePlugin.py b/src/PIL/FpxImagePlugin.py
index 4ba93bb3912..b3e6c6e362b 100644
--- a/src/PIL/FpxImagePlugin.py
+++ b/src/PIL/FpxImagePlugin.py
@@ -70,7 +70,7 @@ def _open(self):
 
         self._open_index(1)
 
-    def _open_index(self, index=1):
+    def _open_index(self, index: int = 1) -> None:
         #
         # get the Image Contents Property Set
 
@@ -85,7 +85,7 @@ def _open_index(self, index=1):
         size = max(self.size)
         i = 1
         while size > 64:
-            size = size / 2
+            size = size // 2
             i += 1
         self.maxid = i - 1
 
@@ -118,7 +118,7 @@ def _open_index(self, index=1):
 
         self._open_subimage(1, self.maxid)
 
-    def _open_subimage(self, index=1, subimage=0):
+    def _open_subimage(self, index: int = 1, subimage: int = 0) -> None:
         #
         # setup tile descriptors for a given subimage
 
diff --git a/src/PIL/ImageEnhance.py b/src/PIL/ImageEnhance.py
index 93a50d2a2b9..d7e99a96815 100644
--- a/src/PIL/ImageEnhance.py
+++ b/src/PIL/ImageEnhance.py
@@ -23,7 +23,10 @@
 
 
 class _Enhance:
-    def enhance(self, factor):
+    image: Image.Image
+    degenerate: Image.Image
+
+    def enhance(self, factor: float) -> Image.Image:
         """
         Returns an enhanced image.
 
@@ -46,7 +49,7 @@ class Color(_Enhance):
     the original image.
     """
 
-    def __init__(self, image):
+    def __init__(self, image: Image.Image) -> None:
         self.image = image
         self.intermediate_mode = "L"
         if "A" in image.getbands():
@@ -63,7 +66,7 @@ class Contrast(_Enhance):
     gives a solid gray image. A factor of 1.0 gives the original image.
     """
 
-    def __init__(self, image):
+    def __init__(self, image: Image.Image) -> None:
         self.image = image
         mean = int(ImageStat.Stat(image.convert("L")).mean[0] + 0.5)
         self.degenerate = Image.new("L", image.size, mean).convert(image.mode)
@@ -80,7 +83,7 @@ class Brightness(_Enhance):
     original image.
     """
 
-    def __init__(self, image):
+    def __init__(self, image: Image.Image) -> None:
         self.image = image
         self.degenerate = Image.new(image.mode, image.size, 0)
 
@@ -96,7 +99,7 @@ class Sharpness(_Enhance):
     original image, and a factor of 2.0 gives a sharpened image.
     """
 
-    def __init__(self, image):
+    def __init__(self, image: Image.Image) -> None:
         self.image = image
         self.degenerate = image.filter(ImageFilter.SMOOTH)
 
diff --git a/src/PIL/ImageFilter.py b/src/PIL/ImageFilter.py
index 43e700b7b30..02288e13576 100644
--- a/src/PIL/ImageFilter.py
+++ b/src/PIL/ImageFilter.py
@@ -18,7 +18,8 @@
 
 import abc
 import functools
-from typing import Sequence
+from types import ModuleType
+from typing import Any, Sequence
 
 
 class Filter:
@@ -57,7 +58,13 @@ class Kernel(BuiltinFilter):
 
     name = "Kernel"
 
-    def __init__(self, size, kernel, scale=None, offset=0):
+    def __init__(
+        self,
+        size: tuple[int, int],
+        kernel: Sequence[float],
+        scale: float | None = None,
+        offset: float = 0,
+    ) -> None:
         if scale is None:
             # default scale is sum of kernel
             scale = functools.reduce(lambda a, b: a + b, kernel)
@@ -194,10 +201,8 @@ class BoxBlur(MultibandFilter):
 
     name = "BoxBlur"
 
-    def __init__(self, radius):
-        xy = radius
-        if not isinstance(xy, (tuple, list)):
-            xy = (xy, xy)
+    def __init__(self, radius: float | Sequence[float]) -> None:
+        xy = radius if isinstance(radius, (tuple, list)) else (radius, radius)
         if xy[0] < 0 or xy[1] < 0:
             msg = "radius must be >= 0"
             raise ValueError(msg)
@@ -381,7 +386,9 @@ class Color3DLUT(MultibandFilter):
 
     name = "Color 3D LUT"
 
-    def __init__(self, size, table, channels=3, target_mode=None, **kwargs):
+    def __init__(
+        self, size, table, channels: int = 3, target_mode: str | None = None, **kwargs
+    ):
         if channels not in (3, 4):
             msg = "Only 3 or 4 output channels are supported"
             raise ValueError(msg)
@@ -395,7 +402,7 @@ def __init__(self, size, table, channels=3, target_mode=None, **kwargs):
         items = size[0] * size[1] * size[2]
         wrong_size = False
 
-        numpy = None
+        numpy: ModuleType | None = None
         if hasattr(table, "shape"):
             try:
                 import numpy
@@ -442,7 +449,7 @@ def __init__(self, size, table, channels=3, target_mode=None, **kwargs):
         self.table = table
 
     @staticmethod
-    def _check_size(size):
+    def _check_size(size: Any) -> list[int]:
         try:
             _, _, _ = size
         except ValueError as e:
diff --git a/src/PIL/ImageMorph.py b/src/PIL/ImageMorph.py
index 6ee8c4f253d..6a43983d33d 100644
--- a/src/PIL/ImageMorph.py
+++ b/src/PIL/ImageMorph.py
@@ -200,7 +200,7 @@ def __init__(
         elif patterns is not None:
             self.lut = LutBuilder(patterns=patterns).build_lut()
 
-    def apply(self, image: Image.Image):
+    def apply(self, image: Image.Image) -> tuple[int, Image.Image]:
         """Run a single morphological operation on an image
 
         Returns a tuple of the number of changed pixels and the
@@ -216,7 +216,7 @@ def apply(self, image: Image.Image):
         count = _imagingmorph.apply(bytes(self.lut), image.im.id, outimage.im.id)
         return count, outimage
 
-    def match(self, image: Image.Image):
+    def match(self, image: Image.Image) -> list[tuple[int, int]]:
         """Get a list of coordinates matching the morphological operation on
         an image.
 
@@ -231,7 +231,7 @@ def match(self, image: Image.Image):
             raise ValueError(msg)
         return _imagingmorph.match(bytes(self.lut), image.im.id)
 
-    def get_on_pixels(self, image: Image.Image):
+    def get_on_pixels(self, image: Image.Image) -> list[tuple[int, int]]:
         """Get a list of all turned on pixels in a binary image
 
         Returns a list of tuples of (x,y) coordinates
diff --git a/src/PIL/Jpeg2KImagePlugin.py b/src/PIL/Jpeg2KImagePlugin.py
index ce6342bdba2..e6395b1cb96 100644
--- a/src/PIL/Jpeg2KImagePlugin.py
+++ b/src/PIL/Jpeg2KImagePlugin.py
@@ -34,7 +34,7 @@ def __init__(self, fp, length=-1):
         self.length = length
         self.remaining_in_box = -1
 
-    def _can_read(self, num_bytes):
+    def _can_read(self, num_bytes: int) -> bool:
         if self.has_length and self.fp.tell() + num_bytes > self.length:
             # Outside box: ensure we don't read past the known file length
             return False
@@ -44,7 +44,7 @@ def _can_read(self, num_bytes):
         else:
             return True  # No length known, just read
 
-    def _read_bytes(self, num_bytes):
+    def _read_bytes(self, num_bytes: int) -> bytes:
         if not self._can_read(num_bytes):
             msg = "Not enough data in header"
             raise SyntaxError(msg)
@@ -74,7 +74,7 @@ def has_next_box(self) -> bool:
         else:
             return True
 
-    def next_box_type(self):
+    def next_box_type(self) -> bytes:
         # Skip the rest of the box if it has not been read
         if self.remaining_in_box > 0:
             self.fp.seek(self.remaining_in_box, os.SEEK_CUR)
diff --git a/src/PIL/PaletteFile.py b/src/PIL/PaletteFile.py
index dc31754020e..eaed5367c99 100644
--- a/src/PIL/PaletteFile.py
+++ b/src/PIL/PaletteFile.py
@@ -48,5 +48,5 @@ def __init__(self, fp):
 
         self.palette = b"".join(self.palette)
 
-    def getpalette(self):
+    def getpalette(self) -> tuple[bytes, str]:
         return self.palette, self.rawmode
diff --git a/src/PIL/QoiImagePlugin.py b/src/PIL/QoiImagePlugin.py
index cea8b60da81..f2cf06d0dd7 100644
--- a/src/PIL/QoiImagePlugin.py
+++ b/src/PIL/QoiImagePlugin.py
@@ -38,7 +38,7 @@ def _open(self) -> None:
 class QoiDecoder(ImageFile.PyDecoder):
     _pulls_fd = True
 
-    def _add_to_previous_pixels(self, value):
+    def _add_to_previous_pixels(self, value: bytes | bytearray) -> None:
         self._previous_pixel = value
 
         r, g, b, a = value
diff --git a/src/PIL/SpiderImagePlugin.py b/src/PIL/SpiderImagePlugin.py
index 5b8ad47f0cd..e5242395f92 100644
--- a/src/PIL/SpiderImagePlugin.py
+++ b/src/PIL/SpiderImagePlugin.py
@@ -233,7 +233,7 @@ def loadImageSeries(filelist=None):
 # For saving images in Spider format
 
 
-def makeSpiderHeader(im):
+def makeSpiderHeader(im: Image.Image) -> list[bytes]:
     nsam, nrow = im.size
     lenbyt = nsam * 4  # There are labrec records in the header
     labrec = int(1024 / lenbyt)
diff --git a/src/PIL/WebPImagePlugin.py b/src/PIL/WebPImagePlugin.py
index ff7402dca32..463d6a62398 100644
--- a/src/PIL/WebPImagePlugin.py
+++ b/src/PIL/WebPImagePlugin.py
@@ -117,7 +117,7 @@ def seek(self, frame: int) -> None:
         # Set logical frame to requested position
         self.__logical_frame = frame
 
-    def _reset(self, reset=True):
+    def _reset(self, reset: bool = True) -> None:
         if reset:
             self._decoder.reset()
         self.__physical_frame = 0

From b3c534cc9aa1acb7d84d0be83c2919072e46af95 Mon Sep 17 00:00:00 2001
From: Andrew Murray <radarhere@users.noreply.github.com>
Date: Wed, 5 Jun 2024 08:29:28 +1000
Subject: [PATCH 0673/1178] Added type hints

---
 src/PIL/BmpImagePlugin.py      |  9 ++++++---
 src/PIL/BufrStubImagePlugin.py |  4 +++-
 src/PIL/DdsImagePlugin.py      |  3 ++-
 src/PIL/GifImagePlugin.py      | 16 +++++++++-------
 src/PIL/GribStubImagePlugin.py |  4 +++-
 src/PIL/IcoImagePlugin.py      |  6 ++++--
 src/PIL/ImImagePlugin.py       |  5 +++--
 src/PIL/Image.py               | 20 ++++++++++----------
 src/PIL/MpoImagePlugin.py      |  3 ++-
 src/PIL/PdfImagePlugin.py      |  3 ++-
 src/PIL/SpiderImagePlugin.py   |  6 +++---
 src/PIL/TiffImagePlugin.py     |  4 ++--
 src/PIL/WmfImagePlugin.py      |  4 +++-
 13 files changed, 52 insertions(+), 35 deletions(-)

diff --git a/src/PIL/BmpImagePlugin.py b/src/PIL/BmpImagePlugin.py
index c5d1cd40d3b..2df1d8d33bd 100644
--- a/src/PIL/BmpImagePlugin.py
+++ b/src/PIL/BmpImagePlugin.py
@@ -25,6 +25,7 @@
 from __future__ import annotations
 
 import os
+from typing import IO
 
 from . import Image, ImageFile, ImagePalette
 from ._binary import i16le as i16
@@ -52,7 +53,7 @@ def _accept(prefix: bytes) -> bool:
     return prefix[:2] == b"BM"
 
 
-def _dib_accept(prefix):
+def _dib_accept(prefix: bytes) -> bool:
     return i32(prefix) in [12, 40, 52, 56, 64, 108, 124]
 
 
@@ -394,11 +395,13 @@ def _open(self) -> None:
 }
 
 
-def _dib_save(im, fp, filename):
+def _dib_save(im: Image.Image, fp: IO[bytes], filename: str) -> None:
     _save(im, fp, filename, False)
 
 
-def _save(im, fp, filename, bitmap_header=True):
+def _save(
+    im: Image.Image, fp: IO[bytes], filename: str, bitmap_header: bool = True
+) -> None:
     try:
         rawmode, bits, colors = SAVE[im.mode]
     except KeyError as e:
diff --git a/src/PIL/BufrStubImagePlugin.py b/src/PIL/BufrStubImagePlugin.py
index 826e89dafea..6f52204b829 100644
--- a/src/PIL/BufrStubImagePlugin.py
+++ b/src/PIL/BufrStubImagePlugin.py
@@ -10,6 +10,8 @@
 #
 from __future__ import annotations
 
+from typing import IO
+
 from . import Image, ImageFile
 
 _handler = None
@@ -58,7 +60,7 @@ def _load(self) -> ImageFile.StubHandler | None:
         return _handler
 
 
-def _save(im, fp, filename):
+def _save(im: Image.Image, fp: IO[bytes], filename: str) -> None:
     if _handler is None or not hasattr(_handler, "save"):
         msg = "BUFR save handler not installed"
         raise OSError(msg)
diff --git a/src/PIL/DdsImagePlugin.py b/src/PIL/DdsImagePlugin.py
index 1575f2d88b6..a3efadb030d 100644
--- a/src/PIL/DdsImagePlugin.py
+++ b/src/PIL/DdsImagePlugin.py
@@ -16,6 +16,7 @@
 import struct
 import sys
 from enum import IntEnum, IntFlag
+from typing import IO
 
 from . import Image, ImageFile, ImagePalette
 from ._binary import i32le as i32
@@ -510,7 +511,7 @@ def decode(self, buffer):
         return -1, 0
 
 
-def _save(im, fp, filename):
+def _save(im: Image.Image, fp: IO[bytes], filename: str) -> None:
     if im.mode not in ("RGB", "RGBA", "L", "LA"):
         msg = f"cannot write mode {im.mode} as DDS"
         raise OSError(msg)
diff --git a/src/PIL/GifImagePlugin.py b/src/PIL/GifImagePlugin.py
index 962a9283464..e62852db31d 100644
--- a/src/PIL/GifImagePlugin.py
+++ b/src/PIL/GifImagePlugin.py
@@ -31,6 +31,7 @@
 import subprocess
 from enum import IntEnum
 from functools import cached_property
+from typing import IO
 
 from . import (
     Image,
@@ -336,14 +337,13 @@ def _seek(self, frame, update_image=True):
                         self._mode = "RGB"
                         self.im = self.im.convert("RGB", Image.Dither.FLOYDSTEINBERG)
 
-        def _rgb(color):
+        def _rgb(color: int) -> tuple[int, int, int]:
             if self._frame_palette:
                 if color * 3 + 3 > len(self._frame_palette.palette):
                     color = 0
-                color = tuple(self._frame_palette.palette[color * 3 : color * 3 + 3])
+                return tuple(self._frame_palette.palette[color * 3 : color * 3 + 3])
             else:
-                color = (color, color, color)
-            return color
+                return (color, color, color)
 
         self.dispose_extent = frame_dispose_extent
         try:
@@ -709,11 +709,13 @@ def _write_multiple_frames(im, fp, palette):
     return True
 
 
-def _save_all(im, fp, filename):
+def _save_all(im: Image.Image, fp: IO[bytes], filename: str) -> None:
     _save(im, fp, filename, save_all=True)
 
 
-def _save(im, fp, filename, save_all=False):
+def _save(
+    im: Image.Image, fp: IO[bytes], filename: str, save_all: bool = False
+) -> None:
     # header
     if "palette" in im.encoderinfo or "palette" in im.info:
         palette = im.encoderinfo.get("palette", im.info.get("palette"))
@@ -730,7 +732,7 @@ def _save(im, fp, filename, save_all=False):
         fp.flush()
 
 
-def get_interlace(im):
+def get_interlace(im: Image.Image) -> int:
     interlace = im.encoderinfo.get("interlace", 1)
 
     # workaround for @PIL153
diff --git a/src/PIL/GribStubImagePlugin.py b/src/PIL/GribStubImagePlugin.py
index c27cffab63e..b24dcded2f9 100644
--- a/src/PIL/GribStubImagePlugin.py
+++ b/src/PIL/GribStubImagePlugin.py
@@ -10,6 +10,8 @@
 #
 from __future__ import annotations
 
+from typing import IO
+
 from . import Image, ImageFile
 
 _handler = None
@@ -58,7 +60,7 @@ def _load(self) -> ImageFile.StubHandler | None:
         return _handler
 
 
-def _save(im, fp, filename):
+def _save(im: Image.Image, fp: IO[bytes], filename: str) -> None:
     if _handler is None or not hasattr(_handler, "save"):
         msg = "GRIB save handler not installed"
         raise OSError(msg)
diff --git a/src/PIL/IcoImagePlugin.py b/src/PIL/IcoImagePlugin.py
index cea093f9c6c..af94e5a2e7f 100644
--- a/src/PIL/IcoImagePlugin.py
+++ b/src/PIL/IcoImagePlugin.py
@@ -25,6 +25,7 @@
 import warnings
 from io import BytesIO
 from math import ceil, log
+from typing import IO
 
 from . import BmpImagePlugin, Image, ImageFile, PngImagePlugin
 from ._binary import i16le as i16
@@ -39,7 +40,7 @@
 _MAGIC = b"\0\0\1\0"
 
 
-def _save(im, fp, filename):
+def _save(im: Image.Image, fp: IO[bytes], filename: str) -> None:
     fp.write(_MAGIC)  # (2+2)
     bmp = im.encoderinfo.get("bitmap_format") == "bmp"
     sizes = im.encoderinfo.get(
@@ -194,7 +195,7 @@ def getimage(self, size, bpp=False):
         """
         return self.frame(self.getentryindex(size, bpp))
 
-    def frame(self, idx):
+    def frame(self, idx: int) -> Image.Image:
         """
         Get an image from frame idx
         """
@@ -205,6 +206,7 @@ def frame(self, idx):
         data = self.buf.read(8)
         self.buf.seek(header["offset"])
 
+        im: Image.Image
         if data[:8] == PngImagePlugin._MAGIC:
             # png frame
             im = PngImagePlugin.PngImageFile(self.buf)
diff --git a/src/PIL/ImImagePlugin.py b/src/PIL/ImImagePlugin.py
index 8e949ebaf9d..c98cfb0984b 100644
--- a/src/PIL/ImImagePlugin.py
+++ b/src/PIL/ImImagePlugin.py
@@ -28,6 +28,7 @@
 
 import os
 import re
+from typing import IO, Any
 
 from . import Image, ImageFile, ImagePalette
 
@@ -103,7 +104,7 @@
 split = re.compile(rb"^([A-Za-z][^:]*):[ \t]*(.*)[ \t]*$")
 
 
-def number(s):
+def number(s: Any) -> float:
     try:
         return int(s)
     except ValueError:
@@ -325,7 +326,7 @@ def tell(self) -> int:
 }
 
 
-def _save(im, fp, filename):
+def _save(im: Image.Image, fp: IO[bytes], filename: str) -> None:
     try:
         image_type, rawmode = SAVE[im.mode]
     except KeyError as e:
diff --git a/src/PIL/Image.py b/src/PIL/Image.py
index 6385f204bf2..8cb4b7e3292 100644
--- a/src/PIL/Image.py
+++ b/src/PIL/Image.py
@@ -2875,7 +2875,7 @@ def transpose(self, method: Transpose) -> Image:
         self.load()
         return self._new(self.im.transpose(method))
 
-    def effect_spread(self, distance):
+    def effect_spread(self, distance: int) -> Image:
         """
         Randomly spread pixels in an image.
 
@@ -3012,7 +3012,7 @@ def new(
     return im._new(core.fill(mode, size, color))
 
 
-def frombytes(mode, size, data, decoder_name="raw", *args) -> Image:
+def frombytes(mode, size, data, decoder_name: str = "raw", *args) -> Image:
     """
     Creates a copy of an image memory from pixel data in a buffer.
 
@@ -3051,7 +3051,7 @@ def frombytes(mode, size, data, decoder_name="raw", *args) -> Image:
     return im
 
 
-def frombuffer(mode, size, data, decoder_name="raw", *args) -> Image:
+def frombuffer(mode: str, size, data, decoder_name: str = "raw", *args) -> Image:
     """
     Creates an image memory referencing pixel data in a byte buffer.
 
@@ -3553,7 +3553,7 @@ def register_save(id: str, driver) -> None:
     SAVE[id.upper()] = driver
 
 
-def register_save_all(id, driver) -> None:
+def register_save_all(id: str, driver) -> None:
     """
     Registers an image function to save all the frames
     of a multiframe format.  This function should not be
@@ -3565,7 +3565,7 @@ def register_save_all(id, driver) -> None:
     SAVE_ALL[id.upper()] = driver
 
 
-def register_extension(id, extension) -> None:
+def register_extension(id: str, extension: str) -> None:
     """
     Registers an image extension.  This function should not be
     used in application code.
@@ -3576,7 +3576,7 @@ def register_extension(id, extension) -> None:
     EXTENSION[extension.lower()] = id.upper()
 
 
-def register_extensions(id, extensions) -> None:
+def register_extensions(id: str, extensions: list[str]) -> None:
     """
     Registers image extensions.  This function should not be
     used in application code.
@@ -3588,7 +3588,7 @@ def register_extensions(id, extensions) -> None:
         register_extension(id, extension)
 
 
-def registered_extensions():
+def registered_extensions() -> dict[str, str]:
     """
     Returns a dictionary containing all file extensions belonging
     to registered plugins
@@ -3650,7 +3650,7 @@ def effect_mandelbrot(size, extent, quality):
     return Image()._new(core.effect_mandelbrot(size, extent, quality))
 
 
-def effect_noise(size, sigma):
+def effect_noise(size: tuple[int, int], sigma: float) -> Image:
     """
     Generate Gaussian noise centered around 128.
 
@@ -3661,7 +3661,7 @@ def effect_noise(size, sigma):
     return Image()._new(core.effect_noise(size, sigma))
 
 
-def linear_gradient(mode):
+def linear_gradient(mode: str) -> Image:
     """
     Generate 256x256 linear gradient from black to white, top to bottom.
 
@@ -3670,7 +3670,7 @@ def linear_gradient(mode):
     return Image()._new(core.linear_gradient(mode))
 
 
-def radial_gradient(mode):
+def radial_gradient(mode: str) -> Image:
     """
     Generate 256x256 radial gradient from black to white, centre to edge.
 
diff --git a/src/PIL/MpoImagePlugin.py b/src/PIL/MpoImagePlugin.py
index 766e1290ced..6716722f204 100644
--- a/src/PIL/MpoImagePlugin.py
+++ b/src/PIL/MpoImagePlugin.py
@@ -22,6 +22,7 @@
 import itertools
 import os
 import struct
+from typing import IO
 
 from . import (
     Image,
@@ -32,7 +33,7 @@
 from ._binary import o32le
 
 
-def _save(im, fp, filename):
+def _save(im: Image.Image, fp: IO[bytes], filename: str) -> None:
     JpegImagePlugin._save(im, fp, filename)
 
 
diff --git a/src/PIL/PdfImagePlugin.py b/src/PIL/PdfImagePlugin.py
index 1777f1f20db..ccd28f3434b 100644
--- a/src/PIL/PdfImagePlugin.py
+++ b/src/PIL/PdfImagePlugin.py
@@ -25,6 +25,7 @@
 import math
 import os
 import time
+from typing import IO
 
 from . import Image, ImageFile, ImageSequence, PdfParser, __version__, features
 
@@ -39,7 +40,7 @@
 #  5. page contents
 
 
-def _save_all(im, fp, filename):
+def _save_all(im: Image.Image, fp: IO[bytes], filename: str) -> None:
     _save(im, fp, filename, save_all=True)
 
 
diff --git a/src/PIL/SpiderImagePlugin.py b/src/PIL/SpiderImagePlugin.py
index e5242395f92..98dd91c0e24 100644
--- a/src/PIL/SpiderImagePlugin.py
+++ b/src/PIL/SpiderImagePlugin.py
@@ -37,7 +37,7 @@
 import os
 import struct
 import sys
-from typing import TYPE_CHECKING
+from typing import IO, TYPE_CHECKING
 
 from . import Image, ImageFile
 
@@ -263,7 +263,7 @@ def makeSpiderHeader(im: Image.Image) -> list[bytes]:
     return [struct.pack("f", v) for v in hdr]
 
 
-def _save(im, fp, filename):
+def _save(im: Image.Image, fp: IO[bytes], filename: str) -> None:
     if im.mode[0] != "F":
         im = im.convert("F")
 
@@ -279,7 +279,7 @@ def _save(im, fp, filename):
     ImageFile._save(im, fp, [("raw", (0, 0) + im.size, 0, (rawmode, 0, 1))])
 
 
-def _save_spider(im, fp, filename):
+def _save_spider(im: Image.Image, fp: IO[bytes], filename: str) -> None:
     # get the filename extension and register it with Image
     ext = os.path.splitext(filename)[1]
     Image.register_extension(SpiderImageFile.format, ext)
diff --git a/src/PIL/TiffImagePlugin.py b/src/PIL/TiffImagePlugin.py
index f3fa3c24ccd..04f36744bed 100644
--- a/src/PIL/TiffImagePlugin.py
+++ b/src/PIL/TiffImagePlugin.py
@@ -1995,7 +1995,7 @@ def newFrame(self) -> None:
         self.finalize()
         self.setup()
 
-    def __enter__(self):
+    def __enter__(self) -> AppendingTiffWriter:
         return self
 
     def __exit__(self, exc_type, exc_value, traceback):
@@ -2023,7 +2023,7 @@ def goToEnd(self) -> None:
             self.f.write(bytes(pad_bytes))
         self.offsetOfNewPage = self.f.tell()
 
-    def setEndian(self, endian):
+    def setEndian(self, endian: str) -> None:
         self.endian = endian
         self.longFmt = f"{self.endian}L"
         self.shortFmt = f"{self.endian}H"
diff --git a/src/PIL/WmfImagePlugin.py b/src/PIL/WmfImagePlugin.py
index fab3e26c587..25a4545db52 100644
--- a/src/PIL/WmfImagePlugin.py
+++ b/src/PIL/WmfImagePlugin.py
@@ -20,6 +20,8 @@
 # http://wvware.sourceforge.net/caolan/ora-wmf.html
 from __future__ import annotations
 
+from typing import IO
+
 from . import Image, ImageFile
 from ._binary import i16le as word
 from ._binary import si16le as short
@@ -161,7 +163,7 @@ def load(self, dpi=None):
         return super().load()
 
 
-def _save(im, fp, filename):
+def _save(im: Image.Image, fp: IO[bytes], filename: str) -> None:
     if _handler is None or not hasattr(_handler, "save"):
         msg = "WMF save handler not installed"
         raise OSError(msg)

From 923d4e5e1a971ea64ce56c5b016a620be33d51eb Mon Sep 17 00:00:00 2001
From: Andrew Murray <radarhere@users.noreply.github.com>
Date: Wed, 5 Jun 2024 22:27:23 +1000
Subject: [PATCH 0674/1178] Added type hints

---
 Tests/bench_cffi_access.py          |  1 +
 Tests/test_features.py              |  2 +-
 Tests/test_file_bmp.py              |  2 +-
 Tests/test_file_bufrstub.py         | 11 ++++++-----
 Tests/test_file_gribstub.py         |  4 ++--
 Tests/test_file_hdf5stub.py         |  7 ++++---
 Tests/test_file_jpeg.py             |  2 +-
 Tests/test_file_webp.py             |  4 +++-
 Tests/test_file_webp_animated.py    |  2 +-
 Tests/test_file_wmf.py              | 12 ++++++++----
 Tests/test_image_access.py          |  6 ++++++
 Tests/test_image_rotate.py          |  4 ++--
 Tests/test_image_thumbnail.py       |  4 +++-
 Tests/test_imageops_usm.py          |  1 -
 Tests/test_qt_image_qapplication.py |  2 +-
 src/PIL/BufrStubImagePlugin.py      |  2 +-
 src/PIL/GribStubImagePlugin.py      |  2 +-
 src/PIL/Hdf5StubImagePlugin.py      |  2 +-
 src/PIL/WmfImagePlugin.py           |  2 +-
 19 files changed, 44 insertions(+), 28 deletions(-)

diff --git a/Tests/bench_cffi_access.py b/Tests/bench_cffi_access.py
index d2a08c07bc4..c7d105836aa 100644
--- a/Tests/bench_cffi_access.py
+++ b/Tests/bench_cffi_access.py
@@ -44,6 +44,7 @@ def test_direct() -> None:
     caccess = im.im.pixel_access(False)
     access = PyAccess.new(im, False)
 
+    assert access is not None
     assert caccess[(0, 0)] == access[(0, 0)]
 
     print(f"Size: {im.width}x{im.height}")
diff --git a/Tests/test_features.py b/Tests/test_features.py
index 59fb4980923..de418115ee0 100644
--- a/Tests/test_features.py
+++ b/Tests/test_features.py
@@ -124,7 +124,7 @@ def test_unsupported_module() -> None:
 
 
 @pytest.mark.parametrize("supported_formats", (True, False))
-def test_pilinfo(supported_formats) -> None:
+def test_pilinfo(supported_formats: bool) -> None:
     buf = io.StringIO()
     features.pilinfo(buf, supported_formats=supported_formats)
     out = buf.getvalue()
diff --git a/Tests/test_file_bmp.py b/Tests/test_file_bmp.py
index c7c9b24e763..2ff4160bd71 100644
--- a/Tests/test_file_bmp.py
+++ b/Tests/test_file_bmp.py
@@ -140,7 +140,7 @@ def test_load_dib() -> None:
         (124, "g/pal8v5.bmp"),
     ),
 )
-def test_dib_header_size(header_size, path):
+def test_dib_header_size(header_size: int, path: str) -> None:
     image_path = "Tests/images/bmp/" + path
     with open(image_path, "rb") as fp:
         data = fp.read()[14:]
diff --git a/Tests/test_file_bufrstub.py b/Tests/test_file_bufrstub.py
index 3dd24533aae..939e82e7717 100644
--- a/Tests/test_file_bufrstub.py
+++ b/Tests/test_file_bufrstub.py
@@ -1,10 +1,11 @@
 from __future__ import annotations
 
 from pathlib import Path
+from typing import IO
 
 import pytest
 
-from PIL import BufrStubImagePlugin, Image
+from PIL import BufrStubImagePlugin, Image, ImageFile
 
 from .helper import hopper
 
@@ -50,20 +51,20 @@ def test_save(tmp_path: Path) -> None:
 
 
 def test_handler(tmp_path: Path) -> None:
-    class TestHandler:
+    class TestHandler(ImageFile.StubHandler):
         opened = False
         loaded = False
         saved = False
 
-        def open(self, im) -> None:
+        def open(self, im: ImageFile.StubImageFile) -> None:
             self.opened = True
 
-        def load(self, im):
+        def load(self, im: ImageFile.StubImageFile) -> Image.Image:
             self.loaded = True
             im.fp.close()
             return Image.new("RGB", (1, 1))
 
-        def save(self, im, fp, filename) -> None:
+        def save(self, im: Image.Image, fp: IO[bytes], filename: str) -> None:
             self.saved = True
 
     handler = TestHandler()
diff --git a/Tests/test_file_gribstub.py b/Tests/test_file_gribstub.py
index 096a5b88b21..86a9064fc46 100644
--- a/Tests/test_file_gribstub.py
+++ b/Tests/test_file_gribstub.py
@@ -5,7 +5,7 @@
 
 import pytest
 
-from PIL import GribStubImagePlugin, Image
+from PIL import GribStubImagePlugin, Image, ImageFile
 
 from .helper import hopper
 
@@ -51,7 +51,7 @@ def test_save(tmp_path: Path) -> None:
 
 
 def test_handler(tmp_path: Path) -> None:
-    class TestHandler:
+    class TestHandler(ImageFile.StubHandler):
         opened = False
         loaded = False
         saved = False
diff --git a/Tests/test_file_hdf5stub.py b/Tests/test_file_hdf5stub.py
index f871e2eff16..ee1544c51fa 100644
--- a/Tests/test_file_hdf5stub.py
+++ b/Tests/test_file_hdf5stub.py
@@ -1,11 +1,12 @@
 from __future__ import annotations
 
+from io import BytesIO
 from pathlib import Path
 from typing import IO
 
 import pytest
 
-from PIL import Hdf5StubImagePlugin, Image
+from PIL import Hdf5StubImagePlugin, Image, ImageFile
 
 TEST_FILE = "Tests/images/hdf5.h5"
 
@@ -41,7 +42,7 @@ def test_load() -> None:
 def test_save() -> None:
     # Arrange
     with Image.open(TEST_FILE) as im:
-        dummy_fp = None
+        dummy_fp = BytesIO()
         dummy_filename = "dummy.filename"
 
         # Act / Assert: stub cannot save without an implemented handler
@@ -52,7 +53,7 @@ def test_save() -> None:
 
 
 def test_handler(tmp_path: Path) -> None:
-    class TestHandler:
+    class TestHandler(ImageFile.StubHandler):
         opened = False
         loaded = False
         saved = False
diff --git a/Tests/test_file_jpeg.py b/Tests/test_file_jpeg.py
index 33f9ce00edc..18dc752d8bd 100644
--- a/Tests/test_file_jpeg.py
+++ b/Tests/test_file_jpeg.py
@@ -171,7 +171,7 @@ def getchannels(im: JpegImagePlugin.JpegImageFile) -> tuple[int, int, int]:
         [TEST_FILE, "Tests/images/pil_sample_cmyk.jpg"],
     )
     def test_dpi(self, test_image_path: str) -> None:
-        def test(xdpi: int, ydpi: int | None = None):
+        def test(xdpi: int, ydpi: int | None = None) -> tuple[int, int] | None:
             with Image.open(test_image_path) as im:
                 im = self.roundtrip(im, dpi=(xdpi, ydpi or xdpi))
             return im.info.get("dpi")
diff --git a/Tests/test_file_webp.py b/Tests/test_file_webp.py
index e2de84c71a1..1caf032f6e1 100644
--- a/Tests/test_file_webp.py
+++ b/Tests/test_file_webp.py
@@ -198,7 +198,9 @@ def test_file_pointer_could_be_reused(self) -> None:
         (0, (0,), (-1, 0, 1, 2), (253, 254, 255, 256)),
     )
     @skip_unless_feature("webp_anim")
-    def test_invalid_background(self, background, tmp_path: Path) -> None:
+    def test_invalid_background(
+        self, background: int | tuple[int, ...], tmp_path: Path
+    ) -> None:
         temp_file = str(tmp_path / "temp.webp")
         im = hopper()
         with pytest.raises(OSError):
diff --git a/Tests/test_file_webp_animated.py b/Tests/test_file_webp_animated.py
index ba931f8643c..882dccb32f9 100644
--- a/Tests/test_file_webp_animated.py
+++ b/Tests/test_file_webp_animated.py
@@ -69,7 +69,7 @@ def test_write_animation_RGB(tmp_path: Path) -> None:
     are visually similar to the originals.
     """
 
-    def check(temp_file) -> None:
+    def check(temp_file: str) -> None:
         with Image.open(temp_file) as im:
             assert im.n_frames == 2
 
diff --git a/Tests/test_file_wmf.py b/Tests/test_file_wmf.py
index b43e3f2965f..79e707263d6 100644
--- a/Tests/test_file_wmf.py
+++ b/Tests/test_file_wmf.py
@@ -1,10 +1,11 @@
 from __future__ import annotations
 
 from pathlib import Path
+from typing import IO
 
 import pytest
 
-from PIL import Image, WmfImagePlugin
+from PIL import Image, ImageFile, WmfImagePlugin
 
 from .helper import assert_image_similar_tofile, hopper
 
@@ -34,10 +35,13 @@ def test_load() -> None:
 
 
 def test_register_handler(tmp_path: Path) -> None:
-    class TestHandler:
+    class TestHandler(ImageFile.StubHandler):
         methodCalled = False
 
-        def save(self, im, fp, filename) -> None:
+        def load(self, im: ImageFile.StubImageFile) -> Image.Image:
+            return Image.new("RGB", (1, 1))
+
+        def save(self, im: Image.Image, fp: IO[bytes], filename: str) -> None:
             self.methodCalled = True
 
     handler = TestHandler()
@@ -70,7 +74,7 @@ def test_load_set_dpi() -> None:
 
 
 @pytest.mark.parametrize("ext", (".wmf", ".emf"))
-def test_save(ext, tmp_path: Path) -> None:
+def test_save(ext: str, tmp_path: Path) -> None:
     im = hopper()
 
     tmpfile = str(tmp_path / ("temp" + ext))
diff --git a/Tests/test_image_access.py b/Tests/test_image_access.py
index 9d600667937..8abb1f69fc1 100644
--- a/Tests/test_image_access.py
+++ b/Tests/test_image_access.py
@@ -259,6 +259,7 @@ def _test_get_access(self, im: Image.Image) -> None:
         caccess = im.im.pixel_access(False)
         with pytest.warns(DeprecationWarning):
             access = PyAccess.new(im, False)
+        assert access is not None
 
         w, h = im.size
         for x in range(0, w, 10):
@@ -289,6 +290,7 @@ def _test_set_access(self, im: Image.Image, color: tuple[int, ...] | float) -> N
         caccess = im.im.pixel_access(False)
         with pytest.warns(DeprecationWarning):
             access = PyAccess.new(im, False)
+        assert access is not None
 
         w, h = im.size
         for x in range(0, w, 10):
@@ -299,6 +301,8 @@ def _test_set_access(self, im: Image.Image, color: tuple[int, ...] | float) -> N
         # Attempt to set the value on a read-only image
         with pytest.warns(DeprecationWarning):
             access = PyAccess.new(im, True)
+        assert access is not None
+
         with pytest.raises(ValueError):
             access[(0, 0)] = color
 
@@ -341,6 +345,8 @@ def test_p_putpixel_rgb_rgba(self, mode: str) -> None:
             im = Image.new(mode, (1, 1))
             with pytest.warns(DeprecationWarning):
                 access = PyAccess.new(im, False)
+                assert access is not None
+
                 access.putpixel((0, 0), color)
 
                 if len(color) == 3:
diff --git a/Tests/test_image_rotate.py b/Tests/test_image_rotate.py
index c10c96da6f9..252a15db742 100644
--- a/Tests/test_image_rotate.py
+++ b/Tests/test_image_rotate.py
@@ -124,8 +124,8 @@ def test_fastpath_translate() -> None:
 def test_center() -> None:
     im = hopper()
     rotate(im, im.mode, 45, center=(0, 0))
-    rotate(im, im.mode, 45, translate=(im.size[0] / 2, 0))
-    rotate(im, im.mode, 45, center=(0, 0), translate=(im.size[0] / 2, 0))
+    rotate(im, im.mode, 45, translate=(im.size[0] // 2, 0))
+    rotate(im, im.mode, 45, center=(0, 0), translate=(im.size[0] // 2, 0))
 
 
 def test_rotate_no_fill() -> None:
diff --git a/Tests/test_image_thumbnail.py b/Tests/test_image_thumbnail.py
index 2ca1d2cfc03..1593eaaf7fa 100644
--- a/Tests/test_image_thumbnail.py
+++ b/Tests/test_image_thumbnail.py
@@ -111,7 +111,9 @@ def test_load_first_unless_jpeg() -> None:
     with Image.open("Tests/images/hopper.jpg") as im:
         draft = im.draft
 
-        def im_draft(mode: str, size: tuple[int, int]):
+        def im_draft(
+            mode: str, size: tuple[int, int]
+        ) -> tuple[str, tuple[int, int, float, float]] | None:
             result = draft(mode, size)
             assert result is not None
 
diff --git a/Tests/test_imageops_usm.py b/Tests/test_imageops_usm.py
index 104c620de01..dbdd5b317d5 100644
--- a/Tests/test_imageops_usm.py
+++ b/Tests/test_imageops_usm.py
@@ -58,7 +58,6 @@ def test_blur_formats(test_images: dict[str, ImageFile.ImageFile]) -> None:
     blur = ImageFilter.GaussianBlur
     with pytest.raises(ValueError):
         im.convert("1").filter(blur)
-    blur(im.convert("L"))
     with pytest.raises(ValueError):
         im.convert("I").filter(blur)
     with pytest.raises(ValueError):
diff --git a/Tests/test_qt_image_qapplication.py b/Tests/test_qt_image_qapplication.py
index 3cd323553fa..28f66891c0d 100644
--- a/Tests/test_qt_image_qapplication.py
+++ b/Tests/test_qt_image_qapplication.py
@@ -46,7 +46,7 @@ def roundtrip(expected: Image.Image) -> None:
 @pytest.mark.skipif(not ImageQt.qt_is_installed, reason="Qt bindings are not installed")
 def test_sanity(tmp_path: Path) -> None:
     # Segfault test
-    app = QApplication([])
+    app: QApplication | None = QApplication([])
     ex = Example()
     assert app  # Silence warning
     assert ex  # Silence warning
diff --git a/src/PIL/BufrStubImagePlugin.py b/src/PIL/BufrStubImagePlugin.py
index 6f52204b829..7388a2b8a3a 100644
--- a/src/PIL/BufrStubImagePlugin.py
+++ b/src/PIL/BufrStubImagePlugin.py
@@ -17,7 +17,7 @@
 _handler = None
 
 
-def register_handler(handler: ImageFile.StubHandler) -> None:
+def register_handler(handler: ImageFile.StubHandler | None) -> None:
     """
     Install application-specific BUFR image handler.
 
diff --git a/src/PIL/GribStubImagePlugin.py b/src/PIL/GribStubImagePlugin.py
index b24dcded2f9..d3655f4ddc0 100644
--- a/src/PIL/GribStubImagePlugin.py
+++ b/src/PIL/GribStubImagePlugin.py
@@ -17,7 +17,7 @@
 _handler = None
 
 
-def register_handler(handler: ImageFile.StubHandler) -> None:
+def register_handler(handler: ImageFile.StubHandler | None) -> None:
     """
     Install application-specific GRIB image handler.
 
diff --git a/src/PIL/Hdf5StubImagePlugin.py b/src/PIL/Hdf5StubImagePlugin.py
index c8d7866a312..b789c215fee 100644
--- a/src/PIL/Hdf5StubImagePlugin.py
+++ b/src/PIL/Hdf5StubImagePlugin.py
@@ -17,7 +17,7 @@
 _handler = None
 
 
-def register_handler(handler: ImageFile.StubHandler) -> None:
+def register_handler(handler: ImageFile.StubHandler | None) -> None:
     """
     Install application-specific HDF5 image handler.
 
diff --git a/src/PIL/WmfImagePlugin.py b/src/PIL/WmfImagePlugin.py
index 25a4545db52..a68f705a03c 100644
--- a/src/PIL/WmfImagePlugin.py
+++ b/src/PIL/WmfImagePlugin.py
@@ -30,7 +30,7 @@
 _handler = None
 
 
-def register_handler(handler: ImageFile.StubHandler) -> None:
+def register_handler(handler: ImageFile.StubHandler | None) -> None:
     """
     Install application-specific WMF image handler.
 

From 148f0d345f92261e12d28ebbbd3b92d027d667ca Mon Sep 17 00:00:00 2001
From: Hugo van Kemenade <1324225+hugovk@users.noreply.github.com>
Date: Thu, 6 Jun 2024 09:38:38 +0300
Subject: [PATCH 0675/1178] Use Sphinx long options in Makefile

---
 docs/Makefile | 44 ++++++++++++++++++++++----------------------
 1 file changed, 22 insertions(+), 22 deletions(-)

diff --git a/docs/Makefile b/docs/Makefile
index 6495e5866ff..8f13f1aea1c 100644
--- a/docs/Makefile
+++ b/docs/Makefile
@@ -9,9 +9,9 @@ PAPER         =
 BUILDDIR      = _build
 
 # Internal variables.
-PAPEROPT_a4     = -D latex_paper_size=a4
-PAPEROPT_letter = -D latex_paper_size=letter
-ALLSPHINXOPTS   = -d $(BUILDDIR)/doctrees $(PAPEROPT_$(PAPER)) $(SPHINXOPTS) .
+PAPEROPT_a4     = --define latex_paper_size=a4
+PAPEROPT_letter = --define latex_paper_size=letter
+ALLSPHINXOPTS   = --doctree-dir $(BUILDDIR)/doctrees $(PAPEROPT_$(PAPER)) $(SPHINXOPTS) .
 # the i18n builder cannot share the environment and doctrees with the others
 I18NSPHINXOPTS  = $(PAPEROPT_$(PAPER)) $(SPHINXOPTS) .
 
@@ -51,42 +51,42 @@ install-sphinx:
 .PHONY: html
 html:
 	$(MAKE) install-sphinx
-	$(SPHINXBUILD) -b html -W --keep-going $(ALLSPHINXOPTS) $(BUILDDIR)/html
+	$(SPHINXBUILD) --builder html --fail-on-warning --keep-going $(ALLSPHINXOPTS) $(BUILDDIR)/html
 	@echo
 	@echo "Build finished. The HTML pages are in $(BUILDDIR)/html."
 
 .PHONY: dirhtml
 dirhtml:
 	$(MAKE) install-sphinx
-	$(SPHINXBUILD) -b dirhtml $(ALLSPHINXOPTS) $(BUILDDIR)/dirhtml
+	$(SPHINXBUILD) --builder dirhtml $(ALLSPHINXOPTS) $(BUILDDIR)/dirhtml
 	@echo
 	@echo "Build finished. The HTML pages are in $(BUILDDIR)/dirhtml."
 
 .PHONY: singlehtml
 singlehtml:
 	$(MAKE) install-sphinx
-	$(SPHINXBUILD) -b singlehtml $(ALLSPHINXOPTS) $(BUILDDIR)/singlehtml
+	$(SPHINXBUILD) --builder singlehtml $(ALLSPHINXOPTS) $(BUILDDIR)/singlehtml
 	@echo
 	@echo "Build finished. The HTML page is in $(BUILDDIR)/singlehtml."
 
 .PHONY: pickle
 pickle:
 	$(MAKE) install-sphinx
-	$(SPHINXBUILD) -b pickle $(ALLSPHINXOPTS) $(BUILDDIR)/pickle
+	$(SPHINXBUILD) --builder pickle $(ALLSPHINXOPTS) $(BUILDDIR)/pickle
 	@echo
 	@echo "Build finished; now you can process the pickle files."
 
 .PHONY: json
 json:
 	$(MAKE) install-sphinx
-	$(SPHINXBUILD) -b json $(ALLSPHINXOPTS) $(BUILDDIR)/json
+	$(SPHINXBUILD) --builder json $(ALLSPHINXOPTS) $(BUILDDIR)/json
 	@echo
 	@echo "Build finished; now you can process the JSON files."
 
 .PHONY: htmlhelp
 htmlhelp:
 	$(MAKE) install-sphinx
-	$(SPHINXBUILD) -b htmlhelp $(ALLSPHINXOPTS) $(BUILDDIR)/htmlhelp
+	$(SPHINXBUILD) --builder htmlhelp $(ALLSPHINXOPTS) $(BUILDDIR)/htmlhelp
 	@echo
 	@echo "Build finished; now you can run HTML Help Workshop with the" \
 	      ".hhp project file in $(BUILDDIR)/htmlhelp."
@@ -94,7 +94,7 @@ htmlhelp:
 .PHONY: qthelp
 qthelp:
 	$(MAKE) install-sphinx
-	$(SPHINXBUILD) -b qthelp $(ALLSPHINXOPTS) $(BUILDDIR)/qthelp
+	$(SPHINXBUILD) --builder qthelp $(ALLSPHINXOPTS) $(BUILDDIR)/qthelp
 	@echo
 	@echo "Build finished; now you can run "qcollectiongenerator" with the" \
 	      ".qhcp project file in $(BUILDDIR)/qthelp, like this:"
@@ -105,7 +105,7 @@ qthelp:
 .PHONY: devhelp
 devhelp:
 	$(MAKE) install-sphinx
-	$(SPHINXBUILD) -b devhelp $(ALLSPHINXOPTS) $(BUILDDIR)/devhelp
+	$(SPHINXBUILD) --builder devhelp $(ALLSPHINXOPTS) $(BUILDDIR)/devhelp
 	@echo
 	@echo "Build finished."
 	@echo "To view the help file:"
@@ -116,14 +116,14 @@ devhelp:
 .PHONY: epub
 epub:
 	$(MAKE) install-sphinx
-	$(SPHINXBUILD) -b epub $(ALLSPHINXOPTS) $(BUILDDIR)/epub
+	$(SPHINXBUILD) --builder epub $(ALLSPHINXOPTS) $(BUILDDIR)/epub
 	@echo
 	@echo "Build finished. The epub file is in $(BUILDDIR)/epub."
 
 .PHONY: latex
 latex:
 	$(MAKE) install-sphinx
-	$(SPHINXBUILD) -b latex $(ALLSPHINXOPTS) $(BUILDDIR)/latex
+	$(SPHINXBUILD) --builder latex $(ALLSPHINXOPTS) $(BUILDDIR)/latex
 	@echo
 	@echo "Build finished; the LaTeX files are in $(BUILDDIR)/latex."
 	@echo "Run \`make' in that directory to run these through (pdf)latex" \
@@ -132,7 +132,7 @@ latex:
 .PHONY: latexpdf
 latexpdf:
 	$(MAKE) install-sphinx
-	$(SPHINXBUILD) -b latex $(ALLSPHINXOPTS) $(BUILDDIR)/latex
+	$(SPHINXBUILD) --builder latex $(ALLSPHINXOPTS) $(BUILDDIR)/latex
 	@echo "Running LaTeX files through pdflatex..."
 	$(MAKE) -C $(BUILDDIR)/latex all-pdf
 	@echo "pdflatex finished; the PDF files are in $(BUILDDIR)/latex."
@@ -140,21 +140,21 @@ latexpdf:
 .PHONY: text
 text:
 	$(MAKE) install-sphinx
-	$(SPHINXBUILD) -b text $(ALLSPHINXOPTS) $(BUILDDIR)/text
+	$(SPHINXBUILD) --builder text $(ALLSPHINXOPTS) $(BUILDDIR)/text
 	@echo
 	@echo "Build finished. The text files are in $(BUILDDIR)/text."
 
 .PHONY: man
 man:
 	$(MAKE) install-sphinx
-	$(SPHINXBUILD) -b man $(ALLSPHINXOPTS) $(BUILDDIR)/man
+	$(SPHINXBUILD) --builder man $(ALLSPHINXOPTS) $(BUILDDIR)/man
 	@echo
 	@echo "Build finished. The manual pages are in $(BUILDDIR)/man."
 
 .PHONY: texinfo
 texinfo:
 	$(MAKE) install-sphinx
-	$(SPHINXBUILD) -b texinfo $(ALLSPHINXOPTS) $(BUILDDIR)/texinfo
+	$(SPHINXBUILD) --builder texinfo $(ALLSPHINXOPTS) $(BUILDDIR)/texinfo
 	@echo
 	@echo "Build finished. The Texinfo files are in $(BUILDDIR)/texinfo."
 	@echo "Run \`make' in that directory to run these through makeinfo" \
@@ -163,7 +163,7 @@ texinfo:
 .PHONY: info
 info:
 	$(MAKE) install-sphinx
-	$(SPHINXBUILD) -b texinfo $(ALLSPHINXOPTS) $(BUILDDIR)/texinfo
+	$(SPHINXBUILD) --builder texinfo $(ALLSPHINXOPTS) $(BUILDDIR)/texinfo
 	@echo "Running Texinfo files through makeinfo..."
 	make -C $(BUILDDIR)/texinfo info
 	@echo "makeinfo finished; the Info files are in $(BUILDDIR)/texinfo."
@@ -171,21 +171,21 @@ info:
 .PHONY: gettext
 gettext:
 	$(MAKE) install-sphinx
-	$(SPHINXBUILD) -b gettext $(I18NSPHINXOPTS) $(BUILDDIR)/locale
+	$(SPHINXBUILD) --builder gettext $(I18NSPHINXOPTS) $(BUILDDIR)/locale
 	@echo
 	@echo "Build finished. The message catalogs are in $(BUILDDIR)/locale."
 
 .PHONY: changes
 changes:
 	$(MAKE) install-sphinx
-	$(SPHINXBUILD) -b changes $(ALLSPHINXOPTS) $(BUILDDIR)/changes
+	$(SPHINXBUILD) --builder changes $(ALLSPHINXOPTS) $(BUILDDIR)/changes
 	@echo
 	@echo "The overview file is in $(BUILDDIR)/changes."
 
 .PHONY: linkcheck
 linkcheck:
 	$(MAKE) install-sphinx
-	$(SPHINXBUILD) -b linkcheck $(ALLSPHINXOPTS) $(BUILDDIR)/linkcheck -j auto
+	$(SPHINXBUILD) --builder linkcheck $(ALLSPHINXOPTS) $(BUILDDIR)/linkcheck -j auto
 	@echo
 	@echo "Link check complete; look for any errors in the above output " \
 	      "or in $(BUILDDIR)/linkcheck/output.txt."
@@ -193,7 +193,7 @@ linkcheck:
 .PHONY: doctest
 doctest:
 	$(MAKE) install-sphinx
-	$(SPHINXBUILD) -b doctest $(ALLSPHINXOPTS) $(BUILDDIR)/doctest
+	$(SPHINXBUILD) --builder doctest $(ALLSPHINXOPTS) $(BUILDDIR)/doctest
 	@echo "Testing of doctests in the sources finished, look at the " \
 	      "results in $(BUILDDIR)/doctest/output.txt."
 

From ac7967cfc0d554a494739891f468d8d3dd10595c Mon Sep 17 00:00:00 2001
From: Andrew Murray <radarhere@users.noreply.github.com>
Date: Fri, 7 Jun 2024 13:25:56 +1000
Subject: [PATCH 0676/1178] Do not preserve EXIFIFD tag by default

---
 Tests/test_file_libtiff.py | 13 +++++++++----
 src/PIL/TiffImagePlugin.py | 12 ++++++++----
 2 files changed, 17 insertions(+), 8 deletions(-)

diff --git a/Tests/test_file_libtiff.py b/Tests/test_file_libtiff.py
index 22bcd285622..20c0bae9218 100644
--- a/Tests/test_file_libtiff.py
+++ b/Tests/test_file_libtiff.py
@@ -685,13 +685,18 @@ def test_save_ycbcr(self, tmp_path: Path) -> None:
             assert reloaded.tag_v2[530] == (1, 1)
             assert reloaded.tag_v2[532] == (0, 255, 128, 255, 128, 255)
 
-    def test_exif_ifd(self, tmp_path: Path) -> None:
-        outfile = str(tmp_path / "temp.tif")
+    def test_exif_ifd(self) -> None:
+        out = io.BytesIO()
         with Image.open("Tests/images/tiff_adobe_deflate.tif") as im:
             assert im.tag_v2[34665] == 125456
-            im.save(outfile)
+            im.save(out, "TIFF")
 
-        with Image.open(outfile) as reloaded:
+            with Image.open(out) as reloaded:
+                assert 34665 not in reloaded.tag_v2
+
+            im.save(out, "TIFF", tiffinfo={34665: 125456})
+
+        with Image.open(out) as reloaded:
             if Image.core.libtiff_support_custom_tags:
                 assert reloaded.tag_v2[34665] == 125456
 
diff --git a/src/PIL/TiffImagePlugin.py b/src/PIL/TiffImagePlugin.py
index 04f36744bed..ab5934816ba 100644
--- a/src/PIL/TiffImagePlugin.py
+++ b/src/PIL/TiffImagePlugin.py
@@ -1816,11 +1816,15 @@ def _save(im, fp, filename):
         if hasattr(im, "tag"):
             legacy_ifd = im.tag.to_v2()
 
-        # SAMPLEFORMAT is determined by the image format and should not be copied
-        # from legacy_ifd.
         supplied_tags = {**getattr(im, "tag_v2", {}), **legacy_ifd}
-        if SAMPLEFORMAT in supplied_tags:
-            del supplied_tags[SAMPLEFORMAT]
+        for tag in (
+            # IFD offset that may not be correct in the saved image
+            EXIFIFD,
+            # Determined by the image format and should not be copied from legacy_ifd.
+            SAMPLEFORMAT,
+        ):
+            if tag in supplied_tags:
+                del supplied_tags[tag]
 
         for tag, value in itertools.chain(ifd.items(), supplied_tags.items()):
             # Libtiff can only process certain core items without adding

From 44805bcd1d34446af734052f91428844a604540b Mon Sep 17 00:00:00 2001
From: Andrew Murray <radarhere@users.noreply.github.com>
Date: Fri, 7 Jun 2024 16:49:03 +1000
Subject: [PATCH 0677/1178] Updated fribidi to 1.0.15

---
 winbuild/build_prepare.py | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/winbuild/build_prepare.py b/winbuild/build_prepare.py
index 0d6da77549f..7ec1eaa82b0 100644
--- a/winbuild/build_prepare.py
+++ b/winbuild/build_prepare.py
@@ -112,7 +112,7 @@ def cmd_msbuild(
 V = {
     "BROTLI": "1.1.0",
     "FREETYPE": "2.13.2",
-    "FRIBIDI": "1.0.13",
+    "FRIBIDI": "1.0.15",
     "HARFBUZZ": "8.4.0",
     "JPEGTURBO": "3.0.2",
     "LCMS2": "2.16",

From 08b5a2e9a7d290f4cd2cfb35dd556d50145a7dea Mon Sep 17 00:00:00 2001
From: Andrew Murray <radarhere@users.noreply.github.com>
Date: Sat, 8 Jun 2024 14:35:10 +1000
Subject: [PATCH 0678/1178] Corrected using a 1 mode mask with I;16* images

---
 Tests/images/imagedraw_polygon_width_I.tiff | Bin 0 -> 20122 bytes
 Tests/test_imagedraw.py                     |  13 ++++++++++
 src/libImaging/Paste.c                      |  26 +++++++++++++++++---
 3 files changed, 35 insertions(+), 4 deletions(-)
 create mode 100644 Tests/images/imagedraw_polygon_width_I.tiff

diff --git a/Tests/images/imagedraw_polygon_width_I.tiff b/Tests/images/imagedraw_polygon_width_I.tiff
new file mode 100644
index 0000000000000000000000000000000000000000..ce1917d61fe9f4a8d04e6d2bdf0cfd057c0d8e9d
GIT binary patch
literal 20122
zcmeI$K@Ng25QX8X7^6Gg=*ER>Z^Fh?cnU9%Ekk3GZXl3!nxDkjG==cKSJc?HPdSRn
zNyP2N`O(|ITr%Fdrk_9i`DPf0b%$hp8P<RN{53iEHjE!Hk$bY<FXKP}0R#|00D(#c
zx~`63oj*uYl0ayrhE6mGNy^z<u@UQ?=<}gz%F$hNC$%Ke93s{`i8)BJWH)bd&aV;M
zouoNPvc*oBd(Ckpc02jcL6W&UVeR$PMr?MH%R!R0cgvjX<r)cd)_&1X@3;?P@Slir
z600fnsg66*Zi+OA<rJX_-C5RC#P17D6L*-!cWuJjCv8sJeixdmhAwjbFoysF2q1s}
z0tg_000IagfB*srAb<b@2q1s}0tg_000IagfB*srAb<b@2q1s}0tg_000IagP=>%4
DH7N{|

literal 0
HcmV?d00001

diff --git a/Tests/test_imagedraw.py b/Tests/test_imagedraw.py
index c221fe00829..505bba80c52 100644
--- a/Tests/test_imagedraw.py
+++ b/Tests/test_imagedraw.py
@@ -631,6 +631,19 @@ def test_polygon(points: Coords) -> None:
     assert_image_equal_tofile(im, "Tests/images/imagedraw_polygon.png")
 
 
+@pytest.mark.parametrize("points", POINTS)
+def test_polygon_width_I16(points: Coords) -> None:
+    # Arrange
+    im = Image.new("I;16", (W, H))
+    draw = ImageDraw.Draw(im)
+
+    # Act
+    draw.polygon(points, outline=0xFFFF, width=2)
+
+    # Assert
+    assert_image_equal_tofile(im, "Tests/images/imagedraw_polygon_width_I.tiff")
+
+
 @pytest.mark.parametrize("mode", ("RGB", "L"))
 @pytest.mark.parametrize("kite_points", KITE_POINTS)
 def test_polygon_kite(
diff --git a/src/libImaging/Paste.c b/src/libImaging/Paste.c
index a018225b26e..dc67cb41d2f 100644
--- a/src/libImaging/Paste.c
+++ b/src/libImaging/Paste.c
@@ -65,15 +65,32 @@ paste_mask_1(
     int x, y;
 
     if (imOut->image8) {
+        int in_i16 = strncmp(imIn->mode, "I;16", 4) == 0;
+        int out_i16 = strncmp(imOut->mode, "I;16", 4) == 0;
         for (y = 0; y < ysize; y++) {
             UINT8 *out = imOut->image8[y + dy] + dx;
+            if (out_i16) {
+                out += dx;
+            }
             UINT8 *in = imIn->image8[y + sy] + sx;
+            if (in_i16) {
+                in += sx;
+            }
             UINT8 *mask = imMask->image8[y + sy] + sx;
             for (x = 0; x < xsize; x++) {
-                if (*mask++) {
+                if (*mask) {
                     *out = *in;
                 }
-                out++, in++;
+                if (in_i16) {
+                    in++;
+                }
+                if (out_i16) {
+                    out++;
+                    if (*mask) {
+                        *out = *in;
+                    }
+                }
+                out++, in++, mask++;
             }
         }
 
@@ -415,15 +432,16 @@ fill_mask_L(
     unsigned int tmp1;
 
     if (imOut->image8) {
+        int i16 = strncmp(imOut->mode, "I;16", 4) == 0;
         for (y = 0; y < ysize; y++) {
             UINT8 *out = imOut->image8[y + dy] + dx;
-            if (strncmp(imOut->mode, "I;16", 4) == 0) {
+            if (i16) {
                 out += dx;
             }
             UINT8 *mask = imMask->image8[y + sy] + sx;
             for (x = 0; x < xsize; x++) {
                 *out = BLEND(*mask, *out, ink[0], tmp1);
-                if (strncmp(imOut->mode, "I;16", 4) == 0) {
+                if (i16) {
                     out++;
                     *out = BLEND(*mask, *out, ink[1], tmp1);
                 }

From d2603b779aec4810349621542b795e79c0144d8e Mon Sep 17 00:00:00 2001
From: Andrew Murray <radarhere@users.noreply.github.com>
Date: Sat, 8 Jun 2024 15:42:24 +1000
Subject: [PATCH 0679/1178] im color could be a tuple with a single float

---
 src/PIL/Image.py | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/src/PIL/Image.py b/src/PIL/Image.py
index 2ea26877d13..d9eb73e453c 100644
--- a/src/PIL/Image.py
+++ b/src/PIL/Image.py
@@ -1719,7 +1719,7 @@ def entropy(self, mask=None, extrema=None):
 
     def paste(
         self,
-        im: Image | str | float | tuple[int, ...],
+        im: Image | str | float | tuple[float, ...],
         box: tuple[int, int, int, int] | tuple[int, int] | None = None,
         mask: Image | None = None,
     ) -> None:

From 45cdc53bbb609212590b0558061aa2991cc87a5d Mon Sep 17 00:00:00 2001
From: Andrew Murray <radarhere@users.noreply.github.com>
Date: Sat, 8 Jun 2024 18:01:26 +1000
Subject: [PATCH 0680/1178] Updated type hints

---
 Tests/test_image_rotate.py |  4 ++--
 docs/handbook/concepts.rst |  6 ++++++
 docs/reference/Image.rst   |  1 -
 src/PIL/Image.py           | 10 +++++-----
 src/PIL/ImageDraw.py       | 11 ++++++-----
 src/PIL/ImageFont.py       |  2 +-
 src/PIL/_imagingft.pyi     |  2 +-
 7 files changed, 21 insertions(+), 15 deletions(-)

diff --git a/Tests/test_image_rotate.py b/Tests/test_image_rotate.py
index c10c96da6f9..252a15db742 100644
--- a/Tests/test_image_rotate.py
+++ b/Tests/test_image_rotate.py
@@ -124,8 +124,8 @@ def test_fastpath_translate() -> None:
 def test_center() -> None:
     im = hopper()
     rotate(im, im.mode, 45, center=(0, 0))
-    rotate(im, im.mode, 45, translate=(im.size[0] / 2, 0))
-    rotate(im, im.mode, 45, center=(0, 0), translate=(im.size[0] / 2, 0))
+    rotate(im, im.mode, 45, translate=(im.size[0] // 2, 0))
+    rotate(im, im.mode, 45, center=(0, 0), translate=(im.size[0] // 2, 0))
 
 
 def test_rotate_no_fill() -> None:
diff --git a/docs/handbook/concepts.rst b/docs/handbook/concepts.rst
index 5094dbf3f27..7da1078c14e 100644
--- a/docs/handbook/concepts.rst
+++ b/docs/handbook/concepts.rst
@@ -144,10 +144,12 @@ pixel, the Python Imaging Library provides different resampling *filters*.
 .. py:currentmodule:: PIL.Image
 
 .. data:: Resampling.NEAREST
+    :noindex:
 
     Pick one nearest pixel from the input image. Ignore all other input pixels.
 
 .. data:: Resampling.BOX
+    :noindex:
 
     Each pixel of source image contributes to one pixel of the
     destination image with identical weights.
@@ -158,6 +160,7 @@ pixel, the Python Imaging Library provides different resampling *filters*.
     .. versionadded:: 3.4.0
 
 .. data:: Resampling.BILINEAR
+    :noindex:
 
     For resize calculate the output pixel value using linear interpolation
     on all pixels that may contribute to the output value.
@@ -165,6 +168,7 @@ pixel, the Python Imaging Library provides different resampling *filters*.
     in the input image is used.
 
 .. data:: Resampling.HAMMING
+    :noindex:
 
     Produces a sharper image than :data:`Resampling.BILINEAR`, doesn't have
     dislocations on local level like with :data:`Resampling.BOX`.
@@ -174,6 +178,7 @@ pixel, the Python Imaging Library provides different resampling *filters*.
     .. versionadded:: 3.4.0
 
 .. data:: Resampling.BICUBIC
+    :noindex:
 
     For resize calculate the output pixel value using cubic interpolation
     on all pixels that may contribute to the output value.
@@ -181,6 +186,7 @@ pixel, the Python Imaging Library provides different resampling *filters*.
     in the input image is used.
 
 .. data:: Resampling.LANCZOS
+    :noindex:
 
     Calculate the output pixel value using a high-quality Lanczos filter (a
     truncated sinc) on all pixels that may contribute to the output value.
diff --git a/docs/reference/Image.rst b/docs/reference/Image.rst
index d917a3c9271..1c095a11453 100644
--- a/docs/reference/Image.rst
+++ b/docs/reference/Image.rst
@@ -424,7 +424,6 @@ See :ref:`concept-filters` for details.
 .. autoclass:: Resampling
     :members:
     :undoc-members:
-    :noindex:
 
 Dither modes
 ^^^^^^^^^^^^
diff --git a/src/PIL/Image.py b/src/PIL/Image.py
index d9eb73e453c..13d374345a6 100644
--- a/src/PIL/Image.py
+++ b/src/PIL/Image.py
@@ -2303,8 +2303,8 @@ def reduce(
     def rotate(
         self,
         angle: float,
-        resample: int = Resampling.NEAREST,
-        expand: bool = False,
+        resample: Resampling = Resampling.NEAREST,
+        expand: int | bool = False,
         center: tuple[int, int] | None = None,
         translate: tuple[int, int] | None = None,
         fillcolor: float | tuple[float, ...] | str | None = None,
@@ -2617,8 +2617,8 @@ def tell(self) -> int:
 
     def thumbnail(
         self,
-        size: tuple[int, int],
-        resample: int = Resampling.BICUBIC,
+        size: tuple[float, float],
+        resample: Resampling = Resampling.BICUBIC,
         reducing_gap: float = 2.0,
     ) -> None:
         """
@@ -2953,7 +2953,7 @@ def transform(
         self,
         size: tuple[int, int],
         image: Image,
-        **options: str | int | tuple[int, ...] | list[int],
+        **options: Any,
     ) -> Image:
         pass
 
diff --git a/src/PIL/ImageDraw.py b/src/PIL/ImageDraw.py
index 0663d9ddf85..9796189bb4b 100644
--- a/src/PIL/ImageDraw.py
+++ b/src/PIL/ImageDraw.py
@@ -95,7 +95,9 @@ def __init__(self, im: Image.Image, mode: str | None = None) -> None:
     if TYPE_CHECKING:
         from . import ImageFont
 
-    def getfont(self) -> ImageFont.FreeTypeFont | ImageFont.ImageFont:
+    def getfont(
+        self,
+    ) -> ImageFont.ImageFont | ImageFont.FreeTypeFont | ImageFont.TransposedFont:
         """
         Get the current default font.
 
@@ -122,14 +124,13 @@ def getfont(self) -> ImageFont.FreeTypeFont | ImageFont.ImageFont:
 
     def _getfont(
         self, font_size: float | None
-    ) -> ImageFont.FreeTypeFont | ImageFont.ImageFont:
+    ) -> ImageFont.ImageFont | ImageFont.FreeTypeFont | ImageFont.TransposedFont:
         if font_size is not None:
             from . import ImageFont
 
-            font = ImageFont.load_default(font_size)
+            return ImageFont.load_default(font_size)
         else:
-            font = self.getfont()
-        return font
+            return self.getfont()
 
     def _getink(self, ink, fill=None) -> tuple[int | None, int | None]:
         if ink is None and fill is None:
diff --git a/src/PIL/ImageFont.py b/src/PIL/ImageFont.py
index a9925483e40..87261f51920 100644
--- a/src/PIL/ImageFont.py
+++ b/src/PIL/ImageFont.py
@@ -361,7 +361,7 @@ def getbbox(
         text: str,
         mode: str = "",
         direction: str | None = None,
-        features: str | None = None,
+        features: list[str] | None = None,
         language: str | None = None,
         stroke_width: float = 0,
         anchor: str | None = None,
diff --git a/src/PIL/_imagingft.pyi b/src/PIL/_imagingft.pyi
index b023efe0110..6e0ddd2f165 100644
--- a/src/PIL/_imagingft.pyi
+++ b/src/PIL/_imagingft.pyi
@@ -6,7 +6,7 @@ class _Axis(TypedDict):
     minimum: int | None
     default: int | None
     maximum: int | None
-    name: str | None
+    name: bytes | None
 
 class Font:
     @property

From 985e6053810b7236e67dafcbfcd4b53e71e3fe3d Mon Sep 17 00:00:00 2001
From: Andrew Murray <radarhere@users.noreply.github.com>
Date: Sat, 8 Jun 2024 19:06:46 +1000
Subject: [PATCH 0681/1178] Renamed transform2 to transform

---
 src/PIL/Image.py | 2 +-
 src/_imaging.c   | 4 ++--
 2 files changed, 3 insertions(+), 3 deletions(-)

diff --git a/src/PIL/Image.py b/src/PIL/Image.py
index 611d6960da1..f61acc1d317 100644
--- a/src/PIL/Image.py
+++ b/src/PIL/Image.py
@@ -2883,7 +2883,7 @@ def __transformer(
         if image.mode in ("1", "P"):
             resample = Resampling.NEAREST
 
-        self.im.transform2(box, image.im, method, data, resample, fill)
+        self.im.transform(box, image.im, method, data, resample, fill)
 
     def transpose(self, method: Transpose) -> Image:
         """
diff --git a/src/_imaging.c b/src/_imaging.c
index c565c21bb15..f398c6c7c72 100644
--- a/src/_imaging.c
+++ b/src/_imaging.c
@@ -2028,7 +2028,7 @@ im_setmode(ImagingObject *self, PyObject *args) {
 }
 
 static PyObject *
-_transform2(ImagingObject *self, PyObject *args) {
+_transform(ImagingObject *self, PyObject *args) {
     static const char *wrong_number = "wrong number of matrix entries";
 
     Imaging imOut;
@@ -3647,7 +3647,7 @@ static struct PyMethodDef methods[] = {
     {"resize", (PyCFunction)_resize, METH_VARARGS},
     {"reduce", (PyCFunction)_reduce, METH_VARARGS},
     {"transpose", (PyCFunction)_transpose, METH_VARARGS},
-    {"transform2", (PyCFunction)_transform2, METH_VARARGS},
+    {"transform", (PyCFunction)_transform, METH_VARARGS},
 
     {"isblock", (PyCFunction)_isblock, METH_NOARGS},
 

From 0d73721c65d71e968a1a3b07d4252dd99b154772 Mon Sep 17 00:00:00 2001
From: Andrew Murray <radarhere@users.noreply.github.com>
Date: Sat, 8 Jun 2024 19:11:51 +1000
Subject: [PATCH 0682/1178] Allow float center for rotate operations

---
 src/PIL/Image.py | 13 +++++--------
 1 file changed, 5 insertions(+), 8 deletions(-)

diff --git a/src/PIL/Image.py b/src/PIL/Image.py
index 611d6960da1..1e46c4ee4a4 100644
--- a/src/PIL/Image.py
+++ b/src/PIL/Image.py
@@ -2305,7 +2305,7 @@ def rotate(
         angle: float,
         resample: Resampling = Resampling.NEAREST,
         expand: int | bool = False,
-        center: tuple[int, int] | None = None,
+        center: tuple[float, float] | None = None,
         translate: tuple[int, int] | None = None,
         fillcolor: float | tuple[float, ...] | str | None = None,
     ) -> Image:
@@ -2373,10 +2373,7 @@ def rotate(
         else:
             post_trans = translate
         if center is None:
-            # FIXME These should be rounded to ints?
-            rotn_center = (w / 2.0, h / 2.0)
-        else:
-            rotn_center = center
+            center = (w / 2, h / 2)
 
         angle = -math.radians(angle)
         matrix = [
@@ -2393,10 +2390,10 @@ def transform(x, y, matrix):
             return a * x + b * y + c, d * x + e * y + f
 
         matrix[2], matrix[5] = transform(
-            -rotn_center[0] - post_trans[0], -rotn_center[1] - post_trans[1], matrix
+            -center[0] - post_trans[0], -center[1] - post_trans[1], matrix
         )
-        matrix[2] += rotn_center[0]
-        matrix[5] += rotn_center[1]
+        matrix[2] += center[0]
+        matrix[5] += center[1]
 
         if expand:
             # calculate output size

From 14a32650ddf8af6016045170e6e7490e1cdcc0b0 Mon Sep 17 00:00:00 2001
From: Andrew Murray <radarhere@users.noreply.github.com>
Date: Sat, 8 Jun 2024 22:26:28 +1000
Subject: [PATCH 0683/1178] Added type hints

---
 src/PIL/ImageColor.py | 53 +++++++++++++++++++++++--------------------
 1 file changed, 28 insertions(+), 25 deletions(-)

diff --git a/src/PIL/ImageColor.py b/src/PIL/ImageColor.py
index 5fb80b75310..9a15a8eb759 100644
--- a/src/PIL/ImageColor.py
+++ b/src/PIL/ImageColor.py
@@ -25,7 +25,7 @@
 
 
 @lru_cache
-def getrgb(color):
+def getrgb(color: str) -> tuple[int, int, int] | tuple[int, int, int, int]:
     """
      Convert a color string to an RGB or RGBA tuple. If the string cannot be
      parsed, this function raises a :py:exc:`ValueError` exception.
@@ -44,8 +44,10 @@ def getrgb(color):
     if rgb:
         if isinstance(rgb, tuple):
             return rgb
-        colormap[color] = rgb = getrgb(rgb)
-        return rgb
+        rgb_tuple = getrgb(rgb)
+        assert len(rgb_tuple) == 3
+        colormap[color] = rgb_tuple
+        return rgb_tuple
 
     # check for known string formats
     if re.match("#[a-f0-9]{3}$", color):
@@ -88,15 +90,15 @@ def getrgb(color):
     if m:
         from colorsys import hls_to_rgb
 
-        rgb = hls_to_rgb(
+        rgb_floats = hls_to_rgb(
             float(m.group(1)) / 360.0,
             float(m.group(3)) / 100.0,
             float(m.group(2)) / 100.0,
         )
         return (
-            int(rgb[0] * 255 + 0.5),
-            int(rgb[1] * 255 + 0.5),
-            int(rgb[2] * 255 + 0.5),
+            int(rgb_floats[0] * 255 + 0.5),
+            int(rgb_floats[1] * 255 + 0.5),
+            int(rgb_floats[2] * 255 + 0.5),
         )
 
     m = re.match(
@@ -105,15 +107,15 @@ def getrgb(color):
     if m:
         from colorsys import hsv_to_rgb
 
-        rgb = hsv_to_rgb(
+        rgb_floats = hsv_to_rgb(
             float(m.group(1)) / 360.0,
             float(m.group(2)) / 100.0,
             float(m.group(3)) / 100.0,
         )
         return (
-            int(rgb[0] * 255 + 0.5),
-            int(rgb[1] * 255 + 0.5),
-            int(rgb[2] * 255 + 0.5),
+            int(rgb_floats[0] * 255 + 0.5),
+            int(rgb_floats[1] * 255 + 0.5),
+            int(rgb_floats[2] * 255 + 0.5),
         )
 
     m = re.match(r"rgba\(\s*(\d+)\s*,\s*(\d+)\s*,\s*(\d+)\s*,\s*(\d+)\s*\)$", color)
@@ -124,7 +126,7 @@ def getrgb(color):
 
 
 @lru_cache
-def getcolor(color, mode: str) -> tuple[int, ...]:
+def getcolor(color: str, mode: str) -> int | tuple[int, ...]:
     """
     Same as :py:func:`~PIL.ImageColor.getrgb` for most modes. However, if
     ``mode`` is HSV, converts the RGB value to a HSV value, or if ``mode`` is
@@ -136,33 +138,34 @@ def getcolor(color, mode: str) -> tuple[int, ...]:
 
     :param color: A color string
     :param mode: Convert result to this mode
-    :return: ``(graylevel[, alpha]) or (red, green, blue[, alpha])``
+    :return: ``graylevel, (graylevel, alpha) or (red, green, blue[, alpha])``
     """
     # same as getrgb, but converts the result to the given mode
-    color, alpha = getrgb(color), 255
-    if len(color) == 4:
-        color, alpha = color[:3], color[3]
+    rgb, alpha = getrgb(color), 255
+    if len(rgb) == 4:
+        alpha = rgb[3]
+        rgb = rgb[:3]
 
     if mode == "HSV":
         from colorsys import rgb_to_hsv
 
-        r, g, b = color
+        r, g, b = rgb
         h, s, v = rgb_to_hsv(r / 255, g / 255, b / 255)
         return int(h * 255), int(s * 255), int(v * 255)
     elif Image.getmodebase(mode) == "L":
-        r, g, b = color
+        r, g, b = rgb
         # ITU-R Recommendation 601-2 for nonlinear RGB
         # scaled to 24 bits to match the convert's implementation.
-        color = (r * 19595 + g * 38470 + b * 7471 + 0x8000) >> 16
+        graylevel = (r * 19595 + g * 38470 + b * 7471 + 0x8000) >> 16
         if mode[-1] == "A":
-            return color, alpha
-    else:
-        if mode[-1] == "A":
-            return color + (alpha,)
-    return color
+            return graylevel, alpha
+        return graylevel
+    elif mode[-1] == "A":
+        return rgb + (alpha,)
+    return rgb
 
 
-colormap = {
+colormap: dict[str, str | tuple[int, int, int]] = {
     # X11 colour table from https://drafts.csswg.org/css-color-4/, with
     # gray/grey spelling issues fixed.  This is a superset of HTML 4.0
     # colour names used in CSS 1.

From 56fa3c658a9c60facce7acbb3909855f7aea2340 Mon Sep 17 00:00:00 2001
From: Andrew Murray <radarhere@users.noreply.github.com>
Date: Sun, 9 Jun 2024 07:12:05 +1000
Subject: [PATCH 0684/1178] Added type hints

---
 src/PIL/GifImagePlugin.py    | 15 +++++++++----
 src/PIL/GimpGradientFile.py  | 43 +++++++++++++++++++++++++++---------
 src/PIL/Image.py             |  2 +-
 src/PIL/ImageDraw2.py        |  6 ++---
 src/PIL/ImageTk.py           |  6 ++---
 src/PIL/Jpeg2KImagePlugin.py |  3 ++-
 src/PIL/PaletteFile.py       | 10 +++++----
 src/PIL/TiffImagePlugin.py   |  4 ++--
 8 files changed, 61 insertions(+), 28 deletions(-)

diff --git a/src/PIL/GifImagePlugin.py b/src/PIL/GifImagePlugin.py
index e62852db31d..f41bc2b321d 100644
--- a/src/PIL/GifImagePlugin.py
+++ b/src/PIL/GifImagePlugin.py
@@ -558,7 +558,11 @@ def _normalize_palette(im, palette, info):
     return im
 
 
-def _write_single_frame(im, fp, palette):
+def _write_single_frame(
+    im: Image.Image,
+    fp: IO[bytes],
+    palette: bytes | bytearray | list[int] | ImagePalette.ImagePalette,
+) -> None:
     im_out = _normalize_mode(im)
     for k, v in im_out.info.items():
         im.encoderinfo.setdefault(k, v)
@@ -579,7 +583,9 @@ def _write_single_frame(im, fp, palette):
     fp.write(b"\0")  # end of image data
 
 
-def _getbbox(base_im, im_frame):
+def _getbbox(
+    base_im: Image.Image, im_frame: Image.Image
+) -> tuple[Image.Image, tuple[int, int, int, int]]:
     if _get_palette_bytes(im_frame) != _get_palette_bytes(base_im):
         im_frame = im_frame.convert("RGBA")
         base_im = base_im.convert("RGBA")
@@ -790,7 +796,7 @@ def _write_local_header(fp, im, offset, flags):
     fp.write(o8(8))  # bits
 
 
-def _save_netpbm(im, fp, filename):
+def _save_netpbm(im: Image.Image, fp: IO[bytes], filename: str) -> None:
     # Unused by default.
     # To use, uncomment the register_save call at the end of the file.
     #
@@ -821,6 +827,7 @@ def _save_netpbm(im, fp, filename):
                 )
 
                 # Allow ppmquant to receive SIGPIPE if ppmtogif exits
+                assert quant_proc.stdout is not None
                 quant_proc.stdout.close()
 
                 retcode = quant_proc.wait()
@@ -1080,7 +1087,7 @@ def getdata(im, offset=(0, 0), **params):
     class Collector:
         data = []
 
-        def write(self, data):
+        def write(self, data: bytes) -> None:
             self.data.append(data)
 
     im.load()  # make sure raster data is available
diff --git a/src/PIL/GimpGradientFile.py b/src/PIL/GimpGradientFile.py
index 2d8c78ea91a..92068b904e7 100644
--- a/src/PIL/GimpGradientFile.py
+++ b/src/PIL/GimpGradientFile.py
@@ -21,6 +21,7 @@
 from __future__ import annotations
 
 from math import log, pi, sin, sqrt
+from typing import IO, Callable
 
 from ._binary import o8
 
@@ -28,7 +29,7 @@
 """"""  # Enable auto-doc for data member
 
 
-def linear(middle, pos):
+def linear(middle: float, pos: float) -> float:
     if pos <= middle:
         if middle < EPSILON:
             return 0.0
@@ -43,19 +44,19 @@ def linear(middle, pos):
             return 0.5 + 0.5 * pos / middle
 
 
-def curved(middle, pos):
+def curved(middle: float, pos: float) -> float:
     return pos ** (log(0.5) / log(max(middle, EPSILON)))
 
 
-def sine(middle, pos):
+def sine(middle: float, pos: float) -> float:
     return (sin((-pi / 2.0) + pi * linear(middle, pos)) + 1.0) / 2.0
 
 
-def sphere_increasing(middle, pos):
+def sphere_increasing(middle: float, pos: float) -> float:
     return sqrt(1.0 - (linear(middle, pos) - 1.0) ** 2)
 
 
-def sphere_decreasing(middle, pos):
+def sphere_decreasing(middle: float, pos: float) -> float:
     return 1.0 - sqrt(1.0 - linear(middle, pos) ** 2)
 
 
@@ -64,9 +65,22 @@ def sphere_decreasing(middle, pos):
 
 
 class GradientFile:
-    gradient = None
-
-    def getpalette(self, entries=256):
+    gradient: (
+        list[
+            tuple[
+                float,
+                float,
+                float,
+                list[float],
+                list[float],
+                Callable[[float, float], float],
+            ]
+        ]
+        | None
+    ) = None
+
+    def getpalette(self, entries: int = 256) -> tuple[bytes, str]:
+        assert self.gradient is not None
         palette = []
 
         ix = 0
@@ -101,7 +115,7 @@ def getpalette(self, entries=256):
 class GimpGradientFile(GradientFile):
     """File handler for GIMP's gradient format."""
 
-    def __init__(self, fp):
+    def __init__(self, fp: IO[bytes]) -> None:
         if fp.readline()[:13] != b"GIMP Gradient":
             msg = "not a GIMP gradient file"
             raise SyntaxError(msg)
@@ -114,7 +128,16 @@ def __init__(self, fp):
 
         count = int(line)
 
-        gradient = []
+        gradient: list[
+            tuple[
+                float,
+                float,
+                float,
+                list[float],
+                list[float],
+                Callable[[float, float], float],
+            ]
+        ] = []
 
         for i in range(count):
             s = fp.readline().split()
diff --git a/src/PIL/Image.py b/src/PIL/Image.py
index f61acc1d317..f6ffac8a77f 100644
--- a/src/PIL/Image.py
+++ b/src/PIL/Image.py
@@ -2470,7 +2470,7 @@ def save(
 
         save_all = params.pop("save_all", False)
         self.encoderinfo = params
-        self.encoderconfig = ()
+        self.encoderconfig: tuple[Any, ...] = ()
 
         preinit()
 
diff --git a/src/PIL/ImageDraw2.py b/src/PIL/ImageDraw2.py
index 35ee5834e34..b42f5d9eac1 100644
--- a/src/PIL/ImageDraw2.py
+++ b/src/PIL/ImageDraw2.py
@@ -30,7 +30,7 @@
 class Pen:
     """Stores an outline color and width."""
 
-    def __init__(self, color, width=1, opacity=255):
+    def __init__(self, color: str, width: int = 1, opacity: int = 255) -> None:
         self.color = ImageColor.getrgb(color)
         self.width = width
 
@@ -38,7 +38,7 @@ def __init__(self, color, width=1, opacity=255):
 class Brush:
     """Stores a fill color"""
 
-    def __init__(self, color, opacity=255):
+    def __init__(self, color: str, opacity: int = 255) -> None:
         self.color = ImageColor.getrgb(color)
 
 
@@ -63,7 +63,7 @@ def __init__(self, image, size=None, color=None):
         self.image = image
         self.transform = None
 
-    def flush(self):
+    def flush(self) -> Image.Image:
         return self.image
 
     def render(self, op, xy, pen, brush=None):
diff --git a/src/PIL/ImageTk.py b/src/PIL/ImageTk.py
index 6e2e7db1e19..90defdbbc23 100644
--- a/src/PIL/ImageTk.py
+++ b/src/PIL/ImageTk.py
@@ -37,7 +37,7 @@
 _pilbitmap_ok = None
 
 
-def _pilbitmap_check():
+def _pilbitmap_check() -> int:
     global _pilbitmap_ok
     if _pilbitmap_ok is None:
         try:
@@ -162,7 +162,7 @@ def height(self) -> int:
         """
         return self.__size[1]
 
-    def paste(self, im):
+    def paste(self, im: Image.Image) -> None:
         """
         Paste a PIL image into the photo image.  Note that this can
         be very slow if the photo image is displayed.
@@ -254,7 +254,7 @@ def __str__(self) -> str:
         return str(self.__photo)
 
 
-def getimage(photo):
+def getimage(photo: PhotoImage) -> Image.Image:
     """Copies the contents of a PhotoImage to a PIL image memory."""
     im = Image.new("RGBA", (photo.width(), photo.height()))
     block = im.im
diff --git a/src/PIL/Jpeg2KImagePlugin.py b/src/PIL/Jpeg2KImagePlugin.py
index e6395b1cb96..5a0ef0d01a3 100644
--- a/src/PIL/Jpeg2KImagePlugin.py
+++ b/src/PIL/Jpeg2KImagePlugin.py
@@ -18,6 +18,7 @@
 import io
 import os
 import struct
+from typing import IO
 
 from . import Image, ImageFile, ImagePalette, _binary
 
@@ -328,7 +329,7 @@ def _accept(prefix: bytes) -> bool:
 # Save support
 
 
-def _save(im, fp, filename):
+def _save(im: Image.Image, fp: IO[bytes], filename: str) -> None:
     # Get the keyword arguments
     info = im.encoderinfo
 
diff --git a/src/PIL/PaletteFile.py b/src/PIL/PaletteFile.py
index eaed5367c99..81652e5eec2 100644
--- a/src/PIL/PaletteFile.py
+++ b/src/PIL/PaletteFile.py
@@ -14,6 +14,8 @@
 #
 from __future__ import annotations
 
+from typing import IO
+
 from ._binary import o8
 
 
@@ -22,8 +24,8 @@ class PaletteFile:
 
     rawmode = "RGB"
 
-    def __init__(self, fp):
-        self.palette = [(i, i, i) for i in range(256)]
+    def __init__(self, fp: IO[bytes]) -> None:
+        palette = [o8(i) * 3 for i in range(256)]
 
         while True:
             s = fp.readline()
@@ -44,9 +46,9 @@ def __init__(self, fp):
                 g = b = r
 
             if 0 <= i <= 255:
-                self.palette[i] = o8(r) + o8(g) + o8(b)
+                palette[i] = o8(r) + o8(g) + o8(b)
 
-        self.palette = b"".join(self.palette)
+        self.palette = b"".join(palette)
 
     def getpalette(self) -> tuple[bytes, str]:
         return self.palette, self.rawmode
diff --git a/src/PIL/TiffImagePlugin.py b/src/PIL/TiffImagePlugin.py
index 04f36744bed..0b96017552a 100644
--- a/src/PIL/TiffImagePlugin.py
+++ b/src/PIL/TiffImagePlugin.py
@@ -50,7 +50,7 @@
 from collections.abc import MutableMapping
 from fractions import Fraction
 from numbers import Number, Rational
-from typing import TYPE_CHECKING, Any, Callable
+from typing import IO, TYPE_CHECKING, Any, Callable
 
 from . import ExifTags, Image, ImageFile, ImageOps, ImagePalette, TiffTags
 from ._binary import i16be as i16
@@ -2149,7 +2149,7 @@ def fixOffsets(self, count, isShort=False, isLong=False):
                 self.rewriteLastLong(offset)
 
 
-def _save_all(im, fp, filename):
+def _save_all(im: Image.Image, fp: IO[bytes], filename: str) -> None:
     encoderinfo = im.encoderinfo.copy()
     encoderconfig = im.encoderconfig
     append_images = list(encoderinfo.get("append_images", []))

From 1a14957c1954b18368a65bff06d8a959731d9e55 Mon Sep 17 00:00:00 2001
From: Andrew Murray <radarhere@users.noreply.github.com>
Date: Sun, 9 Jun 2024 15:16:17 +1000
Subject: [PATCH 0685/1178] Added type hints

---
 Tests/test_decompression_bomb.py |  2 +-
 Tests/test_file_jpeg.py          | 17 ++++++++++-------
 Tests/test_file_tiff.py          |  2 +-
 Tests/test_image_mode.py         |  6 +++++-
 Tests/test_image_quantize.py     |  2 +-
 Tests/test_image_reduce.py       | 12 ++++++++----
 Tests/test_image_thumbnail.py    |  2 +-
 Tests/test_imagedraw.py          |  6 +++++-
 Tests/test_imagefont.py          |  2 +-
 Tests/test_imageops.py           |  2 +-
 Tests/test_imagewin_pointers.py  |  2 +-
 Tests/test_main.py               |  2 +-
 12 files changed, 36 insertions(+), 21 deletions(-)

diff --git a/Tests/test_decompression_bomb.py b/Tests/test_decompression_bomb.py
index 9c21efa45f7..c140156f9ea 100644
--- a/Tests/test_decompression_bomb.py
+++ b/Tests/test_decompression_bomb.py
@@ -12,7 +12,7 @@
 
 
 class TestDecompressionBomb:
-    def teardown_method(self, method) -> None:
+    def teardown_method(self) -> None:
         Image.MAX_IMAGE_PIXELS = ORIGINAL_LIMIT
 
     def test_no_warning_small_file(self) -> None:
diff --git a/Tests/test_file_jpeg.py b/Tests/test_file_jpeg.py
index 18dc752d8bd..8e4d694c1a9 100644
--- a/Tests/test_file_jpeg.py
+++ b/Tests/test_file_jpeg.py
@@ -443,7 +443,9 @@ def test_smooth(self) -> None:
         assert_image(im1, im2.mode, im2.size)
 
     def test_subsampling(self) -> None:
-        def getsampling(im: JpegImagePlugin.JpegImageFile):
+        def getsampling(
+            im: JpegImagePlugin.JpegImageFile,
+        ) -> tuple[int, int, int, int, int, int]:
             layer = im.layer
             return layer[0][1:3] + layer[1][1:3] + layer[2][1:3]
 
@@ -917,24 +919,25 @@ def test_icc_after_SOF(self) -> None:
         with Image.open("Tests/images/icc-after-SOF.jpg") as im:
             assert im.info["icc_profile"] == b"profile"
 
-    def test_jpeg_magic_number(self) -> None:
+    def test_jpeg_magic_number(self, monkeypatch: pytest.MonkeyPatch) -> None:
         size = 4097
         buffer = BytesIO(b"\xFF" * size)  # Many xFF bytes
-        buffer.max_pos = 0
+        max_pos = 0
         orig_read = buffer.read
 
-        def read(n=-1):
+        def read(n: int | None = -1) -> bytes:
+            nonlocal max_pos
             res = orig_read(n)
-            buffer.max_pos = max(buffer.max_pos, buffer.tell())
+            max_pos = max(max_pos, buffer.tell())
             return res
 
-        buffer.read = read
+        monkeypatch.setattr(buffer, "read", read)
         with pytest.raises(UnidentifiedImageError):
             with Image.open(buffer):
                 pass
 
         # Assert the entire file has not been read
-        assert 0 < buffer.max_pos < size
+        assert 0 < max_pos < size
 
     def test_getxmp(self) -> None:
         with Image.open("Tests/images/xmp_test.jpg") as im:
diff --git a/Tests/test_file_tiff.py b/Tests/test_file_tiff.py
index 8821fb46a84..06591a29a37 100644
--- a/Tests/test_file_tiff.py
+++ b/Tests/test_file_tiff.py
@@ -113,7 +113,7 @@ def test_bigtiff(self, tmp_path: Path) -> None:
             outfile = str(tmp_path / "temp.tif")
             im.save(outfile, save_all=True, append_images=[im], tiffinfo=im.tag_v2)
 
-    def test_seek_too_large(self):
+    def test_seek_too_large(self) -> None:
         with pytest.raises(ValueError, match="Unable to seek to frame"):
             Image.open("Tests/images/seek_too_large.tif")
 
diff --git a/Tests/test_image_mode.py b/Tests/test_image_mode.py
index 8e94aafc598..20d3a160e9c 100644
--- a/Tests/test_image_mode.py
+++ b/Tests/test_image_mode.py
@@ -68,7 +68,11 @@ def test_sanity() -> None:
     ),
 )
 def test_properties(
-    mode, expected_base, expected_type, expected_bands, expected_band_names
+    mode: str,
+    expected_base: str,
+    expected_type: str,
+    expected_bands: int,
+    expected_band_names: tuple[str, ...],
 ) -> None:
     assert Image.getmodebase(mode) == expected_base
     assert Image.getmodetype(mode) == expected_type
diff --git a/Tests/test_image_quantize.py b/Tests/test_image_quantize.py
index 2daaf5c3cbb..2d461d985dd 100644
--- a/Tests/test_image_quantize.py
+++ b/Tests/test_image_quantize.py
@@ -98,7 +98,7 @@ def test_quantize_dither_diff() -> None:
 @pytest.mark.parametrize(
     "method", (Image.Quantize.MEDIANCUT, Image.Quantize.MAXCOVERAGE)
 )
-def test_quantize_kmeans(method) -> None:
+def test_quantize_kmeans(method: Image.Quantize) -> None:
     im = hopper()
     no_kmeans = im.quantize(kmeans=0, method=method)
     kmeans = im.quantize(kmeans=1, method=method)
diff --git a/Tests/test_image_reduce.py b/Tests/test_image_reduce.py
index f6609a1a054..6771b46b051 100644
--- a/Tests/test_image_reduce.py
+++ b/Tests/test_image_reduce.py
@@ -56,10 +56,12 @@ def test_args_factor(size: int | tuple[int, int], expected: tuple[int, int]) ->
 @pytest.mark.parametrize(
     "size, expected_error", ((0, ValueError), (2.0, TypeError), ((0, 10), ValueError))
 )
-def test_args_factor_error(size: float | tuple[int, int], expected_error) -> None:
+def test_args_factor_error(
+    size: float | tuple[int, int], expected_error: type[Exception]
+) -> None:
     im = Image.new("L", (10, 10))
     with pytest.raises(expected_error):
-        im.reduce(size)
+        im.reduce(size)  # type: ignore[arg-type]
 
 
 @pytest.mark.parametrize(
@@ -86,10 +88,12 @@ def test_args_box(size: tuple[int, int, int, int], expected: tuple[int, int]) ->
         ((5, 0, 5, 10), ValueError),
     ),
 )
-def test_args_box_error(size: str | tuple[int, int, int, int], expected_error) -> None:
+def test_args_box_error(
+    size: str | tuple[int, int, int, int], expected_error: type[Exception]
+) -> None:
     im = Image.new("L", (10, 10))
     with pytest.raises(expected_error):
-        im.reduce(2, size).size
+        im.reduce(2, size).size  # type: ignore[arg-type]
 
 
 @pytest.mark.parametrize("mode", ("P", "1", "I;16"))
diff --git a/Tests/test_image_thumbnail.py b/Tests/test_image_thumbnail.py
index 1593eaaf7fa..1606d8939c0 100644
--- a/Tests/test_image_thumbnail.py
+++ b/Tests/test_image_thumbnail.py
@@ -16,7 +16,7 @@
 
 def test_sanity() -> None:
     im = hopper()
-    assert im.thumbnail((100, 100)) is None
+    assert im.thumbnail((100, 100)) is None  # type: ignore[func-returns-value]
 
     assert im.size == (100, 100)
 
diff --git a/Tests/test_imagedraw.py b/Tests/test_imagedraw.py
index c221fe00829..51543d7851f 100644
--- a/Tests/test_imagedraw.py
+++ b/Tests/test_imagedraw.py
@@ -1562,7 +1562,11 @@ def test_compute_regular_polygon_vertices(
     ],
 )
 def test_compute_regular_polygon_vertices_input_error_handling(
-    n_sides, bounding_circle, rotation, expected_error, error_message
+    n_sides: int,
+    bounding_circle: int | tuple[int | tuple[int] | str, ...],
+    rotation: int | str,
+    expected_error: type[Exception],
+    error_message: str,
 ) -> None:
     with pytest.raises(expected_error) as e:
         ImageDraw._compute_regular_polygon_vertices(bounding_circle, n_sides, rotation)
diff --git a/Tests/test_imagefont.py b/Tests/test_imagefont.py
index 4398f8a3055..73cad513e62 100644
--- a/Tests/test_imagefont.py
+++ b/Tests/test_imagefont.py
@@ -224,7 +224,7 @@ def test_render_multiline(font: ImageFont.FreeTypeFont) -> None:
     draw = ImageDraw.Draw(im)
     line_spacing = font.getbbox("A")[3] + 4
     lines = TEST_TEXT.split("\n")
-    y = 0
+    y: float = 0
     for line in lines:
         draw.text((0, y), line, font=font)
         y += line_spacing
diff --git a/Tests/test_imageops.py b/Tests/test_imageops.py
index d6bdaf45073..27a6090c5fa 100644
--- a/Tests/test_imageops.py
+++ b/Tests/test_imageops.py
@@ -454,7 +454,7 @@ def test_autocontrast_cutoff() -> None:
     # Test the cutoff argument of autocontrast
     with Image.open("Tests/images/bw_gradient.png") as img:
 
-        def autocontrast(cutoff: int | tuple[int, int]):
+        def autocontrast(cutoff: int | tuple[int, int]) -> list[int]:
             return ImageOps.autocontrast(img, cutoff).histogram()
 
         assert autocontrast(10) == autocontrast((10, 10))
diff --git a/Tests/test_imagewin_pointers.py b/Tests/test_imagewin_pointers.py
index f59ee7284b8..e6c312a0c46 100644
--- a/Tests/test_imagewin_pointers.py
+++ b/Tests/test_imagewin_pointers.py
@@ -70,7 +70,7 @@ class BITMAPINFOHEADER(ctypes.Structure):
     ]
     CreateDIBSection.restype = ctypes.wintypes.HBITMAP
 
-    def serialize_dib(bi, pixels) -> bytearray:
+    def serialize_dib(bi: BITMAPINFOHEADER, pixels: ctypes.c_void_p) -> bytearray:
         bf = BITMAPFILEHEADER()
         bf.bfType = 0x4D42
         bf.bfOffBits = ctypes.sizeof(bf) + bi.biSize
diff --git a/Tests/test_main.py b/Tests/test_main.py
index e9e12b24a79..2582dbee3db 100644
--- a/Tests/test_main.py
+++ b/Tests/test_main.py
@@ -11,7 +11,7 @@
     "args, report",
     ((["PIL"], False), (["PIL", "--report"], True), (["PIL.report"], True)),
 )
-def test_main(args, report) -> None:
+def test_main(args: list[str], report: bool) -> None:
     args = [sys.executable, "-m"] + args
     out = subprocess.check_output(args).decode("utf-8")
     lines = out.splitlines()

From de0779eee876ae92c48458d38778a3c557566312 Mon Sep 17 00:00:00 2001
From: Andrew Murray <3112309+radarhere@users.noreply.github.com>
Date: Sun, 9 Jun 2024 18:09:54 +1000
Subject: [PATCH 0686/1178] Removed return value assertion

---
 Tests/test_image_thumbnail.py | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/Tests/test_image_thumbnail.py b/Tests/test_image_thumbnail.py
index 1606d8939c0..bdbf09c407e 100644
--- a/Tests/test_image_thumbnail.py
+++ b/Tests/test_image_thumbnail.py
@@ -16,7 +16,7 @@
 
 def test_sanity() -> None:
     im = hopper()
-    assert im.thumbnail((100, 100)) is None  # type: ignore[func-returns-value]
+    im.thumbnail((100, 100))
 
     assert im.size == (100, 100)
 

From 56c79b6f523d2bb7733b9193e47fab2f63f5b546 Mon Sep 17 00:00:00 2001
From: Andrew Murray <radarhere@users.noreply.github.com>
Date: Sun, 9 Jun 2024 22:13:01 +1000
Subject: [PATCH 0687/1178] Simplified code

---
 src/PIL/GimpGradientFile.py | 15 ++-------------
 1 file changed, 2 insertions(+), 13 deletions(-)

diff --git a/src/PIL/GimpGradientFile.py b/src/PIL/GimpGradientFile.py
index 92068b904e7..220eac57e38 100644
--- a/src/PIL/GimpGradientFile.py
+++ b/src/PIL/GimpGradientFile.py
@@ -128,16 +128,7 @@ def __init__(self, fp: IO[bytes]) -> None:
 
         count = int(line)
 
-        gradient: list[
-            tuple[
-                float,
-                float,
-                float,
-                list[float],
-                list[float],
-                Callable[[float, float], float],
-            ]
-        ] = []
+        self.gradient = []
 
         for i in range(count):
             s = fp.readline().split()
@@ -155,6 +146,4 @@ def __init__(self, fp: IO[bytes]) -> None:
                 msg = "cannot handle HSV colour space"
                 raise OSError(msg)
 
-            gradient.append((x0, x1, xm, rgb0, rgb1, segment))
-
-        self.gradient = gradient
+            self.gradient.append((x0, x1, xm, rgb0, rgb1, segment))

From e225f9f589e07d46ad5d1f79e7c233addf9c3836 Mon Sep 17 00:00:00 2001
From: Andrew Murray <radarhere@users.noreply.github.com>
Date: Mon, 10 Jun 2024 11:50:13 +1000
Subject: [PATCH 0688/1178] Deprecate ImageDraw.getdraw hints argument

---
 Tests/test_imagedraw.py      |  5 +++++
 docs/deprecations.rst        |  7 +++++++
 docs/releasenotes/10.4.0.rst |  5 +++++
 src/PIL/ImageDraw.py         | 24 ++++++++----------------
 4 files changed, 25 insertions(+), 16 deletions(-)

diff --git a/Tests/test_imagedraw.py b/Tests/test_imagedraw.py
index c221fe00829..61d7b5c6a18 100644
--- a/Tests/test_imagedraw.py
+++ b/Tests/test_imagedraw.py
@@ -1624,3 +1624,8 @@ def test_incorrectly_ordered_coordinates(xy: tuple[int, int, int, int]) -> None:
         draw.rectangle(xy)
     with pytest.raises(ValueError):
         draw.rounded_rectangle(xy)
+
+
+def test_getdraw():
+    with pytest.warns(DeprecationWarning):
+        ImageDraw.getdraw(None, [])
diff --git a/docs/deprecations.rst b/docs/deprecations.rst
index b2cd968fee3..8a03d858c71 100644
--- a/docs/deprecations.rst
+++ b/docs/deprecations.rst
@@ -115,6 +115,13 @@ Support for LibTIFF earlier than 4
 Support for LibTIFF earlier than version 4 has been deprecated.
 Upgrade to a newer version of LibTIFF instead.
 
+ImageDraw.getdraw hints argument
+^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
+
+.. deprecated:: 10.4.0
+
+The ``hints`` argument in :py:meth:`~PIL.ImageDraw.getdraw()` has been deprecated.
+
 Removed features
 ----------------
 
diff --git a/docs/releasenotes/10.4.0.rst b/docs/releasenotes/10.4.0.rst
index e0d695a8bba..8c49e0842c5 100644
--- a/docs/releasenotes/10.4.0.rst
+++ b/docs/releasenotes/10.4.0.rst
@@ -34,6 +34,11 @@ Support for LibTIFF earlier than 4
 Support for LibTIFF earlier than version 4 has been deprecated.
 Upgrade to a newer version of LibTIFF instead.
 
+ImageDraw.getdraw hints argument
+^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
+
+The ``hints`` argument in :py:meth:`~PIL.ImageDraw.getdraw()` has been deprecated.
+
 API Changes
 ===========
 
diff --git a/src/PIL/ImageDraw.py b/src/PIL/ImageDraw.py
index 73ed3d4a9a6..ec15b535fbe 100644
--- a/src/PIL/ImageDraw.py
+++ b/src/PIL/ImageDraw.py
@@ -37,6 +37,7 @@
 from typing import TYPE_CHECKING, AnyStr, Sequence, cast
 
 from . import Image, ImageColor
+from ._deprecate import deprecate
 from ._typing import Coords
 
 """
@@ -902,26 +903,17 @@ def Draw(im, mode: str | None = None) -> ImageDraw:
 
 def getdraw(im=None, hints=None):
     """
-    (Experimental) A more advanced 2D drawing interface for PIL images,
-    based on the WCK interface.
-
     :param im: The image to draw in.
-    :param hints: An optional list of hints.
+    :param hints: An optional list of hints. Deprecated.
     :returns: A (drawing context, drawing resource factory) tuple.
     """
-    # FIXME: this needs more work!
-    # FIXME: come up with a better 'hints' scheme.
-    handler = None
-    if not hints or "nicest" in hints:
-        try:
-            from . import _imagingagg as handler
-        except ImportError:
-            pass
-    if handler is None:
-        from . import ImageDraw2 as handler
+    if hints is not None:
+        deprecate("'hints' argument", 12)
+    from . import ImageDraw2
+
     if im:
-        im = handler.Draw(im)
-    return im, handler
+        im = ImageDraw2.Draw(im)
+    return im, ImageDraw2
 
 
 def floodfill(

From 2d1fe7572f461e13ed70f4f6162d5266d8440df0 Mon Sep 17 00:00:00 2001
From: Andrew Murray <radarhere@users.noreply.github.com>
Date: Mon, 10 Jun 2024 14:15:28 +1000
Subject: [PATCH 0689/1178] Added type hints

---
 src/PIL/BlpImagePlugin.py      | 15 ++++++++++-----
 src/PIL/BmpImagePlugin.py      |  4 ++--
 src/PIL/BufrStubImagePlugin.py |  2 +-
 src/PIL/DdsImagePlugin.py      |  2 +-
 src/PIL/GifImagePlugin.py      |  6 +++---
 src/PIL/GribStubImagePlugin.py |  2 +-
 src/PIL/Hdf5StubImagePlugin.py |  2 +-
 src/PIL/IcnsImagePlugin.py     | 19 +++++++++----------
 src/PIL/IcoImagePlugin.py      |  2 +-
 src/PIL/ImImagePlugin.py       |  4 +++-
 src/PIL/Image.py               | 26 +++++++++++++++++---------
 src/PIL/ImageDraw.py           | 16 ++++++++++------
 src/PIL/ImageFile.py           |  2 +-
 src/PIL/Jpeg2KImagePlugin.py   |  6 ++++--
 src/PIL/JpegImagePlugin.py     |  6 +++---
 src/PIL/MpoImagePlugin.py      |  2 +-
 src/PIL/MspImagePlugin.py      |  2 +-
 src/PIL/PcxImagePlugin.py      |  2 +-
 src/PIL/PdfImagePlugin.py      |  2 +-
 src/PIL/PdfParser.py           | 13 ++++++-------
 src/PIL/PngImagePlugin.py      |  2 +-
 src/PIL/PpmImagePlugin.py      |  2 +-
 src/PIL/QoiImagePlugin.py      | 16 ++++++++++------
 src/PIL/SgiImagePlugin.py      |  7 ++++---
 src/PIL/SpiderImagePlugin.py   |  7 ++++---
 src/PIL/TgaImagePlugin.py      |  2 +-
 src/PIL/TiffImagePlugin.py     |  4 ++--
 src/PIL/WebPImagePlugin.py     |  8 ++++----
 src/PIL/WmfImagePlugin.py      |  2 +-
 src/PIL/XbmImagePlugin.py      |  2 +-
 30 files changed, 106 insertions(+), 81 deletions(-)

diff --git a/src/PIL/BlpImagePlugin.py b/src/PIL/BlpImagePlugin.py
index 2db115ccc4f..003fa9b2479 100644
--- a/src/PIL/BlpImagePlugin.py
+++ b/src/PIL/BlpImagePlugin.py
@@ -31,6 +31,7 @@
 
 from __future__ import annotations
 
+import abc
 import os
 import struct
 from enum import IntEnum
@@ -276,7 +277,7 @@ def _open(self) -> None:
 class _BLPBaseDecoder(ImageFile.PyDecoder):
     _pulls_fd = True
 
-    def decode(self, buffer):
+    def decode(self, buffer: bytes) -> tuple[int, int]:
         try:
             self._read_blp_header()
             self._load()
@@ -285,6 +286,10 @@ def decode(self, buffer):
             raise OSError(msg) from e
         return -1, 0
 
+    @abc.abstractmethod
+    def _load(self) -> None:
+        pass
+
     def _read_blp_header(self) -> None:
         assert self.fd is not None
         self.fd.seek(4)
@@ -318,7 +323,7 @@ def _read_palette(self) -> list[tuple[int, int, int, int]]:
             ret.append((b, g, r, a))
         return ret
 
-    def _read_bgra(self, palette):
+    def _read_bgra(self, palette: list[tuple[int, int, int, int]]) -> bytearray:
         data = bytearray()
         _data = BytesIO(self._safe_read(self._blp_lengths[0]))
         while True:
@@ -327,7 +332,7 @@ def _read_bgra(self, palette):
             except struct.error:
                 break
             b, g, r, a = palette[offset]
-            d = (r, g, b)
+            d: tuple[int, ...] = (r, g, b)
             if self._blp_alpha_depth:
                 d += (a,)
             data.extend(d)
@@ -431,7 +436,7 @@ def _write_palette(self) -> bytes:
             data += b"\x00" * 4
         return data
 
-    def encode(self, bufsize):
+    def encode(self, bufsize: int) -> tuple[int, int, bytes]:
         palette_data = self._write_palette()
 
         offset = 20 + 16 * 4 * 2 + len(palette_data)
@@ -449,7 +454,7 @@ def encode(self, bufsize):
         return len(data), 0, data
 
 
-def _save(im: Image.Image, fp: IO[bytes], filename: str) -> None:
+def _save(im: Image.Image, fp: IO[bytes], filename: str | bytes) -> None:
     if im.mode != "P":
         msg = "Unsupported BLP image mode"
         raise ValueError(msg)
diff --git a/src/PIL/BmpImagePlugin.py b/src/PIL/BmpImagePlugin.py
index 2df1d8d33bd..45c1ea941e8 100644
--- a/src/PIL/BmpImagePlugin.py
+++ b/src/PIL/BmpImagePlugin.py
@@ -395,12 +395,12 @@ def _open(self) -> None:
 }
 
 
-def _dib_save(im: Image.Image, fp: IO[bytes], filename: str) -> None:
+def _dib_save(im: Image.Image, fp: IO[bytes], filename: str | bytes) -> None:
     _save(im, fp, filename, False)
 
 
 def _save(
-    im: Image.Image, fp: IO[bytes], filename: str, bitmap_header: bool = True
+    im: Image.Image, fp: IO[bytes], filename: str | bytes, bitmap_header: bool = True
 ) -> None:
     try:
         rawmode, bits, colors = SAVE[im.mode]
diff --git a/src/PIL/BufrStubImagePlugin.py b/src/PIL/BufrStubImagePlugin.py
index 7388a2b8a3a..0ee2f653b2c 100644
--- a/src/PIL/BufrStubImagePlugin.py
+++ b/src/PIL/BufrStubImagePlugin.py
@@ -60,7 +60,7 @@ def _load(self) -> ImageFile.StubHandler | None:
         return _handler
 
 
-def _save(im: Image.Image, fp: IO[bytes], filename: str) -> None:
+def _save(im: Image.Image, fp: IO[bytes], filename: str | bytes) -> None:
     if _handler is None or not hasattr(_handler, "save"):
         msg = "BUFR save handler not installed"
         raise OSError(msg)
diff --git a/src/PIL/DdsImagePlugin.py b/src/PIL/DdsImagePlugin.py
index a3efadb030d..861a1eca0cc 100644
--- a/src/PIL/DdsImagePlugin.py
+++ b/src/PIL/DdsImagePlugin.py
@@ -511,7 +511,7 @@ def decode(self, buffer):
         return -1, 0
 
 
-def _save(im: Image.Image, fp: IO[bytes], filename: str) -> None:
+def _save(im: Image.Image, fp: IO[bytes], filename: str | bytes) -> None:
     if im.mode not in ("RGB", "RGBA", "L", "LA"):
         msg = f"cannot write mode {im.mode} as DDS"
         raise OSError(msg)
diff --git a/src/PIL/GifImagePlugin.py b/src/PIL/GifImagePlugin.py
index f41bc2b321d..a540595b85b 100644
--- a/src/PIL/GifImagePlugin.py
+++ b/src/PIL/GifImagePlugin.py
@@ -715,12 +715,12 @@ def _write_multiple_frames(im, fp, palette):
     return True
 
 
-def _save_all(im: Image.Image, fp: IO[bytes], filename: str) -> None:
+def _save_all(im: Image.Image, fp: IO[bytes], filename: str | bytes) -> None:
     _save(im, fp, filename, save_all=True)
 
 
 def _save(
-    im: Image.Image, fp: IO[bytes], filename: str, save_all: bool = False
+    im: Image.Image, fp: IO[bytes], filename: str | bytes, save_all: bool = False
 ) -> None:
     # header
     if "palette" in im.encoderinfo or "palette" in im.info:
@@ -796,7 +796,7 @@ def _write_local_header(fp, im, offset, flags):
     fp.write(o8(8))  # bits
 
 
-def _save_netpbm(im: Image.Image, fp: IO[bytes], filename: str) -> None:
+def _save_netpbm(im: Image.Image, fp: IO[bytes], filename: str | bytes) -> None:
     # Unused by default.
     # To use, uncomment the register_save call at the end of the file.
     #
diff --git a/src/PIL/GribStubImagePlugin.py b/src/PIL/GribStubImagePlugin.py
index d3655f4ddc0..e9aa084b281 100644
--- a/src/PIL/GribStubImagePlugin.py
+++ b/src/PIL/GribStubImagePlugin.py
@@ -60,7 +60,7 @@ def _load(self) -> ImageFile.StubHandler | None:
         return _handler
 
 
-def _save(im: Image.Image, fp: IO[bytes], filename: str) -> None:
+def _save(im: Image.Image, fp: IO[bytes], filename: str | bytes) -> None:
     if _handler is None or not hasattr(_handler, "save"):
         msg = "GRIB save handler not installed"
         raise OSError(msg)
diff --git a/src/PIL/Hdf5StubImagePlugin.py b/src/PIL/Hdf5StubImagePlugin.py
index b789c215fee..cc9e73deb80 100644
--- a/src/PIL/Hdf5StubImagePlugin.py
+++ b/src/PIL/Hdf5StubImagePlugin.py
@@ -60,7 +60,7 @@ def _load(self) -> ImageFile.StubHandler | None:
         return _handler
 
 
-def _save(im: Image.Image, fp: IO[bytes], filename: str) -> None:
+def _save(im: Image.Image, fp: IO[bytes], filename: str | bytes) -> None:
     if _handler is None or not hasattr(_handler, "save"):
         msg = "HDF5 save handler not installed"
         raise OSError(msg)
diff --git a/src/PIL/IcnsImagePlugin.py b/src/PIL/IcnsImagePlugin.py
index 0a86ba883f1..2a89d498cbf 100644
--- a/src/PIL/IcnsImagePlugin.py
+++ b/src/PIL/IcnsImagePlugin.py
@@ -22,6 +22,7 @@
 import os
 import struct
 import sys
+from typing import IO
 
 from . import Image, ImageFile, PngImagePlugin, features
 
@@ -312,7 +313,7 @@ def load(self):
         return px
 
 
-def _save(im, fp, filename):
+def _save(im: Image.Image, fp: IO[bytes], filename: str | bytes) -> None:
     """
     Saves the image as a series of PNG files,
     that are then combined into a .icns file.
@@ -346,29 +347,27 @@ def _save(im, fp, filename):
     entries = []
     for type, size in sizes.items():
         stream = size_streams[size]
-        entries.append(
-            {"type": type, "size": HEADERSIZE + len(stream), "stream": stream}
-        )
+        entries.append((type, HEADERSIZE + len(stream), stream))
 
     # Header
     fp.write(MAGIC)
     file_length = HEADERSIZE  # Header
     file_length += HEADERSIZE + 8 * len(entries)  # TOC
-    file_length += sum(entry["size"] for entry in entries)
+    file_length += sum(entry[1] for entry in entries)
     fp.write(struct.pack(">i", file_length))
 
     # TOC
     fp.write(b"TOC ")
     fp.write(struct.pack(">i", HEADERSIZE + len(entries) * HEADERSIZE))
     for entry in entries:
-        fp.write(entry["type"])
-        fp.write(struct.pack(">i", entry["size"]))
+        fp.write(entry[0])
+        fp.write(struct.pack(">i", entry[1]))
 
     # Data
     for entry in entries:
-        fp.write(entry["type"])
-        fp.write(struct.pack(">i", entry["size"]))
-        fp.write(entry["stream"])
+        fp.write(entry[0])
+        fp.write(struct.pack(">i", entry[1]))
+        fp.write(entry[2])
 
     if hasattr(fp, "flush"):
         fp.flush()
diff --git a/src/PIL/IcoImagePlugin.py b/src/PIL/IcoImagePlugin.py
index af94e5a2e7f..227fcf35cbb 100644
--- a/src/PIL/IcoImagePlugin.py
+++ b/src/PIL/IcoImagePlugin.py
@@ -40,7 +40,7 @@
 _MAGIC = b"\0\0\1\0"
 
 
-def _save(im: Image.Image, fp: IO[bytes], filename: str) -> None:
+def _save(im: Image.Image, fp: IO[bytes], filename: str | bytes) -> None:
     fp.write(_MAGIC)  # (2+2)
     bmp = im.encoderinfo.get("bitmap_format") == "bmp"
     sizes = im.encoderinfo.get(
diff --git a/src/PIL/ImImagePlugin.py b/src/PIL/ImImagePlugin.py
index c98cfb0984b..015c2febea8 100644
--- a/src/PIL/ImImagePlugin.py
+++ b/src/PIL/ImImagePlugin.py
@@ -326,7 +326,7 @@ def tell(self) -> int:
 }
 
 
-def _save(im: Image.Image, fp: IO[bytes], filename: str) -> None:
+def _save(im: Image.Image, fp: IO[bytes], filename: str | bytes) -> None:
     try:
         image_type, rawmode = SAVE[im.mode]
     except KeyError as e:
@@ -341,6 +341,8 @@ def _save(im: Image.Image, fp: IO[bytes], filename: str) -> None:
         # or: SyntaxError("not an IM file")
         # 8 characters are used for "Name: " and "\r\n"
         # Keep just the filename, ditch the potentially overlong path
+        if isinstance(filename, bytes):
+            filename = filename.decode("ascii")
         name, ext = os.path.splitext(os.path.basename(filename))
         name = "".join([name[: 92 - len(ext)], ext])
 
diff --git a/src/PIL/Image.py b/src/PIL/Image.py
index f6ffac8a77f..af174861019 100644
--- a/src/PIL/Image.py
+++ b/src/PIL/Image.py
@@ -626,7 +626,7 @@ def _ensure_mutable(self) -> None:
             self.load()
 
     def _dump(
-        self, file: str | None = None, format: str | None = None, **options
+        self, file: str | None = None, format: str | None = None, **options: Any
     ) -> str:
         suffix = ""
         if format:
@@ -649,10 +649,12 @@ def _dump(
 
         return filename
 
-    def __eq__(self, other):
+    def __eq__(self, other: object) -> bool:
+        if self.__class__ is not other.__class__:
+            return False
+        assert isinstance(other, Image)
         return (
-            self.__class__ is other.__class__
-            and self.mode == other.mode
+            self.mode == other.mode
             and self.size == other.size
             and self.info == other.info
             and self.getpalette() == other.getpalette()
@@ -2965,7 +2967,7 @@ def transform(
 # Debugging
 
 
-def _wedge():
+def _wedge() -> Image:
     """Create grayscale wedge (for debugging only)"""
 
     return Image()._new(core.wedge("L"))
@@ -3566,7 +3568,9 @@ def register_mime(id: str, mimetype: str) -> None:
     MIME[id.upper()] = mimetype
 
 
-def register_save(id: str, driver) -> None:
+def register_save(
+    id: str, driver: Callable[[Image, IO[bytes], str | bytes], None]
+) -> None:
     """
     Registers an image save function.  This function should not be
     used in application code.
@@ -3577,7 +3581,9 @@ def register_save(id: str, driver) -> None:
     SAVE[id.upper()] = driver
 
 
-def register_save_all(id: str, driver) -> None:
+def register_save_all(
+    id: str, driver: Callable[[Image, IO[bytes], str | bytes], None]
+) -> None:
     """
     Registers an image function to save all the frames
     of a multiframe format.  This function should not be
@@ -3651,7 +3657,7 @@ def register_encoder(name: str, encoder: type[ImageFile.PyEncoder]) -> None:
 # Simple display support.
 
 
-def _show(image, **options) -> None:
+def _show(image: Image, **options: Any) -> None:
     from . import ImageShow
 
     ImageShow.show(image, **options)
@@ -3661,7 +3667,9 @@ def _show(image, **options) -> None:
 # Effects
 
 
-def effect_mandelbrot(size, extent, quality):
+def effect_mandelbrot(
+    size: tuple[int, int], extent: tuple[int, int, int, int], quality: int
+) -> Image:
     """
     Generate a Mandelbrot set covering the given extent.
 
diff --git a/src/PIL/ImageDraw.py b/src/PIL/ImageDraw.py
index 73ed3d4a9a6..01f99c11984 100644
--- a/src/PIL/ImageDraw.py
+++ b/src/PIL/ImageDraw.py
@@ -219,7 +219,9 @@ def line(self, xy: Coords, fill=None, width=0, joint=None) -> None:
                         # This is a straight line, so no joint is required
                         continue
 
-                    def coord_at_angle(coord, angle):
+                    def coord_at_angle(
+                        coord: Sequence[float], angle: float
+                    ) -> tuple[float, float]:
                         x, y = coord
                         angle -= 90
                         distance = width / 2 - 1
@@ -1109,11 +1111,13 @@ def _get_angles(n_sides: int, rotation: float) -> list[float]:
     return [_compute_polygon_vertex(angle) for angle in angles]
 
 
-def _color_diff(color1, color2: float | tuple[int, ...]) -> float:
+def _color_diff(
+    color1: float | tuple[int, ...], color2: float | tuple[int, ...]
+) -> float:
     """
     Uses 1-norm distance to calculate difference between two values.
     """
-    if isinstance(color2, tuple):
-        return sum(abs(color1[i] - color2[i]) for i in range(0, len(color2)))
-    else:
-        return abs(color1 - color2)
+    first = color1 if isinstance(color1, tuple) else (color1,)
+    second = color2 if isinstance(color2, tuple) else (color2,)
+
+    return sum(abs(first[i] - second[i]) for i in range(0, len(second)))
diff --git a/src/PIL/ImageFile.py b/src/PIL/ImageFile.py
index f0e49238760..6bef681e979 100644
--- a/src/PIL/ImageFile.py
+++ b/src/PIL/ImageFile.py
@@ -763,7 +763,7 @@ class PyEncoder(PyCodec):
     def pushes_fd(self):
         return self._pushes_fd
 
-    def encode(self, bufsize):
+    def encode(self, bufsize: int) -> tuple[int, int, bytes]:
         """
         Override to perform the encoding process.
 
diff --git a/src/PIL/Jpeg2KImagePlugin.py b/src/PIL/Jpeg2KImagePlugin.py
index 5a0ef0d01a3..72c2cb85e3c 100644
--- a/src/PIL/Jpeg2KImagePlugin.py
+++ b/src/PIL/Jpeg2KImagePlugin.py
@@ -329,11 +329,13 @@ def _accept(prefix: bytes) -> bool:
 # Save support
 
 
-def _save(im: Image.Image, fp: IO[bytes], filename: str) -> None:
+def _save(im: Image.Image, fp: IO[bytes], filename: str | bytes) -> None:
     # Get the keyword arguments
     info = im.encoderinfo
 
-    if filename.endswith(".j2k") or info.get("no_jp2", False):
+    if isinstance(filename, str):
+        filename = filename.encode()
+    if filename.endswith(b".j2k") or info.get("no_jp2", False):
         kind = "j2k"
     else:
         kind = "jp2"
diff --git a/src/PIL/JpegImagePlugin.py b/src/PIL/JpegImagePlugin.py
index 4d0b75e77ed..0c8a678887e 100644
--- a/src/PIL/JpegImagePlugin.py
+++ b/src/PIL/JpegImagePlugin.py
@@ -42,7 +42,7 @@
 import sys
 import tempfile
 import warnings
-from typing import Any
+from typing import IO, Any
 
 from . import Image, ImageFile
 from ._binary import i16be as i16
@@ -644,7 +644,7 @@ def get_sampling(im):
     return samplings.get(sampling, -1)
 
 
-def _save(im, fp, filename):
+def _save(im: Image.Image, fp: IO[bytes], filename: str | bytes) -> None:
     if im.width == 0 or im.height == 0:
         msg = "cannot write empty image as JPEG"
         raise ValueError(msg)
@@ -827,7 +827,7 @@ def validate_qtables(qtables):
     ImageFile._save(im, fp, [("jpeg", (0, 0) + im.size, 0, rawmode)], bufsize)
 
 
-def _save_cjpeg(im, fp, filename):
+def _save_cjpeg(im: Image.Image, fp: IO[bytes], filename: str | bytes) -> None:
     # ALTERNATIVE: handle JPEGs via the IJG command line utilities.
     tempfile = im._dump()
     subprocess.check_call(["cjpeg", "-outfile", filename, tempfile])
diff --git a/src/PIL/MpoImagePlugin.py b/src/PIL/MpoImagePlugin.py
index 6716722f204..152e19e2365 100644
--- a/src/PIL/MpoImagePlugin.py
+++ b/src/PIL/MpoImagePlugin.py
@@ -33,7 +33,7 @@
 from ._binary import o32le
 
 
-def _save(im: Image.Image, fp: IO[bytes], filename: str) -> None:
+def _save(im: Image.Image, fp: IO[bytes], filename: str | bytes) -> None:
     JpegImagePlugin._save(im, fp, filename)
 
 
diff --git a/src/PIL/MspImagePlugin.py b/src/PIL/MspImagePlugin.py
index 65cc70624b7..0a75c868b97 100644
--- a/src/PIL/MspImagePlugin.py
+++ b/src/PIL/MspImagePlugin.py
@@ -164,7 +164,7 @@ def decode(self, buffer: bytes) -> tuple[int, int]:
 # write MSP files (uncompressed only)
 
 
-def _save(im: Image.Image, fp: IO[bytes], filename: str) -> None:
+def _save(im: Image.Image, fp: IO[bytes], filename: str | bytes) -> None:
     if im.mode != "1":
         msg = f"cannot write mode {im.mode} as MSP"
         raise OSError(msg)
diff --git a/src/PIL/PcxImagePlugin.py b/src/PIL/PcxImagePlugin.py
index 026bfd9a01b..dd42003b5a3 100644
--- a/src/PIL/PcxImagePlugin.py
+++ b/src/PIL/PcxImagePlugin.py
@@ -144,7 +144,7 @@ def _open(self) -> None:
 }
 
 
-def _save(im: Image.Image, fp: IO[bytes], filename: str) -> None:
+def _save(im: Image.Image, fp: IO[bytes], filename: str | bytes) -> None:
     try:
         version, bits, planes, rawmode = SAVE[im.mode]
     except KeyError as e:
diff --git a/src/PIL/PdfImagePlugin.py b/src/PIL/PdfImagePlugin.py
index ccd28f3434b..f0da1e04797 100644
--- a/src/PIL/PdfImagePlugin.py
+++ b/src/PIL/PdfImagePlugin.py
@@ -40,7 +40,7 @@
 #  5. page contents
 
 
-def _save_all(im: Image.Image, fp: IO[bytes], filename: str) -> None:
+def _save_all(im: Image.Image, fp: IO[bytes], filename: str | bytes) -> None:
     _save(im, fp, filename, save_all=True)
 
 
diff --git a/src/PIL/PdfParser.py b/src/PIL/PdfParser.py
index a6c24e67179..52e8358017a 100644
--- a/src/PIL/PdfParser.py
+++ b/src/PIL/PdfParser.py
@@ -76,7 +76,7 @@ class PdfFormatError(RuntimeError):
     pass
 
 
-def check_format_condition(condition, error_message):
+def check_format_condition(condition: bool, error_message: str) -> None:
     if not condition:
         raise PdfFormatError(error_message)
 
@@ -93,12 +93,11 @@ def __str__(self) -> str:
     def __bytes__(self) -> bytes:
         return self.__str__().encode("us-ascii")
 
-    def __eq__(self, other):
-        return (
-            other.__class__ is self.__class__
-            and other.object_id == self.object_id
-            and other.generation == self.generation
-        )
+    def __eq__(self, other: object) -> bool:
+        if self.__class__ is not other.__class__:
+            return False
+        assert isinstance(other, IndirectReference)
+        return other.object_id == self.object_id and other.generation == self.generation
 
     def __ne__(self, other):
         return not (self == other)
diff --git a/src/PIL/PngImagePlugin.py b/src/PIL/PngImagePlugin.py
index 76ffdef3f55..9aaadb47d5e 100644
--- a/src/PIL/PngImagePlugin.py
+++ b/src/PIL/PngImagePlugin.py
@@ -1234,7 +1234,7 @@ def _write_multiple_frames(im, fp, chunk, rawmode, default_image, append_images)
             seq_num = fdat_chunks.seq_num
 
 
-def _save_all(im: Image.Image, fp: IO[bytes], filename: str) -> None:
+def _save_all(im: Image.Image, fp: IO[bytes], filename: str | bytes) -> None:
     _save(im, fp, filename, save_all=True)
 
 
diff --git a/src/PIL/PpmImagePlugin.py b/src/PIL/PpmImagePlugin.py
index 94bf430b825..16c9ccbba72 100644
--- a/src/PIL/PpmImagePlugin.py
+++ b/src/PIL/PpmImagePlugin.py
@@ -328,7 +328,7 @@ def decode(self, buffer: bytes) -> tuple[int, int]:
 # --------------------------------------------------------------------
 
 
-def _save(im: Image.Image, fp: IO[bytes], filename: str) -> None:
+def _save(im: Image.Image, fp: IO[bytes], filename: str | bytes) -> None:
     if im.mode == "1":
         rawmode, head = "1;I", b"P4"
     elif im.mode == "L":
diff --git a/src/PIL/QoiImagePlugin.py b/src/PIL/QoiImagePlugin.py
index f2cf06d0dd7..202ef52d09b 100644
--- a/src/PIL/QoiImagePlugin.py
+++ b/src/PIL/QoiImagePlugin.py
@@ -37,6 +37,8 @@ def _open(self) -> None:
 
 class QoiDecoder(ImageFile.PyDecoder):
     _pulls_fd = True
+    _previous_pixel: bytes | bytearray | None = None
+    _previously_seen_pixels: dict[int, bytes | bytearray] = {}
 
     def _add_to_previous_pixels(self, value: bytes | bytearray) -> None:
         self._previous_pixel = value
@@ -45,9 +47,10 @@ def _add_to_previous_pixels(self, value: bytes | bytearray) -> None:
         hash_value = (r * 3 + g * 5 + b * 7 + a * 11) % 64
         self._previously_seen_pixels[hash_value] = value
 
-    def decode(self, buffer):
+    def decode(self, buffer: bytes) -> tuple[int, int]:
+        assert self.fd is not None
+
         self._previously_seen_pixels = {}
-        self._previous_pixel = None
         self._add_to_previous_pixels(bytearray((0, 0, 0, 255)))
 
         data = bytearray()
@@ -55,7 +58,8 @@ def decode(self, buffer):
         dest_length = self.state.xsize * self.state.ysize * bands
         while len(data) < dest_length:
             byte = self.fd.read(1)[0]
-            if byte == 0b11111110:  # QOI_OP_RGB
+            value: bytes | bytearray
+            if byte == 0b11111110 and self._previous_pixel:  # QOI_OP_RGB
                 value = bytearray(self.fd.read(3)) + self._previous_pixel[3:]
             elif byte == 0b11111111:  # QOI_OP_RGBA
                 value = self.fd.read(4)
@@ -66,7 +70,7 @@ def decode(self, buffer):
                     value = self._previously_seen_pixels.get(
                         op_index, bytearray((0, 0, 0, 0))
                     )
-                elif op == 1:  # QOI_OP_DIFF
+                elif op == 1 and self._previous_pixel:  # QOI_OP_DIFF
                     value = bytearray(
                         (
                             (self._previous_pixel[0] + ((byte & 0b00110000) >> 4) - 2)
@@ -77,7 +81,7 @@ def decode(self, buffer):
                             self._previous_pixel[3],
                         )
                     )
-                elif op == 2:  # QOI_OP_LUMA
+                elif op == 2 and self._previous_pixel:  # QOI_OP_LUMA
                     second_byte = self.fd.read(1)[0]
                     diff_green = (byte & 0b00111111) - 32
                     diff_red = ((second_byte & 0b11110000) >> 4) - 8
@@ -90,7 +94,7 @@ def decode(self, buffer):
                         )
                     )
                     value += self._previous_pixel[3:]
-                elif op == 3:  # QOI_OP_RUN
+                elif op == 3 and self._previous_pixel:  # QOI_OP_RUN
                     run_length = (byte & 0b00111111) + 1
                     value = self._previous_pixel
                     if bands == 3:
diff --git a/src/PIL/SgiImagePlugin.py b/src/PIL/SgiImagePlugin.py
index 7bd84ebd491..50d97910932 100644
--- a/src/PIL/SgiImagePlugin.py
+++ b/src/PIL/SgiImagePlugin.py
@@ -125,7 +125,7 @@ def _open(self) -> None:
             ]
 
 
-def _save(im: Image.Image, fp: IO[bytes], filename: str) -> None:
+def _save(im: Image.Image, fp: IO[bytes], filename: str | bytes) -> None:
     if im.mode not in {"RGB", "RGBA", "L"}:
         msg = "Unsupported SGI image mode"
         raise ValueError(msg)
@@ -171,8 +171,9 @@ def _save(im: Image.Image, fp: IO[bytes], filename: str) -> None:
     # Maximum Byte value (255 = 8bits per pixel)
     pinmax = 255
     # Image name (79 characters max, truncated below in write)
-    filename = os.path.basename(filename)
-    img_name = os.path.splitext(filename)[0].encode("ascii", "ignore")
+    img_name = os.path.splitext(os.path.basename(filename))[0]
+    if isinstance(img_name, str):
+        img_name = img_name.encode("ascii", "ignore")
     # Standard representation of pixel in the file
     colormap = 0
     fp.write(struct.pack(">h", magic_number))
diff --git a/src/PIL/SpiderImagePlugin.py b/src/PIL/SpiderImagePlugin.py
index 98dd91c0e24..a6cc00019da 100644
--- a/src/PIL/SpiderImagePlugin.py
+++ b/src/PIL/SpiderImagePlugin.py
@@ -263,7 +263,7 @@ def makeSpiderHeader(im: Image.Image) -> list[bytes]:
     return [struct.pack("f", v) for v in hdr]
 
 
-def _save(im: Image.Image, fp: IO[bytes], filename: str) -> None:
+def _save(im: Image.Image, fp: IO[bytes], filename: str | bytes) -> None:
     if im.mode[0] != "F":
         im = im.convert("F")
 
@@ -279,9 +279,10 @@ def _save(im: Image.Image, fp: IO[bytes], filename: str) -> None:
     ImageFile._save(im, fp, [("raw", (0, 0) + im.size, 0, (rawmode, 0, 1))])
 
 
-def _save_spider(im: Image.Image, fp: IO[bytes], filename: str) -> None:
+def _save_spider(im: Image.Image, fp: IO[bytes], filename: str | bytes) -> None:
     # get the filename extension and register it with Image
-    ext = os.path.splitext(filename)[1]
+    filename_ext = os.path.splitext(filename)[1]
+    ext = filename_ext.decode() if isinstance(filename_ext, bytes) else filename_ext
     Image.register_extension(SpiderImageFile.format, ext)
     _save(im, fp, filename)
 
diff --git a/src/PIL/TgaImagePlugin.py b/src/PIL/TgaImagePlugin.py
index 401a83f9fba..f16f075df05 100644
--- a/src/PIL/TgaImagePlugin.py
+++ b/src/PIL/TgaImagePlugin.py
@@ -178,7 +178,7 @@ def load_end(self) -> None:
 }
 
 
-def _save(im: Image.Image, fp: IO[bytes], filename: str) -> None:
+def _save(im: Image.Image, fp: IO[bytes], filename: str | bytes) -> None:
     try:
         rawmode, bits, colormaptype, imagetype = SAVE[im.mode]
     except KeyError as e:
diff --git a/src/PIL/TiffImagePlugin.py b/src/PIL/TiffImagePlugin.py
index 0b96017552a..08ee506b162 100644
--- a/src/PIL/TiffImagePlugin.py
+++ b/src/PIL/TiffImagePlugin.py
@@ -387,7 +387,7 @@ def __repr__(self) -> str:
     def __hash__(self):
         return self._val.__hash__()
 
-    def __eq__(self, other):
+    def __eq__(self, other: object) -> bool:
         val = self._val
         if isinstance(other, IFDRational):
             other = other._val
@@ -2149,7 +2149,7 @@ def fixOffsets(self, count, isShort=False, isLong=False):
                 self.rewriteLastLong(offset)
 
 
-def _save_all(im: Image.Image, fp: IO[bytes], filename: str) -> None:
+def _save_all(im: Image.Image, fp: IO[bytes], filename: str | bytes) -> None:
     encoderinfo = im.encoderinfo.copy()
     encoderconfig = im.encoderconfig
     append_images = list(encoderinfo.get("append_images", []))
diff --git a/src/PIL/WebPImagePlugin.py b/src/PIL/WebPImagePlugin.py
index 463d6a62398..97debc2edc9 100644
--- a/src/PIL/WebPImagePlugin.py
+++ b/src/PIL/WebPImagePlugin.py
@@ -1,7 +1,7 @@
 from __future__ import annotations
 
 from io import BytesIO
-from typing import Any
+from typing import IO, Any
 
 from . import Image, ImageFile
 
@@ -182,7 +182,7 @@ def tell(self) -> int:
         return self.__logical_frame
 
 
-def _save_all(im, fp, filename):
+def _save_all(im: Image.Image, fp: IO[bytes], filename: str | bytes) -> None:
     encoderinfo = im.encoderinfo.copy()
     append_images = list(encoderinfo.get("append_images", []))
 
@@ -195,7 +195,7 @@ def _save_all(im, fp, filename):
         _save(im, fp, filename)
         return
 
-    background = (0, 0, 0, 0)
+    background: int | tuple[int, ...] = (0, 0, 0, 0)
     if "background" in encoderinfo:
         background = encoderinfo["background"]
     elif "background" in im.info:
@@ -325,7 +325,7 @@ def _save_all(im, fp, filename):
     fp.write(data)
 
 
-def _save(im, fp, filename):
+def _save(im: Image.Image, fp: IO[bytes], filename: str | bytes) -> None:
     lossless = im.encoderinfo.get("lossless", False)
     quality = im.encoderinfo.get("quality", 80)
     alpha_quality = im.encoderinfo.get("alpha_quality", 100)
diff --git a/src/PIL/WmfImagePlugin.py b/src/PIL/WmfImagePlugin.py
index a68f705a03c..3d5cddcc8f5 100644
--- a/src/PIL/WmfImagePlugin.py
+++ b/src/PIL/WmfImagePlugin.py
@@ -163,7 +163,7 @@ def load(self, dpi=None):
         return super().load()
 
 
-def _save(im: Image.Image, fp: IO[bytes], filename: str) -> None:
+def _save(im: Image.Image, fp: IO[bytes], filename: str | bytes) -> None:
     if _handler is None or not hasattr(_handler, "save"):
         msg = "WMF save handler not installed"
         raise OSError(msg)
diff --git a/src/PIL/XbmImagePlugin.py b/src/PIL/XbmImagePlugin.py
index eee7274361c..6d11bbfcf6b 100644
--- a/src/PIL/XbmImagePlugin.py
+++ b/src/PIL/XbmImagePlugin.py
@@ -70,7 +70,7 @@ def _open(self) -> None:
         self.tile = [("xbm", (0, 0) + self.size, m.end(), None)]
 
 
-def _save(im: Image.Image, fp: IO[bytes], filename: str) -> None:
+def _save(im: Image.Image, fp: IO[bytes], filename: str | bytes) -> None:
     if im.mode != "1":
         msg = f"cannot write mode {im.mode} as XBM"
         raise OSError(msg)

From 9f831317fe98633214ad0266417d349b44e5d6bf Mon Sep 17 00:00:00 2001
From: Andrew Murray <3112309+radarhere@users.noreply.github.com>
Date: Mon, 10 Jun 2024 16:47:18 +1000
Subject: [PATCH 0690/1178] Updated text

Co-authored-by: Hugo van Kemenade <1324225+hugovk@users.noreply.github.com>
---
 docs/deprecations.rst        | 6 +++---
 docs/releasenotes/10.4.0.rst | 6 +++---
 2 files changed, 6 insertions(+), 6 deletions(-)

diff --git a/docs/deprecations.rst b/docs/deprecations.rst
index 8a03d858c71..627672e1f3b 100644
--- a/docs/deprecations.rst
+++ b/docs/deprecations.rst
@@ -115,12 +115,12 @@ Support for LibTIFF earlier than 4
 Support for LibTIFF earlier than version 4 has been deprecated.
 Upgrade to a newer version of LibTIFF instead.
 
-ImageDraw.getdraw hints argument
-^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
+ImageDraw.getdraw hints parameter
+^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
 
 .. deprecated:: 10.4.0
 
-The ``hints`` argument in :py:meth:`~PIL.ImageDraw.getdraw()` has been deprecated.
+The ``hints`` parameter in :py:meth:`~PIL.ImageDraw.getdraw()` has been deprecated.
 
 Removed features
 ----------------
diff --git a/docs/releasenotes/10.4.0.rst b/docs/releasenotes/10.4.0.rst
index 8c49e0842c5..44727efd41f 100644
--- a/docs/releasenotes/10.4.0.rst
+++ b/docs/releasenotes/10.4.0.rst
@@ -34,10 +34,10 @@ Support for LibTIFF earlier than 4
 Support for LibTIFF earlier than version 4 has been deprecated.
 Upgrade to a newer version of LibTIFF instead.
 
-ImageDraw.getdraw hints argument
-^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
+ImageDraw.getdraw hints parameter
+^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
 
-The ``hints`` argument in :py:meth:`~PIL.ImageDraw.getdraw()` has been deprecated.
+The ``hints`` parameter in :py:meth:`~PIL.ImageDraw.getdraw()` has been deprecated.
 
 API Changes
 ===========

From 4679e4bf9e542ffae8c81e68603d5c944108389f Mon Sep 17 00:00:00 2001
From: Andrew Murray <3112309+radarhere@users.noreply.github.com>
Date: Mon, 10 Jun 2024 16:47:52 +1000
Subject: [PATCH 0691/1178] Updated deprecation warning

---
 src/PIL/ImageDraw.py | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/src/PIL/ImageDraw.py b/src/PIL/ImageDraw.py
index ec15b535fbe..23d7e6973b4 100644
--- a/src/PIL/ImageDraw.py
+++ b/src/PIL/ImageDraw.py
@@ -908,7 +908,7 @@ def getdraw(im=None, hints=None):
     :returns: A (drawing context, drawing resource factory) tuple.
     """
     if hints is not None:
-        deprecate("'hints' argument", 12)
+        deprecate("'hints' parameter", 12)
     from . import ImageDraw2
 
     if im:

From 8e8ee1e4c4b8037c9b755e2ba26a7297dfa5d6ac Mon Sep 17 00:00:00 2001
From: Andrew Murray <radarhere@users.noreply.github.com>
Date: Mon, 10 Jun 2024 17:38:17 +1000
Subject: [PATCH 0692/1178] Accept 't' suffix for libtiff version

---
 Tests/test_features.py | 4 +++-
 1 file changed, 3 insertions(+), 1 deletion(-)

diff --git a/Tests/test_features.py b/Tests/test_features.py
index de418115ee0..b7eefa09ae1 100644
--- a/Tests/test_features.py
+++ b/Tests/test_features.py
@@ -38,7 +38,9 @@ def test(name: str, function: Callable[[str], str | None]) -> None:
             assert function(name) == version
             if name != "PIL":
                 if name == "zlib" and version is not None:
-                    version = version.replace(".zlib-ng", "")
+                    version = re.sub(".zlib-ng$", "", version)
+                elif name == "libtiff" and version is not None:
+                    version = re.sub("t$", "", version)
                 assert version is None or re.search(r"\d+(\.\d+)*$", version)
 
     for module in features.modules:

From b84c970fbf3f08825cabf9c5a132e20f868907f1 Mon Sep 17 00:00:00 2001
From: Andrew Murray <radarhere@users.noreply.github.com>
Date: Mon, 10 Jun 2024 19:19:06 +1000
Subject: [PATCH 0693/1178] Wait until all markers are read to process EXIF

---
 Tests/images/multiple_exif.jpg | Bin 364 -> 391 bytes
 Tests/test_file_jpeg.py        |   2 +-
 src/PIL/JpegImagePlugin.py     |  68 +++++++++++++++++----------------
 3 files changed, 37 insertions(+), 33 deletions(-)

diff --git a/Tests/images/multiple_exif.jpg b/Tests/images/multiple_exif.jpg
index 32e0aa301a94dfa13dc47faeb3071c25a5d8b573..f9f343507e73c5fe2df844deaa5d025f5cd013ec 100644
GIT binary patch
delta 66
zcmaFE)XqFX++5wYA~TJF!Pl2Ti-CcGgMpEekAVru;sIhQAZAF*EGjPf|B!(nqOdqM
NIX^FjVWY7nBLK0l4od(4

delta 39
qcmZo?e#10DT!z=RA~TJFAuY40xa9vs20jS4I5jyxFJ+^jB_jX@Ck-qB

diff --git a/Tests/test_file_jpeg.py b/Tests/test_file_jpeg.py
index 18dc752d8bd..342c9e47bd4 100644
--- a/Tests/test_file_jpeg.py
+++ b/Tests/test_file_jpeg.py
@@ -870,7 +870,7 @@ def test_ifd_offset_exif(self) -> None:
 
     def test_multiple_exif(self) -> None:
         with Image.open("Tests/images/multiple_exif.jpg") as im:
-            assert im.info["exif"] == b"Exif\x00\x00firstsecond"
+            assert im.getexif()[270] == "firstsecond"
 
     @mark_if_feature_version(
         pytest.mark.valgrind_known_error, "libjpeg_turbo", "2.0", reason="Known Failing"
diff --git a/src/PIL/JpegImagePlugin.py b/src/PIL/JpegImagePlugin.py
index 4d0b75e77ed..a9a89e58bd7 100644
--- a/src/PIL/JpegImagePlugin.py
+++ b/src/PIL/JpegImagePlugin.py
@@ -159,38 +159,6 @@ def APP(self, marker):
         # plus constant header size
         self.info["mpoffset"] = self.fp.tell() - n + 4
 
-    # If DPI isn't in JPEG header, fetch from EXIF
-    if "dpi" not in self.info and "exif" in self.info:
-        try:
-            exif = self.getexif()
-            resolution_unit = exif[0x0128]
-            x_resolution = exif[0x011A]
-            try:
-                dpi = float(x_resolution[0]) / x_resolution[1]
-            except TypeError:
-                dpi = x_resolution
-            if math.isnan(dpi):
-                msg = "DPI is not a number"
-                raise ValueError(msg)
-            if resolution_unit == 3:  # cm
-                # 1 dpcm = 2.54 dpi
-                dpi *= 2.54
-            self.info["dpi"] = dpi, dpi
-        except (
-            struct.error,
-            KeyError,
-            SyntaxError,
-            TypeError,
-            ValueError,
-            ZeroDivisionError,
-        ):
-            # struct.error for truncated EXIF
-            # KeyError for dpi not included
-            # SyntaxError for invalid/unreadable EXIF
-            # ValueError or TypeError for dpi being an invalid float
-            # ZeroDivisionError for invalid dpi rational value
-            self.info["dpi"] = 72, 72
-
 
 def COM(self: JpegImageFile, marker: int) -> None:
     #
@@ -409,6 +377,8 @@ def _open(self):
                 msg = "no marker found"
                 raise SyntaxError(msg)
 
+        self._read_dpi_from_exif()
+
     def load_read(self, read_bytes: int) -> bytes:
         """
         internal: read more image data
@@ -497,6 +467,40 @@ def load_djpeg(self) -> None:
     def _getexif(self) -> dict[str, Any] | None:
         return _getexif(self)
 
+    def _read_dpi_from_exif(self) -> None:
+        # If DPI isn't in JPEG header, fetch from EXIF
+        if "dpi" in self.info or "exif" not in self.info:
+            return
+        try:
+            exif = self.getexif()
+            resolution_unit = exif[0x0128]
+            x_resolution = exif[0x011A]
+            try:
+                dpi = float(x_resolution[0]) / x_resolution[1]
+            except TypeError:
+                dpi = x_resolution
+            if math.isnan(dpi):
+                msg = "DPI is not a number"
+                raise ValueError(msg)
+            if resolution_unit == 3:  # cm
+                # 1 dpcm = 2.54 dpi
+                dpi *= 2.54
+            self.info["dpi"] = dpi, dpi
+        except (
+            struct.error,
+            KeyError,
+            SyntaxError,
+            TypeError,
+            ValueError,
+            ZeroDivisionError,
+        ):
+            # struct.error for truncated EXIF
+            # KeyError for dpi not included
+            # SyntaxError for invalid/unreadable EXIF
+            # ValueError or TypeError for dpi being an invalid float
+            # ZeroDivisionError for invalid dpi rational value
+            self.info["dpi"] = 72, 72
+
     def _getmp(self):
         return _getmp(self)
 

From 9afe9d2769d9241385a4fd8f8e2376fbdca74981 Mon Sep 17 00:00:00 2001
From: Andrew Murray <radarhere@users.noreply.github.com>
Date: Mon, 10 Jun 2024 16:08:06 +1000
Subject: [PATCH 0694/1178] Added type hints

---
 Tests/test_file_gif.py    |   9 +-
 src/PIL/GifImagePlugin.py | 206 +++++++++++++++++++++++---------------
 src/PIL/Image.py          |  20 ++--
 src/PIL/ImageOps.py       |   2 +-
 src/PIL/ImagePalette.py   |  13 ++-
 5 files changed, 154 insertions(+), 96 deletions(-)

diff --git a/Tests/test_file_gif.py b/Tests/test_file_gif.py
index 4e790926bfc..e19c88a47c4 100644
--- a/Tests/test_file_gif.py
+++ b/Tests/test_file_gif.py
@@ -53,6 +53,7 @@ def test_closed_file() -> None:
 
 def test_seek_after_close() -> None:
     im = Image.open("Tests/images/iss634.gif")
+    assert isinstance(im, GifImagePlugin.GifImageFile)
     im.load()
     im.close()
 
@@ -377,7 +378,8 @@ def test_save_netpbm_bmp_mode(tmp_path: Path) -> None:
         img = img.convert("RGB")
 
         tempfile = str(tmp_path / "temp.gif")
-        GifImagePlugin._save_netpbm(img, 0, tempfile)
+        b = BytesIO()
+        GifImagePlugin._save_netpbm(img, b, tempfile)
         with Image.open(tempfile) as reloaded:
             assert_image_similar(img, reloaded.convert("RGB"), 0)
 
@@ -388,7 +390,8 @@ def test_save_netpbm_l_mode(tmp_path: Path) -> None:
         img = img.convert("L")
 
         tempfile = str(tmp_path / "temp.gif")
-        GifImagePlugin._save_netpbm(img, 0, tempfile)
+        b = BytesIO()
+        GifImagePlugin._save_netpbm(img, b, tempfile)
         with Image.open(tempfile) as reloaded:
             assert_image_similar(img, reloaded.convert("L"), 0)
 
@@ -648,7 +651,7 @@ def test_dispose2_palette(tmp_path: Path) -> None:
             assert rgb_img.getpixel((50, 50)) == circle
 
             # Check that frame transparency wasn't added unnecessarily
-            assert img._frame_transparency is None
+            assert getattr(img, "_frame_transparency") is None
 
 
 def test_dispose2_diff(tmp_path: Path) -> None:
diff --git a/src/PIL/GifImagePlugin.py b/src/PIL/GifImagePlugin.py
index a540595b85b..a305e8de668 100644
--- a/src/PIL/GifImagePlugin.py
+++ b/src/PIL/GifImagePlugin.py
@@ -29,9 +29,10 @@
 import math
 import os
 import subprocess
+import sys
 from enum import IntEnum
 from functools import cached_property
-from typing import IO
+from typing import IO, TYPE_CHECKING, Any, List, Literal, NamedTuple, Union
 
 from . import (
     Image,
@@ -46,6 +47,9 @@
 from ._binary import o8
 from ._binary import o16le as o16
 
+if TYPE_CHECKING:
+    from . import _imaging
+
 
 class LoadingStrategy(IntEnum):
     """.. versionadded:: 9.1.0"""
@@ -118,7 +122,7 @@ def _open(self) -> None:
         self._seek(0)  # get ready to read first frame
 
     @property
-    def n_frames(self):
+    def n_frames(self) -> int:
         if self._n_frames is None:
             current = self.tell()
             try:
@@ -163,11 +167,11 @@ def seek(self, frame: int) -> None:
                 msg = "no more images in GIF file"
                 raise EOFError(msg) from e
 
-    def _seek(self, frame, update_image=True):
+    def _seek(self, frame: int, update_image: bool = True) -> None:
         if frame == 0:
             # rewind
             self.__offset = 0
-            self.dispose = None
+            self.dispose: _imaging.ImagingCore | None = None
             self.__frame = -1
             self._fp.seek(self.__rewind)
             self.disposal_method = 0
@@ -195,9 +199,9 @@ def _seek(self, frame, update_image=True):
             msg = "no more images in GIF file"
             raise EOFError(msg)
 
-        palette = None
+        palette: ImagePalette.ImagePalette | Literal[False] | None = None
 
-        info = {}
+        info: dict[str, Any] = {}
         frame_transparency = None
         interlace = None
         frame_dispose_extent = None
@@ -213,7 +217,7 @@ def _seek(self, frame, update_image=True):
                 #
                 s = self.fp.read(1)
                 block = self.data()
-                if s[0] == 249:
+                if s[0] == 249 and block is not None:
                     #
                     # graphic control extension
                     #
@@ -249,14 +253,14 @@ def _seek(self, frame, update_image=True):
                         info["comment"] = comment
                     s = None
                     continue
-                elif s[0] == 255 and frame == 0:
+                elif s[0] == 255 and frame == 0 and block is not None:
                     #
                     # application extension
                     #
                     info["extension"] = block, self.fp.tell()
                     if block[:11] == b"NETSCAPE2.0":
                         block = self.data()
-                        if len(block) >= 3 and block[0] == 1:
+                        if block and len(block) >= 3 and block[0] == 1:
                             self.info["loop"] = i16(block, 1)
                 while self.data():
                     pass
@@ -345,51 +349,52 @@ def _rgb(color: int) -> tuple[int, int, int]:
             else:
                 return (color, color, color)
 
+        self.dispose = None
         self.dispose_extent = frame_dispose_extent
-        try:
-            if self.disposal_method < 2:
-                # do not dispose or none specified
-                self.dispose = None
-            elif self.disposal_method == 2:
-                # replace with background colour
-
-                # only dispose the extent in this frame
-                x0, y0, x1, y1 = self.dispose_extent
-                dispose_size = (x1 - x0, y1 - y0)
-
-                Image._decompression_bomb_check(dispose_size)
-
-                # by convention, attempt to use transparency first
-                dispose_mode = "P"
-                color = self.info.get("transparency", frame_transparency)
-                if color is not None:
-                    if self.mode in ("RGB", "RGBA"):
-                        dispose_mode = "RGBA"
-                        color = _rgb(color) + (0,)
-                else:
-                    color = self.info.get("background", 0)
-                    if self.mode in ("RGB", "RGBA"):
-                        dispose_mode = "RGB"
-                        color = _rgb(color)
-                self.dispose = Image.core.fill(dispose_mode, dispose_size, color)
-            else:
-                # replace with previous contents
-                if self.im is not None:
+        if self.dispose_extent and self.disposal_method >= 2:
+            try:
+                if self.disposal_method == 2:
+                    # replace with background colour
+
                     # only dispose the extent in this frame
-                    self.dispose = self._crop(self.im, self.dispose_extent)
-                elif frame_transparency is not None:
                     x0, y0, x1, y1 = self.dispose_extent
                     dispose_size = (x1 - x0, y1 - y0)
 
                     Image._decompression_bomb_check(dispose_size)
+
+                    # by convention, attempt to use transparency first
                     dispose_mode = "P"
-                    color = frame_transparency
-                    if self.mode in ("RGB", "RGBA"):
-                        dispose_mode = "RGBA"
-                        color = _rgb(frame_transparency) + (0,)
+                    color = self.info.get("transparency", frame_transparency)
+                    if color is not None:
+                        if self.mode in ("RGB", "RGBA"):
+                            dispose_mode = "RGBA"
+                            color = _rgb(color) + (0,)
+                    else:
+                        color = self.info.get("background", 0)
+                        if self.mode in ("RGB", "RGBA"):
+                            dispose_mode = "RGB"
+                            color = _rgb(color)
                     self.dispose = Image.core.fill(dispose_mode, dispose_size, color)
-        except AttributeError:
-            pass
+                else:
+                    # replace with previous contents
+                    if self.im is not None:
+                        # only dispose the extent in this frame
+                        self.dispose = self._crop(self.im, self.dispose_extent)
+                    elif frame_transparency is not None:
+                        x0, y0, x1, y1 = self.dispose_extent
+                        dispose_size = (x1 - x0, y1 - y0)
+
+                        Image._decompression_bomb_check(dispose_size)
+                        dispose_mode = "P"
+                        color = frame_transparency
+                        if self.mode in ("RGB", "RGBA"):
+                            dispose_mode = "RGBA"
+                            color = _rgb(frame_transparency) + (0,)
+                        self.dispose = Image.core.fill(
+                            dispose_mode, dispose_size, color
+                        )
+            except AttributeError:
+                pass
 
         if interlace is not None:
             transparency = -1
@@ -498,7 +503,12 @@ def _normalize_mode(im: Image.Image) -> Image.Image:
     return im.convert("L")
 
 
-def _normalize_palette(im, palette, info):
+_Palette = Union[bytes, bytearray, List[int], ImagePalette.ImagePalette]
+
+
+def _normalize_palette(
+    im: Image.Image, palette: _Palette | None, info: dict[str, Any]
+) -> Image.Image:
     """
     Normalizes the palette for image.
       - Sets the palette to the incoming palette, if provided.
@@ -526,8 +536,10 @@ def _normalize_palette(im, palette, info):
             source_palette = bytearray(i // 3 for i in range(768))
         im.palette = ImagePalette.ImagePalette("RGB", palette=source_palette)
 
+    used_palette_colors: list[int] | None
     if palette:
         used_palette_colors = []
+        assert source_palette is not None
         for i in range(0, len(source_palette), 3):
             source_color = tuple(source_palette[i : i + 3])
             index = im.palette.colors.get(source_color)
@@ -561,7 +573,7 @@ def _normalize_palette(im, palette, info):
 def _write_single_frame(
     im: Image.Image,
     fp: IO[bytes],
-    palette: bytes | bytearray | list[int] | ImagePalette.ImagePalette,
+    palette: _Palette | None,
 ) -> None:
     im_out = _normalize_mode(im)
     for k, v in im_out.info.items():
@@ -585,7 +597,7 @@ def _write_single_frame(
 
 def _getbbox(
     base_im: Image.Image, im_frame: Image.Image
-) -> tuple[Image.Image, tuple[int, int, int, int]]:
+) -> tuple[Image.Image, tuple[int, int, int, int] | None]:
     if _get_palette_bytes(im_frame) != _get_palette_bytes(base_im):
         im_frame = im_frame.convert("RGBA")
         base_im = base_im.convert("RGBA")
@@ -593,12 +605,20 @@ def _getbbox(
     return delta, delta.getbbox(alpha_only=False)
 
 
-def _write_multiple_frames(im, fp, palette):
+class _Frame(NamedTuple):
+    im: Image.Image
+    bbox: tuple[int, int, int, int] | None
+    encoderinfo: dict[str, Any]
+
+
+def _write_multiple_frames(
+    im: Image.Image, fp: IO[bytes], palette: _Palette | None
+) -> bool:
     duration = im.encoderinfo.get("duration")
     disposal = im.encoderinfo.get("disposal", im.info.get("disposal"))
 
-    im_frames = []
-    previous_im = None
+    im_frames: list[_Frame] = []
+    previous_im: Image.Image | None = None
     frame_count = 0
     background_im = None
     for imSequence in itertools.chain([im], im.encoderinfo.get("append_images", [])):
@@ -624,24 +644,22 @@ def _write_multiple_frames(im, fp, palette):
             frame_count += 1
 
             diff_frame = None
-            if im_frames:
+            if im_frames and previous_im:
                 # delta frame
                 delta, bbox = _getbbox(previous_im, im_frame)
                 if not bbox:
                     # This frame is identical to the previous frame
                     if encoderinfo.get("duration"):
-                        im_frames[-1]["encoderinfo"]["duration"] += encoderinfo[
-                            "duration"
-                        ]
+                        im_frames[-1].encoderinfo["duration"] += encoderinfo["duration"]
                     continue
-                if im_frames[-1]["encoderinfo"].get("disposal") == 2:
+                if im_frames[-1].encoderinfo.get("disposal") == 2:
                     if background_im is None:
                         color = im.encoderinfo.get(
                             "transparency", im.info.get("transparency", (0, 0, 0))
                         )
                         background = _get_background(im_frame, color)
                         background_im = Image.new("P", im_frame.size, background)
-                        background_im.putpalette(im_frames[0]["im"].palette)
+                        background_im.putpalette(im_frames[0].im.palette)
                     bbox = _getbbox(background_im, im_frame)[1]
                 elif encoderinfo.get("optimize") and im_frame.mode != "1":
                     if "transparency" not in encoderinfo:
@@ -687,31 +705,29 @@ def _write_multiple_frames(im, fp, palette):
             else:
                 bbox = None
             previous_im = im_frame
-            im_frames.append(
-                {"im": diff_frame or im_frame, "bbox": bbox, "encoderinfo": encoderinfo}
-            )
+            im_frames.append(_Frame(diff_frame or im_frame, bbox, encoderinfo))
 
     if len(im_frames) == 1:
         if "duration" in im.encoderinfo:
             # Since multiple frames will not be written, use the combined duration
-            im.encoderinfo["duration"] = im_frames[0]["encoderinfo"]["duration"]
-        return
+            im.encoderinfo["duration"] = im_frames[0].encoderinfo["duration"]
+        return False
 
     for frame_data in im_frames:
-        im_frame = frame_data["im"]
-        if not frame_data["bbox"]:
+        im_frame = frame_data.im
+        if not frame_data.bbox:
             # global header
-            for s in _get_global_header(im_frame, frame_data["encoderinfo"]):
+            for s in _get_global_header(im_frame, frame_data.encoderinfo):
                 fp.write(s)
             offset = (0, 0)
         else:
             # compress difference
             if not palette:
-                frame_data["encoderinfo"]["include_color_table"] = True
+                frame_data.encoderinfo["include_color_table"] = True
 
-            im_frame = im_frame.crop(frame_data["bbox"])
-            offset = frame_data["bbox"][:2]
-        _write_frame_data(fp, im_frame, offset, frame_data["encoderinfo"])
+            im_frame = im_frame.crop(frame_data.bbox)
+            offset = frame_data.bbox[:2]
+        _write_frame_data(fp, im_frame, offset, frame_data.encoderinfo)
     return True
 
 
@@ -748,7 +764,9 @@ def get_interlace(im: Image.Image) -> int:
     return interlace
 
 
-def _write_local_header(fp, im, offset, flags):
+def _write_local_header(
+    fp: IO[bytes], im: Image.Image, offset: tuple[int, int], flags: int
+) -> None:
     try:
         transparency = im.encoderinfo["transparency"]
     except KeyError:
@@ -849,7 +867,7 @@ def _save_netpbm(im: Image.Image, fp: IO[bytes], filename: str | bytes) -> None:
 _FORCE_OPTIMIZE = False
 
 
-def _get_optimize(im, info):
+def _get_optimize(im: Image.Image, info: dict[str, Any]) -> list[int] | None:
     """
     Palette optimization is a potentially expensive operation.
 
@@ -893,6 +911,7 @@ def _get_optimize(im, info):
                 and current_palette_size > 2
             ):
                 return used_palette_colors
+    return None
 
 
 def _get_color_table_size(palette_bytes: bytes) -> int:
@@ -933,7 +952,10 @@ def _get_palette_bytes(im: Image.Image) -> bytes:
     return im.palette.palette if im.palette else b""
 
 
-def _get_background(im, info_background):
+def _get_background(
+    im: Image.Image,
+    info_background: int | tuple[int, int, int] | tuple[int, int, int, int] | None,
+) -> int:
     background = 0
     if info_background:
         if isinstance(info_background, tuple):
@@ -956,7 +978,7 @@ def _get_background(im, info_background):
     return background
 
 
-def _get_global_header(im, info):
+def _get_global_header(im: Image.Image, info: dict[str, Any]) -> list[bytes]:
     """Return a list of strings representing a GIF header"""
 
     # Header Block
@@ -1018,7 +1040,12 @@ def _get_global_header(im, info):
     return header
 
 
-def _write_frame_data(fp, im_frame, offset, params):
+def _write_frame_data(
+    fp: IO[bytes],
+    im_frame: Image.Image,
+    offset: tuple[int, int],
+    params: dict[str, Any],
+) -> None:
     try:
         im_frame.encoderinfo = params
 
@@ -1038,7 +1065,9 @@ def _write_frame_data(fp, im_frame, offset, params):
 # Legacy GIF utilities
 
 
-def getheader(im, palette=None, info=None):
+def getheader(
+    im: Image.Image, palette: _Palette | None = None, info: dict[str, Any] | None = None
+) -> tuple[list[bytes], list[int] | None]:
     """
     Legacy Method to get Gif data from image.
 
@@ -1050,11 +1079,11 @@ def getheader(im, palette=None, info=None):
     :returns: tuple of(list of header items, optimized palette)
 
     """
-    used_palette_colors = _get_optimize(im, info)
-
     if info is None:
         info = {}
 
+    used_palette_colors = _get_optimize(im, info)
+
     if "background" not in info and "background" in im.info:
         info["background"] = im.info["background"]
 
@@ -1066,7 +1095,9 @@ def getheader(im, palette=None, info=None):
     return header, used_palette_colors
 
 
-def getdata(im, offset=(0, 0), **params):
+def getdata(
+    im: Image.Image, offset: tuple[int, int] = (0, 0), **params: Any
+) -> list[bytes]:
     """
     Legacy Method
 
@@ -1083,12 +1114,23 @@ def getdata(im, offset=(0, 0), **params):
     :returns: List of bytes containing GIF encoded frame data
 
     """
+    from io import BytesIO
 
-    class Collector:
+    class Collector(BytesIO):
         data = []
 
-        def write(self, data: bytes) -> None:
-            self.data.append(data)
+        if sys.version_info >= (3, 12):
+            from collections.abc import Buffer
+
+            def write(self, data: Buffer) -> int:
+                self.data.append(data)
+                return len(data)
+
+        else:
+
+            def write(self, data: Any) -> int:
+                self.data.append(data)
+                return len(data)
 
     im.load()  # make sure raster data is available
 
diff --git a/src/PIL/Image.py b/src/PIL/Image.py
index af174861019..bdd869ccc15 100644
--- a/src/PIL/Image.py
+++ b/src/PIL/Image.py
@@ -41,7 +41,7 @@
 from collections.abc import Callable, MutableMapping
 from enum import IntEnum
 from types import ModuleType
-from typing import IO, TYPE_CHECKING, Any, Literal, Protocol, Sequence, cast
+from typing import IO, TYPE_CHECKING, Any, Literal, Protocol, Sequence, Tuple, cast
 
 # VERSION was removed in Pillow 6.0.0.
 # PILLOW_VERSION was removed in Pillow 9.0.0.
@@ -1367,7 +1367,7 @@ def getbands(self) -> tuple[str, ...]:
         """
         return ImageMode.getmode(self.mode).bands
 
-    def getbbox(self, *, alpha_only: bool = True) -> tuple[int, int, int, int]:
+    def getbbox(self, *, alpha_only: bool = True) -> tuple[int, int, int, int] | None:
         """
         Calculates the bounding box of the non-zero regions in the
         image.
@@ -3029,12 +3029,18 @@ def new(
         color = ImageColor.getcolor(color, mode)
 
     im = Image()
-    if mode == "P" and isinstance(color, (list, tuple)) and len(color) in [3, 4]:
-        # RGB or RGBA value for a P image
-        from . import ImagePalette
+    if (
+        mode == "P"
+        and isinstance(color, (list, tuple))
+        and all(isinstance(i, int) for i in color)
+    ):
+        color_ints: tuple[int, ...] = cast(Tuple[int, ...], tuple(color))
+        if len(color_ints) == 3 or len(color_ints) == 4:
+            # RGB or RGBA value for a P image
+            from . import ImagePalette
 
-        im.palette = ImagePalette.ImagePalette()
-        color = im.palette.getcolor(color)
+            im.palette = ImagePalette.ImagePalette()
+            color = im.palette.getcolor(color_ints)
     return im._new(core.fill(mode, size, color))
 
 
diff --git a/src/PIL/ImageOps.py b/src/PIL/ImageOps.py
index 33db8fa50c7..cbe189cc926 100644
--- a/src/PIL/ImageOps.py
+++ b/src/PIL/ImageOps.py
@@ -497,7 +497,7 @@ def expand(
     color = _color(fill, image.mode)
     if image.palette:
         palette = ImagePalette.ImagePalette(palette=image.getpalette())
-        if isinstance(color, tuple):
+        if isinstance(color, tuple) and (len(color) == 3 or len(color) == 4):
             color = palette.getcolor(color)
     else:
         palette = None
diff --git a/src/PIL/ImagePalette.py b/src/PIL/ImagePalette.py
index 057ccd1d7c4..1ff05a3eff1 100644
--- a/src/PIL/ImagePalette.py
+++ b/src/PIL/ImagePalette.py
@@ -18,10 +18,13 @@
 from __future__ import annotations
 
 import array
-from typing import IO, Sequence
+from typing import IO, TYPE_CHECKING, Sequence
 
 from . import GimpGradientFile, GimpPaletteFile, ImageColor, PaletteFile
 
+if TYPE_CHECKING:
+    from . import Image
+
 
 class ImagePalette:
     """
@@ -128,7 +131,11 @@ def _new_color_index(self, image=None, e=None):
                 raise ValueError(msg) from e
         return index
 
-    def getcolor(self, color, image=None) -> int:
+    def getcolor(
+        self,
+        color: tuple[int, int, int] | tuple[int, int, int, int],
+        image: Image.Image | None = None,
+    ) -> int:
         """Given an rgb tuple, allocate palette entry.
 
         .. warning:: This method is experimental.
@@ -163,7 +170,7 @@ def getcolor(self, color, image=None) -> int:
                 self.dirty = 1
                 return index
         else:
-            msg = f"unknown color specifier: {repr(color)}"
+            msg = f"unknown color specifier: {repr(color)}"  # type: ignore[unreachable]
             raise ValueError(msg)
 
     def save(self, fp: str | IO[str]) -> None:

From 84b284723259f2a7d1e079daea0670e0138c4980 Mon Sep 17 00:00:00 2001
From: Andrew Murray <radarhere@users.noreply.github.com>
Date: Tue, 11 Jun 2024 07:15:47 +1000
Subject: [PATCH 0695/1178] Accept 't' suffix for libtiff version

---
 Tests/test_file_libtiff.py | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/Tests/test_file_libtiff.py b/Tests/test_file_libtiff.py
index 22bcd285622..fe9d017c086 100644
--- a/Tests/test_file_libtiff.py
+++ b/Tests/test_file_libtiff.py
@@ -54,7 +54,7 @@ class TestFileLibTiff(LibTiffTestCase):
     def test_version(self) -> None:
         version = features.version_codec("libtiff")
         assert version is not None
-        assert re.search(r"\d+\.\d+\.\d+$", version)
+        assert re.search(r"\d+\.\d+\.\d+t?$", version)
 
     def test_g4_tiff(self, tmp_path: Path) -> None:
         """Test the ordinary file path load path"""

From 474ef6ff8d152effba530f364d7c3c5a0653358f Mon Sep 17 00:00:00 2001
From: "renovate[bot]" <29139614+renovate[bot]@users.noreply.github.com>
Date: Tue, 11 Jun 2024 00:01:02 +0000
Subject: [PATCH 0696/1178] Update dependency cibuildwheel to v2.19.0

---
 .ci/requirements-cibw.txt | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/.ci/requirements-cibw.txt b/.ci/requirements-cibw.txt
index 7e257b75cf3..bf1d1315bfc 100644
--- a/.ci/requirements-cibw.txt
+++ b/.ci/requirements-cibw.txt
@@ -1 +1 @@
-cibuildwheel==2.18.1
+cibuildwheel==2.19.0

From 780d85b667f3201c02c1563ca7c09581f8871237 Mon Sep 17 00:00:00 2001
From: Andrew Murray <radarhere@users.noreply.github.com>
Date: Tue, 11 Jun 2024 23:18:11 +1000
Subject: [PATCH 0697/1178] Update CHANGES.rst [ci skip]

---
 CHANGES.rst | 6 ++++++
 1 file changed, 6 insertions(+)

diff --git a/CHANGES.rst b/CHANGES.rst
index dc4016d76f6..d7231ebeabf 100644
--- a/CHANGES.rst
+++ b/CHANGES.rst
@@ -5,6 +5,12 @@ Changelog (Pillow)
 10.4.0 (unreleased)
 -------------------
 
+- Accept 't' suffix for libtiff version #8126, #8129
+  [radarhere]
+
+- Deprecate ImageDraw.getdraw hints parameter #8124
+  [radarhere, hugovk]
+
 - Added ImageDraw circle() #8085
   [void4, hugovk, radarhere]
 

From 1eb960f7e3e662b489c7cfc2b97b88e5317ffff5 Mon Sep 17 00:00:00 2001
From: Andrew Murray <radarhere@users.noreply.github.com>
Date: Tue, 11 Jun 2024 23:26:00 +1000
Subject: [PATCH 0698/1178] Added type hints

---
 src/PIL/BlpImagePlugin.py    | 20 ++++++++--------
 src/PIL/BmpImagePlugin.py    |  3 ++-
 src/PIL/DdsImagePlugin.py    |  3 ++-
 src/PIL/EpsImagePlugin.py    | 45 ++++++++++++++++++------------------
 src/PIL/FitsImagePlugin.py   |  2 +-
 src/PIL/FpxImagePlugin.py    |  2 +-
 src/PIL/ImageFile.py         |  2 +-
 src/PIL/Jpeg2KImagePlugin.py | 15 ++++++------
 src/PIL/MicImagePlugin.py    |  2 +-
 src/PIL/MpoImagePlugin.py    | 15 ++++--------
 src/PIL/PSDraw.py            |  2 +-
 src/PIL/PalmImagePlugin.py   | 10 ++++----
 src/PIL/PdfParser.py         |  3 +--
 src/PIL/PngImagePlugin.py    |  2 +-
 src/PIL/TarIO.py             |  8 +------
 src/PIL/TiffImagePlugin.py   | 29 +++++++++++------------
 16 files changed, 78 insertions(+), 85 deletions(-)

diff --git a/src/PIL/BlpImagePlugin.py b/src/PIL/BlpImagePlugin.py
index 003fa9b2479..59246c6e2e1 100644
--- a/src/PIL/BlpImagePlugin.py
+++ b/src/PIL/BlpImagePlugin.py
@@ -61,7 +61,9 @@ def unpack_565(i: int) -> tuple[int, int, int]:
     return ((i >> 11) & 0x1F) << 3, ((i >> 5) & 0x3F) << 2, (i & 0x1F) << 3
 
 
-def decode_dxt1(data, alpha=False):
+def decode_dxt1(
+    data: bytes, alpha: bool = False
+) -> tuple[bytearray, bytearray, bytearray, bytearray]:
     """
     input: one "row" of data (i.e. will produce 4*width pixels)
     """
@@ -69,9 +71,9 @@ def decode_dxt1(data, alpha=False):
     blocks = len(data) // 8  # number of blocks in row
     ret = (bytearray(), bytearray(), bytearray(), bytearray())
 
-    for block in range(blocks):
+    for block_index in range(blocks):
         # Decode next 8-byte block.
-        idx = block * 8
+        idx = block_index * 8
         color0, color1, bits = struct.unpack_from("<HHI", data, idx)
 
         r0, g0, b0 = unpack_565(color0)
@@ -116,7 +118,7 @@ def decode_dxt1(data, alpha=False):
     return ret
 
 
-def decode_dxt3(data):
+def decode_dxt3(data: bytes) -> tuple[bytearray, bytearray, bytearray, bytearray]:
     """
     input: one "row" of data (i.e. will produce 4*width pixels)
     """
@@ -124,8 +126,8 @@ def decode_dxt3(data):
     blocks = len(data) // 16  # number of blocks in row
     ret = (bytearray(), bytearray(), bytearray(), bytearray())
 
-    for block in range(blocks):
-        idx = block * 16
+    for block_index in range(blocks):
+        idx = block_index * 16
         block = data[idx : idx + 16]
         # Decode next 16-byte block.
         bits = struct.unpack_from("<8B", block)
@@ -169,7 +171,7 @@ def decode_dxt3(data):
     return ret
 
 
-def decode_dxt5(data):
+def decode_dxt5(data: bytes) -> tuple[bytearray, bytearray, bytearray, bytearray]:
     """
     input: one "row" of data (i.e. will produce 4 * width pixels)
     """
@@ -177,8 +179,8 @@ def decode_dxt5(data):
     blocks = len(data) // 16  # number of blocks in row
     ret = (bytearray(), bytearray(), bytearray(), bytearray())
 
-    for block in range(blocks):
-        idx = block * 16
+    for block_index in range(blocks):
+        idx = block_index * 16
         block = data[idx : idx + 16]
         # Decode next 16-byte block.
         a0, a1 = struct.unpack_from("<BB", block)
diff --git a/src/PIL/BmpImagePlugin.py b/src/PIL/BmpImagePlugin.py
index 45c1ea941e8..ef204533712 100644
--- a/src/PIL/BmpImagePlugin.py
+++ b/src/PIL/BmpImagePlugin.py
@@ -301,7 +301,8 @@ def _open(self) -> None:
 class BmpRleDecoder(ImageFile.PyDecoder):
     _pulls_fd = True
 
-    def decode(self, buffer):
+    def decode(self, buffer: bytes) -> tuple[int, int]:
+        assert self.fd is not None
         rle4 = self.args[1]
         data = bytearray()
         x = 0
diff --git a/src/PIL/DdsImagePlugin.py b/src/PIL/DdsImagePlugin.py
index 861a1eca0cc..e7472700765 100644
--- a/src/PIL/DdsImagePlugin.py
+++ b/src/PIL/DdsImagePlugin.py
@@ -480,7 +480,8 @@ def load_seek(self, pos: int) -> None:
 class DdsRgbDecoder(ImageFile.PyDecoder):
     _pulls_fd = True
 
-    def decode(self, buffer):
+    def decode(self, buffer: bytes) -> tuple[int, int]:
+        assert self.fd is not None
         bitcount, masks = self.args
 
         # Some masks will be padded with zeros, e.g. R 0b11 G 0b1100
diff --git a/src/PIL/EpsImagePlugin.py b/src/PIL/EpsImagePlugin.py
index d24a2ba80f0..380b1cf0ec4 100644
--- a/src/PIL/EpsImagePlugin.py
+++ b/src/PIL/EpsImagePlugin.py
@@ -27,6 +27,7 @@
 import subprocess
 import sys
 import tempfile
+from typing import IO
 
 from . import Image, ImageFile
 from ._binary import i32le as i32
@@ -236,7 +237,7 @@ def check_required_header_comments() -> None:
                 msg = 'EPS header missing "%%BoundingBox" comment'
                 raise SyntaxError(msg)
 
-        def _read_comment(s):
+        def _read_comment(s: str) -> bool:
             nonlocal reading_trailer_comments
             try:
                 m = split.match(s)
@@ -244,27 +245,25 @@ def _read_comment(s):
                 msg = "not an EPS file"
                 raise SyntaxError(msg) from e
 
-            if m:
-                k, v = m.group(1, 2)
-                self.info[k] = v
-                if k == "BoundingBox":
-                    if v == "(atend)":
-                        reading_trailer_comments = True
-                    elif not self._size or (
-                        trailer_reached and reading_trailer_comments
-                    ):
-                        try:
-                            # Note: The DSC spec says that BoundingBox
-                            # fields should be integers, but some drivers
-                            # put floating point values there anyway.
-                            box = [int(float(i)) for i in v.split()]
-                            self._size = box[2] - box[0], box[3] - box[1]
-                            self.tile = [
-                                ("eps", (0, 0) + self.size, offset, (length, box))
-                            ]
-                        except Exception:
-                            pass
-                return True
+            if not m:
+                return False
+
+            k, v = m.group(1, 2)
+            self.info[k] = v
+            if k == "BoundingBox":
+                if v == "(atend)":
+                    reading_trailer_comments = True
+                elif not self._size or (trailer_reached and reading_trailer_comments):
+                    try:
+                        # Note: The DSC spec says that BoundingBox
+                        # fields should be integers, but some drivers
+                        # put floating point values there anyway.
+                        box = [int(float(i)) for i in v.split()]
+                        self._size = box[2] - box[0], box[3] - box[1]
+                        self.tile = [("eps", (0, 0) + self.size, offset, (length, box))]
+                    except Exception:
+                        pass
+            return True
 
         while True:
             byte = self.fp.read(1)
@@ -413,7 +412,7 @@ def load_seek(self, pos: int) -> None:
 # --------------------------------------------------------------------
 
 
-def _save(im, fp, filename, eps=1):
+def _save(im: Image.Image, fp: IO[bytes], filename: str | bytes, eps: int = 1) -> None:
     """EPS Writer for the Python Imaging Library."""
 
     # make sure image data is available
diff --git a/src/PIL/FitsImagePlugin.py b/src/PIL/FitsImagePlugin.py
index 07191892506..a169b6083e9 100644
--- a/src/PIL/FitsImagePlugin.py
+++ b/src/PIL/FitsImagePlugin.py
@@ -122,7 +122,7 @@ def _parse_headers(
 class FitsGzipDecoder(ImageFile.PyDecoder):
     _pulls_fd = True
 
-    def decode(self, buffer):
+    def decode(self, buffer: bytes) -> tuple[int, int]:
         assert self.fd is not None
         value = gzip.decompress(self.fd.read())
 
diff --git a/src/PIL/FpxImagePlugin.py b/src/PIL/FpxImagePlugin.py
index b3e6c6e362b..c1927bd26aa 100644
--- a/src/PIL/FpxImagePlugin.py
+++ b/src/PIL/FpxImagePlugin.py
@@ -241,7 +241,7 @@ def close(self) -> None:
         self.ole.close()
         super().close()
 
-    def __exit__(self, *args):
+    def __exit__(self, *args: object) -> None:
         self.ole.close()
         super().__exit__()
 
diff --git a/src/PIL/ImageFile.py b/src/PIL/ImageFile.py
index 6bef681e979..5d67409ea45 100644
--- a/src/PIL/ImageFile.py
+++ b/src/PIL/ImageFile.py
@@ -487,7 +487,7 @@ def feed(self, data):
     def __enter__(self):
         return self
 
-    def __exit__(self, *args):
+    def __exit__(self, *args: object) -> None:
         self.close()
 
     def close(self):
diff --git a/src/PIL/Jpeg2KImagePlugin.py b/src/PIL/Jpeg2KImagePlugin.py
index 72c2cb85e3c..60f3bff0acb 100644
--- a/src/PIL/Jpeg2KImagePlugin.py
+++ b/src/PIL/Jpeg2KImagePlugin.py
@@ -18,7 +18,7 @@
 import io
 import os
 import struct
-from typing import IO
+from typing import IO, Tuple, cast
 
 from . import Image, ImageFile, ImagePalette, _binary
 
@@ -59,7 +59,7 @@ def _read_bytes(self, num_bytes: int) -> bytes:
             self.remaining_in_box -= num_bytes
         return data
 
-    def read_fields(self, field_format):
+    def read_fields(self, field_format: str) -> tuple[int | bytes, ...]:
         size = struct.calcsize(field_format)
         data = self._read_bytes(size)
         return struct.unpack(field_format, data)
@@ -82,9 +82,9 @@ def next_box_type(self) -> bytes:
         self.remaining_in_box = -1
 
         # Read the length and type of the next box
-        lbox, tbox = self.read_fields(">I4s")
+        lbox, tbox = cast(Tuple[int, bytes], self.read_fields(">I4s"))
         if lbox == 1:
-            lbox = self.read_fields(">Q")[0]
+            lbox = cast(int, self.read_fields(">Q")[0])
             hlen = 16
         else:
             hlen = 8
@@ -127,12 +127,13 @@ def _parse_codestream(fp):
     return size, mode
 
 
-def _res_to_dpi(num, denom, exp):
+def _res_to_dpi(num: int, denom: int, exp: int) -> float | None:
     """Convert JPEG2000's (numerator, denominator, exponent-base-10) resolution,
     calculated as (num / denom) * 10^exp and stored in dots per meter,
     to floating-point dots per inch."""
-    if denom != 0:
-        return (254 * num * (10**exp)) / (10000 * denom)
+    if denom == 0:
+        return None
+    return (254 * num * (10**exp)) / (10000 * denom)
 
 
 def _parse_jp2_header(fp):
diff --git a/src/PIL/MicImagePlugin.py b/src/PIL/MicImagePlugin.py
index 5aef94dfbff..ed2ea2849d0 100644
--- a/src/PIL/MicImagePlugin.py
+++ b/src/PIL/MicImagePlugin.py
@@ -93,7 +93,7 @@ def close(self) -> None:
         self.ole.close()
         super().close()
 
-    def __exit__(self, *args):
+    def __exit__(self, *args: object) -> None:
         self.__fp.close()
         self.ole.close()
         super().__exit__()
diff --git a/src/PIL/MpoImagePlugin.py b/src/PIL/MpoImagePlugin.py
index 152e19e2365..f21570661f8 100644
--- a/src/PIL/MpoImagePlugin.py
+++ b/src/PIL/MpoImagePlugin.py
@@ -37,19 +37,14 @@ def _save(im: Image.Image, fp: IO[bytes], filename: str | bytes) -> None:
     JpegImagePlugin._save(im, fp, filename)
 
 
-def _save_all(im, fp, filename):
+def _save_all(im: Image.Image, fp: IO[bytes], filename: str | bytes) -> None:
     append_images = im.encoderinfo.get("append_images", [])
-    if not append_images:
-        try:
-            animated = im.is_animated
-        except AttributeError:
-            animated = False
-        if not animated:
-            _save(im, fp, filename)
-            return
+    if not append_images and not getattr(im, "is_animated", False):
+        _save(im, fp, filename)
+        return
 
     mpf_offset = 28
-    offsets = []
+    offsets: list[int] = []
     for imSequence in itertools.chain([im], append_images):
         for im_frame in ImageSequence.Iterator(imSequence):
             if not offsets:
diff --git a/src/PIL/PSDraw.py b/src/PIL/PSDraw.py
index 4e2b9788ef3..673eae1d12c 100644
--- a/src/PIL/PSDraw.py
+++ b/src/PIL/PSDraw.py
@@ -138,7 +138,7 @@ def image(
             sx = x / im.size[0]
             sy = y / im.size[1]
             self.fp.write(b"%f %f scale\n" % (sx, sy))
-        EpsImagePlugin._save(im, self.fp, None, 0)
+        EpsImagePlugin._save(im, self.fp, "", 0)
         self.fp.write(b"\ngrestore\n")
 
 
diff --git a/src/PIL/PalmImagePlugin.py b/src/PIL/PalmImagePlugin.py
index 85f9fe1bf61..fc83918b5b4 100644
--- a/src/PIL/PalmImagePlugin.py
+++ b/src/PIL/PalmImagePlugin.py
@@ -8,6 +8,8 @@
 ##
 from __future__ import annotations
 
+from typing import IO
+
 from . import Image, ImageFile
 from ._binary import o8
 from ._binary import o16be as o16b
@@ -82,10 +84,10 @@
 
 
 # so build a prototype image to be used for palette resampling
-def build_prototype_image():
+def build_prototype_image() -> Image.Image:
     image = Image.new("L", (1, len(_Palm8BitColormapValues)))
     image.putdata(list(range(len(_Palm8BitColormapValues))))
-    palettedata = ()
+    palettedata: tuple[int, ...] = ()
     for colormapValue in _Palm8BitColormapValues:
         palettedata += colormapValue
     palettedata += (0, 0, 0) * (256 - len(_Palm8BitColormapValues))
@@ -112,7 +114,7 @@ def build_prototype_image():
 # (Internal) Image save plugin for the Palm format.
 
 
-def _save(im, fp, filename):
+def _save(im: Image.Image, fp: IO[bytes], filename: str | bytes) -> None:
     if im.mode == "P":
         # we assume this is a color Palm image with the standard colormap,
         # unless the "info" dict has a "custom-colormap" field
@@ -141,7 +143,7 @@ def _save(im, fp, filename):
             raise OSError(msg)
 
         # we ignore the palette here
-        im.mode = "P"
+        im._mode = "P"
         rawmode = f"P;{bpp}"
         version = 1
 
diff --git a/src/PIL/PdfParser.py b/src/PIL/PdfParser.py
index 52e8358017a..9e22313475e 100644
--- a/src/PIL/PdfParser.py
+++ b/src/PIL/PdfParser.py
@@ -404,9 +404,8 @@ def __init__(self, filename=None, f=None, buf=None, start_offset=0, mode="rb"):
     def __enter__(self) -> PdfParser:
         return self
 
-    def __exit__(self, exc_type, exc_value, traceback):
+    def __exit__(self, *args: object) -> None:
         self.close()
-        return False  # do not suppress exceptions
 
     def start_writing(self) -> None:
         self.close_buf()
diff --git a/src/PIL/PngImagePlugin.py b/src/PIL/PngImagePlugin.py
index 9aaadb47d5e..ba95980653a 100644
--- a/src/PIL/PngImagePlugin.py
+++ b/src/PIL/PngImagePlugin.py
@@ -178,7 +178,7 @@ def read(self) -> tuple[bytes, int, int]:
     def __enter__(self) -> ChunkStream:
         return self
 
-    def __exit__(self, *args):
+    def __exit__(self, *args: object) -> None:
         self.close()
 
     def close(self) -> None:
diff --git a/src/PIL/TarIO.py b/src/PIL/TarIO.py
index 7470663b4a1..cba26d4b059 100644
--- a/src/PIL/TarIO.py
+++ b/src/PIL/TarIO.py
@@ -16,7 +16,6 @@
 from __future__ import annotations
 
 import io
-from types import TracebackType
 
 from . import ContainerIO
 
@@ -61,12 +60,7 @@ def __init__(self, tarfile: str, file: str) -> None:
     def __enter__(self) -> TarIO:
         return self
 
-    def __exit__(
-        self,
-        exc_type: type[BaseException] | None,
-        exc_val: BaseException | None,
-        exc_tb: TracebackType | None,
-    ) -> None:
+    def __exit__(self, *args: object) -> None:
         self.close()
 
     def close(self) -> None:
diff --git a/src/PIL/TiffImagePlugin.py b/src/PIL/TiffImagePlugin.py
index 08ee506b162..702d8f33b5b 100644
--- a/src/PIL/TiffImagePlugin.py
+++ b/src/PIL/TiffImagePlugin.py
@@ -717,7 +717,7 @@ def _setitem(self, tag, value, legacy_api):
             # Unspec'd, and length > 1
             dest[tag] = values
 
-    def __delitem__(self, tag):
+    def __delitem__(self, tag: int) -> None:
         self._tags_v2.pop(tag, None)
         self._tags_v1.pop(tag, None)
         self._tagdata.pop(tag, None)
@@ -1106,7 +1106,7 @@ def __init__(self, fp=None, filename=None):
 
         super().__init__(fp, filename)
 
-    def _open(self):
+    def _open(self) -> None:
         """Open the first image in a TIFF file"""
 
         # Header
@@ -1123,8 +1123,8 @@ def _open(self):
         self.__first = self.__next = self.tag_v2.next
         self.__frame = -1
         self._fp = self.fp
-        self._frame_pos = []
-        self._n_frames = None
+        self._frame_pos: list[int] = []
+        self._n_frames: int | None = None
 
         logger.debug("*** TiffImageFile._open ***")
         logger.debug("- __first: %s", self.__first)
@@ -1998,10 +1998,9 @@ def newFrame(self) -> None:
     def __enter__(self) -> AppendingTiffWriter:
         return self
 
-    def __exit__(self, exc_type, exc_value, traceback):
+    def __exit__(self, *args: object) -> None:
         if self.close_fp:
             self.close()
-        return False
 
     def tell(self) -> int:
         return self.f.tell() - self.offsetOfNewPage
@@ -2043,42 +2042,42 @@ def skipIFDs(self) -> None:
     def write(self, data):
         return self.f.write(data)
 
-    def readShort(self):
+    def readShort(self) -> int:
         (value,) = struct.unpack(self.shortFmt, self.f.read(2))
         return value
 
-    def readLong(self):
+    def readLong(self) -> int:
         (value,) = struct.unpack(self.longFmt, self.f.read(4))
         return value
 
-    def rewriteLastShortToLong(self, value):
+    def rewriteLastShortToLong(self, value: int) -> None:
         self.f.seek(-2, os.SEEK_CUR)
         bytes_written = self.f.write(struct.pack(self.longFmt, value))
         if bytes_written is not None and bytes_written != 4:
             msg = f"wrote only {bytes_written} bytes but wanted 4"
             raise RuntimeError(msg)
 
-    def rewriteLastShort(self, value):
+    def rewriteLastShort(self, value: int) -> None:
         self.f.seek(-2, os.SEEK_CUR)
         bytes_written = self.f.write(struct.pack(self.shortFmt, value))
         if bytes_written is not None and bytes_written != 2:
             msg = f"wrote only {bytes_written} bytes but wanted 2"
             raise RuntimeError(msg)
 
-    def rewriteLastLong(self, value):
+    def rewriteLastLong(self, value: int) -> None:
         self.f.seek(-4, os.SEEK_CUR)
         bytes_written = self.f.write(struct.pack(self.longFmt, value))
         if bytes_written is not None and bytes_written != 4:
             msg = f"wrote only {bytes_written} bytes but wanted 4"
             raise RuntimeError(msg)
 
-    def writeShort(self, value):
+    def writeShort(self, value: int) -> None:
         bytes_written = self.f.write(struct.pack(self.shortFmt, value))
         if bytes_written is not None and bytes_written != 2:
             msg = f"wrote only {bytes_written} bytes but wanted 2"
             raise RuntimeError(msg)
 
-    def writeLong(self, value):
+    def writeLong(self, value: int) -> None:
         bytes_written = self.f.write(struct.pack(self.longFmt, value))
         if bytes_written is not None and bytes_written != 4:
             msg = f"wrote only {bytes_written} bytes but wanted 4"
@@ -2097,9 +2096,9 @@ def fixIFD(self) -> None:
             field_size = self.fieldSizes[field_type]
             total_size = field_size * count
             is_local = total_size <= 4
+            offset: int | None
             if not is_local:
-                offset = self.readLong()
-                offset += self.offsetOfNewPage
+                offset = self.readLong() + self.offsetOfNewPage
                 self.rewriteLastLong(offset)
 
             if tag in self.Tags:

From 2e15dc9f534be4411e4eddbf3d85b2034384b6a3 Mon Sep 17 00:00:00 2001
From: mamg22 <45301823+mamg22@users.noreply.github.com>
Date: Tue, 11 Jun 2024 22:00:08 -0400
Subject: [PATCH 0699/1178] Improve xdg directory support in Linux

---
 src/PIL/ImageFont.py | 19 +++++++++++++------
 1 file changed, 13 insertions(+), 6 deletions(-)

diff --git a/src/PIL/ImageFont.py b/src/PIL/ImageFont.py
index fa5608e6cd8..163bb700678 100644
--- a/src/PIL/ImageFont.py
+++ b/src/PIL/ImageFont.py
@@ -837,12 +837,19 @@ def freetype(font: StrOrBytesPath | BinaryIO | None) -> FreeTypeFont:
             if windir:
                 dirs.append(os.path.join(windir, "fonts"))
         elif sys.platform in ("linux", "linux2"):
-            lindirs = os.environ.get("XDG_DATA_DIRS")
-            if not lindirs:
-                # According to the freedesktop spec, XDG_DATA_DIRS should
-                # default to /usr/share
-                lindirs = "/usr/share"
-            dirs += [os.path.join(lindir, "fonts") for lindir in lindirs.split(":")]
+            data_home = os.environ.get("XDG_DATA_HOME")
+            if not data_home:
+                # The freedesktop spec defines the following default directory for
+                # when XDG_DATA_HOME is unset or empty. This user-level directory
+                # takes precedence over system-level directories.
+                data_home = os.path.expanduser("~/.local/share")
+            dirs.append(os.path.join(data_home, "fonts"))
+
+            data_dirs = os.environ.get("XDG_DATA_DIRS")
+            if not data_dirs:
+                # Similarly, defaults are defined for the system-level directories
+                data_dirs = "/usr/local/share:/usr/share"
+            dirs += [os.path.join(ddir, "fonts") for ddir in data_dirs.split(":")]
         elif sys.platform == "darwin":
             dirs += [
                 "/Library/Fonts",

From 1175e53d53ccd1fa86a94b2f8d2365dbc0a3336a Mon Sep 17 00:00:00 2001
From: mamg22 <45301823+mamg22@users.noreply.github.com>
Date: Tue, 11 Jun 2024 22:08:53 -0400
Subject: [PATCH 0700/1178] Set XDG_DATA_HOME on font tests

---
 Tests/test_imagefont.py | 1 +
 1 file changed, 1 insertion(+)

diff --git a/Tests/test_imagefont.py b/Tests/test_imagefont.py
index 4398f8a3055..3cba726d64e 100644
--- a/Tests/test_imagefont.py
+++ b/Tests/test_imagefont.py
@@ -564,6 +564,7 @@ def loadable_font(
     # catching syntax like errors
     monkeypatch.setattr(sys, "platform", platform)
     if platform == "linux":
+        monkeypatch.setenv("XDG_DATA_HOME", "/home/__pillow__/.local/share")
         monkeypatch.setenv("XDG_DATA_DIRS", "/usr/share/:/usr/local/share/")
 
     def fake_walker(path: str) -> list[tuple[str, list[str], list[str]]]:

From be73b13ad33a88a17e8055e74993d02c5d3f68a0 Mon Sep 17 00:00:00 2001
From: Andrew Murray <radarhere@users.noreply.github.com>
Date: Wed, 12 Jun 2024 21:15:55 +1000
Subject: [PATCH 0701/1178] Added type hints

---
 src/PIL/BdfFontFile.py     |  2 +-
 src/PIL/ImageDraw.py       | 20 ++++++------
 src/PIL/ImagePalette.py    | 12 +++++---
 src/PIL/MicImagePlugin.py  |  4 +--
 src/PIL/PngImagePlugin.py  | 63 +++++++++++++++++++++++++-------------
 src/PIL/TiffImagePlugin.py | 31 +++++++++++--------
 src/PIL/_imaging.pyi       |  2 +-
 src/PIL/features.py        | 18 ++++++-----
 8 files changed, 95 insertions(+), 57 deletions(-)

diff --git a/src/PIL/BdfFontFile.py b/src/PIL/BdfFontFile.py
index e3eda4fe98c..bc1416c74c6 100644
--- a/src/PIL/BdfFontFile.py
+++ b/src/PIL/BdfFontFile.py
@@ -103,7 +103,7 @@ def bdf_char(
 class BdfFontFile(FontFile.FontFile):
     """Font file plugin for the X11 BDF format."""
 
-    def __init__(self, fp: BinaryIO):
+    def __init__(self, fp: BinaryIO) -> None:
         super().__init__()
 
         s = fp.readline()
diff --git a/src/PIL/ImageDraw.py b/src/PIL/ImageDraw.py
index e74fab9fb3d..41a3eb0cb46 100644
--- a/src/PIL/ImageDraw.py
+++ b/src/PIL/ImageDraw.py
@@ -34,12 +34,16 @@
 import math
 import numbers
 import struct
+from types import ModuleType
 from typing import TYPE_CHECKING, AnyStr, Sequence, cast
 
 from . import Image, ImageColor
 from ._deprecate import deprecate
 from ._typing import Coords
 
+if TYPE_CHECKING:
+    from . import ImageDraw2, ImageFont
+
 """
 A simple 2D drawing interface for PIL images.
 <p>
@@ -93,9 +97,6 @@ def __init__(self, im: Image.Image, mode: str | None = None) -> None:
             self.fontmode = "L"  # aliasing is okay for other modes
         self.fill = False
 
-    if TYPE_CHECKING:
-        from . import ImageFont
-
     def getfont(
         self,
     ) -> ImageFont.ImageFont | ImageFont.FreeTypeFont | ImageFont.TransposedFont:
@@ -879,7 +880,7 @@ def multiline_textbbox(
         return bbox
 
 
-def Draw(im, mode: str | None = None) -> ImageDraw:
+def Draw(im: Image.Image, mode: str | None = None) -> ImageDraw:
     """
     A simple 2D drawing interface for PIL images.
 
@@ -891,7 +892,7 @@ def Draw(im, mode: str | None = None) -> ImageDraw:
        defaults to the mode of the image.
     """
     try:
-        return im.getdraw(mode)
+        return getattr(im, "getdraw")(mode)
     except AttributeError:
         return ImageDraw(im, mode)
 
@@ -903,7 +904,9 @@ def Draw(im, mode: str | None = None) -> ImageDraw:
     Outline = None
 
 
-def getdraw(im=None, hints=None):
+def getdraw(
+    im: Image.Image | None = None, hints: list[str] | None = None
+) -> tuple[ImageDraw2.Draw | None, ModuleType]:
     """
     :param im: The image to draw in.
     :param hints: An optional list of hints. Deprecated.
@@ -913,9 +916,8 @@ def getdraw(im=None, hints=None):
         deprecate("'hints' parameter", 12)
     from . import ImageDraw2
 
-    if im:
-        im = ImageDraw2.Draw(im)
-    return im, ImageDraw2
+    draw = ImageDraw2.Draw(im) if im is not None else None
+    return draw, ImageDraw2
 
 
 def floodfill(
diff --git a/src/PIL/ImagePalette.py b/src/PIL/ImagePalette.py
index 1ff05a3eff1..6473c4577b0 100644
--- a/src/PIL/ImagePalette.py
+++ b/src/PIL/ImagePalette.py
@@ -54,7 +54,7 @@ def palette(self, palette):
         self._palette = palette
 
     @property
-    def colors(self):
+    def colors(self) -> dict[tuple[int, int, int] | tuple[int, int, int, int], int]:
         if self._colors is None:
             mode_len = len(self.mode)
             self._colors = {}
@@ -66,7 +66,9 @@ def colors(self):
         return self._colors
 
     @colors.setter
-    def colors(self, colors):
+    def colors(
+        self, colors: dict[tuple[int, int, int] | tuple[int, int, int, int], int]
+    ) -> None:
         self._colors = colors
 
     def copy(self) -> ImagePalette:
@@ -107,11 +109,13 @@ def tobytes(self) -> bytes:
     # Declare tostring as an alias for tobytes
     tostring = tobytes
 
-    def _new_color_index(self, image=None, e=None):
+    def _new_color_index(
+        self, image: Image.Image | None = None, e: Exception | None = None
+    ) -> int:
         if not isinstance(self.palette, bytearray):
             self._palette = bytearray(self.palette)
         index = len(self.palette) // 3
-        special_colors = ()
+        special_colors: tuple[int | tuple[int, ...] | None, ...] = ()
         if image:
             special_colors = (
                 image.info.get("background"),
diff --git a/src/PIL/MicImagePlugin.py b/src/PIL/MicImagePlugin.py
index ed2ea2849d0..07239887f9f 100644
--- a/src/PIL/MicImagePlugin.py
+++ b/src/PIL/MicImagePlugin.py
@@ -63,7 +63,7 @@ def _open(self) -> None:
             msg = "not an MIC file; no image entries"
             raise SyntaxError(msg)
 
-        self.frame = None
+        self.frame = -1
         self._n_frames = len(self.images)
         self.is_animated = self._n_frames > 1
 
@@ -85,7 +85,7 @@ def seek(self, frame):
 
         self.frame = frame
 
-    def tell(self):
+    def tell(self) -> int:
         return self.frame
 
     def close(self) -> None:
diff --git a/src/PIL/PngImagePlugin.py b/src/PIL/PngImagePlugin.py
index ba95980653a..927d6c0cfbd 100644
--- a/src/PIL/PngImagePlugin.py
+++ b/src/PIL/PngImagePlugin.py
@@ -39,7 +39,7 @@
 import warnings
 import zlib
 from enum import IntEnum
-from typing import IO, Any
+from typing import IO, TYPE_CHECKING, Any, NoReturn
 
 from . import Image, ImageChops, ImageFile, ImagePalette, ImageSequence
 from ._binary import i16be as i16
@@ -48,6 +48,9 @@
 from ._binary import o16be as o16
 from ._binary import o32be as o32
 
+if TYPE_CHECKING:
+    from . import _imaging
+
 logger = logging.getLogger(__name__)
 
 is_cid = re.compile(rb"\w\w\w\w").match
@@ -249,6 +252,9 @@ class iTXt(str):
 
     """
 
+    lang: str | bytes | None
+    tkey: str | bytes | None
+
     @staticmethod
     def __new__(cls, text, lang=None, tkey=None):
         """
@@ -270,10 +276,10 @@ class PngInfo:
 
     """
 
-    def __init__(self):
-        self.chunks = []
+    def __init__(self) -> None:
+        self.chunks: list[tuple[bytes, bytes, bool]] = []
 
-    def add(self, cid, data, after_idat=False):
+    def add(self, cid: bytes, data: bytes, after_idat: bool = False) -> None:
         """Appends an arbitrary chunk. Use with caution.
 
         :param cid: a byte string, 4 bytes long.
@@ -283,12 +289,16 @@ def add(self, cid, data, after_idat=False):
 
         """
 
-        chunk = [cid, data]
-        if after_idat:
-            chunk.append(True)
-        self.chunks.append(tuple(chunk))
+        self.chunks.append((cid, data, after_idat))
 
-    def add_itxt(self, key, value, lang="", tkey="", zip=False):
+    def add_itxt(
+        self,
+        key: str | bytes,
+        value: str | bytes,
+        lang: str | bytes = "",
+        tkey: str | bytes = "",
+        zip: bool = False,
+    ) -> None:
         """Appends an iTXt chunk.
 
         :param key: latin-1 encodable text key name
@@ -316,7 +326,9 @@ def add_itxt(self, key, value, lang="", tkey="", zip=False):
         else:
             self.add(b"iTXt", key + b"\0\0\0" + lang + b"\0" + tkey + b"\0" + value)
 
-    def add_text(self, key, value, zip=False):
+    def add_text(
+        self, key: str | bytes, value: str | bytes | iTXt, zip: bool = False
+    ) -> None:
         """Appends a text chunk.
 
         :param key: latin-1 encodable text key name
@@ -326,7 +338,13 @@ def add_text(self, key, value, zip=False):
 
         """
         if isinstance(value, iTXt):
-            return self.add_itxt(key, value, value.lang, value.tkey, zip=zip)
+            return self.add_itxt(
+                key,
+                value,
+                value.lang if value.lang is not None else b"",
+                value.tkey if value.tkey is not None else b"",
+                zip=zip,
+            )
 
         # The tEXt chunk stores latin-1 text
         if not isinstance(value, bytes):
@@ -434,7 +452,7 @@ def chunk_IHDR(self, pos: int, length: int) -> bytes:
             raise SyntaxError(msg)
         return s
 
-    def chunk_IDAT(self, pos, length):
+    def chunk_IDAT(self, pos: int, length: int) -> NoReturn:
         # image data
         if "bbox" in self.im_info:
             tile = [("zip", self.im_info["bbox"], pos, self.im_rawmode)]
@@ -447,7 +465,7 @@ def chunk_IDAT(self, pos, length):
         msg = "image data found"
         raise EOFError(msg)
 
-    def chunk_IEND(self, pos, length):
+    def chunk_IEND(self, pos: int, length: int) -> NoReturn:
         msg = "end of PNG image"
         raise EOFError(msg)
 
@@ -821,7 +839,10 @@ def seek(self, frame: int) -> None:
                 msg = "no more images in APNG file"
                 raise EOFError(msg) from e
 
-    def _seek(self, frame, rewind=False):
+    def _seek(self, frame: int, rewind: bool = False) -> None:
+        assert self.png is not None
+
+        self.dispose: _imaging.ImagingCore | None
         if frame == 0:
             if rewind:
                 self._fp.seek(self.__rewind)
@@ -906,14 +927,14 @@ def _seek(self, frame, rewind=False):
         if self._prev_im is None and self.dispose_op == Disposal.OP_PREVIOUS:
             self.dispose_op = Disposal.OP_BACKGROUND
 
+        self.dispose = None
         if self.dispose_op == Disposal.OP_PREVIOUS:
-            self.dispose = self._prev_im.copy()
-            self.dispose = self._crop(self.dispose, self.dispose_extent)
+            if self._prev_im:
+                self.dispose = self._prev_im.copy()
+                self.dispose = self._crop(self.dispose, self.dispose_extent)
         elif self.dispose_op == Disposal.OP_BACKGROUND:
             self.dispose = Image.core.fill(self.mode, self.size)
             self.dispose = self._crop(self.dispose, self.dispose_extent)
-        else:
-            self.dispose = None
 
     def tell(self) -> int:
         return self.__frame
@@ -1026,7 +1047,7 @@ def _getexif(self) -> dict[str, Any] | None:
             return None
         return self.getexif()._get_merged_dict()
 
-    def getexif(self):
+    def getexif(self) -> Image.Exif:
         if "exif" not in self.info:
             self.load()
 
@@ -1346,7 +1367,7 @@ def _save(im, fp, filename, chunk=putchunk, save_all=False):
                 chunk(fp, cid, data)
             elif cid[1:2].islower():
                 # Private chunk
-                after_idat = info_chunk[2:3]
+                after_idat = len(info_chunk) == 3 and info_chunk[2]
                 if not after_idat:
                     chunk(fp, cid, data)
 
@@ -1425,7 +1446,7 @@ def _save(im, fp, filename, chunk=putchunk, save_all=False):
             cid, data = info_chunk[:2]
             if cid[1:2].islower():
                 # Private chunk
-                after_idat = info_chunk[2:3]
+                after_idat = len(info_chunk) == 3 and info_chunk[2]
                 if after_idat:
                     chunk(fp, cid, data)
 
diff --git a/src/PIL/TiffImagePlugin.py b/src/PIL/TiffImagePlugin.py
index 702d8f33b5b..833e12d2b37 100644
--- a/src/PIL/TiffImagePlugin.py
+++ b/src/PIL/TiffImagePlugin.py
@@ -50,7 +50,7 @@
 from collections.abc import MutableMapping
 from fractions import Fraction
 from numbers import Number, Rational
-from typing import IO, TYPE_CHECKING, Any, Callable
+from typing import IO, TYPE_CHECKING, Any, Callable, NoReturn
 
 from . import ExifTags, Image, ImageFile, ImageOps, ImagePalette, TiffTags
 from ._binary import i16be as i16
@@ -384,7 +384,7 @@ def limit_rational(self, max_denominator):
     def __repr__(self) -> str:
         return str(float(self._val))
 
-    def __hash__(self):
+    def __hash__(self) -> int:
         return self._val.__hash__()
 
     def __eq__(self, other: object) -> bool:
@@ -551,7 +551,12 @@ class ImageFileDirectory_v2(_IFDv2Base):
     _load_dispatch: dict[int, Callable[[ImageFileDirectory_v2, bytes, bool], Any]] = {}
     _write_dispatch: dict[int, Callable[..., Any]] = {}
 
-    def __init__(self, ifh=b"II\052\0\0\0\0\0", prefix=None, group=None):
+    def __init__(
+        self,
+        ifh: bytes = b"II\052\0\0\0\0\0",
+        prefix: bytes | None = None,
+        group: int | None = None,
+    ) -> None:
         """Initialize an ImageFileDirectory.
 
         To construct an ImageFileDirectory from a real file, pass the 8-byte
@@ -575,7 +580,7 @@ def __init__(self, ifh=b"II\052\0\0\0\0\0", prefix=None, group=None):
             raise SyntaxError(msg)
         self._bigtiff = ifh[2] == 43
         self.group = group
-        self.tagtype = {}
+        self.tagtype: dict[int, int] = {}
         """ Dictionary of tag types """
         self.reset()
         (self.next,) = (
@@ -587,18 +592,18 @@ def __init__(self, ifh=b"II\052\0\0\0\0\0", prefix=None, group=None):
     offset = property(lambda self: self._offset)
 
     @property
-    def legacy_api(self):
+    def legacy_api(self) -> bool:
         return self._legacy_api
 
     @legacy_api.setter
-    def legacy_api(self, value):
+    def legacy_api(self, value: bool) -> NoReturn:
         msg = "Not allowing setting of legacy api"
         raise Exception(msg)
 
-    def reset(self):
-        self._tags_v1 = {}  # will remain empty if legacy_api is false
-        self._tags_v2 = {}  # main tag storage
-        self._tagdata = {}
+    def reset(self) -> None:
+        self._tags_v1: dict[int, Any] = {}  # will remain empty if legacy_api is false
+        self._tags_v2: dict[int, Any] = {}  # main tag storage
+        self._tagdata: dict[int, bytes] = {}
         self.tagtype = {}  # added 2008-06-05 by Florian Hoech
         self._next = None
         self._offset = None
@@ -2039,7 +2044,7 @@ def skipIFDs(self) -> None:
             num_tags = self.readShort()
             self.f.seek(num_tags * 12, os.SEEK_CUR)
 
-    def write(self, data):
+    def write(self, data: bytes) -> int | None:
         return self.f.write(data)
 
     def readShort(self) -> int:
@@ -2122,7 +2127,9 @@ def fixIFD(self) -> None:
                 # skip the locally stored value that is not an offset
                 self.f.seek(4, os.SEEK_CUR)
 
-    def fixOffsets(self, count, isShort=False, isLong=False):
+    def fixOffsets(
+        self, count: int, isShort: bool = False, isLong: bool = False
+    ) -> None:
         if not isShort and not isLong:
             msg = "offset is neither short nor long"
             raise RuntimeError(msg)
diff --git a/src/PIL/_imaging.pyi b/src/PIL/_imaging.pyi
index 1fe95441715..b233eb34d8b 100644
--- a/src/PIL/_imaging.pyi
+++ b/src/PIL/_imaging.pyi
@@ -12,5 +12,5 @@ class ImagingDraw:
 class PixelAccess:
     def __getattr__(self, name: str) -> Any: ...
 
-def font(image, glyphdata: bytes) -> ImagingFont: ...
+def font(image: ImagingCore, glyphdata: bytes) -> ImagingFont: ...
 def __getattr__(name: str) -> Any: ...
diff --git a/src/PIL/features.py b/src/PIL/features.py
index 16c749f148b..13908c4eb78 100644
--- a/src/PIL/features.py
+++ b/src/PIL/features.py
@@ -4,6 +4,7 @@
 import os
 import sys
 import warnings
+from typing import IO
 
 import PIL
 
@@ -223,7 +224,7 @@ def get_supported() -> list[str]:
     return ret
 
 
-def pilinfo(out=None, supported_formats=True):
+def pilinfo(out: IO[str] | None = None, supported_formats: bool = True) -> None:
     """
     Prints information about this installation of Pillow.
     This function can be called with ``python3 -m PIL``.
@@ -244,9 +245,9 @@ def pilinfo(out=None, supported_formats=True):
 
     print("-" * 68, file=out)
     print(f"Pillow {PIL.__version__}", file=out)
-    py_version = sys.version.splitlines()
-    print(f"Python {py_version[0].strip()}", file=out)
-    for py_version in py_version[1:]:
+    py_version_lines = sys.version.splitlines()
+    print(f"Python {py_version_lines[0].strip()}", file=out)
+    for py_version in py_version_lines[1:]:
         print(f"       {py_version.strip()}", file=out)
     print("-" * 68, file=out)
     print(f"Python executable is {sys.executable or 'unknown'}", file=out)
@@ -282,9 +283,12 @@ def pilinfo(out=None, supported_formats=True):
         ("xcb", "XCB (X protocol)"),
     ]:
         if check(name):
-            if name == "jpg" and check_feature("libjpeg_turbo"):
-                v = "libjpeg-turbo " + version_feature("libjpeg_turbo")
-            else:
+            v: str | None = None
+            if name == "jpg":
+                libjpeg_turbo_version = version_feature("libjpeg_turbo")
+                if libjpeg_turbo_version is not None:
+                    v = "libjpeg-turbo " + libjpeg_turbo_version
+            if v is None:
                 v = version(name)
             if v is not None:
                 version_static = name in ("pil", "jpg")

From eea3ac765c2793f1931ca5696555f497011e0b0e Mon Sep 17 00:00:00 2001
From: Andrew Murray <radarhere@users.noreply.github.com>
Date: Wed, 12 Jun 2024 22:44:03 +1000
Subject: [PATCH 0702/1178] Deprecate non-image and unsupported modes

---
 Tests/test_imagecms.py       |  9 ++++++++-
 docs/deprecations.rst        |  9 +++++++++
 docs/releasenotes/10.4.0.rst |  7 +++++++
 src/PIL/ImageCms.py          | 25 +++++++++++++++++++++++++
 src/_imagingcms.c            | 10 ++++++----
 5 files changed, 55 insertions(+), 5 deletions(-)

diff --git a/Tests/test_imagecms.py b/Tests/test_imagecms.py
index 55f72c3b95c..dbbd46dcf76 100644
--- a/Tests/test_imagecms.py
+++ b/Tests/test_imagecms.py
@@ -678,7 +678,8 @@ def test_auxiliary_channels_isolated() -> None:
 
 def test_long_modes() -> None:
     p = ImageCms.getOpenProfile("Tests/icc/sGrey-v2-nano.icc")
-    ImageCms.buildTransform(p, p, "ABCDEFGHI", "ABCDEFGHI")
+    with pytest.warns(DeprecationWarning):
+        ImageCms.buildTransform(p, p, "ABCDEFGHI", "ABCDEFGHI")
 
 
 @pytest.mark.parametrize("mode", ("RGB", "RGBA", "RGBX"))
@@ -699,3 +700,9 @@ def test_deprecation() -> None:
         assert ImageCms.VERSION == "1.0.0 pil"
     with pytest.warns(DeprecationWarning):
         assert isinstance(ImageCms.FLAGS, dict)
+
+    profile = ImageCmsProfile(ImageCms.createProfile("sRGB"))
+    with pytest.warns(DeprecationWarning):
+        ImageCms.ImageCmsTransform(profile, profile, "RGBA;16B", "RGB")
+    with pytest.warns(DeprecationWarning):
+        ImageCms.ImageCmsTransform(profile, profile, "RGB", "RGBA;16B")
diff --git a/docs/deprecations.rst b/docs/deprecations.rst
index 627672e1f3b..e6566eae297 100644
--- a/docs/deprecations.rst
+++ b/docs/deprecations.rst
@@ -107,6 +107,15 @@ BGR;15, BGR 16 and BGR;24
 
 The experimental BGR;15, BGR;16 and BGR;24 modes have been deprecated.
 
+Non-image modes in ImageCms
+^^^^^^^^^^^^^^^^^^^^^^^^^^^
+
+.. deprecated:: 10.4.0
+
+The use in :py:mod:`.ImageCms` of input modes and output modes that are not Pillow
+image modes has been deprecated. Defaulting to "L" or "1" if the mode cannot be mapped
+is also deprecated.
+
 Support for LibTIFF earlier than 4
 ^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
 
diff --git a/docs/releasenotes/10.4.0.rst b/docs/releasenotes/10.4.0.rst
index 44727efd41f..96300c008e8 100644
--- a/docs/releasenotes/10.4.0.rst
+++ b/docs/releasenotes/10.4.0.rst
@@ -28,6 +28,13 @@ BGR;15, BGR 16 and BGR;24
 
 The experimental BGR;15, BGR;16 and BGR;24 modes have been deprecated.
 
+Non-image modes in ImageCms
+^^^^^^^^^^^^^^^^^^^^^^^^^^^
+
+The use in :py:mod:`.ImageCms` of input modes and output modes that are not Pillow
+image modes has been deprecated. Defaulting to "L" or "1" if the mode cannot be mapped
+is also deprecated.
+
 Support for LibTIFF earlier than 4
 ^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
 
diff --git a/src/PIL/ImageCms.py b/src/PIL/ImageCms.py
index 19a79facc24..ec10230f12b 100644
--- a/src/PIL/ImageCms.py
+++ b/src/PIL/ImageCms.py
@@ -299,6 +299,31 @@ def __init__(
         proof_intent: Intent = Intent.ABSOLUTE_COLORIMETRIC,
         flags: Flags = Flags.NONE,
     ):
+        supported_modes = (
+            "RGB",
+            "RGBA",
+            "RGBX",
+            "CMYK",
+            "I;16",
+            "I;16L",
+            "I;16B",
+            "YCbCr",
+            "LAB",
+            "L",
+            "1",
+        )
+        for mode in (input_mode, output_mode):
+            if mode not in supported_modes:
+                deprecate(
+                    mode,
+                    12,
+                    {
+                        "L;16": "I;16 or I;16L",
+                        "L:16B": "I;16B",
+                        "YCCA": "YCbCr",
+                        "YCC": "YCbCr",
+                    }.get(mode),
+                )
         if proof is None:
             self.transform = core.buildTransform(
                 input.profile, output.profile, input_mode, output_mode, intent, flags
diff --git a/src/_imagingcms.c b/src/_imagingcms.c
index 2b9612db73d..590e1b983a9 100644
--- a/src/_imagingcms.c
+++ b/src/_imagingcms.c
@@ -223,20 +223,22 @@ findLCMStype(char *PILmode) {
     if (strcmp(PILmode, "CMYK") == 0) {
         return TYPE_CMYK_8;
     }
-    if (strcmp(PILmode, "L;16") == 0) {
+    if (strcmp(PILmode, "I;16") == 0 || strcmp(PILmode, "I;16L") == 0 ||
+        strcmp(PILmode, "L;16") == 0) {
         return TYPE_GRAY_16;
     }
-    if (strcmp(PILmode, "L;16B") == 0) {
+    if (strcmp(PILmode, "I;16B") == 0 || strcmp(PILmode, "L;16B") == 0) {
         return TYPE_GRAY_16_SE;
     }
-    if (strcmp(PILmode, "YCCA") == 0 || strcmp(PILmode, "YCC") == 0) {
+    if (strcmp(PILmode, "YCbCr") == 0 || strcmp(PILmode, "YCCA") == 0 ||
+        strcmp(PILmode, "YCC") == 0) {
         return TYPE_YCbCr_8;
     }
     if (strcmp(PILmode, "LAB") == 0) {
         // LabX equivalent like ALab, but not reversed -- no #define in lcms2
         return (COLORSPACE_SH(PT_LabV2) | CHANNELS_SH(3) | BYTES_SH(1) | EXTRA_SH(1));
     }
-    /* presume "L" by default */
+    /* presume "1" or "L" by default */
     return TYPE_GRAY_8;
 }
 

From c9a9e81749c12fdc4c7187284fe661810c9bc5c4 Mon Sep 17 00:00:00 2001
From: Andrew Murray <radarhere@users.noreply.github.com>
Date: Thu, 13 Jun 2024 00:03:16 +1000
Subject: [PATCH 0703/1178] Use latest Ubuntu

---
 .readthedocs.yml | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/.readthedocs.yml b/.readthedocs.yml
index b83ba05b128..def6282dd56 100644
--- a/.readthedocs.yml
+++ b/.readthedocs.yml
@@ -3,7 +3,7 @@ version: 2
 formats: [pdf]
 
 build:
-  os: ubuntu-22.04
+  os: ubuntu-lts-latest
   tools:
     python: "3"
   jobs:

From 00161099c7df3aa76bcbd7106aa144072b45a592 Mon Sep 17 00:00:00 2001
From: mamg22 <45301823+mamg22@users.noreply.github.com>
Date: Wed, 12 Jun 2024 12:36:14 -0400
Subject: [PATCH 0704/1178] Update docs for ImageFont.truetype [ci skip]

---
 src/PIL/ImageFont.py | 13 +++++++++----
 1 file changed, 9 insertions(+), 4 deletions(-)

diff --git a/src/PIL/ImageFont.py b/src/PIL/ImageFont.py
index 163bb700678..235a76325c1 100644
--- a/src/PIL/ImageFont.py
+++ b/src/PIL/ImageFont.py
@@ -775,10 +775,15 @@ def truetype(
 
     :param font: A filename or file-like object containing a TrueType font.
                  If the file is not found in this filename, the loader may also
-                 search in other directories, such as the :file:`fonts/`
-                 directory on Windows or :file:`/Library/Fonts/`,
-                 :file:`/System/Library/Fonts/` and :file:`~/Library/Fonts/` on
-                 macOS.
+                 search in other directories, such as:
+
+                 * The :file:`fonts/` directory on Windows,
+                 * :file:`/Library/Fonts/`, :file:`/System/Library/Fonts/`
+                   and :file:`~/Library/Fonts/` on macOS.
+                 * :file:`~/.local/share/fonts`, :file:`/usr/local/share/fonts`,
+                   and :file:`/usr/share/fonts` on Linux; or those specified by
+                   the ``XDG_DATA_HOME`` and ``XDG_DATA_DIRS`` environment variables
+                   for user-installed and system-wide fonts, respectively.
 
     :param size: The requested size, in pixels.
     :param index: Which font face to load (default is first available face).

From ed828d23df58f8e59f69933b74db12d7fba87c8c Mon Sep 17 00:00:00 2001
From: mamg22 <45301823+mamg22@users.noreply.github.com>
Date: Wed, 12 Jun 2024 13:08:48 -0400
Subject: [PATCH 0705/1178] Update changes in release notes [ci skip]

---
 docs/releasenotes/10.4.0.rst | 8 ++++++++
 1 file changed, 8 insertions(+)

diff --git a/docs/releasenotes/10.4.0.rst b/docs/releasenotes/10.4.0.rst
index 44727efd41f..0a54cc7a39a 100644
--- a/docs/releasenotes/10.4.0.rst
+++ b/docs/releasenotes/10.4.0.rst
@@ -42,6 +42,14 @@ The ``hints`` parameter in :py:meth:`~PIL.ImageDraw.getdraw()` has been deprecat
 API Changes
 ===========
 
+ImageFont.truetype
+^^^^^^^^^^^^^^^^^^
+
+:py:function:`~PIL.ImageFont.truetype` now searches for fonts in the directory
+indicated by the ``XDG_DATA_HOME`` in addition to those specified in ``XDG_DATA_DIRS``.
+Additionally, the default for ``XDG_DATA_DIRS`` has been updated to match the
+freedesktop spec.
+
 TODO
 ^^^^
 

From 7e14364cee9e5f78d0bb658dbf470a4e7e580e34 Mon Sep 17 00:00:00 2001
From: Andrew Murray <radarhere@users.noreply.github.com>
Date: Wed, 1 May 2024 22:03:33 +1000
Subject: [PATCH 0706/1178] putalpha does not allow other color values

---
 src/PIL/Image.py | 3 +--
 1 file changed, 1 insertion(+), 2 deletions(-)

diff --git a/src/PIL/Image.py b/src/PIL/Image.py
index da61ef4dd13..5416524c015 100644
--- a/src/PIL/Image.py
+++ b/src/PIL/Image.py
@@ -1933,8 +1933,7 @@ def putalpha(self, alpha: Image | int) -> None:
         The new layer must be either "L" or "1".
 
         :param alpha: The new alpha layer.  This can either be an "L" or "1"
-           image having the same size as this image, or an integer or
-           other color value.
+           image having the same size as this image, or an integer.
         """
 
         self._ensure_mutable()

From eb56f3ed56c9f72e5579943f9c87a2fcc9846587 Mon Sep 17 00:00:00 2001
From: Andrew Murray <radarhere@users.noreply.github.com>
Date: Thu, 30 May 2024 23:20:13 +1000
Subject: [PATCH 0707/1178] Removed ignores

---
 src/PIL/Image.py     | 5 ++---
 src/PIL/ImageGrab.py | 5 +++--
 src/PIL/PyAccess.py  | 5 ++---
 3 files changed, 7 insertions(+), 8 deletions(-)

diff --git a/src/PIL/Image.py b/src/PIL/Image.py
index 5416524c015..faf70b718a9 100644
--- a/src/PIL/Image.py
+++ b/src/PIL/Image.py
@@ -2074,9 +2074,8 @@ def putpixel(self, xy: tuple[int, int], value: float | tuple[int, ...]) -> None:
             if self.mode == "PA":
                 alpha = value[3] if len(value) == 4 else 255
                 value = value[:3]
-            value = self.palette.getcolor(value, self)
-            if self.mode == "PA":
-                value = (value, alpha)  # type: ignore[assignment]
+            palette_index = self.palette.getcolor(value, self)
+            value = (palette_index, alpha) if self.mode == "PA" else palette_index
         return self.im.putpixel(xy, value)
 
     def remap_palette(self, dest_map, source_palette=None):
diff --git a/src/PIL/ImageGrab.py b/src/PIL/ImageGrab.py
index f16e9554433..96a28bb3570 100644
--- a/src/PIL/ImageGrab.py
+++ b/src/PIL/ImageGrab.py
@@ -33,6 +33,7 @@ def grab(
     all_screens: bool = False,
     xdisplay: str | None = None,
 ) -> Image.Image:
+    im: Image.Image
     if xdisplay is None:
         if sys.platform == "darwin":
             fh, filepath = tempfile.mkstemp(".png")
@@ -42,7 +43,7 @@ def grab(
                 left, top, right, bottom = bbox
                 args += ["-R", f"{left},{top},{right-left},{bottom-top}"]
             subprocess.call(args + ["-x", filepath])
-            im: Image.Image = Image.open(filepath)
+            im = Image.open(filepath)
             im.load()
             os.unlink(filepath)
             if bbox:
@@ -84,7 +85,7 @@ def grab(
             fh, filepath = tempfile.mkstemp(".png")
             os.close(fh)
             subprocess.call(["gnome-screenshot", "-f", filepath])
-            im: Image.Image = Image.open(filepath)  # type: ignore[no-redef, unused-ignore]
+            im = Image.open(filepath)
             im.load()
             os.unlink(filepath)
             if bbox:
diff --git a/src/PIL/PyAccess.py b/src/PIL/PyAccess.py
index cc8e2e35958..5663a7e48ae 100644
--- a/src/PIL/PyAccess.py
+++ b/src/PIL/PyAccess.py
@@ -107,9 +107,8 @@ def __setitem__(self, xy: tuple[int, int], color: float | tuple[int, ...]) -> No
             if self._im.mode == "PA":
                 alpha = color[3] if len(color) == 4 else 255
                 color = color[:3]
-            color = self._palette.getcolor(color, self._img)
-            if self._im.mode == "PA":
-                color = (color, alpha)  # type: ignore[assignment]
+            palette_index = self._palette.getcolor(color, self._img)
+            color = (palette_index, alpha) if self._im.mode == "PA" else palette_index
 
         return self.set_pixel(x, y, color)
 

From 2a2033eea1bd36637645f211239033bb7fad482d Mon Sep 17 00:00:00 2001
From: Nulano <nulano@nulano.eu>
Date: Wed, 12 Jun 2024 21:35:22 +0200
Subject: [PATCH 0708/1178] mypy fixes after merge

---
 src/PIL/Image.py | 10 ++++++++--
 1 file changed, 8 insertions(+), 2 deletions(-)

diff --git a/src/PIL/Image.py b/src/PIL/Image.py
index 76ea48510a3..6dee3fe2397 100644
--- a/src/PIL/Image.py
+++ b/src/PIL/Image.py
@@ -1128,7 +1128,10 @@ def convert_transparency(m, v):
                 del new_im.info["transparency"]
             if trns is not None:
                 try:
-                    new_im.info["transparency"] = new_im.palette.getcolor(trns, new_im)
+                    new_im.info["transparency"] = new_im.palette.getcolor(
+                        cast(Tuple[int, int, int], trns),  # trns was converted to RGB
+                        new_im,
+                    )
                 except Exception:
                     # if we can't make a transparent color, don't leave the old
                     # transparency hanging around to mess us up.
@@ -1178,7 +1181,10 @@ def convert_transparency(m, v):
         if trns is not None:
             if new_im.mode == "P":
                 try:
-                    new_im.info["transparency"] = new_im.palette.getcolor(trns, new_im)
+                    new_im.info["transparency"] = new_im.palette.getcolor(
+                        cast(Tuple[int, int, int], trns),  # trns was converted to RGB
+                        new_im,
+                    )
                 except ValueError as e:
                     del new_im.info["transparency"]
                     if str(e) != "cannot allocate more than 256 colors":

From 238110303c7bf829c0e56e5f721bcd80ad715699 Mon Sep 17 00:00:00 2001
From: Nulano <nulano@nulano.eu>
Date: Wed, 12 Jun 2024 22:17:10 +0200
Subject: [PATCH 0709/1178] getpixel and putpixel also support a list argument

---
 src/PIL/Image.py    | 6 ++++--
 src/PIL/PyAccess.py | 8 ++++++--
 2 files changed, 10 insertions(+), 4 deletions(-)

diff --git a/src/PIL/Image.py b/src/PIL/Image.py
index 6dee3fe2397..9c60bbb7a35 100644
--- a/src/PIL/Image.py
+++ b/src/PIL/Image.py
@@ -1676,7 +1676,7 @@ def apply_transparency(self) -> None:
         del self.info["transparency"]
 
     def getpixel(
-        self, xy: tuple[SupportsInt, SupportsInt]
+        self, xy: tuple[int, int] | list[int]
     ) -> float | tuple[int, ...] | None:
         """
         Returns the pixel value at a given position.
@@ -2058,7 +2058,9 @@ def putpalette(self, data, rawmode="RGB") -> None:
         self.palette.mode = "RGB"
         self.load()  # install new palette
 
-    def putpixel(self, xy: tuple[int, int], value: float | tuple[int, ...]) -> None:
+    def putpixel(
+        self, xy: tuple[int, int], value: float | tuple[int, ...] | list[int]
+    ) -> None:
         """
         Modifies the pixel at the given position. The color is given as
         a single numerical value for single-band images, and a tuple for
diff --git a/src/PIL/PyAccess.py b/src/PIL/PyAccess.py
index 5663a7e48ae..d41f00aea49 100644
--- a/src/PIL/PyAccess.py
+++ b/src/PIL/PyAccess.py
@@ -77,7 +77,11 @@ def __init__(self, img: Image.Image, readonly: bool = False) -> None:
     def _post_init(self) -> None:
         pass
 
-    def __setitem__(self, xy: tuple[int, int], color: float | tuple[int, ...]) -> None:
+    def __setitem__(
+        self,
+        xy: tuple[int, int] | list[int],
+        color: float | tuple[int, ...] | list[int],
+    ) -> None:
         """
         Modifies the pixel at x,y. The color is given as a single
         numerical value for single band images, and a tuple for
@@ -112,7 +116,7 @@ def __setitem__(self, xy: tuple[int, int], color: float | tuple[int, ...]) -> No
 
         return self.set_pixel(x, y, color)
 
-    def __getitem__(self, xy: tuple[int, int]) -> float | tuple[int, ...]:
+    def __getitem__(self, xy: tuple[int, int] | list[int]) -> float | tuple[int, ...]:
         """
         Returns the pixel at x,y. The pixel is returned as a single
         value for single band images or a tuple for multiple band

From 0a2baab6c1744a42422713858bc2bc2872805794 Mon Sep 17 00:00:00 2001
From: "pre-commit-ci[bot]"
 <66853113+pre-commit-ci[bot]@users.noreply.github.com>
Date: Wed, 12 Jun 2024 20:19:17 +0000
Subject: [PATCH 0710/1178] [pre-commit.ci] auto fixes from pre-commit.com
 hooks

for more information, see https://pre-commit.ci
---
 src/PIL/Image.py | 1 -
 1 file changed, 1 deletion(-)

diff --git a/src/PIL/Image.py b/src/PIL/Image.py
index 9c60bbb7a35..5619915ea78 100644
--- a/src/PIL/Image.py
+++ b/src/PIL/Image.py
@@ -48,7 +48,6 @@
     Literal,
     Protocol,
     Sequence,
-    SupportsInt,
     Tuple,
     cast,
 )

From 142cb11dcce7b82df56c018a457e6d9876c7397e Mon Sep 17 00:00:00 2001
From: Andrew Murray <radarhere@users.noreply.github.com>
Date: Thu, 13 Jun 2024 10:58:51 +1000
Subject: [PATCH 0711/1178] Use GitHub URL for xz

---
 winbuild/build_prepare.py | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/winbuild/build_prepare.py b/winbuild/build_prepare.py
index 1df8db17bc7..0bc739ea816 100644
--- a/winbuild/build_prepare.py
+++ b/winbuild/build_prepare.py
@@ -176,7 +176,7 @@ def cmd_msbuild(
         "libs": [r"*.lib"],
     },
     "xz": {
-        "url": f"{SF_PROJECTS}/lzmautils/files/xz-{V['XZ']}.tar.gz/download",
+        "url": f"https://github.com/tukaani-project/xz/releases/download/v{V['XZ']}/xz-{V['XZ']}.tar.gz",
         "filename": f"xz-{V['XZ']}.tar.gz",
         "dir": f"xz-{V['XZ']}",
         "license": "COPYING",

From 6cf08afb1587bfb148334907f91ae7dbe4d8a41b Mon Sep 17 00:00:00 2001
From: mamg22 <45301823+mamg22@users.noreply.github.com>
Date: Thu, 13 Jun 2024 00:03:03 -0400
Subject: [PATCH 0712/1178] Fix broken reference in release notes

[ci skip]

Co-authored-by: Andrew Murray <3112309+radarhere@users.noreply.github.com>
---
 docs/releasenotes/10.4.0.rst | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/docs/releasenotes/10.4.0.rst b/docs/releasenotes/10.4.0.rst
index 0a54cc7a39a..36c2758f9bb 100644
--- a/docs/releasenotes/10.4.0.rst
+++ b/docs/releasenotes/10.4.0.rst
@@ -45,7 +45,7 @@ API Changes
 ImageFont.truetype
 ^^^^^^^^^^^^^^^^^^
 
-:py:function:`~PIL.ImageFont.truetype` now searches for fonts in the directory
+:py:func:`~PIL.ImageFont.truetype` now searches for fonts in the directory
 indicated by the ``XDG_DATA_HOME`` in addition to those specified in ``XDG_DATA_DIRS``.
 Additionally, the default for ``XDG_DATA_DIRS`` has been updated to match the
 freedesktop spec.

From 48606afeb6e69483c329535106383c3dd79a323c Mon Sep 17 00:00:00 2001
From: mamg22 <45301823+mamg22@users.noreply.github.com>
Date: Thu, 13 Jun 2024 00:12:07 -0400
Subject: [PATCH 0713/1178] Add missing wording for envvar in release notes

[ci skip]
---
 docs/releasenotes/10.4.0.rst | 8 ++++----
 1 file changed, 4 insertions(+), 4 deletions(-)

diff --git a/docs/releasenotes/10.4.0.rst b/docs/releasenotes/10.4.0.rst
index 36c2758f9bb..00506a094ae 100644
--- a/docs/releasenotes/10.4.0.rst
+++ b/docs/releasenotes/10.4.0.rst
@@ -45,10 +45,10 @@ API Changes
 ImageFont.truetype
 ^^^^^^^^^^^^^^^^^^
 
-:py:func:`~PIL.ImageFont.truetype` now searches for fonts in the directory
-indicated by the ``XDG_DATA_HOME`` in addition to those specified in ``XDG_DATA_DIRS``.
-Additionally, the default for ``XDG_DATA_DIRS`` has been updated to match the
-freedesktop spec.
+:py:func:`~PIL.ImageFont.truetype` now searches for fonts in the directory indicated
+by the ``XDG_DATA_HOME`` envirnorment variable in addition to those specified in
+``XDG_DATA_DIRS``.  Additionally, the default for ``XDG_DATA_DIRS`` has been updated
+to match the freedesktop spec.
 
 TODO
 ^^^^

From d56ffebf2a18ffd94043300418bcb98819a6a776 Mon Sep 17 00:00:00 2001
From: mamg22 <45301823+mamg22@users.noreply.github.com>
Date: Thu, 13 Jun 2024 09:43:40 -0400
Subject: [PATCH 0714/1178] Fix typo in release notes

[ci skip]

Co-authored-by: Andrew Murray <3112309+radarhere@users.noreply.github.com>
---
 docs/releasenotes/10.4.0.rst | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/docs/releasenotes/10.4.0.rst b/docs/releasenotes/10.4.0.rst
index 00506a094ae..1678b460c37 100644
--- a/docs/releasenotes/10.4.0.rst
+++ b/docs/releasenotes/10.4.0.rst
@@ -46,7 +46,7 @@ ImageFont.truetype
 ^^^^^^^^^^^^^^^^^^
 
 :py:func:`~PIL.ImageFont.truetype` now searches for fonts in the directory indicated
-by the ``XDG_DATA_HOME`` envirnorment variable in addition to those specified in
+by the ``XDG_DATA_HOME`` environment variable in addition to those specified in
 ``XDG_DATA_DIRS``.  Additionally, the default for ``XDG_DATA_DIRS`` has been updated
 to match the freedesktop spec.
 

From 20ce7ad9f8c23bf6b02fd0a68cd39b20f12b58b7 Mon Sep 17 00:00:00 2001
From: Andrew Murray <radarhere@users.noreply.github.com>
Date: Thu, 13 Jun 2024 19:36:32 +1000
Subject: [PATCH 0715/1178] Updated type hint

---
 src/PIL/PyAccess.py | 4 +++-
 1 file changed, 3 insertions(+), 1 deletion(-)

diff --git a/src/PIL/PyAccess.py b/src/PIL/PyAccess.py
index d41f00aea49..3be1ccace0c 100644
--- a/src/PIL/PyAccess.py
+++ b/src/PIL/PyAccess.py
@@ -148,7 +148,9 @@ def check_xy(self, xy: tuple[int, int]) -> tuple[int, int]:
     def get_pixel(self, x: int, y: int) -> float | tuple[int, ...]:
         raise NotImplementedError()
 
-    def set_pixel(self, x: int, y: int, color: float | tuple[int, ...]) -> None:
+    def set_pixel(
+        self, x: int, y: int, color: float | tuple[int, ...] | list[int]
+    ) -> None:
         raise NotImplementedError()
 
 

From 05a70e7861f37d2eb65be0186345ea8ea62fc3fe Mon Sep 17 00:00:00 2001
From: Andrew Murray <radarhere@users.noreply.github.com>
Date: Fri, 14 Jun 2024 20:59:12 +1000
Subject: [PATCH 0716/1178] Corrected Ghostscript path

---
 .appveyor.yml | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/.appveyor.yml b/.appveyor.yml
index 92a04a02154..6ce5200b6ea 100644
--- a/.appveyor.yml
+++ b/.appveyor.yml
@@ -35,7 +35,7 @@ install:
 - curl -fsSL -o nasm-win64.zip https://raw.githubusercontent.com/python-pillow/pillow-depends/main/nasm-2.16.03-win64.zip
 - 7z x nasm-win64.zip -oc:\
 - choco install ghostscript --version=10.3.1
-- path c:\nasm-2.16.03;C:\Program Files\gs\gs10.00.0\bin;%PATH%
+- path c:\nasm-2.16.03;C:\Program Files\gs\gs10.03.1\bin;%PATH%
 - cd c:\pillow\winbuild\
 - ps: |
         c:\python38\python.exe c:\pillow\winbuild\build_prepare.py -v --depends=C:\pillow-depends\

From dfd53564ff6a3fc7d35a5884bc0ef03939bcec0a Mon Sep 17 00:00:00 2001
From: Andrew Murray <radarhere@users.noreply.github.com>
Date: Sat, 15 Jun 2024 11:51:02 +1000
Subject: [PATCH 0717/1178] Ignore brew dependencies for libraqm on macOS 13

---
 .github/workflows/macos-install.sh | 6 +++++-
 1 file changed, 5 insertions(+), 1 deletion(-)

diff --git a/.github/workflows/macos-install.sh b/.github/workflows/macos-install.sh
index 28124d7f759..f8f191d387a 100755
--- a/.github/workflows/macos-install.sh
+++ b/.github/workflows/macos-install.sh
@@ -7,11 +7,15 @@ brew install \
     ghostscript \
     libimagequant \
     libjpeg \
-    libraqm \
     libtiff \
     little-cms2 \
     openjpeg \
     webp
+if [[ "$ImageOS" == "macos13" ]]; then
+    brew install --ignore-dependencies libraqm
+else
+    brew install libraqm
+fi
 export PKG_CONFIG_PATH="/usr/local/opt/openblas/lib/pkgconfig"
 
 # TODO Update condition when cffi supports 3.13

From b3e3784b8ebf4fc8c29d9a28d1987fb21ec57c65 Mon Sep 17 00:00:00 2001
From: Andrew Murray <radarhere@users.noreply.github.com>
Date: Sat, 15 Jun 2024 16:05:58 +1000
Subject: [PATCH 0718/1178] Added byte support to FreeTypeFont

---
 Tests/test_imagefont.py | 17 +++++++++++
 src/PIL/ImageFont.py    |  8 +++---
 src/PIL/_imagingft.pyi  |  4 +--
 src/_imagingft.c        | 64 +++++++++++++++++++----------------------
 4 files changed, 53 insertions(+), 40 deletions(-)

diff --git a/Tests/test_imagefont.py b/Tests/test_imagefont.py
index 4398f8a3055..4ca882aab03 100644
--- a/Tests/test_imagefont.py
+++ b/Tests/test_imagefont.py
@@ -1096,6 +1096,23 @@ def test_too_many_characters(font: ImageFont.FreeTypeFont) -> None:
         imagefont.getmask("A" * 1_000_001)
 
 
+def test_bytes(font: ImageFont.FreeTypeFont) -> None:
+    assert font.getlength(b"test") == font.getlength("test")
+
+    assert font.getbbox(b"test") == font.getbbox("test")
+
+    assert_image_equal(
+        Image.Image()._new(font.getmask(b"test")),
+        Image.Image()._new(font.getmask("test")),
+    )
+
+    assert_image_equal(
+        Image.Image()._new(font.getmask2(b"test")[0]),
+        Image.Image()._new(font.getmask2("test")[0]),
+    )
+    assert font.getmask2(b"test")[1] == font.getmask2("test")[1]
+
+
 @pytest.mark.parametrize(
     "test_file",
     [
diff --git a/src/PIL/ImageFont.py b/src/PIL/ImageFont.py
index fa5608e6cd8..ac85f48bedf 100644
--- a/src/PIL/ImageFont.py
+++ b/src/PIL/ImageFont.py
@@ -279,7 +279,7 @@ def getmetrics(self) -> tuple[int, int]:
         return self.font.ascent, self.font.descent
 
     def getlength(
-        self, text: str, mode="", direction=None, features=None, language=None
+        self, text: str | bytes, mode="", direction=None, features=None, language=None
     ) -> float:
         """
         Returns length (in pixels with 1/64 precision) of given text when rendered
@@ -354,7 +354,7 @@ def getlength(
 
     def getbbox(
         self,
-        text: str,
+        text: str | bytes,
         mode: str = "",
         direction: str | None = None,
         features: list[str] | None = None,
@@ -511,7 +511,7 @@ def getmask(
 
     def getmask2(
         self,
-        text: str,
+        text: str | bytes,
         mode="",
         direction=None,
         features=None,
@@ -730,7 +730,7 @@ def getbbox(self, text, *args, **kwargs):
             return 0, 0, height, width
         return 0, 0, width, height
 
-    def getlength(self, text: str, *args, **kwargs) -> float:
+    def getlength(self, text: str | bytes, *args, **kwargs) -> float:
         if self.orientation in (Image.Transpose.ROTATE_90, Image.Transpose.ROTATE_270):
             msg = "text length is undefined for text rotated by 90 or 270 degrees"
             raise ValueError(msg)
diff --git a/src/PIL/_imagingft.pyi b/src/PIL/_imagingft.pyi
index 6e0ddd2f165..5e97b40b2e0 100644
--- a/src/PIL/_imagingft.pyi
+++ b/src/PIL/_imagingft.pyi
@@ -27,7 +27,7 @@ class Font:
     def glyphs(self) -> int: ...
     def render(
         self,
-        string: str,
+        string: str | bytes,
         fill,
         mode=...,
         dir=...,
@@ -51,7 +51,7 @@ class Font:
         /,
     ) -> tuple[tuple[int, int], tuple[int, int]]: ...
     def getlength(
-        self, string: str, mode=..., dir=..., features=..., lang=..., /
+        self, string: str | bytes, mode=..., dir=..., features=..., lang=..., /
     ) -> float: ...
     def getvarnames(self) -> list[bytes]: ...
     def getvaraxes(self) -> list[_Axis] | None: ...
diff --git a/src/_imagingft.c b/src/_imagingft.c
index e83ddfec122..ba36cc72c23 100644
--- a/src/_imagingft.c
+++ b/src/_imagingft.c
@@ -233,18 +233,6 @@ getfont(PyObject *self_, PyObject *args, PyObject *kw) {
     return (PyObject *)self;
 }
 
-static int
-font_getchar(PyObject *string, int index, FT_ULong *char_out) {
-    if (PyUnicode_Check(string)) {
-        if (index >= PyUnicode_GET_LENGTH(string)) {
-            return 0;
-        }
-        *char_out = PyUnicode_READ_CHAR(string, index);
-        return 1;
-    }
-    return 0;
-}
-
 #ifdef HAVE_RAQM
 
 static size_t
@@ -266,28 +254,34 @@ text_layout_raqm(
         goto failed;
     }
 
+    Py_ssize_t size;
+    int set_text;
     if (PyUnicode_Check(string)) {
         Py_UCS4 *text = PyUnicode_AsUCS4Copy(string);
-        Py_ssize_t size = PyUnicode_GET_LENGTH(string);
+        size = PyUnicode_GET_LENGTH(string);
         if (!text || !size) {
             /* return 0 and clean up, no glyphs==no size,
                and raqm fails with empty strings */
             goto failed;
         }
-        int set_text = raqm_set_text(rq, text, size);
+        set_text = raqm_set_text(rq, text, size);
         PyMem_Free(text);
-        if (!set_text) {
-            PyErr_SetString(PyExc_ValueError, "raqm_set_text() failed");
+    } else {
+        char *buffer;
+        PyBytes_AsStringAndSize(string, &buffer, &size);
+        if (!buffer || !size) {
+            /* return 0 and clean up, no glyphs==no size,
+               and raqm fails with empty strings */
             goto failed;
         }
-        if (lang) {
-            if (!raqm_set_language(rq, lang, start, size)) {
-                PyErr_SetString(PyExc_ValueError, "raqm_set_language() failed");
-                goto failed;
-            }
-        }
-    } else {
-        PyErr_SetString(PyExc_TypeError, "expected string");
+        set_text = raqm_set_text_utf8(rq, buffer, size);
+    }
+    if (!set_text) {
+        PyErr_SetString(PyExc_ValueError, "raqm_set_text() failed");
+        goto failed;
+    }
+    if (lang && !raqm_set_language(rq, lang, start, size)) {
+        PyErr_SetString(PyExc_ValueError, "raqm_set_language() failed");
         goto failed;
     }
 
@@ -405,13 +399,13 @@ text_layout_fallback(
     GlyphInfo **glyph_info,
     int mask,
     int color) {
-    int error, load_flags;
+    int error, load_flags, i;
+    char *buffer = NULL;
     FT_ULong ch;
     Py_ssize_t count;
     FT_GlyphSlot glyph;
     FT_Bool kerning = FT_HAS_KERNING(self->face);
     FT_UInt last_index = 0;
-    int i;
 
     if (features != Py_None || dir != NULL || lang != NULL) {
         PyErr_SetString(
@@ -419,14 +413,11 @@ text_layout_fallback(
             "setting text direction, language or font features is not supported "
             "without libraqm");
     }
-    if (!PyUnicode_Check(string)) {
-        PyErr_SetString(PyExc_TypeError, "expected string");
-        return 0;
-    }
 
-    count = 0;
-    while (font_getchar(string, count, &ch)) {
-        count++;
+    if (PyUnicode_Check(string)) {
+        count = PyUnicode_GET_LENGTH(string);
+    } else {
+        PyBytes_AsStringAndSize(string, &buffer, &count);
     }
     if (count == 0) {
         return 0;
@@ -445,7 +436,12 @@ text_layout_fallback(
     if (color) {
         load_flags |= FT_LOAD_COLOR;
     }
-    for (i = 0; font_getchar(string, i, &ch); i++) {
+    for (i = 0; i < count; i++) {
+        if (buffer) {
+            ch = buffer[i];
+        } else {
+            ch = PyUnicode_READ_CHAR(string, i);
+        }
         (*glyph_info)[i].index = FT_Get_Char_Index(self->face, ch);
         error = FT_Load_Glyph(self->face, (*glyph_info)[i].index, load_flags);
         if (error) {

From ed5e8f91c57a402ba67ee23530084b8e99c0c41e Mon Sep 17 00:00:00 2001
From: Andrew Murray <radarhere@users.noreply.github.com>
Date: Sat, 15 Jun 2024 19:11:11 +1000
Subject: [PATCH 0719/1178] Use pkg-config to help find libwebp and raqm

---
 setup.py | 4 ++++
 1 file changed, 4 insertions(+)

diff --git a/setup.py b/setup.py
index abdd87ea252..0abfaaddc5b 100644
--- a/setup.py
+++ b/setup.py
@@ -37,7 +37,9 @@ def get_version():
 JPEG2K_ROOT = None
 JPEG_ROOT = None
 LCMS_ROOT = None
+RAQM_ROOT = None
 TIFF_ROOT = None
+WEBP_ROOT = None
 ZLIB_ROOT = None
 FUZZING_BUILD = "LIB_FUZZING_ENGINE" in os.environ
 
@@ -459,6 +461,8 @@ def build_extensions(self):
             "FREETYPE_ROOT": "freetype2",
             "HARFBUZZ_ROOT": "harfbuzz",
             "FRIBIDI_ROOT": "fribidi",
+            "RAQM_ROOT": "raqm",
+            "WEBP_ROOT": "libwebp",
             "LCMS_ROOT": "lcms2",
             "IMAGEQUANT_ROOT": "libimagequant",
         }.items():

From f62796dadc35ed21ab5b06be1e655f283046c7cb Mon Sep 17 00:00:00 2001
From: Andrew Murray <radarhere@users.noreply.github.com>
Date: Sat, 15 Jun 2024 19:35:46 +1000
Subject: [PATCH 0720/1178] Rearranged code

---
 src/PIL/ImageFont.py | 6 ++++--
 1 file changed, 4 insertions(+), 2 deletions(-)

diff --git a/src/PIL/ImageFont.py b/src/PIL/ImageFont.py
index 235a76325c1..cc00cdfb6a1 100644
--- a/src/PIL/ImageFont.py
+++ b/src/PIL/ImageFont.py
@@ -848,13 +848,15 @@ def freetype(font: StrOrBytesPath | BinaryIO | None) -> FreeTypeFont:
                 # when XDG_DATA_HOME is unset or empty. This user-level directory
                 # takes precedence over system-level directories.
                 data_home = os.path.expanduser("~/.local/share")
-            dirs.append(os.path.join(data_home, "fonts"))
+            xdg_dirs = [data_home]
 
             data_dirs = os.environ.get("XDG_DATA_DIRS")
             if not data_dirs:
                 # Similarly, defaults are defined for the system-level directories
                 data_dirs = "/usr/local/share:/usr/share"
-            dirs += [os.path.join(ddir, "fonts") for ddir in data_dirs.split(":")]
+            xdg_dirs += data_dirs.split(":")
+
+            dirs += [os.path.join(xdg_dir, "fonts") for xdg_dir in xdg_dirs]
         elif sys.platform == "darwin":
             dirs += [
                 "/Library/Fonts",

From e4887610e9ac48699d386b399dbcbf104a470e0f Mon Sep 17 00:00:00 2001
From: "renovate[bot]" <29139614+renovate[bot]@users.noreply.github.com>
Date: Sat, 15 Jun 2024 22:40:46 +0000
Subject: [PATCH 0721/1178] Update dependency cibuildwheel to v2.19.1

---
 .ci/requirements-cibw.txt | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/.ci/requirements-cibw.txt b/.ci/requirements-cibw.txt
index bf1d1315bfc..0d0f81fbfad 100644
--- a/.ci/requirements-cibw.txt
+++ b/.ci/requirements-cibw.txt
@@ -1 +1 @@
-cibuildwheel==2.19.0
+cibuildwheel==2.19.1

From 8d14a452df0a6ab1264294b0b28b35032db4f791 Mon Sep 17 00:00:00 2001
From: mamg22 <45301823+mamg22@users.noreply.github.com>
Date: Sat, 15 Jun 2024 19:50:10 -0400
Subject: [PATCH 0722/1178] Update test environment variable for ImageFont

Co-authored-by: Andrew Murray <3112309+radarhere@users.noreply.github.com>
---
 Tests/test_imagefont.py | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/Tests/test_imagefont.py b/Tests/test_imagefont.py
index 3cba726d64e..4e6ec86d9d7 100644
--- a/Tests/test_imagefont.py
+++ b/Tests/test_imagefont.py
@@ -564,7 +564,7 @@ def loadable_font(
     # catching syntax like errors
     monkeypatch.setattr(sys, "platform", platform)
     if platform == "linux":
-        monkeypatch.setenv("XDG_DATA_HOME", "/home/__pillow__/.local/share")
+        monkeypatch.setenv("XDG_DATA_HOME", os.path.expanduser("~/.local/share"))
         monkeypatch.setenv("XDG_DATA_DIRS", "/usr/share/:/usr/local/share/")
 
     def fake_walker(path: str) -> list[tuple[str, list[str], list[str]]]:

From b2c4539cd99da978d523dcaf2d8577b6ee5a7934 Mon Sep 17 00:00:00 2001
From: mamg22 <45301823+mamg22@users.noreply.github.com>
Date: Sat, 15 Jun 2024 19:51:59 -0400
Subject: [PATCH 0723/1178] Remove releate note for truetype() changes

The proposed changes don't match match with previous release notes'
meaning of "API Changes".
---
 docs/releasenotes/10.4.0.rst | 8 --------
 1 file changed, 8 deletions(-)

diff --git a/docs/releasenotes/10.4.0.rst b/docs/releasenotes/10.4.0.rst
index 1678b460c37..44727efd41f 100644
--- a/docs/releasenotes/10.4.0.rst
+++ b/docs/releasenotes/10.4.0.rst
@@ -42,14 +42,6 @@ The ``hints`` parameter in :py:meth:`~PIL.ImageDraw.getdraw()` has been deprecat
 API Changes
 ===========
 
-ImageFont.truetype
-^^^^^^^^^^^^^^^^^^
-
-:py:func:`~PIL.ImageFont.truetype` now searches for fonts in the directory indicated
-by the ``XDG_DATA_HOME`` environment variable in addition to those specified in
-``XDG_DATA_DIRS``.  Additionally, the default for ``XDG_DATA_DIRS`` has been updated
-to match the freedesktop spec.
-
 TODO
 ^^^^
 

From 6b5b2f6e58ed77aad8b2950319a5c0178b00285a Mon Sep 17 00:00:00 2001
From: Andrew Murray <radarhere@users.noreply.github.com>
Date: Tue, 18 Jun 2024 22:44:17 +1000
Subject: [PATCH 0724/1178] Added type hints to Image

---
 src/PIL/FitsImagePlugin.py   |   6 +-
 src/PIL/GifImagePlugin.py    |   2 +
 src/PIL/Image.py             | 173 +++++++++++++++++++++--------------
 src/PIL/Jpeg2KImagePlugin.py |   4 +-
 src/PIL/PalmImagePlugin.py   |   9 +-
 src/PIL/_imaging.pyi         |   6 ++
 6 files changed, 124 insertions(+), 76 deletions(-)

diff --git a/src/PIL/FitsImagePlugin.py b/src/PIL/FitsImagePlugin.py
index a169b6083e9..4846054b1e4 100644
--- a/src/PIL/FitsImagePlugin.py
+++ b/src/PIL/FitsImagePlugin.py
@@ -115,7 +115,11 @@ def _parse_headers(
         elif number_of_bits in (-32, -64):
             self._mode = "F"
 
-        args = (self.mode, 0, -1) if decoder_name == "raw" else (number_of_bits,)
+        args: tuple[str | int, ...]
+        if decoder_name == "raw":
+            args = (self.mode, 0, -1)
+        else:
+            args = (number_of_bits,)
         return decoder_name, offset, args
 
 
diff --git a/src/PIL/GifImagePlugin.py b/src/PIL/GifImagePlugin.py
index a305e8de668..541d97f8c3b 100644
--- a/src/PIL/GifImagePlugin.py
+++ b/src/PIL/GifImagePlugin.py
@@ -458,6 +458,8 @@ def load_end(self) -> None:
             frame_im = self.im.convert("RGBA")
         else:
             frame_im = self.im.convert("RGB")
+
+        assert self.dispose_extent is not None
         frame_im = self._crop(frame_im, self.dispose_extent)
 
         self.im = self._prev_im
diff --git a/src/PIL/Image.py b/src/PIL/Image.py
index bdd869ccc15..4725811274e 100644
--- a/src/PIL/Image.py
+++ b/src/PIL/Image.py
@@ -410,7 +410,9 @@ def init() -> bool:
 # Codec factories (used by tobytes/frombytes and ImageFile.load)
 
 
-def _getdecoder(mode, decoder_name, args, extra=()):
+def _getdecoder(
+    mode: str, decoder_name: str, args: Any, extra: tuple[Any, ...] = ()
+) -> core.ImagingDecoder | ImageFile.PyDecoder:
     # tweak arguments
     if args is None:
         args = ()
@@ -433,7 +435,9 @@ def _getdecoder(mode, decoder_name, args, extra=()):
     return decoder(mode, *args + extra)
 
 
-def _getencoder(mode, encoder_name, args, extra=()):
+def _getencoder(
+    mode: str, encoder_name: str, args: Any, extra: tuple[Any, ...] = ()
+) -> core.ImagingEncoder | ImageFile.PyEncoder:
     # tweak arguments
     if args is None:
         args = ()
@@ -550,10 +554,10 @@ def size(self) -> tuple[int, int]:
         return self._size
 
     @property
-    def mode(self):
+    def mode(self) -> str:
         return self._mode
 
-    def _new(self, im) -> Image:
+    def _new(self, im: core.ImagingCore) -> Image:
         new = Image()
         new.im = im
         new._mode = im.mode
@@ -687,7 +691,7 @@ def _repr_pretty_(self, p, cycle) -> None:
             )
         )
 
-    def _repr_image(self, image_format, **kwargs):
+    def _repr_image(self, image_format: str, **kwargs: Any) -> bytes | None:
         """Helper function for iPython display hook.
 
         :param image_format: Image format.
@@ -700,14 +704,14 @@ def _repr_image(self, image_format, **kwargs):
             return None
         return b.getvalue()
 
-    def _repr_png_(self):
+    def _repr_png_(self) -> bytes | None:
         """iPython display hook support for PNG format.
 
         :returns: PNG version of the image as bytes
         """
         return self._repr_image("PNG", compress_level=1)
 
-    def _repr_jpeg_(self):
+    def _repr_jpeg_(self) -> bytes | None:
         """iPython display hook support for JPEG format.
 
         :returns: JPEG version of the image as bytes
@@ -754,7 +758,7 @@ def __setstate__(self, state) -> None:
             self.putpalette(palette)
         self.frombytes(data)
 
-    def tobytes(self, encoder_name: str = "raw", *args) -> bytes:
+    def tobytes(self, encoder_name: str = "raw", *args: Any) -> bytes:
         """
         Return image as a bytes object.
 
@@ -776,12 +780,13 @@ def tobytes(self, encoder_name: str = "raw", *args) -> bytes:
         :returns: A :py:class:`bytes` object.
         """
 
-        # may pass tuple instead of argument list
-        if len(args) == 1 and isinstance(args[0], tuple):
-            args = args[0]
+        encoder_args: Any = args
+        if len(encoder_args) == 1 and isinstance(encoder_args[0], tuple):
+            # may pass tuple instead of argument list
+            encoder_args = encoder_args[0]
 
-        if encoder_name == "raw" and args == ():
-            args = self.mode
+        if encoder_name == "raw" and encoder_args == ():
+            encoder_args = self.mode
 
         self.load()
 
@@ -789,7 +794,7 @@ def tobytes(self, encoder_name: str = "raw", *args) -> bytes:
             return b""
 
         # unpack data
-        e = _getencoder(self.mode, encoder_name, args)
+        e = _getencoder(self.mode, encoder_name, encoder_args)
         e.setimage(self.im)
 
         bufsize = max(65536, self.size[0] * 4)  # see RawEncode.c
@@ -832,7 +837,9 @@ def tobitmap(self, name: str = "image") -> bytes:
             ]
         )
 
-    def frombytes(self, data: bytes, decoder_name: str = "raw", *args) -> None:
+    def frombytes(
+        self, data: bytes | bytearray, decoder_name: str = "raw", *args: Any
+    ) -> None:
         """
         Loads this image with pixel data from a bytes object.
 
@@ -843,16 +850,17 @@ def frombytes(self, data: bytes, decoder_name: str = "raw", *args) -> None:
         if self.width == 0 or self.height == 0:
             return
 
-        # may pass tuple instead of argument list
-        if len(args) == 1 and isinstance(args[0], tuple):
-            args = args[0]
+        decoder_args: Any = args
+        if len(decoder_args) == 1 and isinstance(decoder_args[0], tuple):
+            # may pass tuple instead of argument list
+            decoder_args = decoder_args[0]
 
         # default format
-        if decoder_name == "raw" and args == ():
-            args = self.mode
+        if decoder_name == "raw" and decoder_args == ():
+            decoder_args = self.mode
 
         # unpack data
-        d = _getdecoder(self.mode, decoder_name, args)
+        d = _getdecoder(self.mode, decoder_name, decoder_args)
         d.setimage(self.im)
         s = d.decode(data)
 
@@ -996,9 +1004,11 @@ def convert(
             if has_transparency and self.im.bands == 3:
                 transparency = new_im.info["transparency"]
 
-                def convert_transparency(m, v):
-                    v = m[0] * v[0] + m[1] * v[1] + m[2] * v[2] + m[3] * 0.5
-                    return max(0, min(255, int(v)))
+                def convert_transparency(
+                    m: tuple[float, ...], v: tuple[int, int, int]
+                ) -> int:
+                    value = m[0] * v[0] + m[1] * v[1] + m[2] * v[2] + m[3] * 0.5
+                    return max(0, min(255, int(value)))
 
                 if mode == "L":
                     transparency = convert_transparency(matrix, transparency)
@@ -1250,7 +1260,7 @@ def copy(self) -> Image:
 
     __copy__ = copy
 
-    def crop(self, box: tuple[int, int, int, int] | None = None) -> Image:
+    def crop(self, box: tuple[float, float, float, float] | None = None) -> Image:
         """
         Returns a rectangular region from this image. The box is a
         4-tuple defining the left, upper, right, and lower pixel
@@ -1276,7 +1286,9 @@ def crop(self, box: tuple[int, int, int, int] | None = None) -> Image:
         self.load()
         return self._new(self._crop(self.im, box))
 
-    def _crop(self, im, box):
+    def _crop(
+        self, im: core.ImagingCore, box: tuple[float, float, float, float]
+    ) -> core.ImagingCore:
         """
         Returns a rectangular region from the core image object im.
 
@@ -1448,7 +1460,7 @@ def getextrema(self) -> tuple[float, float] | tuple[tuple[int, int], ...]:
         return self.im.getextrema()
 
     def _getxmp(self, xmp_tags):
-        def get_name(tag):
+        def get_name(tag: str) -> str:
             return re.sub("^{[^}]+}", "", tag)
 
         def get_value(element):
@@ -1549,7 +1561,11 @@ def get_child_images(self) -> list[ImageFile.ImageFile]:
                 fp = io.BytesIO(data)
 
             with open(fp) as im:
-                if thumbnail_offset is None:
+                from . import TiffImagePlugin
+
+                if thumbnail_offset is None and isinstance(
+                    im, TiffImagePlugin.TiffImageFile
+                ):
                     im._frame_pos = [ifd_offset]
                     im._seek(0)
                 im.load()
@@ -1803,7 +1819,9 @@ def paste(
         else:
             self.im.paste(im, box)
 
-    def alpha_composite(self, im, dest=(0, 0), source=(0, 0)):
+    def alpha_composite(
+        self, im: Image, dest: Sequence[int] = (0, 0), source: Sequence[int] = (0, 0)
+    ) -> None:
         """'In-place' analog of Image.alpha_composite. Composites an image
         onto this image.
 
@@ -1818,32 +1836,35 @@ def alpha_composite(self, im, dest=(0, 0), source=(0, 0)):
         """
 
         if not isinstance(source, (list, tuple)):
-            msg = "Source must be a tuple"
+            msg = "Source must be a list or tuple"
             raise ValueError(msg)
         if not isinstance(dest, (list, tuple)):
-            msg = "Destination must be a tuple"
+            msg = "Destination must be a list or tuple"
             raise ValueError(msg)
-        if len(source) not in (2, 4):
-            msg = "Source must be a 2 or 4-tuple"
+
+        if len(source) == 4:
+            overlay_crop_box = tuple(source)
+        elif len(source) == 2:
+            overlay_crop_box = tuple(source) + im.size
+        else:
+            msg = "Source must be a sequence of length 2 or 4"
             raise ValueError(msg)
+
         if not len(dest) == 2:
-            msg = "Destination must be a 2-tuple"
+            msg = "Destination must be a sequence of length 2"
             raise ValueError(msg)
         if min(source) < 0:
             msg = "Source must be non-negative"
             raise ValueError(msg)
 
-        if len(source) == 2:
-            source = source + im.size
-
-        # over image, crop if it's not the whole thing.
-        if source == (0, 0) + im.size:
+        # over image, crop if it's not the whole image.
+        if overlay_crop_box == (0, 0) + im.size:
             overlay = im
         else:
-            overlay = im.crop(source)
+            overlay = im.crop(overlay_crop_box)
 
         # target for the paste
-        box = dest + (dest[0] + overlay.width, dest[1] + overlay.height)
+        box = tuple(dest) + (dest[0] + overlay.width, dest[1] + overlay.height)
 
         # destination image. don't copy if we're using the whole image.
         if box == (0, 0) + self.size:
@@ -1854,7 +1875,11 @@ def alpha_composite(self, im, dest=(0, 0), source=(0, 0)):
         result = alpha_composite(background, overlay)
         self.paste(result, box)
 
-    def point(self, lut, mode: str | None = None) -> Image:
+    def point(
+        self,
+        lut: Sequence[float] | Callable[[int], float] | ImagePointHandler,
+        mode: str | None = None,
+    ) -> Image:
         """
         Maps this image through a lookup table or function.
 
@@ -1891,7 +1916,9 @@ def point(self, data):
                 scale, offset = _getscaleoffset(lut)
                 return self._new(self.im.point_transform(scale, offset))
             # for other modes, convert the function to a table
-            lut = [lut(i) for i in range(256)] * self.im.bands
+            flatLut = [lut(i) for i in range(256)] * self.im.bands
+        else:
+            flatLut = lut
 
         if self.mode == "F":
             # FIXME: _imaging returns a confusing error message for this case
@@ -1899,8 +1926,8 @@ def point(self, data):
             raise ValueError(msg)
 
         if mode != "F":
-            lut = [round(i) for i in lut]
-        return self._new(self.im.point(lut, mode))
+            flatLut = [round(i) for i in flatLut]
+        return self._new(self.im.point(flatLut, mode))
 
     def putalpha(self, alpha):
         """
@@ -2973,29 +3000,29 @@ def _wedge() -> Image:
     return Image()._new(core.wedge("L"))
 
 
-def _check_size(size):
+def _check_size(size: Any) -> None:
     """
     Common check to enforce type and sanity check on size tuples
 
     :param size: Should be a 2 tuple of (width, height)
-    :returns: True, or raises a ValueError
+    :returns: None, or raises a ValueError
     """
 
     if not isinstance(size, (list, tuple)):
-        msg = "Size must be a tuple"
+        msg = "Size must be a list or tuple"
         raise ValueError(msg)
     if len(size) != 2:
-        msg = "Size must be a tuple of length 2"
+        msg = "Size must be a sequence of length 2"
         raise ValueError(msg)
     if size[0] < 0 or size[1] < 0:
         msg = "Width and height must be >= 0"
         raise ValueError(msg)
 
-    return True
-
 
 def new(
-    mode: str, size: tuple[int, int], color: float | tuple[float, ...] | str | None = 0
+    mode: str,
+    size: tuple[int, int] | list[int],
+    color: float | tuple[float, ...] | str | None = 0,
 ) -> Image:
     """
     Creates a new image with the given mode and size.
@@ -3044,7 +3071,13 @@ def new(
     return im._new(core.fill(mode, size, color))
 
 
-def frombytes(mode, size, data, decoder_name: str = "raw", *args) -> Image:
+def frombytes(
+    mode: str,
+    size: tuple[int, int],
+    data: bytes | bytearray,
+    decoder_name: str = "raw",
+    *args: Any,
+) -> Image:
     """
     Creates a copy of an image memory from pixel data in a buffer.
 
@@ -3072,18 +3105,21 @@ def frombytes(mode, size, data, decoder_name: str = "raw", *args) -> Image:
 
     im = new(mode, size)
     if im.width != 0 and im.height != 0:
-        # may pass tuple instead of argument list
-        if len(args) == 1 and isinstance(args[0], tuple):
-            args = args[0]
+        decoder_args: Any = args
+        if len(decoder_args) == 1 and isinstance(decoder_args[0], tuple):
+            # may pass tuple instead of argument list
+            decoder_args = decoder_args[0]
 
-        if decoder_name == "raw" and args == ():
-            args = mode
+        if decoder_name == "raw" and decoder_args == ():
+            decoder_args = mode
 
-        im.frombytes(data, decoder_name, args)
+        im.frombytes(data, decoder_name, decoder_args)
     return im
 
 
-def frombuffer(mode: str, size, data, decoder_name: str = "raw", *args) -> Image:
+def frombuffer(
+    mode: str, size: tuple[int, int], data, decoder_name: str = "raw", *args: Any
+) -> Image:
     """
     Creates an image memory referencing pixel data in a byte buffer.
 
@@ -3540,7 +3576,7 @@ def merge(mode: str, bands: Sequence[Image]) -> Image:
 
 
 def register_open(
-    id,
+    id: str,
     factory: Callable[[IO[bytes], str | bytes], ImageFile.ImageFile],
     accept: Callable[[bytes], bool | str] | None = None,
 ) -> None:
@@ -3674,7 +3710,7 @@ def _show(image: Image, **options: Any) -> None:
 
 
 def effect_mandelbrot(
-    size: tuple[int, int], extent: tuple[int, int, int, int], quality: int
+    size: tuple[int, int], extent: tuple[float, float, float, float], quality: int
 ) -> Image:
     """
     Generate a Mandelbrot set covering the given extent.
@@ -3721,19 +3757,18 @@ def radial_gradient(mode: str) -> Image:
 # Resources
 
 
-def _apply_env_variables(env=None) -> None:
-    if env is None:
-        env = os.environ
+def _apply_env_variables(env: dict[str, str] | None = None) -> None:
+    env_dict = env if env is not None else os.environ
 
     for var_name, setter in [
         ("PILLOW_ALIGNMENT", core.set_alignment),
         ("PILLOW_BLOCK_SIZE", core.set_block_size),
         ("PILLOW_BLOCKS_MAX", core.set_blocks_max),
     ]:
-        if var_name not in env:
+        if var_name not in env_dict:
             continue
 
-        var = env[var_name].lower()
+        var = env_dict[var_name].lower()
 
         units = 1
         for postfix, mul in [("k", 1024), ("m", 1024 * 1024)]:
@@ -3742,13 +3777,13 @@ def _apply_env_variables(env=None) -> None:
                 var = var[: -len(postfix)]
 
         try:
-            var = int(var) * units
+            var_int = int(var) * units
         except ValueError:
             warnings.warn(f"{var_name} is not int")
             continue
 
         try:
-            setter(var)
+            setter(var_int)
         except ValueError as e:
             warnings.warn(f"{var_name}: {e}")
 
diff --git a/src/PIL/Jpeg2KImagePlugin.py b/src/PIL/Jpeg2KImagePlugin.py
index 60f3bff0acb..39eb1c20314 100644
--- a/src/PIL/Jpeg2KImagePlugin.py
+++ b/src/PIL/Jpeg2KImagePlugin.py
@@ -122,7 +122,7 @@ def _parse_codestream(fp):
     elif csiz == 4:
         mode = "RGBA"
     else:
-        mode = None
+        mode = ""
 
     return size, mode
 
@@ -237,7 +237,7 @@ def _open(self) -> None:
                 msg = "not a JPEG 2000 file"
                 raise SyntaxError(msg)
 
-        if self.size is None or self.mode is None:
+        if self.size is None or not self.mode:
             msg = "unable to determine size/mode"
             raise SyntaxError(msg)
 
diff --git a/src/PIL/PalmImagePlugin.py b/src/PIL/PalmImagePlugin.py
index fc83918b5b4..1735070f81b 100644
--- a/src/PIL/PalmImagePlugin.py
+++ b/src/PIL/PalmImagePlugin.py
@@ -129,15 +129,16 @@ def _save(im: Image.Image, fp: IO[bytes], filename: str | bytes) -> None:
             # and invert it because
             # Palm does grayscale from white (0) to black (1)
             bpp = im.encoderinfo["bpp"]
-            im = im.point(
-                lambda x, shift=8 - bpp, maxval=(1 << bpp) - 1: maxval - (x >> shift)
-            )
+            maxval = (1 << bpp) - 1
+            shift = 8 - bpp
+            im = im.point(lambda x: maxval - (x >> shift))
         elif im.info.get("bpp") in (1, 2, 4):
             # here we assume that even though the inherent mode is 8-bit grayscale,
             # only the lower bpp bits are significant.
             # We invert them to match the Palm.
             bpp = im.info["bpp"]
-            im = im.point(lambda x, maxval=(1 << bpp) - 1: maxval - (x & maxval))
+            maxval = (1 << bpp) - 1
+            im = im.point(lambda x: maxval - (x & maxval))
         else:
             msg = f"cannot write mode {im.mode} as Palm"
             raise OSError(msg)
diff --git a/src/PIL/_imaging.pyi b/src/PIL/_imaging.pyi
index 1fe95441715..3467eeb4549 100644
--- a/src/PIL/_imaging.pyi
+++ b/src/PIL/_imaging.pyi
@@ -12,5 +12,11 @@ class ImagingDraw:
 class PixelAccess:
     def __getattr__(self, name: str) -> Any: ...
 
+class ImagingDecoder:
+    def __getattr__(self, name: str) -> Any: ...
+
+class ImagingEncoder:
+    def __getattr__(self, name: str) -> Any: ...
+
 def font(image, glyphdata: bytes) -> ImagingFont: ...
 def __getattr__(name: str) -> Any: ...

From 291ee352047c845e2e6e5062c2c219923689da8d Mon Sep 17 00:00:00 2001
From: Andrew Murray <radarhere@users.noreply.github.com>
Date: Tue, 18 Jun 2024 23:03:03 +1000
Subject: [PATCH 0725/1178] Added type hints

---
 Tests/test_file_jpeg.py       |  2 +-
 Tests/test_file_jpeg2k.py     |  2 +-
 Tests/test_image.py           |  2 +-
 Tests/test_image_putdata.py   |  8 ++++----
 Tests/test_numpy.py           | 25 +++++++++++++++++--------
 Tests/test_shell_injection.py |  7 ++++---
 6 files changed, 28 insertions(+), 18 deletions(-)

diff --git a/Tests/test_file_jpeg.py b/Tests/test_file_jpeg.py
index 8e4d694c1a9..1459a87eb13 100644
--- a/Tests/test_file_jpeg.py
+++ b/Tests/test_file_jpeg.py
@@ -701,7 +701,7 @@ def test_load_djpeg(self) -> None:
     def test_save_cjpeg(self, tmp_path: Path) -> None:
         with Image.open(TEST_FILE) as img:
             tempfile = str(tmp_path / "temp.jpg")
-            JpegImagePlugin._save_cjpeg(img, 0, tempfile)
+            JpegImagePlugin._save_cjpeg(img, BytesIO(), tempfile)
             # Default save quality is 75%, so a tiny bit of difference is alright
             assert_image_similar_tofile(img, tempfile, 17)
 
diff --git a/Tests/test_file_jpeg2k.py b/Tests/test_file_jpeg2k.py
index 5a208739f70..ed7ea4fcfbc 100644
--- a/Tests/test_file_jpeg2k.py
+++ b/Tests/test_file_jpeg2k.py
@@ -460,7 +460,7 @@ def test_plt_marker() -> None:
         out.seek(length - 2, os.SEEK_CUR)
 
 
-def test_9bit():
+def test_9bit() -> None:
     with Image.open("Tests/images/9bit.j2k") as im:
         assert im.mode == "I;16"
         assert im.size == (128, 128)
diff --git a/Tests/test_image.py b/Tests/test_image.py
index d6a739c79df..0d7d034806c 100644
--- a/Tests/test_image.py
+++ b/Tests/test_image.py
@@ -152,7 +152,7 @@ def test_bad_mode(self) -> None:
 
     def test_stringio(self) -> None:
         with pytest.raises(ValueError):
-            with Image.open(io.StringIO()):
+            with Image.open(io.StringIO()):  # type: ignore[arg-type]
                 pass
 
     def test_pathlib(self, tmp_path: Path) -> None:
diff --git a/Tests/test_image_putdata.py b/Tests/test_image_putdata.py
index dad26ef144c..5e57e4c4c8f 100644
--- a/Tests/test_image_putdata.py
+++ b/Tests/test_image_putdata.py
@@ -113,13 +113,13 @@ def test_array_F() -> None:
 def test_not_flattened() -> None:
     im = Image.new("L", (1, 1))
     with pytest.raises(TypeError):
-        im.putdata([[0]])
+        im.putdata([[0]])  # type: ignore[list-item]
     with pytest.raises(TypeError):
-        im.putdata([[0]], 2)
+        im.putdata([[0]], 2)  # type: ignore[list-item]
 
     with pytest.raises(TypeError):
         im = Image.new("I", (1, 1))
-        im.putdata([[0]])
+        im.putdata([[0]])  # type: ignore[list-item]
     with pytest.raises(TypeError):
         im = Image.new("F", (1, 1))
-        im.putdata([[0]])
+        im.putdata([[0]])  # type: ignore[list-item]
diff --git a/Tests/test_numpy.py b/Tests/test_numpy.py
index 9f4e6534e8a..36cdb368267 100644
--- a/Tests/test_numpy.py
+++ b/Tests/test_numpy.py
@@ -1,6 +1,7 @@
 from __future__ import annotations
 
 import warnings
+from typing import TYPE_CHECKING, Any
 
 import pytest
 
@@ -8,13 +9,19 @@
 
 from .helper import assert_deep_equal, assert_image, hopper, skip_unless_feature
 
-numpy = pytest.importorskip("numpy", reason="NumPy not installed")
+if TYPE_CHECKING:
+    import numpy
+    import numpy.typing
+else:
+    numpy = pytest.importorskip("numpy", reason="NumPy not installed")
 
 TEST_IMAGE_SIZE = (10, 10)
 
 
 def test_numpy_to_image() -> None:
-    def to_image(dtype, bands: int = 1, boolean: int = 0) -> Image.Image:
+    def to_image(
+        dtype: numpy.typing.DTypeLike, bands: int = 1, boolean: int = 0
+    ) -> Image.Image:
         if bands == 1:
             if boolean:
                 data = [0, 255] * 50
@@ -99,14 +106,16 @@ def test_1d_array() -> None:
     assert_image(Image.fromarray(a), "L", (1, 5))
 
 
-def _test_img_equals_nparray(img: Image.Image, np) -> None:
-    assert len(np.shape) >= 2
-    np_size = np.shape[1], np.shape[0]
+def _test_img_equals_nparray(
+    img: Image.Image, np_img: numpy.typing.NDArray[Any]
+) -> None:
+    assert len(np_img.shape) >= 2
+    np_size = np_img.shape[1], np_img.shape[0]
     assert img.size == np_size
     px = img.load()
     for x in range(0, img.size[0], int(img.size[0] / 10)):
         for y in range(0, img.size[1], int(img.size[1] / 10)):
-            assert_deep_equal(px[x, y], np[y, x])
+            assert_deep_equal(px[x, y], np_img[y, x])
 
 
 def test_16bit() -> None:
@@ -157,7 +166,7 @@ def test_save_tiff_uint16() -> None:
         ("HSV", numpy.uint8),
     ),
 )
-def test_to_array(mode: str, dtype) -> None:
+def test_to_array(mode: str, dtype: numpy.typing.DTypeLike) -> None:
     img = hopper(mode)
 
     # Resize to non-square
@@ -207,7 +216,7 @@ def test_putdata() -> None:
         numpy.float64,
     ),
 )
-def test_roundtrip_eye(dtype) -> None:
+def test_roundtrip_eye(dtype: numpy.typing.DTypeLike) -> None:
     arr = numpy.eye(10, dtype=dtype)
     numpy.testing.assert_array_equal(arr, numpy.array(Image.fromarray(arr)))
 
diff --git a/Tests/test_shell_injection.py b/Tests/test_shell_injection.py
index 2a072fd44c5..dd4fc46c374 100644
--- a/Tests/test_shell_injection.py
+++ b/Tests/test_shell_injection.py
@@ -1,8 +1,9 @@
 from __future__ import annotations
 
 import shutil
+from io import BytesIO
 from pathlib import Path
-from typing import Callable
+from typing import IO, Callable
 
 import pytest
 
@@ -22,11 +23,11 @@ def assert_save_filename_check(
         self,
         tmp_path: Path,
         src_img: Image.Image,
-        save_func: Callable[[Image.Image, int, str], None],
+        save_func: Callable[[Image.Image, IO[bytes], str | bytes], None],
     ) -> None:
         for filename in test_filenames:
             dest_file = str(tmp_path / filename)
-            save_func(src_img, 0, dest_file)
+            save_func(src_img, BytesIO(), dest_file)
             # If file can't be opened, shell injection probably occurred
             with Image.open(dest_file) as im:
                 im.load()

From 9f79e5d7680a0eba9b625ad24595fc2ece6e523c Mon Sep 17 00:00:00 2001
From: Andrew Murray <radarhere@users.noreply.github.com>
Date: Wed, 19 Jun 2024 08:43:23 +1000
Subject: [PATCH 0726/1178] Added type hints to ImageDraw shape methods

---
 Tests/test_imagedraw.py |  20 +++-
 src/PIL/ImageDraw.py    | 248 +++++++++++++++++++++++++++-------------
 src/PIL/_imaging.pyi    |   5 +
 3 files changed, 187 insertions(+), 86 deletions(-)

diff --git a/Tests/test_imagedraw.py b/Tests/test_imagedraw.py
index d9593c60f60..8b55df992e1 100644
--- a/Tests/test_imagedraw.py
+++ b/Tests/test_imagedraw.py
@@ -448,6 +448,7 @@ def test_shape1() -> None:
     x3, y3 = 95, 5
 
     # Act
+    assert ImageDraw.Outline is not None
     s = ImageDraw.Outline()
     s.move(x0, y0)
     s.curve(x1, y1, x2, y2, x3, y3)
@@ -469,6 +470,7 @@ def test_shape2() -> None:
     x3, y3 = 5, 95
 
     # Act
+    assert ImageDraw.Outline is not None
     s = ImageDraw.Outline()
     s.move(x0, y0)
     s.curve(x1, y1, x2, y2, x3, y3)
@@ -487,6 +489,7 @@ def test_transform() -> None:
     draw = ImageDraw.Draw(im)
 
     # Act
+    assert ImageDraw.Outline is not None
     s = ImageDraw.Outline()
     s.line(0, 0)
     s.transform((0, 0, 0, 0, 0, 0))
@@ -913,7 +916,12 @@ def test_rounded_rectangle_translucent(
 def test_floodfill(bbox: Coords) -> None:
     red = ImageColor.getrgb("red")
 
-    for mode, value in [("L", 1), ("RGBA", (255, 0, 0, 0)), ("RGB", red)]:
+    mode_values: list[tuple[str, int | tuple[int, ...]]] = [
+        ("L", 1),
+        ("RGBA", (255, 0, 0, 0)),
+        ("RGB", red),
+    ]
+    for mode, value in mode_values:
         # Arrange
         im = Image.new(mode, (W, H))
         draw = ImageDraw.Draw(im)
@@ -1429,6 +1437,7 @@ def test_same_color_outline(bbox: Coords) -> None:
     x2, y2 = 95, 50
     x3, y3 = 95, 5
 
+    assert ImageDraw.Outline is not None
     s = ImageDraw.Outline()
     s.move(x0, y0)
     s.curve(x1, y1, x2, y2, x3, y3)
@@ -1467,7 +1476,7 @@ def test_same_color_outline(bbox: Coords) -> None:
         (4, "square", {}),
         (8, "regular_octagon", {}),
         (4, "square_rotate_45", {"rotation": 45}),
-        (3, "triangle_width", {"width": 5, "outline": "yellow"}),
+        (3, "triangle_width", {"outline": "yellow", "width": 5}),
     ],
 )
 def test_draw_regular_polygon(
@@ -1477,7 +1486,10 @@ def test_draw_regular_polygon(
     filename = f"Tests/images/imagedraw_{polygon_name}.png"
     draw = ImageDraw.Draw(im)
     bounding_circle = ((W // 2, H // 2), 25)
-    draw.regular_polygon(bounding_circle, n_sides, fill="red", **args)
+    rotation = int(args.get("rotation", 0))
+    outline = args.get("outline")
+    width = int(args.get("width", 1))
+    draw.regular_polygon(bounding_circle, n_sides, rotation, "red", outline, width)
     assert_image_equal_tofile(im, filename)
 
 
@@ -1630,6 +1642,6 @@ def test_incorrectly_ordered_coordinates(xy: tuple[int, int, int, int]) -> None:
         draw.rounded_rectangle(xy)
 
 
-def test_getdraw():
+def test_getdraw() -> None:
     with pytest.warns(DeprecationWarning):
         ImageDraw.getdraw(None, [])
diff --git a/src/PIL/ImageDraw.py b/src/PIL/ImageDraw.py
index 41a3eb0cb46..91f8988387d 100644
--- a/src/PIL/ImageDraw.py
+++ b/src/PIL/ImageDraw.py
@@ -35,15 +35,24 @@
 import numbers
 import struct
 from types import ModuleType
-from typing import TYPE_CHECKING, AnyStr, Sequence, cast
+from typing import TYPE_CHECKING, AnyStr, Callable, List, Sequence, Tuple, Union, cast
 
 from . import Image, ImageColor
 from ._deprecate import deprecate
 from ._typing import Coords
 
+# experimental access to the outline API
+Outline: Callable[[], Image.core._Outline] | None
+try:
+    Outline = Image.core.outline
+except AttributeError:
+    Outline = None
+
 if TYPE_CHECKING:
     from . import ImageDraw2, ImageFont
 
+_Ink = Union[float, Tuple[int, ...], str]
+
 """
 A simple 2D drawing interface for PIL images.
 <p>
@@ -134,34 +143,47 @@ def _getfont(
         else:
             return self.getfont()
 
-    def _getink(self, ink, fill=None) -> tuple[int | None, int | None]:
+    def _getink(
+        self, ink: _Ink | None, fill: _Ink | None = None
+    ) -> tuple[int | None, int | None]:
+        result_ink = None
+        result_fill = None
         if ink is None and fill is None:
             if self.fill:
-                fill = self.ink
+                result_fill = self.ink
             else:
-                ink = self.ink
+                result_ink = self.ink
         else:
             if ink is not None:
                 if isinstance(ink, str):
                     ink = ImageColor.getcolor(ink, self.mode)
                 if self.palette and not isinstance(ink, numbers.Number):
                     ink = self.palette.getcolor(ink, self._image)
-                ink = self.draw.draw_ink(ink)
+                result_ink = self.draw.draw_ink(ink)
             if fill is not None:
                 if isinstance(fill, str):
                     fill = ImageColor.getcolor(fill, self.mode)
                 if self.palette and not isinstance(fill, numbers.Number):
                     fill = self.palette.getcolor(fill, self._image)
-                fill = self.draw.draw_ink(fill)
-        return ink, fill
+                result_fill = self.draw.draw_ink(fill)
+        return result_ink, result_fill
 
-    def arc(self, xy: Coords, start, end, fill=None, width=1) -> None:
+    def arc(
+        self,
+        xy: Coords,
+        start: float,
+        end: float,
+        fill: _Ink | None = None,
+        width: int = 1,
+    ) -> None:
         """Draw an arc."""
         ink, fill = self._getink(fill)
         if ink is not None:
             self.draw.draw_arc(xy, start, end, ink, width)
 
-    def bitmap(self, xy: Sequence[int], bitmap, fill=None) -> None:
+    def bitmap(
+        self, xy: Sequence[int], bitmap: Image.Image, fill: _Ink | None = None
+    ) -> None:
         """Draw a bitmap."""
         bitmap.load()
         ink, fill = self._getink(fill)
@@ -170,30 +192,55 @@ def bitmap(self, xy: Sequence[int], bitmap, fill=None) -> None:
         if ink is not None:
             self.draw.draw_bitmap(xy, bitmap.im, ink)
 
-    def chord(self, xy: Coords, start, end, fill=None, outline=None, width=1) -> None:
+    def chord(
+        self,
+        xy: Coords,
+        start: float,
+        end: float,
+        fill: _Ink | None = None,
+        outline: _Ink | None = None,
+        width: int = 1,
+    ) -> None:
         """Draw a chord."""
-        ink, fill = self._getink(outline, fill)
-        if fill is not None:
-            self.draw.draw_chord(xy, start, end, fill, 1)
-        if ink is not None and ink != fill and width != 0:
+        ink, fill_ink = self._getink(outline, fill)
+        if fill_ink is not None:
+            self.draw.draw_chord(xy, start, end, fill_ink, 1)
+        if ink is not None and ink != fill_ink and width != 0:
             self.draw.draw_chord(xy, start, end, ink, 0, width)
 
-    def ellipse(self, xy: Coords, fill=None, outline=None, width=1) -> None:
+    def ellipse(
+        self,
+        xy: Coords,
+        fill: _Ink | None = None,
+        outline: _Ink | None = None,
+        width: int = 1,
+    ) -> None:
         """Draw an ellipse."""
-        ink, fill = self._getink(outline, fill)
-        if fill is not None:
-            self.draw.draw_ellipse(xy, fill, 1)
-        if ink is not None and ink != fill and width != 0:
+        ink, fill_ink = self._getink(outline, fill)
+        if fill_ink is not None:
+            self.draw.draw_ellipse(xy, fill_ink, 1)
+        if ink is not None and ink != fill_ink and width != 0:
             self.draw.draw_ellipse(xy, ink, 0, width)
 
     def circle(
-        self, xy: Sequence[float], radius: float, fill=None, outline=None, width=1
+        self,
+        xy: Sequence[float],
+        radius: float,
+        fill: _Ink | None = None,
+        outline: _Ink | None = None,
+        width: int = 1,
     ) -> None:
         """Draw a circle given center coordinates and a radius."""
         ellipse_xy = (xy[0] - radius, xy[1] - radius, xy[0] + radius, xy[1] + radius)
         self.ellipse(ellipse_xy, fill, outline, width)
 
-    def line(self, xy: Coords, fill=None, width=0, joint=None) -> None:
+    def line(
+        self,
+        xy: Coords,
+        fill: _Ink | None = None,
+        width: int = 0,
+        joint: str | None = None,
+    ) -> None:
         """Draw a line, or a connected sequence of line segments."""
         ink = self._getink(fill)[0]
         if ink is not None:
@@ -223,7 +270,7 @@ def line(self, xy: Coords, fill=None, width=0, joint=None) -> None:
 
                     def coord_at_angle(
                         coord: Sequence[float], angle: float
-                    ) -> tuple[float, float]:
+                    ) -> tuple[float, ...]:
                         x, y = coord
                         angle -= 90
                         distance = width / 2 - 1
@@ -264,37 +311,54 @@ def coord_at_angle(
                             ]
                         self.line(gap_coords, fill, width=3)
 
-    def shape(self, shape, fill=None, outline=None) -> None:
+    def shape(
+        self,
+        shape: Image.core._Outline,
+        fill: _Ink | None = None,
+        outline: _Ink | None = None,
+    ) -> None:
         """(Experimental) Draw a shape."""
         shape.close()
-        ink, fill = self._getink(outline, fill)
-        if fill is not None:
-            self.draw.draw_outline(shape, fill, 1)
-        if ink is not None and ink != fill:
+        ink, fill_ink = self._getink(outline, fill)
+        if fill_ink is not None:
+            self.draw.draw_outline(shape, fill_ink, 1)
+        if ink is not None and ink != fill_ink:
             self.draw.draw_outline(shape, ink, 0)
 
     def pieslice(
-        self, xy: Coords, start, end, fill=None, outline=None, width=1
+        self,
+        xy: Coords,
+        start: float,
+        end: float,
+        fill: _Ink | None = None,
+        outline: _Ink | None = None,
+        width: int = 1,
     ) -> None:
         """Draw a pieslice."""
-        ink, fill = self._getink(outline, fill)
-        if fill is not None:
-            self.draw.draw_pieslice(xy, start, end, fill, 1)
-        if ink is not None and ink != fill and width != 0:
+        ink, fill_ink = self._getink(outline, fill)
+        if fill_ink is not None:
+            self.draw.draw_pieslice(xy, start, end, fill_ink, 1)
+        if ink is not None and ink != fill_ink and width != 0:
             self.draw.draw_pieslice(xy, start, end, ink, 0, width)
 
-    def point(self, xy: Coords, fill=None) -> None:
+    def point(self, xy: Coords, fill: _Ink | None = None) -> None:
         """Draw one or more individual pixels."""
         ink, fill = self._getink(fill)
         if ink is not None:
             self.draw.draw_points(xy, ink)
 
-    def polygon(self, xy: Coords, fill=None, outline=None, width=1) -> None:
+    def polygon(
+        self,
+        xy: Coords,
+        fill: _Ink | None = None,
+        outline: _Ink | None = None,
+        width: int = 1,
+    ) -> None:
         """Draw a polygon."""
-        ink, fill = self._getink(outline, fill)
-        if fill is not None:
-            self.draw.draw_polygon(xy, fill, 1)
-        if ink is not None and ink != fill and width != 0:
+        ink, fill_ink = self._getink(outline, fill)
+        if fill_ink is not None:
+            self.draw.draw_polygon(xy, fill_ink, 1)
+        if ink is not None and ink != fill_ink and width != 0:
             if width == 1:
                 self.draw.draw_polygon(xy, ink, 0, width)
             elif self.im is not None:
@@ -320,22 +384,41 @@ def polygon(self, xy: Coords, fill=None, outline=None, width=1) -> None:
                 self.im.paste(im.im, (0, 0) + im.size, mask.im)
 
     def regular_polygon(
-        self, bounding_circle, n_sides, rotation=0, fill=None, outline=None, width=1
+        self,
+        bounding_circle: Sequence[Sequence[float] | float],
+        n_sides: int,
+        rotation: float = 0,
+        fill: _Ink | None = None,
+        outline: _Ink | None = None,
+        width: int = 1,
     ) -> None:
         """Draw a regular polygon."""
         xy = _compute_regular_polygon_vertices(bounding_circle, n_sides, rotation)
         self.polygon(xy, fill, outline, width)
 
-    def rectangle(self, xy: Coords, fill=None, outline=None, width=1) -> None:
+    def rectangle(
+        self,
+        xy: Coords,
+        fill: _Ink | None = None,
+        outline: _Ink | None = None,
+        width: int = 1,
+    ) -> None:
         """Draw a rectangle."""
-        ink, fill = self._getink(outline, fill)
-        if fill is not None:
-            self.draw.draw_rectangle(xy, fill, 1)
-        if ink is not None and ink != fill and width != 0:
+        ink, fill_ink = self._getink(outline, fill)
+        if fill_ink is not None:
+            self.draw.draw_rectangle(xy, fill_ink, 1)
+        if ink is not None and ink != fill_ink and width != 0:
             self.draw.draw_rectangle(xy, ink, 0, width)
 
     def rounded_rectangle(
-        self, xy: Coords, radius=0, fill=None, outline=None, width=1, *, corners=None
+        self,
+        xy: Coords,
+        radius: float = 0,
+        fill: _Ink | None = None,
+        outline: _Ink | None = None,
+        width: int = 1,
+        *,
+        corners: tuple[bool, bool, bool, bool] | None = None,
     ) -> None:
         """Draw a rounded rectangle."""
         if isinstance(xy[0], (list, tuple)):
@@ -377,10 +460,10 @@ def rounded_rectangle(
             # that is a rectangle
             return self.rectangle(xy, fill, outline, width)
 
-        r = d // 2
-        ink, fill = self._getink(outline, fill)
+        r = int(d // 2)
+        ink, fill_ink = self._getink(outline, fill)
 
-        def draw_corners(pieslice) -> None:
+        def draw_corners(pieslice: bool) -> None:
             parts: tuple[tuple[tuple[float, float, float, float], int, int], ...]
             if full_x:
                 # Draw top and bottom halves
@@ -410,32 +493,32 @@ def draw_corners(pieslice) -> None:
                 )
             for part in parts:
                 if pieslice:
-                    self.draw.draw_pieslice(*(part + (fill, 1)))
+                    self.draw.draw_pieslice(*(part + (fill_ink, 1)))
                 else:
                     self.draw.draw_arc(*(part + (ink, width)))
 
-        if fill is not None:
+        if fill_ink is not None:
             draw_corners(True)
 
             if full_x:
-                self.draw.draw_rectangle((x0, y0 + r + 1, x1, y1 - r - 1), fill, 1)
+                self.draw.draw_rectangle((x0, y0 + r + 1, x1, y1 - r - 1), fill_ink, 1)
             else:
-                self.draw.draw_rectangle((x0 + r + 1, y0, x1 - r - 1, y1), fill, 1)
+                self.draw.draw_rectangle((x0 + r + 1, y0, x1 - r - 1, y1), fill_ink, 1)
             if not full_x and not full_y:
                 left = [x0, y0, x0 + r, y1]
                 if corners[0]:
                     left[1] += r + 1
                 if corners[3]:
                     left[3] -= r + 1
-                self.draw.draw_rectangle(left, fill, 1)
+                self.draw.draw_rectangle(left, fill_ink, 1)
 
                 right = [x1 - r, y0, x1, y1]
                 if corners[1]:
                     right[1] += r + 1
                 if corners[2]:
                     right[3] -= r + 1
-                self.draw.draw_rectangle(right, fill, 1)
-        if ink is not None and ink != fill and width != 0:
+                self.draw.draw_rectangle(right, fill_ink, 1)
+        if ink is not None and ink != fill_ink and width != 0:
             draw_corners(False)
 
             if not full_x:
@@ -530,10 +613,11 @@ def text(
                 embedded_color,
             )
 
-        def getink(fill):
-            ink, fill = self._getink(fill)
+        def getink(fill: _Ink | None) -> int:
+            ink, fill_ink = self._getink(fill)
             if ink is None:
-                return fill
+                assert fill_ink is not None
+                return fill_ink
             return ink
 
         def draw_text(ink, stroke_width=0, stroke_offset=None) -> None:
@@ -897,13 +981,6 @@ def Draw(im: Image.Image, mode: str | None = None) -> ImageDraw:
         return ImageDraw(im, mode)
 
 
-# experimental access to the outline API
-try:
-    Outline = Image.core.outline
-except AttributeError:
-    Outline = None
-
-
 def getdraw(
     im: Image.Image | None = None, hints: list[str] | None = None
 ) -> tuple[ImageDraw2.Draw | None, ModuleType]:
@@ -983,12 +1060,12 @@ def floodfill(
 
 
 def _compute_regular_polygon_vertices(
-    bounding_circle, n_sides, rotation
+    bounding_circle: Sequence[Sequence[float] | float], n_sides: int, rotation: float
 ) -> list[tuple[float, float]]:
     """
     Generate a list of vertices for a 2D regular polygon.
 
-    :param bounding_circle: The bounding circle is a tuple defined
+    :param bounding_circle: The bounding circle is a sequence defined
         by a point and radius. The polygon is inscribed in this circle.
         (e.g. ``bounding_circle=(x, y, r)`` or ``((x, y), r)``)
     :param n_sides: Number of sides
@@ -1026,7 +1103,7 @@ def _compute_regular_polygon_vertices(
     # 1. Error Handling
     # 1.1 Check `n_sides` has an appropriate value
     if not isinstance(n_sides, int):
-        msg = "n_sides should be an int"
+        msg = "n_sides should be an int"  # type: ignore[unreachable]
         raise TypeError(msg)
     if n_sides < 3:
         msg = "n_sides should be an int > 2"
@@ -1038,9 +1115,24 @@ def _compute_regular_polygon_vertices(
         raise TypeError(msg)
 
     if len(bounding_circle) == 3:
-        *centroid, polygon_radius = bounding_circle
-    elif len(bounding_circle) == 2:
-        centroid, polygon_radius = bounding_circle
+        if not all(isinstance(i, (int, float)) for i in bounding_circle):
+            msg = "bounding_circle should only contain numeric data"
+            raise ValueError(msg)
+
+        *centroid, polygon_radius = cast(List[float], list(bounding_circle))
+    elif len(bounding_circle) == 2 and isinstance(bounding_circle[0], (list, tuple)):
+        if not all(
+            isinstance(i, (int, float)) for i in bounding_circle[0]
+        ) or not isinstance(bounding_circle[1], (int, float)):
+            msg = "bounding_circle should only contain numeric data"
+            raise ValueError(msg)
+
+        if len(bounding_circle[0]) != 2:
+            msg = "bounding_circle centre should contain 2D coordinates (e.g. (x, y))"
+            raise ValueError(msg)
+
+        centroid = cast(List[float], list(bounding_circle[0]))
+        polygon_radius = cast(float, bounding_circle[1])
     else:
         msg = (
             "bounding_circle should contain 2D coordinates "
@@ -1048,25 +1140,17 @@ def _compute_regular_polygon_vertices(
         )
         raise ValueError(msg)
 
-    if not all(isinstance(i, (int, float)) for i in (*centroid, polygon_radius)):
-        msg = "bounding_circle should only contain numeric data"
-        raise ValueError(msg)
-
-    if not len(centroid) == 2:
-        msg = "bounding_circle centre should contain 2D coordinates (e.g. (x, y))"
-        raise ValueError(msg)
-
     if polygon_radius <= 0:
         msg = "bounding_circle radius should be > 0"
         raise ValueError(msg)
 
     # 1.3 Check `rotation` has an appropriate value
     if not isinstance(rotation, (int, float)):
-        msg = "rotation should be an int or float"
+        msg = "rotation should be an int or float"  # type: ignore[unreachable]
         raise ValueError(msg)
 
     # 2. Define Helper Functions
-    def _apply_rotation(point: list[float], degrees: float) -> tuple[int, int]:
+    def _apply_rotation(point: list[float], degrees: float) -> tuple[float, float]:
         return (
             round(
                 point[0] * math.cos(math.radians(360 - degrees))
@@ -1082,7 +1166,7 @@ def _apply_rotation(point: list[float], degrees: float) -> tuple[int, int]:
             ),
         )
 
-    def _compute_polygon_vertex(angle: float) -> tuple[int, int]:
+    def _compute_polygon_vertex(angle: float) -> tuple[float, float]:
         start_point = [polygon_radius, 0]
         return _apply_rotation(start_point, angle)
 
diff --git a/src/PIL/_imaging.pyi b/src/PIL/_imaging.pyi
index dda06b5a1af..2bfe421e6e5 100644
--- a/src/PIL/_imaging.pyi
+++ b/src/PIL/_imaging.pyi
@@ -18,5 +18,10 @@ class ImagingDecoder:
 class ImagingEncoder:
     def __getattr__(self, name: str) -> Any: ...
 
+class _Outline:
+    def close(self) -> None: ...
+    def __getattr__(self, name: str) -> Any: ...
+
 def font(image: ImagingCore, glyphdata: bytes) -> ImagingFont: ...
+def outline() -> _Outline: ...
 def __getattr__(name: str) -> Any: ...

From b64847e07fd32f8865f45600f663655116d46840 Mon Sep 17 00:00:00 2001
From: Nulano <nulano@nulano.eu>
Date: Wed, 19 Jun 2024 21:48:48 +0200
Subject: [PATCH 0727/1178] Do not use a protocol for PixelAccess object

---
 docs/reference/PixelAccess.rst | 22 +++++++++++++++++++---
 src/PIL/Image.py               | 29 ++---------------------------
 src/PIL/_imaging.pyi           |  5 ++++-
 3 files changed, 25 insertions(+), 31 deletions(-)

diff --git a/docs/reference/PixelAccess.rst b/docs/reference/PixelAccess.rst
index 026f488d8e1..1ac3d034b49 100644
--- a/docs/reference/PixelAccess.rst
+++ b/docs/reference/PixelAccess.rst
@@ -44,7 +44,23 @@ Access using negative indexes is also possible. ::
 -----------------------------
 
 .. class:: PixelAccess
-  :canonical: PIL.Image.PixelAccess
+  :canonical: PIL.Image.core.PixelAccess
 
-  .. automethod:: PIL.Image.PixelAccess.__getitem__
-  .. automethod:: PIL.Image.PixelAccess.__setitem__
+  .. method:: __getitem__(self, xy: tuple[int, int]) -> float | tuple[int, ...]
+
+        Returns the pixel at x,y. The pixel is returned as a single
+        value for single band images or a tuple for multi-band images.
+
+        :param xy: The pixel coordinate, given as (x, y).
+        :returns: a pixel value for single band images, a tuple of
+                  pixel values for multiband images.
+
+  .. method:: __setitem__(self, xy: tuple[int, int], color: float | tuple[int, ...]) -> None
+
+        Modifies the pixel at x,y. The color is given as a single
+        numerical value for single band images, and a tuple for
+        multi-band images.
+
+        :param xy: The pixel coordinate, given as (x, y).
+        :param color: The pixel value according to its mode,
+                      e.g. tuple (r, g, b) for RGB mode.
diff --git a/src/PIL/Image.py b/src/PIL/Image.py
index 5619915ea78..26849707ebc 100644
--- a/src/PIL/Image.py
+++ b/src/PIL/Image.py
@@ -227,7 +227,7 @@ class Quantize(IntEnum):
 # Registries
 
 if TYPE_CHECKING:
-    from . import ImageFile
+    from . import ImageFile, PyAccess
 ID: list[str] = []
 OPEN: dict[
     str,
@@ -512,31 +512,6 @@ def _getscaleoffset(expr):
 # Implementation wrapper
 
 
-class PixelAccess(Protocol):
-    def __getitem__(self, xy: tuple[int, int]) -> float | tuple[int, ...]:
-        """
-        Returns the pixel at x,y. The pixel is returned as a single
-        value for single band images or a tuple for multi-band images.
-
-        :param xy: The pixel coordinate, given as (x, y).
-        :returns: a pixel value for single band images, a tuple of
-                  pixel values for multiband images.
-        """
-        raise NotImplementedError()
-
-    def __setitem__(self, xy: tuple[int, int], color: float | tuple[int, ...]) -> None:
-        """
-        Modifies the pixel at x,y. The color is given as a single
-        numerical value for single band images, and a tuple for
-        multi-band images.
-
-        :param xy: The pixel coordinate, given as (x, y).
-        :param color: The pixel value according to its mode,
-                      e.g. tuple (r, g, b) for RGB mode.
-        """
-        raise NotImplementedError()
-
-
 class SupportsGetData(Protocol):
     def getdata(
         self,
@@ -897,7 +872,7 @@ def frombytes(self, data: bytes, decoder_name: str = "raw", *args) -> None:
             msg = "cannot decode image data"
             raise ValueError(msg)
 
-    def load(self) -> PixelAccess | None:
+    def load(self) -> core.PixelAccess | PyAccess.PyAccess | None:
         """
         Allocates storage for the image and loads the pixel data.  In
         normal cases, you don't need to call this method, since the
diff --git a/src/PIL/_imaging.pyi b/src/PIL/_imaging.pyi
index 1fe95441715..1a0184069fc 100644
--- a/src/PIL/_imaging.pyi
+++ b/src/PIL/_imaging.pyi
@@ -10,7 +10,10 @@ class ImagingDraw:
     def __getattr__(self, name: str) -> Any: ...
 
 class PixelAccess:
-    def __getattr__(self, name: str) -> Any: ...
+    def __getitem__(self, xy: tuple[int, int]) -> float | tuple[int, ...]: ...
+    def __setitem__(
+        self, xy: tuple[int, int], color: float | tuple[int, ...]
+    ) -> None: ...
 
 def font(image, glyphdata: bytes) -> ImagingFont: ...
 def __getattr__(name: str) -> Any: ...

From 324e548e525f2e7a3e31bb9dde10086fc202e8b5 Mon Sep 17 00:00:00 2001
From: Andrew Murray <radarhere@users.noreply.github.com>
Date: Fri, 21 Jun 2024 20:41:22 +1000
Subject: [PATCH 0728/1178] Added type hints to ImageFilter

---
 Tests/test_color_lut.py             |  4 +-
 Tests/test_image_filter.py          |  2 +-
 Tests/test_numpy.py                 | 18 +++-----
 docs/reference/internal_modules.rst |  4 ++
 src/PIL/ImageFilter.py              | 72 ++++++++++++++++++++---------
 src/PIL/_typing.py                  | 10 +++-
 6 files changed, 71 insertions(+), 39 deletions(-)

diff --git a/Tests/test_color_lut.py b/Tests/test_color_lut.py
index c8886a7796d..00c8995b08d 100644
--- a/Tests/test_color_lut.py
+++ b/Tests/test_color_lut.py
@@ -354,10 +354,10 @@ def test_overflow(self) -> None:
 class TestColorLut3DFilter:
     def test_wrong_args(self) -> None:
         with pytest.raises(ValueError, match="should be either an integer"):
-            ImageFilter.Color3DLUT("small", [1])
+            ImageFilter.Color3DLUT("small", [1])  # type: ignore[arg-type]
 
         with pytest.raises(ValueError, match="should be either an integer"):
-            ImageFilter.Color3DLUT((11, 11), [1])
+            ImageFilter.Color3DLUT((11, 11), [1])  # type: ignore[arg-type]
 
         with pytest.raises(ValueError, match=r"in \[2, 65\] range"):
             ImageFilter.Color3DLUT((11, 11, 1), [1])
diff --git a/Tests/test_image_filter.py b/Tests/test_image_filter.py
index 1f0644471ee..412ab44c3c1 100644
--- a/Tests/test_image_filter.py
+++ b/Tests/test_image_filter.py
@@ -137,7 +137,7 @@ def test_builtinfilter_p() -> None:
     builtin_filter = ImageFilter.BuiltinFilter()
 
     with pytest.raises(ValueError):
-        builtin_filter.filter(hopper("P"))
+        builtin_filter.filter(hopper("P").im)
 
 
 def test_kernel_not_enough_coefficients() -> None:
diff --git a/Tests/test_numpy.py b/Tests/test_numpy.py
index 36cdb368267..32d2cf9853a 100644
--- a/Tests/test_numpy.py
+++ b/Tests/test_numpy.py
@@ -1,17 +1,17 @@
 from __future__ import annotations
 
 import warnings
-from typing import TYPE_CHECKING, Any
+from typing import TYPE_CHECKING
 
 import pytest
 
-from PIL import Image
+from PIL import Image, _typing
 
 from .helper import assert_deep_equal, assert_image, hopper, skip_unless_feature
 
 if TYPE_CHECKING:
     import numpy
-    import numpy.typing
+    import numpy.typing as npt
 else:
     numpy = pytest.importorskip("numpy", reason="NumPy not installed")
 
@@ -19,9 +19,7 @@
 
 
 def test_numpy_to_image() -> None:
-    def to_image(
-        dtype: numpy.typing.DTypeLike, bands: int = 1, boolean: int = 0
-    ) -> Image.Image:
+    def to_image(dtype: npt.DTypeLike, bands: int = 1, boolean: int = 0) -> Image.Image:
         if bands == 1:
             if boolean:
                 data = [0, 255] * 50
@@ -106,9 +104,7 @@ def test_1d_array() -> None:
     assert_image(Image.fromarray(a), "L", (1, 5))
 
 
-def _test_img_equals_nparray(
-    img: Image.Image, np_img: numpy.typing.NDArray[Any]
-) -> None:
+def _test_img_equals_nparray(img: Image.Image, np_img: _typing.NumpyArray) -> None:
     assert len(np_img.shape) >= 2
     np_size = np_img.shape[1], np_img.shape[0]
     assert img.size == np_size
@@ -166,7 +162,7 @@ def test_save_tiff_uint16() -> None:
         ("HSV", numpy.uint8),
     ),
 )
-def test_to_array(mode: str, dtype: numpy.typing.DTypeLike) -> None:
+def test_to_array(mode: str, dtype: npt.DTypeLike) -> None:
     img = hopper(mode)
 
     # Resize to non-square
@@ -216,7 +212,7 @@ def test_putdata() -> None:
         numpy.float64,
     ),
 )
-def test_roundtrip_eye(dtype: numpy.typing.DTypeLike) -> None:
+def test_roundtrip_eye(dtype: npt.DTypeLike) -> None:
     arr = numpy.eye(10, dtype=dtype)
     numpy.testing.assert_array_equal(arr, numpy.array(Image.fromarray(arr)))
 
diff --git a/docs/reference/internal_modules.rst b/docs/reference/internal_modules.rst
index 899e4966ff2..e4cb17c4d8f 100644
--- a/docs/reference/internal_modules.rst
+++ b/docs/reference/internal_modules.rst
@@ -33,6 +33,10 @@ Internal Modules
 Provides a convenient way to import type hints that are not available
 on some Python versions.
 
+.. py:class:: NumpyArray
+
+    Typing alias.
+
 .. py:class:: StrOrBytesPath
 
     Typing alias.
diff --git a/src/PIL/ImageFilter.py b/src/PIL/ImageFilter.py
index 02288e13576..e18b4a4466a 100644
--- a/src/PIL/ImageFilter.py
+++ b/src/PIL/ImageFilter.py
@@ -19,12 +19,16 @@
 import abc
 import functools
 from types import ModuleType
-from typing import Any, Sequence
+from typing import TYPE_CHECKING, Any, Callable, Sequence, cast
+
+if TYPE_CHECKING:
+    from . import _imaging
+    from ._typing import NumpyArray
 
 
 class Filter:
     @abc.abstractmethod
-    def filter(self, image):
+    def filter(self, image: _imaging.ImagingCore) -> _imaging.ImagingCore:
         pass
 
 
@@ -33,7 +37,9 @@ class MultibandFilter(Filter):
 
 
 class BuiltinFilter(MultibandFilter):
-    def filter(self, image):
+    filterargs: tuple[Any, ...]
+
+    def filter(self, image: _imaging.ImagingCore) -> _imaging.ImagingCore:
         if image.mode == "P":
             msg = "cannot filter palette images"
             raise ValueError(msg)
@@ -91,7 +97,7 @@ def __init__(self, size: int, rank: int) -> None:
         self.size = size
         self.rank = rank
 
-    def filter(self, image):
+    def filter(self, image: _imaging.ImagingCore) -> _imaging.ImagingCore:
         if image.mode == "P":
             msg = "cannot filter palette images"
             raise ValueError(msg)
@@ -158,7 +164,7 @@ class ModeFilter(Filter):
     def __init__(self, size: int = 3) -> None:
         self.size = size
 
-    def filter(self, image):
+    def filter(self, image: _imaging.ImagingCore) -> _imaging.ImagingCore:
         return image.modefilter(self.size)
 
 
@@ -176,9 +182,9 @@ class GaussianBlur(MultibandFilter):
     def __init__(self, radius: float | Sequence[float] = 2) -> None:
         self.radius = radius
 
-    def filter(self, image):
+    def filter(self, image: _imaging.ImagingCore) -> _imaging.ImagingCore:
         xy = self.radius
-        if not isinstance(xy, (tuple, list)):
+        if isinstance(xy, (int, float)):
             xy = (xy, xy)
         if xy == (0, 0):
             return image.copy()
@@ -208,9 +214,9 @@ def __init__(self, radius: float | Sequence[float]) -> None:
             raise ValueError(msg)
         self.radius = radius
 
-    def filter(self, image):
+    def filter(self, image: _imaging.ImagingCore) -> _imaging.ImagingCore:
         xy = self.radius
-        if not isinstance(xy, (tuple, list)):
+        if isinstance(xy, (int, float)):
             xy = (xy, xy)
         if xy == (0, 0):
             return image.copy()
@@ -241,7 +247,7 @@ def __init__(
         self.percent = percent
         self.threshold = threshold
 
-    def filter(self, image):
+    def filter(self, image: _imaging.ImagingCore) -> _imaging.ImagingCore:
         return image.unsharp_mask(self.radius, self.percent, self.threshold)
 
 
@@ -387,8 +393,13 @@ class Color3DLUT(MultibandFilter):
     name = "Color 3D LUT"
 
     def __init__(
-        self, size, table, channels: int = 3, target_mode: str | None = None, **kwargs
-    ):
+        self,
+        size: int | tuple[int, int, int],
+        table: Sequence[float] | Sequence[Sequence[int]] | NumpyArray,
+        channels: int = 3,
+        target_mode: str | None = None,
+        **kwargs: bool,
+    ) -> None:
         if channels not in (3, 4):
             msg = "Only 3 or 4 output channels are supported"
             raise ValueError(msg)
@@ -410,15 +421,16 @@ def __init__(
                 pass
 
         if numpy and isinstance(table, numpy.ndarray):
+            numpy_table: NumpyArray = table
             if copy_table:
-                table = table.copy()
+                numpy_table = numpy_table.copy()
 
-            if table.shape in [
+            if numpy_table.shape in [
                 (items * channels,),
                 (items, channels),
                 (size[2], size[1], size[0], channels),
             ]:
-                table = table.reshape(items * channels)
+                table = numpy_table.reshape(items * channels)
             else:
                 wrong_size = True
 
@@ -428,7 +440,8 @@ def __init__(
 
             # Convert to a flat list
             if table and isinstance(table[0], (list, tuple)):
-                table, raw_table = [], table
+                raw_table = cast(Sequence[Sequence[int]], table)
+                flat_table: list[int] = []
                 for pixel in raw_table:
                     if len(pixel) != channels:
                         msg = (
@@ -436,7 +449,8 @@ def __init__(
                             f"have a length of {channels}."
                         )
                         raise ValueError(msg)
-                    table.extend(pixel)
+                    flat_table.extend(pixel)
+                table = flat_table
 
         if wrong_size or len(table) != items * channels:
             msg = (
@@ -449,7 +463,7 @@ def __init__(
         self.table = table
 
     @staticmethod
-    def _check_size(size: Any) -> list[int]:
+    def _check_size(size: Any) -> tuple[int, int, int]:
         try:
             _, _, _ = size
         except ValueError as e:
@@ -457,7 +471,7 @@ def _check_size(size: Any) -> list[int]:
             raise ValueError(msg) from e
         except TypeError:
             size = (size, size, size)
-        size = [int(x) for x in size]
+        size = tuple(int(x) for x in size)
         for size_1d in size:
             if not 2 <= size_1d <= 65:
                 msg = "Size should be in [2, 65] range."
@@ -465,7 +479,13 @@ def _check_size(size: Any) -> list[int]:
         return size
 
     @classmethod
-    def generate(cls, size, callback, channels=3, target_mode=None):
+    def generate(
+        cls,
+        size: int | tuple[int, int, int],
+        callback: Callable[[float, float, float], tuple[float, ...]],
+        channels: int = 3,
+        target_mode: str | None = None,
+    ) -> Color3DLUT:
         """Generates new LUT using provided callback.
 
         :param size: Size of the table. Passed to the constructor.
@@ -482,7 +502,7 @@ def generate(cls, size, callback, channels=3, target_mode=None):
             msg = "Only 3 or 4 output channels are supported"
             raise ValueError(msg)
 
-        table = [0] * (size_1d * size_2d * size_3d * channels)
+        table: list[float] = [0] * (size_1d * size_2d * size_3d * channels)
         idx_out = 0
         for b in range(size_3d):
             for g in range(size_2d):
@@ -500,7 +520,13 @@ def generate(cls, size, callback, channels=3, target_mode=None):
             _copy_table=False,
         )
 
-    def transform(self, callback, with_normals=False, channels=None, target_mode=None):
+    def transform(
+        self,
+        callback: Callable[..., tuple[float, ...]],
+        with_normals: bool = False,
+        channels: int | None = None,
+        target_mode: str | None = None,
+    ) -> Color3DLUT:
         """Transforms the table values using provided callback and returns
         a new LUT with altered values.
 
@@ -564,7 +590,7 @@ def __repr__(self) -> str:
             r.append(f"target_mode={self.mode}")
         return "<{}>".format(" ".join(r))
 
-    def filter(self, image):
+    def filter(self, image: _imaging.ImagingCore) -> _imaging.ImagingCore:
         from . import Image
 
         return image.color_lut_3d(
diff --git a/src/PIL/_typing.py b/src/PIL/_typing.py
index 7075e86726a..09ece18fa60 100644
--- a/src/PIL/_typing.py
+++ b/src/PIL/_typing.py
@@ -2,7 +2,14 @@
 
 import os
 import sys
-from typing import Protocol, Sequence, TypeVar, Union
+from typing import Any, Protocol, Sequence, TypeVar, Union
+
+try:
+    import numpy.typing as npt
+
+    NumpyArray = npt.NDArray[Any]
+except ImportError:
+    pass
 
 if sys.version_info >= (3, 10):
     from typing import TypeGuard
@@ -10,7 +17,6 @@
     try:
         from typing_extensions import TypeGuard
     except ImportError:
-        from typing import Any
 
         class TypeGuard:  # type: ignore[no-redef]
             def __class_getitem__(cls, item: Any) -> type[bool]:

From c155677c4febece9a280208be11f2dd844fe22ad Mon Sep 17 00:00:00 2001
From: Andrew Murray <radarhere@users.noreply.github.com>
Date: Sat, 22 Jun 2024 00:39:37 +1000
Subject: [PATCH 0729/1178] Removed support for Qt 5

---
 Tests/test_imageqt.py | 19 +++++++------------
 src/PIL/ImageQt.py    |  2 +-
 2 files changed, 8 insertions(+), 13 deletions(-)

diff --git a/Tests/test_imageqt.py b/Tests/test_imageqt.py
index 88ad1f9eee4..22cd674ce28 100644
--- a/Tests/test_imageqt.py
+++ b/Tests/test_imageqt.py
@@ -41,18 +41,13 @@ def checkrgb(r: int, g: int, b: int) -> None:
     checkrgb(0, 0, 255)
 
 
-def test_image() -> None:
-    modes = ["1", "RGB", "RGBA", "L", "P"]
-    qt_format = ImageQt.QImage.Format if ImageQt.qt_version == "6" else ImageQt.QImage
-    if hasattr(qt_format, "Format_Grayscale16"):  # Qt 5.13+
-        modes.append("I;16")
-
-    for mode in modes:
-        im = hopper(mode)
-        roundtripped_im = ImageQt.fromqimage(ImageQt.ImageQt(im))
-        if mode not in ("RGB", "RGBA"):
-            im = im.convert("RGB")
-        assert_image_similar(roundtripped_im, im, 1)
+@pytest.mark.parametrize("mode", ("1", "RGB", "RGBA", "L", "P", "I;16"))
+def test_image(mode: str) -> None:
+    im = hopper(mode)
+    roundtripped_im = ImageQt.fromqimage(ImageQt.ImageQt(im))
+    if mode not in ("RGB", "RGBA"):
+        im = im.convert("RGB")
+    assert_image_similar(roundtripped_im, im, 1)
 
 
 def test_closed_file() -> None:
diff --git a/src/PIL/ImageQt.py b/src/PIL/ImageQt.py
index 293ba4941e3..7819ae9c1f5 100644
--- a/src/PIL/ImageQt.py
+++ b/src/PIL/ImageQt.py
@@ -152,7 +152,7 @@ def _toqclass_helper(im):
     elif im.mode == "RGBA":
         data = im.tobytes("raw", "BGRA")
         format = qt_format.Format_ARGB32
-    elif im.mode == "I;16" and hasattr(qt_format, "Format_Grayscale16"):  # Qt 5.13+
+    elif im.mode == "I;16":
         im = im.point(lambda i: i * 256)
 
         format = qt_format.Format_Grayscale16

From cc83cc8ec866ac0308fc8fc16ff16893540f77e2 Mon Sep 17 00:00:00 2001
From: Andrew Murray <radarhere@users.noreply.github.com>
Date: Sat, 22 Jun 2024 10:09:11 +1000
Subject: [PATCH 0730/1178] Updated type hints

---
 Tests/helper.py              |  4 ++--
 Tests/test_file_jpeg.py      |  4 +++-
 Tests/test_file_png.py       | 16 +++++++---------
 Tests/test_file_ppm.py       | 12 ++++--------
 Tests/test_file_tiff.py      |  2 +-
 Tests/test_font_leaks.py     |  2 +-
 Tests/test_image.py          |  8 ++++----
 Tests/test_image_draft.py    |  4 +++-
 Tests/test_image_paste.py    |  5 +++++
 Tests/test_image_point.py    |  2 +-
 Tests/test_image_putdata.py  |  8 ++++----
 Tests/test_image_resample.py |  2 +-
 Tests/test_imagecms.py       | 11 ++++++-----
 Tests/test_imagedraw.py      |  2 +-
 Tests/test_imagedraw2.py     |  5 +++--
 Tests/test_imagefile.py      |  2 +-
 Tests/test_imagefont.py      |  6 +++---
 Tests/test_imagefontpil.py   |  7 ++++++-
 Tests/test_imagepalette.py   |  2 +-
 Tests/test_psdraw.py         | 12 ++++--------
 src/PIL/Image.py             | 30 +++++++++++++++++++-----------
 src/PIL/ImageDraw.py         |  4 +++-
 src/PIL/ImageFont.py         | 12 ++++++++----
 src/PIL/ImageQt.py           |  2 +-
 src/PIL/ImageTransform.py    |  2 +-
 src/PIL/JpegImagePlugin.py   |  2 +-
 src/PIL/TiffTags.py          |  6 ++++--
 27 files changed, 98 insertions(+), 76 deletions(-)

diff --git a/Tests/helper.py b/Tests/helper.py
index fe337c09f5c..605a214d400 100644
--- a/Tests/helper.py
+++ b/Tests/helper.py
@@ -18,7 +18,7 @@
 import pytest
 from packaging.version import parse as parse_version
 
-from PIL import Image, ImageMath, features
+from PIL import Image, ImageFile, ImageMath, features
 
 logger = logging.getLogger(__name__)
 
@@ -240,7 +240,7 @@ def _test_leak(self, core: Callable[[], None]) -> None:
 # helpers
 
 
-def fromstring(data: bytes) -> Image.Image:
+def fromstring(data: bytes) -> ImageFile.ImageFile:
     return Image.open(BytesIO(data))
 
 
diff --git a/Tests/test_file_jpeg.py b/Tests/test_file_jpeg.py
index 02d0b29d8c8..dbd91751712 100644
--- a/Tests/test_file_jpeg.py
+++ b/Tests/test_file_jpeg.py
@@ -1033,8 +1033,10 @@ def test_separate_tables(self) -> None:
 
     def test_repr_jpeg(self) -> None:
         im = hopper()
+        b = im._repr_jpeg_()
+        assert b is not None
 
-        with Image.open(BytesIO(im._repr_jpeg_())) as repr_jpeg:
+        with Image.open(BytesIO(b)) as repr_jpeg:
             assert repr_jpeg.format == "JPEG"
             assert_image_similar(im, repr_jpeg, 17)
 
diff --git a/Tests/test_file_png.py b/Tests/test_file_png.py
index 46714a0f00b..0f09768028e 100644
--- a/Tests/test_file_png.py
+++ b/Tests/test_file_png.py
@@ -535,8 +535,10 @@ def test_roundtrip_no_icc_profile(self) -> None:
 
     def test_repr_png(self) -> None:
         im = hopper()
+        b = im._repr_png_()
+        assert b is not None
 
-        with Image.open(BytesIO(im._repr_png_())) as repr_png:
+        with Image.open(BytesIO(b)) as repr_png:
             assert repr_png.format == "PNG"
             assert_image_equal(im, repr_png)
 
@@ -768,14 +770,10 @@ def test_seek(self) -> None:
     def test_save_stdout(self, buffer: bool) -> None:
         old_stdout = sys.stdout
 
-        if buffer:
+        class MyStdOut:
+            buffer = BytesIO()
 
-            class MyStdOut:
-                buffer = BytesIO()
-
-            mystdout = MyStdOut()
-        else:
-            mystdout = BytesIO()
+        mystdout: MyStdOut | BytesIO = MyStdOut() if buffer else BytesIO()
 
         sys.stdout = mystdout
 
@@ -785,7 +783,7 @@ class MyStdOut:
         # Reset stdout
         sys.stdout = old_stdout
 
-        if buffer:
+        if isinstance(mystdout, MyStdOut):
             mystdout = mystdout.buffer
         with Image.open(mystdout) as reloaded:
             assert_image_equal_tofile(reloaded, TEST_PNG_FILE)
diff --git a/Tests/test_file_ppm.py b/Tests/test_file_ppm.py
index 1bfd0434e96..0a61830a40a 100644
--- a/Tests/test_file_ppm.py
+++ b/Tests/test_file_ppm.py
@@ -368,14 +368,10 @@ def test_mimetypes(tmp_path: Path) -> None:
 def test_save_stdout(buffer: bool) -> None:
     old_stdout = sys.stdout
 
-    if buffer:
+    class MyStdOut:
+        buffer = BytesIO()
 
-        class MyStdOut:
-            buffer = BytesIO()
-
-        mystdout = MyStdOut()
-    else:
-        mystdout = BytesIO()
+    mystdout: MyStdOut | BytesIO = MyStdOut() if buffer else BytesIO()
 
     sys.stdout = mystdout
 
@@ -385,7 +381,7 @@ class MyStdOut:
     # Reset stdout
     sys.stdout = old_stdout
 
-    if buffer:
+    if isinstance(mystdout, MyStdOut):
         mystdout = mystdout.buffer
     with Image.open(mystdout) as reloaded:
         assert_image_equal_tofile(reloaded, TEST_FILE)
diff --git a/Tests/test_file_tiff.py b/Tests/test_file_tiff.py
index 17dab25e91b..08ff334ac45 100644
--- a/Tests/test_file_tiff.py
+++ b/Tests/test_file_tiff.py
@@ -120,7 +120,7 @@ def test_seek_too_large(self) -> None:
     def test_set_legacy_api(self) -> None:
         ifd = TiffImagePlugin.ImageFileDirectory_v2()
         with pytest.raises(Exception) as e:
-            ifd.legacy_api = None
+            ifd.legacy_api = False
         assert str(e.value) == "Not allowing setting of legacy api"
 
     def test_xyres_tiff(self) -> None:
diff --git a/Tests/test_font_leaks.py b/Tests/test_font_leaks.py
index 3fb92a62edb..ab8a7f9ecca 100644
--- a/Tests/test_font_leaks.py
+++ b/Tests/test_font_leaks.py
@@ -34,7 +34,7 @@ class TestDefaultFontLeak(TestTTypeFontLeak):
 
     def test_leak(self) -> None:
         if features.check_module("freetype2"):
-            ImageFont.core = _util.DeferredError(ImportError)
+            ImageFont.core = _util.DeferredError(ImportError("Disabled for testing"))
         try:
             default_font = ImageFont.load_default()
         finally:
diff --git a/Tests/test_image.py b/Tests/test_image.py
index 35a7a49a876..a8f61d67700 100644
--- a/Tests/test_image.py
+++ b/Tests/test_image.py
@@ -393,13 +393,13 @@ def test_alpha_inplace(self) -> None:
 
         # errors
         with pytest.raises(ValueError):
-            source.alpha_composite(over, "invalid source")
+            source.alpha_composite(over, "invalid destination")  # type: ignore[arg-type]
         with pytest.raises(ValueError):
-            source.alpha_composite(over, (0, 0), "invalid destination")
+            source.alpha_composite(over, (0, 0), "invalid source")  # type: ignore[arg-type]
         with pytest.raises(ValueError):
-            source.alpha_composite(over, 0)
+            source.alpha_composite(over, 0)  # type: ignore[arg-type]
         with pytest.raises(ValueError):
-            source.alpha_composite(over, (0, 0), 0)
+            source.alpha_composite(over, (0, 0), 0)  # type: ignore[arg-type]
         with pytest.raises(ValueError):
             source.alpha_composite(over, (0, 0), (0, -1))
 
diff --git a/Tests/test_image_draft.py b/Tests/test_image_draft.py
index 1ce1a7cd8f6..c9d8c93f314 100644
--- a/Tests/test_image_draft.py
+++ b/Tests/test_image_draft.py
@@ -16,7 +16,9 @@ def draft_roundtrip(
     im = Image.new(in_mode, in_size)
     data = tostring(im, "JPEG")
     im = fromstring(data)
-    mode, box = im.draft(req_mode, req_size)
+    result = im.draft(req_mode, req_size)
+    assert result is not None
+    box = result[1]
     scale, _ = im.decoderconfig
     assert box[:2] == (0, 0)
     assert (im.width - scale) < box[2] <= im.width
diff --git a/Tests/test_image_paste.py b/Tests/test_image_paste.py
index d8f6b65e0d8..01cb880cb31 100644
--- a/Tests/test_image_paste.py
+++ b/Tests/test_image_paste.py
@@ -338,3 +338,8 @@ def test_different_sizes(self) -> None:
 
         im.copy().paste(im2)
         im.copy().paste(im2, (0, 0))
+
+    def test_incorrect_abbreviated_form(self) -> None:
+        im = Image.new("L", (1, 1))
+        with pytest.raises(ValueError):
+            im.paste(im, im, im)
diff --git a/Tests/test_image_point.py b/Tests/test_image_point.py
index 05f209351d2..a5d5a15dbab 100644
--- a/Tests/test_image_point.py
+++ b/Tests/test_image_point.py
@@ -61,4 +61,4 @@ def test_f_lut() -> None:
 def test_f_mode() -> None:
     im = hopper("F")
     with pytest.raises(ValueError):
-        im.point(None)
+        im.point([])
diff --git a/Tests/test_image_putdata.py b/Tests/test_image_putdata.py
index 5e57e4c4c8f..dad26ef144c 100644
--- a/Tests/test_image_putdata.py
+++ b/Tests/test_image_putdata.py
@@ -113,13 +113,13 @@ def test_array_F() -> None:
 def test_not_flattened() -> None:
     im = Image.new("L", (1, 1))
     with pytest.raises(TypeError):
-        im.putdata([[0]])  # type: ignore[list-item]
+        im.putdata([[0]])
     with pytest.raises(TypeError):
-        im.putdata([[0]], 2)  # type: ignore[list-item]
+        im.putdata([[0]], 2)
 
     with pytest.raises(TypeError):
         im = Image.new("I", (1, 1))
-        im.putdata([[0]])  # type: ignore[list-item]
+        im.putdata([[0]])
     with pytest.raises(TypeError):
         im = Image.new("F", (1, 1))
-        im.putdata([[0]])  # type: ignore[list-item]
+        im.putdata([[0]])
diff --git a/Tests/test_image_resample.py b/Tests/test_image_resample.py
index 9b3bdf3306f..d6055b577e3 100644
--- a/Tests/test_image_resample.py
+++ b/Tests/test_image_resample.py
@@ -445,7 +445,7 @@ def test_wrong_arguments(self, resample: Image.Resampling) -> None:
         im.resize((32, 32), resample, (20, 20, 100, 20))
 
         with pytest.raises(TypeError, match="must be sequence of length 4"):
-            im.resize((32, 32), resample, (im.width, im.height))
+            im.resize((32, 32), resample, (im.width, im.height))  # type: ignore[arg-type]
 
         with pytest.raises(ValueError, match="can't be negative"):
             im.resize((32, 32), resample, (-20, 20, 100, 100))
diff --git a/Tests/test_imagecms.py b/Tests/test_imagecms.py
index 55f72c3b95c..8a25460d36a 100644
--- a/Tests/test_imagecms.py
+++ b/Tests/test_imagecms.py
@@ -103,7 +103,7 @@ def test_sanity() -> None:
 
 
 def test_flags() -> None:
-    assert ImageCms.Flags.NONE == 0
+    assert ImageCms.Flags.NONE.value == 0
     assert ImageCms.Flags.GRIDPOINTS(0) == ImageCms.Flags.NONE
     assert ImageCms.Flags.GRIDPOINTS(256) == ImageCms.Flags.NONE
 
@@ -569,9 +569,9 @@ def create_test_image() -> Image.Image:
             for delta in nine_grid_deltas:
                 channel_data.paste(
                     channel_pattern,
-                    tuple(
-                        paste_offset[c] + delta[c] * channel_pattern.size[c]
-                        for c in range(2)
+                    (
+                        paste_offset[0] + delta[0] * channel_pattern.size[0],
+                        paste_offset[1] + delta[1] * channel_pattern.size[1],
                     ),
                 )
             chans.append(channel_data)
@@ -642,7 +642,8 @@ def test_auxiliary_channels_isolated() -> None:
                 # convert with and without AUX data, test colors are equal
                 src_colorSpace = cast(Literal["LAB", "XYZ", "sRGB"], src_format[1])
                 source_profile = ImageCms.createProfile(src_colorSpace)
-                destination_profile = ImageCms.createProfile(dst_format[1])
+                dst_colorSpace = cast(Literal["LAB", "XYZ", "sRGB"], dst_format[1])
+                destination_profile = ImageCms.createProfile(dst_colorSpace)
                 source_image = src_format[3]
                 test_transform = ImageCms.buildTransform(
                     source_profile,
diff --git a/Tests/test_imagedraw.py b/Tests/test_imagedraw.py
index 8b55df992e1..a24aa16caba 100644
--- a/Tests/test_imagedraw.py
+++ b/Tests/test_imagedraw.py
@@ -1581,7 +1581,7 @@ def test_compute_regular_polygon_vertices_input_error_handling(
     error_message: str,
 ) -> None:
     with pytest.raises(expected_error) as e:
-        ImageDraw._compute_regular_polygon_vertices(bounding_circle, n_sides, rotation)
+        ImageDraw._compute_regular_polygon_vertices(bounding_circle, n_sides, rotation)  # type: ignore[arg-type]
     assert str(e.value) == error_message
 
 
diff --git a/Tests/test_imagedraw2.py b/Tests/test_imagedraw2.py
index 3171eb9aec1..35fe0cf40dd 100644
--- a/Tests/test_imagedraw2.py
+++ b/Tests/test_imagedraw2.py
@@ -51,9 +51,10 @@ def test_sanity() -> None:
     pen = ImageDraw2.Pen("blue", width=7)
     draw.line(list(range(10)), pen)
 
-    draw, handler = ImageDraw.getdraw(im)
+    draw2, handler = ImageDraw.getdraw(im)
+    assert draw2 is not None
     pen = ImageDraw2.Pen("blue", width=7)
-    draw.line(list(range(10)), pen)
+    draw2.line(list(range(10)), pen)
 
 
 @pytest.mark.parametrize("bbox", BBOX)
diff --git a/Tests/test_imagefile.py b/Tests/test_imagefile.py
index c9dba294359..00cdec95255 100644
--- a/Tests/test_imagefile.py
+++ b/Tests/test_imagefile.py
@@ -381,7 +381,7 @@ def test_oversize(self) -> None:
     def test_encode(self) -> None:
         encoder = ImageFile.PyEncoder(None)
         with pytest.raises(NotImplementedError):
-            encoder.encode(None)
+            encoder.encode(0)
 
         bytes_consumed, errcode = encoder.encode_to_pyfd()
         assert bytes_consumed == 0
diff --git a/Tests/test_imagefont.py b/Tests/test_imagefont.py
index 73cad513e62..9f5c3984bad 100644
--- a/Tests/test_imagefont.py
+++ b/Tests/test_imagefont.py
@@ -209,7 +209,7 @@ def test_getlength(
         assert length == length_raqm
 
 
-def test_float_size() -> None:
+def test_float_size(layout_engine: ImageFont.Layout) -> None:
     lengths = []
     for size in (48, 48.5, 49):
         f = ImageFont.truetype(
@@ -494,8 +494,8 @@ def test_default_font() -> None:
     assert_image_equal_tofile(im, "Tests/images/default_font_freetype.png")
 
 
-@pytest.mark.parametrize("mode", (None, "1", "RGBA"))
-def test_getbbox(font: ImageFont.FreeTypeFont, mode: str | None) -> None:
+@pytest.mark.parametrize("mode", ("", "1", "RGBA"))
+def test_getbbox(font: ImageFont.FreeTypeFont, mode: str) -> None:
     assert (0, 4, 12, 16) == font.getbbox("A", mode)
 
 
diff --git a/Tests/test_imagefontpil.py b/Tests/test_imagefontpil.py
index 3b1c14b4e18..c4a39d1faf2 100644
--- a/Tests/test_imagefontpil.py
+++ b/Tests/test_imagefontpil.py
@@ -14,7 +14,7 @@
 
 def setup_module() -> None:
     if features.check_module("freetype2"):
-        ImageFont.core = _util.DeferredError(ImportError)
+        ImageFont.core = _util.DeferredError(ImportError("Disabled for testing"))
 
 
 def teardown_module() -> None:
@@ -76,3 +76,8 @@ def test_oom() -> None:
     font = ImageFont.ImageFont()
     font._load_pilfont_data(fp, Image.new("L", (1, 1)))
     font.getmask("A" * 1_000_000)
+
+
+def test_freetypefont_without_freetype() -> None:
+    with pytest.raises(ImportError):
+        ImageFont.truetype("Tests/fonts/FreeMono.ttf")
diff --git a/Tests/test_imagepalette.py b/Tests/test_imagepalette.py
index 8e2db15aab7..17f68710a48 100644
--- a/Tests/test_imagepalette.py
+++ b/Tests/test_imagepalette.py
@@ -45,7 +45,7 @@ def test_getcolor() -> None:
 
     # Test unknown color specifier
     with pytest.raises(ValueError):
-        palette.getcolor("unknown")
+        palette.getcolor("unknown")  # type: ignore[arg-type]
 
 
 def test_getcolor_rgba_color_rgb_palette() -> None:
diff --git a/Tests/test_psdraw.py b/Tests/test_psdraw.py
index 64dfb2c95fb..c3afa908937 100644
--- a/Tests/test_psdraw.py
+++ b/Tests/test_psdraw.py
@@ -54,14 +54,10 @@ def test_stdout(buffer: bool) -> None:
     # Temporarily redirect stdout
     old_stdout = sys.stdout
 
-    if buffer:
+    class MyStdOut:
+        buffer = BytesIO()
 
-        class MyStdOut:
-            buffer = BytesIO()
-
-        mystdout = MyStdOut()
-    else:
-        mystdout = BytesIO()
+    mystdout: MyStdOut | BytesIO = MyStdOut() if buffer else BytesIO()
 
     sys.stdout = mystdout
 
@@ -71,6 +67,6 @@ class MyStdOut:
     # Reset stdout
     sys.stdout = old_stdout
 
-    if buffer:
+    if isinstance(mystdout, MyStdOut):
         mystdout = mystdout.buffer
     assert mystdout.getvalue() != b""
diff --git a/src/PIL/Image.py b/src/PIL/Image.py
index 57da58522e7..6e2f3865039 100644
--- a/src/PIL/Image.py
+++ b/src/PIL/Image.py
@@ -1168,7 +1168,7 @@ def convert_transparency(
     def quantize(
         self,
         colors: int = 256,
-        method: Quantize | None = None,
+        method: int | None = None,
         kmeans: int = 0,
         palette=None,
         dither: Dither = Dither.FLOYDSTEINBERG,
@@ -1309,7 +1309,7 @@ def _crop(
         return im.crop((x0, y0, x1, y1))
 
     def draft(
-        self, mode: str | None, size: tuple[int, int]
+        self, mode: str | None, size: tuple[int, int] | None
     ) -> tuple[str, tuple[int, int, float, float]] | None:
         """
         Configures the image file loader so it returns a version of the
@@ -1744,7 +1744,7 @@ def entropy(self, mask=None, extrema=None):
     def paste(
         self,
         im: Image | str | float | tuple[float, ...],
-        box: tuple[int, int, int, int] | tuple[int, int] | None = None,
+        box: Image | tuple[int, int, int, int] | tuple[int, int] | None = None,
         mask: Image | None = None,
     ) -> None:
         """
@@ -1786,10 +1786,14 @@ def paste(
         :param mask: An optional mask image.
         """
 
-        if isImageType(box) and mask is None:
+        if isImageType(box):
+            if mask is not None:
+                msg = "If using second argument as mask, third argument must be None"
+                raise ValueError(msg)
             # abbreviated paste(im, mask) syntax
             mask = box
             box = None
+        assert not isinstance(box, Image)
 
         if box is None:
             box = (0, 0)
@@ -1995,7 +1999,10 @@ def putalpha(self, alpha):
         self.im.putband(alpha.im, band)
 
     def putdata(
-        self, data: Sequence[float], scale: float = 1.0, offset: float = 0.0
+        self,
+        data: Sequence[float] | Sequence[Sequence[int]],
+        scale: float = 1.0,
+        offset: float = 0.0,
     ) -> None:
         """
         Copies pixel data from a flattened sequence object into the image. The
@@ -2656,7 +2663,7 @@ def thumbnail(
         self,
         size: tuple[float, float],
         resample: Resampling = Resampling.BICUBIC,
-        reducing_gap: float = 2.0,
+        reducing_gap: float | None = 2.0,
     ) -> None:
         """
         Make this image into a thumbnail.  This method modifies the
@@ -2717,11 +2724,12 @@ def round_aspect(number, key):
             return x, y
 
         box = None
+        final_size: tuple[int, int]
         if reducing_gap is not None:
             preserved_size = preserve_aspect_ratio()
             if preserved_size is None:
                 return
-            size = preserved_size
+            final_size = preserved_size
 
             res = self.draft(
                 None, (int(size[0] * reducing_gap), int(size[1] * reducing_gap))
@@ -2735,13 +2743,13 @@ def round_aspect(number, key):
             preserved_size = preserve_aspect_ratio()
             if preserved_size is None:
                 return
-            size = preserved_size
+            final_size = preserved_size
 
-        if self.size != size:
-            im = self.resize(size, resample, box=box, reducing_gap=reducing_gap)
+        if self.size != final_size:
+            im = self.resize(final_size, resample, box=box, reducing_gap=reducing_gap)
 
             self.im = im.im
-            self._size = size
+            self._size = final_size
             self._mode = self.im.mode
 
         self.readonly = 0
diff --git a/src/PIL/ImageDraw.py b/src/PIL/ImageDraw.py
index 91f8988387d..a471a7ffde9 100644
--- a/src/PIL/ImageDraw.py
+++ b/src/PIL/ImageDraw.py
@@ -62,7 +62,9 @@
 
 
 class ImageDraw:
-    font = None
+    font: (
+        ImageFont.ImageFont | ImageFont.FreeTypeFont | ImageFont.TransposedFont | None
+    ) = None
 
     def __init__(self, im: Image.Image, mode: str | None = None) -> None:
         """
diff --git a/src/PIL/ImageFont.py b/src/PIL/ImageFont.py
index fa5608e6cd8..61e7a7abec4 100644
--- a/src/PIL/ImageFont.py
+++ b/src/PIL/ImageFont.py
@@ -33,11 +33,12 @@
 import warnings
 from enum import IntEnum
 from io import BytesIO
+from types import ModuleType
 from typing import IO, TYPE_CHECKING, Any, BinaryIO
 
 from . import Image
 from ._typing import StrOrBytesPath
-from ._util import is_path
+from ._util import DeferredError, is_path
 
 if TYPE_CHECKING:
     from . import ImageFile
@@ -53,11 +54,10 @@ class Layout(IntEnum):
 MAX_STRING_LENGTH = 1_000_000
 
 
+core: ModuleType | DeferredError
 try:
     from . import _imagingft as core
 except ImportError as ex:
-    from ._util import DeferredError
-
     core = DeferredError.new(ex)
 
 
@@ -199,6 +199,7 @@ class FreeTypeFont:
     """FreeType font wrapper (requires _imagingft service)"""
 
     font: Font
+    font_bytes: bytes
 
     def __init__(
         self,
@@ -210,6 +211,9 @@ def __init__(
     ) -> None:
         # FIXME: use service provider instead
 
+        if isinstance(core, DeferredError):
+            raise core.ex
+
         if size <= 0:
             msg = "font size must be greater than 0"
             raise ValueError(msg)
@@ -903,7 +907,7 @@ def load_default(size: float | None = None) -> FreeTypeFont | ImageFont:
     :return: A font object.
     """
     f: FreeTypeFont | ImageFont
-    if core.__class__.__name__ == "module" or size is not None:
+    if isinstance(core, ModuleType) or size is not None:
         f = truetype(
             BytesIO(
                 base64.b64decode(
diff --git a/src/PIL/ImageQt.py b/src/PIL/ImageQt.py
index 293ba4941e3..a0c16b7656b 100644
--- a/src/PIL/ImageQt.py
+++ b/src/PIL/ImageQt.py
@@ -196,7 +196,7 @@ def __init__(self, im):
                 self.setColorTable(im_data["colortable"])
 
 
-def toqimage(im):
+def toqimage(im) -> ImageQt:
     return ImageQt(im)
 
 
diff --git a/src/PIL/ImageTransform.py b/src/PIL/ImageTransform.py
index 80a6116b7cf..ffd7916745c 100644
--- a/src/PIL/ImageTransform.py
+++ b/src/PIL/ImageTransform.py
@@ -24,7 +24,7 @@ class Transform(Image.ImageTransformHandler):
 
     method: Image.Transform
 
-    def __init__(self, data: Sequence[int]) -> None:
+    def __init__(self, data: Sequence[Any]) -> None:
         self.data = data
 
     def getdata(self) -> tuple[Image.Transform, Sequence[int]]:
diff --git a/src/PIL/JpegImagePlugin.py b/src/PIL/JpegImagePlugin.py
index 7a32f1cdec0..9d6811cb759 100644
--- a/src/PIL/JpegImagePlugin.py
+++ b/src/PIL/JpegImagePlugin.py
@@ -428,7 +428,7 @@ def load_read(self, read_bytes: int) -> bytes:
         return s
 
     def draft(
-        self, mode: str | None, size: tuple[int, int]
+        self, mode: str | None, size: tuple[int, int] | None
     ) -> tuple[str, tuple[int, int, float, float]] | None:
         if len(self.tile) != 1:
             return None
diff --git a/src/PIL/TiffTags.py b/src/PIL/TiffTags.py
index 89fad703343..e318c87398c 100644
--- a/src/PIL/TiffTags.py
+++ b/src/PIL/TiffTags.py
@@ -89,7 +89,7 @@ def lookup(tag, group=None):
 IFD = 13
 LONG8 = 16
 
-TAGS_V2 = {
+_tags_v2 = {
     254: ("NewSubfileType", LONG, 1),
     255: ("SubfileType", SHORT, 1),
     256: ("ImageWidth", LONG, 1),
@@ -425,9 +425,11 @@ def lookup(tag, group=None):
     50784: "Alias Layer Metadata",
 }
 
+TAGS_V2: dict[int, TagInfo] = {}
+
 
 def _populate():
-    for k, v in TAGS_V2.items():
+    for k, v in _tags_v2.items():
         # Populate legacy structure.
         TAGS[k] = v[0]
         if len(v) == 4:

From a2c0a90c44db86c78ccd2cb7ed1a08829e5389bb Mon Sep 17 00:00:00 2001
From: Yay295 <Yay295@gmail.com>
Date: Mon, 17 Jun 2024 01:23:36 -0500
Subject: [PATCH 0731/1178] check required EPS header comments at end of file,
 not always

---
 src/PIL/EpsImagePlugin.py | 9 +++++++--
 1 file changed, 7 insertions(+), 2 deletions(-)

diff --git a/src/PIL/EpsImagePlugin.py b/src/PIL/EpsImagePlugin.py
index 380b1cf0ec4..c7f9625c962 100644
--- a/src/PIL/EpsImagePlugin.py
+++ b/src/PIL/EpsImagePlugin.py
@@ -230,6 +230,11 @@ def _open(self) -> None:
         trailer_reached = False
 
         def check_required_header_comments() -> None:
+            """
+            The EPS spec requires that some headers exist.
+            This should be checked after all headers have been read,
+            or at the end of the file if that comes first.
+            """
             if "PS-Adobe" not in self.info:
                 msg = 'EPS header missing "%!PS-Adobe" comment'
                 raise SyntaxError(msg)
@@ -270,6 +275,8 @@ def _read_comment(s: str) -> bool:
             if byte == b"":
                 # if we didn't read a byte we must be at the end of the file
                 if bytes_read == 0:
+                    if reading_header_comments:
+                        check_required_header_comments()
                     break
             elif byte in b"\r\n":
                 # if we read a line ending character, ignore it and parse what
@@ -365,8 +372,6 @@ def _read_comment(s: str) -> bool:
                 trailer_reached = True
             bytes_read = 0
 
-        check_required_header_comments()
-
         if not self._size:
             msg = "cannot determine EPS bounding box"
             raise OSError(msg)

From 00c9448cb0610dd957789de402c331ae3000dc5a Mon Sep 17 00:00:00 2001
From: Andrew Murray <radarhere@users.noreply.github.com>
Date: Sun, 23 Jun 2024 21:37:41 +1000
Subject: [PATCH 0732/1178] Update CHANGES.rst [ci skip]

---
 CHANGES.rst | 15 +++++++++++++++
 1 file changed, 15 insertions(+)

diff --git a/CHANGES.rst b/CHANGES.rst
index d7231ebeabf..ec3073446bf 100644
--- a/CHANGES.rst
+++ b/CHANGES.rst
@@ -5,6 +5,21 @@ Changelog (Pillow)
 10.4.0 (unreleased)
 -------------------
 
+- Support unpacking more rawmodes to RGBA palettes #7966
+  [radarhere]
+
+- Removed support for Qt 5 #8159
+  [radarhere]
+
+- Improve ``ImageFont.freetype`` support for XDG directories on Linux #8135
+  [mamg22, radarhere]
+
+- Improved consistency of XMP handling #8069
+  [radarhere]
+
+- Use pkg-config to help find libwebp and raqm #8142
+  [radarhere]
+
 - Accept 't' suffix for libtiff version #8126, #8129
   [radarhere]
 

From 42381aa1e65735f67f4abbae170d97082f212de5 Mon Sep 17 00:00:00 2001
From: Andrew Murray <radarhere@users.noreply.github.com>
Date: Mon, 24 Jun 2024 06:59:00 +1000
Subject: [PATCH 0733/1178] Added type hints

---
 Tests/test_file_bufrstub.py      |  7 +++++--
 Tests/test_file_gribstub.py      |  7 +++++--
 Tests/test_file_hdf5stub.py      |  7 +++++--
 Tests/test_file_png.py           |  2 +-
 Tests/test_file_ppm.py           |  2 +-
 Tests/test_file_psd.py           |  2 +-
 Tests/test_file_tiff_metadata.py | 10 +++++++---
 Tests/test_file_webp.py          |  5 ++++-
 Tests/test_image.py              | 16 ++++++++++++----
 Tests/test_image_array.py        |  7 +++++--
 Tests/test_imagefile.py          |  4 +++-
 Tests/test_imagefont.py          |  2 +-
 Tests/test_imagewin_pointers.py  | 11 ++++++-----
 Tests/test_psdraw.py             |  2 +-
 14 files changed, 57 insertions(+), 27 deletions(-)

diff --git a/Tests/test_file_bufrstub.py b/Tests/test_file_bufrstub.py
index 939e82e7717..77ee5b0ea12 100644
--- a/Tests/test_file_bufrstub.py
+++ b/Tests/test_file_bufrstub.py
@@ -64,6 +64,9 @@ def load(self, im: ImageFile.StubImageFile) -> Image.Image:
             im.fp.close()
             return Image.new("RGB", (1, 1))
 
+        def is_loaded(self) -> bool:
+            return self.loaded
+
         def save(self, im: Image.Image, fp: IO[bytes], filename: str) -> None:
             self.saved = True
 
@@ -71,10 +74,10 @@ def save(self, im: Image.Image, fp: IO[bytes], filename: str) -> None:
     BufrStubImagePlugin.register_handler(handler)
     with Image.open(TEST_FILE) as im:
         assert handler.opened
-        assert not handler.loaded
+        assert not handler.is_loaded()
 
         im.load()
-        assert handler.loaded
+        assert handler.is_loaded()
 
         temp_file = str(tmp_path / "temp.bufr")
         im.save(temp_file)
diff --git a/Tests/test_file_gribstub.py b/Tests/test_file_gribstub.py
index 86a9064fc46..aba473d24d0 100644
--- a/Tests/test_file_gribstub.py
+++ b/Tests/test_file_gribstub.py
@@ -64,6 +64,9 @@ def load(self, im: Image.Image) -> Image.Image:
             im.fp.close()
             return Image.new("RGB", (1, 1))
 
+        def is_loaded(self) -> bool:
+            return self.loaded
+
         def save(self, im: Image.Image, fp: IO[bytes], filename: str) -> None:
             self.saved = True
 
@@ -71,10 +74,10 @@ def save(self, im: Image.Image, fp: IO[bytes], filename: str) -> None:
     GribStubImagePlugin.register_handler(handler)
     with Image.open(TEST_FILE) as im:
         assert handler.opened
-        assert not handler.loaded
+        assert not handler.is_loaded()
 
         im.load()
-        assert handler.loaded
+        assert handler.is_loaded()
 
         temp_file = str(tmp_path / "temp.grib")
         im.save(temp_file)
diff --git a/Tests/test_file_hdf5stub.py b/Tests/test_file_hdf5stub.py
index ee1544c51fa..8275bd0d890 100644
--- a/Tests/test_file_hdf5stub.py
+++ b/Tests/test_file_hdf5stub.py
@@ -66,6 +66,9 @@ def load(self, im: Image.Image) -> Image.Image:
             im.fp.close()
             return Image.new("RGB", (1, 1))
 
+        def is_loaded(self) -> bool:
+            return self.loaded
+
         def save(self, im: Image.Image, fp: IO[bytes], filename: str) -> None:
             self.saved = True
 
@@ -73,10 +76,10 @@ def save(self, im: Image.Image, fp: IO[bytes], filename: str) -> None:
     Hdf5StubImagePlugin.register_handler(handler)
     with Image.open(TEST_FILE) as im:
         assert handler.opened
-        assert not handler.loaded
+        assert not handler.is_loaded()
 
         im.load()
-        assert handler.loaded
+        assert handler.is_loaded()
 
         temp_file = str(tmp_path / "temp.h5")
         im.save(temp_file)
diff --git a/Tests/test_file_png.py b/Tests/test_file_png.py
index 0f09768028e..a8b50a6d4cd 100644
--- a/Tests/test_file_png.py
+++ b/Tests/test_file_png.py
@@ -775,7 +775,7 @@ class MyStdOut:
 
         mystdout: MyStdOut | BytesIO = MyStdOut() if buffer else BytesIO()
 
-        sys.stdout = mystdout
+        sys.stdout = mystdout  # type: ignore[assignment]
 
         with Image.open(TEST_PNG_FILE) as im:
             im.save(sys.stdout, "PNG")
diff --git a/Tests/test_file_ppm.py b/Tests/test_file_ppm.py
index 0a61830a40a..d6451ec18b5 100644
--- a/Tests/test_file_ppm.py
+++ b/Tests/test_file_ppm.py
@@ -373,7 +373,7 @@ class MyStdOut:
 
     mystdout: MyStdOut | BytesIO = MyStdOut() if buffer else BytesIO()
 
-    sys.stdout = mystdout
+    sys.stdout = mystdout  # type: ignore[assignment]
 
     with Image.open(TEST_FILE) as im:
         im.save(sys.stdout, "PPM")
diff --git a/Tests/test_file_psd.py b/Tests/test_file_psd.py
index 484a1be8f83..ddae8f23577 100644
--- a/Tests/test_file_psd.py
+++ b/Tests/test_file_psd.py
@@ -162,7 +162,7 @@ def test_combined_larger_than_size() -> None:
         ("Tests/images/timeout-dedc7a4ebd856d79b4359bbcc79e8ef231ce38f6.psd", OSError),
     ],
 )
-def test_crashes(test_file: str, raises) -> None:
+def test_crashes(test_file: str, raises: type[Exception]) -> None:
     with open(test_file, "rb") as f:
         with pytest.raises(raises):
             with Image.open(f):
diff --git a/Tests/test_file_tiff_metadata.py b/Tests/test_file_tiff_metadata.py
index 8b816aa4fb5..1e0310001a5 100644
--- a/Tests/test_file_tiff_metadata.py
+++ b/Tests/test_file_tiff_metadata.py
@@ -11,7 +11,11 @@
 
 from .helper import assert_deep_equal, hopper
 
-TAG_IDS = {info.name: info.value for info in TiffTags.TAGS_V2.values()}
+TAG_IDS: dict[str, int] = {
+    info.name: info.value
+    for info in TiffTags.TAGS_V2.values()
+    if info.value is not None
+}
 
 
 def test_rt_metadata(tmp_path: Path) -> None:
@@ -411,8 +415,8 @@ def test_empty_values() -> None:
     info = TiffImagePlugin.ImageFileDirectory_v2(head)
     info.load(data)
     # Should not raise ValueError.
-    info = dict(info)
-    assert 33432 in info
+    info_dict = dict(info)
+    assert 33432 in info_dict
 
 
 def test_photoshop_info(tmp_path: Path) -> None:
diff --git a/Tests/test_file_webp.py b/Tests/test_file_webp.py
index 1caf032f6e1..cbc905de4e7 100644
--- a/Tests/test_file_webp.py
+++ b/Tests/test_file_webp.py
@@ -5,6 +5,7 @@
 import sys
 import warnings
 from pathlib import Path
+from typing import Any
 
 import pytest
 
@@ -70,7 +71,9 @@ def test_read_rgb(self) -> None:
             # dwebp -ppm ../../Tests/images/hopper.webp -o hopper_webp_bits.ppm
             assert_image_similar_tofile(image, "Tests/images/hopper_webp_bits.ppm", 1.0)
 
-    def _roundtrip(self, tmp_path: Path, mode, epsilon, args={}) -> None:
+    def _roundtrip(
+        self, tmp_path: Path, mode: str, epsilon: float, args: dict[str, Any] = {}
+    ) -> None:
         temp_file = str(tmp_path / "temp.webp")
 
         hopper(mode).save(temp_file, **args)
diff --git a/Tests/test_image.py b/Tests/test_image.py
index a8f61d67700..5b1ba6289f4 100644
--- a/Tests/test_image.py
+++ b/Tests/test_image.py
@@ -8,7 +8,7 @@
 import tempfile
 import warnings
 from pathlib import Path
-from typing import IO
+from typing import IO, Any
 
 import pytest
 
@@ -175,11 +175,19 @@ def test_pathlib(self, tmp_path: Path) -> None:
     def test_fp_name(self, tmp_path: Path) -> None:
         temp_file = str(tmp_path / "temp.jpg")
 
-        class FP:
+        class FP(io.BytesIO):
             name: str
 
-            def write(self, b: bytes) -> None:
-                pass
+            if sys.version_info >= (3, 12):
+                from collections.abc import Buffer
+
+                def write(self, data: Buffer) -> int:
+                    return len(data)
+
+            else:
+
+                def write(self, data: Any) -> int:
+                    return len(data)
 
         fp = FP()
         fp.name = temp_file
diff --git a/Tests/test_image_array.py b/Tests/test_image_array.py
index d7e6c562c39..bb606488286 100644
--- a/Tests/test_image_array.py
+++ b/Tests/test_image_array.py
@@ -1,6 +1,6 @@
 from __future__ import annotations
 
-from typing import Any
+from typing import TYPE_CHECKING, Any
 
 import pytest
 from packaging.version import parse as parse_version
@@ -13,13 +13,16 @@
 
 im = hopper().resize((128, 100))
 
+if TYPE_CHECKING:
+    import numpy.typing as npt
+
 
 def test_toarray() -> None:
     def test(mode: str) -> tuple[tuple[int, ...], str, int]:
         ai = numpy.array(im.convert(mode))
         return ai.shape, ai.dtype.str, ai.nbytes
 
-    def test_with_dtype(dtype) -> None:
+    def test_with_dtype(dtype: npt.DTypeLike) -> None:
         ai = numpy.array(im, dtype=dtype)
         assert ai.dtype == dtype
 
diff --git a/Tests/test_imagefile.py b/Tests/test_imagefile.py
index 00cdec95255..a269b846a25 100644
--- a/Tests/test_imagefile.py
+++ b/Tests/test_imagefile.py
@@ -351,7 +351,9 @@ def test_negsize(self) -> None:
             ImageFile._save(
                 im, fp, [("MOCK", (xoff, yoff, -10, yoff + ysize), 0, "RGB")]
             )
-        assert MockPyEncoder.last.cleanup_called
+        last: MockPyEncoder | None = MockPyEncoder.last
+        assert last
+        assert last.cleanup_called
 
         with pytest.raises(ValueError):
             ImageFile._save(
diff --git a/Tests/test_imagefont.py b/Tests/test_imagefont.py
index c3906de2430..e50198087be 100644
--- a/Tests/test_imagefont.py
+++ b/Tests/test_imagefont.py
@@ -548,7 +548,7 @@ def _test_fake_loading_font(path_to_fake: str, fontname: str) -> None:
 
             def loadable_font(
                 filepath: str, size: int, index: int, encoding: str, *args: Any
-            ):
+            ) -> ImageFont.FreeTypeFont:
                 _freeTypeFont = getattr(ImageFont, "_FreeTypeFont")
                 if filepath == path_to_fake:
                     return _freeTypeFont(FONT_PATH, size, index, encoding, *args)
diff --git a/Tests/test_imagewin_pointers.py b/Tests/test_imagewin_pointers.py
index e6c312a0c46..c23a5c690a2 100644
--- a/Tests/test_imagewin_pointers.py
+++ b/Tests/test_imagewin_pointers.py
@@ -45,21 +45,22 @@ class BITMAPINFOHEADER(ctypes.Structure):
     memcpy = ctypes.cdll.msvcrt.memcpy
     memcpy.argtypes = [ctypes.c_void_p, ctypes.c_void_p, ctypes.c_size_t]
 
-    CreateCompatibleDC = ctypes.windll.gdi32.CreateCompatibleDC
+    windll = getattr(ctypes, "windll")
+    CreateCompatibleDC = windll.gdi32.CreateCompatibleDC
     CreateCompatibleDC.argtypes = [ctypes.wintypes.HDC]
     CreateCompatibleDC.restype = ctypes.wintypes.HDC
 
-    DeleteDC = ctypes.windll.gdi32.DeleteDC
+    DeleteDC = windll.gdi32.DeleteDC
     DeleteDC.argtypes = [ctypes.wintypes.HDC]
 
-    SelectObject = ctypes.windll.gdi32.SelectObject
+    SelectObject = windll.gdi32.SelectObject
     SelectObject.argtypes = [ctypes.wintypes.HDC, ctypes.wintypes.HGDIOBJ]
     SelectObject.restype = ctypes.wintypes.HGDIOBJ
 
-    DeleteObject = ctypes.windll.gdi32.DeleteObject
+    DeleteObject = windll.gdi32.DeleteObject
     DeleteObject.argtypes = [ctypes.wintypes.HGDIOBJ]
 
-    CreateDIBSection = ctypes.windll.gdi32.CreateDIBSection
+    CreateDIBSection = windll.gdi32.CreateDIBSection
     CreateDIBSection.argtypes = [
         ctypes.wintypes.HDC,
         ctypes.c_void_p,
diff --git a/Tests/test_psdraw.py b/Tests/test_psdraw.py
index c3afa908937..130ffa863a5 100644
--- a/Tests/test_psdraw.py
+++ b/Tests/test_psdraw.py
@@ -59,7 +59,7 @@ class MyStdOut:
 
     mystdout: MyStdOut | BytesIO = MyStdOut() if buffer else BytesIO()
 
-    sys.stdout = mystdout
+    sys.stdout = mystdout  # type: ignore[assignment]
 
     ps = PSDraw.PSDraw()
     _create_document(ps)

From e5c4d56a9e62ab5834350ef1e39da542ea1559d5 Mon Sep 17 00:00:00 2001
From: Andrew Murray <radarhere@users.noreply.github.com>
Date: Mon, 24 Jun 2024 15:08:36 +1000
Subject: [PATCH 0734/1178] Clarify error message when size is missing

---
 Tests/test_imagedraw2.py |  8 ++++++++
 src/PIL/ImageDraw2.py    | 12 ++++++++++--
 2 files changed, 18 insertions(+), 2 deletions(-)

diff --git a/Tests/test_imagedraw2.py b/Tests/test_imagedraw2.py
index 35fe0cf40dd..c80aa739cdf 100644
--- a/Tests/test_imagedraw2.py
+++ b/Tests/test_imagedraw2.py
@@ -57,6 +57,14 @@ def test_sanity() -> None:
     draw2.line(list(range(10)), pen)
 
 
+def test_mode() -> None:
+    draw = ImageDraw2.Draw("L", (1, 1))
+    assert draw.image.mode == "L"
+
+    with pytest.raises(ValueError):
+        ImageDraw2.Draw("L")
+
+
 @pytest.mark.parametrize("bbox", BBOX)
 def test_ellipse(bbox: Coords) -> None:
     # Arrange
diff --git a/src/PIL/ImageDraw2.py b/src/PIL/ImageDraw2.py
index b42f5d9eac1..600e140e1f6 100644
--- a/src/PIL/ImageDraw2.py
+++ b/src/PIL/ImageDraw2.py
@@ -56,8 +56,16 @@ class Draw:
     (Experimental) WCK-style drawing interface
     """
 
-    def __init__(self, image, size=None, color=None):
-        if not hasattr(image, "im"):
+    def __init__(
+        self,
+        image: Image.Image | str,
+        size: tuple[int, int] | list[int] | None = None,
+        color: float | tuple[float, ...] | str | None = None,
+    ) -> None:
+        if isinstance(image, str):
+            if size is None:
+                msg = "If image argument is mode string, size must be a list or tuple"
+                raise ValueError(msg)
             image = Image.new(image, size, color)
         self.draw = ImageDraw.Draw(image)
         self.image = image

From f2302ab716e9ee4e45bca3dee2c83ce5f56283b8 Mon Sep 17 00:00:00 2001
From: Andrew Murray <radarhere@users.noreply.github.com>
Date: Mon, 24 Jun 2024 21:04:33 +1000
Subject: [PATCH 0735/1178] Added type hints

---
 Tests/test_file_spider.py    |  1 +
 Tests/test_imagefile.py      |  4 +--
 Tests/test_imageops_usm.py   |  2 +-
 Tests/test_imagepalette.py   |  8 +++---
 src/PIL/BlpImagePlugin.py    |  2 ++
 src/PIL/ImageDraw2.py        |  7 +++++-
 src/PIL/ImageFile.py         | 25 ++++++++++---------
 src/PIL/ImagePalette.py      | 48 ++++++++++++++++++++++--------------
 src/PIL/ImageWin.py          | 13 ++++++----
 src/PIL/SpiderImagePlugin.py | 22 +++++++++--------
 10 files changed, 79 insertions(+), 53 deletions(-)

diff --git a/Tests/test_file_spider.py b/Tests/test_file_spider.py
index 9b82a962aee..66c88e9d8eb 100644
--- a/Tests/test_file_spider.py
+++ b/Tests/test_file_spider.py
@@ -105,6 +105,7 @@ def test_load_image_series() -> None:
     img_list = SpiderImagePlugin.loadImageSeries(file_list)
 
     # Assert
+    assert img_list is not None
     assert len(img_list) == 1
     assert isinstance(img_list[0], Image.Image)
     assert img_list[0].size == (128, 128)
diff --git a/Tests/test_imagefile.py b/Tests/test_imagefile.py
index a269b846a25..68b28ef07e2 100644
--- a/Tests/test_imagefile.py
+++ b/Tests/test_imagefile.py
@@ -209,7 +209,7 @@ def __init__(self, mode: str, *args: Any) -> None:
 
         super().__init__(mode, *args)
 
-    def decode(self, buffer):
+    def decode(self, buffer: bytes) -> tuple[int, int]:
         # eof
         return -1, 0
 
@@ -222,7 +222,7 @@ def __init__(self, mode: str, *args: Any) -> None:
 
         super().__init__(mode, *args)
 
-    def encode(self, buffer):
+    def encode(self, bufsize: int) -> tuple[int, int, bytes]:
         return 1, 1, b""
 
     def cleanup(self) -> None:
diff --git a/Tests/test_imageops_usm.py b/Tests/test_imageops_usm.py
index dbdd5b317d5..c8e2c0467de 100644
--- a/Tests/test_imageops_usm.py
+++ b/Tests/test_imageops_usm.py
@@ -101,7 +101,7 @@ def test_blur_accuracy(test_images: dict[str, ImageFile.ImageFile]) -> None:
         assert i.im.getpixel((x, y))[c] >= 250
     # Fuzzy match.
 
-    def gp(x, y):
+    def gp(x: int, y: int) -> tuple[int, ...]:
         return i.im.getpixel((x, y))
 
     assert 236 <= gp(7, 4)[0] <= 239
diff --git a/Tests/test_imagepalette.py b/Tests/test_imagepalette.py
index 17f68710a48..6cf0079dda7 100644
--- a/Tests/test_imagepalette.py
+++ b/Tests/test_imagepalette.py
@@ -88,13 +88,13 @@ def test_file(tmp_path: Path) -> None:
 
     palette.save(f)
 
-    p = ImagePalette.load(f)
+    lut = ImagePalette.load(f)
 
     # load returns raw palette information
-    assert len(p[0]) == 768
-    assert p[1] == "RGB"
+    assert len(lut[0]) == 768
+    assert lut[1] == "RGB"
 
-    p = ImagePalette.raw(p[1], p[0])
+    p = ImagePalette.raw(lut[1], lut[0])
     assert isinstance(p, ImagePalette.ImagePalette)
     assert p.palette == palette.tobytes()
 
diff --git a/src/PIL/BlpImagePlugin.py b/src/PIL/BlpImagePlugin.py
index 59246c6e2e1..b9cefafdd07 100644
--- a/src/PIL/BlpImagePlugin.py
+++ b/src/PIL/BlpImagePlugin.py
@@ -430,6 +430,7 @@ class BLPEncoder(ImageFile.PyEncoder):
 
     def _write_palette(self) -> bytes:
         data = b""
+        assert self.im is not None
         palette = self.im.getpalette("RGBA", "RGBA")
         for i in range(len(palette) // 4):
             r, g, b, a = palette[i * 4 : (i + 1) * 4]
@@ -444,6 +445,7 @@ def encode(self, bufsize: int) -> tuple[int, int, bytes]:
         offset = 20 + 16 * 4 * 2 + len(palette_data)
         data = struct.pack("<16I", offset, *((0,) * 15))
 
+        assert self.im is not None
         w, h = self.im.size
         data += struct.pack("<16I", w * h, *((0,) * 15))
 
diff --git a/src/PIL/ImageDraw2.py b/src/PIL/ImageDraw2.py
index 600e140e1f6..e89a78be4b5 100644
--- a/src/PIL/ImageDraw2.py
+++ b/src/PIL/ImageDraw2.py
@@ -24,7 +24,10 @@
 """
 from __future__ import annotations
 
+from typing import BinaryIO
+
 from . import Image, ImageColor, ImageDraw, ImageFont, ImagePath
+from ._typing import StrOrBytesPath
 
 
 class Pen:
@@ -45,7 +48,9 @@ def __init__(self, color: str, opacity: int = 255) -> None:
 class Font:
     """Stores a TrueType font and color"""
 
-    def __init__(self, color, file, size=12):
+    def __init__(
+        self, color: str, file: StrOrBytesPath | BinaryIO, size: float = 12
+    ) -> None:
         # FIXME: add support for bitmap fonts
         self.color = ImageColor.getrgb(color)
         self.font = ImageFont.truetype(file, size)
diff --git a/src/PIL/ImageFile.py b/src/PIL/ImageFile.py
index 5d67409ea45..69e7ee54811 100644
--- a/src/PIL/ImageFile.py
+++ b/src/PIL/ImageFile.py
@@ -65,7 +65,7 @@
 # Helpers
 
 
-def _get_oserror(error, *, encoder):
+def _get_oserror(error: int, *, encoder: bool) -> OSError:
     try:
         msg = Image.core.getcodecstatus(error)
     except AttributeError:
@@ -76,7 +76,7 @@ def _get_oserror(error, *, encoder):
     return OSError(msg)
 
 
-def raise_oserror(error):
+def raise_oserror(error: int) -> OSError:
     deprecate(
         "raise_oserror",
         12,
@@ -154,11 +154,12 @@ def __init__(self, fp=None, filename=None):
                 self.fp.close()
             raise
 
-    def get_format_mimetype(self):
+    def get_format_mimetype(self) -> str | None:
         if self.custom_mimetype:
             return self.custom_mimetype
         if self.format is not None:
             return Image.MIME.get(self.format.upper())
+        return None
 
     def __setstate__(self, state):
         self.tile = []
@@ -365,7 +366,7 @@ class StubImageFile(ImageFile):
     certain format, but relies on external code to load the file.
     """
 
-    def _open(self):
+    def _open(self) -> None:
         msg = "StubImageFile subclass must implement _open"
         raise NotImplementedError(msg)
 
@@ -381,7 +382,7 @@ def load(self):
         self.__dict__ = image.__dict__
         return image.load()
 
-    def _load(self):
+    def _load(self) -> StubHandler | None:
         """(Hook) Find actual image loader."""
         msg = "StubImageFile subclass must implement _load"
         raise NotImplementedError(msg)
@@ -621,7 +622,7 @@ def __init__(self) -> None:
         self.xoff = 0
         self.yoff = 0
 
-    def extents(self):
+    def extents(self) -> tuple[int, int, int, int]:
         return self.xoff, self.yoff, self.xoff + self.xsize, self.yoff + self.ysize
 
 
@@ -661,7 +662,7 @@ def setfd(self, fd):
         """
         self.fd = fd
 
-    def setimage(self, im, extents=None):
+    def setimage(self, im, extents: tuple[int, int, int, int] | None = None) -> None:
         """
         Called from ImageFile to set the core output image for the codec
 
@@ -710,10 +711,10 @@ class PyDecoder(PyCodec):
     _pulls_fd = False
 
     @property
-    def pulls_fd(self):
+    def pulls_fd(self) -> bool:
         return self._pulls_fd
 
-    def decode(self, buffer):
+    def decode(self, buffer: bytes) -> tuple[int, int]:
         """
         Override to perform the decoding process.
 
@@ -738,6 +739,7 @@ def set_as_raw(self, data: bytes, rawmode=None) -> None:
         if not rawmode:
             rawmode = self.mode
         d = Image._getdecoder(self.mode, "raw", rawmode)
+        assert self.im is not None
         d.setimage(self.im, self.state.extents())
         s = d.decode(data)
 
@@ -760,7 +762,7 @@ class PyEncoder(PyCodec):
     _pushes_fd = False
 
     @property
-    def pushes_fd(self):
+    def pushes_fd(self) -> bool:
         return self._pushes_fd
 
     def encode(self, bufsize: int) -> tuple[int, int, bytes]:
@@ -775,7 +777,7 @@ def encode(self, bufsize: int) -> tuple[int, int, bytes]:
         msg = "unavailable in base encoder"
         raise NotImplementedError(msg)
 
-    def encode_to_pyfd(self):
+    def encode_to_pyfd(self) -> tuple[int, int]:
         """
         If ``pushes_fd`` is ``True``, then this method will be used,
         and ``encode()`` will only be called once.
@@ -787,6 +789,7 @@ def encode_to_pyfd(self):
             return 0, -8  # bad configuration
         bytes_consumed, errcode, data = self.encode(0)
         if data:
+            assert self.fd is not None
             self.fd.write(data)
         return bytes_consumed, errcode
 
diff --git a/src/PIL/ImagePalette.py b/src/PIL/ImagePalette.py
index 6473c4577b0..ed38285dc28 100644
--- a/src/PIL/ImagePalette.py
+++ b/src/PIL/ImagePalette.py
@@ -38,23 +38,27 @@ class ImagePalette:
         Defaults to an empty palette.
     """
 
-    def __init__(self, mode: str = "RGB", palette: Sequence[int] | None = None) -> None:
+    def __init__(
+        self,
+        mode: str = "RGB",
+        palette: Sequence[int] | bytes | bytearray | None = None,
+    ) -> None:
         self.mode = mode
-        self.rawmode = None  # if set, palette contains raw data
+        self.rawmode: str | None = None  # if set, palette contains raw data
         self.palette = palette or bytearray()
         self.dirty: int | None = None
 
     @property
-    def palette(self):
+    def palette(self) -> Sequence[int] | bytes | bytearray:
         return self._palette
 
     @palette.setter
-    def palette(self, palette):
-        self._colors = None
+    def palette(self, palette: Sequence[int] | bytes | bytearray) -> None:
+        self._colors: dict[tuple[int, ...], int] | None = None
         self._palette = palette
 
     @property
-    def colors(self) -> dict[tuple[int, int, int] | tuple[int, int, int, int], int]:
+    def colors(self) -> dict[tuple[int, ...], int]:
         if self._colors is None:
             mode_len = len(self.mode)
             self._colors = {}
@@ -66,9 +70,7 @@ def colors(self) -> dict[tuple[int, int, int] | tuple[int, int, int, int], int]:
         return self._colors
 
     @colors.setter
-    def colors(
-        self, colors: dict[tuple[int, int, int] | tuple[int, int, int, int], int]
-    ) -> None:
+    def colors(self, colors: dict[tuple[int, ...], int]) -> None:
         self._colors = colors
 
     def copy(self) -> ImagePalette:
@@ -82,7 +84,7 @@ def copy(self) -> ImagePalette:
 
         return new
 
-    def getdata(self) -> tuple[str, bytes]:
+    def getdata(self) -> tuple[str, Sequence[int] | bytes | bytearray]:
         """
         Get palette contents in format suitable for the low-level
         ``im.putpalette`` primitive.
@@ -137,7 +139,7 @@ def _new_color_index(
 
     def getcolor(
         self,
-        color: tuple[int, int, int] | tuple[int, int, int, int],
+        color: tuple[int, ...],
         image: Image.Image | None = None,
     ) -> int:
         """Given an rgb tuple, allocate palette entry.
@@ -162,12 +164,13 @@ def getcolor(
             except KeyError as e:
                 # allocate new color slot
                 index = self._new_color_index(image, e)
+                assert isinstance(self._palette, bytearray)
                 self.colors[color] = index
                 if index * 3 < len(self.palette):
                     self._palette = (
-                        self.palette[: index * 3]
+                        self._palette[: index * 3]
                         + bytes(color)
-                        + self.palette[index * 3 + 3 :]
+                        + self._palette[index * 3 + 3 :]
                     )
                 else:
                     self._palette += bytes(color)
@@ -204,7 +207,7 @@ def save(self, fp: str | IO[str]) -> None:
 # Internal
 
 
-def raw(rawmode, data) -> ImagePalette:
+def raw(rawmode, data: Sequence[int] | bytes | bytearray) -> ImagePalette:
     palette = ImagePalette()
     palette.rawmode = rawmode
     palette.palette = data
@@ -216,9 +219,9 @@ def raw(rawmode, data) -> ImagePalette:
 # Factories
 
 
-def make_linear_lut(black, white):
+def make_linear_lut(black: int, white: float) -> list[int]:
     if black == 0:
-        return [white * i // 255 for i in range(256)]
+        return [int(white * i // 255) for i in range(256)]
 
     msg = "unavailable when black is non-zero"
     raise NotImplementedError(msg)  # FIXME
@@ -251,15 +254,22 @@ def wedge(mode: str = "RGB") -> ImagePalette:
     return ImagePalette(mode, [i // len(mode) for i in palette])
 
 
-def load(filename):
+def load(filename: str) -> tuple[bytes, str]:
     # FIXME: supports GIMP gradients only
 
     with open(filename, "rb") as fp:
-        for paletteHandler in [
+        paletteHandlers: list[
+            type[
+                GimpPaletteFile.GimpPaletteFile
+                | GimpGradientFile.GimpGradientFile
+                | PaletteFile.PaletteFile
+            ]
+        ] = [
             GimpPaletteFile.GimpPaletteFile,
             GimpGradientFile.GimpGradientFile,
             PaletteFile.PaletteFile,
-        ]:
+        ]
+        for paletteHandler in paletteHandlers:
             try:
                 fp.seek(0)
                 lut = paletteHandler(fp).getpalette()
diff --git a/src/PIL/ImageWin.py b/src/PIL/ImageWin.py
index 6c29e2590cf..978c5a9d176 100644
--- a/src/PIL/ImageWin.py
+++ b/src/PIL/ImageWin.py
@@ -69,19 +69,22 @@ class Dib:
                  defines the size of the image.
     """
 
-    def __init__(self, image, size=None):
-        if hasattr(image, "mode") and hasattr(image, "size"):
+    def __init__(
+        self, image: Image.Image | str, size: tuple[int, int] | list[int] | None = None
+    ) -> None:
+        if isinstance(image, str):
+            mode = image
+            image = ""
+        else:
             mode = image.mode
             size = image.size
-        else:
-            mode = image
-            image = None
         if mode not in ["1", "L", "P", "RGB"]:
             mode = Image.getmodebase(mode)
         self.image = Image.core.display(mode, size)
         self.mode = mode
         self.size = size
         if image:
+            assert not isinstance(image, str)
             self.paste(image)
 
     def expose(self, handle):
diff --git a/src/PIL/SpiderImagePlugin.py b/src/PIL/SpiderImagePlugin.py
index a6cc00019da..f5a09c3ef61 100644
--- a/src/PIL/SpiderImagePlugin.py
+++ b/src/PIL/SpiderImagePlugin.py
@@ -37,12 +37,12 @@
 import os
 import struct
 import sys
-from typing import IO, TYPE_CHECKING
+from typing import IO, TYPE_CHECKING, Any, Tuple, cast
 
 from . import Image, ImageFile
 
 
-def isInt(f):
+def isInt(f: Any) -> int:
     try:
         i = int(f)
         if f - i == 0:
@@ -62,7 +62,7 @@ def isInt(f):
 # otherwise returns 0
 
 
-def isSpiderHeader(t):
+def isSpiderHeader(t: tuple[float, ...]) -> int:
     h = (99,) + t  # add 1 value so can use spider header index start=1
     # header values 1,2,5,12,13,22,23 should be integers
     for i in [1, 2, 5, 12, 13, 22, 23]:
@@ -82,7 +82,7 @@ def isSpiderHeader(t):
     return labbyt
 
 
-def isSpiderImage(filename):
+def isSpiderImage(filename: str) -> int:
     with open(filename, "rb") as fp:
         f = fp.read(92)  # read 23 * 4 bytes
     t = struct.unpack(">23f", f)  # try big-endian first
@@ -184,13 +184,15 @@ def seek(self, frame: int) -> None:
         self._open()
 
     # returns a byte image after rescaling to 0..255
-    def convert2byte(self, depth=255):
-        (minimum, maximum) = self.getextrema()
-        m = 1
+    def convert2byte(self, depth: int = 255) -> Image.Image:
+        extrema = self.getextrema()
+        assert isinstance(extrema[0], float)
+        minimum, maximum = cast(Tuple[float, float], extrema)
+        m: float = 1
         if maximum != minimum:
             m = depth / (maximum - minimum)
         b = -m * minimum
-        return self.point(lambda i, m=m, b=b: i * m + b).convert("L")
+        return self.point(lambda i: i * m + b).convert("L")
 
     if TYPE_CHECKING:
         from . import ImageTk
@@ -207,10 +209,10 @@ def tkPhotoImage(self) -> ImageTk.PhotoImage:
 
 
 # given a list of filenames, return a list of images
-def loadImageSeries(filelist=None):
+def loadImageSeries(filelist: list[str] | None = None) -> list[SpiderImageFile] | None:
     """create a list of :py:class:`~PIL.Image.Image` objects for use in a montage"""
     if filelist is None or len(filelist) < 1:
-        return
+        return None
 
     imglist = []
     for img in filelist:

From 065aeaea472b38896d43363095cccc05220b3c9c Mon Sep 17 00:00:00 2001
From: Yay295 <Yay295@users.noreply.github.com>
Date: Mon, 24 Jun 2024 07:28:47 -0500
Subject: [PATCH 0736/1178] improve check_required_header_comments()
 description

Co-authored-by: Andrew Murray <3112309+radarhere@users.noreply.github.com>
---
 src/PIL/EpsImagePlugin.py | 6 +++---
 1 file changed, 3 insertions(+), 3 deletions(-)

diff --git a/src/PIL/EpsImagePlugin.py b/src/PIL/EpsImagePlugin.py
index c7f9625c962..f31b1c1a2d0 100644
--- a/src/PIL/EpsImagePlugin.py
+++ b/src/PIL/EpsImagePlugin.py
@@ -231,9 +231,9 @@ def _open(self) -> None:
 
         def check_required_header_comments() -> None:
             """
-            The EPS spec requires that some headers exist.
-            This should be checked after all headers have been read,
-            or at the end of the file if that comes first.
+            The EPS specification requires that some headers exist.
+            This should be checked when the header comments formally end,
+            when image data starts, or when the file ends, whichever comes first.
             """
             if "PS-Adobe" not in self.info:
                 msg = 'EPS header missing "%!PS-Adobe" comment'

From a941f096aa06df7d71dc451151076925dc8dc9f9 Mon Sep 17 00:00:00 2001
From: Andrew Murray <radarhere@users.noreply.github.com>
Date: Tue, 25 Jun 2024 18:49:40 +1000
Subject: [PATCH 0737/1178] Update CHANGES.rst [ci skip]

---
 CHANGES.rst | 3 +++
 1 file changed, 3 insertions(+)

diff --git a/CHANGES.rst b/CHANGES.rst
index ec3073446bf..9c731fe9463 100644
--- a/CHANGES.rst
+++ b/CHANGES.rst
@@ -5,6 +5,9 @@ Changelog (Pillow)
 10.4.0 (unreleased)
 -------------------
 
+- Clarify ImageDraw2 error message when size is missing #8165
+  [radarhere]
+
 - Support unpacking more rawmodes to RGBA palettes #7966
   [radarhere]
 

From ded404507bf8e8ae33ee194e9e1dc275e25edc82 Mon Sep 17 00:00:00 2001
From: Andrew Murray <radarhere@users.noreply.github.com>
Date: Sat, 22 Jun 2024 17:02:19 +1000
Subject: [PATCH 0738/1178] Removed ignores

---
 src/PIL/ImageGrab.py | 7 +++----
 1 file changed, 3 insertions(+), 4 deletions(-)

diff --git a/src/PIL/ImageGrab.py b/src/PIL/ImageGrab.py
index 96a28bb3570..aa53abd2084 100644
--- a/src/PIL/ImageGrab.py
+++ b/src/PIL/ImageGrab.py
@@ -22,7 +22,6 @@
 import subprocess
 import sys
 import tempfile
-from typing import Union, cast
 
 from . import Image
 
@@ -70,15 +69,15 @@ def grab(
                 left, top, right, bottom = bbox
                 im = im.crop((left - x0, top - y0, right - x0, bottom - y0))
             return im
-    xdisplay = cast(Union[str, None], xdisplay)  # type: ignore[redundant-cast, unused-ignore]
+    display_name: str | None = xdisplay
     try:
         if not Image.core.HAVE_XCB:
             msg = "Pillow was built without XCB support"
             raise OSError(msg)
-        size, data = Image.core.grabscreen_x11(xdisplay)
+        size, data = Image.core.grabscreen_x11(display_name)
     except OSError:
         if (
-            xdisplay is None
+            display_name is None
             and sys.platform not in ("darwin", "win32")
             and shutil.which("gnome-screenshot")
         ):

From d0d53d4bac853acaad51af7d6aa9582cad59945a Mon Sep 17 00:00:00 2001
From: Andrew Murray <radarhere@users.noreply.github.com>
Date: Sat, 22 Jun 2024 17:02:28 +1000
Subject: [PATCH 0739/1178] Added type hints to tests

---
 Tests/test_imagegrab.py | 3 +++
 1 file changed, 3 insertions(+)

diff --git a/Tests/test_imagegrab.py b/Tests/test_imagegrab.py
index e23adeb7083..5dfa51697c2 100644
--- a/Tests/test_imagegrab.py
+++ b/Tests/test_imagegrab.py
@@ -89,6 +89,7 @@ def test_grabclipboard_file(self) -> None:
         p.communicate()
 
         im = ImageGrab.grabclipboard()
+        assert isinstance(im, list)
         assert len(im) == 1
         assert os.path.samefile(im[0], "Tests/images/hopper.gif")
 
@@ -105,6 +106,7 @@ def test_grabclipboard_png(self) -> None:
         p.communicate()
 
         im = ImageGrab.grabclipboard()
+        assert isinstance(im, Image.Image)
         assert_image_equal_tofile(im, "Tests/images/hopper.png")
 
     @pytest.mark.skipif(
@@ -120,6 +122,7 @@ def test_grabclipboard_wl_clipboard(self, ext: str) -> None:
         with open(image_path, "rb") as fp:
             subprocess.call(["wl-copy"], stdin=fp)
         im = ImageGrab.grabclipboard()
+        assert isinstance(im, Image.Image)
         assert_image_equal_tofile(im, image_path)
 
     @pytest.mark.skipif(

From ab183958188e38b6501410b4f34a561fbea0ba56 Mon Sep 17 00:00:00 2001
From: Andrew Murray <3112309+radarhere@users.noreply.github.com>
Date: Tue, 25 Jun 2024 07:13:17 +1000
Subject: [PATCH 0740/1178] Added comment
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit

Co-authored-by: Ondrej Baranovič <ondreko.tiba@gmail.com>
---
 src/PIL/ImageGrab.py | 1 +
 1 file changed, 1 insertion(+)

diff --git a/src/PIL/ImageGrab.py b/src/PIL/ImageGrab.py
index aa53abd2084..e27ca7e5033 100644
--- a/src/PIL/ImageGrab.py
+++ b/src/PIL/ImageGrab.py
@@ -69,6 +69,7 @@ def grab(
                 left, top, right, bottom = bbox
                 im = im.crop((left - x0, top - y0, right - x0, bottom - y0))
             return im
+    # Cast to Optional[str] needed for Windows and macOS.
     display_name: str | None = xdisplay
     try:
         if not Image.core.HAVE_XCB:

From 44b82e4513529fd20479169eba22366815f7821c Mon Sep 17 00:00:00 2001
From: Andrew Murray <radarhere@users.noreply.github.com>
Date: Tue, 25 Jun 2024 21:40:30 +1000
Subject: [PATCH 0741/1178] Use more specific error

---
 Tests/test_file_jpeg2k.py | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/Tests/test_file_jpeg2k.py b/Tests/test_file_jpeg2k.py
index ed7ea4fcfbc..c6f1e0f52f5 100644
--- a/Tests/test_file_jpeg2k.py
+++ b/Tests/test_file_jpeg2k.py
@@ -337,7 +337,7 @@ def test_issue_6194() -> None:
 
 def test_unbound_local() -> None:
     # prepatch, a malformed jp2 file could cause an UnboundLocalError exception.
-    with pytest.raises(OSError):
+    with pytest.raises(UnidentifiedImageError):
         with Image.open("Tests/images/unbound_variable.jp2"):
             pass
 

From e7c1da3cc8a26b821e0a4ec2d4651d62271f00c5 Mon Sep 17 00:00:00 2001
From: Andrew Murray <radarhere@users.noreply.github.com>
Date: Tue, 25 Jun 2024 21:42:25 +1000
Subject: [PATCH 0742/1178] Update CHANGES.rst [ci skip]

---
 CHANGES.rst | 6 ++++++
 1 file changed, 6 insertions(+)

diff --git a/CHANGES.rst b/CHANGES.rst
index 9c731fe9463..6375f5c6397 100644
--- a/CHANGES.rst
+++ b/CHANGES.rst
@@ -5,6 +5,12 @@ Changelog (Pillow)
 10.4.0 (unreleased)
 -------------------
 
+- Read IM and TIFF images as RGB, rather than RGBX #7997
+  [radarhere]
+
+- Only preserve TIFF IPTC_NAA_CHUNK tag if type is BYTE or UNDEFINED #7948
+  [radarhere]
+
 - Clarify ImageDraw2 error message when size is missing #8165
   [radarhere]
 

From 99666dac291da395dc03743fb540277c9da0b7b5 Mon Sep 17 00:00:00 2001
From: Andrew Murray <radarhere@users.noreply.github.com>
Date: Tue, 25 Jun 2024 22:00:51 +1000
Subject: [PATCH 0743/1178] Simplified casts

---
 src/PIL/Image.py | 9 +++------
 1 file changed, 3 insertions(+), 6 deletions(-)

diff --git a/src/PIL/Image.py b/src/PIL/Image.py
index c2eac31c730..e9cf7cebcc4 100644
--- a/src/PIL/Image.py
+++ b/src/PIL/Image.py
@@ -1113,7 +1113,7 @@ def convert_transparency(
             if trns is not None:
                 try:
                     new_im.info["transparency"] = new_im.palette.getcolor(
-                        cast(Tuple[int, int, int], trns),  # trns was converted to RGB
+                        cast(Tuple[int, ...], trns),  # trns was converted to RGB
                         new_im,
                     )
                 except Exception:
@@ -1163,12 +1163,9 @@ def convert_transparency(
             # crash fail if we leave a bytes transparency in an rgb/l mode.
             del new_im.info["transparency"]
         if trns is not None:
-            if new_im.mode == "P":
+            if new_im.mode == "P" and new_im.palette:
                 try:
-                    new_im.info["transparency"] = new_im.palette.getcolor(
-                        cast(Tuple[int, int, int], trns),  # trns was converted to RGB
-                        new_im,
-                    )
+                    new_im.info["transparency"] = new_im.palette.getcolor(trns, new_im)
                 except ValueError as e:
                     del new_im.info["transparency"]
                     if str(e) != "cannot allocate more than 256 colors":

From 6f28a0c009affcfb8f67c4bde921aa7d6684a7ac Mon Sep 17 00:00:00 2001
From: Yay295 <Yay295@users.noreply.github.com>
Date: Thu, 11 Apr 2024 00:40:11 -0500
Subject: [PATCH 0744/1178] Fix TGA rawmode BGR;15

---
 src/PIL/TgaImagePlugin.py | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/src/PIL/TgaImagePlugin.py b/src/PIL/TgaImagePlugin.py
index f16f075df05..ebf9a1b80cd 100644
--- a/src/PIL/TgaImagePlugin.py
+++ b/src/PIL/TgaImagePlugin.py
@@ -36,7 +36,7 @@
     (3, 1): "1",
     (3, 8): "L",
     (3, 16): "LA",
-    (2, 16): "BGR;5",
+    (2, 16): "BGR;15",
     (2, 24): "BGR",
     (2, 32): "BGRA",
 }

From 872ff125fcc9182fcc4cbcbf3d1bc5632a21860b Mon Sep 17 00:00:00 2001
From: Yay295 <Yay295@users.noreply.github.com>
Date: Thu, 11 Apr 2024 00:53:06 -0500
Subject: [PATCH 0745/1178] "BGR;15" -> "BGRA;15"

---
 src/PIL/TgaImagePlugin.py | 4 ++--
 1 file changed, 2 insertions(+), 2 deletions(-)

diff --git a/src/PIL/TgaImagePlugin.py b/src/PIL/TgaImagePlugin.py
index ebf9a1b80cd..6a6bceacaba 100644
--- a/src/PIL/TgaImagePlugin.py
+++ b/src/PIL/TgaImagePlugin.py
@@ -36,7 +36,7 @@
     (3, 1): "1",
     (3, 8): "L",
     (3, 16): "LA",
-    (2, 16): "BGR;15",
+    (2, 16): "BGRA;15",
     (2, 24): "BGR",
     (2, 32): "BGRA",
 }
@@ -118,7 +118,7 @@ def _open(self) -> None:
             start, size, mapdepth = i16(s, 3), i16(s, 5), s[7]
             if mapdepth == 16:
                 self.palette = ImagePalette.raw(
-                    "BGR;15", b"\0" * 2 * start + self.fp.read(2 * size)
+                    "BGRA;15", b"\0" * 2 * start + self.fp.read(2 * size)
                 )
             elif mapdepth == 24:
                 self.palette = ImagePalette.raw(

From e5c6d883d44aab0ba27ec8faf384f9a3e3b5aa01 Mon Sep 17 00:00:00 2001
From: Yay295 <Yay295@users.noreply.github.com>
Date: Thu, 11 Apr 2024 07:56:29 -0500
Subject: [PATCH 0746/1178] set palette mode for BGRA;15

Co-authored-by: Andrew Murray <3112309+radarhere@users.noreply.github.com>
---
 src/PIL/TgaImagePlugin.py | 1 +
 1 file changed, 1 insertion(+)

diff --git a/src/PIL/TgaImagePlugin.py b/src/PIL/TgaImagePlugin.py
index 6a6bceacaba..9bc483fc5b7 100644
--- a/src/PIL/TgaImagePlugin.py
+++ b/src/PIL/TgaImagePlugin.py
@@ -120,6 +120,7 @@ def _open(self) -> None:
                 self.palette = ImagePalette.raw(
                     "BGRA;15", b"\0" * 2 * start + self.fp.read(2 * size)
                 )
+                self.palette.mode = "RGBA"
             elif mapdepth == 24:
                 self.palette = ImagePalette.raw(
                     "BGR", b"\0" * 3 * start + self.fp.read(3 * size)

From 38402554869bdb2af6ac81bcb90070e939a41c38 Mon Sep 17 00:00:00 2001
From: Andrew Murray <radarhere@users.noreply.github.com>
Date: Tue, 25 Jun 2024 20:50:17 +1000
Subject: [PATCH 0747/1178] Invert alpha bit for map depth 16

---
 Tests/images/p_16.png     | Bin 378 -> 414 bytes
 Tests/test_file_tga.py    |   5 +++--
 src/PIL/TgaImagePlugin.py |   8 +++++---
 3 files changed, 8 insertions(+), 5 deletions(-)

diff --git a/Tests/images/p_16.png b/Tests/images/p_16.png
index e3588641277b804c0100707146a46a506f33d0d6..458f7138e8026159cb9e52a18088db59358e4c44 100644
GIT binary patch
literal 414
zcmeAS@N?(olHy`uVBq!ia0vp^4Is?H1|$#LC7xzrU`+LNaSW-L^Y)S>UxNY<gX5R~
z^~dBxg!A8=*?PfY)AhLQ^#@J;>}4gE|G$2o{oCumKWmr&|6dn*{vnHidV>Yy5l#g^
ohC-$eVTU;kk4A;CheS1lgtNdOv)R!Vz;I{qboFyt=akR{0D$9pJpcdz

literal 378
zcmeAS@N?(olHy`uVBq!ia0vp^4Is?H1SEZ8zRh7^V083!aSW-L^Y-FF&I1Yp3<qcY
zt2X0(;mi@qWbAM2mw0^7wPQbze)_WZZ?X0My6^h`_nT+`=wL8pOkz61(!nVptf1!L
g(=cP?3VdUj^qT*#aqOvMz%XU-boFyt=akR{06%wV2mk;8

diff --git a/Tests/test_file_tga.py b/Tests/test_file_tga.py
index ff6dab00dca..15c7bbdb89e 100644
--- a/Tests/test_file_tga.py
+++ b/Tests/test_file_tga.py
@@ -72,12 +72,13 @@ def test_palette_depth_8(tmp_path: Path) -> None:
 
 def test_palette_depth_16(tmp_path: Path) -> None:
     with Image.open("Tests/images/p_16.tga") as im:
-        assert_image_equal_tofile(im.convert("RGB"), "Tests/images/p_16.png")
+        assert im.palette.mode == "RGBA"
+        assert_image_equal_tofile(im.convert("RGBA"), "Tests/images/p_16.png")
 
         out = str(tmp_path / "temp.png")
         im.save(out)
         with Image.open(out) as reloaded:
-            assert_image_equal_tofile(reloaded.convert("RGB"), "Tests/images/p_16.png")
+            assert_image_equal_tofile(reloaded.convert("RGBA"), "Tests/images/p_16.png")
 
 
 def test_id_field() -> None:
diff --git a/src/PIL/TgaImagePlugin.py b/src/PIL/TgaImagePlugin.py
index 9bc483fc5b7..d158fe49203 100644
--- a/src/PIL/TgaImagePlugin.py
+++ b/src/PIL/TgaImagePlugin.py
@@ -117,9 +117,11 @@ def _open(self) -> None:
             # read palette
             start, size, mapdepth = i16(s, 3), i16(s, 5), s[7]
             if mapdepth == 16:
-                self.palette = ImagePalette.raw(
-                    "BGRA;15", b"\0" * 2 * start + self.fp.read(2 * size)
-                )
+                colormap = self.fp.read(2 * size)
+                palette_data = bytearray(b"\0" * 2 * start)
+                for a, b in zip(colormap[::2], colormap[1::2]):
+                    palette_data += bytearray((a, b ^ 128))
+                self.palette = ImagePalette.raw("BGRA;15", bytes(palette_data))
                 self.palette.mode = "RGBA"
             elif mapdepth == 24:
                 self.palette = ImagePalette.raw(

From 4cadf5c99f690b82cf281b601f96bf5711e52c58 Mon Sep 17 00:00:00 2001
From: Yay295 <Yay295@gmail.com>
Date: Tue, 25 Jun 2024 09:17:40 -0500
Subject: [PATCH 0748/1178] use bytes/bytearray int constructor instead of
 string multiplication

---
 src/PIL/TgaImagePlugin.py | 6 +++---
 1 file changed, 3 insertions(+), 3 deletions(-)

diff --git a/src/PIL/TgaImagePlugin.py b/src/PIL/TgaImagePlugin.py
index d158fe49203..c41b31d6852 100644
--- a/src/PIL/TgaImagePlugin.py
+++ b/src/PIL/TgaImagePlugin.py
@@ -118,18 +118,18 @@ def _open(self) -> None:
             start, size, mapdepth = i16(s, 3), i16(s, 5), s[7]
             if mapdepth == 16:
                 colormap = self.fp.read(2 * size)
-                palette_data = bytearray(b"\0" * 2 * start)
+                palette_data = bytearray(2 * start)
                 for a, b in zip(colormap[::2], colormap[1::2]):
                     palette_data += bytearray((a, b ^ 128))
                 self.palette = ImagePalette.raw("BGRA;15", bytes(palette_data))
                 self.palette.mode = "RGBA"
             elif mapdepth == 24:
                 self.palette = ImagePalette.raw(
-                    "BGR", b"\0" * 3 * start + self.fp.read(3 * size)
+                    "BGR", bytes(3 * start) + self.fp.read(3 * size)
                 )
             elif mapdepth == 32:
                 self.palette = ImagePalette.raw(
-                    "BGRA", b"\0" * 4 * start + self.fp.read(4 * size)
+                    "BGRA", bytes(4 * start) + self.fp.read(4 * size)
                 )
             else:
                 msg = "unknown TGA map depth"

From 58d5a73fac7b4084fe4ba66a1a2c4ed097d0d557 Mon Sep 17 00:00:00 2001
From: Yay295 <Yay295@users.noreply.github.com>
Date: Mon, 17 Jun 2024 09:29:14 -0500
Subject: [PATCH 0749/1178] raise SyntaxError when parsing codestream rather
 than returning an empty string

Co-authored-by: Andrew Murray <3112309+radarhere@users.noreply.github.com>
---
 src/PIL/Jpeg2KImagePlugin.py | 9 +++------
 1 file changed, 3 insertions(+), 6 deletions(-)

diff --git a/src/PIL/Jpeg2KImagePlugin.py b/src/PIL/Jpeg2KImagePlugin.py
index 39eb1c20314..e50cd7799a3 100644
--- a/src/PIL/Jpeg2KImagePlugin.py
+++ b/src/PIL/Jpeg2KImagePlugin.py
@@ -97,7 +97,7 @@ def next_box_type(self) -> bytes:
         return tbox
 
 
-def _parse_codestream(fp):
+def _parse_codestream(fp) -> tuple[tuple[int, int], str]:
     """Parse the JPEG 2000 codestream to extract the size and component
     count from the SIZ marker segment, returning a PIL (size, mode) tuple."""
 
@@ -122,7 +122,8 @@ def _parse_codestream(fp):
     elif csiz == 4:
         mode = "RGBA"
     else:
-        mode = ""
+        msg = "unable to determine J2K image mode"
+        raise SyntaxError(msg)
 
     return size, mode
 
@@ -237,10 +238,6 @@ def _open(self) -> None:
                 msg = "not a JPEG 2000 file"
                 raise SyntaxError(msg)
 
-        if self.size is None or not self.mode:
-            msg = "unable to determine size/mode"
-            raise SyntaxError(msg)
-
         self._reduce = 0
         self.layers = 0
 

From 88b21e725432d418e56bdf0721f8581d14a24e40 Mon Sep 17 00:00:00 2001
From: Andrew Murray <radarhere@users.noreply.github.com>
Date: Tue, 25 Jun 2024 21:38:47 +1000
Subject: [PATCH 0750/1178] Added test

---
 Tests/images/unknown_mode.j2k | Bin 0 -> 318 bytes
 Tests/test_file_jpeg2k.py     |   6 ++++++
 2 files changed, 6 insertions(+)
 create mode 100644 Tests/images/unknown_mode.j2k

diff --git a/Tests/images/unknown_mode.j2k b/Tests/images/unknown_mode.j2k
new file mode 100644
index 0000000000000000000000000000000000000000..38719fe2561bb1341b69ed96e63f23bfb2c45d58
GIT binary patch
literal 318
zcmezG|38pHlK})cpcu>n5-d;*;j{8HGX4)@-~sX&8JJjD7#RP@FmO3EbaYGrqW>uj
zstk<IMX8A;sVNFcl?wg^sd-)juI>tDsYS(^`FRRPdM0`X|0ghTfsHc&YM*@mj{y%C
z&*TFPKN$`%2pnLLWnpJ#2J#pWFjxuje6;1!2CHWT>M%yAuLr4Lz#z||z{q}pp+?Dp
z!AgXIp@Yf&e?50US3Ot@6HtpOiWZ>pKx8N2z|717u|m*+fun)v&wOrsUWg`Upe8ef
jCVQaa3P6|eFfc!4VPpo{^^*x=R||JSd_8wE<NuogGDlDZ

literal 0
HcmV?d00001

diff --git a/Tests/test_file_jpeg2k.py b/Tests/test_file_jpeg2k.py
index ed7ea4fcfbc..95b9b967b0d 100644
--- a/Tests/test_file_jpeg2k.py
+++ b/Tests/test_file_jpeg2k.py
@@ -335,6 +335,12 @@ def test_issue_6194() -> None:
         assert im.getpixel((5, 5)) == 31
 
 
+def test_unknown_j2k_mode() -> None:
+    with pytest.raises(UnidentifiedImageError):
+        with Image.open("Tests/images/unknown_mode.j2k"):
+            pass
+
+
 def test_unbound_local() -> None:
     # prepatch, a malformed jp2 file could cause an UnboundLocalError exception.
     with pytest.raises(OSError):

From d2d03a1da24503f547fce334ff02b6f7183d2bc6 Mon Sep 17 00:00:00 2001
From: Andrew Murray <radarhere@users.noreply.github.com>
Date: Wed, 26 Jun 2024 06:35:15 +1000
Subject: [PATCH 0751/1178] Update CHANGES.rst [ci skip]

---
 CHANGES.rst | 21 +++++++++++++++++++++
 1 file changed, 21 insertions(+)

diff --git a/CHANGES.rst b/CHANGES.rst
index 6375f5c6397..20bc34152ed 100644
--- a/CHANGES.rst
+++ b/CHANGES.rst
@@ -5,6 +5,27 @@ Changelog (Pillow)
 10.4.0 (unreleased)
 -------------------
 
+- Do not use first frame duration for other frames when saving APNG images #8104
+  [radarhere]
+
+- Consider I;16 pixel size when using a 1 mode mask #8112
+  [radarhere]
+
+- When saving multiple PNG frames, convert to mode rather than raw mode #8087
+  [radarhere]
+
+- Added byte support to FreeTypeFont #8141
+  [radarhere]
+
+- Allow float center for rotate operations #8114
+  [radarhere]
+
+- Do not read layers immediately when opening PSD images #8039
+  [radarhere]
+
+- Restore original thread state #8065
+  [radarhere]
+
 - Read IM and TIFF images as RGB, rather than RGBX #7997
   [radarhere]
 

From 50d18bf547727d397b192555b2fa5b9a50e5aa63 Mon Sep 17 00:00:00 2001
From: Andrew Murray <radarhere@users.noreply.github.com>
Date: Wed, 26 Jun 2024 07:38:53 +1000
Subject: [PATCH 0752/1178] Truncated image to reduce file size

---
 Tests/images/ultrahdr.jpg | Bin 520842 -> 48197 bytes
 1 file changed, 0 insertions(+), 0 deletions(-)

diff --git a/Tests/images/ultrahdr.jpg b/Tests/images/ultrahdr.jpg
index 1c5cc4adfe07ff4bbf80e79a784caf287c3b867f..34f615b61aac021eff116bec24ae1facefb83d0a 100644
GIT binary patch
delta 9
QcmeBrDu46`(+1Z)02#Oh{{R30

delta 475939
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
z%0D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%0Dv<WUzRe4>G;*BG+6k
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


From 6ee41897e277a6e05f3673255b21333d7279d9fa Mon Sep 17 00:00:00 2001
From: Andrew Murray <radarhere@users.noreply.github.com>
Date: Wed, 26 Jun 2024 07:19:44 +1000
Subject: [PATCH 0753/1178] Added dedicated unpacker for inverted alpha

---
 src/PIL/TgaImagePlugin.py | 14 +++++---------
 src/libImaging/Unpack.c   | 18 +++++++++++++++++-
 2 files changed, 22 insertions(+), 10 deletions(-)

diff --git a/src/PIL/TgaImagePlugin.py b/src/PIL/TgaImagePlugin.py
index c41b31d6852..39104aeced9 100644
--- a/src/PIL/TgaImagePlugin.py
+++ b/src/PIL/TgaImagePlugin.py
@@ -36,7 +36,7 @@
     (3, 1): "1",
     (3, 8): "L",
     (3, 16): "LA",
-    (2, 16): "BGRA;15",
+    (2, 16): "BGRA;15Z",
     (2, 24): "BGR",
     (2, 32): "BGRA",
 }
@@ -87,9 +87,7 @@ def _open(self) -> None:
         elif imagetype in (1, 9):
             self._mode = "P" if colormaptype else "L"
         elif imagetype in (2, 10):
-            self._mode = "RGB"
-            if depth == 32:
-                self._mode = "RGBA"
+            self._mode = "RGB" if depth == 24 else "RGBA"
         else:
             msg = "unknown TGA mode"
             raise SyntaxError(msg)
@@ -117,11 +115,9 @@ def _open(self) -> None:
             # read palette
             start, size, mapdepth = i16(s, 3), i16(s, 5), s[7]
             if mapdepth == 16:
-                colormap = self.fp.read(2 * size)
-                palette_data = bytearray(2 * start)
-                for a, b in zip(colormap[::2], colormap[1::2]):
-                    palette_data += bytearray((a, b ^ 128))
-                self.palette = ImagePalette.raw("BGRA;15", bytes(palette_data))
+                self.palette = ImagePalette.raw(
+                    "BGRA;15Z", bytes(2 * start) + self.fp.read(2 * size)
+                )
                 self.palette.mode = "RGBA"
             elif mapdepth == 24:
                 self.palette = ImagePalette.raw(
diff --git a/src/libImaging/Unpack.c b/src/libImaging/Unpack.c
index 063bcbbcc48..eaa4374e3e9 100644
--- a/src/libImaging/Unpack.c
+++ b/src/libImaging/Unpack.c
@@ -718,6 +718,21 @@ ImagingUnpackBGRA15(UINT8 *out, const UINT8 *in, int pixels) {
     }
 }
 
+void
+ImagingUnpackBGRA15Z(UINT8 *out, const UINT8 *in, int pixels) {
+    int i, pixel;
+    /* RGB, rearranged channels, 5/5/5/1 bits per pixel, inverted alpha */
+    for (i = 0; i < pixels; i++) {
+        pixel = in[0] + (in[1] << 8);
+        out[B] = (pixel & 31) * 255 / 31;
+        out[G] = ((pixel >> 5) & 31) * 255 / 31;
+        out[R] = ((pixel >> 10) & 31) * 255 / 31;
+        out[A] = ~((pixel >> 15) * 255);
+        out += 4;
+        in += 2;
+    }
+}
+
 void
 ImagingUnpackRGB16(UINT8 *out, const UINT8 *in, int pixels) {
     int i, pixel;
@@ -1538,7 +1553,7 @@ static struct {
 
     /* flags: "I" inverted data; "R" reversed bit order; "B" big
        endian byte order (default is little endian); "L" line
-       interleave, "S" signed, "F" floating point */
+       interleave, "S" signed, "F" floating point, "Z" inverted alpha */
 
     /* exception: rawmodes "I" and "F" are always native endian byte order */
 
@@ -1646,6 +1661,7 @@ static struct {
     {"RGBA", "RGBA;L", 32, unpackRGBAL},
     {"RGBA", "RGBA;15", 16, ImagingUnpackRGBA15},
     {"RGBA", "BGRA;15", 16, ImagingUnpackBGRA15},
+    {"RGBA", "BGRA;15Z", 16, ImagingUnpackBGRA15Z},
     {"RGBA", "RGBA;4B", 16, ImagingUnpackRGBA4B},
     {"RGBA", "RGBA;16L", 64, unpackRGBA16L},
     {"RGBA", "RGBA;16B", 64, unpackRGBA16B},

From a90a9d5ea5fce7257cb22f904b6f013ec53d7eb3 Mon Sep 17 00:00:00 2001
From: Andrew Murray <radarhere@users.noreply.github.com>
Date: Wed, 26 Jun 2024 19:14:58 +1000
Subject: [PATCH 0754/1178] Update CHANGES.rst [ci skip]

---
 CHANGES.rst | 6 ++++++
 1 file changed, 6 insertions(+)

diff --git a/CHANGES.rst b/CHANGES.rst
index 20bc34152ed..cfb987bebb9 100644
--- a/CHANGES.rst
+++ b/CHANGES.rst
@@ -5,6 +5,12 @@ Changelog (Pillow)
 10.4.0 (unreleased)
 -------------------
 
+- Do not detect Ultra HDR images as MPO #8056
+  [radarhere]
+
+- Raise SyntaxError specific to JP2 #8146
+  [Yay295, radarhere]
+
 - Do not use first frame duration for other frames when saving APNG images #8104
   [radarhere]
 

From fd3f6c1a929e52332ac43fdbd328d767b9301839 Mon Sep 17 00:00:00 2001
From: Andrew Murray <radarhere@users.noreply.github.com>
Date: Wed, 26 Jun 2024 19:31:40 +1000
Subject: [PATCH 0755/1178] Remove zero-byte end padding when parsing any XMP
 data

---
 Tests/test_image.py        | 22 ++++++++++++++++++++++
 src/PIL/Image.py           |  2 +-
 src/PIL/JpegImagePlugin.py |  2 +-
 3 files changed, 24 insertions(+), 2 deletions(-)

diff --git a/Tests/test_image.py b/Tests/test_image.py
index 5b1ba6289f4..c5cf5b38331 100644
--- a/Tests/test_image.py
+++ b/Tests/test_image.py
@@ -8,6 +8,7 @@
 import tempfile
 import warnings
 from pathlib import Path
+from types import ModuleType
 from typing import IO, Any
 
 import pytest
@@ -35,6 +36,12 @@
     skip_unless_feature,
 )
 
+ElementTree: ModuleType | None
+try:
+    from defusedxml import ElementTree
+except ImportError:
+    ElementTree = None
+
 
 # Deprecation helper
 def helper_image_new(mode: str, size: tuple[int, int]) -> Image.Image:
@@ -921,6 +928,21 @@ def test_empty_xmp(self) -> None:
         with Image.open("Tests/images/hopper.gif") as im:
             assert im.getxmp() == {}
 
+    def test_getxmp_padded(self) -> None:
+        im = Image.new("RGB", (1, 1))
+        im.info["xmp"] = (
+            b'<?xpacket begin="\xef\xbb\xbf" id="W5M0MpCehiHzreSzNTczkc9d"?>\n'
+            b'<x:xmpmeta xmlns:x="adobe:ns:meta/" />\n<?xpacket end="w"?>\x00\x00'
+        )
+        if ElementTree is None:
+            with pytest.warns(
+                UserWarning,
+                match="XMP data cannot be read without defusedxml dependency",
+            ):
+                assert im.getxmp() == {}
+        else:
+            assert im.getxmp() == {"xmpmeta": None}
+
     @pytest.mark.parametrize("size", ((1, 0), (0, 1), (0, 0)))
     def test_zero_tobytes(self, size: tuple[int, int]) -> None:
         im = Image.new("RGB", size)
diff --git a/src/PIL/Image.py b/src/PIL/Image.py
index e9fb55d6b7a..cbeefa189a5 100644
--- a/src/PIL/Image.py
+++ b/src/PIL/Image.py
@@ -1511,7 +1511,7 @@ def get_value(element):
             return {}
         if "xmp" not in self.info:
             return {}
-        root = ElementTree.fromstring(self.info["xmp"])
+        root = ElementTree.fromstring(self.info["xmp"].rstrip(b"\x00"))
         return {get_name(root.tag): get_value(root)}
 
     def getexif(self) -> Exif:
diff --git a/src/PIL/JpegImagePlugin.py b/src/PIL/JpegImagePlugin.py
index b7d0d24f242..ada52915373 100644
--- a/src/PIL/JpegImagePlugin.py
+++ b/src/PIL/JpegImagePlugin.py
@@ -96,7 +96,7 @@ def APP(self, marker):
             self.info["exif"] = s
             self._exif_offset = self.fp.tell() - n + 6
     elif marker == 0xFFE1 and s[:29] == b"http://ns.adobe.com/xap/1.0/\x00":
-        self.info["xmp"] = s.split(b"\x00")[1]
+        self.info["xmp"] = s.split(b"\x00", 1)[1]
     elif marker == 0xFFE2 and s[:5] == b"FPXR\0":
         # extract FlashPix information (incomplete)
         self.info["flashpix"] = s  # FIXME: value will change

From 6863c87c0151c9330c4ef1db1bb9058b8d34f703 Mon Sep 17 00:00:00 2001
From: Andrew Murray <radarhere@users.noreply.github.com>
Date: Wed, 26 Jun 2024 18:06:47 +1000
Subject: [PATCH 0756/1178] Added test for non-colormap 16-bit image

---
 Tests/images/rgba16.tga | Bin 0 -> 48 bytes
 Tests/test_file_tga.py  |   8 ++++++++
 2 files changed, 8 insertions(+)
 create mode 100644 Tests/images/rgba16.tga

diff --git a/Tests/images/rgba16.tga b/Tests/images/rgba16.tga
new file mode 100644
index 0000000000000000000000000000000000000000..3918647a23cf31628e0beb8a14084ef7383582a1
GIT binary patch
literal 48
qcmZQzU}As)CI&_Z0S@_)SIsbykf2c4FwbC5e?Q#_H%}i|Jq7@4vIgk@

literal 0
HcmV?d00001

diff --git a/Tests/test_file_tga.py b/Tests/test_file_tga.py
index 15c7bbdb89e..a03a6a6e10a 100644
--- a/Tests/test_file_tga.py
+++ b/Tests/test_file_tga.py
@@ -81,6 +81,14 @@ def test_palette_depth_16(tmp_path: Path) -> None:
             assert_image_equal_tofile(reloaded.convert("RGBA"), "Tests/images/p_16.png")
 
 
+def test_rgba_16() -> None:
+    with Image.open("Tests/images/rgba16.tga") as im:
+        assert im.mode == "RGBA"
+
+        assert im.getpixel((0, 0)) == (172, 0, 255, 255)
+        assert im.getpixel((1, 0)) == (0, 255, 82, 0)
+
+
 def test_id_field() -> None:
     # tga file with id field
     test_file = "Tests/images/tga_id_field.tga"

From 304cf484aaba5285cfdf854c31cfe51505de3f9a Mon Sep 17 00:00:00 2001
From: Andrew Murray <radarhere@users.noreply.github.com>
Date: Thu, 27 Jun 2024 13:29:22 +1000
Subject: [PATCH 0757/1178] Do not presume "xmp" info simply because
 "XML:com.adobe.xmp" info exists

---
 Tests/test_imageops.py | 10 ++++++++++
 src/PIL/ImageOps.py    | 23 ++++++++++++-----------
 2 files changed, 22 insertions(+), 11 deletions(-)

diff --git a/Tests/test_imageops.py b/Tests/test_imageops.py
index 27a6090c5fa..64ef929c48d 100644
--- a/Tests/test_imageops.py
+++ b/Tests/test_imageops.py
@@ -432,6 +432,16 @@ def check(orientation_im: Image.Image) -> None:
     assert 0x0112 not in transposed_im.getexif()
 
 
+def test_exif_transpose_xml_without_xmp() -> None:
+    with Image.open("Tests/images/xmp_tags_orientation.png") as im:
+        assert im.getexif()[0x0112] == 3
+        assert "XML:com.adobe.xmp" in im.info
+
+        del im.info["xmp"]
+        transposed_im = ImageOps.exif_transpose(im)
+        assert 0x0112 not in transposed_im.getexif()
+
+
 def test_exif_transpose_in_place() -> None:
     with Image.open("Tests/images/orientation_rectangle.jpg") as im:
         assert im.size == (2, 1)
diff --git a/src/PIL/ImageOps.py b/src/PIL/ImageOps.py
index 6d2814345a3..a84c0834561 100644
--- a/src/PIL/ImageOps.py
+++ b/src/PIL/ImageOps.py
@@ -709,17 +709,18 @@ def exif_transpose(image: Image.Image, *, in_place: bool = False) -> Image.Image
                 exif_image.info["exif"] = exif.tobytes()
             elif "Raw profile type exif" in exif_image.info:
                 exif_image.info["Raw profile type exif"] = exif.tobytes().hex()
-            elif "XML:com.adobe.xmp" in exif_image.info:
-                for pattern in (
-                    r'tiff:Orientation="([0-9])"',
-                    r"<tiff:Orientation>([0-9])</tiff:Orientation>",
-                ):
-                    exif_image.info["XML:com.adobe.xmp"] = re.sub(
-                        pattern, "", exif_image.info["XML:com.adobe.xmp"]
-                    )
-                    exif_image.info["xmp"] = re.sub(
-                        pattern.encode(), b"", exif_image.info["xmp"]
-                    )
+            for key in ("XML:com.adobe.xmp", "xmp"):
+                if key in exif_image.info:
+                    for pattern in (
+                        r'tiff:Orientation="([0-9])"',
+                        r"<tiff:Orientation>([0-9])</tiff:Orientation>",
+                    ):
+                        value = exif_image.info[key]
+                        exif_image.info[key] = (
+                            re.sub(pattern, "", value)
+                            if isinstance(value, str)
+                            else re.sub(pattern.encode(), b"", value)
+                        )
         if not in_place:
             return transposed_image
     elif not in_place:

From 7b636a8e6c40b1d0802cbfc4394b5cae1233642a Mon Sep 17 00:00:00 2001
From: Andrew Murray <radarhere@users.noreply.github.com>
Date: Thu, 27 Jun 2024 20:28:36 +1000
Subject: [PATCH 0758/1178] Update CHANGES.rst [ci skip]

---
 CHANGES.rst | 3 +++
 1 file changed, 3 insertions(+)

diff --git a/CHANGES.rst b/CHANGES.rst
index cfb987bebb9..3de9ef65bf2 100644
--- a/CHANGES.rst
+++ b/CHANGES.rst
@@ -5,6 +5,9 @@ Changelog (Pillow)
 10.4.0 (unreleased)
 -------------------
 
+- Remove zero-byte end padding when parsing any XMP data #8171
+  [radarhere]
+
 - Do not detect Ultra HDR images as MPO #8056
   [radarhere]
 

From d18192cecfa239f2ce66991777199e32eedaef82 Mon Sep 17 00:00:00 2001
From: "renovate[bot]" <29139614+renovate[bot]@users.noreply.github.com>
Date: Fri, 28 Jun 2024 04:20:09 +0000
Subject: [PATCH 0759/1178] Update dependency mypy to v1.10.1

---
 .ci/requirements-mypy.txt | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/.ci/requirements-mypy.txt b/.ci/requirements-mypy.txt
index a0dcb92d22d..6dd43248837 100644
--- a/.ci/requirements-mypy.txt
+++ b/.ci/requirements-mypy.txt
@@ -1 +1 @@
-mypy==1.10.0
+mypy==1.10.1

From 88cd6d41eff702ac83300807b097f6044b665025 Mon Sep 17 00:00:00 2001
From: Andrew Murray <3112309+radarhere@users.noreply.github.com>
Date: Fri, 28 Jun 2024 17:28:42 +1000
Subject: [PATCH 0760/1178] Rearranged comments

Co-authored-by: Hugo van Kemenade <1324225+hugovk@users.noreply.github.com>
---
 src/PIL/JpegImagePlugin.py | 17 ++++++-----------
 1 file changed, 6 insertions(+), 11 deletions(-)

diff --git a/src/PIL/JpegImagePlugin.py b/src/PIL/JpegImagePlugin.py
index a9a89e58bd7..59259b7194c 100644
--- a/src/PIL/JpegImagePlugin.py
+++ b/src/PIL/JpegImagePlugin.py
@@ -487,18 +487,13 @@ def _read_dpi_from_exif(self) -> None:
                 dpi *= 2.54
             self.info["dpi"] = dpi, dpi
         except (
-            struct.error,
-            KeyError,
-            SyntaxError,
-            TypeError,
-            ValueError,
-            ZeroDivisionError,
+            struct.error,  # truncated EXIF
+            KeyError,  # dpi not included
+            SyntaxError,  # invalid/unreadable EXIF
+            TypeError,  # dpi is an invalid float
+            ValueError,  # dpi is an invalid float
+            ZeroDivisionError,  # invalid dpi rational value
         ):
-            # struct.error for truncated EXIF
-            # KeyError for dpi not included
-            # SyntaxError for invalid/unreadable EXIF
-            # ValueError or TypeError for dpi being an invalid float
-            # ZeroDivisionError for invalid dpi rational value
             self.info["dpi"] = 72, 72
 
     def _getmp(self):

From b48d17565652d9537bacb910101ad1ef9f56811a Mon Sep 17 00:00:00 2001
From: Andrew Murray <radarhere@users.noreply.github.com>
Date: Fri, 28 Jun 2024 21:13:41 +1000
Subject: [PATCH 0761/1178] Update CHANGES.rst [ci skip]

---
 CHANGES.rst | 15 +++++++++++++++
 1 file changed, 15 insertions(+)

diff --git a/CHANGES.rst b/CHANGES.rst
index 3de9ef65bf2..a6f2bc12c1d 100644
--- a/CHANGES.rst
+++ b/CHANGES.rst
@@ -5,6 +5,21 @@ Changelog (Pillow)
 10.4.0 (unreleased)
 -------------------
 
+- Deprecate non-image ImageCms modes #8031
+  [radarhere]
+
+- Fixed processing multiple JPEG EXIF markers #8127
+  [radarhere]
+
+- Do not preserve EXIFIFD tag by default when saving TIFF images #8110
+  [radarhere]
+
+- Added ImageFont.load_default_imagefont() #8086
+  [radarhere]
+
+- Added Image.WARN_POSSIBLE_FORMATS #8063
+  [radarhere]
+
 - Remove zero-byte end padding when parsing any XMP data #8171
   [radarhere]
 

From c9ec76aa0db65b52c96dd3973a755367a9c41755 Mon Sep 17 00:00:00 2001
From: Andrew Murray <radarhere@users.noreply.github.com>
Date: Fri, 28 Jun 2024 21:27:44 +1000
Subject: [PATCH 0762/1178] Raise FileNotFoundError if show_file() path does
 not exist

---
 Tests/test_imageshow.py      | 22 ++++++++++++++++++++++
 docs/releasenotes/10.4.0.rst | 34 ++++++++--------------------------
 src/PIL/ImageShow.py         | 16 ++++++++++++++++
 3 files changed, 46 insertions(+), 26 deletions(-)

diff --git a/Tests/test_imageshow.py b/Tests/test_imageshow.py
index 4e9291fbbfb..0bff4389607 100644
--- a/Tests/test_imageshow.py
+++ b/Tests/test_imageshow.py
@@ -1,5 +1,6 @@
 from __future__ import annotations
 
+import os
 from typing import Any
 
 import pytest
@@ -65,6 +66,27 @@ def test_show_without_viewers() -> None:
     ImageShow._viewers = viewers
 
 
+@pytest.mark.parametrize(
+    "viewer",
+    (
+        ImageShow.Viewer(),
+        ImageShow.WindowsViewer(),
+        ImageShow.MacViewer(),
+        ImageShow.XDGViewer(),
+        ImageShow.DisplayViewer(),
+        ImageShow.GmDisplayViewer(),
+        ImageShow.EogViewer(),
+        ImageShow.XVViewer(),
+        ImageShow.IPythonViewer(),
+    ),
+)
+def test_show_file(viewer: ImageShow.Viewer) -> None:
+    assert not os.path.exists("missing.png")
+
+    with pytest.raises(FileNotFoundError):
+        viewer.show_file("missing.png")
+
+
 def test_viewer() -> None:
     viewer = ImageShow.Viewer()
 
diff --git a/docs/releasenotes/10.4.0.rst b/docs/releasenotes/10.4.0.rst
index 96300c008e8..8d3706be617 100644
--- a/docs/releasenotes/10.4.0.rst
+++ b/docs/releasenotes/10.4.0.rst
@@ -4,21 +4,16 @@
 Security
 ========
 
-TODO
-^^^^
-
-TODO
-
-:cve:`YYYY-XXXXX`: TODO
-^^^^^^^^^^^^^^^^^^^^^^^
-
-TODO
+ImageShow.WindowsViewer.show_file
+^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
 
-Backwards Incompatible Changes
-==============================
+If an attacker has control over the ``path`` passed to
+``ImageShow.WindowsViewer.show_file()``, they may be able to
+execute arbitrary shell commands.
 
-TODO
-^^^^
+To prevent this, a :py:exc:`FileNotFoundError` will be raised if the ``path``
+does not exist as a file. To provide a consistent experience, the error has
+been added to all :py:class:`~PIL.ImageShow` viewers.
 
 Deprecations
 ============
@@ -46,14 +41,6 @@ ImageDraw.getdraw hints parameter
 
 The ``hints`` parameter in :py:meth:`~PIL.ImageDraw.getdraw()` has been deprecated.
 
-API Changes
-===========
-
-TODO
-^^^^
-
-TODO
-
 API Additions
 =============
 
@@ -64,11 +51,6 @@ Added :py:meth:`~PIL.ImageDraw.ImageDraw.circle`. It provides the same functiona
 :py:meth:`~PIL.ImageDraw.ImageDraw.ellipse`, but instead of taking a bounding box, it
 takes a center point and radius.
 
-TODO
-^^^^
-
-TODO
-
 Other Changes
 =============
 
diff --git a/src/PIL/ImageShow.py b/src/PIL/ImageShow.py
index f60b1e11e18..037d6f492ce 100644
--- a/src/PIL/ImageShow.py
+++ b/src/PIL/ImageShow.py
@@ -118,6 +118,8 @@ def show_file(self, path: str, **options: Any) -> int:
         """
         Display given file.
         """
+        if not os.path.exists(path):
+            raise FileNotFoundError
         os.system(self.get_command(path, **options))  # nosec
         return 1
 
@@ -142,6 +144,8 @@ def show_file(self, path: str, **options: Any) -> int:
         """
         Display given file.
         """
+        if not os.path.exists(path):
+            raise FileNotFoundError
         subprocess.Popen(
             self.get_command(path, **options),
             shell=True,
@@ -171,6 +175,8 @@ def show_file(self, path: str, **options: Any) -> int:
         """
         Display given file.
         """
+        if not os.path.exists(path):
+            raise FileNotFoundError
         subprocess.call(["open", "-a", "Preview.app", path])
         executable = sys.executable or shutil.which("python3")
         if executable:
@@ -215,6 +221,8 @@ def show_file(self, path: str, **options: Any) -> int:
         """
         Display given file.
         """
+        if not os.path.exists(path):
+            raise FileNotFoundError
         subprocess.Popen(["xdg-open", path])
         return 1
 
@@ -237,6 +245,8 @@ def show_file(self, path: str, **options: Any) -> int:
         """
         Display given file.
         """
+        if not os.path.exists(path):
+            raise FileNotFoundError
         args = ["display"]
         title = options.get("title")
         if title:
@@ -259,6 +269,8 @@ def show_file(self, path: str, **options: Any) -> int:
         """
         Display given file.
         """
+        if not os.path.exists(path):
+            raise FileNotFoundError
         subprocess.Popen(["gm", "display", path])
         return 1
 
@@ -275,6 +287,8 @@ def show_file(self, path: str, **options: Any) -> int:
         """
         Display given file.
         """
+        if not os.path.exists(path):
+            raise FileNotFoundError
         subprocess.Popen(["eog", "-n", path])
         return 1
 
@@ -299,6 +313,8 @@ def show_file(self, path: str, **options: Any) -> int:
         """
         Display given file.
         """
+        if not os.path.exists(path):
+            raise FileNotFoundError
         args = ["xv"]
         title = options.get("title")
         if title:

From b55d74bcfe4b4e69a64d09c785552af8dc9f013d Mon Sep 17 00:00:00 2001
From: Andrew Murray <radarhere@users.noreply.github.com>
Date: Sat, 29 Jun 2024 07:47:26 +1000
Subject: [PATCH 0763/1178] Update CHANGES.rst [ci skip]

---
 CHANGES.rst | 6 ++++++
 1 file changed, 6 insertions(+)

diff --git a/CHANGES.rst b/CHANGES.rst
index a6f2bc12c1d..641aa8803f7 100644
--- a/CHANGES.rst
+++ b/CHANGES.rst
@@ -5,6 +5,12 @@ Changelog (Pillow)
 10.4.0 (unreleased)
 -------------------
 
+- Raise FileNotFoundError if show_file() path does not exist #8178
+  [radarhere]
+
+- Improved reading 16-bit TGA images with colour #7965
+  [Yay295, radarhere]
+
 - Deprecate non-image ImageCms modes #8031
   [radarhere]
 

From 9b4fae77178e827ab17118fbc89c739ffd6a0fab Mon Sep 17 00:00:00 2001
From: Andrew Murray <radarhere@users.noreply.github.com>
Date: Mon, 1 Jul 2024 15:42:12 +1000
Subject: [PATCH 0764/1178] 10.4.0 version bump

---
 CHANGES.rst         | 2 +-
 src/PIL/_version.py | 2 +-
 2 files changed, 2 insertions(+), 2 deletions(-)

diff --git a/CHANGES.rst b/CHANGES.rst
index 641aa8803f7..d071f3214bc 100644
--- a/CHANGES.rst
+++ b/CHANGES.rst
@@ -2,7 +2,7 @@
 Changelog (Pillow)
 ==================
 
-10.4.0 (unreleased)
+10.4.0 (2024-07-01)
 -------------------
 
 - Raise FileNotFoundError if show_file() path does not exist #8178
diff --git a/src/PIL/_version.py b/src/PIL/_version.py
index 12d7412eaa1..cebfd868cfd 100644
--- a/src/PIL/_version.py
+++ b/src/PIL/_version.py
@@ -1,4 +1,4 @@
 # Master version for Pillow
 from __future__ import annotations
 
-__version__ = "10.4.0.dev0"
+__version__ = "10.4.0"

From 2a660bbe9f58c4a6523208a21caaa4ec88275d17 Mon Sep 17 00:00:00 2001
From: Hugo van Kemenade <1324225+hugovk@users.noreply.github.com>
Date: Sun, 30 Jun 2024 00:10:33 +0300
Subject: [PATCH 0765/1178] Remove PSFile class, deprecated in Pillow 9.5.0

---
 Tests/test_file_eps.py       | 40 -------------------------
 docs/deprecations.rst        | 21 ++++++-------
 docs/releasenotes/11.0.0.rst | 58 ++++++++++++++++++++++++++++++++++++
 docs/releasenotes/9.5.0.rst  |  2 +-
 docs/releasenotes/index.rst  |  1 +
 src/PIL/EpsImagePlugin.py    | 38 -----------------------
 6 files changed, 71 insertions(+), 89 deletions(-)
 create mode 100644 docs/releasenotes/11.0.0.rst

diff --git a/Tests/test_file_eps.py b/Tests/test_file_eps.py
index 1c21aa8ca67..3181fc20444 100644
--- a/Tests/test_file_eps.py
+++ b/Tests/test_file_eps.py
@@ -329,46 +329,6 @@ def test_read_binary_preview() -> None:
         pass
 
 
-def test_readline_psfile(tmp_path: Path) -> None:
-    # check all the freaking line endings possible from the spec
-    # test_string = u'something\r\nelse\n\rbaz\rbif\n'
-    line_endings = ["\r\n", "\n", "\n\r", "\r"]
-    strings = ["something", "else", "baz", "bif"]
-
-    def _test_readline(t: EpsImagePlugin.PSFile, ending: str) -> None:
-        ending = f"Failure with line ending: {''.join(str(ord(s)) for s in ending)}"
-        assert t.readline().strip("\r\n") == "something", ending
-        assert t.readline().strip("\r\n") == "else", ending
-        assert t.readline().strip("\r\n") == "baz", ending
-        assert t.readline().strip("\r\n") == "bif", ending
-
-    def _test_readline_io_psfile(test_string: str, ending: str) -> None:
-        f = io.BytesIO(test_string.encode("latin-1"))
-        with pytest.warns(DeprecationWarning):
-            t = EpsImagePlugin.PSFile(f)
-        _test_readline(t, ending)
-
-    def _test_readline_file_psfile(test_string: str, ending: str) -> None:
-        f = str(tmp_path / "temp.txt")
-        with open(f, "wb") as w:
-            w.write(test_string.encode("latin-1"))
-
-        with open(f, "rb") as r:
-            with pytest.warns(DeprecationWarning):
-                t = EpsImagePlugin.PSFile(r)
-            _test_readline(t, ending)
-
-    for ending in line_endings:
-        s = ending.join(strings)
-        _test_readline_io_psfile(s, ending)
-        _test_readline_file_psfile(s, ending)
-
-
-def test_psfile_deprecation() -> None:
-    with pytest.warns(DeprecationWarning):
-        EpsImagePlugin.PSFile(None)
-
-
 @pytest.mark.parametrize("prefix", (b"", simple_binary_header))
 @pytest.mark.parametrize(
     "line_ending",
diff --git a/docs/deprecations.rst b/docs/deprecations.rst
index 0f996a94bec..b7c15ff637a 100644
--- a/docs/deprecations.rst
+++ b/docs/deprecations.rst
@@ -12,16 +12,6 @@ Deprecated features
 Below are features which are considered deprecated. Where appropriate,
 a :py:exc:`DeprecationWarning` is issued.
 
-PSFile
-~~~~~~
-
-.. deprecated:: 9.5.0
-
-The :py:class:`~PIL.EpsImagePlugin.PSFile` class has been deprecated and will
-be removed in Pillow 11 (2024-10-15). This class was only made as a helper to
-be used internally, so there is no replacement. If you need this functionality
-though, it is a very short class that can easily be recreated in your own code.
-
 PyAccess and Image.USE_CFFI_ACCESS
 ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
 
@@ -137,6 +127,17 @@ Removed features
 Deprecated features are only removed in major releases after an appropriate
 period of deprecation has passed.
 
+PSFile
+~~~~~~
+
+.. deprecated:: 9.5.0
+.. versionremoved:: 11.0.0
+
+The :py:class:`!PSFile` class was removed in Pillow 11 (2024-10-15).
+This class was only made as a helper to be used internally,
+so there is no replacement. If you need this functionality though,
+it is a very short class that can easily be recreated in your own code.
+
 Tk/Tcl 8.4
 ~~~~~~~~~~
 
diff --git a/docs/releasenotes/11.0.0.rst b/docs/releasenotes/11.0.0.rst
new file mode 100644
index 00000000000..e04ae9fd694
--- /dev/null
+++ b/docs/releasenotes/11.0.0.rst
@@ -0,0 +1,58 @@
+11.0.0
+------
+
+Security
+========
+
+TODO
+^^^^
+
+TODO
+
+:cve:`YYYY-XXXXX`: TODO
+^^^^^^^^^^^^^^^^^^^^^^^
+
+TODO
+
+Backwards Incompatible Changes
+==============================
+
+PSFile
+^^^^^^
+
+The :py:class:`!PSFile` class was removed in Pillow 11 (2024-10-15).
+This class was only made as a helper to be used internally,
+so there is no replacement. If you need this functionality though,
+it is a very short class that can easily be recreated in your own code.
+
+Deprecations
+============
+
+TODO
+^^^^
+
+TODO
+
+API Changes
+===========
+
+TODO
+^^^^
+
+TODO
+
+API Additions
+=============
+
+TODO
+^^^^
+
+TODO
+
+Other Changes
+=============
+
+TODO
+^^^^
+
+TODO
diff --git a/docs/releasenotes/9.5.0.rst b/docs/releasenotes/9.5.0.rst
index 08e9ec2a473..501479bb6df 100644
--- a/docs/releasenotes/9.5.0.rst
+++ b/docs/releasenotes/9.5.0.rst
@@ -32,7 +32,7 @@ Deprecations
 PSFile
 ^^^^^^
 
-The :py:class:`~PIL.EpsImagePlugin.PSFile` class has been deprecated and will
+The :py:class:`!PSFile` class has been deprecated and will
 be removed in Pillow 11 (2024-10-15). This class was only made as a helper to
 be used internally, so there is no replacement. If you need this functionality
 though, it is a very short class that can easily be recreated in your own code.
diff --git a/docs/releasenotes/index.rst b/docs/releasenotes/index.rst
index 6ee5fb6c8f4..641cda4efb5 100644
--- a/docs/releasenotes/index.rst
+++ b/docs/releasenotes/index.rst
@@ -14,6 +14,7 @@ expected to be backported to earlier versions.
 .. toctree::
   :maxdepth: 2
 
+  11.0.0
   10.4.0
   10.3.0
   10.2.0
diff --git a/src/PIL/EpsImagePlugin.py b/src/PIL/EpsImagePlugin.py
index f31b1c1a2d0..71e86904548 100644
--- a/src/PIL/EpsImagePlugin.py
+++ b/src/PIL/EpsImagePlugin.py
@@ -31,7 +31,6 @@
 
 from . import Image, ImageFile
 from ._binary import i32le as i32
-from ._deprecate import deprecate
 
 # --------------------------------------------------------------------
 
@@ -159,43 +158,6 @@ def Ghostscript(tile, size, fp, scale=1, transparency=False):
     return im
 
 
-class PSFile:
-    """
-    Wrapper for bytesio object that treats either CR or LF as end of line.
-    This class is no longer used internally, but kept for backwards compatibility.
-    """
-
-    def __init__(self, fp):
-        deprecate(
-            "PSFile",
-            11,
-            action="If you need the functionality of this class "
-            "you will need to implement it yourself.",
-        )
-        self.fp = fp
-        self.char = None
-
-    def seek(self, offset, whence=io.SEEK_SET):
-        self.char = None
-        self.fp.seek(offset, whence)
-
-    def readline(self) -> str:
-        s = [self.char or b""]
-        self.char = None
-
-        c = self.fp.read(1)
-        while (c not in b"\r\n") and len(c):
-            s.append(c)
-            c = self.fp.read(1)
-
-        self.char = self.fp.read(1)
-        # line endings can be 1 or 2 of \r \n, in either order
-        if self.char in b"\r\n":
-            self.char = None
-
-        return b"".join(s).decode("latin-1")
-
-
 def _accept(prefix: bytes) -> bool:
     return prefix[:4] == b"%!PS" or (len(prefix) >= 4 and i32(prefix) == 0xC6D3D0C5)
 

From a3a6198286119a5c4b1e7bbeb48b6363315be252 Mon Sep 17 00:00:00 2001
From: Andrew Murray <radarhere@users.noreply.github.com>
Date: Mon, 1 Jul 2024 19:53:27 +1000
Subject: [PATCH 0766/1178] 11.0.0.dev0 version bump

---
 src/PIL/_version.py | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/src/PIL/_version.py b/src/PIL/_version.py
index cebfd868cfd..c4a72ad7ede 100644
--- a/src/PIL/_version.py
+++ b/src/PIL/_version.py
@@ -1,4 +1,4 @@
 # Master version for Pillow
 from __future__ import annotations
 
-__version__ = "10.4.0"
+__version__ = "11.0.0.dev0"

From eb5bf181920d0bb74166aa8cc6df0b657baa9e2f Mon Sep 17 00:00:00 2001
From: Hugo van Kemenade <1324225+hugovk@users.noreply.github.com>
Date: Mon, 1 Jul 2024 13:25:43 +0300
Subject: [PATCH 0767/1178] Bump deprecation tests to Pillow 12

---
 Tests/test_deprecate.py | 20 ++++++++++----------
 1 file changed, 10 insertions(+), 10 deletions(-)

diff --git a/Tests/test_deprecate.py b/Tests/test_deprecate.py
index 584d8f91d67..82ff14181a3 100644
--- a/Tests/test_deprecate.py
+++ b/Tests/test_deprecate.py
@@ -9,9 +9,9 @@
     "version, expected",
     [
         (
-            11,
-            "Old thing is deprecated and will be removed in Pillow 11 "
-            r"\(2024-10-15\)\. Use new thing instead\.",
+            12,
+            "Old thing is deprecated and will be removed in Pillow 12 "
+            r"\(2025-10-15\)\. Use new thing instead\.",
         ),
         (
             None,
@@ -54,18 +54,18 @@ def test_old_version(deprecated: str, plural: bool, expected: str) -> None:
 
 def test_plural() -> None:
     expected = (
-        r"Old things are deprecated and will be removed in Pillow 11 \(2024-10-15\)\. "
+        r"Old things are deprecated and will be removed in Pillow 12 \(2025-10-15\)\. "
         r"Use new thing instead\."
     )
     with pytest.warns(DeprecationWarning, match=expected):
-        _deprecate.deprecate("Old things", 11, "new thing", plural=True)
+        _deprecate.deprecate("Old things", 12, "new thing", plural=True)
 
 
 def test_replacement_and_action() -> None:
     expected = "Use only one of 'replacement' and 'action'"
     with pytest.raises(ValueError, match=expected):
         _deprecate.deprecate(
-            "Old thing", 11, replacement="new thing", action="Upgrade to new thing"
+            "Old thing", 12, replacement="new thing", action="Upgrade to new thing"
         )
 
 
@@ -78,16 +78,16 @@ def test_replacement_and_action() -> None:
 )
 def test_action(action: str) -> None:
     expected = (
-        r"Old thing is deprecated and will be removed in Pillow 11 \(2024-10-15\)\. "
+        r"Old thing is deprecated and will be removed in Pillow 12 \(2025-10-15\)\. "
         r"Upgrade to new thing\."
     )
     with pytest.warns(DeprecationWarning, match=expected):
-        _deprecate.deprecate("Old thing", 11, action=action)
+        _deprecate.deprecate("Old thing", 12, action=action)
 
 
 def test_no_replacement_or_action() -> None:
     expected = (
-        r"Old thing is deprecated and will be removed in Pillow 11 \(2024-10-15\)"
+        r"Old thing is deprecated and will be removed in Pillow 12 \(2025-10-15\)"
     )
     with pytest.warns(DeprecationWarning, match=expected):
-        _deprecate.deprecate("Old thing", 11)
+        _deprecate.deprecate("Old thing", 12)

From 43cc1e36595422047b98659e7346ee1c8b08bd6f Mon Sep 17 00:00:00 2001
From: Andrew Murray <radarhere@users.noreply.github.com>
Date: Sat, 29 Jun 2024 15:02:50 +1000
Subject: [PATCH 0768/1178] Removed PyAccess and Image.USE_CFFI_ACCESS

---
 .ci/install.sh                     |   2 -
 .coveragerc                        |   1 -
 .github/workflows/macos-install.sh |   3 -
 .github/workflows/test-cygwin.yml  |   1 -
 .github/workflows/test-mingw.yml   |   1 -
 Tests/bench_cffi_access.py         |  54 ----
 Tests/test_image_access.py         | 168 +------------
 codecov.yml                        |   1 -
 docs/deprecations.rst              |  24 +-
 docs/reference/PyAccess.rst        |  47 ----
 docs/reference/index.rst           |   1 -
 docs/releasenotes/11.0.0.rst       |   9 +
 src/PIL/GifImagePlugin.py          |   1 -
 src/PIL/IcoImagePlugin.py          |   1 -
 src/PIL/Image.py                   |  31 +--
 src/PIL/ImageOps.py                |   1 -
 src/PIL/PngImagePlugin.py          |   4 -
 src/PIL/PyAccess.py                | 381 -----------------------------
 tox.ini                            |   2 -
 19 files changed, 33 insertions(+), 700 deletions(-)
 delete mode 100644 Tests/bench_cffi_access.py
 delete mode 100644 docs/reference/PyAccess.rst
 delete mode 100644 src/PIL/PyAccess.py

diff --git a/.ci/install.sh b/.ci/install.sh
index 30b64349d70..c6e166171a4 100755
--- a/.ci/install.sh
+++ b/.ci/install.sh
@@ -28,8 +28,6 @@ fi
 
 python3 -m pip install --upgrade pip
 python3 -m pip install --upgrade wheel
-# TODO Update condition when cffi supports 3.13
-if ! [[ "$GHA_PYTHON_VERSION" == "3.13" ]]; then PYTHONOPTIMIZE=0 python3 -m pip install cffi ; fi
 python3 -m pip install coverage
 python3 -m pip install defusedxml
 python3 -m pip install olefile
diff --git a/.coveragerc b/.coveragerc
index 018cc1cbfb1..a94a2567854 100644
--- a/.coveragerc
+++ b/.coveragerc
@@ -19,6 +19,5 @@ exclude_also =
 [run]
 omit =
     Tests/32bit_segfault_check.py
-    Tests/bench_cffi_access.py
     Tests/check_*.py
     Tests/createfontdatachunk.py
diff --git a/.github/workflows/macos-install.sh b/.github/workflows/macos-install.sh
index f8f191d387a..ae346e8b6c3 100755
--- a/.github/workflows/macos-install.sh
+++ b/.github/workflows/macos-install.sh
@@ -18,9 +18,6 @@ else
 fi
 export PKG_CONFIG_PATH="/usr/local/opt/openblas/lib/pkgconfig"
 
-# TODO Update condition when cffi supports 3.13
-if ! [[ "$GHA_PYTHON_VERSION" == "3.13" ]]; then PYTHONOPTIMIZE=0 python3 -m pip install cffi ; fi
-
 python3 -m pip install coverage
 python3 -m pip install defusedxml
 python3 -m pip install olefile
diff --git a/.github/workflows/test-cygwin.yml b/.github/workflows/test-cygwin.yml
index 1269ef8cb4a..97422d56916 100644
--- a/.github/workflows/test-cygwin.yml
+++ b/.github/workflows/test-cygwin.yml
@@ -72,7 +72,6 @@ jobs:
             make
             netpbm
             perl
-            python3${{ matrix.python-minor-version }}-cffi
             python3${{ matrix.python-minor-version }}-cython
             python3${{ matrix.python-minor-version }}-devel
             python3${{ matrix.python-minor-version }}-numpy
diff --git a/.github/workflows/test-mingw.yml b/.github/workflows/test-mingw.yml
index a773ca45304..e5e1ec32e2b 100644
--- a/.github/workflows/test-mingw.yml
+++ b/.github/workflows/test-mingw.yml
@@ -64,7 +64,6 @@ jobs:
               mingw-w64-x86_64-libtiff \
               mingw-w64-x86_64-libwebp \
               mingw-w64-x86_64-openjpeg2 \
-              mingw-w64-x86_64-python3-cffi \
               mingw-w64-x86_64-python3-numpy \
               mingw-w64-x86_64-python3-olefile \
               mingw-w64-x86_64-python3-setuptools \
diff --git a/Tests/bench_cffi_access.py b/Tests/bench_cffi_access.py
deleted file mode 100644
index c7d105836aa..00000000000
--- a/Tests/bench_cffi_access.py
+++ /dev/null
@@ -1,54 +0,0 @@
-from __future__ import annotations
-
-import time
-
-from PIL import PyAccess
-
-from .helper import hopper
-
-# Not running this test by default. No DOS against CI.
-
-
-def iterate_get(size, access) -> None:
-    (w, h) = size
-    for x in range(w):
-        for y in range(h):
-            access[(x, y)]
-
-
-def iterate_set(size, access) -> None:
-    (w, h) = size
-    for x in range(w):
-        for y in range(h):
-            access[(x, y)] = (x % 256, y % 256, 0)
-
-
-def timer(func, label, *args) -> None:
-    iterations = 5000
-    starttime = time.time()
-    for x in range(iterations):
-        func(*args)
-        if time.time() - starttime > 10:
-            break
-    endtime = time.time()
-    print(
-        f"{label}: completed {x + 1} iterations in {endtime - starttime:.4f}s, "
-        f"{(endtime - starttime) / (x + 1.0):.6f}s per iteration"
-    )
-
-
-def test_direct() -> None:
-    im = hopper()
-    im.load()
-    # im = Image.new("RGB", (2000, 2000), (1, 3, 2))
-    caccess = im.im.pixel_access(False)
-    access = PyAccess.new(im, False)
-
-    assert access is not None
-    assert caccess[(0, 0)] == access[(0, 0)]
-
-    print(f"Size: {im.width}x{im.height}")
-    timer(iterate_get, "PyAccess - get", im.size, access)
-    timer(iterate_set, "PyAccess - set", im.size, access)
-    timer(iterate_get, "C-api - get", im.size, caccess)
-    timer(iterate_set, "C-api - set", im.size, caccess)
diff --git a/Tests/test_image_access.py b/Tests/test_image_access.py
index 8abb1f69fc1..52ffef5e88f 100644
--- a/Tests/test_image_access.py
+++ b/Tests/test_image_access.py
@@ -12,19 +12,6 @@
 
 from .helper import assert_image_equal, hopper, is_win32
 
-# CFFI imports pycparser which doesn't support PYTHONOPTIMIZE=2
-# https://github.com/eliben/pycparser/pull/198#issuecomment-317001670
-cffi: ModuleType | None
-if os.environ.get("PYTHONOPTIMIZE") == "2":
-    cffi = None
-else:
-    try:
-        import cffi
-
-        from PIL import PyAccess
-    except ImportError:
-        cffi = None
-
 numpy: ModuleType | None
 try:
     import numpy
@@ -32,21 +19,7 @@
     numpy = None
 
 
-class AccessTest:
-    # Initial value
-    _init_cffi_access = Image.USE_CFFI_ACCESS
-    _need_cffi_access = False
-
-    @classmethod
-    def setup_class(cls) -> None:
-        Image.USE_CFFI_ACCESS = cls._need_cffi_access
-
-    @classmethod
-    def teardown_class(cls) -> None:
-        Image.USE_CFFI_ACCESS = cls._init_cffi_access
-
-
-class TestImagePutPixel(AccessTest):
+class TestImagePutPixel:
     def test_sanity(self) -> None:
         im1 = hopper()
         im2 = Image.new(im1.mode, im1.size, 0)
@@ -131,7 +104,7 @@ def test_numpy(self) -> None:
         assert pix[numpy.int32(1), numpy.int32(2)] == (18, 20, 59)
 
 
-class TestImageGetPixel(AccessTest):
+class TestImageGetPixel:
     @staticmethod
     def color(mode: str) -> int | tuple[int, ...]:
         bands = Image.getmodebands(mode)
@@ -144,9 +117,6 @@ def color(mode: str) -> int | tuple[int, ...]:
         return tuple(range(1, bands + 1))
 
     def check(self, mode: str, expected_color_int: int | None = None) -> None:
-        if self._need_cffi_access and mode.startswith("BGR;"):
-            pytest.skip("Support not added to deprecated module for BGR;* modes")
-
         expected_color = (
             self.color(mode) if expected_color_int is None else expected_color_int
         )
@@ -171,15 +141,14 @@ def check(self, mode: str, expected_color_int: int | None = None) -> None:
         # Check 0x0 image with None initial color
         im = Image.new(mode, (0, 0), None)
         assert im.load() is not None
-        error = ValueError if self._need_cffi_access else IndexError
-        with pytest.raises(error):
+        with pytest.raises(IndexError):
             im.putpixel((0, 0), expected_color)
-        with pytest.raises(error):
+        with pytest.raises(IndexError):
             im.getpixel((0, 0))
         # Check negative index
-        with pytest.raises(error):
+        with pytest.raises(IndexError):
             im.putpixel((-1, -1), expected_color)
-        with pytest.raises(error):
+        with pytest.raises(IndexError):
             im.getpixel((-1, -1))
 
         # Check initial color
@@ -199,10 +168,10 @@ def check(self, mode: str, expected_color_int: int | None = None) -> None:
 
         # Check 0x0 image with initial color
         im = Image.new(mode, (0, 0), expected_color)
-        with pytest.raises(error):
+        with pytest.raises(IndexError):
             im.getpixel((0, 0))
         # Check negative index
-        with pytest.raises(error):
+        with pytest.raises(IndexError):
             im.getpixel((-1, -1))
 
     @pytest.mark.parametrize("mode", Image.MODES)
@@ -235,126 +204,7 @@ def test_p_putpixel_rgb_rgba(self, mode: str, color: tuple[int, ...]) -> None:
         assert im.convert("RGBA").getpixel((0, 0)) == (255, 0, 0, alpha)
 
 
-@pytest.mark.filterwarnings("ignore::DeprecationWarning")
-@pytest.mark.skipif(cffi is None, reason="No CFFI")
-class TestCffiPutPixel(TestImagePutPixel):
-    _need_cffi_access = True
-
-
-@pytest.mark.filterwarnings("ignore::DeprecationWarning")
-@pytest.mark.skipif(cffi is None, reason="No CFFI")
-class TestCffiGetPixel(TestImageGetPixel):
-    _need_cffi_access = True
-
-
-@pytest.mark.skipif(cffi is None, reason="No CFFI")
-class TestCffi(AccessTest):
-    _need_cffi_access = True
-
-    def _test_get_access(self, im: Image.Image) -> None:
-        """Do we get the same thing as the old pixel access
-
-        Using private interfaces, forcing a capi access and
-        a pyaccess for the same image"""
-        caccess = im.im.pixel_access(False)
-        with pytest.warns(DeprecationWarning):
-            access = PyAccess.new(im, False)
-        assert access is not None
-
-        w, h = im.size
-        for x in range(0, w, 10):
-            for y in range(0, h, 10):
-                assert access[(x, y)] == caccess[(x, y)]
-
-        # Access an out-of-range pixel
-        with pytest.raises(ValueError):
-            access[(access.xsize + 1, access.ysize + 1)]
-
-    def test_get_vs_c(self) -> None:
-        with pytest.warns(DeprecationWarning):
-            rgb = hopper("RGB")
-            rgb.load()
-            self._test_get_access(rgb)
-            for mode in ("RGBA", "L", "LA", "1", "P", "F"):
-                self._test_get_access(hopper(mode))
-
-            for mode in ("I;16", "I;16L", "I;16B", "I;16N", "I"):
-                im = Image.new(mode, (10, 10), 40000)
-                self._test_get_access(im)
-
-    def _test_set_access(self, im: Image.Image, color: tuple[int, ...] | float) -> None:
-        """Are we writing the correct bits into the image?
-
-        Using private interfaces, forcing a capi access and
-        a pyaccess for the same image"""
-        caccess = im.im.pixel_access(False)
-        with pytest.warns(DeprecationWarning):
-            access = PyAccess.new(im, False)
-        assert access is not None
-
-        w, h = im.size
-        for x in range(0, w, 10):
-            for y in range(0, h, 10):
-                access[(x, y)] = color
-                assert color == caccess[(x, y)]
-
-        # Attempt to set the value on a read-only image
-        with pytest.warns(DeprecationWarning):
-            access = PyAccess.new(im, True)
-        assert access is not None
-
-        with pytest.raises(ValueError):
-            access[(0, 0)] = color
-
-    def test_set_vs_c(self) -> None:
-        rgb = hopper("RGB")
-        with pytest.warns(DeprecationWarning):
-            rgb.load()
-        self._test_set_access(rgb, (255, 128, 0))
-        self._test_set_access(hopper("RGBA"), (255, 192, 128, 0))
-        self._test_set_access(hopper("L"), 128)
-        self._test_set_access(hopper("LA"), (128, 128))
-        self._test_set_access(hopper("1"), 255)
-        self._test_set_access(hopper("P"), 128)
-        self._test_set_access(hopper("PA"), (128, 128))
-        self._test_set_access(hopper("F"), 1024.0)
-
-        for mode in ("I;16", "I;16L", "I;16B", "I;16N", "I"):
-            im = Image.new(mode, (10, 10), 40000)
-            self._test_set_access(im, 45000)
-
-    @pytest.mark.filterwarnings("ignore::DeprecationWarning")
-    def test_not_implemented(self) -> None:
-        assert PyAccess.new(hopper("BGR;15")) is None
-
-    # Ref https://github.com/python-pillow/Pillow/pull/2009
-    def test_reference_counting(self) -> None:
-        size = 10
-
-        for _ in range(10):
-            # Do not save references to the image, only to the access object
-            with pytest.warns(DeprecationWarning):
-                px = Image.new("L", (size, 1), 0).load()
-            for i in range(size):
-                # Pixels can contain garbage if image is released
-                assert px[i, 0] == 0
-
-    @pytest.mark.parametrize("mode", ("P", "PA"))
-    def test_p_putpixel_rgb_rgba(self, mode: str) -> None:
-        for color in ((255, 0, 0), (255, 0, 0, 127 if mode == "PA" else 255)):
-            im = Image.new(mode, (1, 1))
-            with pytest.warns(DeprecationWarning):
-                access = PyAccess.new(im, False)
-                assert access is not None
-
-                access.putpixel((0, 0), color)
-
-                if len(color) == 3:
-                    color += (255,)
-                assert im.convert("RGBA").getpixel((0, 0)) == color
-
-
-class TestImagePutPixelError(AccessTest):
+class TestImagePutPixelError:
     IMAGE_MODES1 = ["LA", "RGB", "RGBA", "BGR;15"]
     IMAGE_MODES2 = ["L", "I", "I;16"]
     INVALID_TYPES = ["foo", 1.0, None]
diff --git a/codecov.yml b/codecov.yml
index 1ea7974ebbe..8646576bb44 100644
--- a/codecov.yml
+++ b/codecov.yml
@@ -17,6 +17,5 @@ coverage:
 # Matches 'omit:' in .coveragerc
 ignore:
   - "Tests/32bit_segfault_check.py"
-  - "Tests/bench_cffi_access.py"
   - "Tests/check_*.py"
   - "Tests/createfontdatachunk.py"
diff --git a/docs/deprecations.rst b/docs/deprecations.rst
index b7c15ff637a..792fd1c7049 100644
--- a/docs/deprecations.rst
+++ b/docs/deprecations.rst
@@ -12,18 +12,6 @@ Deprecated features
 Below are features which are considered deprecated. Where appropriate,
 a :py:exc:`DeprecationWarning` is issued.
 
-PyAccess and Image.USE_CFFI_ACCESS
-~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
-
-.. deprecated:: 10.0.0
-
-Since Pillow's C API is now faster than PyAccess on PyPy,
-:py:mod:`~PIL.PyAccess` has been deprecated and will be removed in Pillow
-11.0.0 (2024-10-15). Pillow's C API will now be used by default on PyPy instead.
-
-``Image.USE_CFFI_ACCESS``, for switching from the C API to PyAccess, is
-similarly deprecated.
-
 ImageFile.raise_oserror
 ~~~~~~~~~~~~~~~~~~~~~~~
 
@@ -138,6 +126,18 @@ This class was only made as a helper to be used internally,
 so there is no replacement. If you need this functionality though,
 it is a very short class that can easily be recreated in your own code.
 
+PyAccess and Image.USE_CFFI_ACCESS
+~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
+
+.. deprecated:: 10.0.0
+.. versionremoved:: 11.0.0
+
+Since Pillow's C API is now faster than PyAccess on PyPy, ``PyAccess`` has been
+removed. Pillow's C API will now be used on PyPy instead.
+
+``Image.USE_CFFI_ACCESS``, for switching from the C API to PyAccess, was
+similarly removed.
+
 Tk/Tcl 8.4
 ~~~~~~~~~~
 
diff --git a/docs/reference/PyAccess.rst b/docs/reference/PyAccess.rst
deleted file mode 100644
index 04b2a47eed3..00000000000
--- a/docs/reference/PyAccess.rst
+++ /dev/null
@@ -1,47 +0,0 @@
-.. py:module:: PIL.PyAccess
-.. py:currentmodule:: PIL.PyAccess
-
-:py:mod:`~PIL.PyAccess` Module
-==============================
-
-The :py:mod:`~PIL.PyAccess` module provides a CFFI/Python implementation of the :ref:`PixelAccess`. This implementation is far faster on PyPy than the PixelAccess version.
-
-.. note:: Accessing individual pixels is fairly slow. If you are
-          looping over all of the pixels in an image, there is likely
-          a faster way using other parts of the Pillow API.
-
-          :mod:`~PIL.Image`, :mod:`~PIL.ImageChops` and :mod:`~PIL.ImageOps`
-          have methods for many standard operations. If you wish to perform
-          a custom mapping, check out :py:meth:`~PIL.Image.Image.point`.
-
-Example
--------
-
-The following script loads an image, accesses one pixel from it, then changes it. ::
-
-    from PIL import Image
-
-    with Image.open("hopper.jpg") as im:
-        px = im.load()
-    print(px[4, 4])
-    px[4, 4] = (0, 0, 0)
-    print(px[4, 4])
-
-Results in the following::
-
-    (23, 24, 68)
-    (0, 0, 0)
-
-Access using negative indexes is also possible. ::
-
-    px[-1, -1] = (0, 0, 0)
-    print(px[-1, -1])
-
-
-
-:py:class:`PyAccess` Class
---------------------------
-
-.. autoclass:: PIL.PyAccess.PyAccess()
-    :members:
-    :special-members: __getitem__, __setitem__
diff --git a/docs/reference/index.rst b/docs/reference/index.rst
index 82c75e373ad..effcd3c46a1 100644
--- a/docs/reference/index.rst
+++ b/docs/reference/index.rst
@@ -32,7 +32,6 @@ Reference
    JpegPresets
    PSDraw
    PixelAccess
-   PyAccess
    features
    ../PIL
    plugins
diff --git a/docs/releasenotes/11.0.0.rst b/docs/releasenotes/11.0.0.rst
index e04ae9fd694..bde791b1e4f 100644
--- a/docs/releasenotes/11.0.0.rst
+++ b/docs/releasenotes/11.0.0.rst
@@ -25,6 +25,15 @@ This class was only made as a helper to be used internally,
 so there is no replacement. If you need this functionality though,
 it is a very short class that can easily be recreated in your own code.
 
+PyAccess and Image.USE_CFFI_ACCESS
+~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
+
+Since Pillow's C API is now faster than PyAccess on PyPy, ``PyAccess`` has been
+removed. Pillow's C API will now be used on PyPy instead.
+
+``Image.USE_CFFI_ACCESS``, for switching from the C API to PyAccess, was
+similarly removed.
+
 Deprecations
 ============
 
diff --git a/src/PIL/GifImagePlugin.py b/src/PIL/GifImagePlugin.py
index 284128c773f..8018e25dcee 100644
--- a/src/PIL/GifImagePlugin.py
+++ b/src/PIL/GifImagePlugin.py
@@ -331,7 +331,6 @@ def _seek(self, frame: int, update_image: bool = True) -> None:
                     LOADING_STRATEGY != LoadingStrategy.RGB_AFTER_DIFFERENT_PALETTE_ONLY
                     or palette
                 ):
-                    self.pyaccess = None
                     if "transparency" in self.info:
                         self.im.putpalettealpha(self.info["transparency"], 0)
                         self.im = self.im.convert("RGBA", Image.Dither.FLOYDSTEINBERG)
diff --git a/src/PIL/IcoImagePlugin.py b/src/PIL/IcoImagePlugin.py
index 227fcf35cbb..086c87b1af2 100644
--- a/src/PIL/IcoImagePlugin.py
+++ b/src/PIL/IcoImagePlugin.py
@@ -329,7 +329,6 @@ def load(self):
         # if tile is PNG, it won't really be loaded yet
         im.load()
         self.im = im.im
-        self.pyaccess = None
         self._mode = im.mode
         if im.palette:
             self.palette = im.palette
diff --git a/src/PIL/Image.py b/src/PIL/Image.py
index d41c06523f4..dbdb3b132ce 100644
--- a/src/PIL/Image.py
+++ b/src/PIL/Image.py
@@ -125,14 +125,6 @@ class DecompressionBombError(Exception):
     raise
 
 
-USE_CFFI_ACCESS = False
-cffi: ModuleType | None
-try:
-    import cffi
-except ImportError:
-    cffi = None
-
-
 def isImageType(t: Any) -> TypeGuard[Image]:
     """
     Checks if an object is an image object.
@@ -229,7 +221,7 @@ class Quantize(IntEnum):
 # Registries
 
 if TYPE_CHECKING:
-    from . import ImageFile, PyAccess
+    from . import ImageFile
 ID: list[str] = []
 OPEN: dict[
     str,
@@ -549,7 +541,6 @@ def __init__(self):
         self.palette = None
         self.info = {}
         self.readonly = 0
-        self.pyaccess = None
         self._exif = None
 
     @property
@@ -631,7 +622,6 @@ def close(self) -> None:
     def _copy(self) -> None:
         self.load()
         self.im = self.im.copy()
-        self.pyaccess = None
         self.readonly = 0
 
     def _ensure_mutable(self) -> None:
@@ -882,7 +872,7 @@ def frombytes(
             msg = "cannot decode image data"
             raise ValueError(msg)
 
-    def load(self) -> core.PixelAccess | PyAccess.PyAccess | None:
+    def load(self) -> core.PixelAccess | None:
         """
         Allocates storage for the image and loads the pixel data.  In
         normal cases, you don't need to call this method, since the
@@ -895,7 +885,7 @@ def load(self) -> core.PixelAccess | PyAccess.PyAccess | None:
         operations. See :ref:`file-handling` for more information.
 
         :returns: An image access object.
-        :rtype: :py:class:`.PixelAccess` or :py:class:`.PyAccess`
+        :rtype: :py:class:`.PixelAccess`
         """
         if self.im is not None and self.palette and self.palette.dirty:
             # realize palette
@@ -915,14 +905,6 @@ def load(self) -> core.PixelAccess | PyAccess.PyAccess | None:
                 )
 
         if self.im is not None:
-            if cffi and USE_CFFI_ACCESS:
-                if self.pyaccess:
-                    return self.pyaccess
-                from . import PyAccess
-
-                self.pyaccess = PyAccess.new(self, self.readonly)
-                if self.pyaccess:
-                    return self.pyaccess
             return self.im.pixel_access(self.readonly)
         return None
 
@@ -1685,8 +1667,6 @@ def getpixel(
         """
 
         self.load()
-        if self.pyaccess:
-            return self.pyaccess.getpixel(xy)
         return self.im.getpixel(tuple(xy))
 
     def getprojection(self) -> tuple[list[int], list[int]]:
@@ -1983,7 +1963,6 @@ def putalpha(self, alpha: Image | int) -> None:
                         msg = "alpha channel could not be added"
                         raise ValueError(msg) from e  # sanity check
                     self.im = im
-                self.pyaccess = None
                 self._mode = self.im.mode
             except KeyError as e:
                 msg = "illegal image mode"
@@ -2101,9 +2080,6 @@ def putpixel(
             self._copy()
         self.load()
 
-        if self.pyaccess:
-            return self.pyaccess.putpixel(xy, value)
-
         if (
             self.mode in ("P", "PA")
             and isinstance(value, (list, tuple))
@@ -2768,7 +2744,6 @@ def round_aspect(number, key):
             self._mode = self.im.mode
 
         self.readonly = 0
-        self.pyaccess = None
 
     # FIXME: the different transform methods need further explanation
     # instead of bloating the method docs, add a separate chapter.
diff --git a/src/PIL/ImageOps.py b/src/PIL/ImageOps.py
index a84c0834561..55335872d3e 100644
--- a/src/PIL/ImageOps.py
+++ b/src/PIL/ImageOps.py
@@ -698,7 +698,6 @@ def exif_transpose(image: Image.Image, *, in_place: bool = False) -> Image.Image
         transposed_image = image.transpose(method)
         if in_place:
             image.im = transposed_image.im
-            image.pyaccess = None
             image._size = transposed_image._size
         exif_image = image if in_place else transposed_image
 
diff --git a/src/PIL/PngImagePlugin.py b/src/PIL/PngImagePlugin.py
index d2834929b8f..34ea77c5e01 100644
--- a/src/PIL/PngImagePlugin.py
+++ b/src/PIL/PngImagePlugin.py
@@ -851,8 +851,6 @@ def _seek(self, frame: int, rewind: bool = False) -> None:
                 self.png.rewind()
                 self.__prepare_idat = self.__rewind_idat
                 self.im = None
-                if self.pyaccess:
-                    self.pyaccess = None
                 self.info = self.png.im_info
                 self.tile = self.png.im_tile
                 self.fp = self._fp
@@ -1039,8 +1037,6 @@ def load_end(self) -> None:
                     mask = updated.convert("RGBA")
                 self._prev_im.paste(updated, self.dispose_extent, mask)
                 self.im = self._prev_im
-                if self.pyaccess:
-                    self.pyaccess = None
 
     def _getexif(self) -> dict[str, Any] | None:
         if "exif" not in self.info:
diff --git a/src/PIL/PyAccess.py b/src/PIL/PyAccess.py
deleted file mode 100644
index 3be1ccace0c..00000000000
--- a/src/PIL/PyAccess.py
+++ /dev/null
@@ -1,381 +0,0 @@
-#
-# The Python Imaging Library
-# Pillow fork
-#
-# Python implementation of the PixelAccess Object
-#
-# Copyright (c) 1997-2009 by Secret Labs AB.  All rights reserved.
-# Copyright (c) 1995-2009 by Fredrik Lundh.
-# Copyright (c) 2013 Eric Soroos
-#
-# See the README file for information on usage and redistribution
-#
-
-# Notes:
-#
-#  * Implements the pixel access object following Access.c
-#  * Taking only the tuple form, which is used from python.
-#    * Fill.c uses the integer form, but it's still going to use the old
-#      Access.c implementation.
-#
-from __future__ import annotations
-
-import logging
-import sys
-from typing import TYPE_CHECKING
-
-from ._deprecate import deprecate
-
-FFI: type
-try:
-    from cffi import FFI
-
-    defs = """
-    struct Pixel_RGBA {
-        unsigned char r,g,b,a;
-    };
-    struct Pixel_I16 {
-        unsigned char l,r;
-    };
-    """
-    ffi = FFI()
-    ffi.cdef(defs)
-except ImportError as ex:
-    # Allow error import for doc purposes, but error out when accessing
-    # anything in core.
-    from ._util import DeferredError
-
-    FFI = ffi = DeferredError.new(ex)
-
-logger = logging.getLogger(__name__)
-
-if TYPE_CHECKING:
-    from . import Image
-
-
-class PyAccess:
-    def __init__(self, img: Image.Image, readonly: bool = False) -> None:
-        deprecate("PyAccess", 11)
-        vals = dict(img.im.unsafe_ptrs)
-        self.readonly = readonly
-        self.image8 = ffi.cast("unsigned char **", vals["image8"])
-        self.image32 = ffi.cast("int **", vals["image32"])
-        self.image = ffi.cast("unsigned char **", vals["image"])
-        self.xsize, self.ysize = img.im.size
-        self._img = img
-
-        # Keep pointer to im object to prevent dereferencing.
-        self._im = img.im
-        if self._im.mode in ("P", "PA"):
-            self._palette = img.palette
-
-        # Debugging is polluting test traces, only useful here
-        # when hacking on PyAccess
-        # logger.debug("%s", vals)
-        self._post_init()
-
-    def _post_init(self) -> None:
-        pass
-
-    def __setitem__(
-        self,
-        xy: tuple[int, int] | list[int],
-        color: float | tuple[int, ...] | list[int],
-    ) -> None:
-        """
-        Modifies the pixel at x,y. The color is given as a single
-        numerical value for single band images, and a tuple for
-        multi-band images. In addition to this, RGB and RGBA tuples
-        are accepted for P and PA images.
-
-        :param xy: The pixel coordinate, given as (x, y). See
-           :ref:`coordinate-system`.
-        :param color: The pixel value.
-        """
-        if self.readonly:
-            msg = "Attempt to putpixel a read only image"
-            raise ValueError(msg)
-        (x, y) = xy
-        if x < 0:
-            x = self.xsize + x
-        if y < 0:
-            y = self.ysize + y
-        (x, y) = self.check_xy((x, y))
-
-        if (
-            self._im.mode in ("P", "PA")
-            and isinstance(color, (list, tuple))
-            and len(color) in [3, 4]
-        ):
-            # RGB or RGBA value for a P or PA image
-            if self._im.mode == "PA":
-                alpha = color[3] if len(color) == 4 else 255
-                color = color[:3]
-            palette_index = self._palette.getcolor(color, self._img)
-            color = (palette_index, alpha) if self._im.mode == "PA" else palette_index
-
-        return self.set_pixel(x, y, color)
-
-    def __getitem__(self, xy: tuple[int, int] | list[int]) -> float | tuple[int, ...]:
-        """
-        Returns the pixel at x,y. The pixel is returned as a single
-        value for single band images or a tuple for multiple band
-        images
-
-        :param xy: The pixel coordinate, given as (x, y). See
-          :ref:`coordinate-system`.
-        :returns: a pixel value for single band images, a tuple of
-          pixel values for multiband images.
-        """
-        (x, y) = xy
-        if x < 0:
-            x = self.xsize + x
-        if y < 0:
-            y = self.ysize + y
-        (x, y) = self.check_xy((x, y))
-        return self.get_pixel(x, y)
-
-    putpixel = __setitem__
-    getpixel = __getitem__
-
-    def check_xy(self, xy: tuple[int, int]) -> tuple[int, int]:
-        (x, y) = xy
-        if not (0 <= x < self.xsize and 0 <= y < self.ysize):
-            msg = "pixel location out of range"
-            raise ValueError(msg)
-        return xy
-
-    def get_pixel(self, x: int, y: int) -> float | tuple[int, ...]:
-        raise NotImplementedError()
-
-    def set_pixel(
-        self, x: int, y: int, color: float | tuple[int, ...] | list[int]
-    ) -> None:
-        raise NotImplementedError()
-
-
-class _PyAccess32_2(PyAccess):
-    """PA, LA, stored in first and last bytes of a 32 bit word"""
-
-    def _post_init(self, *args, **kwargs):
-        self.pixels = ffi.cast("struct Pixel_RGBA **", self.image32)
-
-    def get_pixel(self, x: int, y: int) -> tuple[int, int]:
-        pixel = self.pixels[y][x]
-        return pixel.r, pixel.a
-
-    def set_pixel(self, x, y, color):
-        pixel = self.pixels[y][x]
-        # tuple
-        pixel.r = min(color[0], 255)
-        pixel.a = min(color[1], 255)
-
-
-class _PyAccess32_3(PyAccess):
-    """RGB and friends, stored in the first three bytes of a 32 bit word"""
-
-    def _post_init(self, *args, **kwargs):
-        self.pixels = ffi.cast("struct Pixel_RGBA **", self.image32)
-
-    def get_pixel(self, x: int, y: int) -> tuple[int, int, int]:
-        pixel = self.pixels[y][x]
-        return pixel.r, pixel.g, pixel.b
-
-    def set_pixel(self, x, y, color):
-        pixel = self.pixels[y][x]
-        # tuple
-        pixel.r = min(color[0], 255)
-        pixel.g = min(color[1], 255)
-        pixel.b = min(color[2], 255)
-        pixel.a = 255
-
-
-class _PyAccess32_4(PyAccess):
-    """RGBA etc, all 4 bytes of a 32 bit word"""
-
-    def _post_init(self, *args, **kwargs):
-        self.pixels = ffi.cast("struct Pixel_RGBA **", self.image32)
-
-    def get_pixel(self, x: int, y: int) -> tuple[int, int, int, int]:
-        pixel = self.pixels[y][x]
-        return pixel.r, pixel.g, pixel.b, pixel.a
-
-    def set_pixel(self, x, y, color):
-        pixel = self.pixels[y][x]
-        # tuple
-        pixel.r = min(color[0], 255)
-        pixel.g = min(color[1], 255)
-        pixel.b = min(color[2], 255)
-        pixel.a = min(color[3], 255)
-
-
-class _PyAccess8(PyAccess):
-    """1, L, P, 8 bit images stored as uint8"""
-
-    def _post_init(self, *args, **kwargs):
-        self.pixels = self.image8
-
-    def get_pixel(self, x: int, y: int) -> int:
-        return self.pixels[y][x]
-
-    def set_pixel(self, x, y, color):
-        try:
-            # integer
-            self.pixels[y][x] = min(color, 255)
-        except TypeError:
-            # tuple
-            self.pixels[y][x] = min(color[0], 255)
-
-
-class _PyAccessI16_N(PyAccess):
-    """I;16 access, native bitendian without conversion"""
-
-    def _post_init(self, *args, **kwargs):
-        self.pixels = ffi.cast("unsigned short **", self.image)
-
-    def get_pixel(self, x: int, y: int) -> int:
-        return self.pixels[y][x]
-
-    def set_pixel(self, x, y, color):
-        try:
-            # integer
-            self.pixels[y][x] = min(color, 65535)
-        except TypeError:
-            # tuple
-            self.pixels[y][x] = min(color[0], 65535)
-
-
-class _PyAccessI16_L(PyAccess):
-    """I;16L access, with conversion"""
-
-    def _post_init(self, *args, **kwargs):
-        self.pixels = ffi.cast("struct Pixel_I16 **", self.image)
-
-    def get_pixel(self, x: int, y: int) -> int:
-        pixel = self.pixels[y][x]
-        return pixel.l + pixel.r * 256
-
-    def set_pixel(self, x, y, color):
-        pixel = self.pixels[y][x]
-        try:
-            color = min(color, 65535)
-        except TypeError:
-            color = min(color[0], 65535)
-
-        pixel.l = color & 0xFF
-        pixel.r = color >> 8
-
-
-class _PyAccessI16_B(PyAccess):
-    """I;16B access, with conversion"""
-
-    def _post_init(self, *args, **kwargs):
-        self.pixels = ffi.cast("struct Pixel_I16 **", self.image)
-
-    def get_pixel(self, x: int, y: int) -> int:
-        pixel = self.pixels[y][x]
-        return pixel.l * 256 + pixel.r
-
-    def set_pixel(self, x, y, color):
-        pixel = self.pixels[y][x]
-        try:
-            color = min(color, 65535)
-        except Exception:
-            color = min(color[0], 65535)
-
-        pixel.l = color >> 8
-        pixel.r = color & 0xFF
-
-
-class _PyAccessI32_N(PyAccess):
-    """Signed Int32 access, native endian"""
-
-    def _post_init(self, *args, **kwargs):
-        self.pixels = self.image32
-
-    def get_pixel(self, x: int, y: int) -> int:
-        return self.pixels[y][x]
-
-    def set_pixel(self, x, y, color):
-        self.pixels[y][x] = color
-
-
-class _PyAccessI32_Swap(PyAccess):
-    """I;32L/B access, with byteswapping conversion"""
-
-    def _post_init(self, *args, **kwargs):
-        self.pixels = self.image32
-
-    def reverse(self, i):
-        orig = ffi.new("int *", i)
-        chars = ffi.cast("unsigned char *", orig)
-        chars[0], chars[1], chars[2], chars[3] = chars[3], chars[2], chars[1], chars[0]
-        return ffi.cast("int *", chars)[0]
-
-    def get_pixel(self, x: int, y: int) -> int:
-        return self.reverse(self.pixels[y][x])
-
-    def set_pixel(self, x, y, color):
-        self.pixels[y][x] = self.reverse(color)
-
-
-class _PyAccessF(PyAccess):
-    """32 bit float access"""
-
-    def _post_init(self, *args, **kwargs):
-        self.pixels = ffi.cast("float **", self.image32)
-
-    def get_pixel(self, x: int, y: int) -> float:
-        return self.pixels[y][x]
-
-    def set_pixel(self, x, y, color):
-        try:
-            # not a tuple
-            self.pixels[y][x] = color
-        except TypeError:
-            # tuple
-            self.pixels[y][x] = color[0]
-
-
-mode_map = {
-    "1": _PyAccess8,
-    "L": _PyAccess8,
-    "P": _PyAccess8,
-    "I;16N": _PyAccessI16_N,
-    "LA": _PyAccess32_2,
-    "La": _PyAccess32_2,
-    "PA": _PyAccess32_2,
-    "RGB": _PyAccess32_3,
-    "LAB": _PyAccess32_3,
-    "HSV": _PyAccess32_3,
-    "YCbCr": _PyAccess32_3,
-    "RGBA": _PyAccess32_4,
-    "RGBa": _PyAccess32_4,
-    "RGBX": _PyAccess32_4,
-    "CMYK": _PyAccess32_4,
-    "F": _PyAccessF,
-    "I": _PyAccessI32_N,
-}
-
-if sys.byteorder == "little":
-    mode_map["I;16"] = _PyAccessI16_N
-    mode_map["I;16L"] = _PyAccessI16_N
-    mode_map["I;16B"] = _PyAccessI16_B
-
-    mode_map["I;32L"] = _PyAccessI32_N
-    mode_map["I;32B"] = _PyAccessI32_Swap
-else:
-    mode_map["I;16"] = _PyAccessI16_L
-    mode_map["I;16L"] = _PyAccessI16_L
-    mode_map["I;16B"] = _PyAccessI16_N
-
-    mode_map["I;32L"] = _PyAccessI32_Swap
-    mode_map["I;32B"] = _PyAccessI32_N
-
-
-def new(img: Image.Image, readonly: bool = False) -> PyAccess | None:
-    access_type = mode_map.get(img.mode, None)
-    if not access_type:
-        logger.debug("PyAccess Not Implemented: %s", img.mode)
-        return None
-    return access_type(img, readonly)
diff --git a/tox.ini b/tox.ini
index 85a2020d6d0..d225a310697 100644
--- a/tox.ini
+++ b/tox.ini
@@ -7,7 +7,6 @@ env_list =
 
 [testenv]
 deps =
-    cffi
     numpy
 extras =
     tests
@@ -39,7 +38,6 @@ deps =
     ipython
     numpy
     packaging
-    types-cffi
     types-defusedxml
     types-olefile
 extras =

From 5e163c0fed44b11ca85b3f74f0d998fa6cd510a7 Mon Sep 17 00:00:00 2001
From: Andrew Murray <radarhere@users.noreply.github.com>
Date: Mon, 1 Jul 2024 20:21:21 +1000
Subject: [PATCH 0769/1178] Updated deprecation timeline

---
 src/PIL/_deprecate.py | 2 --
 1 file changed, 2 deletions(-)

diff --git a/src/PIL/_deprecate.py b/src/PIL/_deprecate.py
index 33a0e07b3f4..83952b397ff 100644
--- a/src/PIL/_deprecate.py
+++ b/src/PIL/_deprecate.py
@@ -45,8 +45,6 @@ def deprecate(
     elif when <= int(__version__.split(".")[0]):
         msg = f"{deprecated} {is_} deprecated and should be removed."
         raise RuntimeError(msg)
-    elif when == 11:
-        removed = "Pillow 11 (2024-10-15)"
     elif when == 12:
         removed = "Pillow 12 (2025-10-15)"
     else:

From 9bc1365ea0de8b87f706dd5e0c4fd18f169432ce Mon Sep 17 00:00:00 2001
From: Andrew Murray <radarhere@users.noreply.github.com>
Date: Mon, 1 Jul 2024 21:41:08 +1000
Subject: [PATCH 0770/1178] Removed reference

---
 docs/releasenotes/10.0.0.rst | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/docs/releasenotes/10.0.0.rst b/docs/releasenotes/10.0.0.rst
index adada6e0151..2ea973c5c76 100644
--- a/docs/releasenotes/10.0.0.rst
+++ b/docs/releasenotes/10.0.0.rst
@@ -158,7 +158,7 @@ PyAccess and Image.USE_CFFI_ACCESS
 ^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
 
 Since Pillow's C API is now faster than PyAccess on PyPy,
-:py:mod:`~PIL.PyAccess` has been deprecated and will be removed in Pillow
+:py:mod:`!PyAccess` has been deprecated and will be removed in Pillow
 11.0.0 (2024-10-15). Pillow's C API will now be used by default on PyPy instead.
 
 ``Image.USE_CFFI_ACCESS``, for switching from the C API to PyAccess, is

From d3f343bb9b658ff97cbac826f9d1d4763a352e85 Mon Sep 17 00:00:00 2001
From: Andrew Murray <radarhere@users.noreply.github.com>
Date: Mon, 1 Jul 2024 19:36:15 +1000
Subject: [PATCH 0771/1178] Skip truncated mask if LOAD_TRUNCATED_IMAGES is
 enabled

---
 Tests/test_file_ico.py    | 28 +++++++++++++++++++++++-
 src/PIL/IcoImagePlugin.py | 45 +++++++++++++++++++++++++--------------
 2 files changed, 56 insertions(+), 17 deletions(-)

diff --git a/Tests/test_file_ico.py b/Tests/test_file_ico.py
index fa8c11d5a95..37770498a0a 100644
--- a/Tests/test_file_ico.py
+++ b/Tests/test_file_ico.py
@@ -6,7 +6,7 @@
 
 import pytest
 
-from PIL import IcoImagePlugin, Image, ImageDraw
+from PIL import IcoImagePlugin, Image, ImageDraw, ImageFile
 
 from .helper import assert_image_equal, assert_image_equal_tofile, hopper
 
@@ -241,3 +241,29 @@ def test_draw_reloaded(tmp_path: Path) -> None:
 
     with Image.open(outfile) as im:
         assert_image_equal_tofile(im, "Tests/images/hopper_draw.ico")
+
+
+def test_truncated_mask() -> None:
+    # 1 bpp
+    with open("Tests/images/hopper_mask.ico", "rb") as fp:
+        data = fp.read()
+
+    ImageFile.LOAD_TRUNCATED_IMAGES = True
+    data = data[:-3]
+
+    try:
+        with Image.open(io.BytesIO(data)) as im:
+            with Image.open("Tests/images/hopper_mask.png") as expected:
+                assert im.mode == "1"
+
+        # 32 bpp
+        output = io.BytesIO()
+        expected = hopper("RGBA")
+        expected.save(output, "ico", bitmap_format="bmp")
+
+        data = output.getvalue()[:-1]
+
+        with Image.open(io.BytesIO(data)) as im:
+            assert im.mode == "RGB"
+    finally:
+        ImageFile.LOAD_TRUNCATED_IMAGES = False
diff --git a/src/PIL/IcoImagePlugin.py b/src/PIL/IcoImagePlugin.py
index 086c87b1af2..f331caad7ba 100644
--- a/src/PIL/IcoImagePlugin.py
+++ b/src/PIL/IcoImagePlugin.py
@@ -235,13 +235,19 @@ def frame(self, idx: int) -> Image.Image:
                 alpha_bytes = self.buf.read(im.size[0] * im.size[1] * 4)[3::4]
 
                 # convert to an 8bpp grayscale image
-                mask = Image.frombuffer(
-                    "L",  # 8bpp
-                    im.size,  # (w, h)
-                    alpha_bytes,  # source chars
-                    "raw",  # raw decoder
-                    ("L", 0, -1),  # 8bpp inverted, unpadded, reversed
-                )
+                try:
+                    mask = Image.frombuffer(
+                        "L",  # 8bpp
+                        im.size,  # (w, h)
+                        alpha_bytes,  # source chars
+                        "raw",  # raw decoder
+                        ("L", 0, -1),  # 8bpp inverted, unpadded, reversed
+                    )
+                except ValueError:
+                    if ImageFile.LOAD_TRUNCATED_IMAGES:
+                        mask = None
+                    else:
+                        raise
             else:
                 # get AND image from end of bitmap
                 w = im.size[0]
@@ -259,19 +265,26 @@ def frame(self, idx: int) -> Image.Image:
                 mask_data = self.buf.read(total_bytes)
 
                 # convert raw data to image
-                mask = Image.frombuffer(
-                    "1",  # 1 bpp
-                    im.size,  # (w, h)
-                    mask_data,  # source chars
-                    "raw",  # raw decoder
-                    ("1;I", int(w / 8), -1),  # 1bpp inverted, padded, reversed
-                )
+                try:
+                    mask = Image.frombuffer(
+                        "1",  # 1 bpp
+                        im.size,  # (w, h)
+                        mask_data,  # source chars
+                        "raw",  # raw decoder
+                        ("1;I", int(w / 8), -1),  # 1bpp inverted, padded, reversed
+                    )
+                except ValueError:
+                    if ImageFile.LOAD_TRUNCATED_IMAGES:
+                        mask = None
+                    else:
+                        raise
 
                 # now we have two images, im is XOR image and mask is AND image
 
             # apply mask image as alpha channel
-            im = im.convert("RGBA")
-            im.putalpha(mask)
+            if mask:
+                im = im.convert("RGBA")
+                im.putalpha(mask)
 
         return im
 

From 381c604b07a23fa173160281a6e295fd5a22fd0e Mon Sep 17 00:00:00 2001
From: Andrew Murray <radarhere@users.noreply.github.com>
Date: Wed, 12 Jun 2024 23:35:24 +1000
Subject: [PATCH 0772/1178] Removed Debian 11

---
 .github/workflows/test-docker.yml      | 1 -
 docs/installation/platform-support.rst | 2 --
 2 files changed, 3 deletions(-)

diff --git a/.github/workflows/test-docker.yml b/.github/workflows/test-docker.yml
index 6afed74db31..d18ab97293f 100644
--- a/.github/workflows/test-docker.yml
+++ b/.github/workflows/test-docker.yml
@@ -44,7 +44,6 @@ jobs:
           amazon-2023-amd64,
           arch,
           centos-stream-9-amd64,
-          debian-11-bullseye-amd64,
           debian-12-bookworm-x86,
           debian-12-bookworm-amd64,
           fedora-39-amd64,
diff --git a/docs/installation/platform-support.rst b/docs/installation/platform-support.rst
index ed25d33a6f3..cde00c76d80 100644
--- a/docs/installation/platform-support.rst
+++ b/docs/installation/platform-support.rst
@@ -27,8 +27,6 @@ These platforms are built and tested for every change.
 +----------------------------------+----------------------------+---------------------+
 | CentOS Stream 9                  | 3.9                        | x86-64              |
 +----------------------------------+----------------------------+---------------------+
-| Debian 11 Bullseye               | 3.9                        | x86-64              |
-+----------------------------------+----------------------------+---------------------+
 | Debian 12 Bookworm               | 3.11                       | x86, x86-64         |
 +----------------------------------+----------------------------+---------------------+
 | Fedora 39                        | 3.12                       | x86-64              |

From 31e64a0da8f263c5d4a9d9f047cb06a7b30c14c4 Mon Sep 17 00:00:00 2001
From: Andrew Murray <radarhere@users.noreply.github.com>
Date: Mon, 1 Jul 2024 14:23:36 +1000
Subject: [PATCH 0773/1178] Updated CVE URL

---
 docs/conf.py | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/docs/conf.py b/docs/conf.py
index f12b30e65fb..41f9c0e3821 100644
--- a/docs/conf.py
+++ b/docs/conf.py
@@ -338,7 +338,7 @@
 # https://www.sphinx-doc.org/en/master/usage/extensions/extlinks.html
 _repo = "https://github.com/python-pillow/Pillow/"
 extlinks = {
-    "cve": ("https://cve.mitre.org/cgi-bin/cvename.cgi?name=CVE-%s", "CVE-%s"),
+    "cve": ("https://www.cve.org/CVERecord?id=CVE-%s", "CVE-%s"),
     "cwe": ("https://cwe.mitre.org/data/definitions/%s.html", "CWE-%s"),
     "issue": (_repo + "issues/%s", "#%s"),
     "pr": (_repo + "pull/%s", "#%s"),

From d6d0a4d98106790b2e9df66073ffff7c2bf18f6d Mon Sep 17 00:00:00 2001
From: "pre-commit-ci[bot]"
 <66853113+pre-commit-ci[bot]@users.noreply.github.com>
Date: Mon, 1 Jul 2024 17:32:51 +0000
Subject: [PATCH 0774/1178] [pre-commit.ci] pre-commit autoupdate
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit

updates:
- [github.com/astral-sh/ruff-pre-commit: v0.4.7 → v0.5.0](https://github.com/astral-sh/ruff-pre-commit/compare/v0.4.7...v0.5.0)
- [github.com/PyCQA/bandit: 1.7.8 → 1.7.9](https://github.com/PyCQA/bandit/compare/1.7.8...1.7.9)
- [github.com/pre-commit/mirrors-clang-format: v18.1.5 → v18.1.8](https://github.com/pre-commit/mirrors-clang-format/compare/v18.1.5...v18.1.8)
- [github.com/python-jsonschema/check-jsonschema: 0.28.4 → 0.28.6](https://github.com/python-jsonschema/check-jsonschema/compare/0.28.4...0.28.6)
- [github.com/tox-dev/pyproject-fmt: 1.8.0 → 2.1.3](https://github.com/tox-dev/pyproject-fmt/compare/1.8.0...2.1.3)
---
 .pre-commit-config.yaml | 10 +++++-----
 1 file changed, 5 insertions(+), 5 deletions(-)

diff --git a/.pre-commit-config.yaml b/.pre-commit-config.yaml
index 6a76e8c00cb..659409de4e0 100644
--- a/.pre-commit-config.yaml
+++ b/.pre-commit-config.yaml
@@ -1,6 +1,6 @@
 repos:
   - repo: https://github.com/astral-sh/ruff-pre-commit
-    rev: v0.4.7
+    rev: v0.5.0
     hooks:
       - id: ruff
         args: [--exit-non-zero-on-fix]
@@ -11,7 +11,7 @@ repos:
       - id: black
 
   - repo: https://github.com/PyCQA/bandit
-    rev: 1.7.8
+    rev: 1.7.9
     hooks:
     - id: bandit
       args: [--severity-level=high]
@@ -24,7 +24,7 @@ repos:
         exclude: (Makefile$|\.bat$|\.cmake$|\.eps$|\.fits$|\.gd$|\.opt$)
 
   - repo: https://github.com/pre-commit/mirrors-clang-format
-    rev: v18.1.5
+    rev: v18.1.8
     hooks:
       - id: clang-format
         types: [c]
@@ -50,7 +50,7 @@ repos:
         exclude: ^.github/.*TEMPLATE|^Tests/(fonts|images)/
 
   - repo: https://github.com/python-jsonschema/check-jsonschema
-    rev: 0.28.4
+    rev: 0.28.6
     hooks:
       - id: check-github-workflows
       - id: check-readthedocs
@@ -62,7 +62,7 @@ repos:
       - id: sphinx-lint
 
   - repo: https://github.com/tox-dev/pyproject-fmt
-    rev: 1.8.0
+    rev: 2.1.3
     hooks:
       - id: pyproject-fmt
 

From b4ee9673729df7a996fc04fe9d3487f99bf32ef5 Mon Sep 17 00:00:00 2001
From: =?UTF-8?q?Cl=C3=A9ment=20Robert?= <cr52@protonmail.com>
Date: Mon, 1 Jul 2024 19:16:13 +0200
Subject: [PATCH 0775/1178] BUG: fix an incompatibility with numpy 1.20

---
 src/PIL/_typing.py | 4 ++--
 1 file changed, 2 insertions(+), 2 deletions(-)

diff --git a/src/PIL/_typing.py b/src/PIL/_typing.py
index 09ece18fa60..435c67f048b 100644
--- a/src/PIL/_typing.py
+++ b/src/PIL/_typing.py
@@ -7,8 +7,8 @@
 try:
     import numpy.typing as npt
 
-    NumpyArray = npt.NDArray[Any]
-except ImportError:
+    NumpyArray = npt.NDArray[Any]  # requires numpy>=1.21
+except (ImportError, AttributeError):
     pass
 
 if sys.version_info >= (3, 10):

From c359bd290b4ad045eb0ff3e5a2e22c6a93fb0bd5 Mon Sep 17 00:00:00 2001
From: "pre-commit-ci[bot]"
 <66853113+pre-commit-ci[bot]@users.noreply.github.com>
Date: Mon, 1 Jul 2024 17:33:15 +0000
Subject: [PATCH 0776/1178] [pre-commit.ci] auto fixes from pre-commit.com
 hooks

for more information, see https://pre-commit.ci
---
 pyproject.toml | 107 ++++++++++++++++++++++++++-----------------------
 1 file changed, 57 insertions(+), 50 deletions(-)

diff --git a/pyproject.toml b/pyproject.toml
index 20e87ad327d..6f47f360b37 100644
--- a/pyproject.toml
+++ b/pyproject.toml
@@ -14,8 +14,10 @@ readme = "README.md"
 keywords = [
   "Imaging",
 ]
-license = {text = "HPND"}
-authors = [{name = "Jeffrey A. Clark", email = "aclark@aclark.net"}]
+license = { text = "HPND" }
+authors = [
+  { name = "Jeffrey A. Clark", email = "aclark@aclark.net" },
+]
 requires-python = ">=3.8"
 classifiers = [
   "Development Status :: 6 - Mature",
@@ -38,8 +40,7 @@ classifiers = [
 dynamic = [
   "version",
 ]
-[project.optional-dependencies]
-docs = [
+optional-dependencies.docs = [
   "furo",
   "olefile",
   "sphinx>=7.3",
@@ -47,13 +48,13 @@ docs = [
   "sphinx-inline-tabs",
   "sphinxext-opengraph",
 ]
-fpx = [
+optional-dependencies.fpx = [
   "olefile",
 ]
-mic = [
+optional-dependencies.mic = [
   "olefile",
 ]
-tests = [
+optional-dependencies.tests = [
   "check-manifest",
   "coverage",
   "defusedxml",
@@ -65,28 +66,29 @@ tests = [
   "pytest-cov",
   "pytest-timeout",
 ]
-typing = [
-  'typing-extensions; python_version < "3.10"',
+optional-dependencies.typing = [
+  "typing-extensions; python_version<'3.10'",
 ]
-xmp = [
+optional-dependencies.xmp = [
   "defusedxml",
 ]
-[project.urls]
-Changelog = "https://github.com/python-pillow/Pillow/blob/main/CHANGES.rst"
-Documentation = "https://pillow.readthedocs.io"
-Funding = "https://tidelift.com/subscription/pkg/pypi-pillow?utm_source=pypi-pillow&utm_medium=pypi"
-Homepage = "https://python-pillow.org"
-Mastodon = "https://fosstodon.org/@pillow"
-"Release notes" = "https://pillow.readthedocs.io/en/stable/releasenotes/index.html"
-Source = "https://github.com/python-pillow/Pillow"
+urls.Changelog = "https://github.com/python-pillow/Pillow/blob/main/CHANGES.rst"
+urls.Documentation = "https://pillow.readthedocs.io"
+urls.Funding = "https://tidelift.com/subscription/pkg/pypi-pillow?utm_source=pypi-pillow&utm_medium=pypi"
+urls.Homepage = "https://python-pillow.org"
+urls.Mastodon = "https://fosstodon.org/@pillow"
+urls."Release notes" = "https://pillow.readthedocs.io/en/stable/releasenotes/index.html"
+urls.Source = "https://github.com/python-pillow/Pillow"
 
 [tool.setuptools]
-packages = ["PIL"]
+packages = [
+  "PIL",
+]
 include-package-data = true
-package-dir = {"" = "src"}
+package-dir = { "" = "src" }
 
 [tool.setuptools.dynamic]
-version = {attr = "PIL.__version__"}
+version = { attr = "PIL.__version__" }
 
 [tool.cibuildwheel]
 before-all = ".github/workflows/wheels-dependencies.sh"
@@ -98,42 +100,47 @@ test-extras = "tests"
 [tool.ruff]
 fix = true
 
-[tool.ruff.lint]
-select = [
-  "C4", # flake8-comprehensions
-  "E", # pycodestyle errors
-  "EM", # flake8-errmsg
-  "F", # pyflakes errors
-  "I", # isort
-  "ISC", # flake8-implicit-str-concat
-  "LOG", # flake8-logging
-  "PGH", # pygrep-hooks
-  "PYI", # flake8-pyi
+lint.select = [
+  "C4",     # flake8-comprehensions
+  "E",      # pycodestyle errors
+  "EM",     # flake8-errmsg
+  "F",      # pyflakes errors
+  "I",      # isort
+  "ISC",    # flake8-implicit-str-concat
+  "LOG",    # flake8-logging
+  "PGH",    # pygrep-hooks
+  "PYI",    # flake8-pyi
   "RUF100", # unused noqa (yesqa)
-  "UP", # pyupgrade
-  "W", # pycodestyle warnings
-  "YTT", # flake8-2020
-]
-ignore = [
-  "E203", # Whitespace before ':'
-  "E221", # Multiple spaces before operator
-  "E226", # Missing whitespace around arithmetic operator
-  "E241", # Multiple spaces after ','
+  "UP",     # pyupgrade
+  "W",      # pycodestyle warnings
+  "YTT",    # flake8-2020
+]
+lint.ignore = [
+  "E203",   # Whitespace before ':'
+  "E221",   # Multiple spaces before operator
+  "E226",   # Missing whitespace around arithmetic operator
+  "E241",   # Multiple spaces after ','
   "PYI026", # flake8-pyi: typing.TypeAlias added in Python 3.10
   "PYI034", # flake8-pyi: typing.Self added in Python 3.11
 ]
-
-[tool.ruff.lint.per-file-ignores]
-"Tests/oss-fuzz/fuzz_font.py" = ["I002"]
-"Tests/oss-fuzz/fuzz_pillow.py" = ["I002"]
-
-[tool.ruff.lint.isort]
-known-first-party = ["PIL"]
-required-imports = ["from __future__ import annotations"]
+lint.per-file-ignores."Tests/oss-fuzz/fuzz_font.py" = [
+  "I002",
+]
+lint.per-file-ignores."Tests/oss-fuzz/fuzz_pillow.py" = [
+  "I002",
+]
+lint.isort.known-first-party = [
+  "PIL",
+]
+lint.isort.required-imports = [
+  "from __future__ import annotations",
+]
 
 [tool.pytest.ini_options]
 addopts = "-ra --color=yes"
-testpaths = ["Tests"]
+testpaths = [
+  "Tests",
+]
 
 [tool.mypy]
 python_version = "3.8"

From 8b8fc18998bb416631acc81f54e95e8c8fc50f61 Mon Sep 17 00:00:00 2001
From: Andrew Murray <radarhere@users.noreply.github.com>
Date: Tue, 2 Jul 2024 19:05:59 +1000
Subject: [PATCH 0777/1178] Do not import numpy.typing unless TYPE_CHECKING

---
 src/PIL/_typing.py | 13 +++++++------
 1 file changed, 7 insertions(+), 6 deletions(-)

diff --git a/src/PIL/_typing.py b/src/PIL/_typing.py
index 435c67f048b..db1e80e2fc1 100644
--- a/src/PIL/_typing.py
+++ b/src/PIL/_typing.py
@@ -2,14 +2,15 @@
 
 import os
 import sys
-from typing import Any, Protocol, Sequence, TypeVar, Union
+from typing import TYPE_CHECKING, Any, Protocol, Sequence, TypeVar, Union
 
-try:
-    import numpy.typing as npt
+if TYPE_CHECKING:
+    try:
+        import numpy.typing as npt
 
-    NumpyArray = npt.NDArray[Any]  # requires numpy>=1.21
-except (ImportError, AttributeError):
-    pass
+        NumpyArray = npt.NDArray[Any]  # requires numpy>=1.21
+    except (ImportError, AttributeError):
+        pass
 
 if sys.version_info >= (3, 10):
     from typing import TypeGuard

From 267c0b37b1c6d24e5e189349f51dc2cfbecf151d Mon Sep 17 00:00:00 2001
From: Andrew Murray <radarhere@users.noreply.github.com>
Date: Tue, 2 Jul 2024 20:10:47 +1000
Subject: [PATCH 0778/1178] Added type hints

---
 Tests/test_color_lut.py      |  2 ++
 Tests/test_file_pcx.py       |  8 ++++++++
 Tests/test_image.py          |  1 +
 Tests/test_image_access.py   |  9 +++++++--
 Tests/test_image_convert.py  |  2 ++
 Tests/test_image_load.py     |  5 +++--
 Tests/test_image_paste.py    |  3 +++
 Tests/test_image_quantize.py |  4 ++++
 Tests/test_image_resample.py | 14 +++++++++++++-
 Tests/test_imageops.py       |  9 +++++++--
 Tests/test_imagetk.py        |  5 +++++
 Tests/test_mode_i16.py       |  2 ++
 Tests/test_numpy.py          |  2 ++
 src/PIL/FpxImagePlugin.py    |  8 ++++----
 src/PIL/Image.py             | 26 +++++++++++++++++---------
 src/PIL/ImageOps.py          |  4 +++-
 src/PIL/ImageTk.py           | 32 +++++++++++++++++++++++---------
 src/PIL/MicImagePlugin.py    |  2 +-
 18 files changed, 107 insertions(+), 31 deletions(-)

diff --git a/Tests/test_color_lut.py b/Tests/test_color_lut.py
index 00c8995b08d..0d9c0b41974 100644
--- a/Tests/test_color_lut.py
+++ b/Tests/test_color_lut.py
@@ -321,6 +321,7 @@ def test_overflow(self) -> None:
                                   -1,  2,  2,   2,  2,  2,
                               ])).load()
         # fmt: on
+        assert transformed is not None
         assert transformed[0, 0] == (0, 0, 255)
         assert transformed[50, 50] == (0, 0, 255)
         assert transformed[255, 0] == (0, 255, 255)
@@ -341,6 +342,7 @@ def test_overflow(self) -> None:
                                   -3,  5,  5,   5,  5,  5,
                               ])).load()
         # fmt: on
+        assert transformed is not None
         assert transformed[0, 0] == (0, 0, 255)
         assert transformed[50, 50] == (0, 0, 255)
         assert transformed[255, 0] == (0, 255, 255)
diff --git a/Tests/test_file_pcx.py b/Tests/test_file_pcx.py
index ab9f9663e1b..b3f38c3e5fd 100644
--- a/Tests/test_file_pcx.py
+++ b/Tests/test_file_pcx.py
@@ -76,6 +76,7 @@ def test_pil184() -> None:
 def test_1px_width(tmp_path: Path) -> None:
     im = Image.new("L", (1, 256))
     px = im.load()
+    assert px is not None
     for y in range(256):
         px[0, y] = y
     _roundtrip(tmp_path, im)
@@ -84,6 +85,7 @@ def test_1px_width(tmp_path: Path) -> None:
 def test_large_count(tmp_path: Path) -> None:
     im = Image.new("L", (256, 1))
     px = im.load()
+    assert px is not None
     for x in range(256):
         px[x, 0] = x // 67 * 67
     _roundtrip(tmp_path, im)
@@ -101,6 +103,7 @@ def _test_buffer_overflow(tmp_path: Path, im: Image.Image, size: int = 1024) ->
 def test_break_in_count_overflow(tmp_path: Path) -> None:
     im = Image.new("L", (256, 5))
     px = im.load()
+    assert px is not None
     for y in range(4):
         for x in range(256):
             px[x, y] = x % 128
@@ -110,6 +113,7 @@ def test_break_in_count_overflow(tmp_path: Path) -> None:
 def test_break_one_in_loop(tmp_path: Path) -> None:
     im = Image.new("L", (256, 5))
     px = im.load()
+    assert px is not None
     for y in range(5):
         for x in range(256):
             px[x, y] = x % 128
@@ -119,6 +123,7 @@ def test_break_one_in_loop(tmp_path: Path) -> None:
 def test_break_many_in_loop(tmp_path: Path) -> None:
     im = Image.new("L", (256, 5))
     px = im.load()
+    assert px is not None
     for y in range(4):
         for x in range(256):
             px[x, y] = x % 128
@@ -130,6 +135,7 @@ def test_break_many_in_loop(tmp_path: Path) -> None:
 def test_break_one_at_end(tmp_path: Path) -> None:
     im = Image.new("L", (256, 5))
     px = im.load()
+    assert px is not None
     for y in range(5):
         for x in range(256):
             px[x, y] = x % 128
@@ -140,6 +146,7 @@ def test_break_one_at_end(tmp_path: Path) -> None:
 def test_break_many_at_end(tmp_path: Path) -> None:
     im = Image.new("L", (256, 5))
     px = im.load()
+    assert px is not None
     for y in range(5):
         for x in range(256):
             px[x, y] = x % 128
@@ -152,6 +159,7 @@ def test_break_many_at_end(tmp_path: Path) -> None:
 def test_break_padding(tmp_path: Path) -> None:
     im = Image.new("L", (257, 5))
     px = im.load()
+    assert px is not None
     for y in range(5):
         for x in range(257):
             px[x, y] = x % 128
diff --git a/Tests/test_image.py b/Tests/test_image.py
index 93f9b9833ce..07161fcfabc 100644
--- a/Tests/test_image.py
+++ b/Tests/test_image.py
@@ -575,6 +575,7 @@ def test_one_item_tuple(self) -> None:
         for mode in ("I", "F", "L"):
             im = Image.new(mode, (100, 100), (5,))
             px = im.load()
+            assert px is not None
             assert px[0, 0] == 5
 
     def test_linear_gradient_wrong_mode(self) -> None:
diff --git a/Tests/test_image_access.py b/Tests/test_image_access.py
index 52ffef5e88f..c860771dc37 100644
--- a/Tests/test_image_access.py
+++ b/Tests/test_image_access.py
@@ -47,6 +47,8 @@ def test_sanity(self) -> None:
         pix1 = im1.load()
         pix2 = im2.load()
 
+        assert pix1 is not None
+        assert pix2 is not None
         with pytest.raises(TypeError):
             pix1[0, "0"]
         with pytest.raises(TypeError):
@@ -89,6 +91,8 @@ def test_sanity_negative_index(self) -> None:
         pix1 = im1.load()
         pix2 = im2.load()
 
+        assert pix1 is not None
+        assert pix2 is not None
         for y in range(-1, -im1.size[1] - 1, -1):
             for x in range(-1, -im1.size[0] - 1, -1):
                 pix2[x, y] = pix1[x, y]
@@ -98,10 +102,11 @@ def test_sanity_negative_index(self) -> None:
     @pytest.mark.skipif(numpy is None, reason="NumPy not installed")
     def test_numpy(self) -> None:
         im = hopper()
-        pix = im.load()
+        px = im.load()
 
+        assert px is not None
         assert numpy is not None
-        assert pix[numpy.int32(1), numpy.int32(2)] == (18, 20, 59)
+        assert px[numpy.int32(1), numpy.int32(2)] == (18, 20, 59)
 
 
 class TestImageGetPixel:
diff --git a/Tests/test_image_convert.py b/Tests/test_image_convert.py
index 2fb45854adf..5b63ceec3fe 100644
--- a/Tests/test_image_convert.py
+++ b/Tests/test_image_convert.py
@@ -222,8 +222,10 @@ def test_l_macro_rounding(convert_mode: str) -> None:
 
         converted_im = im.convert(convert_mode)
         px = converted_im.load()
+        assert px is not None
         converted_color = px[0, 0]
         if convert_mode == "LA":
+            assert converted_color is not None
             converted_color = converted_color[0]
         assert converted_color == 1
 
diff --git a/Tests/test_image_load.py b/Tests/test_image_load.py
index 0605821e0ad..4f1d63b8f43 100644
--- a/Tests/test_image_load.py
+++ b/Tests/test_image_load.py
@@ -12,9 +12,10 @@
 
 def test_sanity() -> None:
     im = hopper()
-    pix = im.load()
+    px = im.load()
 
-    assert pix[0, 0] == (20, 20, 70)
+    assert px is not None
+    assert px[0, 0] == (20, 20, 70)
 
 
 def test_close() -> None:
diff --git a/Tests/test_image_paste.py b/Tests/test_image_paste.py
index 01cb880cb31..2cff6c89378 100644
--- a/Tests/test_image_paste.py
+++ b/Tests/test_image_paste.py
@@ -14,6 +14,7 @@ def assert_9points_image(
         self, im: Image.Image, expected: list[tuple[int, int, int, int]]
     ) -> None:
         px = im.load()
+        assert px is not None
         actual = [
             px[0, 0],
             px[self.size // 2, 0],
@@ -48,6 +49,7 @@ def assert_9points_paste(
     def mask_1(self) -> Image.Image:
         mask = Image.new("1", (self.size, self.size))
         px = mask.load()
+        assert px is not None
         for y in range(mask.height):
             for x in range(mask.width):
                 px[y, x] = (x + y) % 2
@@ -61,6 +63,7 @@ def mask_L(self) -> Image.Image:
     def gradient_L(self) -> Image.Image:
         gradient = Image.new("L", (self.size, self.size))
         px = gradient.load()
+        assert px is not None
         for y in range(gradient.height):
             for x in range(gradient.width):
                 px[y, x] = (x + y) % 255
diff --git a/Tests/test_image_quantize.py b/Tests/test_image_quantize.py
index 2d461d985dd..9f8aa601c6b 100644
--- a/Tests/test_image_quantize.py
+++ b/Tests/test_image_quantize.py
@@ -80,6 +80,7 @@ def test_quantize_no_dither2() -> None:
     assert tuple(quantized.palette.palette) == data
 
     px = quantized.load()
+    assert px is not None
     for x in range(9):
         assert px[x, 0] == (0 if x < 5 else 1)
 
@@ -118,10 +119,12 @@ def test_colors() -> None:
 def test_transparent_colors_equal() -> None:
     im = Image.new("RGBA", (1, 2), (0, 0, 0, 0))
     px = im.load()
+    assert px is not None
     px[0, 1] = (255, 255, 255, 0)
 
     converted = im.quantize()
     converted_px = converted.load()
+    assert converted_px is not None
     assert converted_px[0, 0] == converted_px[0, 1]
 
 
@@ -139,6 +142,7 @@ def test_palette(method: Image.Quantize, color: tuple[int, ...]) -> None:
 
     converted = im.quantize(method=method)
     converted_px = converted.load()
+    assert converted_px is not None
     assert converted_px[0, 0] == converted.palette.colors[color]
 
 
diff --git a/Tests/test_image_resample.py b/Tests/test_image_resample.py
index d6055b577e3..58de812ef65 100644
--- a/Tests/test_image_resample.py
+++ b/Tests/test_image_resample.py
@@ -74,6 +74,7 @@ def make_sample(self, data: str, size: tuple[int, int]) -> Image.Image:
         data = data.replace(" ", "")
         sample = Image.new("L", size)
         s_px = sample.load()
+        assert s_px is not None
         w, h = size[0] // 2, size[1] // 2
         for y in range(h):
             for x in range(w):
@@ -87,6 +88,8 @@ def make_sample(self, data: str, size: tuple[int, int]) -> Image.Image:
     def check_case(self, case: Image.Image, sample: Image.Image) -> None:
         s_px = sample.load()
         c_px = case.load()
+        assert s_px is not None
+        assert c_px is not None
         for y in range(case.size[1]):
             for x in range(case.size[0]):
                 if c_px[x, y] != s_px[x, y]:
@@ -98,6 +101,7 @@ def check_case(self, case: Image.Image, sample: Image.Image) -> None:
 
     def serialize_image(self, image: Image.Image) -> str:
         s_px = image.load()
+        assert s_px is not None
         return "\n".join(
             " ".join(f"{s_px[x, y]:02x}" for x in range(image.size[0]))
             for y in range(image.size[1])
@@ -235,11 +239,14 @@ def make_case(
         self, mode: str, fill: tuple[int, int, int] | float
     ) -> tuple[Image.Image, tuple[int, ...]]:
         im = Image.new(mode, (512, 9), fill)
-        return im.resize((9, 512), Image.Resampling.LANCZOS), im.load()[0, 0]
+        px = im.load()
+        assert px is not None
+        return im.resize((9, 512), Image.Resampling.LANCZOS), px[0, 0]
 
     def run_case(self, case: tuple[Image.Image, int | tuple[int, ...]]) -> None:
         channel, color = case
         px = channel.load()
+        assert px is not None
         for x in range(channel.size[0]):
             for y in range(channel.size[1]):
                 if px[x, y] != color:
@@ -271,6 +278,7 @@ class TestCoreResampleAlphaCorrect:
     def make_levels_case(self, mode: str) -> Image.Image:
         i = Image.new(mode, (256, 16))
         px = i.load()
+        assert px is not None
         for y in range(i.size[1]):
             for x in range(i.size[0]):
                 pix = [x] * len(mode)
@@ -280,6 +288,7 @@ def make_levels_case(self, mode: str) -> Image.Image:
 
     def run_levels_case(self, i: Image.Image) -> None:
         px = i.load()
+        assert px is not None
         for y in range(i.size[1]):
             used_colors = {px[x, y][0] for x in range(i.size[0])}
             assert 256 == len(used_colors), (
@@ -310,6 +319,7 @@ def make_dirty_case(
     ) -> Image.Image:
         i = Image.new(mode, (64, 64), dirty_pixel)
         px = i.load()
+        assert px is not None
         xdiv4 = i.size[0] // 4
         ydiv4 = i.size[1] // 4
         for y in range(ydiv4 * 2):
@@ -319,6 +329,7 @@ def make_dirty_case(
 
     def run_dirty_case(self, i: Image.Image, clean_pixel: tuple[int, ...]) -> None:
         px = i.load()
+        assert px is not None
         for y in range(i.size[1]):
             for x in range(i.size[0]):
                 if px[x, y][-1] != 0 and px[x, y][:-1] != clean_pixel:
@@ -406,6 +417,7 @@ def test_reduce(self) -> None:
             draw.rectangle((0, 0, i.size[0] // 2 - 1, 0), test_color)
 
             px = i.resize((5, i.size[1]), Image.Resampling.BICUBIC).load()
+            assert px is not None
             if px[2, 0] != test_color // 2:
                 assert test_color // 2 == px[2, 0]
 
diff --git a/Tests/test_imageops.py b/Tests/test_imageops.py
index 64ef929c48d..3598df830cc 100644
--- a/Tests/test_imageops.py
+++ b/Tests/test_imageops.py
@@ -165,10 +165,14 @@ def test_pad() -> None:
 def test_pad_round() -> None:
     im = Image.new("1", (1, 1), 1)
     new_im = ImageOps.pad(im, (4, 1))
-    assert new_im.load()[2, 0] == 1
+    px = new_im.load()
+    assert px is not None
+    assert px[2, 0] == 1
 
     new_im = ImageOps.pad(im, (1, 4))
-    assert new_im.load()[0, 2] == 1
+    px = new_im.load()
+    assert px is not None
+    assert px[0, 2] == 1
 
 
 @pytest.mark.parametrize("mode", ("P", "PA"))
@@ -223,6 +227,7 @@ def test_expand_palette(border: int | tuple[int, int, int, int]) -> None:
         else:
             left, top, right, bottom = border
         px = im_expanded.convert("RGB").load()
+        assert px is not None
         for x in range(im_expanded.width):
             for b in range(top):
                 assert px[x, b] == (255, 0, 0)
diff --git a/Tests/test_imagetk.py b/Tests/test_imagetk.py
index b607b8c43aa..e5869892e55 100644
--- a/Tests/test_imagetk.py
+++ b/Tests/test_imagetk.py
@@ -70,6 +70,11 @@ def test_photoimage(mode: str) -> None:
     reloaded = ImageTk.getimage(im_tk)
     assert_image_equal(reloaded, im.convert("RGBA"))
 
+    with pytest.raises(ValueError):
+        ImageTk.PhotoImage()
+    with pytest.raises(ValueError):
+        ImageTk.PhotoImage(mode)
+
 
 def test_photoimage_apply_transparency() -> None:
     with Image.open("Tests/images/pil123p.png") as im:
diff --git a/Tests/test_mode_i16.py b/Tests/test_mode_i16.py
index 1b01f95ce5b..e26f5d283ab 100644
--- a/Tests/test_mode_i16.py
+++ b/Tests/test_mode_i16.py
@@ -16,6 +16,8 @@ def verify(im1: Image.Image) -> None:
     assert im1.size == im2.size
     pix1 = im1.load()
     pix2 = im2.load()
+    assert pix1 is not None
+    assert pix2 is not None
     for y in range(im1.size[1]):
         for x in range(im1.size[0]):
             xy = x, y
diff --git a/Tests/test_numpy.py b/Tests/test_numpy.py
index 32d2cf9853a..a082e5a4d69 100644
--- a/Tests/test_numpy.py
+++ b/Tests/test_numpy.py
@@ -109,6 +109,7 @@ def _test_img_equals_nparray(img: Image.Image, np_img: _typing.NumpyArray) -> No
     np_size = np_img.shape[1], np_img.shape[0]
     assert img.size == np_size
     px = img.load()
+    assert px is not None
     for x in range(0, img.size[0], int(img.size[0] / 10)):
         for y in range(0, img.size[1], int(img.size[1] / 10)):
             assert_deep_equal(px[x, y], np_img[y, x])
@@ -141,6 +142,7 @@ def test_save_tiff_uint16() -> None:
     img = Image.fromarray(a)
 
     img_px = img.load()
+    assert img_px is not None
     assert img_px[0, 0] == pixel_value
 
 
diff --git a/src/PIL/FpxImagePlugin.py b/src/PIL/FpxImagePlugin.py
index c1927bd26aa..93eef48d25c 100644
--- a/src/PIL/FpxImagePlugin.py
+++ b/src/PIL/FpxImagePlugin.py
@@ -53,7 +53,7 @@ class FpxImageFile(ImageFile.ImageFile):
     format = "FPX"
     format_description = "FlashPix"
 
-    def _open(self):
+    def _open(self) -> None:
         #
         # read the OLE directory and see if this is a likely
         # to be a FlashPix file
@@ -64,7 +64,8 @@ def _open(self):
             msg = "not an FPX file; invalid OLE file"
             raise SyntaxError(msg) from e
 
-        if self.ole.root.clsid != "56616700-C154-11CE-8553-00AA00A1F95B":
+        root = self.ole.root
+        if not root or root.clsid != "56616700-C154-11CE-8553-00AA00A1F95B":
             msg = "not an FPX file; bad root CLSID"
             raise SyntaxError(msg)
 
@@ -99,8 +100,7 @@ def _open_index(self, index: int = 1) -> None:
 
         s = prop[0x2000002 | id]
 
-        bands = i32(s, 4)
-        if bands > 4:
+        if not isinstance(s, bytes) or (bands := i32(s, 4)) > 4:
             msg = "Invalid number of bands"
             raise OSError(msg)
 
diff --git a/src/PIL/Image.py b/src/PIL/Image.py
index dbdb3b132ce..005b4cc9ebc 100644
--- a/src/PIL/Image.py
+++ b/src/PIL/Image.py
@@ -221,7 +221,7 @@ class Quantize(IntEnum):
 # Registries
 
 if TYPE_CHECKING:
-    from . import ImageFile
+    from . import ImageFile, ImagePalette
 ID: list[str] = []
 OPEN: dict[
     str,
@@ -1167,7 +1167,7 @@ def quantize(
         colors: int = 256,
         method: int | None = None,
         kmeans: int = 0,
-        palette=None,
+        palette: Image | None = None,
         dither: Dither = Dither.FLOYDSTEINBERG,
     ) -> Image:
         """
@@ -1239,8 +1239,8 @@ def quantize(
         from . import ImagePalette
 
         mode = im.im.getpalettemode()
-        palette = im.im.getpalette(mode, mode)[: colors * len(mode)]
-        im.palette = ImagePalette.ImagePalette(mode, palette)
+        palette_data = im.im.getpalette(mode, mode)[: colors * len(mode)]
+        im.palette = ImagePalette.ImagePalette(mode, palette_data)
 
         return im
 
@@ -1395,7 +1395,9 @@ def getbbox(self, *, alpha_only: bool = True) -> tuple[int, int, int, int] | Non
         self.load()
         return self.im.getbbox(alpha_only)
 
-    def getcolors(self, maxcolors: int = 256):
+    def getcolors(
+        self, maxcolors: int = 256
+    ) -> list[tuple[int, int]] | list[tuple[int, float]] | None:
         """
         Returns a list of colors used in this image.
 
@@ -1456,7 +1458,7 @@ def getextrema(self) -> tuple[float, float] | tuple[tuple[int, int], ...]:
             return tuple(self.im.getband(i).getextrema() for i in range(self.im.bands))
         return self.im.getextrema()
 
-    def getxmp(self):
+    def getxmp(self) -> dict[str, Any]:
         """
         Returns a dictionary containing the XMP tags.
         Requires defusedxml to be installed.
@@ -2017,7 +2019,11 @@ def putdata(
 
         self.im.putdata(data, scale, offset)
 
-    def putpalette(self, data, rawmode="RGB") -> None:
+    def putpalette(
+        self,
+        data: ImagePalette.ImagePalette | bytes | Sequence[int],
+        rawmode: str = "RGB",
+    ) -> None:
         """
         Attaches a palette to this image.  The image must be a "P", "PA", "L"
         or "LA" image.
@@ -2093,7 +2099,9 @@ def putpixel(
             value = (palette_index, alpha) if self.mode == "PA" else palette_index
         return self.im.putpixel(xy, value)
 
-    def remap_palette(self, dest_map, source_palette=None):
+    def remap_palette(
+        self, dest_map: list[int], source_palette: bytes | bytearray | None = None
+    ) -> Image:
         """
         Rewrites the image to reorder the palette.
 
@@ -3532,7 +3540,7 @@ def composite(image1: Image, image2: Image, mask: Image) -> Image:
     return image
 
 
-def eval(image, *args):
+def eval(image: Image, *args: Callable[[int], float]) -> Image:
     """
     Applies the function (which should take one argument) to each pixel
     in the given image. If the image has more than one band, the same
diff --git a/src/PIL/ImageOps.py b/src/PIL/ImageOps.py
index 55335872d3e..d47b86a755f 100644
--- a/src/PIL/ImageOps.py
+++ b/src/PIL/ImageOps.py
@@ -361,7 +361,9 @@ def pad(
     else:
         out = Image.new(image.mode, size, color)
         if resized.palette:
-            out.putpalette(resized.getpalette())
+            palette = resized.getpalette()
+            if palette is not None:
+                out.putpalette(palette)
         if resized.width != size[0]:
             x = round((size[0] - resized.width) * max(0, min(centering[0], 1)))
             out.paste(resized, (x, 0))
diff --git a/src/PIL/ImageTk.py b/src/PIL/ImageTk.py
index 90defdbbc23..6aa70ced3e6 100644
--- a/src/PIL/ImageTk.py
+++ b/src/PIL/ImageTk.py
@@ -28,8 +28,9 @@
 
 import tkinter
 from io import BytesIO
+from typing import Any
 
-from . import Image
+from . import Image, ImageFile
 
 # --------------------------------------------------------------------
 # Check for Tkinter interface hooks
@@ -49,14 +50,15 @@ def _pilbitmap_check() -> int:
     return _pilbitmap_ok
 
 
-def _get_image_from_kw(kw):
+def _get_image_from_kw(kw: dict[str, Any]) -> ImageFile.ImageFile | None:
     source = None
     if "file" in kw:
         source = kw.pop("file")
     elif "data" in kw:
         source = BytesIO(kw.pop("data"))
-    if source:
-        return Image.open(source)
+    if not source:
+        return None
+    return Image.open(source)
 
 
 def _pyimagingtkcall(command, photo, id):
@@ -96,12 +98,27 @@ class PhotoImage:
                    image file).
     """
 
-    def __init__(self, image=None, size=None, **kw):
+    def __init__(
+        self,
+        image: Image.Image | str | None = None,
+        size: tuple[int, int] | None = None,
+        **kw: Any,
+    ) -> None:
         # Tk compatibility: file or data
         if image is None:
             image = _get_image_from_kw(kw)
 
-        if hasattr(image, "mode") and hasattr(image, "size"):
+        if image is None:
+            msg = "Image is required"
+            raise ValueError(msg)
+        elif isinstance(image, str):
+            mode = image
+            image = None
+
+            if size is None:
+                msg = "If first argument is mode, size is required"
+                raise ValueError(msg)
+        else:
             # got an image instead of a mode
             mode = image.mode
             if mode == "P":
@@ -114,9 +131,6 @@ def __init__(self, image=None, size=None, **kw):
                     mode = "RGB"  # default
             size = image.size
             kw["width"], kw["height"] = size
-        else:
-            mode = image
-            image = None
 
         if mode not in ["1", "L", "RGB", "RGBA"]:
             mode = Image.getmodebase(mode)
diff --git a/src/PIL/MicImagePlugin.py b/src/PIL/MicImagePlugin.py
index 07239887f9f..5f23a34b99c 100644
--- a/src/PIL/MicImagePlugin.py
+++ b/src/PIL/MicImagePlugin.py
@@ -70,7 +70,7 @@ def _open(self) -> None:
         self.__fp = self.fp
         self.seek(0)
 
-    def seek(self, frame):
+    def seek(self, frame: int) -> None:
         if not self._seek_check(frame):
             return
         try:

From 0a19410ee21a4de066b0ff5c1869c8870c609afd Mon Sep 17 00:00:00 2001
From: "renovate[bot]" <29139614+renovate[bot]@users.noreply.github.com>
Date: Tue, 2 Jul 2024 12:15:04 +0000
Subject: [PATCH 0779/1178] Update dependency cibuildwheel to v2.19.2

---
 .ci/requirements-cibw.txt | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/.ci/requirements-cibw.txt b/.ci/requirements-cibw.txt
index 0d0f81fbfad..a2bf2a7b0fc 100644
--- a/.ci/requirements-cibw.txt
+++ b/.ci/requirements-cibw.txt
@@ -1 +1 @@
-cibuildwheel==2.19.1
+cibuildwheel==2.19.2

From e50df021e88ea4ab70d01781f2614b3a54b76d67 Mon Sep 17 00:00:00 2001
From: Hugo van Kemenade <1324225+hugovk@users.noreply.github.com>
Date: Sun, 30 Jun 2024 00:17:29 +0300
Subject: [PATCH 0780/1178] Add support for Python 3.13

---
 docs/installation/newer-versions.csv | 17 +++++++++--------
 docs/releasenotes/11.0.0.rst         | 10 +++++++---
 pyproject.toml                       |  4 ++++
 tox.ini                              |  2 +-
 4 files changed, 21 insertions(+), 12 deletions(-)

diff --git a/docs/installation/newer-versions.csv b/docs/installation/newer-versions.csv
index e21caf52071..7f4730df45f 100644
--- a/docs/installation/newer-versions.csv
+++ b/docs/installation/newer-versions.csv
@@ -1,8 +1,9 @@
-Python,3.12,3.11,3.10,3.9,3.8,3.7,3.6,3.5
-Pillow >= 10.1,Yes,Yes,Yes,Yes,Yes,,,
-Pillow 10.0,,Yes,Yes,Yes,Yes,,,
-Pillow 9.3 - 9.5,,Yes,Yes,Yes,Yes,Yes,,
-Pillow 9.0 - 9.2,,,Yes,Yes,Yes,Yes,,
-Pillow 8.3.2 - 8.4,,,Yes,Yes,Yes,Yes,Yes,
-Pillow 8.0 - 8.3.1,,,,Yes,Yes,Yes,Yes,
-Pillow 7.0 - 7.2,,,,,Yes,Yes,Yes,Yes
+Python,3.13,3.12,3.11,3.10,3.9,3.8,3.7,3.6,3.5
+Pillow >= 11,Yes,Yes,Yes,Yes,Yes,Yes,,,
+Pillow >= 10.1,,Yes,Yes,Yes,Yes,Yes,,,
+Pillow 10.0,,,Yes,Yes,Yes,Yes,,,
+Pillow 9.3 - 9.5,,,Yes,Yes,Yes,Yes,Yes,,
+Pillow 9.0 - 9.2,,,,Yes,Yes,Yes,Yes,,
+Pillow 8.3.2 - 8.4,,,,Yes,Yes,Yes,Yes,Yes,
+Pillow 8.0 - 8.3.1,,,,,Yes,Yes,Yes,Yes,
+Pillow 7.0 - 7.2,,,,,,Yes,Yes,Yes,Yes
diff --git a/docs/releasenotes/11.0.0.rst b/docs/releasenotes/11.0.0.rst
index bde791b1e4f..0b18fe01ada 100644
--- a/docs/releasenotes/11.0.0.rst
+++ b/docs/releasenotes/11.0.0.rst
@@ -61,7 +61,11 @@ TODO
 Other Changes
 =============
 
-TODO
-^^^^
+Python 3.13
+^^^^^^^^^^^
 
-TODO
+Pillow 10.4.0 had wheels built against Python 3.13 beta, available as a preview to help
+others prepare for 3.13, and to ensure Pillow could be used immediately at the release
+of 3.13.0 final (2024-10-01, :pep:`719`).
+
+Pillow 11.0.0 now officially supports Python 3.13.
diff --git a/pyproject.toml b/pyproject.toml
index 6f47f360b37..a1cc7554fe4 100644
--- a/pyproject.toml
+++ b/pyproject.toml
@@ -28,6 +28,7 @@ classifiers = [
   "Programming Language :: Python :: 3.10",
   "Programming Language :: Python :: 3.11",
   "Programming Language :: Python :: 3.12",
+  "Programming Language :: Python :: 3.13",
   "Programming Language :: Python :: Implementation :: CPython",
   "Programming Language :: Python :: Implementation :: PyPy",
   "Topic :: Multimedia :: Graphics",
@@ -136,6 +137,9 @@ lint.isort.required-imports = [
   "from __future__ import annotations",
 ]
 
+[tool.pyproject-fmt]
+max_supported_python = "3.13"
+
 [tool.pytest.ini_options]
 addopts = "-ra --color=yes"
 testpaths = [
diff --git a/tox.ini b/tox.ini
index d225a310697..912d7167c2c 100644
--- a/tox.ini
+++ b/tox.ini
@@ -3,7 +3,7 @@ requires =
     tox>=4.2
 env_list =
     lint
-    py{py3, 312, 311, 310, 39, 38}
+    py{py3, 313, 312, 311, 310, 39, 38}
 
 [testenv]
 deps =

From 4eec24a3805bd8dfe671505452985e0da08cdf8a Mon Sep 17 00:00:00 2001
From: Hugo van Kemenade <1324225+hugovk@users.noreply.github.com>
Date: Tue, 2 Jul 2024 21:52:43 +0300
Subject: [PATCH 0781/1178] Increment Python version check on Windows

Co-Authored-By: Andrew Murray <3112309+radarhere@users.noreply.github.com>
---
 setup.py | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/setup.py b/setup.py
index 0abfaaddc5b..b26852b0b07 100644
--- a/setup.py
+++ b/setup.py
@@ -43,7 +43,7 @@ def get_version():
 ZLIB_ROOT = None
 FUZZING_BUILD = "LIB_FUZZING_ENGINE" in os.environ
 
-if sys.platform == "win32" and sys.version_info >= (3, 13):
+if sys.platform == "win32" and sys.version_info >= (3, 14):
     import atexit
 
     atexit.register(

From 40d3b2ce0c1527d374095df36589a90d72eed5ef Mon Sep 17 00:00:00 2001
From: Hugo van Kemenade <1324225+hugovk@users.noreply.github.com>
Date: Tue, 2 Jul 2024 21:53:23 +0300
Subject: [PATCH 0782/1178] Fix version range

Co-Authored-By: Andrew Murray <3112309+radarhere@users.noreply.github.com>
---
 docs/installation/newer-versions.csv | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/docs/installation/newer-versions.csv b/docs/installation/newer-versions.csv
index 7f4730df45f..028a2018f00 100644
--- a/docs/installation/newer-versions.csv
+++ b/docs/installation/newer-versions.csv
@@ -1,6 +1,6 @@
 Python,3.13,3.12,3.11,3.10,3.9,3.8,3.7,3.6,3.5
 Pillow >= 11,Yes,Yes,Yes,Yes,Yes,Yes,,,
-Pillow >= 10.1,,Yes,Yes,Yes,Yes,Yes,,,
+Pillow 10.1 - 10.4,,Yes,Yes,Yes,Yes,Yes,,,
 Pillow 10.0,,,Yes,Yes,Yes,Yes,,,
 Pillow 9.3 - 9.5,,,Yes,Yes,Yes,Yes,Yes,,
 Pillow 9.0 - 9.2,,,,Yes,Yes,Yes,Yes,,

From 534d82119b60a8d16ecdf2c08d4198ae9e974de5 Mon Sep 17 00:00:00 2001
From: Hugo van Kemenade <1324225+hugovk@users.noreply.github.com>
Date: Mon, 1 Jul 2024 18:53:48 +0300
Subject: [PATCH 0783/1178] Test NumPy on Python 3.13

Co-Authored-By: Andrew Murray <3112309+radarhere@users.noreply.github.com>
---
 .ci/install.sh                     | 3 +--
 .github/workflows/macos-install.sh | 4 +---
 .github/workflows/wheels-test.sh   | 2 +-
 3 files changed, 3 insertions(+), 6 deletions(-)

diff --git a/.ci/install.sh b/.ci/install.sh
index c6e166171a4..fc5ff00646b 100755
--- a/.ci/install.sh
+++ b/.ci/install.sh
@@ -37,8 +37,7 @@ python3 -m pip install -U pytest-timeout
 python3 -m pip install pyroma
 
 if [[ $(uname) != CYGWIN* ]]; then
-    # TODO Update condition when NumPy supports 3.13
-    if ! [[ "$GHA_PYTHON_VERSION" == "3.13" ]]; then python3 -m pip install numpy ; fi
+    python3 -m pip install numpy
 
     # PyQt6 doesn't support PyPy3
     if [[ $GHA_PYTHON_VERSION == 3.* ]]; then
diff --git a/.github/workflows/macos-install.sh b/.github/workflows/macos-install.sh
index ae346e8b6c3..d35cfcd3124 100755
--- a/.github/workflows/macos-install.sh
+++ b/.github/workflows/macos-install.sh
@@ -25,9 +25,7 @@ python3 -m pip install -U pytest
 python3 -m pip install -U pytest-cov
 python3 -m pip install -U pytest-timeout
 python3 -m pip install pyroma
-
-# TODO Update condition when NumPy supports 3.13
-if ! [[ "$GHA_PYTHON_VERSION" == "3.13" ]]; then python3 -m pip install numpy ; fi
+python3 -m pip install numpy
 
 # extra test images
 pushd depends && ./install_extra_test_images.sh && popd
diff --git a/.github/workflows/wheels-test.sh b/.github/workflows/wheels-test.sh
index a3376ac929c..3fbf3be695b 100755
--- a/.github/workflows/wheels-test.sh
+++ b/.github/workflows/wheels-test.sh
@@ -12,7 +12,7 @@ elif [ "${AUDITWHEEL_POLICY::9}" == "musllinux" ]; then
 else
     yum install -y fribidi
 fi
-if [ "${AUDITWHEEL_POLICY::9}" != "musllinux" ] && !([[ "$OSTYPE" == "darwin"* ]] && [[ $(python3 --version) == *"3.13."* ]]); then
+if [ "${AUDITWHEEL_POLICY::9}" != "musllinux" ]; then
     python3 -m pip install numpy
 fi
 

From 51bd7d2ea8b8dbebabb200ca3c449c38b76e1d7f Mon Sep 17 00:00:00 2001
From: Hugo van Kemenade <1324225+hugovk@users.noreply.github.com>
Date: Wed, 3 Jul 2024 00:44:45 -0600
Subject: [PATCH 0784/1178] Drop support for Python 3.8 (#8183)

Co-authored-by: Andrew Murray <radarhere@users.noreply.github.com>
Co-authored-by: Andrew Murray <3112309+radarhere@users.noreply.github.com>
---
 .appveyor.yml                            |  6 +++---
 .ci/install.sh                           |  1 -
 .github/workflows/test-cygwin.yml        |  2 +-
 .github/workflows/test-docker.yml        |  1 -
 .github/workflows/test-windows.yml       |  2 +-
 .github/workflows/test.yml               |  5 -----
 .github/workflows/wheels.yml             |  4 ----
 Tests/helper.py                          |  3 ++-
 Tests/test_file_eps.py                   |  7 ++++---
 Tests/test_file_gif.py                   |  2 +-
 Tests/test_file_pdf.py                   |  3 ++-
 Tests/test_file_tiff.py                  |  2 +-
 Tests/test_image_resample.py             |  2 +-
 Tests/test_image_resize.py               |  2 +-
 Tests/test_imagedraw.py                  |  2 +-
 Tests/test_imageops_usm.py               |  2 +-
 Tests/test_imagepath.py                  |  2 +-
 docs/installation/basic-installation.rst |  4 ++--
 docs/installation/newer-versions.csv     |  2 +-
 docs/installation/platform-support.rst   | 12 +++++-------
 docs/releasenotes/11.0.0.rst             |  6 ++++++
 pyproject.toml                           |  5 ++---
 src/PIL/GifImagePlugin.py                |  4 ++--
 src/PIL/Image.py                         |  8 +++-----
 src/PIL/ImageDraw.py                     |  9 +++++----
 src/PIL/ImageFilter.py                   |  3 ++-
 src/PIL/ImageOps.py                      |  3 ++-
 src/PIL/ImagePalette.py                  |  3 ++-
 src/PIL/ImageTransform.py                |  3 ++-
 src/PIL/IptcImagePlugin.py               |  2 +-
 src/PIL/Jpeg2KImagePlugin.py             |  4 ++--
 src/PIL/PdfParser.py                     |  4 ++--
 src/PIL/SpiderImagePlugin.py             |  4 ++--
 src/PIL/_typing.py                       |  3 ++-
 tox.ini                                  |  2 +-
 winbuild/README.md                       |  2 +-
 winbuild/build.rst                       |  2 +-
 37 files changed, 66 insertions(+), 67 deletions(-)

diff --git a/.appveyor.yml b/.appveyor.yml
index 6ce5200b6ea..e12987a5fa7 100644
--- a/.appveyor.yml
+++ b/.appveyor.yml
@@ -21,9 +21,9 @@ environment:
   - PYTHON: C:/Python312
     ARCHITECTURE: x86
     APPVEYOR_BUILD_WORKER_IMAGE: Visual Studio 2022
-  - PYTHON: C:/Python38-x64
+  - PYTHON: C:/Python39-x64
     ARCHITECTURE: AMD64
-    APPVEYOR_BUILD_WORKER_IMAGE: Visual Studio 2017
+    APPVEYOR_BUILD_WORKER_IMAGE: Visual Studio 2019
 
 
 install:
@@ -38,7 +38,7 @@ install:
 - path c:\nasm-2.16.03;C:\Program Files\gs\gs10.03.1\bin;%PATH%
 - cd c:\pillow\winbuild\
 - ps: |
-        c:\python38\python.exe c:\pillow\winbuild\build_prepare.py -v --depends=C:\pillow-depends\
+        c:\python39\python.exe c:\pillow\winbuild\build_prepare.py -v --depends=C:\pillow-depends\
         c:\pillow\winbuild\build\build_dep_all.cmd
         $host.SetShouldExit(0)
 - path C:\pillow\winbuild\build\bin;%PATH%
diff --git a/.ci/install.sh b/.ci/install.sh
index fc5ff00646b..1eb098be9c1 100755
--- a/.ci/install.sh
+++ b/.ci/install.sh
@@ -48,7 +48,6 @@ if [[ $(uname) != CYGWIN* ]]; then
     # Pyroma uses non-isolated build and fails with old setuptools
     if [[
         $GHA_PYTHON_VERSION == pypy3.9
-        || $GHA_PYTHON_VERSION == 3.8
         || $GHA_PYTHON_VERSION == 3.9
     ]]; then
         # To match pyproject.toml
diff --git a/.github/workflows/test-cygwin.yml b/.github/workflows/test-cygwin.yml
index 97422d56916..8e282709917 100644
--- a/.github/workflows/test-cygwin.yml
+++ b/.github/workflows/test-cygwin.yml
@@ -35,7 +35,7 @@ jobs:
     strategy:
       fail-fast: false
       matrix:
-        python-minor-version: [8, 9]
+        python-minor-version: [9]
 
     timeout-minutes: 40
 
diff --git a/.github/workflows/test-docker.yml b/.github/workflows/test-docker.yml
index d18ab97293f..21e1275e7c9 100644
--- a/.github/workflows/test-docker.yml
+++ b/.github/workflows/test-docker.yml
@@ -49,7 +49,6 @@ jobs:
           fedora-39-amd64,
           fedora-40-amd64,
           gentoo,
-          ubuntu-20.04-focal-amd64,
           ubuntu-22.04-jammy-amd64,
           ubuntu-24.04-noble-amd64,
         ]
diff --git a/.github/workflows/test-windows.yml b/.github/workflows/test-windows.yml
index ee265774b2e..5b34d6703af 100644
--- a/.github/workflows/test-windows.yml
+++ b/.github/workflows/test-windows.yml
@@ -35,7 +35,7 @@ jobs:
     strategy:
       fail-fast: false
       matrix:
-        python-version: ["pypy3.10", "pypy3.9", "3.8", "3.9", "3.10", "3.11", "3.12", "3.13"]
+        python-version: ["pypy3.10", "pypy3.9", "3.9", "3.10", "3.11", "3.12", "3.13"]
 
     timeout-minutes: 30
 
diff --git a/.github/workflows/test.yml b/.github/workflows/test.yml
index aa5646caf44..0972459b0fb 100644
--- a/.github/workflows/test.yml
+++ b/.github/workflows/test.yml
@@ -48,7 +48,6 @@ jobs:
           "3.11",
           "3.10",
           "3.9",
-          "3.8",
         ]
         include:
         - python-version: "3.11"
@@ -59,13 +58,9 @@ jobs:
         # M1 only available for 3.10+
         - os: "macos-13"
           python-version: "3.9"
-        - os: "macos-13"
-          python-version: "3.8"
         exclude:
         - os: "macos-14"
           python-version: "3.9"
-        - os: "macos-14"
-          python-version: "3.8"
 
     runs-on: ${{ matrix.os }}
     name: ${{ matrix.os }} Python ${{ matrix.python-version }}
diff --git a/.github/workflows/wheels.yml b/.github/workflows/wheels.yml
index 3d6099c1cf5..4eb907bcd9f 100644
--- a/.github/workflows/wheels.yml
+++ b/.github/workflows/wheels.yml
@@ -41,7 +41,6 @@ jobs:
         python-version:
           - pp39
           - pp310
-          - cp38
           - cp39
           - cp310
           - cp311
@@ -136,8 +135,6 @@ jobs:
           CIBW_MANYLINUX_PYPY_X86_64_IMAGE: ${{ matrix.manylinux }}
           CIBW_MANYLINUX_X86_64_IMAGE: ${{ matrix.manylinux }}
           CIBW_PRERELEASE_PYTHONS: True
-          CIBW_SKIP: pp38-*
-          CIBW_TEST_SKIP: cp38-macosx_arm64
           MACOSX_DEPLOYMENT_TARGET: ${{ matrix.macosx_deployment_target }}
 
       - uses: actions/upload-artifact@v4
@@ -208,7 +205,6 @@ jobs:
           CIBW_BEFORE_ALL: "{package}\\winbuild\\build\\build_dep_all.cmd"
           CIBW_CACHE_PATH: "C:\\cibw"
           CIBW_PRERELEASE_PYTHONS: True
-          CIBW_SKIP: pp38-*
           CIBW_TEST_SKIP: "*-win_arm64"
           CIBW_TEST_COMMAND: 'docker run --rm
             -v {project}:C:\pillow
diff --git a/Tests/helper.py b/Tests/helper.py
index 605a214d400..7abc495b6ea 100644
--- a/Tests/helper.py
+++ b/Tests/helper.py
@@ -11,9 +11,10 @@
 import sys
 import sysconfig
 import tempfile
+from collections.abc import Sequence
 from functools import lru_cache
 from io import BytesIO
-from typing import Any, Callable, Sequence
+from typing import Any, Callable
 
 import pytest
 from packaging.version import parse as parse_version
diff --git a/Tests/test_file_eps.py b/Tests/test_file_eps.py
index 3181fc20444..b54238132c2 100644
--- a/Tests/test_file_eps.py
+++ b/Tests/test_file_eps.py
@@ -385,9 +385,10 @@ def test_timeout(test_file: str) -> None:
 def test_bounding_box_in_trailer() -> None:
     # Check bounding boxes are parsed in the same way
     # when specified in the header and the trailer
-    with Image.open("Tests/images/zero_bb_trailer.eps") as trailer_image, Image.open(
-        FILE1
-    ) as header_image:
+    with (
+        Image.open("Tests/images/zero_bb_trailer.eps") as trailer_image,
+        Image.open(FILE1) as header_image,
+    ):
         assert trailer_image.size == header_image.size
 
 
diff --git a/Tests/test_file_gif.py b/Tests/test_file_gif.py
index e19c88a47c4..79a2ec0ab37 100644
--- a/Tests/test_file_gif.py
+++ b/Tests/test_file_gif.py
@@ -1,9 +1,9 @@
 from __future__ import annotations
 
 import warnings
+from collections.abc import Generator
 from io import BytesIO
 from pathlib import Path
-from typing import Generator
 
 import pytest
 
diff --git a/Tests/test_file_pdf.py b/Tests/test_file_pdf.py
index d39a86565ce..02f07a565d7 100644
--- a/Tests/test_file_pdf.py
+++ b/Tests/test_file_pdf.py
@@ -5,8 +5,9 @@
 import os.path
 import tempfile
 import time
+from collections.abc import Generator
 from pathlib import Path
-from typing import Any, Generator
+from typing import Any
 
 import pytest
 
diff --git a/Tests/test_file_tiff.py b/Tests/test_file_tiff.py
index c06d110a75e..93a9f9e6a61 100644
--- a/Tests/test_file_tiff.py
+++ b/Tests/test_file_tiff.py
@@ -2,10 +2,10 @@
 
 import os
 import warnings
+from collections.abc import Generator
 from io import BytesIO
 from pathlib import Path
 from types import ModuleType
-from typing import Generator
 
 import pytest
 
diff --git a/Tests/test_image_resample.py b/Tests/test_image_resample.py
index 58de812ef65..92ba1553ccc 100644
--- a/Tests/test_image_resample.py
+++ b/Tests/test_image_resample.py
@@ -1,7 +1,7 @@
 from __future__ import annotations
 
+from collections.abc import Generator
 from contextlib import contextmanager
-from typing import Generator
 
 import pytest
 
diff --git a/Tests/test_image_resize.py b/Tests/test_image_resize.py
index 64098f80fb1..3ef05a25f67 100644
--- a/Tests/test_image_resize.py
+++ b/Tests/test_image_resize.py
@@ -4,9 +4,9 @@
 
 from __future__ import annotations
 
+from collections.abc import Generator
 from itertools import permutations
 from pathlib import Path
-from typing import Generator
 
 import pytest
 
diff --git a/Tests/test_imagedraw.py b/Tests/test_imagedraw.py
index 1466ab1bac8..1ff3fea2a64 100644
--- a/Tests/test_imagedraw.py
+++ b/Tests/test_imagedraw.py
@@ -2,7 +2,7 @@
 
 import contextlib
 import os.path
-from typing import Sequence
+from collections.abc import Sequence
 
 import pytest
 
diff --git a/Tests/test_imageops_usm.py b/Tests/test_imageops_usm.py
index c8e2c0467de..920012d8639 100644
--- a/Tests/test_imageops_usm.py
+++ b/Tests/test_imageops_usm.py
@@ -1,6 +1,6 @@
 from __future__ import annotations
 
-from typing import Generator
+from collections.abc import Generator
 
 import pytest
 
diff --git a/Tests/test_imagepath.py b/Tests/test_imagepath.py
index 9487560af88..cda2584e77b 100644
--- a/Tests/test_imagepath.py
+++ b/Tests/test_imagepath.py
@@ -3,7 +3,7 @@
 import array
 import math
 import struct
-from typing import Sequence
+from collections.abc import Sequence
 
 import pytest
 
diff --git a/docs/installation/basic-installation.rst b/docs/installation/basic-installation.rst
index 01981aa4fbe..989f72dddde 100644
--- a/docs/installation/basic-installation.rst
+++ b/docs/installation/basic-installation.rst
@@ -68,8 +68,8 @@ and :pypi:`olefile` for Pillow to read FPX and MIC images::
 .. tab:: Windows
 
     We provide Pillow binaries for Windows compiled for the matrix of supported
-    Pythons in the wheel format. These include x86, x86-64 and arm64 versions
-    (with the exception of Python 3.8 on arm64). These binaries include support
+    Pythons in the wheel format. These include x86, x86-64 and arm64 versions.
+    These binaries include support
     for all optional libraries except libimagequant and libxcb. Raqm support
     requires FriBiDi to be installed separately::
 
diff --git a/docs/installation/newer-versions.csv b/docs/installation/newer-versions.csv
index 028a2018f00..19816af58da 100644
--- a/docs/installation/newer-versions.csv
+++ b/docs/installation/newer-versions.csv
@@ -1,5 +1,5 @@
 Python,3.13,3.12,3.11,3.10,3.9,3.8,3.7,3.6,3.5
-Pillow >= 11,Yes,Yes,Yes,Yes,Yes,Yes,,,
+Pillow >= 11,Yes,Yes,Yes,Yes,Yes,,,,
 Pillow 10.1 - 10.4,,Yes,Yes,Yes,Yes,Yes,,,
 Pillow 10.0,,,Yes,Yes,Yes,Yes,,,
 Pillow 9.3 - 9.5,,,Yes,Yes,Yes,Yes,Yes,,
diff --git a/docs/installation/platform-support.rst b/docs/installation/platform-support.rst
index cde00c76d80..1d449a03655 100644
--- a/docs/installation/platform-support.rst
+++ b/docs/installation/platform-support.rst
@@ -35,14 +35,12 @@ These platforms are built and tested for every change.
 +----------------------------------+----------------------------+---------------------+
 | Gentoo                           | 3.9                        | x86-64              |
 +----------------------------------+----------------------------+---------------------+
-| macOS 13 Ventura                 | 3.8, 3.9                   | x86-64              |
+| macOS 13 Ventura                 | 3.9                        | x86-64              |
 +----------------------------------+----------------------------+---------------------+
 | macOS 14 Sonoma                  | 3.10, 3.11, 3.12, 3.13,    | arm64               |
 |                                  | PyPy3                      |                     |
 +----------------------------------+----------------------------+---------------------+
-| Ubuntu Linux 20.04 LTS (Focal)   | 3.8                        | x86-64              |
-+----------------------------------+----------------------------+---------------------+
-| Ubuntu Linux 22.04 LTS (Jammy)   | 3.8, 3.9, 3.10, 3.11,      | x86-64              |
+| Ubuntu Linux 22.04 LTS (Jammy)   | 3.9, 3.10, 3.11,           | x86-64              |
 |                                  | 3.12, 3.13, PyPy3          |                     |
 |                                  +----------------------------+---------------------+
 |                                  | 3.10                       | arm64v8             |
@@ -50,16 +48,16 @@ These platforms are built and tested for every change.
 | Ubuntu Linux 24.04 LTS (Noble)   | 3.12                       | x86-64, ppc64le,    |
 |                                  |                            | s390x               |
 +----------------------------------+----------------------------+---------------------+
-| Windows Server 2016              | 3.8                        | x86-64              |
+| Windows Server 2016              | 3.9                        | x86-64              |
 +----------------------------------+----------------------------+---------------------+
-| Windows Server 2022              | 3.8, 3.9, 3.10, 3.11,      | x86-64              |
+| Windows Server 2022              | 3.9, 3.10, 3.11,           | x86-64              |
 |                                  | 3.12, 3.13, PyPy3          |                     |
 |                                  +----------------------------+---------------------+
 |                                  | 3.12                       | x86                 |
 |                                  +----------------------------+---------------------+
 |                                  | 3.9 (MinGW)                | x86-64              |
 |                                  +----------------------------+---------------------+
-|                                  | 3.8, 3.9 (Cygwin)          | x86-64              |
+|                                  | 3.9 (Cygwin)               | x86-64              |
 +----------------------------------+----------------------------+---------------------+
 
 
diff --git a/docs/releasenotes/11.0.0.rst b/docs/releasenotes/11.0.0.rst
index 0b18fe01ada..964423ae035 100644
--- a/docs/releasenotes/11.0.0.rst
+++ b/docs/releasenotes/11.0.0.rst
@@ -17,6 +17,12 @@ TODO
 Backwards Incompatible Changes
 ==============================
 
+Python 3.8
+^^^^^^^^^^
+
+Pillow has dropped support for Python 3.8,
+which reached end-of-life in October 2024.
+
 PSFile
 ^^^^^^
 
diff --git a/pyproject.toml b/pyproject.toml
index a1cc7554fe4..700d5e7fec4 100644
--- a/pyproject.toml
+++ b/pyproject.toml
@@ -18,12 +18,11 @@ license = { text = "HPND" }
 authors = [
   { name = "Jeffrey A. Clark", email = "aclark@aclark.net" },
 ]
-requires-python = ">=3.8"
+requires-python = ">=3.9"
 classifiers = [
   "Development Status :: 6 - Mature",
   "License :: OSI Approved :: Historical Permission Notice and Disclaimer (HPND)",
   "Programming Language :: Python :: 3 :: Only",
-  "Programming Language :: Python :: 3.8",
   "Programming Language :: Python :: 3.9",
   "Programming Language :: Python :: 3.10",
   "Programming Language :: Python :: 3.11",
@@ -147,7 +146,7 @@ testpaths = [
 ]
 
 [tool.mypy]
-python_version = "3.8"
+python_version = "3.9"
 pretty = true
 disallow_any_generics = true
 enable_error_code = "ignore-without-code"
diff --git a/src/PIL/GifImagePlugin.py b/src/PIL/GifImagePlugin.py
index 8018e25dcee..bf74f9356fa 100644
--- a/src/PIL/GifImagePlugin.py
+++ b/src/PIL/GifImagePlugin.py
@@ -32,7 +32,7 @@
 import sys
 from enum import IntEnum
 from functools import cached_property
-from typing import IO, TYPE_CHECKING, Any, List, Literal, NamedTuple, Union
+from typing import IO, TYPE_CHECKING, Any, Literal, NamedTuple, Union
 
 from . import (
     Image,
@@ -504,7 +504,7 @@ def _normalize_mode(im: Image.Image) -> Image.Image:
     return im.convert("L")
 
 
-_Palette = Union[bytes, bytearray, List[int], ImagePalette.ImagePalette]
+_Palette = Union[bytes, bytearray, list[int], ImagePalette.ImagePalette]
 
 
 def _normalize_palette(
diff --git a/src/PIL/Image.py b/src/PIL/Image.py
index 005b4cc9ebc..b4ef62510ed 100644
--- a/src/PIL/Image.py
+++ b/src/PIL/Image.py
@@ -38,7 +38,7 @@
 import sys
 import tempfile
 import warnings
-from collections.abc import Callable, MutableMapping
+from collections.abc import Callable, MutableMapping, Sequence
 from enum import IntEnum
 from types import ModuleType
 from typing import (
@@ -47,8 +47,6 @@
     Any,
     Literal,
     Protocol,
-    Sequence,
-    Tuple,
     cast,
 )
 
@@ -1097,7 +1095,7 @@ def convert_transparency(
             if trns is not None:
                 try:
                     new_im.info["transparency"] = new_im.palette.getcolor(
-                        cast(Tuple[int, ...], trns),  # trns was converted to RGB
+                        cast(tuple[int, ...], trns),  # trns was converted to RGB
                         new_im,
                     )
                 except Exception:
@@ -3075,7 +3073,7 @@ def new(
         and isinstance(color, (list, tuple))
         and all(isinstance(i, int) for i in color)
     ):
-        color_ints: tuple[int, ...] = cast(Tuple[int, ...], tuple(color))
+        color_ints: tuple[int, ...] = cast(tuple[int, ...], tuple(color))
         if len(color_ints) == 3 or len(color_ints) == 4:
             # RGB or RGBA value for a P image
             from . import ImagePalette
diff --git a/src/PIL/ImageDraw.py b/src/PIL/ImageDraw.py
index 244d3d5f022..2b3620e712c 100644
--- a/src/PIL/ImageDraw.py
+++ b/src/PIL/ImageDraw.py
@@ -34,8 +34,9 @@
 import math
 import numbers
 import struct
+from collections.abc import Sequence
 from types import ModuleType
-from typing import TYPE_CHECKING, AnyStr, Callable, List, Sequence, Tuple, Union, cast
+from typing import TYPE_CHECKING, AnyStr, Callable, Union, cast
 
 from . import Image, ImageColor
 from ._deprecate import deprecate
@@ -51,7 +52,7 @@
 if TYPE_CHECKING:
     from . import ImageDraw2, ImageFont
 
-_Ink = Union[float, Tuple[int, ...], str]
+_Ink = Union[float, tuple[int, ...], str]
 
 """
 A simple 2D drawing interface for PIL images.
@@ -1124,7 +1125,7 @@ def _compute_regular_polygon_vertices(
             msg = "bounding_circle should only contain numeric data"
             raise ValueError(msg)
 
-        *centroid, polygon_radius = cast(List[float], list(bounding_circle))
+        *centroid, polygon_radius = cast(list[float], list(bounding_circle))
     elif len(bounding_circle) == 2 and isinstance(bounding_circle[0], (list, tuple)):
         if not all(
             isinstance(i, (int, float)) for i in bounding_circle[0]
@@ -1136,7 +1137,7 @@ def _compute_regular_polygon_vertices(
             msg = "bounding_circle centre should contain 2D coordinates (e.g. (x, y))"
             raise ValueError(msg)
 
-        centroid = cast(List[float], list(bounding_circle[0]))
+        centroid = cast(list[float], list(bounding_circle[0]))
         polygon_radius = cast(float, bounding_circle[1])
     else:
         msg = (
diff --git a/src/PIL/ImageFilter.py b/src/PIL/ImageFilter.py
index e18b4a4466a..8b0974b2c37 100644
--- a/src/PIL/ImageFilter.py
+++ b/src/PIL/ImageFilter.py
@@ -18,8 +18,9 @@
 
 import abc
 import functools
+from collections.abc import Sequence
 from types import ModuleType
-from typing import TYPE_CHECKING, Any, Callable, Sequence, cast
+from typing import TYPE_CHECKING, Any, Callable, cast
 
 if TYPE_CHECKING:
     from . import _imaging
diff --git a/src/PIL/ImageOps.py b/src/PIL/ImageOps.py
index d47b86a755f..44aad0c3ca1 100644
--- a/src/PIL/ImageOps.py
+++ b/src/PIL/ImageOps.py
@@ -21,7 +21,8 @@
 import functools
 import operator
 import re
-from typing import Protocol, Sequence, cast
+from collections.abc import Sequence
+from typing import Protocol, cast
 
 from . import ExifTags, Image, ImagePalette
 
diff --git a/src/PIL/ImagePalette.py b/src/PIL/ImagePalette.py
index ed38285dc28..8ccecbd07ca 100644
--- a/src/PIL/ImagePalette.py
+++ b/src/PIL/ImagePalette.py
@@ -18,7 +18,8 @@
 from __future__ import annotations
 
 import array
-from typing import IO, TYPE_CHECKING, Sequence
+from collections.abc import Sequence
+from typing import IO, TYPE_CHECKING
 
 from . import GimpGradientFile, GimpPaletteFile, ImageColor, PaletteFile
 
diff --git a/src/PIL/ImageTransform.py b/src/PIL/ImageTransform.py
index ffd7916745c..a3d8f441a9f 100644
--- a/src/PIL/ImageTransform.py
+++ b/src/PIL/ImageTransform.py
@@ -14,7 +14,8 @@
 #
 from __future__ import annotations
 
-from typing import Any, Sequence
+from collections.abc import Sequence
+from typing import Any
 
 from . import Image
 
diff --git a/src/PIL/IptcImagePlugin.py b/src/PIL/IptcImagePlugin.py
index 73df83bfb31..f9d5b75f0f9 100644
--- a/src/PIL/IptcImagePlugin.py
+++ b/src/PIL/IptcImagePlugin.py
@@ -16,8 +16,8 @@
 #
 from __future__ import annotations
 
+from collections.abc import Sequence
 from io import BytesIO
-from typing import Sequence
 
 from . import Image, ImageFile
 from ._binary import i16be as i16
diff --git a/src/PIL/Jpeg2KImagePlugin.py b/src/PIL/Jpeg2KImagePlugin.py
index e50cd7799a3..c8a57567aa6 100644
--- a/src/PIL/Jpeg2KImagePlugin.py
+++ b/src/PIL/Jpeg2KImagePlugin.py
@@ -18,7 +18,7 @@
 import io
 import os
 import struct
-from typing import IO, Tuple, cast
+from typing import IO, cast
 
 from . import Image, ImageFile, ImagePalette, _binary
 
@@ -82,7 +82,7 @@ def next_box_type(self) -> bytes:
         self.remaining_in_box = -1
 
         # Read the length and type of the next box
-        lbox, tbox = cast(Tuple[int, bytes], self.read_fields(">I4s"))
+        lbox, tbox = cast(tuple[int, bytes], self.read_fields(">I4s"))
         if lbox == 1:
             lbox = cast(int, self.read_fields(">Q")[0])
             hlen = 16
diff --git a/src/PIL/PdfParser.py b/src/PIL/PdfParser.py
index 9e22313475e..622dc7de9e7 100644
--- a/src/PIL/PdfParser.py
+++ b/src/PIL/PdfParser.py
@@ -8,7 +8,7 @@
 import re
 import time
 import zlib
-from typing import TYPE_CHECKING, Any, List, NamedTuple, Union
+from typing import TYPE_CHECKING, Any, NamedTuple, Union
 
 
 # see 7.9.2.2 Text String Type on page 86 and D.3 PDFDocEncoding Character Set
@@ -240,7 +240,7 @@ def __bytes__(self) -> bytes:
         return bytes(result)
 
 
-class PdfArray(List[Any]):
+class PdfArray(list[Any]):
     def __bytes__(self) -> bytes:
         return b"[ " + b" ".join(pdf_repr(x) for x in self) + b" ]"
 
diff --git a/src/PIL/SpiderImagePlugin.py b/src/PIL/SpiderImagePlugin.py
index f5a09c3ef61..a07101e5461 100644
--- a/src/PIL/SpiderImagePlugin.py
+++ b/src/PIL/SpiderImagePlugin.py
@@ -37,7 +37,7 @@
 import os
 import struct
 import sys
-from typing import IO, TYPE_CHECKING, Any, Tuple, cast
+from typing import IO, TYPE_CHECKING, Any, cast
 
 from . import Image, ImageFile
 
@@ -187,7 +187,7 @@ def seek(self, frame: int) -> None:
     def convert2byte(self, depth: int = 255) -> Image.Image:
         extrema = self.getextrema()
         assert isinstance(extrema[0], float)
-        minimum, maximum = cast(Tuple[float, float], extrema)
+        minimum, maximum = cast(tuple[float, float], extrema)
         m: float = 1
         if maximum != minimum:
             m = depth / (maximum - minimum)
diff --git a/src/PIL/_typing.py b/src/PIL/_typing.py
index db1e80e2fc1..b6bb8d89a88 100644
--- a/src/PIL/_typing.py
+++ b/src/PIL/_typing.py
@@ -2,7 +2,8 @@
 
 import os
 import sys
-from typing import TYPE_CHECKING, Any, Protocol, Sequence, TypeVar, Union
+from collections.abc import Sequence
+from typing import TYPE_CHECKING, Any, Protocol, TypeVar, Union
 
 if TYPE_CHECKING:
     try:
diff --git a/tox.ini b/tox.ini
index 912d7167c2c..18941523785 100644
--- a/tox.ini
+++ b/tox.ini
@@ -3,7 +3,7 @@ requires =
     tox>=4.2
 env_list =
     lint
-    py{py3, 313, 312, 311, 310, 39, 38}
+    py{py3, 313, 312, 311, 310, 39}
 
 [testenv]
 deps =
diff --git a/winbuild/README.md b/winbuild/README.md
index 7e81abcb0e5..c8048bcc94a 100644
--- a/winbuild/README.md
+++ b/winbuild/README.md
@@ -16,7 +16,7 @@ For more extensive info, see the [Windows build instructions](build.rst).
 
 The following is a simplified version of the script used on AppVeyor:
 ```
-set PYTHON=C:\Python38\bin
+set PYTHON=C:\Python39\bin
 cd /D C:\Pillow\winbuild
 %PYTHON%\python.exe build_prepare.py -v --depends=C:\pillow-depends
 build\build_dep_all.cmd
diff --git a/winbuild/build.rst b/winbuild/build.rst
index d0be2943eb4..96b8803b477 100644
--- a/winbuild/build.rst
+++ b/winbuild/build.rst
@@ -114,7 +114,7 @@ Example
 
 The following is a simplified version of the script used on AppVeyor::
 
-    set PYTHON=C:\Python38\bin
+    set PYTHON=C:\Python39\bin
     cd /D C:\Pillow\winbuild
     %PYTHON%\python.exe build_prepare.py -v --depends C:\pillow-depends
     build\build_dep_all.cmd

From a34ac045c3cf191a55e52797263beb352c8edb2c Mon Sep 17 00:00:00 2001
From: Andrew Murray <radarhere@users.noreply.github.com>
Date: Wed, 3 Jul 2024 21:05:48 +1000
Subject: [PATCH 0785/1178] Conditionally define type hint to avoid requiring
 core

---
 src/PIL/ImageCms.py | 8 ++++----
 1 file changed, 4 insertions(+), 4 deletions(-)

diff --git a/src/PIL/ImageCms.py b/src/PIL/ImageCms.py
index ec10230f12b..ce5b6101b12 100644
--- a/src/PIL/ImageCms.py
+++ b/src/PIL/ImageCms.py
@@ -31,6 +31,10 @@
 
 try:
     from . import _imagingcms as core
+
+    _CmsProfileCompatible = Union[
+        str, SupportsRead[bytes], core.CmsProfile, "ImageCmsProfile"
+    ]
 except ImportError as ex:
     # Allow error import for doc purposes, but error out when accessing
     # anything in core.
@@ -391,10 +395,6 @@ def get_display_profile(handle: SupportsInt | None = None) -> ImageCmsProfile |
 # pyCMS compatible layer
 # --------------------------------------------------------------------.
 
-_CmsProfileCompatible = Union[
-    str, SupportsRead[bytes], core.CmsProfile, ImageCmsProfile
-]
-
 
 class PyCMSError(Exception):
     """(pyCMS) Exception class.

From 776dd63f33741f02c3f9cae50fdeaf1a82d7c7d2 Mon Sep 17 00:00:00 2001
From: Andrew Murray <radarhere@users.noreply.github.com>
Date: Thu, 4 Jul 2024 11:20:00 +1000
Subject: [PATCH 0786/1178] Update CHANGES.rst [ci skip]

---
 CHANGES.rst | 15 +++++++++++++++
 1 file changed, 15 insertions(+)

diff --git a/CHANGES.rst b/CHANGES.rst
index d071f3214bc..856458aa942 100644
--- a/CHANGES.rst
+++ b/CHANGES.rst
@@ -2,6 +2,21 @@
 Changelog (Pillow)
 ==================
 
+11.0.0 (unreleased)
+-------------------
+
+- Drop support for Python 3.8 #8183
+  [hugovk, radarhere]
+
+- Add support for Python 3.13 #8181
+  [hugovk, radarhere]
+
+- Fix incompatibility with NumPy 1.20 #8187
+  [neutrinoceros, radarhere]
+
+- Remove PSFile, PyAccess and USE_CFFI_ACCESS #8182
+  [hugovk, radarhere]
+
 10.4.0 (2024-07-01)
 -------------------
 

From 936012e861ae1458ca01b7bb3bf2f5cade7405e2 Mon Sep 17 00:00:00 2001
From: Andrew Murray <radarhere@users.noreply.github.com>
Date: Thu, 4 Jul 2024 15:13:03 +1000
Subject: [PATCH 0787/1178] Allow size argument to resize() to be a list

---
 Tests/test_image_resize.py | 6 +++---
 src/PIL/Image.py           | 3 ++-
 2 files changed, 5 insertions(+), 4 deletions(-)

diff --git a/Tests/test_image_resize.py b/Tests/test_image_resize.py
index 3ef05a25f67..c9e3045121f 100644
--- a/Tests/test_image_resize.py
+++ b/Tests/test_image_resize.py
@@ -285,14 +285,14 @@ def test_box_filter(
 
 class TestImageResize:
     def test_resize(self) -> None:
-        def resize(mode: str, size: tuple[int, int]) -> None:
+        def resize(mode: str, size: tuple[int, int] | list[int]) -> None:
             out = hopper(mode).resize(size)
             assert out.mode == mode
-            assert out.size == size
+            assert out.size == tuple(size)
 
         for mode in "1", "P", "L", "RGB", "I", "F":
             resize(mode, (112, 103))
-            resize(mode, (188, 214))
+            resize(mode, [188, 214])
 
         # Test unknown resampling filter
         with hopper() as im:
diff --git a/src/PIL/Image.py b/src/PIL/Image.py
index b4ef62510ed..3c7a3735c95 100644
--- a/src/PIL/Image.py
+++ b/src/PIL/Image.py
@@ -2203,7 +2203,7 @@ def _get_safe_box(self, size, resample, box):
 
     def resize(
         self,
-        size: tuple[int, int],
+        size: tuple[int, int] | list[int],
         resample: int | None = None,
         box: tuple[float, float, float, float] | None = None,
         reducing_gap: float | None = None,
@@ -2276,6 +2276,7 @@ def resize(
         if box is None:
             box = (0, 0) + self.size
 
+        size = tuple(size)
         if self.size == size and box == (0, 0) + self.size:
             return self.copy()
 

From 6990fc4a0996753c5faa6cc272b753cac23cffdf Mon Sep 17 00:00:00 2001
From: Andrew Murray <radarhere@users.noreply.github.com>
Date: Thu, 4 Jul 2024 15:25:35 +1000
Subject: [PATCH 0788/1178] Allow size argument to resize() to be a NumPy array

---
 Tests/test_numpy.py | 9 +++++++++
 src/PIL/Image.py    | 6 +++---
 2 files changed, 12 insertions(+), 3 deletions(-)

diff --git a/Tests/test_numpy.py b/Tests/test_numpy.py
index a082e5a4d69..312e32e0ca7 100644
--- a/Tests/test_numpy.py
+++ b/Tests/test_numpy.py
@@ -198,6 +198,15 @@ def test_putdata() -> None:
     assert len(im.getdata()) == len(arr)
 
 
+def test_resize() -> None:
+    im = hopper()
+    size = (64, 64)
+
+    im_resized = im.resize(numpy.array(size))
+
+    assert im_resized.size == size
+
+
 @pytest.mark.parametrize(
     "dtype",
     (
diff --git a/src/PIL/Image.py b/src/PIL/Image.py
index 3c7a3735c95..8e595eedf76 100644
--- a/src/PIL/Image.py
+++ b/src/PIL/Image.py
@@ -63,7 +63,6 @@
 )
 from ._binary import i32le, o32be, o32le
 from ._deprecate import deprecate
-from ._typing import StrOrBytesPath, TypeGuard
 from ._util import DeferredError, is_path
 
 ElementTree: ModuleType | None
@@ -220,6 +219,7 @@ class Quantize(IntEnum):
 
 if TYPE_CHECKING:
     from . import ImageFile, ImagePalette
+    from ._typing import NumpyArray, StrOrBytesPath, TypeGuard
 ID: list[str] = []
 OPEN: dict[
     str,
@@ -2203,7 +2203,7 @@ def _get_safe_box(self, size, resample, box):
 
     def resize(
         self,
-        size: tuple[int, int] | list[int],
+        size: tuple[int, int] | list[int] | NumpyArray,
         resample: int | None = None,
         box: tuple[float, float, float, float] | None = None,
         reducing_gap: float | None = None,
@@ -2211,7 +2211,7 @@ def resize(
         """
         Returns a resized copy of this image.
 
-        :param size: The requested size in pixels, as a 2-tuple:
+        :param size: The requested size in pixels, as a tuple or array:
            (width, height).
         :param resample: An optional resampling filter.  This can be
            one of :py:data:`Resampling.NEAREST`, :py:data:`Resampling.BOX`,

From d4f1d252efa5e2ca54b2d43eaa92880cdf4ad8dc Mon Sep 17 00:00:00 2001
From: Hugo van Kemenade <1324225+hugovk@users.noreply.github.com>
Date: Thu, 4 Jul 2024 15:45:58 +0300
Subject: [PATCH 0789/1178] Test 3.13 free-threaded build on CI

---
 .ci/install.sh             |  6 ++++--
 .github/workflows/test.yml | 10 ++++++++++
 2 files changed, 14 insertions(+), 2 deletions(-)

diff --git a/.ci/install.sh b/.ci/install.sh
index 1eb098be9c1..0dc738ed805 100755
--- a/.ci/install.sh
+++ b/.ci/install.sh
@@ -37,12 +37,14 @@ python3 -m pip install -U pytest-timeout
 python3 -m pip install pyroma
 
 if [[ $(uname) != CYGWIN* ]]; then
-    python3 -m pip install numpy
+    # TODO Update condition when NumPy supports free-threading
+    if ! [[ "$GHA_PYTHON_VERSION" == "3.13-dev" ]]; then python3 -m pip install numpy ; fi
 
     # PyQt6 doesn't support PyPy3
     if [[ $GHA_PYTHON_VERSION == 3.* ]]; then
         sudo apt-get -qq install libegl1 libxcb-cursor0 libxcb-icccm4 libxcb-image0 libxcb-keysyms1 libxcb-randr0 libxcb-render-util0 libxcb-shape0 libxkbcommon-x11-0
-        python3 -m pip install pyqt6
+        # TODO Update condition when pyqt6 supports free-threading
+        if ! [[ "$GHA_PYTHON_VERSION" == "3.13-dev" ]]; then python3 -m pip install pyqt6 ; fi
     fi
 
     # Pyroma uses non-isolated build and fails with old setuptools
diff --git a/.github/workflows/test.yml b/.github/workflows/test.yml
index 0972459b0fb..75165909c10 100644
--- a/.github/workflows/test.yml
+++ b/.github/workflows/test.yml
@@ -55,6 +55,8 @@ jobs:
           REVERSE: "--reverse"
         - python-version: "3.10"
           PYTHONOPTIMIZE: 2
+        # Free-threaded
+        - { os: "ubuntu-latest", python-version: "3.13-dev", disable-gil: true }
         # M1 only available for 3.10+
         - os: "macos-13"
           python-version: "3.9"
@@ -70,6 +72,7 @@ jobs:
 
     - name: Set up Python ${{ matrix.python-version }}
       uses: actions/setup-python@v5
+      if: "!endsWith(matrix.python-version, '-dev')"
       with:
         python-version: ${{ matrix.python-version }}
         allow-prereleases: true
@@ -78,6 +81,13 @@ jobs:
           ".ci/*.sh"
           "pyproject.toml"
 
+    - name: Set up Python ${{ matrix.python-version }} (free-threaded)
+      uses: deadsnakes/action@v3.1.0
+      if: endsWith(matrix.python-version, '-dev')
+      with:
+        python-version: ${{ matrix.python-version }}
+        nogil: ${{ matrix.disable-gil }}
+
     - name: Build system information
       run: python3 .github/workflows/system-info.py
 

From e76c31b67db5e1cdfe28b593862bbe2d83a81e23 Mon Sep 17 00:00:00 2001
From: Hugo van Kemenade <1324225+hugovk@users.noreply.github.com>
Date: Thu, 4 Jul 2024 15:46:46 +0300
Subject: [PATCH 0790/1178] Refactor to single line for readability

---
 .github/workflows/test.yml | 13 ++++---------
 1 file changed, 4 insertions(+), 9 deletions(-)

diff --git a/.github/workflows/test.yml b/.github/workflows/test.yml
index 75165909c10..d858dcfff6e 100644
--- a/.github/workflows/test.yml
+++ b/.github/workflows/test.yml
@@ -50,19 +50,14 @@ jobs:
           "3.9",
         ]
         include:
-        - python-version: "3.11"
-          PYTHONOPTIMIZE: 1
-          REVERSE: "--reverse"
-        - python-version: "3.10"
-          PYTHONOPTIMIZE: 2
+        - { python-version: "3.11", PYTHONOPTIMIZE: 1, REVERSE: "--reverse" }
+        - { python-version: "3.10", PYTHONOPTIMIZE: 2 }
         # Free-threaded
         - { os: "ubuntu-latest", python-version: "3.13-dev", disable-gil: true }
         # M1 only available for 3.10+
-        - os: "macos-13"
-          python-version: "3.9"
+        - { os: "macos-13", python-version: "3.9" }
         exclude:
-        - os: "macos-14"
-          python-version: "3.9"
+        - { os: "macos-14", python-version: "3.9" }
 
     runs-on: ${{ matrix.os }}
     name: ${{ matrix.os }} Python ${{ matrix.python-version }}

From 701539d017356d8624fba6a6efc97b8e2ebf75e2 Mon Sep 17 00:00:00 2001
From: Hugo van Kemenade <1324225+hugovk@users.noreply.github.com>
Date: Fri, 5 Jul 2024 00:38:50 +0300
Subject: [PATCH 0791/1178] Add PYTHON_GIL=0 env var to keep GIL disabled

---
 .github/workflows/test.yml | 5 +++++
 1 file changed, 5 insertions(+)

diff --git a/.github/workflows/test.yml b/.github/workflows/test.yml
index d858dcfff6e..fc8be6ced33 100644
--- a/.github/workflows/test.yml
+++ b/.github/workflows/test.yml
@@ -83,6 +83,11 @@ jobs:
         python-version: ${{ matrix.python-version }}
         nogil: ${{ matrix.disable-gil }}
 
+    - name: Set PYTHON_GIL
+      if: "${{ matrix.disable-gil }}"
+      run: |
+        echo "PYTHON_GIL=0" >> $GITHUB_ENV
+
     - name: Build system information
       run: python3 .github/workflows/system-info.py
 

From 2d2889e6178ab619bae30952f4d477ac66352dea Mon Sep 17 00:00:00 2001
From: Hugo van Kemenade <1324225+hugovk@users.noreply.github.com>
Date: Fri, 5 Jul 2024 00:49:27 +0300
Subject: [PATCH 0792/1178] Install nightly NumPy for free-threaded

---
 .ci/install.sh | 6 +++++-
 1 file changed, 5 insertions(+), 1 deletion(-)

diff --git a/.ci/install.sh b/.ci/install.sh
index 0dc738ed805..e1274f41cc2 100755
--- a/.ci/install.sh
+++ b/.ci/install.sh
@@ -38,7 +38,11 @@ python3 -m pip install pyroma
 
 if [[ $(uname) != CYGWIN* ]]; then
     # TODO Update condition when NumPy supports free-threading
-    if ! [[ "$GHA_PYTHON_VERSION" == "3.13-dev" ]]; then python3 -m pip install numpy ; fi
+    if [[ "$GHA_PYTHON_VERSION" == "3.13-dev" ]]; then
+        python3 -m pip install numpy --index-url https://pypi.anaconda.org/scientific-python-nightly-wheels/simple
+    else
+        python3 -m pip install numpy
+    fi
 
     # PyQt6 doesn't support PyPy3
     if [[ $GHA_PYTHON_VERSION == 3.* ]]; then

From 7e1a6be76789a59760c5f3d87bdab7e736918b88 Mon Sep 17 00:00:00 2001
From: Andrew Murray <3112309+radarhere@users.noreply.github.com>
Date: Fri, 5 Jul 2024 20:05:59 +1000
Subject: [PATCH 0793/1178] Updated macOS tested Pillow versions (#8202)

Co-authored-by: Andrew Murray <radarhere@users.noreply.github.com>
---
 docs/installation/platform-support.rst | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/docs/installation/platform-support.rst b/docs/installation/platform-support.rst
index 1d449a03655..f2ef9cacb13 100644
--- a/docs/installation/platform-support.rst
+++ b/docs/installation/platform-support.rst
@@ -75,7 +75,7 @@ These platforms have been reported to work at the versions mentioned.
 | Operating system                 | | Tested Python            | | Latest tested  | | Tested     |
 |                                  | | versions                 | | Pillow version | | processors |
 +==================================+============================+==================+==============+
-| macOS 14 Sonoma                  | 3.8, 3.9, 3.10, 3.11, 3.12 | 10.3.0           |arm           |
+| macOS 14 Sonoma                  | 3.8, 3.9, 3.10, 3.11, 3.12 | 10.4.0           |arm           |
 +----------------------------------+----------------------------+------------------+--------------+
 | macOS 13 Ventura                 | 3.8, 3.9, 3.10, 3.11       | 10.0.1           |arm           |
 |                                  +----------------------------+------------------+              |

From bcecaf6addc5bd7102987ec01939b35f73ce2da4 Mon Sep 17 00:00:00 2001
From: Andrew Murray <radarhere@users.noreply.github.com>
Date: Sat, 6 Jul 2024 02:08:37 +1000
Subject: [PATCH 0794/1178] Group aarch64 jobs

---
 .github/workflows/wheels.yml | 7 ++-----
 1 file changed, 2 insertions(+), 5 deletions(-)

diff --git a/.github/workflows/wheels.yml b/.github/workflows/wheels.yml
index 4eb907bcd9f..f8dff3a3e77 100644
--- a/.github/workflows/wheels.yml
+++ b/.github/workflows/wheels.yml
@@ -41,11 +41,8 @@ jobs:
         python-version:
           - pp39
           - pp310
-          - cp39
-          - cp310
-          - cp311
-          - cp312
-          - cp313
+          - cp3{9,10,11}
+          - cp3{12,13}
         spec:
           - manylinux2014
           - manylinux_2_28

From dcd833280538d8cd00b3c2a4617b534efdfa4ff0 Mon Sep 17 00:00:00 2001
From: Hugo van Kemenade <1324225+hugovk@users.noreply.github.com>
Date: Fri, 5 Jul 2024 19:36:58 +0300
Subject: [PATCH 0795/1178] Include 'free-threading' in job name

---
 .github/workflows/test.yml | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/.github/workflows/test.yml b/.github/workflows/test.yml
index fc8be6ced33..70284181417 100644
--- a/.github/workflows/test.yml
+++ b/.github/workflows/test.yml
@@ -60,7 +60,7 @@ jobs:
         - { os: "macos-14", python-version: "3.9" }
 
     runs-on: ${{ matrix.os }}
-    name: ${{ matrix.os }} Python ${{ matrix.python-version }}
+    name: ${{ matrix.os }} Python ${{ matrix.python-version }} ${{ matrix.disable-gil && 'free-threaded' || '' }}
 
     steps:
     - uses: actions/checkout@v4

From f3c3e527973bd5a579f15b3d7ed6ee8f51dfd3e4 Mon Sep 17 00:00:00 2001
From: Andrew Murray <3112309+radarhere@users.noreply.github.com>
Date: Sat, 6 Jul 2024 03:55:23 +1000
Subject: [PATCH 0796/1178] Added type hints (#8204)

Co-authored-by: Andrew Murray <radarhere@users.noreply.github.com>
---
 Tests/test_imageshow.py      |  7 +++--
 src/PIL/EpsImagePlugin.py    |  6 ++--
 src/PIL/FliImagePlugin.py    | 11 ++++----
 src/PIL/FpxImagePlugin.py    |  2 +-
 src/PIL/GbrImagePlugin.py    |  2 +-
 src/PIL/IcnsImagePlugin.py   | 54 ++++++++++++++++++++++--------------
 src/PIL/IcoImagePlugin.py    | 11 ++++----
 src/PIL/Image.py             |  4 +--
 src/PIL/ImageShow.py         |  9 ++----
 src/PIL/IptcImagePlugin.py   |  3 +-
 src/PIL/Jpeg2KImagePlugin.py |  2 +-
 src/PIL/TiffImagePlugin.py   |  2 +-
 src/PIL/WalImageFile.py      |  2 +-
 src/PIL/WebPImagePlugin.py   |  2 +-
 14 files changed, 67 insertions(+), 50 deletions(-)

diff --git a/Tests/test_imageshow.py b/Tests/test_imageshow.py
index 0bff4389607..a4f7e5cc5b4 100644
--- a/Tests/test_imageshow.py
+++ b/Tests/test_imageshow.py
@@ -16,8 +16,11 @@ def test_sanity() -> None:
 
 
 def test_register() -> None:
-    # Test registering a viewer that is not a class
-    ImageShow.register("not a class")
+    # Test registering a viewer that is an instance
+    class TestViewer(ImageShow.Viewer):
+        pass
+
+    ImageShow.register(TestViewer())
 
     # Restore original state
     ImageShow._viewers.pop()
diff --git a/src/PIL/EpsImagePlugin.py b/src/PIL/EpsImagePlugin.py
index 71e86904548..59bb8594d1c 100644
--- a/src/PIL/EpsImagePlugin.py
+++ b/src/PIL/EpsImagePlugin.py
@@ -338,7 +338,7 @@ def _read_comment(s: str) -> bool:
             msg = "cannot determine EPS bounding box"
             raise OSError(msg)
 
-    def _find_offset(self, fp):
+    def _find_offset(self, fp: IO[bytes]) -> tuple[int, int]:
         s = fp.read(4)
 
         if s == b"%!PS":
@@ -361,7 +361,9 @@ def _find_offset(self, fp):
 
         return length, offset
 
-    def load(self, scale=1, transparency=False):
+    def load(
+        self, scale: int = 1, transparency: bool = False
+    ) -> Image.core.PixelAccess | None:
         # Load EPS via Ghostscript
         if self.tile:
             self.im = Ghostscript(self.tile, self.size, self.fp, scale, transparency)
diff --git a/src/PIL/FliImagePlugin.py b/src/PIL/FliImagePlugin.py
index dceb839279a..52d1fce3167 100644
--- a/src/PIL/FliImagePlugin.py
+++ b/src/PIL/FliImagePlugin.py
@@ -45,7 +45,7 @@ class FliImageFile(ImageFile.ImageFile):
     format_description = "Autodesk FLI/FLC Animation"
     _close_exclusive_fp_after_loading = False
 
-    def _open(self):
+    def _open(self) -> None:
         # HEAD
         s = self.fp.read(128)
         if not (_accept(s) and s[20:22] == b"\x00\x00"):
@@ -83,7 +83,7 @@ def _open(self):
         if i16(s, 4) == 0xF1FA:
             # look for palette chunk
             number_of_subchunks = i16(s, 6)
-            chunk_size = None
+            chunk_size: int | None = None
             for _ in range(number_of_subchunks):
                 if chunk_size is not None:
                     self.fp.seek(chunk_size - 6, os.SEEK_CUR)
@@ -96,8 +96,9 @@ def _open(self):
                 if not chunk_size:
                     break
 
-        palette = [o8(r) + o8(g) + o8(b) for (r, g, b) in palette]
-        self.palette = ImagePalette.raw("RGB", b"".join(palette))
+        self.palette = ImagePalette.raw(
+            "RGB", b"".join(o8(r) + o8(g) + o8(b) for (r, g, b) in palette)
+        )
 
         # set things up to decode first frame
         self.__frame = -1
@@ -105,7 +106,7 @@ def _open(self):
         self.__rewind = self.fp.tell()
         self.seek(0)
 
-    def _palette(self, palette, shift):
+    def _palette(self, palette: list[tuple[int, int, int]], shift: int) -> None:
         # load palette
 
         i = 0
diff --git a/src/PIL/FpxImagePlugin.py b/src/PIL/FpxImagePlugin.py
index 93eef48d25c..386e37233b7 100644
--- a/src/PIL/FpxImagePlugin.py
+++ b/src/PIL/FpxImagePlugin.py
@@ -231,7 +231,7 @@ def _open_subimage(self, index: int = 1, subimage: int = 0) -> None:
         self._fp = self.fp
         self.fp = None
 
-    def load(self):
+    def load(self) -> Image.core.PixelAccess | None:
         if not self.fp:
             self.fp = self.ole.openstream(self.stream[:2] + ["Subimage 0000 Data"])
 
diff --git a/src/PIL/GbrImagePlugin.py b/src/PIL/GbrImagePlugin.py
index 93e89b1e655..3c8feea5ffb 100644
--- a/src/PIL/GbrImagePlugin.py
+++ b/src/PIL/GbrImagePlugin.py
@@ -88,7 +88,7 @@ def _open(self) -> None:
         # Data is an uncompressed block of w * h * bytes/pixel
         self._data_size = width * height * color_depth
 
-    def load(self):
+    def load(self) -> Image.core.PixelAccess | None:
         if not self.im:
             self.im = Image.core.new(self.mode, self.size)
             self.frombytes(self.fp.read(self._data_size))
diff --git a/src/PIL/IcnsImagePlugin.py b/src/PIL/IcnsImagePlugin.py
index 2a89d498cbf..8729f76431d 100644
--- a/src/PIL/IcnsImagePlugin.py
+++ b/src/PIL/IcnsImagePlugin.py
@@ -34,11 +34,13 @@
 HEADERSIZE = 8
 
 
-def nextheader(fobj):
+def nextheader(fobj: IO[bytes]) -> tuple[bytes, int]:
     return struct.unpack(">4sI", fobj.read(HEADERSIZE))
 
 
-def read_32t(fobj, start_length, size):
+def read_32t(
+    fobj: IO[bytes], start_length: tuple[int, int], size: tuple[int, int, int]
+) -> dict[str, Image.Image]:
     # The 128x128 icon seems to have an extra header for some reason.
     (start, length) = start_length
     fobj.seek(start)
@@ -49,7 +51,9 @@ def read_32t(fobj, start_length, size):
     return read_32(fobj, (start + 4, length - 4), size)
 
 
-def read_32(fobj, start_length, size):
+def read_32(
+    fobj: IO[bytes], start_length: tuple[int, int], size: tuple[int, int, int]
+) -> dict[str, Image.Image]:
     """
     Read a 32bit RGB icon resource.  Seems to be either uncompressed or
     an RLE packbits-like scheme.
@@ -72,14 +76,14 @@ def read_32(fobj, start_length, size):
                 byte = fobj.read(1)
                 if not byte:
                     break
-                byte = byte[0]
-                if byte & 0x80:
-                    blocksize = byte - 125
+                byte_int = byte[0]
+                if byte_int & 0x80:
+                    blocksize = byte_int - 125
                     byte = fobj.read(1)
                     for i in range(blocksize):
                         data.append(byte)
                 else:
-                    blocksize = byte + 1
+                    blocksize = byte_int + 1
                     data.append(fobj.read(blocksize))
                 bytesleft -= blocksize
                 if bytesleft <= 0:
@@ -92,7 +96,9 @@ def read_32(fobj, start_length, size):
     return {"RGB": im}
 
 
-def read_mk(fobj, start_length, size):
+def read_mk(
+    fobj: IO[bytes], start_length: tuple[int, int], size: tuple[int, int, int]
+) -> dict[str, Image.Image]:
     # Alpha masks seem to be uncompressed
     start = start_length[0]
     fobj.seek(start)
@@ -102,10 +108,14 @@ def read_mk(fobj, start_length, size):
     return {"A": band}
 
 
-def read_png_or_jpeg2000(fobj, start_length, size):
+def read_png_or_jpeg2000(
+    fobj: IO[bytes], start_length: tuple[int, int], size: tuple[int, int, int]
+) -> dict[str, Image.Image]:
     (start, length) = start_length
     fobj.seek(start)
     sig = fobj.read(12)
+
+    im: Image.Image
     if sig[:8] == b"\x89PNG\x0d\x0a\x1a\x0a":
         fobj.seek(start)
         im = PngImagePlugin.PngImageFile(fobj)
@@ -164,12 +174,12 @@ class IcnsFile:
         ],
     }
 
-    def __init__(self, fobj):
+    def __init__(self, fobj: IO[bytes]) -> None:
         """
         fobj is a file-like object as an icns resource
         """
         # signature : (start, length)
-        self.dct = dct = {}
+        self.dct = {}
         self.fobj = fobj
         sig, filesize = nextheader(fobj)
         if not _accept(sig):
@@ -183,11 +193,11 @@ def __init__(self, fobj):
                 raise SyntaxError(msg)
             i += HEADERSIZE
             blocksize -= HEADERSIZE
-            dct[sig] = (i, blocksize)
+            self.dct[sig] = (i, blocksize)
             fobj.seek(blocksize, io.SEEK_CUR)
             i += blocksize
 
-    def itersizes(self):
+    def itersizes(self) -> list[tuple[int, int, int]]:
         sizes = []
         for size, fmts in self.SIZES.items():
             for fmt, reader in fmts:
@@ -196,14 +206,14 @@ def itersizes(self):
                     break
         return sizes
 
-    def bestsize(self):
+    def bestsize(self) -> tuple[int, int, int]:
         sizes = self.itersizes()
         if not sizes:
             msg = "No 32bit icon resources found"
             raise SyntaxError(msg)
         return max(sizes)
 
-    def dataforsize(self, size):
+    def dataforsize(self, size: tuple[int, int, int]) -> dict[str, Image.Image]:
         """
         Get an icon resource as {channel: array}.  Note that
         the arrays are bottom-up like windows bitmaps and will likely
@@ -216,18 +226,20 @@ def dataforsize(self, size):
                 dct.update(reader(self.fobj, desc, size))
         return dct
 
-    def getimage(self, size=None):
+    def getimage(
+        self, size: tuple[int, int] | tuple[int, int, int] | None = None
+    ) -> Image.Image:
         if size is None:
             size = self.bestsize()
-        if len(size) == 2:
+        elif len(size) == 2:
             size = (size[0], size[1], 1)
         channels = self.dataforsize(size)
 
-        im = channels.get("RGBA", None)
+        im = channels.get("RGBA")
         if im:
             return im
 
-        im = channels.get("RGB").copy()
+        im = channels["RGB"].copy()
         try:
             im.putalpha(channels["A"])
         except KeyError:
@@ -268,7 +280,7 @@ def size(self):
         return self._size
 
     @size.setter
-    def size(self, value):
+    def size(self, value) -> None:
         info_size = value
         if info_size not in self.info["sizes"] and len(info_size) == 2:
             info_size = (info_size[0], info_size[1], 1)
@@ -287,7 +299,7 @@ def size(self, value):
             raise ValueError(msg)
         self._size = value
 
-    def load(self):
+    def load(self) -> Image.core.PixelAccess | None:
         if len(self.size) == 3:
             self.best_size = self.size
             self.size = (
diff --git a/src/PIL/IcoImagePlugin.py b/src/PIL/IcoImagePlugin.py
index 086c87b1af2..650f5e4f1dc 100644
--- a/src/PIL/IcoImagePlugin.py
+++ b/src/PIL/IcoImagePlugin.py
@@ -120,7 +120,7 @@ def _accept(prefix: bytes) -> bool:
 
 
 class IcoFile:
-    def __init__(self, buf):
+    def __init__(self, buf) -> None:
         """
         Parse image from file-like object containing ico file data
         """
@@ -177,19 +177,19 @@ def __init__(self, buf):
         # ICO images are usually squares
         self.entry = sorted(self.entry, key=lambda x: x["square"], reverse=True)
 
-    def sizes(self):
+    def sizes(self) -> set[tuple[int, int]]:
         """
         Get a list of all available icon sizes and color depths.
         """
         return {(h["width"], h["height"]) for h in self.entry}
 
-    def getentryindex(self, size, bpp=False):
+    def getentryindex(self, size: tuple[int, int], bpp: int | bool = False) -> int:
         for i, h in enumerate(self.entry):
             if size == h["dim"] and (bpp is False or bpp == h["color_depth"]):
                 return i
         return 0
 
-    def getimage(self, size, bpp=False):
+    def getimage(self, size: tuple[int, int], bpp: int | bool = False) -> Image.Image:
         """
         Get an image from the icon
         """
@@ -321,7 +321,7 @@ def size(self, value):
             raise ValueError(msg)
         self._size = value
 
-    def load(self):
+    def load(self) -> Image.core.PixelAccess | None:
         if self.im is not None and self.im.size == self.size:
             # Already loaded
             return Image.Image.load(self)
@@ -341,6 +341,7 @@ def load(self):
             self.info["sizes"] = set(sizes)
 
             self.size = im.size
+        return None
 
     def load_seek(self, pos: int) -> None:
         # Flag the ImageFile.Parser so that it
diff --git a/src/PIL/Image.py b/src/PIL/Image.py
index b4ef62510ed..c9bb008b0d9 100644
--- a/src/PIL/Image.py
+++ b/src/PIL/Image.py
@@ -1395,7 +1395,7 @@ def getbbox(self, *, alpha_only: bool = True) -> tuple[int, int, int, int] | Non
 
     def getcolors(
         self, maxcolors: int = 256
-    ) -> list[tuple[int, int]] | list[tuple[int, float]] | None:
+    ) -> list[tuple[int, tuple[int, ...]]] | list[tuple[int, float]] | None:
         """
         Returns a list of colors used in this image.
 
@@ -1412,7 +1412,7 @@ def getcolors(
         self.load()
         if self.mode in ("1", "L", "P"):
             h = self.im.histogram()
-            out = [(h[i], i) for i in range(256) if h[i]]
+            out: list[tuple[int, float]] = [(h[i], i) for i in range(256) if h[i]]
             if len(out) > maxcolors:
                 return None
             return out
diff --git a/src/PIL/ImageShow.py b/src/PIL/ImageShow.py
index 037d6f492ce..d62893d9c8b 100644
--- a/src/PIL/ImageShow.py
+++ b/src/PIL/ImageShow.py
@@ -26,7 +26,7 @@
 _viewers = []
 
 
-def register(viewer, order: int = 1) -> None:
+def register(viewer: type[Viewer] | Viewer, order: int = 1) -> None:
     """
     The :py:func:`register` function is used to register additional viewers::
 
@@ -40,11 +40,8 @@ def register(viewer, order: int = 1) -> None:
         Zero or a negative integer to prepend this viewer to the list,
         a positive integer to append it.
     """
-    try:
-        if issubclass(viewer, Viewer):
-            viewer = viewer()
-    except TypeError:
-        pass  # raised if viewer wasn't a class
+    if isinstance(viewer, type) and issubclass(viewer, Viewer):
+        viewer = viewer()
     if order > 0:
         _viewers.append(viewer)
     else:
diff --git a/src/PIL/IptcImagePlugin.py b/src/PIL/IptcImagePlugin.py
index f9d5b75f0f9..a04616fbd64 100644
--- a/src/PIL/IptcImagePlugin.py
+++ b/src/PIL/IptcImagePlugin.py
@@ -148,7 +148,7 @@ def _open(self) -> None:
         if tag == (8, 10):
             self.tile = [("iptc", (0, 0) + self.size, offset, compression)]
 
-    def load(self):
+    def load(self) -> Image.core.PixelAccess | None:
         if len(self.tile) != 1 or self.tile[0][0] != "iptc":
             return ImageFile.ImageFile.load(self)
 
@@ -176,6 +176,7 @@ def load(self):
         with Image.open(o) as _im:
             _im.load()
             self.im = _im.im
+        return None
 
 
 Image.register_open(IptcImageFile.format, IptcImageFile)
diff --git a/src/PIL/Jpeg2KImagePlugin.py b/src/PIL/Jpeg2KImagePlugin.py
index c8a57567aa6..992b9ccaf31 100644
--- a/src/PIL/Jpeg2KImagePlugin.py
+++ b/src/PIL/Jpeg2KImagePlugin.py
@@ -299,7 +299,7 @@ def reduce(self):
     def reduce(self, value):
         self._reduce = value
 
-    def load(self):
+    def load(self) -> Image.core.PixelAccess | None:
         if self.tile and self._reduce:
             power = 1 << self._reduce
             adjust = power >> 1
diff --git a/src/PIL/TiffImagePlugin.py b/src/PIL/TiffImagePlugin.py
index ac5b63c1bc4..b89144803a5 100644
--- a/src/PIL/TiffImagePlugin.py
+++ b/src/PIL/TiffImagePlugin.py
@@ -1232,7 +1232,7 @@ def get_photoshop_blocks(self):
                 val = val[math.ceil((10 + n + size) / 2) * 2 :]
         return blocks
 
-    def load(self):
+    def load(self) -> Image.core.PixelAccess | None:
         if self.tile and self.use_load_libtiff:
             return self._load_libtiff()
         return super().load()
diff --git a/src/PIL/WalImageFile.py b/src/PIL/WalImageFile.py
index fbd7be6ed5c..895d5616a87 100644
--- a/src/PIL/WalImageFile.py
+++ b/src/PIL/WalImageFile.py
@@ -50,7 +50,7 @@ def _open(self) -> None:
         if next_name:
             self.info["next_name"] = next_name
 
-    def load(self):
+    def load(self) -> Image.core.PixelAccess | None:
         if not self.im:
             self.im = Image.core.new(self.mode, self.size)
             self.frombytes(self.fp.read(self.size[0] * self.size[1]))
diff --git a/src/PIL/WebPImagePlugin.py b/src/PIL/WebPImagePlugin.py
index 59be5bf9d31..530b88c8bd6 100644
--- a/src/PIL/WebPImagePlugin.py
+++ b/src/PIL/WebPImagePlugin.py
@@ -144,7 +144,7 @@ def _seek(self, frame: int) -> None:
         while self.__physical_frame < frame:
             self._get_next()  # Advance to the requested frame
 
-    def load(self):
+    def load(self) -> Image.core.PixelAccess | None:
         if _webp.HAVE_WEBPANIM:
             if self.__loaded != self.__logical_frame:
                 self._seek(self.__logical_frame)

From 4aa24f88d9a066318b75f0ad4bf69240d595ffb6 Mon Sep 17 00:00:00 2001
From: Andrew Murray <3112309+radarhere@users.noreply.github.com>
Date: Sat, 6 Jul 2024 03:56:24 +1000
Subject: [PATCH 0797/1178] Added type hints to tests (#8203)

Co-authored-by: Andrew Murray <radarhere@users.noreply.github.com>
---
 Tests/helper.py                  |  4 +--
 Tests/test_file_libtiff.py       |  6 +++-
 Tests/test_file_webp_animated.py |  5 +++-
 Tests/test_image.py              |  9 ++++--
 Tests/test_image_access.py       | 24 ++++++++++------
 Tests/test_image_convert.py      |  2 +-
 Tests/test_image_getcolors.py    |  4 +++
 Tests/test_image_putdata.py      |  2 +-
 Tests/test_image_quantize.py     | 12 ++++++--
 Tests/test_image_resample.py     | 20 +++++++++-----
 Tests/test_image_transform.py    |  5 ++--
 Tests/test_imagechops.py         | 32 ++++++++++++----------
 Tests/test_imagecms.py           |  4 ++-
 Tests/test_imagedraw.py          | 31 +++++++++++++++++----
 Tests/test_imagefile.py          |  2 +-
 Tests/test_imagemorph.py         | 14 ++++++----
 Tests/test_imageops.py           | 47 +++++++++++++++++++++++---------
 Tests/test_imagetk.py            |  2 ++
 Tests/test_tiff_ifdrational.py   |  6 +++-
 19 files changed, 159 insertions(+), 72 deletions(-)

diff --git a/Tests/helper.py b/Tests/helper.py
index 7abc495b6ea..d6a93a8030b 100644
--- a/Tests/helper.py
+++ b/Tests/helper.py
@@ -60,9 +60,7 @@ def convert_to_comparable(
     return new_a, new_b
 
 
-def assert_deep_equal(
-    a: Sequence[Any], b: Sequence[Any], msg: str | None = None
-) -> None:
+def assert_deep_equal(a: Any, b: Any, msg: str | None = None) -> None:
     try:
         assert len(a) == len(b), msg or f"got length {len(a)}, expected {len(b)}"
     except Exception:
diff --git a/Tests/test_file_libtiff.py b/Tests/test_file_libtiff.py
index f491f9875d9..8707311dc8c 100644
--- a/Tests/test_file_libtiff.py
+++ b/Tests/test_file_libtiff.py
@@ -1048,7 +1048,11 @@ def test_open_missing_samplesperpixel(self) -> None:
         ],
     )
     def test_wrong_bits_per_sample(
-        self, file_name: str, mode: str, size: tuple[int, int], tile
+        self,
+        file_name: str,
+        mode: str,
+        size: tuple[int, int],
+        tile: list[tuple[str, tuple[int, int, int, int], int, tuple[Any, ...]]],
     ) -> None:
         with Image.open("Tests/images/" + file_name) as im:
             assert im.mode == mode
diff --git a/Tests/test_file_webp_animated.py b/Tests/test_file_webp_animated.py
index 882dccb32f9..e0d7999e323 100644
--- a/Tests/test_file_webp_animated.py
+++ b/Tests/test_file_webp_animated.py
@@ -1,5 +1,6 @@
 from __future__ import annotations
 
+from collections.abc import Generator
 from pathlib import Path
 
 import pytest
@@ -96,7 +97,9 @@ def check(temp_file: str) -> None:
             check(temp_file1)
 
             # Tests appending using a generator
-            def im_generator(ims):
+            def im_generator(
+                ims: list[Image.Image],
+            ) -> Generator[Image.Image, None, None]:
                 yield from ims
 
             temp_file2 = str(tmp_path / "temp_generator.webp")
diff --git a/Tests/test_image.py b/Tests/test_image.py
index 07161fcfabc..8e6f63face6 100644
--- a/Tests/test_image.py
+++ b/Tests/test_image.py
@@ -372,8 +372,9 @@ def test_alpha_composite(self) -> None:
         img = Image.alpha_composite(dst, src)
 
         # Assert
-        img_colors = sorted(img.getcolors())
-        assert img_colors == expected_colors
+        img_colors = img.getcolors()
+        assert img_colors is not None
+        assert sorted(img_colors) == expected_colors
 
     def test_alpha_inplace(self) -> None:
         src = Image.new("RGBA", (128, 128), "blue")
@@ -670,7 +671,9 @@ def test_remap_palette_transparency(self) -> None:
 
         im_remapped = im.remap_palette([1, 0])
         assert im_remapped.info["transparency"] == 1
-        assert len(im_remapped.getpalette()) == 6
+        palette = im_remapped.getpalette()
+        assert palette is not None
+        assert len(palette) == 6
 
         # Test unused transparency
         im.info["transparency"] = 2
diff --git a/Tests/test_image_access.py b/Tests/test_image_access.py
index c860771dc37..854c79daed2 100644
--- a/Tests/test_image_access.py
+++ b/Tests/test_image_access.py
@@ -27,7 +27,9 @@ def test_sanity(self) -> None:
         for y in range(im1.size[1]):
             for x in range(im1.size[0]):
                 pos = x, y
-                im2.putpixel(pos, im1.getpixel(pos))
+                value = im1.getpixel(pos)
+                assert value is not None
+                im2.putpixel(pos, value)
 
         assert_image_equal(im1, im2)
 
@@ -37,7 +39,9 @@ def test_sanity(self) -> None:
         for y in range(im1.size[1]):
             for x in range(im1.size[0]):
                 pos = x, y
-                im2.putpixel(pos, im1.getpixel(pos))
+                value = im1.getpixel(pos)
+                assert value is not None
+                im2.putpixel(pos, value)
 
         assert not im2.readonly
         assert_image_equal(im1, im2)
@@ -50,9 +54,9 @@ def test_sanity(self) -> None:
         assert pix1 is not None
         assert pix2 is not None
         with pytest.raises(TypeError):
-            pix1[0, "0"]
+            pix1[0, "0"]  # type: ignore[index]
         with pytest.raises(TypeError):
-            pix1["0", 0]
+            pix1["0", 0]  # type: ignore[index]
 
         for y in range(im1.size[1]):
             for x in range(im1.size[0]):
@@ -71,7 +75,9 @@ def test_sanity_negative_index(self) -> None:
         for y in range(-1, -im1.size[1] - 1, -1):
             for x in range(-1, -im1.size[0] - 1, -1):
                 pos = x, y
-                im2.putpixel(pos, im1.getpixel(pos))
+                value = im1.getpixel(pos)
+                assert value is not None
+                im2.putpixel(pos, value)
 
         assert_image_equal(im1, im2)
 
@@ -81,7 +87,9 @@ def test_sanity_negative_index(self) -> None:
         for y in range(-1, -im1.size[1] - 1, -1):
             for x in range(-1, -im1.size[0] - 1, -1):
                 pos = x, y
-                im2.putpixel(pos, im1.getpixel(pos))
+                value = im1.getpixel(pos)
+                assert value is not None
+                im2.putpixel(pos, value)
 
         assert not im2.readonly
         assert_image_equal(im1, im2)
@@ -219,7 +227,7 @@ def test_putpixel_type_error1(self, mode: str) -> None:
         im = hopper(mode)
         for v in self.INVALID_TYPES:
             with pytest.raises(TypeError, match="color must be int or tuple"):
-                im.putpixel((0, 0), v)
+                im.putpixel((0, 0), v)  # type: ignore[arg-type]
 
     @pytest.mark.parametrize(
         ("mode", "band_numbers", "match"),
@@ -253,7 +261,7 @@ def test_putpixel_type_error2(self, mode: str) -> None:
             with pytest.raises(
                 TypeError, match="color must be int or single-element tuple"
             ):
-                im.putpixel((0, 0), v)
+                im.putpixel((0, 0), v)  # type: ignore[arg-type]
 
     @pytest.mark.parametrize("mode", IMAGE_MODES1 + IMAGE_MODES2)
     def test_putpixel_overflow_error(self, mode: str) -> None:
diff --git a/Tests/test_image_convert.py b/Tests/test_image_convert.py
index 5b63ceec3fe..ebb7f282240 100644
--- a/Tests/test_image_convert.py
+++ b/Tests/test_image_convert.py
@@ -225,7 +225,7 @@ def test_l_macro_rounding(convert_mode: str) -> None:
         assert px is not None
         converted_color = px[0, 0]
         if convert_mode == "LA":
-            assert converted_color is not None
+            assert isinstance(converted_color, tuple)
             converted_color = converted_color[0]
         assert converted_color == 1
 
diff --git a/Tests/test_image_getcolors.py b/Tests/test_image_getcolors.py
index 8f8870f4fec..8dbe82b29b0 100644
--- a/Tests/test_image_getcolors.py
+++ b/Tests/test_image_getcolors.py
@@ -54,17 +54,21 @@ def test_pack() -> None:
     assert A is None
 
     A = im.getcolors(maxcolors=3)
+    assert A is not None
     A.sort()
     assert A == expected
 
     A = im.getcolors(maxcolors=4)
+    assert A is not None
     A.sort()
     assert A == expected
 
     A = im.getcolors(maxcolors=8)
+    assert A is not None
     A.sort()
     assert A == expected
 
     A = im.getcolors(maxcolors=16)
+    assert A is not None
     A.sort()
     assert A == expected
diff --git a/Tests/test_image_putdata.py b/Tests/test_image_putdata.py
index dad26ef144c..27cb7c59d89 100644
--- a/Tests/test_image_putdata.py
+++ b/Tests/test_image_putdata.py
@@ -31,7 +31,7 @@ def test_sanity() -> None:
 
 def test_long_integers() -> None:
     # see bug-200802-systemerror
-    def put(value: int) -> tuple[int, int, int, int]:
+    def put(value: int) -> float | tuple[int, ...] | None:
         im = Image.new("RGBA", (1, 1))
         im.putdata([value])
         return im.getpixel((0, 0))
diff --git a/Tests/test_image_quantize.py b/Tests/test_image_quantize.py
index 9f8aa601c6b..903cd8550b5 100644
--- a/Tests/test_image_quantize.py
+++ b/Tests/test_image_quantize.py
@@ -31,7 +31,9 @@ def test_libimagequant_quantize() -> None:
     converted = image.quantize(100, Image.Quantize.LIBIMAGEQUANT)
     assert converted.mode == "P"
     assert_image_similar(converted.convert("RGB"), image, 15)
-    assert len(converted.getcolors()) == 100
+    colors = converted.getcolors()
+    assert colors is not None
+    assert len(colors) == 100
 
 
 def test_octree_quantize() -> None:
@@ -39,7 +41,9 @@ def test_octree_quantize() -> None:
     converted = image.quantize(100, Image.Quantize.FASTOCTREE)
     assert converted.mode == "P"
     assert_image_similar(converted.convert("RGB"), image, 20)
-    assert len(converted.getcolors()) == 100
+    colors = converted.getcolors()
+    assert colors is not None
+    assert len(colors) == 100
 
 
 def test_rgba_quantize() -> None:
@@ -158,4 +162,6 @@ def test_small_palette() -> None:
     im = im.quantize(palette=p)
 
     # Assert
-    assert len(im.getcolors()) == 2
+    quantized_colors = im.getcolors()
+    assert quantized_colors is not None
+    assert len(quantized_colors) == 2
diff --git a/Tests/test_image_resample.py b/Tests/test_image_resample.py
index 92ba1553ccc..ce6209c0da4 100644
--- a/Tests/test_image_resample.py
+++ b/Tests/test_image_resample.py
@@ -237,13 +237,13 @@ def test_box_filter_correct_range(self) -> None:
 class TestCoreResampleConsistency:
     def make_case(
         self, mode: str, fill: tuple[int, int, int] | float
-    ) -> tuple[Image.Image, tuple[int, ...]]:
+    ) -> tuple[Image.Image, float | tuple[int, ...]]:
         im = Image.new(mode, (512, 9), fill)
         px = im.load()
         assert px is not None
         return im.resize((9, 512), Image.Resampling.LANCZOS), px[0, 0]
 
-    def run_case(self, case: tuple[Image.Image, int | tuple[int, ...]]) -> None:
+    def run_case(self, case: tuple[Image.Image, float | tuple[int, ...]]) -> None:
         channel, color = case
         px = channel.load()
         assert px is not None
@@ -256,6 +256,7 @@ def run_case(self, case: tuple[Image.Image, int | tuple[int, ...]]) -> None:
     def test_8u(self) -> None:
         im, color = self.make_case("RGB", (0, 64, 255))
         r, g, b = im.split()
+        assert isinstance(color, tuple)
         self.run_case((r, color[0]))
         self.run_case((g, color[1]))
         self.run_case((b, color[2]))
@@ -290,7 +291,11 @@ def run_levels_case(self, i: Image.Image) -> None:
         px = i.load()
         assert px is not None
         for y in range(i.size[1]):
-            used_colors = {px[x, y][0] for x in range(i.size[0])}
+            used_colors = set()
+            for x in range(i.size[0]):
+                value = px[x, y]
+                assert isinstance(value, tuple)
+                used_colors.add(value[0])
             assert 256 == len(used_colors), (
                 "All colors should be present in resized image. "
                 f"Only {len(used_colors)} on line {y}."
@@ -332,12 +337,13 @@ def run_dirty_case(self, i: Image.Image, clean_pixel: tuple[int, ...]) -> None:
         assert px is not None
         for y in range(i.size[1]):
             for x in range(i.size[0]):
-                if px[x, y][-1] != 0 and px[x, y][:-1] != clean_pixel:
+                value = px[x, y]
+                assert isinstance(value, tuple)
+                if value[-1] != 0 and value[:-1] != clean_pixel:
                     message = (
-                        f"pixel at ({x}, {y}) is different:\n"
-                        f"{px[x, y]}\n{clean_pixel}"
+                        f"pixel at ({x}, {y}) is different:\n{value}\n{clean_pixel}"
                     )
-                    assert px[x, y][:3] == clean_pixel, message
+                    assert value[:3] == clean_pixel, message
 
     def test_dirty_pixels_rgba(self) -> None:
         case = self.make_dirty_case("RGBA", (255, 255, 0, 128), (0, 0, 255, 0))
diff --git a/Tests/test_image_transform.py b/Tests/test_image_transform.py
index 638d1224710..7e83396def7 100644
--- a/Tests/test_image_transform.py
+++ b/Tests/test_image_transform.py
@@ -192,8 +192,9 @@ def _test_nearest(
 
         im = op(im, (40, 10))
 
-        colors = sorted(im.getcolors())
-        assert colors == sorted(
+        colors = im.getcolors()
+        assert colors is not None
+        assert sorted(colors) == sorted(
             (
                 (20 * 10, opaque),
                 (20 * 10, transparent),
diff --git a/Tests/test_imagechops.py b/Tests/test_imagechops.py
index 7e2290c156e..4fc28cdb9ee 100644
--- a/Tests/test_imagechops.py
+++ b/Tests/test_imagechops.py
@@ -391,23 +391,25 @@ def test_overlay() -> None:
 def test_logical() -> None:
     def table(
         op: Callable[[Image.Image, Image.Image], Image.Image], a: int, b: int
-    ) -> tuple[int, int, int, int]:
+    ) -> list[float]:
         out = []
         for x in (a, b):
             imx = Image.new("1", (1, 1), x)
             for y in (a, b):
                 imy = Image.new("1", (1, 1), y)
-                out.append(op(imx, imy).getpixel((0, 0)))
-        return tuple(out)
-
-    assert table(ImageChops.logical_and, 0, 1) == (0, 0, 0, 255)
-    assert table(ImageChops.logical_or, 0, 1) == (0, 255, 255, 255)
-    assert table(ImageChops.logical_xor, 0, 1) == (0, 255, 255, 0)
-
-    assert table(ImageChops.logical_and, 0, 128) == (0, 0, 0, 255)
-    assert table(ImageChops.logical_or, 0, 128) == (0, 255, 255, 255)
-    assert table(ImageChops.logical_xor, 0, 128) == (0, 255, 255, 0)
-
-    assert table(ImageChops.logical_and, 0, 255) == (0, 0, 0, 255)
-    assert table(ImageChops.logical_or, 0, 255) == (0, 255, 255, 255)
-    assert table(ImageChops.logical_xor, 0, 255) == (0, 255, 255, 0)
+                value = op(imx, imy).getpixel((0, 0))
+                assert not isinstance(value, tuple) and value is not None
+                out.append(value)
+        return out
+
+    assert table(ImageChops.logical_and, 0, 1) == [0, 0, 0, 255]
+    assert table(ImageChops.logical_or, 0, 1) == [0, 255, 255, 255]
+    assert table(ImageChops.logical_xor, 0, 1) == [0, 255, 255, 0]
+
+    assert table(ImageChops.logical_and, 0, 128) == [0, 0, 0, 255]
+    assert table(ImageChops.logical_or, 0, 128) == [0, 255, 255, 255]
+    assert table(ImageChops.logical_xor, 0, 128) == [0, 255, 255, 0]
+
+    assert table(ImageChops.logical_and, 0, 255) == [0, 0, 0, 255]
+    assert table(ImageChops.logical_or, 0, 255) == [0, 255, 255, 255]
+    assert table(ImageChops.logical_xor, 0, 255) == [0, 255, 255, 0]
diff --git a/Tests/test_imagecms.py b/Tests/test_imagecms.py
index c51f1155d37..5ee5fcedf24 100644
--- a/Tests/test_imagecms.py
+++ b/Tests/test_imagecms.py
@@ -691,7 +691,9 @@ def test_rgb_lab(mode: str) -> None:
 
     im = Image.new("LAB", (1, 1), (255, 0, 0))
     converted_im = im.convert(mode)
-    assert converted_im.getpixel((0, 0))[:3] == (0, 255, 255)
+    value = converted_im.getpixel((0, 0))
+    assert isinstance(value, tuple)
+    assert value[:3] == (0, 255, 255)
 
 
 def test_deprecation() -> None:
diff --git a/Tests/test_imagedraw.py b/Tests/test_imagedraw.py
index 1ff3fea2a64..e397978cbbf 100644
--- a/Tests/test_imagedraw.py
+++ b/Tests/test_imagedraw.py
@@ -1,8 +1,8 @@
 from __future__ import annotations
 
-import contextlib
 import os.path
 from collections.abc import Sequence
+from typing import Callable
 
 import pytest
 
@@ -1422,25 +1422,44 @@ def test_default_font_size() -> None:
 
     im = Image.new("RGB", (220, 25))
     draw = ImageDraw.Draw(im)
-    with contextlib.nullcontext() if freetype_support else pytest.raises(ImportError):
+
+    def check(func: Callable[[], None]) -> None:
+        if freetype_support:
+            func()
+        else:
+            with pytest.raises(ImportError):
+                func()
+
+    def draw_text() -> None:
         draw.text((0, 0), text, font_size=16)
         assert_image_equal_tofile(im, "Tests/images/imagedraw_default_font_size.png")
 
-    with contextlib.nullcontext() if freetype_support else pytest.raises(ImportError):
+    check(draw_text)
+
+    def draw_textlength() -> None:
         assert draw.textlength(text, font_size=16) == 216
 
-    with contextlib.nullcontext() if freetype_support else pytest.raises(ImportError):
+    check(draw_textlength)
+
+    def draw_textbbox() -> None:
         assert draw.textbbox((0, 0), text, font_size=16) == (0, 3, 216, 19)
 
+    check(draw_textbbox)
+
     im = Image.new("RGB", (220, 25))
     draw = ImageDraw.Draw(im)
-    with contextlib.nullcontext() if freetype_support else pytest.raises(ImportError):
+
+    def draw_multiline_text() -> None:
         draw.multiline_text((0, 0), text, font_size=16)
         assert_image_equal_tofile(im, "Tests/images/imagedraw_default_font_size.png")
 
-    with contextlib.nullcontext() if freetype_support else pytest.raises(ImportError):
+    check(draw_multiline_text)
+
+    def draw_multiline_textbbox() -> None:
         assert draw.multiline_textbbox((0, 0), text, font_size=16) == (0, 3, 216, 19)
 
+    check(draw_multiline_textbbox)
+
 
 @pytest.mark.parametrize("bbox", BBOX)
 def test_same_color_outline(bbox: Coords) -> None:
diff --git a/Tests/test_imagefile.py b/Tests/test_imagefile.py
index 68b28ef07e2..bb686bb3b90 100644
--- a/Tests/test_imagefile.py
+++ b/Tests/test_imagefile.py
@@ -305,7 +305,7 @@ def test_oversize(self) -> None:
     def test_decode(self) -> None:
         decoder = ImageFile.PyDecoder(None)
         with pytest.raises(NotImplementedError):
-            decoder.decode(None)
+            decoder.decode(b"")
 
 
 class TestPyEncoder(CodecsTest):
diff --git a/Tests/test_imagemorph.py b/Tests/test_imagemorph.py
index 32615cf0edb..4363f456e11 100644
--- a/Tests/test_imagemorph.py
+++ b/Tests/test_imagemorph.py
@@ -41,11 +41,15 @@ def string_to_img(image_string: str) -> Image.Image:
 def img_to_string(im: Image.Image) -> str:
     """Turn a (small) binary image into a string representation"""
     chars = ".1"
-    width, height = im.size
-    return "\n".join(
-        "".join(chars[im.getpixel((c, r)) > 0] for c in range(width))
-        for r in range(height)
-    )
+    result = []
+    for r in range(im.height):
+        line = ""
+        for c in range(im.width):
+            value = im.getpixel((c, r))
+            assert not isinstance(value, tuple) and value is not None
+            line += chars[value > 0]
+        result.append(line)
+    return "\n".join(result)
 
 
 def img_string_normalize(im: str) -> str:
diff --git a/Tests/test_imageops.py b/Tests/test_imageops.py
index 3598df830cc..e33e6d4c842 100644
--- a/Tests/test_imageops.py
+++ b/Tests/test_imageops.py
@@ -259,20 +259,26 @@ def test_colorize_2color() -> None:
     left = (0, 1)
     middle = (127, 1)
     right = (255, 1)
+    value = im_test.getpixel(left)
+    assert isinstance(value, tuple)
     assert_tuple_approx_equal(
-        im_test.getpixel(left),
+        value,
         (255, 0, 0),
         threshold=1,
         msg="black test pixel incorrect",
     )
+    value = im_test.getpixel(middle)
+    assert isinstance(value, tuple)
     assert_tuple_approx_equal(
-        im_test.getpixel(middle),
+        value,
         (127, 63, 0),
         threshold=1,
         msg="mid test pixel incorrect",
     )
+    value = im_test.getpixel(right)
+    assert isinstance(value, tuple)
     assert_tuple_approx_equal(
-        im_test.getpixel(right),
+        value,
         (0, 127, 0),
         threshold=1,
         msg="white test pixel incorrect",
@@ -295,20 +301,26 @@ def test_colorize_2color_offset() -> None:
     left = (25, 1)
     middle = (75, 1)
     right = (125, 1)
+    value = im_test.getpixel(left)
+    assert isinstance(value, tuple)
     assert_tuple_approx_equal(
-        im_test.getpixel(left),
+        value,
         (255, 0, 0),
         threshold=1,
         msg="black test pixel incorrect",
     )
+    value = im_test.getpixel(middle)
+    assert isinstance(value, tuple)
     assert_tuple_approx_equal(
-        im_test.getpixel(middle),
+        value,
         (127, 63, 0),
         threshold=1,
         msg="mid test pixel incorrect",
     )
+    value = im_test.getpixel(right)
+    assert isinstance(value, tuple)
     assert_tuple_approx_equal(
-        im_test.getpixel(right),
+        value,
         (0, 127, 0),
         threshold=1,
         msg="white test pixel incorrect",
@@ -339,29 +351,37 @@ def test_colorize_3color_offset() -> None:
     middle = (100, 1)
     right_middle = (150, 1)
     right = (225, 1)
+    value = im_test.getpixel(left)
+    assert isinstance(value, tuple)
     assert_tuple_approx_equal(
-        im_test.getpixel(left),
+        value,
         (255, 0, 0),
         threshold=1,
         msg="black test pixel incorrect",
     )
+    value = im_test.getpixel(left_middle)
+    assert isinstance(value, tuple)
     assert_tuple_approx_equal(
-        im_test.getpixel(left_middle),
+        value,
         (127, 0, 127),
         threshold=1,
         msg="low-mid test pixel incorrect",
     )
+    value = im_test.getpixel(middle)
+    assert isinstance(value, tuple)
+    assert_tuple_approx_equal(value, (0, 0, 255), threshold=1, msg="mid incorrect")
+    value = im_test.getpixel(right_middle)
+    assert isinstance(value, tuple)
     assert_tuple_approx_equal(
-        im_test.getpixel(middle), (0, 0, 255), threshold=1, msg="mid incorrect"
-    )
-    assert_tuple_approx_equal(
-        im_test.getpixel(right_middle),
+        value,
         (0, 63, 127),
         threshold=1,
         msg="high-mid test pixel incorrect",
     )
+    value = im_test.getpixel(right)
+    assert isinstance(value, tuple)
     assert_tuple_approx_equal(
-        im_test.getpixel(right),
+        value,
         (0, 127, 0),
         threshold=1,
         msg="white test pixel incorrect",
@@ -444,6 +464,7 @@ def test_exif_transpose_xml_without_xmp() -> None:
 
         del im.info["xmp"]
         transposed_im = ImageOps.exif_transpose(im)
+        assert transposed_im is not None
         assert 0x0112 not in transposed_im.getexif()
 
 
diff --git a/Tests/test_imagetk.py b/Tests/test_imagetk.py
index e5869892e55..f84c6c03a37 100644
--- a/Tests/test_imagetk.py
+++ b/Tests/test_imagetk.py
@@ -45,10 +45,12 @@ def test_kw() -> None:
 
             # Test "file"
             im = ImageTk._get_image_from_kw(kw)
+            assert im is not None
             assert_image_equal(im, im1)
 
             # Test "data"
             im = ImageTk._get_image_from_kw(kw)
+            assert im is not None
             assert_image_equal(im, im2)
 
     # Test no relevant entry
diff --git a/Tests/test_tiff_ifdrational.py b/Tests/test_tiff_ifdrational.py
index ae80b98b84d..9d06a933250 100644
--- a/Tests/test_tiff_ifdrational.py
+++ b/Tests/test_tiff_ifdrational.py
@@ -11,7 +11,11 @@
 from .helper import hopper, skip_unless_feature
 
 
-def _test_equal(num, denom, target) -> None:
+def _test_equal(
+    num: float | Fraction | IFDRational,
+    denom: int,
+    target: float | Fraction | IFDRational,
+) -> None:
     t = IFDRational(num, denom)
 
     assert target == t

From 69cca2a10364a6128415815d3fc14df7314db596 Mon Sep 17 00:00:00 2001
From: Andrew Murray <radarhere@users.noreply.github.com>
Date: Sat, 6 Jul 2024 15:08:35 +1000
Subject: [PATCH 0798/1178] Added type hints

---
 src/PIL/PdfParser.py | 274 +++++++++++++++++++++++++++----------------
 1 file changed, 172 insertions(+), 102 deletions(-)

diff --git a/src/PIL/PdfParser.py b/src/PIL/PdfParser.py
index 622dc7de9e7..7cb2d241bc2 100644
--- a/src/PIL/PdfParser.py
+++ b/src/PIL/PdfParser.py
@@ -8,7 +8,7 @@
 import re
 import time
 import zlib
-from typing import TYPE_CHECKING, Any, NamedTuple, Union
+from typing import IO, TYPE_CHECKING, Any, NamedTuple, Union
 
 
 # see 7.9.2.2 Text String Type on page 86 and D.3 PDFDocEncoding Character Set
@@ -62,7 +62,7 @@ def encode_text(s: str) -> bytes:
 }
 
 
-def decode_text(b):
+def decode_text(b: bytes) -> str:
     if b[: len(codecs.BOM_UTF16_BE)] == codecs.BOM_UTF16_BE:
         return b[len(codecs.BOM_UTF16_BE) :].decode("utf_16_be")
     else:
@@ -99,7 +99,7 @@ def __eq__(self, other: object) -> bool:
         assert isinstance(other, IndirectReference)
         return other.object_id == self.object_id and other.generation == self.generation
 
-    def __ne__(self, other):
+    def __ne__(self, other: object) -> bool:
         return not (self == other)
 
     def __hash__(self) -> int:
@@ -112,13 +112,17 @@ def __str__(self) -> str:
 
 
 class XrefTable:
-    def __init__(self):
-        self.existing_entries = {}  # object ID => (offset, generation)
-        self.new_entries = {}  # object ID => (offset, generation)
+    def __init__(self) -> None:
+        self.existing_entries: dict[int, tuple[int, int]] = (
+            {}
+        )  # object ID => (offset, generation)
+        self.new_entries: dict[int, tuple[int, int]] = (
+            {}
+        )  # object ID => (offset, generation)
         self.deleted_entries = {0: 65536}  # object ID => generation
         self.reading_finished = False
 
-    def __setitem__(self, key, value):
+    def __setitem__(self, key: int, value: tuple[int, int]) -> None:
         if self.reading_finished:
             self.new_entries[key] = value
         else:
@@ -126,13 +130,13 @@ def __setitem__(self, key, value):
         if key in self.deleted_entries:
             del self.deleted_entries[key]
 
-    def __getitem__(self, key):
+    def __getitem__(self, key: int) -> tuple[int, int]:
         try:
             return self.new_entries[key]
         except KeyError:
             return self.existing_entries[key]
 
-    def __delitem__(self, key):
+    def __delitem__(self, key: int) -> None:
         if key in self.new_entries:
             generation = self.new_entries[key][1] + 1
             del self.new_entries[key]
@@ -146,7 +150,7 @@ def __delitem__(self, key):
             msg = f"object ID {key} cannot be deleted because it doesn't exist"
             raise IndexError(msg)
 
-    def __contains__(self, key):
+    def __contains__(self, key: int) -> bool:
         return key in self.existing_entries or key in self.new_entries
 
     def __len__(self) -> int:
@@ -156,19 +160,19 @@ def __len__(self) -> int:
             | set(self.deleted_entries.keys())
         )
 
-    def keys(self):
+    def keys(self) -> set[int]:
         return (
             set(self.existing_entries.keys()) - set(self.deleted_entries.keys())
         ) | set(self.new_entries.keys())
 
-    def write(self, f):
+    def write(self, f: IO[bytes]) -> int:
         keys = sorted(set(self.new_entries.keys()) | set(self.deleted_entries.keys()))
         deleted_keys = sorted(set(self.deleted_entries.keys()))
         startxref = f.tell()
         f.write(b"xref\n")
         while keys:
             # find a contiguous sequence of object IDs
-            prev = None
+            prev: int | None = None
             for index, key in enumerate(keys):
                 if prev is None or prev + 1 == key:
                     prev = key
@@ -178,7 +182,7 @@ def write(self, f):
                     break
             else:
                 contiguous_keys = keys
-                keys = None
+                keys = []
             f.write(b"%d %d\n" % (contiguous_keys[0], len(contiguous_keys)))
             for object_id in contiguous_keys:
                 if object_id in self.new_entries:
@@ -202,7 +206,9 @@ def write(self, f):
 
 
 class PdfName:
-    def __init__(self, name):
+    name: bytes
+
+    def __init__(self, name: PdfName | bytes | str) -> None:
         if isinstance(name, PdfName):
             self.name = name.name
         elif isinstance(name, bytes):
@@ -213,7 +219,7 @@ def __init__(self, name):
     def name_as_str(self) -> str:
         return self.name.decode("us-ascii")
 
-    def __eq__(self, other):
+    def __eq__(self, other: object) -> bool:
         return (
             isinstance(other, PdfName) and other.name == self.name
         ) or other == self.name
@@ -225,7 +231,7 @@ def __repr__(self) -> str:
         return f"{self.__class__.__name__}({repr(self.name)})"
 
     @classmethod
-    def from_pdf_stream(cls, data):
+    def from_pdf_stream(cls, data: bytes) -> PdfName:
         return cls(PdfParser.interpret_name(data))
 
     allowed_chars = set(range(33, 127)) - {ord(c) for c in "#%/()<>[]{}"}
@@ -252,13 +258,13 @@ def __bytes__(self) -> bytes:
 
 
 class PdfDict(_DictBase):
-    def __setattr__(self, key, value):
+    def __setattr__(self, key: str, value: Any) -> None:
         if key == "data":
             collections.UserDict.__setattr__(self, key, value)
         else:
             self[key.encode("us-ascii")] = value
 
-    def __getattr__(self, key):
+    def __getattr__(self, key: str) -> str | time.struct_time:
         try:
             value = self[key.encode("us-ascii")]
         except KeyError as e:
@@ -300,7 +306,7 @@ def __bytes__(self) -> bytes:
 
 
 class PdfBinary:
-    def __init__(self, data):
+    def __init__(self, data: list[int] | bytes) -> None:
         self.data = data
 
     def __bytes__(self) -> bytes:
@@ -308,27 +314,27 @@ def __bytes__(self) -> bytes:
 
 
 class PdfStream:
-    def __init__(self, dictionary, buf):
+    def __init__(self, dictionary: PdfDict, buf: bytes) -> None:
         self.dictionary = dictionary
         self.buf = buf
 
-    def decode(self):
+    def decode(self) -> bytes:
         try:
-            filter = self.dictionary.Filter
-        except AttributeError:
+            filter = self.dictionary[b"Filter"]
+        except KeyError:
             return self.buf
         if filter == b"FlateDecode":
             try:
-                expected_length = self.dictionary.DL
-            except AttributeError:
-                expected_length = self.dictionary.Length
+                expected_length = self.dictionary[b"DL"]
+            except KeyError:
+                expected_length = self.dictionary[b"Length"]
             return zlib.decompress(self.buf, bufsize=int(expected_length))
         else:
-            msg = f"stream filter {repr(self.dictionary.Filter)} unknown/unsupported"
+            msg = f"stream filter {repr(filter)} unknown/unsupported"
             raise NotImplementedError(msg)
 
 
-def pdf_repr(x):
+def pdf_repr(x: Any) -> bytes:
     if x is True:
         return b"true"
     elif x is False:
@@ -363,12 +369,19 @@ class PdfParser:
     Supports PDF up to 1.4
     """
 
-    def __init__(self, filename=None, f=None, buf=None, start_offset=0, mode="rb"):
+    def __init__(
+        self,
+        filename: str | None = None,
+        f: IO[bytes] | None = None,
+        buf: bytes | bytearray | None = None,
+        start_offset: int = 0,
+        mode: str = "rb",
+    ) -> None:
         if buf and f:
             msg = "specify buf or f or filename, but not both buf and f"
             raise RuntimeError(msg)
         self.filename = filename
-        self.buf = buf
+        self.buf: bytes | bytearray | mmap.mmap | None = buf
         self.f = f
         self.start_offset = start_offset
         self.should_close_buf = False
@@ -377,12 +390,16 @@ def __init__(self, filename=None, f=None, buf=None, start_offset=0, mode="rb"):
             self.f = f = open(filename, mode)
             self.should_close_file = True
         if f is not None:
-            self.buf = buf = self.get_buf_from_file(f)
+            self.buf = self.get_buf_from_file(f)
             self.should_close_buf = True
             if not filename and hasattr(f, "name"):
                 self.filename = f.name
-        self.cached_objects = {}
-        if buf:
+        self.cached_objects: dict[IndirectReference, Any] = {}
+        self.root_ref: IndirectReference | None
+        self.info_ref: IndirectReference | None
+        self.pages_ref: IndirectReference | None
+        self.last_xref_section_offset: int | None
+        if self.buf:
             self.read_pdf_info()
         else:
             self.file_size_total = self.file_size_this = 0
@@ -390,12 +407,12 @@ def __init__(self, filename=None, f=None, buf=None, start_offset=0, mode="rb"):
             self.root_ref = None
             self.info = PdfDict()
             self.info_ref = None
-            self.page_tree_root = {}
-            self.pages = []
-            self.orig_pages = []
+            self.page_tree_root = PdfDict()
+            self.pages: list[IndirectReference] = []
+            self.orig_pages: list[IndirectReference] = []
             self.pages_ref = None
             self.last_xref_section_offset = None
-            self.trailer_dict = {}
+            self.trailer_dict: dict[bytes, Any] = {}
             self.xref_table = XrefTable()
         self.xref_table.reading_finished = True
         if f:
@@ -412,10 +429,8 @@ def start_writing(self) -> None:
         self.seek_end()
 
     def close_buf(self) -> None:
-        try:
+        if isinstance(self.buf, mmap.mmap):
             self.buf.close()
-        except AttributeError:
-            pass
         self.buf = None
 
     def close(self) -> None:
@@ -426,15 +441,19 @@ def close(self) -> None:
             self.f = None
 
     def seek_end(self) -> None:
+        assert self.f is not None
         self.f.seek(0, os.SEEK_END)
 
     def write_header(self) -> None:
+        assert self.f is not None
         self.f.write(b"%PDF-1.4\n")
 
-    def write_comment(self, s):
+    def write_comment(self, s: str) -> None:
+        assert self.f is not None
         self.f.write(f"% {s}\n".encode())
 
     def write_catalog(self) -> IndirectReference:
+        assert self.f is not None
         self.del_root()
         self.root_ref = self.next_object_id(self.f.tell())
         self.pages_ref = self.next_object_id(0)
@@ -477,7 +496,10 @@ def rewrite_pages(self) -> None:
                 pages_tree_node_ref = pages_tree_node.get(b"Parent", None)
         self.orig_pages = []
 
-    def write_xref_and_trailer(self, new_root_ref=None):
+    def write_xref_and_trailer(
+        self, new_root_ref: IndirectReference | None = None
+    ) -> None:
+        assert self.f is not None
         if new_root_ref:
             self.del_root()
             self.root_ref = new_root_ref
@@ -485,7 +507,10 @@ def write_xref_and_trailer(self, new_root_ref=None):
             self.info_ref = self.write_obj(None, self.info)
         start_xref = self.xref_table.write(self.f)
         num_entries = len(self.xref_table)
-        trailer_dict = {b"Root": self.root_ref, b"Size": num_entries}
+        trailer_dict: dict[str | bytes, Any] = {
+            b"Root": self.root_ref,
+            b"Size": num_entries,
+        }
         if self.last_xref_section_offset is not None:
             trailer_dict[b"Prev"] = self.last_xref_section_offset
         if self.info:
@@ -497,16 +522,20 @@ def write_xref_and_trailer(self, new_root_ref=None):
             + b"\nstartxref\n%d\n%%%%EOF" % start_xref
         )
 
-    def write_page(self, ref, *objs, **dict_obj):
-        if isinstance(ref, int):
-            ref = self.pages[ref]
+    def write_page(
+        self, ref: int | IndirectReference | None, *objs: Any, **dict_obj: Any
+    ) -> IndirectReference:
+        obj_ref = self.pages[ref] if isinstance(ref, int) else ref
         if "Type" not in dict_obj:
             dict_obj["Type"] = PdfName(b"Page")
         if "Parent" not in dict_obj:
             dict_obj["Parent"] = self.pages_ref
-        return self.write_obj(ref, *objs, **dict_obj)
+        return self.write_obj(obj_ref, *objs, **dict_obj)
 
-    def write_obj(self, ref, *objs, **dict_obj):
+    def write_obj(
+        self, ref: IndirectReference | None, *objs: Any, **dict_obj: Any
+    ) -> IndirectReference:
+        assert self.f is not None
         f = self.f
         if ref is None:
             ref = self.next_object_id(f.tell())
@@ -534,7 +563,7 @@ def del_root(self) -> None:
         del self.xref_table[self.root[b"Pages"].object_id]
 
     @staticmethod
-    def get_buf_from_file(f):
+    def get_buf_from_file(f: IO[bytes]) -> bytes | mmap.mmap:
         if hasattr(f, "getbuffer"):
             return f.getbuffer()
         elif hasattr(f, "getvalue"):
@@ -546,10 +575,15 @@ def get_buf_from_file(f):
                 return b""
 
     def read_pdf_info(self) -> None:
+        assert self.buf is not None
         self.file_size_total = len(self.buf)
         self.file_size_this = self.file_size_total - self.start_offset
         self.read_trailer()
+        check_format_condition(
+            self.trailer_dict.get(b"Root") is not None, "Root is missing"
+        )
         self.root_ref = self.trailer_dict[b"Root"]
+        assert self.root_ref is not None
         self.info_ref = self.trailer_dict.get(b"Info", None)
         self.root = PdfDict(self.read_indirect(self.root_ref))
         if self.info_ref is None:
@@ -560,12 +594,15 @@ def read_pdf_info(self) -> None:
         check_format_condition(
             self.root[b"Type"] == b"Catalog", "/Type in Root is not /Catalog"
         )
-        check_format_condition(b"Pages" in self.root, "/Pages missing in Root")
+        check_format_condition(
+            self.root.get(b"Pages") is not None, "/Pages missing in Root"
+        )
         check_format_condition(
             isinstance(self.root[b"Pages"], IndirectReference),
             "/Pages in Root is not an indirect reference",
         )
         self.pages_ref = self.root[b"Pages"]
+        assert self.pages_ref is not None
         self.page_tree_root = self.read_indirect(self.pages_ref)
         self.pages = self.linearize_page_tree(self.page_tree_root)
         # save the original list of page references
@@ -573,7 +610,7 @@ def read_pdf_info(self) -> None:
         # and we need to rewrite the pages and their list
         self.orig_pages = self.pages[:]
 
-    def next_object_id(self, offset=None):
+    def next_object_id(self, offset: int | None = None) -> IndirectReference:
         try:
             # TODO: support reuse of deleted objects
             reference = IndirectReference(max(self.xref_table.keys()) + 1, 0)
@@ -623,12 +660,13 @@ def next_object_id(self, offset=None):
         re.DOTALL,
     )
 
-    def read_trailer(self):
+    def read_trailer(self) -> None:
+        assert self.buf is not None
         search_start_offset = len(self.buf) - 16384
         if search_start_offset < self.start_offset:
             search_start_offset = self.start_offset
         m = self.re_trailer_end.search(self.buf, search_start_offset)
-        check_format_condition(m, "trailer end not found")
+        check_format_condition(m is not None, "trailer end not found")
         # make sure we found the LAST trailer
         last_match = m
         while m:
@@ -636,6 +674,7 @@ def read_trailer(self):
             m = self.re_trailer_end.search(self.buf, m.start() + 16)
         if not m:
             m = last_match
+        assert m is not None
         trailer_data = m.group(1)
         self.last_xref_section_offset = int(m.group(2))
         self.trailer_dict = self.interpret_trailer(trailer_data)
@@ -644,12 +683,14 @@ def read_trailer(self):
         if b"Prev" in self.trailer_dict:
             self.read_prev_trailer(self.trailer_dict[b"Prev"])
 
-    def read_prev_trailer(self, xref_section_offset):
+    def read_prev_trailer(self, xref_section_offset: int) -> None:
+        assert self.buf is not None
         trailer_offset = self.read_xref_table(xref_section_offset=xref_section_offset)
         m = self.re_trailer_prev.search(
             self.buf[trailer_offset : trailer_offset + 16384]
         )
-        check_format_condition(m, "previous trailer not found")
+        check_format_condition(m is not None, "previous trailer not found")
+        assert m is not None
         trailer_data = m.group(1)
         check_format_condition(
             int(m.group(2)) == xref_section_offset,
@@ -670,7 +711,7 @@ def read_prev_trailer(self, xref_section_offset):
     re_dict_end = re.compile(whitespace_optional + rb">>" + whitespace_optional)
 
     @classmethod
-    def interpret_trailer(cls, trailer_data):
+    def interpret_trailer(cls, trailer_data: bytes) -> dict[bytes, Any]:
         trailer = {}
         offset = 0
         while True:
@@ -678,14 +719,18 @@ def interpret_trailer(cls, trailer_data):
             if not m:
                 m = cls.re_dict_end.match(trailer_data, offset)
                 check_format_condition(
-                    m and m.end() == len(trailer_data),
+                    m is not None and m.end() == len(trailer_data),
                     "name not found in trailer, remaining data: "
                     + repr(trailer_data[offset:]),
                 )
                 break
             key = cls.interpret_name(m.group(1))
-            value, offset = cls.get_value(trailer_data, m.end())
+            assert isinstance(key, bytes)
+            value, value_offset = cls.get_value(trailer_data, m.end())
             trailer[key] = value
+            if value_offset is None:
+                break
+            offset = value_offset
         check_format_condition(
             b"Size" in trailer and isinstance(trailer[b"Size"], int),
             "/Size not in trailer or not an integer",
@@ -699,7 +744,7 @@ def interpret_trailer(cls, trailer_data):
     re_hashes_in_name = re.compile(rb"([^#]*)(#([0-9a-fA-F]{2}))?")
 
     @classmethod
-    def interpret_name(cls, raw, as_text=False):
+    def interpret_name(cls, raw: bytes, as_text: bool = False) -> str | bytes:
         name = b""
         for m in cls.re_hashes_in_name.finditer(raw):
             if m.group(3):
@@ -761,7 +806,13 @@ def interpret_name(cls, raw, as_text=False):
     )
 
     @classmethod
-    def get_value(cls, data, offset, expect_indirect=None, max_nesting=-1):
+    def get_value(
+        cls,
+        data: bytes | bytearray | mmap.mmap,
+        offset: int,
+        expect_indirect: IndirectReference | None = None,
+        max_nesting: int = -1,
+    ) -> tuple[Any, int | None]:
         if max_nesting == 0:
             return None, None
         m = cls.re_comment.match(data, offset)
@@ -783,11 +834,16 @@ def get_value(cls, data, offset, expect_indirect=None, max_nesting=-1):
                 == IndirectReference(int(m.group(1)), int(m.group(2))),
                 "indirect object definition different than expected",
             )
-            object, offset = cls.get_value(data, m.end(), max_nesting=max_nesting - 1)
-            if offset is None:
+            object, object_offset = cls.get_value(
+                data, m.end(), max_nesting=max_nesting - 1
+            )
+            if object_offset is None:
                 return object, None
-            m = cls.re_indirect_def_end.match(data, offset)
-            check_format_condition(m, "indirect object definition end not found")
+            m = cls.re_indirect_def_end.match(data, object_offset)
+            check_format_condition(
+                m is not None, "indirect object definition end not found"
+            )
+            assert m is not None
             return object, m.end()
         check_format_condition(
             not expect_indirect, "indirect object definition not found"
@@ -806,46 +862,53 @@ def get_value(cls, data, offset, expect_indirect=None, max_nesting=-1):
         m = cls.re_dict_start.match(data, offset)
         if m:
             offset = m.end()
-            result = {}
+            result: dict[Any, Any] = {}
             m = cls.re_dict_end.match(data, offset)
+            current_offset: int | None = offset
             while not m:
-                key, offset = cls.get_value(data, offset, max_nesting=max_nesting - 1)
-                if offset is None:
+                assert current_offset is not None
+                key, current_offset = cls.get_value(
+                    data, current_offset, max_nesting=max_nesting - 1
+                )
+                if current_offset is None:
                     return result, None
-                value, offset = cls.get_value(data, offset, max_nesting=max_nesting - 1)
+                value, current_offset = cls.get_value(
+                    data, current_offset, max_nesting=max_nesting - 1
+                )
                 result[key] = value
-                if offset is None:
+                if current_offset is None:
                     return result, None
-                m = cls.re_dict_end.match(data, offset)
-            offset = m.end()
-            m = cls.re_stream_start.match(data, offset)
+                m = cls.re_dict_end.match(data, current_offset)
+            current_offset = m.end()
+            m = cls.re_stream_start.match(data, current_offset)
             if m:
-                try:
-                    stream_len_str = result.get(b"Length")
-                    stream_len = int(stream_len_str)
-                except (TypeError, ValueError) as e:
-                    msg = f"bad or missing Length in stream dict ({stream_len_str})"
-                    raise PdfFormatError(msg) from e
+                stream_len = result.get(b"Length")
+                if stream_len is None or not isinstance(stream_len, int):
+                    msg = f"bad or missing Length in stream dict ({stream_len})"
+                    raise PdfFormatError(msg)
                 stream_data = data[m.end() : m.end() + stream_len]
                 m = cls.re_stream_end.match(data, m.end() + stream_len)
-                check_format_condition(m, "stream end not found")
-                offset = m.end()
-                result = PdfStream(PdfDict(result), stream_data)
-            else:
-                result = PdfDict(result)
-            return result, offset
+                check_format_condition(m is not None, "stream end not found")
+                assert m is not None
+                current_offset = m.end()
+                return PdfStream(PdfDict(result), stream_data), current_offset
+            return PdfDict(result), current_offset
         m = cls.re_array_start.match(data, offset)
         if m:
             offset = m.end()
-            result = []
+            results = []
             m = cls.re_array_end.match(data, offset)
+            current_offset = offset
             while not m:
-                value, offset = cls.get_value(data, offset, max_nesting=max_nesting - 1)
-                result.append(value)
-                if offset is None:
-                    return result, None
-                m = cls.re_array_end.match(data, offset)
-            return result, m.end()
+                assert current_offset is not None
+                value, current_offset = cls.get_value(
+                    data, current_offset, max_nesting=max_nesting - 1
+                )
+                results.append(value)
+                if current_offset is None:
+                    return results, None
+                m = cls.re_array_end.match(data, current_offset)
+            return results, m.end()
         m = cls.re_null.match(data, offset)
         if m:
             return None, m.end()
@@ -905,7 +968,9 @@ def get_value(cls, data, offset, expect_indirect=None, max_nesting=-1):
     }
 
     @classmethod
-    def get_literal_string(cls, data, offset):
+    def get_literal_string(
+        cls, data: bytes | bytearray | mmap.mmap, offset: int
+    ) -> tuple[bytes, int]:
         nesting_depth = 0
         result = bytearray()
         for m in cls.re_lit_str_token.finditer(data, offset):
@@ -941,12 +1006,14 @@ def get_literal_string(cls, data, offset):
     )
     re_xref_entry = re.compile(rb"([0-9]{10}) ([0-9]{5}) ([fn])( \r| \n|\r\n)")
 
-    def read_xref_table(self, xref_section_offset):
+    def read_xref_table(self, xref_section_offset: int) -> int:
+        assert self.buf is not None
         subsection_found = False
         m = self.re_xref_section_start.match(
             self.buf, xref_section_offset + self.start_offset
         )
-        check_format_condition(m, "xref section start not found")
+        check_format_condition(m is not None, "xref section start not found")
+        assert m is not None
         offset = m.end()
         while True:
             m = self.re_xref_subsection_start.match(self.buf, offset)
@@ -961,7 +1028,8 @@ def read_xref_table(self, xref_section_offset):
             num_objects = int(m.group(2))
             for i in range(first_object, first_object + num_objects):
                 m = self.re_xref_entry.match(self.buf, offset)
-                check_format_condition(m, "xref entry not found")
+                check_format_condition(m is not None, "xref entry not found")
+                assert m is not None
                 offset = m.end()
                 is_free = m.group(3) == b"f"
                 if not is_free:
@@ -971,13 +1039,14 @@ def read_xref_table(self, xref_section_offset):
                         self.xref_table[i] = new_entry
         return offset
 
-    def read_indirect(self, ref, max_nesting=-1):
+    def read_indirect(self, ref: IndirectReference, max_nesting: int = -1) -> Any:
         offset, generation = self.xref_table[ref[0]]
         check_format_condition(
             generation == ref[1],
             f"expected to find generation {ref[1]} for object ID {ref[0]} in xref "
             f"table, instead found generation {generation} at offset {offset}",
         )
+        assert self.buf is not None
         value = self.get_value(
             self.buf,
             offset + self.start_offset,
@@ -987,14 +1056,15 @@ def read_indirect(self, ref, max_nesting=-1):
         self.cached_objects[ref] = value
         return value
 
-    def linearize_page_tree(self, node=None):
-        if node is None:
-            node = self.page_tree_root
+    def linearize_page_tree(
+        self, node: PdfDict | None = None
+    ) -> list[IndirectReference]:
+        page_node = node if node is not None else self.page_tree_root
         check_format_condition(
-            node[b"Type"] == b"Pages", "/Type of page tree node is not /Pages"
+            page_node[b"Type"] == b"Pages", "/Type of page tree node is not /Pages"
         )
         pages = []
-        for kid in node[b"Kids"]:
+        for kid in page_node[b"Kids"]:
             kid_object = self.read_indirect(kid)
             if kid_object[b"Type"] == b"Page":
                 pages.append(kid)

From 486dac7efcc3fd937a00f4180ef32f4a75686f15 Mon Sep 17 00:00:00 2001
From: Andrew Murray <radarhere@users.noreply.github.com>
Date: Sat, 6 Jul 2024 19:17:23 +1000
Subject: [PATCH 0799/1178] Added type hints

---
 Tests/test_file_gif.py     |  2 +-
 Tests/test_file_libtiff.py | 21 ++++++++++++++++-----
 Tests/test_file_pdf.py     |  2 +-
 Tests/test_file_tiff.py    | 22 +++++++++++++---------
 Tests/test_image.py        |  2 +-
 Tests/test_imagegrab.py    |  7 ++++---
 pyproject.toml             |  8 ++++++++
 src/PIL/Image.py           |  4 ++--
 tox.ini                    |  4 +++-
 9 files changed, 49 insertions(+), 23 deletions(-)

diff --git a/Tests/test_file_gif.py b/Tests/test_file_gif.py
index 79a2ec0ab37..85b017d29af 100644
--- a/Tests/test_file_gif.py
+++ b/Tests/test_file_gif.py
@@ -353,7 +353,7 @@ def test_palette_434(tmp_path: Path) -> None:
 
     def roundtrip(im: Image.Image, **kwargs: bool) -> Image.Image:
         out = str(tmp_path / "temp.gif")
-        im.copy().save(out, **kwargs)
+        im.copy().save(out, "GIF", **kwargs)
         reloaded = Image.open(out)
 
         return reloaded
diff --git a/Tests/test_file_libtiff.py b/Tests/test_file_libtiff.py
index 8707311dc8c..d5dbeeb6f74 100644
--- a/Tests/test_file_libtiff.py
+++ b/Tests/test_file_libtiff.py
@@ -92,11 +92,22 @@ def test_g4_tiff_bytesio(self, tmp_path: Path) -> None:
     def test_g4_non_disk_file_object(self, tmp_path: Path) -> None:
         """Testing loading from non-disk non-BytesIO file object"""
         test_file = "Tests/images/hopper_g4_500.tif"
-        s = io.BytesIO()
         with open(test_file, "rb") as f:
-            s.write(f.read())
-            s.seek(0)
-        r = io.BufferedReader(s)
+            data = f.read()
+
+        class NonBytesIO(io.RawIOBase):
+            def read(self, size: int = -1) -> bytes:
+                nonlocal data
+                if size == -1:
+                    size = len(data)
+                result = data[:size]
+                data = data[size:]
+                return result
+
+            def readable(self) -> bool:
+                return True
+
+        r = io.BufferedReader(NonBytesIO())
         with Image.open(r) as im:
             assert im.size == (500, 500)
             self._assert_noerr(tmp_path, im)
@@ -1139,7 +1150,7 @@ def test_save_single_strip(self, argument: bool, tmp_path: Path) -> None:
             arguments: dict[str, str | int] = {"compression": "tiff_adobe_deflate"}
             if argument:
                 arguments["strip_size"] = 2**18
-            im.save(out, **arguments)
+            im.save(out, "TIFF", **arguments)
 
             with Image.open(out) as im:
                 assert isinstance(im, TiffImagePlugin.TiffImageFile)
diff --git a/Tests/test_file_pdf.py b/Tests/test_file_pdf.py
index 02f07a565d7..3729ca58b34 100644
--- a/Tests/test_file_pdf.py
+++ b/Tests/test_file_pdf.py
@@ -118,7 +118,7 @@ def test_dpi(params: dict[str, int | tuple[int, int]], tmp_path: Path) -> None:
     im = hopper()
 
     outfile = str(tmp_path / "temp.pdf")
-    im.save(outfile, **params)
+    im.save(outfile, "PDF", **params)
 
     with open(outfile, "rb") as fp:
         contents = fp.read()
diff --git a/Tests/test_file_tiff.py b/Tests/test_file_tiff.py
index 93a9f9e6a61..8cad252724c 100644
--- a/Tests/test_file_tiff.py
+++ b/Tests/test_file_tiff.py
@@ -78,6 +78,7 @@ def test_closed_file(self) -> None:
 
     def test_seek_after_close(self) -> None:
         im = Image.open("Tests/images/multipage.tiff")
+        assert isinstance(im, TiffImagePlugin.TiffImageFile)
         im.close()
 
         with pytest.raises(ValueError):
@@ -424,13 +425,13 @@ def test_load_string(self) -> None:
     def test_load_float(self) -> None:
         ifd = TiffImagePlugin.ImageFileDirectory_v2()
         data = b"abcdabcd"
-        ret = ifd.load_float(data, False)
+        ret = getattr(ifd, "load_float")(data, False)
         assert ret == (1.6777999408082104e22, 1.6777999408082104e22)
 
     def test_load_double(self) -> None:
         ifd = TiffImagePlugin.ImageFileDirectory_v2()
         data = b"abcdefghabcdefgh"
-        ret = ifd.load_double(data, False)
+        ret = getattr(ifd, "load_double")(data, False)
         assert ret == (8.540883223036124e194, 8.540883223036124e194)
 
     def test_ifd_tag_type(self) -> None:
@@ -599,7 +600,7 @@ def test_gray_semibyte_per_pixel(self) -> None:
     def test_with_underscores(self, tmp_path: Path) -> None:
         kwargs = {"resolution_unit": "inch", "x_resolution": 72, "y_resolution": 36}
         filename = str(tmp_path / "temp.tif")
-        hopper("RGB").save(filename, **kwargs)
+        hopper("RGB").save(filename, "TIFF", **kwargs)
         with Image.open(filename) as im:
             # legacy interface
             assert im.tag[X_RESOLUTION][0][0] == 72
@@ -624,14 +625,17 @@ def test_roundtrip_tiff_uint16(self, tmp_path: Path) -> None:
     def test_iptc(self, tmp_path: Path) -> None:
         # Do not preserve IPTC_NAA_CHUNK by default if type is LONG
         outfile = str(tmp_path / "temp.tif")
-        im = hopper()
-        ifd = TiffImagePlugin.ImageFileDirectory_v2()
-        ifd[33723] = 1
-        ifd.tagtype[33723] = 4
-        im.tag_v2 = ifd
-        im.save(outfile)
+        with Image.open("Tests/images/hopper.tif") as im:
+            im.load()
+            assert isinstance(im, TiffImagePlugin.TiffImageFile)
+            ifd = TiffImagePlugin.ImageFileDirectory_v2()
+            ifd[33723] = 1
+            ifd.tagtype[33723] = 4
+            im.tag_v2 = ifd
+            im.save(outfile)
 
         with Image.open(outfile) as im:
+            assert isinstance(im, TiffImagePlugin.TiffImageFile)
             assert 33723 not in im.tag_v2
 
     def test_rowsperstrip(self, tmp_path: Path) -> None:
diff --git a/Tests/test_image.py b/Tests/test_image.py
index 8e6f63face6..4fdc4179170 100644
--- a/Tests/test_image.py
+++ b/Tests/test_image.py
@@ -704,7 +704,7 @@ def _make_new(
             else:
                 assert new_image.palette is None
 
-        _make_new(im, im_p, ImagePalette.ImagePalette(list(range(256)) * 3))
+        _make_new(im, im_p, ImagePalette.ImagePalette("RGB"))
         _make_new(im_p, im, None)
         _make_new(im, blank_p, ImagePalette.ImagePalette())
         _make_new(im, blank_pa, ImagePalette.ImagePalette())
diff --git a/Tests/test_imagegrab.py b/Tests/test_imagegrab.py
index 5dfa51697c2..5cd510751e2 100644
--- a/Tests/test_imagegrab.py
+++ b/Tests/test_imagegrab.py
@@ -60,6 +60,8 @@ def test_grab_invalid_xdisplay(self) -> None:
     def test_grabclipboard(self) -> None:
         if sys.platform == "darwin":
             subprocess.call(["screencapture", "-cx"])
+
+            ImageGrab.grabclipboard()
         elif sys.platform == "win32":
             p = subprocess.Popen(["powershell", "-command", "-"], stdin=subprocess.PIPE)
             p.stdin.write(
@@ -69,6 +71,8 @@ def test_grabclipboard(self) -> None:
 [Windows.Forms.Clipboard]::SetImage($bmp)"""
             )
             p.communicate()
+
+            ImageGrab.grabclipboard()
         else:
             if not shutil.which("wl-paste") and not shutil.which("xclip"):
                 with pytest.raises(
@@ -77,9 +81,6 @@ def test_grabclipboard(self) -> None:
                     r" ImageGrab.grabclipboard\(\) on Linux",
                 ):
                     ImageGrab.grabclipboard()
-            return
-
-        ImageGrab.grabclipboard()
 
     @pytest.mark.skipif(sys.platform != "win32", reason="Windows only")
     def test_grabclipboard_file(self) -> None:
diff --git a/pyproject.toml b/pyproject.toml
index 700d5e7fec4..cd724866984 100644
--- a/pyproject.toml
+++ b/pyproject.toml
@@ -155,3 +155,11 @@ follow_imports = "silent"
 warn_redundant_casts = true
 warn_unreachable = true
 warn_unused_ignores = true
+exclude = [
+  '^Tests/oss-fuzz/fuzz_font.py$',
+  '^Tests/oss-fuzz/fuzz_pillow.py$',
+  '^Tests/test_qt_image_qapplication.py$',
+  '^Tests/test_font_pcf_charsets.py$',
+  '^Tests/test_font_pcf.py$',
+  '^Tests/test_file_tar.py$',
+]
diff --git a/src/PIL/Image.py b/src/PIL/Image.py
index dbb72ed6afa..565abe71d45 100644
--- a/src/PIL/Image.py
+++ b/src/PIL/Image.py
@@ -1886,7 +1886,7 @@ def alpha_composite(
 
     def point(
         self,
-        lut: Sequence[float] | Callable[[int], float] | ImagePointHandler,
+        lut: Sequence[float] | NumpyArray | Callable[[int], float] | ImagePointHandler,
         mode: str | None = None,
     ) -> Image:
         """
@@ -1996,7 +1996,7 @@ def putalpha(self, alpha: Image | int) -> None:
 
     def putdata(
         self,
-        data: Sequence[float] | Sequence[Sequence[int]],
+        data: Sequence[float] | Sequence[Sequence[int]] | NumpyArray,
         scale: float = 1.0,
         offset: float = 0.0,
     ) -> None:
diff --git a/tox.ini b/tox.ini
index 18941523785..c1bc3b17db3 100644
--- a/tox.ini
+++ b/tox.ini
@@ -38,9 +38,11 @@ deps =
     ipython
     numpy
     packaging
+    pytest
     types-defusedxml
     types-olefile
+    types-setuptools
 extras =
     typing
 commands =
-    mypy src {posargs}
+    mypy src Tests {posargs}

From 6883018725bbaa5f616c1ec190393efcaef7a2ce Mon Sep 17 00:00:00 2001
From: Andrew Murray <radarhere@users.noreply.github.com>
Date: Sat, 6 Jul 2024 22:06:47 +1000
Subject: [PATCH 0800/1178] Added type hint

---
 Tests/test_file_pdf.py | 1 +
 1 file changed, 1 insertion(+)

diff --git a/Tests/test_file_pdf.py b/Tests/test_file_pdf.py
index 3729ca58b34..1d5001b1a9b 100644
--- a/Tests/test_file_pdf.py
+++ b/Tests/test_file_pdf.py
@@ -229,6 +229,7 @@ def test_pdf_append_fails_on_nonexistent_file() -> None:
 
 
 def check_pdf_pages_consistency(pdf: PdfParser.PdfParser) -> None:
+    assert pdf.pages_ref is not None
     pages_info = pdf.read_indirect(pdf.pages_ref)
     assert b"Parent" not in pages_info
     assert b"Kids" in pages_info

From 41eb218a6829ddc58a282d6952d9c0b5af25688d Mon Sep 17 00:00:00 2001
From: Andrew Murray <radarhere@users.noreply.github.com>
Date: Sun, 7 Jul 2024 22:04:50 +1000
Subject: [PATCH 0801/1178] Check GIL, rather than Python version

---
 .ci/install.sh             | 4 ++--
 .github/workflows/test.yml | 4 ++--
 2 files changed, 4 insertions(+), 4 deletions(-)

diff --git a/.ci/install.sh b/.ci/install.sh
index e1274f41cc2..8e65f64c447 100755
--- a/.ci/install.sh
+++ b/.ci/install.sh
@@ -38,7 +38,7 @@ python3 -m pip install pyroma
 
 if [[ $(uname) != CYGWIN* ]]; then
     # TODO Update condition when NumPy supports free-threading
-    if [[ "$GHA_PYTHON_VERSION" == "3.13-dev" ]]; then
+    if [[ "$PYTHON_GIL" == "0" ]]; then
         python3 -m pip install numpy --index-url https://pypi.anaconda.org/scientific-python-nightly-wheels/simple
     else
         python3 -m pip install numpy
@@ -48,7 +48,7 @@ if [[ $(uname) != CYGWIN* ]]; then
     if [[ $GHA_PYTHON_VERSION == 3.* ]]; then
         sudo apt-get -qq install libegl1 libxcb-cursor0 libxcb-icccm4 libxcb-image0 libxcb-keysyms1 libxcb-randr0 libxcb-render-util0 libxcb-shape0 libxkbcommon-x11-0
         # TODO Update condition when pyqt6 supports free-threading
-        if ! [[ "$GHA_PYTHON_VERSION" == "3.13-dev" ]]; then python3 -m pip install pyqt6 ; fi
+        if ! [[ "$PYTHON_GIL" == "0" ]]; then python3 -m pip install pyqt6 ; fi
     fi
 
     # Pyroma uses non-isolated build and fails with old setuptools
diff --git a/.github/workflows/test.yml b/.github/workflows/test.yml
index 70284181417..6e63333b0da 100644
--- a/.github/workflows/test.yml
+++ b/.github/workflows/test.yml
@@ -67,7 +67,7 @@ jobs:
 
     - name: Set up Python ${{ matrix.python-version }}
       uses: actions/setup-python@v5
-      if: "!endsWith(matrix.python-version, '-dev')"
+      if: "${{ !matrix.disable-gil }}"
       with:
         python-version: ${{ matrix.python-version }}
         allow-prereleases: true
@@ -78,7 +78,7 @@ jobs:
 
     - name: Set up Python ${{ matrix.python-version }} (free-threaded)
       uses: deadsnakes/action@v3.1.0
-      if: endsWith(matrix.python-version, '-dev')
+      if: "${{ matrix.disable-gil }}"
       with:
         python-version: ${{ matrix.python-version }}
         nogil: ${{ matrix.disable-gil }}

From 8a05e32336bfbece4aed16a63d009efa55a1b4bb Mon Sep 17 00:00:00 2001
From: Andrew Murray <radarhere@users.noreply.github.com>
Date: Mon, 8 Jul 2024 20:09:45 +1000
Subject: [PATCH 0802/1178] Added type hints

---
 Tests/test_file_mpo.py       | 16 +++++++++----
 Tests/test_imagefile.py      |  5 +++-
 Tests/test_imagetk.py        |  3 +++
 src/PIL/BlpImagePlugin.py    |  1 +
 src/PIL/BmpImagePlugin.py    | 44 +++++++++++++++++++++++++-----------
 src/PIL/ImageFile.py         | 18 +++++++--------
 src/PIL/ImageTk.py           | 24 ++++++++++++++------
 src/PIL/Jpeg2KImagePlugin.py | 40 +++++++++++++++++++++++++++-----
 src/PIL/JpegImagePlugin.py   | 18 ++++++++-------
 src/PIL/MpoImagePlugin.py    | 17 ++++++++++----
 src/PIL/PngImagePlugin.py    | 42 +++++++++++++++++++++++-----------
 src/PIL/PsdImagePlugin.py    |  2 +-
 src/PIL/WebPImagePlugin.py   |  2 +-
 src/PIL/WmfImagePlugin.py    |  2 +-
 src/PIL/_imagingtk.pyi       |  3 +++
 15 files changed, 168 insertions(+), 69 deletions(-)
 create mode 100644 src/PIL/_imagingtk.pyi

diff --git a/Tests/test_file_mpo.py b/Tests/test_file_mpo.py
index 39b9c60b756..5402fcb440d 100644
--- a/Tests/test_file_mpo.py
+++ b/Tests/test_file_mpo.py
@@ -2,11 +2,11 @@
 
 import warnings
 from io import BytesIO
-from typing import Any, cast
+from typing import Any
 
 import pytest
 
-from PIL import Image, MpoImagePlugin
+from PIL import Image, ImageFile, MpoImagePlugin
 
 from .helper import (
     assert_image_equal,
@@ -20,11 +20,11 @@
 pytestmark = skip_unless_feature("jpg")
 
 
-def roundtrip(im: Image.Image, **options: Any) -> MpoImagePlugin.MpoImageFile:
+def roundtrip(im: Image.Image, **options: Any) -> ImageFile.ImageFile:
     out = BytesIO()
     im.save(out, "MPO", **options)
     out.seek(0)
-    return cast(MpoImagePlugin.MpoImageFile, Image.open(out))
+    return Image.open(out)
 
 
 @pytest.mark.parametrize("test_file", test_files)
@@ -226,6 +226,12 @@ def test_eoferror() -> None:
         im.seek(n_frames - 1)
 
 
+def test_adopt_jpeg() -> None:
+    with Image.open("Tests/images/hopper.jpg") as im:
+        with pytest.raises(ValueError):
+            MpoImagePlugin.MpoImageFile.adopt(im)
+
+
 def test_ultra_hdr() -> None:
     with Image.open("Tests/images/ultrahdr.jpg") as im:
         assert im.format == "JPEG"
@@ -275,6 +281,8 @@ def test_save_all() -> None:
     im_reloaded = roundtrip(im, save_all=True, append_images=[im2])
 
     assert_image_equal(im, im_reloaded)
+    assert isinstance(im_reloaded, MpoImagePlugin.MpoImageFile)
+    assert im_reloaded.mpinfo is not None
     assert im_reloaded.mpinfo[45056] == b"0100"
 
     im_reloaded.seek(1)
diff --git a/Tests/test_imagefile.py b/Tests/test_imagefile.py
index bb686bb3b90..b996860ce2c 100644
--- a/Tests/test_imagefile.py
+++ b/Tests/test_imagefile.py
@@ -90,6 +90,7 @@ def test_ico(self) -> None:
             data = f.read()
         with ImageFile.Parser() as p:
             p.feed(data)
+            assert p.image is not None
             assert (48, 48) == p.image.size
 
     @skip_unless_feature("webp")
@@ -103,6 +104,7 @@ def test_incremental_webp(self) -> None:
                 assert not p.image
 
                 p.feed(f.read())
+            assert p.image is not None
             assert (128, 128) == p.image.size
 
     @skip_unless_feature("zlib")
@@ -393,8 +395,9 @@ def test_encode(self) -> None:
         with pytest.raises(NotImplementedError):
             encoder.encode_to_pyfd()
 
+        fh = BytesIO()
         with pytest.raises(NotImplementedError):
-            encoder.encode_to_file(None, None)
+            encoder.encode_to_file(fh, 0)
 
     def test_zero_height(self) -> None:
         with pytest.raises(UnidentifiedImageError):
diff --git a/Tests/test_imagetk.py b/Tests/test_imagetk.py
index f84c6c03a37..4484dca1064 100644
--- a/Tests/test_imagetk.py
+++ b/Tests/test_imagetk.py
@@ -109,3 +109,6 @@ def test_bitmapimage() -> None:
 
     # reloaded = ImageTk.getimage(im_tk)
     # assert_image_equal(reloaded, im)
+
+    with pytest.raises(ValueError):
+        ImageTk.BitmapImage()
diff --git a/src/PIL/BlpImagePlugin.py b/src/PIL/BlpImagePlugin.py
index b9cefafdd07..6d71049a9d5 100644
--- a/src/PIL/BlpImagePlugin.py
+++ b/src/PIL/BlpImagePlugin.py
@@ -313,6 +313,7 @@ def _read_blp_header(self) -> None:
         self._blp_lengths = struct.unpack("<16I", self._safe_read(16 * 4))
 
     def _safe_read(self, length: int) -> bytes:
+        assert self.fd is not None
         return ImageFile._safe_read(self.fd, length)
 
     def _read_palette(self) -> list[tuple[int, int, int, int]]:
diff --git a/src/PIL/BmpImagePlugin.py b/src/PIL/BmpImagePlugin.py
index ef204533712..48bdd98307c 100644
--- a/src/PIL/BmpImagePlugin.py
+++ b/src/PIL/BmpImagePlugin.py
@@ -25,7 +25,7 @@
 from __future__ import annotations
 
 import os
-from typing import IO
+from typing import IO, Any
 
 from . import Image, ImageFile, ImagePalette
 from ._binary import i16le as i16
@@ -72,16 +72,20 @@ class BmpImageFile(ImageFile.ImageFile):
     for k, v in COMPRESSIONS.items():
         vars()[k] = v
 
-    def _bitmap(self, header=0, offset=0):
+    def _bitmap(self, header: int = 0, offset: int = 0) -> None:
         """Read relevant info about the BMP"""
         read, seek = self.fp.read, self.fp.seek
         if header:
             seek(header)
         # read bmp header size @offset 14 (this is part of the header size)
-        file_info = {"header_size": i32(read(4)), "direction": -1}
+        file_info: dict[str, bool | int | tuple[int, ...]] = {
+            "header_size": i32(read(4)),
+            "direction": -1,
+        }
 
         # -------------------- If requested, read header at a specific position
         # read the rest of the bmp header, without its size
+        assert isinstance(file_info["header_size"], int)
         header_data = ImageFile._safe_read(self.fp, file_info["header_size"] - 4)
 
         # ------------------------------- Windows Bitmap v2, IBM OS/2 Bitmap v1
@@ -92,7 +96,7 @@ def _bitmap(self, header=0, offset=0):
             file_info["height"] = i16(header_data, 2)
             file_info["planes"] = i16(header_data, 4)
             file_info["bits"] = i16(header_data, 6)
-            file_info["compression"] = self.RAW
+            file_info["compression"] = self.COMPRESSIONS["RAW"]
             file_info["palette_padding"] = 3
 
         # --------------------------------------------- Windows Bitmap v3 to v5
@@ -122,8 +126,9 @@ def _bitmap(self, header=0, offset=0):
             )
             file_info["colors"] = i32(header_data, 28)
             file_info["palette_padding"] = 4
+            assert isinstance(file_info["pixels_per_meter"], tuple)
             self.info["dpi"] = tuple(x / 39.3701 for x in file_info["pixels_per_meter"])
-            if file_info["compression"] == self.BITFIELDS:
+            if file_info["compression"] == self.COMPRESSIONS["BITFIELDS"]:
                 masks = ["r_mask", "g_mask", "b_mask"]
                 if len(header_data) >= 48:
                     if len(header_data) >= 52:
@@ -144,6 +149,10 @@ def _bitmap(self, header=0, offset=0):
                     file_info["a_mask"] = 0x0
                     for mask in masks:
                         file_info[mask] = i32(read(4))
+                assert isinstance(file_info["r_mask"], int)
+                assert isinstance(file_info["g_mask"], int)
+                assert isinstance(file_info["b_mask"], int)
+                assert isinstance(file_info["a_mask"], int)
                 file_info["rgb_mask"] = (
                     file_info["r_mask"],
                     file_info["g_mask"],
@@ -164,24 +173,26 @@ def _bitmap(self, header=0, offset=0):
         self._size = file_info["width"], file_info["height"]
 
         # ------- If color count was not found in the header, compute from bits
+        assert isinstance(file_info["bits"], int)
         file_info["colors"] = (
             file_info["colors"]
             if file_info.get("colors", 0)
             else (1 << file_info["bits"])
         )
+        assert isinstance(file_info["colors"], int)
         if offset == 14 + file_info["header_size"] and file_info["bits"] <= 8:
             offset += 4 * file_info["colors"]
 
         # ---------------------- Check bit depth for unusual unsupported values
-        self._mode, raw_mode = BIT2MODE.get(file_info["bits"], (None, None))
-        if self.mode is None:
+        self._mode, raw_mode = BIT2MODE.get(file_info["bits"], ("", ""))
+        if not self.mode:
             msg = f"Unsupported BMP pixel depth ({file_info['bits']})"
             raise OSError(msg)
 
         # ---------------- Process BMP with Bitfields compression (not palette)
         decoder_name = "raw"
-        if file_info["compression"] == self.BITFIELDS:
-            SUPPORTED = {
+        if file_info["compression"] == self.COMPRESSIONS["BITFIELDS"]:
+            SUPPORTED: dict[int, list[tuple[int, ...]]] = {
                 32: [
                     (0xFF0000, 0xFF00, 0xFF, 0x0),
                     (0xFF000000, 0xFF0000, 0xFF00, 0x0),
@@ -213,12 +224,14 @@ def _bitmap(self, header=0, offset=0):
                     file_info["bits"] == 32
                     and file_info["rgba_mask"] in SUPPORTED[file_info["bits"]]
                 ):
+                    assert isinstance(file_info["rgba_mask"], tuple)
                     raw_mode = MASK_MODES[(file_info["bits"], file_info["rgba_mask"])]
                     self._mode = "RGBA" if "A" in raw_mode else self.mode
                 elif (
                     file_info["bits"] in (24, 16)
                     and file_info["rgb_mask"] in SUPPORTED[file_info["bits"]]
                 ):
+                    assert isinstance(file_info["rgb_mask"], tuple)
                     raw_mode = MASK_MODES[(file_info["bits"], file_info["rgb_mask"])]
                 else:
                     msg = "Unsupported BMP bitfields layout"
@@ -226,10 +239,13 @@ def _bitmap(self, header=0, offset=0):
             else:
                 msg = "Unsupported BMP bitfields layout"
                 raise OSError(msg)
-        elif file_info["compression"] == self.RAW:
+        elif file_info["compression"] == self.COMPRESSIONS["RAW"]:
             if file_info["bits"] == 32 and header == 22:  # 32-bit .cur offset
                 raw_mode, self._mode = "BGRA", "RGBA"
-        elif file_info["compression"] in (self.RLE8, self.RLE4):
+        elif file_info["compression"] in (
+            self.COMPRESSIONS["RLE8"],
+            self.COMPRESSIONS["RLE4"],
+        ):
             decoder_name = "bmp_rle"
         else:
             msg = f"Unsupported BMP compression ({file_info['compression']})"
@@ -242,6 +258,7 @@ def _bitmap(self, header=0, offset=0):
                 msg = f"Unsupported BMP Palette size ({file_info['colors']})"
                 raise OSError(msg)
             else:
+                assert isinstance(file_info["palette_padding"], int)
                 padding = file_info["palette_padding"]
                 palette = read(padding * file_info["colors"])
                 grayscale = True
@@ -269,10 +286,11 @@ def _bitmap(self, header=0, offset=0):
 
         # ---------------------------- Finally set the tile data for the plugin
         self.info["compression"] = file_info["compression"]
-        args = [raw_mode]
+        args: list[Any] = [raw_mode]
         if decoder_name == "bmp_rle":
-            args.append(file_info["compression"] == self.RLE4)
+            args.append(file_info["compression"] == self.COMPRESSIONS["RLE4"])
         else:
+            assert isinstance(file_info["width"], int)
             args.append(((file_info["width"] * file_info["bits"] + 31) >> 3) & (~3))
         args.append(file_info["direction"])
         self.tile = [
diff --git a/src/PIL/ImageFile.py b/src/PIL/ImageFile.py
index 69e7ee54811..99d7e73f111 100644
--- a/src/PIL/ImageFile.py
+++ b/src/PIL/ImageFile.py
@@ -485,7 +485,7 @@ def feed(self, data):
 
                 self.image = im
 
-    def __enter__(self):
+    def __enter__(self) -> Parser:
         return self
 
     def __exit__(self, *args: object) -> None:
@@ -580,7 +580,7 @@ def _encode_tile(im, fp, tile: list[_Tile], bufsize, fh, exc=None):
             encoder.cleanup()
 
 
-def _safe_read(fp, size):
+def _safe_read(fp: IO[bytes], size: int) -> bytes:
     """
     Reads large blocks in a safe way.  Unlike fp.read(n), this function
     doesn't trust the user.  If the requested size is larger than
@@ -601,18 +601,18 @@ def _safe_read(fp, size):
             msg = "Truncated File Read"
             raise OSError(msg)
         return data
-    data = []
+    blocks: list[bytes] = []
     remaining_size = size
     while remaining_size > 0:
         block = fp.read(min(remaining_size, SAFEBLOCK))
         if not block:
             break
-        data.append(block)
+        blocks.append(block)
         remaining_size -= len(block)
-    if sum(len(d) for d in data) < size:
+    if sum(len(block) for block in blocks) < size:
         msg = "Truncated File Read"
         raise OSError(msg)
-    return b"".join(data)
+    return b"".join(blocks)
 
 
 class PyCodecState:
@@ -636,7 +636,7 @@ def __init__(self, mode, *args):
         self.mode = mode
         self.init(args)
 
-    def init(self, args):
+    def init(self, args) -> None:
         """
         Override to perform codec specific initialization
 
@@ -653,7 +653,7 @@ def cleanup(self) -> None:
         """
         pass
 
-    def setfd(self, fd):
+    def setfd(self, fd) -> None:
         """
         Called from ImageFile to set the Python file-like object
 
@@ -793,7 +793,7 @@ def encode_to_pyfd(self) -> tuple[int, int]:
             self.fd.write(data)
         return bytes_consumed, errcode
 
-    def encode_to_file(self, fh, bufsize):
+    def encode_to_file(self, fh: IO[bytes], bufsize: int) -> int:
         """
         :param fh: File handle.
         :param bufsize: Buffer size.
diff --git a/src/PIL/ImageTk.py b/src/PIL/ImageTk.py
index 6aa70ced3e6..6b13e57a076 100644
--- a/src/PIL/ImageTk.py
+++ b/src/PIL/ImageTk.py
@@ -28,7 +28,7 @@
 
 import tkinter
 from io import BytesIO
-from typing import Any
+from typing import TYPE_CHECKING, Any, cast
 
 from . import Image, ImageFile
 
@@ -61,7 +61,9 @@ def _get_image_from_kw(kw: dict[str, Any]) -> ImageFile.ImageFile | None:
     return Image.open(source)
 
 
-def _pyimagingtkcall(command, photo, id):
+def _pyimagingtkcall(
+    command: str, photo: PhotoImage | tkinter.PhotoImage, id: int
+) -> None:
     tk = photo.tk
     try:
         tk.call(command, photo, id)
@@ -215,11 +217,14 @@ class BitmapImage:
     :param image: A PIL image.
     """
 
-    def __init__(self, image=None, **kw):
+    def __init__(self, image: Image.Image | None = None, **kw: Any) -> None:
         # Tk compatibility: file or data
         if image is None:
             image = _get_image_from_kw(kw)
 
+        if image is None:
+            msg = "Image is required"
+            raise ValueError(msg)
         self.__mode = image.mode
         self.__size = image.size
 
@@ -278,18 +283,23 @@ def getimage(photo: PhotoImage) -> Image.Image:
     return im
 
 
-def _show(image, title):
+def _show(image: Image.Image, title: str | None) -> None:
     """Helper for the Image.show method."""
 
     class UI(tkinter.Label):
-        def __init__(self, master, im):
+        def __init__(self, master: tkinter.Toplevel, im: Image.Image) -> None:
+            self.image: BitmapImage | PhotoImage
             if im.mode == "1":
                 self.image = BitmapImage(im, foreground="white", master=master)
             else:
                 self.image = PhotoImage(im, master=master)
-            super().__init__(master, image=self.image, bg="black", bd=0)
+            if TYPE_CHECKING:
+                image = cast(tkinter._Image, self.image)
+            else:
+                image = self.image
+            super().__init__(master, image=image, bg="black", bd=0)
 
-    if not tkinter._default_root:
+    if not getattr(tkinter, "_default_root"):
         msg = "tkinter not initialized"
         raise OSError(msg)
     top = tkinter.Toplevel()
diff --git a/src/PIL/Jpeg2KImagePlugin.py b/src/PIL/Jpeg2KImagePlugin.py
index 992b9ccaf31..eeec41686ca 100644
--- a/src/PIL/Jpeg2KImagePlugin.py
+++ b/src/PIL/Jpeg2KImagePlugin.py
@@ -29,7 +29,7 @@ class BoxReader:
     and to easily step into and read sub-boxes.
     """
 
-    def __init__(self, fp, length=-1):
+    def __init__(self, fp: IO[bytes], length: int = -1) -> None:
         self.fp = fp
         self.has_length = length >= 0
         self.length = length
@@ -97,7 +97,7 @@ def next_box_type(self) -> bytes:
         return tbox
 
 
-def _parse_codestream(fp) -> tuple[tuple[int, int], str]:
+def _parse_codestream(fp: IO[bytes]) -> tuple[tuple[int, int], str]:
     """Parse the JPEG 2000 codestream to extract the size and component
     count from the SIZ marker segment, returning a PIL (size, mode) tuple."""
 
@@ -137,7 +137,15 @@ def _res_to_dpi(num: int, denom: int, exp: int) -> float | None:
     return (254 * num * (10**exp)) / (10000 * denom)
 
 
-def _parse_jp2_header(fp):
+def _parse_jp2_header(
+    fp: IO[bytes],
+) -> tuple[
+    tuple[int, int],
+    str,
+    str | None,
+    tuple[float, float] | None,
+    ImagePalette.ImagePalette | None,
+]:
     """Parse the JP2 header box to extract size, component count,
     color space information, and optionally DPI information,
     returning a (size, mode, mimetype, dpi) tuple."""
@@ -155,6 +163,7 @@ def _parse_jp2_header(fp):
         elif tbox == b"ftyp":
             if reader.read_fields(">4s")[0] == b"jpx ":
                 mimetype = "image/jpx"
+    assert header is not None
 
     size = None
     mode = None
@@ -168,6 +177,9 @@ def _parse_jp2_header(fp):
 
         if tbox == b"ihdr":
             height, width, nc, bpc = header.read_fields(">IIHB")
+            assert isinstance(height, int)
+            assert isinstance(width, int)
+            assert isinstance(bpc, int)
             size = (width, height)
             if nc == 1 and (bpc & 0x7F) > 8:
                 mode = "I;16"
@@ -185,11 +197,21 @@ def _parse_jp2_header(fp):
                 mode = "CMYK"
         elif tbox == b"pclr" and mode in ("L", "LA"):
             ne, npc = header.read_fields(">HB")
-            bitdepths = header.read_fields(">" + ("B" * npc))
-            if max(bitdepths) <= 8:
+            assert isinstance(ne, int)
+            assert isinstance(npc, int)
+            max_bitdepth = 0
+            for bitdepth in header.read_fields(">" + ("B" * npc)):
+                assert isinstance(bitdepth, int)
+                if bitdepth > max_bitdepth:
+                    max_bitdepth = bitdepth
+            if max_bitdepth <= 8:
                 palette = ImagePalette.ImagePalette()
                 for i in range(ne):
-                    palette.getcolor(header.read_fields(">" + ("B" * npc)))
+                    color: list[int] = []
+                    for value in header.read_fields(">" + ("B" * npc)):
+                        assert isinstance(value, int)
+                        color.append(value)
+                    palette.getcolor(tuple(color))
                 mode = "P" if mode == "L" else "PA"
         elif tbox == b"res ":
             res = header.read_boxes()
@@ -197,6 +219,12 @@ def _parse_jp2_header(fp):
                 tres = res.next_box_type()
                 if tres == b"resc":
                     vrcn, vrcd, hrcn, hrcd, vrce, hrce = res.read_fields(">HHHHBB")
+                    assert isinstance(vrcn, int)
+                    assert isinstance(vrcd, int)
+                    assert isinstance(hrcn, int)
+                    assert isinstance(hrcd, int)
+                    assert isinstance(vrce, int)
+                    assert isinstance(hrce, int)
                     hres = _res_to_dpi(hrcn, hrcd, hrce)
                     vres = _res_to_dpi(vrcn, vrcd, vrce)
                     if hres is not None and vres is not None:
diff --git a/src/PIL/JpegImagePlugin.py b/src/PIL/JpegImagePlugin.py
index b15bf06d2b1..4916727beae 100644
--- a/src/PIL/JpegImagePlugin.py
+++ b/src/PIL/JpegImagePlugin.py
@@ -60,7 +60,7 @@ def Skip(self: JpegImageFile, marker: int) -> None:
     ImageFile._safe_read(self.fp, n)
 
 
-def APP(self, marker):
+def APP(self: JpegImageFile, marker: int) -> None:
     #
     # Application marker.  Store these in the APP dictionary.
     # Also look for well-known application markers.
@@ -133,13 +133,14 @@ def APP(self, marker):
                 offset += 4
                 data = s[offset : offset + size]
                 if code == 0x03ED:  # ResolutionInfo
-                    data = {
+                    photoshop[code] = {
                         "XResolution": i32(data, 0) / 65536,
                         "DisplayedUnitsX": i16(data, 4),
                         "YResolution": i32(data, 8) / 65536,
                         "DisplayedUnitsY": i16(data, 12),
                     }
-                photoshop[code] = data
+                else:
+                    photoshop[code] = data
                 offset += size
                 offset += offset & 1  # align
             except struct.error:
@@ -338,6 +339,7 @@ def _open(self):
 
         # Create attributes
         self.bits = self.layers = 0
+        self._exif_offset = 0
 
         # JPEG specifics (internal)
         self.layer = []
@@ -498,17 +500,17 @@ def _read_dpi_from_exif(self) -> None:
         ):
             self.info["dpi"] = 72, 72
 
-    def _getmp(self):
+    def _getmp(self) -> dict[int, Any] | None:
         return _getmp(self)
 
 
-def _getexif(self) -> dict[str, Any] | None:
+def _getexif(self: JpegImageFile) -> dict[str, Any] | None:
     if "exif" not in self.info:
         return None
     return self.getexif()._get_merged_dict()
 
 
-def _getmp(self):
+def _getmp(self: JpegImageFile) -> dict[int, Any] | None:
     # Extract MP information.  This method was inspired by the "highly
     # experimental" _getexif version that's been in use for years now,
     # itself based on the ImageFileDirectory class in the TIFF plugin.
@@ -616,7 +618,7 @@ def _getmp(self):
 # fmt: on
 
 
-def get_sampling(im):
+def get_sampling(im: Image.Image) -> int:
     # There's no subsampling when images have only 1 layer
     # (grayscale images) or when they are CMYK (4 layers),
     # so set subsampling to the default value.
@@ -624,7 +626,7 @@ def get_sampling(im):
     # NOTE: currently Pillow can't encode JPEG to YCCK format.
     # If YCCK support is added in the future, subsampling code will have
     # to be updated (here and in JpegEncode.c) to deal with 4 layers.
-    if not hasattr(im, "layers") or im.layers in (1, 4):
+    if not isinstance(im, JpegImageFile) or im.layers in (1, 4):
         return -1
     sampling = im.layer[0][1:3] + im.layer[1][1:3] + im.layer[2][1:3]
     return samplings.get(sampling, -1)
diff --git a/src/PIL/MpoImagePlugin.py b/src/PIL/MpoImagePlugin.py
index f21570661f8..5ed9f56a164 100644
--- a/src/PIL/MpoImagePlugin.py
+++ b/src/PIL/MpoImagePlugin.py
@@ -22,7 +22,7 @@
 import itertools
 import os
 import struct
-from typing import IO
+from typing import IO, Any, cast
 
 from . import (
     Image,
@@ -101,8 +101,11 @@ def _open(self) -> None:
         JpegImagePlugin.JpegImageFile._open(self)
         self._after_jpeg_open()
 
-    def _after_jpeg_open(self, mpheader=None):
+    def _after_jpeg_open(self, mpheader: dict[int, Any] | None = None) -> None:
         self.mpinfo = mpheader if mpheader is not None else self._getmp()
+        if self.mpinfo is None:
+            msg = "Image appears to be a malformed MPO file"
+            raise ValueError(msg)
         self.n_frames = self.mpinfo[0xB001]
         self.__mpoffsets = [
             mpent["DataOffset"] + self.info["mpoffset"] for mpent in self.mpinfo[0xB002]
@@ -149,7 +152,10 @@ def tell(self) -> int:
         return self.__frame
 
     @staticmethod
-    def adopt(jpeg_instance, mpheader=None):
+    def adopt(
+        jpeg_instance: JpegImagePlugin.JpegImageFile,
+        mpheader: dict[int, Any] | None = None,
+    ) -> MpoImageFile:
         """
         Transform the instance of JpegImageFile into
         an instance of MpoImageFile.
@@ -161,8 +167,9 @@ def adopt(jpeg_instance, mpheader=None):
         double call to _open.
         """
         jpeg_instance.__class__ = MpoImageFile
-        jpeg_instance._after_jpeg_open(mpheader)
-        return jpeg_instance
+        mpo_instance = cast(MpoImageFile, jpeg_instance)
+        mpo_instance._after_jpeg_open(mpheader)
+        return mpo_instance
 
 
 # ---------------------------------------------------------------------
diff --git a/src/PIL/PngImagePlugin.py b/src/PIL/PngImagePlugin.py
index 34ea77c5e01..fa117d19ae1 100644
--- a/src/PIL/PngImagePlugin.py
+++ b/src/PIL/PngImagePlugin.py
@@ -230,6 +230,7 @@ def verify(self, endchunk: bytes = b"IEND") -> list[bytes]:
 
         cids = []
 
+        assert self.fp is not None
         while True:
             try:
                 cid, pos, length = self.read()
@@ -407,6 +408,7 @@ def rewind(self) -> None:
 
     def chunk_iCCP(self, pos: int, length: int) -> bytes:
         # ICC profile
+        assert self.fp is not None
         s = ImageFile._safe_read(self.fp, length)
         # according to PNG spec, the iCCP chunk contains:
         # Profile name  1-79 bytes (character string)
@@ -434,6 +436,7 @@ def chunk_iCCP(self, pos: int, length: int) -> bytes:
 
     def chunk_IHDR(self, pos: int, length: int) -> bytes:
         # image header
+        assert self.fp is not None
         s = ImageFile._safe_read(self.fp, length)
         if length < 13:
             if ImageFile.LOAD_TRUNCATED_IMAGES:
@@ -471,6 +474,7 @@ def chunk_IEND(self, pos: int, length: int) -> NoReturn:
 
     def chunk_PLTE(self, pos: int, length: int) -> bytes:
         # palette
+        assert self.fp is not None
         s = ImageFile._safe_read(self.fp, length)
         if self.im_mode == "P":
             self.im_palette = "RGB", s
@@ -478,6 +482,7 @@ def chunk_PLTE(self, pos: int, length: int) -> bytes:
 
     def chunk_tRNS(self, pos: int, length: int) -> bytes:
         # transparency
+        assert self.fp is not None
         s = ImageFile._safe_read(self.fp, length)
         if self.im_mode == "P":
             if _simple_palette.match(s):
@@ -498,6 +503,7 @@ def chunk_tRNS(self, pos: int, length: int) -> bytes:
 
     def chunk_gAMA(self, pos: int, length: int) -> bytes:
         # gamma setting
+        assert self.fp is not None
         s = ImageFile._safe_read(self.fp, length)
         self.im_info["gamma"] = i32(s) / 100000.0
         return s
@@ -506,6 +512,7 @@ def chunk_cHRM(self, pos: int, length: int) -> bytes:
         # chromaticity, 8 unsigned ints, actual value is scaled by 100,000
         # WP x,y, Red x,y, Green x,y Blue x,y
 
+        assert self.fp is not None
         s = ImageFile._safe_read(self.fp, length)
         raw_vals = struct.unpack(">%dI" % (len(s) // 4), s)
         self.im_info["chromaticity"] = tuple(elt / 100000.0 for elt in raw_vals)
@@ -518,6 +525,7 @@ def chunk_sRGB(self, pos: int, length: int) -> bytes:
         # 2 saturation
         # 3 absolute colorimetric
 
+        assert self.fp is not None
         s = ImageFile._safe_read(self.fp, length)
         if length < 1:
             if ImageFile.LOAD_TRUNCATED_IMAGES:
@@ -529,6 +537,7 @@ def chunk_sRGB(self, pos: int, length: int) -> bytes:
 
     def chunk_pHYs(self, pos: int, length: int) -> bytes:
         # pixels per unit
+        assert self.fp is not None
         s = ImageFile._safe_read(self.fp, length)
         if length < 9:
             if ImageFile.LOAD_TRUNCATED_IMAGES:
@@ -546,6 +555,7 @@ def chunk_pHYs(self, pos: int, length: int) -> bytes:
 
     def chunk_tEXt(self, pos: int, length: int) -> bytes:
         # text
+        assert self.fp is not None
         s = ImageFile._safe_read(self.fp, length)
         try:
             k, v = s.split(b"\0", 1)
@@ -554,17 +564,18 @@ def chunk_tEXt(self, pos: int, length: int) -> bytes:
             k = s
             v = b""
         if k:
-            k = k.decode("latin-1", "strict")
+            k_str = k.decode("latin-1", "strict")
             v_str = v.decode("latin-1", "replace")
 
-            self.im_info[k] = v if k == "exif" else v_str
-            self.im_text[k] = v_str
+            self.im_info[k_str] = v if k == b"exif" else v_str
+            self.im_text[k_str] = v_str
             self.check_text_memory(len(v_str))
 
         return s
 
     def chunk_zTXt(self, pos: int, length: int) -> bytes:
         # compressed text
+        assert self.fp is not None
         s = ImageFile._safe_read(self.fp, length)
         try:
             k, v = s.split(b"\0", 1)
@@ -589,16 +600,17 @@ def chunk_zTXt(self, pos: int, length: int) -> bytes:
             v = b""
 
         if k:
-            k = k.decode("latin-1", "strict")
-            v = v.decode("latin-1", "replace")
+            k_str = k.decode("latin-1", "strict")
+            v_str = v.decode("latin-1", "replace")
 
-            self.im_info[k] = self.im_text[k] = v
-            self.check_text_memory(len(v))
+            self.im_info[k_str] = self.im_text[k_str] = v_str
+            self.check_text_memory(len(v_str))
 
         return s
 
     def chunk_iTXt(self, pos: int, length: int) -> bytes:
         # international text
+        assert self.fp is not None
         r = s = ImageFile._safe_read(self.fp, length)
         try:
             k, r = r.split(b"\0", 1)
@@ -627,25 +639,27 @@ def chunk_iTXt(self, pos: int, length: int) -> bytes:
         if k == b"XML:com.adobe.xmp":
             self.im_info["xmp"] = v
         try:
-            k = k.decode("latin-1", "strict")
-            lang = lang.decode("utf-8", "strict")
-            tk = tk.decode("utf-8", "strict")
-            v = v.decode("utf-8", "strict")
+            k_str = k.decode("latin-1", "strict")
+            lang_str = lang.decode("utf-8", "strict")
+            tk_str = tk.decode("utf-8", "strict")
+            v_str = v.decode("utf-8", "strict")
         except UnicodeError:
             return s
 
-        self.im_info[k] = self.im_text[k] = iTXt(v, lang, tk)
-        self.check_text_memory(len(v))
+        self.im_info[k_str] = self.im_text[k_str] = iTXt(v_str, lang_str, tk_str)
+        self.check_text_memory(len(v_str))
 
         return s
 
     def chunk_eXIf(self, pos: int, length: int) -> bytes:
+        assert self.fp is not None
         s = ImageFile._safe_read(self.fp, length)
         self.im_info["exif"] = b"Exif\x00\x00" + s
         return s
 
     # APNG chunks
     def chunk_acTL(self, pos: int, length: int) -> bytes:
+        assert self.fp is not None
         s = ImageFile._safe_read(self.fp, length)
         if length < 8:
             if ImageFile.LOAD_TRUNCATED_IMAGES:
@@ -666,6 +680,7 @@ def chunk_acTL(self, pos: int, length: int) -> bytes:
         return s
 
     def chunk_fcTL(self, pos: int, length: int) -> bytes:
+        assert self.fp is not None
         s = ImageFile._safe_read(self.fp, length)
         if length < 26:
             if ImageFile.LOAD_TRUNCATED_IMAGES:
@@ -695,6 +710,7 @@ def chunk_fcTL(self, pos: int, length: int) -> bytes:
         return s
 
     def chunk_fdAT(self, pos: int, length: int) -> bytes:
+        assert self.fp is not None
         if length < 4:
             if ImageFile.LOAD_TRUNCATED_IMAGES:
                 s = ImageFile._safe_read(self.fp, length)
diff --git a/src/PIL/PsdImagePlugin.py b/src/PIL/PsdImagePlugin.py
index edf698bf02d..31dfd4d1234 100644
--- a/src/PIL/PsdImagePlugin.py
+++ b/src/PIL/PsdImagePlugin.py
@@ -185,7 +185,7 @@ def _layerinfo(fp, ct_bytes):
     # read layerinfo block
     layers = []
 
-    def read(size):
+    def read(size: int) -> bytes:
         return ImageFile._safe_read(fp, size)
 
     ct = si16(read(2))
diff --git a/src/PIL/WebPImagePlugin.py b/src/PIL/WebPImagePlugin.py
index 530b88c8bd6..011de9c6ac0 100644
--- a/src/PIL/WebPImagePlugin.py
+++ b/src/PIL/WebPImagePlugin.py
@@ -115,7 +115,7 @@ def _reset(self, reset: bool = True) -> None:
         self.__loaded = -1
         self.__timestamp = 0
 
-    def _get_next(self):
+    def _get_next(self) -> tuple[bytes, int, int]:
         # Get next frame
         ret = self._decoder.get_next()
         self.__physical_frame += 1
diff --git a/src/PIL/WmfImagePlugin.py b/src/PIL/WmfImagePlugin.py
index 3d5cddcc8f5..68f8a74f599 100644
--- a/src/PIL/WmfImagePlugin.py
+++ b/src/PIL/WmfImagePlugin.py
@@ -152,7 +152,7 @@ def _open(self) -> None:
     def _load(self) -> ImageFile.StubHandler | None:
         return _handler
 
-    def load(self, dpi=None):
+    def load(self, dpi: int | None = None) -> Image.core.PixelAccess | None:
         if dpi is not None and self._inch is not None:
             self.info["dpi"] = dpi
             x0, y0, x1, y1 = self.info["wmf_bbox"]
diff --git a/src/PIL/_imagingtk.pyi b/src/PIL/_imagingtk.pyi
new file mode 100644
index 00000000000..e27843e5338
--- /dev/null
+++ b/src/PIL/_imagingtk.pyi
@@ -0,0 +1,3 @@
+from typing import Any
+
+def __getattr__(name: str) -> Any: ...

From 69f967301d11a5b37495542ba64633b085c9b357 Mon Sep 17 00:00:00 2001
From: Hugo van Kemenade <1324225+hugovk@users.noreply.github.com>
Date: Tue, 2 Jul 2024 17:48:46 +0300
Subject: [PATCH 0803/1178] Call PyUnstable_Module_SetGIL() to indicate support
 of running with GIL disabled

---
 src/_imaging.c      | 4 ++++
 src/_imagingcms.c   | 4 ++++
 src/_imagingft.c    | 4 ++++
 src/_imagingmath.c  | 4 ++++
 src/_imagingmorph.c | 4 ++++
 src/_imagingtk.c    | 5 +++++
 src/_webp.c         | 4 ++++
 7 files changed, 29 insertions(+)

diff --git a/src/_imaging.c b/src/_imaging.c
index ddc8d288550..03e10e5472c 100644
--- a/src/_imaging.c
+++ b/src/_imaging.c
@@ -4448,5 +4448,9 @@ PyInit__imaging(void) {
         return NULL;
     }
 
+#ifdef Py_GIL_DISABLED
+    PyUnstable_Module_SetGIL(m, Py_MOD_GIL_NOT_USED);
+#endif
+
     return m;
 }
diff --git a/src/_imagingcms.c b/src/_imagingcms.c
index 590e1b983a9..628662b304f 100644
--- a/src/_imagingcms.c
+++ b/src/_imagingcms.c
@@ -1538,5 +1538,9 @@ PyInit__imagingcms(void) {
 
     PyDateTime_IMPORT;
 
+#ifdef Py_GIL_DISABLED
+    PyUnstable_Module_SetGIL(m, Py_MOD_GIL_NOT_USED);
+#endif
+
     return m;
 }
diff --git a/src/_imagingft.c b/src/_imagingft.c
index ba36cc72c23..1bef876e15c 100644
--- a/src/_imagingft.c
+++ b/src/_imagingft.c
@@ -1576,5 +1576,9 @@ PyInit__imagingft(void) {
         return NULL;
     }
 
+#ifdef Py_GIL_DISABLED
+    PyUnstable_Module_SetGIL(m, Py_MOD_GIL_NOT_USED);
+#endif
+
     return m;
 }
diff --git a/src/_imagingmath.c b/src/_imagingmath.c
index 067c165b248..a2ddc91b9b3 100644
--- a/src/_imagingmath.c
+++ b/src/_imagingmath.c
@@ -290,5 +290,9 @@ PyInit__imagingmath(void) {
         return NULL;
     }
 
+#ifdef Py_GIL_DISABLED
+    PyUnstable_Module_SetGIL(m, Py_MOD_GIL_NOT_USED);
+#endif
+
     return m;
 }
diff --git a/src/_imagingmorph.c b/src/_imagingmorph.c
index 8815c2b7ec6..a95ce75bf60 100644
--- a/src/_imagingmorph.c
+++ b/src/_imagingmorph.c
@@ -269,5 +269,9 @@ PyInit__imagingmorph(void) {
 
     m = PyModule_Create(&module_def);
 
+#ifdef Py_GIL_DISABLED
+    PyUnstable_Module_SetGIL(m, Py_MOD_GIL_NOT_USED);
+#endif
+
     return m;
 }
diff --git a/src/_imagingtk.c b/src/_imagingtk.c
index efa7fc1b6fa..c70d044bb86 100644
--- a/src/_imagingtk.c
+++ b/src/_imagingtk.c
@@ -62,5 +62,10 @@ PyInit__imagingtk(void) {
         Py_DECREF(m);
         return NULL;
     }
+
+#ifdef Py_GIL_DISABLED
+    PyUnstable_Module_SetGIL(m, Py_MOD_GIL_NOT_USED);
+#endif
+
     return m;
 }
diff --git a/src/_webp.c b/src/_webp.c
index 0a70e335757..dfa24da4139 100644
--- a/src/_webp.c
+++ b/src/_webp.c
@@ -1005,5 +1005,9 @@ PyInit__webp(void) {
         return NULL;
     }
 
+#ifdef Py_GIL_DISABLED
+    PyUnstable_Module_SetGIL(m, Py_MOD_GIL_NOT_USED);
+#endif
+
     return m;
 }

From 377bdc0db1415dcbd664b1b9c467d995500809d2 Mon Sep 17 00:00:00 2001
From: Hugo van Kemenade <1324225+hugovk@users.noreply.github.com>
Date: Tue, 2 Jul 2024 18:27:09 +0300
Subject: [PATCH 0804/1178] encode: Replace PyList_GetItem with
 PyList_GetItemRef

---
 src/encode.c                       |    5 +-
 src/thirdparty/pythoncapi_compat.h | 1360 ++++++++++++++++++++++++++++
 2 files changed, 1363 insertions(+), 2 deletions(-)
 create mode 100644 src/thirdparty/pythoncapi_compat.h

diff --git a/src/encode.c b/src/encode.c
index 442b5d04f88..72ad3fa07a2 100644
--- a/src/encode.c
+++ b/src/encode.c
@@ -25,6 +25,7 @@
 #define PY_SSIZE_T_CLEAN
 #include "Python.h"
 
+#include "thirdparty/pythoncapi_compat.h"
 #include "libImaging/Imaging.h"
 #include "libImaging/Gif.h"
 
@@ -671,7 +672,7 @@ PyImaging_LibTiffEncoderNew(PyObject *self, PyObject *args) {
         tags_size = PyList_Size(tags);
         TRACE(("tags size: %d\n", (int)tags_size));
         for (pos = 0; pos < tags_size; pos++) {
-            item = PyList_GetItem(tags, pos);
+            item = PyList_GetItemRef(tags, pos);
             if (!PyTuple_Check(item) || PyTuple_Size(item) != 2) {
                 PyErr_SetString(PyExc_ValueError, "Invalid tags list");
                 return NULL;
@@ -703,7 +704,7 @@ PyImaging_LibTiffEncoderNew(PyObject *self, PyObject *args) {
 
     num_core_tags = sizeof(core_tags) / sizeof(int);
     for (pos = 0; pos < tags_size; pos++) {
-        item = PyList_GetItem(tags, pos);
+        item = PyList_GetItemRef(tags, pos);
         // We already checked that tags is a 2-tuple list.
         key = PyTuple_GetItem(item, 0);
         key_int = (int)PyLong_AsLong(key);
diff --git a/src/thirdparty/pythoncapi_compat.h b/src/thirdparty/pythoncapi_compat.h
new file mode 100644
index 00000000000..51e8c0de752
--- /dev/null
+++ b/src/thirdparty/pythoncapi_compat.h
@@ -0,0 +1,1360 @@
+// Header file providing new C API functions to old Python versions.
+//
+// File distributed under the Zero Clause BSD (0BSD) license.
+// Copyright Contributors to the pythoncapi_compat project.
+//
+// Homepage:
+// https://github.com/python/pythoncapi_compat
+//
+// Latest version:
+// https://raw.githubusercontent.com/python/pythoncapi_compat/master/pythoncapi_compat.h
+//
+// SPDX-License-Identifier: 0BSD
+
+#ifndef PYTHONCAPI_COMPAT
+#define PYTHONCAPI_COMPAT
+
+#ifdef __cplusplus
+extern "C" {
+#endif
+
+#include <Python.h>
+
+// Python 3.11.0b4 added PyFrame_Back() to Python.h
+#if PY_VERSION_HEX < 0x030b00B4 && !defined(PYPY_VERSION)
+#  include "frameobject.h"        // PyFrameObject, PyFrame_GetBack()
+#endif
+
+
+#ifndef _Py_CAST
+#  define _Py_CAST(type, expr) ((type)(expr))
+#endif
+
+// Static inline functions should use _Py_NULL rather than using directly NULL
+// to prevent C++ compiler warnings. On C23 and newer and on C++11 and newer,
+// _Py_NULL is defined as nullptr.
+#if (defined (__STDC_VERSION__) && __STDC_VERSION__ > 201710L) \
+        || (defined(__cplusplus) && __cplusplus >= 201103)
+#  define _Py_NULL nullptr
+#else
+#  define _Py_NULL NULL
+#endif
+
+// Cast argument to PyObject* type.
+#ifndef _PyObject_CAST
+#  define _PyObject_CAST(op) _Py_CAST(PyObject*, op)
+#endif
+
+
+// bpo-42262 added Py_NewRef() to Python 3.10.0a3
+#if PY_VERSION_HEX < 0x030A00A3 && !defined(Py_NewRef)
+static inline PyObject* _Py_NewRef(PyObject *obj)
+{
+    Py_INCREF(obj);
+    return obj;
+}
+#define Py_NewRef(obj) _Py_NewRef(_PyObject_CAST(obj))
+#endif
+
+
+// bpo-42262 added Py_XNewRef() to Python 3.10.0a3
+#if PY_VERSION_HEX < 0x030A00A3 && !defined(Py_XNewRef)
+static inline PyObject* _Py_XNewRef(PyObject *obj)
+{
+    Py_XINCREF(obj);
+    return obj;
+}
+#define Py_XNewRef(obj) _Py_XNewRef(_PyObject_CAST(obj))
+#endif
+
+
+// bpo-39573 added Py_SET_REFCNT() to Python 3.9.0a4
+#if PY_VERSION_HEX < 0x030900A4 && !defined(Py_SET_REFCNT)
+static inline void _Py_SET_REFCNT(PyObject *ob, Py_ssize_t refcnt)
+{
+    ob->ob_refcnt = refcnt;
+}
+#define Py_SET_REFCNT(ob, refcnt) _Py_SET_REFCNT(_PyObject_CAST(ob), refcnt)
+#endif
+
+
+// Py_SETREF() and Py_XSETREF() were added to Python 3.5.2.
+// It is excluded from the limited C API.
+#if (PY_VERSION_HEX < 0x03050200 && !defined(Py_SETREF)) && !defined(Py_LIMITED_API)
+#define Py_SETREF(dst, src)                                     \
+    do {                                                        \
+        PyObject **_tmp_dst_ptr = _Py_CAST(PyObject**, &(dst)); \
+        PyObject *_tmp_dst = (*_tmp_dst_ptr);                   \
+        *_tmp_dst_ptr = _PyObject_CAST(src);                    \
+        Py_DECREF(_tmp_dst);                                    \
+    } while (0)
+
+#define Py_XSETREF(dst, src)                                    \
+    do {                                                        \
+        PyObject **_tmp_dst_ptr = _Py_CAST(PyObject**, &(dst)); \
+        PyObject *_tmp_dst = (*_tmp_dst_ptr);                   \
+        *_tmp_dst_ptr = _PyObject_CAST(src);                    \
+        Py_XDECREF(_tmp_dst);                                   \
+    } while (0)
+#endif
+
+
+// bpo-43753 added Py_Is(), Py_IsNone(), Py_IsTrue() and Py_IsFalse()
+// to Python 3.10.0b1.
+#if PY_VERSION_HEX < 0x030A00B1 && !defined(Py_Is)
+#  define Py_Is(x, y) ((x) == (y))
+#endif
+#if PY_VERSION_HEX < 0x030A00B1 && !defined(Py_IsNone)
+#  define Py_IsNone(x) Py_Is(x, Py_None)
+#endif
+#if (PY_VERSION_HEX < 0x030A00B1 || defined(PYPY_VERSION)) && !defined(Py_IsTrue)
+#  define Py_IsTrue(x) Py_Is(x, Py_True)
+#endif
+#if (PY_VERSION_HEX < 0x030A00B1 || defined(PYPY_VERSION)) && !defined(Py_IsFalse)
+#  define Py_IsFalse(x) Py_Is(x, Py_False)
+#endif
+
+
+// bpo-39573 added Py_SET_TYPE() to Python 3.9.0a4
+#if PY_VERSION_HEX < 0x030900A4 && !defined(Py_SET_TYPE)
+static inline void _Py_SET_TYPE(PyObject *ob, PyTypeObject *type)
+{
+    ob->ob_type = type;
+}
+#define Py_SET_TYPE(ob, type) _Py_SET_TYPE(_PyObject_CAST(ob), type)
+#endif
+
+
+// bpo-39573 added Py_SET_SIZE() to Python 3.9.0a4
+#if PY_VERSION_HEX < 0x030900A4 && !defined(Py_SET_SIZE)
+static inline void _Py_SET_SIZE(PyVarObject *ob, Py_ssize_t size)
+{
+    ob->ob_size = size;
+}
+#define Py_SET_SIZE(ob, size) _Py_SET_SIZE((PyVarObject*)(ob), size)
+#endif
+
+
+// bpo-40421 added PyFrame_GetCode() to Python 3.9.0b1
+#if PY_VERSION_HEX < 0x030900B1 || defined(PYPY_VERSION)
+static inline PyCodeObject* PyFrame_GetCode(PyFrameObject *frame)
+{
+    assert(frame != _Py_NULL);
+    assert(frame->f_code != _Py_NULL);
+    return _Py_CAST(PyCodeObject*, Py_NewRef(frame->f_code));
+}
+#endif
+
+static inline PyCodeObject* _PyFrame_GetCodeBorrow(PyFrameObject *frame)
+{
+    PyCodeObject *code = PyFrame_GetCode(frame);
+    Py_DECREF(code);
+    return code;
+}
+
+
+// bpo-40421 added PyFrame_GetBack() to Python 3.9.0b1
+#if PY_VERSION_HEX < 0x030900B1 && !defined(PYPY_VERSION)
+static inline PyFrameObject* PyFrame_GetBack(PyFrameObject *frame)
+{
+    assert(frame != _Py_NULL);
+    return _Py_CAST(PyFrameObject*, Py_XNewRef(frame->f_back));
+}
+#endif
+
+#if !defined(PYPY_VERSION)
+static inline PyFrameObject* _PyFrame_GetBackBorrow(PyFrameObject *frame)
+{
+    PyFrameObject *back = PyFrame_GetBack(frame);
+    Py_XDECREF(back);
+    return back;
+}
+#endif
+
+
+// bpo-40421 added PyFrame_GetLocals() to Python 3.11.0a7
+#if PY_VERSION_HEX < 0x030B00A7 && !defined(PYPY_VERSION)
+static inline PyObject* PyFrame_GetLocals(PyFrameObject *frame)
+{
+#if PY_VERSION_HEX >= 0x030400B1
+    if (PyFrame_FastToLocalsWithError(frame) < 0) {
+        return NULL;
+    }
+#else
+    PyFrame_FastToLocals(frame);
+#endif
+    return Py_NewRef(frame->f_locals);
+}
+#endif
+
+
+// bpo-40421 added PyFrame_GetGlobals() to Python 3.11.0a7
+#if PY_VERSION_HEX < 0x030B00A7 && !defined(PYPY_VERSION)
+static inline PyObject* PyFrame_GetGlobals(PyFrameObject *frame)
+{
+    return Py_NewRef(frame->f_globals);
+}
+#endif
+
+
+// bpo-40421 added PyFrame_GetBuiltins() to Python 3.11.0a7
+#if PY_VERSION_HEX < 0x030B00A7 && !defined(PYPY_VERSION)
+static inline PyObject* PyFrame_GetBuiltins(PyFrameObject *frame)
+{
+    return Py_NewRef(frame->f_builtins);
+}
+#endif
+
+
+// bpo-40421 added PyFrame_GetLasti() to Python 3.11.0b1
+#if PY_VERSION_HEX < 0x030B00B1 && !defined(PYPY_VERSION)
+static inline int PyFrame_GetLasti(PyFrameObject *frame)
+{
+#if PY_VERSION_HEX >= 0x030A00A7
+    // bpo-27129: Since Python 3.10.0a7, f_lasti is an instruction offset,
+    // not a bytes offset anymore. Python uses 16-bit "wordcode" (2 bytes)
+    // instructions.
+    if (frame->f_lasti < 0) {
+        return -1;
+    }
+    return frame->f_lasti * 2;
+#else
+    return frame->f_lasti;
+#endif
+}
+#endif
+
+
+// gh-91248 added PyFrame_GetVar() to Python 3.12.0a2
+#if PY_VERSION_HEX < 0x030C00A2 && !defined(PYPY_VERSION)
+static inline PyObject* PyFrame_GetVar(PyFrameObject *frame, PyObject *name)
+{
+    PyObject *locals, *value;
+
+    locals = PyFrame_GetLocals(frame);
+    if (locals == NULL) {
+        return NULL;
+    }
+#if PY_VERSION_HEX >= 0x03000000
+    value = PyDict_GetItemWithError(locals, name);
+#else
+    value = _PyDict_GetItemWithError(locals, name);
+#endif
+    Py_DECREF(locals);
+
+    if (value == NULL) {
+        if (PyErr_Occurred()) {
+            return NULL;
+        }
+#if PY_VERSION_HEX >= 0x03000000
+        PyErr_Format(PyExc_NameError, "variable %R does not exist", name);
+#else
+        PyErr_SetString(PyExc_NameError, "variable does not exist");
+#endif
+        return NULL;
+    }
+    return Py_NewRef(value);
+}
+#endif
+
+
+// gh-91248 added PyFrame_GetVarString() to Python 3.12.0a2
+#if PY_VERSION_HEX < 0x030C00A2 && !defined(PYPY_VERSION)
+static inline PyObject*
+PyFrame_GetVarString(PyFrameObject *frame, const char *name)
+{
+    PyObject *name_obj, *value;
+#if PY_VERSION_HEX >= 0x03000000
+    name_obj = PyUnicode_FromString(name);
+#else
+    name_obj = PyString_FromString(name);
+#endif
+    if (name_obj == NULL) {
+        return NULL;
+    }
+    value = PyFrame_GetVar(frame, name_obj);
+    Py_DECREF(name_obj);
+    return value;
+}
+#endif
+
+
+// bpo-39947 added PyThreadState_GetInterpreter() to Python 3.9.0a5
+#if PY_VERSION_HEX < 0x030900A5 || defined(PYPY_VERSION)
+static inline PyInterpreterState *
+PyThreadState_GetInterpreter(PyThreadState *tstate)
+{
+    assert(tstate != _Py_NULL);
+    return tstate->interp;
+}
+#endif
+
+
+// bpo-40429 added PyThreadState_GetFrame() to Python 3.9.0b1
+#if PY_VERSION_HEX < 0x030900B1 && !defined(PYPY_VERSION)
+static inline PyFrameObject* PyThreadState_GetFrame(PyThreadState *tstate)
+{
+    assert(tstate != _Py_NULL);
+    return _Py_CAST(PyFrameObject *, Py_XNewRef(tstate->frame));
+}
+#endif
+
+#if !defined(PYPY_VERSION)
+static inline PyFrameObject*
+_PyThreadState_GetFrameBorrow(PyThreadState *tstate)
+{
+    PyFrameObject *frame = PyThreadState_GetFrame(tstate);
+    Py_XDECREF(frame);
+    return frame;
+}
+#endif
+
+
+// bpo-39947 added PyInterpreterState_Get() to Python 3.9.0a5
+#if PY_VERSION_HEX < 0x030900A5 || defined(PYPY_VERSION)
+static inline PyInterpreterState* PyInterpreterState_Get(void)
+{
+    PyThreadState *tstate;
+    PyInterpreterState *interp;
+
+    tstate = PyThreadState_GET();
+    if (tstate == _Py_NULL) {
+        Py_FatalError("GIL released (tstate is NULL)");
+    }
+    interp = tstate->interp;
+    if (interp == _Py_NULL) {
+        Py_FatalError("no current interpreter");
+    }
+    return interp;
+}
+#endif
+
+
+// bpo-39947 added PyInterpreterState_Get() to Python 3.9.0a6
+#if 0x030700A1 <= PY_VERSION_HEX && PY_VERSION_HEX < 0x030900A6 && !defined(PYPY_VERSION)
+static inline uint64_t PyThreadState_GetID(PyThreadState *tstate)
+{
+    assert(tstate != _Py_NULL);
+    return tstate->id;
+}
+#endif
+
+// bpo-43760 added PyThreadState_EnterTracing() to Python 3.11.0a2
+#if PY_VERSION_HEX < 0x030B00A2 && !defined(PYPY_VERSION)
+static inline void PyThreadState_EnterTracing(PyThreadState *tstate)
+{
+    tstate->tracing++;
+#if PY_VERSION_HEX >= 0x030A00A1
+    tstate->cframe->use_tracing = 0;
+#else
+    tstate->use_tracing = 0;
+#endif
+}
+#endif
+
+// bpo-43760 added PyThreadState_LeaveTracing() to Python 3.11.0a2
+#if PY_VERSION_HEX < 0x030B00A2 && !defined(PYPY_VERSION)
+static inline void PyThreadState_LeaveTracing(PyThreadState *tstate)
+{
+    int use_tracing = (tstate->c_tracefunc != _Py_NULL
+                       || tstate->c_profilefunc != _Py_NULL);
+    tstate->tracing--;
+#if PY_VERSION_HEX >= 0x030A00A1
+    tstate->cframe->use_tracing = use_tracing;
+#else
+    tstate->use_tracing = use_tracing;
+#endif
+}
+#endif
+
+
+// bpo-37194 added PyObject_CallNoArgs() to Python 3.9.0a1
+// PyObject_CallNoArgs() added to PyPy 3.9.16-v7.3.11
+#if !defined(PyObject_CallNoArgs) && PY_VERSION_HEX < 0x030900A1
+static inline PyObject* PyObject_CallNoArgs(PyObject *func)
+{
+    return PyObject_CallFunctionObjArgs(func, NULL);
+}
+#endif
+
+
+// bpo-39245 made PyObject_CallOneArg() public (previously called
+// _PyObject_CallOneArg) in Python 3.9.0a4
+// PyObject_CallOneArg() added to PyPy 3.9.16-v7.3.11
+#if !defined(PyObject_CallOneArg) && PY_VERSION_HEX < 0x030900A4
+static inline PyObject* PyObject_CallOneArg(PyObject *func, PyObject *arg)
+{
+    return PyObject_CallFunctionObjArgs(func, arg, NULL);
+}
+#endif
+
+
+// bpo-1635741 added PyModule_AddObjectRef() to Python 3.10.0a3
+#if PY_VERSION_HEX < 0x030A00A3
+static inline int
+PyModule_AddObjectRef(PyObject *module, const char *name, PyObject *value)
+{
+    int res;
+
+    if (!value && !PyErr_Occurred()) {
+        // PyModule_AddObject() raises TypeError in this case
+        PyErr_SetString(PyExc_SystemError,
+                        "PyModule_AddObjectRef() must be called "
+                        "with an exception raised if value is NULL");
+        return -1;
+    }
+
+    Py_XINCREF(value);
+    res = PyModule_AddObject(module, name, value);
+    if (res < 0) {
+        Py_XDECREF(value);
+    }
+    return res;
+}
+#endif
+
+
+// bpo-40024 added PyModule_AddType() to Python 3.9.0a5
+#if PY_VERSION_HEX < 0x030900A5
+static inline int PyModule_AddType(PyObject *module, PyTypeObject *type)
+{
+    const char *name, *dot;
+
+    if (PyType_Ready(type) < 0) {
+        return -1;
+    }
+
+    // inline _PyType_Name()
+    name = type->tp_name;
+    assert(name != _Py_NULL);
+    dot = strrchr(name, '.');
+    if (dot != _Py_NULL) {
+        name = dot + 1;
+    }
+
+    return PyModule_AddObjectRef(module, name, _PyObject_CAST(type));
+}
+#endif
+
+
+// bpo-40241 added PyObject_GC_IsTracked() to Python 3.9.0a6.
+// bpo-4688 added _PyObject_GC_IS_TRACKED() to Python 2.7.0a2.
+#if PY_VERSION_HEX < 0x030900A6 && !defined(PYPY_VERSION)
+static inline int PyObject_GC_IsTracked(PyObject* obj)
+{
+    return (PyObject_IS_GC(obj) && _PyObject_GC_IS_TRACKED(obj));
+}
+#endif
+
+// bpo-40241 added PyObject_GC_IsFinalized() to Python 3.9.0a6.
+// bpo-18112 added _PyGCHead_FINALIZED() to Python 3.4.0 final.
+#if PY_VERSION_HEX < 0x030900A6 && PY_VERSION_HEX >= 0x030400F0 && !defined(PYPY_VERSION)
+static inline int PyObject_GC_IsFinalized(PyObject *obj)
+{
+    PyGC_Head *gc = _Py_CAST(PyGC_Head*, obj) - 1;
+    return (PyObject_IS_GC(obj) && _PyGCHead_FINALIZED(gc));
+}
+#endif
+
+
+// bpo-39573 added Py_IS_TYPE() to Python 3.9.0a4
+#if PY_VERSION_HEX < 0x030900A4 && !defined(Py_IS_TYPE)
+static inline int _Py_IS_TYPE(PyObject *ob, PyTypeObject *type) {
+    return Py_TYPE(ob) == type;
+}
+#define Py_IS_TYPE(ob, type) _Py_IS_TYPE(_PyObject_CAST(ob), type)
+#endif
+
+
+// bpo-46906 added PyFloat_Pack2() and PyFloat_Unpack2() to Python 3.11a7.
+// bpo-11734 added _PyFloat_Pack2() and _PyFloat_Unpack2() to Python 3.6.0b1.
+// Python 3.11a2 moved _PyFloat_Pack2() and _PyFloat_Unpack2() to the internal
+// C API: Python 3.11a2-3.11a6 versions are not supported.
+#if 0x030600B1 <= PY_VERSION_HEX && PY_VERSION_HEX <= 0x030B00A1 && !defined(PYPY_VERSION)
+static inline int PyFloat_Pack2(double x, char *p, int le)
+{ return _PyFloat_Pack2(x, (unsigned char*)p, le); }
+
+static inline double PyFloat_Unpack2(const char *p, int le)
+{ return _PyFloat_Unpack2((const unsigned char *)p, le); }
+#endif
+
+
+// bpo-46906 added PyFloat_Pack4(), PyFloat_Pack8(), PyFloat_Unpack4() and
+// PyFloat_Unpack8() to Python 3.11a7.
+// Python 3.11a2 moved _PyFloat_Pack4(), _PyFloat_Pack8(), _PyFloat_Unpack4()
+// and _PyFloat_Unpack8() to the internal C API: Python 3.11a2-3.11a6 versions
+// are not supported.
+#if PY_VERSION_HEX <= 0x030B00A1 && !defined(PYPY_VERSION)
+static inline int PyFloat_Pack4(double x, char *p, int le)
+{ return _PyFloat_Pack4(x, (unsigned char*)p, le); }
+
+static inline int PyFloat_Pack8(double x, char *p, int le)
+{ return _PyFloat_Pack8(x, (unsigned char*)p, le); }
+
+static inline double PyFloat_Unpack4(const char *p, int le)
+{ return _PyFloat_Unpack4((const unsigned char *)p, le); }
+
+static inline double PyFloat_Unpack8(const char *p, int le)
+{ return _PyFloat_Unpack8((const unsigned char *)p, le); }
+#endif
+
+
+// gh-92154 added PyCode_GetCode() to Python 3.11.0b1
+#if PY_VERSION_HEX < 0x030B00B1 && !defined(PYPY_VERSION)
+static inline PyObject* PyCode_GetCode(PyCodeObject *code)
+{
+    return Py_NewRef(code->co_code);
+}
+#endif
+
+
+// gh-95008 added PyCode_GetVarnames() to Python 3.11.0rc1
+#if PY_VERSION_HEX < 0x030B00C1 && !defined(PYPY_VERSION)
+static inline PyObject* PyCode_GetVarnames(PyCodeObject *code)
+{
+    return Py_NewRef(code->co_varnames);
+}
+#endif
+
+// gh-95008 added PyCode_GetFreevars() to Python 3.11.0rc1
+#if PY_VERSION_HEX < 0x030B00C1 && !defined(PYPY_VERSION)
+static inline PyObject* PyCode_GetFreevars(PyCodeObject *code)
+{
+    return Py_NewRef(code->co_freevars);
+}
+#endif
+
+// gh-95008 added PyCode_GetCellvars() to Python 3.11.0rc1
+#if PY_VERSION_HEX < 0x030B00C1 && !defined(PYPY_VERSION)
+static inline PyObject* PyCode_GetCellvars(PyCodeObject *code)
+{
+    return Py_NewRef(code->co_cellvars);
+}
+#endif
+
+
+// Py_UNUSED() was added to Python 3.4.0b2.
+#if PY_VERSION_HEX < 0x030400B2 && !defined(Py_UNUSED)
+#  if defined(__GNUC__) || defined(__clang__)
+#    define Py_UNUSED(name) _unused_ ## name __attribute__((unused))
+#  else
+#    define Py_UNUSED(name) _unused_ ## name
+#  endif
+#endif
+
+
+// gh-105922 added PyImport_AddModuleRef() to Python 3.13.0a1
+#if PY_VERSION_HEX < 0x030D00A0
+static inline PyObject* PyImport_AddModuleRef(const char *name)
+{
+    return Py_XNewRef(PyImport_AddModule(name));
+}
+#endif
+
+
+// gh-105927 added PyWeakref_GetRef() to Python 3.13.0a1
+#if PY_VERSION_HEX < 0x030D0000
+static inline int PyWeakref_GetRef(PyObject *ref, PyObject **pobj)
+{
+    PyObject *obj;
+    if (ref != NULL && !PyWeakref_Check(ref)) {
+        *pobj = NULL;
+        PyErr_SetString(PyExc_TypeError, "expected a weakref");
+        return -1;
+    }
+    obj = PyWeakref_GetObject(ref);
+    if (obj == NULL) {
+        // SystemError if ref is NULL
+        *pobj = NULL;
+        return -1;
+    }
+    if (obj == Py_None) {
+        *pobj = NULL;
+        return 0;
+    }
+    *pobj = Py_NewRef(obj);
+    return (*pobj != NULL);
+}
+#endif
+
+
+// bpo-36974 added PY_VECTORCALL_ARGUMENTS_OFFSET to Python 3.8b1
+#ifndef PY_VECTORCALL_ARGUMENTS_OFFSET
+#  define PY_VECTORCALL_ARGUMENTS_OFFSET (_Py_CAST(size_t, 1) << (8 * sizeof(size_t) - 1))
+#endif
+
+// bpo-36974 added PyVectorcall_NARGS() to Python 3.8b1
+#if PY_VERSION_HEX < 0x030800B1
+static inline Py_ssize_t PyVectorcall_NARGS(size_t n)
+{
+    return n & ~PY_VECTORCALL_ARGUMENTS_OFFSET;
+}
+#endif
+
+
+// gh-105922 added PyObject_Vectorcall() to Python 3.9.0a4
+#if PY_VERSION_HEX < 0x030900A4
+static inline PyObject*
+PyObject_Vectorcall(PyObject *callable, PyObject *const *args,
+                     size_t nargsf, PyObject *kwnames)
+{
+#if PY_VERSION_HEX >= 0x030800B1 && !defined(PYPY_VERSION)
+    // bpo-36974 added _PyObject_Vectorcall() to Python 3.8.0b1
+    return _PyObject_Vectorcall(callable, args, nargsf, kwnames);
+#else
+    PyObject *posargs = NULL, *kwargs = NULL;
+    PyObject *res;
+    Py_ssize_t nposargs, nkwargs, i;
+
+    if (nargsf != 0 && args == NULL) {
+        PyErr_BadInternalCall();
+        goto error;
+    }
+    if (kwnames != NULL && !PyTuple_Check(kwnames)) {
+        PyErr_BadInternalCall();
+        goto error;
+    }
+
+    nposargs = (Py_ssize_t)PyVectorcall_NARGS(nargsf);
+    if (kwnames) {
+        nkwargs = PyTuple_GET_SIZE(kwnames);
+    }
+    else {
+        nkwargs = 0;
+    }
+
+    posargs = PyTuple_New(nposargs);
+    if (posargs == NULL) {
+        goto error;
+    }
+    if (nposargs) {
+        for (i=0; i < nposargs; i++) {
+            PyTuple_SET_ITEM(posargs, i, Py_NewRef(*args));
+            args++;
+        }
+    }
+
+    if (nkwargs) {
+        kwargs = PyDict_New();
+        if (kwargs == NULL) {
+            goto error;
+        }
+
+        for (i = 0; i < nkwargs; i++) {
+            PyObject *key = PyTuple_GET_ITEM(kwnames, i);
+            PyObject *value = *args;
+            args++;
+            if (PyDict_SetItem(kwargs, key, value) < 0) {
+                goto error;
+            }
+        }
+    }
+    else {
+        kwargs = NULL;
+    }
+
+    res = PyObject_Call(callable, posargs, kwargs);
+    Py_DECREF(posargs);
+    Py_XDECREF(kwargs);
+    return res;
+
+error:
+    Py_DECREF(posargs);
+    Py_XDECREF(kwargs);
+    return NULL;
+#endif
+}
+#endif
+
+
+// gh-106521 added PyObject_GetOptionalAttr() and
+// PyObject_GetOptionalAttrString() to Python 3.13.0a1
+#if PY_VERSION_HEX < 0x030D00A1
+static inline int
+PyObject_GetOptionalAttr(PyObject *obj, PyObject *attr_name, PyObject **result)
+{
+    // bpo-32571 added _PyObject_LookupAttr() to Python 3.7.0b1
+#if PY_VERSION_HEX >= 0x030700B1 && !defined(PYPY_VERSION)
+    return _PyObject_LookupAttr(obj, attr_name, result);
+#else
+    *result = PyObject_GetAttr(obj, attr_name);
+    if (*result != NULL) {
+        return 1;
+    }
+    if (!PyErr_Occurred()) {
+        return 0;
+    }
+    if (PyErr_ExceptionMatches(PyExc_AttributeError)) {
+        PyErr_Clear();
+        return 0;
+    }
+    return -1;
+#endif
+}
+
+static inline int
+PyObject_GetOptionalAttrString(PyObject *obj, const char *attr_name, PyObject **result)
+{
+    PyObject *name_obj;
+    int rc;
+#if PY_VERSION_HEX >= 0x03000000
+    name_obj = PyUnicode_FromString(attr_name);
+#else
+    name_obj = PyString_FromString(attr_name);
+#endif
+    if (name_obj == NULL) {
+        *result = NULL;
+        return -1;
+    }
+    rc = PyObject_GetOptionalAttr(obj, name_obj, result);
+    Py_DECREF(name_obj);
+    return rc;
+}
+#endif
+
+
+// gh-106307 added PyObject_GetOptionalAttr() and
+// PyMapping_GetOptionalItemString() to Python 3.13.0a1
+#if PY_VERSION_HEX < 0x030D00A1
+static inline int
+PyMapping_GetOptionalItem(PyObject *obj, PyObject *key, PyObject **result)
+{
+    *result = PyObject_GetItem(obj, key);
+    if (*result) {
+        return 1;
+    }
+    if (!PyErr_ExceptionMatches(PyExc_KeyError)) {
+        return -1;
+    }
+    PyErr_Clear();
+    return 0;
+}
+
+static inline int
+PyMapping_GetOptionalItemString(PyObject *obj, const char *key, PyObject **result)
+{
+    PyObject *key_obj;
+    int rc;
+#if PY_VERSION_HEX >= 0x03000000
+    key_obj = PyUnicode_FromString(key);
+#else
+    key_obj = PyString_FromString(key);
+#endif
+    if (key_obj == NULL) {
+        *result = NULL;
+        return -1;
+    }
+    rc = PyMapping_GetOptionalItem(obj, key_obj, result);
+    Py_DECREF(key_obj);
+    return rc;
+}
+#endif
+
+// gh-108511 added PyMapping_HasKeyWithError() and
+// PyMapping_HasKeyStringWithError() to Python 3.13.0a1
+#if PY_VERSION_HEX < 0x030D00A1
+static inline int
+PyMapping_HasKeyWithError(PyObject *obj, PyObject *key)
+{
+    PyObject *res;
+    int rc = PyMapping_GetOptionalItem(obj, key, &res);
+    Py_XDECREF(res);
+    return rc;
+}
+
+static inline int
+PyMapping_HasKeyStringWithError(PyObject *obj, const char *key)
+{
+    PyObject *res;
+    int rc = PyMapping_GetOptionalItemString(obj, key, &res);
+    Py_XDECREF(res);
+    return rc;
+}
+#endif
+
+
+// gh-108511 added PyObject_HasAttrWithError() and
+// PyObject_HasAttrStringWithError() to Python 3.13.0a1
+#if PY_VERSION_HEX < 0x030D00A1
+static inline int
+PyObject_HasAttrWithError(PyObject *obj, PyObject *attr)
+{
+    PyObject *res;
+    int rc = PyObject_GetOptionalAttr(obj, attr, &res);
+    Py_XDECREF(res);
+    return rc;
+}
+
+static inline int
+PyObject_HasAttrStringWithError(PyObject *obj, const char *attr)
+{
+    PyObject *res;
+    int rc = PyObject_GetOptionalAttrString(obj, attr, &res);
+    Py_XDECREF(res);
+    return rc;
+}
+#endif
+
+
+// gh-106004 added PyDict_GetItemRef() and PyDict_GetItemStringRef()
+// to Python 3.13.0a1
+#if PY_VERSION_HEX < 0x030D00A1
+static inline int
+PyDict_GetItemRef(PyObject *mp, PyObject *key, PyObject **result)
+{
+#if PY_VERSION_HEX >= 0x03000000
+    PyObject *item = PyDict_GetItemWithError(mp, key);
+#else
+    PyObject *item = _PyDict_GetItemWithError(mp, key);
+#endif
+    if (item != NULL) {
+        *result = Py_NewRef(item);
+        return 1;  // found
+    }
+    if (!PyErr_Occurred()) {
+        *result = NULL;
+        return 0;  // not found
+    }
+    *result = NULL;
+    return -1;
+}
+
+static inline int
+PyDict_GetItemStringRef(PyObject *mp, const char *key, PyObject **result)
+{
+    int res;
+#if PY_VERSION_HEX >= 0x03000000
+    PyObject *key_obj = PyUnicode_FromString(key);
+#else
+    PyObject *key_obj = PyString_FromString(key);
+#endif
+    if (key_obj == NULL) {
+        *result = NULL;
+        return -1;
+    }
+    res = PyDict_GetItemRef(mp, key_obj, result);
+    Py_DECREF(key_obj);
+    return res;
+}
+#endif
+
+
+// gh-106307 added PyModule_Add() to Python 3.13.0a1
+#if PY_VERSION_HEX < 0x030D00A1
+static inline int
+PyModule_Add(PyObject *mod, const char *name, PyObject *value)
+{
+    int res = PyModule_AddObjectRef(mod, name, value);
+    Py_XDECREF(value);
+    return res;
+}
+#endif
+
+
+// gh-108014 added Py_IsFinalizing() to Python 3.13.0a1
+// bpo-1856 added _Py_Finalizing to Python 3.2.1b1.
+// _Py_IsFinalizing() was added to PyPy 7.3.0.
+#if (0x030201B1 <= PY_VERSION_HEX && PY_VERSION_HEX < 0x030D00A1) \
+        && (!defined(PYPY_VERSION_NUM) || PYPY_VERSION_NUM >= 0x7030000)
+static inline int Py_IsFinalizing(void)
+{
+#if PY_VERSION_HEX >= 0x030700A1
+    // _Py_IsFinalizing() was added to Python 3.7.0a1.
+    return _Py_IsFinalizing();
+#else
+    return (_Py_Finalizing != NULL);
+#endif
+}
+#endif
+
+
+// gh-108323 added PyDict_ContainsString() to Python 3.13.0a1
+#if PY_VERSION_HEX < 0x030D00A1
+static inline int PyDict_ContainsString(PyObject *op, const char *key)
+{
+    PyObject *key_obj = PyUnicode_FromString(key);
+    if (key_obj == NULL) {
+        return -1;
+    }
+    int res = PyDict_Contains(op, key_obj);
+    Py_DECREF(key_obj);
+    return res;
+}
+#endif
+
+
+// gh-108445 added PyLong_AsInt() to Python 3.13.0a1
+#if PY_VERSION_HEX < 0x030D00A1
+static inline int PyLong_AsInt(PyObject *obj)
+{
+#ifdef PYPY_VERSION
+    long value = PyLong_AsLong(obj);
+    if (value == -1 && PyErr_Occurred()) {
+        return -1;
+    }
+    if (value < (long)INT_MIN || (long)INT_MAX < value) {
+        PyErr_SetString(PyExc_OverflowError,
+                        "Python int too large to convert to C int");
+        return -1;
+    }
+    return (int)value;
+#else
+    return _PyLong_AsInt(obj);
+#endif
+}
+#endif
+
+
+// gh-107073 added PyObject_VisitManagedDict() to Python 3.13.0a1
+#if PY_VERSION_HEX < 0x030D00A1
+static inline int
+PyObject_VisitManagedDict(PyObject *obj, visitproc visit, void *arg)
+{
+    PyObject **dict = _PyObject_GetDictPtr(obj);
+    if (*dict == NULL) {
+        return -1;
+    }
+    Py_VISIT(*dict);
+    return 0;
+}
+
+static inline void
+PyObject_ClearManagedDict(PyObject *obj)
+{
+    PyObject **dict = _PyObject_GetDictPtr(obj);
+    if (*dict == NULL) {
+        return;
+    }
+    Py_CLEAR(*dict);
+}
+#endif
+
+// gh-108867 added PyThreadState_GetUnchecked() to Python 3.13.0a1
+// Python 3.5.2 added _PyThreadState_UncheckedGet().
+#if PY_VERSION_HEX >= 0x03050200 && PY_VERSION_HEX < 0x030D00A1
+static inline PyThreadState*
+PyThreadState_GetUnchecked(void)
+{
+    return _PyThreadState_UncheckedGet();
+}
+#endif
+
+// gh-110289 added PyUnicode_EqualToUTF8() and PyUnicode_EqualToUTF8AndSize()
+// to Python 3.13.0a1
+#if PY_VERSION_HEX < 0x030D00A1
+static inline int
+PyUnicode_EqualToUTF8AndSize(PyObject *unicode, const char *str, Py_ssize_t str_len)
+{
+    Py_ssize_t len;
+    const void *utf8;
+    PyObject *exc_type, *exc_value, *exc_tb;
+    int res;
+
+    // API cannot report errors so save/restore the exception
+    PyErr_Fetch(&exc_type, &exc_value, &exc_tb);
+
+    // Python 3.3.0a1 added PyUnicode_AsUTF8AndSize()
+#if PY_VERSION_HEX >= 0x030300A1
+    if (PyUnicode_IS_ASCII(unicode)) {
+        utf8 = PyUnicode_DATA(unicode);
+        len = PyUnicode_GET_LENGTH(unicode);
+    }
+    else {
+        utf8 = PyUnicode_AsUTF8AndSize(unicode, &len);
+        if (utf8 == NULL) {
+            // Memory allocation failure. The API cannot report error,
+            // so ignore the exception and return 0.
+            res = 0;
+            goto done;
+        }
+    }
+
+    if (len != str_len) {
+        res = 0;
+        goto done;
+    }
+    res = (memcmp(utf8, str, (size_t)len) == 0);
+#else
+    PyObject *bytes = PyUnicode_AsUTF8String(unicode);
+    if (bytes == NULL) {
+        // Memory allocation failure. The API cannot report error,
+        // so ignore the exception and return 0.
+        res = 0;
+        goto done;
+    }
+
+#if PY_VERSION_HEX >= 0x03000000
+    len = PyBytes_GET_SIZE(bytes);
+    utf8 = PyBytes_AS_STRING(bytes);
+#else
+    len = PyString_GET_SIZE(bytes);
+    utf8 = PyString_AS_STRING(bytes);
+#endif
+    if (len != str_len) {
+        Py_DECREF(bytes);
+        res = 0;
+        goto done;
+    }
+
+    res = (memcmp(utf8, str, (size_t)len) == 0);
+    Py_DECREF(bytes);
+#endif
+
+done:
+    PyErr_Restore(exc_type, exc_value, exc_tb);
+    return res;
+}
+
+static inline int
+PyUnicode_EqualToUTF8(PyObject *unicode, const char *str)
+{
+    return PyUnicode_EqualToUTF8AndSize(unicode, str, (Py_ssize_t)strlen(str));
+}
+#endif
+
+
+// gh-111138 added PyList_Extend() and PyList_Clear() to Python 3.13.0a2
+#if PY_VERSION_HEX < 0x030D00A2
+static inline int
+PyList_Extend(PyObject *list, PyObject *iterable)
+{
+    return PyList_SetSlice(list, PY_SSIZE_T_MAX, PY_SSIZE_T_MAX, iterable);
+}
+
+static inline int
+PyList_Clear(PyObject *list)
+{
+    return PyList_SetSlice(list, 0, PY_SSIZE_T_MAX, NULL);
+}
+#endif
+
+// gh-111262 added PyDict_Pop() and PyDict_PopString() to Python 3.13.0a2
+#if PY_VERSION_HEX < 0x030D00A2
+static inline int
+PyDict_Pop(PyObject *dict, PyObject *key, PyObject **result)
+{
+    PyObject *value;
+
+    if (!PyDict_Check(dict)) {
+        PyErr_BadInternalCall();
+        if (result) {
+            *result = NULL;
+        }
+        return -1;
+    }
+
+    // bpo-16991 added _PyDict_Pop() to Python 3.5.0b2.
+    // Python 3.6.0b3 changed _PyDict_Pop() first argument type to PyObject*.
+    // Python 3.13.0a1 removed _PyDict_Pop().
+#if defined(PYPY_VERSION) || PY_VERSION_HEX < 0x030500b2 || PY_VERSION_HEX >= 0x030D0000
+    value = PyObject_CallMethod(dict, "pop", "O", key);
+#elif PY_VERSION_HEX < 0x030600b3
+    value = _PyDict_Pop(_Py_CAST(PyDictObject*, dict), key, NULL);
+#else
+    value = _PyDict_Pop(dict, key, NULL);
+#endif
+    if (value == NULL) {
+        if (result) {
+            *result = NULL;
+        }
+        if (PyErr_Occurred() && !PyErr_ExceptionMatches(PyExc_KeyError)) {
+            return -1;
+        }
+        PyErr_Clear();
+        return 0;
+    }
+    if (result) {
+        *result = value;
+    }
+    else {
+        Py_DECREF(value);
+    }
+    return 1;
+}
+
+static inline int
+PyDict_PopString(PyObject *dict, const char *key, PyObject **result)
+{
+    PyObject *key_obj = PyUnicode_FromString(key);
+    if (key_obj == NULL) {
+        if (result != NULL) {
+            *result = NULL;
+        }
+        return -1;
+    }
+
+    int res = PyDict_Pop(dict, key_obj, result);
+    Py_DECREF(key_obj);
+    return res;
+}
+#endif
+
+
+#if PY_VERSION_HEX < 0x030200A4
+// Python 3.2.0a4 added Py_hash_t type
+typedef Py_ssize_t Py_hash_t;
+#endif
+
+
+// gh-111545 added Py_HashPointer() to Python 3.13.0a3
+#if PY_VERSION_HEX < 0x030D00A3
+static inline Py_hash_t Py_HashPointer(const void *ptr)
+{
+#if PY_VERSION_HEX >= 0x030900A4 && !defined(PYPY_VERSION)
+    return _Py_HashPointer(ptr);
+#else
+    return _Py_HashPointer(_Py_CAST(void*, ptr));
+#endif
+}
+#endif
+
+
+// Python 3.13a4 added a PyTime API.
+// Use the private API added to Python 3.5.
+#if PY_VERSION_HEX < 0x030D00A4 && PY_VERSION_HEX  >= 0x03050000
+typedef _PyTime_t PyTime_t;
+#define PyTime_MIN _PyTime_MIN
+#define PyTime_MAX _PyTime_MAX
+
+static inline double PyTime_AsSecondsDouble(PyTime_t t)
+{ return _PyTime_AsSecondsDouble(t); }
+
+static inline int PyTime_Monotonic(PyTime_t *result)
+{ return _PyTime_GetMonotonicClockWithInfo(result, NULL); }
+
+static inline int PyTime_Time(PyTime_t *result)
+{ return _PyTime_GetSystemClockWithInfo(result, NULL); }
+
+static inline int PyTime_PerfCounter(PyTime_t *result)
+{
+#if PY_VERSION_HEX >= 0x03070000 && !defined(PYPY_VERSION)
+    return _PyTime_GetPerfCounterWithInfo(result, NULL);
+#elif PY_VERSION_HEX >= 0x03070000
+    // Call time.perf_counter_ns() and convert Python int object to PyTime_t.
+    // Cache time.perf_counter_ns() function for best performance.
+    static PyObject *func = NULL;
+    if (func == NULL) {
+        PyObject *mod = PyImport_ImportModule("time");
+        if (mod == NULL) {
+            return -1;
+        }
+
+        func = PyObject_GetAttrString(mod, "perf_counter_ns");
+        Py_DECREF(mod);
+        if (func == NULL) {
+            return -1;
+        }
+    }
+
+    PyObject *res = PyObject_CallNoArgs(func);
+    if (res == NULL) {
+        return -1;
+    }
+    long long value = PyLong_AsLongLong(res);
+    Py_DECREF(res);
+
+    if (value == -1 && PyErr_Occurred()) {
+        return -1;
+    }
+
+    Py_BUILD_ASSERT(sizeof(value) >= sizeof(PyTime_t));
+    *result = (PyTime_t)value;
+    return 0;
+#else
+    // Call time.perf_counter() and convert C double to PyTime_t.
+    // Cache time.perf_counter() function for best performance.
+    static PyObject *func = NULL;
+    if (func == NULL) {
+        PyObject *mod = PyImport_ImportModule("time");
+        if (mod == NULL) {
+            return -1;
+        }
+
+        func = PyObject_GetAttrString(mod, "perf_counter");
+        Py_DECREF(mod);
+        if (func == NULL) {
+            return -1;
+        }
+    }
+
+    PyObject *res = PyObject_CallNoArgs(func);
+    if (res == NULL) {
+        return -1;
+    }
+    double d = PyFloat_AsDouble(res);
+    Py_DECREF(res);
+
+    if (d == -1.0 && PyErr_Occurred()) {
+        return -1;
+    }
+
+    // Avoid floor() to avoid having to link to libm
+    *result = (PyTime_t)(d * 1e9);
+    return 0;
+#endif
+}
+
+#endif
+
+// gh-111389 added hash constants to Python 3.13.0a5. These constants were
+// added first as private macros to Python 3.4.0b1 and PyPy 7.3.9.
+#if (!defined(PyHASH_BITS) \
+     && ((!defined(PYPY_VERSION) && PY_VERSION_HEX >= 0x030400B1) \
+         || (defined(PYPY_VERSION) && PY_VERSION_HEX >= 0x03070000 \
+             && PYPY_VERSION_NUM >= 0x07090000)))
+#  define PyHASH_BITS _PyHASH_BITS
+#  define PyHASH_MODULUS _PyHASH_MODULUS
+#  define PyHASH_INF _PyHASH_INF
+#  define PyHASH_IMAG _PyHASH_IMAG
+#endif
+
+
+// gh-111545 added Py_GetConstant() and Py_GetConstantBorrowed()
+// to Python 3.13.0a6
+#if PY_VERSION_HEX < 0x030D00A6 && !defined(Py_CONSTANT_NONE)
+
+#define Py_CONSTANT_NONE 0
+#define Py_CONSTANT_FALSE 1
+#define Py_CONSTANT_TRUE 2
+#define Py_CONSTANT_ELLIPSIS 3
+#define Py_CONSTANT_NOT_IMPLEMENTED 4
+#define Py_CONSTANT_ZERO 5
+#define Py_CONSTANT_ONE 6
+#define Py_CONSTANT_EMPTY_STR 7
+#define Py_CONSTANT_EMPTY_BYTES 8
+#define Py_CONSTANT_EMPTY_TUPLE 9
+
+static inline PyObject* Py_GetConstant(unsigned int constant_id)
+{
+    static PyObject* constants[Py_CONSTANT_EMPTY_TUPLE + 1] = {NULL};
+
+    if (constants[Py_CONSTANT_NONE] == NULL) {
+        constants[Py_CONSTANT_NONE] = Py_None;
+        constants[Py_CONSTANT_FALSE] = Py_False;
+        constants[Py_CONSTANT_TRUE] = Py_True;
+        constants[Py_CONSTANT_ELLIPSIS] = Py_Ellipsis;
+        constants[Py_CONSTANT_NOT_IMPLEMENTED] = Py_NotImplemented;
+
+        constants[Py_CONSTANT_ZERO] = PyLong_FromLong(0);
+        if (constants[Py_CONSTANT_ZERO] == NULL) {
+            goto fatal_error;
+        }
+
+        constants[Py_CONSTANT_ONE] = PyLong_FromLong(1);
+        if (constants[Py_CONSTANT_ONE] == NULL) {
+            goto fatal_error;
+        }
+
+        constants[Py_CONSTANT_EMPTY_STR] = PyUnicode_FromStringAndSize("", 0);
+        if (constants[Py_CONSTANT_EMPTY_STR] == NULL) {
+            goto fatal_error;
+        }
+
+        constants[Py_CONSTANT_EMPTY_BYTES] = PyBytes_FromStringAndSize("", 0);
+        if (constants[Py_CONSTANT_EMPTY_BYTES] == NULL) {
+            goto fatal_error;
+        }
+
+        constants[Py_CONSTANT_EMPTY_TUPLE] = PyTuple_New(0);
+        if (constants[Py_CONSTANT_EMPTY_TUPLE] == NULL) {
+            goto fatal_error;
+        }
+        // goto dance to avoid compiler warnings about Py_FatalError()
+        goto init_done;
+
+fatal_error:
+        // This case should never happen
+        Py_FatalError("Py_GetConstant() failed to get constants");
+    }
+
+init_done:
+    if (constant_id <= Py_CONSTANT_EMPTY_TUPLE) {
+        return Py_NewRef(constants[constant_id]);
+    }
+    else {
+        PyErr_BadInternalCall();
+        return NULL;
+    }
+}
+
+static inline PyObject* Py_GetConstantBorrowed(unsigned int constant_id)
+{
+    PyObject *obj = Py_GetConstant(constant_id);
+    Py_XDECREF(obj);
+    return obj;
+}
+#endif
+
+
+// gh-114329 added PyList_GetItemRef() to Python 3.13.0a4
+#if PY_VERSION_HEX < 0x030D00A4
+static inline PyObject *
+PyList_GetItemRef(PyObject *op, Py_ssize_t index)
+{
+    PyObject *item = PyList_GetItem(op, index);
+    Py_XINCREF(item);
+    return item;
+}
+#endif
+
+
+// gh-114329 added PyList_GetItemRef() to Python 3.13.0a4
+#if PY_VERSION_HEX < 0x030D00A4
+static inline int
+PyDict_SetDefaultRef(PyObject *d, PyObject *key, PyObject *default_value,
+                     PyObject **result)
+{
+    PyObject *value;
+    if (PyDict_GetItemRef(d, key, &value) < 0) {
+        // get error
+        if (result) {
+            *result = NULL;
+        }
+        return -1;
+    }
+    if (value != NULL) {
+        // present
+        if (result) {
+            *result = value;
+        }
+        else {
+            Py_DECREF(value);
+        }
+        return 1;
+    }
+
+    // missing: set the item
+    if (PyDict_SetItem(d, key, default_value) < 0) {
+        // set error
+        if (result) {
+            *result = NULL;
+        }
+        return -1;
+    }
+    if (result) {
+        *result = Py_NewRef(default_value);
+    }
+    return 0;
+}
+#endif
+
+
+// gh-116560 added PyLong_GetSign() to Python 3.14.0a0
+#if PY_VERSION_HEX < 0x030E00A0
+static inline int PyLong_GetSign(PyObject *obj, int *sign)
+{
+    if (!PyLong_Check(obj)) {
+        PyErr_Format(PyExc_TypeError, "expect int, got %s", Py_TYPE(obj)->tp_name);
+        return -1;
+    }
+
+    *sign = _PyLong_Sign(obj);
+    return 0;
+}
+#endif
+
+
+#ifdef __cplusplus
+}
+#endif
+#endif  // PYTHONCAPI_COMPAT

From 7c64ae0c73666924fa1e298f1be55abbf6973586 Mon Sep 17 00:00:00 2001
From: Hugo van Kemenade <1324225+hugovk@users.noreply.github.com>
Date: Tue, 2 Jul 2024 18:46:52 +0300
Subject: [PATCH 0805/1178] encode: Replace PyDict_GetItem with
 PyDict_GetItemRef

---
 src/encode.c | 5 ++++-
 1 file changed, 4 insertions(+), 1 deletion(-)

diff --git a/src/encode.c b/src/encode.c
index 72ad3fa07a2..620774f67af 100644
--- a/src/encode.c
+++ b/src/encode.c
@@ -722,7 +722,10 @@ PyImaging_LibTiffEncoderNew(PyObject *self, PyObject *args) {
         }
 
         if (!is_core_tag) {
-            PyObject *tag_type = PyDict_GetItem(types, key);
+            PyObject *tag_type;
+            if (PyDict_GetItemRef(types, key, &tag_type) == 0) {
+                PyErr_SetString(PyExc_KeyError, "unknown tag type");
+            }
             if (tag_type) {
                 int type_int = PyLong_AsLong(tag_type);
                 if (type_int >= TIFF_BYTE && type_int <= TIFF_DOUBLE) {

From 87596bd747f1cfadd2f7ec6beb5bca67e6aeba0a Mon Sep 17 00:00:00 2001
From: Hugo van Kemenade <1324225+hugovk@users.noreply.github.com>
Date: Tue, 2 Jul 2024 18:51:15 +0300
Subject: [PATCH 0806/1178] imagingft: Replace PyDict_GetItem with
 PyDict_GetItemRef

---
 src/_imagingft.c | 3 ++-
 1 file changed, 2 insertions(+), 1 deletion(-)

diff --git a/src/_imagingft.c b/src/_imagingft.c
index 1bef876e15c..468f1688487 100644
--- a/src/_imagingft.c
+++ b/src/_imagingft.c
@@ -20,6 +20,7 @@
 
 #define PY_SSIZE_T_CLEAN
 #include "Python.h"
+#include "thirdparty/pythoncapi_compat.h"
 #include "libImaging/Imaging.h"
 
 #include <ft2build.h>
@@ -1219,7 +1220,7 @@ font_getvarnames(FontObject *self) {
         }
 
         for (j = 0; j < num_namedstyles; j++) {
-            if (PyList_GetItem(list_names, j) != NULL) {
+            if (PyList_GetItemRef(list_names, j) != NULL) {
                 continue;
             }
 

From 40e7f511b33204a23faa0f26140dd7b74c13be97 Mon Sep 17 00:00:00 2001
From: Lysandros Nikolaou <lisandrosnik@gmail.com>
Date: Fri, 5 Jul 2024 16:30:48 +0200
Subject: [PATCH 0807/1178] Don't use PyList_GetItemRef immediately after
 PyList_New

---
 src/_imagingft.c | 13 ++++++++++++-
 1 file changed, 12 insertions(+), 1 deletion(-)

diff --git a/src/_imagingft.c b/src/_imagingft.c
index 468f1688487..ddcf28f97eb 100644
--- a/src/_imagingft.c
+++ b/src/_imagingft.c
@@ -1205,6 +1205,16 @@ font_getvarnames(FontObject *self) {
 
     num_namedstyles = master->num_namedstyles;
     list_names = PyList_New(num_namedstyles);
+
+    int *list_names_filled = PyMem_Malloc(num_namedstyles * sizeof(int));
+    if (list_names_filled == NULL) {
+        return PyErr_NoMemory();
+    }
+
+    for (int i = 0; i < num_namedstyles; i++) {
+        list_names_filled[i] = 0;
+    }
+
     if (list_names == NULL) {
         FT_Done_MM_Var(library, master);
         return NULL;
@@ -1220,13 +1230,14 @@ font_getvarnames(FontObject *self) {
         }
 
         for (j = 0; j < num_namedstyles; j++) {
-            if (PyList_GetItemRef(list_names, j) != NULL) {
+            if (list_names_filled[j]) {
                 continue;
             }
 
             if (master->namedstyle[j].strid == name.name_id) {
                 list_name = Py_BuildValue("y#", name.string, name.string_len);
                 PyList_SetItem(list_names, j, list_name);
+                list_names_filled[j] = 1;
                 break;
             }
         }

From c416f0ea1db1dfe5b3a96a0d24af0f0318883317 Mon Sep 17 00:00:00 2001
From: Andrew Murray <radarhere@users.noreply.github.com>
Date: Wed, 10 Jul 2024 06:11:11 +1000
Subject: [PATCH 0808/1178] Build wheels with free threading

---
 .github/workflows/wheels-test.sh | 6 ++++++
 .github/workflows/wheels.yml     | 2 ++
 2 files changed, 8 insertions(+)

diff --git a/.github/workflows/wheels-test.sh b/.github/workflows/wheels-test.sh
index 3fbf3be695b..023a338244e 100755
--- a/.github/workflows/wheels-test.sh
+++ b/.github/workflows/wheels-test.sh
@@ -12,8 +12,14 @@ elif [ "${AUDITWHEEL_POLICY::9}" == "musllinux" ]; then
 else
     yum install -y fribidi
 fi
+
 if [ "${AUDITWHEEL_POLICY::9}" != "musllinux" ]; then
+  # TODO Update condition when NumPy supports free-threading
+  if [ $(python3 -c "import sysconfig;print(sysconfig.get_config_var('Py_GIL_DISABLED'))") == "1" ]; then
+    python3 -m pip install numpy --index-url https://pypi.anaconda.org/scientific-python-nightly-wheels/simple
+  else
     python3 -m pip install numpy
+  fi
 fi
 
 if [ ! -d "test-images-main" ]; then
diff --git a/.github/workflows/wheels.yml b/.github/workflows/wheels.yml
index f8dff3a3e77..e32f14529a7 100644
--- a/.github/workflows/wheels.yml
+++ b/.github/workflows/wheels.yml
@@ -129,6 +129,7 @@ jobs:
         env:
           CIBW_ARCHS: ${{ matrix.cibw_arch }}
           CIBW_BUILD: ${{ matrix.build }}
+          CIBW_FREE_THREADED_SUPPORT: True
           CIBW_MANYLINUX_PYPY_X86_64_IMAGE: ${{ matrix.manylinux }}
           CIBW_MANYLINUX_X86_64_IMAGE: ${{ matrix.manylinux }}
           CIBW_PRERELEASE_PYTHONS: True
@@ -201,6 +202,7 @@ jobs:
           CIBW_ARCHS: ${{ matrix.cibw_arch }}
           CIBW_BEFORE_ALL: "{package}\\winbuild\\build\\build_dep_all.cmd"
           CIBW_CACHE_PATH: "C:\\cibw"
+          CIBW_FREE_THREADED_SUPPORT: True
           CIBW_PRERELEASE_PYTHONS: True
           CIBW_TEST_SKIP: "*-win_arm64"
           CIBW_TEST_COMMAND: 'docker run --rm

From 5bae9343171d653dcf5dff0669c3665fd97dea3e Mon Sep 17 00:00:00 2001
From: Andrew Murray <radarhere@users.noreply.github.com>
Date: Fri, 12 Jul 2024 21:16:56 +1000
Subject: [PATCH 0809/1178] Added type hints

---
 Tests/test_file_png.py     |  2 +-
 Tests/test_imagefile.py    |  6 +++---
 src/PIL/ImageFile.py       | 34 +++++++++++++++---------------
 src/PIL/ImageSequence.py   |  2 +-
 src/PIL/JpegImagePlugin.py |  4 ++--
 src/PIL/PdfImagePlugin.py  | 20 +++++++++---------
 src/PIL/PngImagePlugin.py  | 36 ++++++++++++++++---------------
 src/PIL/TiffImagePlugin.py | 43 +++++++++++++++++++-------------------
 src/PIL/WalImageFile.py    |  5 ++++-
 9 files changed, 79 insertions(+), 73 deletions(-)

diff --git a/Tests/test_file_png.py b/Tests/test_file_png.py
index dfe8f9e9927..e2913e9444f 100644
--- a/Tests/test_file_png.py
+++ b/Tests/test_file_png.py
@@ -41,7 +41,7 @@
 
 def chunk(cid: bytes, *data: bytes) -> bytes:
     test_file = BytesIO()
-    PngImagePlugin.putchunk(*(test_file, cid) + data)
+    PngImagePlugin.putchunk(test_file, cid, *data)
     return test_file.getvalue()
 
 
diff --git a/Tests/test_imagefile.py b/Tests/test_imagefile.py
index b996860ce2c..44a6e6a42f1 100644
--- a/Tests/test_imagefile.py
+++ b/Tests/test_imagefile.py
@@ -127,7 +127,7 @@ def test_raise_oserror(self) -> None:
     def test_raise_typeerror(self) -> None:
         with pytest.raises(TypeError):
             parser = ImageFile.Parser()
-            parser.feed(1)
+            parser.feed(1)  # type: ignore[arg-type]
 
     def test_negative_stride(self) -> None:
         with open("Tests/images/raw_negative_stride.bin", "rb") as f:
@@ -305,7 +305,7 @@ def test_oversize(self) -> None:
             im.load()
 
     def test_decode(self) -> None:
-        decoder = ImageFile.PyDecoder(None)
+        decoder = ImageFile.PyDecoder("")
         with pytest.raises(NotImplementedError):
             decoder.decode(b"")
 
@@ -383,7 +383,7 @@ def test_oversize(self) -> None:
             )
 
     def test_encode(self) -> None:
-        encoder = ImageFile.PyEncoder(None)
+        encoder = ImageFile.PyEncoder("")
         with pytest.raises(NotImplementedError):
             encoder.encode(0)
 
diff --git a/src/PIL/ImageFile.py b/src/PIL/ImageFile.py
index 99d7e73f111..6b295345191 100644
--- a/src/PIL/ImageFile.py
+++ b/src/PIL/ImageFile.py
@@ -86,7 +86,7 @@ def raise_oserror(error: int) -> OSError:
     raise _get_oserror(error, encoder=False)
 
 
-def _tilesort(t):
+def _tilesort(t) -> int:
     # sort on offset
     return t[2]
 
@@ -161,7 +161,7 @@ def get_format_mimetype(self) -> str | None:
             return Image.MIME.get(self.format.upper())
         return None
 
-    def __setstate__(self, state):
+    def __setstate__(self, state) -> None:
         self.tile = []
         super().__setstate__(state)
 
@@ -333,14 +333,14 @@ def load_end(self) -> None:
     # def load_read(self, read_bytes: int) -> bytes:
     #     pass
 
-    def _seek_check(self, frame):
+    def _seek_check(self, frame: int) -> bool:
         if (
             frame < self._min_frame
             # Only check upper limit on frames if additional seek operations
             # are not required to do so
             or (
                 not (hasattr(self, "_n_frames") and self._n_frames is None)
-                and frame >= self.n_frames + self._min_frame
+                and frame >= getattr(self, "n_frames") + self._min_frame
             )
         ):
             msg = "attempt to seek outside sequence"
@@ -370,7 +370,7 @@ def _open(self) -> None:
         msg = "StubImageFile subclass must implement _open"
         raise NotImplementedError(msg)
 
-    def load(self):
+    def load(self) -> Image.core.PixelAccess | None:
         loader = self._load()
         if loader is None:
             msg = f"cannot find loader for this {self.format} file"
@@ -378,7 +378,7 @@ def load(self):
         image = loader.load(self)
         assert image is not None
         # become the other object (!)
-        self.__class__ = image.__class__
+        self.__class__ = image.__class__  # type: ignore[assignment]
         self.__dict__ = image.__dict__
         return image.load()
 
@@ -396,8 +396,8 @@ class Parser:
 
     incremental = None
     image: Image.Image | None = None
-    data = None
-    decoder = None
+    data: bytes | None = None
+    decoder: Image.core.ImagingDecoder | PyDecoder | None = None
     offset = 0
     finished = 0
 
@@ -409,7 +409,7 @@ def reset(self) -> None:
         """
         assert self.data is None, "cannot reuse parsers"
 
-    def feed(self, data):
+    def feed(self, data: bytes) -> None:
         """
         (Consumer) Feed data to the parser.
 
@@ -491,7 +491,7 @@ def __enter__(self) -> Parser:
     def __exit__(self, *args: object) -> None:
         self.close()
 
-    def close(self):
+    def close(self) -> Image.Image:
         """
         (Consumer) Close the stream.
 
@@ -525,7 +525,7 @@ def close(self):
 # --------------------------------------------------------------------
 
 
-def _save(im, fp, tile, bufsize=0) -> None:
+def _save(im, fp, tile, bufsize: int = 0) -> None:
     """Helper to save image based on tile list
 
     :param im: Image object.
@@ -553,7 +553,7 @@ def _save(im, fp, tile, bufsize=0) -> None:
         fp.flush()
 
 
-def _encode_tile(im, fp, tile: list[_Tile], bufsize, fh, exc=None):
+def _encode_tile(im, fp, tile: list[_Tile], bufsize: int, fh, exc=None) -> None:
     for encoder_name, extents, offset, args in tile:
         if offset > 0:
             fp.seek(offset)
@@ -629,18 +629,18 @@ def extents(self) -> tuple[int, int, int, int]:
 class PyCodec:
     fd: IO[bytes] | None
 
-    def __init__(self, mode, *args):
-        self.im = None
+    def __init__(self, mode: str, *args: Any) -> None:
+        self.im: Image.core.ImagingCore | None = None
         self.state = PyCodecState()
         self.fd = None
         self.mode = mode
         self.init(args)
 
-    def init(self, args) -> None:
+    def init(self, args: tuple[Any, ...]) -> None:
         """
         Override to perform codec specific initialization
 
-        :param args: Array of args items from the tile entry
+        :param args: Tuple of arg items from the tile entry
         :returns: None
         """
         self.args = args
@@ -662,7 +662,7 @@ def setfd(self, fd) -> None:
         """
         self.fd = fd
 
-    def setimage(self, im, extents: tuple[int, int, int, int] | None = None) -> None:
+    def setimage(self, im, extents=None):
         """
         Called from ImageFile to set the core output image for the codec
 
diff --git a/src/PIL/ImageSequence.py b/src/PIL/ImageSequence.py
index 2c185027630..a6fc340d55f 100644
--- a/src/PIL/ImageSequence.py
+++ b/src/PIL/ImageSequence.py
@@ -33,7 +33,7 @@ class Iterator:
     :param im: An image object.
     """
 
-    def __init__(self, im: Image.Image):
+    def __init__(self, im: Image.Image) -> None:
         if not hasattr(im, "seek"):
             msg = "im must have seek method"
             raise AttributeError(msg)
diff --git a/src/PIL/JpegImagePlugin.py b/src/PIL/JpegImagePlugin.py
index 4916727beae..54f756014da 100644
--- a/src/PIL/JpegImagePlugin.py
+++ b/src/PIL/JpegImagePlugin.py
@@ -827,11 +827,11 @@ def _save_cjpeg(im: Image.Image, fp: IO[bytes], filename: str | bytes) -> None:
 
 ##
 # Factory for making JPEG and MPO instances
-def jpeg_factory(fp=None, filename=None):
+def jpeg_factory(fp: IO[bytes] | None = None, filename: str | bytes | None = None):
     im = JpegImageFile(fp, filename)
     try:
         mpheader = im._getmp()
-        if mpheader[45057] > 1:
+        if mpheader is not None and mpheader[45057] > 1:
             for segment, content in im.applist:
                 if segment == "APP1" and b' hdrgm:Version="' in content:
                     # Ultra HDR images are not yet supported
diff --git a/src/PIL/PdfImagePlugin.py b/src/PIL/PdfImagePlugin.py
index f0da1e04797..e0f732199bc 100644
--- a/src/PIL/PdfImagePlugin.py
+++ b/src/PIL/PdfImagePlugin.py
@@ -174,12 +174,15 @@ def _write_image(im, filename, existing_pdf, image_refs):
     return image_ref, procset
 
 
-def _save(im, fp, filename, save_all=False):
+def _save(
+    im: Image.Image, fp: IO[bytes], filename: str | bytes, save_all: bool = False
+) -> None:
     is_appending = im.encoderinfo.get("append", False)
+    filename_str = filename.decode() if isinstance(filename, bytes) else filename
     if is_appending:
-        existing_pdf = PdfParser.PdfParser(f=fp, filename=filename, mode="r+b")
+        existing_pdf = PdfParser.PdfParser(f=fp, filename=filename_str, mode="r+b")
     else:
-        existing_pdf = PdfParser.PdfParser(f=fp, filename=filename, mode="w+b")
+        existing_pdf = PdfParser.PdfParser(f=fp, filename=filename_str, mode="w+b")
 
     dpi = im.encoderinfo.get("dpi")
     if dpi:
@@ -228,12 +231,7 @@ def _save(im, fp, filename, save_all=False):
     for im in ims:
         im_number_of_pages = 1
         if save_all:
-            try:
-                im_number_of_pages = im.n_frames
-            except AttributeError:
-                # Image format does not have n_frames.
-                # It is a single frame image
-                pass
+            im_number_of_pages = getattr(im, "n_frames", 1)
         number_of_pages += im_number_of_pages
         for i in range(im_number_of_pages):
             image_refs.append(existing_pdf.next_object_id(0))
@@ -250,7 +248,9 @@ def _save(im, fp, filename, save_all=False):
 
     page_number = 0
     for im_sequence in ims:
-        im_pages = ImageSequence.Iterator(im_sequence) if save_all else [im_sequence]
+        im_pages: ImageSequence.Iterator | list[Image.Image] = (
+            ImageSequence.Iterator(im_sequence) if save_all else [im_sequence]
+        )
         for im in im_pages:
             image_ref, procset = _write_image(im, filename, existing_pdf, image_refs)
 
diff --git a/src/PIL/PngImagePlugin.py b/src/PIL/PngImagePlugin.py
index fa117d19ae1..6990b6d05b0 100644
--- a/src/PIL/PngImagePlugin.py
+++ b/src/PIL/PngImagePlugin.py
@@ -144,7 +144,7 @@ def _safe_zlib_decompress(s):
     return plaintext
 
 
-def _crc32(data, seed=0):
+def _crc32(data: bytes, seed: int = 0) -> int:
     return zlib.crc32(data, seed) & 0xFFFFFFFF
 
 
@@ -191,7 +191,7 @@ def push(self, cid: bytes, pos: int, length: int) -> None:
         assert self.queue is not None
         self.queue.append((cid, pos, length))
 
-    def call(self, cid, pos, length):
+    def call(self, cid: bytes, pos: int, length: int) -> bytes:
         """Call the appropriate chunk handler"""
 
         logger.debug("STREAM %r %s %s", cid, pos, length)
@@ -1091,21 +1091,21 @@ def getexif(self) -> Image.Exif:
 }
 
 
-def putchunk(fp, cid, *data):
+def putchunk(fp: IO[bytes], cid: bytes, *data: bytes) -> None:
     """Write a PNG chunk (including CRC field)"""
 
-    data = b"".join(data)
+    byte_data = b"".join(data)
 
-    fp.write(o32(len(data)) + cid)
-    fp.write(data)
-    crc = _crc32(data, _crc32(cid))
+    fp.write(o32(len(byte_data)) + cid)
+    fp.write(byte_data)
+    crc = _crc32(byte_data, _crc32(cid))
     fp.write(o32(crc))
 
 
 class _idat:
     # wrap output from the encoder in IDAT chunks
 
-    def __init__(self, fp, chunk):
+    def __init__(self, fp, chunk) -> None:
         self.fp = fp
         self.chunk = chunk
 
@@ -1116,7 +1116,7 @@ def write(self, data: bytes) -> None:
 class _fdat:
     # wrap encoder output in fdAT chunks
 
-    def __init__(self, fp, chunk, seq_num):
+    def __init__(self, fp: IO[bytes], chunk, seq_num: int) -> None:
         self.fp = fp
         self.chunk = chunk
         self.seq_num = seq_num
@@ -1259,7 +1259,9 @@ def _save_all(im: Image.Image, fp: IO[bytes], filename: str | bytes) -> None:
     _save(im, fp, filename, save_all=True)
 
 
-def _save(im, fp, filename, chunk=putchunk, save_all=False):
+def _save(
+    im: Image.Image, fp, filename: str | bytes, chunk=putchunk, save_all: bool = False
+) -> None:
     # save an image to disk (called by the save method)
 
     if save_all:
@@ -1461,7 +1463,7 @@ def _save(im, fp, filename, chunk=putchunk, save_all=False):
 # PNG chunk converter
 
 
-def getchunks(im, **params):
+def getchunks(im: Image.Image, **params: Any) -> list[tuple[bytes, bytes, bytes]]:
     """Return a list of PNG chunks representing this image."""
 
     class collector:
@@ -1470,19 +1472,19 @@ class collector:
         def write(self, data: bytes) -> None:
             pass
 
-        def append(self, chunk: bytes) -> None:
+        def append(self, chunk: tuple[bytes, bytes, bytes]) -> None:
             self.data.append(chunk)
 
-    def append(fp, cid, *data):
-        data = b"".join(data)
-        crc = o32(_crc32(data, _crc32(cid)))
-        fp.append((cid, data, crc))
+    def append(fp: collector, cid: bytes, *data: bytes) -> None:
+        byte_data = b"".join(data)
+        crc = o32(_crc32(byte_data, _crc32(cid)))
+        fp.append((cid, byte_data, crc))
 
     fp = collector()
 
     try:
         im.encoderinfo = params
-        _save(im, fp, None, append)
+        _save(im, fp, "", append)
     finally:
         del im.encoderinfo
 
diff --git a/src/PIL/TiffImagePlugin.py b/src/PIL/TiffImagePlugin.py
index b89144803a5..253f64852b1 100644
--- a/src/PIL/TiffImagePlugin.py
+++ b/src/PIL/TiffImagePlugin.py
@@ -334,12 +334,13 @@ class IFDRational(Rational):
 
     __slots__ = ("_numerator", "_denominator", "_val")
 
-    def __init__(self, value, denominator=1):
+    def __init__(self, value, denominator: int = 1) -> None:
         """
         :param value: either an integer numerator, a
         float/rational/other number, or an IFDRational
         :param denominator: Optional integer denominator
         """
+        self._val: Fraction | float
         if isinstance(value, IFDRational):
             self._numerator = value.numerator
             self._denominator = value.denominator
@@ -636,13 +637,13 @@ def __getitem__(self, tag):
             val = (val,)
         return val
 
-    def __contains__(self, tag):
+    def __contains__(self, tag: object) -> bool:
         return tag in self._tags_v2 or tag in self._tagdata
 
-    def __setitem__(self, tag, value):
+    def __setitem__(self, tag, value) -> None:
         self._setitem(tag, value, self.legacy_api)
 
-    def _setitem(self, tag, value, legacy_api):
+    def _setitem(self, tag, value, legacy_api) -> None:
         basetypes = (Number, bytes, str)
 
         info = TiffTags.lookup(tag, self.group)
@@ -758,7 +759,7 @@ def load_byte(self, data, legacy_api=True):
         return data
 
     @_register_writer(1)  # Basic type, except for the legacy API.
-    def write_byte(self, data):
+    def write_byte(self, data) -> bytes:
         if isinstance(data, IFDRational):
             data = int(data)
         if isinstance(data, int):
@@ -772,7 +773,7 @@ def load_string(self, data, legacy_api=True):
         return data.decode("latin-1", "replace")
 
     @_register_writer(2)
-    def write_string(self, value):
+    def write_string(self, value) -> bytes:
         # remerge of https://github.com/python-pillow/Pillow/pull/1416
         if isinstance(value, int):
             value = str(value)
@@ -790,7 +791,7 @@ def combine(a, b):
         return tuple(combine(num, denom) for num, denom in zip(vals[::2], vals[1::2]))
 
     @_register_writer(5)
-    def write_rational(self, *values):
+    def write_rational(self, *values) -> bytes:
         return b"".join(
             self._pack("2L", *_limit_rational(frac, 2**32 - 1)) for frac in values
         )
@@ -800,7 +801,7 @@ def load_undefined(self, data, legacy_api=True):
         return data
 
     @_register_writer(7)
-    def write_undefined(self, value):
+    def write_undefined(self, value) -> bytes:
         if isinstance(value, IFDRational):
             value = int(value)
         if isinstance(value, int):
@@ -817,13 +818,13 @@ def combine(a, b):
         return tuple(combine(num, denom) for num, denom in zip(vals[::2], vals[1::2]))
 
     @_register_writer(10)
-    def write_signed_rational(self, *values):
+    def write_signed_rational(self, *values) -> bytes:
         return b"".join(
             self._pack("2l", *_limit_signed_rational(frac, 2**31 - 1, -(2**31)))
             for frac in values
         )
 
-    def _ensure_read(self, fp, size):
+    def _ensure_read(self, fp: IO[bytes], size: int) -> bytes:
         ret = fp.read(size)
         if len(ret) != size:
             msg = (
@@ -977,7 +978,7 @@ def tobytes(self, offset=0):
 
         return result
 
-    def save(self, fp):
+    def save(self, fp: IO[bytes]) -> int:
         if fp.tell() == 0:  # skip TIFF header on subsequent pages
             # tiff header -- PIL always starts the first IFD at offset 8
             fp.write(self._prefix + self._pack("HL", 42, 8))
@@ -1017,7 +1018,7 @@ class ImageFileDirectory_v1(ImageFileDirectory_v2):
     ..  deprecated:: 3.0.0
     """
 
-    def __init__(self, *args, **kwargs):
+    def __init__(self, *args, **kwargs) -> None:
         super().__init__(*args, **kwargs)
         self._legacy_api = True
 
@@ -1029,7 +1030,7 @@ def __init__(self, *args, **kwargs):
     """Dictionary of tag types"""
 
     @classmethod
-    def from_v2(cls, original):
+    def from_v2(cls, original) -> ImageFileDirectory_v1:
         """Returns an
         :py:class:`~PIL.TiffImagePlugin.ImageFileDirectory_v1`
         instance with the same data as is contained in the original
@@ -1063,7 +1064,7 @@ def to_v2(self) -> ImageFileDirectory_v2:
         ifd._tags_v2 = dict(self._tags_v2)
         return ifd
 
-    def __contains__(self, tag):
+    def __contains__(self, tag: object) -> bool:
         return tag in self._tags_v1 or tag in self._tagdata
 
     def __len__(self) -> int:
@@ -1072,7 +1073,7 @@ def __len__(self) -> int:
     def __iter__(self):
         return iter(set(self._tagdata) | set(self._tags_v1))
 
-    def __setitem__(self, tag, value):
+    def __setitem__(self, tag, value) -> None:
         for legacy_api in (False, True):
             self._setitem(tag, value, legacy_api)
 
@@ -1122,7 +1123,7 @@ def _open(self) -> None:
         self.tag_v2 = ImageFileDirectory_v2(ifh)
 
         # legacy IFD entries will be filled in later
-        self.ifd = None
+        self.ifd: ImageFileDirectory_v1 | None = None
 
         # setup frame pointers
         self.__first = self.__next = self.tag_v2.next
@@ -1343,7 +1344,7 @@ def _load_libtiff(self):
 
         return Image.Image.load(self)
 
-    def _setup(self):
+    def _setup(self) -> None:
         """Setup this image object based on current tags"""
 
         if 0xBC01 in self.tag_v2:
@@ -1537,13 +1538,13 @@ def _setup(self):
                     # adjust stride width accordingly
                     stride /= bps_count
 
-                a = (tile_rawmode, int(stride), 1)
+                args = (tile_rawmode, int(stride), 1)
                 self.tile.append(
                     (
                         self._compression,
                         (x, y, min(x + w, xsize), min(y + h, ysize)),
                         offset,
-                        a,
+                        args,
                     )
                 )
                 x = x + w
@@ -1938,7 +1939,7 @@ class AppendingTiffWriter:
         521,  # JPEGACTables
     }
 
-    def __init__(self, fn, new=False):
+    def __init__(self, fn, new: bool = False) -> None:
         if hasattr(fn, "read"):
             self.f = fn
             self.close_fp = False
@@ -2015,7 +2016,7 @@ def __exit__(self, *args: object) -> None:
     def tell(self) -> int:
         return self.f.tell() - self.offsetOfNewPage
 
-    def seek(self, offset, whence=io.SEEK_SET):
+    def seek(self, offset: int, whence=io.SEEK_SET) -> int:
         if whence == os.SEEK_SET:
             offset += self.offsetOfNewPage
 
diff --git a/src/PIL/WalImageFile.py b/src/PIL/WalImageFile.py
index 895d5616a87..ec5c7490001 100644
--- a/src/PIL/WalImageFile.py
+++ b/src/PIL/WalImageFile.py
@@ -24,8 +24,11 @@
 """
 from __future__ import annotations
 
+from typing import IO
+
 from . import Image, ImageFile
 from ._binary import i32le as i32
+from ._typing import StrOrBytesPath
 
 
 class WalImageFile(ImageFile.ImageFile):
@@ -58,7 +61,7 @@ def load(self) -> Image.core.PixelAccess | None:
         return Image.Image.load(self)
 
 
-def open(filename):
+def open(filename: StrOrBytesPath | IO[bytes]) -> WalImageFile:
     """
     Load texture from a Quake2 WAL texture file.
 

From 42bfcaa2d4371b7a1312848c0f5f6cfefcaaa9cb Mon Sep 17 00:00:00 2001
From: Andrew Murray <radarhere@users.noreply.github.com>
Date: Sat, 13 Jul 2024 12:46:15 +1000
Subject: [PATCH 0810/1178] When IFD is missing, connect get_ifd() dictionary
 to Exif

---
 Tests/test_image.py | 8 ++++++++
 src/PIL/Image.py    | 2 +-
 2 files changed, 9 insertions(+), 1 deletion(-)

diff --git a/Tests/test_image.py b/Tests/test_image.py
index 4fdc4179170..77be5826154 100644
--- a/Tests/test_image.py
+++ b/Tests/test_image.py
@@ -769,6 +769,14 @@ def test_empty_exif(self) -> None:
         exif.load(b"Exif\x00\x00")
         assert not dict(exif)
 
+    def test_empty_get_ifd(self) -> None:
+        exif = Image.Exif()
+        ifd = exif.get_ifd(0x8769)
+        assert ifd == {}
+
+        ifd[36864] = b"0220"
+        assert exif.get_ifd(0x8769) == {36864: b"0220"}
+
     @mark_if_feature_version(
         pytest.mark.valgrind_known_error, "libjpeg_turbo", "2.0", reason="Known Failing"
     )
diff --git a/src/PIL/Image.py b/src/PIL/Image.py
index 565abe71d45..9a3e4efa460 100644
--- a/src/PIL/Image.py
+++ b/src/PIL/Image.py
@@ -4073,7 +4073,7 @@ def get_ifd(self, tag):
                 else:
                     # Interop
                     self._ifds[tag] = self._get_ifd_dict(tag_data, tag)
-        ifd = self._ifds.get(tag, {})
+        ifd = self._ifds.setdefault(tag, {})
         if tag == ExifTags.IFD.Exif and self._hidden_data:
             ifd = {
                 k: v

From 8e730e17ae5608616e57194a25629c48ad033cfa Mon Sep 17 00:00:00 2001
From: Andrew Murray <radarhere@users.noreply.github.com>
Date: Sat, 13 Jul 2024 13:00:58 +1000
Subject: [PATCH 0811/1178] Allow saving I;16 images as PPM

---
 Tests/test_file_ppm.py    | 2 ++
 src/PIL/PpmImagePlugin.py | 2 +-
 2 files changed, 3 insertions(+), 1 deletion(-)

diff --git a/Tests/test_file_ppm.py b/Tests/test_file_ppm.py
index d6451ec18b5..fa50274480f 100644
--- a/Tests/test_file_ppm.py
+++ b/Tests/test_file_ppm.py
@@ -95,7 +95,9 @@ def test_16bit_pgm_write(tmp_path: Path) -> None:
     with Image.open("Tests/images/16_bit_binary.pgm") as im:
         filename = str(tmp_path / "temp.pgm")
         im.save(filename, "PPM")
+        assert_image_equal_tofile(im, filename)
 
+        im.convert("I;16").save(filename, "PPM")
         assert_image_equal_tofile(im, filename)
 
 
diff --git a/src/PIL/PpmImagePlugin.py b/src/PIL/PpmImagePlugin.py
index 16c9ccbba72..211577e16ac 100644
--- a/src/PIL/PpmImagePlugin.py
+++ b/src/PIL/PpmImagePlugin.py
@@ -333,7 +333,7 @@ def _save(im: Image.Image, fp: IO[bytes], filename: str | bytes) -> None:
         rawmode, head = "1;I", b"P4"
     elif im.mode == "L":
         rawmode, head = "L", b"P5"
-    elif im.mode == "I":
+    elif im.mode in ("I", "I;16"):
         rawmode, head = "I;16B", b"P5"
     elif im.mode in ("RGB", "RGBA"):
         rawmode, head = "RGB", b"P6"

From f5313db9ce5f800de29cb40af12c0722ecbe7173 Mon Sep 17 00:00:00 2001
From: Lysandros Nikolaou <lisandrosnik@gmail.com>
Date: Sat, 13 Jul 2024 11:00:57 +0200
Subject: [PATCH 0812/1178] Add necessary PyMem_Free and fix PyDict_GetItemRef
 call

---
 src/_imagingft.c | 2 +-
 src/encode.c     | 4 ++--
 2 files changed, 3 insertions(+), 3 deletions(-)

diff --git a/src/_imagingft.c b/src/_imagingft.c
index ddcf28f97eb..eb04945f032 100644
--- a/src/_imagingft.c
+++ b/src/_imagingft.c
@@ -1243,8 +1243,8 @@ font_getvarnames(FontObject *self) {
         }
     }
 
+    PyMem_Free(list_names_filled);
     FT_Done_MM_Var(library, master);
-
     return list_names;
 }
 
diff --git a/src/encode.c b/src/encode.c
index 620774f67af..82aed77837c 100644
--- a/src/encode.c
+++ b/src/encode.c
@@ -723,8 +723,8 @@ PyImaging_LibTiffEncoderNew(PyObject *self, PyObject *args) {
 
         if (!is_core_tag) {
             PyObject *tag_type;
-            if (PyDict_GetItemRef(types, key, &tag_type) == 0) {
-                PyErr_SetString(PyExc_KeyError, "unknown tag type");
+            if (PyDict_GetItemRef(types, key, &tag_type) < 0) {
+                return NULL;  // Exception has been already set
             }
             if (tag_type) {
                 int type_int = PyLong_AsLong(tag_type);

From 9c576d63c3e79964d12ebe07f43144db735cdd35 Mon Sep 17 00:00:00 2001
From: Lysandros Nikolaou <lisandrosnik@gmail.com>
Date: Sat, 13 Jul 2024 12:24:02 +0200
Subject: [PATCH 0813/1178] Fix refcounts after porting to GetItemRef & better
 error checking

---
 src/_imaging.c   |  5 +++++
 src/_imagingft.c | 35 ++++++++++++++++++++++++++++-------
 src/encode.c     | 16 ++++++++++++++--
 src/path.c       | 12 +++++++++---
 4 files changed, 56 insertions(+), 12 deletions(-)

diff --git a/src/_imaging.c b/src/_imaging.c
index 03e10e5472c..ac6310a445e 100644
--- a/src/_imaging.c
+++ b/src/_imaging.c
@@ -2251,6 +2251,11 @@ _getcolors(ImagingObject *self, PyObject *args) {
             ImagingColorItem *v = &items[i];
             PyObject *item = Py_BuildValue(
                 "iN", v->count, getpixel(self->image, self->access, v->x, v->y));
+            if (item == NULL) {
+                Py_DECREF(out);
+                free(items);
+                return NULL;
+            }
             PyList_SetItem(out, i, item);
         }
     }
diff --git a/src/_imagingft.c b/src/_imagingft.c
index eb04945f032..6c2885c6193 100644
--- a/src/_imagingft.c
+++ b/src/_imagingft.c
@@ -1205,9 +1205,15 @@ font_getvarnames(FontObject *self) {
 
     num_namedstyles = master->num_namedstyles;
     list_names = PyList_New(num_namedstyles);
+    if (list_names == NULL) {
+        FT_Done_MM_Var(library, master);
+        return NULL;
+    }
 
     int *list_names_filled = PyMem_Malloc(num_namedstyles * sizeof(int));
     if (list_names_filled == NULL) {
+        Py_DECREF(list_names);
+        FT_Done_MM_Var(library, master);
         return PyErr_NoMemory();
     }
 
@@ -1215,15 +1221,11 @@ font_getvarnames(FontObject *self) {
         list_names_filled[i] = 0;
     }
 
-    if (list_names == NULL) {
-        FT_Done_MM_Var(library, master);
-        return NULL;
-    }
-
     name_count = FT_Get_Sfnt_Name_Count(self->face);
     for (i = 0; i < name_count; i++) {
         error = FT_Get_Sfnt_Name(self->face, i, &name);
         if (error) {
+            PyMem_Free(list_names_filled);
             Py_DECREF(list_names);
             FT_Done_MM_Var(library, master);
             return geterror(error);
@@ -1236,6 +1238,12 @@ font_getvarnames(FontObject *self) {
 
             if (master->namedstyle[j].strid == name.name_id) {
                 list_name = Py_BuildValue("y#", name.string, name.string_len);
+                if (list_name == NULL) {
+                    PyMem_Free(list_names_filled);
+                    Py_DECREF(list_names);
+                    FT_Done_MM_Var(library, master);
+                    return NULL;
+                }
                 PyList_SetItem(list_names, j, list_name);
                 list_names_filled[j] = 1;
                 break;
@@ -1301,9 +1309,15 @@ font_getvaraxes(FontObject *self) {
 
             if (name.name_id == axis.strid) {
                 axis_name = Py_BuildValue("y#", name.string, name.string_len);
+                if (axis_name == NULL) {
+                    Py_DECREF(list_axis);
+                    Py_DECREF(list_axes);
+                    FT_Done_MM_Var(library, master);
+                    return NULL;
+                }
                 PyDict_SetItemString(
                     list_axis, "name", axis_name ? axis_name : Py_None);
-                Py_XDECREF(axis_name);
+                Py_DECREF(axis_name);
                 break;
             }
         }
@@ -1357,7 +1371,12 @@ font_setvaraxes(FontObject *self, PyObject *args) {
         return PyErr_NoMemory();
     }
     for (i = 0; i < num_coords; i++) {
-        item = PyList_GET_ITEM(axes, i);
+        item = PyList_GetItemRef(axes, i);
+        if (item == NULL) {
+            free(coords);
+            return NULL;
+        }
+
         if (PyFloat_Check(item)) {
             coord = PyFloat_AS_DOUBLE(item);
         } else if (PyLong_Check(item)) {
@@ -1365,10 +1384,12 @@ font_setvaraxes(FontObject *self, PyObject *args) {
         } else if (PyNumber_Check(item)) {
             coord = PyFloat_AsDouble(item);
         } else {
+            Py_DECREF(item);
             free(coords);
             PyErr_SetString(PyExc_TypeError, "list must contain numbers");
             return NULL;
         }
+        Py_DECREF(item);
         coords[i] = coord * 65536;
     }
 
diff --git a/src/encode.c b/src/encode.c
index 82aed77837c..2c95b7ebcee 100644
--- a/src/encode.c
+++ b/src/encode.c
@@ -673,10 +673,16 @@ PyImaging_LibTiffEncoderNew(PyObject *self, PyObject *args) {
         TRACE(("tags size: %d\n", (int)tags_size));
         for (pos = 0; pos < tags_size; pos++) {
             item = PyList_GetItemRef(tags, pos);
+            if (item == NULL) {
+                return NULL;
+            }
+
             if (!PyTuple_Check(item) || PyTuple_Size(item) != 2) {
+                Py_DECREF(item);
                 PyErr_SetString(PyExc_ValueError, "Invalid tags list");
                 return NULL;
             }
+            Py_DECREF(item);
         }
         pos = 0;
     }
@@ -705,10 +711,16 @@ PyImaging_LibTiffEncoderNew(PyObject *self, PyObject *args) {
     num_core_tags = sizeof(core_tags) / sizeof(int);
     for (pos = 0; pos < tags_size; pos++) {
         item = PyList_GetItemRef(tags, pos);
+        if (item == NULL) {
+            return NULL;
+        }
+
         // We already checked that tags is a 2-tuple list.
-        key = PyTuple_GetItem(item, 0);
+        key = PyTuple_GET_ITEM(item, 0);
         key_int = (int)PyLong_AsLong(key);
-        value = PyTuple_GetItem(item, 1);
+        value = PyTuple_GET_ITEM(item, 1);
+        Py_DECREF(item);
+
         status = 0;
         is_core_tag = 0;
         is_var_length = 0;
diff --git a/src/path.c b/src/path.c
index 6bc90abed86..f8a99eb5bf2 100644
--- a/src/path.c
+++ b/src/path.c
@@ -179,14 +179,21 @@ PyPath_Flatten(PyObject *data, double **pxy) {
         }                                                               \
         free(xy);                                                       \
         return -1;                                                      \
+    }                                                                   \
+    if (decref) {                                                       \
+        Py_DECREF(op);                                                  \
     }
 
     /* Copy table to path array */
     if (PyList_Check(data)) {
         for (i = 0; i < n; i++) {
             double x, y;
-            PyObject *op = PyList_GET_ITEM(data, i);
-            assign_item_to_array(op, 0);
+            PyObject *op = PyList_GetItemRef(data, i);
+            if (op == NULL) {
+                free(xy);
+                return -1;
+            }
+            assign_item_to_array(op, 1);
         }
     } else if (PyTuple_Check(data)) {
         for (i = 0; i < n; i++) {
@@ -209,7 +216,6 @@ PyPath_Flatten(PyObject *data, double **pxy) {
                 }
             }
             assign_item_to_array(op, 1);
-            Py_DECREF(op);
         }
     }
 

From 8854e4677e0d5d07bfa3d8725e85b681f81a704a Mon Sep 17 00:00:00 2001
From: Lysandros Nikolaou <lisandrosnik@gmail.com>
Date: Sat, 13 Jul 2024 12:34:17 +0200
Subject: [PATCH 0814/1178] Add include

---
 src/path.c | 1 +
 1 file changed, 1 insertion(+)

diff --git a/src/path.c b/src/path.c
index f8a99eb5bf2..bd6ad2259dd 100644
--- a/src/path.c
+++ b/src/path.c
@@ -26,6 +26,7 @@
  */
 
 #include "Python.h"
+#include "thirdparty/pythoncapi_compat.h"
 #include "libImaging/Imaging.h"
 
 #include <math.h>

From 01529d8b0979597902d26fcf4c0dc4f3da2a667e Mon Sep 17 00:00:00 2001
From: Andrew Murray <radarhere@users.noreply.github.com>
Date: Mon, 15 Jul 2024 19:23:36 +1000
Subject: [PATCH 0815/1178] Added type hints

---
 Tests/test_imagewin.py     |  3 ++
 src/PIL/EpsImagePlugin.py  |  2 +-
 src/PIL/IcoImagePlugin.py  | 86 ++++++++++++++++++++------------------
 src/PIL/Image.py           | 14 +++----
 src/PIL/ImageFile.py       |  6 ++-
 src/PIL/ImageQt.py         | 11 +++--
 src/PIL/ImageWin.py        | 28 ++++++++-----
 src/PIL/IptcImagePlugin.py | 16 +++----
 src/PIL/JpegImagePlugin.py | 10 +++--
 src/PIL/PngImagePlugin.py  | 56 ++++++++++++++++---------
 10 files changed, 139 insertions(+), 93 deletions(-)

diff --git a/Tests/test_imagewin.py b/Tests/test_imagewin.py
index b43c31b521f..a836bb90b6e 100644
--- a/Tests/test_imagewin.py
+++ b/Tests/test_imagewin.py
@@ -57,6 +57,9 @@ def test_dib_mode_string(self) -> None:
         # Assert
         assert dib.size == (128, 128)
 
+        with pytest.raises(ValueError):
+            ImageWin.Dib(mode)
+
     def test_dib_paste(self) -> None:
         # Arrange
         im = hopper()
diff --git a/src/PIL/EpsImagePlugin.py b/src/PIL/EpsImagePlugin.py
index 59bb8594d1c..7a73d1f69b4 100644
--- a/src/PIL/EpsImagePlugin.py
+++ b/src/PIL/EpsImagePlugin.py
@@ -65,7 +65,7 @@ def has_ghostscript() -> bool:
     return gs_binary is not False
 
 
-def Ghostscript(tile, size, fp, scale=1, transparency=False):
+def Ghostscript(tile, size, fp, scale=1, transparency: bool = False) -> Image.Image:
     """Render an image using Ghostscript"""
     global gs_binary
     if not has_ghostscript():
diff --git a/src/PIL/IcoImagePlugin.py b/src/PIL/IcoImagePlugin.py
index 650f5e4f1dc..8be1bd316c3 100644
--- a/src/PIL/IcoImagePlugin.py
+++ b/src/PIL/IcoImagePlugin.py
@@ -25,7 +25,7 @@
 import warnings
 from io import BytesIO
 from math import ceil, log
-from typing import IO
+from typing import IO, NamedTuple
 
 from . import BmpImagePlugin, Image, ImageFile, PngImagePlugin
 from ._binary import i16le as i16
@@ -119,8 +119,22 @@ def _accept(prefix: bytes) -> bool:
     return prefix[:4] == _MAGIC
 
 
+class IconHeader(NamedTuple):
+    width: int
+    height: int
+    nb_color: int
+    reserved: int
+    planes: int
+    bpp: int
+    size: int
+    offset: int
+    dim: tuple[int, int]
+    square: int
+    color_depth: int
+
+
 class IcoFile:
-    def __init__(self, buf) -> None:
+    def __init__(self, buf: IO[bytes]) -> None:
         """
         Parse image from file-like object containing ico file data
         """
@@ -141,51 +155,44 @@ def __init__(self, buf) -> None:
         for i in range(self.nb_items):
             s = buf.read(16)
 
-            icon_header = {
-                "width": s[0],
-                "height": s[1],
-                "nb_color": s[2],  # No. of colors in image (0 if >=8bpp)
-                "reserved": s[3],
-                "planes": i16(s, 4),
-                "bpp": i16(s, 6),
-                "size": i32(s, 8),
-                "offset": i32(s, 12),
-            }
-
             # See Wikipedia
-            for j in ("width", "height"):
-                if not icon_header[j]:
-                    icon_header[j] = 256
-
-            # See Wikipedia notes about color depth.
-            # We need this just to differ images with equal sizes
-            icon_header["color_depth"] = (
-                icon_header["bpp"]
-                or (
-                    icon_header["nb_color"] != 0
-                    and ceil(log(icon_header["nb_color"], 2))
-                )
-                or 256
+            width = s[0] or 256
+            height = s[1] or 256
+
+            # No. of colors in image (0 if >=8bpp)
+            nb_color = s[2]
+            bpp = i16(s, 6)
+            icon_header = IconHeader(
+                width=width,
+                height=height,
+                nb_color=nb_color,
+                reserved=s[3],
+                planes=i16(s, 4),
+                bpp=i16(s, 6),
+                size=i32(s, 8),
+                offset=i32(s, 12),
+                dim=(width, height),
+                square=width * height,
+                # See Wikipedia notes about color depth.
+                # We need this just to differ images with equal sizes
+                color_depth=bpp or (nb_color != 0 and ceil(log(nb_color, 2))) or 256,
             )
 
-            icon_header["dim"] = (icon_header["width"], icon_header["height"])
-            icon_header["square"] = icon_header["width"] * icon_header["height"]
-
             self.entry.append(icon_header)
 
-        self.entry = sorted(self.entry, key=lambda x: x["color_depth"])
+        self.entry = sorted(self.entry, key=lambda x: x.color_depth)
         # ICO images are usually squares
-        self.entry = sorted(self.entry, key=lambda x: x["square"], reverse=True)
+        self.entry = sorted(self.entry, key=lambda x: x.square, reverse=True)
 
     def sizes(self) -> set[tuple[int, int]]:
         """
-        Get a list of all available icon sizes and color depths.
+        Get a set of all available icon sizes and color depths.
         """
-        return {(h["width"], h["height"]) for h in self.entry}
+        return {(h.width, h.height) for h in self.entry}
 
     def getentryindex(self, size: tuple[int, int], bpp: int | bool = False) -> int:
         for i, h in enumerate(self.entry):
-            if size == h["dim"] and (bpp is False or bpp == h["color_depth"]):
+            if size == h.dim and (bpp is False or bpp == h.color_depth):
                 return i
         return 0
 
@@ -202,9 +209,9 @@ def frame(self, idx: int) -> Image.Image:
 
         header = self.entry[idx]
 
-        self.buf.seek(header["offset"])
+        self.buf.seek(header.offset)
         data = self.buf.read(8)
-        self.buf.seek(header["offset"])
+        self.buf.seek(header.offset)
 
         im: Image.Image
         if data[:8] == PngImagePlugin._MAGIC:
@@ -222,8 +229,7 @@ def frame(self, idx: int) -> Image.Image:
             im.tile[0] = d, (0, 0) + im.size, o, a
 
             # figure out where AND mask image starts
-            bpp = header["bpp"]
-            if 32 == bpp:
+            if 32 == header.bpp:
                 # 32-bit color depth icon image allows semitransparent areas
                 # PIL's DIB format ignores transparency bits, recover them.
                 # The DIB is packed in BGRX byte order where X is the alpha
@@ -253,7 +259,7 @@ def frame(self, idx: int) -> Image.Image:
                 # padded row size * height / bits per char
 
                 total_bytes = int((w * im.size[1]) / 8)
-                and_mask_offset = header["offset"] + header["size"] - total_bytes
+                and_mask_offset = header.offset + header.size - total_bytes
 
                 self.buf.seek(and_mask_offset)
                 mask_data = self.buf.read(total_bytes)
@@ -307,7 +313,7 @@ class IcoImageFile(ImageFile.ImageFile):
     def _open(self) -> None:
         self.ico = IcoFile(self.fp)
         self.info["sizes"] = self.ico.sizes()
-        self.size = self.ico.entry[0]["dim"]
+        self.size = self.ico.entry[0].dim
         self.load()
 
     @property
diff --git a/src/PIL/Image.py b/src/PIL/Image.py
index 565abe71d45..9d901e02873 100644
--- a/src/PIL/Image.py
+++ b/src/PIL/Image.py
@@ -3286,7 +3286,7 @@ def fromarray(obj: SupportsArrayInterface, mode: str | None = None) -> Image:
     return frombuffer(mode, size, obj, "raw", rawmode, 0, 1)
 
 
-def fromqimage(im):
+def fromqimage(im) -> ImageFile.ImageFile:
     """Creates an image instance from a QImage image"""
     from . import ImageQt
 
@@ -3296,7 +3296,7 @@ def fromqimage(im):
     return ImageQt.fromqimage(im)
 
 
-def fromqpixmap(im):
+def fromqpixmap(im) -> ImageFile.ImageFile:
     """Creates an image instance from a QPixmap image"""
     from . import ImageQt
 
@@ -3867,7 +3867,7 @@ def _fixup_dict(self, src_dict):
         # returns a dict with any single item tuples/lists as individual values
         return {k: self._fixup(v) for k, v in src_dict.items()}
 
-    def _get_ifd_dict(self, offset, group=None):
+    def _get_ifd_dict(self, offset: int, group=None):
         try:
             # an offset pointer to the location of the nested embedded IFD.
             # It should be a long, but may be corrupted.
@@ -3881,7 +3881,7 @@ def _get_ifd_dict(self, offset, group=None):
             info.load(self.fp)
             return self._fixup_dict(info)
 
-    def _get_head(self):
+    def _get_head(self) -> bytes:
         version = b"\x2B" if self.bigtiff else b"\x2A"
         if self.endian == "<":
             head = b"II" + version + b"\x00" + o32le(8)
@@ -4102,16 +4102,16 @@ def __len__(self) -> int:
             keys.update(self._info)
         return len(keys)
 
-    def __getitem__(self, tag):
+    def __getitem__(self, tag: int):
         if self._info is not None and tag not in self._data and tag in self._info:
             self._data[tag] = self._fixup(self._info[tag])
             del self._info[tag]
         return self._data[tag]
 
-    def __contains__(self, tag) -> bool:
+    def __contains__(self, tag: object) -> bool:
         return tag in self._data or (self._info is not None and tag in self._info)
 
-    def __setitem__(self, tag, value) -> None:
+    def __setitem__(self, tag: int, value) -> None:
         if self._info is not None and tag in self._info:
             del self._info[tag]
         self._data[tag] = value
diff --git a/src/PIL/ImageFile.py b/src/PIL/ImageFile.py
index 6b295345191..e4a7dba446b 100644
--- a/src/PIL/ImageFile.py
+++ b/src/PIL/ImageFile.py
@@ -553,7 +553,9 @@ def _save(im, fp, tile, bufsize: int = 0) -> None:
         fp.flush()
 
 
-def _encode_tile(im, fp, tile: list[_Tile], bufsize: int, fh, exc=None) -> None:
+def _encode_tile(
+    im, fp: IO[bytes], tile: list[_Tile], bufsize: int, fh, exc=None
+) -> None:
     for encoder_name, extents, offset, args in tile:
         if offset > 0:
             fp.seek(offset)
@@ -653,7 +655,7 @@ def cleanup(self) -> None:
         """
         pass
 
-    def setfd(self, fd) -> None:
+    def setfd(self, fd: IO[bytes]) -> None:
         """
         Called from ImageFile to set the Python file-like object
 
diff --git a/src/PIL/ImageQt.py b/src/PIL/ImageQt.py
index 35a37760c76..346fe49d348 100644
--- a/src/PIL/ImageQt.py
+++ b/src/PIL/ImageQt.py
@@ -19,11 +19,14 @@
 
 import sys
 from io import BytesIO
-from typing import Callable
+from typing import TYPE_CHECKING, Callable
 
 from . import Image
 from ._util import is_path
 
+if TYPE_CHECKING:
+    from . import ImageFile
+
 qt_version: str | None
 qt_versions = [
     ["6", "PyQt6"],
@@ -90,11 +93,11 @@ def fromqimage(im):
     return Image.open(b)
 
 
-def fromqpixmap(im):
+def fromqpixmap(im) -> ImageFile.ImageFile:
     return fromqimage(im)
 
 
-def align8to32(bytes, width, mode):
+def align8to32(bytes: bytes, width: int, mode: str) -> bytes:
     """
     converts each scanline of data from 8 bit to 32 bit aligned
     """
@@ -172,7 +175,7 @@ def _toqclass_helper(im):
 if qt_is_installed:
 
     class ImageQt(QImage):
-        def __init__(self, im):
+        def __init__(self, im) -> None:
             """
             An PIL image wrapper for Qt.  This is a subclass of PyQt's QImage
             class.
diff --git a/src/PIL/ImageWin.py b/src/PIL/ImageWin.py
index 978c5a9d176..4f9956087df 100644
--- a/src/PIL/ImageWin.py
+++ b/src/PIL/ImageWin.py
@@ -70,11 +70,14 @@ class Dib:
     """
 
     def __init__(
-        self, image: Image.Image | str, size: tuple[int, int] | list[int] | None = None
+        self, image: Image.Image | str, size: tuple[int, int] | None = None
     ) -> None:
         if isinstance(image, str):
             mode = image
             image = ""
+            if size is None:
+                msg = "If first argument is mode, size is required"
+                raise ValueError(msg)
         else:
             mode = image.mode
             size = image.size
@@ -105,7 +108,12 @@ def expose(self, handle):
             result = self.image.expose(handle)
         return result
 
-    def draw(self, handle, dst, src=None):
+    def draw(
+        self,
+        handle,
+        dst: tuple[int, int, int, int],
+        src: tuple[int, int, int, int] | None = None,
+    ):
         """
         Same as expose, but allows you to specify where to draw the image, and
         what part of it to draw.
@@ -115,7 +123,7 @@ def draw(self, handle, dst, src=None):
         the destination have different sizes, the image is resized as
         necessary.
         """
-        if not src:
+        if src is None:
             src = (0, 0) + self.size
         if isinstance(handle, HWND):
             dc = self.image.getdc(handle)
@@ -202,22 +210,22 @@ def __init__(
             title, self.__dispatcher, width or 0, height or 0
         )
 
-    def __dispatcher(self, action, *args):
+    def __dispatcher(self, action: str, *args):
         return getattr(self, f"ui_handle_{action}")(*args)
 
-    def ui_handle_clear(self, dc, x0, y0, x1, y1):
+    def ui_handle_clear(self, dc, x0, y0, x1, y1) -> None:
         pass
 
-    def ui_handle_damage(self, x0, y0, x1, y1):
+    def ui_handle_damage(self, x0, y0, x1, y1) -> None:
         pass
 
     def ui_handle_destroy(self) -> None:
         pass
 
-    def ui_handle_repair(self, dc, x0, y0, x1, y1):
+    def ui_handle_repair(self, dc, x0, y0, x1, y1) -> None:
         pass
 
-    def ui_handle_resize(self, width, height):
+    def ui_handle_resize(self, width, height) -> None:
         pass
 
     def mainloop(self) -> None:
@@ -227,12 +235,12 @@ def mainloop(self) -> None:
 class ImageWindow(Window):
     """Create an image window which displays the given image."""
 
-    def __init__(self, image, title="PIL"):
+    def __init__(self, image, title: str = "PIL") -> None:
         if not isinstance(image, Dib):
             image = Dib(image)
         self.image = image
         width, height = image.size
         super().__init__(title, width=width, height=height)
 
-    def ui_handle_repair(self, dc, x0, y0, x1, y1):
+    def ui_handle_repair(self, dc, x0, y0, x1, y1) -> None:
         self.image.draw(dc, (x0, y0, x1, y1))
diff --git a/src/PIL/IptcImagePlugin.py b/src/PIL/IptcImagePlugin.py
index a04616fbd64..16a18ddfaa8 100644
--- a/src/PIL/IptcImagePlugin.py
+++ b/src/PIL/IptcImagePlugin.py
@@ -18,6 +18,7 @@
 
 from collections.abc import Sequence
 from io import BytesIO
+from typing import cast
 
 from . import Image, ImageFile
 from ._binary import i16be as i16
@@ -184,7 +185,7 @@ def load(self) -> Image.core.PixelAccess | None:
 Image.register_extension(IptcImageFile.format, ".iim")
 
 
-def getiptcinfo(im):
+def getiptcinfo(im: ImageFile.ImageFile):
     """
     Get IPTC information from TIFF, JPEG, or IPTC file.
 
@@ -221,16 +222,17 @@ def getiptcinfo(im):
     class FakeImage:
         pass
 
-    im = FakeImage()
-    im.__class__ = IptcImageFile
+    fake_im = FakeImage()
+    fake_im.__class__ = IptcImageFile  # type: ignore[assignment]
+    iptc_im = cast(IptcImageFile, fake_im)
 
     # parse the IPTC information chunk
-    im.info = {}
-    im.fp = BytesIO(data)
+    iptc_im.info = {}
+    iptc_im.fp = BytesIO(data)
 
     try:
-        im._open()
+        iptc_im._open()
     except (IndexError, KeyError):
         pass  # expected failure
 
-    return im.info
+    return iptc_im.info
diff --git a/src/PIL/JpegImagePlugin.py b/src/PIL/JpegImagePlugin.py
index 54f756014da..af24faa5de2 100644
--- a/src/PIL/JpegImagePlugin.py
+++ b/src/PIL/JpegImagePlugin.py
@@ -685,7 +685,11 @@ def _save(im: Image.Image, fp: IO[bytes], filename: str | bytes) -> None:
             raise ValueError(msg)
         subsampling = get_sampling(im)
 
-    def validate_qtables(qtables):
+    def validate_qtables(
+        qtables: (
+            str | tuple[list[int], ...] | list[list[int]] | dict[int, list[int]] | None
+        )
+    ) -> list[list[int]] | None:
         if qtables is None:
             return qtables
         if isinstance(qtables, str):
@@ -715,12 +719,12 @@ def validate_qtables(qtables):
                     if len(table) != 64:
                         msg = "Invalid quantization table"
                         raise TypeError(msg)
-                    table = array.array("H", table)
+                    table_array = array.array("H", table)
                 except TypeError as e:
                     msg = "Invalid quantization table"
                     raise ValueError(msg) from e
                 else:
-                    qtables[idx] = list(table)
+                    qtables[idx] = list(table_array)
             return qtables
 
     if qtables == "keep":
diff --git a/src/PIL/PngImagePlugin.py b/src/PIL/PngImagePlugin.py
index 6990b6d05b0..247f908edaa 100644
--- a/src/PIL/PngImagePlugin.py
+++ b/src/PIL/PngImagePlugin.py
@@ -39,7 +39,7 @@
 import warnings
 import zlib
 from enum import IntEnum
-from typing import IO, TYPE_CHECKING, Any, NoReturn
+from typing import IO, TYPE_CHECKING, Any, NamedTuple, NoReturn
 
 from . import Image, ImageChops, ImageFile, ImagePalette, ImageSequence
 from ._binary import i16be as i16
@@ -1126,7 +1126,21 @@ def write(self, data: bytes) -> None:
         self.seq_num += 1
 
 
-def _write_multiple_frames(im, fp, chunk, mode, rawmode, default_image, append_images):
+class _Frame(NamedTuple):
+    im: Image.Image
+    bbox: tuple[int, int, int, int] | None
+    encoderinfo: dict[str, Any]
+
+
+def _write_multiple_frames(
+    im: Image.Image,
+    fp: IO[bytes],
+    chunk,
+    mode: str,
+    rawmode: str,
+    default_image: Image.Image | None,
+    append_images: list[Image.Image],
+) -> Image.Image | None:
     duration = im.encoderinfo.get("duration")
     loop = im.encoderinfo.get("loop", im.info.get("loop", 0))
     disposal = im.encoderinfo.get("disposal", im.info.get("disposal", Disposal.OP_NONE))
@@ -1137,7 +1151,7 @@ def _write_multiple_frames(im, fp, chunk, mode, rawmode, default_image, append_i
     else:
         chain = itertools.chain([im], append_images)
 
-    im_frames = []
+    im_frames: list[_Frame] = []
     frame_count = 0
     for im_seq in chain:
         for im_frame in ImageSequence.Iterator(im_seq):
@@ -1158,24 +1172,24 @@ def _write_multiple_frames(im, fp, chunk, mode, rawmode, default_image, append_i
 
             if im_frames:
                 previous = im_frames[-1]
-                prev_disposal = previous["encoderinfo"].get("disposal")
-                prev_blend = previous["encoderinfo"].get("blend")
+                prev_disposal = previous.encoderinfo.get("disposal")
+                prev_blend = previous.encoderinfo.get("blend")
                 if prev_disposal == Disposal.OP_PREVIOUS and len(im_frames) < 2:
                     prev_disposal = Disposal.OP_BACKGROUND
 
                 if prev_disposal == Disposal.OP_BACKGROUND:
-                    base_im = previous["im"].copy()
+                    base_im = previous.im.copy()
                     dispose = Image.core.fill("RGBA", im.size, (0, 0, 0, 0))
-                    bbox = previous["bbox"]
+                    bbox = previous.bbox
                     if bbox:
                         dispose = dispose.crop(bbox)
                     else:
                         bbox = (0, 0) + im.size
                     base_im.paste(dispose, bbox)
                 elif prev_disposal == Disposal.OP_PREVIOUS:
-                    base_im = im_frames[-2]["im"]
+                    base_im = im_frames[-2].im
                 else:
-                    base_im = previous["im"]
+                    base_im = previous.im
                 delta = ImageChops.subtract_modulo(
                     im_frame.convert("RGBA"), base_im.convert("RGBA")
                 )
@@ -1186,14 +1200,14 @@ def _write_multiple_frames(im, fp, chunk, mode, rawmode, default_image, append_i
                     and prev_blend == encoderinfo.get("blend")
                     and "duration" in encoderinfo
                 ):
-                    previous["encoderinfo"]["duration"] += encoderinfo["duration"]
+                    previous.encoderinfo["duration"] += encoderinfo["duration"]
                     continue
             else:
                 bbox = None
-            im_frames.append({"im": im_frame, "bbox": bbox, "encoderinfo": encoderinfo})
+            im_frames.append(_Frame(im_frame, bbox, encoderinfo))
 
     if len(im_frames) == 1 and not default_image:
-        return im_frames[0]["im"]
+        return im_frames[0].im
 
     # animation control
     chunk(
@@ -1211,14 +1225,14 @@ def _write_multiple_frames(im, fp, chunk, mode, rawmode, default_image, append_i
 
     seq_num = 0
     for frame, frame_data in enumerate(im_frames):
-        im_frame = frame_data["im"]
-        if not frame_data["bbox"]:
+        im_frame = frame_data.im
+        if not frame_data.bbox:
             bbox = (0, 0) + im_frame.size
         else:
-            bbox = frame_data["bbox"]
+            bbox = frame_data.bbox
             im_frame = im_frame.crop(bbox)
         size = im_frame.size
-        encoderinfo = frame_data["encoderinfo"]
+        encoderinfo = frame_data.encoderinfo
         frame_duration = int(round(encoderinfo.get("duration", 0)))
         frame_disposal = encoderinfo.get("disposal", disposal)
         frame_blend = encoderinfo.get("blend", blend)
@@ -1253,6 +1267,7 @@ def _write_multiple_frames(im, fp, chunk, mode, rawmode, default_image, append_i
                 [("zip", (0, 0) + im_frame.size, 0, rawmode)],
             )
             seq_num = fdat_chunks.seq_num
+    return None
 
 
 def _save_all(im: Image.Image, fp: IO[bytes], filename: str | bytes) -> None:
@@ -1437,12 +1452,15 @@ def _save(
             exif = exif[6:]
         chunk(fp, b"eXIf", exif)
 
+    single_im: Image.Image | None = im
     if save_all:
-        im = _write_multiple_frames(
+        single_im = _write_multiple_frames(
             im, fp, chunk, mode, rawmode, default_image, append_images
         )
-    if im:
-        ImageFile._save(im, _idat(fp, chunk), [("zip", (0, 0) + im.size, 0, rawmode)])
+    if single_im:
+        ImageFile._save(
+            single_im, _idat(fp, chunk), [("zip", (0, 0) + single_im.size, 0, rawmode)]
+        )
 
     if info:
         for info_chunk in info.chunks:

From 76e5e12f9855e59eaf393c40e68f4e737f1175fd Mon Sep 17 00:00:00 2001
From: Andrew Murray <radarhere@users.noreply.github.com>
Date: Mon, 15 Jul 2024 20:48:39 +1000
Subject: [PATCH 0816/1178] Simplified code

---
 src/_imagingft.c | 3 +--
 1 file changed, 1 insertion(+), 2 deletions(-)

diff --git a/src/_imagingft.c b/src/_imagingft.c
index 6c2885c6193..c6d20fe4509 100644
--- a/src/_imagingft.c
+++ b/src/_imagingft.c
@@ -1315,8 +1315,7 @@ font_getvaraxes(FontObject *self) {
                     FT_Done_MM_Var(library, master);
                     return NULL;
                 }
-                PyDict_SetItemString(
-                    list_axis, "name", axis_name ? axis_name : Py_None);
+                PyDict_SetItemString(list_axis, "name", axis_name);
                 Py_DECREF(axis_name);
                 break;
             }

From 3eeef83517b12d4e7af826b3aa0f6ebc82faf1fa Mon Sep 17 00:00:00 2001
From: Andrew Murray <3112309+radarhere@users.noreply.github.com>
Date: Tue, 16 Jul 2024 16:40:17 +1000
Subject: [PATCH 0817/1178] Updated condition

Co-authored-by: Hugo van Kemenade <1324225+hugovk@users.noreply.github.com>
---
 src/PIL/IcoImagePlugin.py | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/src/PIL/IcoImagePlugin.py b/src/PIL/IcoImagePlugin.py
index 8be1bd316c3..c891024f56e 100644
--- a/src/PIL/IcoImagePlugin.py
+++ b/src/PIL/IcoImagePlugin.py
@@ -229,7 +229,7 @@ def frame(self, idx: int) -> Image.Image:
             im.tile[0] = d, (0, 0) + im.size, o, a
 
             # figure out where AND mask image starts
-            if 32 == header.bpp:
+            if header.bpp == 32:
                 # 32-bit color depth icon image allows semitransparent areas
                 # PIL's DIB format ignores transparency bits, recover them.
                 # The DIB is packed in BGRX byte order where X is the alpha

From e89be771452731e1387f2a9c2fcb47a6d8e3350d Mon Sep 17 00:00:00 2001
From: Lysandros Nikolaou <lisandrosnik@gmail.com>
Date: Tue, 16 Jul 2024 10:21:24 +0200
Subject: [PATCH 0818/1178] Upload wheels to scientific-python-nightly-wheels
 index

---
 .github/workflows/wheels.yml | 22 ++++++++++++++++++++++
 1 file changed, 22 insertions(+)

diff --git a/.github/workflows/wheels.yml b/.github/workflows/wheels.yml
index e32f14529a7..3013f0c3786 100644
--- a/.github/workflows/wheels.yml
+++ b/.github/workflows/wheels.yml
@@ -1,6 +1,14 @@
 name: Wheels
 
 on:
+  schedule:
+  #        ┌───────────── minute (0 - 59)
+  #        │  ┌───────────── hour (0 - 23)
+  #        │  │ ┌───────────── day of the month (1 - 31)
+  #        │  │ │ ┌───────────── month (1 - 12 or JAN-DEC)
+  #        │  │ │ │ ┌───────────── day of the week (0 - 6 or SUN-SAT)
+  #        │  │ │ │ │
+  - cron: "42 1 * * 0,3"
   push:
     paths:
       - ".ci/requirements-cibw.txt"
@@ -140,6 +148,13 @@ jobs:
           name: dist-${{ matrix.os }}-${{ matrix.cibw_arch }}${{ matrix.manylinux && format('-{0}', matrix.manylinux) }}
           path: ./wheelhouse/*.whl
 
+      - name: Upload wheels to scientific-python-nightly-wheels
+        if: github.event_name == 'schedule' || github.event_name == 'workflow_dispatch'          
+        uses: scientific-python/upload-nightly-action@b67d7fcc0396e1128a474d1ab2b48aa94680f9fc # 0.5.0
+        with:
+          artifacts_path: ./wheelhouse
+          anaconda_nightly_upload_token: ${{ secrets.PILLOW_NIGHTLY_UPLOAD_TOKEN }}
+
   windows:
     name: Windows ${{ matrix.cibw_arch }}
     runs-on: windows-latest
@@ -226,6 +241,13 @@ jobs:
           name: fribidi-windows-${{ matrix.cibw_arch }}
           path: winbuild\build\bin\fribidi*
 
+      - name: Upload wheels to scientific-python-nightly-wheels
+        if: github.event_name == 'schedule' || github.event_name == 'workflow_dispatch'          
+        uses: scientific-python/upload-nightly-action@b67d7fcc0396e1128a474d1ab2b48aa94680f9fc # 0.5.0
+        with:
+          artifacts_path: ./wheelhouse
+          anaconda_nightly_upload_token: ${{ secrets.PILLOW_NIGHTLY_UPLOAD_TOKEN }}
+
   sdist:
     runs-on: ubuntu-latest
     steps:

From 784a87449063cb2ee2c65988574e83399b018f60 Mon Sep 17 00:00:00 2001
From: Andrew Murray <radarhere@users.noreply.github.com>
Date: Tue, 16 Jul 2024 18:38:50 +1000
Subject: [PATCH 0819/1178] Trim whitespace

---
 .github/workflows/wheels.yml | 4 ++--
 1 file changed, 2 insertions(+), 2 deletions(-)

diff --git a/.github/workflows/wheels.yml b/.github/workflows/wheels.yml
index 3013f0c3786..191eaffebc3 100644
--- a/.github/workflows/wheels.yml
+++ b/.github/workflows/wheels.yml
@@ -149,7 +149,7 @@ jobs:
           path: ./wheelhouse/*.whl
 
       - name: Upload wheels to scientific-python-nightly-wheels
-        if: github.event_name == 'schedule' || github.event_name == 'workflow_dispatch'          
+        if: github.event_name == 'schedule' || github.event_name == 'workflow_dispatch'
         uses: scientific-python/upload-nightly-action@b67d7fcc0396e1128a474d1ab2b48aa94680f9fc # 0.5.0
         with:
           artifacts_path: ./wheelhouse
@@ -242,7 +242,7 @@ jobs:
           path: winbuild\build\bin\fribidi*
 
       - name: Upload wheels to scientific-python-nightly-wheels
-        if: github.event_name == 'schedule' || github.event_name == 'workflow_dispatch'          
+        if: github.event_name == 'schedule' || github.event_name == 'workflow_dispatch'
         uses: scientific-python/upload-nightly-action@b67d7fcc0396e1128a474d1ab2b48aa94680f9fc # 0.5.0
         with:
           artifacts_path: ./wheelhouse

From 68c3542d096e314921d25539bb65e24e3760a1f3 Mon Sep 17 00:00:00 2001
From: Lysandros Nikolaou <lisandrosnik@gmail.com>
Date: Tue, 16 Jul 2024 10:42:18 +0200
Subject: [PATCH 0820/1178] Rename secret

---
 .github/workflows/wheels.yml | 4 ++--
 1 file changed, 2 insertions(+), 2 deletions(-)

diff --git a/.github/workflows/wheels.yml b/.github/workflows/wheels.yml
index 191eaffebc3..4501802cb3d 100644
--- a/.github/workflows/wheels.yml
+++ b/.github/workflows/wheels.yml
@@ -153,7 +153,7 @@ jobs:
         uses: scientific-python/upload-nightly-action@b67d7fcc0396e1128a474d1ab2b48aa94680f9fc # 0.5.0
         with:
           artifacts_path: ./wheelhouse
-          anaconda_nightly_upload_token: ${{ secrets.PILLOW_NIGHTLY_UPLOAD_TOKEN }}
+          anaconda_nightly_upload_token: ${{ secrets.ANACONDA_ORG_UPLOAD_TOKEN }}
 
   windows:
     name: Windows ${{ matrix.cibw_arch }}
@@ -246,7 +246,7 @@ jobs:
         uses: scientific-python/upload-nightly-action@b67d7fcc0396e1128a474d1ab2b48aa94680f9fc # 0.5.0
         with:
           artifacts_path: ./wheelhouse
-          anaconda_nightly_upload_token: ${{ secrets.PILLOW_NIGHTLY_UPLOAD_TOKEN }}
+          anaconda_nightly_upload_token: ${{ secrets.ANACONDA_ORG_UPLOAD_TOKEN }}
 
   sdist:
     runs-on: ubuntu-latest

From d83c7b38c42952dbd3fcab1807732363d6e64607 Mon Sep 17 00:00:00 2001
From: Andrew Murray <3112309+radarhere@users.noreply.github.com>
Date: Tue, 16 Jul 2024 20:18:25 +1000
Subject: [PATCH 0821/1178] Skip other jobs on schedule (#1)

Co-authored-by: Andrew Murray <radarhere@users.noreply.github.com>
---
 .github/workflows/wheels.yml | 2 ++
 1 file changed, 2 insertions(+)

diff --git a/.github/workflows/wheels.yml b/.github/workflows/wheels.yml
index 4501802cb3d..fa1825e45a7 100644
--- a/.github/workflows/wheels.yml
+++ b/.github/workflows/wheels.yml
@@ -41,6 +41,7 @@ env:
 
 jobs:
   build-1-QEMU-emulated-wheels:
+    if: github.event_name != 'schedule'
     name: aarch64 ${{ matrix.python-version }} ${{ matrix.spec }}
     runs-on: ubuntu-latest
     strategy:
@@ -249,6 +250,7 @@ jobs:
           anaconda_nightly_upload_token: ${{ secrets.ANACONDA_ORG_UPLOAD_TOKEN }}
 
   sdist:
+    if: github.event_name != 'schedule'
     runs-on: ubuntu-latest
     steps:
     - uses: actions/checkout@v4

From 87b23d0207fb5f703e6c143e3ca8ed7d174930ff Mon Sep 17 00:00:00 2001
From: Yay295 <Yay295@users.noreply.github.com>
Date: Sun, 19 May 2024 01:54:21 -0500
Subject: [PATCH 0822/1178] change AlignAfterOpenBracket in .clang-format to
 BlockIndent

to match the Python code
---
 .clang-format | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/.clang-format b/.clang-format
index 3199e330b96..143dde82c2c 100644
--- a/.clang-format
+++ b/.clang-format
@@ -3,7 +3,7 @@
 BasedOnStyle: Google
 AlwaysBreakAfterReturnType: All
 AllowShortIfStatementsOnASingleLine: false
-AlignAfterOpenBracket: AlwaysBreak
+AlignAfterOpenBracket: BlockIndent
 BinPackArguments: false
 BinPackParameters: false
 BreakBeforeBraces: Attach

From 2973b041c76482da213fd93e151c542577178fe3 Mon Sep 17 00:00:00 2001
From: "pre-commit-ci[bot]"
 <66853113+pre-commit-ci[bot]@users.noreply.github.com>
Date: Tue, 16 Jul 2024 12:58:00 +0000
Subject: [PATCH 0823/1178] [pre-commit.ci] auto fixes from pre-commit.com
 hooks

for more information, see https://pre-commit.ci
---
 src/Tk/_tkmini.h               |   9 +-
 src/Tk/tkImaging.c             |  24 +++--
 src/_imaging.c                 | 175 ++++++++++++++++++++-------------
 src/_imagingcms.c              |  79 ++++++++++-----
 src/_imagingft.c               |  91 +++++++++++------
 src/_imagingmath.c             |   3 +-
 src/_imagingmorph.c            |   3 +-
 src/_webp.c                    |  45 ++++++---
 src/decode.c                   |   6 +-
 src/display.c                  |  50 ++++++----
 src/encode.c                   | 108 ++++++++++++--------
 src/libImaging/Access.c        |   3 +-
 src/libImaging/BcnDecode.c     |  39 +++++---
 src/libImaging/BoxBlur.c       |  18 ++--
 src/libImaging/Chops.c         |   9 +-
 src/libImaging/ColorLUT.c      |  30 ++++--
 src/libImaging/Convert.c       |  34 +++----
 src/libImaging/ConvertYCbCr.c  |  36 ++++---
 src/libImaging/Dib.c           |  12 ++-
 src/libImaging/Draw.c          | 134 ++++++++++++++-----------
 src/libImaging/Fill.c          |   4 +-
 src/libImaging/Filter.c        |   6 +-
 src/libImaging/Geometry.c      |  34 ++++---
 src/libImaging/GetBBox.c       |  24 ++---
 src/libImaging/GifEncode.c     |   9 +-
 src/libImaging/HexDecode.c     |   3 +-
 src/libImaging/Imaging.h       |  60 +++++++----
 src/libImaging/Jpeg2KDecode.c  |  57 +++++------
 src/libImaging/Jpeg2KEncode.c  |  14 +--
 src/libImaging/JpegDecode.c    |   8 +-
 src/libImaging/JpegEncode.c    |  18 ++--
 src/libImaging/PackDecode.c    |   6 +-
 src/libImaging/Paste.c         |  54 +++++-----
 src/libImaging/PcxDecode.c     |   6 +-
 src/libImaging/PcxEncode.c     |   3 +-
 src/libImaging/Point.c         |   4 +-
 src/libImaging/Quant.c         | 105 +++++++++++++-------
 src/libImaging/QuantHash.c     |   6 +-
 src/libImaging/QuantHash.h     |  12 +--
 src/libImaging/QuantOctree.c   |  40 +++++---
 src/libImaging/QuantPngQuant.c |   3 +-
 src/libImaging/QuantPngQuant.h |   3 +-
 src/libImaging/RankFilter.c    |   3 +-
 src/libImaging/RawDecode.c     |   3 +-
 src/libImaging/RawEncode.c     |   3 +-
 src/libImaging/Reduce.c        | 105 +++++++++++++-------
 src/libImaging/Resample.c      |  36 ++++---
 src/libImaging/SgiRleDecode.c  |   9 +-
 src/libImaging/Storage.c       |   8 +-
 src/libImaging/SunRleDecode.c  |   3 +-
 src/libImaging/TgaRleDecode.c  |   3 +-
 src/libImaging/TgaRleEncode.c  |   6 +-
 src/libImaging/TiffDecode.c    | 112 ++++++++++++++-------
 src/libImaging/TiffDecode.h    |   3 +-
 src/libImaging/Unpack.c        |  24 +++--
 src/libImaging/UnpackYCC.c     |  15 ++-
 src/libImaging/UnsharpMask.c   |   3 +-
 src/libImaging/XbmEncode.c     |   3 +-
 src/libImaging/ZipDecode.c     |   9 +-
 src/libImaging/ZipEncode.c     |   9 +-
 src/map.c                      |   3 +-
 src/path.c                     |   9 +-
 62 files changed, 1088 insertions(+), 668 deletions(-)

diff --git a/src/Tk/_tkmini.h b/src/Tk/_tkmini.h
index 68247bc472d..a260fa0d1dc 100644
--- a/src/Tk/_tkmini.h
+++ b/src/Tk/_tkmini.h
@@ -80,7 +80,8 @@ typedef struct Tcl_Command_ *Tcl_Command;
 typedef void *ClientData;
 
 typedef int(Tcl_CmdProc)(
-    ClientData clientData, Tcl_Interp *interp, int argc, const char *argv[]);
+    ClientData clientData, Tcl_Interp *interp, int argc, const char *argv[]
+);
 typedef void(Tcl_CmdDeleteProc)(ClientData clientData);
 
 /* Typedefs derived from function signatures in Tcl header */
@@ -90,7 +91,8 @@ typedef Tcl_Command (*Tcl_CreateCommand_t)(
     const char *cmdName,
     Tcl_CmdProc *proc,
     ClientData clientData,
-    Tcl_CmdDeleteProc *deleteProc);
+    Tcl_CmdDeleteProc *deleteProc
+);
 /* Tcl_AppendResult */
 typedef void (*Tcl_AppendResult_t)(Tcl_Interp *interp, ...);
 
@@ -127,7 +129,8 @@ typedef int (*Tk_PhotoPutBlock_t)(
     int y,
     int width,
     int height,
-    int compRule);
+    int compRule
+);
 /* Tk_FindPhoto */
 typedef Tk_PhotoHandle (*Tk_FindPhoto_t)(Tcl_Interp *interp, const char *imageName);
 /* Tk_PhotoGetImage */
diff --git a/src/Tk/tkImaging.c b/src/Tk/tkImaging.c
index ef1c00a94e8..727ee6bed51 100644
--- a/src/Tk/tkImaging.c
+++ b/src/Tk/tkImaging.c
@@ -73,14 +73,16 @@ ImagingFind(const char *name) {
 
 static int
 PyImagingPhotoPut(
-    ClientData clientdata, Tcl_Interp *interp, int argc, const char **argv) {
+    ClientData clientdata, Tcl_Interp *interp, int argc, const char **argv
+) {
     Imaging im;
     Tk_PhotoHandle photo;
     Tk_PhotoImageBlock block;
 
     if (argc != 3) {
         TCL_APPEND_RESULT(
-            interp, "usage: ", argv[0], " destPhoto srcImage", (char *)NULL);
+            interp, "usage: ", argv[0], " destPhoto srcImage", (char *)NULL
+        );
         return TCL_ERROR;
     }
 
@@ -128,14 +130,16 @@ PyImagingPhotoPut(
     block.pixelPtr = (unsigned char *)im->block;
 
     TK_PHOTO_PUT_BLOCK(
-        interp, photo, &block, 0, 0, block.width, block.height, TK_PHOTO_COMPOSITE_SET);
+        interp, photo, &block, 0, 0, block.width, block.height, TK_PHOTO_COMPOSITE_SET
+    );
 
     return TCL_OK;
 }
 
 static int
 PyImagingPhotoGet(
-    ClientData clientdata, Tcl_Interp *interp, int argc, const char **argv) {
+    ClientData clientdata, Tcl_Interp *interp, int argc, const char **argv
+) {
     Imaging im;
     Tk_PhotoHandle photo;
     Tk_PhotoImageBlock block;
@@ -143,7 +147,8 @@ PyImagingPhotoGet(
 
     if (argc != 3) {
         TCL_APPEND_RESULT(
-            interp, "usage: ", argv[0], " srcPhoto destImage", (char *)NULL);
+            interp, "usage: ", argv[0], " srcPhoto destImage", (char *)NULL
+        );
         return TCL_ERROR;
     }
 
@@ -183,13 +188,15 @@ TkImaging_Init(Tcl_Interp *interp) {
         "PyImagingPhoto",
         PyImagingPhotoPut,
         (ClientData)0,
-        (Tcl_CmdDeleteProc *)NULL);
+        (Tcl_CmdDeleteProc *)NULL
+    );
     TCL_CREATE_COMMAND(
         interp,
         "PyImagingPhotoGet",
         PyImagingPhotoGet,
         (ClientData)0,
-        (Tcl_CmdDeleteProc *)NULL);
+        (Tcl_CmdDeleteProc *)NULL
+    );
 }
 
 /*
@@ -394,7 +401,8 @@ _func_loader(void *lib) {
     }
     return (
         (TK_PHOTO_PUT_BLOCK = (Tk_PhotoPutBlock_t)_dfunc(lib, "Tk_PhotoPutBlock")) ==
-        NULL);
+        NULL
+    );
 }
 
 int
diff --git a/src/_imaging.c b/src/_imaging.c
index ac6310a445e..5c2f7b4b623 100644
--- a/src/_imaging.c
+++ b/src/_imaging.c
@@ -290,7 +290,8 @@ ImagingError_ModeError(void) {
 void *
 ImagingError_ValueError(const char *message) {
     PyErr_SetString(
-        PyExc_ValueError, (message) ? (char *)message : "unrecognized argument value");
+        PyExc_ValueError, (message) ? (char *)message : "unrecognized argument value"
+    );
     return NULL;
 }
 
@@ -467,7 +468,8 @@ getpixel(Imaging im, ImagingAccess access, int x, int y) {
                     return Py_BuildValue("BBB", pixel.b[0], pixel.b[1], pixel.b[2]);
                 case 4:
                     return Py_BuildValue(
-                        "BBBB", pixel.b[0], pixel.b[1], pixel.b[2], pixel.b[3]);
+                        "BBBB", pixel.b[0], pixel.b[1], pixel.b[2], pixel.b[3]
+                    );
             }
             break;
         case IMAGING_TYPE_INT32:
@@ -518,7 +520,8 @@ getink(PyObject *color, Imaging im, char *ink) {
             rIsInt = 1;
         } else if (im->bands == 1) {
             PyErr_SetString(
-                PyExc_TypeError, "color must be int or single-element tuple");
+                PyExc_TypeError, "color must be int or single-element tuple"
+            );
             return NULL;
         } else if (tupleSize == -1) {
             PyErr_SetString(PyExc_TypeError, "color must be int or tuple");
@@ -534,8 +537,8 @@ getink(PyObject *color, Imaging im, char *ink) {
                 if (rIsInt != 1) {
                     if (tupleSize != 1) {
                         PyErr_SetString(
-                            PyExc_TypeError,
-                            "color must be int or single-element tuple");
+                            PyExc_TypeError, "color must be int or single-element tuple"
+                        );
                         return NULL;
                     } else if (!PyArg_ParseTuple(color, "L", &r)) {
                         return NULL;
@@ -556,7 +559,8 @@ getink(PyObject *color, Imaging im, char *ink) {
                         if (tupleSize != 1 && tupleSize != 2) {
                             PyErr_SetString(
                                 PyExc_TypeError,
-                                "color must be int, or tuple of one or two elements");
+                                "color must be int, or tuple of one or two elements"
+                            );
                             return NULL;
                         } else if (!PyArg_ParseTuple(color, "L|i", &r, &a)) {
                             return NULL;
@@ -567,7 +571,8 @@ getink(PyObject *color, Imaging im, char *ink) {
                             PyErr_SetString(
                                 PyExc_TypeError,
                                 "color must be int, or tuple of one, three or four "
-                                "elements");
+                                "elements"
+                            );
                             return NULL;
                         } else if (!PyArg_ParseTuple(color, "Lii|i", &r, &g, &b, &a)) {
                             return NULL;
@@ -608,7 +613,8 @@ getink(PyObject *color, Imaging im, char *ink) {
                 } else if (tupleSize != 3) {
                     PyErr_SetString(
                         PyExc_TypeError,
-                        "color must be int, or tuple of one or three elements");
+                        "color must be int, or tuple of one or three elements"
+                    );
                     return NULL;
                 } else if (!PyArg_ParseTuple(color, "iiL", &b, &g, &r)) {
                     return NULL;
@@ -733,7 +739,8 @@ _alpha_composite(ImagingObject *self, PyObject *args) {
     ImagingObject *imagep2;
 
     if (!PyArg_ParseTuple(
-            args, "O!O!", &Imaging_Type, &imagep1, &Imaging_Type, &imagep2)) {
+            args, "O!O!", &Imaging_Type, &imagep1, &Imaging_Type, &imagep2
+        )) {
         return NULL;
     }
 
@@ -748,7 +755,8 @@ _blend(ImagingObject *self, PyObject *args) {
 
     alpha = 0.5;
     if (!PyArg_ParseTuple(
-            args, "O!O!|d", &Imaging_Type, &imagep1, &Imaging_Type, &imagep2, &alpha)) {
+            args, "O!O!|d", &Imaging_Type, &imagep1, &Imaging_Type, &imagep2, &alpha
+        )) {
         return NULL;
     }
 
@@ -827,7 +835,8 @@ _prepare_lut_table(PyObject *table, Py_ssize_t table_size) {
                 break;
             case TYPE_FLOAT32:
                 memcpy(
-                    &item, ((char *)table_data) + i * sizeof(FLOAT32), sizeof(FLOAT32));
+                    &item, ((char *)table_data) + i * sizeof(FLOAT32), sizeof(FLOAT32)
+                );
                 break;
             case TYPE_DOUBLE:
                 memcpy(&dtmp, ((char *)table_data) + i * sizeof(dtmp), sizeof(dtmp));
@@ -878,7 +887,8 @@ _color_lut_3d(ImagingObject *self, PyObject *args) {
             &size1D,
             &size2D,
             &size3D,
-            &table)) {
+            &table
+        )) {
         return NULL;
     }
 
@@ -896,7 +906,8 @@ _color_lut_3d(ImagingObject *self, PyObject *args) {
     if (2 > size1D || size1D > 65 || 2 > size2D || size2D > 65 || 2 > size3D ||
         size3D > 65) {
         PyErr_SetString(
-            PyExc_ValueError, "Table size in any dimension should be from 2 to 65");
+            PyExc_ValueError, "Table size in any dimension should be from 2 to 65"
+        );
         return NULL;
     }
 
@@ -913,13 +924,8 @@ _color_lut_3d(ImagingObject *self, PyObject *args) {
     }
 
     if (!ImagingColorLUT3D_linear(
-            imOut,
-            self->image,
-            table_channels,
-            size1D,
-            size2D,
-            size3D,
-            prepared_table)) {
+            imOut, self->image, table_channels, size1D, size2D, size3D, prepared_table
+        )) {
         free(prepared_table);
         ImagingDelete(imOut);
         return NULL;
@@ -943,7 +949,8 @@ _convert(ImagingObject *self, PyObject *args) {
         if (!PyImaging_Check(paletteimage)) {
             PyObject_Print((PyObject *)paletteimage, stderr, 0);
             PyErr_SetString(
-                PyExc_ValueError, "palette argument must be image with mode 'P'");
+                PyExc_ValueError, "palette argument must be image with mode 'P'"
+            );
             return NULL;
         }
         if (paletteimage->image->palette == NULL) {
@@ -953,7 +960,8 @@ _convert(ImagingObject *self, PyObject *args) {
     }
 
     return PyImagingNew(ImagingConvert(
-        self->image, mode, paletteimage ? paletteimage->image->palette : NULL, dither));
+        self->image, mode, paletteimage ? paletteimage->image->palette : NULL, dither
+    ));
 }
 
 static PyObject *
@@ -961,7 +969,8 @@ _convert2(ImagingObject *self, PyObject *args) {
     ImagingObject *imagep1;
     ImagingObject *imagep2;
     if (!PyArg_ParseTuple(
-            args, "O!O!", &Imaging_Type, &imagep1, &Imaging_Type, &imagep2)) {
+            args, "O!O!", &Imaging_Type, &imagep1, &Imaging_Type, &imagep2
+        )) {
         return NULL;
     }
 
@@ -994,7 +1003,8 @@ _convert_matrix(ImagingObject *self, PyObject *args) {
                 m + 8,
                 m + 9,
                 m + 10,
-                m + 11)) {
+                m + 11
+            )) {
             return NULL;
         }
     }
@@ -1055,7 +1065,8 @@ _filter(ImagingObject *self, PyObject *args) {
     float divisor, offset;
     PyObject *kernel = NULL;
     if (!PyArg_ParseTuple(
-            args, "(ii)ffO", &xsize, &ysize, &divisor, &offset, &kernel)) {
+            args, "(ii)ffO", &xsize, &ysize, &divisor, &offset, &kernel
+        )) {
         return NULL;
     }
 
@@ -1138,7 +1149,8 @@ _getpalette(ImagingObject *self, PyObject *args) {
     }
 
     pack(
-        (UINT8 *)PyBytes_AsString(palette), self->image->palette->palette, palettesize);
+        (UINT8 *)PyBytes_AsString(palette), self->image->palette->palette, palettesize
+    );
 
     return palette;
 }
@@ -1232,7 +1244,8 @@ union hist_extrema {
 
 static union hist_extrema *
 parse_histogram_extremap(
-    ImagingObject *self, PyObject *extremap, union hist_extrema *ep) {
+    ImagingObject *self, PyObject *extremap, union hist_extrema *ep
+) {
     int i0, i1;
     double f0, f1;
 
@@ -1392,7 +1405,8 @@ _paste(ImagingObject *self, PyObject *args) {
     int x0, y0, x1, y1;
     ImagingObject *maskp = NULL;
     if (!PyArg_ParseTuple(
-            args, "O(iiii)|O!", &source, &x0, &y0, &x1, &y1, &Imaging_Type, &maskp)) {
+            args, "O(iiii)|O!", &source, &x0, &y0, &x1, &y1, &Imaging_Type, &maskp
+        )) {
         return NULL;
     }
 
@@ -1404,14 +1418,16 @@ _paste(ImagingObject *self, PyObject *args) {
             x0,
             y0,
             x1,
-            y1);
+            y1
+        );
 
     } else {
         if (!getink(source, self->image, ink)) {
             return NULL;
         }
         status = ImagingFill2(
-            self->image, ink, (maskp) ? maskp->image : NULL, x0, y0, x1, y1);
+            self->image, ink, (maskp) ? maskp->image : NULL, x0, y0, x1, y1
+        );
     }
 
     if (status < 0) {
@@ -1729,7 +1745,8 @@ _putpalette(ImagingObject *self, PyObject *args) {
     UINT8 *palette;
     Py_ssize_t palettesize;
     if (!PyArg_ParseTuple(
-            args, "ssy#", &palette_mode, &rawmode, &palette, &palettesize)) {
+            args, "ssy#", &palette_mode, &rawmode, &palette, &palettesize
+        )) {
         return NULL;
     }
 
@@ -1887,7 +1904,8 @@ _resize(ImagingObject *self, PyObject *args) {
             &box[0],
             &box[1],
             &box[2],
-            &box[3])) {
+            &box[3]
+        )) {
         return NULL;
     }
 
@@ -1923,7 +1941,8 @@ _resize(ImagingObject *self, PyObject *args) {
         imOut = ImagingNewDirty(imIn->mode, xsize, ysize);
 
         imOut = ImagingTransform(
-            imOut, imIn, IMAGING_TRANSFORM_AFFINE, 0, 0, xsize, ysize, a, filter, 1);
+            imOut, imIn, IMAGING_TRANSFORM_AFFINE, 0, 0, xsize, ysize, a, filter, 1
+        );
     } else {
         imOut = ImagingResample(imIn, xsize, ysize, filter, box);
     }
@@ -1944,14 +1963,8 @@ _reduce(ImagingObject *self, PyObject *args) {
     box[3] = imIn->ysize;
 
     if (!PyArg_ParseTuple(
-            args,
-            "(ii)|(iiii)",
-            &xscale,
-            &yscale,
-            &box[0],
-            &box[1],
-            &box[2],
-            &box[3])) {
+            args, "(ii)|(iiii)", &xscale, &yscale, &box[0], &box[1], &box[2], &box[3]
+        )) {
         return NULL;
     }
 
@@ -2053,7 +2066,8 @@ _transform(ImagingObject *self, PyObject *args) {
             &method,
             &data,
             &filter,
-            &fill)) {
+            &fill
+        )) {
         return NULL;
     }
 
@@ -2077,7 +2091,8 @@ _transform(ImagingObject *self, PyObject *args) {
     }
 
     imOut = ImagingTransform(
-        self->image, imagep->image, method, x0, y0, x1, y1, a, filter, fill);
+        self->image, imagep->image, method, x0, y0, x1, y1, a, filter, fill
+    );
 
     free(a);
 
@@ -2250,7 +2265,8 @@ _getcolors(ImagingObject *self, PyObject *args) {
         for (i = 0; i < colors; i++) {
             ImagingColorItem *v = &items[i];
             PyObject *item = Py_BuildValue(
-                "iN", v->count, getpixel(self->image, self->access, v->x, v->y));
+                "iN", v->count, getpixel(self->image, self->access, v->x, v->y)
+            );
             if (item == NULL) {
                 Py_DECREF(out);
                 free(items);
@@ -2316,14 +2332,16 @@ _getprojection(ImagingObject *self) {
     }
 
     ImagingGetProjection(
-        self->image, (unsigned char *)xprofile, (unsigned char *)yprofile);
+        self->image, (unsigned char *)xprofile, (unsigned char *)yprofile
+    );
 
     result = Py_BuildValue(
         "y#y#",
         xprofile,
         (Py_ssize_t)self->image->xsize,
         yprofile,
-        (Py_ssize_t)self->image->ysize);
+        (Py_ssize_t)self->image->ysize
+    );
 
     free(xprofile);
     free(yprofile);
@@ -2397,7 +2415,8 @@ _merge(PyObject *self, PyObject *args) {
             &Imaging_Type,
             &band2,
             &Imaging_Type,
-            &band3)) {
+            &band3
+        )) {
         return NULL;
     }
 
@@ -2643,7 +2662,8 @@ _font_new(PyObject *self_, PyObject *args) {
     unsigned char *glyphdata;
     Py_ssize_t glyphdata_length;
     if (!PyArg_ParseTuple(
-            args, "O!y#", &Imaging_Type, &imagep, &glyphdata, &glyphdata_length)) {
+            args, "O!y#", &Imaging_Type, &imagep, &glyphdata, &glyphdata_length
+        )) {
         return NULL;
     }
 
@@ -2801,7 +2821,8 @@ _font_getmask(ImagingFontObject *self, PyObject *args) {
         if (i == 0 || text[i] != text[i - 1]) {
             ImagingDelete(bitmap);
             bitmap = ImagingCrop(
-                self->bitmap, glyph->sx0, glyph->sy0, glyph->sx1, glyph->sy1);
+                self->bitmap, glyph->sx0, glyph->sy0, glyph->sx1, glyph->sy1
+            );
             if (!bitmap) {
                 goto failed;
             }
@@ -2813,7 +2834,8 @@ _font_getmask(ImagingFontObject *self, PyObject *args) {
             glyph->dx0 + x,
             glyph->dy0 + b,
             glyph->dx1 + x,
-            glyph->dy1 + b);
+            glyph->dy1 + b
+        );
         if (status < 0) {
             goto failed;
         }
@@ -2952,7 +2974,8 @@ _draw_arc(ImagingDrawObject *self, PyObject *args) {
         end,
         &ink,
         width,
-        self->blend);
+        self->blend
+    );
 
     free(xy);
 
@@ -2982,13 +3005,15 @@ _draw_bitmap(ImagingDrawObject *self, PyObject *args) {
     }
     if (n != 1) {
         PyErr_SetString(
-            PyExc_TypeError, "coordinate list must contain exactly 1 coordinate");
+            PyExc_TypeError, "coordinate list must contain exactly 1 coordinate"
+        );
         free(xy);
         return NULL;
     }
 
     n = ImagingDrawBitmap(
-        self->image->image, (int)xy[0], (int)xy[1], bitmap->image, &ink, self->blend);
+        self->image->image, (int)xy[0], (int)xy[1], bitmap->image, &ink, self->blend
+    );
 
     free(xy);
 
@@ -3044,7 +3069,8 @@ _draw_chord(ImagingDrawObject *self, PyObject *args) {
         &ink,
         fill,
         width,
-        self->blend);
+        self->blend
+    );
 
     free(xy);
 
@@ -3098,7 +3124,8 @@ _draw_ellipse(ImagingDrawObject *self, PyObject *args) {
         &ink,
         fill,
         width,
-        self->blend);
+        self->blend
+    );
 
     free(xy);
 
@@ -3138,14 +3165,16 @@ _draw_lines(ImagingDrawObject *self, PyObject *args) {
                     (int)p[2],
                     (int)p[3],
                     &ink,
-                    self->blend) < 0) {
+                    self->blend
+                ) < 0) {
                 free(xy);
                 return NULL;
             }
         }
         if (p) { /* draw last point */
             ImagingDrawPoint(
-                self->image->image, (int)p[2], (int)p[3], &ink, self->blend);
+                self->image->image, (int)p[2], (int)p[3], &ink, self->blend
+            );
         }
     } else {
         for (i = 0; i < n - 1; i++) {
@@ -3158,7 +3187,8 @@ _draw_lines(ImagingDrawObject *self, PyObject *args) {
                     (int)p[3],
                     &ink,
                     width,
-                    self->blend) < 0) {
+                    self->blend
+                ) < 0) {
                 free(xy);
                 return NULL;
             }
@@ -3190,7 +3220,8 @@ _draw_points(ImagingDrawObject *self, PyObject *args) {
     for (i = 0; i < n; i++) {
         double *p = &xy[i + i];
         if (ImagingDrawPoint(
-                self->image->image, (int)p[0], (int)p[1], &ink, self->blend) < 0) {
+                self->image->image, (int)p[0], (int)p[1], &ink, self->blend
+            ) < 0) {
             free(xy);
             return NULL;
         }
@@ -3279,7 +3310,8 @@ _draw_pieslice(ImagingDrawObject *self, PyObject *args) {
         &ink,
         fill,
         width,
-        self->blend);
+        self->blend
+    );
 
     free(xy);
 
@@ -3311,7 +3343,8 @@ _draw_polygon(ImagingDrawObject *self, PyObject *args) {
     }
     if (n < 2) {
         PyErr_SetString(
-            PyExc_TypeError, "coordinate list must contain at least 2 coordinates");
+            PyExc_TypeError, "coordinate list must contain at least 2 coordinates"
+        );
         free(xy);
         return NULL;
     }
@@ -3384,7 +3417,8 @@ _draw_rectangle(ImagingDrawObject *self, PyObject *args) {
         &ink,
         fill,
         width,
-        self->blend);
+        self->blend
+    );
 
     free(xy);
 
@@ -3524,7 +3558,8 @@ _effect_mandelbrot(ImagingObject *self, PyObject *args) {
             &extent[1],
             &extent[2],
             &extent[3],
-            &quality)) {
+            &quality
+        )) {
         return NULL;
     }
 
@@ -3752,7 +3787,8 @@ _getattr_unsafe_ptrs(ImagingObject *self, void *closure) {
         "image32",
         self->image->image32,
         "image",
-        self->image->image);
+        self->image->image
+    );
 }
 
 static struct PyGetSetDef getsetters[] = {
@@ -3762,7 +3798,8 @@ static struct PyGetSetDef getsetters[] = {
     {"id", (getter)_getattr_id},
     {"ptr", (getter)_getattr_ptr},
     {"unsafe_ptrs", (getter)_getattr_unsafe_ptrs},
-    {NULL}};
+    {NULL}
+};
 
 /* basic sequence semantics */
 
@@ -4071,9 +4108,8 @@ _set_blocks_max(PyObject *self, PyObject *args) {
     if (blocks_max < 0) {
         PyErr_SetString(PyExc_ValueError, "blocks_max should be greater than 0");
         return NULL;
-    } else if (
-        (unsigned long)blocks_max >
-        SIZE_MAX / sizeof(ImagingDefaultArena.blocks_pool[0])) {
+    } else if ((unsigned long)blocks_max >
+               SIZE_MAX / sizeof(ImagingDefaultArena.blocks_pool[0])) {
         PyErr_SetString(PyExc_ValueError, "blocks_max is too large");
         return NULL;
     }
@@ -4428,7 +4464,8 @@ setup_module(PyObject *m) {
 
     PyObject *pillow_version = PyUnicode_FromString(version);
     PyDict_SetItemString(
-        d, "PILLOW_VERSION", pillow_version ? pillow_version : Py_None);
+        d, "PILLOW_VERSION", pillow_version ? pillow_version : Py_None
+    );
     Py_XDECREF(pillow_version);
 
     return 0;
diff --git a/src/_imagingcms.c b/src/_imagingcms.c
index 628662b304f..bafe787a743 100644
--- a/src/_imagingcms.c
+++ b/src/_imagingcms.c
@@ -331,7 +331,8 @@ pyCMScopyAux(cmsHTRANSFORM hTransform, Imaging imDst, const Imaging imSrc) {
                 memcpy(
                     pDstExtras + x * dstChunkSize,
                     pSrcExtras + x * srcChunkSize,
-                    channelSize);
+                    channelSize
+                );
             }
         }
     }
@@ -373,7 +374,8 @@ _buildTransform(
     char *sInMode,
     char *sOutMode,
     int iRenderingIntent,
-    cmsUInt32Number cmsFLAGS) {
+    cmsUInt32Number cmsFLAGS
+) {
     cmsHTRANSFORM hTransform;
 
     Py_BEGIN_ALLOW_THREADS
@@ -385,7 +387,8 @@ _buildTransform(
             hOutputProfile,
             findLCMStype(sOutMode),
             iRenderingIntent,
-            cmsFLAGS);
+            cmsFLAGS
+        );
 
     Py_END_ALLOW_THREADS;
 
@@ -405,7 +408,8 @@ _buildProofTransform(
     char *sOutMode,
     int iRenderingIntent,
     int iProofIntent,
-    cmsUInt32Number cmsFLAGS) {
+    cmsUInt32Number cmsFLAGS
+) {
     cmsHTRANSFORM hTransform;
 
     Py_BEGIN_ALLOW_THREADS
@@ -419,7 +423,8 @@ _buildProofTransform(
             hProofProfile,
             iRenderingIntent,
             iProofIntent,
-            cmsFLAGS);
+            cmsFLAGS
+        );
 
     Py_END_ALLOW_THREADS;
 
@@ -454,7 +459,8 @@ buildTransform(PyObject *self, PyObject *args) {
             &sInMode,
             &sOutMode,
             &iRenderingIntent,
-            &cmsFLAGS)) {
+            &cmsFLAGS
+        )) {
         return NULL;
     }
 
@@ -464,7 +470,8 @@ buildTransform(PyObject *self, PyObject *args) {
         sInMode,
         sOutMode,
         iRenderingIntent,
-        cmsFLAGS);
+        cmsFLAGS
+    );
 
     if (!transform) {
         return NULL;
@@ -499,7 +506,8 @@ buildProofTransform(PyObject *self, PyObject *args) {
             &sOutMode,
             &iRenderingIntent,
             &iProofIntent,
-            &cmsFLAGS)) {
+            &cmsFLAGS
+        )) {
         return NULL;
     }
 
@@ -511,7 +519,8 @@ buildProofTransform(PyObject *self, PyObject *args) {
         sOutMode,
         iRenderingIntent,
         iProofIntent,
-        cmsFLAGS);
+        cmsFLAGS
+    );
 
     if (!transform) {
         return NULL;
@@ -563,7 +572,8 @@ createProfile(PyObject *self, PyObject *args) {
                 PyErr_SetString(
                     PyExc_ValueError,
                     "ERROR: Could not calculate white point from color temperature "
-                    "provided, must be float in degrees Kelvin");
+                    "provided, must be float in degrees Kelvin"
+                );
                 return NULL;
             }
             hProfile = cmsCreateLab2Profile(&whitePoint);
@@ -624,7 +634,8 @@ cms_get_display_profile_win32(PyObject *self, PyObject *args) {
     HANDLE handle = 0;
     int is_dc = 0;
     if (!PyArg_ParseTuple(
-            args, "|" F_HANDLE "i:get_display_profile", &handle, &is_dc)) {
+            args, "|" F_HANDLE "i:get_display_profile", &handle, &is_dc
+        )) {
         return NULL;
     }
 
@@ -729,7 +740,8 @@ _xyz_py(cmsCIEXYZ *XYZ) {
     cmsCIExyY xyY;
     cmsXYZ2xyY(&xyY, XYZ);
     return Py_BuildValue(
-        "((d,d,d),(d,d,d))", XYZ->X, XYZ->Y, XYZ->Z, xyY.x, xyY.y, xyY.Y);
+        "((d,d,d),(d,d,d))", XYZ->X, XYZ->Y, XYZ->Z, xyY.x, xyY.y, xyY.Y
+    );
 }
 
 static PyObject *
@@ -758,7 +770,8 @@ _xyz3_py(cmsCIEXYZ *XYZ) {
         xyY[1].Y,
         xyY[2].x,
         xyY[2].y,
-        xyY[2].Y);
+        xyY[2].Y
+    );
 }
 
 static PyObject *
@@ -809,7 +822,8 @@ _profile_read_ciexyy_triple(CmsProfileObject *self, cmsTagSignature info) {
         triple->Green.Y,
         triple->Blue.x,
         triple->Blue.y,
-        triple->Blue.Y);
+        triple->Blue.Y
+    );
 }
 
 static PyObject *
@@ -873,7 +887,8 @@ _calculate_rgb_primaries(CmsProfileObject *self, cmsCIEXYZTRIPLE *result) {
         hXYZ,
         TYPE_XYZ_DBL,
         INTENT_RELATIVE_COLORIMETRIC,
-        cmsFLAGS_NOCACHE | cmsFLAGS_NOOPTIMIZE);
+        cmsFLAGS_NOCACHE | cmsFLAGS_NOOPTIMIZE
+    );
     cmsCloseProfile(hXYZ);
     if (hTransform == NULL) {
         return 0;
@@ -889,7 +904,8 @@ _check_intent(
     int clut,
     cmsHPROFILE hProfile,
     cmsUInt32Number Intent,
-    cmsUInt32Number UsedDirection) {
+    cmsUInt32Number UsedDirection
+) {
     if (clut) {
         return cmsIsCLUT(hProfile, Intent, UsedDirection);
     } else {
@@ -934,7 +950,8 @@ _is_intent_supported(CmsProfileObject *self, int clut) {
             _check_intent(clut, self->profile, intent, LCMS_USED_AS_OUTPUT) ? Py_True
                                                                             : Py_False,
             _check_intent(clut, self->profile, intent, LCMS_USED_AS_PROOF) ? Py_True
-                                                                           : Py_False);
+                                                                           : Py_False
+        );
         if (id == NULL || entry == NULL) {
             Py_XDECREF(id);
             Py_XDECREF(entry);
@@ -968,7 +985,8 @@ static PyMethodDef pyCMSdll_methods[] = {
     {"get_display_profile_win32", cms_get_display_profile_win32, METH_VARARGS},
 #endif
 
-    {NULL, NULL}};
+    {NULL, NULL}
+};
 
 static struct PyMethodDef cms_profile_methods[] = {
     {"is_intent_supported", (PyCFunction)cms_profile_is_intent_supported, METH_VARARGS},
@@ -1028,7 +1046,8 @@ cms_profile_getattr_creation_date(CmsProfileObject *self, void *closure) {
     }
 
     return PyDateTime_FromDateAndTime(
-        1900 + ct.tm_year, ct.tm_mon, ct.tm_mday, ct.tm_hour, ct.tm_min, ct.tm_sec, 0);
+        1900 + ct.tm_year, ct.tm_mon, ct.tm_mday, ct.tm_hour, ct.tm_min, ct.tm_sec, 0
+    );
 }
 
 static PyObject *
@@ -1106,13 +1125,15 @@ cms_profile_getattr_colorimetric_intent(CmsProfileObject *self, void *closure) {
 
 static PyObject *
 cms_profile_getattr_perceptual_rendering_intent_gamut(
-    CmsProfileObject *self, void *closure) {
+    CmsProfileObject *self, void *closure
+) {
     return _profile_read_signature(self, cmsSigPerceptualRenderingIntentGamutTag);
 }
 
 static PyObject *
 cms_profile_getattr_saturation_rendering_intent_gamut(
-    CmsProfileObject *self, void *closure) {
+    CmsProfileObject *self, void *closure
+) {
     return _profile_read_signature(self, cmsSigSaturationRenderingIntentGamutTag);
 }
 
@@ -1145,7 +1166,8 @@ cms_profile_getattr_blue_colorant(CmsProfileObject *self, void *closure) {
 
 static PyObject *
 cms_profile_getattr_media_white_point_temperature(
-    CmsProfileObject *self, void *closure) {
+    CmsProfileObject *self, void *closure
+) {
     cmsCIEXYZ *XYZ;
     cmsCIExyY xyY;
     cmsFloat64Number tempK;
@@ -1329,7 +1351,8 @@ cms_profile_getattr_icc_measurement_condition(CmsProfileObject *self, void *clos
         "flare",
         mc->Flare,
         "illuminant_type",
-        _illu_map(mc->IlluminantType));
+        _illu_map(mc->IlluminantType)
+    );
 }
 
 static PyObject *
@@ -1359,7 +1382,8 @@ cms_profile_getattr_icc_viewing_condition(CmsProfileObject *self, void *closure)
         vc->SurroundXYZ.Y,
         vc->SurroundXYZ.Z,
         "illuminant_type",
-        _illu_map(vc->IlluminantType));
+        _illu_map(vc->IlluminantType)
+    );
 }
 
 static struct PyGetSetDef cms_profile_getsetters[] = {
@@ -1407,11 +1431,12 @@ static struct PyGetSetDef cms_profile_getsetters[] = {
     {"colorant_table_out", (getter)cms_profile_getattr_colorant_table_out},
     {"intent_supported", (getter)cms_profile_getattr_is_intent_supported},
     {"clut", (getter)cms_profile_getattr_is_clut},
-    {"icc_measurement_condition",
-     (getter)cms_profile_getattr_icc_measurement_condition},
+    {"icc_measurement_condition", (getter)cms_profile_getattr_icc_measurement_condition
+    },
     {"icc_viewing_condition", (getter)cms_profile_getattr_icc_viewing_condition},
 
-    {NULL}};
+    {NULL}
+};
 
 static PyTypeObject CmsProfile_Type = {
     PyVarObject_HEAD_INIT(NULL, 0) "PIL.ImageCms.core.CmsProfile", /*tp_name*/
diff --git a/src/_imagingft.c b/src/_imagingft.c
index c6d20fe4509..da03e3ba915 100644
--- a/src/_imagingft.c
+++ b/src/_imagingft.c
@@ -126,7 +126,8 @@ getfont(PyObject *self_, PyObject *args, PyObject *kw) {
     unsigned char *font_bytes;
     Py_ssize_t font_bytes_size = 0;
     static char *kwlist[] = {
-        "filename", "size", "index", "encoding", "font_bytes", "layout_engine", NULL};
+        "filename", "size", "index", "encoding", "font_bytes", "layout_engine", NULL
+    };
 
     if (!library) {
         PyErr_SetString(PyExc_OSError, "failed to initialize FreeType library");
@@ -148,7 +149,8 @@ getfont(PyObject *self_, PyObject *args, PyObject *kw) {
             &encoding,
             &font_bytes,
             &font_bytes_size,
-            &layout_engine)) {
+            &layout_engine
+        )) {
         PyConfig_Clear(&config);
         return NULL;
     }
@@ -166,7 +168,8 @@ getfont(PyObject *self_, PyObject *args, PyObject *kw) {
             &encoding,
             &font_bytes,
             &font_bytes_size,
-            &layout_engine)) {
+            &layout_engine
+        )) {
         return NULL;
     }
 #endif
@@ -199,7 +202,8 @@ getfont(PyObject *self_, PyObject *args, PyObject *kw) {
                 (FT_Byte *)self->font_bytes,
                 font_bytes_size,
                 index,
-                &self->face);
+                &self->face
+            );
         }
     }
 
@@ -243,7 +247,8 @@ text_layout_raqm(
     const char *dir,
     PyObject *features,
     const char *lang,
-    GlyphInfo **glyph_info) {
+    GlyphInfo **glyph_info
+) {
     size_t i = 0, count = 0, start = 0;
     raqm_t *rq;
     raqm_glyph_t *glyphs = NULL;
@@ -297,13 +302,14 @@ text_layout_raqm(
 #if !defined(RAQM_VERSION_ATLEAST)
             /* RAQM_VERSION_ATLEAST was added in Raqm 0.7.0 */
             PyErr_SetString(
-                PyExc_ValueError,
-                "libraqm 0.7 or greater required for 'ttb' direction");
+                PyExc_ValueError, "libraqm 0.7 or greater required for 'ttb' direction"
+            );
             goto failed;
 #endif
         } else {
             PyErr_SetString(
-                PyExc_ValueError, "direction must be either 'rtl', 'ltr' or 'ttb'");
+                PyExc_ValueError, "direction must be either 'rtl', 'ltr' or 'ttb'"
+            );
             goto failed;
         }
     }
@@ -399,7 +405,8 @@ text_layout_fallback(
     const char *lang,
     GlyphInfo **glyph_info,
     int mask,
-    int color) {
+    int color
+) {
     int error, load_flags, i;
     char *buffer = NULL;
     FT_ULong ch;
@@ -412,7 +419,8 @@ text_layout_fallback(
         PyErr_SetString(
             PyExc_KeyError,
             "setting text direction, language or font features is not supported "
-            "without libraqm");
+            "without libraqm"
+        );
     }
 
     if (PyUnicode_Check(string)) {
@@ -459,7 +467,8 @@ text_layout_fallback(
                     last_index,
                     (*glyph_info)[i].index,
                     ft_kerning_default,
-                    &delta) == 0) {
+                    &delta
+                ) == 0) {
                 (*glyph_info)[i - 1].x_advance += PIXEL(delta.x);
                 (*glyph_info)[i - 1].y_advance += PIXEL(delta.y);
             }
@@ -483,7 +492,8 @@ text_layout(
     const char *lang,
     GlyphInfo **glyph_info,
     int mask,
-    int color) {
+    int color
+) {
     size_t count;
 #ifdef HAVE_RAQM
     if (have_raqm && self->layout_engine == LAYOUT_RAQM) {
@@ -492,7 +502,8 @@ text_layout(
 #endif
     {
         count = text_layout_fallback(
-            string, self, dir, features, lang, glyph_info, mask, color);
+            string, self, dir, features, lang, glyph_info, mask, color
+        );
     }
     return count;
 }
@@ -514,7 +525,8 @@ font_getlength(FontObject *self, PyObject *args) {
     /* calculate size and bearing for a given string */
 
     if (!PyArg_ParseTuple(
-            args, "O|zzOz:getlength", &string, &mode, &dir, &features, &lang)) {
+            args, "O|zzOz:getlength", &string, &mode, &dir, &features, &lang
+        )) {
         return NULL;
     }
 
@@ -556,7 +568,8 @@ bounding_box_and_anchors(
     int *width,
     int *height,
     int *x_offset,
-    int *y_offset) {
+    int *y_offset
+) {
     int position; /* pen position along primary axis, in 26.6 precision */
     int advanced; /* pen position along primary axis, in pixels */
     int px, py;   /* position of current glyph, in pixels */
@@ -661,7 +674,8 @@ bounding_box_and_anchors(
                 case 'm':  // middle (ascender + descender) / 2
                     y_anchor = PIXEL(
                         (face->size->metrics.ascender + face->size->metrics.descender) /
-                        2);
+                        2
+                    );
                     break;
                 case 's':  // horizontal baseline
                     y_anchor = 0;
@@ -741,7 +755,8 @@ font_getsize(FontObject *self, PyObject *args) {
     /* calculate size and bearing for a given string */
 
     if (!PyArg_ParseTuple(
-            args, "O|zzOzz:getsize", &string, &mode, &dir, &features, &lang, &anchor)) {
+            args, "O|zzOzz:getsize", &string, &mode, &dir, &features, &lang, &anchor
+        )) {
         return NULL;
     }
 
@@ -773,7 +788,8 @@ font_getsize(FontObject *self, PyObject *args) {
         &width,
         &height,
         &x_offset,
-        &y_offset);
+        &y_offset
+    );
     if (glyph_info) {
         PyMem_Free(glyph_info);
         glyph_info = NULL;
@@ -842,7 +858,8 @@ font_render(FontObject *self, PyObject *args) {
             &anchor,
             &foreground_ink_long,
             &x_start,
-            &y_start)) {
+            &y_start
+        )) {
         return NULL;
     }
 
@@ -889,7 +906,8 @@ font_render(FontObject *self, PyObject *args) {
         &width,
         &height,
         &x_offset,
-        &y_offset);
+        &y_offset
+    );
     if (error) {
         PyMem_Del(glyph_info);
         return NULL;
@@ -929,7 +947,8 @@ font_render(FontObject *self, PyObject *args) {
             (FT_Fixed)stroke_width * 64,
             FT_STROKER_LINECAP_ROUND,
             FT_STROKER_LINEJOIN_ROUND,
-            0);
+            0
+        );
     }
 
     /*
@@ -1104,8 +1123,8 @@ font_render(FontObject *self, PyObject *args) {
                                     BLEND(src_alpha, target[k * 4 + 2], src_blue, tmp);
                                 target[k * 4 + 3] = CLIP8(
                                     src_alpha +
-                                    MULDIV255(
-                                        target[k * 4 + 3], (255 - src_alpha), tmp));
+                                    MULDIV255(target[k * 4 + 3], (255 - src_alpha), tmp)
+                                );
                             } else {
                                 /* paste unpremultiplied RGBA values */
                                 target[k * 4 + 0] = src_red;
@@ -1123,15 +1142,20 @@ font_render(FontObject *self, PyObject *args) {
                             if (src_alpha > 0) {
                                 if (target[k * 4 + 3] > 0) {
                                     target[k * 4 + 0] = BLEND(
-                                        src_alpha, target[k * 4 + 0], ink[0], tmp);
+                                        src_alpha, target[k * 4 + 0], ink[0], tmp
+                                    );
                                     target[k * 4 + 1] = BLEND(
-                                        src_alpha, target[k * 4 + 1], ink[1], tmp);
+                                        src_alpha, target[k * 4 + 1], ink[1], tmp
+                                    );
                                     target[k * 4 + 2] = BLEND(
-                                        src_alpha, target[k * 4 + 2], ink[2], tmp);
+                                        src_alpha, target[k * 4 + 2], ink[2], tmp
+                                    );
                                     target[k * 4 + 3] = CLIP8(
                                         src_alpha +
                                         MULDIV255(
-                                            target[k * 4 + 3], (255 - src_alpha), tmp));
+                                            target[k * 4 + 3], (255 - src_alpha), tmp
+                                        )
+                                    );
                                 } else {
                                     target[k * 4 + 0] = ink[0];
                                     target[k * 4 + 1] = ink[1];
@@ -1149,7 +1173,9 @@ font_render(FontObject *self, PyObject *args) {
                                         ? CLIP8(
                                               src_alpha +
                                               MULDIV255(
-                                                  target[k], (255 - src_alpha), tmp))
+                                                  target[k], (255 - src_alpha), tmp
+                                              )
+                                          )
                                         : src_alpha;
                             }
                         }
@@ -1425,7 +1451,8 @@ static PyMethodDef font_methods[] = {
     {"setvarname", (PyCFunction)font_setvarname, METH_VARARGS},
     {"setvaraxes", (PyCFunction)font_setvaraxes, METH_VARARGS},
 #endif
-    {NULL, NULL}};
+    {NULL, NULL}
+};
 
 static PyObject *
 font_getattr_family(FontObject *self, void *closure) {
@@ -1482,7 +1509,8 @@ static struct PyGetSetDef font_getsetters[] = {
     {"x_ppem", (getter)font_getattr_x_ppem},
     {"y_ppem", (getter)font_getattr_y_ppem},
     {"glyphs", (getter)font_getattr_glyphs},
-    {NULL}};
+    {NULL}
+};
 
 static PyTypeObject Font_Type = {
     PyVarObject_HEAD_INIT(NULL, 0) "Font", /*tp_name*/
@@ -1518,7 +1546,8 @@ static PyTypeObject Font_Type = {
 };
 
 static PyMethodDef _functions[] = {
-    {"getfont", (PyCFunction)getfont, METH_VARARGS | METH_KEYWORDS}, {NULL, NULL}};
+    {"getfont", (PyCFunction)getfont, METH_VARARGS | METH_KEYWORDS}, {NULL, NULL}
+};
 
 static int
 setup_module(PyObject *m) {
diff --git a/src/_imagingmath.c b/src/_imagingmath.c
index a2ddc91b9b3..550a1090382 100644
--- a/src/_imagingmath.c
+++ b/src/_imagingmath.c
@@ -209,7 +209,8 @@ _binop(PyObject *self, PyObject *args) {
 }
 
 static PyMethodDef _functions[] = {
-    {"unop", _unop, 1}, {"binop", _binop, 1}, {NULL, NULL}};
+    {"unop", _unop, 1}, {"binop", _binop, 1}, {NULL, NULL}
+};
 
 static void
 install(PyObject *d, char *name, void *value) {
diff --git a/src/_imagingmorph.c b/src/_imagingmorph.c
index a95ce75bf60..614dfbe7fe7 100644
--- a/src/_imagingmorph.c
+++ b/src/_imagingmorph.c
@@ -253,7 +253,8 @@ static PyMethodDef functions[] = {
     {"apply", (PyCFunction)apply, METH_VARARGS, NULL},
     {"get_on_pixels", (PyCFunction)get_on_pixels, METH_VARARGS, NULL},
     {"match", (PyCFunction)match, METH_VARARGS, NULL},
-    {NULL, NULL, 0, NULL}};
+    {NULL, NULL, 0, NULL}
+};
 
 PyMODINIT_FUNC
 PyInit__imagingmorph(void) {
diff --git a/src/_webp.c b/src/_webp.c
index dfa24da4139..e686ec820fd 100644
--- a/src/_webp.c
+++ b/src/_webp.c
@@ -42,7 +42,8 @@ static const char *const kErrorMessages[-WEBP_MUX_NOT_ENOUGH_DATA + 1] = {
     "WEBP_MUX_INVALID_ARGUMENT",
     "WEBP_MUX_BAD_DATA",
     "WEBP_MUX_MEMORY_ERROR",
-    "WEBP_MUX_NOT_ENOUGH_DATA"};
+    "WEBP_MUX_NOT_ENOUGH_DATA"
+};
 
 PyObject *
 HandleMuxError(WebPMuxError err, char *chunk) {
@@ -61,7 +62,8 @@ HandleMuxError(WebPMuxError err, char *chunk) {
             sprintf(message, "could not assemble chunks: %s", kErrorMessages[-err]);
     } else {
         message_len = sprintf(
-            message, "could not set %.4s chunk: %s", chunk, kErrorMessages[-err]);
+            message, "could not set %.4s chunk: %s", chunk, kErrorMessages[-err]
+        );
     }
     if (message_len < 0) {
         PyErr_SetString(PyExc_RuntimeError, "failed to construct error message");
@@ -138,7 +140,8 @@ _anim_encoder_new(PyObject *self, PyObject *args) {
             &kmin,
             &kmax,
             &allow_mixed,
-            &verbose)) {
+            &verbose
+        )) {
         return NULL;
     }
 
@@ -214,7 +217,8 @@ _anim_encoder_add(PyObject *self, PyObject *args) {
             &lossless,
             &quality_factor,
             &alpha_quality_factor,
-            &method)) {
+            &method
+        )) {
         return NULL;
     }
 
@@ -283,7 +287,8 @@ _anim_encoder_assemble(PyObject *self, PyObject *args) {
             &exif_bytes,
             &exif_size,
             &xmp_bytes,
-            &xmp_size)) {
+            &xmp_size
+        )) {
         return NULL;
     }
 
@@ -421,7 +426,8 @@ _anim_decoder_get_info(PyObject *self) {
         info->loop_count,
         info->bgcolor,
         info->frame_count,
-        decp->mode);
+        decp->mode
+    );
 }
 
 PyObject *
@@ -466,7 +472,8 @@ _anim_decoder_get_next(PyObject *self) {
     }
 
     bytes = PyBytes_FromStringAndSize(
-        (char *)buf, decp->info.canvas_width * 4 * decp->info.canvas_height);
+        (char *)buf, decp->info.canvas_width * 4 * decp->info.canvas_height
+    );
 
     ret = Py_BuildValue("Si", bytes, timestamp);
 
@@ -621,7 +628,8 @@ WebPEncode_wrapper(PyObject *self, PyObject *args) {
             &exif_bytes,
             &exif_size,
             &xmp_bytes,
-            &xmp_size)) {
+            &xmp_size
+        )) {
         return NULL;
     }
 
@@ -828,12 +836,14 @@ WebPDecode_wrapper(PyObject *self, PyObject *args) {
 
             if (WEBP_MUX_OK == WebPMuxGetChunk(mux, "ICCP", &icc_profile_data)) {
                 icc_profile = PyBytes_FromStringAndSize(
-                    (const char *)icc_profile_data.bytes, icc_profile_data.size);
+                    (const char *)icc_profile_data.bytes, icc_profile_data.size
+                );
             }
 
             if (WEBP_MUX_OK == WebPMuxGetChunk(mux, "EXIF", &exif_data)) {
                 exif = PyBytes_FromStringAndSize(
-                    (const char *)exif_data.bytes, exif_data.size);
+                    (const char *)exif_data.bytes, exif_data.size
+                );
             }
 
             WebPDataClear(&image.bitstream);
@@ -848,12 +858,14 @@ WebPDecode_wrapper(PyObject *self, PyObject *args) {
 
     if (config.output.colorspace < MODE_YUV) {
         bytes = PyBytes_FromStringAndSize(
-            (char *)config.output.u.RGBA.rgba, config.output.u.RGBA.size);
+            (char *)config.output.u.RGBA.rgba, config.output.u.RGBA.size
+        );
     } else {
         // Skipping YUV for now. Need Test Images.
         // UNDONE -- unclear if we'll ever get here if we set mode_rgb*
         bytes = PyBytes_FromStringAndSize(
-            (char *)config.output.u.YUVA.y, config.output.u.YUVA.y_size);
+            (char *)config.output.u.YUVA.y, config.output.u.YUVA.y_size
+        );
     }
 
     pymode = PyUnicode_FromString(mode);
@@ -864,7 +876,8 @@ WebPDecode_wrapper(PyObject *self, PyObject *args) {
         config.output.height,
         pymode,
         NULL == icc_profile ? Py_None : icc_profile,
-        NULL == exif ? Py_None : exif);
+        NULL == exif ? Py_None : exif
+    );
 
 end:
     WebPFreeDecBuffer(&config.output);
@@ -898,7 +911,8 @@ WebPDecoderVersion_str(void) {
         "%d.%d.%d",
         version_number >> 16,
         (version_number >> 8) % 0x100,
-        version_number % 0x100);
+        version_number % 0x100
+    );
     return version;
 }
 
@@ -932,7 +946,8 @@ static PyMethodDef webpMethods[] = {
      WebPDecoderBuggyAlpha_wrapper,
      METH_NOARGS,
      "WebPDecoderBuggyAlpha"},
-    {NULL, NULL}};
+    {NULL, NULL}
+};
 
 void
 addMuxFlagToModule(PyObject *m) {
diff --git a/src/decode.c b/src/decode.c
index ea2f3af8012..51d0aced2bd 100644
--- a/src/decode.c
+++ b/src/decode.c
@@ -46,7 +46,8 @@
 
 typedef struct {
     PyObject_HEAD int (*decode)(
-        Imaging im, ImagingCodecState state, UINT8 *buffer, Py_ssize_t bytes);
+        Imaging im, ImagingCodecState state, UINT8 *buffer, Py_ssize_t bytes
+    );
     int (*cleanup)(ImagingCodecState state);
     struct ImagingCodecStateInstance state;
     Imaging im;
@@ -889,7 +890,8 @@ PyImaging_Jpeg2KDecoderNew(PyObject *self, PyObject *args) {
     PY_LONG_LONG length = -1;
 
     if (!PyArg_ParseTuple(
-            args, "ss|iiiL", &mode, &format, &reduce, &layers, &fd, &length)) {
+            args, "ss|iiiL", &mode, &format, &reduce, &layers, &fd, &length
+        )) {
         return NULL;
     }
 
diff --git a/src/display.c b/src/display.c
index 990f4b0a5c9..b4e2e38991a 100644
--- a/src/display.c
+++ b/src/display.c
@@ -105,7 +105,8 @@ _draw(ImagingDisplayObject *display, PyObject *args) {
             src + 0,
             src + 1,
             src + 2,
-            src + 3)) {
+            src + 3
+        )) {
         return NULL;
     }
 
@@ -221,7 +222,8 @@ _tobytes(ImagingDisplayObject *display, PyObject *args) {
     }
 
     return PyBytes_FromStringAndSize(
-        display->dib->bits, display->dib->ysize * display->dib->linesize);
+        display->dib->bits, display->dib->ysize * display->dib->linesize
+    );
 }
 
 static struct PyMethodDef methods[] = {
@@ -247,7 +249,8 @@ _getattr_size(ImagingDisplayObject *self, void *closure) {
 }
 
 static struct PyGetSetDef getsetters[] = {
-    {"mode", (getter)_getattr_mode}, {"size", (getter)_getattr_size}, {NULL}};
+    {"mode", (getter)_getattr_mode}, {"size", (getter)_getattr_size}, {NULL}
+};
 
 static PyTypeObject ImagingDisplayType = {
     PyVarObject_HEAD_INIT(NULL, 0) "ImagingDisplay", /*tp_name*/
@@ -341,9 +344,8 @@ PyImaging_GrabScreenWin32(PyObject *self, PyObject *args) {
     // added in Windows 10 (1607)
     // loaded dynamically to avoid link errors
     user32 = LoadLibraryA("User32.dll");
-    SetThreadDpiAwarenessContext_function =
-        (Func_SetThreadDpiAwarenessContext)GetProcAddress(
-            user32, "SetThreadDpiAwarenessContext");
+    SetThreadDpiAwarenessContext_function = (Func_SetThreadDpiAwarenessContext
+    )GetProcAddress(user32, "SetThreadDpiAwarenessContext");
     if (SetThreadDpiAwarenessContext_function != NULL) {
         // DPI_AWARENESS_CONTEXT_PER_MONITOR_AWARE = ((DPI_CONTEXT_HANDLE)-3)
         dpiAwareness = SetThreadDpiAwarenessContext_function((HANDLE)-3);
@@ -403,7 +405,8 @@ PyImaging_GrabScreenWin32(PyObject *self, PyObject *args) {
             height,
             PyBytes_AS_STRING(buffer),
             (BITMAPINFO *)&core,
-            DIB_RGB_COLORS)) {
+            DIB_RGB_COLORS
+        )) {
         goto error;
     }
 
@@ -547,7 +550,8 @@ windowCallback(HWND wnd, UINT message, WPARAM wParam, LPARAM lParam) {
                 ps.rcPaint.left,
                 ps.rcPaint.top,
                 ps.rcPaint.right,
-                ps.rcPaint.bottom);
+                ps.rcPaint.bottom
+            );
             if (result) {
                 Py_DECREF(result);
             } else {
@@ -562,7 +566,8 @@ windowCallback(HWND wnd, UINT message, WPARAM wParam, LPARAM lParam) {
                 0,
                 0,
                 rect.right - rect.left,
-                rect.bottom - rect.top);
+                rect.bottom - rect.top
+            );
             if (result) {
                 Py_DECREF(result);
             } else {
@@ -577,7 +582,8 @@ windowCallback(HWND wnd, UINT message, WPARAM wParam, LPARAM lParam) {
                 0,
                 0,
                 rect.right - rect.left,
-                rect.bottom - rect.top);
+                rect.bottom - rect.top
+            );
             if (result) {
                 Py_DECREF(result);
             } else {
@@ -591,7 +597,8 @@ windowCallback(HWND wnd, UINT message, WPARAM wParam, LPARAM lParam) {
         case WM_SIZE:
             /* resize window */
             result = PyObject_CallFunction(
-                callback, "sii", "resize", LOWORD(lParam), HIWORD(lParam));
+                callback, "sii", "resize", LOWORD(lParam), HIWORD(lParam)
+            );
             if (result) {
                 InvalidateRect(wnd, NULL, 1);
                 Py_DECREF(result);
@@ -670,7 +677,8 @@ PyImaging_CreateWindowWin32(PyObject *self, PyObject *args) {
         HWND_DESKTOP,
         NULL,
         NULL,
-        NULL);
+        NULL
+    );
 
     if (!wnd) {
         PyErr_SetString(PyExc_OSError, "failed to create window");
@@ -732,7 +740,8 @@ PyImaging_DrawWmf(PyObject *self, PyObject *args) {
             &x0,
             &x1,
             &y0,
-            &y1)) {
+            &y1
+        )) {
         return NULL;
     }
 
@@ -844,7 +853,8 @@ PyImaging_GrabScreenX11(PyObject *self, PyObject *args) {
         PyErr_Format(
             PyExc_OSError,
             "X connection failed: error %i",
-            xcb_connection_has_error(connection));
+            xcb_connection_has_error(connection)
+        );
         xcb_disconnect(connection);
         return NULL;
     }
@@ -878,8 +888,10 @@ PyImaging_GrabScreenX11(PyObject *self, PyObject *args) {
             0,
             width,
             height,
-            0x00ffffff),
-        &error);
+            0x00ffffff
+        ),
+        &error
+    );
     if (reply == NULL) {
         PyErr_Format(
             PyExc_OSError,
@@ -887,7 +899,8 @@ PyImaging_GrabScreenX11(PyObject *self, PyObject *args) {
             error->error_code,
             error->major_code,
             error->minor_code,
-            error->resource_id);
+            error->resource_id
+        );
         free(error);
         xcb_disconnect(connection);
         return NULL;
@@ -897,7 +910,8 @@ PyImaging_GrabScreenX11(PyObject *self, PyObject *args) {
 
     if (reply->depth == 24) {
         buffer = PyBytes_FromStringAndSize(
-            (char *)xcb_get_image_data(reply), xcb_get_image_data_length(reply));
+            (char *)xcb_get_image_data(reply), xcb_get_image_data_length(reply)
+        );
     } else {
         PyErr_Format(PyExc_OSError, "unsupported bit depth: %i", reply->depth);
     }
diff --git a/src/encode.c b/src/encode.c
index 2c95b7ebcee..f711865d5a0 100644
--- a/src/encode.c
+++ b/src/encode.c
@@ -39,7 +39,8 @@
 
 typedef struct {
     PyObject_HEAD int (*encode)(
-        Imaging im, ImagingCodecState state, UINT8 *buffer, int bytes);
+        Imaging im, ImagingCodecState state, UINT8 *buffer, int bytes
+    );
     int (*cleanup)(ImagingCodecState state);
     struct ImagingCodecStateInstance state;
     Imaging im;
@@ -135,7 +136,8 @@ _encode(ImagingEncoderObject *encoder, PyObject *args) {
     }
 
     status = encoder->encode(
-        encoder->im, &encoder->state, (UINT8 *)PyBytes_AsString(buf), bufsize);
+        encoder->im, &encoder->state, (UINT8 *)PyBytes_AsString(buf), bufsize
+    );
 
     /* adjust string length to avoid slicing in encoder */
     if (_PyBytes_Resize(&buf, (status > 0) ? status : 0) < 0) {
@@ -572,7 +574,8 @@ PyImaging_ZipEncoderNew(PyObject *self, PyObject *args) {
             &compress_level,
             &compress_type,
             &dictionary,
-            &dictionary_size)) {
+            &dictionary_size
+        )) {
         return NULL;
     }
 
@@ -653,15 +656,8 @@ PyImaging_LibTiffEncoderNew(PyObject *self, PyObject *args) {
     PyObject *item;
 
     if (!PyArg_ParseTuple(
-            args,
-            "sssnsOO",
-            &mode,
-            &rawmode,
-            &compname,
-            &fp,
-            &filename,
-            &tags,
-            &types)) {
+            args, "sssnsOO", &mode, &rawmode, &compname, &fp, &filename, &tags, &types
+        )) {
         return NULL;
     }
 
@@ -785,7 +781,8 @@ PyImaging_LibTiffEncoderNew(PyObject *self, PyObject *args) {
                 is_var_length = 1;
             }
             if (ImagingLibTiffMergeFieldInfo(
-                    &encoder->state, type, key_int, is_var_length)) {
+                    &encoder->state, type, key_int, is_var_length
+                )) {
                 continue;
             }
         }
@@ -795,7 +792,8 @@ PyImaging_LibTiffEncoderNew(PyObject *self, PyObject *args) {
                 &encoder->state,
                 (ttag_t)key_int,
                 PyBytes_Size(value),
-                PyBytes_AsString(value));
+                PyBytes_AsString(value)
+            );
         } else if (is_var_length) {
             Py_ssize_t len, i;
             TRACE(("Setting from Tuple: %d \n", key_int));
@@ -805,7 +803,8 @@ PyImaging_LibTiffEncoderNew(PyObject *self, PyObject *args) {
                 int stride = 256;
                 if (len != 768) {
                     PyErr_SetString(
-                        PyExc_ValueError, "Requiring 768 items for Colormap");
+                        PyExc_ValueError, "Requiring 768 items for Colormap"
+                    );
                     return NULL;
                 }
                 UINT16 *av;
@@ -820,7 +819,8 @@ PyImaging_LibTiffEncoderNew(PyObject *self, PyObject *args) {
                         (ttag_t)key_int,
                         av,
                         av + stride,
-                        av + stride * 2);
+                        av + stride * 2
+                    );
                     free(av);
                 }
             } else if (key_int == TIFFTAG_YCBCRSUBSAMPLING) {
@@ -828,7 +828,8 @@ PyImaging_LibTiffEncoderNew(PyObject *self, PyObject *args) {
                     &encoder->state,
                     (ttag_t)key_int,
                     (UINT16)PyLong_AsLong(PyTuple_GetItem(value, 0)),
-                    (UINT16)PyLong_AsLong(PyTuple_GetItem(value, 1)));
+                    (UINT16)PyLong_AsLong(PyTuple_GetItem(value, 1))
+                );
             } else if (type == TIFF_SHORT) {
                 UINT16 *av;
                 /* malloc check ok, calloc checks for overflow */
@@ -838,7 +839,8 @@ PyImaging_LibTiffEncoderNew(PyObject *self, PyObject *args) {
                         av[i] = (UINT16)PyLong_AsLong(PyTuple_GetItem(value, i));
                     }
                     status = ImagingLibTiffSetField(
-                        &encoder->state, (ttag_t)key_int, len, av);
+                        &encoder->state, (ttag_t)key_int, len, av
+                    );
                     free(av);
                 }
             } else if (type == TIFF_LONG) {
@@ -850,7 +852,8 @@ PyImaging_LibTiffEncoderNew(PyObject *self, PyObject *args) {
                         av[i] = (UINT32)PyLong_AsLong(PyTuple_GetItem(value, i));
                     }
                     status = ImagingLibTiffSetField(
-                        &encoder->state, (ttag_t)key_int, len, av);
+                        &encoder->state, (ttag_t)key_int, len, av
+                    );
                     free(av);
                 }
             } else if (type == TIFF_SBYTE) {
@@ -862,7 +865,8 @@ PyImaging_LibTiffEncoderNew(PyObject *self, PyObject *args) {
                         av[i] = (INT8)PyLong_AsLong(PyTuple_GetItem(value, i));
                     }
                     status = ImagingLibTiffSetField(
-                        &encoder->state, (ttag_t)key_int, len, av);
+                        &encoder->state, (ttag_t)key_int, len, av
+                    );
                     free(av);
                 }
             } else if (type == TIFF_SSHORT) {
@@ -874,7 +878,8 @@ PyImaging_LibTiffEncoderNew(PyObject *self, PyObject *args) {
                         av[i] = (INT16)PyLong_AsLong(PyTuple_GetItem(value, i));
                     }
                     status = ImagingLibTiffSetField(
-                        &encoder->state, (ttag_t)key_int, len, av);
+                        &encoder->state, (ttag_t)key_int, len, av
+                    );
                     free(av);
                 }
             } else if (type == TIFF_SLONG) {
@@ -886,7 +891,8 @@ PyImaging_LibTiffEncoderNew(PyObject *self, PyObject *args) {
                         av[i] = (INT32)PyLong_AsLong(PyTuple_GetItem(value, i));
                     }
                     status = ImagingLibTiffSetField(
-                        &encoder->state, (ttag_t)key_int, len, av);
+                        &encoder->state, (ttag_t)key_int, len, av
+                    );
                     free(av);
                 }
             } else if (type == TIFF_FLOAT) {
@@ -898,7 +904,8 @@ PyImaging_LibTiffEncoderNew(PyObject *self, PyObject *args) {
                         av[i] = (FLOAT32)PyFloat_AsDouble(PyTuple_GetItem(value, i));
                     }
                     status = ImagingLibTiffSetField(
-                        &encoder->state, (ttag_t)key_int, len, av);
+                        &encoder->state, (ttag_t)key_int, len, av
+                    );
                     free(av);
                 }
             } else if (type == TIFF_DOUBLE) {
@@ -910,43 +917,54 @@ PyImaging_LibTiffEncoderNew(PyObject *self, PyObject *args) {
                         av[i] = PyFloat_AsDouble(PyTuple_GetItem(value, i));
                     }
                     status = ImagingLibTiffSetField(
-                        &encoder->state, (ttag_t)key_int, len, av);
+                        &encoder->state, (ttag_t)key_int, len, av
+                    );
                     free(av);
                 }
             }
         } else {
             if (type == TIFF_SHORT) {
                 status = ImagingLibTiffSetField(
-                    &encoder->state, (ttag_t)key_int, (UINT16)PyLong_AsLong(value));
+                    &encoder->state, (ttag_t)key_int, (UINT16)PyLong_AsLong(value)
+                );
             } else if (type == TIFF_LONG) {
                 status = ImagingLibTiffSetField(
-                    &encoder->state, (ttag_t)key_int, PyLong_AsLongLong(value));
+                    &encoder->state, (ttag_t)key_int, PyLong_AsLongLong(value)
+                );
             } else if (type == TIFF_SSHORT) {
                 status = ImagingLibTiffSetField(
-                    &encoder->state, (ttag_t)key_int, (INT16)PyLong_AsLong(value));
+                    &encoder->state, (ttag_t)key_int, (INT16)PyLong_AsLong(value)
+                );
             } else if (type == TIFF_SLONG) {
                 status = ImagingLibTiffSetField(
-                    &encoder->state, (ttag_t)key_int, (INT32)PyLong_AsLong(value));
+                    &encoder->state, (ttag_t)key_int, (INT32)PyLong_AsLong(value)
+                );
             } else if (type == TIFF_FLOAT) {
                 status = ImagingLibTiffSetField(
-                    &encoder->state, (ttag_t)key_int, (FLOAT32)PyFloat_AsDouble(value));
+                    &encoder->state, (ttag_t)key_int, (FLOAT32)PyFloat_AsDouble(value)
+                );
             } else if (type == TIFF_DOUBLE) {
                 status = ImagingLibTiffSetField(
-                    &encoder->state, (ttag_t)key_int, (FLOAT64)PyFloat_AsDouble(value));
+                    &encoder->state, (ttag_t)key_int, (FLOAT64)PyFloat_AsDouble(value)
+                );
             } else if (type == TIFF_SBYTE) {
                 status = ImagingLibTiffSetField(
-                    &encoder->state, (ttag_t)key_int, (INT8)PyLong_AsLong(value));
+                    &encoder->state, (ttag_t)key_int, (INT8)PyLong_AsLong(value)
+                );
             } else if (type == TIFF_ASCII) {
                 status = ImagingLibTiffSetField(
-                    &encoder->state, (ttag_t)key_int, PyBytes_AsString(value));
+                    &encoder->state, (ttag_t)key_int, PyBytes_AsString(value)
+                );
             } else if (type == TIFF_RATIONAL) {
                 status = ImagingLibTiffSetField(
-                    &encoder->state, (ttag_t)key_int, (FLOAT64)PyFloat_AsDouble(value));
+                    &encoder->state, (ttag_t)key_int, (FLOAT64)PyFloat_AsDouble(value)
+                );
             } else {
                 TRACE(
                     ("Unhandled type for key %d : %s \n",
                      key_int,
-                     PyBytes_AsString(PyObject_Str(value))));
+                     PyBytes_AsString(PyObject_Str(value)))
+                );
             }
         }
         if (!status) {
@@ -1007,7 +1025,8 @@ get_qtables_arrays(PyObject *qtables, int *qtablesLen) {
     if (num_tables < 1 || num_tables > NUM_QUANT_TBLS) {
         PyErr_SetString(
             PyExc_ValueError,
-            "Not a valid number of quantization tables. Should be between 1 and 4.");
+            "Not a valid number of quantization tables. Should be between 1 and 4."
+        );
         Py_DECREF(tables);
         return NULL;
     }
@@ -1096,7 +1115,8 @@ PyImaging_JpegEncoderNew(PyObject *self, PyObject *args) {
             &extra,
             &extra_size,
             &rawExif,
-            &rawExifLen)) {
+            &rawExifLen
+        )) {
         return NULL;
     }
 
@@ -1266,7 +1286,8 @@ PyImaging_Jpeg2KEncoderNew(PyObject *self, PyObject *args) {
             &fd,
             &comment,
             &comment_size,
-            &plt)) {
+            &plt
+        )) {
         return NULL;
     }
 
@@ -1323,7 +1344,8 @@ PyImaging_Jpeg2KEncoderNew(PyObject *self, PyObject *args) {
 
     j2k_decode_coord_tuple(offset, &context->offset_x, &context->offset_y);
     j2k_decode_coord_tuple(
-        tile_offset, &context->tile_offset_x, &context->tile_offset_y);
+        tile_offset, &context->tile_offset_x, &context->tile_offset_y
+    );
     j2k_decode_coord_tuple(tile_size, &context->tile_size_x, &context->tile_size_y);
 
     /* Error on illegal tile offsets */
@@ -1333,7 +1355,8 @@ PyImaging_Jpeg2KEncoderNew(PyObject *self, PyObject *args) {
             PyErr_SetString(
                 PyExc_ValueError,
                 "JPEG 2000 tile offset too small; top left tile must "
-                "intersect image area");
+                "intersect image area"
+            );
             Py_DECREF(encoder);
             return NULL;
         }
@@ -1341,8 +1364,8 @@ PyImaging_Jpeg2KEncoderNew(PyObject *self, PyObject *args) {
         if (context->tile_offset_x > context->offset_x ||
             context->tile_offset_y > context->offset_y) {
             PyErr_SetString(
-                PyExc_ValueError,
-                "JPEG 2000 tile offset too large to cover image area");
+                PyExc_ValueError, "JPEG 2000 tile offset too large to cover image area"
+            );
             Py_DECREF(encoder);
             return NULL;
         }
@@ -1376,7 +1399,8 @@ PyImaging_Jpeg2KEncoderNew(PyObject *self, PyObject *args) {
 
     j2k_decode_coord_tuple(cblk_size, &context->cblk_width, &context->cblk_height);
     j2k_decode_coord_tuple(
-        precinct_size, &context->precinct_width, &context->precinct_height);
+        precinct_size, &context->precinct_width, &context->precinct_height
+    );
 
     context->irreversible = PyObject_IsTrue(irreversible);
     context->progression = prog_order;
diff --git a/src/libImaging/Access.c b/src/libImaging/Access.c
index 3a5e918e837..bf7db281ec6 100644
--- a/src/libImaging/Access.c
+++ b/src/libImaging/Access.c
@@ -36,7 +36,8 @@ add_item(const char *mode) {
             "AccessInit: hash collision: %d for both %s and %s\n",
             i,
             mode,
-            access_table[i].mode);
+            access_table[i].mode
+        );
         exit(1);
     }
     access_table[i].mode = mode;
diff --git a/src/libImaging/BcnDecode.c b/src/libImaging/BcnDecode.c
index 72f478d8d60..9a41febc764 100644
--- a/src/libImaging/BcnDecode.c
+++ b/src/libImaging/BcnDecode.c
@@ -243,7 +243,8 @@ static const bc7_mode_info bc7_modes[] = {
     {1, 0, 2, 1, 5, 6, 0, 0, 2, 3},
     {1, 0, 2, 0, 7, 8, 0, 0, 2, 2},
     {1, 0, 0, 0, 7, 7, 1, 0, 4, 0},
-    {2, 6, 0, 0, 5, 5, 1, 0, 2, 0}};
+    {2, 6, 0, 0, 5, 5, 1, 0, 2, 0}
+};
 
 /* Subset indices:
    Table.P2, 1 bit per index */
@@ -254,7 +255,8 @@ static const UINT16 bc7_si2[] = {
     0x718e, 0x399c, 0xaaaa, 0xf0f0, 0x5a5a, 0x33cc, 0x3c3c, 0x55aa, 0x9696, 0xa55a,
     0x73ce, 0x13c8, 0x324c, 0x3bdc, 0x6996, 0xc33c, 0x9966, 0x0660, 0x0272, 0x04e4,
     0x4e40, 0x2720, 0xc936, 0x936c, 0x39c6, 0x639c, 0x9336, 0x9cc6, 0x817e, 0xe718,
-    0xccf0, 0x0fcc, 0x7744, 0xee22};
+    0xccf0, 0x0fcc, 0x7744, 0xee22
+};
 
 /* Table.P3, 2 bits per index */
 static const UINT32 bc7_si3[] = {
@@ -267,20 +269,23 @@ static const UINT32 bc7_si3[] = {
     0x66660000, 0xa5a0a5a0, 0x50a050a0, 0x69286928, 0x44aaaa44, 0x66666600, 0xaa444444,
     0x54a854a8, 0x95809580, 0x96969600, 0xa85454a8, 0x80959580, 0xaa141414, 0x96960000,
     0xaaaa1414, 0xa05050a0, 0xa0a5a5a0, 0x96000000, 0x40804080, 0xa9a8a9a8, 0xaaaaaa44,
-    0x2a4a5254};
+    0x2a4a5254
+};
 
 /* Anchor indices:
    Table.A2 */
-static const char bc7_ai0[] = {
-    15, 15, 15, 15, 15, 15, 15, 15, 15, 15, 15, 15, 15, 15, 15, 15, 15, 2,  8, 2, 2, 8,
-    8,  15, 2,  8,  2,  2,  8,  8,  2,  2,  15, 15, 6,  8,  2,  8,  15, 15, 2, 8, 2, 2,
-    2,  15, 15, 6,  6,  2,  6,  8,  15, 15, 2,  2,  15, 15, 15, 15, 15, 2,  2, 15};
+static const char bc7_ai0[] = {15, 15, 15, 15, 15, 15, 15, 15, 15, 15, 15, 15, 15,
+                               15, 15, 15, 15, 2,  8,  2,  2,  8,  8,  15, 2,  8,
+                               2,  2,  8,  8,  2,  2,  15, 15, 6,  8,  2,  8,  15,
+                               15, 2,  8,  2,  2,  2,  15, 15, 6,  6,  2,  6,  8,
+                               15, 15, 2,  2,  15, 15, 15, 15, 15, 2,  2,  15};
 
 /* Table.A3a */
-static const char bc7_ai1[] = {
-    3,  3,  15, 15, 8, 3,  15, 15, 8,  8,  6, 6,  6, 5,  3, 3,  3,  3,  8,  15, 3,  3,
-    6,  10, 5,  8,  8, 6,  8,  5,  15, 15, 8, 15, 3, 5,  6, 10, 8,  15, 15, 3,  15, 5,
-    15, 15, 15, 15, 3, 15, 5,  5,  5,  8,  5, 10, 5, 10, 8, 13, 15, 12, 3,  3};
+static const char bc7_ai1[] = {3,  3,  15, 15, 8,  3,  15, 15, 8,  8,  6,  6,  6,
+                               5,  3,  3,  3,  3,  8,  15, 3,  3,  6,  10, 5,  8,
+                               8,  6,  8,  5,  15, 15, 8,  15, 3,  5,  6,  10, 8,
+                               15, 15, 3,  15, 5,  15, 15, 15, 15, 3,  15, 5,  5,
+                               5,  8,  5,  10, 5,  10, 8,  13, 15, 12, 3,  3};
 
 /* Table.A3b */
 static const char bc7_ai2[] = {15, 8,  8,  3,  15, 15, 3,  8,  15, 15, 15, 15, 15,
@@ -293,7 +298,8 @@ static const char bc7_ai2[] = {15, 8,  8,  3,  15, 15, 3,  8,  15, 15, 15, 15, 1
 static const char bc7_weights2[] = {0, 21, 43, 64};
 static const char bc7_weights3[] = {0, 9, 18, 27, 37, 46, 55, 64};
 static const char bc7_weights4[] = {
-    0, 4, 9, 13, 17, 21, 26, 30, 34, 38, 43, 47, 51, 55, 60, 64};
+    0, 4, 9, 13, 17, 21, 26, 30, 34, 38, 43, 47, 51, 55, 60, 64
+};
 
 static const char *
 bc7_get_weights(int n) {
@@ -526,7 +532,8 @@ static const bc6_mode_info bc6_modes[] = {
     {1, 0, 0, 10, 10, 10, 10},
     {1, 1, 0, 11, 9, 9, 9},
     {1, 1, 0, 12, 8, 8, 8},
-    {1, 1, 0, 16, 4, 4, 4}};
+    {1, 1, 0, 16, 4, 4, 4}
+};
 
 /* Table.F, encoded as a sequence of bit indices */
 static const UINT8 bc6_bit_packings[][75] = {
@@ -591,7 +598,8 @@ static const UINT8 bc6_bit_packings[][75] = {
      64, 65, 66, 67, 68, 69, 70, 71, 27, 26, 80, 81, 82, 83, 84, 85, 86, 87, 43, 42},
     {0,  1,  2,  3,  4,  5,  6,  7,  8,  9,  16, 17, 18, 19, 20, 21, 22, 23, 24, 25,
      32, 33, 34, 35, 36, 37, 38, 39, 40, 41, 48, 49, 50, 51, 15, 14, 13, 12, 11, 10,
-     64, 65, 66, 67, 31, 30, 29, 28, 27, 26, 80, 81, 82, 83, 47, 46, 45, 44, 43, 42}};
+     64, 65, 66, 67, 31, 30, 29, 28, 27, 26, 80, 81, 82, 83, 47, 46, 45, 44, 43, 42}
+};
 
 static void
 bc6_sign_extend(UINT16 *v, int prec) {
@@ -830,7 +838,8 @@ decode_bcn(
     int bytes,
     int N,
     int C,
-    char *pixel_format) {
+    char *pixel_format
+) {
     int ymax = state->ysize + state->yoff;
     const UINT8 *ptr = src;
     switch (N) {
diff --git a/src/libImaging/BoxBlur.c b/src/libImaging/BoxBlur.c
index 4ea9c77178a..51cb7e1024e 100644
--- a/src/libImaging/BoxBlur.c
+++ b/src/libImaging/BoxBlur.c
@@ -13,7 +13,8 @@ void static inline ImagingLineBoxBlur32(
     int edgeA,
     int edgeB,
     UINT32 ww,
-    UINT32 fw) {
+    UINT32 fw
+) {
     int x;
     UINT32 acc[4];
     UINT32 bulk[4];
@@ -109,7 +110,8 @@ void static inline ImagingLineBoxBlur8(
     int edgeA,
     int edgeB,
     UINT32 ww,
-    UINT32 fw) {
+    UINT32 fw
+) {
     int x;
     UINT32 acc;
     UINT32 bulk;
@@ -198,7 +200,8 @@ ImagingHorizontalBoxBlur(Imaging imOut, Imaging imIn, float floatRadius) {
                 edgeA,
                 edgeB,
                 ww,
-                fw);
+                fw
+            );
             if (imIn == imOut) {
                 // Commit.
                 memcpy(imOut->image8[y], lineOut, imIn->xsize);
@@ -214,7 +217,8 @@ ImagingHorizontalBoxBlur(Imaging imOut, Imaging imIn, float floatRadius) {
                 edgeA,
                 edgeB,
                 ww,
-                fw);
+                fw
+            );
             if (imIn == imOut) {
                 // Commit.
                 memcpy(imOut->image32[y], lineOut, imIn->xsize * 4);
@@ -314,11 +318,13 @@ _gaussian_blur_radius(float radius, int passes) {
 
 Imaging
 ImagingGaussianBlur(
-    Imaging imOut, Imaging imIn, float xradius, float yradius, int passes) {
+    Imaging imOut, Imaging imIn, float xradius, float yradius, int passes
+) {
     return ImagingBoxBlur(
         imOut,
         imIn,
         _gaussian_blur_radius(xradius, passes),
         _gaussian_blur_radius(yradius, passes),
-        passes);
+        passes
+    );
 }
diff --git a/src/libImaging/Chops.c b/src/libImaging/Chops.c
index f9c005efe3a..f326d402f2c 100644
--- a/src/libImaging/Chops.c
+++ b/src/libImaging/Chops.c
@@ -142,7 +142,8 @@ ImagingChopSoftLight(Imaging imIn1, Imaging imIn2) {
     CHOP2(
         (((255 - in1[x]) * (in1[x] * in2[x])) / 65536) +
             (in1[x] * (255 - ((255 - in1[x]) * (255 - in2[x]) / 255))) / 255,
-        NULL);
+        NULL
+    );
 }
 
 Imaging
@@ -150,7 +151,8 @@ ImagingChopHardLight(Imaging imIn1, Imaging imIn2) {
     CHOP2(
         (in2[x] < 128) ? ((in1[x] * in2[x]) / 127)
                        : 255 - (((255 - in2[x]) * (255 - in1[x])) / 127),
-        NULL);
+        NULL
+    );
 }
 
 Imaging
@@ -158,5 +160,6 @@ ImagingOverlay(Imaging imIn1, Imaging imIn2) {
     CHOP2(
         (in1[x] < 128) ? ((in1[x] * in2[x]) / 127)
                        : 255 - (((255 - in1[x]) * (255 - in2[x])) / 127),
-        NULL);
+        NULL
+    );
 }
diff --git a/src/libImaging/ColorLUT.c b/src/libImaging/ColorLUT.c
index aee7cda067d..5559de689b2 100644
--- a/src/libImaging/ColorLUT.c
+++ b/src/libImaging/ColorLUT.c
@@ -63,7 +63,8 @@ ImagingColorLUT3D_linear(
     int size1D,
     int size2D,
     int size3D,
-    INT16 *table) {
+    INT16 *table
+) {
     /* This float to int conversion doesn't have rounding
        error compensation (+0.5) for two reasons:
        1. As we don't hit the highest value,
@@ -112,7 +113,8 @@ ImagingColorLUT3D_linear(
                                            index2D >> SCALE_BITS,
                                            index3D >> SCALE_BITS,
                                            size1D,
-                                           size1D_2D);
+                                           size1D_2D
+                                       );
             INT16 result[4], left[4], right[4];
             INT16 leftleft[4], leftright[4], rightleft[4], rightright[4];
 
@@ -123,19 +125,22 @@ ImagingColorLUT3D_linear(
                     leftright,
                     &table[idx + size1D * 3],
                     &table[idx + size1D * 3 + 3],
-                    shift1D);
+                    shift1D
+                );
                 interpolate3(left, leftleft, leftright, shift2D);
 
                 interpolate3(
                     rightleft,
                     &table[idx + size1D_2D * 3],
                     &table[idx + size1D_2D * 3 + 3],
-                    shift1D);
+                    shift1D
+                );
                 interpolate3(
                     rightright,
                     &table[idx + size1D_2D * 3 + size1D * 3],
                     &table[idx + size1D_2D * 3 + size1D * 3 + 3],
-                    shift1D);
+                    shift1D
+                );
                 interpolate3(right, rightleft, rightright, shift2D);
 
                 interpolate3(result, left, right, shift3D);
@@ -144,7 +149,8 @@ ImagingColorLUT3D_linear(
                     clip8(result[0]),
                     clip8(result[1]),
                     clip8(result[2]),
-                    rowIn[x * 4 + 3]);
+                    rowIn[x * 4 + 3]
+                );
                 memcpy(rowOut + x * sizeof(v), &v, sizeof(v));
             }
 
@@ -155,19 +161,22 @@ ImagingColorLUT3D_linear(
                     leftright,
                     &table[idx + size1D * 4],
                     &table[idx + size1D * 4 + 4],
-                    shift1D);
+                    shift1D
+                );
                 interpolate4(left, leftleft, leftright, shift2D);
 
                 interpolate4(
                     rightleft,
                     &table[idx + size1D_2D * 4],
                     &table[idx + size1D_2D * 4 + 4],
-                    shift1D);
+                    shift1D
+                );
                 interpolate4(
                     rightright,
                     &table[idx + size1D_2D * 4 + size1D * 4],
                     &table[idx + size1D_2D * 4 + size1D * 4 + 4],
-                    shift1D);
+                    shift1D
+                );
                 interpolate4(right, rightleft, rightright, shift2D);
 
                 interpolate4(result, left, right, shift3D);
@@ -176,7 +185,8 @@ ImagingColorLUT3D_linear(
                     clip8(result[0]),
                     clip8(result[1]),
                     clip8(result[2]),
-                    clip8(result[3]));
+                    clip8(result[3])
+                );
                 memcpy(rowOut + x * sizeof(v), &v, sizeof(v));
             }
         }
diff --git a/src/libImaging/Convert.c b/src/libImaging/Convert.c
index fcb5f7ad95e..c8f23426105 100644
--- a/src/libImaging/Convert.c
+++ b/src/libImaging/Convert.c
@@ -1044,7 +1044,8 @@ static struct {
     {"I;16L", "F", I16L_F},
     {"I;16B", "F", I16B_F},
 
-    {NULL}};
+    {NULL}
+};
 
 /* FIXME: translate indexed versions to pointer versions below this line */
 
@@ -1316,7 +1317,8 @@ frompalette(Imaging imOut, Imaging imIn, const char *mode) {
             (UINT8 *)imOut->image[y],
             (UINT8 *)imIn->image[y],
             imIn->xsize,
-            imIn->palette);
+            imIn->palette
+        );
     }
     ImagingSectionLeave(&cookie);
 
@@ -1328,11 +1330,8 @@ frompalette(Imaging imOut, Imaging imIn, const char *mode) {
 #endif
 static Imaging
 topalette(
-    Imaging imOut,
-    Imaging imIn,
-    const char *mode,
-    ImagingPalette inpalette,
-    int dither) {
+    Imaging imOut, Imaging imIn, const char *mode, ImagingPalette inpalette, int dither
+) {
     ImagingSectionCookie cookie;
     int alpha;
     int x, y;
@@ -1623,7 +1622,8 @@ tobilevel(Imaging imOut, Imaging imIn) {
 
 static Imaging
 convert(
-    Imaging imOut, Imaging imIn, const char *mode, ImagingPalette palette, int dither) {
+    Imaging imOut, Imaging imIn, const char *mode, ImagingPalette palette, int dither
+) {
     ImagingSectionCookie cookie;
     ImagingShuffler convert;
     int y;
@@ -1677,7 +1677,8 @@ convert(
 #else
         static char buf[100];
         snprintf(
-            buf, 100, "conversion from %.10s to %.10s not supported", imIn->mode, mode);
+            buf, 100, "conversion from %.10s to %.10s not supported", imIn->mode, mode
+        );
         return (Imaging)ImagingError_ValueError(buf);
 #endif
     }
@@ -1727,18 +1728,16 @@ ImagingConvertTransparent(Imaging imIn, const char *mode, int r, int g, int b) {
         if (strcmp(mode, "RGBa") == 0) {
             premultiplied = 1;
         }
-    } else if (
-        strcmp(imIn->mode, "RGB") == 0 &&
-        (strcmp(mode, "LA") == 0 || strcmp(mode, "La") == 0)) {
+    } else if (strcmp(imIn->mode, "RGB") == 0 &&
+               (strcmp(mode, "LA") == 0 || strcmp(mode, "La") == 0)) {
         convert = rgb2la;
         source_transparency = 1;
         if (strcmp(mode, "La") == 0) {
             premultiplied = 1;
         }
-    } else if (
-        (strcmp(imIn->mode, "1") == 0 || strcmp(imIn->mode, "I") == 0 ||
-         strcmp(imIn->mode, "I;16") == 0 || strcmp(imIn->mode, "L") == 0) &&
-        (strcmp(mode, "RGBA") == 0 || strcmp(mode, "LA") == 0)) {
+    } else if ((strcmp(imIn->mode, "1") == 0 || strcmp(imIn->mode, "I") == 0 ||
+                strcmp(imIn->mode, "I;16") == 0 || strcmp(imIn->mode, "L") == 0) &&
+               (strcmp(mode, "RGBA") == 0 || strcmp(mode, "LA") == 0)) {
         if (strcmp(imIn->mode, "1") == 0) {
             convert = bit2rgb;
         } else if (strcmp(imIn->mode, "I") == 0) {
@@ -1756,7 +1755,8 @@ ImagingConvertTransparent(Imaging imIn, const char *mode, int r, int g, int b) {
             100,
             "conversion from %.10s to %.10s not supported in convert_transparent",
             imIn->mode,
-            mode);
+            mode
+        );
         return (Imaging)ImagingError_ValueError(buf);
     }
 
diff --git a/src/libImaging/ConvertYCbCr.c b/src/libImaging/ConvertYCbCr.c
index 142f065e57d..285b4332740 100644
--- a/src/libImaging/ConvertYCbCr.c
+++ b/src/libImaging/ConvertYCbCr.c
@@ -47,7 +47,8 @@ static INT16 Y_R[] = {
     4019, 4038, 4057, 4076, 4095, 4114, 4133, 4153, 4172, 4191, 4210, 4229, 4248, 4267,
     4286, 4306, 4325, 4344, 4363, 4382, 4401, 4420, 4440, 4459, 4478, 4497, 4516, 4535,
     4554, 4574, 4593, 4612, 4631, 4650, 4669, 4688, 4707, 4727, 4746, 4765, 4784, 4803,
-    4822, 4841, 4861, 4880};
+    4822, 4841, 4861, 4880
+};
 
 static INT16 Y_G[] = {
     0,    38,   75,   113,  150,  188,  225,  263,  301,  338,  376,  413,  451,  488,
@@ -68,7 +69,8 @@ static INT16 Y_G[] = {
     7889, 7927, 7964, 8002, 8040, 8077, 8115, 8152, 8190, 8227, 8265, 8303, 8340, 8378,
     8415, 8453, 8490, 8528, 8566, 8603, 8641, 8678, 8716, 8753, 8791, 8828, 8866, 8904,
     8941, 8979, 9016, 9054, 9091, 9129, 9167, 9204, 9242, 9279, 9317, 9354, 9392, 9430,
-    9467, 9505, 9542, 9580};
+    9467, 9505, 9542, 9580
+};
 
 static INT16 Y_B[] = {
     0,    7,    15,   22,   29,   36,   44,   51,   58,   66,   73,   80,   88,   95,
@@ -89,7 +91,8 @@ static INT16 Y_B[] = {
     1532, 1539, 1547, 1554, 1561, 1569, 1576, 1583, 1591, 1598, 1605, 1612, 1620, 1627,
     1634, 1642, 1649, 1656, 1663, 1671, 1678, 1685, 1693, 1700, 1707, 1715, 1722, 1729,
     1736, 1744, 1751, 1758, 1766, 1773, 1780, 1788, 1795, 1802, 1809, 1817, 1824, 1831,
-    1839, 1846, 1853, 1860};
+    1839, 1846, 1853, 1860
+};
 
 static INT16 Cb_R[] = {
     0,     -10,   -21,   -31,   -42,   -53,   -64,   -75,   -85,   -96,   -107,  -118,
@@ -113,7 +116,8 @@ static INT16 Cb_R[] = {
     -2332, -2342, -2353, -2364, -2375, -2386, -2396, -2407, -2418, -2429, -2440, -2450,
     -2461, -2472, -2483, -2494, -2504, -2515, -2526, -2537, -2548, -2558, -2569, -2580,
     -2591, -2602, -2612, -2623, -2634, -2645, -2656, -2666, -2677, -2688, -2699, -2710,
-    -2720, -2731, -2742, -2753};
+    -2720, -2731, -2742, -2753
+};
 
 static INT16 Cb_G[] = {
     0,     -20,   -41,   -63,   -84,   -105,  -126,  -147,  -169,  -190,  -211,  -232,
@@ -137,7 +141,8 @@ static INT16 Cb_G[] = {
     -4578, -4600, -4621, -4642, -4663, -4684, -4706, -4727, -4748, -4769, -4790, -4812,
     -4833, -4854, -4875, -4896, -4918, -4939, -4960, -4981, -5002, -5024, -5045, -5066,
     -5087, -5108, -5130, -5151, -5172, -5193, -5214, -5236, -5257, -5278, -5299, -5320,
-    -5342, -5363, -5384, -5405};
+    -5342, -5363, -5384, -5405
+};
 
 static INT16 Cb_B[] = {
     0,    32,   64,   96,   128,  160,  192,  224,  256,  288,  320,  352,  384,  416,
@@ -158,7 +163,8 @@ static INT16 Cb_B[] = {
     6720, 6752, 6784, 6816, 6848, 6880, 6912, 6944, 6976, 7008, 7040, 7072, 7104, 7136,
     7168, 7200, 7232, 7264, 7296, 7328, 7360, 7392, 7424, 7456, 7488, 7520, 7552, 7584,
     7616, 7648, 7680, 7712, 7744, 7776, 7808, 7840, 7872, 7904, 7936, 7968, 8000, 8032,
-    8064, 8096, 8128, 8160};
+    8064, 8096, 8128, 8160
+};
 
 #define Cr_R Cb_B
 
@@ -184,7 +190,8 @@ static INT16 Cr_G[] = {
     -5787, -5814, -5841, -5867, -5894, -5921, -5948, -5975, -6001, -6028, -6055, -6082,
     -6109, -6135, -6162, -6189, -6216, -6243, -6269, -6296, -6323, -6350, -6376, -6403,
     -6430, -6457, -6484, -6510, -6537, -6564, -6591, -6618, -6644, -6671, -6698, -6725,
-    -6752, -6778, -6805, -6832};
+    -6752, -6778, -6805, -6832
+};
 
 static INT16 Cr_B[] = {
     0,     -4,    -9,    -15,   -20,   -25,   -30,   -35,   -41,   -46,   -51,   -56,
@@ -208,7 +215,8 @@ static INT16 Cr_B[] = {
     -1123, -1128, -1133, -1139, -1144, -1149, -1154, -1159, -1165, -1170, -1175, -1180,
     -1185, -1191, -1196, -1201, -1206, -1211, -1217, -1222, -1227, -1232, -1238, -1243,
     -1248, -1253, -1258, -1264, -1269, -1274, -1279, -1284, -1290, -1295, -1300, -1305,
-    -1310, -1316, -1321, -1326};
+    -1310, -1316, -1321, -1326
+};
 
 static INT16 R_Cr[] = {
     -11484, -11394, -11305, -11215, -11125, -11036, -10946, -10856, -10766, -10677,
@@ -236,7 +244,8 @@ static INT16 R_Cr[] = {
     8255,   8345,   8434,   8524,   8614,   8704,   8793,   8883,   8973,   9063,
     9152,   9242,   9332,   9421,   9511,   9601,   9691,   9780,   9870,   9960,
     10050,  10139,  10229,  10319,  10408,  10498,  10588,  10678,  10767,  10857,
-    10947,  11037,  11126,  11216,  11306,  11395};
+    10947,  11037,  11126,  11216,  11306,  11395
+};
 
 static INT16 G_Cb[] = {
     2819,  2797,  2775,  2753,  2731,  2709,  2687,  2665,  2643,  2621,  2599,  2577,
@@ -260,7 +269,8 @@ static INT16 G_Cb[] = {
     -1937, -1959, -1981, -2003, -2025, -2047, -2069, -2091, -2113, -2135, -2157, -2179,
     -2201, -2224, -2246, -2268, -2290, -2312, -2334, -2356, -2378, -2400, -2422, -2444,
     -2466, -2488, -2510, -2532, -2554, -2576, -2598, -2620, -2642, -2664, -2686, -2708,
-    -2730, -2752, -2774, -2796};
+    -2730, -2752, -2774, -2796
+};
 
 static INT16 G_Cr[] = {
     5850,  5805,  5759,  5713,  5667,  5622,  5576,  5530,  5485,  5439,  5393,  5347,
@@ -284,7 +294,8 @@ static INT16 G_Cr[] = {
     -4021, -4067, -4112, -4158, -4204, -4250, -4295, -4341, -4387, -4432, -4478, -4524,
     -4569, -4615, -4661, -4707, -4752, -4798, -4844, -4889, -4935, -4981, -5027, -5072,
     -5118, -5164, -5209, -5255, -5301, -5346, -5392, -5438, -5484, -5529, -5575, -5621,
-    -5666, -5712, -5758, -5804};
+    -5666, -5712, -5758, -5804
+};
 
 static INT16 B_Cb[] = {
     -14515, -14402, -14288, -14175, -14062, -13948, -13835, -13721, -13608, -13495,
@@ -312,7 +323,8 @@ static INT16 B_Cb[] = {
     10434,  10547,  10660,  10774,  10887,  11001,  11114,  11227,  11341,  11454,
     11568,  11681,  11794,  11908,  12021,  12135,  12248,  12361,  12475,  12588,
     12702,  12815,  12929,  13042,  13155,  13269,  13382,  13496,  13609,  13722,
-    13836,  13949,  14063,  14176,  14289,  14403};
+    13836,  13949,  14063,  14176,  14289,  14403
+};
 
 void
 ImagingConvertRGB2YCbCr(UINT8 *out, const UINT8 *in, int pixels) {
diff --git a/src/libImaging/Dib.c b/src/libImaging/Dib.c
index 269be10587b..c69e9e552ae 100644
--- a/src/libImaging/Dib.c
+++ b/src/libImaging/Dib.c
@@ -95,7 +95,8 @@ ImagingNewDIB(const char *mode, int xsize, int ysize) {
     }
 
     dib->bitmap = CreateDIBSection(
-        dib->dc, dib->info, DIB_RGB_COLORS, (void **)&dib->bits, NULL, 0);
+        dib->dc, dib->info, DIB_RGB_COLORS, (void **)&dib->bits, NULL, 0
+    );
     if (!dib->bitmap) {
         free(dib->info);
         free(dib);
@@ -218,7 +219,8 @@ ImagingPasteDIB(ImagingDIB dib, Imaging im, int xy[4]) {
             dib->bits + dib->linesize * (dib->ysize - (xy[1] + y) - 1) +
                 xy[0] * dib->pixelsize,
             im->image[y],
-            im->xsize);
+            im->xsize
+        );
     }
 }
 
@@ -251,7 +253,8 @@ ImagingDrawDIB(ImagingDIB dib, void *dc, int dst[4], int src[4]) {
             dib->bits,
             dib->info,
             DIB_RGB_COLORS,
-            SRCCOPY);
+            SRCCOPY
+        );
     } else {
         /* stretchblt (displays) */
         if (dib->palette != 0) {
@@ -268,7 +271,8 @@ ImagingDrawDIB(ImagingDIB dib, void *dc, int dst[4], int src[4]) {
             src[1],
             src[2] - src[0],
             src[3] - src[1],
-            SRCCOPY);
+            SRCCOPY
+        );
     }
 }
 
diff --git a/src/libImaging/Draw.c b/src/libImaging/Draw.c
index 133696dd86f..f1c8ffcff8d 100644
--- a/src/libImaging/Draw.c
+++ b/src/libImaging/Draw.c
@@ -120,9 +120,8 @@ hline8(Imaging im, int x0, int y0, int x1, int ink) {
         if (x0 <= x1) {
             pixelwidth = strncmp(im->mode, "I;16", 4) == 0 ? 2 : 1;
             memset(
-                im->image8[y0] + x0 * pixelwidth,
-                (UINT8)ink,
-                (x1 - x0 + 1) * pixelwidth);
+                im->image8[y0] + x0 * pixelwidth, (UINT8)ink, (x1 - x0 + 1) * pixelwidth
+            );
         }
     }
 }
@@ -408,7 +407,8 @@ x_cmp(const void *x0, const void *x1) {
 
 static void
 draw_horizontal_lines(
-    Imaging im, int n, Edge *e, int ink, int *x_pos, int y, hline_handler hline) {
+    Imaging im, int n, Edge *e, int ink, int *x_pos, int y, hline_handler hline
+) {
     int i;
     for (i = 0; i < n; i++) {
         if (e[i].ymin == y && e[i].ymin == e[i].ymax) {
@@ -440,13 +440,8 @@ draw_horizontal_lines(
  */
 static inline int
 polygon_generic(
-    Imaging im,
-    int n,
-    Edge *e,
-    int ink,
-    int eofill,
-    hline_handler hline,
-    int hasAlpha) {
+    Imaging im, int n, Edge *e, int ink, int eofill, hline_handler hline, int hasAlpha
+) {
     Edge **edge_table;
     float *xx;
     int edge_count = 0;
@@ -530,25 +525,29 @@ polygon_generic(
                                 other_edge->x0;
                             if (ymin == current->ymax) {
                                 if (current->dx > 0) {
-                                    xx[k] = fmax(
-                                                adjacent_line_x,
-                                                adjacent_line_x_other_edge) +
-                                            1;
+                                    xx[k] =
+                                        fmax(
+                                            adjacent_line_x, adjacent_line_x_other_edge
+                                        ) +
+                                        1;
                                 } else {
-                                    xx[k] = fmin(
-                                                adjacent_line_x,
-                                                adjacent_line_x_other_edge) -
-                                            1;
+                                    xx[k] =
+                                        fmin(
+                                            adjacent_line_x, adjacent_line_x_other_edge
+                                        ) -
+                                        1;
                                 }
                             } else {
                                 if (current->dx > 0) {
                                     xx[k] = fmin(
-                                        adjacent_line_x, adjacent_line_x_other_edge);
+                                        adjacent_line_x, adjacent_line_x_other_edge
+                                    );
                                 } else {
-                                    xx[k] = fmax(
-                                                adjacent_line_x,
-                                                adjacent_line_x_other_edge) +
-                                            1;
+                                    xx[k] =
+                                        fmax(
+                                            adjacent_line_x, adjacent_line_x_other_edge
+                                        ) +
+                                        1;
                                 }
                             }
                             break;
@@ -699,7 +698,8 @@ ImagingDrawLine(Imaging im, int x0, int y0, int x1, int y1, const void *ink_, in
 
 int
 ImagingDrawWideLine(
-    Imaging im, int x0, int y0, int x1, int y1, const void *ink_, int width, int op) {
+    Imaging im, int x0, int y0, int x1, int y1, const void *ink_, int width, int op
+) {
     DRAW *draw;
     INT32 ink;
     int dx, dy;
@@ -730,7 +730,8 @@ ImagingDrawWideLine(
             {x0 - dxmin, y0 + dymax},
             {x1 - dxmin, y1 + dymax},
             {x1 + dxmax, y1 - dymin},
-            {x0 + dxmax, y0 - dymin}};
+            {x0 + dxmax, y0 - dymin}
+        };
 
         add_edge(e + 0, vertices[0][0], vertices[0][1], vertices[1][0], vertices[1][1]);
         add_edge(e + 1, vertices[1][0], vertices[1][1], vertices[2][0], vertices[2][1]);
@@ -752,7 +753,8 @@ ImagingDrawRectangle(
     const void *ink_,
     int fill,
     int width,
-    int op) {
+    int op
+) {
     int i;
     int y;
     int tmp;
@@ -800,7 +802,8 @@ ImagingDrawRectangle(
 
 int
 ImagingDrawPolygon(
-    Imaging im, int count, int *xy, const void *ink_, int fill, int width, int op) {
+    Imaging im, int count, int *xy, const void *ink_, int fill, int width, int op
+) {
     int i, n, x0, y0, x1, y1;
     DRAW *draw;
     INT32 ink;
@@ -851,7 +854,8 @@ ImagingDrawPolygon(
         if (width == 1) {
             for (i = 0; i < count - 1; i++) {
                 draw->line(
-                    im, xy[i * 2], xy[i * 2 + 1], xy[i * 2 + 2], xy[i * 2 + 3], ink);
+                    im, xy[i * 2], xy[i * 2 + 1], xy[i * 2 + 2], xy[i * 2 + 3], ink
+                );
             }
             draw->line(im, xy[i * 2], xy[i * 2 + 1], xy[0], xy[1], ink);
         } else {
@@ -864,10 +868,12 @@ ImagingDrawPolygon(
                     xy[i * 2 + 3],
                     ink_,
                     width,
-                    op);
+                    op
+                );
             }
             ImagingDrawWideLine(
-                im, xy[i * 2], xy[i * 2 + 1], xy[0], xy[1], ink_, width, op);
+                im, xy[i * 2], xy[i * 2 + 1], xy[0], xy[1], ink_, width, op
+            );
         }
     }
 
@@ -877,7 +883,8 @@ ImagingDrawPolygon(
 int
 ImagingDrawBitmap(Imaging im, int x0, int y0, Imaging bitmap, const void *ink, int op) {
     return ImagingFill2(
-        im, ink, bitmap, x0, y0, x0 + bitmap->xsize, y0 + bitmap->ysize);
+        im, ink, bitmap, x0, y0, x0 + bitmap->xsize, y0 + bitmap->ysize
+    );
 }
 
 /* -------------------------------------------------------------------- */
@@ -1086,7 +1093,8 @@ clip_tree_transpose(clip_node *root) {
 // segments, i.e. something like correct bracket sequences.
 int
 clip_tree_do_clip(
-    clip_node *root, int32_t x0, int32_t y, int32_t x1, event_list **ret) {
+    clip_node *root, int32_t x0, int32_t y, int32_t x1, event_list **ret
+) {
     if (root == NULL) {
         event_list *start = malloc(sizeof(event_list));
         if (!start) {
@@ -1223,7 +1231,8 @@ typedef struct {
 } clip_ellipse_state;
 
 typedef void (*clip_ellipse_init)(
-    clip_ellipse_state *, int32_t, int32_t, int32_t, float, float);
+    clip_ellipse_state *, int32_t, int32_t, int32_t, float, float
+);
 
 void
 debug_clip_tree(clip_node *root, int space) {
@@ -1335,7 +1344,8 @@ arc_init(clip_ellipse_state *s, int32_t a, int32_t b, int32_t w, float al, float
 // A chord line.
 void
 chord_line_init(
-    clip_ellipse_state *s, int32_t a, int32_t b, int32_t w, float al, float ar) {
+    clip_ellipse_state *s, int32_t a, int32_t b, int32_t w, float al, float ar
+) {
     ellipse_init(&s->st, a, b, a + b + 1);
 
     s->head = NULL;
@@ -1362,7 +1372,8 @@ chord_line_init(
 // Pie side.
 void
 pie_side_init(
-    clip_ellipse_state *s, int32_t a, int32_t b, int32_t w, float al, float _) {
+    clip_ellipse_state *s, int32_t a, int32_t b, int32_t w, float al, float _
+) {
     ellipse_init(&s->st, a, b, a + b + 1);
 
     s->head = NULL;
@@ -1478,7 +1489,8 @@ clip_ellipse_free(clip_ellipse_state *s) {
 
 int8_t
 clip_ellipse_next(
-    clip_ellipse_state *s, int32_t *ret_x0, int32_t *ret_y, int32_t *ret_x1) {
+    clip_ellipse_state *s, int32_t *ret_x0, int32_t *ret_y, int32_t *ret_x1
+) {
     int32_t x0, y, x1;
     while (s->head == NULL && ellipse_next(&s->st, &x0, &y, &x1) >= 0) {
         if (clip_tree_do_clip(s->root, x0, y, x1, &s->head) < 0) {
@@ -1512,7 +1524,8 @@ ellipseNew(
     const void *ink_,
     int fill,
     int width,
-    int op) {
+    int op
+) {
     DRAW *draw;
     INT32 ink;
     DRAWINIT();
@@ -1547,7 +1560,8 @@ clipEllipseNew(
     const void *ink_,
     int width,
     int op,
-    clip_ellipse_init init) {
+    clip_ellipse_init init
+) {
     DRAW *draw;
     INT32 ink;
     DRAWINIT();
@@ -1580,7 +1594,8 @@ arcNew(
     float end,
     const void *ink_,
     int width,
-    int op) {
+    int op
+) {
     return clipEllipseNew(im, x0, y0, x1, y1, start, end, ink_, width, op, arc_init);
 }
 
@@ -1595,7 +1610,8 @@ chordNew(
     float end,
     const void *ink_,
     int width,
-    int op) {
+    int op
+) {
     return clipEllipseNew(im, x0, y0, x1, y1, start, end, ink_, width, op, chord_init);
 }
 
@@ -1610,9 +1626,11 @@ chordLineNew(
     float end,
     const void *ink_,
     int width,
-    int op) {
+    int op
+) {
     return clipEllipseNew(
-        im, x0, y0, x1, y1, start, end, ink_, width, op, chord_line_init);
+        im, x0, y0, x1, y1, start, end, ink_, width, op, chord_line_init
+    );
 }
 
 static int
@@ -1626,7 +1644,8 @@ pieNew(
     float end,
     const void *ink_,
     int width,
-    int op) {
+    int op
+) {
     return clipEllipseNew(im, x0, y0, x1, y1, start, end, ink_, width, op, pie_init);
 }
 
@@ -1640,7 +1659,8 @@ pieSideNew(
     float start,
     const void *ink_,
     int width,
-    int op) {
+    int op
+) {
     return clipEllipseNew(im, x0, y0, x1, y1, start, 0, ink_, width, op, pie_side_init);
 }
 
@@ -1654,7 +1674,8 @@ ImagingDrawEllipse(
     const void *ink,
     int fill,
     int width,
-    int op) {
+    int op
+) {
     return ellipseNew(im, x0, y0, x1, y1, ink, fill, width, op);
 }
 
@@ -1669,7 +1690,8 @@ ImagingDrawArc(
     float end,
     const void *ink,
     int width,
-    int op) {
+    int op
+) {
     normalize_angles(&start, &end);
     if (start + 360 == end) {
         return ImagingDrawEllipse(im, x0, y0, x1, y1, ink, 0, width, op);
@@ -1692,7 +1714,8 @@ ImagingDrawChord(
     const void *ink,
     int fill,
     int width,
-    int op) {
+    int op
+) {
     normalize_angles(&start, &end);
     if (start + 360 == end) {
         return ImagingDrawEllipse(im, x0, y0, x1, y1, ink, fill, width, op);
@@ -1722,7 +1745,8 @@ ImagingDrawPieslice(
     const void *ink,
     int fill,
     int width,
-    int op) {
+    int op
+) {
     normalize_angles(&start, &end);
     if (start + 360 == end) {
         return ellipseNew(im, x0, y0, x1, y1, ink, fill, width, op);
@@ -1850,13 +1874,8 @@ ImagingOutlineLine(ImagingOutline outline, float x1, float y1) {
 
 int
 ImagingOutlineCurve(
-    ImagingOutline outline,
-    float x1,
-    float y1,
-    float x2,
-    float y2,
-    float x3,
-    float y3) {
+    ImagingOutline outline, float x1, float y1, float x2, float y2, float x3, float y3
+) {
     Edge *e;
     int i;
     float xo, yo;
@@ -1970,7 +1989,8 @@ ImagingOutlineTransform(ImagingOutline outline, double a[6]) {
 
 int
 ImagingDrawOutline(
-    Imaging im, ImagingOutline outline, const void *ink_, int fill, int op) {
+    Imaging im, ImagingOutline outline, const void *ink_, int fill, int op
+) {
     DRAW *draw;
     INT32 ink;
 
diff --git a/src/libImaging/Fill.c b/src/libImaging/Fill.c
index 5b6bfb89cd8..8fb481e7e4d 100644
--- a/src/libImaging/Fill.c
+++ b/src/libImaging/Fill.c
@@ -118,8 +118,8 @@ ImagingFillRadialGradient(const char *mode) {
 
     for (y = 0; y < 256; y++) {
         for (x = 0; x < 256; x++) {
-            d = (int)sqrt(
-                (double)((x - 128) * (x - 128) + (y - 128) * (y - 128)) * 2.0);
+            d = (int
+            )sqrt((double)((x - 128) * (x - 128) + (y - 128) * (y - 128)) * 2.0);
             if (d >= 255) {
                 d = 255;
             }
diff --git a/src/libImaging/Filter.c b/src/libImaging/Filter.c
index 85de77fcbbc..fbd6b425f12 100644
--- a/src/libImaging/Filter.c
+++ b/src/libImaging/Filter.c
@@ -59,7 +59,8 @@ ImagingExpand(Imaging imIn, int xmargin, int ymargin) {
     }
 
     imOut = ImagingNewDirty(
-        imIn->mode, imIn->xsize + 2 * xmargin, imIn->ysize + 2 * ymargin);
+        imIn->mode, imIn->xsize + 2 * xmargin, imIn->ysize + 2 * ymargin
+    );
     if (!imOut) {
         return NULL;
     }
@@ -369,7 +370,8 @@ ImagingFilter5x5(Imaging imOut, Imaging im, const float *kernel, float offset) {
                 }
             }
             memcpy(
-                out + x * sizeof(UINT32), in0 + x * sizeof(UINT32), sizeof(UINT32) * 2);
+                out + x * sizeof(UINT32), in0 + x * sizeof(UINT32), sizeof(UINT32) * 2
+            );
         }
     }
     memcpy(imOut->image[y], im->image[y], im->linesize);
diff --git a/src/libImaging/Geometry.c b/src/libImaging/Geometry.c
index cf3bc997942..2bfeed7b6c6 100644
--- a/src/libImaging/Geometry.c
+++ b/src/libImaging/Geometry.c
@@ -781,7 +781,8 @@ ImagingGenericTransform(
     ImagingTransformMap transform,
     void *transform_data,
     int filterid,
-    int fill) {
+    int fill
+) {
     /* slow generic transformation.  use ImagingTransformAffine or
        ImagingScaleAffine where possible. */
 
@@ -836,14 +837,8 @@ ImagingGenericTransform(
 
 static Imaging
 ImagingScaleAffine(
-    Imaging imOut,
-    Imaging imIn,
-    int x0,
-    int y0,
-    int x1,
-    int y1,
-    double a[6],
-    int fill) {
+    Imaging imOut, Imaging imIn, int x0, int y0, int x1, int y1, double a[6], int fill
+) {
     /* scale, nearest neighbour resampling */
 
     ImagingSectionCookie cookie;
@@ -936,7 +931,8 @@ static inline int
 check_fixed(double a[6], int x, int y) {
     return (
         fabs(x * a[0] + y * a[1] + a[2]) < 32768.0 &&
-        fabs(x * a[3] + y * a[4] + a[5]) < 32768.0);
+        fabs(x * a[3] + y * a[4] + a[5]) < 32768.0
+    );
 }
 
 static inline Imaging
@@ -949,7 +945,8 @@ affine_fixed(
     int y1,
     double a[6],
     int filterid,
-    int fill) {
+    int fill
+) {
     /* affine transform, nearest neighbour resampling, fixed point
        arithmetics */
 
@@ -1026,7 +1023,8 @@ ImagingTransformAffine(
     int y1,
     double a[6],
     int filterid,
-    int fill) {
+    int fill
+) {
     /* affine transform, nearest neighbour resampling, floating point
        arithmetics*/
 
@@ -1039,7 +1037,8 @@ ImagingTransformAffine(
 
     if (filterid || imIn->type == IMAGING_TYPE_SPECIAL) {
         return ImagingGenericTransform(
-            imOut, imIn, x0, y0, x1, y1, affine_transform, a, filterid, fill);
+            imOut, imIn, x0, y0, x1, y1, affine_transform, a, filterid, fill
+        );
     }
 
     if (a[1] == 0 && a[3] == 0) {
@@ -1134,13 +1133,15 @@ ImagingTransform(
     int y1,
     double a[8],
     int filterid,
-    int fill) {
+    int fill
+) {
     ImagingTransformMap transform;
 
     switch (method) {
         case IMAGING_TRANSFORM_AFFINE:
             return ImagingTransformAffine(
-                imOut, imIn, x0, y0, x1, y1, a, filterid, fill);
+                imOut, imIn, x0, y0, x1, y1, a, filterid, fill
+            );
             break;
         case IMAGING_TRANSFORM_PERSPECTIVE:
             transform = perspective_transform;
@@ -1153,5 +1154,6 @@ ImagingTransform(
     }
 
     return ImagingGenericTransform(
-        imOut, imIn, x0, y0, x1, y1, transform, a, filterid, fill);
+        imOut, imIn, x0, y0, x1, y1, transform, a, filterid, fill
+    );
 }
diff --git a/src/libImaging/GetBBox.c b/src/libImaging/GetBBox.c
index bd2a2778cdb..c61a27d3b7f 100644
--- a/src/libImaging/GetBBox.c
+++ b/src/libImaging/GetBBox.c
@@ -58,11 +58,10 @@ ImagingGetBBox(Imaging im, int bbox[4], int alpha_only) {
         INT32 mask = 0xffffffff;
         if (im->bands == 3) {
             ((UINT8 *)&mask)[3] = 0;
-        } else if (
-            alpha_only &&
-            (strcmp(im->mode, "RGBa") == 0 || strcmp(im->mode, "RGBA") == 0 ||
-             strcmp(im->mode, "La") == 0 || strcmp(im->mode, "LA") == 0 ||
-             strcmp(im->mode, "PA") == 0)) {
+        } else if (alpha_only &&
+                   (strcmp(im->mode, "RGBa") == 0 || strcmp(im->mode, "RGBA") == 0 ||
+                    strcmp(im->mode, "La") == 0 || strcmp(im->mode, "LA") == 0 ||
+                    strcmp(im->mode, "PA") == 0)) {
 #ifdef WORDS_BIGENDIAN
             mask = 0x000000ff;
 #else
@@ -246,13 +245,14 @@ getcolors32(Imaging im, int maxcolors, int *size) {
        code in Python 2.1.3; the exact implementation is borrowed from
        Python's Unicode property database (written by yours truly) /F */
 
-    static int SIZES[] = {
-        4,         3,  8,         3,  16,        3,  32,         5,  64,       3,
-        128,       3,  256,       29, 512,       17, 1024,       9,  2048,     5,
-        4096,      83, 8192,      27, 16384,     43, 32768,      3,  65536,    45,
-        131072,    9,  262144,    39, 524288,    39, 1048576,    9,  2097152,  5,
-        4194304,   3,  8388608,   33, 16777216,  27, 33554432,   9,  67108864, 71,
-        134217728, 39, 268435456, 9,  536870912, 5,  1073741824, 83, 0};
+    static int SIZES[] = {4,          3,  8,         3,  16,        3,  32,        5,
+                          64,         3,  128,       3,  256,       29, 512,       17,
+                          1024,       9,  2048,      5,  4096,      83, 8192,      27,
+                          16384,      43, 32768,     3,  65536,     45, 131072,    9,
+                          262144,     39, 524288,    39, 1048576,   9,  2097152,   5,
+                          4194304,    3,  8388608,   33, 16777216,  27, 33554432,  9,
+                          67108864,   71, 134217728, 39, 268435456, 9,  536870912, 5,
+                          1073741824, 83, 0};
 
     code_size = code_poly = code_mask = 0;
 
diff --git a/src/libImaging/GifEncode.c b/src/libImaging/GifEncode.c
index 45b67616d47..203fb9d0af0 100644
--- a/src/libImaging/GifEncode.c
+++ b/src/libImaging/GifEncode.c
@@ -79,7 +79,8 @@ glzwe(
     UINT8 *out_ptr,
     UINT32 *in_avail,
     UINT32 *out_avail,
-    UINT32 end_of_data) {
+    UINT32 end_of_data
+) {
     switch (st->entry_state) {
         case LZW_TRY_IN1:
 get_first_byte:
@@ -312,7 +313,8 @@ ImagingGifEncode(Imaging im, ImagingCodecState state, UINT8 *buf, int bytes) {
                 state->buffer,
                 (UINT8 *)im->image[state->y + state->yoff] +
                     state->xoff * im->pixelsize,
-                state->xsize);
+                state->xsize
+            );
             state->x = 0;
 
             /* step forward, according to the interlace settings */
@@ -348,7 +350,8 @@ ImagingGifEncode(Imaging im, ImagingCodecState state, UINT8 *buf, int bytes) {
             ptr,
             &in_avail,
             &out_avail,
-            state->state == FINISH);
+            state->state == FINISH
+        );
         out_used = sub_block_limit - ptr - out_avail;
         *sub_block_ptr += out_used;
         ptr += out_used;
diff --git a/src/libImaging/HexDecode.c b/src/libImaging/HexDecode.c
index bd16cdbe1da..e26c0e9b348 100644
--- a/src/libImaging/HexDecode.c
+++ b/src/libImaging/HexDecode.c
@@ -49,7 +49,8 @@ ImagingHexDecode(Imaging im, ImagingCodecState state, UINT8 *buf, Py_ssize_t byt
             if (++state->x >= state->bytes) {
                 /* Got a full line, unpack it */
                 state->shuffle(
-                    (UINT8 *)im->image[state->y], state->buffer, state->xsize);
+                    (UINT8 *)im->image[state->y], state->buffer, state->xsize
+                );
 
                 state->x = 0;
 
diff --git a/src/libImaging/Imaging.h b/src/libImaging/Imaging.h
index 1f2c03e934f..b1c3aed4175 100644
--- a/src/libImaging/Imaging.h
+++ b/src/libImaging/Imaging.h
@@ -295,7 +295,8 @@ extern Imaging
 ImagingFill(Imaging im, const void *ink);
 extern int
 ImagingFill2(
-    Imaging into, const void *ink, Imaging mask, int x0, int y0, int x1, int y1);
+    Imaging into, const void *ink, Imaging mask, int x0, int y0, int x1, int y1
+);
 extern Imaging
 ImagingFillBand(Imaging im, int band, int color);
 extern Imaging
@@ -310,7 +311,8 @@ extern Imaging
 ImagingFlipTopBottom(Imaging imOut, Imaging imIn);
 extern Imaging
 ImagingGaussianBlur(
-    Imaging imOut, Imaging imIn, float xradius, float yradius, int passes);
+    Imaging imOut, Imaging imIn, float xradius, float yradius, int passes
+);
 extern Imaging
 ImagingGetBand(Imaging im, int band);
 extern Imaging
@@ -373,7 +375,8 @@ ImagingTransform(
     int y1,
     double a[8],
     int filter,
-    int fill);
+    int fill
+);
 extern Imaging
 ImagingUnsharpMask(Imaging imOut, Imaging im, float radius, int percent, int threshold);
 extern Imaging
@@ -386,7 +389,8 @@ ImagingColorLUT3D_linear(
     int size1D,
     int size2D,
     int size3D,
-    INT16 *table);
+    INT16 *table
+);
 
 extern Imaging
 ImagingCopy2(Imaging imOut, Imaging imIn);
@@ -440,7 +444,8 @@ ImagingDrawArc(
     float end,
     const void *ink,
     int width,
-    int op);
+    int op
+);
 extern int
 ImagingDrawBitmap(Imaging im, int x0, int y0, Imaging bitmap, const void *ink, int op);
 extern int
@@ -455,7 +460,8 @@ ImagingDrawChord(
     const void *ink,
     int fill,
     int width,
-    int op);
+    int op
+);
 extern int
 ImagingDrawEllipse(
     Imaging im,
@@ -466,12 +472,14 @@ ImagingDrawEllipse(
     const void *ink,
     int fill,
     int width,
-    int op);
+    int op
+);
 extern int
 ImagingDrawLine(Imaging im, int x0, int y0, int x1, int y1, const void *ink, int op);
 extern int
 ImagingDrawWideLine(
-    Imaging im, int x0, int y0, int x1, int y1, const void *ink, int width, int op);
+    Imaging im, int x0, int y0, int x1, int y1, const void *ink, int width, int op
+);
 extern int
 ImagingDrawPieslice(
     Imaging im,
@@ -484,12 +492,14 @@ ImagingDrawPieslice(
     const void *ink,
     int fill,
     int width,
-    int op);
+    int op
+);
 extern int
 ImagingDrawPoint(Imaging im, int x, int y, const void *ink, int op);
 extern int
 ImagingDrawPolygon(
-    Imaging im, int points, int *xy, const void *ink, int fill, int width, int op);
+    Imaging im, int points, int *xy, const void *ink, int fill, int width, int op
+);
 extern int
 ImagingDrawRectangle(
     Imaging im,
@@ -500,7 +510,8 @@ ImagingDrawRectangle(
     const void *ink,
     int fill,
     int width,
-    int op);
+    int op
+);
 
 /* Level 2 graphics (WORK IN PROGRESS) */
 extern ImagingOutline
@@ -510,7 +521,8 @@ ImagingOutlineDelete(ImagingOutline outline);
 
 extern int
 ImagingDrawOutline(
-    Imaging im, ImagingOutline outline, const void *ink, int fill, int op);
+    Imaging im, ImagingOutline outline, const void *ink, int fill, int op
+);
 
 extern int
 ImagingOutlineMove(ImagingOutline outline, float x, float y);
@@ -518,7 +530,8 @@ extern int
 ImagingOutlineLine(ImagingOutline outline, float x, float y);
 extern int
 ImagingOutlineCurve(
-    ImagingOutline outline, float x1, float y1, float x2, float y2, float x3, float y3);
+    ImagingOutline outline, float x1, float y1, float x2, float y2, float x3, float y3
+);
 extern int
 ImagingOutlineTransform(ImagingOutline outline, double a[6]);
 
@@ -545,7 +558,8 @@ ImagingSavePPM(Imaging im, const char *filename);
 /* Codecs */
 typedef struct ImagingCodecStateInstance *ImagingCodecState;
 typedef int (*ImagingCodec)(
-    Imaging im, ImagingCodecState state, UINT8 *buffer, int bytes);
+    Imaging im, ImagingCodecState state, UINT8 *buffer, int bytes
+);
 
 extern int
 ImagingBcnDecode(Imaging im, ImagingCodecState state, UINT8 *buffer, Py_ssize_t bytes);
@@ -575,7 +589,8 @@ ImagingJpegEncode(Imaging im, ImagingCodecState state, UINT8 *buffer, int bytes)
 #ifdef HAVE_OPENJPEG
 extern int
 ImagingJpeg2KDecode(
-    Imaging im, ImagingCodecState state, UINT8 *buffer, Py_ssize_t bytes);
+    Imaging im, ImagingCodecState state, UINT8 *buffer, Py_ssize_t bytes
+);
 extern int
 ImagingJpeg2KDecodeCleanup(ImagingCodecState state);
 extern int
@@ -586,7 +601,8 @@ ImagingJpeg2KEncodeCleanup(ImagingCodecState state);
 #ifdef HAVE_LIBTIFF
 extern int
 ImagingLibTiffDecode(
-    Imaging im, ImagingCodecState state, UINT8 *buffer, Py_ssize_t bytes);
+    Imaging im, ImagingCodecState state, UINT8 *buffer, Py_ssize_t bytes
+);
 extern int
 ImagingLibTiffEncode(Imaging im, ImagingCodecState state, UINT8 *buffer, int bytes);
 #endif
@@ -598,7 +614,8 @@ extern int
 ImagingMspDecode(Imaging im, ImagingCodecState state, UINT8 *buffer, Py_ssize_t bytes);
 extern int
 ImagingPackbitsDecode(
-    Imaging im, ImagingCodecState state, UINT8 *buffer, Py_ssize_t bytes);
+    Imaging im, ImagingCodecState state, UINT8 *buffer, Py_ssize_t bytes
+);
 extern int
 ImagingPcdDecode(Imaging im, ImagingCodecState state, UINT8 *buffer, Py_ssize_t bytes);
 extern int
@@ -611,13 +628,16 @@ extern int
 ImagingRawEncode(Imaging im, ImagingCodecState state, UINT8 *buffer, int bytes);
 extern int
 ImagingSgiRleDecode(
-    Imaging im, ImagingCodecState state, UINT8 *buffer, Py_ssize_t bytes);
+    Imaging im, ImagingCodecState state, UINT8 *buffer, Py_ssize_t bytes
+);
 extern int
 ImagingSunRleDecode(
-    Imaging im, ImagingCodecState state, UINT8 *buffer, Py_ssize_t bytes);
+    Imaging im, ImagingCodecState state, UINT8 *buffer, Py_ssize_t bytes
+);
 extern int
 ImagingTgaRleDecode(
-    Imaging im, ImagingCodecState state, UINT8 *buffer, Py_ssize_t bytes);
+    Imaging im, ImagingCodecState state, UINT8 *buffer, Py_ssize_t bytes
+);
 extern int
 ImagingTgaRleEncode(Imaging im, ImagingCodecState state, UINT8 *buffer, int bytes);
 extern int
diff --git a/src/libImaging/Jpeg2KDecode.c b/src/libImaging/Jpeg2KDecode.c
index dd066c10b7a..5b3d7ffc424 100644
--- a/src/libImaging/Jpeg2KDecode.c
+++ b/src/libImaging/Jpeg2KDecode.c
@@ -67,7 +67,8 @@ j2k_skip(OPJ_OFF_T p_nb_bytes, void *p_user_data) {
 /* -------------------------------------------------------------------- */
 
 typedef void (*j2k_unpacker_t)(
-    opj_image_t *in, const JPEG2KTILEINFO *tileInfo, const UINT8 *data, Imaging im);
+    opj_image_t *in, const JPEG2KTILEINFO *tileInfo, const UINT8 *data, Imaging im
+);
 
 struct j2k_decode_unpacker {
     const char *mode;
@@ -89,10 +90,8 @@ j2ku_shift(unsigned x, int n) {
 
 static void
 j2ku_gray_l(
-    opj_image_t *in,
-    const JPEG2KTILEINFO *tileinfo,
-    const UINT8 *tiledata,
-    Imaging im) {
+    opj_image_t *in, const JPEG2KTILEINFO *tileinfo, const UINT8 *tiledata, Imaging im
+) {
     unsigned x0 = tileinfo->x0 - in->x0, y0 = tileinfo->y0 - in->y0;
     unsigned w = tileinfo->x1 - tileinfo->x0;
     unsigned h = tileinfo->y1 - tileinfo->y0;
@@ -145,10 +144,8 @@ j2ku_gray_l(
 
 static void
 j2ku_gray_i(
-    opj_image_t *in,
-    const JPEG2KTILEINFO *tileinfo,
-    const UINT8 *tiledata,
-    Imaging im) {
+    opj_image_t *in, const JPEG2KTILEINFO *tileinfo, const UINT8 *tiledata, Imaging im
+) {
     unsigned x0 = tileinfo->x0 - in->x0, y0 = tileinfo->y0 - in->y0;
     unsigned w = tileinfo->x1 - tileinfo->x0;
     unsigned h = tileinfo->y1 - tileinfo->y0;
@@ -204,10 +201,8 @@ j2ku_gray_i(
 
 static void
 j2ku_gray_rgb(
-    opj_image_t *in,
-    const JPEG2KTILEINFO *tileinfo,
-    const UINT8 *tiledata,
-    Imaging im) {
+    opj_image_t *in, const JPEG2KTILEINFO *tileinfo, const UINT8 *tiledata, Imaging im
+) {
     unsigned x0 = tileinfo->x0 - in->x0, y0 = tileinfo->y0 - in->y0;
     unsigned w = tileinfo->x1 - tileinfo->x0;
     unsigned h = tileinfo->y1 - tileinfo->y0;
@@ -268,10 +263,8 @@ j2ku_gray_rgb(
 
 static void
 j2ku_graya_la(
-    opj_image_t *in,
-    const JPEG2KTILEINFO *tileinfo,
-    const UINT8 *tiledata,
-    Imaging im) {
+    opj_image_t *in, const JPEG2KTILEINFO *tileinfo, const UINT8 *tiledata, Imaging im
+) {
     unsigned x0 = tileinfo->x0 - in->x0, y0 = tileinfo->y0 - in->y0;
     unsigned w = tileinfo->x1 - tileinfo->x0;
     unsigned h = tileinfo->y1 - tileinfo->y0;
@@ -347,10 +340,8 @@ j2ku_graya_la(
 
 static void
 j2ku_srgb_rgb(
-    opj_image_t *in,
-    const JPEG2KTILEINFO *tileinfo,
-    const UINT8 *tiledata,
-    Imaging im) {
+    opj_image_t *in, const JPEG2KTILEINFO *tileinfo, const UINT8 *tiledata, Imaging im
+) {
     unsigned x0 = tileinfo->x0 - in->x0, y0 = tileinfo->y0 - in->y0;
     unsigned w = tileinfo->x1 - tileinfo->x0;
     unsigned h = tileinfo->y1 - tileinfo->y0;
@@ -413,10 +404,8 @@ j2ku_srgb_rgb(
 
 static void
 j2ku_sycc_rgb(
-    opj_image_t *in,
-    const JPEG2KTILEINFO *tileinfo,
-    const UINT8 *tiledata,
-    Imaging im) {
+    opj_image_t *in, const JPEG2KTILEINFO *tileinfo, const UINT8 *tiledata, Imaging im
+) {
     unsigned x0 = tileinfo->x0 - in->x0, y0 = tileinfo->y0 - in->y0;
     unsigned w = tileinfo->x1 - tileinfo->x0;
     unsigned h = tileinfo->y1 - tileinfo->y0;
@@ -482,10 +471,8 @@ j2ku_sycc_rgb(
 
 static void
 j2ku_srgba_rgba(
-    opj_image_t *in,
-    const JPEG2KTILEINFO *tileinfo,
-    const UINT8 *tiledata,
-    Imaging im) {
+    opj_image_t *in, const JPEG2KTILEINFO *tileinfo, const UINT8 *tiledata, Imaging im
+) {
     unsigned x0 = tileinfo->x0 - in->x0, y0 = tileinfo->y0 - in->y0;
     unsigned w = tileinfo->x1 - tileinfo->x0;
     unsigned h = tileinfo->y1 - tileinfo->y0;
@@ -547,10 +534,8 @@ j2ku_srgba_rgba(
 
 static void
 j2ku_sycca_rgba(
-    opj_image_t *in,
-    const JPEG2KTILEINFO *tileinfo,
-    const UINT8 *tiledata,
-    Imaging im) {
+    opj_image_t *in, const JPEG2KTILEINFO *tileinfo, const UINT8 *tiledata, Imaging im
+) {
     unsigned x0 = tileinfo->x0 - in->x0, y0 = tileinfo->y0 - in->y0;
     unsigned w = tileinfo->x1 - tileinfo->x0;
     unsigned h = tileinfo->y1 - tileinfo->y0;
@@ -815,7 +800,8 @@ j2k_decode_entry(Imaging im, ImagingCodecState state) {
                 &tile_info.x1,
                 &tile_info.y1,
                 &tile_info.nb_comps,
-                &should_continue)) {
+                &should_continue
+            )) {
             state->errcode = IMAGING_CODEC_BROKEN;
             state->state = J2K_STATE_FAILED;
             goto quick_exit;
@@ -906,7 +892,8 @@ j2k_decode_entry(Imaging im, ImagingCodecState state) {
                 tile_info.tile_index,
                 (OPJ_BYTE *)state->buffer,
                 tile_info.data_size,
-                stream)) {
+                stream
+            )) {
             state->errcode = IMAGING_CODEC_BROKEN;
             state->state = J2K_STATE_FAILED;
             goto quick_exit;
diff --git a/src/libImaging/Jpeg2KEncode.c b/src/libImaging/Jpeg2KEncode.c
index 7f1aeaddb9b..cb21a186c0b 100644
--- a/src/libImaging/Jpeg2KEncode.c
+++ b/src/libImaging/Jpeg2KEncode.c
@@ -89,7 +89,8 @@ j2k_seek(OPJ_OFF_T p_nb_bytes, void *p_user_data) {
 /* -------------------------------------------------------------------- */
 
 typedef void (*j2k_pack_tile_t)(
-    Imaging im, UINT8 *buf, unsigned x0, unsigned y0, unsigned w, unsigned h);
+    Imaging im, UINT8 *buf, unsigned x0, unsigned y0, unsigned w, unsigned h
+);
 
 static void
 j2k_pack_l(Imaging im, UINT8 *buf, unsigned x0, unsigned y0, unsigned w, unsigned h) {
@@ -157,7 +158,8 @@ j2k_pack_rgb(Imaging im, UINT8 *buf, unsigned x0, unsigned y0, unsigned w, unsig
 
 static void
 j2k_pack_rgba(
-    Imaging im, UINT8 *buf, unsigned x0, unsigned y0, unsigned w, unsigned h) {
+    Imaging im, UINT8 *buf, unsigned x0, unsigned y0, unsigned w, unsigned h
+) {
     UINT8 *pr = buf;
     UINT8 *pg = pr + w * h;
     UINT8 *pb = pg + w * h;
@@ -205,8 +207,8 @@ j2k_set_cinema_params(Imaging im, int components, opj_cparameters_t *params) {
 
     if (params->cp_cinema == OPJ_CINEMA4K_24) {
         float max_rate =
-            ((float)(components * im->xsize * im->ysize * 8) /
-             (CINEMA_24_CS_LENGTH * 8));
+            ((float)(components * im->xsize * im->ysize * 8) / (CINEMA_24_CS_LENGTH * 8)
+            );
 
         params->POC[0].tile = 1;
         params->POC[0].resno0 = 0;
@@ -241,8 +243,8 @@ j2k_set_cinema_params(Imaging im, int components, opj_cparameters_t *params) {
         params->max_comp_size = COMP_24_CS_MAX_LENGTH;
     } else {
         float max_rate =
-            ((float)(components * im->xsize * im->ysize * 8) /
-             (CINEMA_48_CS_LENGTH * 8));
+            ((float)(components * im->xsize * im->ysize * 8) / (CINEMA_48_CS_LENGTH * 8)
+            );
 
         for (n = 0; n < params->tcp_numlayers; ++n) {
             rate = 0;
diff --git a/src/libImaging/JpegDecode.c b/src/libImaging/JpegDecode.c
index 6f75d867068..30c64f23559 100644
--- a/src/libImaging/JpegDecode.c
+++ b/src/libImaging/JpegDecode.c
@@ -206,9 +206,8 @@ ImagingJpegDecode(Imaging im, ImagingCodecState state, UINT8 *buf, Py_ssize_t by
                 context->cinfo.out_color_space = JCS_EXT_RGBX;
             }
 #endif
-            else if (
-                strcmp(context->rawmode, "CMYK") == 0 ||
-                strcmp(context->rawmode, "CMYK;I") == 0) {
+            else if (strcmp(context->rawmode, "CMYK") == 0 ||
+                     strcmp(context->rawmode, "CMYK;I") == 0) {
                 context->cinfo.out_color_space = JCS_CMYK;
             } else if (strcmp(context->rawmode, "YCbCr") == 0) {
                 context->cinfo.out_color_space = JCS_YCbCr;
@@ -256,7 +255,8 @@ ImagingJpegDecode(Imaging im, ImagingCodecState state, UINT8 *buf, Py_ssize_t by
                     (UINT8 *)im->image[state->y + state->yoff] +
                         state->xoff * im->pixelsize,
                     state->buffer,
-                    state->xsize);
+                    state->xsize
+                );
                 state->y++;
             }
             if (ok != 1) {
diff --git a/src/libImaging/JpegEncode.c b/src/libImaging/JpegEncode.c
index ba8353c2d86..4372d51d5c3 100644
--- a/src/libImaging/JpegEncode.c
+++ b/src/libImaging/JpegEncode.c
@@ -175,7 +175,8 @@ ImagingJpegEncode(Imaging im, ImagingCodecState state, UINT8 *buf, int bytes) {
                         i,
                         &context->qtables[i * DCTSIZE2],
                         quality,
-                        FALSE);
+                        FALSE
+                    );
                     context->cinfo.comp_info[i].quant_tbl_no = i;
                     last_q = i;
                 }
@@ -183,7 +184,8 @@ ImagingJpegEncode(Imaging im, ImagingCodecState state, UINT8 *buf, int bytes) {
                     // jpeg_set_defaults created two qtables internally, but we only
                     // wanted one.
                     jpeg_add_quant_table(
-                        &context->cinfo, 1, &context->qtables[0], quality, FALSE);
+                        &context->cinfo, 1, &context->qtables[0], quality, FALSE
+                    );
                 }
                 for (i = last_q; i < context->cinfo.num_components; i++) {
                     context->cinfo.comp_info[i].quant_tbl_no = last_q;
@@ -273,7 +275,8 @@ ImagingJpegEncode(Imaging im, ImagingCodecState state, UINT8 *buf, int bytes) {
                     &context->cinfo,
                     JPEG_APP0 + 1,
                     (unsigned char *)context->rawExif,
-                    context->rawExifLen);
+                    context->rawExifLen
+                );
             }
 
             state->state++;
@@ -289,7 +292,8 @@ ImagingJpegEncode(Imaging im, ImagingCodecState state, UINT8 *buf, int bytes) {
                 memcpy(
                     context->destination.pub.next_output_byte,
                     context->extra + context->extra_offset,
-                    n);
+                    n
+                );
                 context->destination.pub.next_output_byte += n;
                 context->destination.pub.free_in_buffer -= n;
                 context->extra_offset += n;
@@ -309,7 +313,8 @@ ImagingJpegEncode(Imaging im, ImagingCodecState state, UINT8 *buf, int bytes) {
                     &context->cinfo,
                     JPEG_COM,
                     (unsigned char *)context->comment,
-                    context->comment_size);
+                    context->comment_size
+                );
             }
             state->state++;
 
@@ -324,7 +329,8 @@ ImagingJpegEncode(Imaging im, ImagingCodecState state, UINT8 *buf, int bytes) {
                     state->buffer,
                     (UINT8 *)im->image[state->y + state->yoff] +
                         state->xoff * im->pixelsize,
-                    state->xsize);
+                    state->xsize
+                );
                 ok = jpeg_write_scanlines(&context->cinfo, &state->buffer, 1);
                 if (ok != 1) {
                     break;
diff --git a/src/libImaging/PackDecode.c b/src/libImaging/PackDecode.c
index 7dd432b91c2..52f1ac502bd 100644
--- a/src/libImaging/PackDecode.c
+++ b/src/libImaging/PackDecode.c
@@ -17,7 +17,8 @@
 
 int
 ImagingPackbitsDecode(
-    Imaging im, ImagingCodecState state, UINT8 *buf, Py_ssize_t bytes) {
+    Imaging im, ImagingCodecState state, UINT8 *buf, Py_ssize_t bytes
+) {
     UINT8 n;
     UINT8 *ptr;
     int i;
@@ -79,7 +80,8 @@ ImagingPackbitsDecode(
                 (UINT8 *)im->image[state->y + state->yoff] +
                     state->xoff * im->pixelsize,
                 state->buffer,
-                state->xsize);
+                state->xsize
+            );
 
             state->x = 0;
 
diff --git a/src/libImaging/Paste.c b/src/libImaging/Paste.c
index dc67cb41d2f..86085942a2e 100644
--- a/src/libImaging/Paste.c
+++ b/src/libImaging/Paste.c
@@ -33,7 +33,8 @@ paste(
     int sy,
     int xsize,
     int ysize,
-    int pixelsize) {
+    int pixelsize
+) {
     /* paste opaque region */
 
     int y;
@@ -59,7 +60,8 @@ paste_mask_1(
     int sy,
     int xsize,
     int ysize,
-    int pixelsize) {
+    int pixelsize
+) {
     /* paste with mode "1" mask */
 
     int x, y;
@@ -120,7 +122,8 @@ paste_mask_L(
     int sy,
     int xsize,
     int ysize,
-    int pixelsize) {
+    int pixelsize
+) {
     /* paste with mode "L" matte */
 
     int x, y;
@@ -167,7 +170,8 @@ paste_mask_RGBA(
     int sy,
     int xsize,
     int ysize,
-    int pixelsize) {
+    int pixelsize
+) {
     /* paste with mode "RGBA" matte */
 
     int x, y;
@@ -214,7 +218,8 @@ paste_mask_RGBa(
     int sy,
     int xsize,
     int ysize,
-    int pixelsize) {
+    int pixelsize
+) {
     /* paste with mode "RGBa" matte */
 
     int x, y;
@@ -252,7 +257,8 @@ paste_mask_RGBa(
 
 int
 ImagingPaste(
-    Imaging imOut, Imaging imIn, Imaging imMask, int dx0, int dy0, int dx1, int dy1) {
+    Imaging imOut, Imaging imIn, Imaging imMask, int dx0, int dy0, int dx1, int dy1
+) {
     int xsize, ysize;
     int pixelsize;
     int sx0, sy0;
@@ -315,13 +321,15 @@ ImagingPaste(
     } else if (strcmp(imMask->mode, "LA") == 0 || strcmp(imMask->mode, "RGBA") == 0) {
         ImagingSectionEnter(&cookie);
         paste_mask_RGBA(
-            imOut, imIn, imMask, dx0, dy0, sx0, sy0, xsize, ysize, pixelsize);
+            imOut, imIn, imMask, dx0, dy0, sx0, sy0, xsize, ysize, pixelsize
+        );
         ImagingSectionLeave(&cookie);
 
     } else if (strcmp(imMask->mode, "RGBa") == 0) {
         ImagingSectionEnter(&cookie);
         paste_mask_RGBa(
-            imOut, imIn, imMask, dx0, dy0, sx0, sy0, xsize, ysize, pixelsize);
+            imOut, imIn, imMask, dx0, dy0, sx0, sy0, xsize, ysize, pixelsize
+        );
         ImagingSectionLeave(&cookie);
 
     } else {
@@ -334,13 +342,8 @@ ImagingPaste(
 
 static inline void
 fill(
-    Imaging imOut,
-    const void *ink_,
-    int dx,
-    int dy,
-    int xsize,
-    int ysize,
-    int pixelsize) {
+    Imaging imOut, const void *ink_, int dx, int dy, int xsize, int ysize, int pixelsize
+) {
     /* fill opaque region */
 
     int x, y;
@@ -378,7 +381,8 @@ fill_mask_1(
     int sy,
     int xsize,
     int ysize,
-    int pixelsize) {
+    int pixelsize
+) {
     /* fill with mode "1" mask */
 
     int x, y;
@@ -425,7 +429,8 @@ fill_mask_L(
     int sy,
     int xsize,
     int ysize,
-    int pixelsize) {
+    int pixelsize
+) {
     /* fill with mode "L" matte */
 
     int x, y, i;
@@ -484,7 +489,8 @@ fill_mask_RGBA(
     int sy,
     int xsize,
     int ysize,
-    int pixelsize) {
+    int pixelsize
+) {
     /* fill with mode "RGBA" matte */
 
     int x, y, i;
@@ -529,7 +535,8 @@ fill_mask_RGBa(
     int sy,
     int xsize,
     int ysize,
-    int pixelsize) {
+    int pixelsize
+) {
     /* fill with mode "RGBa" matte */
 
     int x, y, i;
@@ -565,13 +572,8 @@ fill_mask_RGBa(
 
 int
 ImagingFill2(
-    Imaging imOut,
-    const void *ink,
-    Imaging imMask,
-    int dx0,
-    int dy0,
-    int dx1,
-    int dy1) {
+    Imaging imOut, const void *ink, Imaging imMask, int dx0, int dy0, int dx1, int dy1
+) {
     ImagingSectionCookie cookie;
     int xsize, ysize;
     int pixelsize;
diff --git a/src/libImaging/PcxDecode.c b/src/libImaging/PcxDecode.c
index c95ffc8692c..942c8dc224d 100644
--- a/src/libImaging/PcxDecode.c
+++ b/src/libImaging/PcxDecode.c
@@ -68,7 +68,8 @@ ImagingPcxDecode(Imaging im, ImagingCodecState state, UINT8 *buf, Py_ssize_t byt
                     memmove(
                         &state->buffer[i * state->xsize],
                         &state->buffer[i * stride],
-                        state->xsize);
+                        state->xsize
+                    );
                 }
             }
             /* Got a full line, unpack it */
@@ -76,7 +77,8 @@ ImagingPcxDecode(Imaging im, ImagingCodecState state, UINT8 *buf, Py_ssize_t byt
                 (UINT8 *)im->image[state->y + state->yoff] +
                     state->xoff * im->pixelsize,
                 state->buffer,
-                state->xsize);
+                state->xsize
+            );
 
             state->x = 0;
 
diff --git a/src/libImaging/PcxEncode.c b/src/libImaging/PcxEncode.c
index 549614bfd39..625cf7ffa72 100644
--- a/src/libImaging/PcxEncode.c
+++ b/src/libImaging/PcxEncode.c
@@ -71,7 +71,8 @@ ImagingPcxEncode(Imaging im, ImagingCodecState state, UINT8 *buf, int bytes) {
                     state->buffer,
                     (UINT8 *)im->image[state->y + state->yoff] +
                         state->xoff * im->pixelsize,
-                    state->xsize);
+                    state->xsize
+                );
 
                 state->y += 1;
 
diff --git a/src/libImaging/Point.c b/src/libImaging/Point.c
index dd06f3940d1..6a4060b4bc1 100644
--- a/src/libImaging/Point.c
+++ b/src/libImaging/Point.c
@@ -197,8 +197,8 @@ ImagingPoint(Imaging imIn, const char *mode, const void *table) {
     return imOut;
 
 mode_mismatch:
-    return (Imaging)ImagingError_ValueError(
-        "point operation not supported for this mode");
+    return (Imaging
+    )ImagingError_ValueError("point operation not supported for this mode");
 }
 
 Imaging
diff --git a/src/libImaging/Quant.c b/src/libImaging/Quant.c
index cdc614536da..197f9f3ee5b 100644
--- a/src/libImaging/Quant.c
+++ b/src/libImaging/Quant.c
@@ -103,7 +103,8 @@ static uint32_t
 pixel_hash(const HashTable *h, const Pixel pixel) {
     PixelHashData *d = (PixelHashData *)hashtable_get_user_data(h);
     return PIXEL_HASH(
-        pixel.c.r >> d->scale, pixel.c.g >> d->scale, pixel.c.b >> d->scale);
+        pixel.c.r >> d->scale, pixel.c.g >> d->scale, pixel.c.b >> d->scale
+    );
 }
 
 static int
@@ -111,9 +112,11 @@ pixel_cmp(const HashTable *h, const Pixel pixel1, const Pixel pixel2) {
     PixelHashData *d = (PixelHashData *)hashtable_get_user_data(h);
     uint32_t A, B;
     A = PIXEL_HASH(
-        pixel1.c.r >> d->scale, pixel1.c.g >> d->scale, pixel1.c.b >> d->scale);
+        pixel1.c.r >> d->scale, pixel1.c.g >> d->scale, pixel1.c.b >> d->scale
+    );
     B = PIXEL_HASH(
-        pixel2.c.r >> d->scale, pixel2.c.g >> d->scale, pixel2.c.b >> d->scale);
+        pixel2.c.r >> d->scale, pixel2.c.g >> d->scale, pixel2.c.b >> d->scale
+    );
     return (A == B) ? 0 : ((A < B) ? -1 : 1);
 }
 
@@ -129,7 +132,8 @@ new_count_func(const HashTable *h, const Pixel key, uint32_t *val) {
 
 static void
 rehash_collide(
-    const HashTable *h, Pixel *keyp, uint32_t *valp, Pixel newkey, uint32_t newval) {
+    const HashTable *h, Pixel *keyp, uint32_t *valp, Pixel newkey, uint32_t newval
+) {
     *valp += newval;
 }
 
@@ -157,7 +161,8 @@ create_pixel_hash(Pixel *pixelData, uint32_t nPixels) {
 #endif
     for (i = 0; i < nPixels; i++) {
         if (!hashtable_insert_or_update_computed(
-                hash, pixelData[i], new_count_func, exists_count_func)) {
+                hash, pixelData[i], new_count_func, exists_count_func
+            )) {
             ;
         }
         while (hashtable_get_count(hash) > MAX_HASH_ENTRIES) {
@@ -335,7 +340,8 @@ splitlists(
     PixelList *nt[2][3],
     uint32_t nCount[2],
     int axis,
-    uint32_t pixelCount) {
+    uint32_t pixelCount
+) {
     uint32_t left;
 
     PixelList *l, *r, *c, *n;
@@ -387,7 +393,8 @@ splitlists(
                     _prevCount[2],
                     _nextCount[0],
                     _nextCount[1],
-                    _nextCount[2]);
+                    _nextCount[2]
+                );
                 exit(1);
             }
         }
@@ -531,12 +538,14 @@ split(BoxNode *node) {
             if (node->tail[_i]->next[_i]) {
                 printf("tail is not tail\n");
                 printf(
-                    "node->tail[%d]->next[%d]=%p\n", _i, _i, node->tail[_i]->next[_i]);
+                    "node->tail[%d]->next[%d]=%p\n", _i, _i, node->tail[_i]->next[_i]
+                );
             }
             if (node->head[_i]->prev[_i]) {
                 printf("head is not head\n");
                 printf(
-                    "node->head[%d]->prev[%d]=%p\n", _i, _i, node->head[_i]->prev[_i]);
+                    "node->head[%d]->prev[%d]=%p\n", _i, _i, node->head[_i]->prev[_i]
+                );
             }
         }
 
@@ -573,14 +582,16 @@ split(BoxNode *node) {
                     _prevCount[2],
                     _nextCount[0],
                     _nextCount[1],
-                    _nextCount[2]);
+                    _nextCount[2]
+                );
             }
         }
     }
 #endif
     node->axis = axis;
     if (!splitlists(
-            node->head, node->tail, heads, tails, newCounts, axis, node->pixelCount)) {
+            node->head, node->tail, heads, tails, newCounts, axis, node->pixelCount
+        )) {
 #ifndef NO_OUTPUT
         printf("list split failed.\n");
 #endif
@@ -772,7 +783,8 @@ _distance_index_cmp(const void *a, const void *b) {
 
 static int
 resort_distance_tables(
-    uint32_t *avgDist, uint32_t **avgDistSortKey, Pixel *p, uint32_t nEntries) {
+    uint32_t *avgDist, uint32_t **avgDistSortKey, Pixel *p, uint32_t nEntries
+) {
     uint32_t i, j, k;
     uint32_t **skRow;
     uint32_t *skElt;
@@ -801,7 +813,8 @@ resort_distance_tables(
 
 static int
 build_distance_tables(
-    uint32_t *avgDist, uint32_t **avgDistSortKey, Pixel *p, uint32_t nEntries) {
+    uint32_t *avgDist, uint32_t **avgDistSortKey, Pixel *p, uint32_t nEntries
+) {
     uint32_t i, j;
     DistanceWithIndex *dwi;
 
@@ -841,7 +854,8 @@ map_image_pixels(
     uint32_t nPaletteEntries,
     uint32_t *avgDist,
     uint32_t **avgDistSortKey,
-    uint32_t *pixelArray) {
+    uint32_t *pixelArray
+) {
     uint32_t *aD, **aDSK;
     uint32_t idx;
     uint32_t i, j;
@@ -888,7 +902,8 @@ map_image_pixels_from_quantized_pixels(
     uint32_t **avgDistSortKey,
     uint32_t *pixelArray,
     uint32_t *avg[3],
-    uint32_t *count) {
+    uint32_t *count
+) {
     uint32_t *aD, **aDSK;
     uint32_t idx;
     uint32_t i, j;
@@ -946,7 +961,8 @@ map_image_pixels_from_median_box(
     HashTable *medianBoxHash,
     uint32_t *avgDist,
     uint32_t **avgDistSortKey,
-    uint32_t *pixelArray) {
+    uint32_t *pixelArray
+) {
     uint32_t *aD, **aDSK;
     uint32_t idx;
     uint32_t i, j;
@@ -998,7 +1014,8 @@ compute_palette_from_median_cut(
     uint32_t nPixels,
     HashTable *medianBoxHash,
     Pixel **palette,
-    uint32_t nPaletteEntries) {
+    uint32_t nPaletteEntries
+) {
     uint32_t i;
     uint32_t paletteEntry;
     Pixel *p;
@@ -1055,7 +1072,8 @@ compute_palette_from_median_cut(
             printf(
                 "panic - paletteEntry>=nPaletteEntries (%d>=%d)\n",
                 (int)paletteEntry,
-                (int)nPaletteEntries);
+                (int)nPaletteEntries
+            );
 #endif
             for (i = 0; i < 3; i++) {
                 free(avg[i]);
@@ -1092,7 +1110,8 @@ compute_palette_from_median_cut(
 
 static int
 recompute_palette_from_averages(
-    Pixel *palette, uint32_t nPaletteEntries, uint32_t *avg[3], uint32_t *count) {
+    Pixel *palette, uint32_t nPaletteEntries, uint32_t *avg[3], uint32_t *count
+) {
     uint32_t i;
 
     for (i = 0; i < nPaletteEntries; i++) {
@@ -1111,7 +1130,8 @@ compute_palette_from_quantized_pixels(
     uint32_t nPaletteEntries,
     uint32_t *avg[3],
     uint32_t *count,
-    uint32_t *qp) {
+    uint32_t *qp
+) {
     uint32_t i;
 
     memset(count, 0, sizeof(uint32_t) * nPaletteEntries);
@@ -1145,7 +1165,8 @@ k_means(
     Pixel *paletteData,
     uint32_t nPaletteEntries,
     uint32_t *qp,
-    int threshold) {
+    int threshold
+) {
     uint32_t *avg[3];
     uint32_t *count;
     uint32_t i;
@@ -1194,16 +1215,19 @@ k_means(
     while (1) {
         if (!built) {
             compute_palette_from_quantized_pixels(
-                pixelData, nPixels, paletteData, nPaletteEntries, avg, count, qp);
+                pixelData, nPixels, paletteData, nPaletteEntries, avg, count, qp
+            );
             if (!build_distance_tables(
-                    avgDist, avgDistSortKey, paletteData, nPaletteEntries)) {
+                    avgDist, avgDistSortKey, paletteData, nPaletteEntries
+                )) {
                 goto error_3;
             }
             built = 1;
         } else {
             recompute_palette_from_averages(paletteData, nPaletteEntries, avg, count);
             resort_distance_tables(
-                avgDist, avgDistSortKey, paletteData, nPaletteEntries);
+                avgDist, avgDistSortKey, paletteData, nPaletteEntries
+            );
         }
         changes = map_image_pixels_from_quantized_pixels(
             pixelData,
@@ -1214,7 +1238,8 @@ k_means(
             avgDistSortKey,
             qp,
             avg,
-            count);
+            count
+        );
         if (changes < 0) {
             goto error_3;
         }
@@ -1273,7 +1298,8 @@ quantize(
     Pixel **palette,
     uint32_t *paletteLength,
     uint32_t **quantizedPixels,
-    int kmeans) {
+    int kmeans
+) {
     PixelList *hl[3];
     HashTable *h;
     BoxNode *root;
@@ -1399,7 +1425,8 @@ quantize(
     }
 
     if (!map_image_pixels_from_median_box(
-            pixelData, nPixels, p, nPaletteEntries, h, avgDist, avgDistSortKey, qp)) {
+            pixelData, nPixels, p, nPaletteEntries, h, avgDist, avgDistSortKey, qp
+        )) {
         goto error_7;
     }
 
@@ -1445,7 +1472,8 @@ quantize(
                                   _SQR(pixelData[i].c.b - p[qp[i]].c.b))),
                     sqrt((double)(_SQR(pixelData[i].c.r - p[bestmatch].c.r) +
                                   _SQR(pixelData[i].c.g - p[bestmatch].c.g) +
-                                  _SQR(pixelData[i].c.b - p[bestmatch].c.b))));
+                                  _SQR(pixelData[i].c.b - p[bestmatch].c.b)))
+                );
             }
         }
         hashtable_free(h2);
@@ -1545,7 +1573,8 @@ quantize2(
     Pixel **palette,
     uint32_t *paletteLength,
     uint32_t **quantizedPixels,
-    int kmeans) {
+    int kmeans
+) {
     HashTable *h;
     uint32_t i;
     uint32_t mean[3];
@@ -1609,7 +1638,8 @@ quantize2(
     }
 
     if (!map_image_pixels(
-            pixelData, nPixels, p, nQuantPixels, avgDist, avgDistSortKey, qp)) {
+            pixelData, nPixels, p, nQuantPixels, avgDist, avgDistSortKey, qp
+        )) {
         goto error_4;
     }
     if (kmeans > 0) {
@@ -1752,7 +1782,8 @@ ImagingQuantize(Imaging im, int colors, int mode, int kmeans) {
                 &palette,
                 &paletteLength,
                 &newData,
-                kmeans);
+                kmeans
+            );
             break;
         case 1:
             /* maximum coverage */
@@ -1763,7 +1794,8 @@ ImagingQuantize(Imaging im, int colors, int mode, int kmeans) {
                 &palette,
                 &paletteLength,
                 &newData,
-                kmeans);
+                kmeans
+            );
             break;
         case 2:
             result = quantize_octree(
@@ -1773,7 +1805,8 @@ ImagingQuantize(Imaging im, int colors, int mode, int kmeans) {
                 &palette,
                 &paletteLength,
                 &newData,
-                withAlpha);
+                withAlpha
+            );
             break;
         case 3:
 #ifdef HAVE_LIBIMAGEQUANT
@@ -1785,7 +1818,8 @@ ImagingQuantize(Imaging im, int colors, int mode, int kmeans) {
                 &palette,
                 &paletteLength,
                 &newData,
-                withAlpha);
+                withAlpha
+            );
 #else
             result = -1;
 #endif
@@ -1836,7 +1870,8 @@ ImagingQuantize(Imaging im, int colors, int mode, int kmeans) {
         if (result == -1) {
             return (Imaging)ImagingError_ValueError(
                 "dependency required by this method was not "
-                "enabled at compile time");
+                "enabled at compile time"
+            );
         }
 
         return (Imaging)ImagingError_ValueError("quantization error");
diff --git a/src/libImaging/QuantHash.c b/src/libImaging/QuantHash.c
index ea75d6037f9..bf2f29fde85 100644
--- a/src/libImaging/QuantHash.c
+++ b/src/libImaging/QuantHash.c
@@ -132,7 +132,8 @@ _hashtable_resize(HashTable *h) {
 
 static int
 _hashtable_insert_node(
-    HashTable *h, HashNode *node, int resize, int update, CollisionFunc cf) {
+    HashTable *h, HashNode *node, int resize, int update, CollisionFunc cf
+) {
     uint32_t hash = h->hashFunc(h, node->key) % h->length;
     HashNode **n, *nv;
     int i;
@@ -207,7 +208,8 @@ _hashtable_insert(HashTable *h, HashKey_t key, HashVal_t val, int resize, int up
 
 int
 hashtable_insert_or_update_computed(
-    HashTable *h, HashKey_t key, ComputeFunc newFunc, ComputeFunc existsFunc) {
+    HashTable *h, HashKey_t key, ComputeFunc newFunc, ComputeFunc existsFunc
+) {
     HashNode **n, *nv;
     HashNode *t;
     int i;
diff --git a/src/libImaging/QuantHash.h b/src/libImaging/QuantHash.h
index fc1a9900376..0462cfd4968 100644
--- a/src/libImaging/QuantHash.h
+++ b/src/libImaging/QuantHash.h
@@ -20,13 +20,12 @@ typedef uint32_t HashVal_t;
 
 typedef uint32_t (*HashFunc)(const HashTable *, const HashKey_t);
 typedef int (*HashCmpFunc)(const HashTable *, const HashKey_t, const HashKey_t);
-typedef void (*IteratorFunc)(
-    const HashTable *, const HashKey_t, const HashVal_t, void *);
-typedef void (*IteratorUpdateFunc)(
-    const HashTable *, const HashKey_t, HashVal_t *, void *);
+typedef void (*IteratorFunc)(const HashTable *, const HashKey_t, const HashVal_t, void *);
+typedef void (*IteratorUpdateFunc)(const HashTable *, const HashKey_t, HashVal_t *, void *);
 typedef void (*ComputeFunc)(const HashTable *, const HashKey_t, HashVal_t *);
 typedef void (*CollisionFunc)(
-    const HashTable *, HashKey_t *, HashVal_t *, HashKey_t, HashVal_t);
+    const HashTable *, HashKey_t *, HashVal_t *, HashKey_t, HashVal_t
+);
 
 HashTable *
 hashtable_new(HashFunc hf, HashCmpFunc cf);
@@ -42,7 +41,8 @@ int
 hashtable_lookup(const HashTable *h, const HashKey_t key, HashVal_t *valp);
 int
 hashtable_insert_or_update_computed(
-    HashTable *h, HashKey_t key, ComputeFunc newFunc, ComputeFunc existsFunc);
+    HashTable *h, HashKey_t key, ComputeFunc newFunc, ComputeFunc existsFunc
+);
 void *
 hashtable_set_user_data(HashTable *h, void *data);
 void *
diff --git a/src/libImaging/QuantOctree.c b/src/libImaging/QuantOctree.c
index 1331a30ad45..7e02ebf65bc 100644
--- a/src/libImaging/QuantOctree.c
+++ b/src/libImaging/QuantOctree.c
@@ -107,11 +107,8 @@ free_color_cube(ColorCube cube) {
 
 static long
 color_bucket_offset_pos(
-    const ColorCube cube,
-    unsigned int r,
-    unsigned int g,
-    unsigned int b,
-    unsigned int a) {
+    const ColorCube cube, unsigned int r, unsigned int g, unsigned int b, unsigned int a
+) {
     return r << cube->rOffset | g << cube->gOffset | b << cube->bOffset |
            a << cube->aOffset;
 }
@@ -191,7 +188,8 @@ create_sorted_color_palette(const ColorCube cube) {
         buckets,
         cube->size,
         sizeof(struct _ColorBucket),
-        (int (*)(void const *, void const *)) & compare_bucket_count);
+        (int (*)(void const *, void const *)) & compare_bucket_count
+    );
 
     return buckets;
 }
@@ -212,7 +210,8 @@ copy_color_cube(
     unsigned int rBits,
     unsigned int gBits,
     unsigned int bBits,
-    unsigned int aBits) {
+    unsigned int aBits
+) {
     unsigned int r, g, b, a;
     long src_pos, dst_pos;
     unsigned int src_reduce[4] = {0}, dst_reduce[4] = {0};
@@ -262,15 +261,18 @@ copy_color_cube(
                         r >> src_reduce[0],
                         g >> src_reduce[1],
                         b >> src_reduce[2],
-                        a >> src_reduce[3]);
+                        a >> src_reduce[3]
+                    );
                     dst_pos = color_bucket_offset_pos(
                         result,
                         r >> dst_reduce[0],
                         g >> dst_reduce[1],
                         b >> dst_reduce[2],
-                        a >> dst_reduce[3]);
+                        a >> dst_reduce[3]
+                    );
                     add_bucket_values(
-                        &cube->buckets[src_pos], &result->buckets[dst_pos]);
+                        &cube->buckets[src_pos], &result->buckets[dst_pos]
+                    );
                 }
             }
         }
@@ -328,7 +330,8 @@ combined_palette(
     ColorBucket bucketsA,
     unsigned long nBucketsA,
     ColorBucket bucketsB,
-    unsigned long nBucketsB) {
+    unsigned long nBucketsB
+) {
     ColorBucket result;
     if (nBucketsA > LONG_MAX - nBucketsB ||
         (nBucketsA + nBucketsB) > LONG_MAX / sizeof(struct _ColorBucket)) {
@@ -366,7 +369,8 @@ map_image_pixels(
     const Pixel *pixelData,
     uint32_t nPixels,
     const ColorCube lookupCube,
-    uint32_t *pixelArray) {
+    uint32_t *pixelArray
+) {
     long i;
     for (i = 0; i < nPixels; i++) {
         pixelArray[i] = lookup_color(lookupCube, &pixelData[i]);
@@ -384,7 +388,8 @@ quantize_octree(
     Pixel **palette,
     uint32_t *paletteLength,
     uint32_t **quantizedPixels,
-    int withAlpha) {
+    int withAlpha
+) {
     ColorCube fineCube = NULL;
     ColorCube coarseCube = NULL;
     ColorCube lookupCube = NULL;
@@ -461,7 +466,8 @@ quantize_octree(
         subtract_color_buckets(
             coarseCube,
             &paletteBucketsFine[nAlreadySubtracted],
-            nFineColors - nAlreadySubtracted);
+            nFineColors - nAlreadySubtracted
+        );
     }
 
     /* create our palette buckets with fine and coarse combined */
@@ -470,7 +476,8 @@ quantize_octree(
         goto error;
     }
     paletteBuckets = combined_palette(
-        paletteBucketsCoarse, nCoarseColors, paletteBucketsFine, nFineColors);
+        paletteBucketsCoarse, nCoarseColors, paletteBucketsFine, nFineColors
+    );
 
     free(paletteBucketsFine);
     paletteBucketsFine = NULL;
@@ -491,7 +498,8 @@ quantize_octree(
     /* expand coarse cube (64) to larger fine cube (4k). the value of each
        coarse bucket is then present in the according 64 fine buckets. */
     lookupCube = copy_color_cube(
-        coarseLookupCube, cubeBits[0], cubeBits[1], cubeBits[2], cubeBits[3]);
+        coarseLookupCube, cubeBits[0], cubeBits[1], cubeBits[2], cubeBits[3]
+    );
     if (!lookupCube) {
         goto error;
     }
diff --git a/src/libImaging/QuantPngQuant.c b/src/libImaging/QuantPngQuant.c
index 7a36300e408..a2258c3a289 100644
--- a/src/libImaging/QuantPngQuant.c
+++ b/src/libImaging/QuantPngQuant.c
@@ -26,7 +26,8 @@ quantize_pngquant(
     Pixel **palette,
     uint32_t *paletteLength,
     uint32_t **quantizedPixels,
-    int withAlpha) {
+    int withAlpha
+) {
     int result = 0;
     liq_image *image = NULL;
     liq_attr *attr = NULL;
diff --git a/src/libImaging/QuantPngQuant.h b/src/libImaging/QuantPngQuant.h
index d65e42590ca..ae96a52f371 100644
--- a/src/libImaging/QuantPngQuant.h
+++ b/src/libImaging/QuantPngQuant.h
@@ -12,6 +12,7 @@ quantize_pngquant(
     Pixel **,
     uint32_t *,
     uint32_t **,
-    int);
+    int
+);
 
 #endif
diff --git a/src/libImaging/RankFilter.c b/src/libImaging/RankFilter.c
index 73a6baecbb2..899b1fd3a29 100644
--- a/src/libImaging/RankFilter.c
+++ b/src/libImaging/RankFilter.c
@@ -102,7 +102,8 @@ MakeRankFunction(UINT8) MakeRankFunction(INT32) MakeRankFunction(FLOAT32)
                     memcpy(                                                       \
                         buf + i * size,                                           \
                         &IMAGING_PIXEL_##type(im, x, y + i),                      \
-                        size * sizeof(type));                                     \
+                        size * sizeof(type)                                       \
+                    );                                                            \
                 }                                                                 \
                 IMAGING_PIXEL_##type(imOut, x, y) = Rank##type(buf, size2, rank); \
             }                                                                     \
diff --git a/src/libImaging/RawDecode.c b/src/libImaging/RawDecode.c
index 24abe48041f..80ed0d6880a 100644
--- a/src/libImaging/RawDecode.c
+++ b/src/libImaging/RawDecode.c
@@ -74,7 +74,8 @@ ImagingRawDecode(Imaging im, ImagingCodecState state, UINT8 *buf, Py_ssize_t byt
         state->shuffle(
             (UINT8 *)im->image[state->y + state->yoff] + state->xoff * im->pixelsize,
             ptr,
-            state->xsize);
+            state->xsize
+        );
 
         ptr += state->bytes;
         bytes -= state->bytes;
diff --git a/src/libImaging/RawEncode.c b/src/libImaging/RawEncode.c
index 50de8d98275..5e60e1106b9 100644
--- a/src/libImaging/RawEncode.c
+++ b/src/libImaging/RawEncode.c
@@ -65,7 +65,8 @@ ImagingRawEncode(Imaging im, ImagingCodecState state, UINT8 *buf, int bytes) {
         state->shuffle(
             ptr,
             (UINT8 *)im->image[state->y + state->yoff] + state->xoff * im->pixelsize,
-            state->xsize);
+            state->xsize
+        );
 
         if (state->bytes > state->count) {
             /* zero-pad the buffer, if necessary */
diff --git a/src/libImaging/Reduce.c b/src/libImaging/Reduce.c
index 61566f0c506..022daa0003f 100644
--- a/src/libImaging/Reduce.c
+++ b/src/libImaging/Reduce.c
@@ -82,7 +82,8 @@ ImagingReduceNxN(Imaging imOut, Imaging imIn, int box[4], int xscale, int yscale
                         }
                     }
                     v = MAKE_UINT32(
-                        (ss0 * multiplier) >> 24, 0, 0, (ss3 * multiplier) >> 24);
+                        (ss0 * multiplier) >> 24, 0, 0, (ss3 * multiplier) >> 24
+                    );
                     memcpy(imOut->image[y] + x * sizeof(v), &v, sizeof(v));
                 }
             } else if (imIn->bands == 3) {
@@ -124,7 +125,8 @@ ImagingReduceNxN(Imaging imOut, Imaging imIn, int box[4], int xscale, int yscale
                         (ss0 * multiplier) >> 24,
                         (ss1 * multiplier) >> 24,
                         (ss2 * multiplier) >> 24,
-                        0);
+                        0
+                    );
                     memcpy(imOut->image[y] + x * sizeof(v), &v, sizeof(v));
                 }
             } else {  // bands == 4
@@ -171,7 +173,8 @@ ImagingReduceNxN(Imaging imOut, Imaging imIn, int box[4], int xscale, int yscale
                         (ss0 * multiplier) >> 24,
                         (ss1 * multiplier) >> 24,
                         (ss2 * multiplier) >> 24,
-                        (ss3 * multiplier) >> 24);
+                        (ss3 * multiplier) >> 24
+                    );
                     memcpy(imOut->image[y] + x * sizeof(v), &v, sizeof(v));
                 }
             }
@@ -226,7 +229,8 @@ ImagingReduce1xN(Imaging imOut, Imaging imIn, int box[4], int yscale) {
                         ss3 += line[xx * 4 + 3];
                     }
                     v = MAKE_UINT32(
-                        (ss0 * multiplier) >> 24, 0, 0, (ss3 * multiplier) >> 24);
+                        (ss0 * multiplier) >> 24, 0, 0, (ss3 * multiplier) >> 24
+                    );
                     memcpy(imOut->image[y] + x * sizeof(v), &v, sizeof(v));
                 }
             } else if (imIn->bands == 3) {
@@ -251,7 +255,8 @@ ImagingReduce1xN(Imaging imOut, Imaging imIn, int box[4], int yscale) {
                         (ss0 * multiplier) >> 24,
                         (ss1 * multiplier) >> 24,
                         (ss2 * multiplier) >> 24,
-                        0);
+                        0
+                    );
                     memcpy(imOut->image[y] + x * sizeof(v), &v, sizeof(v));
                 }
             } else {  // bands == 4
@@ -278,7 +283,8 @@ ImagingReduce1xN(Imaging imOut, Imaging imIn, int box[4], int yscale) {
                         (ss0 * multiplier) >> 24,
                         (ss1 * multiplier) >> 24,
                         (ss2 * multiplier) >> 24,
-                        (ss3 * multiplier) >> 24);
+                        (ss3 * multiplier) >> 24
+                    );
                     memcpy(imOut->image[y] + x * sizeof(v), &v, sizeof(v));
                 }
             }
@@ -329,7 +335,8 @@ ImagingReduceNx1(Imaging imOut, Imaging imIn, int box[4], int xscale) {
                         ss3 += line[xx * 4 + 3];
                     }
                     v = MAKE_UINT32(
-                        (ss0 * multiplier) >> 24, 0, 0, (ss3 * multiplier) >> 24);
+                        (ss0 * multiplier) >> 24, 0, 0, (ss3 * multiplier) >> 24
+                    );
                     memcpy(imOut->image[y] + x * sizeof(v), &v, sizeof(v));
                 }
             } else if (imIn->bands == 3) {
@@ -351,7 +358,8 @@ ImagingReduceNx1(Imaging imOut, Imaging imIn, int box[4], int xscale) {
                         (ss0 * multiplier) >> 24,
                         (ss1 * multiplier) >> 24,
                         (ss2 * multiplier) >> 24,
-                        0);
+                        0
+                    );
                     memcpy(imOut->image[y] + x * sizeof(v), &v, sizeof(v));
                 }
             } else {  // bands == 4
@@ -375,7 +383,8 @@ ImagingReduceNx1(Imaging imOut, Imaging imIn, int box[4], int xscale) {
                         (ss0 * multiplier) >> 24,
                         (ss1 * multiplier) >> 24,
                         (ss2 * multiplier) >> 24,
-                        (ss3 * multiplier) >> 24);
+                        (ss3 * multiplier) >> 24
+                    );
                     memcpy(imOut->image[y] + x * sizeof(v), &v, sizeof(v));
                 }
             }
@@ -425,7 +434,8 @@ ImagingReduce1x2(Imaging imOut, Imaging imIn, int box[4]) {
                     ss1 = line0[xx * 4 + 1] + line1[xx * 4 + 1];
                     ss2 = line0[xx * 4 + 2] + line1[xx * 4 + 2];
                     v = MAKE_UINT32(
-                        (ss0 + amend) >> 1, (ss1 + amend) >> 1, (ss2 + amend) >> 1, 0);
+                        (ss0 + amend) >> 1, (ss1 + amend) >> 1, (ss2 + amend) >> 1, 0
+                    );
                     memcpy(imOut->image[y] + x * sizeof(v), &v, sizeof(v));
                 }
             } else {  // bands == 4
@@ -440,7 +450,8 @@ ImagingReduce1x2(Imaging imOut, Imaging imIn, int box[4]) {
                         (ss0 + amend) >> 1,
                         (ss1 + amend) >> 1,
                         (ss2 + amend) >> 1,
-                        (ss3 + amend) >> 1);
+                        (ss3 + amend) >> 1
+                    );
                     memcpy(imOut->image[y] + x * sizeof(v), &v, sizeof(v));
                 }
             }
@@ -488,7 +499,8 @@ ImagingReduce2x1(Imaging imOut, Imaging imIn, int box[4]) {
                     ss1 = line0[xx * 4 + 1] + line0[xx * 4 + 5];
                     ss2 = line0[xx * 4 + 2] + line0[xx * 4 + 6];
                     v = MAKE_UINT32(
-                        (ss0 + amend) >> 1, (ss1 + amend) >> 1, (ss2 + amend) >> 1, 0);
+                        (ss0 + amend) >> 1, (ss1 + amend) >> 1, (ss2 + amend) >> 1, 0
+                    );
                     memcpy(imOut->image[y] + x * sizeof(v), &v, sizeof(v));
                 }
             } else {  // bands == 4
@@ -503,7 +515,8 @@ ImagingReduce2x1(Imaging imOut, Imaging imIn, int box[4]) {
                         (ss0 + amend) >> 1,
                         (ss1 + amend) >> 1,
                         (ss2 + amend) >> 1,
-                        (ss3 + amend) >> 1);
+                        (ss3 + amend) >> 1
+                    );
                     memcpy(imOut->image[y] + x * sizeof(v), &v, sizeof(v));
                 }
             }
@@ -558,7 +571,8 @@ ImagingReduce2x2(Imaging imOut, Imaging imIn, int box[4]) {
                     ss2 = line0[xx * 4 + 2] + line0[xx * 4 + 6] + line1[xx * 4 + 2] +
                           line1[xx * 4 + 6];
                     v = MAKE_UINT32(
-                        (ss0 + amend) >> 2, (ss1 + amend) >> 2, (ss2 + amend) >> 2, 0);
+                        (ss0 + amend) >> 2, (ss1 + amend) >> 2, (ss2 + amend) >> 2, 0
+                    );
                     memcpy(imOut->image[y] + x * sizeof(v), &v, sizeof(v));
                 }
             } else {  // bands == 4
@@ -577,7 +591,8 @@ ImagingReduce2x2(Imaging imOut, Imaging imIn, int box[4]) {
                         (ss0 + amend) >> 2,
                         (ss1 + amend) >> 2,
                         (ss2 + amend) >> 2,
-                        (ss3 + amend) >> 2);
+                        (ss3 + amend) >> 2
+                    );
                     memcpy(imOut->image[y] + x * sizeof(v), &v, sizeof(v));
                 }
             }
@@ -623,7 +638,8 @@ ImagingReduce1x3(Imaging imOut, Imaging imIn, int box[4]) {
                         ((ss0 + amend) * multiplier) >> 24,
                         0,
                         0,
-                        ((ss3 + amend) * multiplier) >> 24);
+                        ((ss3 + amend) * multiplier) >> 24
+                    );
                     memcpy(imOut->image[y] + x * sizeof(v), &v, sizeof(v));
                 }
             } else if (imIn->bands == 3) {
@@ -637,7 +653,8 @@ ImagingReduce1x3(Imaging imOut, Imaging imIn, int box[4]) {
                         ((ss0 + amend) * multiplier) >> 24,
                         ((ss1 + amend) * multiplier) >> 24,
                         ((ss2 + amend) * multiplier) >> 24,
-                        0);
+                        0
+                    );
                     memcpy(imOut->image[y] + x * sizeof(v), &v, sizeof(v));
                 }
             } else {  // bands == 4
@@ -652,7 +669,8 @@ ImagingReduce1x3(Imaging imOut, Imaging imIn, int box[4]) {
                         ((ss0 + amend) * multiplier) >> 24,
                         ((ss1 + amend) * multiplier) >> 24,
                         ((ss2 + amend) * multiplier) >> 24,
-                        ((ss3 + amend) * multiplier) >> 24);
+                        ((ss3 + amend) * multiplier) >> 24
+                    );
                     memcpy(imOut->image[y] + x * sizeof(v), &v, sizeof(v));
                 }
             }
@@ -694,7 +712,8 @@ ImagingReduce3x1(Imaging imOut, Imaging imIn, int box[4]) {
                         ((ss0 + amend) * multiplier) >> 24,
                         0,
                         0,
-                        ((ss3 + amend) * multiplier) >> 24);
+                        ((ss3 + amend) * multiplier) >> 24
+                    );
                     memcpy(imOut->image[y] + x * sizeof(v), &v, sizeof(v));
                 }
             } else if (imIn->bands == 3) {
@@ -708,7 +727,8 @@ ImagingReduce3x1(Imaging imOut, Imaging imIn, int box[4]) {
                         ((ss0 + amend) * multiplier) >> 24,
                         ((ss1 + amend) * multiplier) >> 24,
                         ((ss2 + amend) * multiplier) >> 24,
-                        0);
+                        0
+                    );
                     memcpy(imOut->image[y] + x * sizeof(v), &v, sizeof(v));
                 }
             } else {  // bands == 4
@@ -723,7 +743,8 @@ ImagingReduce3x1(Imaging imOut, Imaging imIn, int box[4]) {
                         ((ss0 + amend) * multiplier) >> 24,
                         ((ss1 + amend) * multiplier) >> 24,
                         ((ss2 + amend) * multiplier) >> 24,
-                        ((ss3 + amend) * multiplier) >> 24);
+                        ((ss3 + amend) * multiplier) >> 24
+                    );
                     memcpy(imOut->image[y] + x * sizeof(v), &v, sizeof(v));
                 }
             }
@@ -775,7 +796,8 @@ ImagingReduce3x3(Imaging imOut, Imaging imIn, int box[4]) {
                         ((ss0 + amend) * multiplier) >> 24,
                         0,
                         0,
-                        ((ss3 + amend) * multiplier) >> 24);
+                        ((ss3 + amend) * multiplier) >> 24
+                    );
                     memcpy(imOut->image[y] + x * sizeof(v), &v, sizeof(v));
                 }
             } else if (imIn->bands == 3) {
@@ -795,7 +817,8 @@ ImagingReduce3x3(Imaging imOut, Imaging imIn, int box[4]) {
                         ((ss0 + amend) * multiplier) >> 24,
                         ((ss1 + amend) * multiplier) >> 24,
                         ((ss2 + amend) * multiplier) >> 24,
-                        0);
+                        0
+                    );
                     memcpy(imOut->image[y] + x * sizeof(v), &v, sizeof(v));
                 }
             } else {  // bands == 4
@@ -818,7 +841,8 @@ ImagingReduce3x3(Imaging imOut, Imaging imIn, int box[4]) {
                         ((ss0 + amend) * multiplier) >> 24,
                         ((ss1 + amend) * multiplier) >> 24,
                         ((ss2 + amend) * multiplier) >> 24,
-                        ((ss3 + amend) * multiplier) >> 24);
+                        ((ss3 + amend) * multiplier) >> 24
+                    );
                     memcpy(imOut->image[y] + x * sizeof(v), &v, sizeof(v));
                 }
             }
@@ -900,7 +924,8 @@ ImagingReduce4x4(Imaging imOut, Imaging imIn, int box[4]) {
                           line3[xx * 4 + 2] + line3[xx * 4 + 6] + line3[xx * 4 + 10] +
                           line3[xx * 4 + 14];
                     v = MAKE_UINT32(
-                        (ss0 + amend) >> 4, (ss1 + amend) >> 4, (ss2 + amend) >> 4, 0);
+                        (ss0 + amend) >> 4, (ss1 + amend) >> 4, (ss2 + amend) >> 4, 0
+                    );
                     memcpy(imOut->image[y] + x * sizeof(v), &v, sizeof(v));
                 }
             } else {  // bands == 4
@@ -935,7 +960,8 @@ ImagingReduce4x4(Imaging imOut, Imaging imIn, int box[4]) {
                         (ss0 + amend) >> 4,
                         (ss1 + amend) >> 4,
                         (ss2 + amend) >> 4,
-                        (ss3 + amend) >> 4);
+                        (ss3 + amend) >> 4
+                    );
                     memcpy(imOut->image[y] + x * sizeof(v), &v, sizeof(v));
                 }
             }
@@ -1007,7 +1033,8 @@ ImagingReduce5x5(Imaging imOut, Imaging imIn, int box[4]) {
                         ((ss0 + amend) * multiplier) >> 24,
                         0,
                         0,
-                        ((ss3 + amend) * multiplier) >> 24);
+                        ((ss3 + amend) * multiplier) >> 24
+                    );
                     memcpy(imOut->image[y] + x * sizeof(v), &v, sizeof(v));
                 }
             } else if (imIn->bands == 3) {
@@ -1045,7 +1072,8 @@ ImagingReduce5x5(Imaging imOut, Imaging imIn, int box[4]) {
                         ((ss0 + amend) * multiplier) >> 24,
                         ((ss1 + amend) * multiplier) >> 24,
                         ((ss2 + amend) * multiplier) >> 24,
-                        0);
+                        0
+                    );
                     memcpy(imOut->image[y] + x * sizeof(v), &v, sizeof(v));
                 }
             } else {  // bands == 4
@@ -1092,7 +1120,8 @@ ImagingReduce5x5(Imaging imOut, Imaging imIn, int box[4]) {
                         ((ss0 + amend) * multiplier) >> 24,
                         ((ss1 + amend) * multiplier) >> 24,
                         ((ss2 + amend) * multiplier) >> 24,
-                        ((ss3 + amend) * multiplier) >> 24);
+                        ((ss3 + amend) * multiplier) >> 24
+                    );
                     memcpy(imOut->image[y] + x * sizeof(v), &v, sizeof(v));
                 }
             }
@@ -1181,7 +1210,8 @@ ImagingReduceCorners(Imaging imOut, Imaging imIn, int box[4], int xscale, int ys
                     (ss0 * multiplier) >> 24,
                     (ss1 * multiplier) >> 24,
                     (ss2 * multiplier) >> 24,
-                    (ss3 * multiplier) >> 24);
+                    (ss3 * multiplier) >> 24
+                );
                 memcpy(imOut->image[y] + x * sizeof(v), &v, sizeof(v));
             }
         }
@@ -1207,7 +1237,8 @@ ImagingReduceCorners(Imaging imOut, Imaging imIn, int box[4], int xscale, int ys
                     (ss0 * multiplier) >> 24,
                     (ss1 * multiplier) >> 24,
                     (ss2 * multiplier) >> 24,
-                    (ss3 * multiplier) >> 24);
+                    (ss3 * multiplier) >> 24
+                );
                 memcpy(imOut->image[y] + x * sizeof(v), &v, sizeof(v));
             }
         }
@@ -1232,7 +1263,8 @@ ImagingReduceCorners(Imaging imOut, Imaging imIn, int box[4], int xscale, int ys
                 (ss0 * multiplier) >> 24,
                 (ss1 * multiplier) >> 24,
                 (ss2 * multiplier) >> 24,
-                (ss3 * multiplier) >> 24);
+                (ss3 * multiplier) >> 24
+            );
             memcpy(imOut->image[y] + x * sizeof(v), &v, sizeof(v));
         }
     }
@@ -1240,7 +1272,8 @@ ImagingReduceCorners(Imaging imOut, Imaging imIn, int box[4], int xscale, int ys
 
 void
 ImagingReduceNxN_32bpc(
-    Imaging imOut, Imaging imIn, int box[4], int xscale, int yscale) {
+    Imaging imOut, Imaging imIn, int box[4], int xscale, int yscale
+) {
     /* The most general implementation for any xscale and yscale
      */
     int x, y, xx, yy;
@@ -1313,7 +1346,8 @@ ImagingReduceNxN_32bpc(
 
 void
 ImagingReduceCorners_32bpc(
-    Imaging imOut, Imaging imIn, int box[4], int xscale, int yscale) {
+    Imaging imOut, Imaging imIn, int box[4], int xscale, int yscale
+) {
     /* Fill the last row and the last column for any xscale and yscale.
      */
     int x, y, xx, yy;
@@ -1427,7 +1461,8 @@ ImagingReduce(Imaging imIn, int xscale, int yscale, int box[4]) {
     }
 
     imOut = ImagingNewDirty(
-        imIn->mode, (box[2] + xscale - 1) / xscale, (box[3] + yscale - 1) / yscale);
+        imIn->mode, (box[2] + xscale - 1) / xscale, (box[3] + yscale - 1) / yscale
+    );
     if (!imOut) {
         return NULL;
     }
diff --git a/src/libImaging/Resample.c b/src/libImaging/Resample.c
index 59c27b3f421..222d6bca433 100644
--- a/src/libImaging/Resample.c
+++ b/src/libImaging/Resample.c
@@ -186,7 +186,8 @@ precompute_coeffs(
     int outSize,
     struct filter *filterp,
     int **boundsp,
-    double **kkp) {
+    double **kkp
+) {
     double support, scale, filterscale;
     double center, ww, ss;
     int xx, x, ksize, xmin, xmax;
@@ -284,7 +285,8 @@ normalize_coeffs_8bpc(int outSize, int ksize, double *prekk) {
 
 void
 ImagingResampleHorizontal_8bpc(
-    Imaging imOut, Imaging imIn, int offset, int ksize, int *bounds, double *prekk) {
+    Imaging imOut, Imaging imIn, int offset, int ksize, int *bounds, double *prekk
+) {
     ImagingSectionCookie cookie;
     int ss0, ss1, ss2, ss3;
     int xx, yy, x, xmin, xmax;
@@ -376,7 +378,8 @@ ImagingResampleHorizontal_8bpc(
 
 void
 ImagingResampleVertical_8bpc(
-    Imaging imOut, Imaging imIn, int offset, int ksize, int *bounds, double *prekk) {
+    Imaging imOut, Imaging imIn, int offset, int ksize, int *bounds, double *prekk
+) {
     ImagingSectionCookie cookie;
     int ss0, ss1, ss2, ss3;
     int xx, yy, y, ymin, ymax;
@@ -459,7 +462,8 @@ ImagingResampleVertical_8bpc(
 
 void
 ImagingResampleHorizontal_32bpc(
-    Imaging imOut, Imaging imIn, int offset, int ksize, int *bounds, double *kk) {
+    Imaging imOut, Imaging imIn, int offset, int ksize, int *bounds, double *kk
+) {
     ImagingSectionCookie cookie;
     double ss;
     int xx, yy, x, xmin, xmax;
@@ -502,7 +506,8 @@ ImagingResampleHorizontal_32bpc(
 
 void
 ImagingResampleVertical_32bpc(
-    Imaging imOut, Imaging imIn, int offset, int ksize, int *bounds, double *kk) {
+    Imaging imOut, Imaging imIn, int offset, int ksize, int *bounds, double *kk
+) {
     ImagingSectionCookie cookie;
     double ss;
     int xx, yy, y, ymin, ymax;
@@ -544,7 +549,8 @@ ImagingResampleVertical_32bpc(
 }
 
 typedef void (*ResampleFunction)(
-    Imaging imOut, Imaging imIn, int offset, int ksize, int *bounds, double *kk);
+    Imaging imOut, Imaging imIn, int offset, int ksize, int *bounds, double *kk
+);
 
 Imaging
 ImagingResampleInner(
@@ -554,7 +560,8 @@ ImagingResampleInner(
     struct filter *filterp,
     float box[4],
     ResampleFunction ResampleHorizontal,
-    ResampleFunction ResampleVertical);
+    ResampleFunction ResampleVertical
+);
 
 Imaging
 ImagingResample(Imaging imIn, int xsize, int ysize, int filter, float box[4]) {
@@ -609,7 +616,8 @@ ImagingResample(Imaging imIn, int xsize, int ysize, int filter, float box[4]) {
     }
 
     return ImagingResampleInner(
-        imIn, xsize, ysize, filterp, box, ResampleHorizontal, ResampleVertical);
+        imIn, xsize, ysize, filterp, box, ResampleHorizontal, ResampleVertical
+    );
 }
 
 Imaging
@@ -620,7 +628,8 @@ ImagingResampleInner(
     struct filter *filterp,
     float box[4],
     ResampleFunction ResampleHorizontal,
-    ResampleFunction ResampleVertical) {
+    ResampleFunction ResampleVertical
+) {
     Imaging imTemp = NULL;
     Imaging imOut = NULL;
 
@@ -634,13 +643,15 @@ ImagingResampleInner(
     need_vertical = ysize != imIn->ysize || box[1] || box[3] != ysize;
 
     ksize_horiz = precompute_coeffs(
-        imIn->xsize, box[0], box[2], xsize, filterp, &bounds_horiz, &kk_horiz);
+        imIn->xsize, box[0], box[2], xsize, filterp, &bounds_horiz, &kk_horiz
+    );
     if (!ksize_horiz) {
         return NULL;
     }
 
     ksize_vert = precompute_coeffs(
-        imIn->ysize, box[1], box[3], ysize, filterp, &bounds_vert, &kk_vert);
+        imIn->ysize, box[1], box[3], ysize, filterp, &bounds_vert, &kk_vert
+    );
     if (!ksize_vert) {
         free(bounds_horiz);
         free(kk_horiz);
@@ -662,7 +673,8 @@ ImagingResampleInner(
         imTemp = ImagingNewDirty(imIn->mode, xsize, ybox_last - ybox_first);
         if (imTemp) {
             ResampleHorizontal(
-                imTemp, imIn, ybox_first, ksize_horiz, bounds_horiz, kk_horiz);
+                imTemp, imIn, ybox_first, ksize_horiz, bounds_horiz, kk_horiz
+            );
         }
         free(bounds_horiz);
         free(kk_horiz);
diff --git a/src/libImaging/SgiRleDecode.c b/src/libImaging/SgiRleDecode.c
index 89dedb5252f..a8db11740af 100644
--- a/src/libImaging/SgiRleDecode.c
+++ b/src/libImaging/SgiRleDecode.c
@@ -114,7 +114,8 @@ expandrow(UINT8 *dest, UINT8 *src, int n, int z, int xsize, UINT8 *end_of_buffer
 
 static int
 expandrow2(
-    UINT8 *dest, const UINT8 *src, int n, int z, int xsize, UINT8 *end_of_buffer) {
+    UINT8 *dest, const UINT8 *src, int n, int z, int xsize, UINT8 *end_of_buffer
+) {
     UINT8 pixel, count;
     int x = 0;
 
@@ -252,7 +253,8 @@ ImagingSgiRleDecode(Imaging im, ImagingCodecState state, UINT8 *buf, Py_ssize_t
                     c->rlelength,
                     im->bands,
                     im->xsize,
-                    &ptr[c->bufsize - 1]);
+                    &ptr[c->bufsize - 1]
+                );
             } else {
                 status = expandrow2(
                     &state->buffer[c->channo * 2],
@@ -260,7 +262,8 @@ ImagingSgiRleDecode(Imaging im, ImagingCodecState state, UINT8 *buf, Py_ssize_t
                     c->rlelength,
                     im->bands,
                     im->xsize,
-                    &ptr[c->bufsize - 1]);
+                    &ptr[c->bufsize - 1]
+                );
             }
             if (status == -1) {
                 state->errcode = IMAGING_CODEC_OVERRUN;
diff --git a/src/libImaging/Storage.c b/src/libImaging/Storage.c
index b27195a3587..9dc133b0f43 100644
--- a/src/libImaging/Storage.c
+++ b/src/libImaging/Storage.c
@@ -110,9 +110,8 @@ ImagingNewPrologueSubtype(const char *mode, int xsize, int ysize, int size) {
         im->linesize = xsize * 4;
         im->type = IMAGING_TYPE_INT32;
 
-    } else if (
-        strcmp(mode, "I;16") == 0 || strcmp(mode, "I;16L") == 0 ||
-        strcmp(mode, "I;16B") == 0 || strcmp(mode, "I;16N") == 0) {
+    } else if (strcmp(mode, "I;16") == 0 || strcmp(mode, "I;16L") == 0 ||
+               strcmp(mode, "I;16B") == 0 || strcmp(mode, "I;16N") == 0) {
         /* EXPERIMENTAL */
         /* 16-bit raw integer images */
         im->bands = 1;
@@ -227,7 +226,8 @@ ImagingNewPrologueSubtype(const char *mode, int xsize, int ysize, int size) {
 Imaging
 ImagingNewPrologue(const char *mode, int xsize, int ysize) {
     return ImagingNewPrologueSubtype(
-        mode, xsize, ysize, sizeof(struct ImagingMemoryInstance));
+        mode, xsize, ysize, sizeof(struct ImagingMemoryInstance)
+    );
 }
 
 void
diff --git a/src/libImaging/SunRleDecode.c b/src/libImaging/SunRleDecode.c
index 9d8e1292a47..d3231ad901f 100644
--- a/src/libImaging/SunRleDecode.c
+++ b/src/libImaging/SunRleDecode.c
@@ -107,7 +107,8 @@ ImagingSunRleDecode(Imaging im, ImagingCodecState state, UINT8 *buf, Py_ssize_t
                     (UINT8 *)im->image[state->y + state->yoff] +
                         state->xoff * im->pixelsize,
                     state->buffer,
-                    state->xsize);
+                    state->xsize
+                );
 
                 state->x = 0;
 
diff --git a/src/libImaging/TgaRleDecode.c b/src/libImaging/TgaRleDecode.c
index 95ae9b62228..fbf29452c8e 100644
--- a/src/libImaging/TgaRleDecode.c
+++ b/src/libImaging/TgaRleDecode.c
@@ -93,7 +93,8 @@ ImagingTgaRleDecode(Imaging im, ImagingCodecState state, UINT8 *buf, Py_ssize_t
                     (UINT8 *)im->image[state->y + state->yoff] +
                         state->xoff * im->pixelsize,
                     state->buffer,
-                    state->xsize);
+                    state->xsize
+                );
 
                 state->x = 0;
 
diff --git a/src/libImaging/TgaRleEncode.c b/src/libImaging/TgaRleEncode.c
index aa7e7b96d81..dde4766143a 100644
--- a/src/libImaging/TgaRleEncode.c
+++ b/src/libImaging/TgaRleEncode.c
@@ -63,7 +63,8 @@ ImagingTgaRleEncode(Imaging im, ImagingCodecState state, UINT8 *buf, int bytes)
                     state->buffer,
                     (UINT8 *)im->image[state->y + state->yoff] +
                         state->xoff * im->pixelsize,
-                    state->xsize);
+                    state->xsize
+                );
             }
 
             row = state->buffer;
@@ -146,7 +147,8 @@ ImagingTgaRleEncode(Imaging im, ImagingCodecState state, UINT8 *buf, int bytes)
         }
 
         memcpy(
-            dst, state->buffer + (state->x * bytesPerPixel - state->count), flushCount);
+            dst, state->buffer + (state->x * bytesPerPixel - state->count), flushCount
+        );
         dst += flushCount;
         bytes -= flushCount;
 
diff --git a/src/libImaging/TiffDecode.c b/src/libImaging/TiffDecode.c
index abffdeabcd5..18a54f63305 100644
--- a/src/libImaging/TiffDecode.c
+++ b/src/libImaging/TiffDecode.c
@@ -44,7 +44,8 @@ dump_state(const TIFFSTATE *state) {
          (int)state->size,
          (uint)state->eof,
          state->data,
-         state->ifd));
+         state->ifd)
+    );
 }
 
 /*
@@ -64,7 +65,8 @@ _tiffReadProc(thandle_t hdata, tdata_t buf, tsize_t size) {
             "_tiffReadProc",
             "Invalid Read at loc %" PRIu64 ", eof: %" PRIu64,
             state->loc,
-            state->eof);
+            state->eof
+        );
         return 0;
     }
     to_read = min(size, min(state->size, (tsize_t)state->eof) - (tsize_t)state->loc);
@@ -200,13 +202,15 @@ ImagingLibTiffInit(ImagingCodecState state, int fp, uint32_t offset) {
          state->state,
          state->x,
          state->y,
-         state->ystep));
+         state->ystep)
+    );
     TRACE(
         ("State: xsize %d, ysize %d, xoff %d, yoff %d \n",
          state->xsize,
          state->ysize,
          state->xoff,
-         state->yoff));
+         state->yoff)
+    );
     TRACE(("State: bits %d, bytes %d \n", state->bits, state->bytes));
     TRACE(("State: context %p \n", state->context));
 
@@ -226,7 +230,8 @@ _pickUnpackers(
     ImagingCodecState state,
     TIFF *tiff,
     uint16_t planarconfig,
-    ImagingShuffler *unpackers) {
+    ImagingShuffler *unpackers
+) {
     // if number of bands is 1, there is no difference with contig case
     if (planarconfig == PLANARCONFIG_SEPARATE && im->bands > 1) {
         uint16_t bits_per_sample = 8;
@@ -356,7 +361,8 @@ _decodeAsRGBA(Imaging im, ImagingCodecState state, TIFF *tiff) {
                 (UINT8 *)im->image[state->y + state->yoff + current_row] +
                     state->xoff * im->pixelsize,
                 state->buffer + current_row * row_byte_size,
-                state->xsize);
+                state->xsize
+            );
         }
     }
 
@@ -374,7 +380,8 @@ _decodeTile(
     ImagingCodecState state,
     TIFF *tiff,
     int planes,
-    ImagingShuffler *unpackers) {
+    ImagingShuffler *unpackers
+) {
     INT32 x, y, tile_y, current_tile_length, current_tile_width;
     UINT32 tile_width, tile_length;
     tsize_t tile_bytes_size, row_byte_size;
@@ -453,7 +460,8 @@ _decodeTile(
                         ("Writing tile data at %dx%d using tile_width: %d; \n",
                          tile_y + y,
                          x,
-                         current_tile_width));
+                         current_tile_width)
+                    );
 
                     // UINT8 * bbb = state->buffer + tile_y * row_byte_size;
                     // TRACE(("chars: %x%x%x%x\n", ((UINT8 *)bbb)[0], ((UINT8 *)bbb)[1],
@@ -462,7 +470,8 @@ _decodeTile(
                     shuffler(
                         (UINT8 *)im->image[tile_y + y] + x * im->pixelsize,
                         state->buffer + tile_y * row_byte_size,
-                        current_tile_width);
+                        current_tile_width
+                    );
                 }
             }
         }
@@ -477,7 +486,8 @@ _decodeStrip(
     ImagingCodecState state,
     TIFF *tiff,
     int planes,
-    ImagingShuffler *unpackers) {
+    ImagingShuffler *unpackers
+) {
     INT32 strip_row = 0;
     UINT8 *new_data;
     UINT32 rows_per_strip;
@@ -544,9 +554,10 @@ _decodeStrip(
                     tiff,
                     TIFFComputeStrip(tiff, state->y, plane),
                     (tdata_t)state->buffer,
-                    strip_size) == -1) {
-                TRACE(
-                    ("Decode Error, strip %d\n", TIFFComputeStrip(tiff, state->y, 0)));
+                    strip_size
+                ) == -1) {
+                TRACE(("Decode Error, strip %d\n", TIFFComputeStrip(tiff, state->y, 0))
+                );
                 state->errcode = IMAGING_CODEC_BROKEN;
                 return -1;
             }
@@ -567,7 +578,8 @@ _decodeStrip(
                     (UINT8 *)im->image[state->y + state->yoff + strip_row] +
                         state->xoff * im->pixelsize,
                     state->buffer + strip_row * row_byte_size,
-                    state->xsize);
+                    state->xsize
+                );
             }
         }
     }
@@ -577,7 +589,8 @@ _decodeStrip(
 
 int
 ImagingLibTiffDecode(
-    Imaging im, ImagingCodecState state, UINT8 *buffer, Py_ssize_t bytes) {
+    Imaging im, ImagingCodecState state, UINT8 *buffer, Py_ssize_t bytes
+) {
     TIFFSTATE *clientstate = (TIFFSTATE *)state->context;
     char *filename = "tempfile.tif";
     char *mode = "rC";
@@ -602,13 +615,15 @@ ImagingLibTiffDecode(
          state->state,
          state->x,
          state->y,
-         state->ystep));
+         state->ystep)
+    );
     TRACE(
         ("State: xsize %d, ysize %d, xoff %d, yoff %d \n",
          state->xsize,
          state->ysize,
          state->xoff,
-         state->yoff));
+         state->yoff)
+    );
     TRACE(("State: bits %d, bytes %d \n", state->bits, state->bytes));
     TRACE(
         ("Buffer: %p: %c%c%c%c\n",
@@ -616,26 +631,30 @@ ImagingLibTiffDecode(
          (char)buffer[0],
          (char)buffer[1],
          (char)buffer[2],
-         (char)buffer[3]));
+         (char)buffer[3])
+    );
     TRACE(
         ("State->Buffer: %c%c%c%c\n",
          (char)state->buffer[0],
          (char)state->buffer[1],
          (char)state->buffer[2],
-         (char)state->buffer[3]));
+         (char)state->buffer[3])
+    );
     TRACE(
         ("Image: mode %s, type %d, bands: %d, xsize %d, ysize %d \n",
          im->mode,
          im->type,
          im->bands,
          im->xsize,
-         im->ysize));
+         im->ysize)
+    );
     TRACE(
         ("Image: image8 %p, image32 %p, image %p, block %p \n",
          im->image8,
          im->image32,
          im->image,
-         im->block));
+         im->block)
+    );
     TRACE(("Image: pixelsize: %d, linesize %d \n", im->pixelsize, im->linesize));
 
     dump_state(clientstate);
@@ -665,7 +684,8 @@ ImagingLibTiffDecode(
             _tiffCloseProc,
             _tiffSizeProc,
             _tiffMapProc,
-            _tiffUnmapProc);
+            _tiffUnmapProc
+        );
     }
 
     if (!tiff) {
@@ -694,7 +714,8 @@ ImagingLibTiffDecode(
              state->xsize,
              img_width,
              state->ysize,
-             img_height));
+             img_height)
+        );
         state->errcode = IMAGING_CODEC_BROKEN;
         goto decode_err;
     }
@@ -739,7 +760,8 @@ ImagingLibTiffDecode(
                 INT32 y;
 
                 TIFFGetFieldDefaulted(
-                    tiff, TIFFTAG_EXTRASAMPLES, &extrasamples, &sampleinfo);
+                    tiff, TIFFTAG_EXTRASAMPLES, &extrasamples, &sampleinfo
+                );
 
                 if (extrasamples >= 1 && (sampleinfo[0] == EXTRASAMPLE_UNSPECIFIED ||
                                           sampleinfo[0] == EXTRASAMPLE_ASSOCALPHA)) {
@@ -793,13 +815,15 @@ ImagingLibTiffEncodeInit(ImagingCodecState state, char *filename, int fp) {
          state->state,
          state->x,
          state->y,
-         state->ystep));
+         state->ystep)
+    );
     TRACE(
         ("State: xsize %d, ysize %d, xoff %d, yoff %d \n",
          state->xsize,
          state->ysize,
          state->xoff,
-         state->yoff));
+         state->yoff)
+    );
     TRACE(("State: bits %d, bytes %d \n", state->bits, state->bytes));
     TRACE(("State: context %p \n", state->context));
 
@@ -839,7 +863,8 @@ ImagingLibTiffEncodeInit(ImagingCodecState state, char *filename, int fp) {
             _tiffCloseProc,
             _tiffSizeProc,
             _tiffNullMapProc,
-            _tiffUnmapProc); /*force no mmap*/
+            _tiffUnmapProc
+        ); /*force no mmap*/
     }
 
     if (!clientstate->tiff) {
@@ -852,7 +877,8 @@ ImagingLibTiffEncodeInit(ImagingCodecState state, char *filename, int fp) {
 
 int
 ImagingLibTiffMergeFieldInfo(
-    ImagingCodecState state, TIFFDataType field_type, int key, int is_var_length) {
+    ImagingCodecState state, TIFFDataType field_type, int key, int is_var_length
+) {
     // Refer to libtiff docs (http://www.simplesystems.org/libtiff/addingtags.html)
     TIFFSTATE *clientstate = (TIFFSTATE *)state->context;
     uint32_t n;
@@ -874,7 +900,8 @@ ImagingLibTiffMergeFieldInfo(
          FIELD_CUSTOM,
          1,
          passcount,
-         "CustomField"}};
+         "CustomField"}
+    };
 
     n = sizeof(info) / sizeof(info[0]);
 
@@ -922,13 +949,15 @@ ImagingLibTiffEncode(Imaging im, ImagingCodecState state, UINT8 *buffer, int byt
          state->state,
          state->x,
          state->y,
-         state->ystep));
+         state->ystep)
+    );
     TRACE(
         ("State: xsize %d, ysize %d, xoff %d, yoff %d \n",
          state->xsize,
          state->ysize,
          state->xoff,
-         state->yoff));
+         state->yoff)
+    );
     TRACE(("State: bits %d, bytes %d \n", state->bits, state->bytes));
     TRACE(
         ("Buffer: %p: %c%c%c%c\n",
@@ -936,26 +965,30 @@ ImagingLibTiffEncode(Imaging im, ImagingCodecState state, UINT8 *buffer, int byt
          (char)buffer[0],
          (char)buffer[1],
          (char)buffer[2],
-         (char)buffer[3]));
+         (char)buffer[3])
+    );
     TRACE(
         ("State->Buffer: %c%c%c%c\n",
          (char)state->buffer[0],
          (char)state->buffer[1],
          (char)state->buffer[2],
-         (char)state->buffer[3]));
+         (char)state->buffer[3])
+    );
     TRACE(
         ("Image: mode %s, type %d, bands: %d, xsize %d, ysize %d \n",
          im->mode,
          im->type,
          im->bands,
          im->xsize,
-         im->ysize));
+         im->ysize)
+    );
     TRACE(
         ("Image: image8 %p, image32 %p, image %p, block %p \n",
          im->image8,
          im->image32,
          im->image,
-         im->block));
+         im->block)
+    );
     TRACE(("Image: pixelsize: %d, linesize %d \n", im->pixelsize, im->linesize));
 
     dump_state(clientstate);
@@ -967,10 +1000,12 @@ ImagingLibTiffEncode(Imaging im, ImagingCodecState state, UINT8 *buffer, int byt
                 state->buffer,
                 (UINT8 *)im->image[state->y + state->yoff] +
                     state->xoff * im->pixelsize,
-                state->xsize);
+                state->xsize
+            );
 
             if (TIFFWriteScanline(
-                    tiff, (tdata_t)(state->buffer), (uint32_t)state->y, 0) == -1) {
+                    tiff, (tdata_t)(state->buffer), (uint32_t)state->y, 0
+                ) == -1) {
                 TRACE(("Encode Error, row %d\n", state->y));
                 state->errcode = IMAGING_CODEC_BROKEN;
                 TIFFClose(tiff);
@@ -1013,7 +1048,8 @@ ImagingLibTiffEncode(Imaging im, ImagingCodecState state, UINT8 *buffer, int byt
              (char)buffer[0],
              (char)buffer[1],
              (char)buffer[2],
-             (char)buffer[3]));
+             (char)buffer[3])
+        );
         if (clientstate->loc == clientstate->eof) {
             TRACE(("Hit EOF, calling an end, freeing data"));
             state->errcode = IMAGING_CODEC_END;
diff --git a/src/libImaging/TiffDecode.h b/src/libImaging/TiffDecode.h
index 212b7dee6b0..22361210dcb 100644
--- a/src/libImaging/TiffDecode.h
+++ b/src/libImaging/TiffDecode.h
@@ -41,7 +41,8 @@ extern int
 ImagingLibTiffEncodeInit(ImagingCodecState state, char *filename, int fp);
 extern int
 ImagingLibTiffMergeFieldInfo(
-    ImagingCodecState state, TIFFDataType field_type, int key, int is_var_length);
+    ImagingCodecState state, TIFFDataType field_type, int key, int is_var_length
+);
 extern int
 ImagingLibTiffSetField(ImagingCodecState state, ttag_t tag, ...);
 
diff --git a/src/libImaging/Unpack.c b/src/libImaging/Unpack.c
index eaa4374e3e9..c23d5d889f6 100644
--- a/src/libImaging/Unpack.c
+++ b/src/libImaging/Unpack.c
@@ -104,7 +104,8 @@ static UINT8 BITFLIP[] = {
     3,  131, 67, 195, 35, 163, 99,  227, 19, 147, 83, 211, 51, 179, 115, 243,
     11, 139, 75, 203, 43, 171, 107, 235, 27, 155, 91, 219, 59, 187, 123, 251,
     7,  135, 71, 199, 39, 167, 103, 231, 23, 151, 87, 215, 55, 183, 119, 247,
-    15, 143, 79, 207, 47, 175, 111, 239, 31, 159, 95, 223, 63, 191, 127, 255};
+    15, 143, 79, 207, 47, 175, 111, 239, 31, 159, 95, 223, 63, 191, 127, 255
+};
 
 /* Unpack to "1" image */
 
@@ -882,7 +883,8 @@ unpackRGBa16L(UINT8 *_out, const UINT8 *in, int pixels) {
                 CLIP8(in[1] * 255 / a),
                 CLIP8(in[3] * 255 / a),
                 CLIP8(in[5] * 255 / a),
-                a);
+                a
+            );
         }
         memcpy(_out, &iv, sizeof(iv));
         in += 8;
@@ -906,7 +908,8 @@ unpackRGBa16B(UINT8 *_out, const UINT8 *in, int pixels) {
                 CLIP8(in[0] * 255 / a),
                 CLIP8(in[2] * 255 / a),
                 CLIP8(in[4] * 255 / a),
-                a);
+                a
+            );
         }
         memcpy(_out, &iv, sizeof(iv));
         in += 8;
@@ -930,7 +933,8 @@ unpackRGBa(UINT8 *_out, const UINT8 *in, int pixels) {
                 CLIP8(in[0] * 255 / a),
                 CLIP8(in[1] * 255 / a),
                 CLIP8(in[2] * 255 / a),
-                a);
+                a
+            );
         }
         memcpy(_out, &iv, sizeof(iv));
         in += 4;
@@ -954,7 +958,8 @@ unpackRGBaskip1(UINT8 *_out, const UINT8 *in, int pixels) {
                 CLIP8(in[0] * 255 / a),
                 CLIP8(in[1] * 255 / a),
                 CLIP8(in[2] * 255 / a),
-                a);
+                a
+            );
         }
         in += 5;
     }
@@ -976,7 +981,8 @@ unpackRGBaskip2(UINT8 *_out, const UINT8 *in, int pixels) {
                 CLIP8(in[0] * 255 / a),
                 CLIP8(in[1] * 255 / a),
                 CLIP8(in[2] * 255 / a),
-                a);
+                a
+            );
         }
         in += 6;
     }
@@ -998,7 +1004,8 @@ unpackBGRa(UINT8 *_out, const UINT8 *in, int pixels) {
                 CLIP8(in[2] * 255 / a),
                 CLIP8(in[1] * 255 / a),
                 CLIP8(in[0] * 255 / a),
-                a);
+                a
+            );
         }
         memcpy(_out, &iv, sizeof(iv));
         in += 4;
@@ -1029,7 +1036,8 @@ unpackRGBAL(UINT8 *_out, const UINT8 *in, int pixels) {
             in[i],
             in[i + pixels],
             in[i + pixels + pixels],
-            in[i + pixels + pixels + pixels]);
+            in[i + pixels + pixels + pixels]
+        );
         memcpy(_out, &iv, sizeof(iv));
     }
 }
diff --git a/src/libImaging/UnpackYCC.c b/src/libImaging/UnpackYCC.c
index 0b177bdd4f5..35b0c3b694d 100644
--- a/src/libImaging/UnpackYCC.c
+++ b/src/libImaging/UnpackYCC.c
@@ -34,7 +34,8 @@ static INT16 L[] = {
     261, 262, 264, 265, 266, 268, 269, 270, 272, 273, 274, 276, 277, 278, 280, 281,
     283, 284, 285, 287, 288, 289, 291, 292, 293, 295, 296, 297, 299, 300, 302, 303,
     304, 306, 307, 308, 310, 311, 312, 314, 315, 317, 318, 319, 321, 322, 323, 325,
-    326, 327, 329, 330, 331, 333, 334, 336, 337, 338, 340, 341, 342, 344, 345, 346};
+    326, 327, 329, 330, 331, 333, 334, 336, 337, 338, 340, 341, 342, 344, 345, 346
+};
 
 static INT16 CB[] = {
     -345, -343, -341, -338, -336, -334, -332, -329, -327, -325, -323, -321, -318, -316,
@@ -55,7 +56,8 @@ static INT16 CB[] = {
     120,  122,  124,  126,  129,  131,  133,  135,  138,  140,  142,  144,  146,  149,
     151,  153,  155,  157,  160,  162,  164,  166,  169,  171,  173,  175,  177,  180,
     182,  184,  186,  189,  191,  193,  195,  197,  200,  202,  204,  206,  208,  211,
-    213,  215,  217,  220};
+    213,  215,  217,  220
+};
 
 static INT16 GB[] = {
     67,  67,  66,  66,  65,  65,  65,  64,  64,  63,  63,  62,  62,  62,  61,  61,
@@ -73,7 +75,8 @@ static INT16 GB[] = {
     -14, -15, -15, -16, -16, -17, -17, -18, -18, -18, -19, -19, -20, -20, -21, -21,
     -21, -22, -22, -23, -23, -24, -24, -24, -25, -25, -26, -26, -27, -27, -27, -28,
     -28, -29, -29, -30, -30, -30, -31, -31, -32, -32, -33, -33, -33, -34, -34, -35,
-    -35, -36, -36, -36, -37, -37, -38, -38, -39, -39, -39, -40, -40, -41, -41, -42};
+    -35, -36, -36, -36, -37, -37, -38, -38, -39, -39, -39, -40, -40, -41, -41, -42
+};
 
 static INT16 CR[] = {
     -249, -247, -245, -243, -241, -239, -238, -236, -234, -232, -230, -229, -227, -225,
@@ -94,7 +97,8 @@ static INT16 CR[] = {
     133,  135,  137,  138,  140,  142,  144,  146,  148,  149,  151,  153,  155,  157,
     158,  160,  162,  164,  166,  168,  169,  171,  173,  175,  177,  179,  180,  182,
     184,  186,  188,  189,  191,  193,  195,  197,  199,  200,  202,  204,  206,  208,
-    209,  211,  213,  215};
+    209,  211,  213,  215
+};
 
 static INT16 GR[] = {
     127, 126, 125, 124, 123, 122, 121,  121,  120,  119,  118,  117,  116,  115,  114,
@@ -114,7 +118,8 @@ static INT16 GR[] = {
     -67, -68, -69, -69, -70, -71, -72,  -73,  -74,  -75,  -76,  -77,  -78,  -79,  -80,
     -81, -82, -82, -83, -84, -85, -86,  -87,  -88,  -89,  -90,  -91,  -92,  -93,  -94,
     -94, -95, -96, -97, -98, -99, -100, -101, -102, -103, -104, -105, -106, -107, -107,
-    -108};
+    -108
+};
 
 #define R 0
 #define G 1
diff --git a/src/libImaging/UnsharpMask.c b/src/libImaging/UnsharpMask.c
index 2853ce903fc..e714749effd 100644
--- a/src/libImaging/UnsharpMask.c
+++ b/src/libImaging/UnsharpMask.c
@@ -23,7 +23,8 @@ clip8(int in) {
 
 Imaging
 ImagingUnsharpMask(
-    Imaging imOut, Imaging imIn, float radius, int percent, int threshold) {
+    Imaging imOut, Imaging imIn, float radius, int percent, int threshold
+) {
     ImagingSectionCookie cookie;
     Imaging result;
 
diff --git a/src/libImaging/XbmEncode.c b/src/libImaging/XbmEncode.c
index eec4c0d8462..65cc3c6333c 100644
--- a/src/libImaging/XbmEncode.c
+++ b/src/libImaging/XbmEncode.c
@@ -40,7 +40,8 @@ ImagingXbmEncode(Imaging im, ImagingCodecState state, UINT8 *buf, int bytes) {
         state->shuffle(
             state->buffer,
             (UINT8 *)im->image[state->y + state->yoff] + state->xoff * im->pixelsize,
-            state->xsize);
+            state->xsize
+        );
 
         if (state->y < state->ysize - 1) {
             /* any line but the last */
diff --git a/src/libImaging/ZipDecode.c b/src/libImaging/ZipDecode.c
index 8749678341e..d964ff2ca7d 100644
--- a/src/libImaging/ZipDecode.c
+++ b/src/libImaging/ZipDecode.c
@@ -217,7 +217,8 @@ ImagingZipDecode(Imaging im, ImagingCodecState state, UINT8 *buf, Py_ssize_t byt
                     state->shuffle(
                         (UINT8 *)im->image[state->y] + col * im->pixelsize,
                         state->buffer + context->prefix + i,
-                        1);
+                        1
+                    );
                     col += COL_INCREMENT[context->pass];
                 }
             } else {
@@ -229,7 +230,8 @@ ImagingZipDecode(Imaging im, ImagingCodecState state, UINT8 *buf, Py_ssize_t byt
                     UINT8 byte = *(state->buffer + context->prefix + (i / 8));
                     byte <<= (i % 8);
                     state->shuffle(
-                        (UINT8 *)im->image[state->y] + col * im->pixelsize, &byte, 1);
+                        (UINT8 *)im->image[state->y] + col * im->pixelsize, &byte, 1
+                    );
                     col += COL_INCREMENT[context->pass];
                 }
             }
@@ -253,7 +255,8 @@ ImagingZipDecode(Imaging im, ImagingCodecState state, UINT8 *buf, Py_ssize_t byt
                 (UINT8 *)im->image[state->y + state->yoff] +
                     state->xoff * im->pixelsize,
                 state->buffer + context->prefix,
-                state->xsize);
+                state->xsize
+            );
             state->y++;
         }
 
diff --git a/src/libImaging/ZipEncode.c b/src/libImaging/ZipEncode.c
index edbce36822c..44f2629cc12 100644
--- a/src/libImaging/ZipEncode.c
+++ b/src/libImaging/ZipEncode.c
@@ -98,7 +98,8 @@ ImagingZipEncode(Imaging im, ImagingCodecState state, UINT8 *buf, int bytes) {
             15,
             9,
             /* compression strategy (image data are filtered)*/
-            compress_type);
+            compress_type
+        );
         if (err < 0) {
             state->errcode = IMAGING_CODEC_CONFIG;
             return -1;
@@ -108,7 +109,8 @@ ImagingZipEncode(Imaging im, ImagingCodecState state, UINT8 *buf, int bytes) {
             err = deflateSetDictionary(
                 &context->z_stream,
                 (unsigned char *)context->dictionary,
-                context->dictionary_size);
+                context->dictionary_size
+            );
             if (err < 0) {
                 state->errcode = IMAGING_CODEC_CONFIG;
                 return -1;
@@ -163,7 +165,8 @@ ImagingZipEncode(Imaging im, ImagingCodecState state, UINT8 *buf, int bytes) {
                         state->buffer + 1,
                         (UINT8 *)im->image[state->y + state->yoff] +
                             state->xoff * im->pixelsize,
-                        state->xsize);
+                        state->xsize
+                    );
 
                     state->y++;
 
diff --git a/src/map.c b/src/map.c
index c298bd1482a..c66702981d3 100644
--- a/src/map.c
+++ b/src/map.c
@@ -72,7 +72,8 @@ PyImaging_MapBuffer(PyObject *self, PyObject *args) {
             &offset,
             &mode,
             &stride,
-            &ystep)) {
+            &ystep
+        )) {
         return NULL;
     }
 
diff --git a/src/path.c b/src/path.c
index bd6ad2259dd..b96e8b78a70 100644
--- a/src/path.c
+++ b/src/path.c
@@ -489,7 +489,8 @@ path_transform(PyPathObject *self, PyObject *args) {
     double wrap = 0.0;
 
     if (!PyArg_ParseTuple(
-            args, "(dddddd)|d:transform", &a, &b, &c, &d, &e, &f, &wrap)) {
+            args, "(dddddd)|d:transform", &a, &b, &c, &d, &e, &f, &wrap
+        )) {
         return NULL;
     }
 
@@ -570,7 +571,8 @@ path_subscript(PyPathObject *self, PyObject *item) {
         PyErr_Format(
             PyExc_TypeError,
             "Path indices must be integers, not %.200s",
-            Py_TYPE(item)->tp_name);
+            Py_TYPE(item)->tp_name
+        );
         return NULL;
     }
 }
@@ -586,7 +588,8 @@ static PySequenceMethods path_as_sequence = {
 };
 
 static PyMappingMethods path_as_mapping = {
-    (lenfunc)path_len, (binaryfunc)path_subscript, NULL};
+    (lenfunc)path_len, (binaryfunc)path_subscript, NULL
+};
 
 static PyTypeObject PyPathType = {
     PyVarObject_HEAD_INIT(NULL, 0) "Path", /*tp_name*/

From ea7b5c5b667b0bc80a70f9ca4ee123e82450c123 Mon Sep 17 00:00:00 2001
From: Lysandros Nikolaou <lisandrosnik@gmail.com>
Date: Tue, 16 Jul 2024 10:13:26 +0200
Subject: [PATCH 0824/1178] Lock around usages of imaging memory arenas

---
 src/_imaging.c           | 48 +++++++++++++++++++++++++++++++---------
 src/libImaging/Imaging.h | 12 ++++++++++
 src/libImaging/Storage.c | 20 ++++++++++++-----
 3 files changed, 65 insertions(+), 15 deletions(-)

diff --git a/src/_imaging.c b/src/_imaging.c
index ac6310a445e..66709d9bc66 100644
--- a/src/_imaging.c
+++ b/src/_imaging.c
@@ -92,6 +92,7 @@
 
 #define _USE_MATH_DEFINES
 #include <math.h>
+#include <stddef.h>
 
 /* Configuration stuff. Feel free to undef things you don't need. */
 #define WITH_IMAGECHOPS  /* ImageChops support */
@@ -3934,7 +3935,6 @@ static PyObject *
 _get_stats(PyObject *self, PyObject *args) {
     PyObject *d;
     PyObject *v;
-    ImagingMemoryArena arena = &ImagingDefaultArena;
 
     if (!PyArg_ParseTuple(args, ":get_stats")) {
         return NULL;
@@ -3944,6 +3944,10 @@ _get_stats(PyObject *self, PyObject *args) {
     if (!d) {
         return NULL;
     }
+
+    MUTEX_LOCK(&ImagingDefaultArena.mutex);
+    ImagingMemoryArena arena = &ImagingDefaultArena;
+
     v = PyLong_FromLong(arena->stats_new_count);
     PyDict_SetItemString(d, "new_count", v ? v : Py_None);
     Py_XDECREF(v);
@@ -3967,22 +3971,25 @@ _get_stats(PyObject *self, PyObject *args) {
     v = PyLong_FromLong(arena->blocks_cached);
     PyDict_SetItemString(d, "blocks_cached", v ? v : Py_None);
     Py_XDECREF(v);
+
+    MUTEX_UNLOCK(&ImagingDefaultArena.mutex);
     return d;
 }
 
 static PyObject *
 _reset_stats(PyObject *self, PyObject *args) {
-    ImagingMemoryArena arena = &ImagingDefaultArena;
-
     if (!PyArg_ParseTuple(args, ":reset_stats")) {
         return NULL;
     }
 
+    MUTEX_LOCK(&ImagingDefaultArena.mutex);
+    ImagingMemoryArena arena = &ImagingDefaultArena;
     arena->stats_new_count = 0;
     arena->stats_allocated_blocks = 0;
     arena->stats_reused_blocks = 0;
     arena->stats_reallocated_blocks = 0;
     arena->stats_freed_blocks = 0;
+    MUTEX_UNLOCK(&ImagingDefaultArena.mutex);
 
     Py_INCREF(Py_None);
     return Py_None;
@@ -3994,7 +4001,10 @@ _get_alignment(PyObject *self, PyObject *args) {
         return NULL;
     }
 
-    return PyLong_FromLong(ImagingDefaultArena.alignment);
+    MUTEX_LOCK(&ImagingDefaultArena.mutex);
+    int alignment = ImagingDefaultArena.alignment;
+    MUTEX_UNLOCK(&ImagingDefaultArena.mutex);
+    return PyLong_FromLong(alignment);
 }
 
 static PyObject *
@@ -4003,7 +4013,10 @@ _get_block_size(PyObject *self, PyObject *args) {
         return NULL;
     }
 
-    return PyLong_FromLong(ImagingDefaultArena.block_size);
+    MUTEX_LOCK(&ImagingDefaultArena.mutex);
+    int block_size = ImagingDefaultArena.block_size;
+    MUTEX_UNLOCK(&ImagingDefaultArena.mutex);
+    return PyLong_FromLong(block_size);
 }
 
 static PyObject *
@@ -4012,7 +4025,10 @@ _get_blocks_max(PyObject *self, PyObject *args) {
         return NULL;
     }
 
-    return PyLong_FromLong(ImagingDefaultArena.blocks_max);
+    MUTEX_LOCK(&ImagingDefaultArena.mutex);
+    int blocks_max = ImagingDefaultArena.blocks_max;
+    MUTEX_UNLOCK(&ImagingDefaultArena.mutex);
+    return PyLong_FromLong(blocks_max);
 }
 
 static PyObject *
@@ -4032,7 +4048,9 @@ _set_alignment(PyObject *self, PyObject *args) {
         return NULL;
     }
 
+    MUTEX_LOCK(&ImagingDefaultArena.mutex);
     ImagingDefaultArena.alignment = alignment;
+    MUTEX_UNLOCK(&ImagingDefaultArena.mutex);
 
     Py_INCREF(Py_None);
     return Py_None;
@@ -4055,7 +4073,9 @@ _set_block_size(PyObject *self, PyObject *args) {
         return NULL;
     }
 
+    MUTEX_LOCK(&ImagingDefaultArena.mutex);
     ImagingDefaultArena.block_size = block_size;
+    MUTEX_UNLOCK(&ImagingDefaultArena.mutex);
 
     Py_INCREF(Py_None);
     return Py_None;
@@ -4071,14 +4091,20 @@ _set_blocks_max(PyObject *self, PyObject *args) {
     if (blocks_max < 0) {
         PyErr_SetString(PyExc_ValueError, "blocks_max should be greater than 0");
         return NULL;
-    } else if (
-        (unsigned long)blocks_max >
-        SIZE_MAX / sizeof(ImagingDefaultArena.blocks_pool[0])) {
+    }
+
+    MUTEX_LOCK(&ImagingDefaultArena.mutex);
+    size_t blocksize = sizeof(ImagingDefaultArena.blocks_pool[0]);
+    MUTEX_UNLOCK(&ImagingDefaultArena.mutex);
+    if ((unsigned long)blocks_max > SIZE_MAX / blocksize) {
         PyErr_SetString(PyExc_ValueError, "blocks_max is too large");
         return NULL;
     }
 
-    if (!ImagingMemorySetBlocksMax(&ImagingDefaultArena, blocks_max)) {
+    MUTEX_LOCK(&ImagingDefaultArena.mutex);
+    int status = ImagingMemorySetBlocksMax(&ImagingDefaultArena, blocks_max);
+    MUTEX_UNLOCK(&ImagingDefaultArena.mutex);
+    if (!status) {
         return ImagingError_MemoryError();
     }
 
@@ -4094,7 +4120,9 @@ _clear_cache(PyObject *self, PyObject *args) {
         return NULL;
     }
 
+    MUTEX_LOCK(&ImagingDefaultArena.mutex);
     ImagingMemoryClearCache(&ImagingDefaultArena, i);
+    MUTEX_UNLOCK(&ImagingDefaultArena.mutex);
 
     Py_INCREF(Py_None);
     return Py_None;
diff --git a/src/libImaging/Imaging.h b/src/libImaging/Imaging.h
index 1f2c03e934f..28311121607 100644
--- a/src/libImaging/Imaging.h
+++ b/src/libImaging/Imaging.h
@@ -161,6 +161,9 @@ typedef struct ImagingMemoryArena {
     int stats_reallocated_blocks; /* Number of blocks which were actually reallocated
                                      after retrieving */
     int stats_freed_blocks;       /* Number of freed blocks */
+#ifdef Py_GIL_DISABLED
+    PyMutex mutex;
+#endif
 } *ImagingMemoryArena;
 
 /* Objects */
@@ -690,6 +693,15 @@ _imaging_tell_pyFd(PyObject *fd);
 #include "ImagingUtils.h"
 extern UINT8 *clip8_lookups;
 
+/* Mutex lock/unlock helpers */
+#ifdef Py_GIL_DISABLED
+#define MUTEX_LOCK(m) PyMutex_Lock(m)
+#define MUTEX_UNLOCK(m) PyMutex_Unlock(m)
+#else
+#define MUTEX_LOCK(m)
+#define MUTEX_UNLOCK(m)
+#endif
+
 #if defined(__cplusplus)
 }
 #endif
diff --git a/src/libImaging/Storage.c b/src/libImaging/Storage.c
index b27195a3587..9331ed5d538 100644
--- a/src/libImaging/Storage.c
+++ b/src/libImaging/Storage.c
@@ -219,7 +219,9 @@ ImagingNewPrologueSubtype(const char *mode, int xsize, int ysize, int size) {
             break;
     }
 
+    MUTEX_LOCK(&ImagingDefaultArena.mutex);
     ImagingDefaultArena.stats_new_count += 1;
+    MUTEX_UNLOCK(&ImagingDefaultArena.mutex);
 
     return im;
 }
@@ -267,7 +269,8 @@ struct ImagingMemoryArena ImagingDefaultArena = {
     0,
     0,
     0,
-    0  // Stats
+    0,  // Stats
+    {0},
 };
 
 int
@@ -365,7 +368,9 @@ ImagingDestroyArray(Imaging im) {
 
     if (im->blocks) {
         while (im->blocks[y].ptr) {
+            MUTEX_LOCK(&ImagingDefaultArena.mutex);
             memory_return_block(&ImagingDefaultArena, im->blocks[y]);
+            MUTEX_UNLOCK(&ImagingDefaultArena.mutex);
             y += 1;
         }
         free(im->blocks);
@@ -373,9 +378,8 @@ ImagingDestroyArray(Imaging im) {
 }
 
 Imaging
-ImagingAllocateArray(Imaging im, int dirty, int block_size) {
+ImagingAllocateArray(Imaging im, ImagingMemoryArena arena, int dirty, int block_size) {
     int y, line_in_block, current_block;
-    ImagingMemoryArena arena = &ImagingDefaultArena;
     ImagingMemoryBlock block = {NULL, 0};
     int aligned_linesize, lines_per_block, blocks_count;
     char *aligned_ptr = NULL;
@@ -498,14 +502,20 @@ ImagingNewInternal(const char *mode, int xsize, int ysize, int dirty) {
         return NULL;
     }
 
-    if (ImagingAllocateArray(im, dirty, ImagingDefaultArena.block_size)) {
+    MUTEX_LOCK(&ImagingDefaultArena.mutex);
+    Imaging tmp = ImagingAllocateArray(im, &ImagingDefaultArena, dirty, ImagingDefaultArena.block_size);
+    MUTEX_UNLOCK(&ImagingDefaultArena.mutex);
+    if (tmp) {
         return im;
     }
 
     ImagingError_Clear();
 
     // Try to allocate the image once more with smallest possible block size
-    if (ImagingAllocateArray(im, dirty, IMAGING_PAGE_SIZE)) {
+    MUTEX_LOCK(&ImagingDefaultArena.mutex);
+    tmp = ImagingAllocateArray(im, &ImagingDefaultArena, dirty, IMAGING_PAGE_SIZE);
+    MUTEX_UNLOCK(&ImagingDefaultArena.mutex);
+    if (tmp) {
         return im;
     }
 

From 9f110aa702b0faef7f1ecc218fce3984d89b389a Mon Sep 17 00:00:00 2001
From: "pre-commit-ci[bot]"
 <66853113+pre-commit-ci[bot]@users.noreply.github.com>
Date: Tue, 16 Jul 2024 14:47:12 +0000
Subject: [PATCH 0825/1178] [pre-commit.ci] auto fixes from pre-commit.com
 hooks

for more information, see https://pre-commit.ci
---
 src/libImaging/Storage.c | 3 ++-
 1 file changed, 2 insertions(+), 1 deletion(-)

diff --git a/src/libImaging/Storage.c b/src/libImaging/Storage.c
index 9331ed5d538..8b6d46da6a6 100644
--- a/src/libImaging/Storage.c
+++ b/src/libImaging/Storage.c
@@ -503,7 +503,8 @@ ImagingNewInternal(const char *mode, int xsize, int ysize, int dirty) {
     }
 
     MUTEX_LOCK(&ImagingDefaultArena.mutex);
-    Imaging tmp = ImagingAllocateArray(im, &ImagingDefaultArena, dirty, ImagingDefaultArena.block_size);
+    Imaging tmp = ImagingAllocateArray(
+        im, &ImagingDefaultArena, dirty, ImagingDefaultArena.block_size);
     MUTEX_UNLOCK(&ImagingDefaultArena.mutex);
     if (tmp) {
         return im;

From 5999b9b0ccefe916c364490d7de86a71ea383b96 Mon Sep 17 00:00:00 2001
From: Lysandros Nikolaou <lisandrosnik@gmail.com>
Date: Tue, 16 Jul 2024 16:56:15 +0200
Subject: [PATCH 0826/1178] Initialize PyMutex only under the free-threaded
 build

---
 src/libImaging/Storage.c | 2 ++
 1 file changed, 2 insertions(+)

diff --git a/src/libImaging/Storage.c b/src/libImaging/Storage.c
index 8b6d46da6a6..3a49113b62b 100644
--- a/src/libImaging/Storage.c
+++ b/src/libImaging/Storage.c
@@ -270,7 +270,9 @@ struct ImagingMemoryArena ImagingDefaultArena = {
     0,
     0,
     0,  // Stats
+#ifdef Py_GIL_DISABLED
     {0},
+#endif
 };
 
 int

From 06767fc3257fdd7932c2c04d7bc83cc26a0899a5 Mon Sep 17 00:00:00 2001
From: Lysandros Nikolaou <lisandrosnik@gmail.com>
Date: Tue, 16 Jul 2024 17:00:14 +0200
Subject: [PATCH 0827/1178] Address feedback; do not lock in a loop

---
 src/libImaging/Storage.c | 4 ++--
 1 file changed, 2 insertions(+), 2 deletions(-)

diff --git a/src/libImaging/Storage.c b/src/libImaging/Storage.c
index 3a49113b62b..a680fe63cd6 100644
--- a/src/libImaging/Storage.c
+++ b/src/libImaging/Storage.c
@@ -369,12 +369,12 @@ ImagingDestroyArray(Imaging im) {
     int y = 0;
 
     if (im->blocks) {
+        MUTEX_LOCK(&ImagingDefaultArena.mutex);
         while (im->blocks[y].ptr) {
-            MUTEX_LOCK(&ImagingDefaultArena.mutex);
             memory_return_block(&ImagingDefaultArena, im->blocks[y]);
-            MUTEX_UNLOCK(&ImagingDefaultArena.mutex);
             y += 1;
         }
+        MUTEX_UNLOCK(&ImagingDefaultArena.mutex);
         free(im->blocks);
     }
 }

From 98b173928ad434d53c0e9ced859fcf1f14cf8e8f Mon Sep 17 00:00:00 2001
From: Lysandros Nikolaou <lisandrosnik@gmail.com>
Date: Tue, 16 Jul 2024 21:31:29 +0200
Subject: [PATCH 0828/1178] Address more feedback; don't unlock around sizeof

---
 src/_imaging.c | 6 ++----
 1 file changed, 2 insertions(+), 4 deletions(-)

diff --git a/src/_imaging.c b/src/_imaging.c
index 66709d9bc66..15520040f27 100644
--- a/src/_imaging.c
+++ b/src/_imaging.c
@@ -4093,10 +4093,8 @@ _set_blocks_max(PyObject *self, PyObject *args) {
         return NULL;
     }
 
-    MUTEX_LOCK(&ImagingDefaultArena.mutex);
-    size_t blocksize = sizeof(ImagingDefaultArena.blocks_pool[0]);
-    MUTEX_UNLOCK(&ImagingDefaultArena.mutex);
-    if ((unsigned long)blocks_max > SIZE_MAX / blocksize) {
+    if ((unsigned long)blocks_max > SIZE_MAX /
+            sizeof(ImagingDefaultArena.blocks_pool[0])) {
         PyErr_SetString(PyExc_ValueError, "blocks_max is too large");
         return NULL;
     }

From e144707520f2db6256927028cbaee02f8337b73d Mon Sep 17 00:00:00 2001
From: "pre-commit-ci[bot]"
 <66853113+pre-commit-ci[bot]@users.noreply.github.com>
Date: Tue, 16 Jul 2024 19:31:59 +0000
Subject: [PATCH 0829/1178] [pre-commit.ci] auto fixes from pre-commit.com
 hooks

for more information, see https://pre-commit.ci
---
 src/_imaging.c | 4 ++--
 1 file changed, 2 insertions(+), 2 deletions(-)

diff --git a/src/_imaging.c b/src/_imaging.c
index 15520040f27..f1071b1ceab 100644
--- a/src/_imaging.c
+++ b/src/_imaging.c
@@ -4093,8 +4093,8 @@ _set_blocks_max(PyObject *self, PyObject *args) {
         return NULL;
     }
 
-    if ((unsigned long)blocks_max > SIZE_MAX /
-            sizeof(ImagingDefaultArena.blocks_pool[0])) {
+    if ((unsigned long)blocks_max >
+        SIZE_MAX / sizeof(ImagingDefaultArena.blocks_pool[0])) {
         PyErr_SetString(PyExc_ValueError, "blocks_max is too large");
         return NULL;
     }

From 31469407166026ec6d74d2df07196ef2d4e32ab4 Mon Sep 17 00:00:00 2001
From: Andrew Murray <radarhere@users.noreply.github.com>
Date: Wed, 17 Jul 2024 08:26:05 +1000
Subject: [PATCH 0830/1178] Temporarily disable cifuzz

---
 .github/workflows/cifuzz.yml | 2 ++
 1 file changed, 2 insertions(+)

diff --git a/.github/workflows/cifuzz.yml b/.github/workflows/cifuzz.yml
index eb73fc6a7cd..033ff98ce74 100644
--- a/.github/workflows/cifuzz.yml
+++ b/.github/workflows/cifuzz.yml
@@ -24,6 +24,8 @@ concurrency:
 
 jobs:
   Fuzzing:
+    # Disabled until google/oss-fuzz#11419 upgrades Python to 3.9+
+    if: false
     runs-on: ubuntu-latest
     steps:
     - name: Build Fuzzers

From a3f93b3f68804d7c459faee165edf021e54f850a Mon Sep 17 00:00:00 2001
From: Andrew Murray <radarhere@users.noreply.github.com>
Date: Wed, 17 Jul 2024 16:23:29 +1000
Subject: [PATCH 0831/1178] Changed ContainerIO to subclass IO

---
 Tests/test_file_container.py | 91 +++++++++++++++++++++++++++++++-----
 pyproject.toml               |  1 -
 src/PIL/ContainerIO.py       | 72 ++++++++++++++++++++++++----
 src/PIL/TarIO.py             | 10 ----
 4 files changed, 142 insertions(+), 32 deletions(-)

diff --git a/Tests/test_file_container.py b/Tests/test_file_container.py
index 7f76fb47a6a..237045acc7b 100644
--- a/Tests/test_file_container.py
+++ b/Tests/test_file_container.py
@@ -1,7 +1,5 @@
 from __future__ import annotations
 
-from typing import Literal
-
 import pytest
 
 from PIL import ContainerIO, Image
@@ -23,6 +21,13 @@ def test_isatty() -> None:
     assert container.isatty() is False
 
 
+def test_seekable() -> None:
+    with hopper() as im:
+        container = ContainerIO.ContainerIO(im, 0, 0)
+
+    assert container.seekable() is True
+
+
 @pytest.mark.parametrize(
     "mode, expected_position",
     (
@@ -31,7 +36,7 @@ def test_isatty() -> None:
         (2, 100),
     ),
 )
-def test_seek_mode(mode: Literal[0, 1, 2], expected_position: int) -> None:
+def test_seek_mode(mode: int, expected_position: int) -> None:
     # Arrange
     with open(TEST_FILE, "rb") as fh:
         container = ContainerIO.ContainerIO(fh, 22, 100)
@@ -44,6 +49,14 @@ def test_seek_mode(mode: Literal[0, 1, 2], expected_position: int) -> None:
         assert container.tell() == expected_position
 
 
+@pytest.mark.parametrize("bytesmode", (True, False))
+def test_readable(bytesmode: bool) -> None:
+    with open(TEST_FILE, "rb" if bytesmode else "r") as fh:
+        container = ContainerIO.ContainerIO(fh, 0, 120)
+
+    assert container.readable() is True
+
+
 @pytest.mark.parametrize("bytesmode", (True, False))
 def test_read_n0(bytesmode: bool) -> None:
     # Arrange
@@ -51,7 +64,7 @@ def test_read_n0(bytesmode: bool) -> None:
         container = ContainerIO.ContainerIO(fh, 22, 100)
 
         # Act
-        container.seek(81)
+        assert container.seek(81) == 81
         data = container.read()
 
         # Assert
@@ -67,7 +80,7 @@ def test_read_n(bytesmode: bool) -> None:
         container = ContainerIO.ContainerIO(fh, 22, 100)
 
         # Act
-        container.seek(81)
+        assert container.seek(81) == 81
         data = container.read(3)
 
         # Assert
@@ -83,7 +96,7 @@ def test_read_eof(bytesmode: bool) -> None:
         container = ContainerIO.ContainerIO(fh, 22, 100)
 
         # Act
-        container.seek(100)
+        assert container.seek(100) == 100
         data = container.read()
 
         # Assert
@@ -94,21 +107,65 @@ def test_read_eof(bytesmode: bool) -> None:
 
 @pytest.mark.parametrize("bytesmode", (True, False))
 def test_readline(bytesmode: bool) -> None:
-    # Arrange
     with open(TEST_FILE, "rb" if bytesmode else "r") as fh:
         container = ContainerIO.ContainerIO(fh, 0, 120)
 
-        # Act
         data = container.readline()
-
-        # Assert
         if bytesmode:
             data = data.decode()
         assert data == "This is line 1\n"
 
+        data = container.readline(4)
+        if bytesmode:
+            data = data.decode()
+        assert data == "This"
+
 
 @pytest.mark.parametrize("bytesmode", (True, False))
 def test_readlines(bytesmode: bool) -> None:
+    expected = [
+        "This is line 1\n",
+        "This is line 2\n",
+        "This is line 3\n",
+        "This is line 4\n",
+        "This is line 5\n",
+        "This is line 6\n",
+        "This is line 7\n",
+        "This is line 8\n",
+    ]
+    with open(TEST_FILE, "rb" if bytesmode else "r") as fh:
+        container = ContainerIO.ContainerIO(fh, 0, 120)
+
+        data = container.readlines()
+        if bytesmode:
+            data = [line.decode() for line in data]
+        assert data == expected
+
+        assert container.seek(0) == 0
+
+        data = container.readlines(2)
+        if bytesmode:
+            data = [line.decode() for line in data]
+        assert data == expected[:2]
+
+
+@pytest.mark.parametrize("bytesmode", (True, False))
+def test_write(bytesmode: bool) -> None:
+    with open(TEST_FILE, "rb" if bytesmode else "r") as fh:
+        container = ContainerIO.ContainerIO(fh, 0, 120)
+
+        assert container.writable() is False
+
+        with pytest.raises(NotImplementedError):
+            container.write(b"" if bytesmode else "")
+        with pytest.raises(NotImplementedError):
+            container.writelines([])
+        with pytest.raises(NotImplementedError):
+            container.truncate()
+
+
+@pytest.mark.parametrize("bytesmode", (True, False))
+def test_iter(bytesmode: bool) -> None:
     # Arrange
     expected = [
         "This is line 1\n",
@@ -124,9 +181,21 @@ def test_readlines(bytesmode: bool) -> None:
         container = ContainerIO.ContainerIO(fh, 0, 120)
 
         # Act
-        data = container.readlines()
+        data = []
+        for line in container:
+            data.append(line)
 
         # Assert
         if bytesmode:
             data = [line.decode() for line in data]
         assert data == expected
+
+
+@pytest.mark.parametrize("bytesmode", (True, False))
+def test_file(bytesmode: bool) -> None:
+    with open(TEST_FILE, "rb" if bytesmode else "r") as fh:
+        container = ContainerIO.ContainerIO(fh, 0, 120)
+
+        assert isinstance(container.fileno(), int)
+        container.flush()
+        container.close()
diff --git a/pyproject.toml b/pyproject.toml
index cd724866984..b76f3c24d2e 100644
--- a/pyproject.toml
+++ b/pyproject.toml
@@ -161,5 +161,4 @@ exclude = [
   '^Tests/test_qt_image_qapplication.py$',
   '^Tests/test_font_pcf_charsets.py$',
   '^Tests/test_font_pcf.py$',
-  '^Tests/test_file_tar.py$',
 ]
diff --git a/src/PIL/ContainerIO.py b/src/PIL/ContainerIO.py
index 0035296a45c..ec9e66c714f 100644
--- a/src/PIL/ContainerIO.py
+++ b/src/PIL/ContainerIO.py
@@ -16,10 +16,11 @@
 from __future__ import annotations
 
 import io
-from typing import IO, AnyStr, Generic, Literal
+from collections.abc import Iterable
+from typing import IO, AnyStr, NoReturn
 
 
-class ContainerIO(Generic[AnyStr]):
+class ContainerIO(IO[AnyStr]):
     """
     A file object that provides read access to a part of an existing
     file (for example a TAR file).
@@ -45,7 +46,10 @@ def __init__(self, file: IO[AnyStr], offset: int, length: int) -> None:
     def isatty(self) -> bool:
         return False
 
-    def seek(self, offset: int, mode: Literal[0, 1, 2] = io.SEEK_SET) -> None:
+    def seekable(self) -> bool:
+        return True
+
+    def seek(self, offset: int, mode: int = io.SEEK_SET) -> int:
         """
         Move file pointer.
 
@@ -53,6 +57,7 @@ def seek(self, offset: int, mode: Literal[0, 1, 2] = io.SEEK_SET) -> None:
         :param mode: Starting position. Use 0 for beginning of region, 1
            for current offset, and 2 for end of region.  You cannot move
            the pointer outside the defined region.
+        :returns: Offset from start of region, in bytes.
         """
         if mode == 1:
             self.pos = self.pos + offset
@@ -63,6 +68,7 @@ def seek(self, offset: int, mode: Literal[0, 1, 2] = io.SEEK_SET) -> None:
         # clamp
         self.pos = max(0, min(self.pos, self.length))
         self.fh.seek(self.offset + self.pos)
+        return self.pos
 
     def tell(self) -> int:
         """
@@ -72,27 +78,32 @@ def tell(self) -> int:
         """
         return self.pos
 
-    def read(self, n: int = 0) -> AnyStr:
+    def readable(self) -> bool:
+        return True
+
+    def read(self, n: int = -1) -> AnyStr:
         """
         Read data.
 
-        :param n: Number of bytes to read. If omitted or zero,
+        :param n: Number of bytes to read. If omitted, zero or negative,
             read until end of region.
         :returns: An 8-bit string.
         """
-        if n:
+        if n > 0:
             n = min(n, self.length - self.pos)
         else:
             n = self.length - self.pos
-        if not n:  # EOF
+        if n <= 0:  # EOF
             return b"" if "b" in self.fh.mode else ""  # type: ignore[return-value]
         self.pos = self.pos + n
         return self.fh.read(n)
 
-    def readline(self) -> AnyStr:
+    def readline(self, n: int = -1) -> AnyStr:
         """
         Read a line of text.
 
+        :param n: Number of bytes to read. If omitted, zero or negative,
+            read until end of line.
         :returns: An 8-bit string.
         """
         s: AnyStr = b"" if "b" in self.fh.mode else ""  # type: ignore[assignment]
@@ -102,14 +113,16 @@ def readline(self) -> AnyStr:
             if not c:
                 break
             s = s + c
-            if c == newline_character:
+            if c == newline_character or len(s) == n:
                 break
         return s
 
-    def readlines(self) -> list[AnyStr]:
+    def readlines(self, n: int | None = -1) -> list[AnyStr]:
         """
         Read multiple lines of text.
 
+        :param n: Number of lines to read. If omitted, zero, negative or None,
+            read until end of region.
         :returns: A list of 8-bit strings.
         """
         lines = []
@@ -118,4 +131,43 @@ def readlines(self) -> list[AnyStr]:
             if not s:
                 break
             lines.append(s)
+            if len(lines) == n:
+                break
         return lines
+
+    def writable(self) -> bool:
+        return False
+
+    def write(self, b: AnyStr) -> NoReturn:
+        raise NotImplementedError()
+
+    def writelines(self, lines: Iterable[AnyStr]) -> NoReturn:
+        raise NotImplementedError()
+
+    def truncate(self, size: int | None = None) -> int:
+        raise NotImplementedError()
+
+    def __enter__(self) -> ContainerIO[AnyStr]:
+        return self
+
+    def __exit__(self, *args: object) -> None:
+        self.close()
+
+    def __iter__(self) -> ContainerIO[AnyStr]:
+        return self
+
+    def __next__(self) -> AnyStr:
+        line = self.readline()
+        if not line:
+            msg = "end of region"
+            raise StopIteration(msg)
+        return line
+
+    def fileno(self) -> int:
+        return self.fh.fileno()
+
+    def flush(self) -> None:
+        self.fh.flush()
+
+    def close(self) -> None:
+        self.fh.close()
diff --git a/src/PIL/TarIO.py b/src/PIL/TarIO.py
index cba26d4b059..779288b1ce3 100644
--- a/src/PIL/TarIO.py
+++ b/src/PIL/TarIO.py
@@ -55,13 +55,3 @@ def __init__(self, tarfile: str, file: str) -> None:
 
         # Open region
         super().__init__(self.fh, self.fh.tell(), size)
-
-    # Context manager support
-    def __enter__(self) -> TarIO:
-        return self
-
-    def __exit__(self, *args: object) -> None:
-        self.close()
-
-    def close(self) -> None:
-        self.fh.close()

From 10faa5df390c160570110b48bd4cd03fa4390dc6 Mon Sep 17 00:00:00 2001
From: Andrew Murray <radarhere@users.noreply.github.com>
Date: Wed, 17 Jul 2024 22:08:53 +1000
Subject: [PATCH 0832/1178] Deprecate lambda_eval and unsafe_eval options
 argument

---
 Tests/test_imagemath_lambda_eval.py | 65 ++++++++++++++++------------
 Tests/test_imagemath_unsafe_eval.py | 67 ++++++++++++++++-------------
 docs/deprecations.rst               |  9 ++++
 docs/reference/ImageMath.rst        | 16 +++----
 docs/releasenotes/11.0.0.rst        |  8 ++--
 src/PIL/ImageMath.py                | 24 ++++++++---
 6 files changed, 115 insertions(+), 74 deletions(-)

diff --git a/Tests/test_imagemath_lambda_eval.py b/Tests/test_imagemath_lambda_eval.py
index 5769c903e49..360325780bb 100644
--- a/Tests/test_imagemath_lambda_eval.py
+++ b/Tests/test_imagemath_lambda_eval.py
@@ -1,5 +1,9 @@
 from __future__ import annotations
 
+from typing import Any
+
+import pytest
+
 from PIL import Image, ImageMath
 
 
@@ -19,7 +23,7 @@ def pixel(im: Image.Image | int) -> str | int:
 A2 = A.resize((2, 2))
 B2 = B.resize((2, 2))
 
-images = {"A": A, "B": B, "F": F, "I": I}
+images: dict[str, Any] = {"A": A, "B": B, "F": F, "I": I}
 
 
 def test_sanity() -> None:
@@ -30,13 +34,13 @@ def test_sanity() -> None:
         == "I 3"
     )
     assert (
-        pixel(ImageMath.lambda_eval(lambda args: args["A"] + args["B"], images))
+        pixel(ImageMath.lambda_eval(lambda args: args["A"] + args["B"], **images))
         == "I 3"
     )
     assert (
         pixel(
             ImageMath.lambda_eval(
-                lambda args: args["float"](args["A"]) + args["B"], images
+                lambda args: args["float"](args["A"]) + args["B"], **images
             )
         )
         == "F 3.0"
@@ -44,42 +48,47 @@ def test_sanity() -> None:
     assert (
         pixel(
             ImageMath.lambda_eval(
-                lambda args: args["int"](args["float"](args["A"]) + args["B"]), images
+                lambda args: args["int"](args["float"](args["A"]) + args["B"]), **images
             )
         )
         == "I 3"
     )
 
 
+def test_options_deprecated() -> None:
+    with pytest.warns(DeprecationWarning):
+        assert ImageMath.lambda_eval(lambda args: 1, images) == 1
+
+
 def test_ops() -> None:
-    assert pixel(ImageMath.lambda_eval(lambda args: args["A"] * -1, images)) == "I -1"
+    assert pixel(ImageMath.lambda_eval(lambda args: args["A"] * -1, **images)) == "I -1"
 
     assert (
-        pixel(ImageMath.lambda_eval(lambda args: args["A"] + args["B"], images))
+        pixel(ImageMath.lambda_eval(lambda args: args["A"] + args["B"], **images))
         == "I 3"
     )
     assert (
-        pixel(ImageMath.lambda_eval(lambda args: args["A"] - args["B"], images))
+        pixel(ImageMath.lambda_eval(lambda args: args["A"] - args["B"], **images))
         == "I -1"
     )
     assert (
-        pixel(ImageMath.lambda_eval(lambda args: args["A"] * args["B"], images))
+        pixel(ImageMath.lambda_eval(lambda args: args["A"] * args["B"], **images))
         == "I 2"
     )
     assert (
-        pixel(ImageMath.lambda_eval(lambda args: args["A"] / args["B"], images))
+        pixel(ImageMath.lambda_eval(lambda args: args["A"] / args["B"], **images))
         == "I 0"
     )
-    assert pixel(ImageMath.lambda_eval(lambda args: args["B"] ** 2, images)) == "I 4"
+    assert pixel(ImageMath.lambda_eval(lambda args: args["B"] ** 2, **images)) == "I 4"
     assert (
-        pixel(ImageMath.lambda_eval(lambda args: args["B"] ** 33, images))
+        pixel(ImageMath.lambda_eval(lambda args: args["B"] ** 33, **images))
         == "I 2147483647"
     )
 
     assert (
         pixel(
             ImageMath.lambda_eval(
-                lambda args: args["float"](args["A"]) + args["B"], images
+                lambda args: args["float"](args["A"]) + args["B"], **images
             )
         )
         == "F 3.0"
@@ -87,7 +96,7 @@ def test_ops() -> None:
     assert (
         pixel(
             ImageMath.lambda_eval(
-                lambda args: args["float"](args["A"]) - args["B"], images
+                lambda args: args["float"](args["A"]) - args["B"], **images
             )
         )
         == "F -1.0"
@@ -95,7 +104,7 @@ def test_ops() -> None:
     assert (
         pixel(
             ImageMath.lambda_eval(
-                lambda args: args["float"](args["A"]) * args["B"], images
+                lambda args: args["float"](args["A"]) * args["B"], **images
             )
         )
         == "F 2.0"
@@ -103,31 +112,33 @@ def test_ops() -> None:
     assert (
         pixel(
             ImageMath.lambda_eval(
-                lambda args: args["float"](args["A"]) / args["B"], images
+                lambda args: args["float"](args["A"]) / args["B"], **images
             )
         )
         == "F 0.5"
     )
     assert (
-        pixel(ImageMath.lambda_eval(lambda args: args["float"](args["B"]) ** 2, images))
+        pixel(
+            ImageMath.lambda_eval(lambda args: args["float"](args["B"]) ** 2, **images)
+        )
         == "F 4.0"
     )
     assert (
         pixel(
-            ImageMath.lambda_eval(lambda args: args["float"](args["B"]) ** 33, images)
+            ImageMath.lambda_eval(lambda args: args["float"](args["B"]) ** 33, **images)
         )
         == "F 8589934592.0"
     )
 
 
 def test_logical() -> None:
-    assert pixel(ImageMath.lambda_eval(lambda args: not args["A"], images)) == 0
+    assert pixel(ImageMath.lambda_eval(lambda args: not args["A"], **images)) == 0
     assert (
-        pixel(ImageMath.lambda_eval(lambda args: args["A"] and args["B"], images))
+        pixel(ImageMath.lambda_eval(lambda args: args["A"] and args["B"], **images))
         == "L 2"
     )
     assert (
-        pixel(ImageMath.lambda_eval(lambda args: args["A"] or args["B"], images))
+        pixel(ImageMath.lambda_eval(lambda args: args["A"] or args["B"], **images))
         == "L 1"
     )
 
@@ -136,7 +147,7 @@ def test_convert() -> None:
     assert (
         pixel(
             ImageMath.lambda_eval(
-                lambda args: args["convert"](args["A"] + args["B"], "L"), images
+                lambda args: args["convert"](args["A"] + args["B"], "L"), **images
             )
         )
         == "L 3"
@@ -144,7 +155,7 @@ def test_convert() -> None:
     assert (
         pixel(
             ImageMath.lambda_eval(
-                lambda args: args["convert"](args["A"] + args["B"], "1"), images
+                lambda args: args["convert"](args["A"] + args["B"], "1"), **images
             )
         )
         == "1 0"
@@ -152,7 +163,7 @@ def test_convert() -> None:
     assert (
         pixel(
             ImageMath.lambda_eval(
-                lambda args: args["convert"](args["A"] + args["B"], "RGB"), images
+                lambda args: args["convert"](args["A"] + args["B"], "RGB"), **images
             )
         )
         == "RGB (3, 3, 3)"
@@ -163,7 +174,7 @@ def test_compare() -> None:
     assert (
         pixel(
             ImageMath.lambda_eval(
-                lambda args: args["min"](args["A"], args["B"]), images
+                lambda args: args["min"](args["A"], args["B"]), **images
             )
         )
         == "I 1"
@@ -171,13 +182,13 @@ def test_compare() -> None:
     assert (
         pixel(
             ImageMath.lambda_eval(
-                lambda args: args["max"](args["A"], args["B"]), images
+                lambda args: args["max"](args["A"], args["B"]), **images
             )
         )
         == "I 2"
     )
-    assert pixel(ImageMath.lambda_eval(lambda args: args["A"] == 1, images)) == "I 1"
-    assert pixel(ImageMath.lambda_eval(lambda args: args["A"] == 2, images)) == "I 0"
+    assert pixel(ImageMath.lambda_eval(lambda args: args["A"] == 1, **images)) == "I 1"
+    assert pixel(ImageMath.lambda_eval(lambda args: args["A"] == 2, **images)) == "I 0"
 
 
 def test_one_image_larger() -> None:
diff --git a/Tests/test_imagemath_unsafe_eval.py b/Tests/test_imagemath_unsafe_eval.py
index 7b8a562d739..b7ac8469180 100644
--- a/Tests/test_imagemath_unsafe_eval.py
+++ b/Tests/test_imagemath_unsafe_eval.py
@@ -1,5 +1,7 @@
 from __future__ import annotations
 
+from typing import Any
+
 import pytest
 
 from PIL import Image, ImageMath
@@ -21,16 +23,16 @@ def pixel(im: Image.Image | int) -> str | int:
 A2 = A.resize((2, 2))
 B2 = B.resize((2, 2))
 
-images = {"A": A, "B": B, "F": F, "I": I}
+images: dict[str, Any] = {"A": A, "B": B, "F": F, "I": I}
 
 
 def test_sanity() -> None:
     assert ImageMath.unsafe_eval("1") == 1
     assert ImageMath.unsafe_eval("1+A", A=2) == 3
     assert pixel(ImageMath.unsafe_eval("A+B", A=A, B=B)) == "I 3"
-    assert pixel(ImageMath.unsafe_eval("A+B", images)) == "I 3"
-    assert pixel(ImageMath.unsafe_eval("float(A)+B", images)) == "F 3.0"
-    assert pixel(ImageMath.unsafe_eval("int(float(A)+B)", images)) == "I 3"
+    assert pixel(ImageMath.unsafe_eval("A+B", **images)) == "I 3"
+    assert pixel(ImageMath.unsafe_eval("float(A)+B", **images)) == "F 3.0"
+    assert pixel(ImageMath.unsafe_eval("int(float(A)+B)", **images)) == "I 3"
 
 
 def test_eval_deprecated() -> None:
@@ -38,23 +40,28 @@ def test_eval_deprecated() -> None:
         assert ImageMath.eval("1") == 1
 
 
+def test_options_deprecated() -> None:
+    with pytest.warns(DeprecationWarning):
+        assert ImageMath.unsafe_eval("1", images) == 1
+
+
 def test_ops() -> None:
-    assert pixel(ImageMath.unsafe_eval("-A", images)) == "I -1"
-    assert pixel(ImageMath.unsafe_eval("+B", images)) == "L 2"
+    assert pixel(ImageMath.unsafe_eval("-A", **images)) == "I -1"
+    assert pixel(ImageMath.unsafe_eval("+B", **images)) == "L 2"
 
-    assert pixel(ImageMath.unsafe_eval("A+B", images)) == "I 3"
-    assert pixel(ImageMath.unsafe_eval("A-B", images)) == "I -1"
-    assert pixel(ImageMath.unsafe_eval("A*B", images)) == "I 2"
-    assert pixel(ImageMath.unsafe_eval("A/B", images)) == "I 0"
-    assert pixel(ImageMath.unsafe_eval("B**2", images)) == "I 4"
-    assert pixel(ImageMath.unsafe_eval("B**33", images)) == "I 2147483647"
+    assert pixel(ImageMath.unsafe_eval("A+B", **images)) == "I 3"
+    assert pixel(ImageMath.unsafe_eval("A-B", **images)) == "I -1"
+    assert pixel(ImageMath.unsafe_eval("A*B", **images)) == "I 2"
+    assert pixel(ImageMath.unsafe_eval("A/B", **images)) == "I 0"
+    assert pixel(ImageMath.unsafe_eval("B**2", **images)) == "I 4"
+    assert pixel(ImageMath.unsafe_eval("B**33", **images)) == "I 2147483647"
 
-    assert pixel(ImageMath.unsafe_eval("float(A)+B", images)) == "F 3.0"
-    assert pixel(ImageMath.unsafe_eval("float(A)-B", images)) == "F -1.0"
-    assert pixel(ImageMath.unsafe_eval("float(A)*B", images)) == "F 2.0"
-    assert pixel(ImageMath.unsafe_eval("float(A)/B", images)) == "F 0.5"
-    assert pixel(ImageMath.unsafe_eval("float(B)**2", images)) == "F 4.0"
-    assert pixel(ImageMath.unsafe_eval("float(B)**33", images)) == "F 8589934592.0"
+    assert pixel(ImageMath.unsafe_eval("float(A)+B", **images)) == "F 3.0"
+    assert pixel(ImageMath.unsafe_eval("float(A)-B", **images)) == "F -1.0"
+    assert pixel(ImageMath.unsafe_eval("float(A)*B", **images)) == "F 2.0"
+    assert pixel(ImageMath.unsafe_eval("float(A)/B", **images)) == "F 0.5"
+    assert pixel(ImageMath.unsafe_eval("float(B)**2", **images)) == "F 4.0"
+    assert pixel(ImageMath.unsafe_eval("float(B)**33", **images)) == "F 8589934592.0"
 
 
 @pytest.mark.parametrize(
@@ -72,33 +79,33 @@ def test_prevent_exec(expression: str) -> None:
 
 def test_prevent_double_underscores() -> None:
     with pytest.raises(ValueError):
-        ImageMath.unsafe_eval("1", {"__": None})
+        ImageMath.unsafe_eval("1", __=None)
 
 
 def test_prevent_builtins() -> None:
     with pytest.raises(ValueError):
-        ImageMath.unsafe_eval("(lambda: exec('exit()'))()", {"exec": None})
+        ImageMath.unsafe_eval("(lambda: exec('exit()'))()", exec=None)
 
 
 def test_logical() -> None:
-    assert pixel(ImageMath.unsafe_eval("not A", images)) == 0
-    assert pixel(ImageMath.unsafe_eval("A and B", images)) == "L 2"
-    assert pixel(ImageMath.unsafe_eval("A or B", images)) == "L 1"
+    assert pixel(ImageMath.unsafe_eval("not A", **images)) == 0
+    assert pixel(ImageMath.unsafe_eval("A and B", **images)) == "L 2"
+    assert pixel(ImageMath.unsafe_eval("A or B", **images)) == "L 1"
 
 
 def test_convert() -> None:
-    assert pixel(ImageMath.unsafe_eval("convert(A+B, 'L')", images)) == "L 3"
-    assert pixel(ImageMath.unsafe_eval("convert(A+B, '1')", images)) == "1 0"
+    assert pixel(ImageMath.unsafe_eval("convert(A+B, 'L')", **images)) == "L 3"
+    assert pixel(ImageMath.unsafe_eval("convert(A+B, '1')", **images)) == "1 0"
     assert (
-        pixel(ImageMath.unsafe_eval("convert(A+B, 'RGB')", images)) == "RGB (3, 3, 3)"
+        pixel(ImageMath.unsafe_eval("convert(A+B, 'RGB')", **images)) == "RGB (3, 3, 3)"
     )
 
 
 def test_compare() -> None:
-    assert pixel(ImageMath.unsafe_eval("min(A, B)", images)) == "I 1"
-    assert pixel(ImageMath.unsafe_eval("max(A, B)", images)) == "I 2"
-    assert pixel(ImageMath.unsafe_eval("A == 1", images)) == "I 1"
-    assert pixel(ImageMath.unsafe_eval("A == 2", images)) == "I 0"
+    assert pixel(ImageMath.unsafe_eval("min(A, B)", **images)) == "I 1"
+    assert pixel(ImageMath.unsafe_eval("max(A, B)", **images)) == "I 2"
+    assert pixel(ImageMath.unsafe_eval("A == 1", **images)) == "I 1"
+    assert pixel(ImageMath.unsafe_eval("A == 2", **images)) == "I 0"
 
 
 def test_one_image_larger() -> None:
diff --git a/docs/deprecations.rst b/docs/deprecations.rst
index 792fd1c7049..2f5800e0711 100644
--- a/docs/deprecations.rst
+++ b/docs/deprecations.rst
@@ -109,6 +109,15 @@ ImageDraw.getdraw hints parameter
 
 The ``hints`` parameter in :py:meth:`~PIL.ImageDraw.getdraw()` has been deprecated.
 
+ImageMath.lambda_eval and ImageMath.unsafe_eval options parameter
+^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
+
+.. deprecated:: 11.0.0
+
+The ``options`` parameter in :py:meth:`~PIL.ImageMath.lambda_eval()` and
+:py:meth:`~PIL.ImageMath.unsafe_eval()` has been deprecated. One or more keyword
+arguments can be used instead.
+
 Removed features
 ----------------
 
diff --git a/docs/reference/ImageMath.rst b/docs/reference/ImageMath.rst
index 2535db7113c..a72ca92d049 100644
--- a/docs/reference/ImageMath.rst
+++ b/docs/reference/ImageMath.rst
@@ -37,10 +37,10 @@ Example: Using the :py:mod:`~PIL.ImageMath` module
 
     :param expression: A function that receives a dictionary.
     :param options: Values to add to the function's dictionary, mapping image
-                    names to Image instances. You can use one or more keyword
-                    arguments instead of a dictionary, as shown in the above
-                    example. Note that the names must be valid Python
-                    identifiers.
+                    names to Image instances. Deprecated.
+                    You can instead use one or more keyword arguments, as
+                    shown in the above example. Note that the names must be
+                    valid Python identifiers.
     :return: An image, an integer value, a floating point value,
              or a pixel tuple, depending on the expression.
 
@@ -62,10 +62,10 @@ Example: Using the :py:mod:`~PIL.ImageMath` module
                        syntax. In addition to the standard operators, you can
                        also use the functions described below.
     :param options: Values to add to the function's dictionary, mapping image
-                    names to Image instances. You can use one or more keyword
-                    arguments instead of a dictionary, as shown in the above
-                    example. Note that the names must be valid Python
-                    identifiers.
+                    names to Image instances. Deprecated.
+                    You can instead use one or more keyword arguments, as
+                    shown in the above example. Note that the names must be
+                    valid Python identifiers.
     :return: An image, an integer value, a floating point value,
              or a pixel tuple, depending on the expression.
 
diff --git a/docs/releasenotes/11.0.0.rst b/docs/releasenotes/11.0.0.rst
index 964423ae035..bb6179de8c6 100644
--- a/docs/releasenotes/11.0.0.rst
+++ b/docs/releasenotes/11.0.0.rst
@@ -43,10 +43,12 @@ similarly removed.
 Deprecations
 ============
 
-TODO
-^^^^
+ImageMath.lambda_eval and ImageMath.unsafe_eval options parameter
+^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
 
-TODO
+The ``options`` parameter in :py:meth:`~PIL.ImageMath.lambda_eval()` and
+:py:meth:`~PIL.ImageMath.unsafe_eval()` has been deprecated. One or more
+keyword arguments can be used instead.
 
 API Changes
 ===========
diff --git a/src/PIL/ImageMath.py b/src/PIL/ImageMath.py
index 6664434ea45..e79eb3ec9b5 100644
--- a/src/PIL/ImageMath.py
+++ b/src/PIL/ImageMath.py
@@ -249,14 +249,20 @@ def lambda_eval(
     :py:func:`~PIL.Image.merge` function.
 
     :param expression: A function that receives a dictionary.
-    :param options: Values to add to the function's dictionary. You
-                    can either use a dictionary, or one or more keyword
-                    arguments.
+    :param options: Values to add to the function's dictionary. Deprecated.
+                    You can instead use one or more keyword arguments.
     :return: The expression result. This is usually an image object, but can
              also be an integer, a floating point value, or a pixel tuple,
              depending on the expression.
     """
 
+    if options:
+        deprecate(
+            "ImageMath.lambda_eval options",
+            12,
+            "ImageMath.lambda_eval keyword arguments",
+        )
+
     args: dict[str, Any] = ops.copy()
     args.update(options)
     args.update(kw)
@@ -287,14 +293,20 @@ def unsafe_eval(
     :py:func:`~PIL.Image.merge` function.
 
     :param expression: A string containing a Python-style expression.
-    :param options: Values to add to the evaluation context.  You
-                    can either use a dictionary, or one or more keyword
-                    arguments.
+    :param options: Values to add to the evaluation context. Deprecated.
+                    You can instead use one or more keyword arguments.
     :return: The evaluated expression. This is usually an image object, but can
              also be an integer, a floating point value, or a pixel tuple,
              depending on the expression.
     """
 
+    if options:
+        deprecate(
+            "ImageMath.unsafe_eval options",
+            12,
+            "ImageMath.unsafe_eval keyword arguments",
+        )
+
     # build execution namespace
     args: dict[str, Any] = ops.copy()
     for k in list(options.keys()) + list(kw.keys()):

From 47fc36a323892040b1945afd22d036a15fb99abd Mon Sep 17 00:00:00 2001
From: Andrew Murray <radarhere@users.noreply.github.com>
Date: Wed, 17 Jul 2024 22:28:56 +1000
Subject: [PATCH 0833/1178] Update CHANGES.rst [ci skip]

---
 CHANGES.rst | 9 +++++++++
 1 file changed, 9 insertions(+)

diff --git a/CHANGES.rst b/CHANGES.rst
index 856458aa942..a2e02fe6209 100644
--- a/CHANGES.rst
+++ b/CHANGES.rst
@@ -5,6 +5,15 @@ Changelog (Pillow)
 11.0.0 (unreleased)
 -------------------
 
+- Changed ContainerIO to subclass IO #8240
+  [radarhere]
+
+- Move away from APIs that use borrowed references under the free-threaded build #8216
+  [hugovk, lysnikolaou]
+
+- Allow size argument to resize() to be a NumPy array #8201
+  [radarhere]
+
 - Drop support for Python 3.8 #8183
   [hugovk, radarhere]
 

From f39ca5db5a39c2c82e62fbee1ebf95d5b61bdfba Mon Sep 17 00:00:00 2001
From: Lysandros Nikolaou <lisandrosnik@gmail.com>
Date: Wed, 17 Jul 2024 16:21:16 +0200
Subject: [PATCH 0834/1178] Skip QEMU-emulated wheels on workflow dispatch
 event

---
 .github/workflows/wheels.yml | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/.github/workflows/wheels.yml b/.github/workflows/wheels.yml
index fa1825e45a7..10e37f34387 100644
--- a/.github/workflows/wheels.yml
+++ b/.github/workflows/wheels.yml
@@ -41,7 +41,7 @@ env:
 
 jobs:
   build-1-QEMU-emulated-wheels:
-    if: github.event_name != 'schedule'
+    if: github.event_name != 'schedule' && github.event_name != 'workflow_dispatch'
     name: aarch64 ${{ matrix.python-version }} ${{ matrix.spec }}
     runs-on: ubuntu-latest
     strategy:

From 09c817a2ec7c0dc4988235aa50b8073192b3e9e2 Mon Sep 17 00:00:00 2001
From: Lysandros Nikolaou <lisandrosnik@gmail.com>
Date: Wed, 17 Jul 2024 23:05:48 +0200
Subject: [PATCH 0835/1178] Move uploading nightly wheels to different job

This is needed cause the job does not support running on OS's other
than Ubuntu.
---
 .github/workflows/wheels.yml | 31 +++++++++++++++++--------------
 1 file changed, 17 insertions(+), 14 deletions(-)

diff --git a/.github/workflows/wheels.yml b/.github/workflows/wheels.yml
index 10e37f34387..087d2bd56fd 100644
--- a/.github/workflows/wheels.yml
+++ b/.github/workflows/wheels.yml
@@ -149,13 +149,6 @@ jobs:
           name: dist-${{ matrix.os }}-${{ matrix.cibw_arch }}${{ matrix.manylinux && format('-{0}', matrix.manylinux) }}
           path: ./wheelhouse/*.whl
 
-      - name: Upload wheels to scientific-python-nightly-wheels
-        if: github.event_name == 'schedule' || github.event_name == 'workflow_dispatch'
-        uses: scientific-python/upload-nightly-action@b67d7fcc0396e1128a474d1ab2b48aa94680f9fc # 0.5.0
-        with:
-          artifacts_path: ./wheelhouse
-          anaconda_nightly_upload_token: ${{ secrets.ANACONDA_ORG_UPLOAD_TOKEN }}
-
   windows:
     name: Windows ${{ matrix.cibw_arch }}
     runs-on: windows-latest
@@ -242,13 +235,6 @@ jobs:
           name: fribidi-windows-${{ matrix.cibw_arch }}
           path: winbuild\build\bin\fribidi*
 
-      - name: Upload wheels to scientific-python-nightly-wheels
-        if: github.event_name == 'schedule' || github.event_name == 'workflow_dispatch'
-        uses: scientific-python/upload-nightly-action@b67d7fcc0396e1128a474d1ab2b48aa94680f9fc # 0.5.0
-        with:
-          artifacts_path: ./wheelhouse
-          anaconda_nightly_upload_token: ${{ secrets.ANACONDA_ORG_UPLOAD_TOKEN }}
-
   sdist:
     if: github.event_name != 'schedule'
     runs-on: ubuntu-latest
@@ -269,6 +255,23 @@ jobs:
         name: dist-sdist
         path: dist/*.tar.gz
 
+  scientific-python-nightly-wheels-publish:
+    if: github.event_name == 'schedule' || github.event_name == 'workflow_dispatch'
+    needs: [build-2-native-wheels, windows]
+    runs-on: ubuntu-latest
+    name: Upload release to PyPI
+    steps:
+      - uses: actions/download-artifact@v4
+        with:
+          pattern: dist-*
+          path: dist
+          merge-multiple: true
+      - name: Upload wheels to scientific-python-nightly-wheels
+        uses: scientific-python/upload-nightly-action@b67d7fcc0396e1128a474d1ab2b48aa94680f9fc # 0.5.0
+        with:
+          artifacts_path: dist
+          anaconda_nightly_upload_token: ${{ secrets.ANACONDA_ORG_UPLOAD_TOKEN }}
+
   pypi-publish:
     if: github.event_name == 'push' && startsWith(github.ref, 'refs/tags')
     needs: [build-1-QEMU-emulated-wheels, build-2-native-wheels, windows, sdist]

From 7248cde50b985aba3198b70201fed462a15997d0 Mon Sep 17 00:00:00 2001
From: Andrew Murray <radarhere@users.noreply.github.com>
Date: Thu, 18 Jul 2024 11:00:27 +1000
Subject: [PATCH 0836/1178] Documented keyword arguments

---
 docs/reference/ImageMath.rst | 22 ++++++++++++----------
 src/PIL/ImageMath.py         |  2 ++
 2 files changed, 14 insertions(+), 10 deletions(-)

diff --git a/docs/reference/ImageMath.rst b/docs/reference/ImageMath.rst
index a72ca92d049..f4e1081e6b7 100644
--- a/docs/reference/ImageMath.rst
+++ b/docs/reference/ImageMath.rst
@@ -31,20 +31,21 @@ Example: Using the :py:mod:`~PIL.ImageMath` module
               b=im2
             )
 
-.. py:function:: lambda_eval(expression, options)
+.. py:function:: lambda_eval(expression, options, **kw)
 
     Returns the result of an image function.
 
     :param expression: A function that receives a dictionary.
-    :param options: Values to add to the function's dictionary, mapping image
-                    names to Image instances. Deprecated.
+    :param options: Values to add to the function's dictionary. Note that the names
+                    must be valid Python identifiers. Deprecated.
                     You can instead use one or more keyword arguments, as
-                    shown in the above example. Note that the names must be
-                    valid Python identifiers.
+                    shown in the above example.
+    :param \**kw: Values to add to the function's dictionary, mapping image names to
+                 Image instances.
     :return: An image, an integer value, a floating point value,
              or a pixel tuple, depending on the expression.
 
-.. py:function:: unsafe_eval(expression, options)
+.. py:function:: unsafe_eval(expression, options, **kw)
 
     Evaluates an image expression.
 
@@ -61,11 +62,12 @@ Example: Using the :py:mod:`~PIL.ImageMath` module
     :param expression: A string which uses the standard Python expression
                        syntax. In addition to the standard operators, you can
                        also use the functions described below.
-    :param options: Values to add to the function's dictionary, mapping image
-                    names to Image instances. Deprecated.
+    :param options: Values to add to the evaluation context. Note that the names must
+                    be valid Python identifiers. Deprecated.
                     You can instead use one or more keyword arguments, as
-                    shown in the above example. Note that the names must be
-                    valid Python identifiers.
+                    shown in the above example.
+    :param \**kw: Values to add to the evaluation context, mapping image names to Image
+                 instances.
     :return: An image, an integer value, a floating point value,
              or a pixel tuple, depending on the expression.
 
diff --git a/src/PIL/ImageMath.py b/src/PIL/ImageMath.py
index e79eb3ec9b5..191cc2a5f88 100644
--- a/src/PIL/ImageMath.py
+++ b/src/PIL/ImageMath.py
@@ -251,6 +251,7 @@ def lambda_eval(
     :param expression: A function that receives a dictionary.
     :param options: Values to add to the function's dictionary. Deprecated.
                     You can instead use one or more keyword arguments.
+    :param **kw: Values to add to the function's dictionary.
     :return: The expression result. This is usually an image object, but can
              also be an integer, a floating point value, or a pixel tuple,
              depending on the expression.
@@ -295,6 +296,7 @@ def unsafe_eval(
     :param expression: A string containing a Python-style expression.
     :param options: Values to add to the evaluation context. Deprecated.
                     You can instead use one or more keyword arguments.
+    :param **kw: Values to add to the evaluation context.
     :return: The evaluated expression. This is usually an image object, but can
              also be an integer, a floating point value, or a pixel tuple,
              depending on the expression.

From a6e93939566619aa1eb10fd5531aa59bb6e39bdc Mon Sep 17 00:00:00 2001
From: Lysandros Nikolaou <lisandrosnik@gmail.com>
Date: Thu, 18 Jul 2024 10:35:09 +0200
Subject: [PATCH 0837/1178] Update .github/workflows/wheels.yml

Co-authored-by: Andrew Murray <3112309+radarhere@users.noreply.github.com>
---
 .github/workflows/wheels.yml | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/.github/workflows/wheels.yml b/.github/workflows/wheels.yml
index 087d2bd56fd..ffd1abd953a 100644
--- a/.github/workflows/wheels.yml
+++ b/.github/workflows/wheels.yml
@@ -259,7 +259,7 @@ jobs:
     if: github.event_name == 'schedule' || github.event_name == 'workflow_dispatch'
     needs: [build-2-native-wheels, windows]
     runs-on: ubuntu-latest
-    name: Upload release to PyPI
+    name: Upload wheels to scientific-python-nightly-wheels
     steps:
       - uses: actions/download-artifact@v4
         with:

From 73dfe67736565805f4c769cdfc92447f2b098187 Mon Sep 17 00:00:00 2001
From: Andrew Murray <radarhere@users.noreply.github.com>
Date: Thu, 18 Jul 2024 22:46:02 +1000
Subject: [PATCH 0838/1178] Update CHANGES.rst [ci skip]

---
 CHANGES.rst | 3 +++
 1 file changed, 3 insertions(+)

diff --git a/CHANGES.rst b/CHANGES.rst
index a2e02fe6209..bd8d3af030c 100644
--- a/CHANGES.rst
+++ b/CHANGES.rst
@@ -5,6 +5,9 @@ Changelog (Pillow)
 11.0.0 (unreleased)
 -------------------
 
+- Deprecate ImageMath lambda_eval and unsafe_eval options argument #8242
+  [radarhere]
+
 - Changed ContainerIO to subclass IO #8240
   [radarhere]
 

From 18d8020cab65a4aaca528f7848adfa06a9de5b85 Mon Sep 17 00:00:00 2001
From: "Jeffrey A. Clark (Alex)" <aclark@aclark.net>
Date: Thu, 18 Jul 2024 15:17:32 -0400
Subject: [PATCH 0839/1178] Add tutorial images

---
 docs/handbook/contrasted_hopper.jpg      | Bin 0 -> 5572 bytes
 docs/handbook/cropped_hopper.jpg         | Bin 0 -> 2017 bytes
 docs/handbook/enhanced_hopper.jpg        | Bin 0 -> 5721 bytes
 docs/handbook/flip_left_right_hopper.jpg | Bin 0 -> 4637 bytes
 docs/handbook/flip_top_bottom_hopper.jpg | Bin 0 -> 4652 bytes
 docs/handbook/masked_hopper.jpg          | Bin 0 -> 4904 bytes
 docs/handbook/merged_hopper.png          | Bin 0 -> 35390 bytes
 docs/handbook/pasted_hopper.jpg          | Bin 0 -> 4645 bytes
 docs/handbook/rebanded_hopper.jpg        | Bin 0 -> 4743 bytes
 docs/handbook/rolled_hopper.jpg          | Bin 0 -> 4651 bytes
 docs/handbook/rotated_hopper.jpg         | Bin 0 -> 4895 bytes
 docs/handbook/rotated_hopper_180.jpg     | Bin 0 -> 4636 bytes
 docs/handbook/rotated_hopper_270.jpg     | Bin 0 -> 4895 bytes
 docs/handbook/rotated_hopper_90.jpg      | Bin 0 -> 4903 bytes
 docs/handbook/show_hopper.png            | Bin 0 -> 56122 bytes
 docs/handbook/thumbnail_hopper.jpg       | Bin 0 -> 1984 bytes
 docs/handbook/transformed_hopper.jpg     | Bin 0 -> 3608 bytes
 docs/handbook/tutorial.rst               |  67 +++++++++++++++++++++++
 18 files changed, 67 insertions(+)
 create mode 100644 docs/handbook/contrasted_hopper.jpg
 create mode 100644 docs/handbook/cropped_hopper.jpg
 create mode 100644 docs/handbook/enhanced_hopper.jpg
 create mode 100644 docs/handbook/flip_left_right_hopper.jpg
 create mode 100644 docs/handbook/flip_top_bottom_hopper.jpg
 create mode 100644 docs/handbook/masked_hopper.jpg
 create mode 100644 docs/handbook/merged_hopper.png
 create mode 100644 docs/handbook/pasted_hopper.jpg
 create mode 100644 docs/handbook/rebanded_hopper.jpg
 create mode 100644 docs/handbook/rolled_hopper.jpg
 create mode 100644 docs/handbook/rotated_hopper.jpg
 create mode 100644 docs/handbook/rotated_hopper_180.jpg
 create mode 100644 docs/handbook/rotated_hopper_270.jpg
 create mode 100644 docs/handbook/rotated_hopper_90.jpg
 create mode 100644 docs/handbook/show_hopper.png
 create mode 100644 docs/handbook/thumbnail_hopper.jpg
 create mode 100644 docs/handbook/transformed_hopper.jpg

diff --git a/docs/handbook/contrasted_hopper.jpg b/docs/handbook/contrasted_hopper.jpg
new file mode 100644
index 0000000000000000000000000000000000000000..b2d7cfacbb6b62fbcbbbc14aba4e955027bd201d
GIT binary patch
literal 5572
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

literal 0
HcmV?d00001

diff --git a/docs/handbook/cropped_hopper.jpg b/docs/handbook/cropped_hopper.jpg
new file mode 100644
index 0000000000000000000000000000000000000000..912d0a29cb0d154e7b7062123863630e8a1ef3a8
GIT binary patch
literal 2017
zcmbW!c{JPU8VB%SBt&d&Y_-K!yP>7A)izbN-QF50LaJ&kO;OcY8cW-Z8Y*fH8VzOC
zq}tlX7PL~7aI2Of1i@HR)LKhx36;^Ad+wYwf8Be(?|Gj;p7%NLc|Ygnjqs*`qfT~?
zb^r(j0HDJK@Wz0%fS`Z?RDfR)3WdU8f<hvaq9Ve=BC_HVM<fw)N{R?M1qEd_eNAQ6
zZ;mS{Xqjk#bJ75bL@H^TS(+MJ=$}Fwe!T<)gTX|EMPx)pWeimmR1E*;@LB-4An+~l
zEf}N<@WDY~IEdE{C>_3&AM{6ne+R?|hVTnO1z|$MhXZv-0X`5I%m)GU^Fttq({~Qf
z0SKI5T*cswfP~BUP*t3yVO(aB;BlL(Rw-2fn%XJfuzN5e>0>goa_SnITG~2DBV!X&
zv(sm7&)L~KI67T)b#q61cw+qg1FmAP1qOvjMBc(jMaRVdn2>lsiI_~v%FcO6&V59A
zQv5UZY00zaFRE*5>uB{2jW6G{wKF<8|Mj+OfH^qC8Xg&CPtS1P&(6(%SXf-&*!=W)
zYkOyx`_%;kz<;t1>z}Z{x!{K`J_rO1fqr#?`0$4t42STm7zl`;ae;o1lTbB`6O^>c
zEUIdS9Y2LylkyGg7m`*(POGnfrTroM?_l@-FWG-!f4SIz2pDwud0;qT4XlT^`*SJT
zJfQ3bCwWVFGV!Elo4npX+|c!}ndP(5s1fKXK1PPbN+GL>(^i0JSXW?YOSiITgzXwq
zC9&N)=-GW@rOjiHSJhsgMD6y{r8o>ltQ1ELDhMdOP72t-$9I+bDBP7&q!$IriLlle
zzf015XrM{zoOfGkxW#p~W5tR(P3Wr{G{U<;2TMT9fn7xy>VZviZK|{MZ{rhD@h-{H
z1rE~<nZD@j%d#IV=`VWA2?Xj+g>1y=Y~q~!rKq7Nrq+w(^n*I=PQG6|`xhQiQgRTv
z>|VVS+>&u-=CYGDEjT6x_azxHL0*HSXA#8DOTCuCy%$}Fv@r)CcM*EVb4@&;yNGi_
zd}%mFpFEvM*FthrvoCC;FDR?JBwp>50Z%H-m13g6E{(LtC=17uiE)PXlyZ(uY5cv)
z%=}1|R~%~CU6b|1qM4qcHuOPX>^a&+Nk8*6mwIvgwJ+1Hl|Mz$Z5XvXPn!z_!5s+!
zVR24VKH_0ewJGrnM_4r;M4PVDUStUC*>2tKON5ZAT%@@<u}B!F#x%4t(bf5(*_nPB
z{bo}BX`C2UYKU4g8nS{3*RiJsD(Og>;NJ#qYM9apUP2DJ8=xtU)ePMXl|pAqX`~f0
zxUW+yqe}NKMXu3awmC~2^-q22qxfSC8oO>#Ueq74N$tF0b0!q=E?+*0Bb?iY2Y5h2
zG@^g68AIZ3&1`*MtxykCC(Dl%)MbCz`z`+BuLJA13$7#^op8^)xnJWc`rMn|jy{1m
z?-85Sx62^?5Yf7lJg`pW0m)B34#Ns77(LiPw%b8@m~s`36ewou(xQZ!Dls2O*gGCX
z+;dbPU#y)>_EuxgZd$Qws_yj7Yv5CSz-hQiuu|%GtbHuLa{SRpz1p?;=ZO=3n)w^{
zn(O8Agapi|MObj8<?t<>ZL?6*StVOyt7SUXpL))`IMfd_hQKncp$k?r%vB>{b5F`;
z8_s*qwtJhba%>jUvSz`nw`y%0HL%iLD-pWoS)I1DV)(j$Q)}093@^iVLl8Q+ugiwP
zE2Ib7Qpc8i@ycuf3N7N8ZC6xwcw1EsHyKE$hf5|d=uPK(y_r<WyXxu04NotRF^Ke;
zNkez7_UYx5UIYg0IwhiDz$S*G*HixV8Ohr)Nho8Ce6#O{4vlUxjF}zW9Jjx@`kv^!
zS7z?VOu=Egisx~fIhZ+GoiF=-x<(w@Y{bFpo>8Uk+80*g&zH!QIktvhJpBzzQuo-_
z7PSiYGNV&2=Rj&B&PehuBG%-xqx_0q!<;cf#xFl+xNoyWkg;W7C4@qSL}CMZ0Bnfl
zl{C{>t6L!Jp}+$;L#)v&dY=s5N<011JME3eQiJQ6q8FCX2E|GgO#*!<qO<N6MdJ}J
z<n$<VOxmHl^1VjS<CB8(g9mQe>?^P#8SC2HpH<q`Vklu7@%zD8MvNLpx(u157Cm=9
zG|YI_?^n<#hW|v%R=8zT!tHj`kn(&vu7@iMZxzXS0_$ClXp!<e&#Z_Hu@RQHokVu?
zagT(roTt?Xziapj?PhrNRqmSZM3e6H15v(?6E#|~#ADlJ5i`P?;!tYP3ln|GvEd^1
zlKW+4`%4|Nbdsxk7G4$}BBPiCc^L0}Z6$+j=bVT4+Ag<5ah55z!zy^0InneMcQ1Bt
zj^3Bl@>;PPF9CA*SX}4zZ62_M?hTqL%v@zY&a<N?EMxwerL;V0(QcyG!WOXX3+*cV
zKpCnVOpml+y|rjDc~~LF=oBIpay&38sCRexi&H#}{WEw#6gF;`Nqx|EIwdX33sY8o
XXF)<}^sr4x55f`RUL^+)@<x9LQZA?A

literal 0
HcmV?d00001

diff --git a/docs/handbook/enhanced_hopper.jpg b/docs/handbook/enhanced_hopper.jpg
new file mode 100644
index 0000000000000000000000000000000000000000..a87903eba41acc0c4b2873f45b0aec0290c0adc5
GIT binary patch
literal 5721
zcmbW(cQD-Fy9e;kX0gg5I<Zl*T9icZov0DLL=7TZlqE_C5`-wxOQMSwooE{ttCs``
zqDNURI=facH{ajy&b>4DuY2$N%sKy@XU;sYIdf*t_0;tua8pZ7Qw;!t008uN0N1mC
z3P4Om1R)|MhCm=BB*dgpT5>2E8I*~dhLZO7EmoG>w_q?fj(gl}clhBj7>~qVenBBo
zQBhWIDLF}D*?S_Q!v7osA|WAxl0g~C$r**&VeG>H=Uk%!Dq`R@@EQ!d1KgkjfvG^(
z-2m&~J_$kp3h<u+-2f915<!SbNXh;dG~5JkfWY7z1Ykl!0)oHQL4WrF0xCjkb|EDq
z8hu;H9R#iLo5Xx#xN>a=ox#t24iP)AP!dvl21ce^oLt;IcX>s{#3dx9q*YWOsHtmc
zY8e_Co0ytCHn)H3@XXQ4*~R;XkFTHq%Yd-(w-J%=qN0<MQ&Q8?KYYyiR8Uw{T=KcJ
z>`PsJLt_*2YjbB;cTaC$|G?nr*!ZuB$*Jj?CCu{5>e~9Bjm-lr?ht=;d~$mBj|&8V
z|IPZl{u}l`TvUHuHwXy81dxARpc{UFCzy(WkX?v~T1g*bi=eq9{DzoTIWfPsg9I*O
zuuo^_^^=sILv)Gr;2+w*WdA!@=>JRhU$Fmn%>Ym^=<nr$sQ?Aw!2YT<zMOKykQM)a
zSe<TLVu36#X300VbnA{q;Lg1XjAlW--i~L*_CYy|B3ly&xC1VGLw2Fdngw~lKU3LI
zb==Za<Jw=Kl*|Wbn}T>5X99jb0koSvzmGV(dr~mQTUlUp^Lv$u!p-}f1<%v`huS|-
z@>CfKK_;1)j*DGqC<^kl-B?P2Mr00^VAC@qRRhl=^m*aplCG>5p^^aV=vMe$Z-#Vs
zs)rys<8kSPAkqYvRh~fs0e7C?G8ywitzUDyGf*Orun!1VzER82V|$m;+zFBpaJ)-x
z<-&rqyg;;$^qOm6W}vpl&wQCjuil;Xy-JRS{i0-m`j=Si=Xf|soh7+WRj%%jylxx8
zRBFo4R=FgqU*@`$f5pVAMqw#}?c*$%WI|(s?$e(c;m%r<$04^VK61@XT3iDkvzKjX
z{X@5u#$@jY7I=Ieub+CFgx%?><JhEI@%jof_9tlk+2W@s=wj~Apx+XDQ2ENR*v6`Z
zV!yGjmkK5bO(J3fC#ftaNJC?>*0Kkw*FcO|47vBYT*ccjqJkGo!zZ~fIRo;U$Jo|u
zhslE|OE&56m-P94wp8+fCH4*=xX?wO;-MCv){h%Y?L2i~O}L=)9d6%K33b^%kTdDD
zBGQ01S0$HCYjw!~a*z(Ad3wXjOWvxFIr7`45}R@64%fMM`e1uq#`HkvY1Hclm7kG6
zCL()}C>;w@c+%dinb|uq8Dp0Z;qHQpmM`|=AXa%7I{Wk0MO{Vy5x=)t2csnz2AY`|
z^BlUcAhrllO$hH+{)Ykeg-M)Xd3el(w8*fyy?p%#$V{^bqkpg*#7N1dXWQLq08IZo
zE;C&YJ(v&}D!n)<HqsDiw8@)b5N|k~Woh*x(=((<G#2KV>*6_LxTOvzs=~0+Y(HO)
zTQq*d_WV_YQQShh=pmD={`fsFXH3hv0=O&R%yQ0xusH*>RN&R}>nEMjB3AwsUUH{-
z<ZX_m4W-5AkGW~HOc@J?X5l{i=~d7EQl=0LVHPL>abo&WO5vHO^kRsX#)l+Dg}ZS0
zxV`L^@v2s=!|w4oUMfS{hH>+Zs}<8Y;kT*n8~~m}&zd_~0>lQICYFF{vGkKCrfvs%
zvmHybG=&eI>kCxcq7rr_^i^qIka5X7m~85T*&n<lU+2xkQU)X&wSFDH|E#q+wJ68^
zsdsMx)cywm+y-vcrLqS3zK<v>5JS0gr!SK~wO<QN>iVN7b?Hjiz_)QPzd3L=9r>Ck
z+9WkbjdoSJQ4^%GNReG`*xSb<*uF`*i_5jSD{{8><#6ZTHDKCIe->1cJc#I|0Pr09
zkgwI!DSK)R+wB}~`U<Wb>87XIzS#%%J-#%jYZsP6K_f@u{RxC<li3I$X#1|-BTe$;
z#{mnm_fRUnlM)jFrXPlo_4Lj(G+9|SU9en(fQ<2`6I~3+B<Bw8vEJ&tBT2^MZ~Fz^
zh-DIRsK#LJ&WVZ33%lKVu_L-%<sfcMarLJSYUc^@W*wBf;M0g9c=8tZqCx{LlllcB
z7Gidi?IGO<)xKBc$SaleO|LOZmEv^n$HUjcwa{tKV9Um_P@!B%r;e}XX*{i>4+o8L
z^%cWbT7qbeD1(xk?_J*RKyb&!hPR&Af_}4DQfq8^?k!jEY4fSd<sRE--LvMUoOT4s
zO^9!FOlWA|o9NwT`RC4Da}ZE%&PS%JhLuqjeqoew@4;YUggOD8eE2PVtLSO7LrO{L
z(LwEqwXsg18HxEHY^~PObDR5fIJNJvWii)pi(n1C7rlIAUwf5_h+&4QA<`k~VPmwJ
z6v6e~5}2m2!+28Xbm{lmm0d%na~NUtskm#s2w|Uz9fgD^gD2oN<Q>r0HKeQ6B%KmS
z6n~jZw?4}iRF2EL{IP2jYy?QtaWj?4vmf-<RWNrPolbPVcrV|-(<W5ILvXj>F!eX`
z$x6o7E02R4ecjd!@#?6EXRQ_%uDOjCZFUlBg2V4wS$UwQY*`ZSd|mMkVbRw>Xdq?k
z9JVFmls4BgS<_PuO`4e6-@g+_?&{QJ;u}!mW%DJ*o|$h~XK|gezoWk&vR^jOfkdJv
zJ$BuzFfB>y+#}%^aY$z0I5d>JwKncoMVXj>-;X#O-?hGX{1*BrG2YKVGjqwISD?hn
zQt&3omUYz9R;z+Wqhk(sl-@f6$6+K(0T9FjeB>tV7%Q_+^r(-RC{iC|K_WW}3hy{b
zZQ1^b&vv1XiTJq%kyKR5<)V>0Tyjnj(RVu_`t<6>Mz8S9H>`Rcseyr;j|WcX{)uk=
z$u8=%$BQG&Md|)X1!Wt$smC?~hx*#Yc2y)41)+#BvDLH;zju3UR}-xV;NG|?e}~My
zuvuqLt;P71u#D{&a`yr)!fTwvT}5?d+n<H2+OGhlS&K<#X9tgmiV8!j(HpUx9)V{U
z>RVTw$kA18rzi=2<qAZxRb)^Zh`R~6HFyn#7ccERY|1dH7&fXEoFy{IgC&8W04zC<
zNVC*Om*Sf@!O?~vFMCQ%HY(z_Q4_3c;&$yYNw0TU@rkq!?>=V^avJO@j-`{b@g!od
zhR-LZSO)DO-Lu+;8W%3UQ!)+}yH0q><x1$?)Fv-s!!sGEP^hzA1H2pjI~ntxqg({E
zP46|>@T5e%{ue?X9-q0VhRIZyRO8!3H$BS}NcO@eGcrhWHs_gE;zW})e*M<7^)h<;
zX38-uaPn)aNlbDmesX*tCrzzq%yA8r-`v^CfChO9nY_viG)O^jSg(%UEMHyD8{#cl
z+A|SHXx8D5OAu2BOuD-oczBVVr{P!@zA~QPsn*FH`EzGAFlvnDX{>m}GX>r^Q-plO
z0m)-U4)YcR4hYVQ9@(i`*KIen1R}A6Z67g@LK?+pkLdSQlH#(bdWpejMrXd6-W4u4
zohLNgFiVY}<!Jplj`XCsXFhtkAEzS}tI9@etcLyd9tj7P&&%>H1u1kjQjr-`TlVL+
zHrwJf5V`08o(r#+6=lCx-FrGS(^{DXnj*LP=P?(!5dMP#EwdedwkhEDjm6}xfwgkY
zXQE@|W%NlBF>4FQP1Js@?#1<Z?J&nrb5>=MPVV40Cp;so8Q*hFM>)nt&$YFk;W^u)
zod%goXt1+FcfjHBjme>M<b%`u9V|Oi(+#702Y=t0^TuTD2K{rj)T3n5G>Zl-dUlp0
z!RXB&-r=xH3v1bQZ(XN!29V95CI~yp%1e{;NLaV!R>ydL8s=)g=LZ?l_b<sm(F(km
zA_GSRhU@X2&4t5F3?_Fl27X!}G$lZn2Vpyt4U(-4i7n9ql?$bHl_$|-x~S;D!1D(w
zOPmoV9iAFMs1%`g01M@4Ho{w^8><7;^jsztSn%(Ao|K2P+=%HMAV~9EF#E8gLc)yp
zGn}ej!G&ev3zQn#8>3Z`nZpr8WVC%(=J$jtzjpLl=Z&Ri5E7*IG&X9d#2JYAkfRgL
zV9yzOz2qnrWpaDV7ikgzuq5EAz}rNh@9g8or$kIMn;xObB1o~QajI+B8=QS^tbZsq
z6!=k0##{Gn?<|MN!{nm=8mLr(We^|jjmB#cbKtC(FywGiw}Qz^9{Y#<FDXhefxm5x
zYsY<5qc>fhX_HLtwW2#hg>EaZ5cPV#<f^N-Cb{nz=ys)|WiGg!P?!Wd21l23$?LiN
zYAsCXFCnzQx}uQWiZ`^DaUpN5mvd6~vEetK+M;z#Ed;NSn#y0L?q1RSN;lZwsSjWC
zPwBgVj`q1wf*e#cPbJR2)qi`NuVml4(9NTy$?nz1%Bf|A?lKGbg8SYmYB2R>;VM@C
z?Gq!xi_F$*;QJmvzx@$$7q7dpY2B;r%kps4Px#LUVlh{;sE5vy_o35I^0KHar=A?b
z52{+MQY-O1`Mxqb&0hguss!E1Rk7i&vd8}EJ-0j}DrynrJp-<N*2bS6_S>t>C4@iq
z6zL6oY36M5d1;`|{OGEk+Hu>tW3af@H1IUUM0)+{I9nXa(qjULFh~akULuD(c~!4c
zq{E?eJ1x5y^#mG)0Vp354u_<A2MkSof;WuUcQI-g#;L!J1bamg>biH)Wd<IQp6h0@
z*ElV_A8L_WuDNh^GR(dl%{J?C+4ifM*)01c6XWXe-iyxdoiXfCYK78P&(en3)imyA
zb&YK1O)q~AXfPwIZV_T4So)Wb**uQ`3Tf=!x`6MiG}E@24I$aO^|t3*>%ufgs`#oZ
z97c6D3D5N;G%q~8+`HpwEGf|}F4~<m-}8xsRSebl+^ZXR;uWIRP&bCHQtx7sXc||a
z7L$mc!JRy{Z<GpQi4JOJnNOYC<`wqd8mkO)r@#4DG{5X3*s&kOeRmucL06pMJ*hBJ
z)C0eJ8(EcngKJ}mZJCkwh~TiWM-&p}bX4oY!Zyag3lbdhp?w7E;2j1r?R1Fk%=7Gb
z`<?MuyC+&yWqY*IvEI1@Xy4BphG6)5UpVEA^#)jqR1L6?=c_|bG!m5{`0}><2R_G9
zVu7F1y{pnu74-S<;_Y%%QX$Yj<|rvC$v=dz@J_gI{l`2esZ8E|Ua@DfHv~R^UmvGX
z5P2A8jja3ltl_<ZF@ZY*=|wF2;*YN7gf*e)IIo~Z=J<Elk;?X}^K`tNqrpTWwTtPP
zWsP2*jHl2KKoGKOMcLWXU3-$9H@vAKQtuDuUVHx|xPmYK>=<83PGjiCU_I7gq$^ZW
zWsjWBZEpyp%Jn3^aMkGHbU1+tH13YrW<E-O_@-XFX~Da=DFMraPLi)h-VVFVs*;$)
zm)$l-zjkb&-Q`c7I6HPIwtH(YatEbTs8r_sC*suBhJ65?1IH0ho!#^zIWIh;ANjCw
z61=(TlQSwc+<QkAJL`3`Lc9?Ik-dd;Q8rp%Ig-nuD=?uCth@%QMOcPA=Vz#qRK26n
zLu-iaxv9l6akBD>OzDs$b{9`Y%Tpn!=tw|mUu%}Q4RIOUw|QOoHEI4DFf%-I^%bBM
zm~d8Fso5@517z!<3Bc)B))`7`9NtQ%D?t-$aero4QI_F}GI+Nfc?mN)2@sHf37h(^
z>Tr(S_Rk3*o&9<7pzKc>{qRP()Ig|ihC=`0Sruig{qyw=L!KF-#9Sq-{bXGornUNv
zNyE{@_IHgU?=!MnW(MXpQU;ig;d}ST$njM<Bc@|w!sQMj9x^$qF3Z6Rza>3JQ7UpG
z(Q3Q_vAD!OY!wny+%(>6=HF@(*_s1^AABAL$=ad5bzO<K)gnVDt~~0eMcz7daSTu=
z$3~2>`E-ncV@-?Oj27{9vs#5NeBEo=5|GmF3*%9{#`eaEMM8({Sno4;eQeF~Oo@V$
zwZ|;o7AyTKSnErSZ0k?kc*PQha#F0d`Xjk5^rzXVEz>Uv%Og^Sk~^dE0mN(xt}0X_
zW34<#TRWQCb1cqza_3#w0DXn5)PCfn!~^dNmF8Y%gWnII*k;1QNe$(2eXTF$u7Pe!
zx=n9Q&XIR`p|x7Ogt>Yr;Q#^y09;cQ%#-7&s_K{6uc~UGP3;d*l*pBD<VM<%)dwkb
zPGDWn#8T%=<ew(Yb$<DP`>Ey~3#E`*InMv1Akrt#e4&Ecm#?giP5#p)aFyyp;hU3V
z=lyy)_7F-$DWkF0uw%F0EsZ~_^$!VoDWYZSs|;N-3gjUzm?Axlj}w=NjqcUA+-BCP
zuS1b>)Lo{rGfrt36Ht)wSH?eNHOG1q!*c4)l-|tJuAy0%b$F*Y)f=F*MAFGdudOLd
z<PUq-CDCVkUW^ExXPW_rpvu8TEZ@w9%x7{7#V;)aAECCK>)hY18FNdS+rmwwk~ew+
zB)XW3U3JukGT*Ie8nGU|fm{PhHp9(=$qm|mmr%am{dU`HfPtGFQ8>Gv`nV82l?wh_
zA-2{hcQ)y8AiX$(S<KFF)VKzyAID$4wR|F{(1|)Te*phdhnn7&CqD^V8nRj1a+ygH
zj`<O{x#49DnwwR@gJbOh$0n}g$R+hicMNq<@sU6myM1$f?DFTQ-1usEn8CO}s6gxG
zoRa(>&ELwGf(UcLllE@k6Cqc>u<2Ys98vv`n1Yf6$1d?7hZF6iyAG&0*hfsVvyY+(
zl4=|Zi+xcozp_l!OoH;pXlH6xmW-pOir*J_K8d9!W{Z7GfXH#ph9M?rGHApO$xU=9
zE$YUXzcD+jq+VeUpU4fSU2JVyIrb_%{Q(cWdk0t8B*OH&O{0JeIk1O~eKS7UKh1Gq
z-XwjApHC-`#kExE3n16yIn9KN<=)wJDCTcU&VC*;G)7MN$h=qHReM?dJZYT+gl2sW
z7^^X@;J5Viqy{$Ta(K-$6hxVfKT0n>BDrvGG1E42{*%MnHnGM<_R@TiUd7Kdnm9rj
zEs}-rvxH7GU9i6~5{=jiHnGRX#k3%LW!yaaf2AK36`_PIHg37~ye-v97ZO<NK{GDB
z-kHRen=0JQOCv)rk8;L*H!_1+t#pD67Rixr3$4RmA^t9GbEz{;c%00qKl+Vh?PX1?
z*8ud%77N9A#l6CFfr>Hn;%?zu{V4IfiNyV@kE0I{D*`VW496<-zoP2>ZL_X+1_%_G
zmI)?xO8u9r9X}S-rSTMbt-<}j3nP-eq_Zf3%4y6ebB({$HwX<z5yUOO=;<Kf0qzkA
z{rws(7|V{WH`LQ^*tSO28y=sP2R8~Sawl7rbZK5xQ&}n_&d*Ky<TM-<zWE^9!thlw
iXj}!0@Ypxj)Yx~y#o|D)e^r@4**jbrUr+A!^nU>MS^dZW

literal 0
HcmV?d00001

diff --git a/docs/handbook/flip_left_right_hopper.jpg b/docs/handbook/flip_left_right_hopper.jpg
new file mode 100644
index 0000000000000000000000000000000000000000..e1ef519e5cd8a34c65d681071b46318e3dd7f6a4
GIT binary patch
literal 4637
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

literal 0
HcmV?d00001

diff --git a/docs/handbook/flip_top_bottom_hopper.jpg b/docs/handbook/flip_top_bottom_hopper.jpg
new file mode 100644
index 0000000000000000000000000000000000000000..03a5020f3904067cb13d2ea918dd382dc4e29cc5
GIT binary patch
literal 4652
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
D@-E{;

literal 0
HcmV?d00001

diff --git a/docs/handbook/masked_hopper.jpg b/docs/handbook/masked_hopper.jpg
new file mode 100644
index 0000000000000000000000000000000000000000..f70a5ec4769e9c861fcfd4e1e90f812cd4369782
GIT binary patch
literal 4904
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

literal 0
HcmV?d00001

diff --git a/docs/handbook/merged_hopper.png b/docs/handbook/merged_hopper.png
new file mode 100644
index 0000000000000000000000000000000000000000..662816cbdad42a04dd522acbbd195c2d789fb87b
GIT binary patch
literal 35390
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

literal 0
HcmV?d00001

diff --git a/docs/handbook/pasted_hopper.jpg b/docs/handbook/pasted_hopper.jpg
new file mode 100644
index 0000000000000000000000000000000000000000..36e3492a40f92e1c37d91722e1a993793fffbdec
GIT binary patch
literal 4645
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

literal 0
HcmV?d00001

diff --git a/docs/handbook/rebanded_hopper.jpg b/docs/handbook/rebanded_hopper.jpg
new file mode 100644
index 0000000000000000000000000000000000000000..324f7ef14e1e2ec5c1268a2b060bbeb79310a5ce
GIT binary patch
literal 4743
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

literal 0
HcmV?d00001

diff --git a/docs/handbook/rolled_hopper.jpg b/docs/handbook/rolled_hopper.jpg
new file mode 100644
index 0000000000000000000000000000000000000000..b2220f39cbe11fa43e25b698a0dae49a4fadc39f
GIT binary patch
literal 4651
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
AApigX

literal 0
HcmV?d00001

diff --git a/docs/handbook/rotated_hopper.jpg b/docs/handbook/rotated_hopper.jpg
new file mode 100644
index 0000000000000000000000000000000000000000..e4d22be70ce2bc4887a41799e1343fa0cc513cd9
GIT binary patch
literal 4895
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

literal 0
HcmV?d00001

diff --git a/docs/handbook/rotated_hopper_180.jpg b/docs/handbook/rotated_hopper_180.jpg
new file mode 100644
index 0000000000000000000000000000000000000000..cee897e9556897ab46577704966389206852f334
GIT binary patch
literal 4636
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

literal 0
HcmV?d00001

diff --git a/docs/handbook/rotated_hopper_270.jpg b/docs/handbook/rotated_hopper_270.jpg
new file mode 100644
index 0000000000000000000000000000000000000000..e4d22be70ce2bc4887a41799e1343fa0cc513cd9
GIT binary patch
literal 4895
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

literal 0
HcmV?d00001

diff --git a/docs/handbook/rotated_hopper_90.jpg b/docs/handbook/rotated_hopper_90.jpg
new file mode 100644
index 0000000000000000000000000000000000000000..763785c7a1d5b2d45df93884dc63f9a8217ba686
GIT binary patch
literal 4903
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

literal 0
HcmV?d00001

diff --git a/docs/handbook/show_hopper.png b/docs/handbook/show_hopper.png
new file mode 100644
index 0000000000000000000000000000000000000000..1f2e6f243858d8a9944c4db0b1c0758111cc45ce
GIT binary patch
literal 56122
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
F{{xhz)w2Kq

literal 0
HcmV?d00001

diff --git a/docs/handbook/thumbnail_hopper.jpg b/docs/handbook/thumbnail_hopper.jpg
new file mode 100644
index 0000000000000000000000000000000000000000..8c10589c2cf0659cc04b71f98e82ed39a1ca4de5
GIT binary patch
literal 1984
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

literal 0
HcmV?d00001

diff --git a/docs/handbook/transformed_hopper.jpg b/docs/handbook/transformed_hopper.jpg
new file mode 100644
index 0000000000000000000000000000000000000000..33afe67e62be8f3e2922c5cfa5c0018774ac0b5c
GIT binary patch
literal 3608
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

literal 0
HcmV?d00001

diff --git a/docs/handbook/tutorial.rst b/docs/handbook/tutorial.rst
index 6cb1e26392c..b612bde9081 100644
--- a/docs/handbook/tutorial.rst
+++ b/docs/handbook/tutorial.rst
@@ -37,6 +37,9 @@ example, let’s display the image we just loaded::
 
     >>> im.show()
 
+.. image:: show_hopper.png
+    :align: center
+
 .. note::
 
     The standard version of :py:meth:`~PIL.Image.Image.show` is not very
@@ -79,6 +82,9 @@ Convert files to JPEG
             except OSError:
                 print("cannot convert", infile)
 
+.. image:: ../../Tests/images/hopper.jpg
+    :align: center
+
 A second argument can be supplied to the :py:meth:`~PIL.Image.Image.save`
 method which explicitly specifies a file format. If you use a non-standard
 extension, you must always specify the format this way:
@@ -103,6 +109,9 @@ Create JPEG thumbnails
             except OSError:
                 print("cannot create thumbnail for", infile)
 
+.. image:: thumbnail_hopper.jpg
+    :align: center
+
 It is important to note that the library doesn’t decode or load the raster data
 unless it really has to. When you open a file, the file header is read to
 determine the file format and extract things like mode, size, and other
@@ -150,6 +159,9 @@ pixels, so the region in the above example is exactly 300x300 pixels.
 
 The region could now be processed in a certain manner and pasted back.
 
+.. image:: cropped_hopper.jpg
+    :align: center
+
 Processing a subrectangle, and pasting it back
 ^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
 
@@ -164,6 +176,9 @@ modes of the original image and the region do not need to match. If they don’t
 the region is automatically converted before being pasted (see the section on
 :ref:`color-transforms` below for details).
 
+.. image:: pasted_hopper.jpg
+    :align: center
+
 Here’s an additional example:
 
 Rolling an image
@@ -186,6 +201,9 @@ Rolling an image
 
         return im
 
+.. image:: rolled_hopper.jpg
+    :align: center
+
 Or if you would like to merge two images into a wider image:
 
 Merging images
@@ -203,6 +221,9 @@ Merging images
 
         return im
 
+.. image:: merged_hopper.png
+    :align: center
+
 For more advanced tricks, the paste method can also take a transparency mask as
 an optional argument. In this mask, the value 255 indicates that the pasted
 image is opaque in that position (that is, the pasted image should be used as
@@ -229,6 +250,9 @@ Note that for a single-band image, :py:meth:`~PIL.Image.Image.split` returns
 the image itself. To work with individual color bands, you may want to convert
 the image to “RGB” first.
 
+.. image:: rebanded_hopper.jpg
+    :align: center
+
 Geometrical transforms
 ----------------------
 
@@ -245,6 +269,9 @@ Simple geometry transforms
     out = im.resize((128, 128))
     out = im.rotate(45) # degrees counter-clockwise
 
+.. image:: rotated_hopper_90.jpg
+    :align: center
+
 To rotate the image in 90 degree steps, you can either use the
 :py:meth:`~PIL.Image.Image.rotate` method or the
 :py:meth:`~PIL.Image.Image.transpose` method. The latter can also be used to
@@ -256,11 +283,38 @@ Transposing an image
 ::
 
     out = im.transpose(Image.Transpose.FLIP_LEFT_RIGHT)
+
+.. image:: flip_left_right_hopper.jpg
+    :align: center
+
+::
+
     out = im.transpose(Image.Transpose.FLIP_TOP_BOTTOM)
+
+.. image:: flip_top_bottom_hopper.jpg
+    :align: center
+
+::
+
     out = im.transpose(Image.Transpose.ROTATE_90)
+
+.. image:: rotated_hopper_90.jpg
+    :align: center
+
+::
+
     out = im.transpose(Image.Transpose.ROTATE_180)
+
+.. image:: rotated_hopper_180.jpg
+    :align: center
+
+::
+
     out = im.transpose(Image.Transpose.ROTATE_270)
 
+.. image:: rotated_hopper_270.jpg
+    :align: center
+
 ``transpose(ROTATE)`` operations can also be performed identically with
 :py:meth:`~PIL.Image.Image.rotate` operations, provided the ``expand`` flag is
 true, to provide for the same changes to the image's size.
@@ -342,6 +396,9 @@ Applying filters
     from PIL import ImageFilter
     out = im.filter(ImageFilter.DETAIL)
 
+.. image:: enhanced_hopper.jpg
+    :align: center
+
 Point Operations
 ^^^^^^^^^^^^^^^^
 
@@ -358,6 +415,9 @@ Applying point transforms
     # multiply each pixel by 1.2
     out = im.point(lambda i: i * 1.2)
 
+.. image:: transformed_hopper.jpg
+    :align: center
+
 Using the above technique, you can quickly apply any simple expression to an
 image. You can also combine the :py:meth:`~PIL.Image.Image.point` and
 :py:meth:`~PIL.Image.Image.paste` methods to selectively modify an image:
@@ -388,6 +448,9 @@ Note the syntax used to create the mask::
 
     imout = im.point(lambda i: expression and 255)
 
+.. image:: masked_hopper.jpg
+    :align: center
+
 Python only evaluates the portion of a logical expression as is necessary to
 determine the outcome, and returns the last value examined as the result of the
 expression. So if the expression above is false (0), Python does not look at
@@ -412,6 +475,10 @@ Enhancing images
     enh = ImageEnhance.Contrast(im)
     enh.enhance(1.3).show("30% more contrast")
 
+
+.. image:: contrasted_hopper.jpg
+    :align: center
+
 Image sequences
 ---------------
 

From 96a1af9fa859ad36ab9041923dd6dcd420a86f16 Mon Sep 17 00:00:00 2001
From: "Jeffrey A. Clark (Alex)" <aclark@aclark.net>
Date: Thu, 18 Jul 2024 18:33:14 -0400
Subject: [PATCH 0840/1178] Add tutorial images

Animated gif example
---
 docs/handbook/animated_hopper.gif | Bin 0 -> 58616 bytes
 docs/handbook/tutorial.rst        |  37 ++++++++++++++++++++++++++++--
 2 files changed, 35 insertions(+), 2 deletions(-)
 create mode 100644 docs/handbook/animated_hopper.gif

diff --git a/docs/handbook/animated_hopper.gif b/docs/handbook/animated_hopper.gif
new file mode 100644
index 0000000000000000000000000000000000000000..e6eeaffcc4e519810e323704e68d81953fad7e12
GIT binary patch
literal 58616
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
E1DkgEX8-^I

literal 0
HcmV?d00001

diff --git a/docs/handbook/tutorial.rst b/docs/handbook/tutorial.rst
index b612bde9081..2840377e3b1 100644
--- a/docs/handbook/tutorial.rst
+++ b/docs/handbook/tutorial.rst
@@ -511,10 +511,43 @@ Reading sequences
 As seen in this example, you’ll get an :py:exc:`EOFError` exception when the
 sequence ends.
 
+Writing sequences
+^^^^^^^^^^^^^^^^^
+
+You can create animated GIFs with Pillow, e.g.
+
+::
+
+    from PIL import Image
+
+    # List of image filenames
+    image_filenames = [
+        "hopper.jpg",
+        "rotated_hopper_270.jpg",
+        "rotated_hopper_180.jpg",
+        "rotated_hopper_90.jpg",
+    ]
+
+    # Open images and append them to a list
+    images = [Image.open(filename) for filename in image_filenames]
+
+    # Save the images as an animated GIF
+    images[0].save(
+        "animated_hopper.gif",
+        save_all=True,
+        append_images=images[1:],
+        duration=500,  # duration of each frame in milliseconds
+        loop=0,  # loop forever
+    )
+
+
+.. image:: animated_hopper.gif
+    :align: center
+
 The following class lets you use the for-statement to loop over the sequence:
 
-Using the ImageSequence Iterator class
-^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
+Using the :py:meth:`ImageSequence.Iterator` class
+^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
 
 ::
 

From c337dfe98a0097f8f1999bb6c2bf12804a2d0552 Mon Sep 17 00:00:00 2001
From: Andrew Murray <radarhere@users.noreply.github.com>
Date: Fri, 19 Jul 2024 14:32:59 +1000
Subject: [PATCH 0841/1178] Correct reference

---
 docs/handbook/tutorial.rst | 4 ++--
 1 file changed, 2 insertions(+), 2 deletions(-)

diff --git a/docs/handbook/tutorial.rst b/docs/handbook/tutorial.rst
index 2840377e3b1..6c4e3ad593a 100644
--- a/docs/handbook/tutorial.rst
+++ b/docs/handbook/tutorial.rst
@@ -546,8 +546,8 @@ You can create animated GIFs with Pillow, e.g.
 
 The following class lets you use the for-statement to loop over the sequence:
 
-Using the :py:meth:`ImageSequence.Iterator` class
-^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
+Using the :py:class:`~PIL.ImageSequence.Iterator` class
+^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
 
 ::
 

From 1daaef02cd2a6faeb0dfbc0a23360fdfb49a8621 Mon Sep 17 00:00:00 2001
From: Andrew Murray <radarhere@users.noreply.github.com>
Date: Fri, 19 Jul 2024 18:27:00 +1000
Subject: [PATCH 0842/1178] Updated code to match image

---
 docs/handbook/tutorial.rst | 4 ++--
 1 file changed, 2 insertions(+), 2 deletions(-)

diff --git a/docs/handbook/tutorial.rst b/docs/handbook/tutorial.rst
index 6c4e3ad593a..e19da47a54a 100644
--- a/docs/handbook/tutorial.rst
+++ b/docs/handbook/tutorial.rst
@@ -149,13 +149,13 @@ Copying a subrectangle from an image
 
 ::
 
-    box = (100, 100, 400, 400)
+    box = (0, 0, 64, 64)
     region = im.crop(box)
 
 The region is defined by a 4-tuple, where coordinates are (left, upper, right,
 lower). The Python Imaging Library uses a coordinate system with (0, 0) in the
 upper left corner. Also note that coordinates refer to positions between the
-pixels, so the region in the above example is exactly 300x300 pixels.
+pixels, so the region in the above example is exactly 64x64 pixels.
 
 The region could now be processed in a certain manner and pasted back.
 

From 54055c76c4fe3ffe6293f5ed1ab8ded2c0f7d669 Mon Sep 17 00:00:00 2001
From: Andrew Murray <radarhere@users.noreply.github.com>
Date: Fri, 19 Jul 2024 18:45:00 +1000
Subject: [PATCH 0843/1178] Converted images to WebP

---
 docs/handbook/cropped_hopper.jpg          | Bin 2017 -> 0 bytes
 docs/handbook/cropped_hopper.webp         | Bin 0 -> 1656 bytes
 docs/handbook/enhanced_hopper.jpg         | Bin 5721 -> 0 bytes
 docs/handbook/enhanced_hopper.webp        | Bin 0 -> 4684 bytes
 docs/handbook/flip_left_right_hopper.jpg  | Bin 4637 -> 0 bytes
 docs/handbook/flip_left_right_hopper.webp | Bin 0 -> 3976 bytes
 docs/handbook/flip_top_bottom_hopper.jpg  | Bin 4652 -> 0 bytes
 docs/handbook/flip_top_bottom_hopper.webp | Bin 0 -> 3966 bytes
 docs/handbook/masked_hopper.jpg           | Bin 4904 -> 0 bytes
 docs/handbook/masked_hopper.webp          | Bin 0 -> 3954 bytes
 docs/handbook/merged_hopper.png           | Bin 35390 -> 0 bytes
 docs/handbook/merged_hopper.webp          | Bin 0 -> 7536 bytes
 docs/handbook/pasted_hopper.jpg           | Bin 4645 -> 0 bytes
 docs/handbook/pasted_hopper.webp          | Bin 0 -> 3922 bytes
 docs/handbook/rebanded_hopper.jpg         | Bin 4743 -> 0 bytes
 docs/handbook/rebanded_hopper.webp        | Bin 0 -> 3866 bytes
 docs/handbook/rolled_hopper.jpg           | Bin 4651 -> 0 bytes
 docs/handbook/rolled_hopper.webp          | Bin 0 -> 3912 bytes
 docs/handbook/rotated_hopper_180.jpg      | Bin 4636 -> 0 bytes
 docs/handbook/rotated_hopper_180.webp     | Bin 0 -> 3946 bytes
 docs/handbook/rotated_hopper_270.jpg      | Bin 4895 -> 0 bytes
 docs/handbook/rotated_hopper_270.webp     | Bin 0 -> 3922 bytes
 docs/handbook/rotated_hopper_90.jpg       | Bin 4903 -> 0 bytes
 docs/handbook/rotated_hopper_90.webp      | Bin 0 -> 3888 bytes
 docs/handbook/show_hopper.png             | Bin 56122 -> 0 bytes
 docs/handbook/show_hopper.webp            | Bin 0 -> 6548 bytes
 docs/handbook/tutorial.rst                |  28 +++++++++++-----------
 27 files changed, 14 insertions(+), 14 deletions(-)
 delete mode 100644 docs/handbook/cropped_hopper.jpg
 create mode 100644 docs/handbook/cropped_hopper.webp
 delete mode 100644 docs/handbook/enhanced_hopper.jpg
 create mode 100644 docs/handbook/enhanced_hopper.webp
 delete mode 100644 docs/handbook/flip_left_right_hopper.jpg
 create mode 100644 docs/handbook/flip_left_right_hopper.webp
 delete mode 100644 docs/handbook/flip_top_bottom_hopper.jpg
 create mode 100644 docs/handbook/flip_top_bottom_hopper.webp
 delete mode 100644 docs/handbook/masked_hopper.jpg
 create mode 100644 docs/handbook/masked_hopper.webp
 delete mode 100644 docs/handbook/merged_hopper.png
 create mode 100644 docs/handbook/merged_hopper.webp
 delete mode 100644 docs/handbook/pasted_hopper.jpg
 create mode 100644 docs/handbook/pasted_hopper.webp
 delete mode 100644 docs/handbook/rebanded_hopper.jpg
 create mode 100644 docs/handbook/rebanded_hopper.webp
 delete mode 100644 docs/handbook/rolled_hopper.jpg
 create mode 100644 docs/handbook/rolled_hopper.webp
 delete mode 100644 docs/handbook/rotated_hopper_180.jpg
 create mode 100644 docs/handbook/rotated_hopper_180.webp
 delete mode 100644 docs/handbook/rotated_hopper_270.jpg
 create mode 100644 docs/handbook/rotated_hopper_270.webp
 delete mode 100644 docs/handbook/rotated_hopper_90.jpg
 create mode 100644 docs/handbook/rotated_hopper_90.webp
 delete mode 100644 docs/handbook/show_hopper.png
 create mode 100644 docs/handbook/show_hopper.webp

diff --git a/docs/handbook/cropped_hopper.jpg b/docs/handbook/cropped_hopper.jpg
deleted file mode 100644
index 912d0a29cb0d154e7b7062123863630e8a1ef3a8..0000000000000000000000000000000000000000
GIT binary patch
literal 0
HcmV?d00001

literal 2017
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
XXF)<}^sr4x55f`RUL^+)@<x9LQZA?A

diff --git a/docs/handbook/cropped_hopper.webp b/docs/handbook/cropped_hopper.webp
new file mode 100644
index 0000000000000000000000000000000000000000..8d0ae4f9757b5c7a9c9acfb4d782cc2ea28ad8a9
GIT binary patch
literal 1656
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
C4MrUR

literal 0
HcmV?d00001

diff --git a/docs/handbook/enhanced_hopper.jpg b/docs/handbook/enhanced_hopper.jpg
deleted file mode 100644
index a87903eba41acc0c4b2873f45b0aec0290c0adc5..0000000000000000000000000000000000000000
GIT binary patch
literal 0
HcmV?d00001

literal 5721
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

diff --git a/docs/handbook/enhanced_hopper.webp b/docs/handbook/enhanced_hopper.webp
new file mode 100644
index 0000000000000000000000000000000000000000..a582ac0c216f10b4371d363683f2605be432b7fb
GIT binary patch
literal 4684
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
OQUa_$C79z|Jb(aTVNbaL

literal 0
HcmV?d00001

diff --git a/docs/handbook/flip_left_right_hopper.jpg b/docs/handbook/flip_left_right_hopper.jpg
deleted file mode 100644
index e1ef519e5cd8a34c65d681071b46318e3dd7f6a4..0000000000000000000000000000000000000000
GIT binary patch
literal 0
HcmV?d00001

literal 4637
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

diff --git a/docs/handbook/flip_left_right_hopper.webp b/docs/handbook/flip_left_right_hopper.webp
new file mode 100644
index 0000000000000000000000000000000000000000..59452268dfe48ec4c1646c3202b3b43a0fe02a35
GIT binary patch
literal 3976
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

literal 0
HcmV?d00001

diff --git a/docs/handbook/flip_top_bottom_hopper.jpg b/docs/handbook/flip_top_bottom_hopper.jpg
deleted file mode 100644
index 03a5020f3904067cb13d2ea918dd382dc4e29cc5..0000000000000000000000000000000000000000
GIT binary patch
literal 0
HcmV?d00001

literal 4652
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
D@-E{;

diff --git a/docs/handbook/flip_top_bottom_hopper.webp b/docs/handbook/flip_top_bottom_hopper.webp
new file mode 100644
index 0000000000000000000000000000000000000000..28af4bf36591c0fc44ad2bc03bdabddc920ee3b6
GIT binary patch
literal 3966
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
YSj>lQ@V5l_3oj|F$BFYaXz>q#0Q=j;w*UYD

literal 0
HcmV?d00001

diff --git a/docs/handbook/masked_hopper.jpg b/docs/handbook/masked_hopper.jpg
deleted file mode 100644
index f70a5ec4769e9c861fcfd4e1e90f812cd4369782..0000000000000000000000000000000000000000
GIT binary patch
literal 0
HcmV?d00001

literal 4904
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

diff --git a/docs/handbook/masked_hopper.webp b/docs/handbook/masked_hopper.webp
new file mode 100644
index 0000000000000000000000000000000000000000..ef892cb94f7985b7ef38584d78d479e2c46c0e98
GIT binary patch
literal 3954
zcmV-&4~_6rNk&F$4*&pHMM6+kP&go74*&qLIslykDu4ih06uLjkwv5;p_htov_J;L
zu>fGh+^5^_Jnk*8>iB%CPcQC*^Pm3D);8VmH@<3~n|H1^r!6D+$@pIme4BeW+@I~c
z;M$OUx9<n*y>)*<;7`ae>^(yLgZ@{0=Fa*7d#Uy>JYTT$E9?)j2kL+O&+8uBf6eg2
z`{(<AU=Qb?*Z=W*M1Obxul+yer@4=+zw&>i_znJh{lEV2V?W$KW<T3h_Ci#-qZ)x+
zsq+y{h^QwJj4MXsIG#wH;U@t;xP6|+XW%{FQ17B{$a+?*>JKWWHO)^QtA4TbqQyE{
z#z`H-YCC%x+dlOL5z7K;mX^(4W76+Crsx3jatUpsLrcDJ+m15g9~Bv6ZG{KjO=sA`
z&fFm&D5)qp?m!5uq_pP0;KsmRyB@}85P>T4dJ)fk_O13c)NLMdpmKd!`<24j9DF^|
zsf391wAoYB%H1mm;>i~gi?L^yJ{fCT0C-FSf|#MGi{3C^KufJ2yN*MX^gJ#8#tCGO
z5yItWc^(?Nn+v=n#QlcleGC}mF=t<)Z$Q8V^|)b?;HfV=h(1*#@p!5T0N`xA<sV!;
zjV|f&kDpo@m#nkMJiNcVN|i%CYZ#g+_4|DV!s!|J0%picfB^pf;y!DNJU5=?>C6A4
zcdA$Z45eyUWU;UPHGX!egMp=|H0d>Hzv{#o#O3+@4I;eG<=LGN+`hv?aWkBLe8a|f
z*Q#E(ySbMvf7y~H61u?mKoI+ocXorX(u3)2Ou9hm6dxN2g|=lO$Pc1}OP+txXAh-j
z`ZiV;6up|$w>0mcE<15Yje|Hf9tufOB}uuzbk5LC&TRzNO`&L7_ObWctp5M(2OmL%
z-Upnb$3e(NHjLScaIUh&ABlkyEYZpU%{9(PFv~bp33`Fn%<6FiIwD@T_4sdPS?vQ5
z6pHj?c$w^VSI+2b<@eW0cO`RsZT#Hg{9n~E1+8R4wnUFgisJ<vDc@VD|7)pZn%VB2
zl5LA>jKG4K{Uj2aVU*7X72tqFEWcM{t*l3wS>uQNpHsakxnp>n*p5%tLUQH!KWM?h
zYJ!m5g;~|twK?i=`xMJ_`hE_`^J;ajSc(Y=wQ8Q%Jv8CwvriWpuTMVGH5c|r#%ufF
z2_bSa*vOYZp1`FcOoh&zUVHTPZ)RRs%p-`cd=FTGj2)d|FfOYIuKxj%XP~VAp&dy8
zx!el$v~Iy<s%uj=lk@a*RgQGmANSE`-8d8aVIckG{rXXBv`Nxz5#$ne=CsiX;<Dt&
ztbB`3U^Z=lA<v;0kpH)!pCfr+1AW3@Qq$n4$*SUqxvKd8(M_e2RjRb?Go21x-Zl~D
zmF#rcQY}^frSJ^W{S-bH@w`wHc3WMIoqOquwiY>U|K_*sZn7w_{h{jfOB3^O{1lrA
zG+v*5$(3rh4q>ZP4*gp&Xzp7WQ@?#)$$u>g>@b)I1)5JeWEVQBp7%C=Il5D_`YRvK
zPXu;pEeF0WyXeGuk}w<GEGF6x4yy;^v}m8DZXG2=cl~c-oy^>B{VVG>SX`Aj0~pf5
z4Kl3^>6_wt1ci(nr;?XkJ^Ch%g_m&A0GA>i+$#weQZo$zM-$k|&a}iZ-L!=j`43cE
z9bA364fI{^G?I=~3t8FtQkL{Kln;e!gRuFvp#uzhwZ=2jbHX!frLFh<Y&oOzw-9Ep
z+?qk2PROSatwB@^{u|>lPHRx%&F%2N0-h<?nPfXD&a(J-1Ni^*opI(2-x{@O$h~Gp
z+9w(hK5%FJO1~%SIHi}E&u37PNQLlMk%NU%k7?^vLDV2&@O|4mm6e<q!tyv#ZRuOK
z)JW?3zypmuX|!Q*&kcAE8Gd@Im(7_{$o_Q}B;T~vdTnS}Yk+mx&4ZHTkI#)||HYI6
zal7JGVt87H&7pD)slWft9rDa@{#<XD0(_GsU)g~)hGK8fKn#ayc4;e*fUXMW9YXMS
z$9saoC8XbpoXA;rdZZT8d6sJYSnB9KtL^jAJ<9w0B3oBNjN)jMkS#(oeuJo`T#wKs
zc*ZQDA{osl<?RnSqJz9o#e_t5@ztKs+)%HgT^fwrX;_Vs7BMv$Z)T)Ws>#B(PoOB(
zh^&RS)Q?dghEdO5<ghXa7>QZ5xX#<d^h$~VEVyT$y#j=<^A5Vt-DNiHWaj&7Io8It
zy0usb02Y}Cs5oP*vt!Pe9!g!C4oIG8if<KHednJF*TnM&FDnD|7~7V8d8_ML9*R2M
zGOw*Q4;oo^R5AH+6HU<<^rR7Ujk9VHJN^j`;7hZC5y0r>-j3wg&Ep5#t|hvUIk>bX
zaWw^uQ`?rCa(b~SB;S`@^DQLP?`l_@bJtpq?-8=fmS4?j=i)^%1))sHekMFPJ2YyS
z>mn}D*+dXh#`_7)fQNVfSKr_@f#f_z>rYxL8|>D!Q!DDNG0Fho3bDXF%AEp`LwqU#
z2KzL`c*P7aM++!I%2hUztK&fn7~uzMLWQWgwOwYBNle}jRp&>0cbw<JV8-O7Iqy_5
z0Bazw5{yvxns0b$U&W}$YdYe?=Gu=cXI02cYZJPLX$2iu=NaV)Z;PN;P09AR<&1)8
zN}O#ce$2G={%H*&6!+o48rJ>wIRAr{9w1kXQ792i?YaO^V%tY2m`tr%bIPn$293T$
zj$C=XNLlhGtC8ywqH{_B^I4s^Ou5C|nL943XYh|rWelAFEVB#0=A#8|<Z)!t;Op-O
zKnqLbZc*@NNvh?Y*>1Gr@adX3h=a^u!8&3^j1c8U7+|*}{^2OnbUQvyvqE;IkvN((
zK<315+Rd*{I@wvT-b{j@Y3)DA?rLpR>u&}rtc6nDi}Ud-?e#QKPj1^1wWIxZ(|<~U
zN&`*D2l57C0f|tjc|cP`;*Q720GuhO>NW;RE*{k+anwtCJ5&*HaZEgt_}k?BziXI#
zA0ke{SuOs*z@_ItF<S4+Ng_<diN=M4D}1I~OCRNljO6#&tnDE&zpYA9aPGS`ublQ_
zz+L3}GGKG7*{OQwZ73)r6yNbY4vozF(`y+}^9bV$4%SE0L#xtb>KdoU+PQvp3QJB3
z+1j;|e>+_{r8t0QPcE_L;XSP30Wc5JbbSy5bB^6{T27bO!6HlP<R?41N{G=giR+Cu
zm)$%c%HASR2b8w3%iDk$8V&a|sNXAxZUTbYjrOhVp4I1>|2^EZwbV@x@Y?Y;#<$85
z)M05j$c}JI?25}&z8UD0I{F+QJqHb|I*-;c()c2TgRezgUOp|B8uZl3_=>UyEW0g>
z!x7OEA964%VUz*ec{MLVRlAfF43v0X^u&iKl4+d~8Ru_n2GB+PaI?5|B{TT;!#QxY
zcB{XSQwT}AN~h}9i9gWC4}ZjRoT}!Txw~tmiCtp>Ju<@|V4N3V;`)4Uq-w=o6NZb8
z|03Vog$p9`jiAw&RWV%w0Vg-UYxa+WqP~<6u|GflDkzORFvdiH1>8(C4Mu>%t$ZY?
zxMaOYj<$8OJk*S%?E%`OP(BozbaXpR4%OF^t#4l`KxIDt8~$Dx2s09gj8d@guiz{1
zxtx89#e2*U4M7R<Mu6wZ@jJJ=T@rDyuI(at8<oEx#9Oy6cXkop&6-BxbDDU<@)`ud
zkea%NP7qK_fL1bKghm+Huecm<j~{P)`LJ`baUvKz1y6ZAJI(jc)>nVxpNPq^0A$F?
zCRA2Xjm2`4oiEZw_DH`jWsqsVF}<0Kyrufx%_GP#<N`o+Zso{a`NjQl=fApiEx{73
zp~YB+R`Mi~u!9Z#OZ7Zje>(j<p0&C2*0kzOwk2s<5&ZX{Js8z-N!IVoO7)D(YHnHp
z891Mb`?{4izanS%q<wC;DEuGK17817uIK&kGXFvRu(}j$as2(4dtM|y87e#x+)SGC
z$BQ{sO`9h_WD50G%vy?A=PP4l2s7wtsLTomI68GmISQgv7s3i_Em8qn*{-AnDgg12
z??|#_)pOjzc?os`e8^OS5vH1_*=GCD;R&fN$Z#(=2+N?-#tgpEe>S?ISJE}0{Js5=
zjrm-)!FEKp0^Ye=d&syk3#(HLD?Ol&SFn|+40XOKx`Nqo@D|zXfQPPI;4a7Z6X)XT
znMInN7y#y{BLCXYarQ-&dEKiZ3yWXA^9Dq|&>t1Mnnv`_gaR2O%ZCQ`KbQUChG{z#
zgT4c{$~8h6GfvHE@>s$YdOr_HVV?b$tfw^d7Aqu_ntfN3y<-8pxEZR1EN=lplZ*lr
zMGoVa``qU!|Fbayo`3;Kqa#b-Y3Sbl5krXQzpMwMJIaYgILuez#5tNJf_8wJU2_ll
zNHB{&6%IuBao-$~-;s8+KHGcLp-=kWzB54)uVD8#JNDgI^>oXK{OH?*x1y9Ta1(d~
zlRuEQUqYWf8qn9DfBCydj6XXZucW{=aN3uN)dya8qFvS^C5(ZyOgyLr*NykC|JnQ3
zZ+-#akJBu*&fsG$QEkY|=CS$nVzB|lbx=z;(hIp>ccukpmZg(-1RJFUT5Sl?sSmZt
z5=nZhHQJis5<-|zZc9Ndg34%2=6Oks9(}{YIym4^#iXU=4L>bfZ_EJW!Dw13EiVX{
z2NQOd$z~vaG9C}opMwi;tMJGVsSJ{cYNerFf$y>1{^+i0D8q{M=B_E(+p^<-SX*}w
z5aY8y8g%?zjv9;Z<8}!ndxM8v)R>ka7t-CQYo;LnSioQ7lQjW|s&VsLi<L_48F=Az
zK9wwxxCuD~3D;l2iuH+x8#Tui%1B2E_^_4~`(>nAhsLNQkp^*gg^o}D2xgZ%Ip=AN
zztI|&?=rTM8ex>CJI>Jp&>fzGP`hPud^O4L#X2r^bjeMWKYL*ceAPU-654b_VSmK$
z*~$BL`=wEuPld^TcpHT+4geJr&L;+AlVKV?jR=N4xVhj`wrQcg5Mf|1d&bQvbe6fR
z-CZxN!*82>*y=^+<l~w)YnpUO3tQ@|JvOz_nnt&mX{ef=0l;n5!<9<hb-wSn0KUgn
zaHzH8bJHV8=3DP6<(>|MY+F%}EkLvmaUNBf{hr#K+}7c<%nuuw9COd?z@4@Cf(OLy
zY);o|g<d)6Fy&7LW)t~IQMqENsP64?C{p;+TpNB5@jxhant8u0o3F`xQQbkv_B!P9
z^V5Jmsq3-t-K3uN*zM!!qx<uZ23*BK{9(WtzLCQ=!=T1rY15kK?tjuNO>w;0@wg!h
Me`MlElL5m302v_I#{d8T

literal 0
HcmV?d00001

diff --git a/docs/handbook/merged_hopper.png b/docs/handbook/merged_hopper.png
deleted file mode 100644
index 662816cbdad42a04dd522acbbd195c2d789fb87b..0000000000000000000000000000000000000000
GIT binary patch
literal 0
HcmV?d00001

literal 35390
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

diff --git a/docs/handbook/merged_hopper.webp b/docs/handbook/merged_hopper.webp
new file mode 100644
index 0000000000000000000000000000000000000000..324628358e8d81658f72449d3a8d99cc69a5127b
GIT binary patch
literal 7536
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
E0m`+u%m4rY

literal 0
HcmV?d00001

diff --git a/docs/handbook/pasted_hopper.jpg b/docs/handbook/pasted_hopper.jpg
deleted file mode 100644
index 36e3492a40f92e1c37d91722e1a993793fffbdec..0000000000000000000000000000000000000000
GIT binary patch
literal 0
HcmV?d00001

literal 4645
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

diff --git a/docs/handbook/pasted_hopper.webp b/docs/handbook/pasted_hopper.webp
new file mode 100644
index 0000000000000000000000000000000000000000..90dc3199405f55fc02c8f41e80f945c24253c010
GIT binary patch
literal 3922
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

literal 0
HcmV?d00001

diff --git a/docs/handbook/rebanded_hopper.jpg b/docs/handbook/rebanded_hopper.jpg
deleted file mode 100644
index 324f7ef14e1e2ec5c1268a2b060bbeb79310a5ce..0000000000000000000000000000000000000000
GIT binary patch
literal 0
HcmV?d00001

literal 4743
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

diff --git a/docs/handbook/rebanded_hopper.webp b/docs/handbook/rebanded_hopper.webp
new file mode 100644
index 0000000000000000000000000000000000000000..7a9069c9f3d18b5ec4b705144cf9460cdb870093
GIT binary patch
literal 3866
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

literal 0
HcmV?d00001

diff --git a/docs/handbook/rolled_hopper.jpg b/docs/handbook/rolled_hopper.jpg
deleted file mode 100644
index b2220f39cbe11fa43e25b698a0dae49a4fadc39f..0000000000000000000000000000000000000000
GIT binary patch
literal 0
HcmV?d00001

literal 4651
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
AApigX

diff --git a/docs/handbook/rolled_hopper.webp b/docs/handbook/rolled_hopper.webp
new file mode 100644
index 0000000000000000000000000000000000000000..7fe8024636331b408b5ba490068f5ef0e6d47b7c
GIT binary patch
literal 3912
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
We(5faI#p@En3n~-hxB4RlAr*+LdKf_

literal 0
HcmV?d00001

diff --git a/docs/handbook/rotated_hopper_180.jpg b/docs/handbook/rotated_hopper_180.jpg
deleted file mode 100644
index cee897e9556897ab46577704966389206852f334..0000000000000000000000000000000000000000
GIT binary patch
literal 0
HcmV?d00001

literal 4636
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

diff --git a/docs/handbook/rotated_hopper_180.webp b/docs/handbook/rotated_hopper_180.webp
new file mode 100644
index 0000000000000000000000000000000000000000..08e14f0e3a150d24a3ceee5da271cacca441778d
GIT binary patch
literal 3946
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
E0O35#SpWb4

literal 0
HcmV?d00001

diff --git a/docs/handbook/rotated_hopper_270.jpg b/docs/handbook/rotated_hopper_270.jpg
deleted file mode 100644
index e4d22be70ce2bc4887a41799e1343fa0cc513cd9..0000000000000000000000000000000000000000
GIT binary patch
literal 0
HcmV?d00001

literal 4895
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

diff --git a/docs/handbook/rotated_hopper_270.webp b/docs/handbook/rotated_hopper_270.webp
new file mode 100644
index 0000000000000000000000000000000000000000..ead2e102e23cc79f91c41f519d54e18ca7e5ad33
GIT binary patch
literal 3922
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

literal 0
HcmV?d00001

diff --git a/docs/handbook/rotated_hopper_90.jpg b/docs/handbook/rotated_hopper_90.jpg
deleted file mode 100644
index 763785c7a1d5b2d45df93884dc63f9a8217ba686..0000000000000000000000000000000000000000
GIT binary patch
literal 0
HcmV?d00001

literal 4903
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

diff --git a/docs/handbook/rotated_hopper_90.webp b/docs/handbook/rotated_hopper_90.webp
new file mode 100644
index 0000000000000000000000000000000000000000..9a5f70b2030835a5feeaf54665ddae2ad49cbb53
GIT binary patch
literal 3888
zcmV-056|#YNk&E}4*&pHMM6+kP&gnQ4*&qrIslykDu4ih06uLll0~E<p_dD8j6ep&
zu{G_hM}fE8G_R-ghPA(<;aNA9(Em;9*Kenq-`cNNuQ*NmE$O=WFUELJ<QLWc-G5!@
z84_;H|5fXQ`9A*sGHM0uU-CQawmZ-x+%K<x!2a*-Q}MoJeVO(E{af+3@J00RU@y|%
zh+p`BrSwDfSM3kLck}P;zxF#Ae&hQ=e$pe_^u{vf^+At13wRzekjN~=1MT)6^1pVu
zqNa|_6I@o=b6|_W%yYU$IzA*3&mG9;#p$L>HSZk7)3n3gbK$TISR>t6^SW0uzjuVW
z=~g&~b(HXUH4^hSHi|-+w2xn>wL?<6xjuR7E48MK7*F)jXGyLus@BhbbcR-n((qe`
zSrLY-8@V>b;_NSR+F5n4qBp5lI2xRx;_*Rg^2REYT;p{y;{tpY6ggqphX;PTY(Td`
zram9(&TV%)6<_yqLP5V@5wC~!tzmCpfd`<1+LS#&kK*m7Z^X?Ng`}`7I{^LDF1{mc
zINrupWn_}e9Nc13Q4ep2(@5}ri}X!g$sK5!mF!-9PR~KX|BdQwQy{~<px}s4+HFxg
z8I#RYU8r(m!^nE$Tr)LGZO!RR_I>+}2<h1Tc>PGBT9nlquz&#mZhRggE^Buq60aBe
zl3#N_3~X=n{=wpq582jz-ly^Oo*4!{esl+TS5)2C3i|3Sd7VOCfkyD0!5owGcvZBh
zwW_Z8Z1K(GZctzR5X;|)^(*P+r4~?G_{i}LH<&k6ZWNH3q!$}*d-?6qIkfF6^H^ib
zv5bOb^vj7~p*kTuW~$o0`|?kqMNHWL>L5>bFk``-vGM76F?5fD7DEu^rk`FTTAE3N
zECJwa&@#AM%PZd|ZAj(+pG4a-Y`%w?_5q$yk21}wocGFS9z!V%y78*ZP=}BOp=6YW
zgY@c^MZ5NdH&LDtbi@hx#2z)kiek&2z&mu6ONtlWh2|rbj=_QF%_7$BMxN$-b$^X!
z1vK^HjCiFzmFL$89zOYu8WEv;I+X+UlFz7*SyX`Z2vC2$RQEI#Gix0c4wA@&;g+sM
zBERz}{Ul*Wv){8Q;OC<5slOxrf4rU_djcJ2Qyr|M2AZYy#9`n66PK}RlKqgAdOYGC
z(|m}X+tmaA1heL}6BzjLPEM?dnU3MU$H{WnId~^7nfgeVyLJPfX);na<J9BQZQdhl
zg}y*rHe8G;(CW#CR1ur5++RdFC3}hu)a1rUA1*DX^m}nT;Hj>9keY<seQbi`<|DY2
zPjAHExWZxd64B>QVj0`C>0I*}H&VgAfD}3YI?C)`CT~r5CZA+LIl_>USHdy+-Y|BG
zC2)Bg`p}FoAos;9CUaNJ66e$YVJi(^I0@lTR<uhR&lso$`gnH=B(LD;mlf3vn&0jM
zz@}rsNdOTQhQpHTYq@TKa!j-m@M1OPY{ae@YZKeT5iD7*77iXep`5Epkf9TJ795lg
z2?>UV`VtWsPs<s+WBHJ%>`M!a`x4v9Ju-)>d6!kP1o!dyG)WLr1=?ih5|kJCv)zJX
zj(|qB-tz8H_+?c5pwb!d*Q7yq>lPMgbX9*L$u&;@I8|o}K}`zN!dowM(PZ(NZA#6E
zRyui&<`4P*@D4-9mD&wxNI{*i#z1~HME4$oIb)J#T}%PDQPQ3-8Y7yT=O}1!5VW#|
z#3kQ#0#_;KG0|mczl^&r=cheMf>T~9@9Utx6%r@-i`Z}hyXY8EJySV+|N0o1rYIh}
z!yY`>bYsK%sQcY!H?kJApT;lQ0h$PEpJV6nu{@1%Tufb6Pye{6|6C8D-`2_O#!(Ua
zdds9>MV=q?2q4Ob3T^wIwE^aDotGPi2&qgb@bM`@-3*ntn&->v3qp1$LyJaFBKRk=
zy}-x%!7DAak)IpXel5NVmF<H?W6sC_xNYil*=tY+)r<fJbKqdqX{{YRjm<bzIS@pg
zslxSbNw$5&K0M_3=d`pF*fVwk>0PwF;Hp2;y1R0HN&~c~YSJ+Hud&^ok`=UZ1aY;P
z_DBmt{SePhw;ZG%>sVkctF3?(4c^OU`t|rzav&1U*;8qIooA7<;`njmE)^0QFouRW
z`JG3$CYGLAJp}KIYr5m=>?tGz#HIGK>S$@W`6-@Rltpo-wi_ZI?(A0A8TR?+S@<9h
zO_PqLp^LDlU$hg09d+ZyxLZHQ!xdKXm#ao4nLh?zKg$(ZW{1Xd&=eJCHo=uEC>j%}
zoJ)#e@4qXJk57t5gzX$1^}pk4LS*z`XszQ#{`Ie$69-656^kEr<P&}*Ns29KKzLv3
zK}9Zrgn~*ng}Ob^Mg9DL#sasP23O2Lp$_D4J)^+KH>h*40nZg8OKdCQM>hQ>UGt8`
zkMb+~hynQ711%g=<;j&9eslmb*R;j1f@?$Rg67~$ZU8hwewD%(si@54ex=6~x;!+(
z<I@e@CE$;X@nkiPIluCsXBg0S|5_h*9Q<SkB<WhW`s$jpr;oKO7Mn-=AEBJMng`JL
zDU_1p;)Y9w<p#H8%|5^#y$e0N;blN}YM`F%gF;!nLALGarT3_1s(QAxnCQq;c%HZT
zkk;GvT0CD&%vPEHZa?~P4Ig0I7{b$93Jv;IZR$%)K>vW@Y9M$2;nN1dLuxqJ4rz+*
zBj_fBCf=*ZQdZQ-SW$iY?b?2Y0#cU-1(ilgNa-CpTcSW~R6x&K>&L7-<7ub)`~Y1@
zE-e&Noc_drUW6-~9NqCaB245KoAKG(xabvNRd{CuwCX-F(%N>zY#enUDYssF+@pyF
z#kJ^^wE)yxyALyepCjHP^_I(v7k6i{=?=elB(0;@c=8%3$QJJ8=@=TMp@vAELWFM7
z_UN*&Sfc7gyeSRkb<G;o`GRbCqNK=d92H;w`6O;WZH)2TM+`}8jp3kjg5lRgaQoxN
zOqr9!5}-{KVmhRDd(@23^hVoo4rA+sb@vji3H`Qc#@+&7*?GD|G1!`bgyxnxs~=#U
zqBZ#`<^@;hb(VGba>sr?depD<=bdiUIUrmhs+d35Q-D<il>ZC@?IsvX!h`K&;7jrE
z<4|ZTHY=U$SQ(E!%O!E)Mj2kheN?|H*!QrgrOl;ZAuM%U*std^n+KQP7eN`aN)<=S
z#I+Dt<92V(kJYLJuVF^=ZKYq?%eFM;<Y$>a!sjYrotHFM*kftasRwOPmt8BZnlwRE
zGFabqQ^m3?yPx|niV@`gqLenG;hLT>B)<-g&zk;aobHGe=!n2fcwbL+oo3SiJuPI=
z)y4G1?0p)qV<Rmia}<P()dv04aax#n3W=aBTzvt}RY3H{{PIQyNadLsJAe@iuv&F~
z1j~S~H#8QXZvb(cSy589L(}f<p;_6%X_a8xbGwM}xPs93!yVZN!hrE^j*SI*pnzVW
zNQkDN@Iv{u)xLU89)l@8S_}4*(hB+=%5(9VyrqQx$dq!_XUe_CZbl=kl?;bqQl$7c
zRY~8Dfe1q>h1znxCgm-2@*q>KH9vP<7sM(U(QZ!}PWS?iyT46Qg#?F@w+OhY^UPsO
z6g)R;jf_%{=%Ef^SDeV{DyzVv=ddtAA3Ltt>FN#-*Q)UtD{HB?Wp5Nc3?%UUr{@r}
z_<-y)!|&KE_>QR&Eeo`e45?5#^h}Jk$Yi9~S|)yWTUV{*?yYz^3IA=tEI@-8kZAcK
zlhzR3Z2h#(?*v!f0rJ4LmT4kk%yoyuYV!uayNHRa!@$rl#3*Y05uU?WID}g;<UA0B
z*X9V`2z&^vDD`z)G?GTtGO)s9b{wRt?|`7iwy<)(<s%Xr3Nvq3vc%dy=>ybzN=h_8
zfwnI%Ei**40KdPDkf&aI?c?abxmmEmY1t(-x!$e48I;)z=rb#urGRMC=TJN@R3a>Z
z^q<k<Nd!N5j;E0sb4sgD2g!bM_ym}X)TVxOcp7<7h_Nwm!#4I~M~it`!OKLE=Xk)X
z(#6?=N{@<Khhlh3B&&Bp)-Uifb$=+x&+&AB<c4myQKNPrc5J(Ya?c5kj%+0Y?*L(g
zyhrD8{9FL39J2X0NFVYJEw4AP_Q|G;aT)D#br`+dYh*P)k+K(&69Kd8BB==p_&B<)
z%vgac`h^3}6a^~izYf8pVZZu4vOi<S0ZZ>mCyvK^)X!5(KToe1Q^+aJ<=YQbSF?f=
zvm$cAVUlCzU&+^B{Dn391=ot6wcHRJ9r5-sYu=)3uSQ?D+?Q~Ks)(bQX1?Ih8=#H+
ze#Tf1=cYGRG9+>hT)=YeFuUF8K3bsB9iJCH?dTDrN4uhU+<((}$0bZVaLhjNa6|b|
zoI8yP)XL#6$hrUePLk&ytAE%jykWPeX773*s0n30s|$!^Z`uZR7KM>e;~BEm{V1zQ
zG}L|DG}rI8+J+UL(1b*hJA*+D+UwEDntwg6iG%pxf0HkXR;3Fy;dEZ7f=b=IB`2Ka
zbkYf9uJ3pMrsA2shoqu0{-VDMw8+Wgs7_gEk^|d9>Tt!`g>hRYd;@$E`oC`6xo_^b
z(EcF(9<QaBZTV2>K+o5^DRMG33-`VQbsiml;g;nO|DX6+7g}hB)!d2!390;Svi;Pq
zTfhvV%3c<SgKTfw6$)W}aTqBG3DOipyxt5WLoAFG2>%WmlD4Nj9c!w#Z!h1Zv){_b
zYd=LPYuAkgEi}l)LH7iIqi3r}@_I}e7IEfd1<l$$AzRMB#y&REK;GH-6x$PMH~2&-
zNl`Z6N(tb5ikNHlBSGJEJtg6`YU3pzZ823~!)^zZ_y>D2q8isKg?6v(P%pm=altYi
zYGP6I@ch;3K(#ule7=&yZi9t@^2fXCViJIbYe-$EBp$~Hs@v&@=V=mNH1GWdNzm?o
zN%1Xv9c*)?+6O2u;At0Qy^~_+lZ}iMrafFMR#?m>9Rn%}wOyQ$tAjX$9Mt{g5b#r-
zPk!%bD)!m6tdyIbp!M%e{)?vcGZ}xoNdb&UQs(e4vw$k9%F+N1KgAL-k~-4v!$_p-
zfmkA79Outxi^<ScVkn~_S!$k{ND2#!c<cg@XwcYi#-wo-p9<{IN99B`KMOazmU0J(
y=e>ihHO%wx`X04Ln#|`LjgYWmSe0R99ub4DRltdZb7pPwWT1nD2^|#ehyVa4_`Em(

literal 0
HcmV?d00001

diff --git a/docs/handbook/show_hopper.png b/docs/handbook/show_hopper.png
deleted file mode 100644
index 1f2e6f243858d8a9944c4db0b1c0758111cc45ce..0000000000000000000000000000000000000000
GIT binary patch
literal 0
HcmV?d00001

literal 56122
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
F{{xhz)w2Kq

diff --git a/docs/handbook/show_hopper.webp b/docs/handbook/show_hopper.webp
new file mode 100644
index 0000000000000000000000000000000000000000..5cb73325b35ec9a322dfd02568f13bd124dddf69
GIT binary patch
literal 6548
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

literal 0
HcmV?d00001

diff --git a/docs/handbook/tutorial.rst b/docs/handbook/tutorial.rst
index e19da47a54a..402f57f69c0 100644
--- a/docs/handbook/tutorial.rst
+++ b/docs/handbook/tutorial.rst
@@ -37,7 +37,7 @@ example, let’s display the image we just loaded::
 
     >>> im.show()
 
-.. image:: show_hopper.png
+.. image:: show_hopper.webp
     :align: center
 
 .. note::
@@ -159,7 +159,7 @@ pixels, so the region in the above example is exactly 64x64 pixels.
 
 The region could now be processed in a certain manner and pasted back.
 
-.. image:: cropped_hopper.jpg
+.. image:: cropped_hopper.webp
     :align: center
 
 Processing a subrectangle, and pasting it back
@@ -176,7 +176,7 @@ modes of the original image and the region do not need to match. If they don’t
 the region is automatically converted before being pasted (see the section on
 :ref:`color-transforms` below for details).
 
-.. image:: pasted_hopper.jpg
+.. image:: pasted_hopper.webp
     :align: center
 
 Here’s an additional example:
@@ -201,7 +201,7 @@ Rolling an image
 
         return im
 
-.. image:: rolled_hopper.jpg
+.. image:: rolled_hopper.webp
     :align: center
 
 Or if you would like to merge two images into a wider image:
@@ -221,7 +221,7 @@ Merging images
 
         return im
 
-.. image:: merged_hopper.png
+.. image:: merged_hopper.webp
     :align: center
 
 For more advanced tricks, the paste method can also take a transparency mask as
@@ -250,7 +250,7 @@ Note that for a single-band image, :py:meth:`~PIL.Image.Image.split` returns
 the image itself. To work with individual color bands, you may want to convert
 the image to “RGB” first.
 
-.. image:: rebanded_hopper.jpg
+.. image:: rebanded_hopper.webp
     :align: center
 
 Geometrical transforms
@@ -269,7 +269,7 @@ Simple geometry transforms
     out = im.resize((128, 128))
     out = im.rotate(45) # degrees counter-clockwise
 
-.. image:: rotated_hopper_90.jpg
+.. image:: rotated_hopper_90.webp
     :align: center
 
 To rotate the image in 90 degree steps, you can either use the
@@ -284,35 +284,35 @@ Transposing an image
 
     out = im.transpose(Image.Transpose.FLIP_LEFT_RIGHT)
 
-.. image:: flip_left_right_hopper.jpg
+.. image:: flip_left_right_hopper.webp
     :align: center
 
 ::
 
     out = im.transpose(Image.Transpose.FLIP_TOP_BOTTOM)
 
-.. image:: flip_top_bottom_hopper.jpg
+.. image:: flip_top_bottom_hopper.webp
     :align: center
 
 ::
 
     out = im.transpose(Image.Transpose.ROTATE_90)
 
-.. image:: rotated_hopper_90.jpg
+.. image:: rotated_hopper_90.webp
     :align: center
 
 ::
 
     out = im.transpose(Image.Transpose.ROTATE_180)
 
-.. image:: rotated_hopper_180.jpg
+.. image:: rotated_hopper_180.webp
     :align: center
 
 ::
 
     out = im.transpose(Image.Transpose.ROTATE_270)
 
-.. image:: rotated_hopper_270.jpg
+.. image:: rotated_hopper_270.webp
     :align: center
 
 ``transpose(ROTATE)`` operations can also be performed identically with
@@ -396,7 +396,7 @@ Applying filters
     from PIL import ImageFilter
     out = im.filter(ImageFilter.DETAIL)
 
-.. image:: enhanced_hopper.jpg
+.. image:: enhanced_hopper.webp
     :align: center
 
 Point Operations
@@ -448,7 +448,7 @@ Note the syntax used to create the mask::
 
     imout = im.point(lambda i: expression and 255)
 
-.. image:: masked_hopper.jpg
+.. image:: masked_hopper.webp
     :align: center
 
 Python only evaluates the portion of a logical expression as is necessary to

From 4db814042615a45aec0847ee55ef35f0f32521bb Mon Sep 17 00:00:00 2001
From: Andrew Murray <radarhere@users.noreply.github.com>
Date: Fri, 19 Jul 2024 18:49:04 +1000
Subject: [PATCH 0844/1178] Removed unused image

---
 docs/handbook/rotated_hopper.jpg | Bin 4895 -> 0 bytes
 1 file changed, 0 insertions(+), 0 deletions(-)
 delete mode 100644 docs/handbook/rotated_hopper.jpg

diff --git a/docs/handbook/rotated_hopper.jpg b/docs/handbook/rotated_hopper.jpg
deleted file mode 100644
index e4d22be70ce2bc4887a41799e1343fa0cc513cd9..0000000000000000000000000000000000000000
GIT binary patch
literal 0
HcmV?d00001

literal 4895
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


From aa8d87696b27068a0e8f4303d7e631e00c3a5225 Mon Sep 17 00:00:00 2001
From: "pre-commit-ci[bot]"
 <66853113+pre-commit-ci[bot]@users.noreply.github.com>
Date: Fri, 19 Jul 2024 12:14:51 +0000
Subject: [PATCH 0845/1178] [pre-commit.ci] auto fixes from pre-commit.com
 hooks

for more information, see https://pre-commit.ci
---
 src/_imaging.c           | 2 +-
 src/libImaging/Storage.c | 3 ++-
 2 files changed, 3 insertions(+), 2 deletions(-)

diff --git a/src/_imaging.c b/src/_imaging.c
index 21c6b0a02e9..a2606df156e 100644
--- a/src/_imaging.c
+++ b/src/_imaging.c
@@ -4131,7 +4131,7 @@ _set_blocks_max(PyObject *self, PyObject *args) {
     }
 
     if ((unsigned long)blocks_max >
-            SIZE_MAX / sizeof(ImagingDefaultArena.blocks_pool[0])) {
+        SIZE_MAX / sizeof(ImagingDefaultArena.blocks_pool[0])) {
         PyErr_SetString(PyExc_ValueError, "blocks_max is too large");
         return NULL;
     }
diff --git a/src/libImaging/Storage.c b/src/libImaging/Storage.c
index ae4bf72fffe..522e9f37557 100644
--- a/src/libImaging/Storage.c
+++ b/src/libImaging/Storage.c
@@ -506,7 +506,8 @@ ImagingNewInternal(const char *mode, int xsize, int ysize, int dirty) {
 
     MUTEX_LOCK(&ImagingDefaultArena.mutex);
     Imaging tmp = ImagingAllocateArray(
-        im, &ImagingDefaultArena, dirty, ImagingDefaultArena.block_size);
+        im, &ImagingDefaultArena, dirty, ImagingDefaultArena.block_size
+    );
     MUTEX_UNLOCK(&ImagingDefaultArena.mutex);
     if (tmp) {
         return im;

From eff22bc34ef5b509bfc996363204bb8723dd7d89 Mon Sep 17 00:00:00 2001
From: "Jeffrey A. Clark" <aclark@aclark.net>
Date: Fri, 19 Jul 2024 09:00:26 -0400
Subject: [PATCH 0846/1178] Update docs/handbook/tutorial.rst

Co-authored-by: Andrew Murray <3112309+radarhere@users.noreply.github.com>
---
 docs/handbook/tutorial.rst | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/docs/handbook/tutorial.rst b/docs/handbook/tutorial.rst
index 402f57f69c0..ffa8fa01990 100644
--- a/docs/handbook/tutorial.rst
+++ b/docs/handbook/tutorial.rst
@@ -528,7 +528,7 @@ You can create animated GIFs with Pillow, e.g.
         "rotated_hopper_90.jpg",
     ]
 
-    # Open images and append them to a list
+    # Open images and create a list
     images = [Image.open(filename) for filename in image_filenames]
 
     # Save the images as an animated GIF

From 204ec11f64e2ec6a322a39dc525bd97e31113d12 Mon Sep 17 00:00:00 2001
From: Yay295 <Yay295@users.noreply.github.com>
Date: Fri, 19 Jul 2024 08:28:59 -0500
Subject: [PATCH 0847/1178] use local variable instead of casting every line

---
 src/encode.c | 44 +++++++++++++++++++++-----------------------
 1 file changed, 21 insertions(+), 23 deletions(-)

diff --git a/src/encode.c b/src/encode.c
index f711865d5a0..529982dadc5 100644
--- a/src/encode.c
+++ b/src/encode.c
@@ -1186,29 +1186,27 @@ PyImaging_JpegEncoderNew(PyObject *self, PyObject *args) {
 
     encoder->encode = ImagingJpegEncode;
 
-    strncpy(((JPEGENCODERSTATE *)encoder->state.context)->rawmode, rawmode, 8);
-
-    ((JPEGENCODERSTATE *)encoder->state.context)->keep_rgb = keep_rgb;
-    ((JPEGENCODERSTATE *)encoder->state.context)->quality = quality;
-    ((JPEGENCODERSTATE *)encoder->state.context)->qtables = qarrays;
-    ((JPEGENCODERSTATE *)encoder->state.context)->qtablesLen = qtablesLen;
-    ((JPEGENCODERSTATE *)encoder->state.context)->subsampling = subsampling;
-    ((JPEGENCODERSTATE *)encoder->state.context)->progressive = progressive;
-    ((JPEGENCODERSTATE *)encoder->state.context)->smooth = smooth;
-    ((JPEGENCODERSTATE *)encoder->state.context)->optimize = optimize;
-    ((JPEGENCODERSTATE *)encoder->state.context)->streamtype = streamtype;
-    ((JPEGENCODERSTATE *)encoder->state.context)->xdpi = xdpi;
-    ((JPEGENCODERSTATE *)encoder->state.context)->ydpi = ydpi;
-    ((JPEGENCODERSTATE *)encoder->state.context)->restart_marker_blocks =
-        restart_marker_blocks;
-    ((JPEGENCODERSTATE *)encoder->state.context)->restart_marker_rows =
-        restart_marker_rows;
-    ((JPEGENCODERSTATE *)encoder->state.context)->comment = comment;
-    ((JPEGENCODERSTATE *)encoder->state.context)->comment_size = comment_size;
-    ((JPEGENCODERSTATE *)encoder->state.context)->extra = extra;
-    ((JPEGENCODERSTATE *)encoder->state.context)->extra_size = extra_size;
-    ((JPEGENCODERSTATE *)encoder->state.context)->rawExif = rawExif;
-    ((JPEGENCODERSTATE *)encoder->state.context)->rawExifLen = rawExifLen;
+    JPEGENCODERSTATE *jpeg_encoder_state = (JPEGENCODERSTATE *)encoder->state.context;
+    strncpy(jpeg_encoder_state->rawmode, rawmode, 8);
+    jpeg_encoder_state->keep_rgb = keep_rgb;
+    jpeg_encoder_state->quality = quality;
+    jpeg_encoder_state->qtables = qarrays;
+    jpeg_encoder_state->qtablesLen = qtablesLen;
+    jpeg_encoder_state->subsampling = subsampling;
+    jpeg_encoder_state->progressive = progressive;
+    jpeg_encoder_state->smooth = smooth;
+    jpeg_encoder_state->optimize = optimize;
+    jpeg_encoder_state->streamtype = streamtype;
+    jpeg_encoder_state->xdpi = xdpi;
+    jpeg_encoder_state->ydpi = ydpi;
+    jpeg_encoder_state->restart_marker_blocks = restart_marker_blocks;
+    jpeg_encoder_state->restart_marker_rows = restart_marker_rows;
+    jpeg_encoder_state->comment = comment;
+    jpeg_encoder_state->comment_size = comment_size;
+    jpeg_encoder_state->extra = extra;
+    jpeg_encoder_state->extra_size = extra_size;
+    jpeg_encoder_state->rawExif = rawExif;
+    jpeg_encoder_state->rawExifLen = rawExifLen;
 
     return (PyObject *)encoder;
 }

From f62446032166827cd0e20c711bca07650019d43d Mon Sep 17 00:00:00 2001
From: Andrew Murray <radarhere@users.noreply.github.com>
Date: Sat, 20 Jul 2024 13:14:18 +1000
Subject: [PATCH 0848/1178] Added type hints

---
 Tests/test_file_libtiff.py   |  7 +++---
 docs/reference/ImageFile.rst |  5 ++++
 src/PIL/ImageWin.py          | 38 ++++++++++++++--------------
 src/PIL/PsdImagePlugin.py    | 48 +++++++++++++++++++++---------------
 src/PIL/TiffImagePlugin.py   | 28 ++++++++++-----------
 src/PIL/TiffTags.py          | 27 ++++++++++++--------
 6 files changed, 86 insertions(+), 67 deletions(-)

diff --git a/Tests/test_file_libtiff.py b/Tests/test_file_libtiff.py
index d5dbeeb6f74..58ac705c9b8 100644
--- a/Tests/test_file_libtiff.py
+++ b/Tests/test_file_libtiff.py
@@ -240,10 +240,11 @@ def test_additional_metadata(
 
             new_ifd = TiffImagePlugin.ImageFileDirectory_v2()
             for tag, info in core_items.items():
-                if info.length == 1:
-                    new_ifd[tag] = values[info.type]
-                if info.length == 0:
+                assert info.type is not None
+                if not info.length:
                     new_ifd[tag] = tuple(values[info.type] for _ in range(3))
+                elif info.length == 1:
+                    new_ifd[tag] = values[info.type]
                 else:
                     new_ifd[tag] = tuple(values[info.type] for _ in range(info.length))
 
diff --git a/docs/reference/ImageFile.rst b/docs/reference/ImageFile.rst
index e59c7311a99..fdfeb60f99f 100644
--- a/docs/reference/ImageFile.rst
+++ b/docs/reference/ImageFile.rst
@@ -37,6 +37,11 @@ Example: Parse an image
 Classes
 -------
 
+.. autoclass:: PIL.ImageFile._Tile()
+    :member-order: bysource
+    :members:
+    :show-inheritance:
+
 .. autoclass:: PIL.ImageFile.Parser()
     :members:
 
diff --git a/src/PIL/ImageWin.py b/src/PIL/ImageWin.py
index 4f9956087df..6fc7cfaf528 100644
--- a/src/PIL/ImageWin.py
+++ b/src/PIL/ImageWin.py
@@ -90,7 +90,7 @@ def __init__(
             assert not isinstance(image, str)
             self.paste(image)
 
-    def expose(self, handle):
+    def expose(self, handle: int | HDC | HWND) -> None:
         """
         Copy the bitmap contents to a device context.
 
@@ -101,19 +101,18 @@ def expose(self, handle):
         if isinstance(handle, HWND):
             dc = self.image.getdc(handle)
             try:
-                result = self.image.expose(dc)
+                self.image.expose(dc)
             finally:
                 self.image.releasedc(handle, dc)
         else:
-            result = self.image.expose(handle)
-        return result
+            self.image.expose(handle)
 
     def draw(
         self,
-        handle,
+        handle: int | HDC | HWND,
         dst: tuple[int, int, int, int],
         src: tuple[int, int, int, int] | None = None,
-    ):
+    ) -> None:
         """
         Same as expose, but allows you to specify where to draw the image, and
         what part of it to draw.
@@ -128,14 +127,13 @@ def draw(
         if isinstance(handle, HWND):
             dc = self.image.getdc(handle)
             try:
-                result = self.image.draw(dc, dst, src)
+                self.image.draw(dc, dst, src)
             finally:
                 self.image.releasedc(handle, dc)
         else:
-            result = self.image.draw(handle, dst, src)
-        return result
+            self.image.draw(handle, dst, src)
 
-    def query_palette(self, handle):
+    def query_palette(self, handle: int | HDC | HWND) -> int:
         """
         Installs the palette associated with the image in the given device
         context.
@@ -147,8 +145,8 @@ def query_palette(self, handle):
 
         :param handle: Device context (HDC), cast to a Python integer, or an
                        HDC or HWND instance.
-        :return: A true value if one or more entries were changed (this
-                 indicates that the image should be redrawn).
+        :return: The number of entries that were changed (if one or more entries,
+                 this indicates that the image should be redrawn).
         """
         if isinstance(handle, HWND):
             handle = self.image.getdc(handle)
@@ -210,22 +208,22 @@ def __init__(
             title, self.__dispatcher, width or 0, height or 0
         )
 
-    def __dispatcher(self, action: str, *args):
-        return getattr(self, f"ui_handle_{action}")(*args)
+    def __dispatcher(self, action: str, *args: int) -> None:
+        getattr(self, f"ui_handle_{action}")(*args)
 
-    def ui_handle_clear(self, dc, x0, y0, x1, y1) -> None:
+    def ui_handle_clear(self, dc: int, x0: int, y0: int, x1: int, y1: int) -> None:
         pass
 
-    def ui_handle_damage(self, x0, y0, x1, y1) -> None:
+    def ui_handle_damage(self, x0: int, y0: int, x1: int, y1: int) -> None:
         pass
 
     def ui_handle_destroy(self) -> None:
         pass
 
-    def ui_handle_repair(self, dc, x0, y0, x1, y1) -> None:
+    def ui_handle_repair(self, dc: int, x0: int, y0: int, x1: int, y1: int) -> None:
         pass
 
-    def ui_handle_resize(self, width, height) -> None:
+    def ui_handle_resize(self, width: int, height: int) -> None:
         pass
 
     def mainloop(self) -> None:
@@ -235,12 +233,12 @@ def mainloop(self) -> None:
 class ImageWindow(Window):
     """Create an image window which displays the given image."""
 
-    def __init__(self, image, title: str = "PIL") -> None:
+    def __init__(self, image: Image.Image | Dib, title: str = "PIL") -> None:
         if not isinstance(image, Dib):
             image = Dib(image)
         self.image = image
         width, height = image.size
         super().__init__(title, width=width, height=height)
 
-    def ui_handle_repair(self, dc, x0, y0, x1, y1) -> None:
+    def ui_handle_repair(self, dc: int, x0: int, y0: int, x1: int, y1: int) -> None:
         self.image.draw(dc, (x0, y0, x1, y1))
diff --git a/src/PIL/PsdImagePlugin.py b/src/PIL/PsdImagePlugin.py
index 31dfd4d1234..cc99cd6d8cb 100644
--- a/src/PIL/PsdImagePlugin.py
+++ b/src/PIL/PsdImagePlugin.py
@@ -19,6 +19,7 @@
 
 import io
 from functools import cached_property
+from typing import IO
 
 from . import Image, ImageFile, ImagePalette
 from ._binary import i8
@@ -142,7 +143,9 @@ def _open(self) -> None:
         self._min_frame = 1
 
     @cached_property
-    def layers(self):
+    def layers(
+        self,
+    ) -> list[tuple[str, str, tuple[int, int, int, int], list[ImageFile._Tile]]]:
         layers = []
         if self._layers_position is not None:
             self._fp.seek(self._layers_position)
@@ -181,7 +184,9 @@ def tell(self) -> int:
         return self.frame
 
 
-def _layerinfo(fp, ct_bytes):
+def _layerinfo(
+    fp: IO[bytes], ct_bytes: int
+) -> list[tuple[str, str, tuple[int, int, int, int], list[ImageFile._Tile]]]:
     # read layerinfo block
     layers = []
 
@@ -203,7 +208,7 @@ def read(size: int) -> bytes:
         x1 = si32(read(4))
 
         # image info
-        mode = []
+        bands = []
         ct_types = i16(read(2))
         if ct_types > 4:
             fp.seek(ct_types * 6 + 12, io.SEEK_CUR)
@@ -215,23 +220,23 @@ def read(size: int) -> bytes:
             type = i16(read(2))
 
             if type == 65535:
-                m = "A"
+                b = "A"
             else:
-                m = "RGBA"[type]
+                b = "RGBA"[type]
 
-            mode.append(m)
+            bands.append(b)
             read(4)  # size
 
         # figure out the image mode
-        mode.sort()
-        if mode == ["R"]:
+        bands.sort()
+        if bands == ["R"]:
             mode = "L"
-        elif mode == ["B", "G", "R"]:
+        elif bands == ["B", "G", "R"]:
             mode = "RGB"
-        elif mode == ["A", "B", "G", "R"]:
+        elif bands == ["A", "B", "G", "R"]:
             mode = "RGBA"
         else:
-            mode = None  # unknown
+            mode = ""  # unknown
 
         # skip over blend flags and extra information
         read(12)  # filler
@@ -258,19 +263,22 @@ def read(size: int) -> bytes:
         layers.append((name, mode, (x0, y0, x1, y1)))
 
     # get tiles
+    layerinfo = []
     for i, (name, mode, bbox) in enumerate(layers):
         tile = []
         for m in mode:
             t = _maketile(fp, m, bbox, 1)
             if t:
                 tile.extend(t)
-        layers[i] = name, mode, bbox, tile
+        layerinfo.append((name, mode, bbox, tile))
 
-    return layers
+    return layerinfo
 
 
-def _maketile(file, mode, bbox, channels):
-    tile = None
+def _maketile(
+    file: IO[bytes], mode: str, bbox: tuple[int, int, int, int], channels: int
+) -> list[ImageFile._Tile] | None:
+    tiles = None
     read = file.read
 
     compression = i16(read(2))
@@ -283,26 +291,26 @@ def _maketile(file, mode, bbox, channels):
     if compression == 0:
         #
         # raw compression
-        tile = []
+        tiles = []
         for channel in range(channels):
             layer = mode[channel]
             if mode == "CMYK":
                 layer += ";I"
-            tile.append(("raw", bbox, offset, layer))
+            tiles.append(ImageFile._Tile("raw", bbox, offset, layer))
             offset = offset + xsize * ysize
 
     elif compression == 1:
         #
         # packbits compression
         i = 0
-        tile = []
+        tiles = []
         bytecount = read(channels * ysize * 2)
         offset = file.tell()
         for channel in range(channels):
             layer = mode[channel]
             if mode == "CMYK":
                 layer += ";I"
-            tile.append(("packbits", bbox, offset, layer))
+            tiles.append(ImageFile._Tile("packbits", bbox, offset, layer))
             for y in range(ysize):
                 offset = offset + i16(bytecount, i)
                 i += 2
@@ -312,7 +320,7 @@ def _maketile(file, mode, bbox, channels):
     if offset & 1:
         read(1)  # padding
 
-    return tile
+    return tiles
 
 
 # --------------------------------------------------------------------
diff --git a/src/PIL/TiffImagePlugin.py b/src/PIL/TiffImagePlugin.py
index 253f64852b1..1dab0d50b44 100644
--- a/src/PIL/TiffImagePlugin.py
+++ b/src/PIL/TiffImagePlugin.py
@@ -445,7 +445,7 @@ def __setstate__(self, state):
         __int__ = _delegate("__int__")
 
 
-def _register_loader(idx, size):
+def _register_loader(idx: int, size: int):
     def decorator(func):
         from .TiffTags import TYPES
 
@@ -457,7 +457,7 @@ def decorator(func):
     return decorator
 
 
-def _register_writer(idx):
+def _register_writer(idx: int):
     def decorator(func):
         _write_dispatch[idx] = func  # noqa: F821
         return func
@@ -465,7 +465,7 @@ def decorator(func):
     return decorator
 
 
-def _register_basic(idx_fmt_name):
+def _register_basic(idx_fmt_name: tuple[int, str, str]) -> None:
     from .TiffTags import TYPES
 
     idx, fmt, name = idx_fmt_name
@@ -640,7 +640,7 @@ def __getitem__(self, tag):
     def __contains__(self, tag: object) -> bool:
         return tag in self._tags_v2 or tag in self._tagdata
 
-    def __setitem__(self, tag, value) -> None:
+    def __setitem__(self, tag: int, value) -> None:
         self._setitem(tag, value, self.legacy_api)
 
     def _setitem(self, tag, value, legacy_api) -> None:
@@ -731,10 +731,10 @@ def __delitem__(self, tag: int) -> None:
     def __iter__(self):
         return iter(set(self._tagdata) | set(self._tags_v2))
 
-    def _unpack(self, fmt, data):
+    def _unpack(self, fmt: str, data):
         return struct.unpack(self._endian + fmt, data)
 
-    def _pack(self, fmt, *values):
+    def _pack(self, fmt: str, *values):
         return struct.pack(self._endian + fmt, *values)
 
     list(
@@ -755,7 +755,7 @@ def _pack(self, fmt, *values):
     )
 
     @_register_loader(1, 1)  # Basic type, except for the legacy API.
-    def load_byte(self, data, legacy_api=True):
+    def load_byte(self, data, legacy_api: bool = True):
         return data
 
     @_register_writer(1)  # Basic type, except for the legacy API.
@@ -767,7 +767,7 @@ def write_byte(self, data) -> bytes:
         return data
 
     @_register_loader(2, 1)
-    def load_string(self, data, legacy_api=True):
+    def load_string(self, data: bytes, legacy_api: bool = True) -> str:
         if data.endswith(b"\0"):
             data = data[:-1]
         return data.decode("latin-1", "replace")
@@ -797,7 +797,7 @@ def write_rational(self, *values) -> bytes:
         )
 
     @_register_loader(7, 1)
-    def load_undefined(self, data, legacy_api=True):
+    def load_undefined(self, data, legacy_api: bool = True):
         return data
 
     @_register_writer(7)
@@ -809,7 +809,7 @@ def write_undefined(self, value) -> bytes:
         return value
 
     @_register_loader(10, 8)
-    def load_signed_rational(self, data, legacy_api=True):
+    def load_signed_rational(self, data, legacy_api: bool = True):
         vals = self._unpack(f"{len(data) // 4}l", data)
 
         def combine(a, b):
@@ -1030,7 +1030,7 @@ def __init__(self, *args, **kwargs) -> None:
     """Dictionary of tag types"""
 
     @classmethod
-    def from_v2(cls, original) -> ImageFileDirectory_v1:
+    def from_v2(cls, original: ImageFileDirectory_v2) -> ImageFileDirectory_v1:
         """Returns an
         :py:class:`~PIL.TiffImagePlugin.ImageFileDirectory_v1`
         instance with the same data as is contained in the original
@@ -1073,7 +1073,7 @@ def __len__(self) -> int:
     def __iter__(self):
         return iter(set(self._tagdata) | set(self._tags_v1))
 
-    def __setitem__(self, tag, value) -> None:
+    def __setitem__(self, tag: int, value) -> None:
         for legacy_api in (False, True):
             self._setitem(tag, value, legacy_api)
 
@@ -1212,7 +1212,7 @@ def tell(self) -> int:
         """Return the current frame number"""
         return self.__frame
 
-    def get_photoshop_blocks(self):
+    def get_photoshop_blocks(self) -> dict[int, dict[str, bytes]]:
         """
         Returns a dictionary of Photoshop "Image Resource Blocks".
         The keys are the image resource ID. For more information, see
@@ -1259,7 +1259,7 @@ def load_end(self) -> None:
         if ExifTags.Base.Orientation in self.tag_v2:
             del self.tag_v2[ExifTags.Base.Orientation]
 
-    def _load_libtiff(self):
+    def _load_libtiff(self) -> Image.core.PixelAccess | None:
         """Overload method triggered when we detect a compressed tiff
         Calls out to libtiff"""
 
diff --git a/src/PIL/TiffTags.py b/src/PIL/TiffTags.py
index e318c87398c..86adaa45857 100644
--- a/src/PIL/TiffTags.py
+++ b/src/PIL/TiffTags.py
@@ -32,17 +32,24 @@ class _TagInfo(NamedTuple):
 class TagInfo(_TagInfo):
     __slots__: list[str] = []
 
-    def __new__(cls, value=None, name="unknown", type=None, length=None, enum=None):
+    def __new__(
+        cls,
+        value: int | None = None,
+        name: str = "unknown",
+        type: int | None = None,
+        length: int | None = None,
+        enum: dict[str, int] | None = None,
+    ) -> TagInfo:
         return super().__new__(cls, value, name, type, length, enum or {})
 
-    def cvt_enum(self, value):
+    def cvt_enum(self, value: str) -> int | str:
         # Using get will call hash(value), which can be expensive
         # for some types (e.g. Fraction). Since self.enum is rarely
         # used, it's usually better to test it first.
         return self.enum.get(value, value) if self.enum else value
 
 
-def lookup(tag, group=None):
+def lookup(tag: int, group: int | None = None) -> TagInfo:
     """
     :param tag: Integer tag number
     :param group: Which :py:data:`~PIL.TiffTags.TAGS_V2_GROUPS` to look in
@@ -89,7 +96,7 @@ def lookup(tag, group=None):
 IFD = 13
 LONG8 = 16
 
-_tags_v2 = {
+_tags_v2: dict[int, tuple[str, int, int] | tuple[str, int, int, dict[str, int]]] = {
     254: ("NewSubfileType", LONG, 1),
     255: ("SubfileType", SHORT, 1),
     256: ("ImageWidth", LONG, 1),
@@ -233,7 +240,7 @@ def lookup(tag, group=None):
     50838: ("ImageJMetaDataByteCounts", LONG, 0),  # Can be more than one
     50839: ("ImageJMetaData", UNDEFINED, 1),  # see Issue #2006
 }
-TAGS_V2_GROUPS = {
+_tags_v2_groups = {
     # ExifIFD
     34665: {
         36864: ("ExifVersion", UNDEFINED, 1),
@@ -281,7 +288,7 @@ def lookup(tag, group=None):
 
 # Legacy Tags structure
 # these tags aren't included above, but were in the previous versions
-TAGS = {
+TAGS: dict[int | tuple[int, int], str] = {
     347: "JPEGTables",
     700: "XMP",
     # Additional Exif Info
@@ -426,9 +433,10 @@ def lookup(tag, group=None):
 }
 
 TAGS_V2: dict[int, TagInfo] = {}
+TAGS_V2_GROUPS: dict[int, dict[int, TagInfo]] = {}
 
 
-def _populate():
+def _populate() -> None:
     for k, v in _tags_v2.items():
         # Populate legacy structure.
         TAGS[k] = v[0]
@@ -438,9 +446,8 @@ def _populate():
 
         TAGS_V2[k] = TagInfo(k, *v)
 
-    for tags in TAGS_V2_GROUPS.values():
-        for k, v in tags.items():
-            tags[k] = TagInfo(k, *v)
+    for group, tags in _tags_v2_groups.items():
+        TAGS_V2_GROUPS[group] = {k: TagInfo(k, *v) for k, v in tags.items()}
 
 
 _populate()

From b976a8496df8ad741595decac321f5469a100d77 Mon Sep 17 00:00:00 2001
From: "renovate[bot]" <29139614+renovate[bot]@users.noreply.github.com>
Date: Sat, 20 Jul 2024 08:07:12 +0000
Subject: [PATCH 0849/1178] Update dependency mypy to v1.11.0

---
 .ci/requirements-mypy.txt | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/.ci/requirements-mypy.txt b/.ci/requirements-mypy.txt
index 6dd43248837..776bb0dbbf2 100644
--- a/.ci/requirements-mypy.txt
+++ b/.ci/requirements-mypy.txt
@@ -1 +1 @@
-mypy==1.10.1
+mypy==1.11.0

From 882a196a8f04f446c9ea6eaaac900fdecf220429 Mon Sep 17 00:00:00 2001
From: Andrew Murray <radarhere@users.noreply.github.com>
Date: Sat, 20 Jul 2024 18:59:27 +1000
Subject: [PATCH 0850/1178] Removed unused ignores

---
 Tests/test_file_png.py | 2 +-
 Tests/test_file_ppm.py | 2 +-
 Tests/test_psdraw.py   | 2 +-
 3 files changed, 3 insertions(+), 3 deletions(-)

diff --git a/Tests/test_file_png.py b/Tests/test_file_png.py
index e2913e9444f..4958b22228b 100644
--- a/Tests/test_file_png.py
+++ b/Tests/test_file_png.py
@@ -776,7 +776,7 @@ class MyStdOut:
 
         mystdout: MyStdOut | BytesIO = MyStdOut() if buffer else BytesIO()
 
-        sys.stdout = mystdout  # type: ignore[assignment]
+        sys.stdout = mystdout
 
         with Image.open(TEST_PNG_FILE) as im:
             im.save(sys.stdout, "PNG")
diff --git a/Tests/test_file_ppm.py b/Tests/test_file_ppm.py
index d6451ec18b5..0a61830a40a 100644
--- a/Tests/test_file_ppm.py
+++ b/Tests/test_file_ppm.py
@@ -373,7 +373,7 @@ class MyStdOut:
 
     mystdout: MyStdOut | BytesIO = MyStdOut() if buffer else BytesIO()
 
-    sys.stdout = mystdout  # type: ignore[assignment]
+    sys.stdout = mystdout
 
     with Image.open(TEST_FILE) as im:
         im.save(sys.stdout, "PPM")
diff --git a/Tests/test_psdraw.py b/Tests/test_psdraw.py
index 130ffa863a5..c3afa908937 100644
--- a/Tests/test_psdraw.py
+++ b/Tests/test_psdraw.py
@@ -59,7 +59,7 @@ class MyStdOut:
 
     mystdout: MyStdOut | BytesIO = MyStdOut() if buffer else BytesIO()
 
-    sys.stdout = mystdout  # type: ignore[assignment]
+    sys.stdout = mystdout
 
     ps = PSDraw.PSDraw()
     _create_document(ps)

From 38458a204cbbe1a83b458dd8d6be8762bc73ca99 Mon Sep 17 00:00:00 2001
From: Andrew Murray <radarhere@users.noreply.github.com>
Date: Sat, 20 Jul 2024 19:07:42 +1000
Subject: [PATCH 0851/1178] Corrected type hints

---
 Tests/test_file_mpo.py     | 2 ++
 src/PIL/JpegImagePlugin.py | 4 ++--
 src/PIL/PngImagePlugin.py  | 2 +-
 src/PIL/WebPImagePlugin.py | 2 +-
 4 files changed, 6 insertions(+), 4 deletions(-)

diff --git a/Tests/test_file_mpo.py b/Tests/test_file_mpo.py
index 5402fcb440d..e0f42a26649 100644
--- a/Tests/test_file_mpo.py
+++ b/Tests/test_file_mpo.py
@@ -85,7 +85,9 @@ def test_exif(test_file: str) -> None:
         im_reloaded = roundtrip(im_original, save_all=True, exif=im_original.getexif())
 
     for im in (im_original, im_reloaded):
+        assert isinstance(im, MpoImagePlugin.MpoImageFile)
         info = im._getexif()
+        assert info is not None
         assert info[272] == "Nintendo 3DS"
         assert info[296] == 2
         assert info[34665] == 188
diff --git a/src/PIL/JpegImagePlugin.py b/src/PIL/JpegImagePlugin.py
index af24faa5de2..d83d60b7b1b 100644
--- a/src/PIL/JpegImagePlugin.py
+++ b/src/PIL/JpegImagePlugin.py
@@ -468,7 +468,7 @@ def load_djpeg(self) -> None:
 
         self.tile = []
 
-    def _getexif(self) -> dict[str, Any] | None:
+    def _getexif(self) -> dict[int, Any] | None:
         return _getexif(self)
 
     def _read_dpi_from_exif(self) -> None:
@@ -504,7 +504,7 @@ def _getmp(self) -> dict[int, Any] | None:
         return _getmp(self)
 
 
-def _getexif(self: JpegImageFile) -> dict[str, Any] | None:
+def _getexif(self: JpegImageFile) -> dict[int, Any] | None:
     if "exif" not in self.info:
         return None
     return self.getexif()._get_merged_dict()
diff --git a/src/PIL/PngImagePlugin.py b/src/PIL/PngImagePlugin.py
index 247f908edaa..58db7777c39 100644
--- a/src/PIL/PngImagePlugin.py
+++ b/src/PIL/PngImagePlugin.py
@@ -1054,7 +1054,7 @@ def load_end(self) -> None:
                 self._prev_im.paste(updated, self.dispose_extent, mask)
                 self.im = self._prev_im
 
-    def _getexif(self) -> dict[str, Any] | None:
+    def _getexif(self) -> dict[int, Any] | None:
         if "exif" not in self.info:
             self.load()
         if "exif" not in self.info and "Raw profile type exif" not in self.info:
diff --git a/src/PIL/WebPImagePlugin.py b/src/PIL/WebPImagePlugin.py
index 011de9c6ac0..cec7963405b 100644
--- a/src/PIL/WebPImagePlugin.py
+++ b/src/PIL/WebPImagePlugin.py
@@ -96,7 +96,7 @@ def _open(self) -> None:
         # Initialize seek state
         self._reset(reset=False)
 
-    def _getexif(self) -> dict[str, Any] | None:
+    def _getexif(self) -> dict[int, Any] | None:
         if "exif" not in self.info:
             return None
         return self.getexif()._get_merged_dict()

From ddc02bb78c327a1025a772619dd3114752cbb68b Mon Sep 17 00:00:00 2001
From: "Jeffrey A. Clark (Alex)" <aclark@aclark.net>
Date: Sat, 20 Jul 2024 14:41:47 -0400
Subject: [PATCH 0852/1178] Update and add image to PostScript printing example

---
 docs/handbook/hopper_ps.png | Bin 0 -> 76966 bytes
 docs/handbook/tutorial.rst  |  65 ++++++++++++++++++++++++++++--------
 2 files changed, 51 insertions(+), 14 deletions(-)
 create mode 100644 docs/handbook/hopper_ps.png

diff --git a/docs/handbook/hopper_ps.png b/docs/handbook/hopper_ps.png
new file mode 100644
index 0000000000000000000000000000000000000000..fe44e79843f1f46eb2db109d96248670bb645eed
GIT binary patch
literal 76966
zcmdqJWn5HS^fyjQg9ri&k}BN-Lk^7y5+XG;NJ$Lc-5n|=4H8OsmvooJ(A`}_^FMm;
z{ax<wdGmkqyn6VY`OM+$SbMLv_u6Z%?>ZB#ASZ=``4kfY0Rcz)wfH*(1f)&`1ms@y
z2f&juvFD2j2#C6-Vqyx?Vq%mEHc%r|b3+6Kx@h|-@M|P%!p<huYz0hQQG6VpKz|rc
z;Y%v-R_h!Ek#=Y8r@1#E`HX(SnWqrQSD#q)DIcGJsW(29Pd}QQVp?tv7Qv4hDmKve
z;WyWf^>B|!v=daEjvgU|m>&jan@^lQ^b~OgsJzfcN&M&8%$UCac=D#D>Wmyt^l2y&
zV|ZJCyXKJ1-ixyVRxf~Cb-M;nYVlF#l%A&}{0zgTY!4d43B<5`C}sXM#7V<yc-g(h
zIZ}R#SDjhH?JXI%jHLH@H0bO8QK*(C{X~D!leQC)ysx9uQgj_rB2PJNzNwqM9x;ox
z+)aI&rS<tI9|^af0gl9%1%<%pyx4|nZML~T+n#5%S+~&<mTb@S?>NN>Ql^in!k<Ae
za6vPuqAs1JInS`Ayle-sr_W*eE0-VhMy(?QRlK}k4Cp-ay2CtI0C@^7UAv=gIC_tc
z(`vIA5}WJScLOX}F;tT_dixfE0k}s;KnyfRKmqO$fzMOm14!mm00J8D{RsGory>1Q
ziqx5g{Lejd@9&BtN@CK|z_*ftjiI5XtqIglD>*I`=xW^by_%icTUkB>s0EAO2dKUw
zi<5=b?<NQWPJF<vg`u4urIUrZr7fS6AoZUbe8Bzh$E?(pf2!D-2~w-QRiG4u+89!D
zv#_zSQ43*GQc?=od@$mBCocJSbKpNgY7;v<D?V0MM@L5%M@|-~jWH`bFE1}E8wV=~
z2QyHE+1A<8PS1(i(w640PX6gf+|bs*#?;Er6lzKNyI(zhsJ)#aHT7>o|MU0PI1Qal
z|D|MU`}eef39|k!VP$7wWBs4Lfu;h#pYkb~IvJX)i<?>i>;Y&9@$#?>{Hgzcl>AHa
zUQ4xqTk^2~r{%qp|J_pA*3d=_Y5|b66Z%&&f0Mmm_;*7A*55O~$BDn#{O2jaXCX`h
z*8h>25av^X)#nHZ!U)phBJZ6LcN#F9G*_L^?)tK|Dw+1L8uxc}(Q&ErG1M{ok-nLJ
zdYNweHE(w;Zxej;DO+b`TShw3Z8xsK6v@vozz+fADgu#|loa`adA*)S<*M>{;joF(
zE&PT&c{o~tCOrH@Wd2o!l(Fkz-Sq$y+<D+w2x@X&-MwiyRZqADsdk?^i?la7B)T2g
zdBU;E&RJ?lWLDFQ9XnA#ZGI51gA{q;T(dVpp?TJ~ynYP7a;`~czOcVIy*x#QU#(vl
zqQ(iVr4sb5@57HTJ6%|OPf?B^00rlrzA{bZV7#~%+nf59<(5-TXWy%vYY+977m?rZ
zgs7lTKCG8*rDU2hs?IHVfU9&=thx=B_6d$+MI40k_IPV6ZB}vi;I>!43B0`hztzCk
z+q3XC?V@GxJY#r}d_x=kYI1aeid;zOG`Tg|*IZlf_N~Sj{+l;$+4*b<JH-(ZeigJ!
z<I%6xIK~jI6D!{{v~wP8IU^S5Y4p&_R}qw&uQ1R|-0I?AtYEASR;J{IX<qpnu6(AA
z2T!{ca@g$R#YW4g=-!%d*YtE%fYl_0oP93J3fBKLdh-8VBabF*a^tO$+(j#rX{u1k
zOsB`{iuvfh@e<T>NXE|#_-Vd4VDh}tle6B56H}ZSAJ?}yR3T;0=rQVxH#6vnsMy+K
zU}RvZ92t4Hg2$WQx0R4oz4tM&inI4NW&Prb@0IVicII`&WsQ33);<S3v}w-s{M*Ly
z#3|}<&G@nV@Ud$vn5r6FUARxt`2FN&yGj1q5DpJ&^mO$Ys0G>IX>WBGFzQU~JHrKB
z?lzAn!1LgOf`ak6IZLTX@(N!xJXnfgT|wbqPz+%lL|R&1^7+;N>Z>0(;iUXE$HrV1
zhfbuJK^hW<HCj%K{&EOBTwEedRS;?snNnjxTujb8oWd;hAg_NfLQKTLkLJlL%ekBf
zxTM_JJ|O)(m4edj4kP1p<^ToU>@ZM7>pNLJ0kbovL_YgcE-o$&F)?3)wibeN79?uQ
ze=px?gjq(qsJuL>$+KPl-2!H)J#kkt8Gj(wx(2qMfbBRoDcB?F8L!Q+uZf9h2B~94
z_zw~Py}I6bX+N|p3F=(tcGw|Ve{ndj0af=C>W+>-&drSD;3$VkNF=;X<i;Udeu=T1
z52{c?5f}dFT9Bm_rm-?Gpef%cRQtrpj7zK!%@0<urb)2!-H%PRuO#Ro?0j>7wA5BF
z3DSfuO-#y<2b-Er^&m0yQLUO!*!5Aane_)c&t(JB8iVigDacFSYk7NQlh7?HFZ_W)
zwiS|fSSR&+(y_9f_?sO_$o;C#2{K+&aoPj~w6fwKDjg<<*=Wy6cx}G0<0gIjm-B!W
zuwNjNCGpt&dd;)>Y?(Ch^Y`ZumX*6c3VfME-O9UPlP1b5y}G)Zq)ddi!Q^ogZf$ig
z`ly6K;Q#853Mqw%g_~v8OMs7x_%U$}2r3rjTg&jTi~tVE5xPR+mp~s_2H4j>pZzLD
z|IaL&hp2|MkZHb<KDPNf_rEyChJxW|Lcb>)F9hkC3`}2b#wQVUDW7#ae(NL}T}g4h
zfF|}4VI%c+GnJZJwnFfr8To82F_HOE@FW`e95ImxnqnORhq`a4o~{@z%(*bA|1G`C
z=TUp*gi4Ra$Q<ccg$Cb0zz0bqWj>@{4Ph*_GQK+q1e3j6I{#``ShCm}2)jHbO#<DX
zciy#G)^28FcQ4F-G|Eu{mVz9q_tB9JuttA09CncA6yPAM9~SGi&Xm_Ql8|)OKCp#d
zTQ(m2#Ijgw3wD6dI^wMr=I%N_>>`Osk4RnxmC;0gj*&nSUr5G}2YWU$>b3^N?atrb
z%s-}IOJ4j1Q%7fet_UKN6uuG{nGGWPSm%S@+tafXKx)}Mni9?Z@fV%z8O+!>5bfr&
zZvMuSe?7_8e1EP%?%+_+rquNOU{OU!$Fnqt_{2FTCdOg6Vq$8g`}1sgTebD_&c<-&
z_}t#xM~Xw?s>^bpgyTvk)gxAI-9C}Yx0sfw^$7-m6MjrhP06j5BZAjubS@w5b+B4B
z?&YZnn%x~z+-=Ta0_tf|la+``Er{YQs;qR*d7X9E=Jwk8jK}l1%0y#I+jW<#ZX+W!
zzkt~?Pqj%Ge9<kR+<bitZ`#*)Xgca)taQ8JSdN?CE^4v_-)zbkWE&N2PgG238>nhK
zXZ0uXj-KsK8?)9IPg&OOa;r9Z-d0*@SS<eZA0HXfPrbWNbzELt?^Z@*#!0>CGu~MW
zRZU}#sdU&44N6w~Lch#Ee^JS-QQ2oPn9SeVczb#`Xj!w$%F$WzP7Q@_?OZ#7O%JKi
znAgu}<VK<K=4`sscreAsCNMpo|7xeq;%o<|^6uSI8@sUwpVfj_NkdWN<&Q+vt@i{h
zzZ?vg6(Eo;KlVt)S4WbudUC0rw-@Fxv{@k!D2rC@FJP&Fr%;JCbt%r9(RNZ?_vmxs
z*6G5@oW>CZ9p-rR#Hu>(70SxWu<W;qJKu9s7;+N_MD@mXb{F8p2}-R=DHvNLDXY~@
zeBW#?Bb(0;muI!MgYaqOY83{~k7jHKVF5U#a<yUJpu--<A}hyviJ+pJMtB1r(isk|
ze$&<L-7*Su4#zs)i1T`~Stv1UX_4D1ql&h+H|r1SLf-n%>v+UXxk4xDcvMhKqzhVZ
zi>dc;Z+#*1^>9>*;KRcWWAGKP>%Qy!c8@-lMwMk5z0ylkEwY~8-XvkXltGT|txEEV
z8{HIh`x&d&&V%Jkc1Lo5jBV_fkY^x<SdUJ(Z}g1fQF4p<#|^f(7wi03q!Z4`pa!}k
zQrfqC`}N03?dD@Yl&hUxkIQ+IVueGVRmNo894xl(btduzxjpY2MD*Ozaau%m-7ct-
zQ+LIx(1IaEJ!9_ZjCf`nw(;N$SnIg+_!N%wv}O~9{SH%UFe$}8IC@i@$?nZA)YB~W
z@>h=eYER7B%4d1puO3N10t$7S=G@mVgwoPi*1>l*S3Ac%+duLOZFop>elUxrlRu3m
zVupM$PPUH?f5Q24)DW_58s>7b8kfw{MMkplSS@1Fo~bDWvBPbty=h%=-`ck##pBWx
z-o6tj9Qsn?#XMcZ3vDGx)H%Avbfv}k(9n>^nUc%Sw$7c@bhUNntjCpw<RRFg!_GKn
z8IKpWEA<9utd;6{R(5C8$y$Fv9Ry=ZcL63lWe_Q7sdF_ov7@zL+oqCV-4$%mL|`_a
zUjlVoP6VB?tX#MnpC$^qKV|Aj8RVp(owM$IHc;EkDug+CcRhHwo{GyjjCGd0@0O#w
z_%#m~Vido@afo+!fcH>sJ)L>p>gs&m^QH(&0!2C(I}HS154$fK;eO1bL_cuvN@Vd6
zfzH*#+{e$qw7>_y1$`BAuO)bToxajPkr^rEGL;X#X0KWKB$MQSe%MLj_!C4D8)S*}
z`Q=-iRJ6tk`Ur=eN%n<&Kw33?ay*2PNmGS|a1;V42VK;~Yj-x<TOv)5i`BCsF}xaD
zOp4osz}*4<{c__J=Z<p?8tbH+ElXHw``P~dz9n0NZ<9QH-V>Zc=P~yqFE2S!;*7Hb
zE{=Y{A0y9x-tcD5O^2JC`=^!iUdoJOrxgN!s?C9<VcMs=XM;z{Al$u;!8ZmEO(>qJ
zn5yD2mL+Tmj5?^Dkbg8Ondg25Swgwt)yFT3OwswE${Ie^$Ic>NW&w^b4b<K&o^PDA
z3?@ikVSQS<_Be|OTs8S<`59*D?tbx-y)~m}<5>RkiNukv9U3G{+hsG$GR{wDq+C-`
z^DO2ZxeJe-!i?w>Xw85gQeoPVWgm}Ey78{1+-!nH&3t>N)-!2|mo6gJ-64j6+U|QA
zC_5$@Z0?bfhtiJdxpMu=bmRk^YMGna^zKA{{sfQL%yvk0kn~d{Q*F)G!m?vFmzhdk
z-OO0t1gO{H`N&wKY&(P=gj9c6e|xz-YaEtgvObX9SrILdZQ{Nf$|H7*Gu(;?cGH~m
zo@>dW%}*^P@H}s&n8AB9$ai7zlk|g7$~PH&=u@+gA1~b^;Y{n|m9`b3JiE91{hKDL
zQ1=DLN8l?#0%+Lz)BIo_$@<{T{c><~6!MYK<#1#zX_oo^VawD6fd!AJ>m>*7Q5EO;
zRX5zi!lK}6HeFe1GnpU_$`g)#jhi+7flU$la4o{wr2PD}$Wu@^0DVv{Y@hDhHl(<S
zN2)meqA)U8atCd>b8^P3>BXRyrlxtQ6!A1#K+Lqx9@qqJu{BQqDJPRTxVoloEh119
z_gnjCnvMyyfru%cxp5;jQc#`rJiYqkl3G^mstD;6y0bx()BvemrwVN~eHxGV&}f5;
zia~HwQ|$H7yR_kub{-s01-TRJT-F0M6{;+jJe7%lGzwJC!_Xwh&~nRRe{a*ll&4iE
zcT75sGlJyVr!kvD>0+}&OudWHKD-3aB<GK2aQ^hxI{C{`U}Ha1QBlE6{fX)n23aT1
z;-DbdJ|l2X*3g(vlIWiAG%Vyh&yuE49(UhwfG@HSiwcCqvEi07uGm8+=yp7g6X!vQ
zn^iIU-K5a^;o17(%Qf0sdbR?!lAjLybIJG=w};-^Bc1Uo#E{#Kh%bzXoSlOh)2=YX
zI9^6<_b4=m)sMupOisu@6Lm39lx7Q4Zn74=#!pHNI*mFUtinXu4%dA5&}C1&zi~y^
zyGK*>X_#!kDpgQ8kY28}-{$Dg3`K9soJ^G>cYa>xnVWymjZnm&`r{<#oc~Sgaawu^
z&%5iH<lxQ0+nvEM`Ly#Vrvze=M~?A@FK?31U8N6u2j9!<?Mz54lQcON)$Q?Vlzx!b
z?hv_~Ay9WYgUH8$#(vFH*g(R{FqU;`=)c~vwjGDNniV`Nfx60+lNb|pwAj*pz1#24
za#+UG$Zuc`Wo7Ds`B@hWgsd6pkXh0+VKEx%tfI>AtlNheU`lG!2p#b&jn>+;!g9bj
zrhWpXxWvH}b+<<)-0qP&Zif<%pBLaafYRmj6aGAW+0ypVw53gojc};Em~*(vvNIyN
z_&IoAyd^76d+Pzy@K@Qp4-kKq0v8rFKaCunP4L}u)eIjR?85i5nnv~6_0d9Lvi>Gd
z(**_Xi5B9e(g6zHbHLW|68U0Qhhe~-1ok7N{5fbaDBjX-CO7e*R?lws`m_&rH$9sD
zwhVBZrlM)2F7x9=yQ)Zz`3))CtqUC#No<SX9t7OHugqJ2oTl*@m7|>|6`f7-98i-p
zH}kL8vg**GKD?7vQJ<mD<{I5yc|t+qdcZ+kQP||hw*;??x*D0cScdZyw6x@e)@;Rd
znZ+LR_<9rxF+#$8$5%AhaXW7EREs3ZZt-egzq}>*%w?us9_hYguvgYX+jNsa=g?hR
zRHE1z+Pl;qiY7~DjNKmf4O#!)byso7GQfP@0dL`3D?|TT<@xwsE2DX-0cO4d{Ulxz
zwFFKfa|$6^BgcYG!C!BVC0=x@hatCrP$3}5?5JNI{Mo+r>O~{(#d0TMxyhNME!~?0
zmw?soiaYUb__W;OLMU3qweb@BT-NO}_?A`N^8B5VA6xr|=govCuM7^eoCk2);#j5;
zHszjs>(8v{E@g_%1;11KJP&V#L-)kqno%-)h4J?xzL6#5yt^!_s-*zON+GV$dg$Iz
z^u)&Q?R#t5UoR0?@#-kY%40pJy@}_67P{IIN4gG+xe?ut6v_9F%6Q#gyFraeo!Uhp
zU_g!8)KVWjh!C<>%9iEL;wd2%Cj97;p<JDlhz}ku|2X<MG!<h$ZV+rt8Cx^eeq-mI
z;gtR2>U~w7vCd|;q&H#tkF!28>m4v`i5-&QtW6ba;1M}27!>AOdo`rbr}tC*YOKhE
zEA2K>ke6tLdp_`bH*H~;@h}*B_V#?bWgqe7Wn0Sk;3kXu;F~TfA$`YL`#4v;L;f{*
z(_O=`YI5uefqTd-DPt}5$Zl^F;x03*mc+&Lz<H|1hz;huU~;TVJ>j-PE~|tt9(Je>
z;H#`&@O*Z@denJ%{N~6ag?)dMu+!~YjJ=cR=Wf+}iesJptL1*4`5n2%z!u`=@|oN2
z)azi^lMa)I`_G3x&jG(@N2QIY@i5$S`nq&USHJ^<-OyE578fu_z@Tk{3HOO;T@lCm
z8x2~kbHt<e0?#Cxh>Hx=Afi0oXB0OZrykr@->lYz=H7BZ*;aq}`oO2>ZzHhgiNZT-
zWA;<;;GTC}p31#Q)WR(tEnfwTxDsD4%5Jl}yYlLOGtQWQ=}+4Wijj9Z_rQYaUC^|O
zd=Q~<yL^4=ac#~+V|h+goN}{Kw41V<ar$XD<8cHT{gg?&(Ae%43|zW>@obn=e$ZkK
zk7M8Y+74P~LC9{t?hc=wcq@JoOw>9$3>_tQ$@$S>r>C2E&U;8OABr8<1>g8CCqng0
zWA<WgyCAH^A&h6Fo~6EJ$<;qqX^zrH6IqM&ylz@&-Zr0h-pZn{bAFkCcfAc3I75Gt
zH$af9N502*^w##ciyw+~&2S`Zt0%a}SRvojRDafu?2}vc(kS8z*^`6+fr<aEP}uTo
zc3JPfHv2{l=biW2X}bN&P;NwmzUhfbFooFqXP2wRoq`Cb`e$I225?JPj>jsmJ<0~h
zB3Kf8{0+O5BbFR`3kAmAF@9ew97(Ell-izw0F|~NzL6yRMQo9IFqpy4bb%n;yVB*%
zJZ`_~b%!}Jv+!-?_IGntZWiMyp@_URt_Y#hmVLSoRbwa70IOph%AC@DHzs+J+h%0E
zYKKGHb`cdf@a+<D6Da1bqL%Z+g;6#S6?gAGTDj|)5vgSP?sK6G_Qm9Ef{VG8&*pPZ
z@Y5^LQj4Fe&mYaYjgD7+5`aOD1d3XZy#_cP=V3==^AnCD$-JUk24zP=IbcqXY*w`Q
zLuhn~O$MH05@2e+dL`^Kmd5G<_nTb<I}VHNreQ$Q$`71UPh8Ajj)Ut2%Fl7%^F6l5
zem|{jxsPIEjRmQ=o*^Vj;)^{DbI0GJz+!Q>gm(HmUzsJRVnJ5U{etx~tJ?PQI`Fez
zgvHKy%L03rLMdb^ZS3fMr5WXwCY|B&(_{WbBK?R4-K8sEs%dh!gO(&7dE{9S$zI)W
zlpUY4J;8A^LZe2MWF`?grEay63SpPX@6>sk&@OI7ns#qr*C*smW1dPvgXas}D9}0)
zPGavqMA&x^4>g~YK?Ayz73q(pv3JK+r|MZZso$N%M0P%zDkysY{<FAv$n_o;$<(gh
zONj0Uu>`S?x5vp!s4gTb0aJpcjJe)y*DUtOf{A_#=flnSzt|t{swB7*q@gZ<fC`)5
ztRM_&s!TVUfosUf-ghE0GpZKarQ+XOeIPh5M>q`h9~Z0j!nWfF?6;qwcsctzAA5ME
zoJdr-0d$@4Cp%;uH2KM+!%is^AuDmJW<6y);{^NLVp`Gd=#~>;mGCK^2Ftts#Gzhw
z@KmF?`k~P&AAx|%7XE<j+d6G+yfp$x=fR285~ai3P)T9R?P1H&rdb~x{ynHr6xrwa
z$$@Nli&1@<eFwWyb*0;*<Fgo&&iKWtBk8_rRedsp0JC0NKo!ZJlq|;ee1AjObxVVF
z$;uGitU%RFVS3p%BHEHTOdw5$(ka3Oo8gfAmPF7mgWvhx>q%K`B;SpQB;n-_@^qU*
z6k&(kj2ynar)%SpJu}}hH@jzgCF6V}n;qdzFPg>@2w!M3jh`g$WP5EvR}Rt!@7R>P
z4!b#uYZ934SGaM0m`1Yd_`p5l!u@BP_a50$cQ>dsyrC;|a=G-J>g6Wh;J$VM1m}|S
zIC!$1SSRU;-+t9<wa=wRC&DG!9j;0vo_^Z1OvRJf%1YWW=c_kO8i~btDbF}1GdGwm
z3f?{erVVP5BF#`>dny5?uVh_(`(Q*PoAV%E{P2mB;#igt#?WIg75qk@L+%Uzw`ODo
zL~bWM7GHU+ST_c{53~vWkar8C3JBb4PXH?f%;LeGSvyqp1<X?JR@y+=Rlm3zWUE7B
ztAK+xaWLck#(%2N?NX*!aj;A9BFVA#*ouQjdq2^#w!3Cp;kCfoqyaL~<(3^>^%M^q
zv4eiy@oA^(Ig3JlcXlKQ+HrN&P0*@$WR!vgb4*?s)vpa>M|wCvdM#%_NF;=_2%l}9
zopDX~Pv+Y>D%+qK3e&hYlsy>M$X~8vQww&!46*JbVz)eugPQGfjUQ@UDY3|>vPY;>
z_T*jaxfhj07`XCBp((M@6urB9xIoNf{Ba2{G9T@x^?lX}1tO*fM2w^;Uf%55JDspy
zRm)!4=o5OOlGV9rynX@^5w7lGYVC<m-VtLkGAghDs8eoT$yVAr)2~I+Por-1O+?Ap
zjiaa&@NrBKpT73i%-!vY+*;_7$Sb*<%SuZR#bI8!Zd88c?S?Vb?oAzINpS0koEm0L
zHUhY>TR#g|HO7NimPc_OP^N7YcS6`dP&dhMVzzBO(KL=i@Swo^BHZCyA-gqe_qE$$
zi81M7uj4DEj(k)~2aECOWT1tb|1fvmJHV*!3MD6Ut<RC?wu$IZaj2EWsFbV9N^;=4
zv*zAs4sZ-PivEOs$s4m|E*;H}7U&b>>;tybLE|qAK3F8ifCH;5a}-HNF~{P3U366a
zZ{1`?uvB%{v42^6RG%C4;c4g~2R`_L!=Q?CNiCdOCGT<cnWcla{Us^~s&=750AXVJ
z&!b_=rWtw1jE8HCs`|gsAs%#5Pt<)=r8`&+uh2Lif2?~@I+#;yE}2$+I<6saU*TIS
zG{-j7PM7)x+UVBv6x(?tRZizX_u6i6c|pMQ^3Zz=jaGG&nU9DWhD;w-w@1S%)Opb$
zEl2noiR<P^V@reF$&C300ea+l9`V#H<MbiH9NMAAtzD>V@<9!<8`6AyQhGR2oG47b
z9QOd<7aZ*0)U^JI!UPD3nAoRzp1X`ETO{7-qElcR2%YuEg0P;U?O1)`+JD50?nNPa
zX87U(*)U&c8-I6Bs>hVNIOu6&q*s^U74PLm1pl7ZMSQCL;V?Ec-Stp%F6(#3*Pa2`
zh;#Mq+)Ou)7bY%1ENM@0^4Pr<&gsc^o)Hs4G$~q*vAZpLc;$tZkSZZWoh59f!wVbO
zl+DT0qBZbK8>T)_cH^r--CkQ>UwAIrV&Gm-2EP3q)p(SG(Ro4Wzo#VYu0GCt9=0!k
zCq0rdbT@a|?2O=&eYFovt8lcmf18M~i_GkBnc}W`e(F&@{+3<dkU^YB=CnNOVaaZc
zs`jRb+Y`D5;|yOHXfTCSV>GC=?4i&vGO9uGz+27W%$tj@mC9*LTWh|H^RJP<o5$S-
z*9uYXo#0z*T0fYSP1=jFi~yyUOM;+-5_U0SMU(@}lbe0dCW7IHe!rMJttoIh`oV+W
z0TjDJ!myd2ioaaXb~@I-57#gZ8F~{LG_pD$pS2OlS0gI;`akmAfJs5Zcw3_GHcsrS
z?(E7#efOMvTNAh4P@wkq6^9bUUqxl=VT<sU?&oL8oWc*#M3ZHCeOJjmj4rO4P1AjS
z=rpb_uB2OgbgM7=$8R|;DC}|EBY1svJnKp>c;38klOuzlu7O4ua06}+&_cmOV$9ZC
z+PKu|`}oX1?K;yC^w7EHT1NGybl!yMVwwsSp8E3)uHvB(xW}IRcIuwH4U2XJlRb|J
zoZ{bFx$GUJxLLYLN#u7dbfso@zr?0Z11b2?-0?<BQVGQHCXl}i8lkNK7qHNdMx?AK
zZ8;1Fev(8N((5tu+kgp$NCk|OZFKeuZuc8s0U<6uA=no*6q6SeZ(@%)cQb5@cRT@O
z6z*E(15t}z_UOz*n#b^7ST-vh<?B3vlw)%Gc!6zV?X56nLJYyE6VBuW{@4WVea+#P
z_R1TBPhJayGmIA`aO_NTpHd;Amjgh@kaTkuneC_gIfG1$1oR|*B(m>sdf6y6Y|9zk
zi+B?s`7_fZE~b5ck2$dZ`Xu=SN?0#TU0=A>Dh&siJ>_LP=P{=PCk1KB4vkckEVINP
ze5n>4yTi&+t6<_Qx*e@m(kf_BBym<|I2Iin0kKwe#-^89uFpo8oSC1nlI$Ct*z=H>
z<;+A$sVpy{Q7Vj1*bxKM^b(N+1&6>Lqo#lOoar+@+D2mj^M64ZL5vSfouHvjm0`}%
zN(o(EbheKuIyH}4+Xc=Sd@b#Y_w_|oF)xX&zkrNAjtBr*hvFdzDbaCu(4x&>1bg%(
zef_iqa!T>kl=&A;+mNFq=qb3ev<PnAq->7PskiOrVyMn(UZoL)#JX>@p-EYLy=5z@
zPgzHeG}HPAMiWNy(IzY<+rCj?L$P^VKBR&CBruls5)+6-pEyKB{EHL`M<JM-CagSI
zK^?PM3sMo+eTW~$MlMb)^Y-yyke)Zv%Y`;;1!iI^jj>n%4hsPMNZ62GQ8Ip+_F7bK
zxev(s1`DHy$7r<c*6M$}k9{?J;diM;tg5i<hA9`{!^DKW3DD(`sH;Mdn$$j~+$(5q
ze$<7%6S%3i<fN;fXLpadHxlj8;~Hk>)Mcb5mH)Q!B3Mumc%J*gm^XH?q*KiEFVX)6
zFb1$82I<!*V=rzO6^7o!`Rr(cDO&ky!&|2w-2*ZodUGZU8wr!wJ~33SGKZOy@-(^`
z!66L<|Ea@-LLJRwj7b|oE1zP1dU~o}`Z4a_B)rg*U?{o%Jm!-Ne6Sav2X}<>9Pe|B
zdWaS=cv%Ra-uGUkW(CTq1R)nXI~8}r{}7u)XPYWv>TJLtVZYA~Dhc5wr`KAR_A37_
z0P!>)BsnrPgSyjL_0E3*R$wPA$O0lQd5OsTnYHBd<-g09ItmXFr>i&c)6sog8T$#+
z5idDM9OT*GE8@?9HbT7;sfvnZX>Bxbduc^wobU5lF1A^?`ax<rC>C7^)|-2LpZcY*
zFpHo|X-0x|guEKr`bTk3I|al0^n#lCUo32oea7#04mD6&QazC)%|E{1ySQ!|hC<yt
z%G99O17^b73^AYB$T#wGj_%jFOh!QEs4y1_PM^6fC%f{un5kw@<%p5G#~xu6%#h|%
zLjZlj4ZNzvf-^+;S`rd=w+7;|=0^Nr|F4Wly#oRQ`t;`esmo}3-^g9`eRj9rVJ%B4
z()v$5g&`C-X3}3(HBXb2$*xdW_@uAyj|$-Y^C)F9G=7G3vTy13_a)dOm&W5hodYsj
zcV*NqZdLqGy8&~gU!@mYu;n)EM%ok@`WXNHrkn}FEd8!YAfeAxxzPU%Cn^*nCo&c^
zAR+ai?gGfXEtf!X&dyzmih=jX7w{Y?aC-enA?JTRO$k`6&yFPj^zD}^{zLD2j9<Tg
zO-6cNFI!#!@o_UomHgt((HzHViW!j8L7L!kALrRtUXhUl@#Dv^(+M3Yr%@kUA>-dl
zr}_KKq3x65oLcrD@+jiE2lybnji?*IN!}Pg=w)r1F&apM<$;78cH#vA#Lxk7ri=!d
zSy`*FSgM<|WfQ2alhQLD|CztHl7tuX(enuT#};EWNXB&DXJ-zXr=a)<GG6_ed5t&E
zAE~ISPVCNvgkYMPnf3A$8A4aL<Nw}fNpy&{$}6k3GouvC;*9S+?r{_mAEbpMC*HgE
zB0^qO>V46@jS1}LH%N~<b3RpW-PaU!CcqwH+33ye04Di?rn%GLwiir}>EGvhaaGD(
zCJ0$}mi0(z5m>aEj7cnD^3-8#YGPG0Vu(3%G@ja^7$n;;e4$Zy-FT)fr(<#4Ys9;g
z_a`9$+a4e$cJnOlHnf?NMmYUqEfG5PSzgE#2M1?-YHAB*9e^<{E{;|m7X69WcJR><
zIchs9Ev7k~LFiG@Tmg6#mag!<iVCxdsg7_`tw!n3FJS<BX}q55*@#2R&14(VB&yfV
zZ4LlbONZ6dTJPTJ6VS@p6=i3?RGkZDZQOW34zO_g(+e3*=diA5`6Yz*-RY`nC3(Ts
zEq(WVgQ;@U!laAibvOk3s@$LxH!g4~?q-1(0J<v@EtU_}%Zy-ed1il^sq@kORx@JW
zUTud8)jeC8=t+nuK=R0MqppO1uewzm04DiePI6y-mOd^h4GWb$bRJhXhQ&3WywIpL
zPmsu*ZCcve-rg<gBrn@{Tjzg54FIr}O;>eIoB^>0uWQHhR7tlpqF7j100XeDA7h2p
zZ4t}zNm$d&@bIGF<^1jLJRf_%D7_1`{!o&3<jLK|?bUu&M~5VFgYPaqBV(EK@fr+=
zXJ$d4&z4^!W71<YD~`iLe;TIKNM{4%##}Kgtm%m1vfuh;-abhaDWE@pv*$R=UU`#b
zJ5ZtlZ5T^&TEb901CVD;zlX5^@b);}0mvi)(n8o=?Cw@c-XyE)0DI~I4x${1sG`i_
z8*eutksyC@?l%?>SeYfs{EkzqjYp5`c1n9|)!pcg=zjo5&ZkX&=I?}2z@P&JuMb-H
zoYr*LF}E{yZvhv4r{^Sc)MjR6WQnOLKQVYIW_+@0&ZXA_h}H9(m8Z_@l!6JD%UzW0
z;If1rkwTZbH#^4QGC=Zkr&Y$}mJ}eX=HIxWw$9C#YBJk?0_&s>B&jo;)VQeO>?^@d
z80Xu?0rAlCzt*8MQhHR|VU#BUx)(Yj2r*=k%WQm7-t$t)cx;#1gTtS`ol=5gLMr^J
zp>e8vWlU`B+Rh8+(x$tc{p4xn!Twm1$OKC=yEqa~qcCPjIh_V~Rpf5gX@dS|797|k
ze{L<FNft=7YM~~Kne^%^Pv?eV`OWaIu5PPi&4M_C9acJO5>hn}_yeZP+=n6eHsTI%
z>WV+fFk&fQOr2u4%#;Y!Lw6_}G_Dg`j=YGmd3F#%(}G<_cD!~*R09Q)Q3>6nm2SyY
zJxooA0ljR(#>bM6V+@Yu?$Mh{NsMFT<5Sbnrrn<GJS67slg?G~myHzcgISaA*N2_S
z@vA43eV>_!sr$|p5TvN_Rmpq5ohHQU&*S)QC-EhY8(vD6S-!+P3?z5SO=QcS%!<k`
zV(b03k-h)Q`QWA3wBx*cRoO?|fR?mvsp9ZHnZ5GHGV&LHDX={h4$hU~PicQ_$QubS
zA8v}pX;pW^96QD|8GqLI^n|ps@e2<!t<%VE!ZsnocbbiE@CUJPJ#`?4yu|~=se;=l
zvlttUvS33@owclO)EgUm2X_$}$MDnb34ZoBp7ZA2#2Y|PM5W#4JD%58D_zlN+$bQ_
zt3s_h4)=87th<x(0u756AJl=kcow`JGzlhx_5&b^W%oCZ@1A~OIQ<)vH+Ii{nB(~h
z^=RJ%&abM&Vl7+s2)EII^rB(VA)JK$Cx$zuJ?8fzubWGdM(q&0JV)MwWB+=q2|cKJ
zlcw49J3Wy*9K}O**kZwe;wpX?u(UfwOvqLwu^0-{f9J34{LUXJ%Pt)YdsCv<`hfPG
zYbdTr^m#g-dzTQrW)Sw%A8Yo45T<i?Igxytu!lzYIX_S|mIc42jeQ$98+agAn`^?>
z1L87AK%C!weY@8|(Q5RQ3>KTjc@nQ}QhOW^GU1}fkNo^{M<9{o%$MT2S-tya-wZN(
zw>y8^k72o%wQx$~RD5f$2b)Bj&k!`|z^?lZ%5#0as44i%!jD=%8Af{XTaD%TA~5HQ
zV7)5HEl09Fc+&ozBHSnT9mJIW>m~u2EMaGz<38>lpXJR_FKgBBQ&NuPm~uP)MT~xI
z2G@qD2v698SK~5fD=x$v+IX=R#%4s0set>aekp_zz_ZC`83B>3`*EOhw*DHHXp=Wb
zyON0B!7?DPI~kElu0DM-<kIIb%<;?)eAtV@V(NT%R@G!Ne>Df+f!?k`cS3cpGqjvn
zV_KLX#DJydO(jDq@WHh(0<d?n=@2n%8nxZIykZUJ8@!x1b!6d45Ept~-(aMK@j-xf
zH!ZVrOe3DvRc#`!qdD^XvHr2DxHg$q+1mlBCKA~dRaN4P9(y(G<Z=E;3F*I#22+xG
zB^7(oNeMduogK;*=aJ$1U|K2<dLZG5-tjVfz9Q8rN#$&=jlBq?V6XgXndjfBd$SlO
z!rG4Hzs>CpG$g=)u%eD#Vph$dtlw|EN|LuO6bK_1NrixiePr0<`whLE=~6a1$z;m~
zMrmuR#NpVIm0htUZ>dQ_<B_*7OU0FB*F*Sad*PEM2As<5OKm{z(;ibN_T4zA4+`^G
zSjEh-kr%3!aO(bYpGAm4Ks1dfE>d3%s6-mtX`7sL^V?`*BSe2qhUcG`FBH;D|8hZt
zpS5-)BZ+I&-D?k};RVFacPSou^*RU#Hjo*LxQ+V~V#NE9SykVe>>yUg3QpE1g$0GK
zvV)l?8|%adUFd)M5@}#UDx-sCEYS!G)_)^oK6M=1cHJBF*}PWK7CX$tcYG5F?Q;X8
ze=K<tOccOV|Ea7(A+bP6kT&$Kf{PBxmD^jWye5O;+?ig~SM<y32p83c>-PHUr>in`
zHD70!!qKTDnJx}ii4QD`Gi6Mcw#}4)yIC;bFg9^45TfNNtUqW#Tj!qP&Ifa``{P+*
zO9BRk@8OT{{lAZ69|Vb4P->eRw-di+Qe;Sryto^jNo@KLJHBA}4LJudr(feL%uA#-
zV^}R=L3nRSI?JhT*)&<I5CbH)H;sl=iFp?y_b_T6^%~S%yzG$Jv+%*WM8CS(%#(%W
z^Llq13mqpkmewwpCvm=eP_X#7^l1T~cKy6fe(cE~QU@p`vHhtlz7>k^Z4MxVL4+PM
zbONrpv6*I4R>H}t6FMAVG}!Pw4@qf1c%Yl#XDPv_fyWU)R)Pl|x4d^vyM@i7#q@{i
zYF0(u&sar}PvOgYjD>}UL65UC_35=L#lO61?^~KQ1<RYxcP{`N?SvDt<9zoC%-cGY
z-p3VJbD6uKGU?Uxc#;PFnQH46t<C}^N@Fazqzo60D2iB~HQ&b$p*?2BYmPaqL2;~C
z#<^GnOHw8M#ZbFo-5R^}gIQ`daKTVbhQ$F1?F&6OgS&QjTK&yEn54yTKeJhZmeN|_
z*E}Mi5eeB4C6&=JH3s%N)EDTyYWA=`ux#Eoqmv}*vBYo03ip~rH(|!96+nWlJ?XWS
zw>19Mt87zT$-Xpu9@Tj6CR|MA%F#&C#r+(F^|qHSPYz79*7DtMg+(Q6b)R`;kajOe
zf;}|V%QL_yLt<yEte&v`ole+I<AFbG^=7W`;_S6e`CmR|SEN^)wMWty8Nefa^-!(!
zL$|dGq?YmeROhaOAfd4i*?;MerE|T;6M4+LCTrua?n2>lu2%=2bFB+j3EB0$i1TC*
zc!vdy&9I8qT6Q8*2QW;|0JZ0sc?M(*Otn)PQCy3sehe`HQ+H%Ygx0F}ZjQHn&r~-m
zenxnbzdS5OQL&!lI?$j}q`mv{K{^*i`j3OQu!3$PJlAbKst&A=94|oI66?5?5PV6R
z@d@^*E<f^EB1kPZ?2YARWSphuhR(Uo2!m2&O1gvafSsDMU%iZLY=34zX#45WI6?VO
zj)0@1)!tbqNB5X2j~f@B7hK!xex!EcX@>luI`V=J!o8$gm}8b&jZN0?RM&xIUwegz
z$MxHVbpvnnMa?b&ds;Kh1d`^y&5O3^z9B|oGirQgcsefm?5{vTmz?kth@W^DaF6K_
zknFh9nzIs-+&$f8*mI<^C%@UpiAKdvrg6o-%~7l0%uY-?KPf1!sTG%D99%bdIl)+4
z09nGr7+Oq|cuOz}8X8{U?ieJOU%taGqhJax(*1^W`QG!umtu!oH|lecrgi&cIfSx7
z!loTo=1KUBZ6xW6REr$gWZuGeb(HvP;o~smzt1bHBS53brz8&m(gvZTkd!P<nHAYD
z9h^-=2hl&MJR_r9=kd?@61&uNnb%bM+w+nPBUz;Asadh>38NOlV)i$w6rTvh12UXC
z>fK*JQUOy$S6=Y+m$fDNZH<6OKi9-0n$Q8FXPgEH1Qo7yJt_rDMew8MolX-;X%h+M
znX&RM`)C|mJzRif@t1>t@<w>6T2<h;GhkJVF~q<JofEjaUI*`M(rp;jSub~3-d1^#
znlfwGJC)ditAXU-aFt0nP3*$jEe6{1{n~Ao=|=ZD9Ze%?Rm@n&(=k;zZ*?T?aEy;n
zV|seahW0Qguxt8*m*m~Ilq7kAQ%nJ)&*A2Df*<P)K(5!tUFCa0gXssxo|~~EahUBq
zd(!XzC_5{ClvfyC!H4fGfdi8X#iXKsHCChcS-NhfVR=>Cd3*WJNaTdPoobrZj_J*}
z>DG}fnQ%*V!k+T3kr5dg2IdBVNYUtMdX;>&=n@k6s@&oPzw4R#x<|`-JCKOzQ#Lg+
z5l3WF%UGODn3fMt6@N)MlAo%dviI2TyDr!S!+3)m)8<lk{Z0A%GLMjT`|WYwUfzOk
zyIx9)qeLKsS<9yT#lV>Fs*w!gnP5?*xE=SqDcawL2sxs9#Hkz*igS`ep)<Mzl0cUI
zdeb(pPjbM!+80T(SR4|x1qFmZ!f5)4#cCCI6vf|>DZNUO%}C4PN6~t^;VR4C`_L-M
zI%09f1@o+NYk@cQdWCjZaNjvHG+*S-WDdPJ+}unEDdu8>=WWvmO!LanjAZIWd`_eO
zuVc(R8kO9NlgC+qn@1Et80#8D55&HNy&o><@<OEDvCKWWLw#W;C98ShM_POvQ!NwS
zFXsq{7zT(7n*Tlvkfppvr5Fben-7({f1d{bT)ts|uSi*^`?2tz``z69aKTF;c-dPo
z@7?_n#e*k^Kv=I7D|_vJ`aU)jz#p{OqBp+{p?@wCaTLM={fAmiT*`k^#20pK!^m1D
zn_FIe{FS?4G`Ag=)I#^@w}bpl$PHvmE|yRKSKtC$?)TAoT>E_t7$dESSNhZd-!{|L
zmTJ?~uDKkN4M(uvI4E&;T?o#LHK5DmetGhlUT*!bg-?h8FbAm`{i6?X7<{K{PB;N!
zpy}L1gOJG!29j{(|5kf_l$5E<oXdPai2sKTz|H;_VZH(d%l$9u1NSEa5<}Nz3TEmw
z?y7jtb3ej1#|sd198h?1KdJ`!+kmT)wWyQ+m$?36vsi+#QGh_l*8BV6jECOoa>AC6
z{|Y?Zi<5o;OeA9k6Ck(#Pdxo^i$4lPzO|2Vs&nrtr5K<ReMK4XPeUyExAX6bmV0;q
z=@WpdPY5CS|A^;zT)78@!#X061LgEyI2)k#8Za8vK>w2dGlsqum2^k%drQO%-R@Bo
zXk0_&-f)Cb_%L3RZ5RAA>Awb$4Cu#GmH$~7zi+&M%h-kSKI4Lff%vRJ!{h(ZP5bQC
zRx*cqe<IWfNMBLJp~(NPG@wKDhf%8_1hKsP6~z((J`6S9ZZ+H+H9+JoML`v?Jnpd@
z1-;9L%qv~_UYFkKGQ!A50ecmygZJ0J%fl!Q2|UWF`@v$8DU=lz_VS`87uJ7w74<_(
zO6&il&$mGI*hI(kRQn#!D1`wL{{I=empo;1Wp2}7ZzI(!Avw-n1U=(dF<!K4`xzbN
zFG??yGhILvQ(XL5gNd(Cbdy>}pFbu<gD$B9OYsFhKW(zyqCi=c@{&N=`&#6Ssgfq-
zKqV6h`jw(3Xf5{qRy5(6QMU@Ix|Zefx?EK-f#meCn5%{Cx9$jg@%+s49$a#Z%4hs%
z(<Kjn5!090aac+Ow{jN>SoX&CmoZ=APM;w&kEbw|u#Xv-pZ)sIZMyWFF^{e+BSS?d
z=To7@v)rbVtl3KQX#<VQakcz!Jq!VnC1<!N`0lR*M>aTVK9pve7}I_H{#^UJ{`Tui
zHAQTTx1EQgU>F{`l(zZeV;fd9YH=0%&~KSUaxvAV?-o^5S)MK#V(=;yX1~&_Iey}W
zzT5oM3^jIAxGZXhLPn2f<;Yg&mfjXOL^?;E4-$r|qjw@0c4iek#m@-WSQy*+y35s)
z9hO&YX#3;1NR#)slo#GVY9>x>JN%APSS!AOO>4Cc_b}C{vZzqYC($n^>7hsTp4L5d
zDwFuxT9EO9p$+2SKAp%M{iEvjbHia1Y#02cht!~_zWK6|{#~!ow^YoaP@CTJ7gV)B
z&vj6|wY-ntFk>h_m8lXHCNGmXemQwn)YxStOKQk9tzDUy^L!VU+-dIV6lU?=w7g=w
z5_XIHjEMewrIl1>3{T@n#%yj_E~{JLo-+`<@@&P=i&TZpbldJ^ya=^eymsc+@1rAS
z-$`SR=b2^*P*&q0tGF~MsMNd3bC`gp7T0FyhCc;QPvs6$@qHe*lz8#5{7d#`ar@7#
z4OI+r$M0D`ndxXk9F)#%)N#|bu^*%q@4Xhe%{ixxT&lnssqN3G4i1_^|AJ=ytk9N$
zGyM8X8sS6=ACB0UOj);toWn?|WIjo0ITA7V<=a-#e6+w%^-uJ)e<;U(87`iytxA<}
zdNWSke*0;?7`i9ffniZbVu`L_611)1hx9~UvnC(yLS5z2t}wARrFmQ`kH``U-4{R)
zV8#K4^P)Csg)GVgD#ZDW*JG%9C=y@%*kl$T<Gv`7)rInlYm(^)Zxh;GKlPd9g!qYd
z&95bgx@{`(kEaVohjwEKtJ%<JB)p>o6Vdyug}@RMt6*EiDdkIcz6E4;%_+`C$%0j!
zmZ!Uh#WS&sGYm40U(^VZm>>NpK6)4QOQEKsDppO(&F{rj!1Odf=}z-m&Q3}lMb%OW
zW?tc>;oa5rJOFIOiVk%$&rIoY=1EP>L_a?3+h&EeOjRj5{`yobDV0H=N5)IGBxr6?
zP!PNEI>S>@CN1@aax2p;Ux#Rn5|bteOjIH!Hsp(lLZ)mIu_#PJ*UJ?(iJ-L~(ego%
zU%sxpBNM$1Rft%<wATltqvz&1y4l)$gcS<k-d79si%GSFjIq5vP7cl(Geoq7xF@)T
zEDhxEU0NsGD<RZ%WDQGd5^K*ZplxR;&zn&ceO9F*s@D>(Al%eUk5T_~9Ad^GG%Y59
z&YB)#Riyuh)S4G4quwZXy(4ng@3jz~<}DGAmO4elDiNWpi|bv$qE8W%G4Wx*6^#@n
zy=ZkxN5M4Rr+^#abk<ZM8+A`12j*v$jPpIRci8*+oydQ<mN}a3I`H)>jVC(PZPxzz
zM%zM-ba^G00mYV|KR1$I+?yD6{v+bnTGC+2f&#%0r>6zu<3G=0Cd=f(7E-um<?dG>
zcl*P)^XXt83_*fOB9n;3(WX}IYQ?${;ZL-HD$k1hp^cV-z{{RXOK(iN9+(M}lETd^
zL!xahCUgB&G<jh?RG&1csxue$%keYt-Q|7XmZKBdRcp0PkC=d&=CT&NYlkeDzJIMl
z|Lm*O43dOl&<I47_RG$63oZGtXoS}>waf{TAGehntFLh@v87g_ttw&Hb?D;#$j*~|
z#K14Q%`;X>Fq=<-rp|R&O=MpIW0m>i3)8(qx<0d60!<U^rgN$60*5c18<MG-GreZR
zKH(d#M#>P%?4%T%PP#%}W&eX!Ayz61du0Y6iJWGKTZHScOTF@hy7Xq|=A}#2)r`#{
zvWIGp<zrtLjuaq198`XZOH%nI735!wF(2V9RUZ$7!)juKs;K1y-zErPstl^|+nqnm
z|EXLoDW=$pGy}W_XN5mLyjR+zXBC)R`t>Ws^}L04XEP_ok0jtdOTaWbin)aI6c9&9
zECAkk+ny*2%*CDdC)Pobu}K^whZ$UL<4&%sy7jCvf7QhkI3k^{v`^$BgFvMscgnVg
zu`Fg*UZ`ks_dH!XC<;IocpUuGjA|{ve<)3b%zxgtybIELiYtuHf<ykQmfI?hR&e%#
z1bxC~b@O<)BF7oLh7?!zy_X=K3+rI<j<Jytbhb$@e^d~4p&zT)aUzn1z51g$+rF!n
z1%3IfD}suB5w?8caYM`TpJ-@W6b8szvkT|_G@vvd;2{o%NPD9k`gvL&sH_{<VSW#b
z`HUH%q6bdx#cDxo(s;_dX)c1_cTK4D#e`5JWy2@t5oS!}!Nn`E567beu$*W@3}I_K
zqH|~u0a5VcUK6@d&v|F<qi4(yTZ%`1_Gl<R@r|;mQd30JE~ala=AKPyt0@=&gAlQt
zG+gV#pCTGZmOiT6-%{|p{O7j-yup*(8go7-5?2Zy-3K-rH8%e4i!z>;2DEZ*jqzIL
zyBw~kV-wi^8uq77bq8CFyPx1X2C7;Y?2OEjQ+0C{UE11J9k=TPuDkscaP=dFuBW>0
z<ec`E;dFVW28YG%ViH6wzHE3Rl&wo|TcjOvATh~?6N;-ifwZ3lQ_S%ta@N;`5w{*y
zpQ~ti4$+YA&sN(VeyEY1!wFNW)7F~Yr?7p(cURrpZ5CK*mn8>JkUQM%(I;&g&ckzd
zE*P#fH*|=}<oazLfo^{Lx_4X(SmFy|RKi!fDAYi<Lwh#;%fqBpYFIEoI>=bv5Brp<
zlTcRRfhr<I;t+F~A=q}&eJ9xP5`#?yn}$<mq<CtiRA&1*+%=lq33rxOO_krziUg^a
z1~K$yeuAA+(9a)<88V`z0`3~5OwoQxa@?5+YN-U)Nu!uNfw*6A*m1Y5)un6fo8eWJ
zdueZzgkV3|grW24zTD22&#xBHiYm7YU5g&aW$#{a$v4wpASHqfO2fYj421NsJ;YPl
zm!XP~F<{SQh)}oKWhu|XM@A!7hlSJZ;K2n=&9vQ~`0jnQSlqebwx4@7U70gCH#cE!
zf1qk9P4nY{n;2y{)i^$CYw(*_F`E2Z&jqaCr0>iM=%V%s2x-z%G}brGbl7j6Ft5e3
zz7ss`5oDUHlhbsZ=-phCW3*bgF487n@5dR`vrL&#e#t_0RyI4iKed9nk~%<iNcIP-
zppykGV}EC@UkvypUr=&C(-qHPZGW+R^}!~Mq&>FGa%2nr?tKXTAaU%cf#l5rFTd6c
zCq-e~_fJK?D!vEeX5hOQ3$i;B=3eFgU0F_HRCZ)EJkJ+=Wig2KUIn2Hyd_=^BRNWM
z`xeLQgZ`vd?`D;<&PgERz%uNs_mpmyzf0xO(Ho8OYjfZQ%A6^mtmB!qrkoUY!#en0
zNeMwm^N$&mNWlxVYHL69>4@F4k=ij8F8xn$6L|--2U84MCEu$tQd`tlIOjccx37Bk
zecFtsQ{^Xd?aaqBvN90Uk5)+)Sb8mFx@;ZiYO=GaVpS$|=e5{~!>{tmtqJ(l8ASZV
zYn@bG+$mEyy_*#0q$9dN=tC*B?9tMQyoWX=B@e`sACGrlH~;wS`9x@-fXI#(qi1qw
zLcN=10cWbQphMs+#rW>3{o-nIPo+)d)wDXUjKXh^%Ukp%C7>cyr7Q@%MI^n5T5D{L
z)ol&Xu0N745)EDCQrx^2i>H2%!c_aPK6!ePL^MSt_hnT0Pnh~wDt)nsZDHmjdOHt>
zTKIaRjR@^uQPxei66y$`6{68&PuW87V-;yL7gM6%5K)Oe@v}wkvE_JHVWUf)A=3PF
zC%=!0Aa<4H!GZ+U9Cb0_U_AFQi|62DhqH^gsUzEtR+)@PouS2kT*T3|z`I$Kq={e6
z_mZqPwo&R<fOm!8&+FAW?p7&GqsVZNsVhBN+~#|lUqSAB@DUG|lvTEHgkQy7?zn8m
zRcQ+iAFFtt|6R~<dVbEVpP8B4@%B}s&zWq(lx0?{O#aI1?Ah6zWGJ#2UD#`i4PE}r
zr{NOpR#7}CDP|ZB>8TGJNt!!JF>@p_;&})*2!ag9hyOpS-YTrkw&@ziin|7PcXxM}
zwiI`FcMI-X9EwYE4Q_?t?hxE5QYeMeVt;x+@3-+EvzN^?bB(N7vj&#YX&W~%cz<e3
zt)J>7eM0gY#S+!&^C<$q%4w7v%4II)T7*oFw@#U7Hj#ZqkKgd&aplneRTa6=+Kt+j
zyj>ju3K|4-nFLIr)@}sP3plM?DJBcZ^wMm?F^;*JuW{|6!*Rt`<KTBE;z|$6n_ouZ
zUEHvJ!`F3V@@c@u4p#mwjiZ#nrQv>j+bkhwye%?!%v~_*kcx941bZ6`7^3cGGNWX#
zGJpJ8$%UMvdxR-hhP*UJ^h9i3Miw$YMa0>JW$fKx{AY*N`PZW|VKTokQ5-hX`A~Ac
zRAd4?|Gh4bbNemPG{}Exbfch)mm9l&9CR(@P&PUvQ)j7Hj#n=bwC+Y~A~t6*b+S=F
ze~7(v<&2K+)F#;BGz8NxBKK`jjwv?Wy{=?fz;)Y__hcsK2220r$K_dLk%j1NBFKg7
z@;ZcHvHrvktyg-FGbuj`Kx0_^M<cGqbe3fr=(>KkbtUwe5s_+6GEYXRQ5_!iW$@}l
zE%0{^URNRH3-&`BM<#nmUt|Crqyd9%`=u%=ho77C;&%21(M+dqX{FM$%2(+>_Eqs7
z6gD8*qSuaqvORE>WCz)ydL<{*1&-|MGa#22*vFsW-ob^mdRZ4&t9<)Df!&1;R4DnZ
zLbKD{8vgBX924$7*8y%1U<ls;`@^!1pF8VGDdnJpGNqA)Oqcd&*(V-fEnjyJ>>5SJ
zz0{~vVOEx`1_`Uu;zY2}6Ip#dbhwYPkq({iCsBr`^!+}N*EI>hajY(*1x^U<^=whN
z4j)k$<V2VZ#!750+9*0;=_&g)@RLh~RpVv~xIUog6xUL>mAQ3<4Y;)p*I=L1hy)~p
zQ=CCrAjCEl_;=h?P3Tt~id{3Y<YOozn3Uq-Ls3kmFRG<KXk!#F!|5%ZR)vs{W{_!r
zJB;{T?l_YF(jH2TkYB*ntK>$;$)7b27et*E(P*t(vm`r^HZvdS$_^4UzeHQ+7@C@%
zzD6<Q$gT2RD!ib)^9ZoM4Xcgu?&NnduL`AEHO}b5LiwcpzgjsDW}u!f8SO9bS9cn&
zPGq`_D{MbzL-+G2A3&))(X;)O!2zICVc}D}&`{1VxYjKK=^UO*J(AaN6$IQ+O%&W~
z)OHt{xDV;qaBl9!J5hhj{3`QKsCuz|K%jPNALyE~lC0nGHcWUy$`AX3N-ZmoyLswL
z4?srjpe*r|d2_UxD)qD;0FFOWAS>&mP<EmnpFJywfm6}nyOd3OqPbx@nwgwq;#F(C
zEXcuqmV;~asvjC3^8rm+A9LH+SGx@7jozj7wFWshi%9bX3*1yaQY!(5Hzfk$q642t
z4$slv$#fCN7_A0jzd;t9Kc&RY8HV5U*cOxj{D@br;|rhnP>w8&c+`+3Bid)6i57@X
zfH+N#v?W#NnPpm5t{-Z8uRj=fZtNkje9lD<Bmyd7?w=I*5tKr_`&4U0>Q$`2D`wqb
z3NKs?)D|cq5@~j)7Y&@8-ekRoaQyiRZbu`}7DhVNiE8CDLF!0;CurRKoUw6c0tEd7
zg^Hz+Zw%EAI;A+G^Qhr$;ebrjHO|iW*o`QL{Xtpe;y&CX+N95(wi^*x60VMzS7A05
z2x!Qbu^=v+Zm0+f{6^($Q`MJ%EfSIxsy2hJ1RvP@(@0L+)r&AGjX?r<h4*AJhOjiM
zoi|qF8RdSJ@}N6NV(W>#47o1ZaK92-JadGQr5_(MZ|s2<-StRw{#jW&m_dWgel7S!
z7W8YY%k9`M%uu1MU0~Fl*rmg{u@^b?j8F|v92fFbPtZT4J?*p>9w+Vau(BbWQr`lF
z&Lebp!=!@_YwDcVKYWO=BdBJ9y`9aOu*Oj%OsBB+PAYTyoouYz`qq?hRNjt~^%MEI
z#r$|@;NIGCD-;&-N<BuNRAP}^FKjr6nv1N%V@r%JABiaGr|RWH&#PG=mUM4~DK`Ul
z+%S0s`Tn^~?1(gG_2M>QK7LAI9z3F-Or8EGO0$E=bR8GTm7#OSvj67lK6u>I=(@pU
zJoBwO$~|i9T%*czz|aG$ezQ*NKmSLBg+iXvZfVPMH~=<;cxoS6d%buZ+^cVB*_#LS
zy!HL(seKQdtgGv8fN!`yM(8qVLqBpNZn-dLN0Z3SPYZY{Gu)lp?@1pl6}roGb!67!
zh1e!g(4$q$#HL-4)_{m=ui7REs`lX_({5F6&^(_(!};!a3??IC8TPU~_E-s*OgsI#
zCp!1(GgQG2sDEbm(Zx}Aqgm%^sxfFHdalUcS{`LOV9nvlx7XgWXxl6XlfDkN0gu!)
zaN&V$%Ni+}zP{56fzL$Px+haN8I-`$M|M3!|8N3Yt7kWkvLh&~cM@V?l<v`K3W+h_
zZWodT^KX#mn>K%aU$xPKmIZm;EWZl6;M$DlDR~sEH*p?FVz>+^$X+jJ=B+0YMB_$B
zP@`EyM8X-}%j2<C>FPT*wuQW;^xCoK+(f1c*<oN&7ki=}3ymQf#C_EXc5KG0EdY#s
zHTW#wf#zfz$<mQqAm&r>Y&m_<Spv;CiR9DC@Ei|(572hga@JzkTH8nd0E>MK|8hFR
z{|{38KNu1SM-Q!Riis3vaDhWg#pQHx&1jN_aurHd5Gs!h-Q9Hy{y<-vNa8K*^x@mb
z0kQzBaE@hE*EpXeb!qJ6=40Erb|TY&5f#;`eO;W6cXwRE3f`Gl0Z-15_}t@kt_aLp
zHt!7od3uYZ>V;LklqNfJ0NdIhK+$bFGs0JlGA(QT@65|M@t?JDyQRZY9cDQ@+ux;8
zGt4wM1N^c%z-(UZV@`+Br%o>!Df%<X27ws+%b1s6quwjD@>6>mu_6dDqA-USb100&
z4trxfOjfSdmG}cTB~h=KqY~uF<w8*yFo{o|f#<l3y_SvbF%OW(g<&^kZQToMM-4uy
z;+VZ!BUsj7)N0DcwgXQyeGiYcSdh|+gv-2?kj1Pop}Cn@l<>7&r7oXG++9Yp*mG<y
zOoNy5xS^a(HBs^yO}@h7vSu2=@ibZNlFkL$hs8kchsCSNkk#cu{IA>Zv$?KYSbXOW
zuYUjhL$h}7eEAdc)jMmv<#spD=H`ImIzq(Q#BUmJV*6q(>mR0!PYC@$zI9VLBq5_a
zz!g1@U<f!qd|(|;bo*f8980@3?>6t_6bPTjia9jkBZR;jY-Pw@L|*zxSiue8K$RBX
z%HqhiL?fD!`y7|{ursym$ZI<trnhY-3L1cIR%7KFVIJYwW{##-xQ!wzu)Qz|T6o~M
zEY7d`OV!Jbf?QP`ZR&=Q#!MAKu8G;(%EyQdJO*UxsS;Q=8KWHFXtwM5x3`<QLGt(=
zFTYA|IYL&Qn<9EH>YLwXeFyodT@*CEbHfqV+qH;E9t6W*lT$wmk8y2#Az2V}8V3k4
zJPls@)O&+$FG6ao^TL&7PxO`jh1oXLeQxHdYXNCZ8}At`4Zb(kCpmu`l=zG6J6KUV
zgX;!c^7iY1{tk!e4~Ag^6Q#QI0MOdMXvVa2nL(q_>Ch%oRzC?@@RP%7Ve9$>g>lS;
z3>PgG+hxxB-2D`>tNq0B3~ayz5jg|X2OxTAS4v>tQG!vZ=xznx8WZ9o(S1u0!zD7Z
zsRE(<M{k2dW5VbCa;mWe&$sHVf5QMR0JLF6I~1uVpm9^c&JnikZoQ7i$<DU;+9?D_
zZD?~ingZf3Q#5$lFSlKY%3>K^o~5VvyTLR^mSvMERqx;oxz*&Ra!yzOBD8@?E@st^
z<Z!v(EbCUHG@MjS-awc`-q<;<!cFy~G-0-*gBy12H8_xYNhFGhMs*O0i1vtTrx!3`
z6ph`I#F-c%t3jsd*OBZqBEms#U6P#R9B_;gc$0z!*<>_r^La$b9%_87t2oscH{$oX
zhBzhN+C=K8>REqm|M)o>EbKO;v<7MJhF?XzEsFGWb;Y2Clkegu-*TCA_Q${r;G=So
zk5gx&e3xyAz8SI7)rk;+vw);fQ$2`40|<=0aU<6i_fJ$eY#S7~s&1~?$6IJL5N*2S
z2=x5U3vxS`5xw}CDPZ}43y7l?aDQeZ75C^Qua^9Npu}s^n!ikYs3Q%W?!Y5psqgs0
z_AuhG24Q2;VfKiC7<cvZ@0L#2Pj@%A+KWF_2sU(8#oK>X$ZgPRME}tks^eC)`VU+$
zZu(c9uHI`o%9&~5`CZ=fgKXardc2NNNkv`6ES|oJc34KL7q*dw`xfz&HAKZaN366D
zDI}v?9wfwpf)?m%6^_~#TWCmwcWBhIxF<=HE3V>V1U6UMd+Le5z<+gPE^RfxA%0Fx
zNRZXl&uiOQ+B48zuvsCP5kPz|s)*B7a?P~GgpHQ7z*Op{RLSNPV}>Rx6wN(Y58xm)
zM^AT*DY}uUZ6RmR(K<}pet3$ZXe0U(h!Zk5CL|x5L?ODf6TGsb%TtQddY}#(U8Sv-
zv|6DZ-Kb7GENpbMJe1DoYS=Ofu*dt0VtPyxX{q{|CQkvsw0{<pT-=7fqC&v`8&fSA
z1?YPk7-Y8)gnpfGwiaXtFcOd7Pu_A7^>uC6wv47FQ5<i08@CoP|Aim;`qkFyH;5f{
zDpf`v;!<=q8p%TWdd8J67MT07gtN6K;p%LML3G&*9sZ4_P8`D*Z$wRFeuH>PW9gG9
zI%48a*v#)P6a~B7bw7R)*-Ro^{F=(H`yzExkNB`Brg`>LVr*)t0+OKK(DSmjpYBS4
z=$coP_ME<bUYN!!Mty~Ok@8<Wql3n?@Lo2D&&bfZtfp8O=Kg3jWP0O{+GlL@BHw4D
zw$Z6&I0k#RZYF`%$f%$tw{>(Q{TOebq!}7)^(|;w?YF_@0BnPjWD!V<eN5lu7S!t~
zOO|!8Lz*^eVoB;o-I}6QWvul#SrQDK_v=_ljrr$la8x^OOvMl0{cvx+sxa?L_F#}e
zo<Nw2ypTZ|(dVw~U`D<q)N>J}sO~7*enLLrrfh}sFgIT#nxuwhoNpvuBBdl2*Ue6+
zIa}Ow)-6wGQ)lu8hes{H+o65~)a^8v%45fC8@?^pVwWpF;`pwEIvxfWw{4P=c52(m
zEQnvho+q;)Zfm^yYNzm-e37ka3|6qZ6hd<fY5n!M6S{%w=651p$YiFiC2p$2uX^wU
zN1g?e1J>r<oNJSF;1|V&noB%E^~gDXGTA&V{l|3;M{zwQtTcxN%zVV%qh<}VD(3Wk
z0~~mG4M@^F#caBo`z7Ly_MXT-gg!NGik>kfEd_O*XgtKPHxW?D*}<9UPS{t#E0gcB
zo;lZN9QR~&Q0m!!QN8+KS^WR|uJ)!q6;oCXd8hlJ<j9UOioi*V;9uMcwDEF|cwPpm
z8kopnkl6xm&!xC6<NzEy&DD$g+L7o?W_g3C)?^+_-Ma!-z7Au3msCXVR;Nzg?`r+7
zzl96NRZl(&j9sx0jdDY;<yRYl2(1%+X6!TW30Shd=8t5&bw&u`IU!^CMd+5J=b6G#
z0Tg#&hqJg{V}CDd!~xaKjf#|4jQPi7Ht#2_<;@@0f5b~w5?i4^VE<{fXfob>_$H#p
z3CV4>p+?wp>r@?adfhtCnI5jI^Q$9}--%4!N%)IJ6*{hvG$==rp|B}G#n~cn%igYo
z{-KU3rYRa(vSomf@TAYJU5XFY=$;PFvCg<1#fAA8kl49CYvNW?Z~T;gwHY#kDG-Sx
zaIH-m=Qoza05*a2f=vP)Yp-N`kJfK)1wux-Y5~Hi&~46Nnf)t?J89|(I^%y2*6~{U
z`A!Vyh&nV#;L*hs{5==!39i|=T4&yiykG0T{+|7m`+V5X-*v~w{@-6xjC@0?deB+S
z5l2D`7m+U|`mL>9T24Ta@$xLq7-YX>qjv2MST&8E^Bak${g|UiYo6cX)VjZtlS;hA
zHkZ#k_XiNe6_%W`wLj~qN?7FVxa!;<p=fsOJd8k!9cgW?jXYJJR9)8+b$6=w@t8|B
zi5N;2y9BM7LK26ZdZ@}1zMh(~C5cMfFeXyR%3}9xfp6x*)-~Ft%Pm{d0d*5vqtuVo
zqN2<S(BUKt#4Jyp;Q-Y5kh<;to3!aC;f9jjOy`rYrk<y21iKN}Tm$AOLv{5G@~@(Z
zIHs<UjvvkNNGUP}vSzeA3P@X|@v6d8CeuDn8<za8yOvWXkZ2TfmL&H=C`sL={mJpN
z!n@YpgdH&L-hezO){Yo5-R^Uo`6+ye2hd!5+5J0s#D~nGZFk3WVB6>PswvsBiHbqS
zUj3VOMfJ1=iqh*DX1*amLH|a@85*OAd$TZ=614}h4(40&xpa0wcGlrF+-k>jfJjzX
z0P>~=aB5q+0~vK^x~uSX??~<EJ8s|3dp3Wb+;*COv-x*2P+pW2N92F~Bkb(@DjeP|
zFk;MUcSjbxp&i>6JZqq;?WFzpg>Yl^lSzjlsMjh*Ovm|?QAkDbfu@A{lC4^_o&r9y
z23X8Br!e%D1A+k?P-iYlBZ&`*RHg^n?E?&3%#!PS-RRls2y{PXw+RXk*f%-_k-v`S
z01(XQ3=9oQuy9a@#ec-;MXA0sJ*Rt4!*LbDnDRuuaL$?S!e3JGwCRF^cqp@NNRr#Q
zk1S*H3EWL{b=5(U<StI22mrp2`+*+vl!{@yPl7m9+^&kUgqAkvmJ=xL;|$Ov0uFGJ
z>?2}&==SqGlE-K<BH>-v3GZ15j+u#b$ap1`>LG+v!as~Af&Qp+L~3z1Cw%Ik3kjX;
zdl*yvw82|z+6*0MM(C%BzaEf48yVyTL76r4L32RK%^qdA9T8MjRS(J0BT2n*+f3dp
zJ@N))ND`9qO>0Es)PmAx@y-Y+8s#oUCF;mCdnOis_s4}!>hdnC8S?#gtV61&Pbj8J
zTkI)(W3G^SxN%Uj_&;4$d@5*$f$L>*NJmE3g=;?Wc<dW>z5tOx+8sH+b?_f@hmLef
zXwB2(`~o$9edmJCjc()!^akx<Qn-wkQ-DELm9tQN#VXy8A`7$PKgdLXZzVWiJe0YK
z`;puR;WS_n?k3Bj$qYm_JGGyT26S?a?0;{X!=w;H-$$xtMqnn3DIv|@_e496M-dPT
z<~xaq=I?rU0O&{KQjal%%9S6*;@b?AB_`sJ)s<H-Z|WnlwbWxz7NmETmM`ME&ABy@
zBIRS7!{en47SaNFHmUs*ux)6gUPq~%GTfSxEsH7ZTMAxM`bjWiWsMS3UG0B$fSOn2
zx0#~x<XLvE>rS*EL&&7XE9QFb@EDUi92@+Lf`6ig+IvsLivPSRd-!{egj0jTopp;E
zgHubq&kj)GNQCvh(He?maZ+5jAh=rfyX2}YYw*D<;NmODua3~QdM<mHYrb4<!Yk8$
zr>^kZQc$mPEWaWDW@g;R;7d<}jVZFIFUqHP;I2<8t%R0kwuRy~i<ST7dURL`(F`Gu
zoT-v%=n$B3et9`wS$Ojj+|FtE(#*gZEsI?{pMRYef+Lf!ofD1owS)<^1G$@fq%4*h
zUGlKr@M?k4q$#;FcKdA)@8+TqP1{M=MAyOl>0$lLcI>R%4F=@luj8tpaakYM0$ph{
zk6ytkq`V$uwez^CH4kL2(2Y4;heUm`g|??7ZF<5N=}iJHW`5_?+sC-EOK<JdVU8L?
z*wA-P6Y!<Ume^rA$Z|>=h;`4H*gEX>ES9iy+>w`ro{MO)doqWGz9KzP6Sm}Ul0ZY3
zx{H=M0-Ojw(7FS@^^m&X!_kqqR2zS&o(^?N<a>C3Vz@NY=W}2*p<(MSzadP*&G)w#
z&Zg+Kp|w9@<nG5Z<DR<Gj}_&6-*F<Q5Ru>+%>Gm^9v2Ve8#B7$VaL!H5PFRJ>cwfp
z$}!V%Cu@^gdf+oUqzO{#io>c=s2S6&67}{=J=|%-#FztT^WeVaH;|5D99d!jyIZqL
z3jga;VE%O}do<N3G;WpHvDApS+L1yKc%pEoNF(KQuGn3LQ;<}eA{tv&uuC+U=nI+~
zJyXPBedMl7tN7ieh-eVP0^R0*D;bvg=6MHI>2MD48Zet;==r`CY`BNH&@=}XH$<Uz
zN1)!{3++84gBU{`AU=|oGxs^(oCrm`$(WxhWl6OdN4U57(Z317rA@*5l7FR}jUpgy
zKru&N<=f1ZszyIkLblTDY+j7LaUxq@gMEt!7_o02;#UE*VxN_v`}}G*I2D?RxL`AM
zT`PqZWKSxxmmJZ(7HMCMIt4cg_6GbZ{5<p6j}1#dw+Zb#7&=|Z!tO<ZJ{@gsoey9<
zKxAw$*a=G!UFK|YQr%sXD3$M8h^Fbo*gWMdA95>?i_qR!l2}17CkEwrd}B7VuB!DI
zkx|&Jy|@n@;gTAUBIc_8(?>7&t4vMI)wwD1UMO}HzvXz>x*1Q#w0qqoG>`H+c=dWA
zjgtR8xDvwSJ-xe;(kD4*9H6vD7*DM3GX97;%7`mEp{{{Gvj<*II5AH2{&m=d5EbTm
zo)j$USXfI3=&E_e(G<uOd4sNfCJ&v%v@S{GGo~ladQ3I4+Q}e0MS8J*9eiyPhjvKF
zo5-a?iOuJ&m77zImq1cD#O3{u=tNlE?DHap#ry!7ocAi8HRpU$T>Y?k*wx@B!uP-2
z^Eqn-iB5qQxckQd-VObXw3uTLFY2kY;_u$cGvkOC&PabxY2>sxX$=tHgz>l!INs~)
zJo2=WfJ+%Y(y%Vb$$;aBH~QC7fAB{VXQXT0khjvYhwNh=yWeYBEnU&V0cU;OA9_AJ
z;<<>-`^5Y1s?13UeL|hIXG}Mjw(%2e%Z#(gbiS3Z9gwqZN^u^h{4JS^1?gY+j@o;6
zffOG91n76d=_%P-kQ*Dmn*6u!U+e}gc61Ip-5O#HXy78ggrU(Q{uv&!V}2xhU)`nn
z_k&!}^DeQ&bR37oml*jrn;)=p9qVRDm<uwAp3RgZ*feQ)x`Qxi)E6Tx{S7+UGg_Mh
z7DrZ)7{K^kUBE^%{|W>Usp_bR5U+*rf*JckI>8CqdI`56T<LHMFN!JQbx<pvEOM;7
z*wUR04m+uo>v(xd&;6iHeEW!P``2y~O(R|zHpGi<@6rc9{SqyTioI)jX-j=*Tx6JI
z77;A82?NxyR{~xlu#JH5zB?hk4Yd>?^0K^--{h(X>oIJE>V*=Q<+$M1@rHxu;db<e
zeWbZOCFf-I8ze7V6YdjN!wnIRslW5a%Nf^2+umW}<_%i(6}l|s!d{qspN_@QMCbMF
zc;74G_3DkJZT86oX{v|WJ=0(K*Qb9RK-9E<Q!*2Rc4Y)aX4rVsZh&9N*EYQX3zjIw
z*B$P778SKKuG3j;>BIvA<Rg(-DFbotAoMI7RL4g~DoQY&97m;}O%8v&!g^9#)uwLa
zh7<o&%0@$<sFUN2MknszM_8J4)b^D)%Xmjr=m^J=Io^x^z55av7R>-8P90~74Q>N_
zxaB>?JjXHB&D$YWP_uV>VU%#P2S@26z7vplAi1i<j*;F%(TKPIknkX5<r($nP7#Pd
zl%D0lz&NTclI`S(e06KEpE%c`ZjV37u;iQL95w@ZTFB72C6)Kr;K|^g{5ARex%a$(
zh?HPc+RoXh>@jr$4{S29o^1AWq;*YV&E<KYuzN4vw|psYTD(E5ZHPcc!UWT_IMB8P
z-mao2&dl~78BDG?49YDfx&do1$(c3b?3syHWmV%de`r3ht9G+j8ln^=uvvZ=Z~MR&
zDeVprivhZ)hJU${l|wT~Vg|~Nt9lnk15WB(?a>8Phirv_9=lsXgF6a*iL%}^O;HMU
z^(gxrZUxQh%(~~_w2h|kn9d)G((z<g@XCw=be;X+$~bzd_!gv)#q`Xmuj89WoMyA)
zOX!^fs|G9FD*2(UPut(hJ(hjkpCTydUR)Pe5?N@?XL7ZSfDPyG7V$QWGVTRk%zOTK
zgFH;`_TH7S5K_4@bRh-)6rKgCqe0Le<){c(E4D5Bm;*usf!CPSh>+E(_aN#!Ruj9H
zPmOp@Uj~owheA6jL*3J-CI_xJyEapYM88?$cZtQYW6|j@be&ULQoeYvK{291VS|4P
z0zf!AC@>sGB(DwyhE>AMmzekpV<Y)95e=(i?9L-yo!S7U@iKtYbVn_XSsFD<3w-z^
zyCXGUE;>U}IY5wK31~6)AytL;lB6UOCzJZ4)xg^@3o9pOl6MxOp#yTru%2cGB$ZN|
z2m7SdLaqzX@eAe=_cFwu*k+rIN^yZy0V3p<9L|rimdG{Y#BEZs&Y`%BrqEjKlRU(8
zwMFd5VNAC!j6ZwWP+~_h<+*B)DsS5k?$?k;RZqC%R>C^HK?Gjl4>(cImA&!0qE`bA
zu?4#d!vSwP<9LcYbUX?R8V1RQ^?(KfdotBx_bUM3`qtuQq&x0YbqRB^HjnNZEk**r
zJRjRn<1F(NDzi&lnLq0u6L@V~KO@~vuU*hi&T;#PWP2NSK(6wb9Kp5zH|X{MmWZUN
zaZ-gi%4<tNv4d2MQeRbuNWcFotbpBM=8t8Im+G%xD`@)0lNiTE^`{BXVnJW(Tr`2p
zZaVUD$evM+x}128NSkqsitn>_`~<HZPZC&#eIb5=n+o%f-T-pe4p(Gl>*^vd`ieTG
zscl^4H}9I6RvS>q822%6rH4Y$LF%2MRN8W;9@bJ`5;FEm(@9pA84p%u1}i7)ut=$_
znHHHm&y<5=!M;$bo?95@I~Ou*og?T5^58GL<j(}6tS)s-(K%z<M5bMBZ2)+}gn1La
zZuj@t(xe7dXZhIFhkCNDD`Y}WiYfdCqMtoTud&mS8OO!}+6IRUSeSl%8o#8082eMz
zq|WY<HL|AS(rWuNHcdaU?}DW1s^-6NxKDFX4fHVea&29HXx}0H-T8c(QWWkVv~WQ=
zb!6Gcl<gnkZ?p|;>7HH6`>&?N{D+5k5jw;nqX)ogM9OI0N=Buh4ycM&dGZX7cw-OX
z`@1v|M}1)|E^v_#5xl{e;(JMKUW&6qWJHs#lYt39Ayk!Xv(vOV5k_9}i3};*WoJAK
zV;Byi^lIBn^v+?%g3FEAU&QWe&@QyV7~UvYSC{?3NEK-*#0~dm5j`9$Bl{^+!8z#I
zPSo*0N$vi!Pl(nOr_^+wE8$Dm12-9|Y@;^9V)%6Dczw=hu1u~>s_qf?0dA{!VviB3
zv=O4Y5#o?hc;_VkCVr>88tS)dQmx6R@)#%wKqn}8$_D}p?zj@salLP_tR|Hq+0Z6p
zzsBzI`V*$4A;Z>De2vMbji<i+tN&~SOp1W&Q!q73>rK=!eP)YT;R2WI?;qV$Y$PpW
z@{1?KG+eZ3WpDHExAi!yBe#;hb=d#$fj+=JVty9lSWYPOi5sM%gV~TniOjll7sJP;
zJhUu~n0QPnnFolj|GCf^_p#SyEN5b|Cq9PZ0f@L$RE3_Pxe(^i<(B4x8Q;ggLpPrs
z3a|!eVu$CvU}mJ0?<H%Id~HkD>*EJ=Zy-X3RjAU>v95v=f=!Lr7(h|04l0vvA3uYg
z7ISbwUME3@B93Y54N`12u^T!g6$vy>h5#DUZoC7E;L>qfLqqec`_Fa&ydWtu%XBQC
z2z(~g1nvsHLUun2OV(_BMN!*LPvLo@&i7`~Qr#cu1{1hBqCcs(yC2p#ttK`<{B3x7
zxP-*i?E{``-FXMYxAqi}ZMqBHQmN{fmG#!XHl7<M<t><o#;LUx57+!iu(WdP-H<pa
zfq7^w;4H`;Losf!N@w&7UdZ1lv<4R;jG$O*n)m$e0|x4A%yazXt}!9NJ@%&yaYUk(
z2*eH&%Y>D#O~`!bnUuBFE|(e=F~ttUx5QT?!$*=okt2~OHC67!nI|Dpv1AZ`B&NMa
z7-0o*3(a*&+!$p=I%{;}sAS4w4|C?wkQ{KrRUPwL)Da9vQAZ7h{JN+BSYD}#WpiMs
zuIc&c(HoO;{cJ$+PNDed(rTOB5!G6?QGoK^*$J$~njj!_tFmCKi<02VyiLlau;J3J
zV|I`vpth^_J5evK6=n$>A(Qc9?k70zuzZa1P*&0jfXlVURzNZm+~oFasyKeL{V|hA
z*EP%6$N5eCfuGl7u12PQT^fcijDh4RRlL0OSKD&;e3TW#(#qCZsM4F1q`3>-5_sGy
zU4gDApWTHD1$(5QP)k);_Zo-zi6UU<@cg6xyD)Jg5?MO0UTk8D>#-EdH!=2`$Lt^e
zk~}?UDhOl4C_k}ZSUC*8=C%Jk>5j@qd>9I(+?biWaYy`1zXrf_{6wD8a70`G31%?k
z0|Q9AIqmEl0lWb29Y9a`kN8amYX_4?yjpKT^rm0_&H#F%Woq(o#qBR%A&Wo=QPGW8
zRmisDAk@r~Y4-O0l3k)H<5LFpQwG5^^CW@HE#1N}Nxp-+`YR{~d)$Lr2o^Z^KW9H-
z<r=~|(2#LyV+jMpu<}$Hk1>Io+)vt<Kfl0-`%@EZC0M~FaRyiEgmG6C$k!~P;5`(7
zgCTGEE6oHfphjEw2>GjHEjEvLgwI5yx%VhPDQjx-RX@6Ay5iR~he^#w=9u8s)}N2H
znP`ueFfA~kSnZ4pk3q-exX{_JGGNIt?Fs(yUxU&$b&EW95%2X0Zjk+9&j$O;Nm<C*
zxjv(TV}%ldzolU2_|<{iAIzP~G}b&|oaQZioitDU()S9M_&k!I--&8IJS#Lfiaw3`
zcy?IF!0#F5IlFTXQbzh;Cf*6a<&7z*`TLSsAA^ZcKcn{^(P3J6Ct_3hB!%e}d6fj&
zpx^c{4WwxIAesOE^@<#?Y4FvO9nM3XbD{ZF9!uJEC&u6}_`jFkt4$2+FCilv(|k5P
zHhb<0MhHTf4M7O`HGJx9dw~UN6$L9>Aj2@Qy&vB!mZulnTM?FFa#Z#CAkWPAQElTB
zvS3XJV`t`QPF;;>pc#faoTSu>ezpz%-+4JcX}U2@x=bq3I<{8Nq&-9DkynaS)G7a#
z>d9i2$)Q}nbIc8S<UNio)`z2t1fTu_+B-;Fg^pP^2gk-=gN=Ck(E^Kb%8cEkHMShg
zuiuH_icnN681>g4h)?O~Fh0}dr<MbK;G~gi!h)HyF<xgDOQu+Otpu-$HOR}9rJ{4v
zm!YCme0;`wHlu!`>=XzvmS7IEEvs=)t2{weVpiABS2E^H68*Wbyh{R`j{1fD<>Ds?
z<cXT&1)6*u;=C}`0fSmj#_3;TaP78Wx!}zM+eWIt^X*_dY)fs=BKv8QC=d<CoW(wN
zA_WR>)ChVH2X4je9NwP+-j@F7w68S9jT}g0uV{|1F3FT>P|r;q#0t3~f0BGl5xgu8
zaY9480Nsu=<nEXBJyb!$Hr6MwWONE?rBp+PQfW7g_nfEEQX@ItO|({XrfVXa00#*E
zmty|H@;N+HFl%Z}YDLP4!4;INM{UH!-@_8ykC0}c^ioHOBU|5*F$#RjcJl7B*zb&?
zH=1-%wXXf3GE1tjfuE<u6#T6^)wV!NOn*-fH$k}gg9l;`1X!6TA0^P_UzTKr?~$D9
z+6>qw_+4!9kf^hS!nat{&qyky%q(J6*E7!YK}pUUy83~UL=O3oaR)dBq-w&PF^Bo0
zGM%E85O^ktc_FOk5!6d`L30wkZ@(HUqaBq2|MO?|RmncaxHJ|FmaNGdJaj}^lN{gd
z`C}d<^o^5O$znfyNzRVyzN|;ym$RZQq_=?*XGUjz&#^mgX9}mPki)>q8q*-CcLpJx
zaKV}Aa>odQu_hGv>J-d^or!&8<{Rj19%hJ4+wO=O_quO5RxWe66me2jm>toMt!sbW
zGZ{#O0P}dg-IpimOmxS>aLLLc3iBwz3QY7jxN3@xk(F~3iuxEUFpC+O>-LWPKu#*p
zt3f;=w9+~csVCelr`m)B-CBINSv%Nba#ps_b@7ZIvH2qayFzqXRWw4_t+=qP>yKfU
zVa^aQFG@05zB#Z3PN)sRJJ_5FwOYBhCAF!^WLT8Xq*sKS$B7lGVTpz#z!1K;#vK;}
z&-Hd-3xupuq6VB^k*33xP|IOsl?i{qtBUE?W2QFDym=O1ulW<S`h7$DbY0;JmV*R^
z)e7!Yr`*n1dSUfoT>g4>B8ce=E44W#dw2i)y#NxkA0@R9V>A9Kn|ApWDjGgpjwN%O
z)kJoh=>}8ho^poInv}3m1O7<~i#hx=pcoP<0cXnyXQeRka#iJg^<3t2b?dr$;o9r!
z`tk?MN&_hiUZT-xt7#zMmf#5-`q=L5+74v&nt*9$nR&;Yc~-ng&in~>T}`XnS4typ
zia3nOI`I}!VUz2<4Ze!!PsG1k@A`-rfy6qIbluj%s&?s{IfsZ+F46r~)Y*i*$vuQ>
z$EJzS5Q`lhe>zMhS{wLL*n(&&4=#lsqh06={=!Uk@Cvh>;Lq{P&ivtyV(d{GZ2}PI
zgApOl=zvC_&=Nkd+jE;_8;Aa(6tNN8N%Razz1hf7&~ViS9%R+Yc$S@V%fykTsylr|
zT$a3YpB7}ZB^xb@0+8G|HrJHFprR}`-8E_*w!sTMG!}e7@4gOm)J;o8$-o^lJ^P&S
zv656zeH;@$Hd*@7-0fq*VesFmr$z7Cx2S~crHSOn^|?OD<sU>3hk}2RAE6cm#<_8O
zCfJ1u4WI-zzDF2+`T8RGb{}dTY=zWueYp|%qu-?{_!*XX4QO4mXvAP1`nzMdwXYts
z>Nwy!W3#3ZOhw2no9pD#BiYo?uu&q0$PO#llBywy-dUKMU98RZ{nd*Tf2CZ2%2Q;C
zj!y!9BEnp>#RM()Oi>aREYlL^9<SEQ&_lg%En~7d>F<`$owQB}vn9-M8)d!<^du=}
zuWT7~CPIni!>w6Y^vQBnPj9n}R9tnXXfm-0T(u6U2-J`Q$5HuWEhkj;VuT$~fW>ju
z`q5zjm=8F{^aSeu068HnvjlEAcstFLZyb~wu{dP0XR=So4&UCUVZfYasttL7iQTt5
zT*A?c!<0(2K;X&wO{;WI;nC!_Z#KkMq-q9q;V8lZZrkaeLS4-Vci0GH1EJjG-#vR9
zP`t3%yhw!8&&=t&sRL4eykouA`ve27=r1cX*2qO7z9$mfI)!Jvq5NMw=>LoCC-nOL
z2apn&GPuS72Y!YNgHRm`gM4=bmR_I#I!Ybm*E<abY|AoyOLLz|x*C%VS-`{sU0rp!
zZf4FXUj896ZF<Ky_;xYyW?HudGdp6886Wi#hiytk-Gw0US>UoG7g-TRIA5T}6Yvc|
zK&}sl8Sh?5&IVVVp~F5DRXKv8lG(EE&a|t^h3E!bLtBpy9x#RJtRNsXoe3pX`w^58
zD_p1M+FS~~D*z$tHVQTy4rhiR)yC)0*=Lu<j*WI<s8%wc0ZpW5@ho}9n2Y(%N{#dI
zc(77EGr))+8SToRGWzcg*+pUeE{tRq1-!=P4f+})cDx)&KO?QeZsMHgOg>>G{o*TZ
z_4H@^-Z@JFBWWSCkB{L+qbyN?-dWr)$6(m)xKgX3^j3$RUY~6x+k(B!;DYlw8b&7D
zRIGdTBUnOT@<rd-ZZOp0tNibiSC1Bm^NPEeV&|RPd!qrDe9_mT!|UIBYyTI4Y2hf6
zPY)#?wV|%gPE%at#WI_go<tlvN=ZvUIK3uP&oD3aj*B$RV%OyL;l0oAS&YE%U&k&t
zPG2`skL90YLSN~xlBro*N)I@73iHS+m2Fr8fEL;6zs3Z*-dimZTp(MG;g6<*N$FTz
zGL}norXWxbLr&4@UlP`gczF3Pz2>Cjnq&8cvj-6??)R&d*6dhT$?m18HbUp4iRf^H
zyYF;T+%ttJs_J6I!p+Ujvzlq7$kH=+HtT88lnv@@4k*UOVTO*7nJCiCHDDXsi04FL
z#PDtc)J?{j!wwKr1NkUCo;mW48ZxIo{u=G|qx9UqUzmS@Ig8L(LQP=xxnCHoH{NZ>
zlK8XyZ8M!d8_g>Du7FnaB#(yvPk5$kxV070qB<)Lg5_jH<d$T4kwyl8N^c@<C%u}s
z+pp1XiS9(#HbX=GUs4{WPrC3pO^y?DcuKmG>Ak5Ez8&g{V6CeiO-y&Ux<ag9jTj-f
zI5$wsX@t7@m&T`k#Y0-RO4?Lp#4uaLBv&&{$(Op971cl=-={ECH}O;lrHK>td106%
znWuBjepy|@MAfXT7c3XZ52#w~h41()jU#rd@H|0*bmt;=h9*5;-FHuxm&Af%6;rhx
zPeK>DnU^j~_j;8NQzpVmE`qWr{IFCu!^HZBb@d-SrI=Rj)m|@#J&kKN_&47}9GP1a
zo@DRl8Nz}nb|@&YoRH=$PQ_rY=G;=0(r0EDZH4DXzFEv>Exdl)&^`8SF8#T<@TrF3
zoL<>92F4yUcbsX$8*YRh=FiEtGsKloxw_Knu6gVVg#sP1P~xygPk3rXif4{|^X>j5
zoj=v<`QTG%)7sl}KRaw?VI|AU{disnvr4+h%5N)GqO2*<q~1?`b&t>ZaP~-ayNb1J
zzcD#>ClttXLQo1&O^o+(XYo`Su3vaWnEHR8Q#_9vA_LcR0?Us>Z2le{DnBualD~Kb
zK4bkaHFhP0^^b{>&22m1!vDk(>cLsxdBG<bq%rH1`g7>{Fv+^xZU`L%2oAg|8a6nu
z|L%Vx9|Tk(!*qc@@GTQQ>^wmpo<5nj_ZY^gZB3=YX3fF5F`~fl>ZG&cdzP>lgPnab
z%^L@y=a=XW_4}RPZZrp4FN(+qgJ7DAHR~|MhKD)OSWaX3!T>T&7gO>*P0h&b(W}BP
z)H5)N`N2J{yX|t(iTr=J_V?CDlVn*f*?<447`u#Pq^$UEyt{b@47AF7uY`{}&RjX%
z&z}Ni>#et^ko07IY0DY(O?EV~ZlNHy;{o@%K)OD9ZN{t$Ijs-PCSwH9LgeDL_4PXx
zQoj4C74)?F+Ob=aMm1qt5!HQQ(sOUOs4$w;rR+l1!nzE7J?dCx$mr|uwr4*ghCc!*
zo3!gJthTD{Od<b$ze>Yfq*3f^Q}7<HT4x(I!HQga)Y$Y%%uf#g!bhR54xJl~(g;oc
zsHdYE{Bqe$VRQhl|H@lm0C&dZ88l$LB_Sg1HTnd3&Pxe{+TgRC)UFmZ=$wW;radAT
z{6XI8yr<?$6yGS0efrjI-6G!;a8(oh_dHOS+Vbhw`?=z~nPyYGvr(vIk3^6A_D;|p
zJ1N#e<-zV0X3L;ekg_}?j7hjtJx?joczLuv9Zpo~%gpXGfeR7)CQYH)K!mt5Q!!rw
z5NOp4%#CEo=mcBr#9Qfe*6BL8$CF03jD|VZF0?2(I{E%swbyV@L&tjvFJWJL`#AVI
z;i$Q3&C>(DvV6IEL&&cbc7_r%Yz3-S%V{MM`F@gi5Ai1TPN{cKwJIP9K~Z3I6df7s
zTw)*%af*5JMlJC=msBK+xBHyt(DwUs_NoVjB=qCz(vV+q+K(%>b}YaVY!CrI#hEo8
z&ghikNpIjRSkk<GzE=!fifP%Gdf1#yx6bJ$`q|`;hB76w$1#TX5%q&oWETp9*d({?
zGYPfhulM>}k9Xo5@P;&<$5I{0iHAN|TwI0QNM_`ot`;UiXA`#p2~T1eYgl}D|CeD;
z=>Em~BZWtEXuKz<anoyrK&76LAe$uGH)ReNq@=nq@vXUa?P23RqCL8`1nfmibnMF`
zR(fMFr+Tl0ix;IY-gxWtY_+9@ld2i;)-DtT7fp6OLH6*$E>QyFfrpv{@FG9H3^v1P
z6f+Q^0RhJqUn7ZNHWQSDXI+;s4;<nyFY#mI7;-nG$=_F(OO|f&Hi_<Uk#EtdRFpfr
z7&X;?YUrE@3Jp0G=UFP+TrCt$EUNq2WQ*46Am)CbE*@}R@NrF`$&Qt_YVWe3BSPMg
z63cSvHrCOBm)T80pxaoo#lakiV^h}`XeN5!aCJ?l|CHmzhXuENJ<qa{dq3}lB`Qlr
z%I^J!P0ugl$N(`mFz#^Aa`L)>$rq+0P!b><F0DVR0#(L`__u8^U!JB0@O3=t*?+!I
z+^;+46V_fqSg7s9-MRgd3vXgieekX`lR;k<y~PV>p$UYi7n}^SBVzY&-sVqC?%|xE
zVjv^>eQY54OCR!lK)VMuE>~zdDdy@sk}{^ahpt$>t*#{!V21BP>lt80X}Sx$>6QUl
zn+Qn0dVAfFgeh{AIzy$4sxY8-P7#025r3->=4oq$B*GEH8UDc$-L)_xv|1Fk`DsA;
z#0$K0KOA%k@)?tO-jlV$#>d2ITVRv=k-zL7lmpwtGM}bEk;>2-)S%mp)@g19^O0aL
z2R%lKjA<b;1N?n4o%L|bPSDA^A}qNRRj5o{;mgg*wyabr8mBqi$&C~tOpIM#N2*NX
znWbkMRE5%lpl`Mk%_?n3UxIO-H}ae>W6wiCjg0m_2X>%SS&jK=%PgFNCtfV~%3JDf
z^%ZAKCo9jrX4;#u&m%e}oTmHANW$5F^h;&k{VmSM8AvSu?!&Yy7fO?pqxE=450sB2
z(KNlE#x7>q>d|61R?wIt+3Iwm^Rv)0GWg@x()Wp<^2A2mH}G7lhQLNyGuS4>wW_75
z;i9r&tO)nEk74!6|L?g6{yq1=@6nWL#l30yJ+n{+_XKn*WrpnOdio{~*;Y{)3#5oI
zFF%VytwVpihRDcwqdwTh3>w%?v62qn-aX6>_)qy<Jee6`<ihKlmcyiyyqTLToOFf3
z%acsC6B3;61V0%=Hl!U3jNCR4xb<y5Og7ZBEVnlqPw9TVfluP<I=xrf$f|x^xF8e$
zap38gul8d~Ps9+co1`4#M@G~_PlxgTg6x{62cRX=ZQ~2Nh8d!5*%fBYKt68-eQ3SE
z|44_80_pZ99XKM(z^;%z*_>d@2437{Lp48tQ?CX2g@y9y@2HT(jc_%Y2uXpOU5IYA
zB+8Y>|8B;M$KhLqAqL3Q@r3zcBy`DBkg5355joJK>Hb``!L^j|UHGo3xGJJB$!)h0
zrW}D6A5XT^ZC#k}dzqU#)>PdyDhEbBdT$l|{t<&$GEJ?sE=|)hPV()-n<P>5#|r#-
zUoazdr<51t-HHL3(#4nah#ueHzSUTnOFl_$yPOhm|ICvF7HiBi!1B2X3P)KWNW5GE
zaO6;whr(p=tz;H%qrcJ=rASM}f83ko`ciqh@@W?o`Zn<LW0jWl>8EeMD=X<wkypfw
zr4Wr#U46@9)Z`5M4LczaHRtE?Ua8Z~yuKTqjccd3402z$mO&njDDFk%2`)Z7EK*)7
zpI9T>ArOfM=8^T)-UEod*j1xsjNLrN=Qs^*mfOOaUW(GVnfl`$Ce{S5VDdQPoYMI9
zW;<NSu+UUgZh7C$bD5O~Gq#KXC<nv2Ot*dU*qil~Crk`_e2+8enfb+2O$wMs_xI!%
z9r&pK<I~v-sn7L-;y7{!io(x%p=+JLT`_;DZL@0$9MfkgV8>+{Ues^J8jcsoxv;rB
zjnyEs77I4v6a>F&<Vn-_v(k8}ha835HhJ)1r{tgRDJ7a_XF(V>7Xss}08bo!ly1vO
zAJx!;X)1l?>Ybfz&MM%i`fF9XQp?D0#?Ff!N*Br>UR*OVcxpaf7Tovehh-Em{|^^P
z_=gMhFowuMaRC81L6_CE4}5=ELsof|-r2zBS-ciV9?=`NviVp`=afB;<@?<6K8H+f
zhWOl_62ke%@ogxpD9L&%!TeRCna8LtMqG@v68h$YF~$Ga#CQe*Jr8OLz4QAm<Z0~p
z)tTNYp3h7{r4L(nv>J&JWm?kJ<~KO1I8kujS`%63F(Iq!EUi$SMyF<TifaDp#5~~@
zGPxUcv0q#)DJ6dldQ$6pIgP&D+25aB^Q2bSq^=apMdYfPVU~VkzJZf~?Y&{sH8;g<
zhaW;tDJg|Fo8pQHFfarbJM@=*KFsk1n+C4d6<xvlH<bmIc9NEaTw}I6m>GRi_=#-=
za)?l7^Js7K>yuSk6|)(+vsd=zugGv(A&9wZ$B5r}K}OP*IY!5aubpE^z`HOc1oFmE
zyoa*+;vA*;X?`rMP;+679xST_;ZY!uc`{JYg>;V&=ga@o0vH(Et}$NLP0v9>3#(3Q
zOeIpB9C(6)2h)xS(6aNQ@b(Z|c1GY-AHr~#C$@@(Fn+emu+A4tE}Z@B<P!FI?=Yp~
zvRyL72`P}K-ueQway4H7c*sE|)P_Hc563}plseYLww)&=9`v|CJxgd=t4rwKH^|!6
z5{?Eo7DWj9h%z@LjF*!JR)>Qqvn<b~8uBgtrf4xC>!?etD-MfLKzk&E-7}}cGGjO>
z!P4OR%07e8H-x?p23xQQEBaV`gz?Iai>hsJ$t0W<801k0s|0-LCOuF}D+@Pn(V}te
znS+<!A*`AD?9l)d%e+T6!-+}o$72TMy47}fLCo5?;*^IK_P2XQ^a<42rX=k6vu2#`
zCbX4~*s51-ORg8iOrq?&aWqntME{Is-FeHnIPRnLX)2J7t&WD3+mTX$J%YgaOEUr)
zuZ=PNSF|wS@IY!I3S6ZwUps$*U0FTW>+?4O^t+H-ERE;+gW??L-^s_%Tj@_lD<+`?
zHwpi%D#;WFhi}Pt$t3wGfvtqFFXuss_*fPGQM&xF=n^_z0>7*7B{mPC8jFIUzNBf3
zaKtsH2=oz@Yz4J$)l_40xaITII@UKjl=)j(hLd}DpFzze6n}BYb`wRUUK{pu6aZ~m
zGx^W((swIl^N2jWR;BP}Eh!9ZqaUeqls$fZtX-}{=Az(AyV^SgCH<XTN0mw=E52vX
zLemvCZP{4>V7M=`<da6PuVJ3urK$uP*DdpvG#ZUVx~A5Q{+v<kpAK(Z=CN-cd_&wk
z<B^5^fD?TNThiO+(BbN;pKzG2#PD+pEo<~k{dS!p9_3NUMe1F9j+oNd&m3-QqhhUz
z-sB(;4NkSRbc!&^u*loj!Iy~dVVwq-@ZgV^J3NoHRTIlq6A~$%qr_t=sUOtNIO!zt
zkjARKhO0uFuYs3eolU!IPKmcQ38h<V6N!SoHY|pk{|0u>`Smykcsx&-zs~#*2ydV%
zexvjk`ci9nfCTMbL9|@THQ|M4i74K7F@+eUloJ=}V0HK`<-m)=d?9%$M=1z8Ba(Hn
ztpJs5Vm%4oWq66x`nXs`6m3vUCXnLrlFNF4VH;x}-ODGR@L-1v>}-JmeBVUE&Sks5
zMa?@0w?+R!+ck_<p%!a8op`nq*Gi`c^g%-piQNOQkLO`Dt7O@8UY=6@>nW8SXVNom
zp|y^Asd*ec870gK%Ep;)(S++@pwz?(OH)tyfLj;HF2iTZ+Qo33(qT$%nbn+s%xVO|
z13SrHO;<>LH#3tz3}i`6flru2m7|!IHj$a8qP0nK^98|w()lnRcD`yJ$#$Mhm4v#f
zK<9=wt=OrkwoS1}ub<qBJe9!J@aN{c{DU+n)_fni=-h4^E(t6~In`SwwFv>s!z`Gr
zG9%Z|Gb^rn5qjH=NQA-tSe<PQDe98fw+cRiST>3L{f`wc8WBwyW}R})Pq%~m&q)7k
zUj37x@!P+TH^c}Uzq#P>U^F&HV4OL}Q3wvZ(CQdc6{p9ylA}vj+^tiK+_8POkA$Uf
zKIo#tbrRzuPzeDWKv;V-Hv$y568K^J!3AHmc}TRr6yxQ<Hsh7U@lug`bKOL1d|I`x
zJBAfn-|AMIyg>cJ%REJ}q&vh?pPH|i9q(&wg#il|l3|!39!8%yLp(2t#rc4=miECa
z*9a-JEK|V&=p*#8uEnGURlvc&oD{E|csU4k*w<gd;&0nSIG@t81{+p1n8mJzV%y+q
zZ@F|$Qx8Z({gOPWKql-VWOsC<`-Q4vd<Ah_v3eQF$+ioG-iXsg<_5EUGZ?1OW7zQy
zwIq?RUpFNt5!jwxlcjGAn*RGvR70B$K@m$qN~{atB8r<E4;|KEbdcq@^nl(qQd)o;
z4%?hn>U8qb6D}jn%r$cL1}k#^T8hsZ9^~3Ksr|}}vtfeBMP%b}_y2G(nty%Kfxx3Q
zv@a5;DgH)LuGW<!w2S-*SC_6~mvBdQvTaQRHXHm<;Jqwim)u9gwe}ZbaAY3G4kf}E
z2NhPxmiRpmhn%7q?Xbu@8oWi)1Q_O`f)Pid?5X`o_XQ4<e!D62T@}mzpX-b&mtLY)
zv0qJ-Mr39Q-Go{Y$QYWeNoj6VT|}hq|39|gGAgdM2^Z|frEzz62@pbX*Wm61Y24j{
zG=vb`-QC?SxH}21!QDb|$aKDQ&di#-?%(~hR_%JL9;w>r^wUnZZFc(^zgHTWq98Hu
z#!2EvL}5SjfdbfMZXH@zDi7GU^U!8eQH-x6%X4N=`mivFSKzMk-eqnId&)X+R*aTN
zJ=&i^Vd<@$+z2jeBpq@ZdJ=(U5LLpFk4{%rV!f78wVq|S%x#7^J-8B9JcUWMSwOW9
zmJereW-tzN2;CF5{Y2nD3D<-ktt@)y_T4MzaW*N-XpNIWrSkVQ8^dI`)8+y36WTu=
z-bZ`5o20#;_Z3};ucyK=A1ja;1wbVb6>tQWKrXE`zgQmnDPE#grd;hY?|T?dM8mP`
zY*80#WFFh~Ji3HAxQR~|Z{OTB2dTEJc<&OS6CNV0`Lj}b$uxj6O|l{fylt#^kvF{_
z!-XDyc%Ee_3z~@SG@~_(NS2G?<1b5MJv9{lMmwNeV~ALj_Kz#-?zxUs*WF=VUQSC8
zw{ppqP^hml+r^^+cu4woWg4}v7p0D%@LQS>I2Vcjs<4%H%EUh^;TvI2^cF4_-<UlY
z7PrYvCJGhx%m2Z_e+E1!I@VXs+-{~K>ENspUU%buz<7`h3iF;%!Xr_4qU};9J!*#)
z^-KjV4a~QN77muRhDoV~s9L?bPaX(q>>!!8RuSr|&Uz#@4>A1io3>S&b!**0ZqgbT
zWWqD>luy%oU8?F<Q;<B%?(Yv2-dsJ<{x=_~{^sLP_IplfJ}OdkNNqB+r^BRt(IR|;
zN3q+|g5c{;Z`1JU%Eo{&D-0T+T!jLQc8i0RM?A%gb)Vl+t+HO2mYC2#F_(qt==|EJ
z_01afgYeVf7;{M-bBC?#_Dtb%wI<C2DjL&Y4xct_Py3|Csr_V&YvbhA(i}g_!w<@3
z`~LK<P^+qm3B6ob?nrcZSS}6o9ke>^jFR`l6#3}8(R^{Pp9Mog1d5U8RdwSxTwPu7
z#qo~0vlsQV*z~#5*OErZ_K+53)U`4%NfMS8=PIcE+Lw16pvyH+Fe<v)_FCq5dEi-B
zQt*j;3j54KAI_cy7fx5C#Q{D%pcKW3LZ8=LLRkkR)vg4f09j`uFfw4>{z657N{(>J
zy^)b@_XhmQWDw}7w(Lo+H8h~j`J?{>sE@OAC}-!R$epnZOmkf`??$oboq@!HuwMQ&
z)|pGd+DFj9m=CKH9ND{q2Wv0?`^>AhmyUlr2tg<=<@7h`O8*8u7A&3`O#97{TDI@I
z=a-@k`tkK~BIzwgIhZQ1xcMKug63f%ns=??k(~O8!Nuw;NX5%Al;P7F`Fye2f%rRO
zh+AaK^YRC$B7d&B>*W`PYkNOevL>Aut}9X{r7B3!V$0Rn9Y&9C*#xZv6uC3l6yZDV
z1RTTI(;Rk*)Eh@}!jnFOb5aOwn`Ocd7X9y-@h&WSSS6=;Wi+~NNzay{E9Zq)4c5VZ
zl&}<{y>j$Z@PeQjyDx$gIJ+w930Me9PYUe2op`%=731Ti6iZ1g+N?FK@9f|58pDn7
z5m(Xlw4vS8kcc&NO60I!?85j@9D&Ts;|#eoWMoBC!L6-UIdPg7@mJ@x*NGsLweXg4
zY#c@*FGknOP%J*5Og*LG@^kIZ%nfqK?;UzGI|s?%&y;IKmQ*;{zP{#@liMAMJp4nT
zX=2UXWrpt5Fh9O_Ld(M{5<o-=o$965NS2P<Ir_vs=^~LH;mf*wz_Cb(K6+^!fus!z
z8IC2x5za_foLDk9P1xPV53zbMA=p=LGFxA_R@=yD%IMQ8(ZrO4iZwbLml~W{{utBy
zS;7{6HvQaR*yO$GhxA?Sh`+=qCsK<?L=z{K<Q*qcTTW!AwA-57Ecn7hX`S;_bWfBj
z>^s0wX%bdVN#+8ji_TfOPRPkNx;Nw2l-!DKw$@P{I@3{mn-lKxj)E50hA?4LFQsDp
z-WdALkwUNcJ6c7ccV&)+csgyf{=3{ifbCX-5lLSWnJvN7O{4|RQ)))-?J5PN?$NJl
zrC<Hlcv%yg4uJ6E0>r;m`bf;25~#z}u}5C(_qZFgjYQUs3|M-E(B@|S*A3Zb@AH2j
z9vnP{uVy>!E&f$<K)G^;zZK!Y=wHy3w<Oq?Xavc@T@}6jKJT>r$yG$*Q~`^Yav|r>
z?<r?~H<XF87f@@4oL%KhJPu&YxH{O>yuif#5tdu`V`cK`gJpItL5_EPn7aguF-KnX
z4!Ec|MYJVU=899xMi&e!&u*!$HI~_lMqAo|l^zCEvF^^D=5UTWB5Ax2T!M?nWh(!k
z6lc9V2Tv0JAY}9I^n4c5w8HkZBjBk16-vh_8ecWr!86aBUolLn6Vd`@834bq;=>;|
zzBQGBTRag<i$9LCwx99zC^rcXsp;!EVE}{z4KWbeGp61ZYtlK1-jao)egLdQoxHaz
zYquK5rA<@iEtC+EgCe>(vN@czNFcU2-%F>S-xGymvjt(<60d#KU+2da(+k`1?`r!L
z!)~on{jyHKmmm_H&9EFF^!k;ESiAklz-<0yU^absWcF#C_Nh6FwnB_m9yT<HNx12!
zqMXbypO|-u<J(9n4M%eO6%(rFx$?SRS8AxqsTz)Cv*R^}Qqj%^kUk_L=sK~m!$w`P
zlehW1+XY@+tX$`J-QN`4UjI^FT@jyGOF%zB6o#C}vf7M{mdN5KM!82jAA&U09u5yj
z(i^_5FMSKi%Fs0*1M}Z>0-cyjA}A$*SZf?UE-}XOWZpU_l<rGrT<cN#?*otHgsy%h
zRBw$e+!}6WoUCjPA6HrNZSiLGYbmBOA0Pu+Q)cYdG%*mv-JfIkl$=k#PoLu44C8%@
z3EgpZ2-=9fH5-*0u?h`ruV2aA#RC_G!qOkA$`(<Pw2SqBh;&ZZ70;NsZ`DFL&z8hx
z=SV@4N^{3t7E*|WZ?|*Dtn@Ux!glo3w?3%v?`+uinJdo#hY9Yu?d$jnwH|h2IJo90
zZ9V-uqYzvPxc(o>bze@i1#Jqx!M;92|M~)?Ez^Cjwz0-??%~ui51<Q7S!gI&M4b^)
zjhB&8fG@3-I-8x`i!O@wK0Ox}Q+CoThqF#`+3bDBq~ay)ofU=3ghUU>b~Pj-<94n=
zdFeex2lyaPb2so9*AErsUb(e|M-5C&$Yf0#b5hEr<q#uRTksJi`{`={;6hENxN=_t
z!%*!|tDbEMNx}-AVi;1zs@8<QmD=>UP&q;;8hkuXH|+Q{csx9uNfTB8CzS*2A;-5v
z0~55gjN<N?s*V)dxx0r<Tyo7nq~eb7CdWy9Zani?x$W(^fJy+mF1EV$3Xo8)#2C-Q
z<70*Q^$I3D$$5<`_h;$MsATLCz+IL)-HK(&i)SI=A4PUr&s1htW%y+B#)CEJDos0Z
zYKA=pTIVGzt<c$46I7tRrf?^lB?1~Q5s|UaQp<F0BRQQSy8F5LZz&M^TMAy#AFdvd
zGV_oMIZ&mkZ3n4U`0`}oJ<J|mzj2MkOUn9YD5*|HNi7=#iAo0<x~P{!M7_gLMU$@J
zhUDmn+gM9QiTLF?+bWflc_t;B2)_N!?7BSNX^y^g%>MP|7-zCZUK2H5sx4C&XLb%3
zYgA>|48$07STa(`JN9##I{haMk5vPH`|c6Y$CMVEGy+H*B8;N2Rv=;?%QWTO=qvlK
zliywB+QWN?bit9SBB`SJayKZ!L{@zr!RzAubVbW_^;p!)JI^ZRjggD+Fy9Bk6SXXN
zGCzmR%|?k`qE&rQ))<LF1fp}ng!6h_T;xC-0wOG?MLehK!Lj<ih<maaJwcVrLNUB=
z8(+D8;BuvLd8@d?Q~g2u;$AC|Ci?ENgl%@)V~Aqy$@(%X@7{HW1ome1We#G4V;Q`2
zJL?x!ouGcw+{SbDil}rd@>l8s#cOo`;x)@?SN&I5yyIAmyOth%+r;tV;b#=gt|$xn
z35xM&lhibrxJvY}2ltpTT}pD1`&y62*0Gv~)Aq21gC=t3V!DeOZA7{oM50WK;eu+x
z!_`Lhmf8M&$@nZ9f&JNv%xEjN*JO#Z0fG6!W^$+_)Co39@q@|s>DMa<i`oEV%|ZD*
ziK*bEw<o~tx1A9<qj|P(#`(<KLuHAgF)+@i&Q`0%H;d%8D^U!TiDCkk_lis6l>nu>
z^?i6ZLkEisRjX(5Y}2i#w6Nr$U1F-(#0l!2RWEz9ESDue0e-<+{gw-3>y+B-TvL{|
zcjHQFGcr8H?|Gu*w$m9EVs%F3f{A?88%KW3H@ql~>EV#F#Rh*Kkp1R`B%!nc-|N%r
zGz%8egR9Up)tOJtcQ+3yIJ^2*x>uGnH!{P(@O4A!EL{77Y`hiz<O*BtW^{BX>h)jY
zXEt?DN-lJgZKv{Qg-)`9Fw;V=qbO;p9=|O5qtQLGB>Hi?90HJ>U^LAG>%W^^XV3z5
zgpgw3&CoaCRBL~vdIU*o_Q}UzDFUWbYdJZi30CyYy%*n4FK_<Ym1%~QIP(N2nnreT
z%m~2`-6%Wp7FP-PC!)*J`4OU(fNf&z=g3x8R+yL9@?Aq>;SCZ0>@?f0aRb@e4B56&
zCzPD4Q*&WADkxU`cV-r}7OTEc)HTafl5u3isbp>!(S4pn4S}I6u23x&OlbC~klRoH
zMdO1$gJroy{|(o&y1Hg%k0s@-A49kf-zAcpLujX+0o()Mi%gFgJ(@oqc*N~Ll(iA(
zD|&dzT?eJL(Bs3&Ti+lla`MeWYPcENJ<KN!6XCn>sOHgbeqi+4!Hu}>@bfnP`cZx&
zW^K}f<kIGPCw!97QEAn(p!^sf<0Rmg`k#dE9n7Z^C?d0%u`|3!<AgwS*&^~1?RR6;
zZ}il!@6p=QZ@?`W0GY?F<)N=&x!4f*@8y%=EkQ1|&M$Wbr}R@I@)l=8b#gXTGJI-`
zzNE3%iUn`0VY0N}7}Z_;*+S&yNn}IJp@--w<|i=J%}vV{f`Hp#MbyOg3{iceEjXto
z8IjJI5WV+yt3$KQX-3>VqOOQfjTj<b*1o=o_rwQmGR<CrG0w&5byU&VRB1n@Ys`@g
z(WMON=oOMPwm2g>mg`5TzKn?O1_*v1;G^VC(I&F_lw22&b9s<z#aJd?AeD#3W7U^~
zZyp<=u;qK3G0jIP>_B-02)7Kf8mf%sRwi7K8SV`5vXjTV9#$Yeb@TD)Y2v|7j4N&(
zHU7f-IiS~V1QtkS;XTm?;<`KrXnw7%@vT4lSdRoYOO4vxDdq&Ay1?JuJ?QElA;s^Q
z{h&8myo%1U-j1IC@`QMj@L!<W{}$cz<a;2r=&mCf2zDC>Jgy@ix}G=@ZhQk6eO+kz
z&d`#EZ0~J9%Jcq>s=LGVag-VRk38IsZ@elTVamimk-6Vdxuys8sRi1jBz^uA909mB
zM{)UdkXCYLV;@$@Mx;|;yED-9MYJ@M45q#sS+SBN$S$73N$>+)O4Gb#EAkW(8A>pB
zDBw9~v(d8JP<&XwiKON3?4bM8e7fjCOLhP$(Ey6>5xjOQO~#}P6Ku+rVX>Vn5hDfl
zN5;4pJe%^z%;(6rjjm}<xteL4UlEEfw)6l8$UfUBl!CzBP=Hg8Fnn}*af+E~R%i64
z_mg6HaHYy#&6noXN}k&FA^++a)Dhncht=D&Xd#zxHfP}VM^t&9U9ke&2%XuuuKh%&
z4}p>K)_^s<i2af+oo?lU;1lKCpZKjqwG~2F*HWwJXWzpS#_RZBxu5wT7Y9+&t#6(F
z%vzGwDE&v+ZDP%6Ck5{yb|3Eh&iK3ig&2O3K$H%8gkKNYY)Prh018RKvu)H&D9Gox
z&1|0hv3cE(K6kxK5ubn;VF|{VoedG?0jGc<J2opxyGEX5M~|w@89lI4v>Pw5Rb09;
z=GC*!iySGbmv|1C&JfF|z*ns})PkZhb|jW`E*;3254&<`up1WV-N>&fP|P@D`QCBG
zV>{Z<>7{vnsr}@1PEXVp(a))dVKh)T%#_^Vi#=d>O!k0J7%uQ>l80!$?#%9NF8SC4
z+?B+)uVx3dZKmstXv03a!kiKJU8A+lhAYJZXFwMO2=FN~C*u2#G`*R(X@<Z`H|f=V
zVwX`%e+A4kEiPH{*n3_e)qpEceV%Ub<x|+;qFWxV1;|ZOQbzO;j-=x6%PyD}iF+&6
zDLQyr3Ni=&@O{~O^SBXn=Qr!9)2WOBC`l=$u;1wu0_LDceY}JAWKafTrX?+S=U)B-
zWE4zM|5uDbDizpf&nu234iVuh`jBfwZGb`~jz{v=YhL*I(vSX_Odq9#OA|se{*A5o
zGfxkD0{aT5uI?@r8Dd!KR-An*<`YJ|R9qQBZf>4=S1^9|n@v@k0u=Q@SpXp@^ahXX
zt8)g3=^);BK&R)7{$=z%?;yArv}&;+$*vl7z+UONG&a`GcJ66^*J{!cDr2#@KqT5X
z$Kio8I!qmn`?A6%JV@5U1_>VQ{n@<!ts!_V5Ap+OjPC{80K5*PcKI5Dt$9DPzA(#-
zu@?($jP^1<d`n&~RNy0<FEphSbv+Hg_9pqt>YLjG7yn_<I5$SD8YpmI)W?FdeYmj4
zPS_qbLY{}ZR;GvV7nyzj=;xi0dL;)k8Z045@_<eZz7N1e;^vid(f|DY!Ob63Q!g#g
zaH-Br2OP(U4R;DFBC^Y^>hC%E8n;Jm|JfU=skgSgs-<_K==c_mlLbw!nip<a->=&%
zUoanuXYN}{Jl4!yNLD`4>sG(#86hC#VdQZiz*OG>SdWc7;Vv4rfn`CDrIN)2SSuET
zb>BJ1{1%+iJa4Ib`YDiX$iC95zy0RXI+q)^N39W-H@f^MmHMH5`<N3vS5F)AC6vkq
zfMUw*QsBM5H#)kNx-A~9bW};4L`tkG=5H#h7#Aq+r;3wFWX|<zgmt>5gWRSpG=@*q
zxeKL|Iy@@O(CBZ=;M`Drn-yZE#N(-9vz^rt#Qxk0CtyN!2$#wuShP&8bL-cH=o#pl
zjIcRomB?}5=K2J!nUE^5Dyzm^!(adf!Q6<*0_a?_%q~2qSU6KSxR6cpq4pyw!RQoL
z@LF%{9xX)|Q+*;_FujkiP?8fnXVr5I!+=-#Gi_k1nHRJkf8_B?#u+(6@h<7*{bJ6~
zJ2~b9<9sJW0>4WQZgPM5zF_Y{cEsBSck+Lq<(xb#%no>}m)cw@R?j+~7KVRm4+?&^
zc@Up!ZuYbboG?YWnW9Blpr~2<xT}dNd5+z~%CxzQn-)Te>Qv}JzPhKw*}%GdxQvys
z5^F#4r9zZ&P>8i(xV|q|7l1qVlNwcJ>?al2kjD!4gD6Eo@HzKM@<HmnopBDJ`Mo~Q
zD$)5e<M4ps77wZwhRK*ihuMycu>|XSF>K>>>ibYW(ac5JG<)Hc3MuB*B&T9Vnz9jU
zGA0hJn$kFqG{>*##5$pot_G&eDNWdECf+;(CDC#OmlS|+G~uBfoEXN5&oo7@g_c(7
zh*m}39I_TwlYuLS)gqIyqEyzfyL1nBlR>BT@awFLEJ#{Igoq$oX67Jlm#DDMI6AGD
z?bmCc@Skm{8b3mh=_p@BEKu06uDFkoxMM9}tY1tud0>)4>H_a2*PLO7s)L^p@8A8y
zK=A!#koh{O{CS~$8y`&f>x*qG`{(A`Na%u7Q+KznYc&=%rHAdo2rD<4+am`39?n)t
zX&n#qIegpg?DBa!Lksn$-%hn#(-%0qM2uL0%(-YYNkclx4l<sel?%R+lX32=pLrg+
z<YfycUcuYE@fv^<zxsBGDa{LYL9?X>7oX3GK-p8Z8(1A-E8sNP6&AoZsxuValO7d~
z=3FH^Go3g$@tx^)kgqfSS0o<h6uWk<b%EeJQL-=K2<H)5bz@o#Qd^N!rD8#GS)fk@
zau_qBkXc_|`JX7--+)NEs@SttknRxqIr$vrc!VxHJ`Vc_mDOR-w%K(mSD|J%RU*6R
z7#y8;G_FVz@31{X1fkL3&m&s+Zew$<bfCat>@5wPU%M<=QL-82pN&17GMj~v`mT7)
zAv=rx_HLE8gR6!^I;;6)4mnyot}-XDCI8@!&(cuF@_B<qgo^_5mH?vt=Q*0}w53v`
zEN)<+3nFr4E3OOVHOl{VEmiqr!+*!`#2wxg><%$84}<T<K{2A$<kvmPCA~k~MbLN!
zG*WkOz?~EtRaJwy(>6&1kHWu{E`<i_<6GhGr_$<yjf&W&f|i-jGL7pgyi!SN3<;O9
zvA@jA*jo89Xswd1M&U~dJJqJ5!wLq&u5M22y1I{+>wF6VJC<lXsnajS(tozf{3V4F
zd;>8Ms~kcV#PESViK+`2-wizFPB<MwDTqLa{G<xZq}>td4fWzWpJPaXbH0!*;6qO<
zTr7#ob(vTiKE}Bur+#xpqvT-rN9*E3H~;IB<X&Ze5E;gthpc<|0@4$&FvB}(V7YNB
zp(0-lIq8z*>F47h?KVwG%+qFJxDkxt+NV7Mi1}GW?wy#IRz|6ER{)UG_TV6S`tGWY
z-aq)Cz-kjhB_|(EE?>(0;J!hn(OV16;~>PqvOt?kUFTfggi*6akykj97T4z7ZNgx)
z)9F}}SkB~KQxIXrQm9*p8NiX*N#X;QKr7snIM)c&oQADCG17jUKI}08ZWUbF$~E|*
zwFQbXV**L@f&tzADtqOl=hTBL`x@p|B_mAYy2_OLIyHNB&a1Ty)lp|vB#5`?mWFP9
zxY*Wor<b|l-yT-;a{$132gnuS4hh{Y;py|m5i61T6iXUXXEbYHWsI_O45*0~k4B6?
zH^P!6?Pm{HpnbX+ZUj;JBOY6*NIgBsV+8c}!$Ce3ufq@Dh2tnt3<j8>hcf{)6v$y{
zP)lx>3iI5+o^DP56K#fYy0+*0X8~<<m1R?SNE|2kImAkb3vV5fL-#{+g47yGgDt3=
zbL+T4|Hl?wWP$xhxDMwS44CVes%lhWX}=-EoQ;eBFi57qJ@ApkeH~P|d4=Rg54KLj
zOvc8Q=LcXYj;52(pWHU&yiE8%7Ubkk54NL?WNg92#TFBmk^vj#Zg4JZegjQz@RS5H
zP4kViPn{r+<)q*eeu{L1WSB>EN5^HK0&{En_NXO#ukW@K4=cPDjOv20k>6<qlliJ;
znmt%A%-S!$OQ)^Nb(<W-F=zTZ^nY`AwhMT@oO!)D&m%i?JKZuiW$AG)`>gERFx|=>
zp|V%_y+_at{uH$c<#h=Bh3W;Ld{m--n9SIVkx^PEGm+peU6TN>vH}re!|@udM2^j;
zx1{eh2+cq57U&Gs<?GO++gS$k8?;>ms|m{)Q|WPXm}=sfEL_OVi{M8RG}2zj1r;bI
z#Ny+P1;-+%aYgP_U_h=S@j*KY)7W_f0MhOgZKabd`8)ZV@2l&G{*2#j?%uFr$!<F0
z!8(76Ils7qUWof&kBbNN>xYhUHNM;bh{8F<HpeUL8Eu)jLc-@pkQ3)mfBW37ZoVc@
zlyi**X>8%aX{f0qE6Fi`3A`i}*UEkyA()FKxBxh%GlKUsyTaZozT|c|qk1Q*7k6H*
zRuwG_Q{R3wQU;JArC{vJgzI^Gm@WZEu%;iSnu`Lwq1{1AMSR<Xt<PtjSi$>I@Egd>
zNMUu-Fx&%BW4KF^<U+nht``b&XwwnbHjuX9tlM`+WI|eS7-1CkMu@H7D|**)kCgNj
z8&`S=H4wUTSn0|;O}L{$HvPNJ4LehZ!8HwSFg|t$?`u<0n<(sEsDj;s5K&1~@QIg%
z9bks%-R1YE<1X2k84YR76c*A>JNLPjGCesLKiJ)Daj5&~<W4k68Iz7O6XuR<3<r{Q
z4|h9pk`7;7`TIrZ@oW%K6rA1RFYG8^)m^=|rbXZVs|gX55#2O{ChP<HLmhNzt3#sI
zXoXQxP(7qp4BO>wUnak`ojcvXe0@1xurGuM3nl<4&$dBD<=YTrz*`?(`f9q70Sn*^
zUbBN5yEon;OT20p9mMhn8Z)X8*_Nw;qb|zmQ0wP)JuUT_5ijatMkRq8X(}`@F%$g{
zx>VX!(w{WF=iFO_*Jq3N1utZ%^d@qT6x2UcsX|BUt0vk$1lrZLT2<j2N9-2B;aWNu
zrp6s5X<u`BxTpg@>h2&jUE4Gn&xc4Mc2c&l7Ka8I>(#@%5g=~`fG*`-BU|~}jYK_0
z7B5u`WHiN02bPYP2Ab*|NNi1Wg1rL0nxj8$lO7b^cvv8h!fy-(Y1v(KAF=NSB|<ze
zkrS1HzloeODa}Y{KD_C@Vl37W9-M*h3Hv@%{`<bjPmlby(*6#p(?eqB+-UgJw07}6
zXuCAWD(BD9KN{AWzoN<-&!L!csD@QqG+`7jUY+Zk*_I1epFY8sd|m|J41Fw-m5UxA
zP%%?6BU}?uYQU25xw(gS#f+;OzOaF%l{a%I72c(<{B@yV5EP1t*URXlg2E($GD2oP
z^9-}ARH2aZqg8Iys*vO!hXDc&hE{Cq2VbiBYsOW<V=n1SQsbm;QFwj}UZq_WYZU*;
zD!;Gm1}7t2ZJGz;q~(}0^voFR3?~@~!tRC=T(f+3D==KkKz>Wb6;#Sg+OyxWloXaE
zrY&FGGwR!Pfo~4d6rW@nYr|+drgG)1-U4H6iPf`eLgAzmPOTyZq!#eCQUeL9<5WL3
zNm|5JIzyJ?s`m8?$2}78@bn3!wvQGPeGg8uazD(I0jBPLwciEQo%h=|via+TwV(!?
zAw{>8nRhB)T;(_2yTbL}L3nL&#NG#oV_aSQ^YgnB{nbc%>p$m0HIf!^*kA+Lz)?Or
zK-*X*N(fkvKKg@dmjhfWN+`o2z_buYgAQoZG!4kq%yl7KGDOU^6*U7|55$If2V<H_
zzY`4=ZCsu`6G&dwX$B*E!xd!~31zDkd*f3l=omCjacb_bu(@^4yxq!%!EXRJ?jgis
z>cCWTjmM^Xf7y|gO*_#b=YyZZn+zuF;O`ofZ0-Eb^k)qiULq@L5oyNTCmMx4t;Vs%
z#=tCTDd@x%ISTTkZ>UTmrA9czT2$~LFw&GZTsg+lJqGTa<tv}7<raq3xG0CnT!tv&
zAP(9xAE4~wAE^<|4-%(sbG_Lm9;MzHEDCys+qrh$KixL27IR*(44O>ET|C?ja}6Q(
z8^sPj>+evOaPGW-*w48-y=gpiqbOOGJo)H<-um&+`9B$n@i!weJbPn$Wwvawfe_C7
zk&llM&aQ}zrQ#G}5TvD$l)&oUV3-&OL%oX<PA5yhuGuO!(fYd;HWvddZz+@+{2ObL
zc(eOdR$7gY4m8q>N*!+^mBByS@!>`t*8Qdw_8gS_XL{XjGWa9}kxCI}wGlX(Fm7d}
zN&Ea($?7<E^CKuU{^T6#!hlUUyZ(uwy>VIM8Pvs?(S489(_{uSmIwI2OvzU&QF5v{
zLV1=mTH<tt#s2dsxzMG?(V@0YT1zxH^>Or`6gpBIp!N6u{VHTkio2o1aQ%Byig*)*
ztt%#WcC%?|&~0?g*@E+UGPy5G2JaABWW{z?xE~{fpoBczp997(;i|aGd|HxY_JnBx
zpSHwApI-a&c}_hHGr0xOT32ub`~g7)WDGLT!<{dvJNGe1eJ%fZlJ1rNc1?efgHJkc
zvF`uq!`;aEDfX!!S?;|t6ZMD%#g-o%;vdTAt|sZj6N7e<6>42)B1mD52E2P}KCDVL
z?*XMGv5bq18vE(QSqbBHlhd2Un2xhL^zk!4)|!T#atvF|t>;ok)re+=Ij-ZUeZ(Ht
zsiZT%7;@Hu%lP?L@a)5rKwkzS0WvN6q{F6zCys|k=?ZGVi$wjjw*dbVLjs8kddFa4
zXLD@gcUgWIf9iFo5DD-qy&|`i5;pj=s$K+boLpdWe~@{aD}l<91B~o6y;afZ%~)E#
z*pOFF5Y5x?=(E#v*jKBs&P!f)zk@2uTijp1bX{Fl3+Z;5hK!}tsez-tb)2Sfk*iY<
ztw>??YBOEc08+{r21TNaz3dm)qS3-vw{)m6Bn}hkCG$Te<UvCi_VmQFF2t!64m%=$
z1)tEis0hj|3d?(r$IQzZPtjmP>gtC&O?$9Yj+8F|de~jHyow&?%)eN-G}F+<IBme=
zupS4_os2MTc!9hU^r_|KU>Tq|*BF%^jOHThXg0kX?kRv9Dyyz^tF=g)my(|iKzB;+
zfa3-6dW;@YYg5uy<`c`&mzft6?P5k^Vk(*k+7;p<?0O)`b@<OTi>wpti3BWvyZYYU
za8(r`j-onXQDxEMxK?NJg7o5M%xBy_FFnL57nfHYPkxP&iYJFSj4~DHgoK|Ir38CK
zl=)Tz&G9pWuk<Z1U%yD&=@q9_=c3i>Iq=(LrE;jDzM)<ZPFv4_<W~1;v$BI>i}XFJ
z@Agp&G`u&HhjH-Rg0!@CNvMFkIt#p@Gr2KG7GI^>dr;{wb)zxn`l<k%Un$Ao0naJM
z+Gk1^0bVa|BC`+N*xmn-F_}?+BS~^M8Z#%er64J)g8K(2tu3;6Lu$Y$&O*Z^5-#1a
zoL4^@0apUS%J~bDjF!~*4wPq$(FqH<30X`Fuml5AWXRf73xR#@z&8n_x49kix2;_b
zW(iT6s56KMycqBWd|27NUa#mQ3KhqO6s<~3`cVy%2)yWVQlwNNNRZ8}of(IPN&i2~
zGaH-leP5qas(c*g9iA<Q@d<2~s@MSEtvfmv>35<oxZ)%G&B~8e$vO<mT*&DUe(F)3
zG&MK&Yrw^^if4~3yKS0#Y930$E2shN(oa4B4qy#fS8$)L-U(DU-kP@ArM&r=HyuvK
zW%NMl>GWi^`DyqT<L-2sz^B>cl}P^J{iU+ez9-BJCuY`=up@{=hP%?Pbt}~t?;dt)
zj9uR9Dh1#3!YxKeso&vKWV0W+Pl5XJ#?Wx)IfL+RVbasRl;4`;!M~2r|I=gJ07s2v
zZ3+?XUHZ&=uCZ)X%`wVPjsXsXsMik>0qQ{<)x{+q=zdOYDYYPUZ0m5N!o+z+bmI;x
zzt}vw0zvu{fo#*zVg)9AdoEklP;iFaGP<Lket`4nSju$X=6VAQ%LtjqzIUGK`dJ+r
zD6KT~yfqTsZ$U)Lc+3OmaWeYrc3I4-+v}ydt6R#Pe@sT?4hokg1pHEex~%%R>>J>-
z{_Sb~g6px&u<e#nAzS>lR%Xb{BC2-+-GMx}K)5mMMZ&g%i@cT%_;t%rczEuqxDDUB
zdN}eeTIm}z0Z;!nyNagpy#{Zid)_zrr)zDl9>3@4b)C7o6$VIXW<@)H1~!Ifngu~G
zH~m@cE;#8Fy1j|GU6cQ_k~}RUy$VlDd;fNPF*V#<frXZ(CN%sIVoK|DK#ml<*K+lS
zElAt^JAB6#i|{@-<!0y_Qt8fg$?Cwc)CFhe@CC;C@0|Zv&Gq=@`tJ+X_wNhkeNoPw
zjXBX<*DtY$Mq^m{9cHATP@qAIzKm_lpbi^Ug#bul3gk2iS{q0vmHg6^1}2`v3ic7@
z%m(Sn^igif1G<SC$8mGt(){8tr*NHnN2ytj9YHFCpLXNs^7XYPD$_(%ldm&oHMn!#
z23)D9Q=ilISllJHd^l8V)pbNInnuaeX~hyTzQAuqwcILZ@lexB*(3b6&IV0RqSX#c
zl`==IBVPJ~d-Z(?4*|Uzjo$|Z#awbuH0okO8$)RZ8}&;ANl^DA8!pr|WHX*b9gjqR
z%1QMmt7yfjdgQT(d64^{kgeI#+mt&m#-RAaRV>f4L;e`-fPmw3-}!lf#irLo=<VU#
z%{s~sxLWn7m_AA|E?C+fq`uU`r{oQtJMohMYpk`Qz=}J<Nab#kPo1_0=jSg%S9NzS
z{{d4Cc+e*cdb!|X_7Q2q8%_hAe-2(?ukL$axZ^v%m`K{0B$=8HRo!OPhxjBP!|~=@
z*7puNKx9dn?uPbVU|^<e@mCGtr-8?)6iRPV>BLW5!b3y{TyaC~_McZJT4rmxwoP^L
zn55u2k{UR5ZFcdjQ5+T0NZ*ThuMroXKE4iY+`r`5rIh<c`HwvY7LiiAk!vPbB$g)^
z!;R*Kq7zQKh|&|lqI`;#C||Wkp<pMrisEbsw7{O&ByTw{BH+@cxib+5HNWp!)rFUV
zd5%<X)dOEiu;b3C!w$9y8b_X*eyJ39X2yqZtC%0D9FJ!+sTgMo<k~43Xrd>NP7_O2
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
Ve?A}dZ4dkJs-dYt`Q>|${uf4b-edp(

literal 0
HcmV?d00001

diff --git a/docs/handbook/tutorial.rst b/docs/handbook/tutorial.rst
index ffa8fa01990..bc433992841 100644
--- a/docs/handbook/tutorial.rst
+++ b/docs/handbook/tutorial.rst
@@ -567,25 +567,62 @@ Drawing PostScript
 
 ::
 
-    from PIL import Image
-    from PIL import PSDraw
+    from PIL import Image, PSDraw
+    import os
 
-    with Image.open("hopper.ppm") as im:
-        title = "hopper"
-        box = (1 * 72, 2 * 72, 7 * 72, 10 * 72)  # in points
+    # Define the PostScript file
+    ps_file = open("hopper.ps", "wb")
+
+    # Create a PSDraw object
+    ps = PSDraw.PSDraw(ps_file)
+
+    # Start the document
+    ps.begin_document()
+
+    # Set the text to be drawn
+    text = "Hopper"
+
+    # Define the PostScript font
+    font_name = "Helvetica-Narrow-Bold"
+    font_size = 36
+
+    # Calculate text size (approximation as PSDraw doesn't provide direct method)
+    # Assuming average character width as 0.6 of the font size
+    text_width = len(text) * font_size * 0.6
+    text_height = font_size
 
-        ps = PSDraw.PSDraw()  # default is sys.stdout or sys.stdout.buffer
-        ps.begin_document(title)
+    # Set the position (top-center)
+    page_width, page_height = 595, 842  # A4 size in points
+    text_x = (page_width - text_width) // 2
+    text_y = page_height - text_height - 50  # Distance from the top of the page
 
-        # draw the image (75 dpi)
-        ps.image(box, im, 75)
-        ps.rectangle(box)
+    # Load the image
+    image_path = os.path.join("img", "hopper.ppm")  # Update this with your image path
+    with Image.open(image_path) as im:
+        # Resize the image if it's too large
+        im.thumbnail((page_width - 100, page_height // 2))
 
-        # draw title
-        ps.setfont("HelveticaNarrow-Bold", 36)
-        ps.text((3 * 72, 4 * 72), title)
+        # Define the box where the image will be placed
+        img_width, img_height = im.size
+        img_x = (page_width - img_width) // 2
+        img_y = text_y + text_height - 200  # 200 points below the text
+
+        # Draw the image (75 dpi)
+        ps.image((img_x, img_y, img_x + img_width, img_y + img_height), im, 75)
+
+    # Draw the text
+    ps.setfont(font_name, font_size)
+    ps.text((text_x, text_y), text)
+
+    # End the document
+    ps.end_document()
+    ps_file.close()
+
+.. image:: hopper_ps.png
+
+.. note::
 
-        ps.end_document()
+    PostScript converted to PDF for display purposes
 
 More on reading images
 ----------------------

From 1cf887dbec2387d1e3228497cc12329bf84d18e5 Mon Sep 17 00:00:00 2001
From: Andrew Murray <radarhere@users.noreply.github.com>
Date: Sun, 21 Jul 2024 05:22:13 +1000
Subject: [PATCH 0853/1178] Rearranged code

---
 Tests/test_file_libtiff.py | 6 +++---
 1 file changed, 3 insertions(+), 3 deletions(-)

diff --git a/Tests/test_file_libtiff.py b/Tests/test_file_libtiff.py
index 58ac705c9b8..62f8719af53 100644
--- a/Tests/test_file_libtiff.py
+++ b/Tests/test_file_libtiff.py
@@ -241,10 +241,10 @@ def test_additional_metadata(
             new_ifd = TiffImagePlugin.ImageFileDirectory_v2()
             for tag, info in core_items.items():
                 assert info.type is not None
-                if not info.length:
-                    new_ifd[tag] = tuple(values[info.type] for _ in range(3))
-                elif info.length == 1:
+                if info.length == 1:
                     new_ifd[tag] = values[info.type]
+                elif not info.length:
+                    new_ifd[tag] = tuple(values[info.type] for _ in range(3))
                 else:
                     new_ifd[tag] = tuple(values[info.type] for _ in range(info.length))
 

From 22ef8df59abf461824e4672bba8c47137730ef57 Mon Sep 17 00:00:00 2001
From: Yay295 <Yay295@users.noreply.github.com>
Date: Mon, 22 Jul 2024 00:29:55 -0500
Subject: [PATCH 0854/1178] Do not run scheduled wheel jobs on forks

---
 .github/workflows/wheels.yml | 6 ++++--
 1 file changed, 4 insertions(+), 2 deletions(-)

diff --git a/.github/workflows/wheels.yml b/.github/workflows/wheels.yml
index ffd1abd953a..3ed1b5926cf 100644
--- a/.github/workflows/wheels.yml
+++ b/.github/workflows/wheels.yml
@@ -97,6 +97,7 @@ jobs:
           path: ./wheelhouse/*.whl
 
   build-2-native-wheels:
+    if: github.event_name != 'schedule' || github.repository_owner == 'python-pillow'
     name: ${{ matrix.name }}
     runs-on: ${{ matrix.os }}
     strategy:
@@ -150,6 +151,7 @@ jobs:
           path: ./wheelhouse/*.whl
 
   windows:
+    if: github.event_name != 'schedule' || github.repository_owner == 'python-pillow'
     name: Windows ${{ matrix.cibw_arch }}
     runs-on: windows-latest
     strategy:
@@ -256,7 +258,7 @@ jobs:
         path: dist/*.tar.gz
 
   scientific-python-nightly-wheels-publish:
-    if: github.event_name == 'schedule' || github.event_name == 'workflow_dispatch'
+    if: github.repository_owner == 'python-pillow' && (github.event_name == 'schedule' || github.event_name == 'workflow_dispatch')
     needs: [build-2-native-wheels, windows]
     runs-on: ubuntu-latest
     name: Upload wheels to scientific-python-nightly-wheels
@@ -273,7 +275,7 @@ jobs:
           anaconda_nightly_upload_token: ${{ secrets.ANACONDA_ORG_UPLOAD_TOKEN }}
 
   pypi-publish:
-    if: github.event_name == 'push' && startsWith(github.ref, 'refs/tags')
+    if: github.repository_owner == 'python-pillow' && github.event_name == 'push' && startsWith(github.ref, 'refs/tags')
     needs: [build-1-QEMU-emulated-wheels, build-2-native-wheels, windows, sdist]
     runs-on: ubuntu-latest
     name: Upload release to PyPI

From 96fa1f5dbf43fe26a9b7abd98697ae46e8165435 Mon Sep 17 00:00:00 2001
From: "Jeffrey A. Clark (Alex)" <aclark@aclark.net>
Date: Tue, 23 Jul 2024 14:55:04 -0400
Subject: [PATCH 0855/1178] multiply each pixel by 20

---
 docs/handbook/tutorial.rst | 4 ++--
 1 file changed, 2 insertions(+), 2 deletions(-)

diff --git a/docs/handbook/tutorial.rst b/docs/handbook/tutorial.rst
index bc433992841..4e747714394 100644
--- a/docs/handbook/tutorial.rst
+++ b/docs/handbook/tutorial.rst
@@ -412,8 +412,8 @@ Applying point transforms
 
 ::
 
-    # multiply each pixel by 1.2
-    out = im.point(lambda i: i * 1.2)
+    # multiply each pixel by 20
+    out = im.point(lambda i: i * 20)
 
 .. image:: transformed_hopper.jpg
     :align: center

From cf6ec5e065e910d8ce5951de0d19a84879ea77c9 Mon Sep 17 00:00:00 2001
From: Andrew Murray <radarhere@users.noreply.github.com>
Date: Wed, 24 Jul 2024 06:44:06 +1000
Subject: [PATCH 0856/1178] Converted images to WebP

---
 docs/handbook/hopper_ps.png           | Bin 76966 -> 0 bytes
 docs/handbook/hopper_ps.webp          | Bin 0 -> 8322 bytes
 docs/handbook/transformed_hopper.jpg  | Bin 3608 -> 0 bytes
 docs/handbook/transformed_hopper.webp | Bin 0 -> 3054 bytes
 docs/handbook/tutorial.rst            |   4 ++--
 5 files changed, 2 insertions(+), 2 deletions(-)
 delete mode 100644 docs/handbook/hopper_ps.png
 create mode 100644 docs/handbook/hopper_ps.webp
 delete mode 100644 docs/handbook/transformed_hopper.jpg
 create mode 100644 docs/handbook/transformed_hopper.webp

diff --git a/docs/handbook/hopper_ps.png b/docs/handbook/hopper_ps.png
deleted file mode 100644
index fe44e79843f1f46eb2db109d96248670bb645eed..0000000000000000000000000000000000000000
GIT binary patch
literal 0
HcmV?d00001

literal 76966
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%0D9FJ!+sTgMo<k~43Xrd>NP7_O2
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
Ve?A}dZ4dkJs-dYt`Q>|${uf4b-edp(

diff --git a/docs/handbook/hopper_ps.webp b/docs/handbook/hopper_ps.webp
new file mode 100644
index 0000000000000000000000000000000000000000..3dd2943d68262e42c96df88647fb958413560f20
GIT binary patch
literal 8322
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
T%)hKKorTfBZ2#<;FxvkBGmtjo

literal 0
HcmV?d00001

diff --git a/docs/handbook/transformed_hopper.jpg b/docs/handbook/transformed_hopper.jpg
deleted file mode 100644
index 33afe67e62be8f3e2922c5cfa5c0018774ac0b5c..0000000000000000000000000000000000000000
GIT binary patch
literal 0
HcmV?d00001

literal 3608
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

diff --git a/docs/handbook/transformed_hopper.webp b/docs/handbook/transformed_hopper.webp
new file mode 100644
index 0000000000000000000000000000000000000000..be5e90f9677bc56b8ece7235d9aef26d33de8e5d
GIT binary patch
literal 3054
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

literal 0
HcmV?d00001

diff --git a/docs/handbook/tutorial.rst b/docs/handbook/tutorial.rst
index 4e747714394..d8a1ae9c91e 100644
--- a/docs/handbook/tutorial.rst
+++ b/docs/handbook/tutorial.rst
@@ -415,7 +415,7 @@ Applying point transforms
     # multiply each pixel by 20
     out = im.point(lambda i: i * 20)
 
-.. image:: transformed_hopper.jpg
+.. image:: transformed_hopper.webp
     :align: center
 
 Using the above technique, you can quickly apply any simple expression to an
@@ -618,7 +618,7 @@ Drawing PostScript
     ps.end_document()
     ps_file.close()
 
-.. image:: hopper_ps.png
+.. image:: hopper_ps.webp
 
 .. note::
 

From 888b2f716e0873bd7692fd1055c0b588de648352 Mon Sep 17 00:00:00 2001
From: Andrew Murray <radarhere@users.noreply.github.com>
Date: Wed, 24 Jul 2024 06:56:42 +1000
Subject: [PATCH 0857/1178] Improved consistency of example paths

---
 docs/handbook/tutorial.rst | 7 +++----
 1 file changed, 3 insertions(+), 4 deletions(-)

diff --git a/docs/handbook/tutorial.rst b/docs/handbook/tutorial.rst
index d8a1ae9c91e..fead6fb21a4 100644
--- a/docs/handbook/tutorial.rst
+++ b/docs/handbook/tutorial.rst
@@ -332,7 +332,7 @@ choose to resize relative to a given size.
 
     from PIL import Image, ImageOps
     size = (100, 150)
-    with Image.open("Tests/images/hopper.webp") as im:
+    with Image.open("hopper.webp") as im:
         ImageOps.contain(im, size).save("imageops_contain.webp")
         ImageOps.cover(im, size).save("imageops_cover.webp")
         ImageOps.fit(im, size).save("imageops_fit.webp")
@@ -597,7 +597,7 @@ Drawing PostScript
     text_y = page_height - text_height - 50  # Distance from the top of the page
 
     # Load the image
-    image_path = os.path.join("img", "hopper.ppm")  # Update this with your image path
+    image_path = "hopper.ppm"  # Update this with your image path
     with Image.open(image_path) as im:
         # Resize the image if it's too large
         im.thumbnail((page_width - 100, page_height // 2))
@@ -690,7 +690,7 @@ Reading from a tar archive
 
     from PIL import Image, TarIO
 
-    fp = TarIO.TarIO("Tests/images/hopper.tar", "hopper.jpg")
+    fp = TarIO.TarIO("hopper.tar", "hopper.jpg")
     im = Image.open(fp)
 
 
@@ -705,7 +705,6 @@ in the current directory can be saved as JPEGs at reduced quality.
     import glob
     from PIL import Image
 
-
     def compress_image(source_path, dest_path):
         with Image.open(source_path) as img:
             if img.mode != "RGB":

From 8f4dbfe6a64240f613372a6a66f2e7cc563b4251 Mon Sep 17 00:00:00 2001
From: Andrew Murray <radarhere@users.noreply.github.com>
Date: Wed, 24 Jul 2024 06:56:59 +1000
Subject: [PATCH 0858/1178] Simplified code

---
 docs/handbook/tutorial.rst | 5 ++---
 1 file changed, 2 insertions(+), 3 deletions(-)

diff --git a/docs/handbook/tutorial.rst b/docs/handbook/tutorial.rst
index fead6fb21a4..c36011362c6 100644
--- a/docs/handbook/tutorial.rst
+++ b/docs/handbook/tutorial.rst
@@ -603,12 +603,11 @@ Drawing PostScript
         im.thumbnail((page_width - 100, page_height // 2))
 
         # Define the box where the image will be placed
-        img_width, img_height = im.size
-        img_x = (page_width - img_width) // 2
+        img_x = (page_width - im.width) // 2
         img_y = text_y + text_height - 200  # 200 points below the text
 
         # Draw the image (75 dpi)
-        ps.image((img_x, img_y, img_x + img_width, img_y + img_height), im, 75)
+        ps.image((img_x, img_y, img_x + im.width, img_y + im.height), im, 75)
 
     # Draw the text
     ps.setfont(font_name, font_size)

From 77df988d06fee6e3ba87d125912870eed55c5da0 Mon Sep 17 00:00:00 2001
From: Andrew Murray <radarhere@users.noreply.github.com>
Date: Wed, 24 Jul 2024 19:51:19 +1000
Subject: [PATCH 0859/1178] Support RGBA palettes

---
 Tests/test_file_jpeg2k.py    | 7 +++++++
 src/PIL/Jpeg2KImagePlugin.py | 2 +-
 2 files changed, 8 insertions(+), 1 deletion(-)

diff --git a/Tests/test_file_jpeg2k.py b/Tests/test_file_jpeg2k.py
index a5cfa7c6c7a..d7100a761a7 100644
--- a/Tests/test_file_jpeg2k.py
+++ b/Tests/test_file_jpeg2k.py
@@ -391,6 +391,13 @@ def test_pclr() -> None:
         assert len(im.palette.colors) == 256
         assert im.palette.colors[(255, 255, 255)] == 0
 
+    with Image.open(
+        f"{EXTRA_DIR}/147af3f1083de4393666b7d99b01b58b_signal_sigsegv_130c531_6155_5136.jp2"
+    ) as im:
+        assert im.mode == "P"
+        assert len(im.palette.colors) == 139
+        assert im.palette.colors[(0, 0, 0, 0)] == 0
+
 
 def test_comment() -> None:
     with Image.open("Tests/images/comment.jp2") as im:
diff --git a/src/PIL/Jpeg2KImagePlugin.py b/src/PIL/Jpeg2KImagePlugin.py
index eeec41686ca..c5e33b9058a 100644
--- a/src/PIL/Jpeg2KImagePlugin.py
+++ b/src/PIL/Jpeg2KImagePlugin.py
@@ -205,7 +205,7 @@ def _parse_jp2_header(
                 if bitdepth > max_bitdepth:
                     max_bitdepth = bitdepth
             if max_bitdepth <= 8:
-                palette = ImagePalette.ImagePalette()
+                palette = ImagePalette.ImagePalette("RGBA" if npc == 4 else "RGB")
                 for i in range(ne):
                     color: list[int] = []
                     for value in header.read_fields(">" + ("B" * npc)):

From ab635be11bfbf1ac67fdf13f50c66781a7849ca9 Mon Sep 17 00:00:00 2001
From: Andrew Murray <radarhere@users.noreply.github.com>
Date: Wed, 24 Jul 2024 22:08:15 +1000
Subject: [PATCH 0860/1178] Removed unused argument

---
 src/PIL/ImageDraw.py | 4 +---
 1 file changed, 1 insertion(+), 3 deletions(-)

diff --git a/src/PIL/ImageDraw.py b/src/PIL/ImageDraw.py
index 2b3620e712c..ce8e6657182 100644
--- a/src/PIL/ImageDraw.py
+++ b/src/PIL/ImageDraw.py
@@ -623,7 +623,7 @@ def getink(fill: _Ink | None) -> int:
                 return fill_ink
             return ink
 
-        def draw_text(ink, stroke_width=0, stroke_offset=None) -> None:
+        def draw_text(ink, stroke_width=0) -> None:
             mode = self.fontmode
             if stroke_width == 0 and embedded_color:
                 mode = "RGBA"
@@ -664,8 +664,6 @@ def draw_text(ink, stroke_width=0, stroke_offset=None) -> None:
                     )
                 except TypeError:
                     mask = font.getmask(text)
-            if stroke_offset:
-                coord = [coord[0] + stroke_offset[0], coord[1] + stroke_offset[1]]
             if mode == "RGBA":
                 # font.getmask2(mode="RGBA") returns color in RGB bands and mask in A
                 # extract mask and set text alpha

From 7a570d67bf518684a63721ae40d151d40cf2874d Mon Sep 17 00:00:00 2001
From: Hugo van Kemenade <1324225+hugovk@users.noreply.github.com>
Date: Wed, 24 Jul 2024 20:32:20 +0300
Subject: [PATCH 0861/1178] Remove unused _util.is_directory

---
 Tests/test_util.py | 22 ----------------------
 src/PIL/_util.py   |  5 -----
 2 files changed, 27 deletions(-)

diff --git a/Tests/test_util.py b/Tests/test_util.py
index 197ef79eef5..9eaabf18a73 100644
--- a/Tests/test_util.py
+++ b/Tests/test_util.py
@@ -30,28 +30,6 @@ def test_is_not_path(tmp_path: Path) -> None:
     assert not it_is_not
 
 
-def test_is_directory() -> None:
-    # Arrange
-    directory = "Tests"
-
-    # Act
-    it_is = _util.is_directory(directory)
-
-    # Assert
-    assert it_is
-
-
-def test_is_not_directory() -> None:
-    # Arrange
-    text = "abc"
-
-    # Act
-    it_is_not = _util.is_directory(text)
-
-    # Assert
-    assert not it_is_not
-
-
 def test_deferred_error() -> None:
     # Arrange
 
diff --git a/src/PIL/_util.py b/src/PIL/_util.py
index 6bc76281616..8ef0d36f754 100644
--- a/src/PIL/_util.py
+++ b/src/PIL/_util.py
@@ -10,11 +10,6 @@ def is_path(f: Any) -> TypeGuard[StrOrBytesPath]:
     return isinstance(f, (bytes, str, os.PathLike))
 
 
-def is_directory(f: Any) -> TypeGuard[StrOrBytesPath]:
-    """Checks if an object is a string, and that it points to a directory."""
-    return is_path(f) and os.path.isdir(f)
-
-
 class DeferredError:
     def __init__(self, ex: BaseException):
         self.ex = ex

From 72a243c49815b95df5a64a950db6dc815c91cb88 Mon Sep 17 00:00:00 2001
From: Hugo van Kemenade <1324225+hugovk@users.noreply.github.com>
Date: Wed, 24 Jul 2024 11:44:44 -0600
Subject: [PATCH 0862/1178] Revert "Corrected exiv2.org links"

---
 Tests/test_file_jpeg.py | 2 +-
 src/PIL/JpegPresets.py  | 2 +-
 2 files changed, 2 insertions(+), 2 deletions(-)

diff --git a/Tests/test_file_jpeg.py b/Tests/test_file_jpeg.py
index 68705094bab..9660e28288a 100644
--- a/Tests/test_file_jpeg.py
+++ b/Tests/test_file_jpeg.py
@@ -829,7 +829,7 @@ def test_no_dpi_in_exif(self) -> None:
         with Image.open("Tests/images/no-dpi-in-exif.jpg") as im:
             # Act / Assert
             # "When the image resolution is unknown, 72 [dpi] is designated."
-            # https://web.archive.org/web/20240227115053/https://exiv2.org/tags.html
+            # https://exiv2.org/tags.html
             assert im.info.get("dpi") == (72, 72)
 
     def test_invalid_exif(self) -> None:
diff --git a/src/PIL/JpegPresets.py b/src/PIL/JpegPresets.py
index 3aefa073ce2..d0e64a35ee1 100644
--- a/src/PIL/JpegPresets.py
+++ b/src/PIL/JpegPresets.py
@@ -37,7 +37,7 @@
 :func:`.JpegImagePlugin.get_sampling` function.
 
 In JPEG compressed data a JPEG marker is used instead of an EXIF tag.
-(ref.: https://web.archive.org/web/20240227115053/https://exiv2.org/tags.html)
+(ref.: https://exiv2.org/tags.html)
 
 
 Quantization tables

From d0d4227515c91a779520881a8adf164835691859 Mon Sep 17 00:00:00 2001
From: Andrew Murray <radarhere@users.noreply.github.com>
Date: Thu, 25 Jul 2024 18:45:38 +1000
Subject: [PATCH 0863/1178] Require font parameter in FreeTypeFont

---
 src/PIL/ImageFont.py | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/src/PIL/ImageFont.py b/src/PIL/ImageFont.py
index d260eef6946..2f41c29cd93 100644
--- a/src/PIL/ImageFont.py
+++ b/src/PIL/ImageFont.py
@@ -203,7 +203,7 @@ class FreeTypeFont:
 
     def __init__(
         self,
-        font: StrOrBytesPath | BinaryIO | None = None,
+        font: StrOrBytesPath | BinaryIO,
         size: float = 10,
         index: int = 0,
         encoding: str = "",

From 68328ccc6adadab538c559acfd6506b5c6998cd4 Mon Sep 17 00:00:00 2001
From: Andrew Murray <radarhere@users.noreply.github.com>
Date: Thu, 25 Jul 2024 18:52:04 +1000
Subject: [PATCH 0864/1178] Require font parameter for truetype()

---
 src/PIL/ImageFont.py | 4 ++--
 1 file changed, 2 insertions(+), 2 deletions(-)

diff --git a/src/PIL/ImageFont.py b/src/PIL/ImageFont.py
index 2f41c29cd93..b2d79c25fe6 100644
--- a/src/PIL/ImageFont.py
+++ b/src/PIL/ImageFont.py
@@ -756,7 +756,7 @@ def load(filename: str) -> ImageFont:
 
 
 def truetype(
-    font: StrOrBytesPath | BinaryIO | None = None,
+    font: StrOrBytesPath | BinaryIO,
     size: float = 10,
     index: int = 0,
     encoding: str = "",
@@ -827,7 +827,7 @@ def truetype(
     :exception ValueError: If the font size is not greater than zero.
     """
 
-    def freetype(font: StrOrBytesPath | BinaryIO | None) -> FreeTypeFont:
+    def freetype(font: StrOrBytesPath | BinaryIO) -> FreeTypeFont:
         return FreeTypeFont(font, size, index, encoding, layout_engine)
 
     try:

From 726cdf5eed05b2494f2948878c3f2a8c1bc9bfab Mon Sep 17 00:00:00 2001
From: Andrew Murray <radarhere@users.noreply.github.com>
Date: Thu, 25 Jul 2024 22:55:49 +1000
Subject: [PATCH 0865/1178] Added type hints

---
 Tests/test_font_pcf.py              |   3 +-
 Tests/test_imagefont.py             |   4 +-
 docs/reference/ImageFont.rst        |   8 ++
 docs/reference/internal_modules.rst |   4 +
 pyproject.toml                      |   2 -
 src/PIL/Image.py                    |  68 ++++++++------
 src/PIL/ImageDraw.py                | 140 +++++++++++++++-------------
 src/PIL/ImageFont.py                |  93 +++++++++++-------
 src/PIL/_imaging.pyi                |   1 +
 src/PIL/_imagingft.pyi              |  58 ++++++------
 10 files changed, 223 insertions(+), 158 deletions(-)

diff --git a/Tests/test_font_pcf.py b/Tests/test_font_pcf.py
index 997809e463b..567ddaf13a0 100644
--- a/Tests/test_font_pcf.py
+++ b/Tests/test_font_pcf.py
@@ -2,6 +2,7 @@
 
 import os
 from pathlib import Path
+from typing import AnyStr
 
 import pytest
 
@@ -92,7 +93,7 @@ def test_textsize(request: pytest.FixtureRequest, tmp_path: Path) -> None:
 
 
 def _test_high_characters(
-    request: pytest.FixtureRequest, tmp_path: Path, message: str | bytes
+    request: pytest.FixtureRequest, tmp_path: Path, message: AnyStr
 ) -> None:
     tempname = save_font(request, tmp_path)
     font = ImageFont.load(tempname)
diff --git a/Tests/test_imagefont.py b/Tests/test_imagefont.py
index 9cb42037106..340cc47420b 100644
--- a/Tests/test_imagefont.py
+++ b/Tests/test_imagefont.py
@@ -717,14 +717,14 @@ def test_variation_set_by_name(font: ImageFont.FreeTypeFont) -> None:
 
     font = ImageFont.truetype("Tests/fonts/AdobeVFPrototype.ttf", 36)
     _check_text(font, "Tests/images/variation_adobe.png", 11)
-    for name in ["Bold", b"Bold"]:
+    for name in ("Bold", b"Bold"):
         font.set_variation_by_name(name)
         assert font.getname()[1] == "Bold"
     _check_text(font, "Tests/images/variation_adobe_name.png", 16)
 
     font = ImageFont.truetype("Tests/fonts/TINY5x3GX.ttf", 36)
     _check_text(font, "Tests/images/variation_tiny.png", 40)
-    for name in ["200", b"200"]:
+    for name in ("200", b"200"):
         font.set_variation_by_name(name)
         assert font.getname()[1] == "200"
     _check_text(font, "Tests/images/variation_tiny_name.png", 40)
diff --git a/docs/reference/ImageFont.rst b/docs/reference/ImageFont.rst
index edbdd9a32a6..d9d9cac6e13 100644
--- a/docs/reference/ImageFont.rst
+++ b/docs/reference/ImageFont.rst
@@ -91,3 +91,11 @@ Constants
     Set to 1,000,000, to protect against potential DOS attacks. Pillow will
     raise a :py:exc:`ValueError` if the number of characters is over this limit. The
     check can be disabled by setting ``ImageFont.MAX_STRING_LENGTH = None``.
+
+Dictionaries
+------------
+
+.. autoclass:: Axis
+    :members:
+    :undoc-members:
+    :show-inheritance:
diff --git a/docs/reference/internal_modules.rst b/docs/reference/internal_modules.rst
index e4cb17c4d8f..2fb4ff8c018 100644
--- a/docs/reference/internal_modules.rst
+++ b/docs/reference/internal_modules.rst
@@ -78,3 +78,7 @@ on some Python versions.
 
 An internal interface module previously known as :mod:`~PIL._imaging`,
 implemented in :file:`_imaging.c`.
+
+.. py:class:: ImagingCore
+
+    A representation of the image data.
diff --git a/pyproject.toml b/pyproject.toml
index b76f3c24d2e..0940664f355 100644
--- a/pyproject.toml
+++ b/pyproject.toml
@@ -159,6 +159,4 @@ exclude = [
   '^Tests/oss-fuzz/fuzz_font.py$',
   '^Tests/oss-fuzz/fuzz_pillow.py$',
   '^Tests/test_qt_image_qapplication.py$',
-  '^Tests/test_font_pcf_charsets.py$',
-  '^Tests/test_font_pcf.py$',
 ]
diff --git a/src/PIL/Image.py b/src/PIL/Image.py
index 9d901e02873..aa5eeabb293 100644
--- a/src/PIL/Image.py
+++ b/src/PIL/Image.py
@@ -218,6 +218,8 @@ class Quantize(IntEnum):
 # Registries
 
 if TYPE_CHECKING:
+    from xml.etree.ElementTree import Element
+
     from . import ImageFile, ImagePalette
     from ._typing import NumpyArray, StrOrBytesPath, TypeGuard
 ID: list[str] = []
@@ -241,9 +243,9 @@ class Quantize(IntEnum):
 _ENDIAN = "<" if sys.byteorder == "little" else ">"
 
 
-def _conv_type_shape(im):
+def _conv_type_shape(im: Image) -> tuple[tuple[int, ...], str]:
     m = ImageMode.getmode(im.mode)
-    shape = (im.height, im.width)
+    shape: tuple[int, ...] = (im.height, im.width)
     extra = len(m.bands)
     if extra != 1:
         shape += (extra,)
@@ -470,10 +472,10 @@ def __init__(self, scale, offset) -> None:
         self.scale = scale
         self.offset = offset
 
-    def __neg__(self):
+    def __neg__(self) -> _E:
         return _E(-self.scale, -self.offset)
 
-    def __add__(self, other):
+    def __add__(self, other) -> _E:
         if isinstance(other, _E):
             return _E(self.scale + other.scale, self.offset + other.offset)
         return _E(self.scale, self.offset + other)
@@ -486,14 +488,14 @@ def __sub__(self, other):
     def __rsub__(self, other):
         return other + -self
 
-    def __mul__(self, other):
+    def __mul__(self, other) -> _E:
         if isinstance(other, _E):
             return NotImplemented
         return _E(self.scale * other, self.offset * other)
 
     __rmul__ = __mul__
 
-    def __truediv__(self, other):
+    def __truediv__(self, other) -> _E:
         if isinstance(other, _E):
             return NotImplemented
         return _E(self.scale / other, self.offset / other)
@@ -718,9 +720,9 @@ def _repr_jpeg_(self) -> bytes | None:
         return self._repr_image("JPEG")
 
     @property
-    def __array_interface__(self):
+    def __array_interface__(self) -> dict[str, str | bytes | int | tuple[int, ...]]:
         # numpy array interface support
-        new = {"version": 3}
+        new: dict[str, str | bytes | int | tuple[int, ...]] = {"version": 3}
         try:
             if self.mode == "1":
                 # Binary images need to be extended from bits to bytes
@@ -1418,7 +1420,7 @@ def getcolors(
             return out
         return self.im.getcolors(maxcolors)
 
-    def getdata(self, band: int | None = None):
+    def getdata(self, band: int | None = None) -> core.ImagingCore:
         """
         Returns the contents of this image as a sequence object
         containing pixel values.  The sequence object is flattened, so
@@ -1467,8 +1469,8 @@ def getxmp(self) -> dict[str, Any]:
         def get_name(tag: str) -> str:
             return re.sub("^{[^}]+}", "", tag)
 
-        def get_value(element):
-            value = {get_name(k): v for k, v in element.attrib.items()}
+        def get_value(element: Element) -> str | dict[str, Any] | None:
+            value: dict[str, Any] = {get_name(k): v for k, v in element.attrib.items()}
             children = list(element)
             if children:
                 for child in children:
@@ -1712,7 +1714,7 @@ def histogram(self, mask: Image | None = None, extrema=None) -> list[int]:
             return self.im.histogram(extrema)
         return self.im.histogram()
 
-    def entropy(self, mask=None, extrema=None):
+    def entropy(self, mask: Image | None = None, extrema=None):
         """
         Calculates and returns the entropy for the image.
 
@@ -1996,7 +1998,7 @@ def putalpha(self, alpha: Image | int) -> None:
 
     def putdata(
         self,
-        data: Sequence[float] | Sequence[Sequence[int]] | NumpyArray,
+        data: Sequence[float] | Sequence[Sequence[int]] | core.ImagingCore | NumpyArray,
         scale: float = 1.0,
         offset: float = 0.0,
     ) -> None:
@@ -2184,7 +2186,12 @@ def remap_palette(
 
         return m_im
 
-    def _get_safe_box(self, size, resample, box):
+    def _get_safe_box(
+        self,
+        size: tuple[int, int],
+        resample: Resampling,
+        box: tuple[float, float, float, float],
+    ) -> tuple[int, int, int, int]:
         """Expands the box so it includes adjacent pixels
         that may be used by resampling with the given resampling filter.
         """
@@ -2294,7 +2301,7 @@ def resize(
             factor_x = int((box[2] - box[0]) / size[0] / reducing_gap) or 1
             factor_y = int((box[3] - box[1]) / size[1] / reducing_gap) or 1
             if factor_x > 1 or factor_y > 1:
-                reduce_box = self._get_safe_box(size, resample, box)
+                reduce_box = self._get_safe_box(size, cast(Resampling, resample), box)
                 factor = (factor_x, factor_y)
                 self = (
                     self.reduce(factor, box=reduce_box)
@@ -2430,7 +2437,7 @@ def rotate(
             0.0,
         ]
 
-        def transform(x, y, matrix):
+        def transform(x: float, y: float, matrix: list[float]) -> tuple[float, float]:
             (a, b, c, d, e, f) = matrix
             return a * x + b * y + c, d * x + e * y + f
 
@@ -2445,9 +2452,9 @@ def transform(x, y, matrix):
             xx = []
             yy = []
             for x, y in ((0, 0), (w, 0), (w, h), (0, h)):
-                x, y = transform(x, y, matrix)
-                xx.append(x)
-                yy.append(y)
+                transformed_x, transformed_y = transform(x, y, matrix)
+                xx.append(transformed_x)
+                yy.append(transformed_y)
             nw = math.ceil(max(xx)) - math.floor(min(xx))
             nh = math.ceil(max(yy)) - math.floor(min(yy))
 
@@ -2705,7 +2712,7 @@ def thumbnail(
         provided_size = tuple(map(math.floor, size))
 
         def preserve_aspect_ratio() -> tuple[int, int] | None:
-            def round_aspect(number, key):
+            def round_aspect(number: float, key: Callable[[int], float]) -> int:
                 return max(min(math.floor(number), math.ceil(number), key=key), 1)
 
             x, y = provided_size
@@ -2849,7 +2856,13 @@ def getdata(self):
         return im
 
     def __transformer(
-        self, box, image, method, data, resample=Resampling.NEAREST, fill=1
+        self,
+        box: tuple[int, int, int, int],
+        image: Image,
+        method,
+        data,
+        resample: int = Resampling.NEAREST,
+        fill: bool = True,
     ):
         w = box[2] - box[0]
         h = box[3] - box[1]
@@ -2899,11 +2912,12 @@ def __transformer(
             Resampling.BICUBIC,
         ):
             if resample in (Resampling.BOX, Resampling.HAMMING, Resampling.LANCZOS):
-                msg = {
+                unusable: dict[int, str] = {
                     Resampling.BOX: "Image.Resampling.BOX",
                     Resampling.HAMMING: "Image.Resampling.HAMMING",
                     Resampling.LANCZOS: "Image.Resampling.LANCZOS",
-                }[resample] + f" ({resample}) cannot be used."
+                }
+                msg = unusable[resample] + f" ({resample}) cannot be used."
             else:
                 msg = f"Unknown resampling filter ({resample})."
 
@@ -3843,7 +3857,7 @@ class Exif(_ExifBase):
       print(gps_ifd[ExifTags.GPS.GPSDateStamp])  # 1999:99:99 99:99:99
     """
 
-    endian = None
+    endian: str | None = None
     bigtiff = False
     _loaded = False
 
@@ -3892,7 +3906,7 @@ def _get_head(self) -> bytes:
             head += b"\x00\x00\x00\x00"
         return head
 
-    def load(self, data):
+    def load(self, data: bytes) -> None:
         # Extract EXIF information.  This is highly experimental,
         # and is likely to be replaced with something better in a future
         # version.
@@ -3911,7 +3925,7 @@ def load(self, data):
             self._info = None
             return
 
-        self.fp = io.BytesIO(data)
+        self.fp: IO[bytes] = io.BytesIO(data)
         self.head = self.fp.read(8)
         # process dictionary
         from . import TiffImagePlugin
@@ -3921,7 +3935,7 @@ def load(self, data):
         self.fp.seek(self._info.next)
         self._info.load(self.fp)
 
-    def load_from_fp(self, fp, offset=None):
+    def load_from_fp(self, fp: IO[bytes], offset: int | None = None) -> None:
         self._loaded_exif = None
         self._data.clear()
         self._hidden_data.clear()
diff --git a/src/PIL/ImageDraw.py b/src/PIL/ImageDraw.py
index ce8e6657182..6f56d023618 100644
--- a/src/PIL/ImageDraw.py
+++ b/src/PIL/ImageDraw.py
@@ -36,7 +36,7 @@
 import struct
 from collections.abc import Sequence
 from types import ModuleType
-from typing import TYPE_CHECKING, AnyStr, Callable, Union, cast
+from typing import TYPE_CHECKING, Any, AnyStr, Callable, Union, cast
 
 from . import Image, ImageColor
 from ._deprecate import deprecate
@@ -561,7 +561,12 @@ def _multiline_check(self, text: AnyStr) -> bool:
     def _multiline_split(self, text: AnyStr) -> list[AnyStr]:
         return text.split("\n" if isinstance(text, str) else b"\n")
 
-    def _multiline_spacing(self, font, spacing, stroke_width):
+    def _multiline_spacing(
+        self,
+        font: ImageFont.ImageFont | ImageFont.FreeTypeFont | ImageFont.TransposedFont,
+        spacing: float,
+        stroke_width: float,
+    ) -> float:
         return (
             self.textbbox((0, 0), "A", font, stroke_width=stroke_width)[3]
             + stroke_width
@@ -571,25 +576,25 @@ def _multiline_spacing(self, font, spacing, stroke_width):
     def text(
         self,
         xy: tuple[float, float],
-        text: str,
-        fill=None,
+        text: AnyStr,
+        fill: _Ink | None = None,
         font: (
             ImageFont.ImageFont
             | ImageFont.FreeTypeFont
             | ImageFont.TransposedFont
             | None
         ) = None,
-        anchor=None,
-        spacing=4,
-        align="left",
-        direction=None,
-        features=None,
-        language=None,
-        stroke_width=0,
-        stroke_fill=None,
-        embedded_color=False,
-        *args,
-        **kwargs,
+        anchor: str | None = None,
+        spacing: float = 4,
+        align: str = "left",
+        direction: str | None = None,
+        features: list[str] | None = None,
+        language: str | None = None,
+        stroke_width: float = 0,
+        stroke_fill: _Ink | None = None,
+        embedded_color: bool = False,
+        *args: Any,
+        **kwargs: Any,
     ) -> None:
         """Draw text."""
         if embedded_color and self.mode not in ("RGB", "RGBA"):
@@ -623,15 +628,14 @@ def getink(fill: _Ink | None) -> int:
                 return fill_ink
             return ink
 
-        def draw_text(ink, stroke_width=0) -> None:
+        def draw_text(ink: int, stroke_width: float = 0) -> None:
             mode = self.fontmode
             if stroke_width == 0 and embedded_color:
                 mode = "RGBA"
             coord = []
-            start = []
             for i in range(2):
                 coord.append(int(xy[i]))
-                start.append(math.modf(xy[i])[0])
+            start = (math.modf(xy[0])[0], math.modf(xy[1])[0])
             try:
                 mask, offset = font.getmask2(  # type: ignore[union-attr,misc]
                     text,
@@ -697,25 +701,25 @@ def draw_text(ink, stroke_width=0) -> None:
     def multiline_text(
         self,
         xy: tuple[float, float],
-        text: str,
-        fill=None,
+        text: AnyStr,
+        fill: _Ink | None = None,
         font: (
             ImageFont.ImageFont
             | ImageFont.FreeTypeFont
             | ImageFont.TransposedFont
             | None
         ) = None,
-        anchor=None,
-        spacing=4,
-        align="left",
-        direction=None,
-        features=None,
-        language=None,
-        stroke_width=0,
-        stroke_fill=None,
-        embedded_color=False,
+        anchor: str | None = None,
+        spacing: float = 4,
+        align: str = "left",
+        direction: str | None = None,
+        features: list[str] | None = None,
+        language: str | None = None,
+        stroke_width: float = 0,
+        stroke_fill: _Ink | None = None,
+        embedded_color: bool = False,
         *,
-        font_size=None,
+        font_size: float | None = None,
     ) -> None:
         if direction == "ttb":
             msg = "ttb direction is unsupported for multiline text"
@@ -788,19 +792,19 @@ def multiline_text(
 
     def textlength(
         self,
-        text: str,
+        text: AnyStr,
         font: (
             ImageFont.ImageFont
             | ImageFont.FreeTypeFont
             | ImageFont.TransposedFont
             | None
         ) = None,
-        direction=None,
-        features=None,
-        language=None,
-        embedded_color=False,
+        direction: str | None = None,
+        features: list[str] | None = None,
+        language: str | None = None,
+        embedded_color: bool = False,
         *,
-        font_size=None,
+        font_size: float | None = None,
     ) -> float:
         """Get the length of a given string, in pixels with 1/64 precision."""
         if self._multiline_check(text):
@@ -817,20 +821,25 @@ def textlength(
 
     def textbbox(
         self,
-        xy,
-        text,
-        font=None,
-        anchor=None,
-        spacing=4,
-        align="left",
-        direction=None,
-        features=None,
-        language=None,
-        stroke_width=0,
-        embedded_color=False,
+        xy: tuple[float, float],
+        text: AnyStr,
+        font: (
+            ImageFont.ImageFont
+            | ImageFont.FreeTypeFont
+            | ImageFont.TransposedFont
+            | None
+        ) = None,
+        anchor: str | None = None,
+        spacing: float = 4,
+        align: str = "left",
+        direction: str | None = None,
+        features: list[str] | None = None,
+        language: str | None = None,
+        stroke_width: float = 0,
+        embedded_color: bool = False,
         *,
-        font_size=None,
-    ) -> tuple[int, int, int, int]:
+        font_size: float | None = None,
+    ) -> tuple[float, float, float, float]:
         """Get the bounding box of a given string, in pixels."""
         if embedded_color and self.mode not in ("RGB", "RGBA"):
             msg = "Embedded color supported only in RGB and RGBA modes"
@@ -862,20 +871,25 @@ def textbbox(
 
     def multiline_textbbox(
         self,
-        xy,
-        text,
-        font=None,
-        anchor=None,
-        spacing=4,
-        align="left",
-        direction=None,
-        features=None,
-        language=None,
-        stroke_width=0,
-        embedded_color=False,
+        xy: tuple[float, float],
+        text: AnyStr,
+        font: (
+            ImageFont.ImageFont
+            | ImageFont.FreeTypeFont
+            | ImageFont.TransposedFont
+            | None
+        ) = None,
+        anchor: str | None = None,
+        spacing: float = 4,
+        align: str = "left",
+        direction: str | None = None,
+        features: list[str] | None = None,
+        language: str | None = None,
+        stroke_width: float = 0,
+        embedded_color: bool = False,
         *,
-        font_size=None,
-    ) -> tuple[int, int, int, int]:
+        font_size: float | None = None,
+    ) -> tuple[float, float, float, float]:
         if direction == "ttb":
             msg = "ttb direction is unsupported for multiline text"
             raise ValueError(msg)
@@ -914,7 +928,7 @@ def multiline_textbbox(
         elif anchor[1] == "d":
             top -= (len(lines) - 1) * line_spacing
 
-        bbox: tuple[int, int, int, int] | None = None
+        bbox: tuple[float, float, float, float] | None = None
 
         for idx, line in enumerate(lines):
             left = xy[0]
diff --git a/src/PIL/ImageFont.py b/src/PIL/ImageFont.py
index d260eef6946..24490348c32 100644
--- a/src/PIL/ImageFont.py
+++ b/src/PIL/ImageFont.py
@@ -34,7 +34,7 @@
 from enum import IntEnum
 from io import BytesIO
 from types import ModuleType
-from typing import IO, TYPE_CHECKING, Any, BinaryIO
+from typing import IO, TYPE_CHECKING, Any, BinaryIO, TypedDict
 
 from . import Image
 from ._typing import StrOrBytesPath
@@ -46,6 +46,13 @@
     from ._imagingft import Font
 
 
+class Axis(TypedDict):
+    minimum: int | None
+    default: int | None
+    maximum: int | None
+    name: bytes | None
+
+
 class Layout(IntEnum):
     BASIC = 0
     RAQM = 1
@@ -138,7 +145,9 @@ def _load_pilfont_data(self, file: IO[bytes], image: Image.Image) -> None:
 
         self.font = Image.core.font(image.im, data)
 
-    def getmask(self, text, mode="", *args, **kwargs):
+    def getmask(
+        self, text: str | bytes, mode: str = "", *args: Any, **kwargs: Any
+    ) -> Image.core.ImagingCore:
         """
         Create a bitmap for the text.
 
@@ -236,7 +245,7 @@ def __init__(
 
         self.layout_engine = layout_engine
 
-        def load_from_bytes(f):
+        def load_from_bytes(f) -> None:
             self.font_bytes = f.read()
             self.font = core.getfont(
                 "", size, index, encoding, self.font_bytes, layout_engine
@@ -283,7 +292,12 @@ def getmetrics(self) -> tuple[int, int]:
         return self.font.ascent, self.font.descent
 
     def getlength(
-        self, text: str | bytes, mode="", direction=None, features=None, language=None
+        self,
+        text: str | bytes,
+        mode: str = "",
+        direction: str | None = None,
+        features: list[str] | None = None,
+        language: str | None = None,
     ) -> float:
         """
         Returns length (in pixels with 1/64 precision) of given text when rendered
@@ -424,16 +438,16 @@ def getbbox(
 
     def getmask(
         self,
-        text,
-        mode="",
-        direction=None,
-        features=None,
-        language=None,
-        stroke_width=0,
-        anchor=None,
-        ink=0,
-        start=None,
-    ):
+        text: str | bytes,
+        mode: str = "",
+        direction: str | None = None,
+        features: list[str] | None = None,
+        language: str | None = None,
+        stroke_width: float = 0,
+        anchor: str | None = None,
+        ink: int = 0,
+        start: tuple[float, float] | None = None,
+    ) -> Image.core.ImagingCore:
         """
         Create a bitmap for the text.
 
@@ -516,17 +530,17 @@ def getmask(
     def getmask2(
         self,
         text: str | bytes,
-        mode="",
-        direction=None,
-        features=None,
-        language=None,
-        stroke_width=0,
-        anchor=None,
-        ink=0,
-        start=None,
-        *args,
-        **kwargs,
-    ):
+        mode: str = "",
+        direction: str | None = None,
+        features: list[str] | None = None,
+        language: str | None = None,
+        stroke_width: float = 0,
+        anchor: str | None = None,
+        ink: int = 0,
+        start: tuple[float, float] | None = None,
+        *args: Any,
+        **kwargs: Any,
+    ) -> tuple[Image.core.ImagingCore, tuple[int, int]]:
         """
         Create a bitmap for the text.
 
@@ -599,7 +613,7 @@ def getmask2(
         if start is None:
             start = (0, 0)
 
-        def fill(width, height):
+        def fill(width: int, height: int) -> Image.core.ImagingCore:
             size = (width, height)
             Image._decompression_bomb_check(size)
             return Image.core.fill("RGBA" if mode == "RGBA" else "L", size)
@@ -619,8 +633,13 @@ def fill(width, height):
         )
 
     def font_variant(
-        self, font=None, size=None, index=None, encoding=None, layout_engine=None
-    ):
+        self,
+        font: StrOrBytesPath | BinaryIO | None = None,
+        size: float | None = None,
+        index: int | None = None,
+        encoding: str | None = None,
+        layout_engine: Layout | None = None,
+    ) -> FreeTypeFont:
         """
         Create a copy of this FreeTypeFont object,
         using any specified arguments to override the settings.
@@ -655,7 +674,7 @@ def get_variation_names(self) -> list[bytes]:
             raise NotImplementedError(msg) from e
         return [name.replace(b"\x00", b"") for name in names]
 
-    def set_variation_by_name(self, name):
+    def set_variation_by_name(self, name: str | bytes) -> None:
         """
         :param name: The name of the style.
         :exception OSError: If the font is not a variation font.
@@ -674,7 +693,7 @@ def set_variation_by_name(self, name):
 
         self.font.setvarname(index)
 
-    def get_variation_axes(self):
+    def get_variation_axes(self) -> list[Axis]:
         """
         :returns: A list of the axes in a variation font.
         :exception OSError: If the font is not a variation font.
@@ -704,7 +723,9 @@ def set_variation_by_axes(self, axes: list[float]) -> None:
 class TransposedFont:
     """Wrapper for writing rotated or mirrored text"""
 
-    def __init__(self, font, orientation=None):
+    def __init__(
+        self, font: ImageFont | FreeTypeFont, orientation: Image.Transpose | None = None
+    ):
         """
         Wrapper that creates a transposed font from any existing font
         object.
@@ -718,13 +739,17 @@ def __init__(self, font, orientation=None):
         self.font = font
         self.orientation = orientation  # any 'transpose' argument, or None
 
-    def getmask(self, text, mode="", *args, **kwargs):
+    def getmask(
+        self, text: str | bytes, mode: str = "", *args: Any, **kwargs: Any
+    ) -> Image.core.ImagingCore:
         im = self.font.getmask(text, mode, *args, **kwargs)
         if self.orientation is not None:
             return im.transpose(self.orientation)
         return im
 
-    def getbbox(self, text, *args, **kwargs):
+    def getbbox(
+        self, text: str | bytes, *args: Any, **kwargs: Any
+    ) -> tuple[int, int, float, float]:
         # TransposedFont doesn't support getmask2, move top-left point to (0, 0)
         # this has no effect on ImageFont and simulates anchor="lt" for FreeTypeFont
         left, top, right, bottom = self.font.getbbox(text, *args, **kwargs)
@@ -734,7 +759,7 @@ def getbbox(self, text, *args, **kwargs):
             return 0, 0, height, width
         return 0, 0, width, height
 
-    def getlength(self, text: str | bytes, *args, **kwargs) -> float:
+    def getlength(self, text: str | bytes, *args: Any, **kwargs: Any) -> float:
         if self.orientation in (Image.Transpose.ROTATE_90, Image.Transpose.ROTATE_270):
             msg = "text length is undefined for text rotated by 90 or 270 degrees"
             raise ValueError(msg)
diff --git a/src/PIL/_imaging.pyi b/src/PIL/_imaging.pyi
index 8cccd3ac73e..998bc52eb8a 100644
--- a/src/PIL/_imaging.pyi
+++ b/src/PIL/_imaging.pyi
@@ -1,6 +1,7 @@
 from typing import Any
 
 class ImagingCore:
+    def __getitem__(self, index: int) -> float: ...
     def __getattr__(self, name: str) -> Any: ...
 
 class ImagingFont:
diff --git a/src/PIL/_imagingft.pyi b/src/PIL/_imagingft.pyi
index 5e97b40b2e0..9cc9822f5b4 100644
--- a/src/PIL/_imagingft.pyi
+++ b/src/PIL/_imagingft.pyi
@@ -1,12 +1,6 @@
-from typing import Any, TypedDict
+from typing import Any, Callable
 
-from . import _imaging
-
-class _Axis(TypedDict):
-    minimum: int | None
-    default: int | None
-    maximum: int | None
-    name: bytes | None
+from . import ImageFont, _imaging
 
 class Font:
     @property
@@ -28,42 +22,48 @@ class Font:
     def render(
         self,
         string: str | bytes,
-        fill,
-        mode=...,
-        dir=...,
-        features=...,
-        lang=...,
-        stroke_width=...,
-        anchor=...,
-        foreground_ink_long=...,
-        x_start=...,
-        y_start=...,
+        fill: Callable[[int, int], _imaging.ImagingCore],
+        mode: str,
+        dir: str | None,
+        features: list[str] | None,
+        lang: str | None,
+        stroke_width: float,
+        anchor: str | None,
+        foreground_ink_long: int,
+        x_start: float,
+        y_start: float,
         /,
     ) -> tuple[_imaging.ImagingCore, tuple[int, int]]: ...
     def getsize(
         self,
         string: str | bytes | bytearray,
-        mode=...,
-        dir=...,
-        features=...,
-        lang=...,
-        anchor=...,
+        mode: str,
+        dir: str | None,
+        features: list[str] | None,
+        lang: str | None,
+        anchor: str | None,
         /,
     ) -> tuple[tuple[int, int], tuple[int, int]]: ...
     def getlength(
-        self, string: str | bytes, mode=..., dir=..., features=..., lang=..., /
+        self,
+        string: str | bytes,
+        mode: str,
+        dir: str | None,
+        features: list[str] | None,
+        lang: str | None,
+        /,
     ) -> float: ...
     def getvarnames(self) -> list[bytes]: ...
-    def getvaraxes(self) -> list[_Axis] | None: ...
+    def getvaraxes(self) -> list[ImageFont.Axis]: ...
     def setvarname(self, instance_index: int, /) -> None: ...
     def setvaraxes(self, axes: list[float], /) -> None: ...
 
 def getfont(
     filename: str | bytes,
     size: float,
-    index=...,
-    encoding=...,
-    font_bytes=...,
-    layout_engine=...,
+    index: int,
+    encoding: str,
+    font_bytes: bytes,
+    layout_engine: int,
 ) -> Font: ...
 def __getattr__(name: str) -> Any: ...

From 046285ac5d0998ec8c80e4cf70192dcdf4753ec4 Mon Sep 17 00:00:00 2001
From: Andrew Murray <radarhere@users.noreply.github.com>
Date: Fri, 26 Jul 2024 16:42:28 +1000
Subject: [PATCH 0866/1178] Added type hints

---
 Tests/test_file_iptc.py    |  1 +
 src/PIL/Image.py           | 14 +++++------
 src/PIL/ImageDraw2.py      | 49 ++++++++++++++++++++++----------------
 src/PIL/ImageQt.py         |  2 +-
 src/PIL/IptcImagePlugin.py |  4 +++-
 src/PIL/TiffImagePlugin.py | 24 ++++++++++---------
 6 files changed, 53 insertions(+), 41 deletions(-)

diff --git a/Tests/test_file_iptc.py b/Tests/test_file_iptc.py
index 88c30d46895..b0ea2bf4282 100644
--- a/Tests/test_file_iptc.py
+++ b/Tests/test_file_iptc.py
@@ -57,6 +57,7 @@ def test_getiptcinfo_fotostation() -> None:
         iptc = IptcImagePlugin.getiptcinfo(im)
 
     # Assert
+    assert iptc is not None
     for tag in iptc.keys():
         if tag[0] == 240:
             return
diff --git a/src/PIL/Image.py b/src/PIL/Image.py
index aa5eeabb293..72d167a8a94 100644
--- a/src/PIL/Image.py
+++ b/src/PIL/Image.py
@@ -468,40 +468,40 @@ def _getencoder(
 
 
 class _E:
-    def __init__(self, scale, offset) -> None:
+    def __init__(self, scale: float, offset: float) -> None:
         self.scale = scale
         self.offset = offset
 
     def __neg__(self) -> _E:
         return _E(-self.scale, -self.offset)
 
-    def __add__(self, other) -> _E:
+    def __add__(self, other: _E | float) -> _E:
         if isinstance(other, _E):
             return _E(self.scale + other.scale, self.offset + other.offset)
         return _E(self.scale, self.offset + other)
 
     __radd__ = __add__
 
-    def __sub__(self, other):
+    def __sub__(self, other: _E | float) -> _E:
         return self + -other
 
-    def __rsub__(self, other):
+    def __rsub__(self, other: _E | float) -> _E:
         return other + -self
 
-    def __mul__(self, other) -> _E:
+    def __mul__(self, other: _E | float) -> _E:
         if isinstance(other, _E):
             return NotImplemented
         return _E(self.scale * other, self.offset * other)
 
     __rmul__ = __mul__
 
-    def __truediv__(self, other) -> _E:
+    def __truediv__(self, other: _E | float) -> _E:
         if isinstance(other, _E):
             return NotImplemented
         return _E(self.scale / other, self.offset / other)
 
 
-def _getscaleoffset(expr):
+def _getscaleoffset(expr) -> tuple[float, float]:
     a = expr(_E(1, 0))
     return (a.scale, a.offset) if isinstance(a, _E) else (0, a)
 
diff --git a/src/PIL/ImageDraw2.py b/src/PIL/ImageDraw2.py
index e89a78be4b5..c0d89e4aa5e 100644
--- a/src/PIL/ImageDraw2.py
+++ b/src/PIL/ImageDraw2.py
@@ -24,10 +24,10 @@
 """
 from __future__ import annotations
 
-from typing import BinaryIO
+from typing import AnyStr, BinaryIO
 
 from . import Image, ImageColor, ImageDraw, ImageFont, ImagePath
-from ._typing import StrOrBytesPath
+from ._typing import Coords, StrOrBytesPath
 
 
 class Pen:
@@ -74,12 +74,14 @@ def __init__(
             image = Image.new(image, size, color)
         self.draw = ImageDraw.Draw(image)
         self.image = image
-        self.transform = None
+        self.transform: tuple[float, float, float, float, float, float] | None = None
 
     def flush(self) -> Image.Image:
         return self.image
 
-    def render(self, op, xy, pen, brush=None):
+    def render(
+        self, op: str, xy: Coords, pen: Pen | Brush, brush: Brush | Pen | None = None
+    ) -> None:
         # handle color arguments
         outline = fill = None
         width = 1
@@ -95,20 +97,21 @@ def render(self, op, xy, pen, brush=None):
             fill = pen.color
         # handle transformation
         if self.transform:
-            xy = ImagePath.Path(xy)
-            xy.transform(self.transform)
+            path = ImagePath.Path(xy)
+            path.transform(self.transform)
+            xy = path
         # render the item
         if op == "line":
             self.draw.line(xy, fill=outline, width=width)
         else:
             getattr(self.draw, op)(xy, fill=fill, outline=outline)
 
-    def settransform(self, offset):
+    def settransform(self, offset: tuple[float, float]) -> None:
         """Sets a transformation offset."""
         (xoffset, yoffset) = offset
         self.transform = (1, 0, xoffset, 0, 1, yoffset)
 
-    def arc(self, xy, start, end, *options):
+    def arc(self, xy: Coords, start, end, *options) -> None:
         """
         Draws an arc (a portion of a circle outline) between the start and end
         angles, inside the given bounding box.
@@ -117,7 +120,7 @@ def arc(self, xy, start, end, *options):
         """
         self.render("arc", xy, start, end, *options)
 
-    def chord(self, xy, start, end, *options):
+    def chord(self, xy: Coords, start, end, *options) -> None:
         """
         Same as :py:meth:`~PIL.ImageDraw2.Draw.arc`, but connects the end points
         with a straight line.
@@ -126,7 +129,7 @@ def chord(self, xy, start, end, *options):
         """
         self.render("chord", xy, start, end, *options)
 
-    def ellipse(self, xy, *options):
+    def ellipse(self, xy: Coords, *options) -> None:
         """
         Draws an ellipse inside the given bounding box.
 
@@ -134,7 +137,7 @@ def ellipse(self, xy, *options):
         """
         self.render("ellipse", xy, *options)
 
-    def line(self, xy, *options):
+    def line(self, xy: Coords, *options) -> None:
         """
         Draws a line between the coordinates in the ``xy`` list.
 
@@ -142,7 +145,7 @@ def line(self, xy, *options):
         """
         self.render("line", xy, *options)
 
-    def pieslice(self, xy, start, end, *options):
+    def pieslice(self, xy: Coords, start, end, *options) -> None:
         """
         Same as arc, but also draws straight lines between the end points and the
         center of the bounding box.
@@ -151,7 +154,7 @@ def pieslice(self, xy, start, end, *options):
         """
         self.render("pieslice", xy, start, end, *options)
 
-    def polygon(self, xy, *options):
+    def polygon(self, xy: Coords, *options) -> None:
         """
         Draws a polygon.
 
@@ -164,7 +167,7 @@ def polygon(self, xy, *options):
         """
         self.render("polygon", xy, *options)
 
-    def rectangle(self, xy, *options):
+    def rectangle(self, xy: Coords, *options) -> None:
         """
         Draws a rectangle.
 
@@ -172,18 +175,21 @@ def rectangle(self, xy, *options):
         """
         self.render("rectangle", xy, *options)
 
-    def text(self, xy, text, font):
+    def text(self, xy: tuple[float, float], text: AnyStr, font: Font) -> None:
         """
         Draws the string at the given position.
 
         .. seealso:: :py:meth:`PIL.ImageDraw.ImageDraw.text`
         """
         if self.transform:
-            xy = ImagePath.Path(xy)
-            xy.transform(self.transform)
+            path = ImagePath.Path(xy)
+            path.transform(self.transform)
+            xy = path
         self.draw.text(xy, text, font=font.font, fill=font.color)
 
-    def textbbox(self, xy, text, font):
+    def textbbox(
+        self, xy: tuple[float, float], text: AnyStr, font: Font
+    ) -> tuple[float, float, float, float]:
         """
         Returns bounding box (in pixels) of given text.
 
@@ -192,11 +198,12 @@ def textbbox(self, xy, text, font):
         .. seealso:: :py:meth:`PIL.ImageDraw.ImageDraw.textbbox`
         """
         if self.transform:
-            xy = ImagePath.Path(xy)
-            xy.transform(self.transform)
+            path = ImagePath.Path(xy)
+            path.transform(self.transform)
+            xy = path
         return self.draw.textbbox(xy, text, font=font.font)
 
-    def textlength(self, text, font):
+    def textlength(self, text: AnyStr, font: Font) -> float:
         """
         Returns length (in pixels) of given text.
         This is the amount by which following text should be offset.
diff --git a/src/PIL/ImageQt.py b/src/PIL/ImageQt.py
index 346fe49d348..a2d94671414 100644
--- a/src/PIL/ImageQt.py
+++ b/src/PIL/ImageQt.py
@@ -58,7 +58,7 @@
     qt_version = None
 
 
-def rgb(r, g, b, a=255):
+def rgb(r: int, g: int, b: int, a: int = 255) -> int:
     """(Internal) Turns an RGB color into a Qt compatible color integer."""
     # use qRgb to pack the colors, and then turn the resulting long
     # into a negative integer with the same bitpattern.
diff --git a/src/PIL/IptcImagePlugin.py b/src/PIL/IptcImagePlugin.py
index 16a18ddfaa8..17243e705c1 100644
--- a/src/PIL/IptcImagePlugin.py
+++ b/src/PIL/IptcImagePlugin.py
@@ -185,7 +185,9 @@ def load(self) -> Image.core.PixelAccess | None:
 Image.register_extension(IptcImageFile.format, ".iim")
 
 
-def getiptcinfo(im: ImageFile.ImageFile):
+def getiptcinfo(
+    im: ImageFile.ImageFile,
+) -> dict[tuple[int, int], bytes | list[bytes]] | None:
     """
     Get IPTC information from TIFF, JPEG, or IPTC file.
 
diff --git a/src/PIL/TiffImagePlugin.py b/src/PIL/TiffImagePlugin.py
index 1dab0d50b44..ad050ffe4d6 100644
--- a/src/PIL/TiffImagePlugin.py
+++ b/src/PIL/TiffImagePlugin.py
@@ -584,8 +584,10 @@ def __init__(
         self.tagtype: dict[int, int] = {}
         """ Dictionary of tag types """
         self.reset()
-        (self.next,) = (
-            self._unpack("Q", ifh[8:]) if self._bigtiff else self._unpack("L", ifh[4:])
+        self.next = (
+            self._unpack("Q", ifh[8:])[0]
+            if self._bigtiff
+            else self._unpack("L", ifh[4:])[0]
         )
         self._legacy_api = False
 
@@ -643,7 +645,7 @@ def __contains__(self, tag: object) -> bool:
     def __setitem__(self, tag: int, value) -> None:
         self._setitem(tag, value, self.legacy_api)
 
-    def _setitem(self, tag, value, legacy_api) -> None:
+    def _setitem(self, tag: int, value, legacy_api: bool) -> None:
         basetypes = (Number, bytes, str)
 
         info = TiffTags.lookup(tag, self.group)
@@ -731,7 +733,7 @@ def __delitem__(self, tag: int) -> None:
     def __iter__(self):
         return iter(set(self._tagdata) | set(self._tags_v2))
 
-    def _unpack(self, fmt: str, data):
+    def _unpack(self, fmt: str, data: bytes):
         return struct.unpack(self._endian + fmt, data)
 
     def _pack(self, fmt: str, *values):
@@ -755,11 +757,11 @@ def _pack(self, fmt: str, *values):
     )
 
     @_register_loader(1, 1)  # Basic type, except for the legacy API.
-    def load_byte(self, data, legacy_api: bool = True):
+    def load_byte(self, data: bytes, legacy_api: bool = True) -> bytes:
         return data
 
     @_register_writer(1)  # Basic type, except for the legacy API.
-    def write_byte(self, data) -> bytes:
+    def write_byte(self, data: bytes | int | IFDRational) -> bytes:
         if isinstance(data, IFDRational):
             data = int(data)
         if isinstance(data, int):
@@ -773,7 +775,7 @@ def load_string(self, data: bytes, legacy_api: bool = True) -> str:
         return data.decode("latin-1", "replace")
 
     @_register_writer(2)
-    def write_string(self, value) -> bytes:
+    def write_string(self, value: str | bytes | int) -> bytes:
         # remerge of https://github.com/python-pillow/Pillow/pull/1416
         if isinstance(value, int):
             value = str(value)
@@ -782,7 +784,7 @@ def write_string(self, value) -> bytes:
         return value + b"\0"
 
     @_register_loader(5, 8)
-    def load_rational(self, data, legacy_api=True):
+    def load_rational(self, data, legacy_api: bool = True):
         vals = self._unpack(f"{len(data) // 4}L", data)
 
         def combine(a, b):
@@ -797,11 +799,11 @@ def write_rational(self, *values) -> bytes:
         )
 
     @_register_loader(7, 1)
-    def load_undefined(self, data, legacy_api: bool = True):
+    def load_undefined(self, data: bytes, legacy_api: bool = True) -> bytes:
         return data
 
     @_register_writer(7)
-    def write_undefined(self, value) -> bytes:
+    def write_undefined(self, value: bytes | int | IFDRational) -> bytes:
         if isinstance(value, IFDRational):
             value = int(value)
         if isinstance(value, int):
@@ -809,7 +811,7 @@ def write_undefined(self, value) -> bytes:
         return value
 
     @_register_loader(10, 8)
-    def load_signed_rational(self, data, legacy_api: bool = True):
+    def load_signed_rational(self, data: bytes, legacy_api: bool = True):
         vals = self._unpack(f"{len(data) // 4}l", data)
 
         def combine(a, b):

From c85eb0cae5568ba9286ac15c3e8f1709f7bbe9e0 Mon Sep 17 00:00:00 2001
From: Andrew Murray <radarhere@users.noreply.github.com>
Date: Sun, 28 Jul 2024 12:53:02 +1000
Subject: [PATCH 0867/1178] Added type hints

---
 Tests/test_file_png.py     |  2 ++
 src/PIL/Image.py           | 30 +++++++++++++++++-------------
 src/PIL/ImageDraw2.py      | 14 +++++++-------
 src/PIL/PngImagePlugin.py  | 38 +++++++++++++++++++-------------------
 src/PIL/TiffImagePlugin.py |  8 +++++---
 5 files changed, 50 insertions(+), 42 deletions(-)

diff --git a/Tests/test_file_png.py b/Tests/test_file_png.py
index 4958b22228b..0abf9866ff2 100644
--- a/Tests/test_file_png.py
+++ b/Tests/test_file_png.py
@@ -424,8 +424,10 @@ def test_roundtrip_itxt(self) -> None:
         im = roundtrip(im, pnginfo=info)
         assert im.info == {"spam": "Eggs", "eggs": "Spam"}
         assert im.text == {"spam": "Eggs", "eggs": "Spam"}
+        assert isinstance(im.text["spam"], PngImagePlugin.iTXt)
         assert im.text["spam"].lang == "en"
         assert im.text["spam"].tkey == "Spam"
+        assert isinstance(im.text["eggs"], PngImagePlugin.iTXt)
         assert im.text["eggs"].lang == "en"
         assert im.text["eggs"].tkey == "Eggs"
 
diff --git a/src/PIL/Image.py b/src/PIL/Image.py
index 72d167a8a94..eb3dd5a36f9 100644
--- a/src/PIL/Image.py
+++ b/src/PIL/Image.py
@@ -38,7 +38,7 @@
 import sys
 import tempfile
 import warnings
-from collections.abc import Callable, MutableMapping, Sequence
+from collections.abc import Callable, Iterator, MutableMapping, Sequence
 from enum import IntEnum
 from types import ModuleType
 from typing import (
@@ -744,11 +744,11 @@ def __array_interface__(self) -> dict[str, str | bytes | int | tuple[int, ...]]:
         new["shape"], new["typestr"] = _conv_type_shape(self)
         return new
 
-    def __getstate__(self):
+    def __getstate__(self) -> list[Any]:
         im_data = self.tobytes()  # load image first
         return [self.info, self.mode, self.size, self.getpalette(), im_data]
 
-    def __setstate__(self, state) -> None:
+    def __setstate__(self, state: list[Any]) -> None:
         Image.__init__(self)
         info, mode, size, palette, data = state
         self.info = info
@@ -1683,7 +1683,9 @@ def getprojection(self) -> tuple[list[int], list[int]]:
         x, y = self.im.getprojection()
         return list(x), list(y)
 
-    def histogram(self, mask: Image | None = None, extrema=None) -> list[int]:
+    def histogram(
+        self, mask: Image | None = None, extrema: tuple[float, float] | None = None
+    ) -> list[int]:
         """
         Returns a histogram for the image. The histogram is returned as a
         list of pixel counts, one for each pixel value in the source
@@ -1709,12 +1711,14 @@ def histogram(self, mask: Image | None = None, extrema=None) -> list[int]:
             mask.load()
             return self.im.histogram((0, 0), mask.im)
         if self.mode in ("I", "F"):
-            if extrema is None:
-                extrema = self.getextrema()
-            return self.im.histogram(extrema)
+            return self.im.histogram(
+                extrema if extrema is not None else self.getextrema()
+            )
         return self.im.histogram()
 
-    def entropy(self, mask: Image | None = None, extrema=None):
+    def entropy(
+        self, mask: Image | None = None, extrema: tuple[float, float] | None = None
+    ) -> float:
         """
         Calculates and returns the entropy for the image.
 
@@ -1735,9 +1739,9 @@ def entropy(self, mask: Image | None = None, extrema=None):
             mask.load()
             return self.im.entropy((0, 0), mask.im)
         if self.mode in ("I", "F"):
-            if extrema is None:
-                extrema = self.getextrema()
-            return self.im.entropy(extrema)
+            return self.im.entropy(
+                extrema if extrema is not None else self.getextrema()
+            )
         return self.im.entropy()
 
     def paste(
@@ -3881,7 +3885,7 @@ def _fixup_dict(self, src_dict):
         # returns a dict with any single item tuples/lists as individual values
         return {k: self._fixup(v) for k, v in src_dict.items()}
 
-    def _get_ifd_dict(self, offset: int, group=None):
+    def _get_ifd_dict(self, offset: int, group: int | None = None):
         try:
             # an offset pointer to the location of the nested embedded IFD.
             # It should be a long, but may be corrupted.
@@ -4136,7 +4140,7 @@ def __delitem__(self, tag: int) -> None:
         else:
             del self._data[tag]
 
-    def __iter__(self):
+    def __iter__(self) -> Iterator[int]:
         keys = set(self._data)
         if self._info is not None:
             keys.update(self._info)
diff --git a/src/PIL/ImageDraw2.py b/src/PIL/ImageDraw2.py
index c0d89e4aa5e..1ad239382cb 100644
--- a/src/PIL/ImageDraw2.py
+++ b/src/PIL/ImageDraw2.py
@@ -24,7 +24,7 @@
 """
 from __future__ import annotations
 
-from typing import AnyStr, BinaryIO
+from typing import Any, AnyStr, BinaryIO
 
 from . import Image, ImageColor, ImageDraw, ImageFont, ImagePath
 from ._typing import Coords, StrOrBytesPath
@@ -111,7 +111,7 @@ def settransform(self, offset: tuple[float, float]) -> None:
         (xoffset, yoffset) = offset
         self.transform = (1, 0, xoffset, 0, 1, yoffset)
 
-    def arc(self, xy: Coords, start, end, *options) -> None:
+    def arc(self, xy: Coords, start, end, *options: Any) -> None:
         """
         Draws an arc (a portion of a circle outline) between the start and end
         angles, inside the given bounding box.
@@ -120,7 +120,7 @@ def arc(self, xy: Coords, start, end, *options) -> None:
         """
         self.render("arc", xy, start, end, *options)
 
-    def chord(self, xy: Coords, start, end, *options) -> None:
+    def chord(self, xy: Coords, start, end, *options: Any) -> None:
         """
         Same as :py:meth:`~PIL.ImageDraw2.Draw.arc`, but connects the end points
         with a straight line.
@@ -129,7 +129,7 @@ def chord(self, xy: Coords, start, end, *options) -> None:
         """
         self.render("chord", xy, start, end, *options)
 
-    def ellipse(self, xy: Coords, *options) -> None:
+    def ellipse(self, xy: Coords, *options: Any) -> None:
         """
         Draws an ellipse inside the given bounding box.
 
@@ -137,7 +137,7 @@ def ellipse(self, xy: Coords, *options) -> None:
         """
         self.render("ellipse", xy, *options)
 
-    def line(self, xy: Coords, *options) -> None:
+    def line(self, xy: Coords, *options: Any) -> None:
         """
         Draws a line between the coordinates in the ``xy`` list.
 
@@ -145,7 +145,7 @@ def line(self, xy: Coords, *options) -> None:
         """
         self.render("line", xy, *options)
 
-    def pieslice(self, xy: Coords, start, end, *options) -> None:
+    def pieslice(self, xy: Coords, start, end, *options: Any) -> None:
         """
         Same as arc, but also draws straight lines between the end points and the
         center of the bounding box.
@@ -154,7 +154,7 @@ def pieslice(self, xy: Coords, start, end, *options) -> None:
         """
         self.render("pieslice", xy, start, end, *options)
 
-    def polygon(self, xy: Coords, *options) -> None:
+    def polygon(self, xy: Coords, *options: Any) -> None:
         """
         Draws a polygon.
 
diff --git a/src/PIL/PngImagePlugin.py b/src/PIL/PngImagePlugin.py
index 58db7777c39..52cfcd13a8e 100644
--- a/src/PIL/PngImagePlugin.py
+++ b/src/PIL/PngImagePlugin.py
@@ -38,6 +38,7 @@
 import struct
 import warnings
 import zlib
+from collections.abc import Callable
 from enum import IntEnum
 from typing import IO, TYPE_CHECKING, Any, NamedTuple, NoReturn
 
@@ -135,7 +136,7 @@ class Blend(IntEnum):
     """
 
 
-def _safe_zlib_decompress(s):
+def _safe_zlib_decompress(s: bytes) -> bytes:
     dobj = zlib.decompressobj()
     plaintext = dobj.decompress(s, MAX_TEXT_CHUNK)
     if dobj.unconsumed_tail:
@@ -783,7 +784,7 @@ def _open(self) -> None:
         self._mode = self.png.im_mode
         self._size = self.png.im_size
         self.info = self.png.im_info
-        self._text = None
+        self._text: dict[str, str | iTXt] | None = None
         self.tile = self.png.im_tile
         self.custom_mimetype = self.png.im_custom_mimetype
         self.n_frames = self.png.im_n_frames or 1
@@ -810,7 +811,7 @@ def _open(self) -> None:
         self.is_animated = self.n_frames > 1
 
     @property
-    def text(self):
+    def text(self) -> dict[str, str | iTXt]:
         # experimental
         if self._text is None:
             # iTxt, tEXt and zTXt chunks may appear at the end of the file
@@ -822,6 +823,7 @@ def text(self):
             self.load()
             if self.is_animated:
                 self.seek(frame)
+        assert self._text is not None
         return self._text
 
     def verify(self) -> None:
@@ -1105,7 +1107,7 @@ def putchunk(fp: IO[bytes], cid: bytes, *data: bytes) -> None:
 class _idat:
     # wrap output from the encoder in IDAT chunks
 
-    def __init__(self, fp, chunk) -> None:
+    def __init__(self, fp: IO[bytes], chunk: Callable[..., None]) -> None:
         self.fp = fp
         self.chunk = chunk
 
@@ -1116,7 +1118,7 @@ def write(self, data: bytes) -> None:
 class _fdat:
     # wrap encoder output in fdAT chunks
 
-    def __init__(self, fp: IO[bytes], chunk, seq_num: int) -> None:
+    def __init__(self, fp: IO[bytes], chunk: Callable[..., None], seq_num: int) -> None:
         self.fp = fp
         self.chunk = chunk
         self.seq_num = seq_num
@@ -1135,7 +1137,7 @@ class _Frame(NamedTuple):
 def _write_multiple_frames(
     im: Image.Image,
     fp: IO[bytes],
-    chunk,
+    chunk: Callable[..., None],
     mode: str,
     rawmode: str,
     default_image: Image.Image | None,
@@ -1275,7 +1277,11 @@ def _save_all(im: Image.Image, fp: IO[bytes], filename: str | bytes) -> None:
 
 
 def _save(
-    im: Image.Image, fp, filename: str | bytes, chunk=putchunk, save_all: bool = False
+    im: Image.Image,
+    fp: IO[bytes],
+    filename: str | bytes,
+    chunk: Callable[..., None] = putchunk,
+    save_all: bool = False,
 ) -> None:
     # save an image to disk (called by the save method)
 
@@ -1483,22 +1489,16 @@ def _save(
 
 def getchunks(im: Image.Image, **params: Any) -> list[tuple[bytes, bytes, bytes]]:
     """Return a list of PNG chunks representing this image."""
+    from io import BytesIO
 
-    class collector:
-        data = []
-
-        def write(self, data: bytes) -> None:
-            pass
-
-        def append(self, chunk: tuple[bytes, bytes, bytes]) -> None:
-            self.data.append(chunk)
+    chunks = []
 
-    def append(fp: collector, cid: bytes, *data: bytes) -> None:
+    def append(fp: IO[bytes], cid: bytes, *data: bytes) -> None:
         byte_data = b"".join(data)
         crc = o32(_crc32(byte_data, _crc32(cid)))
-        fp.append((cid, byte_data, crc))
+        chunks.append((cid, byte_data, crc))
 
-    fp = collector()
+    fp = BytesIO()
 
     try:
         im.encoderinfo = params
@@ -1506,7 +1506,7 @@ def append(fp: collector, cid: bytes, *data: bytes) -> None:
     finally:
         del im.encoderinfo
 
-    return fp.data
+    return chunks
 
 
 # --------------------------------------------------------------------
diff --git a/src/PIL/TiffImagePlugin.py b/src/PIL/TiffImagePlugin.py
index ad050ffe4d6..318e9825ca8 100644
--- a/src/PIL/TiffImagePlugin.py
+++ b/src/PIL/TiffImagePlugin.py
@@ -1020,7 +1020,7 @@ class ImageFileDirectory_v1(ImageFileDirectory_v2):
     ..  deprecated:: 3.0.0
     """
 
-    def __init__(self, *args, **kwargs) -> None:
+    def __init__(self, *args: Any, **kwargs: Any) -> None:
         super().__init__(*args, **kwargs)
         self._legacy_api = True
 
@@ -1142,13 +1142,15 @@ def _open(self) -> None:
         self._seek(0)
 
     @property
-    def n_frames(self):
-        if self._n_frames is None:
+    def n_frames(self) -> int:
+        current_n_frames = self._n_frames
+        if current_n_frames is None:
             current = self.tell()
             self._seek(len(self._frame_pos))
             while self._n_frames is None:
                 self._seek(self.tell() + 1)
             self.seek(current)
+        assert self._n_frames is not None
         return self._n_frames
 
     def seek(self, frame: int) -> None:

From a03033e7f3cdc1bdf9a6aabc09d6dc2aca97cff7 Mon Sep 17 00:00:00 2001
From: Aleksandr Karpinskii <homm86@gmail.com>
Date: Sun, 7 Jul 2024 15:52:46 +0400
Subject: [PATCH 0868/1178] Remove all WITH_* flags from _imaging.c

---
 src/_imaging.c | 89 +++-----------------------------------------------
 1 file changed, 4 insertions(+), 85 deletions(-)

diff --git a/src/_imaging.c b/src/_imaging.c
index 5c2f7b4b623..d675cf22ef4 100644
--- a/src/_imaging.c
+++ b/src/_imaging.c
@@ -93,19 +93,6 @@
 #define _USE_MATH_DEFINES
 #include <math.h>
 
-/* Configuration stuff. Feel free to undef things you don't need. */
-#define WITH_IMAGECHOPS  /* ImageChops support */
-#define WITH_IMAGEDRAW   /* ImageDraw support */
-#define WITH_MAPPING     /* use memory mapping to read some file formats */
-#define WITH_IMAGEPATH   /* ImagePath stuff */
-#define WITH_ARROW       /* arrow graphics stuff (experimental) */
-#define WITH_EFFECTS     /* special effects */
-#define WITH_QUANTIZE    /* quantization support */
-#define WITH_RANKFILTER  /* rank filter */
-#define WITH_MODEFILTER  /* mode filter */
-#define WITH_THREADING   /* "friendly" threading support */
-#define WITH_UNSHARPMASK /* Kevin Cazabon's unsharpmask module */
-
 #undef VERBOSE
 
 #define B16(p, i) ((((int)p[(i)]) << 8) + p[(i) + 1])
@@ -123,8 +110,6 @@ typedef struct {
 
 static PyTypeObject Imaging_Type;
 
-#ifdef WITH_IMAGEDRAW
-
 typedef struct {
     /* to write a character, cut out sxy from glyph data, place
        at current position plus dxy, and advance by (dx, dy) */
@@ -151,8 +136,6 @@ typedef struct {
 
 static PyTypeObject ImagingDraw_Type;
 
-#endif
-
 typedef struct {
     PyObject_HEAD ImagingObject *image;
     int readonly;
@@ -215,16 +198,12 @@ PyImaging_AsImaging(PyObject *op) {
 
 void
 ImagingSectionEnter(ImagingSectionCookie *cookie) {
-#ifdef WITH_THREADING
     *cookie = (PyThreadState *)PyEval_SaveThread();
-#endif
 }
 
 void
 ImagingSectionLeave(ImagingSectionCookie *cookie) {
-#ifdef WITH_THREADING
     PyEval_RestoreThread((PyThreadState *)*cookie);
-#endif
 }
 
 /* -------------------------------------------------------------------- */
@@ -1091,7 +1070,6 @@ _filter(ImagingObject *self, PyObject *args) {
     return imOut;
 }
 
-#ifdef WITH_UNSHARPMASK
 static PyObject *
 _gaussian_blur(ImagingObject *self, PyObject *args) {
     Imaging imIn;
@@ -1116,7 +1094,6 @@ _gaussian_blur(ImagingObject *self, PyObject *args) {
 
     return PyImagingNew(imOut);
 }
-#endif
 
 static PyObject *
 _getpalette(ImagingObject *self, PyObject *args) {
@@ -1374,7 +1351,6 @@ _entropy(ImagingObject *self, PyObject *args) {
     return PyFloat_FromDouble(-entropy);
 }
 
-#ifdef WITH_MODEFILTER
 static PyObject *
 _modefilter(ImagingObject *self, PyObject *args) {
     int size;
@@ -1384,7 +1360,6 @@ _modefilter(ImagingObject *self, PyObject *args) {
 
     return PyImagingNew(ImagingModeFilter(self->image, size));
 }
-#endif
 
 static PyObject *
 _offset(ImagingObject *self, PyObject *args) {
@@ -1716,8 +1691,6 @@ _putdata(ImagingObject *self, PyObject *args) {
     return Py_None;
 }
 
-#ifdef WITH_QUANTIZE
-
 static PyObject *
 _quantize(ImagingObject *self, PyObject *args) {
     int colours = 256;
@@ -1734,7 +1707,6 @@ _quantize(ImagingObject *self, PyObject *args) {
 
     return PyImagingNew(ImagingQuantize(self->image, colours, method, kmeans));
 }
-#endif
 
 static PyObject *
 _putpalette(ImagingObject *self, PyObject *args) {
@@ -1870,7 +1842,6 @@ _putpixel(ImagingObject *self, PyObject *args) {
     return Py_None;
 }
 
-#ifdef WITH_RANKFILTER
 static PyObject *
 _rankfilter(ImagingObject *self, PyObject *args) {
     int size, rank;
@@ -1880,7 +1851,6 @@ _rankfilter(ImagingObject *self, PyObject *args) {
 
     return PyImagingNew(ImagingRankFilter(self->image, size, rank));
 }
-#endif
 
 static PyObject *
 _resize(ImagingObject *self, PyObject *args) {
@@ -2162,7 +2132,6 @@ _transpose(ImagingObject *self, PyObject *args) {
     return PyImagingNew(imOut);
 }
 
-#ifdef WITH_UNSHARPMASK
 static PyObject *
 _unsharp_mask(ImagingObject *self, PyObject *args) {
     Imaging imIn;
@@ -2186,7 +2155,6 @@ _unsharp_mask(ImagingObject *self, PyObject *args) {
 
     return PyImagingNew(imOut);
 }
-#endif
 
 static PyObject *
 _box_blur(ImagingObject *self, PyObject *args) {
@@ -2463,9 +2431,7 @@ _split(ImagingObject *self) {
     return list;
 }
 
-/* -------------------------------------------------------------------- */
-
-#ifdef WITH_IMAGECHOPS
+/* Channel operations (ImageChops) ------------------------------------ */
 
 static PyObject *
 _chop_invert(ImagingObject *self) {
@@ -2646,11 +2612,8 @@ _chop_overlay(ImagingObject *self, PyObject *args) {
 
     return PyImagingNew(ImagingOverlay(self->image, imagep->image));
 }
-#endif
-
-/* -------------------------------------------------------------------- */
 
-#ifdef WITH_IMAGEDRAW
+/* Graphics (ImageDraw) ----------------------------------------------- */
 
 static PyObject *
 _font_new(PyObject *self_, PyObject *args) {
@@ -3233,8 +3196,6 @@ _draw_points(ImagingDrawObject *self, PyObject *args) {
     return Py_None;
 }
 
-#ifdef WITH_ARROW
-
 /* from outline.c */
 extern ImagingOutline
 PyOutline_AsOutline(PyObject *outline);
@@ -3264,8 +3225,6 @@ _draw_outline(ImagingDrawObject *self, PyObject *args) {
     return Py_None;
 }
 
-#endif
-
 static PyObject *
 _draw_pieslice(ImagingDrawObject *self, PyObject *args) {
     double *xy;
@@ -3431,12 +3390,9 @@ _draw_rectangle(ImagingDrawObject *self, PyObject *args) {
 }
 
 static struct PyMethodDef _draw_methods[] = {
-#ifdef WITH_IMAGEDRAW
     /* Graphics (ImageDraw) */
     {"draw_lines", (PyCFunction)_draw_lines, METH_VARARGS},
-#ifdef WITH_ARROW
     {"draw_outline", (PyCFunction)_draw_outline, METH_VARARGS},
-#endif
     {"draw_polygon", (PyCFunction)_draw_polygon, METH_VARARGS},
     {"draw_rectangle", (PyCFunction)_draw_rectangle, METH_VARARGS},
     {"draw_points", (PyCFunction)_draw_points, METH_VARARGS},
@@ -3446,11 +3402,9 @@ static struct PyMethodDef _draw_methods[] = {
     {"draw_ellipse", (PyCFunction)_draw_ellipse, METH_VARARGS},
     {"draw_pieslice", (PyCFunction)_draw_pieslice, METH_VARARGS},
     {"draw_ink", (PyCFunction)_draw_ink, METH_VARARGS},
-#endif
     {NULL, NULL} /* sentinel */
 };
 
-#endif
 
 static PyObject *
 pixel_access_new(ImagingObject *imagep, PyObject *args) {
@@ -3532,11 +3486,9 @@ pixel_access_setitem(PixelAccessObject *self, PyObject *xy, PyObject *color) {
 }
 
 /* -------------------------------------------------------------------- */
-/* EFFECTS (experimental)                            */
+/* EFFECTS (experimental)                                               */
 /* -------------------------------------------------------------------- */
 
-#ifdef WITH_EFFECTS
-
 static PyObject *
 _effect_mandelbrot(ImagingObject *self, PyObject *args) {
     int xsize = 512;
@@ -3588,8 +3540,6 @@ _effect_spread(ImagingObject *self, PyObject *args) {
     return PyImagingNew(ImagingEffectSpread(self->image, dist));
 }
 
-#endif
-
 /* -------------------------------------------------------------------- */
 /* UTILITIES                                */
 /* -------------------------------------------------------------------- */
@@ -3670,20 +3620,14 @@ static struct PyMethodDef methods[] = {
     {"filter", (PyCFunction)_filter, METH_VARARGS},
     {"histogram", (PyCFunction)_histogram, METH_VARARGS},
     {"entropy", (PyCFunction)_entropy, METH_VARARGS},
-#ifdef WITH_MODEFILTER
     {"modefilter", (PyCFunction)_modefilter, METH_VARARGS},
-#endif
     {"offset", (PyCFunction)_offset, METH_VARARGS},
     {"paste", (PyCFunction)_paste, METH_VARARGS},
     {"point", (PyCFunction)_point, METH_VARARGS},
     {"point_transform", (PyCFunction)_point_transform, METH_VARARGS},
     {"putdata", (PyCFunction)_putdata, METH_VARARGS},
-#ifdef WITH_QUANTIZE
     {"quantize", (PyCFunction)_quantize, METH_VARARGS},
-#endif
-#ifdef WITH_RANKFILTER
     {"rankfilter", (PyCFunction)_rankfilter, METH_VARARGS},
-#endif
     {"resize", (PyCFunction)_resize, METH_VARARGS},
     {"reduce", (PyCFunction)_reduce, METH_VARARGS},
     {"transpose", (PyCFunction)_transpose, METH_VARARGS},
@@ -3709,7 +3653,6 @@ static struct PyMethodDef methods[] = {
     {"putpalettealpha", (PyCFunction)_putpalettealpha, METH_VARARGS},
     {"putpalettealphas", (PyCFunction)_putpalettealphas, METH_VARARGS},
 
-#ifdef WITH_IMAGECHOPS
     /* Channel operations (ImageChops) */
     {"chop_invert", (PyCFunction)_chop_invert, METH_NOARGS},
     {"chop_lighter", (PyCFunction)_chop_lighter, METH_VARARGS},
@@ -3728,20 +3671,14 @@ static struct PyMethodDef methods[] = {
     {"chop_hard_light", (PyCFunction)_chop_hard_light, METH_VARARGS},
     {"chop_overlay", (PyCFunction)_chop_overlay, METH_VARARGS},
 
-#endif
-
-#ifdef WITH_UNSHARPMASK
-    /* Kevin Cazabon's unsharpmask extension */
+    /* Unsharpmask extension */
     {"gaussian_blur", (PyCFunction)_gaussian_blur, METH_VARARGS},
     {"unsharp_mask", (PyCFunction)_unsharp_mask, METH_VARARGS},
-#endif
 
     {"box_blur", (PyCFunction)_box_blur, METH_VARARGS},
 
-#ifdef WITH_EFFECTS
     /* Special effects */
     {"effect_spread", (PyCFunction)_effect_spread, METH_VARARGS},
-#endif
 
     /* Misc. */
     {"new_block", (PyCFunction)_new_block, METH_VARARGS},
@@ -3870,8 +3807,6 @@ static PyTypeObject Imaging_Type = {
     getsetters,           /*tp_getset*/
 };
 
-#ifdef WITH_IMAGEDRAW
-
 static PyTypeObject ImagingFont_Type = {
     PyVarObject_HEAD_INIT(NULL, 0) "ImagingFont", /*tp_name*/
     sizeof(ImagingFontObject),                    /*tp_basicsize*/
@@ -3938,8 +3873,6 @@ static PyTypeObject ImagingDraw_Type = {
     0,                         /*tp_getset*/
 };
 
-#endif
-
 static PyMappingMethods pixel_access_as_mapping = {
     (lenfunc)NULL,                       /*mp_length*/
     (binaryfunc)pixel_access_getitem,    /*mp_subscript*/
@@ -4283,9 +4216,7 @@ static PyMethodDef functions[] = {
 #endif
 
 /* Memory mapping */
-#ifdef WITH_MAPPING
     {"map_buffer", (PyCFunction)PyImaging_MapBuffer, METH_VARARGS},
-#endif
 
 /* Display support */
 #ifdef _WIN32
@@ -4305,29 +4236,21 @@ static PyMethodDef functions[] = {
     {"getcodecstatus", (PyCFunction)_getcodecstatus, METH_VARARGS},
 
 /* Special effects (experimental) */
-#ifdef WITH_EFFECTS
     {"effect_mandelbrot", (PyCFunction)_effect_mandelbrot, METH_VARARGS},
     {"effect_noise", (PyCFunction)_effect_noise, METH_VARARGS},
     {"linear_gradient", (PyCFunction)_linear_gradient, METH_VARARGS},
     {"radial_gradient", (PyCFunction)_radial_gradient, METH_VARARGS},
     {"wedge", (PyCFunction)_linear_gradient, METH_VARARGS}, /* Compatibility */
-#endif
 
 /* Drawing support stuff */
-#ifdef WITH_IMAGEDRAW
     {"font", (PyCFunction)_font_new, METH_VARARGS},
     {"draw", (PyCFunction)_draw_new, METH_VARARGS},
-#endif
 
 /* Experimental path stuff */
-#ifdef WITH_IMAGEPATH
     {"path", (PyCFunction)PyPath_Create, METH_VARARGS},
-#endif
 
 /* Experimental arrow graphics stuff */
-#ifdef WITH_ARROW
     {"outline", (PyCFunction)PyOutline_Create, METH_VARARGS},
-#endif
 
     /* Resource management */
     {"get_stats", (PyCFunction)_get_stats, METH_VARARGS},
@@ -4352,16 +4275,12 @@ setup_module(PyObject *m) {
     if (PyType_Ready(&Imaging_Type) < 0) {
         return -1;
     }
-
-#ifdef WITH_IMAGEDRAW
     if (PyType_Ready(&ImagingFont_Type) < 0) {
         return -1;
     }
-
     if (PyType_Ready(&ImagingDraw_Type) < 0) {
         return -1;
     }
-#endif
     if (PyType_Ready(&PixelAccess_Type) < 0) {
         return -1;
     }

From cfce566d17999698e6f8fa2ccd815c8146b5de20 Mon Sep 17 00:00:00 2001
From: Aleksandr Karpinskii <homm86@gmail.com>
Date: Sun, 7 Jul 2024 16:08:52 +0400
Subject: [PATCH 0869/1178] codestyle

---
 src/_imaging.c | 13 ++++++-------
 1 file changed, 6 insertions(+), 7 deletions(-)

diff --git a/src/_imaging.c b/src/_imaging.c
index d675cf22ef4..91cae2e5d91 100644
--- a/src/_imaging.c
+++ b/src/_imaging.c
@@ -3405,7 +3405,6 @@ static struct PyMethodDef _draw_methods[] = {
     {NULL, NULL} /* sentinel */
 };
 
-
 static PyObject *
 pixel_access_new(ImagingObject *imagep, PyObject *args) {
     PixelAccessObject *self;
@@ -4215,11 +4214,11 @@ static PyMethodDef functions[] = {
     {"zip_encoder", (PyCFunction)PyImaging_ZipEncoderNew, METH_VARARGS},
 #endif
 
-/* Memory mapping */
+    /* Memory mapping */
     {"map_buffer", (PyCFunction)PyImaging_MapBuffer, METH_VARARGS},
 
-/* Display support */
 #ifdef _WIN32
+    /* Display support */
     {"display", (PyCFunction)PyImaging_DisplayWin32, METH_VARARGS},
     {"display_mode", (PyCFunction)PyImaging_DisplayModeWin32, METH_VARARGS},
     {"grabscreen_win32", (PyCFunction)PyImaging_GrabScreenWin32, METH_VARARGS},
@@ -4235,21 +4234,21 @@ static PyMethodDef functions[] = {
     /* Utilities */
     {"getcodecstatus", (PyCFunction)_getcodecstatus, METH_VARARGS},
 
-/* Special effects (experimental) */
+    /* Special effects (experimental) */
     {"effect_mandelbrot", (PyCFunction)_effect_mandelbrot, METH_VARARGS},
     {"effect_noise", (PyCFunction)_effect_noise, METH_VARARGS},
     {"linear_gradient", (PyCFunction)_linear_gradient, METH_VARARGS},
     {"radial_gradient", (PyCFunction)_radial_gradient, METH_VARARGS},
     {"wedge", (PyCFunction)_linear_gradient, METH_VARARGS}, /* Compatibility */
 
-/* Drawing support stuff */
+    /* Drawing support stuff */
     {"font", (PyCFunction)_font_new, METH_VARARGS},
     {"draw", (PyCFunction)_draw_new, METH_VARARGS},
 
-/* Experimental path stuff */
+    /* Experimental path stuff */
     {"path", (PyCFunction)PyPath_Create, METH_VARARGS},
 
-/* Experimental arrow graphics stuff */
+    /* Experimental arrow graphics stuff */
     {"outline", (PyCFunction)PyOutline_Create, METH_VARARGS},
 
     /* Resource management */

From dc53356c1a9dd222e504d390861fdac7368bb300 Mon Sep 17 00:00:00 2001
From: Aleksandr Karpinskii <homm86@gmail.com>
Date: Sun, 7 Jul 2024 23:47:21 +0400
Subject: [PATCH 0870/1178] Not needed since memcpy is used here

---
 src/libImaging/Pack.c | 11 -----------
 1 file changed, 11 deletions(-)

diff --git a/src/libImaging/Pack.c b/src/libImaging/Pack.c
index f3b71421595..c29473d90db 100644
--- a/src/libImaging/Pack.c
+++ b/src/libImaging/Pack.c
@@ -258,16 +258,6 @@ void
 ImagingPackRGB(UINT8 *out, const UINT8 *in, int pixels) {
     int i = 0;
     /* RGB triplets */
-#ifdef __sparc
-    /* SPARC CPUs cannot read integers from nonaligned addresses. */
-    for (; i < pixels; i++) {
-        out[0] = in[R];
-        out[1] = in[G];
-        out[2] = in[B];
-        out += 3;
-        in += 4;
-    }
-#else
     for (; i < pixels - 1; i++) {
         memcpy(out, in + i * 4, 4);
         out += 3;
@@ -278,7 +268,6 @@ ImagingPackRGB(UINT8 *out, const UINT8 *in, int pixels) {
         out[2] = in[i * 4 + B];
         out += 3;
     }
-#endif
 }
 
 void

From d00fb87fa3b06776c14b882d0b39f737c39ec8da Mon Sep 17 00:00:00 2001
From: Aleksandr Karpinskii <homm86@gmail.com>
Date: Mon, 8 Jul 2024 11:08:32 +0400
Subject: [PATCH 0871/1178] Rename Not NO_OUTPUT to DEBUG, remove
 TEST_MERGESORT and TEST_SPLIT* flags

---
 src/libImaging/Quant.c | 106 +++++++++++++++++++----------------------
 1 file changed, 50 insertions(+), 56 deletions(-)

diff --git a/src/libImaging/Quant.c b/src/libImaging/Quant.c
index 197f9f3ee5b..595ee42a0e0 100644
--- a/src/libImaging/Quant.c
+++ b/src/libImaging/Quant.c
@@ -36,7 +36,8 @@
 #define UINT32_MAX 0xffffffff
 #endif
 
-#define NO_OUTPUT
+// #define DEBUG
+// #define TEST_NEAREST_NEIGHBOUR
 
 typedef struct {
     uint32_t scale;
@@ -144,7 +145,7 @@ create_pixel_hash(Pixel *pixelData, uint32_t nPixels) {
     PixelHashData *d;
     HashTable *hash;
     uint32_t i;
-#ifndef NO_OUTPUT
+#ifdef DEBUG
     uint32_t timer, timer2, timer3;
 #endif
 
@@ -156,7 +157,7 @@ create_pixel_hash(Pixel *pixelData, uint32_t nPixels) {
     hash = hashtable_new(pixel_hash, pixel_cmp);
     hashtable_set_user_data(hash, d);
     d->scale = 0;
-#ifndef NO_OUTPUT
+#ifdef DEBUG
     timer = timer3 = clock();
 #endif
     for (i = 0; i < nPixels; i++) {
@@ -167,22 +168,22 @@ create_pixel_hash(Pixel *pixelData, uint32_t nPixels) {
         }
         while (hashtable_get_count(hash) > MAX_HASH_ENTRIES) {
             d->scale++;
-#ifndef NO_OUTPUT
+#ifdef DEBUG
             printf("rehashing - new scale: %d\n", (int)d->scale);
             timer2 = clock();
 #endif
             hashtable_rehash_compute(hash, rehash_collide);
-#ifndef NO_OUTPUT
+#ifdef DEBUG
             timer2 = clock() - timer2;
             printf("rehash took %f sec\n", timer2 / (double)CLOCKS_PER_SEC);
             timer += timer2;
 #endif
         }
     }
-#ifndef NO_OUTPUT
+#ifdef DEBUG
     printf("inserts took %f sec\n", (clock() - timer) / (double)CLOCKS_PER_SEC);
 #endif
-#ifndef NO_OUTPUT
+#ifdef DEBUG
     printf("total        %f sec\n", (clock() - timer3) / (double)CLOCKS_PER_SEC);
 #endif
     return hash;
@@ -304,7 +305,7 @@ mergesort_pixels(PixelList *head, int i) {
     return head;
 }
 
-#if defined(TEST_MERGESORT) || defined(TEST_SORTED)
+#ifdef DEBUG
 static int
 test_sorted(PixelList *pl[3]) {
     int i, n, l;
@@ -347,12 +348,12 @@ splitlists(
     PixelList *l, *r, *c, *n;
     int i;
     int nRight;
-#ifndef NO_OUTPUT
+#ifdef DEBUG
     int nLeft;
 #endif
     int splitColourVal;
 
-#ifdef TEST_SPLIT
+#ifdef DEBUG
     {
         PixelList *_prevTest, *_nextTest;
         int _i, _nextCount[3], _prevCount[3];
@@ -402,14 +403,14 @@ splitlists(
 #endif
     nCount[0] = nCount[1] = 0;
     nRight = 0;
-#ifndef NO_OUTPUT
+#ifdef DEBUG
     nLeft = 0;
 #endif
     for (left = 0, c = h[axis]; c;) {
         left = left + c->count;
         nCount[0] += c->count;
         c->flag = 0;
-#ifndef NO_OUTPUT
+#ifdef DEBUG
         nLeft++;
 #endif
         c = c->next[axis];
@@ -424,7 +425,7 @@ splitlists(
                 break;
             }
             c->flag = 0;
-#ifndef NO_OUTPUT
+#ifdef DEBUG
             nLeft++;
 #endif
             nCount[0] += c->count;
@@ -442,14 +443,14 @@ splitlists(
             }
             c->flag = 1;
             nRight++;
-#ifndef NO_OUTPUT
+#ifdef DEBUG
             nLeft--;
 #endif
             nCount[0] -= c->count;
             nCount[1] += c->count;
         }
     }
-#ifndef NO_OUTPUT
+#ifdef DEBUG
     if (!nLeft) {
         for (c = h[axis]; c; c = c->next[axis]) {
             printf("[%d %d %d]\n", c->p.c.r, c->p.c.g, c->p.c.b);
@@ -511,7 +512,7 @@ split(BoxNode *node) {
     gl = node->tail[1]->p.c.g;
     bh = node->head[2]->p.c.b;
     bl = node->tail[2]->p.c.b;
-#ifdef TEST_SPLIT
+#ifdef DEBUG
     printf("splitting node [%d %d %d] [%d %d %d] ", rl, gl, bl, rh, gh, bh);
 #endif
     f[0] = (rh - rl) * 77;
@@ -526,11 +527,8 @@ split(BoxNode *node) {
             axis = i;
         }
     }
-#ifdef TEST_SPLIT
+#ifdef DEBUG
     printf("along axis %d\n", axis + 1);
-#endif
-
-#ifdef TEST_SPLIT
     {
         PixelList *_prevTest, *_nextTest;
         int _i, _nextCount[3], _prevCount[3];
@@ -592,12 +590,12 @@ split(BoxNode *node) {
     if (!splitlists(
             node->head, node->tail, heads, tails, newCounts, axis, node->pixelCount
         )) {
-#ifndef NO_OUTPUT
+#ifdef DEBUG
         printf("list split failed.\n");
 #endif
         return 0;
     }
-#ifdef TEST_SPLIT
+#ifdef DEBUG
     if (!test_sorted(heads[0])) {
         printf("bug in split");
         exit(1);
@@ -623,7 +621,7 @@ split(BoxNode *node) {
         node->head[i] = NULL;
         node->tail[i] = NULL;
     }
-#ifdef TEST_SPLIT
+#ifdef DEBUG
     if (left->head[0]) {
         rh = left->head[0]->p.c.r;
         rl = left->tail[0]->p.c.r;
@@ -687,7 +685,7 @@ median_cut(PixelList *hl[3], uint32_t imPixelCount, int nPixels) {
             }
         } while (compute_box_volume(thisNode) == 1);
         if (!split(thisNode)) {
-#ifndef NO_OUTPUT
+#ifdef DEBUG
             printf("Oops, split failed...\n");
 #endif
             exit(1);
@@ -716,16 +714,14 @@ free_box_tree(BoxNode *n) {
     free(n);
 }
 
-#ifdef TEST_SPLIT_INTEGRITY
+#ifdef DEBUG
 static int
 checkContained(BoxNode *n, Pixel *pp) {
     if (n->l && n->r) {
         return checkContained(n->l, pp) + checkContained(n->r, pp);
     }
     if (n->l || n->r) {
-#ifndef NO_OUTPUT
         printf("box tree is dead\n");
-#endif
         return 0;
     }
     if (pp->c.r <= n->head[0]->p.c.r && pp->c.r >= n->tail[0]->p.c.r &&
@@ -746,7 +742,7 @@ annotate_hash_table(BoxNode *n, HashTable *h, uint32_t *box) {
         return annotate_hash_table(n->l, h, box) && annotate_hash_table(n->r, h, box);
     }
     if (n->l || n->r) {
-#ifndef NO_OUTPUT
+#ifdef DEBUG
         printf("box tree is dead\n");
 #endif
         return 0;
@@ -754,7 +750,7 @@ annotate_hash_table(BoxNode *n, HashTable *h, uint32_t *box) {
     for (p = n->head[0]; p; p = p->next[0]) {
         PIXEL_UNSCALE(&(p->p), &q, d->scale);
         if (!hashtable_insert(h, q, *box)) {
-#ifndef NO_OUTPUT
+#ifdef DEBUG
             printf("hashtable insert failed\n");
 #endif
             return 0;
@@ -978,7 +974,7 @@ map_image_pixels_from_median_box(
             continue;
         }
         if (!hashtable_lookup(medianBoxHash, pixelData[i], &pixelVal)) {
-#ifndef NO_OUTPUT
+#ifdef DEBUG
             printf("pixel lookup failed\n");
 #endif
             return 0;
@@ -1043,7 +1039,7 @@ compute_palette_from_median_cut(
         }
     }
     for (i = 0; i < nPixels; i++) {
-#ifdef TEST_SPLIT_INTEGRITY
+#ifdef DEBUG
         if (!(i % 100)) {
             printf("%05d\r", i);
             fflush(stdout);
@@ -1058,7 +1054,7 @@ compute_palette_from_median_cut(
         }
 #endif
         if (!hashtable_lookup(medianBoxHash, pixelData[i], &paletteEntry)) {
-#ifndef NO_OUTPUT
+#ifdef DEBUG
             printf("pixel lookup failed\n");
 #endif
             for (i = 0; i < 3; i++) {
@@ -1068,7 +1064,7 @@ compute_palette_from_median_cut(
             return 0;
         }
         if (paletteEntry >= nPaletteEntries) {
-#ifndef NO_OUTPUT
+#ifdef DEBUG
             printf(
                 "panic - paletteEntry>=nPaletteEntries (%d>=%d)\n",
                 (int)paletteEntry,
@@ -1140,7 +1136,7 @@ compute_palette_from_quantized_pixels(
     }
     for (i = 0; i < nPixels; i++) {
         if (qp[i] >= nPaletteEntries) {
-#ifndef NO_OUTPUT
+#ifdef DEBUG
             printf("scream\n");
 #endif
             return 0;
@@ -1208,7 +1204,7 @@ k_means(
         goto error_2;
     }
 
-#ifndef NO_OUTPUT
+#ifdef DEBUG
     printf("[");
     fflush(stdout);
 #endif
@@ -1243,7 +1239,7 @@ k_means(
         if (changes < 0) {
             goto error_3;
         }
-#ifndef NO_OUTPUT
+#ifdef DEBUG
         printf(".(%d)", changes);
         fflush(stdout);
 #endif
@@ -1251,7 +1247,7 @@ k_means(
             break;
         }
     }
-#ifndef NO_OUTPUT
+#ifdef DEBUG
     printf("]\n");
 #endif
     if (avgDistSortKey) {
@@ -1311,32 +1307,32 @@ quantize(
     uint32_t **avgDistSortKey;
     Pixel *p;
 
-#ifndef NO_OUTPUT
+#ifdef DEBUG
     uint32_t timer, timer2;
 #endif
 
-#ifndef NO_OUTPUT
+#ifdef DEBUG
     timer2 = clock();
     printf("create hash table...");
     fflush(stdout);
     timer = clock();
 #endif
     h = create_pixel_hash(pixelData, nPixels);
-#ifndef NO_OUTPUT
+#ifdef DEBUG
     printf("done (%f)\n", (clock() - timer) / (double)CLOCKS_PER_SEC);
 #endif
     if (!h) {
         goto error_0;
     }
 
-#ifndef NO_OUTPUT
+#ifdef DEBUG
     printf("create lists from hash table...");
     fflush(stdout);
     timer = clock();
 #endif
     hl[0] = hl[1] = hl[2] = NULL;
     hashtable_foreach(h, hash_to_list, hl);
-#ifndef NO_OUTPUT
+#ifdef DEBUG
     printf("done (%f)\n", (clock() - timer) / (double)CLOCKS_PER_SEC);
 #endif
 
@@ -1344,7 +1340,7 @@ quantize(
         goto error_1;
     }
 
-#ifndef NO_OUTPUT
+#ifdef DEBUG
     printf("mergesort lists...");
     fflush(stdout);
     timer = clock();
@@ -1352,39 +1348,37 @@ quantize(
     for (i = 0; i < 3; i++) {
         hl[i] = mergesort_pixels(hl[i], i);
     }
-#ifdef TEST_MERGESORT
+#ifdef DEBUG
     if (!test_sorted(hl)) {
         printf("bug in mergesort\n");
         goto error_1;
     }
-#endif
-#ifndef NO_OUTPUT
     printf("done (%f)\n", (clock() - timer) / (double)CLOCKS_PER_SEC);
 #endif
 
-#ifndef NO_OUTPUT
+#ifdef DEBUG
     printf("median cut...");
     fflush(stdout);
     timer = clock();
 #endif
     root = median_cut(hl, nPixels, nQuantPixels);
-#ifndef NO_OUTPUT
+#ifdef DEBUG
     printf("done (%f)\n", (clock() - timer) / (double)CLOCKS_PER_SEC);
 #endif
     if (!root) {
         goto error_1;
     }
     nPaletteEntries = 0;
-#ifndef NO_OUTPUT
+#ifdef DEBUG
     printf("median cut tree to hash table...");
     fflush(stdout);
     timer = clock();
 #endif
     annotate_hash_table(root, h, &nPaletteEntries);
-#ifndef NO_OUTPUT
+#ifdef DEBUG
     printf("done (%f)\n", (clock() - timer) / (double)CLOCKS_PER_SEC);
 #endif
-#ifndef NO_OUTPUT
+#ifdef DEBUG
     printf("compute palette...\n");
     fflush(stdout);
     timer = clock();
@@ -1392,7 +1386,7 @@ quantize(
     if (!compute_palette_from_median_cut(pixelData, nPixels, h, &p, nPaletteEntries)) {
         goto error_3;
     }
-#ifndef NO_OUTPUT
+#ifdef DEBUG
     printf("done (%f)\n", (clock() - timer) / (double)CLOCKS_PER_SEC);
 #endif
 
@@ -1479,7 +1473,7 @@ quantize(
         hashtable_free(h2);
     }
 #endif
-#ifndef NO_OUTPUT
+#ifdef DEBUG
     printf("k means...\n");
     fflush(stdout);
     timer = clock();
@@ -1487,7 +1481,7 @@ quantize(
     if (kmeans > 0) {
         k_means(pixelData, nPixels, p, nPaletteEntries, qp, kmeans - 1);
     }
-#ifndef NO_OUTPUT
+#ifdef DEBUG
     printf("done (%f)\n", (clock() - timer) / (double)CLOCKS_PER_SEC);
 #endif
 
@@ -1495,7 +1489,7 @@ quantize(
     *palette = p;
     *paletteLength = nPaletteEntries;
 
-#ifndef NO_OUTPUT
+#ifdef DEBUG
     printf("cleanup...");
     fflush(stdout);
     timer = clock();
@@ -1507,7 +1501,7 @@ quantize(
         free(avgDistSortKey);
     }
     destroy_pixel_hash(h);
-#ifndef NO_OUTPUT
+#ifdef DEBUG
     printf("done (%f)\n", (clock() - timer) / (double)CLOCKS_PER_SEC);
     printf("-----\ntotal time %f\n", (clock() - timer2) / (double)CLOCKS_PER_SEC);
 #endif

From a6d83ec9ccc23284bf5274325591499500e269d7 Mon Sep 17 00:00:00 2001
From: Aleksandr Karpinskii <homm86@gmail.com>
Date: Sun, 28 Jul 2024 17:09:31 +0400
Subject: [PATCH 0872/1178] Add relesenotes

---
 docs/releasenotes/11.0.0.rst | 7 +++++++
 1 file changed, 7 insertions(+)

diff --git a/docs/releasenotes/11.0.0.rst b/docs/releasenotes/11.0.0.rst
index bb6179de8c6..936a441d9d5 100644
--- a/docs/releasenotes/11.0.0.rst
+++ b/docs/releasenotes/11.0.0.rst
@@ -77,3 +77,10 @@ others prepare for 3.13, and to ensure Pillow could be used immediately at the r
 of 3.13.0 final (2024-10-01, :pep:`719`).
 
 Pillow 11.0.0 now officially supports Python 3.13.
+
+C-level Flags
+^^^^^^^^^^^^^
+
+Some compiling flags like ``WITH_THREADING``, ``WITH_IMAGECHOPS``, and other
+``WITH_*`` were removed. These flags were not available in the build system,
+but they could be edited in the C source.

From 302962dae10b7dcae7e373ba8193e846211f3922 Mon Sep 17 00:00:00 2001
From: Aleksandr Karpinskii <homm86@gmail.com>
Date: Sun, 28 Jul 2024 17:19:50 +0400
Subject: [PATCH 0873/1178] Updated comments

by @radarhere, lost during rebase
---
 docs/releasenotes/11.0.0.rst | 2 +-
 src/_imaging.c               | 4 ++--
 2 files changed, 3 insertions(+), 3 deletions(-)

diff --git a/docs/releasenotes/11.0.0.rst b/docs/releasenotes/11.0.0.rst
index 936a441d9d5..f30442aef30 100644
--- a/docs/releasenotes/11.0.0.rst
+++ b/docs/releasenotes/11.0.0.rst
@@ -82,5 +82,5 @@ C-level Flags
 ^^^^^^^^^^^^^
 
 Some compiling flags like ``WITH_THREADING``, ``WITH_IMAGECHOPS``, and other
-``WITH_*`` were removed. These flags were not available in the build system,
+``WITH_*`` were removed. These flags were not available through the build system,
 but they could be edited in the C source.
diff --git a/src/_imaging.c b/src/_imaging.c
index 91cae2e5d91..b24776ead25 100644
--- a/src/_imaging.c
+++ b/src/_imaging.c
@@ -2613,7 +2613,7 @@ _chop_overlay(ImagingObject *self, PyObject *args) {
     return PyImagingNew(ImagingOverlay(self->image, imagep->image));
 }
 
-/* Graphics (ImageDraw) ----------------------------------------------- */
+/* Fonts (ImageDraw and ImageFont) ------------------------------------ */
 
 static PyObject *
 _font_new(PyObject *self_, PyObject *args) {
@@ -2842,7 +2842,7 @@ static struct PyMethodDef _font_methods[] = {
     {NULL, NULL} /* sentinel */
 };
 
-/* -------------------------------------------------------------------- */
+/* Graphics (ImageDraw) ----------------------------------------------- */
 
 static PyObject *
 _draw_new(PyObject *self_, PyObject *args) {

From 6420f73613dce5533e2d8a417f8d7fede98de07e Mon Sep 17 00:00:00 2001
From: Andrew Murray <radarhere@users.noreply.github.com>
Date: Mon, 29 Jul 2024 23:46:07 +1000
Subject: [PATCH 0874/1178] Added type hints

---
 src/PIL/Image.py             |  6 +++-
 src/PIL/ImageDraw2.py        |  2 +-
 src/PIL/ImageFont.py         |  6 ++--
 src/PIL/ImagePalette.py      |  2 +-
 src/PIL/Jpeg2KImagePlugin.py |  2 +-
 src/PIL/PdfImagePlugin.py    | 45 +++++++++++++++-----------
 src/PIL/TiffImagePlugin.py   | 61 ++++++++++++++++++++----------------
 7 files changed, 71 insertions(+), 53 deletions(-)

diff --git a/src/PIL/Image.py b/src/PIL/Image.py
index eb3dd5a36f9..ae8634539e8 100644
--- a/src/PIL/Image.py
+++ b/src/PIL/Image.py
@@ -2052,7 +2052,11 @@ def putpalette(
             msg = "illegal image mode"
             raise ValueError(msg)
         if isinstance(data, ImagePalette.ImagePalette):
-            palette = ImagePalette.raw(data.rawmode, data.palette)
+            if data.rawmode is not None:
+                palette = ImagePalette.raw(data.rawmode, data.palette)
+            else:
+                palette = ImagePalette.ImagePalette(palette=data.palette)
+                palette.dirty = 1
         else:
             if not isinstance(data, bytes):
                 data = bytes(data)
diff --git a/src/PIL/ImageDraw2.py b/src/PIL/ImageDraw2.py
index 1ad239382cb..58302f95050 100644
--- a/src/PIL/ImageDraw2.py
+++ b/src/PIL/ImageDraw2.py
@@ -167,7 +167,7 @@ def polygon(self, xy: Coords, *options: Any) -> None:
         """
         self.render("polygon", xy, *options)
 
-    def rectangle(self, xy: Coords, *options) -> None:
+    def rectangle(self, xy: Coords, *options: Any) -> None:
         """
         Draws a rectangle.
 
diff --git a/src/PIL/ImageFont.py b/src/PIL/ImageFont.py
index 24490348c32..2ab65bfefe4 100644
--- a/src/PIL/ImageFont.py
+++ b/src/PIL/ImageFont.py
@@ -269,12 +269,12 @@ def load_from_bytes(f) -> None:
         else:
             load_from_bytes(font)
 
-    def __getstate__(self):
+    def __getstate__(self) -> list[Any]:
         return [self.path, self.size, self.index, self.encoding, self.layout_engine]
 
-    def __setstate__(self, state):
+    def __setstate__(self, state: list[Any]) -> None:
         path, size, index, encoding, layout_engine = state
-        self.__init__(path, size, index, encoding, layout_engine)
+        FreeTypeFont.__init__(self, path, size, index, encoding, layout_engine)
 
     def getname(self) -> tuple[str | None, str | None]:
         """
diff --git a/src/PIL/ImagePalette.py b/src/PIL/ImagePalette.py
index 8ccecbd07ca..183f85526d2 100644
--- a/src/PIL/ImagePalette.py
+++ b/src/PIL/ImagePalette.py
@@ -208,7 +208,7 @@ def save(self, fp: str | IO[str]) -> None:
 # Internal
 
 
-def raw(rawmode, data: Sequence[int] | bytes | bytearray) -> ImagePalette:
+def raw(rawmode: str, data: Sequence[int] | bytes | bytearray) -> ImagePalette:
     palette = ImagePalette()
     palette.rawmode = rawmode
     palette.palette = data
diff --git a/src/PIL/Jpeg2KImagePlugin.py b/src/PIL/Jpeg2KImagePlugin.py
index eeec41686ca..ef9107f0073 100644
--- a/src/PIL/Jpeg2KImagePlugin.py
+++ b/src/PIL/Jpeg2KImagePlugin.py
@@ -324,7 +324,7 @@ def reduce(self):
         return self._reduce or super().reduce
 
     @reduce.setter
-    def reduce(self, value):
+    def reduce(self, value: int) -> None:
         self._reduce = value
 
     def load(self) -> Image.core.PixelAccess | None:
diff --git a/src/PIL/PdfImagePlugin.py b/src/PIL/PdfImagePlugin.py
index e0f732199bc..7fc1108bb84 100644
--- a/src/PIL/PdfImagePlugin.py
+++ b/src/PIL/PdfImagePlugin.py
@@ -25,7 +25,7 @@
 import math
 import os
 import time
-from typing import IO
+from typing import IO, Any
 
 from . import Image, ImageFile, ImageSequence, PdfParser, __version__, features
 
@@ -48,7 +48,12 @@ def _save_all(im: Image.Image, fp: IO[bytes], filename: str | bytes) -> None:
 # (Internal) Image save plugin for the PDF format.
 
 
-def _write_image(im, filename, existing_pdf, image_refs):
+def _write_image(
+    im: Image.Image,
+    filename: str | bytes,
+    existing_pdf: PdfParser.PdfParser,
+    image_refs: list[PdfParser.IndirectReference],
+) -> tuple[PdfParser.IndirectReference, str]:
     # FIXME: Should replace ASCIIHexDecode with RunLengthDecode
     # (packbits) or LZWDecode (tiff/lzw compression).  Note that
     # PDF 1.2 also supports Flatedecode (zip compression).
@@ -61,10 +66,10 @@ def _write_image(im, filename, existing_pdf, image_refs):
 
     width, height = im.size
 
-    dict_obj = {"BitsPerComponent": 8}
+    dict_obj: dict[str, Any] = {"BitsPerComponent": 8}
     if im.mode == "1":
         if features.check("libtiff"):
-            filter = "CCITTFaxDecode"
+            decode_filter = "CCITTFaxDecode"
             dict_obj["BitsPerComponent"] = 1
             params = PdfParser.PdfArray(
                 [
@@ -79,22 +84,23 @@ def _write_image(im, filename, existing_pdf, image_refs):
                 ]
             )
         else:
-            filter = "DCTDecode"
+            decode_filter = "DCTDecode"
         dict_obj["ColorSpace"] = PdfParser.PdfName("DeviceGray")
         procset = "ImageB"  # grayscale
     elif im.mode == "L":
-        filter = "DCTDecode"
+        decode_filter = "DCTDecode"
         # params = f"<< /Predictor 15 /Columns {width-2} >>"
         dict_obj["ColorSpace"] = PdfParser.PdfName("DeviceGray")
         procset = "ImageB"  # grayscale
     elif im.mode == "LA":
-        filter = "JPXDecode"
+        decode_filter = "JPXDecode"
         # params = f"<< /Predictor 15 /Columns {width-2} >>"
         procset = "ImageB"  # grayscale
         dict_obj["SMaskInData"] = 1
     elif im.mode == "P":
-        filter = "ASCIIHexDecode"
+        decode_filter = "ASCIIHexDecode"
         palette = im.getpalette()
+        assert palette is not None
         dict_obj["ColorSpace"] = [
             PdfParser.PdfName("Indexed"),
             PdfParser.PdfName("DeviceRGB"),
@@ -110,15 +116,15 @@ def _write_image(im, filename, existing_pdf, image_refs):
             image_ref = _write_image(smask, filename, existing_pdf, image_refs)[0]
             dict_obj["SMask"] = image_ref
     elif im.mode == "RGB":
-        filter = "DCTDecode"
+        decode_filter = "DCTDecode"
         dict_obj["ColorSpace"] = PdfParser.PdfName("DeviceRGB")
         procset = "ImageC"  # color images
     elif im.mode == "RGBA":
-        filter = "JPXDecode"
+        decode_filter = "JPXDecode"
         procset = "ImageC"  # color images
         dict_obj["SMaskInData"] = 1
     elif im.mode == "CMYK":
-        filter = "DCTDecode"
+        decode_filter = "DCTDecode"
         dict_obj["ColorSpace"] = PdfParser.PdfName("DeviceCMYK")
         procset = "ImageC"  # color images
         decode = [1, 0, 1, 0, 1, 0, 1, 0]
@@ -131,9 +137,9 @@ def _write_image(im, filename, existing_pdf, image_refs):
 
     op = io.BytesIO()
 
-    if filter == "ASCIIHexDecode":
+    if decode_filter == "ASCIIHexDecode":
         ImageFile._save(im, op, [("hex", (0, 0) + im.size, 0, im.mode)])
-    elif filter == "CCITTFaxDecode":
+    elif decode_filter == "CCITTFaxDecode":
         im.save(
             op,
             "TIFF",
@@ -141,21 +147,22 @@ def _write_image(im, filename, existing_pdf, image_refs):
             # use a single strip
             strip_size=math.ceil(width / 8) * height,
         )
-    elif filter == "DCTDecode":
+    elif decode_filter == "DCTDecode":
         Image.SAVE["JPEG"](im, op, filename)
-    elif filter == "JPXDecode":
+    elif decode_filter == "JPXDecode":
         del dict_obj["BitsPerComponent"]
         Image.SAVE["JPEG2000"](im, op, filename)
     else:
-        msg = f"unsupported PDF filter ({filter})"
+        msg = f"unsupported PDF filter ({decode_filter})"
         raise ValueError(msg)
 
     stream = op.getvalue()
-    if filter == "CCITTFaxDecode":
+    filter: PdfParser.PdfArray | PdfParser.PdfName
+    if decode_filter == "CCITTFaxDecode":
         stream = stream[8:]
-        filter = PdfParser.PdfArray([PdfParser.PdfName(filter)])
+        filter = PdfParser.PdfArray([PdfParser.PdfName(decode_filter)])
     else:
-        filter = PdfParser.PdfName(filter)
+        filter = PdfParser.PdfName(decode_filter)
 
     image_ref = image_refs.pop(0)
     existing_pdf.write_obj(
diff --git a/src/PIL/TiffImagePlugin.py b/src/PIL/TiffImagePlugin.py
index 318e9825ca8..dd013a0cf45 100644
--- a/src/PIL/TiffImagePlugin.py
+++ b/src/PIL/TiffImagePlugin.py
@@ -47,16 +47,18 @@
 import os
 import struct
 import warnings
-from collections.abc import MutableMapping
+from collections.abc import Iterator, MutableMapping
 from fractions import Fraction
 from numbers import Number, Rational
-from typing import IO, TYPE_CHECKING, Any, Callable, NoReturn
+from typing import IO, TYPE_CHECKING, Any, Callable, NoReturn, cast
 
 from . import ExifTags, Image, ImageFile, ImageOps, ImagePalette, TiffTags
 from ._binary import i16be as i16
 from ._binary import i32be as i32
 from ._binary import o8
 from ._deprecate import deprecate
+from ._typing import StrOrBytesPath
+from ._util import is_path
 from .TiffTags import TYPES
 
 logger = logging.getLogger(__name__)
@@ -313,7 +315,7 @@ def _limit_signed_rational(val, max_val, min_val):
 _write_dispatch = {}
 
 
-def _delegate(op):
+def _delegate(op: str):
     def delegate(self, *args):
         return getattr(self._val, op)(*args)
 
@@ -334,7 +336,9 @@ class IFDRational(Rational):
 
     __slots__ = ("_numerator", "_denominator", "_val")
 
-    def __init__(self, value, denominator: int = 1) -> None:
+    def __init__(
+        self, value: float | Fraction | IFDRational, denominator: int = 1
+    ) -> None:
         """
         :param value: either an integer numerator, a
         float/rational/other number, or an IFDRational
@@ -358,18 +362,20 @@ def __init__(self, value, denominator: int = 1) -> None:
             self._val = float("nan")
         elif denominator == 1:
             self._val = Fraction(value)
+        elif int(value) == value:
+            self._val = Fraction(int(value), denominator)
         else:
-            self._val = Fraction(value, denominator)
+            self._val = Fraction(value / denominator)
 
     @property
     def numerator(self):
         return self._numerator
 
     @property
-    def denominator(self):
+    def denominator(self) -> int:
         return self._denominator
 
-    def limit_rational(self, max_denominator):
+    def limit_rational(self, max_denominator: int) -> tuple[float, int]:
         """
 
         :param max_denominator: Integer, the maximum denominator value
@@ -379,6 +385,7 @@ def limit_rational(self, max_denominator):
         if self.denominator == 0:
             return self.numerator, self.denominator
 
+        assert isinstance(self._val, Fraction)
         f = self._val.limit_denominator(max_denominator)
         return f.numerator, f.denominator
 
@@ -396,14 +403,15 @@ def __eq__(self, other: object) -> bool:
             val = float(val)
         return val == other
 
-    def __getstate__(self):
+    def __getstate__(self) -> list[float | Fraction]:
         return [self._val, self._numerator, self._denominator]
 
-    def __setstate__(self, state):
+    def __setstate__(self, state: list[float | Fraction]) -> None:
         IFDRational.__init__(self, 0)
         _val, _numerator, _denominator = state
         self._val = _val
         self._numerator = _numerator
+        assert isinstance(_denominator, int)
         self._denominator = _denominator
 
     """ a = ['add','radd', 'sub', 'rsub', 'mul', 'rmul',
@@ -730,13 +738,13 @@ def __delitem__(self, tag: int) -> None:
         self._tags_v1.pop(tag, None)
         self._tagdata.pop(tag, None)
 
-    def __iter__(self):
+    def __iter__(self) -> Iterator[int]:
         return iter(set(self._tagdata) | set(self._tags_v2))
 
     def _unpack(self, fmt: str, data: bytes):
         return struct.unpack(self._endian + fmt, data)
 
-    def _pack(self, fmt: str, *values):
+    def _pack(self, fmt: str, *values) -> bytes:
         return struct.pack(self._endian + fmt, *values)
 
     list(
@@ -787,7 +795,7 @@ def write_string(self, value: str | bytes | int) -> bytes:
     def load_rational(self, data, legacy_api: bool = True):
         vals = self._unpack(f"{len(data) // 4}L", data)
 
-        def combine(a, b):
+        def combine(a: int, b: int) -> tuple[int, int] | IFDRational:
             return (a, b) if legacy_api else IFDRational(a, b)
 
         return tuple(combine(num, denom) for num, denom in zip(vals[::2], vals[1::2]))
@@ -814,7 +822,7 @@ def write_undefined(self, value: bytes | int | IFDRational) -> bytes:
     def load_signed_rational(self, data: bytes, legacy_api: bool = True):
         vals = self._unpack(f"{len(data) // 4}l", data)
 
-        def combine(a, b):
+        def combine(a: int, b: int) -> tuple[int, int] | IFDRational:
             return (a, b) if legacy_api else IFDRational(a, b)
 
         return tuple(combine(num, denom) for num, denom in zip(vals[::2], vals[1::2]))
@@ -903,11 +911,11 @@ def load(self, fp):
             warnings.warn(str(msg))
             return
 
-    def tobytes(self, offset=0):
+    def tobytes(self, offset: int = 0) -> bytes:
         # FIXME What about tagdata?
         result = self._pack("H", len(self._tags_v2))
 
-        entries = []
+        entries: list[tuple[int, int, int, bytes, bytes]] = []
         offset = offset + len(result) + len(self._tags_v2) * 12 + 4
         stripoffsets = None
 
@@ -916,7 +924,7 @@ def tobytes(self, offset=0):
         for tag, value in sorted(self._tags_v2.items()):
             if tag == STRIPOFFSETS:
                 stripoffsets = len(entries)
-            typ = self.tagtype.get(tag)
+            typ = self.tagtype[tag]
             logger.debug("Tag %s, Type: %s, Value: %s", tag, typ, repr(value))
             is_ifd = typ == TiffTags.LONG and isinstance(value, dict)
             if is_ifd:
@@ -1072,7 +1080,7 @@ def __contains__(self, tag: object) -> bool:
     def __len__(self) -> int:
         return len(set(self._tagdata) | set(self._tags_v1))
 
-    def __iter__(self):
+    def __iter__(self) -> Iterator[int]:
         return iter(set(self._tagdata) | set(self._tags_v1))
 
     def __setitem__(self, tag: int, value) -> None:
@@ -1943,17 +1951,18 @@ class AppendingTiffWriter:
         521,  # JPEGACTables
     }
 
-    def __init__(self, fn, new: bool = False) -> None:
-        if hasattr(fn, "read"):
-            self.f = fn
-            self.close_fp = False
-        else:
+    def __init__(self, fn: StrOrBytesPath | IO[bytes], new: bool = False) -> None:
+        self.f: IO[bytes]
+        if is_path(fn):
             self.name = fn
             self.close_fp = True
             try:
                 self.f = open(fn, "w+b" if new else "r+b")
             except OSError:
                 self.f = open(fn, "w+b")
+        else:
+            self.f = cast(IO[bytes], fn)
+            self.close_fp = False
         self.beginning = self.f.tell()
         self.setup()
 
@@ -1961,7 +1970,7 @@ def setup(self) -> None:
         # Reset everything.
         self.f.seek(self.beginning, os.SEEK_SET)
 
-        self.whereToWriteNewIFDOffset = None
+        self.whereToWriteNewIFDOffset: int | None = None
         self.offsetOfNewPage = 0
 
         self.IIMM = iimm = self.f.read(4)
@@ -2000,6 +2009,7 @@ def finalize(self) -> None:
 
         ifd_offset = self.readLong()
         ifd_offset += self.offsetOfNewPage
+        assert self.whereToWriteNewIFDOffset is not None
         self.f.seek(self.whereToWriteNewIFDOffset)
         self.writeLong(ifd_offset)
         self.f.seek(ifd_offset)
@@ -2020,7 +2030,7 @@ def __exit__(self, *args: object) -> None:
     def tell(self) -> int:
         return self.f.tell() - self.offsetOfNewPage
 
-    def seek(self, offset: int, whence=io.SEEK_SET) -> int:
+    def seek(self, offset: int, whence: int = io.SEEK_SET) -> int:
         if whence == os.SEEK_SET:
             offset += self.offsetOfNewPage
 
@@ -2111,7 +2121,6 @@ def fixIFD(self) -> None:
             field_size = self.fieldSizes[field_type]
             total_size = field_size * count
             is_local = total_size <= 4
-            offset: int | None
             if not is_local:
                 offset = self.readLong() + self.offsetOfNewPage
                 self.rewriteLastLong(offset)
@@ -2131,8 +2140,6 @@ def fixIFD(self) -> None:
                     )
                     self.f.seek(cur_pos)
 
-                offset = cur_pos = None
-
             elif is_local:
                 # skip the locally stored value that is not an offset
                 self.f.seek(4, os.SEEK_CUR)

From db5c4fbb2cb0978f58d503aadc6901c01c023a47 Mon Sep 17 00:00:00 2001
From: Andrew Murray <radarhere@users.noreply.github.com>
Date: Sat, 27 Jul 2024 18:41:37 +1000
Subject: [PATCH 0875/1178] Include required arguments

---
 src/PIL/ImageDraw2.py | 30 +++++++++++++++---------------
 1 file changed, 15 insertions(+), 15 deletions(-)

diff --git a/src/PIL/ImageDraw2.py b/src/PIL/ImageDraw2.py
index 58302f95050..6e848663bd1 100644
--- a/src/PIL/ImageDraw2.py
+++ b/src/PIL/ImageDraw2.py
@@ -80,7 +80,7 @@ def flush(self) -> Image.Image:
         return self.image
 
     def render(
-        self, op: str, xy: Coords, pen: Pen | Brush, brush: Brush | Pen | None = None
+        self, op: str, xy: Coords, pen: Pen | Brush | None, brush: Brush | Pen | None = None
     ) -> None:
         # handle color arguments
         outline = fill = None
@@ -111,50 +111,50 @@ def settransform(self, offset: tuple[float, float]) -> None:
         (xoffset, yoffset) = offset
         self.transform = (1, 0, xoffset, 0, 1, yoffset)
 
-    def arc(self, xy: Coords, start, end, *options: Any) -> None:
+    def arc(self, xy: Coords, pen: Pen | Brush | None, start, end, *options: Any) -> None:
         """
         Draws an arc (a portion of a circle outline) between the start and end
         angles, inside the given bounding box.
 
         .. seealso:: :py:meth:`PIL.ImageDraw.ImageDraw.arc`
         """
-        self.render("arc", xy, start, end, *options)
+        self.render("arc", xy, pen, start, end, *options)
 
-    def chord(self, xy: Coords, start, end, *options: Any) -> None:
+    def chord(self, xy: Coords, pen: Pen | Brush | None, start, end, *options: Any) -> None:
         """
         Same as :py:meth:`~PIL.ImageDraw2.Draw.arc`, but connects the end points
         with a straight line.
 
         .. seealso:: :py:meth:`PIL.ImageDraw.ImageDraw.chord`
         """
-        self.render("chord", xy, start, end, *options)
+        self.render("chord", xy, pen, start, end, *options)
 
-    def ellipse(self, xy: Coords, *options: Any) -> None:
+    def ellipse(self, xy: Coords, pen: Pen | Brush | None, *options: Any) -> None:
         """
         Draws an ellipse inside the given bounding box.
 
         .. seealso:: :py:meth:`PIL.ImageDraw.ImageDraw.ellipse`
         """
-        self.render("ellipse", xy, *options)
+        self.render("ellipse", xy, pen, *options)
 
-    def line(self, xy: Coords, *options: Any) -> None:
+    def line(self, xy: Coords, pen: Pen | Brush | None, *options: Any) -> None:
         """
         Draws a line between the coordinates in the ``xy`` list.
 
         .. seealso:: :py:meth:`PIL.ImageDraw.ImageDraw.line`
         """
-        self.render("line", xy, *options)
+        self.render("line", xy, pen, *options)
 
-    def pieslice(self, xy: Coords, start, end, *options: Any) -> None:
+    def pieslice(self, xy: Coords, pen: Pen | Brush | None, start, end, *options: Any) -> None:
         """
         Same as arc, but also draws straight lines between the end points and the
         center of the bounding box.
 
         .. seealso:: :py:meth:`PIL.ImageDraw.ImageDraw.pieslice`
         """
-        self.render("pieslice", xy, start, end, *options)
+        self.render("pieslice", xy, pen, start, end, *options)
 
-    def polygon(self, xy: Coords, *options: Any) -> None:
+    def polygon(self, xy: Coords, pen: Pen | Brush | None, *options: Any) -> None:
         """
         Draws a polygon.
 
@@ -165,15 +165,15 @@ def polygon(self, xy: Coords, *options: Any) -> None:
 
         .. seealso:: :py:meth:`PIL.ImageDraw.ImageDraw.polygon`
         """
-        self.render("polygon", xy, *options)
+        self.render("polygon", xy, pen, *options)
 
-    def rectangle(self, xy: Coords, *options: Any) -> None:
+    def rectangle(self, xy: Coords, pen: Pen | Brush | None, *options: Any) -> None:
         """
         Draws a rectangle.
 
         .. seealso:: :py:meth:`PIL.ImageDraw.ImageDraw.rectangle`
         """
-        self.render("rectangle", xy, *options)
+        self.render("rectangle", xy, pen, *options)
 
     def text(self, xy: tuple[float, float], text: AnyStr, font: Font) -> None:
         """

From b84e2a9935a49197012002122ad84a856940133a Mon Sep 17 00:00:00 2001
From: Andrew Murray <radarhere@users.noreply.github.com>
Date: Sat, 27 Jul 2024 18:55:17 +1000
Subject: [PATCH 0876/1178] Do not pass outline to arc

---
 src/PIL/ImageDraw2.py | 4 +++-
 1 file changed, 3 insertions(+), 1 deletion(-)

diff --git a/src/PIL/ImageDraw2.py b/src/PIL/ImageDraw2.py
index 6e848663bd1..97898ffd986 100644
--- a/src/PIL/ImageDraw2.py
+++ b/src/PIL/ImageDraw2.py
@@ -101,7 +101,9 @@ def render(
             path.transform(self.transform)
             xy = path
         # render the item
-        if op == "line":
+        if op == "arc":
+            self.draw.arc(xy, fill=outline)
+        elif op == "line":
             self.draw.line(xy, fill=outline, width=width)
         else:
             getattr(self.draw, op)(xy, fill=fill, outline=outline)

From 955854728acf3456866bbfa152920b5d81eb449a Mon Sep 17 00:00:00 2001
From: Andrew Murray <radarhere@users.noreply.github.com>
Date: Sat, 27 Jul 2024 18:44:13 +1000
Subject: [PATCH 0877/1178] Pass start and end to arc, chord and pieslice

---
 Tests/test_imagedraw2.py | 46 +++++++++++++++++++++++++++++++++++
 src/PIL/ImageDraw2.py    | 52 ++++++++++++++++++++++++++++++----------
 2 files changed, 86 insertions(+), 12 deletions(-)

diff --git a/Tests/test_imagedraw2.py b/Tests/test_imagedraw2.py
index c80aa739cdf..e0d368228a0 100644
--- a/Tests/test_imagedraw2.py
+++ b/Tests/test_imagedraw2.py
@@ -65,6 +65,36 @@ def test_mode() -> None:
         ImageDraw2.Draw("L")
 
 
+@pytest.mark.parametrize("bbox", BBOX)
+@pytest.mark.parametrize("start, end", ((0, 180), (0.5, 180.4)))
+def test_arc(bbox: Coords, start: float, end: float) -> None:
+    # Arrange
+    im = Image.new("RGB", (W, H))
+    draw = ImageDraw2.Draw(im)
+    pen = ImageDraw2.Pen("white", width=1)
+
+    # Act
+    draw.arc(bbox, pen, start, end)
+
+    # Assert
+    assert_image_similar_tofile(im, "Tests/images/imagedraw_arc.png", 1)
+
+
+@pytest.mark.parametrize("bbox", BBOX)
+def test_chord(bbox: Coords) -> None:
+    # Arrange
+    im = Image.new("RGB", (W, H))
+    draw = ImageDraw2.Draw(im)
+    pen = ImageDraw2.Pen("yellow")
+    brush = ImageDraw2.Brush("red")
+
+    # Act
+    draw.chord(bbox, pen, 0, 180, brush)
+
+    # Assert
+    assert_image_similar_tofile(im, "Tests/images/imagedraw_chord_RGB.png", 1)
+
+
 @pytest.mark.parametrize("bbox", BBOX)
 def test_ellipse(bbox: Coords) -> None:
     # Arrange
@@ -123,6 +153,22 @@ def test_line_pen_as_brush(points: Coords) -> None:
     assert_image_equal_tofile(im, "Tests/images/imagedraw_line.png")
 
 
+@pytest.mark.parametrize("bbox", BBOX)
+@pytest.mark.parametrize("start, end", ((-92, 46), (-92.2, 46.2)))
+def test_pieslice(bbox: Coords, start: float, end: float) -> None:
+    # Arrange
+    im = Image.new("RGB", (W, H))
+    draw = ImageDraw2.Draw(im)
+    pen = ImageDraw2.Pen("blue")
+    brush = ImageDraw2.Brush("white")
+
+    # Act
+    draw.pieslice(bbox, pen, start, end, brush)
+
+    # Assert
+    assert_image_similar_tofile(im, "Tests/images/imagedraw_pieslice.png", 1)
+
+
 @pytest.mark.parametrize("points", POINTS)
 def test_polygon(points: Coords) -> None:
     # Arrange
diff --git a/src/PIL/ImageDraw2.py b/src/PIL/ImageDraw2.py
index 97898ffd986..3d68658ed5b 100644
--- a/src/PIL/ImageDraw2.py
+++ b/src/PIL/ImageDraw2.py
@@ -80,7 +80,12 @@ def flush(self) -> Image.Image:
         return self.image
 
     def render(
-        self, op: str, xy: Coords, pen: Pen | Brush | None, brush: Brush | Pen | None = None
+        self,
+        op: str,
+        xy: Coords,
+        pen: Pen | Brush | None,
+        brush: Brush | Pen | None = None,
+        **kwargs: Any,
     ) -> None:
         # handle color arguments
         outline = fill = None
@@ -101,35 +106,51 @@ def render(
             path.transform(self.transform)
             xy = path
         # render the item
-        if op == "arc":
-            self.draw.arc(xy, fill=outline)
-        elif op == "line":
-            self.draw.line(xy, fill=outline, width=width)
+        if op in ("arc", "line"):
+            kwargs.setdefault("fill", outline)
         else:
-            getattr(self.draw, op)(xy, fill=fill, outline=outline)
+            kwargs.setdefault("fill", fill)
+            kwargs.setdefault("outline", outline)
+        if op == "line":
+            kwargs.setdefault("width", width)
+        getattr(self.draw, op)(xy, **kwargs)
 
     def settransform(self, offset: tuple[float, float]) -> None:
         """Sets a transformation offset."""
         (xoffset, yoffset) = offset
         self.transform = (1, 0, xoffset, 0, 1, yoffset)
 
-    def arc(self, xy: Coords, pen: Pen | Brush | None, start, end, *options: Any) -> None:
+    def arc(
+        self,
+        xy: Coords,
+        pen: Pen | Brush | None,
+        start: float,
+        end: float,
+        *options: Any,
+    ) -> None:
         """
         Draws an arc (a portion of a circle outline) between the start and end
         angles, inside the given bounding box.
 
         .. seealso:: :py:meth:`PIL.ImageDraw.ImageDraw.arc`
         """
-        self.render("arc", xy, pen, start, end, *options)
+        self.render("arc", xy, pen, *options, start=start, end=end)
 
-    def chord(self, xy: Coords, pen: Pen | Brush | None, start, end, *options: Any) -> None:
+    def chord(
+        self,
+        xy: Coords,
+        pen: Pen | Brush | None,
+        start: float,
+        end: float,
+        *options: Any,
+    ) -> None:
         """
         Same as :py:meth:`~PIL.ImageDraw2.Draw.arc`, but connects the end points
         with a straight line.
 
         .. seealso:: :py:meth:`PIL.ImageDraw.ImageDraw.chord`
         """
-        self.render("chord", xy, pen, start, end, *options)
+        self.render("chord", xy, pen, *options, start=start, end=end)
 
     def ellipse(self, xy: Coords, pen: Pen | Brush | None, *options: Any) -> None:
         """
@@ -147,14 +168,21 @@ def line(self, xy: Coords, pen: Pen | Brush | None, *options: Any) -> None:
         """
         self.render("line", xy, pen, *options)
 
-    def pieslice(self, xy: Coords, pen: Pen | Brush | None, start, end, *options: Any) -> None:
+    def pieslice(
+        self,
+        xy: Coords,
+        pen: Pen | Brush | None,
+        start: float,
+        end: float,
+        *options: Any,
+    ) -> None:
         """
         Same as arc, but also draws straight lines between the end points and the
         center of the bounding box.
 
         .. seealso:: :py:meth:`PIL.ImageDraw.ImageDraw.pieslice`
         """
-        self.render("pieslice", xy, pen, start, end, *options)
+        self.render("pieslice", xy, pen, *options, start=start, end=end)
 
     def polygon(self, xy: Coords, pen: Pen | Brush | None, *options: Any) -> None:
         """

From accfaf1c092517f7f3918c33b8f9fc38f9ae6a62 Mon Sep 17 00:00:00 2001
From: Andrew Murray <radarhere@users.noreply.github.com>
Date: Tue, 30 Jul 2024 20:20:09 +1000
Subject: [PATCH 0878/1178] Added type hints

---
 Tests/test_file_jpeg.py    |  2 +-
 Tests/test_image.py        |  2 +-
 docs/reference/plugins.rst |  8 +++++++
 src/PIL/EpsImagePlugin.py  | 20 ++++++++++++----
 src/PIL/Image.py           | 48 +++++++++++++++++++++-----------------
 src/PIL/ImageFile.py       | 19 +++++++++++----
 src/PIL/JpegImagePlugin.py | 25 ++++++++++++--------
 src/PIL/PngImagePlugin.py  | 16 +++++++++----
 src/PIL/TiffImagePlugin.py | 14 +++++++----
 9 files changed, 101 insertions(+), 53 deletions(-)

diff --git a/Tests/test_file_jpeg.py b/Tests/test_file_jpeg.py
index 9660e28288a..b4b3f71cbb7 100644
--- a/Tests/test_file_jpeg.py
+++ b/Tests/test_file_jpeg.py
@@ -154,7 +154,7 @@ def test_cmyk(self) -> None:
             assert k > 0.9
 
     def test_rgb(self) -> None:
-        def getchannels(im: JpegImagePlugin.JpegImageFile) -> tuple[int, int, int]:
+        def getchannels(im: JpegImagePlugin.JpegImageFile) -> tuple[int, ...]:
             return tuple(v[0] for v in im.layer)
 
         im = hopper()
diff --git a/Tests/test_image.py b/Tests/test_image.py
index 4fdc4179170..d8372789be9 100644
--- a/Tests/test_image.py
+++ b/Tests/test_image.py
@@ -99,7 +99,7 @@ def text(self, text: str) -> None:
         im = Image.new("L", (100, 100))
 
         p = Pretty()
-        im._repr_pretty_(p, None)
+        im._repr_pretty_(p, False)
         assert p.pretty_output == "<PIL.Image.Image image mode=L size=100x100>"
 
     def test_open_formats(self) -> None:
diff --git a/docs/reference/plugins.rst b/docs/reference/plugins.rst
index 18cd99cf3a2..454b94d8ce7 100644
--- a/docs/reference/plugins.rst
+++ b/docs/reference/plugins.rst
@@ -185,6 +185,14 @@ Plugin reference
     :undoc-members:
     :show-inheritance:
 
+:mod:`~PIL.MpoImagePlugin` Module
+----------------------------------
+
+.. automodule:: PIL.MpoImagePlugin
+    :members:
+    :undoc-members:
+    :show-inheritance:
+
 :mod:`~PIL.MspImagePlugin` Module
 ---------------------------------
 
diff --git a/src/PIL/EpsImagePlugin.py b/src/PIL/EpsImagePlugin.py
index 7a73d1f69b4..35915e6520a 100644
--- a/src/PIL/EpsImagePlugin.py
+++ b/src/PIL/EpsImagePlugin.py
@@ -65,16 +65,24 @@ def has_ghostscript() -> bool:
     return gs_binary is not False
 
 
-def Ghostscript(tile, size, fp, scale=1, transparency: bool = False) -> Image.Image:
+def Ghostscript(
+    tile: list[ImageFile._Tile],
+    size: tuple[int, int],
+    fp: IO[bytes],
+    scale: int = 1,
+    transparency: bool = False,
+) -> Image.Image:
     """Render an image using Ghostscript"""
     global gs_binary
     if not has_ghostscript():
         msg = "Unable to locate Ghostscript on paths"
         raise OSError(msg)
+    assert isinstance(gs_binary, str)
 
     # Unpack decoder tile
-    decoder, tile, offset, data = tile[0]
-    length, bbox = data
+    args = tile[0].args
+    assert isinstance(args, tuple)
+    length, bbox = args
 
     # Hack to support hi-res rendering
     scale = int(scale) or 1
@@ -227,7 +235,11 @@ def _read_comment(s: str) -> bool:
                         # put floating point values there anyway.
                         box = [int(float(i)) for i in v.split()]
                         self._size = box[2] - box[0], box[3] - box[1]
-                        self.tile = [("eps", (0, 0) + self.size, offset, (length, box))]
+                        self.tile = [
+                            ImageFile._Tile(
+                                "eps", (0, 0) + self.size, offset, (length, box)
+                            )
+                        ]
                     except Exception:
                         pass
             return True
diff --git a/src/PIL/Image.py b/src/PIL/Image.py
index ae8634539e8..ebf4f46c435 100644
--- a/src/PIL/Image.py
+++ b/src/PIL/Image.py
@@ -220,7 +220,7 @@ class Quantize(IntEnum):
 if TYPE_CHECKING:
     from xml.etree.ElementTree import Element
 
-    from . import ImageFile, ImagePalette
+    from . import ImageFile, ImagePalette, TiffImagePlugin
     from ._typing import NumpyArray, StrOrBytesPath, TypeGuard
 ID: list[str] = []
 OPEN: dict[
@@ -676,7 +676,7 @@ def __repr__(self) -> str:
             id(self),
         )
 
-    def _repr_pretty_(self, p, cycle) -> None:
+    def _repr_pretty_(self, p, cycle: bool) -> None:
         """IPython plain text display support"""
 
         # Same as __repr__ but without unpredictable id(self),
@@ -1551,6 +1551,7 @@ def get_child_images(self) -> list[ImageFile.ImageFile]:
                     ifds.append((exif._get_ifd_dict(subifd_offset), subifd_offset))
         ifd1 = exif.get_ifd(ExifTags.IFD.IFD1)
         if ifd1 and ifd1.get(513):
+            assert exif._info is not None
             ifds.append((ifd1, exif._info.next))
 
         offset = None
@@ -1560,12 +1561,13 @@ def get_child_images(self) -> list[ImageFile.ImageFile]:
                 offset = current_offset
 
             fp = self.fp
-            thumbnail_offset = ifd.get(513)
-            if thumbnail_offset is not None:
-                thumbnail_offset += getattr(self, "_exif_offset", 0)
-                self.fp.seek(thumbnail_offset)
-                data = self.fp.read(ifd.get(514))
-                fp = io.BytesIO(data)
+            if ifd is not None:
+                thumbnail_offset = ifd.get(513)
+                if thumbnail_offset is not None:
+                    thumbnail_offset += getattr(self, "_exif_offset", 0)
+                    self.fp.seek(thumbnail_offset)
+                    data = self.fp.read(ifd.get(514))
+                    fp = io.BytesIO(data)
 
             with open(fp) as im:
                 from . import TiffImagePlugin
@@ -3869,14 +3871,14 @@ class Exif(_ExifBase):
     bigtiff = False
     _loaded = False
 
-    def __init__(self):
-        self._data = {}
-        self._hidden_data = {}
-        self._ifds = {}
-        self._info = None
-        self._loaded_exif = None
+    def __init__(self) -> None:
+        self._data: dict[int, Any] = {}
+        self._hidden_data: dict[int, Any] = {}
+        self._ifds: dict[int, dict[int, Any]] = {}
+        self._info: TiffImagePlugin.ImageFileDirectory_v2 | None = None
+        self._loaded_exif: bytes | None = None
 
-    def _fixup(self, value):
+    def _fixup(self, value: Any) -> Any:
         try:
             if len(value) == 1 and isinstance(value, tuple):
                 return value[0]
@@ -3884,24 +3886,26 @@ def _fixup(self, value):
             pass
         return value
 
-    def _fixup_dict(self, src_dict):
+    def _fixup_dict(self, src_dict: dict[int, Any]) -> dict[int, Any]:
         # Helper function
         # returns a dict with any single item tuples/lists as individual values
         return {k: self._fixup(v) for k, v in src_dict.items()}
 
-    def _get_ifd_dict(self, offset: int, group: int | None = None):
+    def _get_ifd_dict(
+        self, offset: int, group: int | None = None
+    ) -> dict[int, Any] | None:
         try:
             # an offset pointer to the location of the nested embedded IFD.
             # It should be a long, but may be corrupted.
             self.fp.seek(offset)
         except (KeyError, TypeError):
-            pass
+            return None
         else:
             from . import TiffImagePlugin
 
             info = TiffImagePlugin.ImageFileDirectory_v2(self.head, group=group)
             info.load(self.fp)
-            return self._fixup_dict(info)
+            return self._fixup_dict(dict(info))
 
     def _get_head(self) -> bytes:
         version = b"\x2B" if self.bigtiff else b"\x2A"
@@ -3966,7 +3970,7 @@ def load_from_fp(self, fp: IO[bytes], offset: int | None = None) -> None:
         self.fp.seek(offset)
         self._info.load(self.fp)
 
-    def _get_merged_dict(self):
+    def _get_merged_dict(self) -> dict[int, Any]:
         merged_dict = dict(self)
 
         # get EXIF extension
@@ -4124,7 +4128,7 @@ def __len__(self) -> int:
             keys.update(self._info)
         return len(keys)
 
-    def __getitem__(self, tag: int):
+    def __getitem__(self, tag: int) -> Any:
         if self._info is not None and tag not in self._data and tag in self._info:
             self._data[tag] = self._fixup(self._info[tag])
             del self._info[tag]
@@ -4133,7 +4137,7 @@ def __getitem__(self, tag: int):
     def __contains__(self, tag: object) -> bool:
         return tag in self._data or (self._info is not None and tag in self._info)
 
-    def __setitem__(self, tag: int, value) -> None:
+    def __setitem__(self, tag: int, value: Any) -> None:
         if self._info is not None and tag in self._info:
             del self._info[tag]
         self._data[tag] = value
diff --git a/src/PIL/ImageFile.py b/src/PIL/ImageFile.py
index e4a7dba446b..2a8846c1afd 100644
--- a/src/PIL/ImageFile.py
+++ b/src/PIL/ImageFile.py
@@ -86,7 +86,7 @@ def raise_oserror(error: int) -> OSError:
     raise _get_oserror(error, encoder=False)
 
 
-def _tilesort(t) -> int:
+def _tilesort(t: _Tile) -> int:
     # sort on offset
     return t[2]
 
@@ -161,7 +161,7 @@ def get_format_mimetype(self) -> str | None:
             return Image.MIME.get(self.format.upper())
         return None
 
-    def __setstate__(self, state) -> None:
+    def __setstate__(self, state: list[Any]) -> None:
         self.tile = []
         super().__setstate__(state)
 
@@ -525,7 +525,7 @@ def close(self) -> Image.Image:
 # --------------------------------------------------------------------
 
 
-def _save(im, fp, tile, bufsize: int = 0) -> None:
+def _save(im: Image.Image, fp: IO[bytes], tile, bufsize: int = 0) -> None:
     """Helper to save image based on tile list
 
     :param im: Image object.
@@ -554,7 +554,12 @@ def _save(im, fp, tile, bufsize: int = 0) -> None:
 
 
 def _encode_tile(
-    im, fp: IO[bytes], tile: list[_Tile], bufsize: int, fh, exc=None
+    im: Image.Image,
+    fp: IO[bytes],
+    tile: list[_Tile],
+    bufsize: int,
+    fh,
+    exc: BaseException | None = None,
 ) -> None:
     for encoder_name, extents, offset, args in tile:
         if offset > 0:
@@ -664,7 +669,11 @@ def setfd(self, fd: IO[bytes]) -> None:
         """
         self.fd = fd
 
-    def setimage(self, im, extents=None):
+    def setimage(
+        self,
+        im: Image.core.ImagingCore,
+        extents: tuple[int, int, int, int] | None = None,
+    ) -> None:
         """
         Called from ImageFile to set the core output image for the codec
 
diff --git a/src/PIL/JpegImagePlugin.py b/src/PIL/JpegImagePlugin.py
index d83d60b7b1b..3a83f9ca68a 100644
--- a/src/PIL/JpegImagePlugin.py
+++ b/src/PIL/JpegImagePlugin.py
@@ -42,7 +42,7 @@
 import sys
 import tempfile
 import warnings
-from typing import IO, Any
+from typing import IO, TYPE_CHECKING, Any
 
 from . import Image, ImageFile
 from ._binary import i16be as i16
@@ -51,6 +51,9 @@
 from ._binary import o16be as o16
 from .JpegPresets import presets
 
+if TYPE_CHECKING:
+    from .MpoImagePlugin import MpoImageFile
+
 #
 # Parser
 
@@ -329,7 +332,7 @@ class JpegImageFile(ImageFile.ImageFile):
     format = "JPEG"
     format_description = "JPEG (ISO 10918)"
 
-    def _open(self):
+    def _open(self) -> None:
         s = self.fp.read(3)
 
         if not _accept(s):
@@ -342,13 +345,13 @@ def _open(self):
         self._exif_offset = 0
 
         # JPEG specifics (internal)
-        self.layer = []
-        self.huffman_dc = {}
-        self.huffman_ac = {}
-        self.quantization = {}
-        self.app = {}  # compatibility
-        self.applist = []
-        self.icclist = []
+        self.layer: list[tuple[int, int, int, int]] = []
+        self.huffman_dc: dict[Any, Any] = {}
+        self.huffman_ac: dict[Any, Any] = {}
+        self.quantization: dict[int, list[int]] = {}
+        self.app: dict[str, bytes] = {}  # compatibility
+        self.applist: list[tuple[str, bytes]] = []
+        self.icclist: list[bytes] = []
 
         while True:
             i = s[0]
@@ -831,7 +834,9 @@ def _save_cjpeg(im: Image.Image, fp: IO[bytes], filename: str | bytes) -> None:
 
 ##
 # Factory for making JPEG and MPO instances
-def jpeg_factory(fp: IO[bytes] | None = None, filename: str | bytes | None = None):
+def jpeg_factory(
+    fp: IO[bytes] | None = None, filename: str | bytes | None = None
+) -> JpegImageFile | MpoImageFile:
     im = JpegImageFile(fp, filename)
     try:
         mpheader = im._getmp()
diff --git a/src/PIL/PngImagePlugin.py b/src/PIL/PngImagePlugin.py
index 52cfcd13a8e..910fa9755cd 100644
--- a/src/PIL/PngImagePlugin.py
+++ b/src/PIL/PngImagePlugin.py
@@ -40,7 +40,7 @@
 import zlib
 from collections.abc import Callable
 from enum import IntEnum
-from typing import IO, TYPE_CHECKING, Any, NamedTuple, NoReturn
+from typing import IO, TYPE_CHECKING, Any, NamedTuple, NoReturn, cast
 
 from . import Image, ImageChops, ImageFile, ImagePalette, ImageSequence
 from ._binary import i16be as i16
@@ -1223,7 +1223,11 @@ def _write_multiple_frames(
     if default_image:
         if im.mode != mode:
             im = im.convert(mode)
-        ImageFile._save(im, _idat(fp, chunk), [("zip", (0, 0) + im.size, 0, rawmode)])
+        ImageFile._save(
+            im,
+            cast(IO[bytes], _idat(fp, chunk)),
+            [("zip", (0, 0) + im.size, 0, rawmode)],
+        )
 
     seq_num = 0
     for frame, frame_data in enumerate(im_frames):
@@ -1258,14 +1262,14 @@ def _write_multiple_frames(
             # first frame must be in IDAT chunks for backwards compatibility
             ImageFile._save(
                 im_frame,
-                _idat(fp, chunk),
+                cast(IO[bytes], _idat(fp, chunk)),
                 [("zip", (0, 0) + im_frame.size, 0, rawmode)],
             )
         else:
             fdat_chunks = _fdat(fp, chunk, seq_num)
             ImageFile._save(
                 im_frame,
-                fdat_chunks,
+                cast(IO[bytes], fdat_chunks),
                 [("zip", (0, 0) + im_frame.size, 0, rawmode)],
             )
             seq_num = fdat_chunks.seq_num
@@ -1465,7 +1469,9 @@ def _save(
         )
     if single_im:
         ImageFile._save(
-            single_im, _idat(fp, chunk), [("zip", (0, 0) + single_im.size, 0, rawmode)]
+            single_im,
+            cast(IO[bytes], _idat(fp, chunk)),
+            [("zip", (0, 0) + single_im.size, 0, rawmode)],
         )
 
     if info:
diff --git a/src/PIL/TiffImagePlugin.py b/src/PIL/TiffImagePlugin.py
index dd013a0cf45..d9d1bab5ac8 100644
--- a/src/PIL/TiffImagePlugin.py
+++ b/src/PIL/TiffImagePlugin.py
@@ -288,8 +288,10 @@ def _accept(prefix: bytes) -> bool:
     return prefix[:4] in PREFIXES
 
 
-def _limit_rational(val, max_val):
-    inv = abs(val) > 1
+def _limit_rational(
+    val: float | Fraction | IFDRational, max_val: int
+) -> tuple[float, float]:
+    inv = abs(float(val)) > 1
     n_d = IFDRational(1 / val if inv else val).limit_rational(max_val)
     return n_d[::-1] if inv else n_d
 
@@ -792,7 +794,9 @@ def write_string(self, value: str | bytes | int) -> bytes:
         return value + b"\0"
 
     @_register_loader(5, 8)
-    def load_rational(self, data, legacy_api: bool = True):
+    def load_rational(
+        self, data: bytes, legacy_api: bool = True
+    ) -> tuple[tuple[int, int] | IFDRational, ...]:
         vals = self._unpack(f"{len(data) // 4}L", data)
 
         def combine(a: int, b: int) -> tuple[int, int] | IFDRational:
@@ -801,7 +805,7 @@ def combine(a: int, b: int) -> tuple[int, int] | IFDRational:
         return tuple(combine(num, denom) for num, denom in zip(vals[::2], vals[1::2]))
 
     @_register_writer(5)
-    def write_rational(self, *values) -> bytes:
+    def write_rational(self, *values: IFDRational) -> bytes:
         return b"".join(
             self._pack("2L", *_limit_rational(frac, 2**32 - 1)) for frac in values
         )
@@ -828,7 +832,7 @@ def combine(a: int, b: int) -> tuple[int, int] | IFDRational:
         return tuple(combine(num, denom) for num, denom in zip(vals[::2], vals[1::2]))
 
     @_register_writer(10)
-    def write_signed_rational(self, *values) -> bytes:
+    def write_signed_rational(self, *values: IFDRational) -> bytes:
         return b"".join(
             self._pack("2l", *_limit_signed_rational(frac, 2**31 - 1, -(2**31)))
             for frac in values

From e6fd8359d3184e09b8194c8ae8ec87c5a8c27c7f Mon Sep 17 00:00:00 2001
From: Andrew Murray <radarhere@users.noreply.github.com>
Date: Thu, 1 Aug 2024 12:27:45 +1000
Subject: [PATCH 0879/1178] Deprecate huffman_ac and huffman_dc

---
 Tests/test_file_jpeg.py      |  7 +++++++
 docs/deprecations.rst        |  8 ++++++++
 docs/releasenotes/11.0.0.rst |  8 ++++++++
 src/PIL/JpegImagePlugin.py   | 11 +++++++++--
 4 files changed, 32 insertions(+), 2 deletions(-)

diff --git a/Tests/test_file_jpeg.py b/Tests/test_file_jpeg.py
index b4b3f71cbb7..df589e24a1b 100644
--- a/Tests/test_file_jpeg.py
+++ b/Tests/test_file_jpeg.py
@@ -1045,6 +1045,13 @@ def test_repr_jpeg_error_returns_none(self) -> None:
 
         assert im._repr_jpeg_() is None
 
+    def test_deprecation(self) -> None:
+        with Image.open(TEST_FILE) as im:
+            with pytest.warns(DeprecationWarning):
+                assert im.huffman_ac == {}
+            with pytest.warns(DeprecationWarning):
+                assert im.huffman_dc == {}
+
 
 @pytest.mark.skipif(not is_win32(), reason="Windows only")
 @skip_unless_feature("jpg")
diff --git a/docs/deprecations.rst b/docs/deprecations.rst
index 2f5800e0711..a03f274a985 100644
--- a/docs/deprecations.rst
+++ b/docs/deprecations.rst
@@ -118,6 +118,14 @@ The ``options`` parameter in :py:meth:`~PIL.ImageMath.lambda_eval()` and
 :py:meth:`~PIL.ImageMath.unsafe_eval()` has been deprecated. One or more keyword
 arguments can be used instead.
 
+JpegImageFile.huffman_ac and JpegImageFile.huffman_dc
+^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
+
+.. deprecated:: 11.0.0
+
+The ``huffman_ac`` and ``huffman_dc`` dictionaries on JPEG images were unused, and have
+been deprecated.
+
 Removed features
 ----------------
 
diff --git a/docs/releasenotes/11.0.0.rst b/docs/releasenotes/11.0.0.rst
index bb6179de8c6..579821ba904 100644
--- a/docs/releasenotes/11.0.0.rst
+++ b/docs/releasenotes/11.0.0.rst
@@ -50,6 +50,14 @@ The ``options`` parameter in :py:meth:`~PIL.ImageMath.lambda_eval()` and
 :py:meth:`~PIL.ImageMath.unsafe_eval()` has been deprecated. One or more
 keyword arguments can be used instead.
 
+JpegImageFile.huffman_ac and JpegImageFile.huffman_dc
+^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
+
+.. deprecated:: 11.0.0
+
+The ``huffman_ac`` and ``huffman_dc`` dictionaries on JPEG images were unused, and have
+been deprecated.
+
 API Changes
 ===========
 
diff --git a/src/PIL/JpegImagePlugin.py b/src/PIL/JpegImagePlugin.py
index 3a83f9ca68a..fc897e2b919 100644
--- a/src/PIL/JpegImagePlugin.py
+++ b/src/PIL/JpegImagePlugin.py
@@ -49,6 +49,7 @@
 from ._binary import i32be as i32
 from ._binary import o8
 from ._binary import o16be as o16
+from ._deprecate import deprecate
 from .JpegPresets import presets
 
 if TYPE_CHECKING:
@@ -346,8 +347,8 @@ def _open(self) -> None:
 
         # JPEG specifics (internal)
         self.layer: list[tuple[int, int, int, int]] = []
-        self.huffman_dc: dict[Any, Any] = {}
-        self.huffman_ac: dict[Any, Any] = {}
+        self._huffman_dc: dict[Any, Any] = {}
+        self._huffman_ac: dict[Any, Any] = {}
         self.quantization: dict[int, list[int]] = {}
         self.app: dict[str, bytes] = {}  # compatibility
         self.applist: list[tuple[str, bytes]] = []
@@ -386,6 +387,12 @@ def _open(self) -> None:
 
         self._read_dpi_from_exif()
 
+    def __getattr__(self, name: str) -> Any:
+        if name in ("huffman_ac", "huffman_dc"):
+            deprecate(name, 12)
+            return getattr(self, "_" + name)
+        raise AttributeError(name)
+
     def load_read(self, read_bytes: int) -> bytes:
         """
         internal: read more image data

From 488e1982bd8d1152c202652260ce8f239178c8f8 Mon Sep 17 00:00:00 2001
From: Andrew Murray <radarhere@users.noreply.github.com>
Date: Thu, 1 Aug 2024 16:29:46 +1000
Subject: [PATCH 0880/1178] Added removal version and date

---
 docs/deprecations.rst        | 4 ++--
 docs/releasenotes/11.0.0.rst | 4 ++--
 2 files changed, 4 insertions(+), 4 deletions(-)

diff --git a/docs/deprecations.rst b/docs/deprecations.rst
index a03f274a985..058468cfe36 100644
--- a/docs/deprecations.rst
+++ b/docs/deprecations.rst
@@ -123,8 +123,8 @@ JpegImageFile.huffman_ac and JpegImageFile.huffman_dc
 
 .. deprecated:: 11.0.0
 
-The ``huffman_ac`` and ``huffman_dc`` dictionaries on JPEG images were unused, and have
-been deprecated.
+The ``huffman_ac`` and ``huffman_dc`` dictionaries on JPEG images were unused. They
+have been deprecated, and will be removed in Pillow 12 (2025-10-15).
 
 Removed features
 ----------------
diff --git a/docs/releasenotes/11.0.0.rst b/docs/releasenotes/11.0.0.rst
index 579821ba904..0175ae52d0d 100644
--- a/docs/releasenotes/11.0.0.rst
+++ b/docs/releasenotes/11.0.0.rst
@@ -55,8 +55,8 @@ JpegImageFile.huffman_ac and JpegImageFile.huffman_dc
 
 .. deprecated:: 11.0.0
 
-The ``huffman_ac`` and ``huffman_dc`` dictionaries on JPEG images were unused, and have
-been deprecated.
+The ``huffman_ac`` and ``huffman_dc`` dictionaries on JPEG images were unused. They
+have been deprecated, and will be removed in Pillow 12 (2025-10-15).
 
 API Changes
 ===========

From 8f1157a61d70ee003df5a9a91f77219beb8038a9 Mon Sep 17 00:00:00 2001
From: Andrew Murray <radarhere@users.noreply.github.com>
Date: Fri, 2 Aug 2024 23:30:27 +1000
Subject: [PATCH 0881/1178] Added type hints to Image.__init__()

---
 Tests/test_box_blur.py         |  1 +
 Tests/test_color_lut.py        | 16 ++++++
 Tests/test_file_webp.py        |  1 +
 Tests/test_image.py            |  7 +++
 Tests/test_image_array.py      |  2 +
 Tests/test_image_convert.py    |  1 +
 Tests/test_image_filter.py     |  4 +-
 Tests/test_image_getim.py      |  1 +
 Tests/test_image_putpalette.py |  1 +
 Tests/test_image_quantize.py   |  4 ++
 Tests/test_image_resample.py   |  1 +
 Tests/test_image_resize.py     |  5 ++
 Tests/test_imagemorph.py       |  2 +
 Tests/test_imageops_usm.py     |  2 +
 Tests/test_lib_image.py        |  3 ++
 src/PIL/BlpImagePlugin.py      |  1 +
 src/PIL/BmpImagePlugin.py      |  3 ++
 src/PIL/EpsImagePlugin.py      |  8 +--
 src/PIL/FpxImagePlugin.py      |  2 +
 src/PIL/GifImagePlugin.py      | 48 ++++++++++++------
 src/PIL/IcnsImagePlugin.py     |  1 +
 src/PIL/ImImagePlugin.py       |  1 +
 src/PIL/Image.py               | 90 +++++++++++++++++++++++++++-------
 src/PIL/ImageChops.py          | 17 +++++++
 src/PIL/ImageCms.py            |  3 ++
 src/PIL/ImageDraw.py           |  5 +-
 src/PIL/ImageFile.py           |  2 +
 src/PIL/ImageFont.py           |  1 +
 src/PIL/ImageMath.py           |  5 ++
 src/PIL/ImageMorph.py          |  4 ++
 src/PIL/ImageTk.py             |  9 ++--
 src/PIL/IptcImagePlugin.py     | 11 ++++-
 src/PIL/JpegImagePlugin.py     |  1 +
 src/PIL/PalmImagePlugin.py     |  1 +
 src/PIL/PcdImagePlugin.py      |  1 +
 src/PIL/PngImagePlugin.py      | 15 ++++--
 src/PIL/QoiImagePlugin.py      |  2 +-
 src/PIL/TiffImagePlugin.py     |  1 +
 38 files changed, 232 insertions(+), 51 deletions(-)

diff --git a/Tests/test_box_blur.py b/Tests/test_box_blur.py
index 1f6ed61277a..dd5fe029047 100644
--- a/Tests/test_box_blur.py
+++ b/Tests/test_box_blur.py
@@ -24,6 +24,7 @@ def test_imageops_box_blur() -> None:
 
 
 def box_blur(image: Image.Image, radius: float = 1, n: int = 1) -> Image.Image:
+    assert image.im is not None
     return image._new(image.im.box_blur((radius, radius), n))
 
 
diff --git a/Tests/test_color_lut.py b/Tests/test_color_lut.py
index 0d9c0b41974..574ccd1240d 100644
--- a/Tests/test_color_lut.py
+++ b/Tests/test_color_lut.py
@@ -47,6 +47,7 @@ def generate_identity_table(
 
     def test_wrong_args(self) -> None:
         im = Image.new("RGB", (10, 10), 0)
+        assert im.im is not None
 
         with pytest.raises(ValueError, match="filter"):
             im.im.color_lut_3d(
@@ -107,6 +108,7 @@ def test_wrong_args(self) -> None:
 
     def test_correct_args(self) -> None:
         im = Image.new("RGB", (10, 10), 0)
+        assert im.im is not None
 
         im.im.color_lut_3d(
             "RGB", Image.Resampling.BILINEAR, *self.generate_identity_table(3, 3)
@@ -143,51 +145,60 @@ def test_correct_args(self) -> None:
     def test_wrong_mode(self) -> None:
         with pytest.raises(ValueError, match="wrong mode"):
             im = Image.new("L", (10, 10), 0)
+            assert im.im is not None
             im.im.color_lut_3d(
                 "RGB", Image.Resampling.BILINEAR, *self.generate_identity_table(3, 3)
             )
 
         with pytest.raises(ValueError, match="wrong mode"):
             im = Image.new("RGB", (10, 10), 0)
+            assert im.im is not None
             im.im.color_lut_3d(
                 "L", Image.Resampling.BILINEAR, *self.generate_identity_table(3, 3)
             )
 
         with pytest.raises(ValueError, match="wrong mode"):
             im = Image.new("L", (10, 10), 0)
+            assert im.im is not None
             im.im.color_lut_3d(
                 "L", Image.Resampling.BILINEAR, *self.generate_identity_table(3, 3)
             )
 
         with pytest.raises(ValueError, match="wrong mode"):
             im = Image.new("RGB", (10, 10), 0)
+            assert im.im is not None
             im.im.color_lut_3d(
                 "RGBA", Image.Resampling.BILINEAR, *self.generate_identity_table(3, 3)
             )
 
         with pytest.raises(ValueError, match="wrong mode"):
             im = Image.new("RGB", (10, 10), 0)
+            assert im.im is not None
             im.im.color_lut_3d(
                 "RGB", Image.Resampling.BILINEAR, *self.generate_identity_table(4, 3)
             )
 
     def test_correct_mode(self) -> None:
         im = Image.new("RGBA", (10, 10), 0)
+        assert im.im is not None
         im.im.color_lut_3d(
             "RGBA", Image.Resampling.BILINEAR, *self.generate_identity_table(3, 3)
         )
 
         im = Image.new("RGBA", (10, 10), 0)
+        assert im.im is not None
         im.im.color_lut_3d(
             "RGBA", Image.Resampling.BILINEAR, *self.generate_identity_table(4, 3)
         )
 
         im = Image.new("RGB", (10, 10), 0)
+        assert im.im is not None
         im.im.color_lut_3d(
             "HSV", Image.Resampling.BILINEAR, *self.generate_identity_table(3, 3)
         )
 
         im = Image.new("RGB", (10, 10), 0)
+        assert im.im is not None
         im.im.color_lut_3d(
             "RGBA", Image.Resampling.BILINEAR, *self.generate_identity_table(4, 3)
         )
@@ -202,6 +213,7 @@ def test_identities(self) -> None:
                 g.transpose(Image.Transpose.ROTATE_180),
             ],
         )
+        assert im.im is not None
 
         # Fast test with small cubes
         for size in [2, 3, 5, 7, 11, 16, 17]:
@@ -238,6 +250,7 @@ def test_identities_4_channels(self) -> None:
                 g.transpose(Image.Transpose.ROTATE_180),
             ],
         )
+        assert im.im is not None
 
         # Red channel copied to alpha
         assert_image_equal(
@@ -262,6 +275,7 @@ def test_copy_alpha_channel(self) -> None:
                 g.transpose(Image.Transpose.ROTATE_270),
             ],
         )
+        assert im.im is not None
 
         assert_image_equal(
             im,
@@ -284,6 +298,7 @@ def test_channels_order(self) -> None:
                 g.transpose(Image.Transpose.ROTATE_180),
             ],
         )
+        assert im.im is not None
 
         # Reverse channels by splitting and using table
         # fmt: off
@@ -309,6 +324,7 @@ def test_overflow(self) -> None:
                 g.transpose(Image.Transpose.ROTATE_180),
             ],
         )
+        assert im.im is not None
 
         # fmt: off
         transformed = im._new(im.im.color_lut_3d('RGB', Image.Resampling.BILINEAR,
diff --git a/Tests/test_file_webp.py b/Tests/test_file_webp.py
index cbc905de4e7..3fb416ffe53 100644
--- a/Tests/test_file_webp.py
+++ b/Tests/test_file_webp.py
@@ -250,6 +250,7 @@ def test_roundtrip_rgba_palette(self, tmp_path: Path) -> None:
         temp_file = str(tmp_path / "temp.webp")
         im = Image.new("RGBA", (1, 1)).convert("P")
         assert im.mode == "P"
+        assert im.palette is not None
         assert im.palette.mode == "RGBA"
         im.save(temp_file)
 
diff --git a/Tests/test_image.py b/Tests/test_image.py
index d8372789be9..d4ab8ad3803 100644
--- a/Tests/test_image.py
+++ b/Tests/test_image.py
@@ -695,11 +695,13 @@ def _make_new(
             image: Image.Image,
             palette_result: ImagePalette.ImagePalette | None = None,
         ) -> None:
+            assert image.im is not None
             new_image = base_image._new(image.im)
             assert new_image.mode == image.mode
             assert new_image.size == image.size
             assert new_image.info == base_image.info
             if palette_result is not None:
+                assert new_image.palette is not None
                 assert new_image.palette.tobytes() == palette_result.tobytes()
             else:
                 assert new_image.palette is None
@@ -990,12 +992,14 @@ def test_has_transparency_data(self) -> None:
         # P mode with RGBA palette
         im = Image.new("RGBA", (1, 1)).convert("P")
         assert im.mode == "P"
+        assert im.palette is not None
         assert im.palette.mode == "RGBA"
         assert im.has_transparency_data
 
     def test_apply_transparency(self) -> None:
         im = Image.new("P", (1, 1))
         im.putpalette((0, 0, 0, 1, 1, 1))
+        assert im.palette is not None
         assert im.palette.colors == {(0, 0, 0): 0, (1, 1, 1): 1}
 
         # Test that no transformation is applied without transparency
@@ -1013,13 +1017,16 @@ def test_apply_transparency(self) -> None:
         im.putpalette((0, 0, 0, 255, 1, 1, 1, 128), "RGBA")
         im.info["transparency"] = 0
         im.apply_transparency()
+        assert im.palette is not None
         assert im.palette.colors == {(0, 0, 0, 0): 0, (1, 1, 1, 128): 1}
 
         # Test that transparency bytes are applied
         with Image.open("Tests/images/pil123p.png") as im:
             assert isinstance(im.info["transparency"], bytes)
+            assert im.palette is not None
             assert im.palette.colors[(27, 35, 6)] == 24
             im.apply_transparency()
+            assert im.palette is not None
             assert im.palette.colors[(27, 35, 6, 214)] == 24
 
     def test_constants(self) -> None:
diff --git a/Tests/test_image_array.py b/Tests/test_image_array.py
index bb606488286..4d8ffbf4a27 100644
--- a/Tests/test_image_array.py
+++ b/Tests/test_image_array.py
@@ -113,4 +113,6 @@ def test_fromarray_palette() -> None:
     out = Image.fromarray(a, "P")
 
     # Assert that the Python and C palettes match
+    assert out.palette is not None
+    assert out.im is not None
     assert len(out.palette.colors) == len(out.im.getpalette()) / 3
diff --git a/Tests/test_image_convert.py b/Tests/test_image_convert.py
index ebb7f282240..6a925975eaa 100644
--- a/Tests/test_image_convert.py
+++ b/Tests/test_image_convert.py
@@ -218,6 +218,7 @@ def test_trns_RGB(tmp_path: Path) -> None:
 def test_l_macro_rounding(convert_mode: str) -> None:
     for mode in ("P", "PA"):
         im = Image.new(mode, (1, 1))
+        assert im.palette is not None
         im.palette.getcolor((0, 1, 2))
 
         converted_im = im.convert(convert_mode)
diff --git a/Tests/test_image_filter.py b/Tests/test_image_filter.py
index 412ab44c3c1..ea5438f3d8a 100644
--- a/Tests/test_image_filter.py
+++ b/Tests/test_image_filter.py
@@ -137,7 +137,9 @@ def test_builtinfilter_p() -> None:
     builtin_filter = ImageFilter.BuiltinFilter()
 
     with pytest.raises(ValueError):
-        builtin_filter.filter(hopper("P").im)
+        im = hopper("P").im
+        assert im is not None
+        builtin_filter.filter(im)
 
 
 def test_kernel_not_enough_coefficients() -> None:
diff --git a/Tests/test_image_getim.py b/Tests/test_image_getim.py
index 9afa02b0a8b..e62d6e0ec37 100644
--- a/Tests/test_image_getim.py
+++ b/Tests/test_image_getim.py
@@ -8,4 +8,5 @@ def test_sanity() -> None:
     type_repr = repr(type(im.getim()))
 
     assert "PyCapsule" in type_repr
+    assert im.im is not None
     assert isinstance(im.im.id, int)
diff --git a/Tests/test_image_putpalette.py b/Tests/test_image_putpalette.py
index 75d9d2fc116..f2c447f711c 100644
--- a/Tests/test_image_putpalette.py
+++ b/Tests/test_image_putpalette.py
@@ -86,6 +86,7 @@ def test_rgba_palette(mode: str, palette: tuple[int, ...]) -> None:
     im = Image.new("P", (1, 1))
     im.putpalette(palette, mode)
     assert im.getpalette() == [1, 2, 3]
+    assert im.palette is not None
     assert im.palette.colors == {(1, 2, 3, 4): 0}
 
 
diff --git a/Tests/test_image_quantize.py b/Tests/test_image_quantize.py
index 903cd8550b5..7c564d96758 100644
--- a/Tests/test_image_quantize.py
+++ b/Tests/test_image_quantize.py
@@ -69,6 +69,7 @@ def test_quantize_no_dither() -> None:
 
     converted = image.quantize(dither=Image.Dither.NONE, palette=palette)
     assert converted.mode == "P"
+    assert converted.palette is not None
     assert converted.palette.palette == palette.palette.palette
 
 
@@ -81,6 +82,7 @@ def test_quantize_no_dither2() -> None:
     palette.putpalette(data)
     quantized = im.quantize(dither=Image.Dither.NONE, palette=palette)
 
+    assert quantized.palette is not None
     assert tuple(quantized.palette.palette) == data
 
     px = quantized.load()
@@ -117,6 +119,7 @@ def test_colors() -> None:
     im = hopper()
     colors = 2
     converted = im.quantize(colors)
+    assert converted.palette is not None
     assert len(converted.palette.palette) == colors * len("RGB")
 
 
@@ -147,6 +150,7 @@ def test_palette(method: Image.Quantize, color: tuple[int, ...]) -> None:
     converted = im.quantize(method=method)
     converted_px = converted.load()
     assert converted_px is not None
+    assert converted.palette is not None
     assert converted_px[0, 0] == converted.palette.colors[color]
 
 
diff --git a/Tests/test_image_resample.py b/Tests/test_image_resample.py
index ce6209c0da4..4a5901d4799 100644
--- a/Tests/test_image_resample.py
+++ b/Tests/test_image_resample.py
@@ -27,6 +27,7 @@ def test_overflow(self) -> None:
         ):
             with pytest.raises(MemoryError):
                 # any resampling filter will do here
+                assert im.im is not None
                 im.im.resize((xsize, ysize), Image.Resampling.BILINEAR)
 
     def test_invalid_size(self) -> None:
diff --git a/Tests/test_image_resize.py b/Tests/test_image_resize.py
index c9e3045121f..5700b3e0658 100644
--- a/Tests/test_image_resize.py
+++ b/Tests/test_image_resize.py
@@ -27,6 +27,7 @@ def resize(
     ) -> Image.Image:
         # Image class independent version of resize.
         im.load()
+        assert im.im is not None
         return im._new(im.im.resize(size, f))
 
     @pytest.mark.parametrize(
@@ -37,6 +38,8 @@ def test_nearest_mode(self, mode: str) -> None:
         r = self.resize(im, (15, 12), Image.Resampling.NEAREST)
         assert r.mode == mode
         assert r.size == (15, 12)
+        assert r.im is not None
+        assert im.im is not None
         assert r.im.bands == im.im.bands
 
     def test_convolution_modes(self) -> None:
@@ -51,6 +54,8 @@ def test_convolution_modes(self) -> None:
             r = self.resize(im, (15, 12), Image.Resampling.BILINEAR)
             assert r.mode == mode
             assert r.size == (15, 12)
+            assert r.im is not None
+            assert im.im is not None
             assert r.im.bands == im.im.bands
 
     @pytest.mark.parametrize(
diff --git a/Tests/test_imagemorph.py b/Tests/test_imagemorph.py
index 4363f456e11..b40de7f98f5 100644
--- a/Tests/test_imagemorph.py
+++ b/Tests/test_imagemorph.py
@@ -325,6 +325,8 @@ def test_wrong_mode() -> None:
     lut = ImageMorph.LutBuilder(op_name="corner").build_lut()
     imrgb = Image.new("RGB", (10, 10))
     iml = Image.new("L", (10, 10))
+    assert imrgb.im is not None
+    assert iml.im is not None
 
     with pytest.raises(RuntimeError):
         _imagingmorph.apply(bytes(lut), imrgb.im.id, iml.im.id)
diff --git a/Tests/test_imageops_usm.py b/Tests/test_imageops_usm.py
index 920012d8639..64116bf7073 100644
--- a/Tests/test_imageops_usm.py
+++ b/Tests/test_imageops_usm.py
@@ -98,10 +98,12 @@ def test_blur_accuracy(test_images: dict[str, ImageFile.ImageFile]) -> None:
         (4, 3, 2),
         (4, 2, 2),
     ]:
+        assert i.im is not None
         assert i.im.getpixel((x, y))[c] >= 250
     # Fuzzy match.
 
     def gp(x: int, y: int) -> tuple[int, ...]:
+        assert i.im is not None
         return i.im.getpixel((x, y))
 
     assert 236 <= gp(7, 4)[0] <= 239
diff --git a/Tests/test_lib_image.py b/Tests/test_lib_image.py
index 31548bbc91f..0a36af8b69e 100644
--- a/Tests/test_lib_image.py
+++ b/Tests/test_lib_image.py
@@ -7,18 +7,21 @@
 
 def test_setmode() -> None:
     im = Image.new("L", (1, 1), 255)
+    assert im.im is not None
     im.im.setmode("1")
     assert im.im.getpixel((0, 0)) == 255
     im.im.setmode("L")
     assert im.im.getpixel((0, 0)) == 255
 
     im = Image.new("1", (1, 1), 1)
+    assert im.im is not None
     im.im.setmode("L")
     assert im.im.getpixel((0, 0)) == 255
     im.im.setmode("1")
     assert im.im.getpixel((0, 0)) == 255
 
     im = Image.new("RGB", (1, 1), (1, 2, 3))
+    assert im.im is not None
     im.im.setmode("RGB")
     assert im.im.getpixel((0, 0)) == (1, 2, 3)
     im.im.setmode("RGBA")
diff --git a/src/PIL/BlpImagePlugin.py b/src/PIL/BlpImagePlugin.py
index 6d71049a9d5..dc7192b9913 100644
--- a/src/PIL/BlpImagePlugin.py
+++ b/src/PIL/BlpImagePlugin.py
@@ -467,6 +467,7 @@ def _save(im: Image.Image, fp: IO[bytes], filename: str | bytes) -> None:
     magic = b"BLP1" if im.encoderinfo.get("blp_version") == "BLP1" else b"BLP2"
     fp.write(magic)
 
+    assert im.palette is not None
     fp.write(struct.pack("<i", 1))  # Uncompressed or DirectX compression
     fp.write(struct.pack("<b", Encoding.UNCOMPRESSED))
     fp.write(struct.pack("<b", 1 if im.palette.mode == "RGBA" else 0))
diff --git a/src/PIL/BmpImagePlugin.py b/src/PIL/BmpImagePlugin.py
index 48bdd98307c..ce2ee464af2 100644
--- a/src/PIL/BmpImagePlugin.py
+++ b/src/PIL/BmpImagePlugin.py
@@ -170,6 +170,8 @@ def _bitmap(self, header: int = 0, offset: int = 0) -> None:
 
         # ------------------ Special case : header is reported 40, which
         # ---------------------- is shorter than real size for bpp >= 16
+        assert isinstance(file_info["width"], int)
+        assert isinstance(file_info["height"], int)
         self._size = file_info["width"], file_info["height"]
 
         # ------- If color count was not found in the header, compute from bits
@@ -443,6 +445,7 @@ def _save(
     elif im.mode == "L":
         palette = b"".join(o8(i) * 4 for i in range(256))
     elif im.mode == "P":
+        assert im.im is not None
         palette = im.im.getpalette("RGB", "BGRX")
         colors = len(palette) // 4
     else:
diff --git a/src/PIL/EpsImagePlugin.py b/src/PIL/EpsImagePlugin.py
index 35915e6520a..c5ca8dadc7a 100644
--- a/src/PIL/EpsImagePlugin.py
+++ b/src/PIL/EpsImagePlugin.py
@@ -71,7 +71,7 @@ def Ghostscript(
     fp: IO[bytes],
     scale: int = 1,
     transparency: bool = False,
-) -> Image.Image:
+) -> Image.core.ImagingCore:
     """Render an image using Ghostscript"""
     global gs_binary
     if not has_ghostscript():
@@ -161,6 +161,7 @@ def Ghostscript(
         except OSError:
             pass
 
+    assert out_im.im is not None
     im = out_im.im.copy()
     out_im.close()
     return im
@@ -190,7 +191,6 @@ def _open(self) -> None:
         self.fp.seek(offset)
 
         self._mode = "RGB"
-        self._size = None
 
         byte_arr = bytearray(255)
         bytes_mv = memoryview(byte_arr)
@@ -228,7 +228,7 @@ def _read_comment(s: str) -> bool:
             if k == "BoundingBox":
                 if v == "(atend)":
                     reading_trailer_comments = True
-                elif not self._size or (trailer_reached and reading_trailer_comments):
+                elif not self.tile or (trailer_reached and reading_trailer_comments):
                     try:
                         # Note: The DSC spec says that BoundingBox
                         # fields should be integers, but some drivers
@@ -346,7 +346,7 @@ def _read_comment(s: str) -> bool:
                 trailer_reached = True
             bytes_read = 0
 
-        if not self._size:
+        if not self.tile:
             msg = "cannot determine EPS bounding box"
             raise OSError(msg)
 
diff --git a/src/PIL/FpxImagePlugin.py b/src/PIL/FpxImagePlugin.py
index 386e37233b7..64d48635e8b 100644
--- a/src/PIL/FpxImagePlugin.py
+++ b/src/PIL/FpxImagePlugin.py
@@ -81,6 +81,8 @@ def _open_index(self, index: int = 1) -> None:
 
         # size (highest resolution)
 
+        assert isinstance(prop[0x1000002], int)
+        assert isinstance(prop[0x1000003], int)
         self._size = prop[0x1000002], prop[0x1000003]
 
         size = max(self.size)
diff --git a/src/PIL/GifImagePlugin.py b/src/PIL/GifImagePlugin.py
index bf74f9356fa..55f927d407b 100644
--- a/src/PIL/GifImagePlugin.py
+++ b/src/PIL/GifImagePlugin.py
@@ -307,6 +307,7 @@ def _seek(self, frame: int, update_image: bool = True) -> None:
         self.tile = []
 
         if self.dispose:
+            assert self.im is not None
             self.im.paste(self.dispose, self.dispose_extent)
 
         self._frame_palette = palette if palette is not None else self.global_palette
@@ -320,17 +321,21 @@ def _seek(self, frame: int, update_image: bool = True) -> None:
             else:
                 self._mode = "L"
 
-            if not palette and self.global_palette:
+            if palette:
+                self.palette = palette
+            elif self.global_palette:
                 from copy import copy
 
-                palette = copy(self.global_palette)
-            self.palette = palette
+                self.palette = copy(self.global_palette)
+            else:
+                self.palette = None
         else:
             if self.mode == "P":
                 if (
                     LOADING_STRATEGY != LoadingStrategy.RGB_AFTER_DIFFERENT_PALETTE_ONLY
                     or palette
                 ):
+                    assert self.im is not None
                     if "transparency" in self.info:
                         self.im.putpalettealpha(self.info["transparency"], 0)
                         self.im = self.im.convert("RGBA", Image.Dither.FLOYDSTEINBERG)
@@ -432,6 +437,7 @@ def load_prepare(self) -> None:
             self._prev_im = self.im
             if self._frame_palette:
                 self.im = Image.core.fill("P", self.size, self._frame_transparency or 0)
+                assert self.im is not None
                 self.im.putpalette("RGB", *self._frame_palette.getdata())
             else:
                 self.im = None
@@ -441,6 +447,7 @@ def load_prepare(self) -> None:
         super().load_prepare()
 
     def load_end(self) -> None:
+        assert self.im is not None
         if self.__frame == 0:
             if self.mode == "P" and LOADING_STRATEGY == LoadingStrategy.RGB_ALWAYS:
                 if self._frame_transparency is not None:
@@ -495,6 +502,7 @@ def _normalize_mode(im: Image.Image) -> Image.Image:
         return im
     if Image.getmodebase(im.mode) == "RGB":
         im = im.convert("P", palette=Image.Palette.ADAPTIVE)
+        assert im.palette is not None
         if im.palette.mode == "RGBA":
             for rgba in im.palette.colors:
                 if rgba[3] == 0:
@@ -531,16 +539,17 @@ def _normalize_palette(
 
     if im.mode == "P":
         if not source_palette:
+            assert im.im is not None
             source_palette = im.im.getpalette("RGB")[:768]
     else:  # L-mode
         if not source_palette:
             source_palette = bytearray(i // 3 for i in range(768))
         im.palette = ImagePalette.ImagePalette("RGB", palette=source_palette)
+    assert source_palette is not None
 
-    used_palette_colors: list[int] | None
     if palette:
-        used_palette_colors = []
-        assert source_palette is not None
+        used_palette_colors: list[int | None] = []
+        assert im.palette is not None
         for i in range(0, len(source_palette), 3):
             source_color = tuple(source_palette[i : i + 3])
             index = im.palette.colors.get(source_color)
@@ -553,20 +562,25 @@ def _normalize_palette(
                     if j not in used_palette_colors:
                         used_palette_colors[i] = j
                         break
-        im = im.remap_palette(used_palette_colors)
+        dest_map: list[int] = []
+        for index in used_palette_colors:
+            assert index is not None
+            dest_map.append(index)
+        im = im.remap_palette(dest_map)
     else:
-        used_palette_colors = _get_optimize(im, info)
-        if used_palette_colors is not None:
-            im = im.remap_palette(used_palette_colors, source_palette)
+        optimized_palette_colors = _get_optimize(im, info)
+        if optimized_palette_colors is not None:
+            im = im.remap_palette(optimized_palette_colors, source_palette)
             if "transparency" in info:
                 try:
-                    info["transparency"] = used_palette_colors.index(
+                    info["transparency"] = optimized_palette_colors.index(
                         info["transparency"]
                     )
                 except ValueError:
                     del info["transparency"]
             return im
 
+    assert im.palette is not None
     im.palette.palette = source_palette
     return im
 
@@ -578,7 +592,8 @@ def _write_single_frame(
 ) -> None:
     im_out = _normalize_mode(im)
     for k, v in im_out.info.items():
-        im.encoderinfo.setdefault(k, v)
+        if isinstance(k, str):
+            im.encoderinfo.setdefault(k, v)
     im_out = _normalize_palette(im_out, palette, im.encoderinfo)
 
     for s in _get_global_header(im_out, im.encoderinfo):
@@ -630,7 +645,8 @@ def _write_multiple_frames(
                 for k, v in im_frame.info.items():
                     if k == "transparency":
                         continue
-                    im.encoderinfo.setdefault(k, v)
+                    if isinstance(k, str):
+                        im.encoderinfo.setdefault(k, v)
 
             encoderinfo = im.encoderinfo.copy()
             if "transparency" in im_frame.info:
@@ -660,10 +676,12 @@ def _write_multiple_frames(
                         )
                         background = _get_background(im_frame, color)
                         background_im = Image.new("P", im_frame.size, background)
+                        assert im_frames[0].im.palette is not None
                         background_im.putpalette(im_frames[0].im.palette)
                     bbox = _getbbox(background_im, im_frame)[1]
                 elif encoderinfo.get("optimize") and im_frame.mode != "1":
                     if "transparency" not in encoderinfo:
+                        assert im_frame.palette is not None
                         try:
                             encoderinfo["transparency"] = (
                                 im_frame.palette._new_color_index(im_frame)
@@ -901,6 +919,7 @@ def _get_optimize(im: Image.Image, info: dict[str, Any]) -> list[int] | None:
             if optimise or max(used_palette_colors) >= len(used_palette_colors):
                 return used_palette_colors
 
+            assert im.palette is not None
             num_palette_colors = len(im.palette.palette) // Image.getmodebands(
                 im.palette.mode
             )
@@ -950,7 +969,7 @@ def _get_palette_bytes(im: Image.Image) -> bytes:
     :param im: Image object
     :returns: Bytes, len<=768 suitable for inclusion in gif header
     """
-    return im.palette.palette if im.palette else b""
+    return bytes(im.palette.palette) if im.palette else b""
 
 
 def _get_background(
@@ -963,6 +982,7 @@ def _get_background(
             # WebPImagePlugin stores an RGBA value in info["background"]
             # So it must be converted to the same format as GifImagePlugin's
             # info["background"] - a global color table index
+            assert im.palette is not None
             try:
                 background = im.palette.getcolor(info_background, im)
             except ValueError as e:
diff --git a/src/PIL/IcnsImagePlugin.py b/src/PIL/IcnsImagePlugin.py
index 8729f76431d..58d4a90a0bf 100644
--- a/src/PIL/IcnsImagePlugin.py
+++ b/src/PIL/IcnsImagePlugin.py
@@ -92,6 +92,7 @@ def read_32(
                 msg = f"Error reading channel [{repr(bytesleft)} left]"
                 raise SyntaxError(msg)
             band = Image.frombuffer("L", pixel_size, b"".join(data), "raw", "L", 0, 1)
+            assert im.im is not None
             im.im.putband(band.im, band_ix)
     return {"RGB": im}
 
diff --git a/src/PIL/ImImagePlugin.py b/src/PIL/ImImagePlugin.py
index 2fb7ecd52a0..9d60011bead 100644
--- a/src/PIL/ImImagePlugin.py
+++ b/src/PIL/ImImagePlugin.py
@@ -353,6 +353,7 @@ def _save(im: Image.Image, fp: IO[bytes], filename: str | bytes) -> None:
         fp.write(b"Lut: 1\r\n")
     fp.write(b"\000" * (511 - fp.tell()) + b"\032")
     if im.mode in ["P", "PA"]:
+        assert im.im is not None
         im_palette = im.im.getpalette("RGB", "RGB;L")
         colors = len(im_palette) // 3
         palette = b""
diff --git a/src/PIL/Image.py b/src/PIL/Image.py
index ebf4f46c435..7532a49a2aa 100644
--- a/src/PIL/Image.py
+++ b/src/PIL/Image.py
@@ -532,16 +532,16 @@ class Image:
     format_description: str | None = None
     _close_exclusive_fp_after_loading = True
 
-    def __init__(self):
+    def __init__(self) -> None:
         # FIXME: take "new" parameters / other image?
         # FIXME: turn mode and size into delegating properties?
-        self.im = None
+        self.im: core.ImagingCore | None = None
         self._mode = ""
         self._size = (0, 0)
-        self.palette = None
-        self.info = {}
+        self.palette: ImagePalette.ImagePalette | None = None
+        self.info: dict[str | tuple[int, int], Any] = {}
         self.readonly = 0
-        self._exif = None
+        self._exif: Exif | None = None
 
     @property
     def width(self) -> int:
@@ -617,11 +617,12 @@ def close(self) -> None:
         # Instead of simply setting to None, we're setting up a
         # deferred error that will better explain that the core image
         # object is gone.
-        self.im = DeferredError(ValueError("Operation on closed image"))
+        self.im = DeferredError(ValueError("Operation on closed image"))  # type: ignore[assignment]
 
     def _copy(self) -> None:
         self.load()
-        self.im = self.im.copy()
+        if self.im:
+            self.im = self.im.copy()
         self.readonly = 0
 
     def _ensure_mutable(self) -> None:
@@ -648,6 +649,7 @@ def _dump(
         self.load()
 
         if not format or format == "PPM":
+            assert self.im is not None
             self.im.save_ppm(filename)
         else:
             self.save(filename, format, **options)
@@ -796,6 +798,7 @@ def tobytes(self, encoder_name: str = "raw", *args: Any) -> bytes:
 
         # unpack data
         e = _getencoder(self.mode, encoder_name, encoder_args)
+        assert self.im is not None
         e.setimage(self.im)
 
         bufsize = max(65536, self.size[0] * 4)  # see RawEncode.c
@@ -862,6 +865,7 @@ def frombytes(
 
         # unpack data
         d = _getdecoder(self.mode, decoder_name, decoder_args)
+        assert self.im is not None
         d.setimage(self.im)
         s = d.decode(data)
 
@@ -975,6 +979,7 @@ def convert(
             deprecate(mode, 12)
 
         self.load()
+        assert self.im is not None
 
         has_transparency = "transparency" in self.info
         if not mode and self.mode == "P":
@@ -1045,9 +1050,11 @@ def convert_transparency(
                     # use existing conversions
                     trns_im = new(self.mode, (1, 1))
                     if self.mode == "P":
+                        assert self.palette is not None
                         trns_im.putpalette(self.palette)
                         if isinstance(t, tuple):
                             err = "Couldn't allocate a palette color for transparency"
+                            assert trns_im.palette is not None
                             try:
                                 t = trns_im.palette.getcolor(t, self)
                             except ValueError as e:
@@ -1087,6 +1094,7 @@ def convert_transparency(
             new_im = self._new(im)
             from . import ImagePalette
 
+            assert new_im.im is not None
             new_im.palette = ImagePalette.ImagePalette(
                 "RGB", new_im.im.getpalette("RGB")
             )
@@ -1149,7 +1157,9 @@ def convert_transparency(
         if trns is not None:
             if new_im.mode == "P" and new_im.palette:
                 try:
-                    new_im.info["transparency"] = new_im.palette.getcolor(trns, new_im)
+                    new_im.info["transparency"] = new_im.palette.getcolor(
+                        cast(tuple[int, ...], trns), new_im  # trns was converted to RGB
+                    )
                 except ValueError as e:
                     del new_im.info["transparency"]
                     if str(e) != "cannot allocate more than 256 colors":
@@ -1216,6 +1226,7 @@ def quantize(
             )
             raise ValueError(msg)
 
+        assert self.im is not None
         if palette:
             # use palette from reference image
             palette.load()
@@ -1227,6 +1238,7 @@ def quantize(
                 raise ValueError(msg)
             im = self.im.convert("P", dither, palette.im)
             new_im = self._new(im)
+            assert palette.palette is not None
             new_im.palette = palette.palette.copy()
             return new_im
 
@@ -1253,6 +1265,7 @@ def copy(self) -> Image:
         :returns: An :py:class:`~PIL.Image.Image` object.
         """
         self.load()
+        assert self.im is not None
         return self._new(self.im.copy())
 
     __copy__ = copy
@@ -1281,6 +1294,7 @@ def crop(self, box: tuple[float, float, float, float] | None = None) -> Image:
             raise ValueError(msg)
 
         self.load()
+        assert self.im is not None
         return self._new(self._crop(self.im, box))
 
     def _crop(
@@ -1334,6 +1348,7 @@ def _expand(self, xmargin: int, ymargin: int | None = None) -> Image:
         if ymargin is None:
             ymargin = xmargin
         self.load()
+        assert self.im is not None
         return self._new(self.im.expand(xmargin, ymargin))
 
     if TYPE_CHECKING:
@@ -1358,6 +1373,7 @@ def filter(self, filter: ImageFilter.Filter | type[ImageFilter.Filter]) -> Image
             raise TypeError(msg)
 
         multiband = isinstance(filter, ImageFilter.MultibandFilter)
+        assert self.im is not None
         if self.im.bands == 1 or multiband:
             return self._new(filter.filter(self.im))
 
@@ -1393,6 +1409,7 @@ def getbbox(self, *, alpha_only: bool = True) -> tuple[int, int, int, int] | Non
         """
 
         self.load()
+        assert self.im is not None
         return self.im.getbbox(alpha_only)
 
     def getcolors(
@@ -1412,6 +1429,7 @@ def getcolors(
         """
 
         self.load()
+        assert self.im is not None
         if self.mode in ("1", "L", "P"):
             h = self.im.histogram()
             out: list[tuple[int, float]] = [(h[i], i) for i in range(256) if h[i]]
@@ -1439,6 +1457,7 @@ def getdata(self, band: int | None = None) -> core.ImagingCore:
         """
 
         self.load()
+        assert self.im is not None
         if band is not None:
             return self.im.getband(band)
         return self.im  # could be abused
@@ -1454,6 +1473,7 @@ def getextrema(self) -> tuple[float, float] | tuple[tuple[int, int], ...]:
         """
 
         self.load()
+        assert self.im is not None
         if self.im.bands > 1:
             return tuple(self.im.getband(i).getextrema() for i in range(self.im.bands))
         return self.im.getextrema()
@@ -1592,6 +1612,7 @@ def getim(self):
         """
 
         self.load()
+        assert self.im is not None
         return self.im.ptr
 
     def getpalette(self, rawmode: str | None = "RGB") -> list[int] | None:
@@ -1608,6 +1629,7 @@ def getpalette(self, rawmode: str | None = "RGB") -> list[int] | None:
         """
 
         self.load()
+        assert self.im is not None
         try:
             mode = self.im.getpalettemode()
         except ValueError:
@@ -1628,11 +1650,15 @@ def has_transparency_data(self) -> bool:
 
         :returns: A boolean.
         """
-        return (
+        if (
             self.mode in ("LA", "La", "PA", "RGBA", "RGBa")
-            or (self.mode == "P" and self.palette.mode.endswith("A"))
             or "transparency" in self.info
-        )
+        ):
+            return True
+        if self.mode == "P":
+            assert self.palette is not None
+            return self.palette.mode.endswith("A")
+        return False
 
     def apply_transparency(self) -> None:
         """
@@ -1671,6 +1697,7 @@ def getpixel(
         """
 
         self.load()
+        assert self.im is not None
         return self.im.getpixel(tuple(xy))
 
     def getprojection(self) -> tuple[list[int], list[int]]:
@@ -1682,6 +1709,7 @@ def getprojection(self) -> tuple[list[int], list[int]]:
         """
 
         self.load()
+        assert self.im is not None
         x, y = self.im.getprojection()
         return list(x), list(y)
 
@@ -1709,6 +1737,7 @@ def histogram(
         :returns: A list containing pixel counts.
         """
         self.load()
+        assert self.im is not None
         if mask:
             mask.load()
             return self.im.histogram((0, 0), mask.im)
@@ -1737,6 +1766,7 @@ def entropy(
         :returns: A float value representing the image entropy
         """
         self.load()
+        assert self.im is not None
         if mask:
             mask.load()
             return self.im.entropy((0, 0), mask.im)
@@ -1815,26 +1845,32 @@ def paste(
                 raise ValueError(msg)
             box += (box[0] + size[0], box[1] + size[1])
 
+        source: core.ImagingCore | str | float | tuple[float, ...]
         if isinstance(im, str):
             from . import ImageColor
 
-            im = ImageColor.getcolor(im, self.mode)
-
+            source = ImageColor.getcolor(im, self.mode)
         elif isImageType(im):
             im.load()
             if self.mode != im.mode:
                 if self.mode != "RGB" or im.mode not in ("LA", "RGBA", "RGBa"):
                     # should use an adapter for this!
                     im = im.convert(self.mode)
-            im = im.im
+            assert im.im is not None
+            source = im.im
+        elif isinstance(im, tuple):
+            source = im
+        else:
+            source = cast(float, im)
 
         self._ensure_mutable()
+        assert self.im is not None
 
         if mask:
             mask.load()
-            self.im.paste(im, box, mask.im)
+            self.im.paste(source, box, mask.im)
         else:
-            self.im.paste(im, box)
+            self.im.paste(source, box)
 
     def alpha_composite(
         self, im: Image, dest: Sequence[int] = (0, 0), source: Sequence[int] = (0, 0)
@@ -1924,6 +1960,7 @@ def point(self, data):
         if isinstance(lut, ImagePointHandler):
             return lut.point(self)
 
+        assert self.im is not None
         if callable(lut):
             # if it isn't a list, it should be a function
             if self.mode in ("I", "I;16", "F"):
@@ -1960,17 +1997,20 @@ def putalpha(self, alpha: Image | int) -> None:
 
         if self.mode not in ("LA", "PA", "RGBA"):
             # attempt to promote self to a matching alpha mode
+            assert self.im is not None
             try:
                 mode = getmodebase(self.mode) + "A"
                 try:
                     self.im.setmode(mode)
                 except (AttributeError, ValueError) as e:
                     # do things the hard way
+                    assert self.im is not None
                     im = self.im.convert(mode)
                     if im.mode not in ("LA", "PA", "RGBA"):
                         msg = "alpha channel could not be added"
                         raise ValueError(msg) from e  # sanity check
                     self.im = im
+                    assert self.im is not None
                 self._mode = self.im.mode
             except KeyError as e:
                 msg = "illegal image mode"
@@ -1981,6 +2021,7 @@ def putalpha(self, alpha: Image | int) -> None:
         else:
             band = 3
 
+        assert self.im is not None
         if isImageType(alpha):
             # alpha layer
             if alpha.mode not in ("1", "L"):
@@ -2023,6 +2064,7 @@ def putdata(
 
         self._ensure_mutable()
 
+        assert self.im is not None
         self.im.putdata(data, scale, offset)
 
     def putpalette(
@@ -2105,8 +2147,10 @@ def putpixel(
             if self.mode == "PA":
                 alpha = value[3] if len(value) == 4 else 255
                 value = value[:3]
-            palette_index = self.palette.getcolor(value, self)
+            assert self.palette is not None
+            palette_index = self.palette.getcolor(tuple(value), self)
             value = (palette_index, alpha) if self.mode == "PA" else palette_index
+        assert self.im is not None
         return self.im.putpixel(xy, value)
 
     def remap_palette(
@@ -2133,6 +2177,7 @@ def remap_palette(
         if source_palette is None:
             if self.mode == "P":
                 self.load()
+                assert self.im is not None
                 palette_mode = self.im.getpalettemode()
                 if palette_mode == "RGBA":
                     bands = 4
@@ -2180,6 +2225,7 @@ def remap_palette(
         # m_im.putpalette(mapping_palette, 'L')  # converts to 'P'
         # or just force it.
         # UNDONE -- this is part of the general issue with palettes
+        assert m_im.im is not None
         m_im.im.putpalette(palette_mode, palette_mode + ";L", m_im.palette.tobytes())
 
         m_im = m_im.convert("L")
@@ -2325,6 +2371,7 @@ def resize(
                     (box[3] - reduce_box[1]) / factor_y,
                 )
 
+        assert self.im is not None
         return self._new(self.im.resize(size, resample, box))
 
     def reduce(
@@ -2359,7 +2406,7 @@ def reduce(
             return im.convert(self.mode)
 
         self.load()
-
+        assert self.im is not None
         return self._new(self.im.reduce(factor, box))
 
     def rotate(
@@ -2637,6 +2684,7 @@ def split(self) -> tuple[Image, ...]:
         """
 
         self.load()
+        assert self.im is not None
         if self.im.bands == 1:
             return (self.copy(),)
         return tuple(map(self._new, self.im.split()))
@@ -2661,6 +2709,7 @@ def getchannel(self, channel: int | str) -> Image:
                 msg = f'The image has no channel "{channel}"'
                 raise ValueError(msg) from e
 
+        assert self.im is not None
         return self._new(self.im.getband(channel))
 
     def tell(self) -> int:
@@ -2765,6 +2814,7 @@ def round_aspect(number: float, key: Callable[[int], float]) -> int:
 
             self.im = im.im
             self._size = final_size
+            assert self.im is not None
             self._mode = self.im.mode
 
         self.readonly = 0
@@ -2949,6 +2999,7 @@ def __transformer(
         if image.mode in ("1", "P"):
             resample = Resampling.NEAREST
 
+        assert self.im is not None
         self.im.transform(box, image.im, method, data, resample, fill)
 
     def transpose(self, method: Transpose) -> Image:
@@ -2963,6 +3014,7 @@ def transpose(self, method: Transpose) -> Image:
         """
 
         self.load()
+        assert self.im is not None
         return self._new(self.im.transpose(method))
 
     def effect_spread(self, distance: int) -> Image:
@@ -2972,6 +3024,7 @@ def effect_spread(self, distance: int) -> Image:
         :param distance: Distance to spread pixels.
         """
         self.load()
+        assert self.im is not None
         return self._new(self.im.effect_spread(distance))
 
     def toqimage(self):
@@ -3205,6 +3258,7 @@ def frombuffer(
             if mode == "P":
                 from . import ImagePalette
 
+                assert im.im is not None
                 im.palette = ImagePalette.ImagePalette("RGB", im.im.getpalette("RGB"))
             im.readonly = 1
             return im
diff --git a/src/PIL/ImageChops.py b/src/PIL/ImageChops.py
index 29a5c995fd8..b1b616d5c71 100644
--- a/src/PIL/ImageChops.py
+++ b/src/PIL/ImageChops.py
@@ -48,6 +48,7 @@ def invert(image: Image.Image) -> Image.Image:
     """
 
     image.load()
+    assert image.im is not None
     return image._new(image.im.chop_invert())
 
 
@@ -63,6 +64,7 @@ def lighter(image1: Image.Image, image2: Image.Image) -> Image.Image:
 
     image1.load()
     image2.load()
+    assert image1.im is not None
     return image1._new(image1.im.chop_lighter(image2.im))
 
 
@@ -78,6 +80,7 @@ def darker(image1: Image.Image, image2: Image.Image) -> Image.Image:
 
     image1.load()
     image2.load()
+    assert image1.im is not None
     return image1._new(image1.im.chop_darker(image2.im))
 
 
@@ -93,6 +96,7 @@ def difference(image1: Image.Image, image2: Image.Image) -> Image.Image:
 
     image1.load()
     image2.load()
+    assert image1.im is not None
     return image1._new(image1.im.chop_difference(image2.im))
 
 
@@ -110,6 +114,7 @@ def multiply(image1: Image.Image, image2: Image.Image) -> Image.Image:
 
     image1.load()
     image2.load()
+    assert image1.im is not None
     return image1._new(image1.im.chop_multiply(image2.im))
 
 
@@ -124,6 +129,7 @@ def screen(image1: Image.Image, image2: Image.Image) -> Image.Image:
 
     image1.load()
     image2.load()
+    assert image1.im is not None
     return image1._new(image1.im.chop_screen(image2.im))
 
 
@@ -136,6 +142,7 @@ def soft_light(image1: Image.Image, image2: Image.Image) -> Image.Image:
 
     image1.load()
     image2.load()
+    assert image1.im is not None
     return image1._new(image1.im.chop_soft_light(image2.im))
 
 
@@ -148,6 +155,7 @@ def hard_light(image1: Image.Image, image2: Image.Image) -> Image.Image:
 
     image1.load()
     image2.load()
+    assert image1.im is not None
     return image1._new(image1.im.chop_hard_light(image2.im))
 
 
@@ -160,6 +168,7 @@ def overlay(image1: Image.Image, image2: Image.Image) -> Image.Image:
 
     image1.load()
     image2.load()
+    assert image1.im is not None
     return image1._new(image1.im.chop_overlay(image2.im))
 
 
@@ -177,6 +186,7 @@ def add(
 
     image1.load()
     image2.load()
+    assert image1.im is not None
     return image1._new(image1.im.chop_add(image2.im, scale, offset))
 
 
@@ -194,6 +204,7 @@ def subtract(
 
     image1.load()
     image2.load()
+    assert image1.im is not None
     return image1._new(image1.im.chop_subtract(image2.im, scale, offset))
 
 
@@ -207,6 +218,7 @@ def add_modulo(image1: Image.Image, image2: Image.Image) -> Image.Image:
 
     image1.load()
     image2.load()
+    assert image1.im is not None
     return image1._new(image1.im.chop_add_modulo(image2.im))
 
 
@@ -220,6 +232,7 @@ def subtract_modulo(image1: Image.Image, image2: Image.Image) -> Image.Image:
 
     image1.load()
     image2.load()
+    assert image1.im is not None
     return image1._new(image1.im.chop_subtract_modulo(image2.im))
 
 
@@ -238,6 +251,7 @@ def logical_and(image1: Image.Image, image2: Image.Image) -> Image.Image:
 
     image1.load()
     image2.load()
+    assert image1.im is not None
     return image1._new(image1.im.chop_and(image2.im))
 
 
@@ -253,6 +267,7 @@ def logical_or(image1: Image.Image, image2: Image.Image) -> Image.Image:
 
     image1.load()
     image2.load()
+    assert image1.im is not None
     return image1._new(image1.im.chop_or(image2.im))
 
 
@@ -268,6 +283,7 @@ def logical_xor(image1: Image.Image, image2: Image.Image) -> Image.Image:
 
     image1.load()
     image2.load()
+    assert image1.im is not None
     return image1._new(image1.im.chop_xor(image2.im))
 
 
@@ -308,4 +324,5 @@ def offset(image: Image.Image, xoffset: int, yoffset: int | None = None) -> Imag
     if yoffset is None:
         yoffset = xoffset
     image.load()
+    assert image.im is not None
     return image._new(image.im.offset(xoffset, yoffset))
diff --git a/src/PIL/ImageCms.py b/src/PIL/ImageCms.py
index ec10230f12b..3a6d5294973 100644
--- a/src/PIL/ImageCms.py
+++ b/src/PIL/ImageCms.py
@@ -352,6 +352,8 @@ def apply(self, im: Image.Image, imOut: Image.Image | None = None) -> Image.Imag
         im.load()
         if imOut is None:
             imOut = Image.new(self.output_mode, im.size, None)
+        assert im.im is not None
+        assert imOut.im is not None
         self.transform.apply(im.im.id, imOut.im.id)
         imOut.info["icc_profile"] = self.output_profile.tobytes()
         return imOut
@@ -361,6 +363,7 @@ def apply_in_place(self, im: Image.Image) -> Image.Image:
         if im.mode != self.output_mode:
             msg = "mode mismatch"
             raise ValueError(msg)  # wrong output mode
+        assert im.im is not None
         self.transform.apply(im.im.id, im.im.id)
         im.info["icc_profile"] = self.output_profile.tobytes()
         return im
diff --git a/src/PIL/ImageDraw.py b/src/PIL/ImageDraw.py
index 6f56d023618..988e3d7c5c9 100644
--- a/src/PIL/ImageDraw.py
+++ b/src/PIL/ImageDraw.py
@@ -32,7 +32,6 @@
 from __future__ import annotations
 
 import math
-import numbers
 import struct
 from collections.abc import Sequence
 from types import ModuleType
@@ -160,13 +159,13 @@ def _getink(
             if ink is not None:
                 if isinstance(ink, str):
                     ink = ImageColor.getcolor(ink, self.mode)
-                if self.palette and not isinstance(ink, numbers.Number):
+                if self.palette and isinstance(ink, tuple):
                     ink = self.palette.getcolor(ink, self._image)
                 result_ink = self.draw.draw_ink(ink)
             if fill is not None:
                 if isinstance(fill, str):
                     fill = ImageColor.getcolor(fill, self.mode)
-                if self.palette and not isinstance(fill, numbers.Number):
+                if self.palette and isinstance(fill, tuple):
                     fill = self.palette.getcolor(fill, self._image)
                 result_fill = self.draw.draw_ink(fill)
         return result_ink, result_fill
diff --git a/src/PIL/ImageFile.py b/src/PIL/ImageFile.py
index 2a8846c1afd..babf453cba6 100644
--- a/src/PIL/ImageFile.py
+++ b/src/PIL/ImageFile.py
@@ -475,6 +475,7 @@ def feed(self, data: bytes) -> None:
                     d, e, o, a = im.tile[0]
                     im.tile = []
                     self.decoder = Image._getdecoder(im.mode, d, a, im.decoderconfig)
+                    assert im.im is not None
                     self.decoder.setimage(im.im, e)
 
                     # calculate decoder offset
@@ -566,6 +567,7 @@ def _encode_tile(
             fp.seek(offset)
         encoder = Image._getencoder(im.mode, encoder_name, args, im.encoderconfig)
         try:
+            assert im.im is not None
             encoder.setimage(im.im, extents)
             if encoder.pushes_fd:
                 encoder.setfd(fp)
diff --git a/src/PIL/ImageFont.py b/src/PIL/ImageFont.py
index 2ab65bfefe4..2d71b4df41e 100644
--- a/src/PIL/ImageFont.py
+++ b/src/PIL/ImageFont.py
@@ -142,6 +142,7 @@ def _load_pilfont_data(self, file: IO[bytes], image: Image.Image) -> None:
             raise TypeError(msg)
 
         image.load()
+        assert image.im is not None
 
         self.font = Image.core.font(image.im, data)
 
diff --git a/src/PIL/ImageMath.py b/src/PIL/ImageMath.py
index 191cc2a5f88..c8f0406ed13 100644
--- a/src/PIL/ImageMath.py
+++ b/src/PIL/ImageMath.py
@@ -65,6 +65,8 @@ def apply(
             except AttributeError as e:
                 msg = f"bad operand type for '{op}'"
                 raise TypeError(msg) from e
+            assert out.im is not None
+            assert im_1.im is not None
             _imagingmath.unop(op, out.im.id, im_1.im.id)
         else:
             # binary operation
@@ -93,6 +95,9 @@ def apply(
             except AttributeError as e:
                 msg = f"bad operand type for '{op}'"
                 raise TypeError(msg) from e
+            assert out.im is not None
+            assert im_1.im is not None
+            assert im_2.im is not None
             _imagingmath.binop(op, out.im.id, im_1.im.id, im_2.im.id)
         return _Operand(out)
 
diff --git a/src/PIL/ImageMorph.py b/src/PIL/ImageMorph.py
index 6a43983d33d..cd4fa3cfede 100644
--- a/src/PIL/ImageMorph.py
+++ b/src/PIL/ImageMorph.py
@@ -213,6 +213,8 @@ def apply(self, image: Image.Image) -> tuple[int, Image.Image]:
             msg = "Image mode must be L"
             raise ValueError(msg)
         outimage = Image.new(image.mode, image.size, None)
+        assert image.im is not None
+        assert outimage.im is not None
         count = _imagingmorph.apply(bytes(self.lut), image.im.id, outimage.im.id)
         return count, outimage
 
@@ -229,6 +231,7 @@ def match(self, image: Image.Image) -> list[tuple[int, int]]:
         if image.mode != "L":
             msg = "Image mode must be L"
             raise ValueError(msg)
+        assert image.im is not None
         return _imagingmorph.match(bytes(self.lut), image.im.id)
 
     def get_on_pixels(self, image: Image.Image) -> list[tuple[int, int]]:
@@ -240,6 +243,7 @@ def get_on_pixels(self, image: Image.Image) -> list[tuple[int, int]]:
         if image.mode != "L":
             msg = "Image mode must be L"
             raise ValueError(msg)
+        assert image.im is not None
         return _imagingmorph.get_on_pixels(image.im.id)
 
     def load_lut(self, filename: str) -> None:
diff --git a/src/PIL/ImageTk.py b/src/PIL/ImageTk.py
index 6b13e57a076..6344220efa3 100644
--- a/src/PIL/ImageTk.py
+++ b/src/PIL/ImageTk.py
@@ -43,6 +43,7 @@ def _pilbitmap_check() -> int:
     if _pilbitmap_ok is None:
         try:
             im = Image.new("1", (1, 1))
+            assert im.im is not None
             tkinter.BitmapImage(data=f"PIL:{im.im.id}")
             _pilbitmap_ok = 1
         except tkinter.TclError:
@@ -127,10 +128,7 @@ def __init__(
                 # palette mapped data
                 image.apply_transparency()
                 image.load()
-                try:
-                    mode = image.palette.mode
-                except AttributeError:
-                    mode = "RGB"  # default
+                mode = image.palette.mode if image.palette else "RGB"
             size = image.size
             kw["width"], kw["height"] = size
 
@@ -190,6 +188,7 @@ def paste(self, im: Image.Image) -> None:
         # convert to blittable
         im.load()
         image = im.im
+        assert image is not None
         if image.isblock() and im.mode == self.__mode:
             block = image
         else:
@@ -231,6 +230,7 @@ def __init__(self, image: Image.Image | None = None, **kw: Any) -> None:
         if _pilbitmap_check():
             # fast way (requires the pilbitmap booster patch)
             image.load()
+            assert image.im is not None
             kw["data"] = f"PIL:{image.im.id}"
             self.__im = image  # must keep a reference
         else:
@@ -277,6 +277,7 @@ def getimage(photo: PhotoImage) -> Image.Image:
     """Copies the contents of a PhotoImage to a PIL image memory."""
     im = Image.new("RGBA", (photo.width(), photo.height()))
     block = im.im
+    assert block is not None
 
     _pyimagingtkcall("PyImagingPhotoGet", photo, block.id)
 
diff --git a/src/PIL/IptcImagePlugin.py b/src/PIL/IptcImagePlugin.py
index 17243e705c1..03712d24c1d 100644
--- a/src/PIL/IptcImagePlugin.py
+++ b/src/PIL/IptcImagePlugin.py
@@ -199,9 +199,13 @@ def getiptcinfo(
 
     data = None
 
+    info: dict[tuple[int, int], bytes | list[bytes]] = {}
     if isinstance(im, IptcImageFile):
         # return info dictionary right away
-        return im.info
+        for k, v in im.info.items():
+            if isinstance(k, tuple):
+                info[k] = v
+        return info
 
     elif isinstance(im, JpegImagePlugin.JpegImageFile):
         # extract the IPTC/NAA resource
@@ -237,4 +241,7 @@ class FakeImage:
     except (IndexError, KeyError):
         pass  # expected failure
 
-    return iptc_im.info
+    for k, v in iptc_im.info.items():
+        if isinstance(k, tuple):
+            info[k] = v
+    return info
diff --git a/src/PIL/JpegImagePlugin.py b/src/PIL/JpegImagePlugin.py
index fc897e2b919..04fe8ba8557 100644
--- a/src/PIL/JpegImagePlugin.py
+++ b/src/PIL/JpegImagePlugin.py
@@ -473,6 +473,7 @@ def load_djpeg(self) -> None:
             except OSError:
                 pass
 
+        assert self.im is not None
         self._mode = self.im.mode
         self._size = self.im.size
 
diff --git a/src/PIL/PalmImagePlugin.py b/src/PIL/PalmImagePlugin.py
index 1735070f81b..9ca93c5316e 100644
--- a/src/PIL/PalmImagePlugin.py
+++ b/src/PIL/PalmImagePlugin.py
@@ -173,6 +173,7 @@ def _save(im: Image.Image, fp: IO[bytes], filename: str | bytes) -> None:
 
     flags = 0
     if im.mode == "P" and "custom-colormap" in im.info:
+        assert im.palette is not None
         flags = flags & _FLAGS["custom-colormap"]
         colormapsize = 4 * 256 + 2
         colormapmode = im.palette.mode
diff --git a/src/PIL/PcdImagePlugin.py b/src/PIL/PcdImagePlugin.py
index 1cd5c4a9dbe..64898e2351b 100644
--- a/src/PIL/PcdImagePlugin.py
+++ b/src/PIL/PcdImagePlugin.py
@@ -55,6 +55,7 @@ def load_end(self) -> None:
             assert self.im is not None
 
             self.im = self.im.rotate(self.tile_post_rotate)
+            assert self.im is not None
             self._size = self.im.size
 
 
diff --git a/src/PIL/PngImagePlugin.py b/src/PIL/PngImagePlugin.py
index 910fa9755cd..59b5d0a8b11 100644
--- a/src/PIL/PngImagePlugin.py
+++ b/src/PIL/PngImagePlugin.py
@@ -863,6 +863,7 @@ def _seek(self, frame: int, rewind: bool = False) -> None:
         assert self.png is not None
 
         self.dispose: _imaging.ImagingCore | None
+        dispose_extent = None
         if frame == 0:
             if rewind:
                 self._fp.seek(self.__rewind)
@@ -877,7 +878,7 @@ def _seek(self, frame: int, rewind: bool = False) -> None:
             self.default_image = self.info.get("default_image", False)
             self.dispose_op = self.info.get("disposal")
             self.blend_op = self.info.get("blend")
-            self.dispose_extent = self.info.get("bbox")
+            dispose_extent = self.info.get("bbox")
             self.__frame = 0
         else:
             if frame != self.__frame + 1:
@@ -886,6 +887,7 @@ def _seek(self, frame: int, rewind: bool = False) -> None:
 
             # ensure previous frame was loaded
             self.load()
+            assert self.im is not None
 
             if self.dispose:
                 self.im.paste(self.dispose, self.dispose_extent)
@@ -935,11 +937,13 @@ def _seek(self, frame: int, rewind: bool = False) -> None:
             self.tile = self.png.im_tile
             self.dispose_op = self.info.get("disposal")
             self.blend_op = self.info.get("blend")
-            self.dispose_extent = self.info.get("bbox")
+            dispose_extent = self.info.get("bbox")
 
             if not self.tile:
                 msg = "image not found in APNG frame"
                 raise EOFError(msg)
+        if dispose_extent:
+            self.dispose_extent: tuple[float, float, float, float] = dispose_extent
 
         # setup frame disposal (actual disposal done when needed in the next _seek())
         if self._prev_im is None and self.dispose_op == Disposal.OP_PREVIOUS:
@@ -1046,6 +1050,7 @@ def load_end(self) -> None:
             self.png = None
         else:
             if self._prev_im and self.blend_op == Blend.OP_OVER:
+                assert self.im is not None
                 updated = self._crop(self.im, self.dispose_extent)
                 if self.im.mode == "RGB" and "transparency" in self.info:
                     mask = updated.convert_transparent(
@@ -1400,6 +1405,7 @@ def _save(
                     chunk(fp, cid, data)
 
     if im.mode == "P":
+        assert im.im is not None
         palette_byte_number = colors * 3
         palette_bytes = im.im.getpalette("RGB")[:palette_byte_number]
         while len(palette_bytes) < palette_byte_number:
@@ -1430,8 +1436,9 @@ def _save(
                 # and it's in the info dict. It's probably just stale.
                 msg = "cannot use transparency for this mode"
                 raise OSError(msg)
-    else:
-        if im.mode == "P" and im.im.getpalettemode() == "RGBA":
+    elif im.mode == "P":
+        assert im.im is not None
+        if im.im.getpalettemode() == "RGBA":
             alpha = im.im.getpalette("RGBA", "A")
             alpha_bytes = colors
             chunk(fp, b"tRNS", alpha[:alpha_bytes])
diff --git a/src/PIL/QoiImagePlugin.py b/src/PIL/QoiImagePlugin.py
index 202ef52d09b..c81d381fb6c 100644
--- a/src/PIL/QoiImagePlugin.py
+++ b/src/PIL/QoiImagePlugin.py
@@ -26,7 +26,7 @@ def _open(self) -> None:
             msg = "not a QOI file"
             raise SyntaxError(msg)
 
-        self._size = tuple(i32(self.fp.read(4)) for i in range(2))
+        self._size = i32(self.fp.read(4)), i32(self.fp.read(4))
 
         channels = self.fp.read(1)[0]
         self._mode = "RGB" if channels == 3 else "RGBA"
diff --git a/src/PIL/TiffImagePlugin.py b/src/PIL/TiffImagePlugin.py
index d9d1bab5ac8..2b53c7dfa27 100644
--- a/src/PIL/TiffImagePlugin.py
+++ b/src/PIL/TiffImagePlugin.py
@@ -1313,6 +1313,7 @@ def _load_libtiff(self) -> Image.core.PixelAccess | None:
         decoder = Image._getdecoder(
             self.mode, "libtiff", tuple(args), self.decoderconfig
         )
+        assert self.im is not None
         try:
             decoder.setimage(self.im, extents)
         except ValueError as e:

From 3e93b806cc68aedb887fa9071cfe35a2144cd960 Mon Sep 17 00:00:00 2001
From: "renovate[bot]" <29139614+renovate[bot]@users.noreply.github.com>
Date: Sat, 3 Aug 2024 02:29:19 +0000
Subject: [PATCH 0882/1178] Update dependency mypy to v1.11.1

---
 .ci/requirements-mypy.txt | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/.ci/requirements-mypy.txt b/.ci/requirements-mypy.txt
index 776bb0dbbf2..ebb80e03b2d 100644
--- a/.ci/requirements-mypy.txt
+++ b/.ci/requirements-mypy.txt
@@ -1 +1 @@
-mypy==1.11.0
+mypy==1.11.1

From 69076fa3d9c04e00ab20cc7ba13ab046547b5138 Mon Sep 17 00:00:00 2001
From: "renovate[bot]" <29139614+renovate[bot]@users.noreply.github.com>
Date: Sun, 4 Aug 2024 06:21:13 +0000
Subject: [PATCH 0883/1178] Update dependency cibuildwheel to v2.20.0

---
 .ci/requirements-cibw.txt | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/.ci/requirements-cibw.txt b/.ci/requirements-cibw.txt
index a2bf2a7b0fc..b8e6c39473e 100644
--- a/.ci/requirements-cibw.txt
+++ b/.ci/requirements-cibw.txt
@@ -1 +1 @@
-cibuildwheel==2.19.2
+cibuildwheel==2.20.0

From 2722cfd72b6b458f709d71c2ef06e9949cf3bbe2 Mon Sep 17 00:00:00 2001
From: Andrew Murray <radarhere@users.noreply.github.com>
Date: Mon, 5 Aug 2024 20:20:24 +1000
Subject: [PATCH 0884/1178] Added writing XMP bytes to JPEG

---
 Tests/test_file_jpeg.py    | 7 +++++++
 src/PIL/JpegImagePlugin.py | 5 +++++
 2 files changed, 12 insertions(+)

diff --git a/Tests/test_file_jpeg.py b/Tests/test_file_jpeg.py
index df589e24a1b..8feae2eddf9 100644
--- a/Tests/test_file_jpeg.py
+++ b/Tests/test_file_jpeg.py
@@ -991,6 +991,13 @@ def test_getxmp_padded(self) -> None:
             else:
                 assert im.getxmp() == {"xmpmeta": None}
 
+    def test_save_xmp(self, tmp_path: Path) -> None:
+        f = str(tmp_path / "temp.jpg")
+        hopper().save(f, xmp=b"XMP test")
+
+        with Image.open(f) as reloaded:
+            assert reloaded.info["xmp"] == b"XMP test"
+
     @pytest.mark.timeout(timeout=1)
     def test_eof(self) -> None:
         # Even though this decoder never says that it is finished
diff --git a/src/PIL/JpegImagePlugin.py b/src/PIL/JpegImagePlugin.py
index fc897e2b919..f15b62f0f13 100644
--- a/src/PIL/JpegImagePlugin.py
+++ b/src/PIL/JpegImagePlugin.py
@@ -746,6 +746,11 @@ def validate_qtables(
 
     extra = info.get("extra", b"")
 
+    xmp = info.get("xmp")
+    if xmp:
+        size = o16(31 + len(xmp))
+        extra += b"\xFF\xE1" + size + b"http://ns.adobe.com/xap/1.0/\x00" + xmp
+
     MAX_BYTES_IN_MARKER = 65533
     icc_profile = info.get("icc_profile")
     if icc_profile:

From d49884e40c204db7ce89b621823b2ac37ad51a10 Mon Sep 17 00:00:00 2001
From: Andrew Murray <radarhere@users.noreply.github.com>
Date: Mon, 5 Aug 2024 21:48:36 +1000
Subject: [PATCH 0885/1178] Raise ValueError is XMP data is too long

---
 Tests/test_file_jpeg.py    |  8 +++++++-
 src/PIL/JpegImagePlugin.py | 19 ++++++++++++-------
 2 files changed, 19 insertions(+), 8 deletions(-)

diff --git a/Tests/test_file_jpeg.py b/Tests/test_file_jpeg.py
index 8feae2eddf9..f9c5fbc0bc7 100644
--- a/Tests/test_file_jpeg.py
+++ b/Tests/test_file_jpeg.py
@@ -993,11 +993,17 @@ def test_getxmp_padded(self) -> None:
 
     def test_save_xmp(self, tmp_path: Path) -> None:
         f = str(tmp_path / "temp.jpg")
-        hopper().save(f, xmp=b"XMP test")
+        im = hopper()
+        im.save(f, xmp=b"XMP test")
 
         with Image.open(f) as reloaded:
             assert reloaded.info["xmp"] == b"XMP test"
 
+        im.save(f, xmp=b"1" * 65504)
+
+        with pytest.raises(ValueError):
+            im.save(f, xmp=b"1" * 65505)
+
     @pytest.mark.timeout(timeout=1)
     def test_eof(self) -> None:
         # Even though this decoder never says that it is finished
diff --git a/src/PIL/JpegImagePlugin.py b/src/PIL/JpegImagePlugin.py
index f15b62f0f13..75c0ae38486 100644
--- a/src/PIL/JpegImagePlugin.py
+++ b/src/PIL/JpegImagePlugin.py
@@ -746,23 +746,28 @@ def validate_qtables(
 
     extra = info.get("extra", b"")
 
+    MAX_BYTES_IN_MARKER = 65533
     xmp = info.get("xmp")
     if xmp:
-        size = o16(31 + len(xmp))
+        overhead_len = 29
+        max_data_bytes_in_marker = MAX_BYTES_IN_MARKER - overhead_len
+        if len(xmp) > max_data_bytes_in_marker:
+            msg = "XMP data is too long"
+            raise ValueError(msg)
+        size = o16(2 + overhead_len + len(xmp))
         extra += b"\xFF\xE1" + size + b"http://ns.adobe.com/xap/1.0/\x00" + xmp
 
-    MAX_BYTES_IN_MARKER = 65533
     icc_profile = info.get("icc_profile")
     if icc_profile:
-        ICC_OVERHEAD_LEN = 14
-        MAX_DATA_BYTES_IN_MARKER = MAX_BYTES_IN_MARKER - ICC_OVERHEAD_LEN
+        overhead_len = 14
+        max_data_bytes_in_marker = MAX_BYTES_IN_MARKER - overhead_len
         markers = []
         while icc_profile:
-            markers.append(icc_profile[:MAX_DATA_BYTES_IN_MARKER])
-            icc_profile = icc_profile[MAX_DATA_BYTES_IN_MARKER:]
+            markers.append(icc_profile[:max_data_bytes_in_marker])
+            icc_profile = icc_profile[max_data_bytes_in_marker:]
         i = 1
         for marker in markers:
-            size = o16(2 + ICC_OVERHEAD_LEN + len(marker))
+            size = o16(2 + overhead_len + len(marker))
             extra += (
                 b"\xFF\xE2"
                 + size

From 554f8bb23a9a35fbfd638b7677f1af12043ce9d0 Mon Sep 17 00:00:00 2001
From: "pre-commit-ci[bot]"
 <66853113+pre-commit-ci[bot]@users.noreply.github.com>
Date: Mon, 5 Aug 2024 17:37:42 +0000
Subject: [PATCH 0886/1178] [pre-commit.ci] pre-commit autoupdate
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit

updates:
- [github.com/astral-sh/ruff-pre-commit: v0.5.0 → v0.5.6](https://github.com/astral-sh/ruff-pre-commit/compare/v0.5.0...v0.5.6)
- [github.com/python-jsonschema/check-jsonschema: 0.28.6 → 0.29.1](https://github.com/python-jsonschema/check-jsonschema/compare/0.28.6...0.29.1)
- [github.com/tox-dev/pyproject-fmt: 2.1.3 → 2.2.1](https://github.com/tox-dev/pyproject-fmt/compare/2.1.3...2.2.1)
---
 .pre-commit-config.yaml | 6 +++---
 1 file changed, 3 insertions(+), 3 deletions(-)

diff --git a/.pre-commit-config.yaml b/.pre-commit-config.yaml
index 659409de4e0..74764752e80 100644
--- a/.pre-commit-config.yaml
+++ b/.pre-commit-config.yaml
@@ -1,6 +1,6 @@
 repos:
   - repo: https://github.com/astral-sh/ruff-pre-commit
-    rev: v0.5.0
+    rev: v0.5.6
     hooks:
       - id: ruff
         args: [--exit-non-zero-on-fix]
@@ -50,7 +50,7 @@ repos:
         exclude: ^.github/.*TEMPLATE|^Tests/(fonts|images)/
 
   - repo: https://github.com/python-jsonschema/check-jsonschema
-    rev: 0.28.6
+    rev: 0.29.1
     hooks:
       - id: check-github-workflows
       - id: check-readthedocs
@@ -62,7 +62,7 @@ repos:
       - id: sphinx-lint
 
   - repo: https://github.com/tox-dev/pyproject-fmt
-    rev: 2.1.3
+    rev: 2.2.1
     hooks:
       - id: pyproject-fmt
 

From c056406f21e2a5aa87a8e4560fc33e079bed59e8 Mon Sep 17 00:00:00 2001
From: Andrew Murray <radarhere@users.noreply.github.com>
Date: Tue, 6 Aug 2024 06:19:15 +1000
Subject: [PATCH 0887/1178] Added comments to explain overhead_len

---
 src/PIL/JpegImagePlugin.py | 4 ++--
 1 file changed, 2 insertions(+), 2 deletions(-)

diff --git a/src/PIL/JpegImagePlugin.py b/src/PIL/JpegImagePlugin.py
index 75c0ae38486..0cb50e0bfab 100644
--- a/src/PIL/JpegImagePlugin.py
+++ b/src/PIL/JpegImagePlugin.py
@@ -749,7 +749,7 @@ def validate_qtables(
     MAX_BYTES_IN_MARKER = 65533
     xmp = info.get("xmp")
     if xmp:
-        overhead_len = 29
+        overhead_len = 29  # b"http://ns.adobe.com/xap/1.0/\x00"
         max_data_bytes_in_marker = MAX_BYTES_IN_MARKER - overhead_len
         if len(xmp) > max_data_bytes_in_marker:
             msg = "XMP data is too long"
@@ -759,7 +759,7 @@ def validate_qtables(
 
     icc_profile = info.get("icc_profile")
     if icc_profile:
-        overhead_len = 14
+        overhead_len = 14  # b"ICC_PROFILE\0" + o8(i) + o8(len(markers))
         max_data_bytes_in_marker = MAX_BYTES_IN_MARKER - overhead_len
         markers = []
         while icc_profile:

From 1fd4d1478226e0b745b42ed33a9ade993cd393df Mon Sep 17 00:00:00 2001
From: Andrew Murray <radarhere@users.noreply.github.com>
Date: Tue, 6 Aug 2024 06:31:47 +1000
Subject: [PATCH 0888/1178] Update CHANGES.rst [ci skip]

---
 CHANGES.rst | 12 ++++++++++++
 1 file changed, 12 insertions(+)

diff --git a/CHANGES.rst b/CHANGES.rst
index bd8d3af030c..ae995e0a03f 100644
--- a/CHANGES.rst
+++ b/CHANGES.rst
@@ -5,6 +5,18 @@ Changelog (Pillow)
 11.0.0 (unreleased)
 -------------------
 
+- Remove all WITH_* flags from _imaging.c and other flags #8211
+  [homm]
+
+- Improve ImageDraw2 shape methods #8265
+  [radarhere]
+
+- Lock around usages of imaging memory arenas #8238
+  [lysnikolaou]
+
+- Deprecate JpegImageFile huffman_ac and huffman_dc #8274
+  [radarhere]
+
 - Deprecate ImageMath lambda_eval and unsafe_eval options argument #8242
   [radarhere]
 

From 13c00bab86df263a83874304972951bd847439ac Mon Sep 17 00:00:00 2001
From: Andrew Murray <radarhere@users.noreply.github.com>
Date: Tue, 6 Aug 2024 11:16:55 +1000
Subject: [PATCH 0889/1178] Updated libimagequant to 4.3.3

---
 depends/install_imagequant.sh              | 2 +-
 docs/installation/building-from-source.rst | 2 +-
 2 files changed, 2 insertions(+), 2 deletions(-)

diff --git a/depends/install_imagequant.sh b/depends/install_imagequant.sh
index 9dd7742ed34..867b31e4d19 100755
--- a/depends/install_imagequant.sh
+++ b/depends/install_imagequant.sh
@@ -2,7 +2,7 @@
 # install libimagequant
 
 archive_name=libimagequant
-archive_version=4.3.1
+archive_version=4.3.3
 
 archive=$archive_name-$archive_version
 
diff --git a/docs/installation/building-from-source.rst b/docs/installation/building-from-source.rst
index 7f7dfa6ff24..fc02bb382ee 100644
--- a/docs/installation/building-from-source.rst
+++ b/docs/installation/building-from-source.rst
@@ -68,7 +68,7 @@ Many of Pillow's features require external libraries:
 
 * **libimagequant** provides improved color quantization
 
-  * Pillow has been tested with libimagequant **2.6-4.3.1**
+  * Pillow has been tested with libimagequant **2.6-4.3.3**
   * Libimagequant is licensed GPLv3, which is more restrictive than
     the Pillow license, therefore we will not be distributing binaries
     with libimagequant support enabled.

From 5e8dbbbf9e22b7615157172fa11bc7f7bf86f4c6 Mon Sep 17 00:00:00 2001
From: Andrew Murray <radarhere@users.noreply.github.com>
Date: Tue, 6 Aug 2024 13:32:46 +1000
Subject: [PATCH 0890/1178] Removed unused variable

---
 src/libImaging/Quant.c | 3 +--
 1 file changed, 1 insertion(+), 2 deletions(-)

diff --git a/src/libImaging/Quant.c b/src/libImaging/Quant.c
index 595ee42a0e0..55b5e7a555c 100644
--- a/src/libImaging/Quant.c
+++ b/src/libImaging/Quant.c
@@ -308,11 +308,10 @@ mergesort_pixels(PixelList *head, int i) {
 #ifdef DEBUG
 static int
 test_sorted(PixelList *pl[3]) {
-    int i, n, l;
+    int i, l;
     PixelList *t;
 
     for (i = 0; i < 3; i++) {
-        n = 0;
         l = 256;
         for (t = pl[i]; t; t = t->next[i]) {
             if (l < t->p.a.v[i])

From 9d6d16d5cc7bcf6070f5ad002de8642cbb2a17ab Mon Sep 17 00:00:00 2001
From: Aarni Koskela <akx@iki.fi>
Date: Tue, 6 Aug 2024 15:19:40 +0300
Subject: [PATCH 0891/1178] Parametrize some color_lut tests for DRYness

---
 Tests/test_color_lut.py | 131 +++++++++++++++++-----------------------
 1 file changed, 54 insertions(+), 77 deletions(-)

diff --git a/Tests/test_color_lut.py b/Tests/test_color_lut.py
index 0d9c0b41974..152a7a1e60d 100644
--- a/Tests/test_color_lut.py
+++ b/Tests/test_color_lut.py
@@ -105,91 +105,68 @@ def test_wrong_args(self) -> None:
         with pytest.raises(TypeError):
             im.im.color_lut_3d("RGB", Image.Resampling.BILINEAR, 3, 2, 2, 2, 16)
 
-    def test_correct_args(self) -> None:
+    @pytest.mark.parametrize(
+        ("lut_mode", "table_size"),
+        [
+            ("RGB", (3, 3)),
+            ("CMYK", (4, 3)),
+            ("RGB", (3, (2, 3, 3))),
+            ("RGB", (3, (65, 3, 3))),
+            ("RGB", (3, (3, 65, 3))),
+            ("RGB", (3, (3, 3, 65))),
+        ],
+    )
+    def test_correct_args(
+        self, lut_mode: str, table_size: tuple[int, int | tuple[int, int, int]]
+    ) -> None:
         im = Image.new("RGB", (10, 10), 0)
-
-        im.im.color_lut_3d(
-            "RGB", Image.Resampling.BILINEAR, *self.generate_identity_table(3, 3)
-        )
-
-        im.im.color_lut_3d(
-            "CMYK", Image.Resampling.BILINEAR, *self.generate_identity_table(4, 3)
-        )
-
+        assert im.im is not None
         im.im.color_lut_3d(
-            "RGB",
+            lut_mode,
             Image.Resampling.BILINEAR,
-            *self.generate_identity_table(3, (2, 3, 3)),
-        )
-
-        im.im.color_lut_3d(
-            "RGB",
-            Image.Resampling.BILINEAR,
-            *self.generate_identity_table(3, (65, 3, 3)),
-        )
-
-        im.im.color_lut_3d(
-            "RGB",
-            Image.Resampling.BILINEAR,
-            *self.generate_identity_table(3, (3, 65, 3)),
-        )
-
-        im.im.color_lut_3d(
-            "RGB",
-            Image.Resampling.BILINEAR,
-            *self.generate_identity_table(3, (3, 3, 65)),
-        )
-
-    def test_wrong_mode(self) -> None:
-        with pytest.raises(ValueError, match="wrong mode"):
-            im = Image.new("L", (10, 10), 0)
-            im.im.color_lut_3d(
-                "RGB", Image.Resampling.BILINEAR, *self.generate_identity_table(3, 3)
-            )
-
-        with pytest.raises(ValueError, match="wrong mode"):
-            im = Image.new("RGB", (10, 10), 0)
-            im.im.color_lut_3d(
-                "L", Image.Resampling.BILINEAR, *self.generate_identity_table(3, 3)
-            )
-
-        with pytest.raises(ValueError, match="wrong mode"):
-            im = Image.new("L", (10, 10), 0)
-            im.im.color_lut_3d(
-                "L", Image.Resampling.BILINEAR, *self.generate_identity_table(3, 3)
-            )
-
-        with pytest.raises(ValueError, match="wrong mode"):
-            im = Image.new("RGB", (10, 10), 0)
-            im.im.color_lut_3d(
-                "RGBA", Image.Resampling.BILINEAR, *self.generate_identity_table(3, 3)
-            )
-
+            *self.generate_identity_table(*table_size),
+        )
+
+    @pytest.mark.parametrize(
+        ("image_mode", "lut_mode", "table_size"),
+        [
+            ("L", "RGB", (3, 3)),
+            ("RGB", "L", (3, 3)),
+            ("L", "L", (3, 3)),
+            ("RGB", "RGBA", (3, 3)),
+            ("RGB", "RGB", (4, 3)),
+        ],
+    )
+    def test_wrong_mode(
+        self, image_mode: str, lut_mode: str, table_size: tuple[int, int]
+    ) -> None:
         with pytest.raises(ValueError, match="wrong mode"):
-            im = Image.new("RGB", (10, 10), 0)
+            im = Image.new(image_mode, (10, 10), 0)
+            assert im.im is not None
             im.im.color_lut_3d(
-                "RGB", Image.Resampling.BILINEAR, *self.generate_identity_table(4, 3)
+                lut_mode,
+                Image.Resampling.BILINEAR,
+                *self.generate_identity_table(*table_size),
             )
 
-    def test_correct_mode(self) -> None:
-        im = Image.new("RGBA", (10, 10), 0)
-        im.im.color_lut_3d(
-            "RGBA", Image.Resampling.BILINEAR, *self.generate_identity_table(3, 3)
-        )
-
-        im = Image.new("RGBA", (10, 10), 0)
+    @pytest.mark.parametrize(
+        ("image_mode", "lut_mode", "table_size"),
+        [
+            ("RGBA", "RGB", (3, 3)),
+            ("RGBA", "RGBA", (4, 3)),
+            ("RGB", "HSV", (3, 3)),
+            ("RGB", "RGBA", (4, 3)),
+        ],
+    )
+    def test_correct_mode(
+        self, image_mode: str, lut_mode: str, table_size: tuple[int, int]
+    ) -> None:
+        im = Image.new(image_mode, (10, 10), 0)
+        assert im.im is not None
         im.im.color_lut_3d(
-            "RGBA", Image.Resampling.BILINEAR, *self.generate_identity_table(4, 3)
-        )
-
-        im = Image.new("RGB", (10, 10), 0)
-        im.im.color_lut_3d(
-            "HSV", Image.Resampling.BILINEAR, *self.generate_identity_table(3, 3)
-        )
-
-        im = Image.new("RGB", (10, 10), 0)
-        im.im.color_lut_3d(
-            "RGBA", Image.Resampling.BILINEAR, *self.generate_identity_table(4, 3)
+            lut_mode,
+            Image.Resampling.BILINEAR,
+            *self.generate_identity_table(*table_size),
         )
 
     def test_identities(self) -> None:

From 70298d3be948e4245e2f24481b33d8d877c45e1d Mon Sep 17 00:00:00 2001
From: Andrew Murray <radarhere@users.noreply.github.com>
Date: Wed, 7 Aug 2024 06:38:46 +1000
Subject: [PATCH 0892/1178] Fix undefined variable

---
 src/libImaging/Quant.c | 10 +++++++---
 1 file changed, 7 insertions(+), 3 deletions(-)

diff --git a/src/libImaging/Quant.c b/src/libImaging/Quant.c
index 55b5e7a555c..a489a882db2 100644
--- a/src/libImaging/Quant.c
+++ b/src/libImaging/Quant.c
@@ -314,8 +314,9 @@ test_sorted(PixelList *pl[3]) {
     for (i = 0; i < 3; i++) {
         l = 256;
         for (t = pl[i]; t; t = t->next[i]) {
-            if (l < t->p.a.v[i])
+            if (l < t->p.a.v[i]) {
                 return 0;
+            }
             l = t->p.a.v[i];
         }
     }
@@ -1009,7 +1010,8 @@ compute_palette_from_median_cut(
     uint32_t nPixels,
     HashTable *medianBoxHash,
     Pixel **palette,
-    uint32_t nPaletteEntries
+    uint32_t nPaletteEntries,
+    BoxNode *root
 ) {
     uint32_t i;
     uint32_t paletteEntry;
@@ -1382,7 +1384,9 @@ quantize(
     fflush(stdout);
     timer = clock();
 #endif
-    if (!compute_palette_from_median_cut(pixelData, nPixels, h, &p, nPaletteEntries)) {
+    if (!compute_palette_from_median_cut(
+            pixelData, nPixels, h, &p, nPaletteEntries, root
+        )) {
         goto error_3;
     }
 #ifdef DEBUG

From 59c69f8d71d7f3e43cb09bd6bd2271c6e332c7ba Mon Sep 17 00:00:00 2001
From: Aarni Koskela <akx@iki.fi>
Date: Mon, 5 Aug 2024 19:12:12 +0300
Subject: [PATCH 0893/1178] Move auxiliary mypy requirements to a requirements
 file

For easier installation outside tox
---
 .ci/requirements-mypy.txt | 9 +++++++++
 tox.ini                   | 9 ---------
 2 files changed, 9 insertions(+), 9 deletions(-)

diff --git a/.ci/requirements-mypy.txt b/.ci/requirements-mypy.txt
index ebb80e03b2d..23792281b15 100644
--- a/.ci/requirements-mypy.txt
+++ b/.ci/requirements-mypy.txt
@@ -1 +1,10 @@
 mypy==1.11.1
+IceSpringPySideStubs-PyQt6
+IceSpringPySideStubs-PySide6
+ipython
+numpy
+packaging
+pytest
+types-defusedxml
+types-olefile
+types-setuptools
diff --git a/tox.ini b/tox.ini
index c1bc3b17db3..4b40594550e 100644
--- a/tox.ini
+++ b/tox.ini
@@ -33,15 +33,6 @@ commands =
 skip_install = true
 deps =
     -r .ci/requirements-mypy.txt
-    IceSpringPySideStubs-PyQt6
-    IceSpringPySideStubs-PySide6
-    ipython
-    numpy
-    packaging
-    pytest
-    types-defusedxml
-    types-olefile
-    types-setuptools
 extras =
     typing
 commands =

From 7581b48706cb3ce8af112305bae22af705134608 Mon Sep 17 00:00:00 2001
From: Andrew Murray <radarhere@users.noreply.github.com>
Date: Wed, 7 Aug 2024 18:44:43 +1000
Subject: [PATCH 0894/1178] Fixed sign comparison warning

---
 src/_imagingft.c | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/src/_imagingft.c b/src/_imagingft.c
index da03e3ba915..f8143e0cc32 100644
--- a/src/_imagingft.c
+++ b/src/_imagingft.c
@@ -1243,7 +1243,7 @@ font_getvarnames(FontObject *self) {
         return PyErr_NoMemory();
     }
 
-    for (int i = 0; i < num_namedstyles; i++) {
+    for (unsigned int i = 0; i < num_namedstyles; i++) {
         list_names_filled[i] = 0;
     }
 

From 4fddc625f177d8b7cd2120fa2c7880f664e25e67 Mon Sep 17 00:00:00 2001
From: Andrew Murray <radarhere@users.noreply.github.com>
Date: Wed, 7 Aug 2024 18:26:24 +1000
Subject: [PATCH 0895/1178] Corrected lut mode

---
 Tests/test_color_lut.py | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/Tests/test_color_lut.py b/Tests/test_color_lut.py
index 152a7a1e60d..1543faf01d2 100644
--- a/Tests/test_color_lut.py
+++ b/Tests/test_color_lut.py
@@ -152,7 +152,7 @@ def test_wrong_mode(
     @pytest.mark.parametrize(
         ("image_mode", "lut_mode", "table_size"),
         [
-            ("RGBA", "RGB", (3, 3)),
+            ("RGBA", "RGBA", (3, 3)),
             ("RGBA", "RGBA", (4, 3)),
             ("RGB", "HSV", (3, 3)),
             ("RGB", "RGBA", (4, 3)),

From 5c4aeaa3296c748facfafc265e29fbb1c7c8e518 Mon Sep 17 00:00:00 2001
From: Andrew Murray <radarhere@users.noreply.github.com>
Date: Wed, 7 Aug 2024 18:24:50 +1000
Subject: [PATCH 0896/1178] Concatenate parameters into single string

---
 Tests/test_color_lut.py | 6 +++---
 1 file changed, 3 insertions(+), 3 deletions(-)

diff --git a/Tests/test_color_lut.py b/Tests/test_color_lut.py
index 1543faf01d2..346ea749a99 100644
--- a/Tests/test_color_lut.py
+++ b/Tests/test_color_lut.py
@@ -106,7 +106,7 @@ def test_wrong_args(self) -> None:
             im.im.color_lut_3d("RGB", Image.Resampling.BILINEAR, 3, 2, 2, 2, 16)
 
     @pytest.mark.parametrize(
-        ("lut_mode", "table_size"),
+        "lut_mode, table_size",
         [
             ("RGB", (3, 3)),
             ("CMYK", (4, 3)),
@@ -128,7 +128,7 @@ def test_correct_args(
         )
 
     @pytest.mark.parametrize(
-        ("image_mode", "lut_mode", "table_size"),
+        "image_mode, lut_mode, table_size",
         [
             ("L", "RGB", (3, 3)),
             ("RGB", "L", (3, 3)),
@@ -150,7 +150,7 @@ def test_wrong_mode(
             )
 
     @pytest.mark.parametrize(
-        ("image_mode", "lut_mode", "table_size"),
+        "image_mode, lut_mode, table_size",
         [
             ("RGBA", "RGBA", (3, 3)),
             ("RGBA", "RGBA", (4, 3)),

From a06529a3a89d3e57e584b85c25fa24cf075f4dcd Mon Sep 17 00:00:00 2001
From: Andrew Murray <radarhere@users.noreply.github.com>
Date: Wed, 7 Aug 2024 18:28:51 +1000
Subject: [PATCH 0897/1178] Added channels parameter

---
 Tests/test_color_lut.py | 48 ++++++++++++++++++++---------------------
 1 file changed, 24 insertions(+), 24 deletions(-)

diff --git a/Tests/test_color_lut.py b/Tests/test_color_lut.py
index 346ea749a99..084cb19e137 100644
--- a/Tests/test_color_lut.py
+++ b/Tests/test_color_lut.py
@@ -106,39 +106,39 @@ def test_wrong_args(self) -> None:
             im.im.color_lut_3d("RGB", Image.Resampling.BILINEAR, 3, 2, 2, 2, 16)
 
     @pytest.mark.parametrize(
-        "lut_mode, table_size",
+        "lut_mode, table_channels, table_size",
         [
-            ("RGB", (3, 3)),
-            ("CMYK", (4, 3)),
-            ("RGB", (3, (2, 3, 3))),
-            ("RGB", (3, (65, 3, 3))),
-            ("RGB", (3, (3, 65, 3))),
-            ("RGB", (3, (3, 3, 65))),
+            ("RGB", 3, 3),
+            ("CMYK", 4, 3),
+            ("RGB", 3, (2, 3, 3)),
+            ("RGB", 3, (65, 3, 3)),
+            ("RGB", 3, (3, 65, 3)),
+            ("RGB", 3, (2, 3, 65)),
         ],
     )
     def test_correct_args(
-        self, lut_mode: str, table_size: tuple[int, int | tuple[int, int, int]]
+        self, lut_mode: str, table_channels: int, table_size: int | tuple[int, int, int]
     ) -> None:
         im = Image.new("RGB", (10, 10), 0)
         assert im.im is not None
         im.im.color_lut_3d(
             lut_mode,
             Image.Resampling.BILINEAR,
-            *self.generate_identity_table(*table_size),
+            *self.generate_identity_table(table_channels, table_size),
         )
 
     @pytest.mark.parametrize(
-        "image_mode, lut_mode, table_size",
+        "image_mode, lut_mode, table_channels, table_size",
         [
-            ("L", "RGB", (3, 3)),
-            ("RGB", "L", (3, 3)),
-            ("L", "L", (3, 3)),
-            ("RGB", "RGBA", (3, 3)),
-            ("RGB", "RGB", (4, 3)),
+            ("L", "RGB", 3, 3),
+            ("RGB", "L", 3, 3),
+            ("L", "L", 3, 3),
+            ("RGB", "RGBA", 3, 3),
+            ("RGB", "RGB", 4, 3),
         ],
     )
     def test_wrong_mode(
-        self, image_mode: str, lut_mode: str, table_size: tuple[int, int]
+        self, image_mode: str, lut_mode: str, table_channels: int, table_size: int
     ) -> None:
         with pytest.raises(ValueError, match="wrong mode"):
             im = Image.new(image_mode, (10, 10), 0)
@@ -146,27 +146,27 @@ def test_wrong_mode(
             im.im.color_lut_3d(
                 lut_mode,
                 Image.Resampling.BILINEAR,
-                *self.generate_identity_table(*table_size),
+                *self.generate_identity_table(table_channels, table_size),
             )
 
     @pytest.mark.parametrize(
-        "image_mode, lut_mode, table_size",
+        "image_mode, lut_mode, table_channels, table_size",
         [
-            ("RGBA", "RGBA", (3, 3)),
-            ("RGBA", "RGBA", (4, 3)),
-            ("RGB", "HSV", (3, 3)),
-            ("RGB", "RGBA", (4, 3)),
+            ("RGBA", "RGBA", 3, 3),
+            ("RGBA", "RGBA", 4, 3),
+            ("RGB", "HSV", 3, 3),
+            ("RGB", "RGBA", 4, 3),
         ],
     )
     def test_correct_mode(
-        self, image_mode: str, lut_mode: str, table_size: tuple[int, int]
+        self, image_mode: str, lut_mode: str, table_channels: int, table_size: int
     ) -> None:
         im = Image.new(image_mode, (10, 10), 0)
         assert im.im is not None
         im.im.color_lut_3d(
             lut_mode,
             Image.Resampling.BILINEAR,
-            *self.generate_identity_table(*table_size),
+            *self.generate_identity_table(table_channels, table_size),
         )
 
     def test_identities(self) -> None:

From 8ca53b312d7fbac101a688c6864b4eeed9bae168 Mon Sep 17 00:00:00 2001
From: Aarni Koskela <akx@iki.fi>
Date: Wed, 7 Aug 2024 12:17:49 +0300
Subject: [PATCH 0898/1178] Enforce CSV parametrize names style

---
 Tests/test_file_dds.py     | 6 +++---
 Tests/test_file_eps.py     | 4 +---
 Tests/test_image_access.py | 2 +-
 Tests/test_pickle.py       | 2 +-
 pyproject.toml             | 3 +++
 5 files changed, 9 insertions(+), 8 deletions(-)

diff --git a/Tests/test_file_dds.py b/Tests/test_file_dds.py
index ebc0e89a1c5..9a826ebe8ca 100644
--- a/Tests/test_file_dds.py
+++ b/Tests/test_file_dds.py
@@ -152,7 +152,7 @@ def test_sanity_ati2_bc5u(image_path: str) -> None:
 
 
 @pytest.mark.parametrize(
-    ("image_path", "expected_path"),
+    "image_path, expected_path",
     (
         # hexeditted to be typeless
         (TEST_FILE_DX10_BC5_TYPELESS, TEST_FILE_DX10_BC5_UNORM),
@@ -248,7 +248,7 @@ def test_dx10_r8g8b8a8_unorm_srgb() -> None:
 
 
 @pytest.mark.parametrize(
-    ("mode", "size", "test_file"),
+    "mode, size, test_file",
     [
         ("L", (128, 128), TEST_FILE_UNCOMPRESSED_L),
         ("LA", (128, 128), TEST_FILE_UNCOMPRESSED_L_WITH_ALPHA),
@@ -373,7 +373,7 @@ def test_save_unsupported_mode(tmp_path: Path) -> None:
 
 
 @pytest.mark.parametrize(
-    ("mode", "test_file"),
+    "mode, test_file",
     [
         ("L", "Tests/images/linear_gradient.png"),
         ("LA", "Tests/images/uncompressed_la.png"),
diff --git a/Tests/test_file_eps.py b/Tests/test_file_eps.py
index b54238132c2..d54deb5158e 100644
--- a/Tests/test_file_eps.py
+++ b/Tests/test_file_eps.py
@@ -80,9 +80,7 @@
 
 
 @pytest.mark.skipif(not HAS_GHOSTSCRIPT, reason="Ghostscript not available")
-@pytest.mark.parametrize(
-    ("filename", "size"), ((FILE1, (460, 352)), (FILE2, (360, 252)))
-)
+@pytest.mark.parametrize("filename, size", ((FILE1, (460, 352)), (FILE2, (360, 252))))
 @pytest.mark.parametrize("scale", (1, 2))
 def test_sanity(filename: str, size: tuple[int, int], scale: int) -> None:
     expected_size = tuple(s * scale for s in size)
diff --git a/Tests/test_image_access.py b/Tests/test_image_access.py
index 854c79daed2..bb30b462d2f 100644
--- a/Tests/test_image_access.py
+++ b/Tests/test_image_access.py
@@ -230,7 +230,7 @@ def test_putpixel_type_error1(self, mode: str) -> None:
                 im.putpixel((0, 0), v)  # type: ignore[arg-type]
 
     @pytest.mark.parametrize(
-        ("mode", "band_numbers", "match"),
+        "mode, band_numbers, match",
         (
             ("L", (0, 2), "color must be int or single-element tuple"),
             ("LA", (0, 3), "color must be int, or tuple of one or two elements"),
diff --git a/Tests/test_pickle.py b/Tests/test_pickle.py
index ed415953f06..be143e9c6f0 100644
--- a/Tests/test_pickle.py
+++ b/Tests/test_pickle.py
@@ -46,7 +46,7 @@ def helper_pickle_string(protocol: int, test_file: str, mode: str | None) -> Non
 
 
 @pytest.mark.parametrize(
-    ("test_file", "test_mode"),
+    "test_file, test_mode",
     [
         ("Tests/images/hopper.jpg", None),
         ("Tests/images/hopper.jpg", "L"),
diff --git a/pyproject.toml b/pyproject.toml
index 0940664f355..d81f79c5f7c 100644
--- a/pyproject.toml
+++ b/pyproject.toml
@@ -109,6 +109,7 @@ lint.select = [
   "ISC",    # flake8-implicit-str-concat
   "LOG",    # flake8-logging
   "PGH",    # pygrep-hooks
+  "PT006",  # pytest-parametrize-names-wrong-type
   "PYI",    # flake8-pyi
   "RUF100", # unused noqa (yesqa)
   "UP",     # pyupgrade
@@ -129,6 +130,8 @@ lint.per-file-ignores."Tests/oss-fuzz/fuzz_font.py" = [
 lint.per-file-ignores."Tests/oss-fuzz/fuzz_pillow.py" = [
   "I002",
 ]
+lint.flake8-pytest-style.parametrize-names-type = "csv"
+
 lint.isort.known-first-party = [
   "PIL",
 ]

From 1c998d7f7c5378ae2ed3a029ef7c4724633050e1 Mon Sep 17 00:00:00 2001
From: Aarni Koskela <akx@iki.fi>
Date: Thu, 8 Aug 2024 14:10:18 +0300
Subject: [PATCH 0899/1178] Update pyproject.toml

Co-authored-by: Andrew Murray <3112309+radarhere@users.noreply.github.com>
---
 pyproject.toml | 1 -
 1 file changed, 1 deletion(-)

diff --git a/pyproject.toml b/pyproject.toml
index d81f79c5f7c..8bb21019c29 100644
--- a/pyproject.toml
+++ b/pyproject.toml
@@ -131,7 +131,6 @@ lint.per-file-ignores."Tests/oss-fuzz/fuzz_pillow.py" = [
   "I002",
 ]
 lint.flake8-pytest-style.parametrize-names-type = "csv"
-
 lint.isort.known-first-party = [
   "PIL",
 ]

From e938283eb9ff28fbd18432eae3aa5b0ec79967d3 Mon Sep 17 00:00:00 2001
From: Andrew Murray <radarhere@users.noreply.github.com>
Date: Fri, 9 Aug 2024 20:56:14 +1000
Subject: [PATCH 0900/1178] Allow docs to build without lcms2

---
 docs/conf.py | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/docs/conf.py b/docs/conf.py
index 41f9c0e3821..75e4c2a2041 100644
--- a/docs/conf.py
+++ b/docs/conf.py
@@ -121,7 +121,7 @@
 # generating warnings in “nitpicky mode”. Note that type should include the domain name
 # if present. Example entries would be ('py:func', 'int') or
 # ('envvar', 'LD_LIBRARY_PATH').
-# nitpick_ignore = []
+nitpick_ignore = [("py:class", "_CmsProfileCompatible")]
 
 
 # -- Options for HTML output ----------------------------------------------

From 4d0e8e74b4998422141e77525d9cfe30ccb7dc2e Mon Sep 17 00:00:00 2001
From: Andrew Murray <radarhere@users.noreply.github.com>
Date: Sat, 10 Aug 2024 10:20:08 +1000
Subject: [PATCH 0901/1178] Use im property

---
 Tests/test_box_blur.py       |  1 -
 Tests/test_color_lut.py      |  9 ------
 Tests/test_image.py          |  1 -
 Tests/test_image_array.py    |  1 -
 Tests/test_image_filter.py   |  4 +--
 Tests/test_image_getim.py    |  1 -
 Tests/test_image_resample.py |  1 -
 Tests/test_image_resize.py   |  5 ---
 Tests/test_imagemorph.py     |  2 --
 Tests/test_imageops_usm.py   |  2 --
 Tests/test_lib_image.py      |  3 --
 selftest.py                  |  2 +-
 src/PIL/BmpImagePlugin.py    |  1 -
 src/PIL/EpsImagePlugin.py    |  1 -
 src/PIL/GbrImagePlugin.py    |  2 +-
 src/PIL/GifImagePlugin.py    | 11 ++-----
 src/PIL/IcnsImagePlugin.py   |  3 +-
 src/PIL/IcoImagePlugin.py    |  2 +-
 src/PIL/ImImagePlugin.py     |  1 -
 src/PIL/Image.py             | 63 ++++++++++--------------------------
 src/PIL/ImageChops.py        | 17 ----------
 src/PIL/ImageCms.py          |  3 --
 src/PIL/ImageFile.py         |  4 +--
 src/PIL/ImageFont.py         |  1 -
 src/PIL/ImageMath.py         |  5 ---
 src/PIL/ImageMorph.py        |  4 ---
 src/PIL/ImageTk.py           |  4 ---
 src/PIL/JpegImagePlugin.py   |  1 -
 src/PIL/PcdImagePlugin.py    |  3 --
 src/PIL/PcxImagePlugin.py    |  2 --
 src/PIL/PngImagePlugin.py    | 10 ++----
 src/PIL/TgaImagePlugin.py    |  2 --
 src/PIL/TiffImagePlugin.py   |  1 -
 src/PIL/WalImageFile.py      |  2 +-
 34 files changed, 30 insertions(+), 145 deletions(-)

diff --git a/Tests/test_box_blur.py b/Tests/test_box_blur.py
index dd5fe029047..1f6ed61277a 100644
--- a/Tests/test_box_blur.py
+++ b/Tests/test_box_blur.py
@@ -24,7 +24,6 @@ def test_imageops_box_blur() -> None:
 
 
 def box_blur(image: Image.Image, radius: float = 1, n: int = 1) -> Image.Image:
-    assert image.im is not None
     return image._new(image.im.box_blur((radius, radius), n))
 
 
diff --git a/Tests/test_color_lut.py b/Tests/test_color_lut.py
index 4b083d689f8..36ab187f261 100644
--- a/Tests/test_color_lut.py
+++ b/Tests/test_color_lut.py
@@ -47,7 +47,6 @@ def generate_identity_table(
 
     def test_wrong_args(self) -> None:
         im = Image.new("RGB", (10, 10), 0)
-        assert im.im is not None
 
         with pytest.raises(ValueError, match="filter"):
             im.im.color_lut_3d(
@@ -121,7 +120,6 @@ def test_correct_args(
         self, lut_mode: str, table_channels: int, table_size: int | tuple[int, int, int]
     ) -> None:
         im = Image.new("RGB", (10, 10), 0)
-        assert im.im is not None
         im.im.color_lut_3d(
             lut_mode,
             Image.Resampling.BILINEAR,
@@ -143,7 +141,6 @@ def test_wrong_mode(
     ) -> None:
         with pytest.raises(ValueError, match="wrong mode"):
             im = Image.new(image_mode, (10, 10), 0)
-            assert im.im is not None
             im.im.color_lut_3d(
                 lut_mode,
                 Image.Resampling.BILINEAR,
@@ -163,7 +160,6 @@ def test_correct_mode(
         self, image_mode: str, lut_mode: str, table_channels: int, table_size: int
     ) -> None:
         im = Image.new(image_mode, (10, 10), 0)
-        assert im.im is not None
         im.im.color_lut_3d(
             lut_mode,
             Image.Resampling.BILINEAR,
@@ -180,7 +176,6 @@ def test_identities(self) -> None:
                 g.transpose(Image.Transpose.ROTATE_180),
             ],
         )
-        assert im.im is not None
 
         # Fast test with small cubes
         for size in [2, 3, 5, 7, 11, 16, 17]:
@@ -217,7 +212,6 @@ def test_identities_4_channels(self) -> None:
                 g.transpose(Image.Transpose.ROTATE_180),
             ],
         )
-        assert im.im is not None
 
         # Red channel copied to alpha
         assert_image_equal(
@@ -242,7 +236,6 @@ def test_copy_alpha_channel(self) -> None:
                 g.transpose(Image.Transpose.ROTATE_270),
             ],
         )
-        assert im.im is not None
 
         assert_image_equal(
             im,
@@ -265,7 +258,6 @@ def test_channels_order(self) -> None:
                 g.transpose(Image.Transpose.ROTATE_180),
             ],
         )
-        assert im.im is not None
 
         # Reverse channels by splitting and using table
         # fmt: off
@@ -291,7 +283,6 @@ def test_overflow(self) -> None:
                 g.transpose(Image.Transpose.ROTATE_180),
             ],
         )
-        assert im.im is not None
 
         # fmt: off
         transformed = im._new(im.im.color_lut_3d('RGB', Image.Resampling.BILINEAR,
diff --git a/Tests/test_image.py b/Tests/test_image.py
index d4ab8ad3803..12b6c1fdda7 100644
--- a/Tests/test_image.py
+++ b/Tests/test_image.py
@@ -695,7 +695,6 @@ def _make_new(
             image: Image.Image,
             palette_result: ImagePalette.ImagePalette | None = None,
         ) -> None:
-            assert image.im is not None
             new_image = base_image._new(image.im)
             assert new_image.mode == image.mode
             assert new_image.size == image.size
diff --git a/Tests/test_image_array.py b/Tests/test_image_array.py
index 4d8ffbf4a27..2b9ccd04ec3 100644
--- a/Tests/test_image_array.py
+++ b/Tests/test_image_array.py
@@ -114,5 +114,4 @@ def test_fromarray_palette() -> None:
 
     # Assert that the Python and C palettes match
     assert out.palette is not None
-    assert out.im is not None
     assert len(out.palette.colors) == len(out.im.getpalette()) / 3
diff --git a/Tests/test_image_filter.py b/Tests/test_image_filter.py
index ea5438f3d8a..412ab44c3c1 100644
--- a/Tests/test_image_filter.py
+++ b/Tests/test_image_filter.py
@@ -137,9 +137,7 @@ def test_builtinfilter_p() -> None:
     builtin_filter = ImageFilter.BuiltinFilter()
 
     with pytest.raises(ValueError):
-        im = hopper("P").im
-        assert im is not None
-        builtin_filter.filter(im)
+        builtin_filter.filter(hopper("P").im)
 
 
 def test_kernel_not_enough_coefficients() -> None:
diff --git a/Tests/test_image_getim.py b/Tests/test_image_getim.py
index e62d6e0ec37..9afa02b0a8b 100644
--- a/Tests/test_image_getim.py
+++ b/Tests/test_image_getim.py
@@ -8,5 +8,4 @@ def test_sanity() -> None:
     type_repr = repr(type(im.getim()))
 
     assert "PyCapsule" in type_repr
-    assert im.im is not None
     assert isinstance(im.im.id, int)
diff --git a/Tests/test_image_resample.py b/Tests/test_image_resample.py
index 4a5901d4799..ce6209c0da4 100644
--- a/Tests/test_image_resample.py
+++ b/Tests/test_image_resample.py
@@ -27,7 +27,6 @@ def test_overflow(self) -> None:
         ):
             with pytest.raises(MemoryError):
                 # any resampling filter will do here
-                assert im.im is not None
                 im.im.resize((xsize, ysize), Image.Resampling.BILINEAR)
 
     def test_invalid_size(self) -> None:
diff --git a/Tests/test_image_resize.py b/Tests/test_image_resize.py
index 5700b3e0658..c9e3045121f 100644
--- a/Tests/test_image_resize.py
+++ b/Tests/test_image_resize.py
@@ -27,7 +27,6 @@ def resize(
     ) -> Image.Image:
         # Image class independent version of resize.
         im.load()
-        assert im.im is not None
         return im._new(im.im.resize(size, f))
 
     @pytest.mark.parametrize(
@@ -38,8 +37,6 @@ def test_nearest_mode(self, mode: str) -> None:
         r = self.resize(im, (15, 12), Image.Resampling.NEAREST)
         assert r.mode == mode
         assert r.size == (15, 12)
-        assert r.im is not None
-        assert im.im is not None
         assert r.im.bands == im.im.bands
 
     def test_convolution_modes(self) -> None:
@@ -54,8 +51,6 @@ def test_convolution_modes(self) -> None:
             r = self.resize(im, (15, 12), Image.Resampling.BILINEAR)
             assert r.mode == mode
             assert r.size == (15, 12)
-            assert r.im is not None
-            assert im.im is not None
             assert r.im.bands == im.im.bands
 
     @pytest.mark.parametrize(
diff --git a/Tests/test_imagemorph.py b/Tests/test_imagemorph.py
index b40de7f98f5..4363f456e11 100644
--- a/Tests/test_imagemorph.py
+++ b/Tests/test_imagemorph.py
@@ -325,8 +325,6 @@ def test_wrong_mode() -> None:
     lut = ImageMorph.LutBuilder(op_name="corner").build_lut()
     imrgb = Image.new("RGB", (10, 10))
     iml = Image.new("L", (10, 10))
-    assert imrgb.im is not None
-    assert iml.im is not None
 
     with pytest.raises(RuntimeError):
         _imagingmorph.apply(bytes(lut), imrgb.im.id, iml.im.id)
diff --git a/Tests/test_imageops_usm.py b/Tests/test_imageops_usm.py
index 64116bf7073..920012d8639 100644
--- a/Tests/test_imageops_usm.py
+++ b/Tests/test_imageops_usm.py
@@ -98,12 +98,10 @@ def test_blur_accuracy(test_images: dict[str, ImageFile.ImageFile]) -> None:
         (4, 3, 2),
         (4, 2, 2),
     ]:
-        assert i.im is not None
         assert i.im.getpixel((x, y))[c] >= 250
     # Fuzzy match.
 
     def gp(x: int, y: int) -> tuple[int, ...]:
-        assert i.im is not None
         return i.im.getpixel((x, y))
 
     assert 236 <= gp(7, 4)[0] <= 239
diff --git a/Tests/test_lib_image.py b/Tests/test_lib_image.py
index 0a36af8b69e..31548bbc91f 100644
--- a/Tests/test_lib_image.py
+++ b/Tests/test_lib_image.py
@@ -7,21 +7,18 @@
 
 def test_setmode() -> None:
     im = Image.new("L", (1, 1), 255)
-    assert im.im is not None
     im.im.setmode("1")
     assert im.im.getpixel((0, 0)) == 255
     im.im.setmode("L")
     assert im.im.getpixel((0, 0)) == 255
 
     im = Image.new("1", (1, 1), 1)
-    assert im.im is not None
     im.im.setmode("L")
     assert im.im.getpixel((0, 0)) == 255
     im.im.setmode("1")
     assert im.im.getpixel((0, 0)) == 255
 
     im = Image.new("RGB", (1, 1), (1, 2, 3))
-    assert im.im is not None
     im.im.setmode("RGB")
     assert im.im.getpixel((0, 0)) == (1, 2, 3)
     im.im.setmode("RGBA")
diff --git a/selftest.py b/selftest.py
index 9e049367edc..e9b5689a0d4 100755
--- a/selftest.py
+++ b/selftest.py
@@ -52,7 +52,7 @@ def testimage() -> None:
     or you call the "load" method:
 
     >>> im = Image.open("Tests/images/hopper.ppm")
-    >>> print(im.im) # internal image attribute
+    >>> print(im._im) # internal image attribute
     None
     >>> a = im.load()
     >>> type(im.im) # doctest: +ELLIPSIS
diff --git a/src/PIL/BmpImagePlugin.py b/src/PIL/BmpImagePlugin.py
index ce2ee464af2..da9f2eba5b0 100644
--- a/src/PIL/BmpImagePlugin.py
+++ b/src/PIL/BmpImagePlugin.py
@@ -445,7 +445,6 @@ def _save(
     elif im.mode == "L":
         palette = b"".join(o8(i) * 4 for i in range(256))
     elif im.mode == "P":
-        assert im.im is not None
         palette = im.im.getpalette("RGB", "BGRX")
         colors = len(palette) // 4
     else:
diff --git a/src/PIL/EpsImagePlugin.py b/src/PIL/EpsImagePlugin.py
index c5ca8dadc7a..28aa9689d50 100644
--- a/src/PIL/EpsImagePlugin.py
+++ b/src/PIL/EpsImagePlugin.py
@@ -161,7 +161,6 @@ def Ghostscript(
         except OSError:
             pass
 
-    assert out_im.im is not None
     im = out_im.im.copy()
     out_im.close()
     return im
diff --git a/src/PIL/GbrImagePlugin.py b/src/PIL/GbrImagePlugin.py
index 3c8feea5ffb..f319d7e846e 100644
--- a/src/PIL/GbrImagePlugin.py
+++ b/src/PIL/GbrImagePlugin.py
@@ -89,7 +89,7 @@ def _open(self) -> None:
         self._data_size = width * height * color_depth
 
     def load(self) -> Image.core.PixelAccess | None:
-        if not self.im:
+        if self._im is None:
             self.im = Image.core.new(self.mode, self.size)
             self.frombytes(self.fp.read(self._data_size))
         return Image.Image.load(self)
diff --git a/src/PIL/GifImagePlugin.py b/src/PIL/GifImagePlugin.py
index 55f927d407b..74aebcb1f53 100644
--- a/src/PIL/GifImagePlugin.py
+++ b/src/PIL/GifImagePlugin.py
@@ -155,7 +155,7 @@ def seek(self, frame: int) -> None:
         if not self._seek_check(frame):
             return
         if frame < self.__frame:
-            self.im = None
+            self._im = None
             self._seek(0)
 
         last_frame = self.__frame
@@ -307,7 +307,6 @@ def _seek(self, frame: int, update_image: bool = True) -> None:
         self.tile = []
 
         if self.dispose:
-            assert self.im is not None
             self.im.paste(self.dispose, self.dispose_extent)
 
         self._frame_palette = palette if palette is not None else self.global_palette
@@ -335,7 +334,6 @@ def _seek(self, frame: int, update_image: bool = True) -> None:
                     LOADING_STRATEGY != LoadingStrategy.RGB_AFTER_DIFFERENT_PALETTE_ONLY
                     or palette
                 ):
-                    assert self.im is not None
                     if "transparency" in self.info:
                         self.im.putpalettealpha(self.info["transparency"], 0)
                         self.im = self.im.convert("RGBA", Image.Dither.FLOYDSTEINBERG)
@@ -381,7 +379,7 @@ def _rgb(color: int) -> tuple[int, int, int]:
                     self.dispose = Image.core.fill(dispose_mode, dispose_size, color)
                 else:
                     # replace with previous contents
-                    if self.im is not None:
+                    if self._im is not None:
                         # only dispose the extent in this frame
                         self.dispose = self._crop(self.im, self.dispose_extent)
                     elif frame_transparency is not None:
@@ -437,17 +435,15 @@ def load_prepare(self) -> None:
             self._prev_im = self.im
             if self._frame_palette:
                 self.im = Image.core.fill("P", self.size, self._frame_transparency or 0)
-                assert self.im is not None
                 self.im.putpalette("RGB", *self._frame_palette.getdata())
             else:
-                self.im = None
+                self._im = None
         self._mode = temp_mode
         self._frame_palette = None
 
         super().load_prepare()
 
     def load_end(self) -> None:
-        assert self.im is not None
         if self.__frame == 0:
             if self.mode == "P" and LOADING_STRATEGY == LoadingStrategy.RGB_ALWAYS:
                 if self._frame_transparency is not None:
@@ -539,7 +535,6 @@ def _normalize_palette(
 
     if im.mode == "P":
         if not source_palette:
-            assert im.im is not None
             source_palette = im.im.getpalette("RGB")[:768]
     else:  # L-mode
         if not source_palette:
diff --git a/src/PIL/IcnsImagePlugin.py b/src/PIL/IcnsImagePlugin.py
index 58d4a90a0bf..ca66aa0fd1e 100644
--- a/src/PIL/IcnsImagePlugin.py
+++ b/src/PIL/IcnsImagePlugin.py
@@ -92,7 +92,6 @@ def read_32(
                 msg = f"Error reading channel [{repr(bytesleft)} left]"
                 raise SyntaxError(msg)
             band = Image.frombuffer("L", pixel_size, b"".join(data), "raw", "L", 0, 1)
-            assert im.im is not None
             im.im.putband(band.im, band_ix)
     return {"RGB": im}
 
@@ -309,7 +308,7 @@ def load(self) -> Image.core.PixelAccess | None:
             )
 
         px = Image.Image.load(self)
-        if self.im is not None and self.im.size == self.size:
+        if self._im is not None and self.im.size == self.size:
             # Already loaded
             return px
         self.load_prepare()
diff --git a/src/PIL/IcoImagePlugin.py b/src/PIL/IcoImagePlugin.py
index c891024f56e..4613379b6d2 100644
--- a/src/PIL/IcoImagePlugin.py
+++ b/src/PIL/IcoImagePlugin.py
@@ -328,7 +328,7 @@ def size(self, value):
         self._size = value
 
     def load(self) -> Image.core.PixelAccess | None:
-        if self.im is not None and self.im.size == self.size:
+        if self._im is not None and self.im.size == self.size:
             # Already loaded
             return Image.Image.load(self)
         im = self.ico.getimage(self.size)
diff --git a/src/PIL/ImImagePlugin.py b/src/PIL/ImImagePlugin.py
index 9d60011bead..2fb7ecd52a0 100644
--- a/src/PIL/ImImagePlugin.py
+++ b/src/PIL/ImImagePlugin.py
@@ -353,7 +353,6 @@ def _save(im: Image.Image, fp: IO[bytes], filename: str | bytes) -> None:
         fp.write(b"Lut: 1\r\n")
     fp.write(b"\000" * (511 - fp.tell()) + b"\032")
     if im.mode in ["P", "PA"]:
-        assert im.im is not None
         im_palette = im.im.getpalette("RGB", "RGB;L")
         colors = len(im_palette) // 3
         palette = b""
diff --git a/src/PIL/Image.py b/src/PIL/Image.py
index 7532a49a2aa..5ec41608115 100644
--- a/src/PIL/Image.py
+++ b/src/PIL/Image.py
@@ -535,7 +535,7 @@ class Image:
     def __init__(self) -> None:
         # FIXME: take "new" parameters / other image?
         # FIXME: turn mode and size into delegating properties?
-        self.im: core.ImagingCore | None = None
+        self._im: core.ImagingCore | DeferredError | None = None
         self._mode = ""
         self._size = (0, 0)
         self.palette: ImagePalette.ImagePalette | None = None
@@ -543,6 +543,17 @@ def __init__(self) -> None:
         self.readonly = 0
         self._exif: Exif | None = None
 
+    @property
+    def im(self) -> core.ImagingCore:
+        if isinstance(self._im, DeferredError):
+            raise self._im.ex
+        assert self._im is not None
+        return self._im
+
+    @im.setter
+    def im(self, im: core.ImagingCore) -> None:
+        self._im = im
+
     @property
     def width(self) -> int:
         return self.size[0]
@@ -617,12 +628,11 @@ def close(self) -> None:
         # Instead of simply setting to None, we're setting up a
         # deferred error that will better explain that the core image
         # object is gone.
-        self.im = DeferredError(ValueError("Operation on closed image"))  # type: ignore[assignment]
+        self._im = DeferredError(ValueError("Operation on closed image"))
 
     def _copy(self) -> None:
         self.load()
-        if self.im:
-            self.im = self.im.copy()
+        self.im = self.im.copy()
         self.readonly = 0
 
     def _ensure_mutable(self) -> None:
@@ -649,7 +659,6 @@ def _dump(
         self.load()
 
         if not format or format == "PPM":
-            assert self.im is not None
             self.im.save_ppm(filename)
         else:
             self.save(filename, format, **options)
@@ -798,7 +807,6 @@ def tobytes(self, encoder_name: str = "raw", *args: Any) -> bytes:
 
         # unpack data
         e = _getencoder(self.mode, encoder_name, encoder_args)
-        assert self.im is not None
         e.setimage(self.im)
 
         bufsize = max(65536, self.size[0] * 4)  # see RawEncode.c
@@ -865,7 +873,6 @@ def frombytes(
 
         # unpack data
         d = _getdecoder(self.mode, decoder_name, decoder_args)
-        assert self.im is not None
         d.setimage(self.im)
         s = d.decode(data)
 
@@ -891,7 +898,7 @@ def load(self) -> core.PixelAccess | None:
         :returns: An image access object.
         :rtype: :py:class:`.PixelAccess`
         """
-        if self.im is not None and self.palette and self.palette.dirty:
+        if self._im is not None and self.palette and self.palette.dirty:
             # realize palette
             mode, arr = self.palette.getdata()
             self.im.putpalette(self.palette.mode, mode, arr)
@@ -908,7 +915,7 @@ def load(self) -> core.PixelAccess | None:
                     self.palette.mode, self.palette.mode
                 )
 
-        if self.im is not None:
+        if self._im is not None:
             return self.im.pixel_access(self.readonly)
         return None
 
@@ -979,7 +986,6 @@ def convert(
             deprecate(mode, 12)
 
         self.load()
-        assert self.im is not None
 
         has_transparency = "transparency" in self.info
         if not mode and self.mode == "P":
@@ -1094,7 +1100,6 @@ def convert_transparency(
             new_im = self._new(im)
             from . import ImagePalette
 
-            assert new_im.im is not None
             new_im.palette = ImagePalette.ImagePalette(
                 "RGB", new_im.im.getpalette("RGB")
             )
@@ -1226,7 +1231,6 @@ def quantize(
             )
             raise ValueError(msg)
 
-        assert self.im is not None
         if palette:
             # use palette from reference image
             palette.load()
@@ -1265,7 +1269,6 @@ def copy(self) -> Image:
         :returns: An :py:class:`~PIL.Image.Image` object.
         """
         self.load()
-        assert self.im is not None
         return self._new(self.im.copy())
 
     __copy__ = copy
@@ -1294,7 +1297,6 @@ def crop(self, box: tuple[float, float, float, float] | None = None) -> Image:
             raise ValueError(msg)
 
         self.load()
-        assert self.im is not None
         return self._new(self._crop(self.im, box))
 
     def _crop(
@@ -1348,7 +1350,6 @@ def _expand(self, xmargin: int, ymargin: int | None = None) -> Image:
         if ymargin is None:
             ymargin = xmargin
         self.load()
-        assert self.im is not None
         return self._new(self.im.expand(xmargin, ymargin))
 
     if TYPE_CHECKING:
@@ -1373,7 +1374,6 @@ def filter(self, filter: ImageFilter.Filter | type[ImageFilter.Filter]) -> Image
             raise TypeError(msg)
 
         multiband = isinstance(filter, ImageFilter.MultibandFilter)
-        assert self.im is not None
         if self.im.bands == 1 or multiband:
             return self._new(filter.filter(self.im))
 
@@ -1409,7 +1409,6 @@ def getbbox(self, *, alpha_only: bool = True) -> tuple[int, int, int, int] | Non
         """
 
         self.load()
-        assert self.im is not None
         return self.im.getbbox(alpha_only)
 
     def getcolors(
@@ -1429,7 +1428,6 @@ def getcolors(
         """
 
         self.load()
-        assert self.im is not None
         if self.mode in ("1", "L", "P"):
             h = self.im.histogram()
             out: list[tuple[int, float]] = [(h[i], i) for i in range(256) if h[i]]
@@ -1457,7 +1455,6 @@ def getdata(self, band: int | None = None) -> core.ImagingCore:
         """
 
         self.load()
-        assert self.im is not None
         if band is not None:
             return self.im.getband(band)
         return self.im  # could be abused
@@ -1473,7 +1470,6 @@ def getextrema(self) -> tuple[float, float] | tuple[tuple[int, int], ...]:
         """
 
         self.load()
-        assert self.im is not None
         if self.im.bands > 1:
             return tuple(self.im.getband(i).getextrema() for i in range(self.im.bands))
         return self.im.getextrema()
@@ -1612,7 +1608,6 @@ def getim(self):
         """
 
         self.load()
-        assert self.im is not None
         return self.im.ptr
 
     def getpalette(self, rawmode: str | None = "RGB") -> list[int] | None:
@@ -1629,7 +1624,6 @@ def getpalette(self, rawmode: str | None = "RGB") -> list[int] | None:
         """
 
         self.load()
-        assert self.im is not None
         try:
             mode = self.im.getpalettemode()
         except ValueError:
@@ -1697,7 +1691,6 @@ def getpixel(
         """
 
         self.load()
-        assert self.im is not None
         return self.im.getpixel(tuple(xy))
 
     def getprojection(self) -> tuple[list[int], list[int]]:
@@ -1709,7 +1702,6 @@ def getprojection(self) -> tuple[list[int], list[int]]:
         """
 
         self.load()
-        assert self.im is not None
         x, y = self.im.getprojection()
         return list(x), list(y)
 
@@ -1737,7 +1729,6 @@ def histogram(
         :returns: A list containing pixel counts.
         """
         self.load()
-        assert self.im is not None
         if mask:
             mask.load()
             return self.im.histogram((0, 0), mask.im)
@@ -1766,7 +1757,6 @@ def entropy(
         :returns: A float value representing the image entropy
         """
         self.load()
-        assert self.im is not None
         if mask:
             mask.load()
             return self.im.entropy((0, 0), mask.im)
@@ -1856,7 +1846,6 @@ def paste(
                 if self.mode != "RGB" or im.mode not in ("LA", "RGBA", "RGBa"):
                     # should use an adapter for this!
                     im = im.convert(self.mode)
-            assert im.im is not None
             source = im.im
         elif isinstance(im, tuple):
             source = im
@@ -1864,7 +1853,6 @@ def paste(
             source = cast(float, im)
 
         self._ensure_mutable()
-        assert self.im is not None
 
         if mask:
             mask.load()
@@ -1960,7 +1948,6 @@ def point(self, data):
         if isinstance(lut, ImagePointHandler):
             return lut.point(self)
 
-        assert self.im is not None
         if callable(lut):
             # if it isn't a list, it should be a function
             if self.mode in ("I", "I;16", "F"):
@@ -1997,20 +1984,17 @@ def putalpha(self, alpha: Image | int) -> None:
 
         if self.mode not in ("LA", "PA", "RGBA"):
             # attempt to promote self to a matching alpha mode
-            assert self.im is not None
             try:
                 mode = getmodebase(self.mode) + "A"
                 try:
                     self.im.setmode(mode)
                 except (AttributeError, ValueError) as e:
                     # do things the hard way
-                    assert self.im is not None
                     im = self.im.convert(mode)
                     if im.mode not in ("LA", "PA", "RGBA"):
                         msg = "alpha channel could not be added"
                         raise ValueError(msg) from e  # sanity check
                     self.im = im
-                    assert self.im is not None
                 self._mode = self.im.mode
             except KeyError as e:
                 msg = "illegal image mode"
@@ -2021,7 +2005,6 @@ def putalpha(self, alpha: Image | int) -> None:
         else:
             band = 3
 
-        assert self.im is not None
         if isImageType(alpha):
             # alpha layer
             if alpha.mode not in ("1", "L"):
@@ -2064,7 +2047,6 @@ def putdata(
 
         self._ensure_mutable()
 
-        assert self.im is not None
         self.im.putdata(data, scale, offset)
 
     def putpalette(
@@ -2150,7 +2132,6 @@ def putpixel(
             assert self.palette is not None
             palette_index = self.palette.getcolor(tuple(value), self)
             value = (palette_index, alpha) if self.mode == "PA" else palette_index
-        assert self.im is not None
         return self.im.putpixel(xy, value)
 
     def remap_palette(
@@ -2177,7 +2158,6 @@ def remap_palette(
         if source_palette is None:
             if self.mode == "P":
                 self.load()
-                assert self.im is not None
                 palette_mode = self.im.getpalettemode()
                 if palette_mode == "RGBA":
                     bands = 4
@@ -2225,7 +2205,6 @@ def remap_palette(
         # m_im.putpalette(mapping_palette, 'L')  # converts to 'P'
         # or just force it.
         # UNDONE -- this is part of the general issue with palettes
-        assert m_im.im is not None
         m_im.im.putpalette(palette_mode, palette_mode + ";L", m_im.palette.tobytes())
 
         m_im = m_im.convert("L")
@@ -2371,7 +2350,6 @@ def resize(
                     (box[3] - reduce_box[1]) / factor_y,
                 )
 
-        assert self.im is not None
         return self._new(self.im.resize(size, resample, box))
 
     def reduce(
@@ -2406,7 +2384,7 @@ def reduce(
             return im.convert(self.mode)
 
         self.load()
-        assert self.im is not None
+
         return self._new(self.im.reduce(factor, box))
 
     def rotate(
@@ -2684,7 +2662,6 @@ def split(self) -> tuple[Image, ...]:
         """
 
         self.load()
-        assert self.im is not None
         if self.im.bands == 1:
             return (self.copy(),)
         return tuple(map(self._new, self.im.split()))
@@ -2709,7 +2686,6 @@ def getchannel(self, channel: int | str) -> Image:
                 msg = f'The image has no channel "{channel}"'
                 raise ValueError(msg) from e
 
-        assert self.im is not None
         return self._new(self.im.getband(channel))
 
     def tell(self) -> int:
@@ -2814,7 +2790,6 @@ def round_aspect(number: float, key: Callable[[int], float]) -> int:
 
             self.im = im.im
             self._size = final_size
-            assert self.im is not None
             self._mode = self.im.mode
 
         self.readonly = 0
@@ -2999,7 +2974,6 @@ def __transformer(
         if image.mode in ("1", "P"):
             resample = Resampling.NEAREST
 
-        assert self.im is not None
         self.im.transform(box, image.im, method, data, resample, fill)
 
     def transpose(self, method: Transpose) -> Image:
@@ -3014,7 +2988,6 @@ def transpose(self, method: Transpose) -> Image:
         """
 
         self.load()
-        assert self.im is not None
         return self._new(self.im.transpose(method))
 
     def effect_spread(self, distance: int) -> Image:
@@ -3024,7 +2997,6 @@ def effect_spread(self, distance: int) -> Image:
         :param distance: Distance to spread pixels.
         """
         self.load()
-        assert self.im is not None
         return self._new(self.im.effect_spread(distance))
 
     def toqimage(self):
@@ -3258,7 +3230,6 @@ def frombuffer(
             if mode == "P":
                 from . import ImagePalette
 
-                assert im.im is not None
                 im.palette = ImagePalette.ImagePalette("RGB", im.im.getpalette("RGB"))
             im.readonly = 1
             return im
diff --git a/src/PIL/ImageChops.py b/src/PIL/ImageChops.py
index b1b616d5c71..29a5c995fd8 100644
--- a/src/PIL/ImageChops.py
+++ b/src/PIL/ImageChops.py
@@ -48,7 +48,6 @@ def invert(image: Image.Image) -> Image.Image:
     """
 
     image.load()
-    assert image.im is not None
     return image._new(image.im.chop_invert())
 
 
@@ -64,7 +63,6 @@ def lighter(image1: Image.Image, image2: Image.Image) -> Image.Image:
 
     image1.load()
     image2.load()
-    assert image1.im is not None
     return image1._new(image1.im.chop_lighter(image2.im))
 
 
@@ -80,7 +78,6 @@ def darker(image1: Image.Image, image2: Image.Image) -> Image.Image:
 
     image1.load()
     image2.load()
-    assert image1.im is not None
     return image1._new(image1.im.chop_darker(image2.im))
 
 
@@ -96,7 +93,6 @@ def difference(image1: Image.Image, image2: Image.Image) -> Image.Image:
 
     image1.load()
     image2.load()
-    assert image1.im is not None
     return image1._new(image1.im.chop_difference(image2.im))
 
 
@@ -114,7 +110,6 @@ def multiply(image1: Image.Image, image2: Image.Image) -> Image.Image:
 
     image1.load()
     image2.load()
-    assert image1.im is not None
     return image1._new(image1.im.chop_multiply(image2.im))
 
 
@@ -129,7 +124,6 @@ def screen(image1: Image.Image, image2: Image.Image) -> Image.Image:
 
     image1.load()
     image2.load()
-    assert image1.im is not None
     return image1._new(image1.im.chop_screen(image2.im))
 
 
@@ -142,7 +136,6 @@ def soft_light(image1: Image.Image, image2: Image.Image) -> Image.Image:
 
     image1.load()
     image2.load()
-    assert image1.im is not None
     return image1._new(image1.im.chop_soft_light(image2.im))
 
 
@@ -155,7 +148,6 @@ def hard_light(image1: Image.Image, image2: Image.Image) -> Image.Image:
 
     image1.load()
     image2.load()
-    assert image1.im is not None
     return image1._new(image1.im.chop_hard_light(image2.im))
 
 
@@ -168,7 +160,6 @@ def overlay(image1: Image.Image, image2: Image.Image) -> Image.Image:
 
     image1.load()
     image2.load()
-    assert image1.im is not None
     return image1._new(image1.im.chop_overlay(image2.im))
 
 
@@ -186,7 +177,6 @@ def add(
 
     image1.load()
     image2.load()
-    assert image1.im is not None
     return image1._new(image1.im.chop_add(image2.im, scale, offset))
 
 
@@ -204,7 +194,6 @@ def subtract(
 
     image1.load()
     image2.load()
-    assert image1.im is not None
     return image1._new(image1.im.chop_subtract(image2.im, scale, offset))
 
 
@@ -218,7 +207,6 @@ def add_modulo(image1: Image.Image, image2: Image.Image) -> Image.Image:
 
     image1.load()
     image2.load()
-    assert image1.im is not None
     return image1._new(image1.im.chop_add_modulo(image2.im))
 
 
@@ -232,7 +220,6 @@ def subtract_modulo(image1: Image.Image, image2: Image.Image) -> Image.Image:
 
     image1.load()
     image2.load()
-    assert image1.im is not None
     return image1._new(image1.im.chop_subtract_modulo(image2.im))
 
 
@@ -251,7 +238,6 @@ def logical_and(image1: Image.Image, image2: Image.Image) -> Image.Image:
 
     image1.load()
     image2.load()
-    assert image1.im is not None
     return image1._new(image1.im.chop_and(image2.im))
 
 
@@ -267,7 +253,6 @@ def logical_or(image1: Image.Image, image2: Image.Image) -> Image.Image:
 
     image1.load()
     image2.load()
-    assert image1.im is not None
     return image1._new(image1.im.chop_or(image2.im))
 
 
@@ -283,7 +268,6 @@ def logical_xor(image1: Image.Image, image2: Image.Image) -> Image.Image:
 
     image1.load()
     image2.load()
-    assert image1.im is not None
     return image1._new(image1.im.chop_xor(image2.im))
 
 
@@ -324,5 +308,4 @@ def offset(image: Image.Image, xoffset: int, yoffset: int | None = None) -> Imag
     if yoffset is None:
         yoffset = xoffset
     image.load()
-    assert image.im is not None
     return image._new(image.im.offset(xoffset, yoffset))
diff --git a/src/PIL/ImageCms.py b/src/PIL/ImageCms.py
index 3a6d5294973..ec10230f12b 100644
--- a/src/PIL/ImageCms.py
+++ b/src/PIL/ImageCms.py
@@ -352,8 +352,6 @@ def apply(self, im: Image.Image, imOut: Image.Image | None = None) -> Image.Imag
         im.load()
         if imOut is None:
             imOut = Image.new(self.output_mode, im.size, None)
-        assert im.im is not None
-        assert imOut.im is not None
         self.transform.apply(im.im.id, imOut.im.id)
         imOut.info["icc_profile"] = self.output_profile.tobytes()
         return imOut
@@ -363,7 +361,6 @@ def apply_in_place(self, im: Image.Image) -> Image.Image:
         if im.mode != self.output_mode:
             msg = "mode mismatch"
             raise ValueError(msg)  # wrong output mode
-        assert im.im is not None
         self.transform.apply(im.im.id, im.im.id)
         im.info["icc_profile"] = self.output_profile.tobytes()
         return im
diff --git a/src/PIL/ImageFile.py b/src/PIL/ImageFile.py
index babf453cba6..24b3a9eb18d 100644
--- a/src/PIL/ImageFile.py
+++ b/src/PIL/ImageFile.py
@@ -315,7 +315,7 @@ def load(self):
 
     def load_prepare(self) -> None:
         # create image memory if necessary
-        if not self.im or self.im.mode != self.mode or self.im.size != self.size:
+        if self._im is None or self.im.mode != self.mode or self.im.size != self.size:
             self.im = Image.core.new(self.mode, self.size)
         # create palette (optional)
         if self.mode == "P":
@@ -475,7 +475,6 @@ def feed(self, data: bytes) -> None:
                     d, e, o, a = im.tile[0]
                     im.tile = []
                     self.decoder = Image._getdecoder(im.mode, d, a, im.decoderconfig)
-                    assert im.im is not None
                     self.decoder.setimage(im.im, e)
 
                     # calculate decoder offset
@@ -567,7 +566,6 @@ def _encode_tile(
             fp.seek(offset)
         encoder = Image._getencoder(im.mode, encoder_name, args, im.encoderconfig)
         try:
-            assert im.im is not None
             encoder.setimage(im.im, extents)
             if encoder.pushes_fd:
                 encoder.setfd(fp)
diff --git a/src/PIL/ImageFont.py b/src/PIL/ImageFont.py
index 2d71b4df41e..2ab65bfefe4 100644
--- a/src/PIL/ImageFont.py
+++ b/src/PIL/ImageFont.py
@@ -142,7 +142,6 @@ def _load_pilfont_data(self, file: IO[bytes], image: Image.Image) -> None:
             raise TypeError(msg)
 
         image.load()
-        assert image.im is not None
 
         self.font = Image.core.font(image.im, data)
 
diff --git a/src/PIL/ImageMath.py b/src/PIL/ImageMath.py
index c8f0406ed13..191cc2a5f88 100644
--- a/src/PIL/ImageMath.py
+++ b/src/PIL/ImageMath.py
@@ -65,8 +65,6 @@ def apply(
             except AttributeError as e:
                 msg = f"bad operand type for '{op}'"
                 raise TypeError(msg) from e
-            assert out.im is not None
-            assert im_1.im is not None
             _imagingmath.unop(op, out.im.id, im_1.im.id)
         else:
             # binary operation
@@ -95,9 +93,6 @@ def apply(
             except AttributeError as e:
                 msg = f"bad operand type for '{op}'"
                 raise TypeError(msg) from e
-            assert out.im is not None
-            assert im_1.im is not None
-            assert im_2.im is not None
             _imagingmath.binop(op, out.im.id, im_1.im.id, im_2.im.id)
         return _Operand(out)
 
diff --git a/src/PIL/ImageMorph.py b/src/PIL/ImageMorph.py
index cd4fa3cfede..6a43983d33d 100644
--- a/src/PIL/ImageMorph.py
+++ b/src/PIL/ImageMorph.py
@@ -213,8 +213,6 @@ def apply(self, image: Image.Image) -> tuple[int, Image.Image]:
             msg = "Image mode must be L"
             raise ValueError(msg)
         outimage = Image.new(image.mode, image.size, None)
-        assert image.im is not None
-        assert outimage.im is not None
         count = _imagingmorph.apply(bytes(self.lut), image.im.id, outimage.im.id)
         return count, outimage
 
@@ -231,7 +229,6 @@ def match(self, image: Image.Image) -> list[tuple[int, int]]:
         if image.mode != "L":
             msg = "Image mode must be L"
             raise ValueError(msg)
-        assert image.im is not None
         return _imagingmorph.match(bytes(self.lut), image.im.id)
 
     def get_on_pixels(self, image: Image.Image) -> list[tuple[int, int]]:
@@ -243,7 +240,6 @@ def get_on_pixels(self, image: Image.Image) -> list[tuple[int, int]]:
         if image.mode != "L":
             msg = "Image mode must be L"
             raise ValueError(msg)
-        assert image.im is not None
         return _imagingmorph.get_on_pixels(image.im.id)
 
     def load_lut(self, filename: str) -> None:
diff --git a/src/PIL/ImageTk.py b/src/PIL/ImageTk.py
index 6344220efa3..a788c9d1f13 100644
--- a/src/PIL/ImageTk.py
+++ b/src/PIL/ImageTk.py
@@ -43,7 +43,6 @@ def _pilbitmap_check() -> int:
     if _pilbitmap_ok is None:
         try:
             im = Image.new("1", (1, 1))
-            assert im.im is not None
             tkinter.BitmapImage(data=f"PIL:{im.im.id}")
             _pilbitmap_ok = 1
         except tkinter.TclError:
@@ -188,7 +187,6 @@ def paste(self, im: Image.Image) -> None:
         # convert to blittable
         im.load()
         image = im.im
-        assert image is not None
         if image.isblock() and im.mode == self.__mode:
             block = image
         else:
@@ -230,7 +228,6 @@ def __init__(self, image: Image.Image | None = None, **kw: Any) -> None:
         if _pilbitmap_check():
             # fast way (requires the pilbitmap booster patch)
             image.load()
-            assert image.im is not None
             kw["data"] = f"PIL:{image.im.id}"
             self.__im = image  # must keep a reference
         else:
@@ -277,7 +274,6 @@ def getimage(photo: PhotoImage) -> Image.Image:
     """Copies the contents of a PhotoImage to a PIL image memory."""
     im = Image.new("RGBA", (photo.width(), photo.height()))
     block = im.im
-    assert block is not None
 
     _pyimagingtkcall("PyImagingPhotoGet", photo, block.id)
 
diff --git a/src/PIL/JpegImagePlugin.py b/src/PIL/JpegImagePlugin.py
index 04fe8ba8557..fc897e2b919 100644
--- a/src/PIL/JpegImagePlugin.py
+++ b/src/PIL/JpegImagePlugin.py
@@ -473,7 +473,6 @@ def load_djpeg(self) -> None:
             except OSError:
                 pass
 
-        assert self.im is not None
         self._mode = self.im.mode
         self._size = self.im.size
 
diff --git a/src/PIL/PcdImagePlugin.py b/src/PIL/PcdImagePlugin.py
index 64898e2351b..d9970405c7a 100644
--- a/src/PIL/PcdImagePlugin.py
+++ b/src/PIL/PcdImagePlugin.py
@@ -52,10 +52,7 @@ def _open(self) -> None:
     def load_end(self) -> None:
         if self.tile_post_rotate:
             # Handle rotated PCDs
-            assert self.im is not None
-
             self.im = self.im.rotate(self.tile_post_rotate)
-            assert self.im is not None
             self._size = self.im.size
 
 
diff --git a/src/PIL/PcxImagePlugin.py b/src/PIL/PcxImagePlugin.py
index dd42003b5a3..2b8ced8afd2 100644
--- a/src/PIL/PcxImagePlugin.py
+++ b/src/PIL/PcxImagePlugin.py
@@ -202,8 +202,6 @@ def _save(im: Image.Image, fp: IO[bytes], filename: str | bytes) -> None:
 
     if im.mode == "P":
         # colour palette
-        assert im.im is not None
-
         fp.write(o8(12))
         palette = im.im.getpalette("RGB", "RGB")
         palette += b"\x00" * (768 - len(palette))
diff --git a/src/PIL/PngImagePlugin.py b/src/PIL/PngImagePlugin.py
index 59b5d0a8b11..a0ac2457115 100644
--- a/src/PIL/PngImagePlugin.py
+++ b/src/PIL/PngImagePlugin.py
@@ -869,7 +869,7 @@ def _seek(self, frame: int, rewind: bool = False) -> None:
                 self._fp.seek(self.__rewind)
                 self.png.rewind()
                 self.__prepare_idat = self.__rewind_idat
-                self.im = None
+                self._im = None
                 self.info = self.png.im_info
                 self.tile = self.png.im_tile
                 self.fp = self._fp
@@ -887,7 +887,6 @@ def _seek(self, frame: int, rewind: bool = False) -> None:
 
             # ensure previous frame was loaded
             self.load()
-            assert self.im is not None
 
             if self.dispose:
                 self.im.paste(self.dispose, self.dispose_extent)
@@ -1050,7 +1049,6 @@ def load_end(self) -> None:
             self.png = None
         else:
             if self._prev_im and self.blend_op == Blend.OP_OVER:
-                assert self.im is not None
                 updated = self._crop(self.im, self.dispose_extent)
                 if self.im.mode == "RGB" and "transparency" in self.info:
                     mask = updated.convert_transparent(
@@ -1405,7 +1403,6 @@ def _save(
                     chunk(fp, cid, data)
 
     if im.mode == "P":
-        assert im.im is not None
         palette_byte_number = colors * 3
         palette_bytes = im.im.getpalette("RGB")[:palette_byte_number]
         while len(palette_bytes) < palette_byte_number:
@@ -1436,9 +1433,8 @@ def _save(
                 # and it's in the info dict. It's probably just stale.
                 msg = "cannot use transparency for this mode"
                 raise OSError(msg)
-    elif im.mode == "P":
-        assert im.im is not None
-        if im.im.getpalettemode() == "RGBA":
+    else:
+        if im.mode == "P" and im.im.getpalettemode() == "RGBA":
             alpha = im.im.getpalette("RGBA", "A")
             alpha_bytes = colors
             chunk(fp, b"tRNS", alpha[:alpha_bytes])
diff --git a/src/PIL/TgaImagePlugin.py b/src/PIL/TgaImagePlugin.py
index 39104aeced9..c2a0ee4e923 100644
--- a/src/PIL/TgaImagePlugin.py
+++ b/src/PIL/TgaImagePlugin.py
@@ -158,7 +158,6 @@ def _open(self) -> None:
 
     def load_end(self) -> None:
         if self._flip_horizontally:
-            assert self.im is not None
             self.im = self.im.transpose(Image.Transpose.FLIP_LEFT_RIGHT)
 
 
@@ -200,7 +199,6 @@ def _save(im: Image.Image, fp: IO[bytes], filename: str | bytes) -> None:
         warnings.warn("id_section has been trimmed to 255 characters")
 
     if colormaptype:
-        assert im.im is not None
         palette = im.im.getpalette("RGB", "BGR")
         colormaplength, colormapentry = len(palette) // 3, 24
     else:
diff --git a/src/PIL/TiffImagePlugin.py b/src/PIL/TiffImagePlugin.py
index 2b53c7dfa27..d9d1bab5ac8 100644
--- a/src/PIL/TiffImagePlugin.py
+++ b/src/PIL/TiffImagePlugin.py
@@ -1313,7 +1313,6 @@ def _load_libtiff(self) -> Image.core.PixelAccess | None:
         decoder = Image._getdecoder(
             self.mode, "libtiff", tuple(args), self.decoderconfig
         )
-        assert self.im is not None
         try:
             decoder.setimage(self.im, extents)
         except ValueError as e:
diff --git a/src/PIL/WalImageFile.py b/src/PIL/WalImageFile.py
index ec5c7490001..87e32878b19 100644
--- a/src/PIL/WalImageFile.py
+++ b/src/PIL/WalImageFile.py
@@ -54,7 +54,7 @@ def _open(self) -> None:
             self.info["next_name"] = next_name
 
     def load(self) -> Image.core.PixelAccess | None:
-        if not self.im:
+        if self._im is None:
             self.im = Image.core.new(self.mode, self.size)
             self.frombytes(self.fp.read(self.size[0] * self.size[1]))
             self.putpalette(quake2palette)

From de441ee09107a2ac544eee905f6e94aeaa21cb55 Mon Sep 17 00:00:00 2001
From: Andrew Murray <radarhere@users.noreply.github.com>
Date: Sat, 10 Aug 2024 21:05:14 +1000
Subject: [PATCH 0902/1178] Updated to Python 3.10

---
 Tests/oss-fuzz/python.supp | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/Tests/oss-fuzz/python.supp b/Tests/oss-fuzz/python.supp
index 94cc87db97d..36385d67266 100644
--- a/Tests/oss-fuzz/python.supp
+++ b/Tests/oss-fuzz/python.supp
@@ -1,5 +1,5 @@
 {
-   <py3_8_encode_current_locale>
+   <py3_10_encode_current_locale>
    Memcheck:Cond
    ...
    fun:encode_current_locale

From 0d79a38e77ddcf5e386d2153e791f12e5d67a2f5 Mon Sep 17 00:00:00 2001
From: Aleksandr Karpinskii <homm86@gmail.com>
Date: Sun, 11 Aug 2024 15:14:29 +0400
Subject: [PATCH 0903/1178] Add missing TIFF CMYK;16B reader

---
 src/PIL/TiffImagePlugin.py | 1 +
 1 file changed, 1 insertion(+)

diff --git a/src/PIL/TiffImagePlugin.py b/src/PIL/TiffImagePlugin.py
index d9d1bab5ac8..deae199d50e 100644
--- a/src/PIL/TiffImagePlugin.py
+++ b/src/PIL/TiffImagePlugin.py
@@ -259,6 +259,7 @@
     (II, 5, (1,), 1, (8, 8, 8, 8, 8, 8), (0, 0)): ("CMYK", "CMYKXX"),
     (MM, 5, (1,), 1, (8, 8, 8, 8, 8, 8), (0, 0)): ("CMYK", "CMYKXX"),
     (II, 5, (1,), 1, (16, 16, 16, 16), ()): ("CMYK", "CMYK;16L"),
+    (MM, 5, (1,), 1, (16, 16, 16, 16), ()): ("CMYK", "CMYK;16B"),
     (II, 6, (1,), 1, (8,), ()): ("L", "L"),
     (MM, 6, (1,), 1, (8,), ()): ("L", "L"),
     # JPEG compressed images handled by LibTiff and auto-converted to RGBX

From f801649513f1e1a89505cc6c481d5b26202dc2f4 Mon Sep 17 00:00:00 2001
From: Andrew Murray <radarhere@users.noreply.github.com>
Date: Tue, 13 Aug 2024 06:11:32 +1000
Subject: [PATCH 0904/1178] Updated freetype to 2.13.3

---
 winbuild/build_prepare.py | 10 +++-------
 1 file changed, 3 insertions(+), 7 deletions(-)

diff --git a/winbuild/build_prepare.py b/winbuild/build_prepare.py
index 9837589b2b1..241737f9228 100644
--- a/winbuild/build_prepare.py
+++ b/winbuild/build_prepare.py
@@ -111,7 +111,7 @@ def cmd_msbuild(
 
 V = {
     "BROTLI": "1.1.0",
-    "FREETYPE": "2.13.2",
+    "FREETYPE": "2.13.3",
     "FRIBIDI": "1.0.15",
     "HARFBUZZ": "8.5.0",
     "JPEGTURBO": "3.0.3",
@@ -293,12 +293,8 @@ def cmd_msbuild(
         },
         "build": [
             cmd_rmdir("objs"),
-            cmd_msbuild(
-                r"builds\windows\vc2010\freetype.sln", "Release Static", "Clean"
-            ),
-            cmd_msbuild(
-                r"builds\windows\vc2010\freetype.sln", "Release Static", "Build"
-            ),
+            cmd_msbuild("MSBuild.sln", "Release Static", "Clean"),
+            cmd_msbuild("MSBuild.sln", "Release Static", "Build"),
             cmd_xcopy("include", "{inc_dir}"),
         ],
         "libs": [r"objs\{msbuild_arch}\Release Static\freetype.lib"],

From c1e8375af834b190386cd2cfa30703c7975675a8 Mon Sep 17 00:00:00 2001
From: Aleksandr Karpinskii <homm86@gmail.com>
Date: Sun, 7 Jul 2024 21:51:14 +0400
Subject: [PATCH 0905/1178] Require webpmux and webpdemux

---
 Tests/check_wheel.py                       |  1 -
 Tests/test_features.py                     |  5 ---
 Tests/test_file_webp_metadata.py           |  5 +--
 docs/handbook/image-file-formats.rst       |  9 ++---
 docs/installation/building-from-source.rst |  8 ++--
 docs/reference/features.rst                |  1 -
 setup.py                                   | 46 ++++++++--------------
 src/PIL/features.py                        |  2 -
 src/_webp.c                                | 33 ----------------
 winbuild/build_prepare.py                  |  2 +-
 10 files changed, 26 insertions(+), 86 deletions(-)

diff --git a/Tests/check_wheel.py b/Tests/check_wheel.py
index 4b91984f58a..2e4498db6c3 100644
--- a/Tests/check_wheel.py
+++ b/Tests/check_wheel.py
@@ -28,7 +28,6 @@ def test_wheel_codecs() -> None:
 def test_wheel_features() -> None:
     expected_features = {
         "webp_anim",
-        "webp_mux",
         "transp_webp",
         "raqm",
         "fribidi",
diff --git a/Tests/test_features.py b/Tests/test_features.py
index b7eefa09ae1..33509a346af 100644
--- a/Tests/test_features.py
+++ b/Tests/test_features.py
@@ -57,11 +57,6 @@ def test_webp_transparency() -> None:
     assert features.check("transp_webp") == _webp.HAVE_TRANSPARENCY
 
 
-@skip_unless_feature("webp")
-def test_webp_mux() -> None:
-    assert features.check("webp_mux") == _webp.HAVE_WEBPMUX
-
-
 @skip_unless_feature("webp")
 def test_webp_anim() -> None:
     assert features.check("webp_anim") == _webp.HAVE_WEBPANIM
diff --git a/Tests/test_file_webp_metadata.py b/Tests/test_file_webp_metadata.py
index c3df4ad7bcb..52a84a83e9b 100644
--- a/Tests/test_file_webp_metadata.py
+++ b/Tests/test_file_webp_metadata.py
@@ -10,10 +10,7 @@
 
 from .helper import mark_if_feature_version, skip_unless_feature
 
-pytestmark = [
-    skip_unless_feature("webp"),
-    skip_unless_feature("webp_mux"),
-]
+pytestmark = [skip_unless_feature("webp")]
 
 ElementTree: ModuleType | None
 try:
diff --git a/docs/handbook/image-file-formats.rst b/docs/handbook/image-file-formats.rst
index 1ec97214900..8561cc4aa29 100644
--- a/docs/handbook/image-file-formats.rst
+++ b/docs/handbook/image-file-formats.rst
@@ -1252,16 +1252,13 @@ The :py:meth:`~PIL.Image.Image.save` method supports the following options:
     Requires libwebp 0.5.0 or later.
 
 **icc_profile**
-    The ICC Profile to include in the saved file. Only supported if
-    the system WebP library was built with webpmux support.
+    The ICC Profile to include in the saved file.
 
 **exif**
-    The exif data to include in the saved file. Only supported if
-    the system WebP library was built with webpmux support.
+    The exif data to include in the saved file.
 
 **xmp**
-    The XMP data to include in the saved file. Only supported if
-    the system WebP library was built with webpmux support.
+    The XMP data to include in the saved file.
 
 Saving sequences
 ~~~~~~~~~~~~~~~~
diff --git a/docs/installation/building-from-source.rst b/docs/installation/building-from-source.rst
index 7f7dfa6ff24..f47edbc5bcc 100644
--- a/docs/installation/building-from-source.rst
+++ b/docs/installation/building-from-source.rst
@@ -275,18 +275,18 @@ Build Options
 
 * Config settings: ``-C zlib=disable``, ``-C jpeg=disable``,
   ``-C tiff=disable``, ``-C freetype=disable``, ``-C raqm=disable``,
-  ``-C lcms=disable``, ``-C webp=disable``, ``-C webpmux=disable``,
+  ``-C lcms=disable``, ``-C webp=disable``,
   ``-C jpeg2000=disable``, ``-C imagequant=disable``, ``-C xcb=disable``.
   Disable building the corresponding feature even if the development
   libraries are present on the building machine.
 
 * Config settings: ``-C zlib=enable``, ``-C jpeg=enable``,
   ``-C tiff=enable``, ``-C freetype=enable``, ``-C raqm=enable``,
-  ``-C lcms=enable``, ``-C webp=enable``, ``-C webpmux=enable``,
+  ``-C lcms=enable``, ``-C webp=enable``,
   ``-C jpeg2000=enable``, ``-C imagequant=enable``, ``-C xcb=enable``.
   Require that the corresponding feature is built. The build will raise
-  an exception if the libraries are not found. Webpmux (WebP metadata)
-  relies on WebP support. Tcl and Tk also must be used together.
+  an exception if the libraries are not found. Tcl and Tk must be used
+  together.
 
 * Config settings: ``-C raqm=vendor``, ``-C fribidi=vendor``.
   These flags are used to compile a modified version of libraqm and
diff --git a/docs/reference/features.rst b/docs/reference/features.rst
index c6619306186..55c0b120007 100644
--- a/docs/reference/features.rst
+++ b/docs/reference/features.rst
@@ -55,7 +55,6 @@ Support for the following features can be checked:
 
 * ``libjpeg_turbo``: (compile time) Whether Pillow was compiled against the libjpeg-turbo version of libjpeg. Compile-time version number is available.
 * ``transp_webp``: Support for transparency in WebP images.
-* ``webp_mux``: (compile time) Support for EXIF data in WebP images.
 * ``webp_anim``: (compile time) Support for animated WebP images.
 * ``raqm``: Raqm library, required for ``ImageFont.Layout.RAQM`` in :py:func:`PIL.ImageFont.truetype`. Run-time version number is available for Raqm 0.7.0 or newer.
 * ``libimagequant``: (compile time) ImageQuant quantization support in :py:func:`PIL.Image.Image.quantize`. Run-time version number is available.
diff --git a/setup.py b/setup.py
index b26852b0b07..8d0dfb6fa21 100644
--- a/setup.py
+++ b/setup.py
@@ -295,7 +295,6 @@ class feature:
             "raqm",
             "lcms",
             "webp",
-            "webpmux",
             "jpeg2000",
             "imagequant",
             "xcb",
@@ -794,28 +793,21 @@ def build_extensions(self):
 
         if feature.want("webp"):
             _dbg("Looking for webp")
-            if _find_include_file(self, "webp/encode.h") and _find_include_file(
-                self, "webp/decode.h"
+            if all(
+                _find_include_file(self, src)
+                for src in ["webp/encode.h", "webp/mux.h", "webp/demux.h"]
             ):
                 # In Google's precompiled zip it is call "libwebp":
-                if _find_library_file(self, "webp"):
-                    feature.webp = "webp"
-                elif _find_library_file(self, "libwebp"):
-                    feature.webp = "libwebp"
-
-        if feature.want("webpmux"):
-            _dbg("Looking for webpmux")
-            if _find_include_file(self, "webp/mux.h") and _find_include_file(
-                self, "webp/demux.h"
-            ):
-                if _find_library_file(self, "webpmux") and _find_library_file(
-                    self, "webpdemux"
+                if all(
+                    _find_library_file(self, lib)
+                    for lib in ["webp", "webpmux", "webpdemux"]
                 ):
-                    feature.webpmux = "webpmux"
-                if _find_library_file(self, "libwebpmux") and _find_library_file(
-                    self, "libwebpdemux"
+                    feature.webp = "webp"
+                elif all(
+                    _find_library_file(self, lib)
+                    for lib in ["libwebp", "libwebpmux", "libwebpdemux"]
                 ):
-                    feature.webpmux = "libwebpmux"
+                    feature.webp = "libwebp"
 
         if feature.want("xcb"):
             _dbg("Looking for xcb")
@@ -904,15 +896,12 @@ def build_extensions(self):
             self._remove_extension("PIL._imagingcms")
 
         if feature.webp:
-            libs = [feature.webp]
-            defs = []
-
-            if feature.webpmux:
-                defs.append(("HAVE_WEBPMUX", None))
-                libs.append(feature.webpmux)
-                libs.append(feature.webpmux.replace("pmux", "pdemux"))
-
-            self._update_extension("PIL._webp", libs, defs)
+            libs = [
+                feature.webp,
+                feature.webp + "mux",
+                feature.webp + "demux",
+            ]
+            self._update_extension("PIL._webp", libs, [])
         else:
             self._remove_extension("PIL._webp")
 
@@ -953,7 +942,6 @@ def summary_report(self, feature):
             (feature.raqm, "RAQM (Text shaping)", raqm_extra_info),
             (feature.lcms, "LITTLECMS2"),
             (feature.webp, "WEBP"),
-            (feature.webpmux, "WEBPMUX"),
             (feature.xcb, "XCB (X protocol)"),
         ]
 
diff --git a/src/PIL/features.py b/src/PIL/features.py
index 13908c4eb78..7f6cdb1618f 100644
--- a/src/PIL/features.py
+++ b/src/PIL/features.py
@@ -120,7 +120,6 @@ def get_supported_codecs() -> list[str]:
 
 features = {
     "webp_anim": ("PIL._webp", "HAVE_WEBPANIM", None),
-    "webp_mux": ("PIL._webp", "HAVE_WEBPMUX", None),
     "transp_webp": ("PIL._webp", "HAVE_TRANSPARENCY", None),
     "raqm": ("PIL._imagingft", "HAVE_RAQM", "raqm_version"),
     "fribidi": ("PIL._imagingft", "HAVE_FRIBIDI", "fribidi_version"),
@@ -272,7 +271,6 @@ def pilinfo(out: IO[str] | None = None, supported_formats: bool = True) -> None:
         ("littlecms2", "LITTLECMS2"),
         ("webp", "WEBP"),
         ("transp_webp", "WEBP Transparency"),
-        ("webp_mux", "WEBPMUX"),
         ("webp_anim", "WEBP Animation"),
         ("jpg", "JPEG"),
         ("jpg_2000", "OPENJPEG (JPEG2000)"),
diff --git a/src/_webp.c b/src/_webp.c
index e686ec820fd..ab229058b4d 100644
--- a/src/_webp.c
+++ b/src/_webp.c
@@ -4,8 +4,6 @@
 #include <webp/encode.h>
 #include <webp/decode.h>
 #include <webp/types.h>
-
-#ifdef HAVE_WEBPMUX
 #include <webp/mux.h>
 #include <webp/demux.h>
 
@@ -19,8 +17,6 @@
 #define HAVE_WEBPANIM
 #endif
 
-#endif
-
 void
 ImagingSectionEnter(ImagingSectionCookie *cookie) {
     *cookie = (PyThreadState *)PyEval_SaveThread();
@@ -35,8 +31,6 @@ ImagingSectionLeave(ImagingSectionCookie *cookie) {
 /* WebP Muxer Error Handling                                            */
 /* -------------------------------------------------------------------- */
 
-#ifdef HAVE_WEBPMUX
-
 static const char *const kErrorMessages[-WEBP_MUX_NOT_ENOUGH_DATA + 1] = {
     "WEBP_MUX_NOT_FOUND",
     "WEBP_MUX_INVALID_ARGUMENT",
@@ -89,8 +83,6 @@ HandleMuxError(WebPMuxError err, char *chunk) {
     return NULL;
 }
 
-#endif
-
 /* -------------------------------------------------------------------- */
 /* WebP Animation Support                                               */
 /* -------------------------------------------------------------------- */
@@ -693,13 +685,6 @@ WebPEncode_wrapper(PyObject *self, PyObject *args) {
     output = writer.mem;
     ret_size = writer.size;
 
-#ifndef HAVE_WEBPMUX
-    if (ret_size > 0) {
-        PyObject *ret = PyBytes_FromStringAndSize((char *)output, ret_size);
-        free(output);
-        return ret;
-    }
-#else
     {
         /* I want to truncate the *_size items that get passed into WebP
            data. Pypy2.1.0 had some issues where the Py_ssize_t items had
@@ -775,7 +760,6 @@ WebPEncode_wrapper(PyObject *self, PyObject *args) {
             return ret;
         }
     }
-#endif
     Py_RETURN_NONE;
 }
 
@@ -809,9 +793,6 @@ WebPDecode_wrapper(PyObject *self, PyObject *args) {
             mode = "RGBA";
         }
 
-#ifndef HAVE_WEBPMUX
-        vp8_status_code = WebPDecode(webp, size, &config);
-#else
         {
             int copy_data = 0;
             WebPData data = {webp, size};
@@ -849,7 +830,6 @@ WebPDecode_wrapper(PyObject *self, PyObject *args) {
             WebPDataClear(&image.bitstream);
             WebPMuxDelete(mux);
         }
-#endif
     }
 
     if (vp8_status_code != VP8_STATUS_OK) {
@@ -949,18 +929,6 @@ static PyMethodDef webpMethods[] = {
     {NULL, NULL}
 };
 
-void
-addMuxFlagToModule(PyObject *m) {
-    PyObject *have_webpmux;
-#ifdef HAVE_WEBPMUX
-    have_webpmux = Py_True;
-#else
-    have_webpmux = Py_False;
-#endif
-    Py_INCREF(have_webpmux);
-    PyModule_AddObject(m, "HAVE_WEBPMUX", have_webpmux);
-}
-
 void
 addAnimFlagToModule(PyObject *m) {
     PyObject *have_webpanim;
@@ -991,7 +959,6 @@ setup_module(PyObject *m) {
     }
 #endif
     PyObject *d = PyModule_GetDict(m);
-    addMuxFlagToModule(m);
     addAnimFlagToModule(m);
     addTransparencyFlagToModule(m);
 
diff --git a/winbuild/build_prepare.py b/winbuild/build_prepare.py
index 9837589b2b1..7129699eb52 100644
--- a/winbuild/build_prepare.py
+++ b/winbuild/build_prepare.py
@@ -201,7 +201,7 @@ def cmd_msbuild(
         },
         "build": [
             *cmds_cmake(
-                "webp webpdemux webpmux",
+                "webp webpmux webpdemux",
                 "-DBUILD_SHARED_LIBS:BOOL=OFF",
                 "-DWEBP_LINK_STATIC:BOOL=OFF",
             ),

From 9bed5b426437ad4aacd36288fcfb9422cac8c9c9 Mon Sep 17 00:00:00 2001
From: Aleksandr Karpinskii <homm86@gmail.com>
Date: Sun, 7 Jul 2024 22:05:57 +0400
Subject: [PATCH 0906/1178] Remove _webp.WebPDecoderBuggyAlpha and
 _webp.HAVE_TRANSPARENCY

---
 Tests/check_wheel.py          |  1 -
 Tests/test_features.py        |  6 ------
 Tests/test_file_webp.py       |  1 -
 Tests/test_file_webp_alpha.py |  8 --------
 docs/reference/features.rst   |  1 -
 src/PIL/features.py           |  2 --
 src/_webp.c                   | 27 ---------------------------
 7 files changed, 46 deletions(-)

diff --git a/Tests/check_wheel.py b/Tests/check_wheel.py
index 2e4498db6c3..f862e4fff89 100644
--- a/Tests/check_wheel.py
+++ b/Tests/check_wheel.py
@@ -28,7 +28,6 @@ def test_wheel_codecs() -> None:
 def test_wheel_features() -> None:
     expected_features = {
         "webp_anim",
-        "transp_webp",
         "raqm",
         "fribidi",
         "harfbuzz",
diff --git a/Tests/test_features.py b/Tests/test_features.py
index 33509a346af..577e7a5d5c8 100644
--- a/Tests/test_features.py
+++ b/Tests/test_features.py
@@ -51,12 +51,6 @@ def test(name: str, function: Callable[[str], str | None]) -> None:
         test(feature, features.version_feature)
 
 
-@skip_unless_feature("webp")
-def test_webp_transparency() -> None:
-    assert features.check("transp_webp") != _webp.WebPDecoderBuggyAlpha()
-    assert features.check("transp_webp") == _webp.HAVE_TRANSPARENCY
-
-
 @skip_unless_feature("webp")
 def test_webp_anim() -> None:
     assert features.check("webp_anim") == _webp.HAVE_WEBPANIM
diff --git a/Tests/test_file_webp.py b/Tests/test_file_webp.py
index cbc905de4e7..f132d0a64b4 100644
--- a/Tests/test_file_webp.py
+++ b/Tests/test_file_webp.py
@@ -49,7 +49,6 @@ def setup_method(self) -> None:
 
     def test_version(self) -> None:
         _webp.WebPDecoderVersion()
-        _webp.WebPDecoderBuggyAlpha()
         version = features.version_module("webp")
         assert version is not None
         assert re.search(r"\d+\.\d+\.\d+$", version)
diff --git a/Tests/test_file_webp_alpha.py b/Tests/test_file_webp_alpha.py
index c7445212110..e80ef7d4f5b 100644
--- a/Tests/test_file_webp_alpha.py
+++ b/Tests/test_file_webp_alpha.py
@@ -16,11 +16,6 @@
 _webp = pytest.importorskip("PIL._webp", reason="WebP support not installed")
 
 
-def setup_module() -> None:
-    if _webp.WebPDecoderBuggyAlpha():
-        pytest.skip("Buggy early version of WebP installed, not testing transparency")
-
-
 def test_read_rgba() -> None:
     """
     Can we read an RGBA mode file without error?
@@ -81,9 +76,6 @@ def test_write_rgba(tmp_path: Path) -> None:
     pil_image = Image.new("RGBA", (10, 10), (255, 0, 0, 20))
     pil_image.save(temp_file)
 
-    if _webp.WebPDecoderBuggyAlpha():
-        return
-
     with Image.open(temp_file) as image:
         image.load()
 
diff --git a/docs/reference/features.rst b/docs/reference/features.rst
index 55c0b120007..d4fb340bdc6 100644
--- a/docs/reference/features.rst
+++ b/docs/reference/features.rst
@@ -54,7 +54,6 @@ Feature version numbers are available only where stated.
 Support for the following features can be checked:
 
 * ``libjpeg_turbo``: (compile time) Whether Pillow was compiled against the libjpeg-turbo version of libjpeg. Compile-time version number is available.
-* ``transp_webp``: Support for transparency in WebP images.
 * ``webp_anim``: (compile time) Support for animated WebP images.
 * ``raqm``: Raqm library, required for ``ImageFont.Layout.RAQM`` in :py:func:`PIL.ImageFont.truetype`. Run-time version number is available for Raqm 0.7.0 or newer.
 * ``libimagequant``: (compile time) ImageQuant quantization support in :py:func:`PIL.Image.Image.quantize`. Run-time version number is available.
diff --git a/src/PIL/features.py b/src/PIL/features.py
index 7f6cdb1618f..60590dc098d 100644
--- a/src/PIL/features.py
+++ b/src/PIL/features.py
@@ -120,7 +120,6 @@ def get_supported_codecs() -> list[str]:
 
 features = {
     "webp_anim": ("PIL._webp", "HAVE_WEBPANIM", None),
-    "transp_webp": ("PIL._webp", "HAVE_TRANSPARENCY", None),
     "raqm": ("PIL._imagingft", "HAVE_RAQM", "raqm_version"),
     "fribidi": ("PIL._imagingft", "HAVE_FRIBIDI", "fribidi_version"),
     "harfbuzz": ("PIL._imagingft", "HAVE_HARFBUZZ", "harfbuzz_version"),
@@ -270,7 +269,6 @@ def pilinfo(out: IO[str] | None = None, supported_formats: bool = True) -> None:
         ("freetype2", "FREETYPE2"),
         ("littlecms2", "LITTLECMS2"),
         ("webp", "WEBP"),
-        ("transp_webp", "WEBP Transparency"),
         ("webp_anim", "WEBP Animation"),
         ("jpg", "JPEG"),
         ("jpg_2000", "OPENJPEG (JPEG2000)"),
diff --git a/src/_webp.c b/src/_webp.c
index ab229058b4d..a10eb111c3b 100644
--- a/src/_webp.c
+++ b/src/_webp.c
@@ -896,20 +896,6 @@ WebPDecoderVersion_str(void) {
     return version;
 }
 
-/*
- * The version of webp that ships with (0.1.3) Ubuntu 12.04 doesn't handle alpha well.
- * Files that are valid with 0.3 are reported as being invalid.
- */
-int
-WebPDecoderBuggyAlpha(void) {
-    return WebPGetDecoderVersion() == 0x0103;
-}
-
-PyObject *
-WebPDecoderBuggyAlpha_wrapper() {
-    return Py_BuildValue("i", WebPDecoderBuggyAlpha());
-}
-
 /* -------------------------------------------------------------------- */
 /* Module Setup                                                         */
 /* -------------------------------------------------------------------- */
@@ -922,10 +908,6 @@ static PyMethodDef webpMethods[] = {
     {"WebPEncode", WebPEncode_wrapper, METH_VARARGS, "WebPEncode"},
     {"WebPDecode", WebPDecode_wrapper, METH_VARARGS, "WebPDecode"},
     {"WebPDecoderVersion", WebPDecoderVersion_wrapper, METH_NOARGS, "WebPVersion"},
-    {"WebPDecoderBuggyAlpha",
-     WebPDecoderBuggyAlpha_wrapper,
-     METH_NOARGS,
-     "WebPDecoderBuggyAlpha"},
     {NULL, NULL}
 };
 
@@ -941,14 +923,6 @@ addAnimFlagToModule(PyObject *m) {
     PyModule_AddObject(m, "HAVE_WEBPANIM", have_webpanim);
 }
 
-void
-addTransparencyFlagToModule(PyObject *m) {
-    PyObject *have_transparency = PyBool_FromLong(!WebPDecoderBuggyAlpha());
-    if (PyModule_AddObject(m, "HAVE_TRANSPARENCY", have_transparency)) {
-        Py_DECREF(have_transparency);
-    }
-}
-
 static int
 setup_module(PyObject *m) {
 #ifdef HAVE_WEBPANIM
@@ -960,7 +934,6 @@ setup_module(PyObject *m) {
 #endif
     PyObject *d = PyModule_GetDict(m);
     addAnimFlagToModule(m);
-    addTransparencyFlagToModule(m);
 
     PyObject *v = PyUnicode_FromString(WebPDecoderVersion_str());
     PyDict_SetItemString(d, "webpdecoder_version", v ? v : Py_None);

From a3468996c0b7b6df2b685ff21c4f515f5105ff8c Mon Sep 17 00:00:00 2001
From: Aleksandr Karpinskii <homm86@gmail.com>
Date: Sun, 7 Jul 2024 22:47:06 +0400
Subject: [PATCH 0907/1178] Remove webp animations flags and conditions

Removed:
_webp.WebPDecode
_webp.HAVE_WEBPANIM
features.webp_anim
---
 Tests/check_wheel.py                 |   1 -
 Tests/test_features.py               |  10 --
 Tests/test_file_gif.py               |   2 +-
 Tests/test_file_webp.py              |  24 ++---
 Tests/test_file_webp_alpha.py        |   7 +-
 Tests/test_file_webp_animated.py     |   5 +-
 Tests/test_file_webp_lossless.py     |   3 -
 Tests/test_file_webp_metadata.py     |   3 +-
 Tests/test_image.py                  |   1 -
 Tests/test_imagefile.py              |   1 -
 Tests/test_imageops.py               |   2 +-
 docs/handbook/image-file-formats.rst |   9 +-
 docs/reference/features.rst          |   1 -
 setup.py                             |   7 +-
 src/PIL/WebPImagePlugin.py           |  51 +++------
 src/PIL/features.py                  |   2 -
 src/_webp.c                          | 150 +--------------------------
 17 files changed, 36 insertions(+), 243 deletions(-)

diff --git a/Tests/check_wheel.py b/Tests/check_wheel.py
index f862e4fff89..8fcb75dad5c 100644
--- a/Tests/check_wheel.py
+++ b/Tests/check_wheel.py
@@ -27,7 +27,6 @@ def test_wheel_codecs() -> None:
 
 def test_wheel_features() -> None:
     expected_features = {
-        "webp_anim",
         "raqm",
         "fribidi",
         "harfbuzz",
diff --git a/Tests/test_features.py b/Tests/test_features.py
index 577e7a5d5c8..40466082f7a 100644
--- a/Tests/test_features.py
+++ b/Tests/test_features.py
@@ -10,11 +10,6 @@
 
 from .helper import skip_unless_feature
 
-try:
-    from PIL import _webp
-except ImportError:
-    pass
-
 
 def test_check() -> None:
     # Check the correctness of the convenience function
@@ -51,11 +46,6 @@ def test(name: str, function: Callable[[str], str | None]) -> None:
         test(feature, features.version_feature)
 
 
-@skip_unless_feature("webp")
-def test_webp_anim() -> None:
-    assert features.check("webp_anim") == _webp.HAVE_WEBPANIM
-
-
 @skip_unless_feature("libjpeg_turbo")
 def test_libjpeg_turbo_version() -> None:
     version = features.version("libjpeg_turbo")
diff --git a/Tests/test_file_gif.py b/Tests/test_file_gif.py
index 85b017d29af..8cefdb628e6 100644
--- a/Tests/test_file_gif.py
+++ b/Tests/test_file_gif.py
@@ -978,7 +978,7 @@ def test_webp_background(tmp_path: Path) -> None:
     out = str(tmp_path / "temp.gif")
 
     # Test opaque WebP background
-    if features.check("webp") and features.check("webp_anim"):
+    if features.check("webp"):
         with Image.open("Tests/images/hopper.webp") as im:
             assert im.info["background"] == (255, 255, 255, 255)
             im.save(out)
diff --git a/Tests/test_file_webp.py b/Tests/test_file_webp.py
index f132d0a64b4..6e9eea4aec0 100644
--- a/Tests/test_file_webp.py
+++ b/Tests/test_file_webp.py
@@ -48,7 +48,6 @@ def setup_method(self) -> None:
         self.rgb_mode = "RGB"
 
     def test_version(self) -> None:
-        _webp.WebPDecoderVersion()
         version = features.version_module("webp")
         assert version is not None
         assert re.search(r"\d+\.\d+\.\d+$", version)
@@ -116,7 +115,6 @@ def test_write_method(self, tmp_path: Path) -> None:
         hopper().save(buffer_method, format="WEBP", method=6)
         assert buffer_no_args.getbuffer() != buffer_method.getbuffer()
 
-    @skip_unless_feature("webp_anim")
     def test_save_all(self, tmp_path: Path) -> None:
         temp_file = str(tmp_path / "temp.webp")
         im = Image.new("RGB", (1, 1))
@@ -131,10 +129,9 @@ def test_save_all(self, tmp_path: Path) -> None:
 
     def test_icc_profile(self, tmp_path: Path) -> None:
         self._roundtrip(tmp_path, self.rgb_mode, 12.5, {"icc_profile": None})
-        if _webp.HAVE_WEBPANIM:
-            self._roundtrip(
-                tmp_path, self.rgb_mode, 12.5, {"icc_profile": None, "save_all": True}
-            )
+        self._roundtrip(
+            tmp_path, self.rgb_mode, 12.5, {"icc_profile": None, "save_all": True}
+        )
 
     def test_write_unsupported_mode_L(self, tmp_path: Path) -> None:
         """
@@ -164,10 +161,8 @@ def test_WebPEncode_with_invalid_args(self) -> None:
         """
         Calling encoder functions with no arguments should result in an error.
         """
-
-        if _webp.HAVE_WEBPANIM:
-            with pytest.raises(TypeError):
-                _webp.WebPAnimEncoder()
+        with pytest.raises(TypeError):
+            _webp.WebPAnimEncoder()
         with pytest.raises(TypeError):
             _webp.WebPEncode()
 
@@ -175,12 +170,8 @@ def test_WebPDecode_with_invalid_args(self) -> None:
         """
         Calling decoder functions with no arguments should result in an error.
         """
-
-        if _webp.HAVE_WEBPANIM:
-            with pytest.raises(TypeError):
-                _webp.WebPAnimDecoder()
         with pytest.raises(TypeError):
-            _webp.WebPDecode()
+            _webp.WebPAnimDecoder()
 
     def test_no_resource_warning(self, tmp_path: Path) -> None:
         file_path = "Tests/images/hopper.webp"
@@ -199,7 +190,6 @@ def test_file_pointer_could_be_reused(self) -> None:
         "background",
         (0, (0,), (-1, 0, 1, 2), (253, 254, 255, 256)),
     )
-    @skip_unless_feature("webp_anim")
     def test_invalid_background(
         self, background: int | tuple[int, ...], tmp_path: Path
     ) -> None:
@@ -208,7 +198,6 @@ def test_invalid_background(
         with pytest.raises(OSError):
             im.save(temp_file, save_all=True, append_images=[im], background=background)
 
-    @skip_unless_feature("webp_anim")
     def test_background_from_gif(self, tmp_path: Path) -> None:
         # Save L mode GIF with background
         with Image.open("Tests/images/no_palette_with_background.gif") as im:
@@ -233,7 +222,6 @@ def test_background_from_gif(self, tmp_path: Path) -> None:
         difference = sum(abs(original_value[i] - reread_value[i]) for i in range(0, 3))
         assert difference < 5
 
-    @skip_unless_feature("webp_anim")
     def test_duration(self, tmp_path: Path) -> None:
         with Image.open("Tests/images/dispose_bgnd.gif") as im:
             assert im.info["duration"] == 1000
diff --git a/Tests/test_file_webp_alpha.py b/Tests/test_file_webp_alpha.py
index e80ef7d4f5b..53cdfff0327 100644
--- a/Tests/test_file_webp_alpha.py
+++ b/Tests/test_file_webp_alpha.py
@@ -85,12 +85,7 @@ def test_write_rgba(tmp_path: Path) -> None:
         image.load()
         image.getdata()
 
-        # Early versions of WebP are known to produce higher deviations:
-        # deal with it
-        if _webp.WebPDecoderVersion() <= 0x201:
-            assert_image_similar(image, pil_image, 3.0)
-        else:
-            assert_image_similar(image, pil_image, 1.0)
+        assert_image_similar(image, pil_image, 1.0)
 
 
 def test_keep_rgb_values_when_transparent(tmp_path: Path) -> None:
diff --git a/Tests/test_file_webp_animated.py b/Tests/test_file_webp_animated.py
index e0d7999e323..967a0aae847 100644
--- a/Tests/test_file_webp_animated.py
+++ b/Tests/test_file_webp_animated.py
@@ -15,10 +15,7 @@
     skip_unless_feature,
 )
 
-pytestmark = [
-    skip_unless_feature("webp"),
-    skip_unless_feature("webp_anim"),
-]
+pytestmark = skip_unless_feature("webp")
 
 
 def test_n_frames() -> None:
diff --git a/Tests/test_file_webp_lossless.py b/Tests/test_file_webp_lossless.py
index 32e29de56ad..dc98ad3f013 100644
--- a/Tests/test_file_webp_lossless.py
+++ b/Tests/test_file_webp_lossless.py
@@ -13,9 +13,6 @@
 
 
 def test_write_lossless_rgb(tmp_path: Path) -> None:
-    if _webp.WebPDecoderVersion() < 0x0200:
-        pytest.skip("lossless not included")
-
     temp_file = str(tmp_path / "temp.webp")
 
     hopper(RGB_MODE).save(temp_file, lossless=True)
diff --git a/Tests/test_file_webp_metadata.py b/Tests/test_file_webp_metadata.py
index 52a84a83e9b..4ef3d95f259 100644
--- a/Tests/test_file_webp_metadata.py
+++ b/Tests/test_file_webp_metadata.py
@@ -10,7 +10,7 @@
 
 from .helper import mark_if_feature_version, skip_unless_feature
 
-pytestmark = [skip_unless_feature("webp")]
+pytestmark = skip_unless_feature("webp")
 
 ElementTree: ModuleType | None
 try:
@@ -133,7 +133,6 @@ def test_getxmp() -> None:
             )
 
 
-@skip_unless_feature("webp_anim")
 def test_write_animated_metadata(tmp_path: Path) -> None:
     iccp_data = b"<iccp_data>"
     exif_data = b"<exif_data>"
diff --git a/Tests/test_image.py b/Tests/test_image.py
index d8372789be9..719732d127b 100644
--- a/Tests/test_image.py
+++ b/Tests/test_image.py
@@ -817,7 +817,6 @@ def test_exif_jpeg(self, tmp_path: Path) -> None:
             assert reloaded_exif[305] == "Pillow test"
 
     @skip_unless_feature("webp")
-    @skip_unless_feature("webp_anim")
     def test_exif_webp(self, tmp_path: Path) -> None:
         with Image.open("Tests/images/hopper.webp") as im:
             exif = im.getexif()
diff --git a/Tests/test_imagefile.py b/Tests/test_imagefile.py
index 44a6e6a42f1..fe7d44785ce 100644
--- a/Tests/test_imagefile.py
+++ b/Tests/test_imagefile.py
@@ -94,7 +94,6 @@ def test_ico(self) -> None:
             assert (48, 48) == p.image.size
 
     @skip_unless_feature("webp")
-    @skip_unless_feature("webp_anim")
     def test_incremental_webp(self) -> None:
         with ImageFile.Parser() as p:
             with open("Tests/images/hopper.webp", "rb") as f:
diff --git a/Tests/test_imageops.py b/Tests/test_imageops.py
index e33e6d4c842..2fb2a60b632 100644
--- a/Tests/test_imageops.py
+++ b/Tests/test_imageops.py
@@ -390,7 +390,7 @@ def test_colorize_3color_offset() -> None:
 
 def test_exif_transpose() -> None:
     exts = [".jpg"]
-    if features.check("webp") and features.check("webp_anim"):
+    if features.check("webp"):
         exts.append(".webp")
     for ext in exts:
         with Image.open("Tests/images/hopper" + ext) as base_im:
diff --git a/docs/handbook/image-file-formats.rst b/docs/handbook/image-file-formats.rst
index 8561cc4aa29..49a17bb5c4f 100644
--- a/docs/handbook/image-file-formats.rst
+++ b/docs/handbook/image-file-formats.rst
@@ -1220,8 +1220,7 @@ using the general tags available through tiffinfo.
 WebP
 ^^^^
 
-Pillow reads and writes WebP files. The specifics of Pillow's capabilities with
-this format are currently undocumented.
+Pillow reads and writes WebP files. Requires libwebp v0.5.0 or later.
 
 .. _webp-saving:
 
@@ -1263,12 +1262,6 @@ The :py:meth:`~PIL.Image.Image.save` method supports the following options:
 Saving sequences
 ~~~~~~~~~~~~~~~~
 
-.. note::
-
-    Support for animated WebP files will only be enabled if the system WebP
-    library is v0.5.0 or later. You can check webp animation support at
-    runtime by calling ``features.check("webp_anim")``.
-
 When calling :py:meth:`~PIL.Image.Image.save` to write a WebP file, by default
 only the first frame of a multiframe image will be saved. If the ``save_all``
 argument is present and true, then all frames will be saved, and the following
diff --git a/docs/reference/features.rst b/docs/reference/features.rst
index d4fb340bdc6..26c8ab8cd69 100644
--- a/docs/reference/features.rst
+++ b/docs/reference/features.rst
@@ -54,7 +54,6 @@ Feature version numbers are available only where stated.
 Support for the following features can be checked:
 
 * ``libjpeg_turbo``: (compile time) Whether Pillow was compiled against the libjpeg-turbo version of libjpeg. Compile-time version number is available.
-* ``webp_anim``: (compile time) Support for animated WebP images.
 * ``raqm``: Raqm library, required for ``ImageFont.Layout.RAQM`` in :py:func:`PIL.ImageFont.truetype`. Run-time version number is available for Raqm 0.7.0 or newer.
 * ``libimagequant``: (compile time) ImageQuant quantization support in :py:func:`PIL.Image.Image.quantize`. Run-time version number is available.
 * ``xcb``: (compile time) Support for X11 in :py:func:`PIL.ImageGrab.grab` via the XCB library.
diff --git a/setup.py b/setup.py
index 8d0dfb6fa21..edfa9ee28fc 100644
--- a/setup.py
+++ b/setup.py
@@ -795,7 +795,12 @@ def build_extensions(self):
             _dbg("Looking for webp")
             if all(
                 _find_include_file(self, src)
-                for src in ["webp/encode.h", "webp/mux.h", "webp/demux.h"]
+                for src in [
+                    "webp/encode.h",
+                    "webp/decode.h",
+                    "webp/mux.h",
+                    "webp/demux.h",
+                ]
             ):
                 # In Google's precompiled zip it is call "libwebp":
                 if all(
diff --git a/src/PIL/WebPImagePlugin.py b/src/PIL/WebPImagePlugin.py
index cec7963405b..fc8f4fc2edc 100644
--- a/src/PIL/WebPImagePlugin.py
+++ b/src/PIL/WebPImagePlugin.py
@@ -45,22 +45,6 @@ class WebPImageFile(ImageFile.ImageFile):
     __logical_frame = 0
 
     def _open(self) -> None:
-        if not _webp.HAVE_WEBPANIM:
-            # Legacy mode
-            data, width, height, self._mode, icc_profile, exif = _webp.WebPDecode(
-                self.fp.read()
-            )
-            if icc_profile:
-                self.info["icc_profile"] = icc_profile
-            if exif:
-                self.info["exif"] = exif
-            self._size = width, height
-            self.fp = BytesIO(data)
-            self.tile = [("raw", (0, 0) + self.size, 0, self.mode)]
-            self.n_frames = 1
-            self.is_animated = False
-            return
-
         # Use the newer AnimDecoder API to parse the (possibly) animated file,
         # and access muxed chunks like ICC/EXIF/XMP.
         self._decoder = _webp.WebPAnimDecoder(self.fp.read())
@@ -145,21 +129,20 @@ def _seek(self, frame: int) -> None:
             self._get_next()  # Advance to the requested frame
 
     def load(self) -> Image.core.PixelAccess | None:
-        if _webp.HAVE_WEBPANIM:
-            if self.__loaded != self.__logical_frame:
-                self._seek(self.__logical_frame)
-
-                # We need to load the image data for this frame
-                data, timestamp, duration = self._get_next()
-                self.info["timestamp"] = timestamp
-                self.info["duration"] = duration
-                self.__loaded = self.__logical_frame
-
-                # Set tile
-                if self.fp and self._exclusive_fp:
-                    self.fp.close()
-                self.fp = BytesIO(data)
-                self.tile = [("raw", (0, 0) + self.size, 0, self.rawmode)]
+        if self.__loaded != self.__logical_frame:
+            self._seek(self.__logical_frame)
+
+            # We need to load the image data for this frame
+            data, timestamp, duration = self._get_next()
+            self.info["timestamp"] = timestamp
+            self.info["duration"] = duration
+            self.__loaded = self.__logical_frame
+
+            # Set tile
+            if self.fp and self._exclusive_fp:
+                self.fp.close()
+            self.fp = BytesIO(data)
+            self.tile = [("raw", (0, 0) + self.size, 0, self.rawmode)]
 
         return super().load()
 
@@ -167,9 +150,6 @@ def load_seek(self, pos: int) -> None:
         pass
 
     def tell(self) -> int:
-        if not _webp.HAVE_WEBPANIM:
-            return super().tell()
-
         return self.__logical_frame
 
 
@@ -357,7 +337,6 @@ def _save(im: Image.Image, fp: IO[bytes], filename: str | bytes) -> None:
 Image.register_open(WebPImageFile.format, WebPImageFile, _accept)
 if SUPPORTED:
     Image.register_save(WebPImageFile.format, _save)
-    if _webp.HAVE_WEBPANIM:
-        Image.register_save_all(WebPImageFile.format, _save_all)
+    Image.register_save_all(WebPImageFile.format, _save_all)
     Image.register_extension(WebPImageFile.format, ".webp")
     Image.register_mime(WebPImageFile.format, "image/webp")
diff --git a/src/PIL/features.py b/src/PIL/features.py
index 60590dc098d..bbf7c641b43 100644
--- a/src/PIL/features.py
+++ b/src/PIL/features.py
@@ -119,7 +119,6 @@ def get_supported_codecs() -> list[str]:
 
 
 features = {
-    "webp_anim": ("PIL._webp", "HAVE_WEBPANIM", None),
     "raqm": ("PIL._imagingft", "HAVE_RAQM", "raqm_version"),
     "fribidi": ("PIL._imagingft", "HAVE_FRIBIDI", "fribidi_version"),
     "harfbuzz": ("PIL._imagingft", "HAVE_HARFBUZZ", "harfbuzz_version"),
@@ -269,7 +268,6 @@ def pilinfo(out: IO[str] | None = None, supported_formats: bool = True) -> None:
         ("freetype2", "FREETYPE2"),
         ("littlecms2", "LITTLECMS2"),
         ("webp", "WEBP"),
-        ("webp_anim", "WEBP Animation"),
         ("jpg", "JPEG"),
         ("jpg_2000", "OPENJPEG (JPEG2000)"),
         ("zlib", "ZLIB (PNG/ZIP)"),
diff --git a/src/_webp.c b/src/_webp.c
index a10eb111c3b..8302925b0fc 100644
--- a/src/_webp.c
+++ b/src/_webp.c
@@ -13,8 +13,8 @@
  * very early versions had some significant differences, so we require later
  * versions, before enabling animation support.
  */
-#if WEBP_MUX_ABI_VERSION >= 0x0104 && WEBP_DEMUX_ABI_VERSION >= 0x0105
-#define HAVE_WEBPANIM
+#if WEBP_MUX_ABI_VERSION < 0x0106 || WEBP_DEMUX_ABI_VERSION < 0x0107
+#error libwebp 0.5.0 and above is required. Upgrade libwebp or build with --disable-webp flag
 #endif
 
 void
@@ -87,8 +87,6 @@ HandleMuxError(WebPMuxError err, char *chunk) {
 /* WebP Animation Support                                               */
 /* -------------------------------------------------------------------- */
 
-#ifdef HAVE_WEBPANIM
-
 // Encoder type
 typedef struct {
     PyObject_HEAD WebPAnimEncoder *enc;
@@ -568,8 +566,6 @@ static PyTypeObject WebPAnimDecoder_Type = {
     0,                                 /*tp_getset*/
 };
 
-#endif
-
 /* -------------------------------------------------------------------- */
 /* Legacy WebP Support                                                  */
 /* -------------------------------------------------------------------- */
@@ -644,10 +640,7 @@ WebPEncode_wrapper(PyObject *self, PyObject *args) {
     config.quality = quality_factor;
     config.alpha_quality = alpha_quality_factor;
     config.method = method;
-#if WEBP_ENCODER_ABI_VERSION >= 0x0209
-    // the "exact" flag is only available in libwebp 0.5.0 and later
     config.exact = exact;
-#endif
 
     // Validate the config
     if (!WebPValidateConfig(&config)) {
@@ -763,124 +756,6 @@ WebPEncode_wrapper(PyObject *self, PyObject *args) {
     Py_RETURN_NONE;
 }
 
-PyObject *
-WebPDecode_wrapper(PyObject *self, PyObject *args) {
-    PyBytesObject *webp_string;
-    const uint8_t *webp;
-    Py_ssize_t size;
-    PyObject *ret = Py_None, *bytes = NULL, *pymode = NULL, *icc_profile = NULL,
-             *exif = NULL;
-    WebPDecoderConfig config;
-    VP8StatusCode vp8_status_code = VP8_STATUS_OK;
-    char *mode = "RGB";
-
-    if (!PyArg_ParseTuple(args, "S", &webp_string)) {
-        return NULL;
-    }
-
-    if (!WebPInitDecoderConfig(&config)) {
-        Py_RETURN_NONE;
-    }
-
-    PyBytes_AsStringAndSize((PyObject *)webp_string, (char **)&webp, &size);
-
-    vp8_status_code = WebPGetFeatures(webp, size, &config.input);
-    if (vp8_status_code == VP8_STATUS_OK) {
-        // If we don't set it, we don't get alpha.
-        // Initialized to MODE_RGB
-        if (config.input.has_alpha) {
-            config.output.colorspace = MODE_RGBA;
-            mode = "RGBA";
-        }
-
-        {
-            int copy_data = 0;
-            WebPData data = {webp, size};
-            WebPMuxFrameInfo image;
-            WebPData icc_profile_data = {0};
-            WebPData exif_data = {0};
-
-            WebPMux *mux = WebPMuxCreate(&data, copy_data);
-            if (NULL == mux) {
-                goto end;
-            }
-
-            if (WEBP_MUX_OK != WebPMuxGetFrame(mux, 1, &image)) {
-                WebPMuxDelete(mux);
-                goto end;
-            }
-
-            webp = image.bitstream.bytes;
-            size = image.bitstream.size;
-
-            vp8_status_code = WebPDecode(webp, size, &config);
-
-            if (WEBP_MUX_OK == WebPMuxGetChunk(mux, "ICCP", &icc_profile_data)) {
-                icc_profile = PyBytes_FromStringAndSize(
-                    (const char *)icc_profile_data.bytes, icc_profile_data.size
-                );
-            }
-
-            if (WEBP_MUX_OK == WebPMuxGetChunk(mux, "EXIF", &exif_data)) {
-                exif = PyBytes_FromStringAndSize(
-                    (const char *)exif_data.bytes, exif_data.size
-                );
-            }
-
-            WebPDataClear(&image.bitstream);
-            WebPMuxDelete(mux);
-        }
-    }
-
-    if (vp8_status_code != VP8_STATUS_OK) {
-        goto end;
-    }
-
-    if (config.output.colorspace < MODE_YUV) {
-        bytes = PyBytes_FromStringAndSize(
-            (char *)config.output.u.RGBA.rgba, config.output.u.RGBA.size
-        );
-    } else {
-        // Skipping YUV for now. Need Test Images.
-        // UNDONE -- unclear if we'll ever get here if we set mode_rgb*
-        bytes = PyBytes_FromStringAndSize(
-            (char *)config.output.u.YUVA.y, config.output.u.YUVA.y_size
-        );
-    }
-
-    pymode = PyUnicode_FromString(mode);
-    ret = Py_BuildValue(
-        "SiiSSS",
-        bytes,
-        config.output.width,
-        config.output.height,
-        pymode,
-        NULL == icc_profile ? Py_None : icc_profile,
-        NULL == exif ? Py_None : exif
-    );
-
-end:
-    WebPFreeDecBuffer(&config.output);
-
-    Py_XDECREF(bytes);
-    Py_XDECREF(pymode);
-    Py_XDECREF(icc_profile);
-    Py_XDECREF(exif);
-
-    if (Py_None == ret) {
-        Py_RETURN_NONE;
-    }
-
-    return ret;
-}
-
-// Return the decoder's version number, packed in hexadecimal using 8bits for
-// each of major/minor/revision. E.g: v2.5.7 is 0x020507.
-PyObject *
-WebPDecoderVersion_wrapper() {
-    return Py_BuildValue("i", WebPGetDecoderVersion());
-}
-
 // Version as string
 const char *
 WebPDecoderVersion_str(void) {
@@ -901,39 +776,20 @@ WebPDecoderVersion_str(void) {
 /* -------------------------------------------------------------------- */
 
 static PyMethodDef webpMethods[] = {
-#ifdef HAVE_WEBPANIM
     {"WebPAnimDecoder", _anim_decoder_new, METH_VARARGS, "WebPAnimDecoder"},
     {"WebPAnimEncoder", _anim_encoder_new, METH_VARARGS, "WebPAnimEncoder"},
-#endif
     {"WebPEncode", WebPEncode_wrapper, METH_VARARGS, "WebPEncode"},
-    {"WebPDecode", WebPDecode_wrapper, METH_VARARGS, "WebPDecode"},
-    {"WebPDecoderVersion", WebPDecoderVersion_wrapper, METH_NOARGS, "WebPVersion"},
     {NULL, NULL}
 };
 
-void
-addAnimFlagToModule(PyObject *m) {
-    PyObject *have_webpanim;
-#ifdef HAVE_WEBPANIM
-    have_webpanim = Py_True;
-#else
-    have_webpanim = Py_False;
-#endif
-    Py_INCREF(have_webpanim);
-    PyModule_AddObject(m, "HAVE_WEBPANIM", have_webpanim);
-}
-
 static int
 setup_module(PyObject *m) {
-#ifdef HAVE_WEBPANIM
+    PyObject *d = PyModule_GetDict(m);
     /* Ready object types */
     if (PyType_Ready(&WebPAnimDecoder_Type) < 0 ||
         PyType_Ready(&WebPAnimEncoder_Type) < 0) {
         return -1;
     }
-#endif
-    PyObject *d = PyModule_GetDict(m);
-    addAnimFlagToModule(m);
 
     PyObject *v = PyUnicode_FromString(WebPDecoderVersion_str());
     PyDict_SetItemString(d, "webpdecoder_version", v ? v : Py_None);

From 56ca359c657ee2f4e81426f780c4b4e2e281e404 Mon Sep 17 00:00:00 2001
From: Aleksandr Karpinskii <homm86@gmail.com>
Date: Mon, 8 Jul 2024 20:07:43 +0400
Subject: [PATCH 0908/1178] Bring back removed features, add deprecations and
 Release notes

---
 Tests/check_wheel.py         |  3 +++
 Tests/test_features.py       | 12 ++++++++++++
 docs/reference/features.rst  |  3 +++
 docs/releasenotes/11.0.0.rst |  8 ++++++++
 src/PIL/features.py          | 10 +++++++++-
 5 files changed, 35 insertions(+), 1 deletion(-)

diff --git a/Tests/check_wheel.py b/Tests/check_wheel.py
index 8fcb75dad5c..4b91984f58a 100644
--- a/Tests/check_wheel.py
+++ b/Tests/check_wheel.py
@@ -27,6 +27,9 @@ def test_wheel_codecs() -> None:
 
 def test_wheel_features() -> None:
     expected_features = {
+        "webp_anim",
+        "webp_mux",
+        "transp_webp",
         "raqm",
         "fribidi",
         "harfbuzz",
diff --git a/Tests/test_features.py b/Tests/test_features.py
index 40466082f7a..cb8fd8688c9 100644
--- a/Tests/test_features.py
+++ b/Tests/test_features.py
@@ -46,6 +46,18 @@ def test(name: str, function: Callable[[str], str | None]) -> None:
         test(feature, features.version_feature)
 
 
+def test_webp_transparency() -> None:
+    assert features.check("transp_webp") == features.check_module("webp")
+
+
+def test_webp_mux() -> None:
+    assert features.check("webp_mux") == features.check_module("webp")
+
+
+def test_webp_anim() -> None:
+    assert features.check("webp_anim") == features.check_module("webp")
+
+
 @skip_unless_feature("libjpeg_turbo")
 def test_libjpeg_turbo_version() -> None:
     version = features.version("libjpeg_turbo")
diff --git a/docs/reference/features.rst b/docs/reference/features.rst
index 26c8ab8cd69..fcff9673567 100644
--- a/docs/reference/features.rst
+++ b/docs/reference/features.rst
@@ -57,6 +57,9 @@ Support for the following features can be checked:
 * ``raqm``: Raqm library, required for ``ImageFont.Layout.RAQM`` in :py:func:`PIL.ImageFont.truetype`. Run-time version number is available for Raqm 0.7.0 or newer.
 * ``libimagequant``: (compile time) ImageQuant quantization support in :py:func:`PIL.Image.Image.quantize`. Run-time version number is available.
 * ``xcb``: (compile time) Support for X11 in :py:func:`PIL.ImageGrab.grab` via the XCB library.
+* ``transp_webp``: Deprecated. Always ``True`` if WebP module is installed.
+* ``webp_mux``: Deprecated. Always ``True`` if WebP module is installed.
+* ``webp_anim``: Deprecated. Always ``True`` if WebP module is installed.
 
 .. autofunction:: PIL.features.check_feature
 .. autofunction:: PIL.features.version_feature
diff --git a/docs/releasenotes/11.0.0.rst b/docs/releasenotes/11.0.0.rst
index 1d1afcde53a..bb707a04480 100644
--- a/docs/releasenotes/11.0.0.rst
+++ b/docs/releasenotes/11.0.0.rst
@@ -58,6 +58,14 @@ JpegImageFile.huffman_ac and JpegImageFile.huffman_dc
 The ``huffman_ac`` and ``huffman_dc`` dictionaries on JPEG images were unused. They
 have been deprecated, and will be removed in Pillow 12 (2025-10-15).
 
+Specific WebP Feature Checks
+^^^^^^^^^^^^^^^^^^^^^^^^^^^^
+
+The following features ``features.check("transp_webp")``,
+``features.check("webp_mux")``, and ``features.check("webp_anim")`` are now
+always ``True`` if the WebP module is installed and should not be used.
+These checks will be removed in Pillow 12.0.0 (2025-10-15).
+
 API Changes
 ===========
 
diff --git a/src/PIL/features.py b/src/PIL/features.py
index bbf7c641b43..f594a2cdc4a 100644
--- a/src/PIL/features.py
+++ b/src/PIL/features.py
@@ -7,6 +7,7 @@
 from typing import IO
 
 import PIL
+from PIL import _deprecate
 
 from . import Image
 
@@ -119,6 +120,9 @@ def get_supported_codecs() -> list[str]:
 
 
 features = {
+    "webp_anim": ("PIL._webp", True, None),
+    "webp_mux": ("PIL._webp", True, None),
+    "transp_webp": ("PIL._webp", True, None),
     "raqm": ("PIL._imagingft", "HAVE_RAQM", "raqm_version"),
     "fribidi": ("PIL._imagingft", "HAVE_FRIBIDI", "fribidi_version"),
     "harfbuzz": ("PIL._imagingft", "HAVE_HARFBUZZ", "harfbuzz_version"),
@@ -144,7 +148,11 @@ def check_feature(feature: str) -> bool | None:
 
     try:
         imported_module = __import__(module, fromlist=["PIL"])
-        return getattr(imported_module, flag)
+        if isinstance(flag, str):
+            return getattr(imported_module, flag)
+        else:
+            _deprecate.deprecate(f'check_feature("{feature}")', 12)
+            return flag
     except ModuleNotFoundError:
         return None
     except ImportError as ex:

From 6180abc75c3dfa950276b2586cd1a8aab1bede70 Mon Sep 17 00:00:00 2001
From: Aleksandr Karpinskii <homm86@gmail.com>
Date: Mon, 8 Jul 2024 20:32:35 +0400
Subject: [PATCH 0909/1178] Remove WebP versions notes from docs

---
 docs/handbook/image-file-formats.rst       | 1 -
 docs/installation/building-from-source.rst | 4 ----
 2 files changed, 5 deletions(-)

diff --git a/docs/handbook/image-file-formats.rst b/docs/handbook/image-file-formats.rst
index 49a17bb5c4f..861e09a43aa 100644
--- a/docs/handbook/image-file-formats.rst
+++ b/docs/handbook/image-file-formats.rst
@@ -1248,7 +1248,6 @@ The :py:meth:`~PIL.Image.Image.save` method supports the following options:
 **exact**
     If true, preserve the transparent RGB values. Otherwise, discard
     invisible RGB values for better compression. Defaults to false.
-    Requires libwebp 0.5.0 or later.
 
 **icc_profile**
     The ICC Profile to include in the saved file.
diff --git a/docs/installation/building-from-source.rst b/docs/installation/building-from-source.rst
index f47edbc5bcc..71787311f35 100644
--- a/docs/installation/building-from-source.rst
+++ b/docs/installation/building-from-source.rst
@@ -55,10 +55,6 @@ Many of Pillow's features require external libraries:
 
 * **libwebp** provides the WebP format.
 
-  * Pillow has been tested with version **0.1.3**, which does not read
-    transparent WebP files. Versions **0.3.0** and above support
-    transparency.
-
 * **openjpeg** provides JPEG 2000 functionality.
 
   * Pillow has been tested with openjpeg **2.0.0**, **2.1.0**, **2.3.1**,

From 924df9e60b39c6ced91553895497fa43db2d232d Mon Sep 17 00:00:00 2001
From: Andrew Murray <radarhere@users.noreply.github.com>
Date: Tue, 13 Aug 2024 06:46:46 +1000
Subject: [PATCH 0910/1178] Moved line after early return

Improve compiler advice

Update src/PIL/features.py
---
 src/PIL/features.py | 5 ++---
 src/_webp.c         | 4 ++--
 2 files changed, 4 insertions(+), 5 deletions(-)

diff --git a/src/PIL/features.py b/src/PIL/features.py
index f594a2cdc4a..a5487042ead 100644
--- a/src/PIL/features.py
+++ b/src/PIL/features.py
@@ -148,11 +148,10 @@ def check_feature(feature: str) -> bool | None:
 
     try:
         imported_module = __import__(module, fromlist=["PIL"])
-        if isinstance(flag, str):
-            return getattr(imported_module, flag)
-        else:
+        if isinstance(flag, bool):
             _deprecate.deprecate(f'check_feature("{feature}")', 12)
             return flag
+        return getattr(imported_module, flag)
     except ModuleNotFoundError:
         return None
     except ImportError as ex:
diff --git a/src/_webp.c b/src/_webp.c
index 8302925b0fc..306a290bdb9 100644
--- a/src/_webp.c
+++ b/src/_webp.c
@@ -14,7 +14,7 @@
  * versions, before enabling animation support.
  */
 #if WEBP_MUX_ABI_VERSION < 0x0106 || WEBP_DEMUX_ABI_VERSION < 0x0107
-#error libwebp 0.5.0 and above is required. Upgrade libwebp or build with --disable-webp flag
+#error libwebp 0.5.0 and above is required. Upgrade libwebp or build Pillow with --disable-webp flag
 #endif
 
 void
@@ -784,13 +784,13 @@ static PyMethodDef webpMethods[] = {
 
 static int
 setup_module(PyObject *m) {
-    PyObject *d = PyModule_GetDict(m);
     /* Ready object types */
     if (PyType_Ready(&WebPAnimDecoder_Type) < 0 ||
         PyType_Ready(&WebPAnimEncoder_Type) < 0) {
         return -1;
     }
 
+    PyObject *d = PyModule_GetDict(m);
     PyObject *v = PyUnicode_FromString(WebPDecoderVersion_str());
     PyDict_SetItemString(d, "webpdecoder_version", v ? v : Py_None);
     Py_XDECREF(v);

From 93ce9ce0048639706eecd523fc54c7d6cfc15bef Mon Sep 17 00:00:00 2001
From: Alexander Karpinsky <homm86@gmail.com>
Date: Tue, 13 Aug 2024 09:52:07 +0400
Subject: [PATCH 0911/1178] Update features type

Co-authored-by: Andrew Murray <3112309+radarhere@users.noreply.github.com>
---
 src/PIL/features.py | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/src/PIL/features.py b/src/PIL/features.py
index a5487042ead..9421dbd3cf4 100644
--- a/src/PIL/features.py
+++ b/src/PIL/features.py
@@ -119,7 +119,7 @@ def get_supported_codecs() -> list[str]:
     return [f for f in codecs if check_codec(f)]
 
 
-features = {
+features: dict[str, tuple[str, str | bool, str | None]] = {
     "webp_anim": ("PIL._webp", True, None),
     "webp_mux": ("PIL._webp", True, None),
     "transp_webp": ("PIL._webp", True, None),

From 55469948282fe2dd763dcb8e66a767b5c63adb54 Mon Sep 17 00:00:00 2001
From: Andrew Murray <radarhere@users.noreply.github.com>
Date: Tue, 13 Aug 2024 19:03:14 +1000
Subject: [PATCH 0912/1178] Removed unnecessary variable

---
 Tests/test_file_webp_alpha.py    | 2 +-
 Tests/test_file_webp_lossless.py | 2 +-
 2 files changed, 2 insertions(+), 2 deletions(-)

diff --git a/Tests/test_file_webp_alpha.py b/Tests/test_file_webp_alpha.py
index 53cdfff0327..c88fe3589ea 100644
--- a/Tests/test_file_webp_alpha.py
+++ b/Tests/test_file_webp_alpha.py
@@ -13,7 +13,7 @@
     hopper,
 )
 
-_webp = pytest.importorskip("PIL._webp", reason="WebP support not installed")
+pytest.importorskip("PIL._webp", reason="WebP support not installed")
 
 
 def test_read_rgba() -> None:
diff --git a/Tests/test_file_webp_lossless.py b/Tests/test_file_webp_lossless.py
index dc98ad3f013..80429715e9e 100644
--- a/Tests/test_file_webp_lossless.py
+++ b/Tests/test_file_webp_lossless.py
@@ -8,7 +8,7 @@
 
 from .helper import assert_image_equal, hopper
 
-_webp = pytest.importorskip("PIL._webp", reason="WebP support not installed")
+pytest.importorskip("PIL._webp", reason="WebP support not installed")
 RGB_MODE = "RGB"
 
 

From f3aec6dd383bb27676e7e02a7749a5bff1cc30c2 Mon Sep 17 00:00:00 2001
From: Andrew Murray <radarhere@users.noreply.github.com>
Date: Tue, 13 Aug 2024 19:05:32 +1000
Subject: [PATCH 0913/1178] Simplified code

---
 setup.py | 36 ++++++++++++------------------------
 1 file changed, 12 insertions(+), 24 deletions(-)

diff --git a/setup.py b/setup.py
index edfa9ee28fc..863d102cf85 100644
--- a/setup.py
+++ b/setup.py
@@ -794,25 +794,17 @@ def build_extensions(self):
         if feature.want("webp"):
             _dbg("Looking for webp")
             if all(
-                _find_include_file(self, src)
-                for src in [
-                    "webp/encode.h",
-                    "webp/decode.h",
-                    "webp/mux.h",
-                    "webp/demux.h",
-                ]
+                _find_include_file(self, "webp/" + include)
+                for include in ("encode.h", "decode.h", "mux.h", "demux.h")
             ):
-                # In Google's precompiled zip it is call "libwebp":
-                if all(
-                    _find_library_file(self, lib)
-                    for lib in ["webp", "webpmux", "webpdemux"]
-                ):
-                    feature.webp = "webp"
-                elif all(
-                    _find_library_file(self, lib)
-                    for lib in ["libwebp", "libwebpmux", "libwebpdemux"]
-                ):
-                    feature.webp = "libwebp"
+                # In Google's precompiled zip it is called "libwebp"
+                for prefix in ("", "lib"):
+                    if all(
+                        _find_library_file(self, prefix + library)
+                        for library in ("webp", "webpmux", "webpdemux")
+                    ):
+                        feature.webp = prefix + "webp"
+                        break
 
         if feature.want("xcb"):
             _dbg("Looking for xcb")
@@ -901,12 +893,8 @@ def build_extensions(self):
             self._remove_extension("PIL._imagingcms")
 
         if feature.webp:
-            libs = [
-                feature.webp,
-                feature.webp + "mux",
-                feature.webp + "demux",
-            ]
-            self._update_extension("PIL._webp", libs, [])
+            libs = [feature.webp, feature.webp + "mux", feature.webp + "demux"]
+            self._update_extension("PIL._webp", libs)
         else:
             self._remove_extension("PIL._webp")
 

From c7e6289b36d4eb1823b6bfcace27674826a58e43 Mon Sep 17 00:00:00 2001
From: Andrew Murray <radarhere@users.noreply.github.com>
Date: Tue, 13 Aug 2024 19:07:01 +1000
Subject: [PATCH 0914/1178] Use relative import

---
 src/PIL/features.py | 4 ++--
 1 file changed, 2 insertions(+), 2 deletions(-)

diff --git a/src/PIL/features.py b/src/PIL/features.py
index 9421dbd3cf4..e505adae060 100644
--- a/src/PIL/features.py
+++ b/src/PIL/features.py
@@ -7,9 +7,9 @@
 from typing import IO
 
 import PIL
-from PIL import _deprecate
 
 from . import Image
+from ._deprecate import deprecate
 
 modules = {
     "pil": ("PIL._imaging", "PILLOW_VERSION"),
@@ -149,7 +149,7 @@ def check_feature(feature: str) -> bool | None:
     try:
         imported_module = __import__(module, fromlist=["PIL"])
         if isinstance(flag, bool):
-            _deprecate.deprecate(f'check_feature("{feature}")', 12)
+            deprecate(f'check_feature("{feature}")', 12)
             return flag
         return getattr(imported_module, flag)
     except ModuleNotFoundError:

From ba82dff7bc6c489f299a63d2f2d3722dfe11852e Mon Sep 17 00:00:00 2001
From: Andrew Murray <radarhere@users.noreply.github.com>
Date: Tue, 13 Aug 2024 19:10:54 +1000
Subject: [PATCH 0915/1178] Updated test name

---
 Tests/test_file_webp.py | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/Tests/test_file_webp.py b/Tests/test_file_webp.py
index 6e9eea4aec0..6ccd489bb47 100644
--- a/Tests/test_file_webp.py
+++ b/Tests/test_file_webp.py
@@ -166,7 +166,7 @@ def test_WebPEncode_with_invalid_args(self) -> None:
         with pytest.raises(TypeError):
             _webp.WebPEncode()
 
-    def test_WebPDecode_with_invalid_args(self) -> None:
+    def test_WebPAnimDecoder_with_invalid_args(self) -> None:
         """
         Calling decoder functions with no arguments should result in an error.
         """

From 66319fcce764f4f09e53900b2896ec15457f691f Mon Sep 17 00:00:00 2001
From: Andrew Murray <radarhere@users.noreply.github.com>
Date: Tue, 13 Aug 2024 19:17:36 +1000
Subject: [PATCH 0916/1178] Animation support is no longer conditionally
 enabled

---
 src/_webp.c | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/src/_webp.c b/src/_webp.c
index 306a290bdb9..d1943b3e0a5 100644
--- a/src/_webp.c
+++ b/src/_webp.c
@@ -11,7 +11,7 @@
  * Check the versions from mux.h and demux.h, to ensure the WebPAnimEncoder and
  * WebPAnimDecoder APIs are present (initial support was added in 0.5.0). The
  * very early versions had some significant differences, so we require later
- * versions, before enabling animation support.
+ * versions.
  */
 #if WEBP_MUX_ABI_VERSION < 0x0106 || WEBP_DEMUX_ABI_VERSION < 0x0107
 #error libwebp 0.5.0 and above is required. Upgrade libwebp or build Pillow with --disable-webp flag

From 45552b5b4f6ea470639e5c7ff0d9efb96ad7db68 Mon Sep 17 00:00:00 2001
From: Andrew Murray <radarhere@users.noreply.github.com>
Date: Tue, 13 Aug 2024 19:24:34 +1000
Subject: [PATCH 0917/1178] Updated documentation

---
 docs/deprecations.rst        | 10 ++++++++++
 docs/releasenotes/11.0.0.rst |  8 ++++----
 2 files changed, 14 insertions(+), 4 deletions(-)

diff --git a/docs/deprecations.rst b/docs/deprecations.rst
index 058468cfe36..a9498d5ed5e 100644
--- a/docs/deprecations.rst
+++ b/docs/deprecations.rst
@@ -126,6 +126,16 @@ JpegImageFile.huffman_ac and JpegImageFile.huffman_dc
 The ``huffman_ac`` and ``huffman_dc`` dictionaries on JPEG images were unused. They
 have been deprecated, and will be removed in Pillow 12 (2025-10-15).
 
+Specific WebP Feature Checks
+^^^^^^^^^^^^^^^^^^^^^^^^^^^^
+
+.. deprecated:: 11.0.0
+
+``features.check("transp_webp")``, ``features.check("webp_mux")`` and
+``features.check("webp_anim")`` are now deprecated. They will always return
+``True`` if the WebP module is installed, until they are removed in Pillow
+12.0.0 (2025-10-15).
+
 Removed features
 ----------------
 
diff --git a/docs/releasenotes/11.0.0.rst b/docs/releasenotes/11.0.0.rst
index bb707a04480..ac9237acf78 100644
--- a/docs/releasenotes/11.0.0.rst
+++ b/docs/releasenotes/11.0.0.rst
@@ -61,10 +61,10 @@ have been deprecated, and will be removed in Pillow 12 (2025-10-15).
 Specific WebP Feature Checks
 ^^^^^^^^^^^^^^^^^^^^^^^^^^^^
 
-The following features ``features.check("transp_webp")``,
-``features.check("webp_mux")``, and ``features.check("webp_anim")`` are now
-always ``True`` if the WebP module is installed and should not be used.
-These checks will be removed in Pillow 12.0.0 (2025-10-15).
+``features.check("transp_webp")``, ``features.check("webp_mux")`` and
+``features.check("webp_anim")`` are now deprecated. They will always return
+``True`` if the WebP module is installed, until they are removed in Pillow
+12.0.0 (2025-10-15).
 
 API Changes
 ===========

From 359d7592c7861729092434154d131310c7bf1d71 Mon Sep 17 00:00:00 2001
From: Andrew Murray <radarhere@users.noreply.github.com>
Date: Wed, 14 Aug 2024 18:41:39 +1000
Subject: [PATCH 0918/1178] Test deprecation warnings

---
 Tests/test_features.py | 21 ++++++++++++++++-----
 src/PIL/features.py    | 12 +++++++++++-
 2 files changed, 27 insertions(+), 6 deletions(-)

diff --git a/Tests/test_features.py b/Tests/test_features.py
index cb8fd8688c9..80778284773 100644
--- a/Tests/test_features.py
+++ b/Tests/test_features.py
@@ -18,7 +18,11 @@ def test_check() -> None:
     for codec in features.codecs:
         assert features.check_codec(codec) == features.check(codec)
     for feature in features.features:
-        assert features.check_feature(feature) == features.check(feature)
+        if "webp" in feature:
+            with pytest.warns(DeprecationWarning):
+                assert features.check_feature(feature) == features.check(feature)
+        else:
+            assert features.check_feature(feature) == features.check(feature)
 
 
 def test_version() -> None:
@@ -43,19 +47,26 @@ def test(name: str, function: Callable[[str], str | None]) -> None:
     for codec in features.codecs:
         test(codec, features.version_codec)
     for feature in features.features:
-        test(feature, features.version_feature)
+        if "webp" in feature:
+            with pytest.warns(DeprecationWarning):
+                test(feature, features.version_feature)
+        else:
+            test(feature, features.version_feature)
 
 
 def test_webp_transparency() -> None:
-    assert features.check("transp_webp") == features.check_module("webp")
+    with pytest.warns(DeprecationWarning):
+        assert features.check("transp_webp") == features.check_module("webp")
 
 
 def test_webp_mux() -> None:
-    assert features.check("webp_mux") == features.check_module("webp")
+    with pytest.warns(DeprecationWarning):
+        assert features.check("webp_mux") == features.check_module("webp")
 
 
 def test_webp_anim() -> None:
-    assert features.check("webp_anim") == features.check_module("webp")
+    with pytest.warns(DeprecationWarning):
+        assert features.check("webp_anim") == features.check_module("webp")
 
 
 @skip_unless_feature("libjpeg_turbo")
diff --git a/src/PIL/features.py b/src/PIL/features.py
index e505adae060..24c5ee978b3 100644
--- a/src/PIL/features.py
+++ b/src/PIL/features.py
@@ -180,7 +180,17 @@ def get_supported_features() -> list[str]:
     """
     :returns: A list of all supported features.
     """
-    return [f for f in features if check_feature(f)]
+    supported_features = []
+    for f, (module, flag, _) in features.items():
+        if flag is True:
+            for feature, (feature_module, _) in modules.items():
+                if feature_module == module:
+                    if check_module(feature):
+                        supported_features.append(f)
+                    break
+        elif check_feature(f):
+            supported_features.append(f)
+    return supported_features
 
 
 def check(feature: str) -> bool | None:

From 4cf5688cfd42caed6f25db2d5ea29271ea8c1c9f Mon Sep 17 00:00:00 2001
From: Aleksandr Karpinskii <homm86@gmail.com>
Date: Tue, 2 Jul 2024 16:43:34 +0400
Subject: [PATCH 0919/1178] Optimize getbbox() and getextrema()

---
 src/libImaging/GetBBox.c | 62 +++++++++++++++++++++++++++-------------
 1 file changed, 42 insertions(+), 20 deletions(-)

diff --git a/src/libImaging/GetBBox.c b/src/libImaging/GetBBox.c
index c61a27d3b7f..680d1cf77ba 100644
--- a/src/libImaging/GetBBox.c
+++ b/src/libImaging/GetBBox.c
@@ -30,26 +30,45 @@ ImagingGetBBox(Imaging im, int bbox[4], int alpha_only) {
     bbox[1] = -1;
     bbox[2] = bbox[3] = 0;
 
-#define GETBBOX(image, mask)              \
-    for (y = 0; y < im->ysize; y++) {     \
-        has_data = 0;                     \
-        for (x = 0; x < im->xsize; x++) { \
-            if (im->image[y][x] & mask) { \
-                has_data = 1;             \
-                if (x < bbox[0]) {        \
-                    bbox[0] = x;          \
-                }                         \
-                if (x >= bbox[2]) {       \
-                    bbox[2] = x + 1;      \
-                }                         \
-            }                             \
-        }                                 \
-        if (has_data) {                   \
-            if (bbox[1] < 0) {            \
-                bbox[1] = y;              \
-            }                             \
-            bbox[3] = y + 1;              \
-        }                                 \
+#define	GETBBOX(image, mask)                                 \
+    /* first stage: looking for any px from top */           \
+    for (y = 0; y < im->ysize; y++) {                        \
+        has_data = 0;                                        \
+        for (x = 0; x < im->xsize; x++)                      \
+            if (im->image[y][x] & mask) {                    \
+                has_data = 1;                                \
+                bbox[0] = x;                                 \
+                bbox[1] = y;                                 \
+                break;                                       \
+            }                                                \
+        if (has_data) break;                                 \
+    }                                                        \
+    /* Check that we got a box */                            \
+    if (bbox[1] < 0)                                         \
+        return 0; /* no data */                              \
+    /* second stage: looking for any px from bottom */       \
+    for (y = im->ysize - 1; y >= bbox[1]; y--) {             \
+        has_data = 0;                                        \
+        for (x = 0; x < im->xsize; x++)                      \
+            if (im->image[y][x] & mask) {                    \
+                has_data = 1;                                \
+                bbox[3] = y + 1;                             \
+                break;                                       \
+            }                                                \
+        if (has_data) break;                                 \
+    }                                                        \
+    /* third stage: looking for left and right boundaries */ \
+    for (y = bbox[1]; y < bbox[3]; y++) {                    \
+        for (x = 0; x < bbox[0]; x++)                        \
+            if (im->image[y][x] & mask) {                    \
+                bbox[0] = x;                                 \
+                break;                                       \
+            }                                                \
+        for (x = im->xsize - 1; x >= bbox[2]; x--)           \
+            if (im->image[y][x] & mask) {                    \
+                bbox[2] = x + 1;                             \
+                break;                                       \
+            }                                                \
     }
 
     if (im->image8) {
@@ -144,6 +163,9 @@ ImagingGetExtrema(Imaging im, void *extrema) {
                         imax = in[x];
                     }
                 }
+                if (imin == 0 && imax == 255) {
+                    break;
+                }
             }
             ((UINT8 *)extrema)[0] = (UINT8)imin;
             ((UINT8 *)extrema)[1] = (UINT8)imax;

From 6a87df2c1fdd0dea1a3bdd5fb85e388e535e063b Mon Sep 17 00:00:00 2001
From: Aleksandr Karpinskii <homm86@gmail.com>
Date: Tue, 2 Jul 2024 18:40:19 +0400
Subject: [PATCH 0920/1178] clang-format

---
 src/libImaging/GetBBox.c | 8 +++++---
 1 file changed, 5 insertions(+), 3 deletions(-)

diff --git a/src/libImaging/GetBBox.c b/src/libImaging/GetBBox.c
index 680d1cf77ba..46a67807826 100644
--- a/src/libImaging/GetBBox.c
+++ b/src/libImaging/GetBBox.c
@@ -30,7 +30,7 @@ ImagingGetBBox(Imaging im, int bbox[4], int alpha_only) {
     bbox[1] = -1;
     bbox[2] = bbox[3] = 0;
 
-#define	GETBBOX(image, mask)                                 \
+#define GETBBOX(image, mask)                                 \
     /* first stage: looking for any px from top */           \
     for (y = 0; y < im->ysize; y++) {                        \
         has_data = 0;                                        \
@@ -41,7 +41,8 @@ ImagingGetBBox(Imaging im, int bbox[4], int alpha_only) {
                 bbox[1] = y;                                 \
                 break;                                       \
             }                                                \
-        if (has_data) break;                                 \
+        if (has_data)                                        \
+            break;                                           \
     }                                                        \
     /* Check that we got a box */                            \
     if (bbox[1] < 0)                                         \
@@ -55,7 +56,8 @@ ImagingGetBBox(Imaging im, int bbox[4], int alpha_only) {
                 bbox[3] = y + 1;                             \
                 break;                                       \
             }                                                \
-        if (has_data) break;                                 \
+        if (has_data)                                        \
+            break;                                           \
     }                                                        \
     /* third stage: looking for left and right boundaries */ \
     for (y = bbox[1]; y < bbox[3]; y++) {                    \

From 5fb44ab694bc5576c6cd7e7ee54dfce660f497af Mon Sep 17 00:00:00 2001
From: Aleksandr Karpinskii <homm86@gmail.com>
Date: Tue, 2 Jul 2024 18:45:13 +0400
Subject: [PATCH 0921/1178] This check is useless, since moved after the first
 stage

---
 src/libImaging/GetBBox.c | 5 -----
 1 file changed, 5 deletions(-)

diff --git a/src/libImaging/GetBBox.c b/src/libImaging/GetBBox.c
index 46a67807826..2e8afc8d54d 100644
--- a/src/libImaging/GetBBox.c
+++ b/src/libImaging/GetBBox.c
@@ -92,11 +92,6 @@ ImagingGetBBox(Imaging im, int bbox[4], int alpha_only) {
         GETBBOX(image32, mask);
     }
 
-    /* Check that we got a box */
-    if (bbox[1] < 0) {
-        return 0; /* no data */
-    }
-
     return 1; /* ok */
 }
 

From 8256b9bb7fd22abfe61ed0013c02fa18255f398f Mon Sep 17 00:00:00 2001
From: Aleksandr Karpinskii <homm86@gmail.com>
Date: Tue, 2 Jul 2024 19:05:24 +0400
Subject: [PATCH 0922/1178] Correct left boundary on the second stage

---
 src/libImaging/GetBBox.c | 2 ++
 1 file changed, 2 insertions(+)

diff --git a/src/libImaging/GetBBox.c b/src/libImaging/GetBBox.c
index 2e8afc8d54d..50b2253a0e0 100644
--- a/src/libImaging/GetBBox.c
+++ b/src/libImaging/GetBBox.c
@@ -53,6 +53,8 @@ ImagingGetBBox(Imaging im, int bbox[4], int alpha_only) {
         for (x = 0; x < im->xsize; x++)                      \
             if (im->image[y][x] & mask) {                    \
                 has_data = 1;                                \
+                if (x < bbox[0])                             \
+                    bbox[0] = x;                             \
                 bbox[3] = y + 1;                             \
                 break;                                       \
             }                                                \

From 2b6c5a27a1a6813fef4f06d45cf63428b2ae2da6 Mon Sep 17 00:00:00 2001
From: Andrew Murray <radarhere@users.noreply.github.com>
Date: Wed, 3 Jul 2024 22:42:52 +1000
Subject: [PATCH 0923/1178] Added braces

---
 src/libImaging/GetBBox.c | 24 ++++++++++++++++--------
 1 file changed, 16 insertions(+), 8 deletions(-)

diff --git a/src/libImaging/GetBBox.c b/src/libImaging/GetBBox.c
index 50b2253a0e0..1303617ad1e 100644
--- a/src/libImaging/GetBBox.c
+++ b/src/libImaging/GetBBox.c
@@ -34,45 +34,53 @@ ImagingGetBBox(Imaging im, int bbox[4], int alpha_only) {
     /* first stage: looking for any px from top */           \
     for (y = 0; y < im->ysize; y++) {                        \
         has_data = 0;                                        \
-        for (x = 0; x < im->xsize; x++)                      \
+        for (x = 0; x < im->xsize; x++) {                    \
             if (im->image[y][x] & mask) {                    \
                 has_data = 1;                                \
                 bbox[0] = x;                                 \
                 bbox[1] = y;                                 \
                 break;                                       \
             }                                                \
-        if (has_data)                                        \
+        }                                                    \
+        if (has_data) {                                      \
             break;                                           \
+        }                                                    \
     }                                                        \
     /* Check that we got a box */                            \
-    if (bbox[1] < 0)                                         \
+    if (bbox[1] < 0) {                                       \
         return 0; /* no data */                              \
+    }                                                        \
     /* second stage: looking for any px from bottom */       \
     for (y = im->ysize - 1; y >= bbox[1]; y--) {             \
         has_data = 0;                                        \
-        for (x = 0; x < im->xsize; x++)                      \
+        for (x = 0; x < im->xsize; x++) {                    \
             if (im->image[y][x] & mask) {                    \
                 has_data = 1;                                \
-                if (x < bbox[0])                             \
+                if (x < bbox[0]) {                           \
                     bbox[0] = x;                             \
+                }                                            \
                 bbox[3] = y + 1;                             \
                 break;                                       \
             }                                                \
-        if (has_data)                                        \
+        }                                                    \
+        if (has_data) {                                      \
             break;                                           \
+        }                                                    \
     }                                                        \
     /* third stage: looking for left and right boundaries */ \
     for (y = bbox[1]; y < bbox[3]; y++) {                    \
-        for (x = 0; x < bbox[0]; x++)                        \
+        for (x = 0; x < bbox[0]; x++) {                      \
             if (im->image[y][x] & mask) {                    \
                 bbox[0] = x;                                 \
                 break;                                       \
             }                                                \
-        for (x = im->xsize - 1; x >= bbox[2]; x--)           \
+        }                                                    \
+        for (x = im->xsize - 1; x >= bbox[2]; x--) {         \
             if (im->image[y][x] & mask) {                    \
                 bbox[2] = x + 1;                             \
                 break;                                       \
             }                                                \
+        }                                                    \
     }
 
     if (im->image8) {

From e4e2cd65642fa3dc02793fe426ba22a00d163db9 Mon Sep 17 00:00:00 2001
From: Andrew Murray <radarhere@users.noreply.github.com>
Date: Wed, 3 Jul 2024 22:45:10 +1000
Subject: [PATCH 0924/1178] Updated comments

---
 src/libImaging/GetBBox.c | 6 +++---
 1 file changed, 3 insertions(+), 3 deletions(-)

diff --git a/src/libImaging/GetBBox.c b/src/libImaging/GetBBox.c
index 1303617ad1e..d430893ddb2 100644
--- a/src/libImaging/GetBBox.c
+++ b/src/libImaging/GetBBox.c
@@ -31,7 +31,7 @@ ImagingGetBBox(Imaging im, int bbox[4], int alpha_only) {
     bbox[2] = bbox[3] = 0;
 
 #define GETBBOX(image, mask)                                 \
-    /* first stage: looking for any px from top */           \
+    /* first stage: looking for any pixels from top */       \
     for (y = 0; y < im->ysize; y++) {                        \
         has_data = 0;                                        \
         for (x = 0; x < im->xsize; x++) {                    \
@@ -46,11 +46,11 @@ ImagingGetBBox(Imaging im, int bbox[4], int alpha_only) {
             break;                                           \
         }                                                    \
     }                                                        \
-    /* Check that we got a box */                            \
+    /* Check that we have a box */                           \
     if (bbox[1] < 0) {                                       \
         return 0; /* no data */                              \
     }                                                        \
-    /* second stage: looking for any px from bottom */       \
+    /* second stage: looking for any pixels from bottom */   \
     for (y = im->ysize - 1; y >= bbox[1]; y--) {             \
         has_data = 0;                                        \
         for (x = 0; x < im->xsize; x++) {                    \

From b14142462e1d4f0205b7e77c647a02c760b99a05 Mon Sep 17 00:00:00 2001
From: Andrew Murray <radarhere@users.noreply.github.com>
Date: Thu, 15 Aug 2024 05:11:00 +1000
Subject: [PATCH 0925/1178] Update CHANGES.rst [ci skip]

---
 CHANGES.rst | 6 ++++++
 1 file changed, 6 insertions(+)

diff --git a/CHANGES.rst b/CHANGES.rst
index ae995e0a03f..25dcb188719 100644
--- a/CHANGES.rst
+++ b/CHANGES.rst
@@ -5,6 +5,12 @@ Changelog (Pillow)
 11.0.0 (unreleased)
 -------------------
 
+- Remove WebP support without anim, mux/demux, and with buggy alpha #8213
+  [homm, radarhere]
+
+- Add missing TIFF CMYK;16B reader #8298
+  [homm]
+
 - Remove all WITH_* flags from _imaging.c and other flags #8211
   [homm]
 

From 873770978197484b284a267d247d1b832afc2a24 Mon Sep 17 00:00:00 2001
From: Andrew Murray <radarhere@users.noreply.github.com>
Date: Mon, 5 Aug 2024 13:32:59 +1000
Subject: [PATCH 0926/1178] Added return type to ImageFile.load()

---
 src/PIL/Image.py     |  8 +++-----
 src/PIL/ImageFile.py | 19 ++++++++-----------
 2 files changed, 11 insertions(+), 16 deletions(-)

diff --git a/src/PIL/Image.py b/src/PIL/Image.py
index ebf4f46c435..a6eefff56fc 100644
--- a/src/PIL/Image.py
+++ b/src/PIL/Image.py
@@ -218,9 +218,10 @@ class Quantize(IntEnum):
 # Registries
 
 if TYPE_CHECKING:
+    import mmap
     from xml.etree.ElementTree import Element
 
-    from . import ImageFile, ImagePalette, TiffImagePlugin
+    from . import ImageFile, ImageFilter, ImagePalette, TiffImagePlugin
     from ._typing import NumpyArray, StrOrBytesPath, TypeGuard
 ID: list[str] = []
 OPEN: dict[
@@ -612,7 +613,7 @@ def close(self) -> None:
                 logger.debug("Error closing: %s", msg)
 
         if getattr(self, "map", None):
-            self.map = None
+            self.map: mmap.mmap | None = None
 
         # Instead of simply setting to None, we're setting up a
         # deferred error that will better explain that the core image
@@ -1336,9 +1337,6 @@ def _expand(self, xmargin: int, ymargin: int | None = None) -> Image:
         self.load()
         return self._new(self.im.expand(xmargin, ymargin))
 
-    if TYPE_CHECKING:
-        from . import ImageFilter
-
     def filter(self, filter: ImageFilter.Filter | type[ImageFilter.Filter]) -> Image:
         """
         Filters this image using the given filter.  For a list of
diff --git a/src/PIL/ImageFile.py b/src/PIL/ImageFile.py
index 2a8846c1afd..829082e94e4 100644
--- a/src/PIL/ImageFile.py
+++ b/src/PIL/ImageFile.py
@@ -174,7 +174,7 @@ def verify(self) -> None:
             self.fp.close()
         self.fp = None
 
-    def load(self):
+    def load(self) -> Image.core.PixelAccess | None:
         """Load image data based on tile list"""
 
         if self.tile is None:
@@ -185,7 +185,7 @@ def load(self):
         if not self.tile:
             return pixel
 
-        self.map = None
+        self.map: mmap.mmap | None = None
         use_mmap = self.filename and len(self.tile) == 1
         # As of pypy 2.1.0, memory mapping was failing here.
         use_mmap = use_mmap and not hasattr(sys, "pypy_version_info")
@@ -193,17 +193,17 @@ def load(self):
         readonly = 0
 
         # look for read/seek overrides
-        try:
+        if hasattr(self, "load_read"):
             read = self.load_read
             # don't use mmap if there are custom read/seek functions
             use_mmap = False
-        except AttributeError:
+        else:
             read = self.fp.read
 
-        try:
+        if hasattr(self, "load_seek"):
             seek = self.load_seek
             use_mmap = False
-        except AttributeError:
+        else:
             seek = self.fp.seek
 
         if use_mmap:
@@ -243,11 +243,8 @@ def load(self):
             # sort tiles in file order
             self.tile.sort(key=_tilesort)
 
-            try:
-                # FIXME: This is a hack to handle TIFF's JpegTables tag.
-                prefix = self.tile_prefix
-            except AttributeError:
-                prefix = b""
+            # FIXME: This is a hack to handle TIFF's JpegTables tag.
+            prefix = getattr(self, "tile_prefix", b"")
 
             # Remove consecutive duplicates that only differ by their offset
             self.tile = [

From 497080f63b62c9acbb427c7e554f222de70fe3a9 Mon Sep 17 00:00:00 2001
From: Andrew Murray <radarhere@users.noreply.github.com>
Date: Mon, 5 Aug 2024 15:20:34 +1000
Subject: [PATCH 0927/1178] Added type hint to ImageFile._save tile parameter

---
 Tests/test_imagefile.py      | 30 ++++++++++++++++++++++++------
 src/PIL/BlpImagePlugin.py    |  2 +-
 src/PIL/BmpImagePlugin.py    |  4 +++-
 src/PIL/EpsImagePlugin.py    |  2 +-
 src/PIL/GifImagePlugin.py    |  8 ++++++--
 src/PIL/IcoImagePlugin.py    |  4 +++-
 src/PIL/ImImagePlugin.py     |  4 +++-
 src/PIL/ImageFile.py         |  4 ++--
 src/PIL/Jpeg2KImagePlugin.py |  2 +-
 src/PIL/JpegImagePlugin.py   |  4 +++-
 src/PIL/MspImagePlugin.py    |  2 +-
 src/PIL/PalmImagePlugin.py   |  4 +++-
 src/PIL/PcxImagePlugin.py    |  4 +++-
 src/PIL/PdfImagePlugin.py    |  2 +-
 src/PIL/PngImagePlugin.py    |  8 ++++----
 src/PIL/PpmImagePlugin.py    |  4 +++-
 src/PIL/SpiderImagePlugin.py |  4 +++-
 src/PIL/TgaImagePlugin.py    |  8 ++++++--
 src/PIL/XbmImagePlugin.py    |  2 +-
 19 files changed, 72 insertions(+), 30 deletions(-)

diff --git a/Tests/test_imagefile.py b/Tests/test_imagefile.py
index fe7d44785ce..95e91db839f 100644
--- a/Tests/test_imagefile.py
+++ b/Tests/test_imagefile.py
@@ -317,7 +317,13 @@ def test_setimage(self) -> None:
 
         fp = BytesIO()
         ImageFile._save(
-            im, fp, [("MOCK", (xoff, yoff, xoff + xsize, yoff + ysize), 0, "RGB")]
+            im,
+            fp,
+            [
+                ImageFile._Tile(
+                    "MOCK", (xoff, yoff, xoff + xsize, yoff + ysize), 0, "RGB"
+                )
+            ],
         )
 
         assert MockPyEncoder.last
@@ -333,7 +339,7 @@ def test_extents_none(self) -> None:
         im.tile = [("MOCK", None, 32, None)]
 
         fp = BytesIO()
-        ImageFile._save(im, fp, [("MOCK", None, 0, "RGB")])
+        ImageFile._save(im, fp, [ImageFile._Tile("MOCK", None, 0, "RGB")])
 
         assert MockPyEncoder.last
         assert MockPyEncoder.last.state.xoff == 0
@@ -350,7 +356,9 @@ def test_negsize(self) -> None:
         MockPyEncoder.last = None
         with pytest.raises(ValueError):
             ImageFile._save(
-                im, fp, [("MOCK", (xoff, yoff, -10, yoff + ysize), 0, "RGB")]
+                im,
+                fp,
+                [ImageFile._Tile("MOCK", (xoff, yoff, -10, yoff + ysize), 0, "RGB")],
             )
         last: MockPyEncoder | None = MockPyEncoder.last
         assert last
@@ -358,7 +366,9 @@ def test_negsize(self) -> None:
 
         with pytest.raises(ValueError):
             ImageFile._save(
-                im, fp, [("MOCK", (xoff, yoff, xoff + xsize, -10), 0, "RGB")]
+                im,
+                fp,
+                [ImageFile._Tile("MOCK", (xoff, yoff, xoff + xsize, -10), 0, "RGB")],
             )
 
     def test_oversize(self) -> None:
@@ -371,14 +381,22 @@ def test_oversize(self) -> None:
             ImageFile._save(
                 im,
                 fp,
-                [("MOCK", (xoff, yoff, xoff + xsize + 100, yoff + ysize), 0, "RGB")],
+                [
+                    ImageFile._Tile(
+                        "MOCK", (xoff, yoff, xoff + xsize + 100, yoff + ysize), 0, "RGB"
+                    )
+                ],
             )
 
         with pytest.raises(ValueError):
             ImageFile._save(
                 im,
                 fp,
-                [("MOCK", (xoff, yoff, xoff + xsize, yoff + ysize + 100), 0, "RGB")],
+                [
+                    ImageFile._Tile(
+                        "MOCK", (xoff, yoff, xoff + xsize, yoff + ysize + 100), 0, "RGB"
+                    )
+                ],
             )
 
     def test_encode(self) -> None:
diff --git a/src/PIL/BlpImagePlugin.py b/src/PIL/BlpImagePlugin.py
index 6d71049a9d5..569f2c9bfe9 100644
--- a/src/PIL/BlpImagePlugin.py
+++ b/src/PIL/BlpImagePlugin.py
@@ -477,7 +477,7 @@ def _save(im: Image.Image, fp: IO[bytes], filename: str | bytes) -> None:
         fp.write(struct.pack("<i", 5))
         fp.write(struct.pack("<i", 0))
 
-    ImageFile._save(im, fp, [("BLP", (0, 0) + im.size, 0, im.mode)])
+    ImageFile._save(im, fp, [ImageFile._Tile("BLP", (0, 0) + im.size, 0, im.mode)])
 
 
 Image.register_open(BlpImageFile.format, BlpImageFile, _accept)
diff --git a/src/PIL/BmpImagePlugin.py b/src/PIL/BmpImagePlugin.py
index 48bdd98307c..1294159556b 100644
--- a/src/PIL/BmpImagePlugin.py
+++ b/src/PIL/BmpImagePlugin.py
@@ -482,7 +482,9 @@ def _save(
     if palette:
         fp.write(palette)
 
-    ImageFile._save(im, fp, [("raw", (0, 0) + im.size, 0, (rawmode, stride, -1))])
+    ImageFile._save(
+        im, fp, [ImageFile._Tile("raw", (0, 0) + im.size, 0, (rawmode, stride, -1))]
+    )
 
 
 #
diff --git a/src/PIL/EpsImagePlugin.py b/src/PIL/EpsImagePlugin.py
index 35915e6520a..4da0cd230e2 100644
--- a/src/PIL/EpsImagePlugin.py
+++ b/src/PIL/EpsImagePlugin.py
@@ -434,7 +434,7 @@ def _save(im: Image.Image, fp: IO[bytes], filename: str | bytes, eps: int = 1) -
     if hasattr(fp, "flush"):
         fp.flush()
 
-    ImageFile._save(im, fp, [("eps", (0, 0) + im.size, 0, None)])
+    ImageFile._save(im, fp, [ImageFile._Tile("eps", (0, 0) + im.size, 0, None)])
 
     fp.write(b"\n%%%%EndBinary\n")
     fp.write(b"grestore end\n")
diff --git a/src/PIL/GifImagePlugin.py b/src/PIL/GifImagePlugin.py
index bf74f9356fa..45d5132890b 100644
--- a/src/PIL/GifImagePlugin.py
+++ b/src/PIL/GifImagePlugin.py
@@ -591,7 +591,9 @@ def _write_single_frame(
     _write_local_header(fp, im, (0, 0), flags)
 
     im_out.encoderconfig = (8, get_interlace(im))
-    ImageFile._save(im_out, fp, [("gif", (0, 0) + im.size, 0, RAWMODE[im_out.mode])])
+    ImageFile._save(
+        im_out, fp, [ImageFile._Tile("gif", (0, 0) + im.size, 0, RAWMODE[im_out.mode])]
+    )
 
     fp.write(b"\0")  # end of image data
 
@@ -1054,7 +1056,9 @@ def _write_frame_data(
         _write_local_header(fp, im_frame, offset, 0)
 
         ImageFile._save(
-            im_frame, fp, [("gif", (0, 0) + im_frame.size, 0, RAWMODE[im_frame.mode])]
+            im_frame,
+            fp,
+            [ImageFile._Tile("gif", (0, 0) + im_frame.size, 0, RAWMODE[im_frame.mode])],
         )
 
         fp.write(b"\0")  # end of image data
diff --git a/src/PIL/IcoImagePlugin.py b/src/PIL/IcoImagePlugin.py
index c891024f56e..3bf5d9c0464 100644
--- a/src/PIL/IcoImagePlugin.py
+++ b/src/PIL/IcoImagePlugin.py
@@ -97,7 +97,9 @@ def _save(im: Image.Image, fp: IO[bytes], filename: str | bytes) -> None:
             if bits != 32:
                 and_mask = Image.new("1", size)
                 ImageFile._save(
-                    and_mask, image_io, [("raw", (0, 0) + size, 0, ("1", 0, -1))]
+                    and_mask,
+                    image_io,
+                    [ImageFile._Tile("raw", (0, 0) + size, 0, ("1", 0, -1))],
                 )
         else:
             frame.save(image_io, "png")
diff --git a/src/PIL/ImImagePlugin.py b/src/PIL/ImImagePlugin.py
index 2fb7ecd52a0..b9416508987 100644
--- a/src/PIL/ImImagePlugin.py
+++ b/src/PIL/ImImagePlugin.py
@@ -360,7 +360,9 @@ def _save(im: Image.Image, fp: IO[bytes], filename: str | bytes) -> None:
             palette += im_palette[colors * i : colors * (i + 1)]
             palette += b"\x00" * (256 - colors)
         fp.write(palette)  # 768 bytes
-    ImageFile._save(im, fp, [("raw", (0, 0) + im.size, 0, (rawmode, 0, -1))])
+    ImageFile._save(
+        im, fp, [ImageFile._Tile("raw", (0, 0) + im.size, 0, (rawmode, 0, -1))]
+    )
 
 
 #
diff --git a/src/PIL/ImageFile.py b/src/PIL/ImageFile.py
index 829082e94e4..73554fa53e3 100644
--- a/src/PIL/ImageFile.py
+++ b/src/PIL/ImageFile.py
@@ -93,7 +93,7 @@ def _tilesort(t: _Tile) -> int:
 
 class _Tile(NamedTuple):
     codec_name: str
-    extents: tuple[int, int, int, int]
+    extents: tuple[int, int, int, int] | None
     offset: int
     args: tuple[Any, ...] | str | None
 
@@ -522,7 +522,7 @@ def close(self) -> Image.Image:
 # --------------------------------------------------------------------
 
 
-def _save(im: Image.Image, fp: IO[bytes], tile, bufsize: int = 0) -> None:
+def _save(im: Image.Image, fp: IO[bytes], tile: list[_Tile], bufsize: int = 0) -> None:
     """Helper to save image based on tile list
 
     :param im: Image object.
diff --git a/src/PIL/Jpeg2KImagePlugin.py b/src/PIL/Jpeg2KImagePlugin.py
index ef9107f0073..02c2e48cfb4 100644
--- a/src/PIL/Jpeg2KImagePlugin.py
+++ b/src/PIL/Jpeg2KImagePlugin.py
@@ -419,7 +419,7 @@ def _save(im: Image.Image, fp: IO[bytes], filename: str | bytes) -> None:
         plt,
     )
 
-    ImageFile._save(im, fp, [("jpeg2k", (0, 0) + im.size, 0, kind)])
+    ImageFile._save(im, fp, [ImageFile._Tile("jpeg2k", (0, 0) + im.size, 0, kind)])
 
 
 # ------------------------------------------------------------
diff --git a/src/PIL/JpegImagePlugin.py b/src/PIL/JpegImagePlugin.py
index fc897e2b919..bd4539be420 100644
--- a/src/PIL/JpegImagePlugin.py
+++ b/src/PIL/JpegImagePlugin.py
@@ -826,7 +826,9 @@ def validate_qtables(
         # Ensure that our buffer is big enough. Same with the icc_profile block.
         bufsize = max(bufsize, len(exif) + 5, len(extra) + 1)
 
-    ImageFile._save(im, fp, [("jpeg", (0, 0) + im.size, 0, rawmode)], bufsize)
+    ImageFile._save(
+        im, fp, [ImageFile._Tile("jpeg", (0, 0) + im.size, 0, rawmode)], bufsize
+    )
 
 
 def _save_cjpeg(im: Image.Image, fp: IO[bytes], filename: str | bytes) -> None:
diff --git a/src/PIL/MspImagePlugin.py b/src/PIL/MspImagePlugin.py
index 0a75c868b97..40e5fa435a8 100644
--- a/src/PIL/MspImagePlugin.py
+++ b/src/PIL/MspImagePlugin.py
@@ -188,7 +188,7 @@ def _save(im: Image.Image, fp: IO[bytes], filename: str | bytes) -> None:
         fp.write(o16(h))
 
     # image body
-    ImageFile._save(im, fp, [("raw", (0, 0) + im.size, 32, ("1", 0, 1))])
+    ImageFile._save(im, fp, [ImageFile._Tile("raw", (0, 0) + im.size, 32, ("1", 0, 1))])
 
 
 #
diff --git a/src/PIL/PalmImagePlugin.py b/src/PIL/PalmImagePlugin.py
index 1735070f81b..62bf5f54288 100644
--- a/src/PIL/PalmImagePlugin.py
+++ b/src/PIL/PalmImagePlugin.py
@@ -213,7 +213,9 @@ def _save(im: Image.Image, fp: IO[bytes], filename: str | bytes) -> None:
                 )
 
     # now convert data to raw form
-    ImageFile._save(im, fp, [("raw", (0, 0) + im.size, 0, (rawmode, rowbytes, 1))])
+    ImageFile._save(
+        im, fp, [ImageFile._Tile("raw", (0, 0) + im.size, 0, (rawmode, rowbytes, 1))]
+    )
 
     if hasattr(fp, "flush"):
         fp.flush()
diff --git a/src/PIL/PcxImagePlugin.py b/src/PIL/PcxImagePlugin.py
index dd42003b5a3..4fb04715bb2 100644
--- a/src/PIL/PcxImagePlugin.py
+++ b/src/PIL/PcxImagePlugin.py
@@ -198,7 +198,9 @@ def _save(im: Image.Image, fp: IO[bytes], filename: str | bytes) -> None:
 
     assert fp.tell() == 128
 
-    ImageFile._save(im, fp, [("pcx", (0, 0) + im.size, 0, (rawmode, bits * planes))])
+    ImageFile._save(
+        im, fp, [ImageFile._Tile("pcx", (0, 0) + im.size, 0, (rawmode, bits * planes))]
+    )
 
     if im.mode == "P":
         # colour palette
diff --git a/src/PIL/PdfImagePlugin.py b/src/PIL/PdfImagePlugin.py
index 7fc1108bb84..e9c20ddc159 100644
--- a/src/PIL/PdfImagePlugin.py
+++ b/src/PIL/PdfImagePlugin.py
@@ -138,7 +138,7 @@ def _write_image(
     op = io.BytesIO()
 
     if decode_filter == "ASCIIHexDecode":
-        ImageFile._save(im, op, [("hex", (0, 0) + im.size, 0, im.mode)])
+        ImageFile._save(im, op, [ImageFile._Tile("hex", (0, 0) + im.size, 0, im.mode)])
     elif decode_filter == "CCITTFaxDecode":
         im.save(
             op,
diff --git a/src/PIL/PngImagePlugin.py b/src/PIL/PngImagePlugin.py
index 910fa9755cd..fc20b18a892 100644
--- a/src/PIL/PngImagePlugin.py
+++ b/src/PIL/PngImagePlugin.py
@@ -1226,7 +1226,7 @@ def _write_multiple_frames(
         ImageFile._save(
             im,
             cast(IO[bytes], _idat(fp, chunk)),
-            [("zip", (0, 0) + im.size, 0, rawmode)],
+            [ImageFile._Tile("zip", (0, 0) + im.size, 0, rawmode)],
         )
 
     seq_num = 0
@@ -1263,14 +1263,14 @@ def _write_multiple_frames(
             ImageFile._save(
                 im_frame,
                 cast(IO[bytes], _idat(fp, chunk)),
-                [("zip", (0, 0) + im_frame.size, 0, rawmode)],
+                [ImageFile._Tile("zip", (0, 0) + im_frame.size, 0, rawmode)],
             )
         else:
             fdat_chunks = _fdat(fp, chunk, seq_num)
             ImageFile._save(
                 im_frame,
                 cast(IO[bytes], fdat_chunks),
-                [("zip", (0, 0) + im_frame.size, 0, rawmode)],
+                [ImageFile._Tile("zip", (0, 0) + im_frame.size, 0, rawmode)],
             )
             seq_num = fdat_chunks.seq_num
     return None
@@ -1471,7 +1471,7 @@ def _save(
         ImageFile._save(
             single_im,
             cast(IO[bytes], _idat(fp, chunk)),
-            [("zip", (0, 0) + single_im.size, 0, rawmode)],
+            [ImageFile._Tile("zip", (0, 0) + single_im.size, 0, rawmode)],
         )
 
     if info:
diff --git a/src/PIL/PpmImagePlugin.py b/src/PIL/PpmImagePlugin.py
index 16c9ccbba72..7bdaa9fe740 100644
--- a/src/PIL/PpmImagePlugin.py
+++ b/src/PIL/PpmImagePlugin.py
@@ -353,7 +353,9 @@ def _save(im: Image.Image, fp: IO[bytes], filename: str | bytes) -> None:
     elif head == b"Pf":
         fp.write(b"-1.0\n")
     row_order = -1 if im.mode == "F" else 1
-    ImageFile._save(im, fp, [("raw", (0, 0) + im.size, 0, (rawmode, 0, row_order))])
+    ImageFile._save(
+        im, fp, [ImageFile._Tile("raw", (0, 0) + im.size, 0, (rawmode, 0, row_order))]
+    )
 
 
 #
diff --git a/src/PIL/SpiderImagePlugin.py b/src/PIL/SpiderImagePlugin.py
index a07101e5461..7045ab566de 100644
--- a/src/PIL/SpiderImagePlugin.py
+++ b/src/PIL/SpiderImagePlugin.py
@@ -278,7 +278,9 @@ def _save(im: Image.Image, fp: IO[bytes], filename: str | bytes) -> None:
     fp.writelines(hdr)
 
     rawmode = "F;32NF"  # 32-bit native floating point
-    ImageFile._save(im, fp, [("raw", (0, 0) + im.size, 0, (rawmode, 0, 1))])
+    ImageFile._save(
+        im, fp, [ImageFile._Tile("raw", (0, 0) + im.size, 0, (rawmode, 0, 1))]
+    )
 
 
 def _save_spider(im: Image.Image, fp: IO[bytes], filename: str | bytes) -> None:
diff --git a/src/PIL/TgaImagePlugin.py b/src/PIL/TgaImagePlugin.py
index 39104aeced9..a43aae1ec75 100644
--- a/src/PIL/TgaImagePlugin.py
+++ b/src/PIL/TgaImagePlugin.py
@@ -238,11 +238,15 @@ def _save(im: Image.Image, fp: IO[bytes], filename: str | bytes) -> None:
 
     if rle:
         ImageFile._save(
-            im, fp, [("tga_rle", (0, 0) + im.size, 0, (rawmode, orientation))]
+            im,
+            fp,
+            [ImageFile._Tile("tga_rle", (0, 0) + im.size, 0, (rawmode, orientation))],
         )
     else:
         ImageFile._save(
-            im, fp, [("raw", (0, 0) + im.size, 0, (rawmode, 0, orientation))]
+            im,
+            fp,
+            [ImageFile._Tile("raw", (0, 0) + im.size, 0, (rawmode, 0, orientation))],
         )
 
     # write targa version 2 footer
diff --git a/src/PIL/XbmImagePlugin.py b/src/PIL/XbmImagePlugin.py
index 6d11bbfcf6b..6c2e32804e3 100644
--- a/src/PIL/XbmImagePlugin.py
+++ b/src/PIL/XbmImagePlugin.py
@@ -85,7 +85,7 @@ def _save(im: Image.Image, fp: IO[bytes], filename: str | bytes) -> None:
 
     fp.write(b"static char im_bits[] = {\n")
 
-    ImageFile._save(im, fp, [("xbm", (0, 0) + im.size, 0, None)])
+    ImageFile._save(im, fp, [ImageFile._Tile("xbm", (0, 0) + im.size, 0, None)])
 
     fp.write(b"};\n")
 

From 8afb7ddb4ed265caf67213f4fd5416cd29ae24a1 Mon Sep 17 00:00:00 2001
From: Andrew Murray <radarhere@users.noreply.github.com>
Date: Thu, 15 Aug 2024 08:08:43 +1000
Subject: [PATCH 0928/1178] Added type hints

---
 .ci/requirements-mypy.txt      |  1 +
 docs/example/DdsImagePlugin.py | 29 +++++++++++++++------------
 src/PIL/TiffImagePlugin.py     | 36 ++++++++++++++++++++--------------
 tox.ini                        |  2 +-
 winbuild/build_prepare.py      | 12 ++++++------
 5 files changed, 45 insertions(+), 35 deletions(-)

diff --git a/.ci/requirements-mypy.txt b/.ci/requirements-mypy.txt
index 23792281b15..47fc6439994 100644
--- a/.ci/requirements-mypy.txt
+++ b/.ci/requirements-mypy.txt
@@ -5,6 +5,7 @@ ipython
 numpy
 packaging
 pytest
+sphinx
 types-defusedxml
 types-olefile
 types-setuptools
diff --git a/docs/example/DdsImagePlugin.py b/docs/example/DdsImagePlugin.py
index 2a2a0ba2961..caa852b1fe1 100644
--- a/docs/example/DdsImagePlugin.py
+++ b/docs/example/DdsImagePlugin.py
@@ -14,6 +14,7 @@
 
 import struct
 from io import BytesIO
+from typing import IO
 
 from PIL import Image, ImageFile
 
@@ -94,26 +95,26 @@
 DXT5_FOURCC = 0x35545844
 
 
-def _decode565(bits):
+def _decode565(bits: int) -> tuple[int, int, int]:
     a = ((bits >> 11) & 0x1F) << 3
     b = ((bits >> 5) & 0x3F) << 2
     c = (bits & 0x1F) << 3
     return a, b, c
 
 
-def _c2a(a, b):
+def _c2a(a: int, b: int) -> int:
     return (2 * a + b) // 3
 
 
-def _c2b(a, b):
+def _c2b(a: int, b: int) -> int:
     return (a + b) // 2
 
 
-def _c3(a, b):
+def _c3(a: int, b: int) -> int:
     return (2 * b + a) // 3
 
 
-def _dxt1(data, width, height):
+def _dxt1(data: IO[bytes], width: int, height: int) -> bytes:
     # TODO implement this function as pixel format in decode.c
     ret = bytearray(4 * width * height)
 
@@ -151,7 +152,7 @@ def _dxt1(data, width, height):
     return bytes(ret)
 
 
-def _dxtc_alpha(a0, a1, ac0, ac1, ai):
+def _dxtc_alpha(a0: int, a1: int, ac0: int, ac1: int, ai: int) -> int:
     if ai <= 12:
         ac = (ac0 >> ai) & 7
     elif ai == 15:
@@ -175,7 +176,7 @@ def _dxtc_alpha(a0, a1, ac0, ac1, ai):
     return alpha
 
 
-def _dxt5(data, width, height):
+def _dxt5(data: IO[bytes], width: int, height: int) -> bytes:
     # TODO implement this function as pixel format in decode.c
     ret = bytearray(4 * width * height)
 
@@ -211,7 +212,7 @@ class DdsImageFile(ImageFile.ImageFile):
     format = "DDS"
     format_description = "DirectDraw Surface"
 
-    def _open(self):
+    def _open(self) -> None:
         if not _accept(self.fp.read(4)):
             msg = "not a DDS file"
             raise SyntaxError(msg)
@@ -242,19 +243,20 @@ def _open(self):
         elif fourcc == b"DXT5":
             self.decoder = "DXT5"
         else:
-            msg = f"Unimplemented pixel format {fourcc}"
+            msg = f"Unimplemented pixel format {repr(fourcc)}"
             raise NotImplementedError(msg)
 
         self.tile = [(self.decoder, (0, 0) + self.size, 0, (self.mode, 0, 1))]
 
-    def load_seek(self, pos):
+    def load_seek(self, pos: int) -> None:
         pass
 
 
 class DXT1Decoder(ImageFile.PyDecoder):
     _pulls_fd = True
 
-    def decode(self, buffer):
+    def decode(self, buffer: bytes) -> tuple[int, int]:
+        assert self.fd is not None
         try:
             self.set_as_raw(_dxt1(self.fd, self.state.xsize, self.state.ysize))
         except struct.error as e:
@@ -266,7 +268,8 @@ def decode(self, buffer):
 class DXT5Decoder(ImageFile.PyDecoder):
     _pulls_fd = True
 
-    def decode(self, buffer):
+    def decode(self, buffer: bytes) -> tuple[int, int]:
+        assert self.fd is not None
         try:
             self.set_as_raw(_dxt5(self.fd, self.state.xsize, self.state.ysize))
         except struct.error as e:
@@ -279,7 +282,7 @@ def decode(self, buffer):
 Image.register_decoder("DXT5", DXT5Decoder)
 
 
-def _accept(prefix):
+def _accept(prefix: bytes) -> bool:
     return prefix[:4] == b"DDS "
 
 
diff --git a/src/PIL/TiffImagePlugin.py b/src/PIL/TiffImagePlugin.py
index deae199d50e..2ce8a6c2a11 100644
--- a/src/PIL/TiffImagePlugin.py
+++ b/src/PIL/TiffImagePlugin.py
@@ -456,8 +456,11 @@ def __setstate__(self, state: list[float | Fraction]) -> None:
         __int__ = _delegate("__int__")
 
 
-def _register_loader(idx: int, size: int):
-    def decorator(func):
+_LoaderFunc = Callable[["ImageFileDirectory_v2", bytes, bool], Any]
+
+
+def _register_loader(idx: int, size: int) -> Callable[[_LoaderFunc], _LoaderFunc]:
+    def decorator(func: _LoaderFunc) -> _LoaderFunc:
         from .TiffTags import TYPES
 
         if func.__name__.startswith("load_"):
@@ -482,12 +485,13 @@ def _register_basic(idx_fmt_name: tuple[int, str, str]) -> None:
     idx, fmt, name = idx_fmt_name
     TYPES[idx] = name
     size = struct.calcsize(f"={fmt}")
-    _load_dispatch[idx] = (  # noqa: F821
-        size,
-        lambda self, data, legacy_api=True: (
-            self._unpack(f"{len(data) // size}{fmt}", data)
-        ),
-    )
+
+    def basic_handler(
+        self: ImageFileDirectory_v2, data: bytes, legacy_api: bool = True
+    ) -> tuple[Any, ...]:
+        return self._unpack(f"{len(data) // size}{fmt}", data)
+
+    _load_dispatch[idx] = size, basic_handler  # noqa: F821
     _write_dispatch[idx] = lambda self, *values: (  # noqa: F821
         b"".join(self._pack(fmt, value) for value in values)
     )
@@ -560,7 +564,7 @@ class ImageFileDirectory_v2(_IFDv2Base):
 
     """
 
-    _load_dispatch: dict[int, Callable[[ImageFileDirectory_v2, bytes, bool], Any]] = {}
+    _load_dispatch: dict[int, tuple[int, _LoaderFunc]] = {}
     _write_dispatch: dict[int, Callable[..., Any]] = {}
 
     def __init__(
@@ -653,10 +657,10 @@ def __getitem__(self, tag):
     def __contains__(self, tag: object) -> bool:
         return tag in self._tags_v2 or tag in self._tagdata
 
-    def __setitem__(self, tag: int, value) -> None:
+    def __setitem__(self, tag: int, value: Any) -> None:
         self._setitem(tag, value, self.legacy_api)
 
-    def _setitem(self, tag: int, value, legacy_api: bool) -> None:
+    def _setitem(self, tag: int, value: Any, legacy_api: bool) -> None:
         basetypes = (Number, bytes, str)
 
         info = TiffTags.lookup(tag, self.group)
@@ -744,10 +748,10 @@ def __delitem__(self, tag: int) -> None:
     def __iter__(self) -> Iterator[int]:
         return iter(set(self._tagdata) | set(self._tags_v2))
 
-    def _unpack(self, fmt: str, data: bytes):
+    def _unpack(self, fmt: str, data: bytes) -> tuple[Any, ...]:
         return struct.unpack(self._endian + fmt, data)
 
-    def _pack(self, fmt: str, *values) -> bytes:
+    def _pack(self, fmt: str, *values: Any) -> bytes:
         return struct.pack(self._endian + fmt, *values)
 
     list(
@@ -824,7 +828,9 @@ def write_undefined(self, value: bytes | int | IFDRational) -> bytes:
         return value
 
     @_register_loader(10, 8)
-    def load_signed_rational(self, data: bytes, legacy_api: bool = True):
+    def load_signed_rational(
+        self, data: bytes, legacy_api: bool = True
+    ) -> tuple[tuple[int, int] | IFDRational, ...]:
         vals = self._unpack(f"{len(data) // 4}l", data)
 
         def combine(a: int, b: int) -> tuple[int, int] | IFDRational:
@@ -1088,7 +1094,7 @@ def __len__(self) -> int:
     def __iter__(self) -> Iterator[int]:
         return iter(set(self._tagdata) | set(self._tags_v1))
 
-    def __setitem__(self, tag: int, value) -> None:
+    def __setitem__(self, tag: int, value: Any) -> None:
         for legacy_api in (False, True):
             self._setitem(tag, value, legacy_api)
 
diff --git a/tox.ini b/tox.ini
index 4b40594550e..70b8bf14584 100644
--- a/tox.ini
+++ b/tox.ini
@@ -36,4 +36,4 @@ deps =
 extras =
     typing
 commands =
-    mypy src Tests {posargs}
+    mypy docs src winbuild Tests {posargs}
diff --git a/winbuild/build_prepare.py b/winbuild/build_prepare.py
index 7129699eb52..1021e4f229f 100644
--- a/winbuild/build_prepare.py
+++ b/winbuild/build_prepare.py
@@ -7,6 +7,7 @@
 import shutil
 import struct
 import subprocess
+from typing import Any
 
 
 def cmd_cd(path: str) -> str:
@@ -43,21 +44,19 @@ def cmd_nmake(
     target: str = "",
     params: list[str] | None = None,
 ) -> str:
-    params = "" if params is None else " ".join(params)
-
     return " ".join(
         [
             "{nmake}",
             "-nologo",
             f'-f "{makefile}"' if makefile is not None else "",
-            f"{params}",
+            f'{" ".join(params)}' if params is not None else "",
             f'"{target}"',
         ]
     )
 
 
 def cmds_cmake(
-    target: str | tuple[str, ...] | list[str], *params, build_dir: str = "."
+    target: str | tuple[str, ...] | list[str], *params: str, build_dir: str = "."
 ) -> list[str]:
     if not isinstance(target, str):
         target = " ".join(target)
@@ -129,7 +128,7 @@ def cmd_msbuild(
 
 
 # dependencies, listed in order of compilation
-DEPS = {
+DEPS: dict[str, dict[str, Any]] = {
     "libjpeg": {
         "url": f"{SF_PROJECTS}/libjpeg-turbo/files/{V['JPEGTURBO']}/"
         f"libjpeg-turbo-{V['JPEGTURBO']}.tar.gz/download",
@@ -538,7 +537,7 @@ def write_script(
             print("    " + line)
 
 
-def get_footer(dep: dict) -> list[str]:
+def get_footer(dep: dict[str, Any]) -> list[str]:
     lines = []
     for out in dep.get("headers", []):
         lines.append(cmd_copy(out, "{inc_dir}"))
@@ -583,6 +582,7 @@ def build_dep(name: str, prefs: dict[str, str], verbose: bool) -> str:
             license_text += f.read()
     if "license_pattern" in dep:
         match = re.search(dep["license_pattern"], license_text, re.DOTALL)
+        assert match is not None
         license_text = "\n".join(match.groups())
     assert len(license_text) > 50
     with open(os.path.join(license_dir, f"{directory}.txt"), "w") as f:

From d4c72da6b2ae5aabc45f679f8feeaf2726976a2b Mon Sep 17 00:00:00 2001
From: Andrew Murray <radarhere@users.noreply.github.com>
Date: Thu, 15 Aug 2024 14:10:31 +1000
Subject: [PATCH 0929/1178] Added type hints to example code

---
 docs/handbook/image-file-formats.rst            | 12 +++++++-----
 docs/handbook/tutorial.rst                      |  6 +++---
 docs/handbook/writing-your-own-image-plugin.rst |  6 +++---
 3 files changed, 13 insertions(+), 11 deletions(-)

diff --git a/docs/handbook/image-file-formats.rst b/docs/handbook/image-file-formats.rst
index 861e09a43aa..ca0e05eb6c0 100644
--- a/docs/handbook/image-file-formats.rst
+++ b/docs/handbook/image-file-formats.rst
@@ -1517,19 +1517,21 @@ To add other read or write support, use
 :py:func:`PIL.WmfImagePlugin.register_handler` to register a WMF and EMF
 handler. ::
 
-    from PIL import Image
+    from typing import IO
+
+    from PIL import Image, ImageFile
     from PIL import WmfImagePlugin
 
 
-    class WmfHandler:
-        def open(self, im):
+    class WmfHandler(ImageFile.StubHandler):
+        def open(self, im: ImageFile.StubImageFile) -> None:
             ...
 
-        def load(self, im):
+        def load(self, im: ImageFile.StubImageFile) -> Image.Image:
             ...
             return image
 
-        def save(self, im, fp, filename):
+        def save(self, im: Image.Image, fp: IO[bytes], filename: str) -> None:
             ...
 
 
diff --git a/docs/handbook/tutorial.rst b/docs/handbook/tutorial.rst
index c36011362c6..3df8e0d20be 100644
--- a/docs/handbook/tutorial.rst
+++ b/docs/handbook/tutorial.rst
@@ -186,7 +186,7 @@ Rolling an image
 
 ::
 
-    def roll(im, delta):
+    def roll(im: Image.Image, delta: int) -> Image.Image:
         """Roll an image sideways."""
         xsize, ysize = im.size
 
@@ -211,7 +211,7 @@ Merging images
 
 ::
 
-    def merge(im1, im2):
+    def merge(im1: Image.Image, im2: Image.Image) -> Image.Image:
         w = im1.size[0] + im2.size[0]
         h = max(im1.size[1], im2.size[1])
         im = Image.new("RGBA", (w, h))
@@ -704,7 +704,7 @@ in the current directory can be saved as JPEGs at reduced quality.
     import glob
     from PIL import Image
 
-    def compress_image(source_path, dest_path):
+    def compress_image(source_path: str, dest_path: str) -> None:
         with Image.open(source_path) as img:
             if img.mode != "RGB":
                 img = img.convert("RGB")
diff --git a/docs/handbook/writing-your-own-image-plugin.rst b/docs/handbook/writing-your-own-image-plugin.rst
index 956d63aa771..2e853224d5a 100644
--- a/docs/handbook/writing-your-own-image-plugin.rst
+++ b/docs/handbook/writing-your-own-image-plugin.rst
@@ -53,7 +53,7 @@ true color.
     from PIL import Image, ImageFile
 
 
-    def _accept(prefix):
+    def _accept(prefix: bytes) -> bool:
         return prefix[:4] == b"SPAM"
 
 
@@ -62,7 +62,7 @@ true color.
         format = "SPAM"
         format_description = "Spam raster image"
 
-        def _open(self):
+        def _open(self) -> None:
 
             header = self.fp.read(128).split()
 
@@ -82,7 +82,7 @@ true color.
                 raise SyntaxError(msg)
 
             # data descriptor
-            self.tile = [("raw", (0, 0) + self.size, 128, (self.mode, 0, 1))]
+            self.tile = [ImageFile._Tile("raw", (0, 0) + self.size, 128, (self.mode, 0, 1))]
 
 
     Image.register_open(SpamImageFile.format, SpamImageFile, _accept)

From d5e3f6b51673564c16a8973a72a2b68e8ba96f0c Mon Sep 17 00:00:00 2001
From: Andrew Murray <radarhere@users.noreply.github.com>
Date: Thu, 15 Aug 2024 14:46:23 +1000
Subject: [PATCH 0930/1178] If left and right sides meet, do not draw rectangle
 to fill gap

---
 ...d_rectangle_joined_x_different_corners.png | Bin 0 -> 411 bytes
 Tests/test_imagedraw.py                       |  21 ++++++++++++++++++
 src/PIL/ImageDraw.py                          |   2 +-
 3 files changed, 22 insertions(+), 1 deletion(-)
 create mode 100644 Tests/images/imagedraw_rounded_rectangle_joined_x_different_corners.png

diff --git a/Tests/images/imagedraw_rounded_rectangle_joined_x_different_corners.png b/Tests/images/imagedraw_rounded_rectangle_joined_x_different_corners.png
new file mode 100644
index 0000000000000000000000000000000000000000..b225afc2dc1449375e748d59e2336eedd9ddceaf
GIT binary patch
literal 411
zcmeAS@N?(olHy`uVBq!ia0vp^DIm<j1SJ1AFflVQFeZ7rIEGZrd3)zz)?otyhKs&0
z+uzS$-hRQUCDZ!jI+@N&^L(Eawv$h$aClBq@qE1__AkTzqQ<Ru+VV}Ow8iTWx^Db5
zE7gCNwD$6KVegXf1zF~=R0}Q(`&WDVul)BtZ^FJj{k!qgcK&GTso8x~k3Zfj_4h^3
zRQAoT#<pAbKKPultz_kkE+GG^x9e%cGld%*m$ko|JN0qG?4Upy?c)dimL|Q@|MB(e
z(Nl#RZf@(^6k*BtO<UCWc){tQht}LHJEr=F@6KCYkgm8qIrX6Pnne}qxixHulRG51
zEyT6wulr`#{P3Jp532;Xfmnjhfry5U49Segm}n#r^6zHERr{EIy5&&IR6HjwnOeiR
Y?vawZ8p~E|V4yR2y85}Sb4q9e04y!3y#N3J

literal 0
HcmV?d00001

diff --git a/Tests/test_imagedraw.py b/Tests/test_imagedraw.py
index e397978cbbf..e852b847188 100644
--- a/Tests/test_imagedraw.py
+++ b/Tests/test_imagedraw.py
@@ -857,6 +857,27 @@ def test_rounded_rectangle_corners(
     )
 
 
+def test_rounded_rectangle_joined_x_different_corners() -> None:
+    # Arrange
+    im = Image.new("RGB", (W, H))
+    draw = ImageDraw.Draw(im, "RGBA")
+
+    # Act
+    draw.rounded_rectangle(
+        (20, 10, 80, 90),
+        30,
+        fill="red",
+        outline="green",
+        width=5,
+        corners=(True, False, False, False),
+    )
+
+    # Assert
+    assert_image_equal_tofile(
+        im, "Tests/images/imagedraw_rounded_rectangle_joined_x_different_corners.png"
+    )
+
+
 @pytest.mark.parametrize(
     "xy, radius, type",
     [
diff --git a/src/PIL/ImageDraw.py b/src/PIL/ImageDraw.py
index 6f56d023618..5609bf971e8 100644
--- a/src/PIL/ImageDraw.py
+++ b/src/PIL/ImageDraw.py
@@ -505,7 +505,7 @@ def draw_corners(pieslice: bool) -> None:
 
             if full_x:
                 self.draw.draw_rectangle((x0, y0 + r + 1, x1, y1 - r - 1), fill_ink, 1)
-            else:
+            elif x1 - r - 1 > x0 + r + 1:
                 self.draw.draw_rectangle((x0 + r + 1, y0, x1 - r - 1, y1), fill_ink, 1)
             if not full_x and not full_y:
                 left = [x0, y0, x0 + r, y1]

From 0a03b77daf088e2aac0e32acbbc370704c749591 Mon Sep 17 00:00:00 2001
From: Andrew Murray <radarhere@users.noreply.github.com>
Date: Fri, 16 Aug 2024 06:36:31 +1000
Subject: [PATCH 0931/1178] Update CHANGES.rst [ci skip]

---
 CHANGES.rst | 3 +++
 1 file changed, 3 insertions(+)

diff --git a/CHANGES.rst b/CHANGES.rst
index 25dcb188719..a7edc340cb6 100644
--- a/CHANGES.rst
+++ b/CHANGES.rst
@@ -5,6 +5,9 @@ Changelog (Pillow)
 11.0.0 (unreleased)
 -------------------
 
+- If left and right sides meet in ImageDraw.rounded_rectangle(), do not draw rectangle to fill gap #8304
+  [radarhere]
+
 - Remove WebP support without anim, mux/demux, and with buggy alpha #8213
   [homm, radarhere]
 

From 617699ffc76230d481d903c7a9b000d96b7e89e7 Mon Sep 17 00:00:00 2001
From: Andrew Murray <radarhere@users.noreply.github.com>
Date: Fri, 16 Aug 2024 12:03:02 +1000
Subject: [PATCH 0932/1178] Log value from tag_v2

---
 src/PIL/TiffImagePlugin.py | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/src/PIL/TiffImagePlugin.py b/src/PIL/TiffImagePlugin.py
index 2ce8a6c2a11..7bbbc832e19 100644
--- a/src/PIL/TiffImagePlugin.py
+++ b/src/PIL/TiffImagePlugin.py
@@ -1393,7 +1393,7 @@ def _setup(self) -> None:
         logger.debug("- photometric_interpretation: %s", photo)
         logger.debug("- planar_configuration: %s", self._planar_configuration)
         logger.debug("- fill_order: %s", fillorder)
-        logger.debug("- YCbCr subsampling: %s", self.tag.get(YCBCRSUBSAMPLING))
+        logger.debug("- YCbCr subsampling: %s", self.tag_v2.get(YCBCRSUBSAMPLING))
 
         # size
         xsize = int(self.tag_v2.get(IMAGEWIDTH))

From 5cb79c6a69b7d9b56607b7b7499b03c1aa434a35 Mon Sep 17 00:00:00 2001
From: Andrew Murray <radarhere@users.noreply.github.com>
Date: Fri, 16 Aug 2024 18:31:07 +1000
Subject: [PATCH 0933/1178] Check object is bytes

---
 Tests/test_imagefont.py |  3 +++
 src/_imagingft.c        | 10 ++++++++--
 2 files changed, 11 insertions(+), 2 deletions(-)

diff --git a/Tests/test_imagefont.py b/Tests/test_imagefont.py
index 340cc47420b..953706010f6 100644
--- a/Tests/test_imagefont.py
+++ b/Tests/test_imagefont.py
@@ -1113,6 +1113,9 @@ def test_bytes(font: ImageFont.FreeTypeFont) -> None:
     )
     assert font.getmask2(b"test")[1] == font.getmask2("test")[1]
 
+    with pytest.raises(TypeError):
+        font.getlength((0, 0))  # type: ignore[arg-type]
+
 
 @pytest.mark.parametrize(
     "test_file",
diff --git a/src/_imagingft.c b/src/_imagingft.c
index f8143e0cc32..5c446e641f5 100644
--- a/src/_imagingft.c
+++ b/src/_imagingft.c
@@ -272,7 +272,7 @@ text_layout_raqm(
         }
         set_text = raqm_set_text(rq, text, size);
         PyMem_Free(text);
-    } else {
+    } else if (PyBytes_Check(string)) {
         char *buffer;
         PyBytes_AsStringAndSize(string, &buffer, &size);
         if (!buffer || !size) {
@@ -281,6 +281,9 @@ text_layout_raqm(
             goto failed;
         }
         set_text = raqm_set_text_utf8(rq, buffer, size);
+    } else {
+        PyErr_SetString(PyExc_TypeError, "expected string or bytes");
+        goto failed;
     }
     if (!set_text) {
         PyErr_SetString(PyExc_ValueError, "raqm_set_text() failed");
@@ -425,8 +428,11 @@ text_layout_fallback(
 
     if (PyUnicode_Check(string)) {
         count = PyUnicode_GET_LENGTH(string);
-    } else {
+    } else if (PyBytes_Check(string)) {
         PyBytes_AsStringAndSize(string, &buffer, &count);
+    } else {
+        PyErr_SetString(PyExc_TypeError, "expected string or bytes");
+        return 0;
     }
     if (count == 0) {
         return 0;

From 6f506d2ae3879256e8a893233fc28ba6fb2518d8 Mon Sep 17 00:00:00 2001
From: Hugo van Kemenade <1324225+hugovk@users.noreply.github.com>
Date: Fri, 16 Aug 2024 14:59:46 +0300
Subject: [PATCH 0934/1178] Run all flake8-pytest-style except rules some that
 fail

---
 .pre-commit-config.yaml |  6 +++---
 pyproject.toml          | 10 +++++++++-
 2 files changed, 12 insertions(+), 4 deletions(-)

diff --git a/.pre-commit-config.yaml b/.pre-commit-config.yaml
index 74764752e80..8ab478e848a 100644
--- a/.pre-commit-config.yaml
+++ b/.pre-commit-config.yaml
@@ -1,12 +1,12 @@
 repos:
   - repo: https://github.com/astral-sh/ruff-pre-commit
-    rev: v0.5.6
+    rev: v0.6.0
     hooks:
       - id: ruff
         args: [--exit-non-zero-on-fix]
 
   - repo: https://github.com/psf/black-pre-commit-mirror
-    rev: 24.4.2
+    rev: 24.8.0
     hooks:
       - id: black
 
@@ -67,7 +67,7 @@ repos:
       - id: pyproject-fmt
 
   - repo: https://github.com/abravalheri/validate-pyproject
-    rev: v0.18
+    rev: v0.19
     hooks:
       - id: validate-pyproject
 
diff --git a/pyproject.toml b/pyproject.toml
index 8bb21019c29..d4b83ef7fd0 100644
--- a/pyproject.toml
+++ b/pyproject.toml
@@ -109,7 +109,7 @@ lint.select = [
   "ISC",    # flake8-implicit-str-concat
   "LOG",    # flake8-logging
   "PGH",    # pygrep-hooks
-  "PT006",  # pytest-parametrize-names-wrong-type
+  "PT",     # flake8-pytest-style
   "PYI",    # flake8-pyi
   "RUF100", # unused noqa (yesqa)
   "UP",     # pyupgrade
@@ -121,6 +121,14 @@ lint.ignore = [
   "E221",   # Multiple spaces before operator
   "E226",   # Missing whitespace around arithmetic operator
   "E241",   # Multiple spaces after ','
+  "PT001",  # pytest-fixture-incorrect-parentheses-style
+  "PT007",  # pytest-parametrize-values-wrong-type
+  "PT011",  # pytest-raises-too-broad
+  "PT012",  # pytest-raises-with-multiple-statements
+  "PT014",  # pytest-duplicate-parametrize-test-cases
+  "PT016",  # pytest-fail-without-message
+  "PT017",  # pytest-assert-in-except
+  "PT018",  # pytest-composite-assertion
   "PYI026", # flake8-pyi: typing.TypeAlias added in Python 3.10
   "PYI034", # flake8-pyi: typing.Self added in Python 3.11
 ]

From 5c282d02991e6bca1993c974d85dd19bce734ddd Mon Sep 17 00:00:00 2001
From: Hugo van Kemenade <1324225+hugovk@users.noreply.github.com>
Date: Fri, 16 Aug 2024 14:47:11 +0300
Subject: [PATCH 0935/1178] Fix PT014: duplicate test cases in
 pytest.mark.parametrize

---
 Tests/test_file_jpeg2k.py | 2 +-
 pyproject.toml            | 1 -
 2 files changed, 1 insertion(+), 2 deletions(-)

diff --git a/Tests/test_file_jpeg2k.py b/Tests/test_file_jpeg2k.py
index a5cfa7c6c7a..5e11465ca1d 100644
--- a/Tests/test_file_jpeg2k.py
+++ b/Tests/test_file_jpeg2k.py
@@ -233,7 +233,7 @@ def test_layers() -> None:
         ("foo.jp2", {"no_jp2": True}, 0, b"\xff\x4f"),
         ("foo.j2k", {"no_jp2": False}, 0, b"\xff\x4f"),
         ("foo.jp2", {"no_jp2": False}, 4, b"jP"),
-        ("foo.jp2", {"no_jp2": False}, 4, b"jP"),
+        (None, {"no_jp2": False}, 4, b"jP"),
     ),
 )
 def test_no_jp2(name: str, args: dict[str, bool], offset: int, data: bytes) -> None:
diff --git a/pyproject.toml b/pyproject.toml
index d4b83ef7fd0..b42ad7424a1 100644
--- a/pyproject.toml
+++ b/pyproject.toml
@@ -125,7 +125,6 @@ lint.ignore = [
   "PT007",  # pytest-parametrize-values-wrong-type
   "PT011",  # pytest-raises-too-broad
   "PT012",  # pytest-raises-with-multiple-statements
-  "PT014",  # pytest-duplicate-parametrize-test-cases
   "PT016",  # pytest-fail-without-message
   "PT017",  # pytest-assert-in-except
   "PT018",  # pytest-composite-assertion

From 5747267eb39961101d8ed6f18e77cefc1fc5c4b8 Mon Sep 17 00:00:00 2001
From: Hugo van Kemenade <1324225+hugovk@users.noreply.github.com>
Date: Fri, 16 Aug 2024 14:52:56 +0300
Subject: [PATCH 0936/1178] Fix PT018: Assert only one thing

---
 Tests/test_file_jpeg.py        | 9 ++++++---
 Tests/test_imagechops.py       | 3 ++-
 Tests/test_imagemorph.py       | 3 ++-
 Tests/test_tiff_ifdrational.py | 4 ++--
 pyproject.toml                 | 1 -
 5 files changed, 12 insertions(+), 8 deletions(-)

diff --git a/Tests/test_file_jpeg.py b/Tests/test_file_jpeg.py
index df589e24a1b..8e6221750e2 100644
--- a/Tests/test_file_jpeg.py
+++ b/Tests/test_file_jpeg.py
@@ -1019,13 +1019,16 @@ def test_separate_tables(self) -> None:
 
         # SOI, EOI
         for marker in b"\xff\xd8", b"\xff\xd9":
-            assert marker in data[1] and marker in data[2]
+            assert marker in data[1]
+            assert marker in data[2]
         # DHT, DQT
         for marker in b"\xff\xc4", b"\xff\xdb":
-            assert marker in data[1] and marker not in data[2]
+            assert marker in data[1]
+            assert marker not in data[2]
         # SOF0, SOS, APP0 (JFIF header)
         for marker in b"\xff\xc0", b"\xff\xda", b"\xff\xe0":
-            assert marker not in data[1] and marker in data[2]
+            assert marker not in data[1]
+            assert marker in data[2]
 
         with Image.open(BytesIO(data[0])) as interchange_im:
             with Image.open(BytesIO(data[1] + data[2])) as combined_im:
diff --git a/Tests/test_imagechops.py b/Tests/test_imagechops.py
index 4fc28cdb9ee..4309214f5cc 100644
--- a/Tests/test_imagechops.py
+++ b/Tests/test_imagechops.py
@@ -398,7 +398,8 @@ def table(
             for y in (a, b):
                 imy = Image.new("1", (1, 1), y)
                 value = op(imx, imy).getpixel((0, 0))
-                assert not isinstance(value, tuple) and value is not None
+                assert not isinstance(value, tuple)
+                assert value is not None
                 out.append(value)
         return out
 
diff --git a/Tests/test_imagemorph.py b/Tests/test_imagemorph.py
index 4363f456e11..80d8c38155b 100644
--- a/Tests/test_imagemorph.py
+++ b/Tests/test_imagemorph.py
@@ -46,7 +46,8 @@ def img_to_string(im: Image.Image) -> str:
         line = ""
         for c in range(im.width):
             value = im.getpixel((c, r))
-            assert not isinstance(value, tuple) and value is not None
+            assert not isinstance(value, tuple)
+            assert value is not None
             line += chars[value > 0]
         result.append(line)
     return "\n".join(result)
diff --git a/Tests/test_tiff_ifdrational.py b/Tests/test_tiff_ifdrational.py
index 9d06a933250..13f1f9c80fe 100644
--- a/Tests/test_tiff_ifdrational.py
+++ b/Tests/test_tiff_ifdrational.py
@@ -54,8 +54,8 @@ def test_nonetype() -> None:
     assert xres.denominator is not None
     assert yres._val is not None
 
-    assert xres and 1
-    assert xres and yres
+    assert xres
+    assert yres
 
 
 @pytest.mark.parametrize(
diff --git a/pyproject.toml b/pyproject.toml
index b42ad7424a1..9e53d4bfe34 100644
--- a/pyproject.toml
+++ b/pyproject.toml
@@ -127,7 +127,6 @@ lint.ignore = [
   "PT012",  # pytest-raises-with-multiple-statements
   "PT016",  # pytest-fail-without-message
   "PT017",  # pytest-assert-in-except
-  "PT018",  # pytest-composite-assertion
   "PYI026", # flake8-pyi: typing.TypeAlias added in Python 3.10
   "PYI034", # flake8-pyi: typing.Self added in Python 3.11
 ]

From f26b47595b10eaf3d781a8ea3f357f78f0a2774c Mon Sep 17 00:00:00 2001
From: Andrew Murray <radarhere@users.noreply.github.com>
Date: Mon, 19 Aug 2024 06:56:31 +1000
Subject: [PATCH 0937/1178] Get IPTC info from tag_v2

---
 Tests/test_file_iptc.py    | 10 ++++++++++
 src/PIL/IptcImagePlugin.py |  2 +-
 2 files changed, 11 insertions(+), 1 deletion(-)

diff --git a/Tests/test_file_iptc.py b/Tests/test_file_iptc.py
index b0ea2bf4282..8a7c59fb150 100644
--- a/Tests/test_file_iptc.py
+++ b/Tests/test_file_iptc.py
@@ -77,6 +77,16 @@ def test_getiptcinfo_zero_padding() -> None:
     assert len(iptc) == 3
 
 
+def test_getiptcinfo_tiff() -> None:
+    # Arrange
+    with Image.open("Tests/images/hopper.Lab.tif") as im:
+        # Act
+        iptc = IptcImagePlugin.getiptcinfo(im)
+
+    # Assert
+    assert iptc == {(1, 90): b"\x1b%G", (2, 0): b"\xcf\xc0"}
+
+
 def test_getiptcinfo_tiff_none() -> None:
     # Arrange
     with Image.open("Tests/images/hopper.tif") as im:
diff --git a/src/PIL/IptcImagePlugin.py b/src/PIL/IptcImagePlugin.py
index 17243e705c1..153243519de 100644
--- a/src/PIL/IptcImagePlugin.py
+++ b/src/PIL/IptcImagePlugin.py
@@ -213,7 +213,7 @@ def getiptcinfo(
         # get raw data from the IPTC/NAA tag (PhotoShop tags the data
         # as 4-byte integers, so we cannot use the get method...)
         try:
-            data = im.tag.tagdata[TiffImagePlugin.IPTC_NAA_CHUNK]
+            data = im.tag_v2[TiffImagePlugin.IPTC_NAA_CHUNK]
         except (AttributeError, KeyError):
             pass
 

From cd76b4853319619a0cb9726dcd7907551794f049 Mon Sep 17 00:00:00 2001
From: Yay295 <Yay295@users.noreply.github.com>
Date: Fri, 16 Aug 2024 09:08:18 -0500
Subject: [PATCH 0938/1178] move repeated code to private helper function

---
 src/PIL/TiffImagePlugin.py | 26 +++++++++++---------------
 1 file changed, 11 insertions(+), 15 deletions(-)

diff --git a/src/PIL/TiffImagePlugin.py b/src/PIL/TiffImagePlugin.py
index deae199d50e..7dda413e6ac 100644
--- a/src/PIL/TiffImagePlugin.py
+++ b/src/PIL/TiffImagePlugin.py
@@ -2080,38 +2080,34 @@ def readLong(self) -> int:
         (value,) = struct.unpack(self.longFmt, self.f.read(4))
         return value
 
+    @staticmethod
+    def _verify_bytes_written(bytes_written: int | None, expected: int) -> None:
+        if bytes_written is not None and bytes_written != expected:
+            msg = f"wrote only {bytes_written} bytes but wanted {expected}"
+            raise RuntimeError(msg)
+
     def rewriteLastShortToLong(self, value: int) -> None:
         self.f.seek(-2, os.SEEK_CUR)
         bytes_written = self.f.write(struct.pack(self.longFmt, value))
-        if bytes_written is not None and bytes_written != 4:
-            msg = f"wrote only {bytes_written} bytes but wanted 4"
-            raise RuntimeError(msg)
+        self._verify_bytes_written(bytes_written, 4)
 
     def rewriteLastShort(self, value: int) -> None:
         self.f.seek(-2, os.SEEK_CUR)
         bytes_written = self.f.write(struct.pack(self.shortFmt, value))
-        if bytes_written is not None and bytes_written != 2:
-            msg = f"wrote only {bytes_written} bytes but wanted 2"
-            raise RuntimeError(msg)
+        self._verify_bytes_written(bytes_written, 2)
 
     def rewriteLastLong(self, value: int) -> None:
         self.f.seek(-4, os.SEEK_CUR)
         bytes_written = self.f.write(struct.pack(self.longFmt, value))
-        if bytes_written is not None and bytes_written != 4:
-            msg = f"wrote only {bytes_written} bytes but wanted 4"
-            raise RuntimeError(msg)
+        self._verify_bytes_written(bytes_written, 4)
 
     def writeShort(self, value: int) -> None:
         bytes_written = self.f.write(struct.pack(self.shortFmt, value))
-        if bytes_written is not None and bytes_written != 2:
-            msg = f"wrote only {bytes_written} bytes but wanted 2"
-            raise RuntimeError(msg)
+        self._verify_bytes_written(bytes_written, 2)
 
     def writeLong(self, value: int) -> None:
         bytes_written = self.f.write(struct.pack(self.longFmt, value))
-        if bytes_written is not None and bytes_written != 4:
-            msg = f"wrote only {bytes_written} bytes but wanted 4"
-            raise RuntimeError(msg)
+        self._verify_bytes_written(bytes_written, 4)
 
     def close(self) -> None:
         self.finalize()

From 2467369c134a882473e46928eac952d7fab5f7a4 Mon Sep 17 00:00:00 2001
From: Andrew Murray <radarhere@users.noreply.github.com>
Date: Mon, 19 Aug 2024 20:50:45 +1000
Subject: [PATCH 0939/1178] Uninstall gradle and maven on macOS 13

---
 .github/workflows/macos-install.sh | 3 +++
 1 file changed, 3 insertions(+)

diff --git a/.github/workflows/macos-install.sh b/.github/workflows/macos-install.sh
index d35cfcd3124..25943776f10 100755
--- a/.github/workflows/macos-install.sh
+++ b/.github/workflows/macos-install.sh
@@ -2,6 +2,9 @@
 
 set -e
 
+if [[ "$ImageOS" == "macos13" ]]; then
+    brew uninstall gradle maven
+fi
 brew install \
     freetype \
     ghostscript \

From d1d567bb59886f15e91522d937e5399395158692 Mon Sep 17 00:00:00 2001
From: Andrew Murray <radarhere@users.noreply.github.com>
Date: Mon, 19 Aug 2024 08:47:35 +1000
Subject: [PATCH 0940/1178] Do not use sys.stdout in PSDraw

---
 Tests/test_psdraw.py | 11 +++--------
 src/PIL/PSDraw.py    | 11 ++++-------
 2 files changed, 7 insertions(+), 15 deletions(-)

diff --git a/Tests/test_psdraw.py b/Tests/test_psdraw.py
index c3afa908937..a743d831f5a 100644
--- a/Tests/test_psdraw.py
+++ b/Tests/test_psdraw.py
@@ -5,8 +5,6 @@
 from io import BytesIO
 from pathlib import Path
 
-import pytest
-
 from PIL import Image, PSDraw
 
 
@@ -49,15 +47,14 @@ def test_draw_postscript(tmp_path: Path) -> None:
     assert os.path.getsize(tempfile) > 0
 
 
-@pytest.mark.parametrize("buffer", (True, False))
-def test_stdout(buffer: bool) -> None:
+def test_stdout() -> None:
     # Temporarily redirect stdout
     old_stdout = sys.stdout
 
     class MyStdOut:
         buffer = BytesIO()
 
-    mystdout: MyStdOut | BytesIO = MyStdOut() if buffer else BytesIO()
+    mystdout = MyStdOut()
 
     sys.stdout = mystdout
 
@@ -67,6 +64,4 @@ class MyStdOut:
     # Reset stdout
     sys.stdout = old_stdout
 
-    if isinstance(mystdout, MyStdOut):
-        mystdout = mystdout.buffer
-    assert mystdout.getvalue() != b""
+    assert mystdout.buffer.getvalue() != b""
diff --git a/src/PIL/PSDraw.py b/src/PIL/PSDraw.py
index 673eae1d12c..02939d26b5f 100644
--- a/src/PIL/PSDraw.py
+++ b/src/PIL/PSDraw.py
@@ -17,7 +17,7 @@
 from __future__ import annotations
 
 import sys
-from typing import TYPE_CHECKING
+from typing import IO, TYPE_CHECKING
 
 from . import EpsImagePlugin
 
@@ -28,15 +28,12 @@
 class PSDraw:
     """
     Sets up printing to the given file. If ``fp`` is omitted,
-    ``sys.stdout.buffer`` or ``sys.stdout`` is assumed.
+    ``sys.stdout.buffer`` is assumed.
     """
 
-    def __init__(self, fp=None):
+    def __init__(self, fp: IO[bytes] | None = None) -> None:
         if not fp:
-            try:
-                fp = sys.stdout.buffer
-            except AttributeError:
-                fp = sys.stdout
+            fp = sys.stdout.buffer
         self.fp = fp
 
     def begin_document(self, id: str | None = None) -> None:

From 2ed8502d12a0f0efd7d4cd2c65b4c6a7e59aaa2a Mon Sep 17 00:00:00 2001
From: Andrew Murray <radarhere@users.noreply.github.com>
Date: Mon, 19 Aug 2024 22:55:07 +1000
Subject: [PATCH 0941/1178] Use ipython PrettyPrinter, rather than custom class

---
 .appveyor.yml                      |  2 +-
 .ci/install.sh                     |  1 +
 .github/workflows/macos-install.sh |  1 +
 .github/workflows/test-cygwin.yml  |  1 +
 Tests/test_image.py                | 17 +++++++++++------
 src/PIL/Image.py                   |  4 +++-
 6 files changed, 18 insertions(+), 8 deletions(-)

diff --git a/.appveyor.yml b/.appveyor.yml
index e12987a5fa7..f490561cdcd 100644
--- a/.appveyor.yml
+++ b/.appveyor.yml
@@ -51,7 +51,7 @@ build_script:
 
 test_script:
 - cd c:\pillow
-- '%PYTHON%\%EXECUTABLE% -m pip install pytest pytest-cov pytest-timeout defusedxml numpy olefile pyroma'
+- '%PYTHON%\%EXECUTABLE% -m pip install pytest pytest-cov pytest-timeout defusedxml ipython numpy olefile pyroma'
 - c:\"Program Files (x86)"\"Windows Kits"\10\Debuggers\x86\gflags.exe /p /enable %PYTHON%\%EXECUTABLE%
 - '%PYTHON%\%EXECUTABLE% -c "from PIL import Image"'
 - '%PYTHON%\%EXECUTABLE% -m pytest -vx --cov PIL --cov Tests --cov-report term --cov-report xml Tests'
diff --git a/.ci/install.sh b/.ci/install.sh
index 8e65f64c447..b2d61586695 100755
--- a/.ci/install.sh
+++ b/.ci/install.sh
@@ -30,6 +30,7 @@ python3 -m pip install --upgrade pip
 python3 -m pip install --upgrade wheel
 python3 -m pip install coverage
 python3 -m pip install defusedxml
+python3 -m pip install ipython
 python3 -m pip install olefile
 python3 -m pip install -U pytest
 python3 -m pip install -U pytest-cov
diff --git a/.github/workflows/macos-install.sh b/.github/workflows/macos-install.sh
index 25943776f10..ddb4212301d 100755
--- a/.github/workflows/macos-install.sh
+++ b/.github/workflows/macos-install.sh
@@ -23,6 +23,7 @@ export PKG_CONFIG_PATH="/usr/local/opt/openblas/lib/pkgconfig"
 
 python3 -m pip install coverage
 python3 -m pip install defusedxml
+python3 -m pip install ipython
 python3 -m pip install olefile
 python3 -m pip install -U pytest
 python3 -m pip install -U pytest-cov
diff --git a/.github/workflows/test-cygwin.yml b/.github/workflows/test-cygwin.yml
index 8e282709917..0aa79e4235a 100644
--- a/.github/workflows/test-cygwin.yml
+++ b/.github/workflows/test-cygwin.yml
@@ -74,6 +74,7 @@ jobs:
             perl
             python3${{ matrix.python-minor-version }}-cython
             python3${{ matrix.python-minor-version }}-devel
+            python3${{ matrix.python-minor-version }}-ipython
             python3${{ matrix.python-minor-version }}-numpy
             python3${{ matrix.python-minor-version }}-sip
             python3${{ matrix.python-minor-version }}-tkinter
diff --git a/Tests/test_image.py b/Tests/test_image.py
index 719732d127b..2afcf2efd72 100644
--- a/Tests/test_image.py
+++ b/Tests/test_image.py
@@ -42,6 +42,12 @@
 except ImportError:
     ElementTree = None
 
+PrettyPrinter: type | None
+try:
+    from IPython.lib.pretty import PrettyPrinter
+except ImportError:
+    PrettyPrinter = None
+
 
 # Deprecation helper
 def helper_image_new(mode: str, size: tuple[int, int]) -> Image.Image:
@@ -91,16 +97,15 @@ def test_sanity(self) -> None:
         # with pytest.raises(MemoryError):
         #   Image.new("L", (1000000, 1000000))
 
+    @pytest.mark.skipif(PrettyPrinter is None, reason="IPython is not installed")
     def test_repr_pretty(self) -> None:
-        class Pretty:
-            def text(self, text: str) -> None:
-                self.pretty_output = text
-
         im = Image.new("L", (100, 100))
 
-        p = Pretty()
+        output = io.StringIO()
+        assert PrettyPrinter is not None
+        p = PrettyPrinter(output)
         im._repr_pretty_(p, False)
-        assert p.pretty_output == "<PIL.Image.Image image mode=L size=100x100>"
+        assert output.getvalue() == "<PIL.Image.Image image mode=L size=100x100>"
 
     def test_open_formats(self) -> None:
         PNGFILE = "Tests/images/hopper.png"
diff --git a/src/PIL/Image.py b/src/PIL/Image.py
index a6eefff56fc..705d0a14438 100644
--- a/src/PIL/Image.py
+++ b/src/PIL/Image.py
@@ -221,6 +221,8 @@ class Quantize(IntEnum):
     import mmap
     from xml.etree.ElementTree import Element
 
+    from IPython.lib.pretty import PrettyPrinter
+
     from . import ImageFile, ImageFilter, ImagePalette, TiffImagePlugin
     from ._typing import NumpyArray, StrOrBytesPath, TypeGuard
 ID: list[str] = []
@@ -677,7 +679,7 @@ def __repr__(self) -> str:
             id(self),
         )
 
-    def _repr_pretty_(self, p, cycle: bool) -> None:
+    def _repr_pretty_(self, p: PrettyPrinter, cycle: bool) -> None:
         """IPython plain text display support"""
 
         # Same as __repr__ but without unpredictable id(self),

From e6e5ef5c5fbd83ac5dd63301e4d7d6860a7b2d09 Mon Sep 17 00:00:00 2001
From: Andrew Murray <radarhere@users.noreply.github.com>
Date: Wed, 21 Aug 2024 08:05:02 +1000
Subject: [PATCH 0942/1178] Added type hints

---
 Tests/test_file_tiff.py    |  7 +++++
 Tests/test_imagefile.py    |  3 +-
 docs/reference/Image.rst   |  1 +
 src/PIL/IcoImagePlugin.py  |  4 +--
 src/PIL/Image.py           | 42 ++++++++++++++++++---------
 src/PIL/ImageFile.py       |  8 ++++--
 src/PIL/IptcImagePlugin.py |  2 +-
 src/PIL/TiffImagePlugin.py | 59 ++++++++++++++++++++++----------------
 8 files changed, 80 insertions(+), 46 deletions(-)

diff --git a/Tests/test_file_tiff.py b/Tests/test_file_tiff.py
index 8cad252724c..190f83f40fc 100644
--- a/Tests/test_file_tiff.py
+++ b/Tests/test_file_tiff.py
@@ -684,6 +684,13 @@ def test_planar_configuration_save(self, tmp_path: Path) -> None:
             with Image.open(outfile) as reloaded:
                 assert_image_equal_tofile(reloaded, infile)
 
+    def test_invalid_tiled_dimensions(self) -> None:
+        with open("Tests/images/tiff_tiled_planar_raw.tif", "rb") as fp:
+            data = fp.read()
+        b = BytesIO(data[:144] + b"\x02" + data[145:])
+        with pytest.raises(ValueError):
+            Image.open(b)
+
     @pytest.mark.parametrize("mode", ("P", "PA"))
     def test_palette(self, mode: str, tmp_path: Path) -> None:
         outfile = str(tmp_path / "temp.tif")
diff --git a/Tests/test_imagefile.py b/Tests/test_imagefile.py
index 95e91db839f..a8bd798c12d 100644
--- a/Tests/test_imagefile.py
+++ b/Tests/test_imagefile.py
@@ -412,9 +412,8 @@ def test_encode(self) -> None:
         with pytest.raises(NotImplementedError):
             encoder.encode_to_pyfd()
 
-        fh = BytesIO()
         with pytest.raises(NotImplementedError):
-            encoder.encode_to_file(fh, 0)
+            encoder.encode_to_file(0, 0)
 
     def test_zero_height(self) -> None:
         with pytest.raises(UnidentifiedImageError):
diff --git a/docs/reference/Image.rst b/docs/reference/Image.rst
index 66c5e5422da..02e714f20b8 100644
--- a/docs/reference/Image.rst
+++ b/docs/reference/Image.rst
@@ -363,6 +363,7 @@ Classes
     :show-inheritance:
 .. autoclass:: PIL.Image.ImagePointHandler
 .. autoclass:: PIL.Image.ImageTransformHandler
+.. autoclass:: PIL.Image._E
 
 Protocols
 ---------
diff --git a/src/PIL/IcoImagePlugin.py b/src/PIL/IcoImagePlugin.py
index 3bf5d9c0464..92656249716 100644
--- a/src/PIL/IcoImagePlugin.py
+++ b/src/PIL/IcoImagePlugin.py
@@ -319,11 +319,11 @@ def _open(self) -> None:
         self.load()
 
     @property
-    def size(self):
+    def size(self) -> tuple[int, int]:
         return self._size
 
     @size.setter
-    def size(self, value):
+    def size(self, value: tuple[int, int]) -> None:
         if value not in self.info["sizes"]:
             msg = "This is not one of the allowed sizes of this image"
             raise ValueError(msg)
diff --git a/src/PIL/Image.py b/src/PIL/Image.py
index 705d0a14438..ffc6bec342a 100644
--- a/src/PIL/Image.py
+++ b/src/PIL/Image.py
@@ -504,7 +504,7 @@ def __truediv__(self, other: _E | float) -> _E:
         return _E(self.scale / other, self.offset / other)
 
 
-def _getscaleoffset(expr) -> tuple[float, float]:
+def _getscaleoffset(expr: Callable[[_E], _E | float]) -> tuple[float, float]:
     a = expr(_E(1, 0))
     return (a.scale, a.offset) if isinstance(a, _E) else (0, a)
 
@@ -1894,7 +1894,13 @@ def alpha_composite(
 
     def point(
         self,
-        lut: Sequence[float] | NumpyArray | Callable[[int], float] | ImagePointHandler,
+        lut: (
+            Sequence[float]
+            | NumpyArray
+            | Callable[[int], float]
+            | Callable[[_E], _E | float]
+            | ImagePointHandler
+        ),
         mode: str | None = None,
     ) -> Image:
         """
@@ -1930,10 +1936,10 @@ def point(self, data):
                 # check if the function can be used with point_transform
                 # UNDONE wiredfool -- I think this prevents us from ever doing
                 # a gamma function point transform on > 8bit images.
-                scale, offset = _getscaleoffset(lut)
+                scale, offset = _getscaleoffset(lut)  # type: ignore[arg-type]
                 return self._new(self.im.point_transform(scale, offset))
             # for other modes, convert the function to a table
-            flatLut = [lut(i) for i in range(256)] * self.im.bands
+            flatLut = [lut(i) for i in range(256)] * self.im.bands  # type: ignore[arg-type]
         else:
             flatLut = lut
 
@@ -2869,11 +2875,11 @@ def __transformer(
         self,
         box: tuple[int, int, int, int],
         image: Image,
-        method,
-        data,
+        method: Transform,
+        data: Sequence[float],
         resample: int = Resampling.NEAREST,
         fill: bool = True,
-    ):
+    ) -> None:
         w = box[2] - box[0]
         h = box[3] - box[1]
 
@@ -4008,15 +4014,19 @@ def tobytes(self, offset: int = 8) -> bytes:
             ifd[tag] = value
         return b"Exif\x00\x00" + head + ifd.tobytes(offset)
 
-    def get_ifd(self, tag):
+    def get_ifd(self, tag: int) -> dict[int, Any]:
         if tag not in self._ifds:
             if tag == ExifTags.IFD.IFD1:
                 if self._info is not None and self._info.next != 0:
-                    self._ifds[tag] = self._get_ifd_dict(self._info.next)
+                    ifd = self._get_ifd_dict(self._info.next)
+                    if ifd is not None:
+                        self._ifds[tag] = ifd
             elif tag in [ExifTags.IFD.Exif, ExifTags.IFD.GPSInfo]:
                 offset = self._hidden_data.get(tag, self.get(tag))
                 if offset is not None:
-                    self._ifds[tag] = self._get_ifd_dict(offset, tag)
+                    ifd = self._get_ifd_dict(offset, tag)
+                    if ifd is not None:
+                        self._ifds[tag] = ifd
             elif tag in [ExifTags.IFD.Interop, ExifTags.IFD.Makernote]:
                 if ExifTags.IFD.Exif not in self._ifds:
                     self.get_ifd(ExifTags.IFD.Exif)
@@ -4073,7 +4083,9 @@ def get_ifd(self, tag):
                                 (offset,) = struct.unpack(">L", data)
                                 self.fp.seek(offset)
 
-                                camerainfo = {"ModelID": self.fp.read(4)}
+                                camerainfo: dict[str, int | bytes] = {
+                                    "ModelID": self.fp.read(4)
+                                }
 
                                 self.fp.read(4)
                                 # Seconds since 2000
@@ -4089,16 +4101,18 @@ def get_ifd(self, tag):
                                 ][1]
                                 camerainfo["Parallax"] = handler(
                                     ImageFileDirectory_v2(), parallax, False
-                                )
+                                )[0]
 
                                 self.fp.read(4)
                                 camerainfo["Category"] = self.fp.read(2)
 
-                                makernote = {0x1101: dict(self._fixup_dict(camerainfo))}
+                                makernote = {0x1101: camerainfo}
                         self._ifds[tag] = makernote
                 else:
                     # Interop
-                    self._ifds[tag] = self._get_ifd_dict(tag_data, tag)
+                    ifd = self._get_ifd_dict(tag_data, tag)
+                    if ifd is not None:
+                        self._ifds[tag] = ifd
         ifd = self._ifds.get(tag, {})
         if tag == ExifTags.IFD.Exif and self._hidden_data:
             ifd = {
diff --git a/src/PIL/ImageFile.py b/src/PIL/ImageFile.py
index 73554fa53e3..fdeb81d7a10 100644
--- a/src/PIL/ImageFile.py
+++ b/src/PIL/ImageFile.py
@@ -31,6 +31,7 @@
 import abc
 import io
 import itertools
+import os
 import struct
 import sys
 from typing import IO, Any, NamedTuple
@@ -555,7 +556,7 @@ def _encode_tile(
     fp: IO[bytes],
     tile: list[_Tile],
     bufsize: int,
-    fh,
+    fh: int | None,
     exc: BaseException | None = None,
 ) -> None:
     for encoder_name, extents, offset, args in tile:
@@ -577,6 +578,7 @@ def _encode_tile(
                             break
                 else:
                     # slight speedup: compress to real file object
+                    assert fh is not None
                     errcode = encoder.encode_to_file(fh, bufsize)
             if errcode < 0:
                 raise _get_oserror(errcode, encoder=True) from exc
@@ -801,7 +803,7 @@ def encode_to_pyfd(self) -> tuple[int, int]:
             self.fd.write(data)
         return bytes_consumed, errcode
 
-    def encode_to_file(self, fh: IO[bytes], bufsize: int) -> int:
+    def encode_to_file(self, fh: int, bufsize: int) -> int:
         """
         :param fh: File handle.
         :param bufsize: Buffer size.
@@ -814,5 +816,5 @@ def encode_to_file(self, fh: IO[bytes], bufsize: int) -> int:
         while errcode == 0:
             status, errcode, buf = self.encode(bufsize)
             if status > 0:
-                fh.write(buf[status:])
+                os.write(fh, buf[status:])
         return errcode
diff --git a/src/PIL/IptcImagePlugin.py b/src/PIL/IptcImagePlugin.py
index 153243519de..6ccf28aa1dd 100644
--- a/src/PIL/IptcImagePlugin.py
+++ b/src/PIL/IptcImagePlugin.py
@@ -214,7 +214,7 @@ def getiptcinfo(
         # as 4-byte integers, so we cannot use the get method...)
         try:
             data = im.tag_v2[TiffImagePlugin.IPTC_NAA_CHUNK]
-        except (AttributeError, KeyError):
+        except KeyError:
             pass
 
     if data is None:
diff --git a/src/PIL/TiffImagePlugin.py b/src/PIL/TiffImagePlugin.py
index 7bbbc832e19..5c6996a652c 100644
--- a/src/PIL/TiffImagePlugin.py
+++ b/src/PIL/TiffImagePlugin.py
@@ -624,12 +624,12 @@ def reset(self) -> None:
         self._tagdata: dict[int, bytes] = {}
         self.tagtype = {}  # added 2008-06-05 by Florian Hoech
         self._next = None
-        self._offset = None
+        self._offset: int | None = None
 
     def __str__(self) -> str:
         return str(dict(self))
 
-    def named(self):
+    def named(self) -> dict[str, Any]:
         """
         :returns: dict of name|key: value
 
@@ -643,7 +643,7 @@ def named(self):
     def __len__(self) -> int:
         return len(set(self._tagdata) | set(self._tags_v2))
 
-    def __getitem__(self, tag):
+    def __getitem__(self, tag: int) -> Any:
         if tag not in self._tags_v2:  # unpack on the fly
             data = self._tagdata[tag]
             typ = self.tagtype[tag]
@@ -855,7 +855,7 @@ def _ensure_read(self, fp: IO[bytes], size: int) -> bytes:
             raise OSError(msg)
         return ret
 
-    def load(self, fp):
+    def load(self, fp: IO[bytes]) -> None:
         self.reset()
         self._offset = fp.tell()
 
@@ -1098,7 +1098,7 @@ def __setitem__(self, tag: int, value: Any) -> None:
         for legacy_api in (False, True):
             self._setitem(tag, value, legacy_api)
 
-    def __getitem__(self, tag):
+    def __getitem__(self, tag: int) -> Any:
         if tag not in self._tags_v1:  # unpack on the fly
             data = self._tagdata[tag]
             typ = self.tagtype[tag]
@@ -1124,11 +1124,15 @@ class TiffImageFile(ImageFile.ImageFile):
     format_description = "Adobe TIFF"
     _close_exclusive_fp_after_loading = False
 
-    def __init__(self, fp=None, filename=None):
-        self.tag_v2 = None
+    def __init__(
+        self,
+        fp: StrOrBytesPath | IO[bytes] | None = None,
+        filename: str | bytes | None = None,
+    ) -> None:
+        self.tag_v2: ImageFileDirectory_v2
         """ Image file directory (tag dictionary) """
 
-        self.tag = None
+        self.tag: ImageFileDirectory_v1
         """ Legacy tag entries """
 
         super().__init__(fp, filename)
@@ -1143,9 +1147,6 @@ def _open(self) -> None:
 
         self.tag_v2 = ImageFileDirectory_v2(ifh)
 
-        # legacy IFD entries will be filled in later
-        self.ifd: ImageFileDirectory_v1 | None = None
-
         # setup frame pointers
         self.__first = self.__next = self.tag_v2.next
         self.__frame = -1
@@ -1396,8 +1397,11 @@ def _setup(self) -> None:
         logger.debug("- YCbCr subsampling: %s", self.tag_v2.get(YCBCRSUBSAMPLING))
 
         # size
-        xsize = int(self.tag_v2.get(IMAGEWIDTH))
-        ysize = int(self.tag_v2.get(IMAGELENGTH))
+        xsize = self.tag_v2.get(IMAGEWIDTH)
+        ysize = self.tag_v2.get(IMAGELENGTH)
+        if not isinstance(xsize, int) or not isinstance(ysize, int):
+            msg = "Invalid dimensions"
+            raise ValueError(msg)
         self._size = xsize, ysize
 
         logger.debug("- size: %s", self.size)
@@ -1545,8 +1549,12 @@ def _setup(self) -> None:
             else:
                 # tiled image
                 offsets = self.tag_v2[TILEOFFSETS]
-                w = self.tag_v2.get(TILEWIDTH)
+                tilewidth = self.tag_v2.get(TILEWIDTH)
                 h = self.tag_v2.get(TILELENGTH)
+                if not isinstance(tilewidth, int) or not isinstance(h, int):
+                    msg = "Invalid tile dimensions"
+                    raise ValueError(msg)
+                w = tilewidth
 
             for offset in offsets:
                 if x + w > xsize:
@@ -1624,7 +1632,7 @@ def _setup(self) -> None:
 }
 
 
-def _save(im, fp, filename):
+def _save(im: Image.Image, fp, filename: str | bytes) -> None:
     try:
         rawmode, prefix, photo, format, bits, extra = SAVE_INFO[im.mode]
     except KeyError as e:
@@ -1760,10 +1768,11 @@ def _save(im, fp, filename):
         if im.mode == "1":
             inverted_im = im.copy()
             px = inverted_im.load()
-            for y in range(inverted_im.height):
-                for x in range(inverted_im.width):
-                    px[x, y] = 0 if px[x, y] == 255 else 255
-            im = inverted_im
+            if px is not None:
+                for y in range(inverted_im.height):
+                    for x in range(inverted_im.width):
+                        px[x, y] = 0 if px[x, y] == 255 else 255
+                im = inverted_im
         else:
             im = ImageOps.invert(im)
 
@@ -1805,11 +1814,11 @@ def _save(im, fp, filename):
     ifd[COMPRESSION] = COMPRESSION_INFO_REV.get(compression, 1)
 
     if im.mode == "YCbCr":
-        for tag, value in {
+        for tag, default_value in {
             YCBCRSUBSAMPLING: (1, 1),
             REFERENCEBLACKWHITE: (0, 255, 128, 255, 128, 255),
         }.items():
-            ifd.setdefault(tag, value)
+            ifd.setdefault(tag, default_value)
 
     blocklist = [TILEWIDTH, TILELENGTH, TILEOFFSETS, TILEBYTECOUNTS]
     if libtiff:
@@ -1852,7 +1861,7 @@ def _save(im, fp, filename):
         ]
 
         # bits per sample is a single short in the tiff directory, not a list.
-        atts = {BITSPERSAMPLE: bits[0]}
+        atts: dict[int, Any] = {BITSPERSAMPLE: bits[0]}
         # Merge the ones that we have with (optional) more bits from
         # the original file, e.g x,y resolution so that we can
         # save(load('')) == original file.
@@ -1923,13 +1932,15 @@ def _save(im, fp, filename):
         offset = ifd.save(fp)
 
         ImageFile._save(
-            im, fp, [("raw", (0, 0) + im.size, offset, (rawmode, stride, 1))]
+            im,
+            fp,
+            [ImageFile._Tile("raw", (0, 0) + im.size, offset, (rawmode, stride, 1))],
         )
 
     # -- helper for multi-page save --
     if "_debug_multipage" in encoderinfo:
         # just to access o32 and o16 (using correct byte order)
-        im._debug_multipage = ifd
+        setattr(im, "_debug_multipage", ifd)
 
 
 class AppendingTiffWriter:

From 388fc78e36e60f45a9b5ff0cd3223e3b8bc2c307 Mon Sep 17 00:00:00 2001
From: Jeffrey 'Alex' Clark <aclark@aclark.net>
Date: Wed, 21 Aug 2024 15:32:06 -0400
Subject: [PATCH 0943/1178] Add/update project-makefile files

---
 Makefile | 4781 ++++++++++++++++++++++++++++++++++++++++++++++++++++--
 1 file changed, 4656 insertions(+), 125 deletions(-)

diff --git a/Makefile b/Makefile
index 94f7565d826..4200f95dafd 100644
--- a/Makefile
+++ b/Makefile
@@ -1,125 +1,4656 @@
-.DEFAULT_GOAL := help
-
-.PHONY: clean
-clean:
-	rm src/PIL/*.so || true
-	rm -r build || true
-	find . -name __pycache__ | xargs rm -r || true
-
-.PHONY: coverage
-coverage:
-	python3 -c "import pytest" > /dev/null 2>&1 || python3 -m pip install pytest
-	python3 -m pytest -qq
-	rm -r htmlcov || true
-	python3 -c "import coverage" > /dev/null 2>&1 || python3 -m pip install coverage
-	python3 -m coverage report
-
-.PHONY: doc
-.PHONY: html
-doc html:
-	python3 -c "import PIL" > /dev/null 2>&1 || python3 -m pip install .
-	$(MAKE) -C docs html
-
-.PHONY: htmlview
-htmlview:
-	python3 -c "import PIL" > /dev/null 2>&1 || python3 -m pip install .
-	$(MAKE) -C docs htmlview
-
-.PHONY: doccheck
-doccheck:
-	$(MAKE) doc
-# Don't make our tests rely on the links in the docs being up every single build.
-# We don't control them.  But do check, and update them to the target of their redirects.
-	$(MAKE) -C docs linkcheck || true
-
-.PHONY: docserve
-docserve:
-	cd docs/_build/html && python3 -m http.server 2> /dev/null&
-
-.PHONY: help
-help:
-	@echo "Welcome to Pillow development. Please use \`make <target>\` where <target> is one of"
-	@echo "  clean              remove build products"
-	@echo "  coverage           run coverage test (in progress)"
-	@echo "  doc                make HTML docs"
-	@echo "  docserve           run an HTTP server on the docs directory"
-	@echo "  html               make HTML docs"
-	@echo "  htmlview           open the index page built by the html target in your browser"
-	@echo "  install            make and install"
-	@echo "  install-coverage   make and install with C coverage"
-	@echo "  lint               run the lint checks"
-	@echo "  lint-fix           run Ruff to (mostly) fix lint issues"
-	@echo "  release-test       run code and package tests before release"
-	@echo "  test               run tests on installed Pillow"
-
-.PHONY: install
-install:
-	python3 -m pip -v install .
-	python3 selftest.py
-
-.PHONY: install-coverage
-install-coverage:
-	CFLAGS="-coverage -Werror=implicit-function-declaration" python3 -m pip -v install .
-	python3 selftest.py
-
-.PHONY: debug
-debug:
-# make a debug version if we don't have a -dbg python. Leaves in symbols
-# for our stuff, kills optimization, and redirects to dev null so we
-# see any build failures.
-	make clean > /dev/null
-	CFLAGS='-g -O0' python3 -m pip -v install . > /dev/null
-
-.PHONY: release-test
-release-test:
-	python3 Tests/check_release_notes.py
-	python3 -m pip install -e .[tests]
-	python3 selftest.py
-	python3 -m pytest Tests
-	python3 -m pip install .
-	python3 -m pytest -qq
-	python3 -m check_manifest
-	python3 -m pyroma .
-	$(MAKE) readme
-
-.PHONY: sdist
-sdist:
-	python3 -m build --help > /dev/null 2>&1 || python3 -m pip install build
-	python3 -m build --sdist
-	python3 -m twine --help > /dev/null 2>&1 || python3 -m pip install twine
-	python3 -m twine check --strict dist/*
-
-.PHONY: test
-test:
-	python3 -c "import pytest" > /dev/null 2>&1 || python3 -m pip install pytest
-	python3 -m pytest -qq
-
-.PHONY: valgrind
-valgrind:
-	python3 -c "import pytest_valgrind" > /dev/null 2>&1 || python3 -m pip install pytest-valgrind
-	PYTHONMALLOC=malloc valgrind --suppressions=Tests/oss-fuzz/python.supp --leak-check=no \
-            --log-file=/tmp/valgrind-output \
-            python3 -m pytest --no-memcheck -vv --valgrind --valgrind-log=/tmp/valgrind-output
-
-.PHONY: readme
-readme:
-	python3 -c "import markdown2" > /dev/null 2>&1 || python3 -m pip install markdown2
-	python3 -m markdown2 README.md > .long-description.html && open .long-description.html
-
-
-.PHONY: lint
-lint:
-	python3 -c "import tox" > /dev/null 2>&1 || python3 -m pip install tox
-	python3 -m tox -e lint
-
-.PHONY: lint-fix
-lint-fix:
-	python3 -c "import black" > /dev/null 2>&1 || python3 -m pip install black
-	python3 -m black .
-	python3 -c "import ruff" > /dev/null 2>&1 || python3 -m pip install ruff
-	python3 -m ruff --fix .
-
-.PHONY: mypy
-mypy:
-	python3 -c "import tox" > /dev/null 2>&1 || python3 -m pip install tox
-	python3 -m tox -e mypy
+# Project Makefile
+#
+# A makefile to automate setup of a Wagtail CMS project and related tasks.
+#
+# https://github.com/aclark4life/project-makefile
+#
+# --------------------------------------------------------------------------------
+# Set the default goal to be `git commit -a -m $(GIT_MESSAGE)` and `git push`
+# --------------------------------------------------------------------------------
+
+.DEFAULT_GOAL := git-commit
+
+# --------------------------------------------------------------------------------
+# Single line variables to be used by phony target rules
+# --------------------------------------------------------------------------------
+
+ADD_DIR := mkdir -pv
+ADD_FILE := touch
+AWS_OPTS := --no-cli-pager --output table
+COPY_DIR := cp -rv
+COPY_FILE := cp -v
+DEL_DIR := rm -rv
+DEL_FILE := rm -v
+DJANGO_DB_COL = awk -F\= '{print $$2}'
+DJANGO_DB_URL = eb ssh -c "source /opt/elasticbeanstalk/deployment/custom_env_var; env | grep DATABASE_URL"
+DJANGO_DB_HOST = $(shell $(DJANGO_DB_URL) | $(DJANGO_DB_COL) |\
+	python -c 'import dj_database_url; url = input(); url = dj_database_url.parse(url); print(url["HOST"])')
+DJANGO_DB_NAME = $(shell $(DJANGO_DB_URL) | $(DJANGO_DB_COL) |\
+	python -c 'import dj_database_url; url = input(); url = dj_database_url.parse(url); print(url["NAME"])')
+DJANGO_DB_PASS = $(shell $(DJANGO_DB_URL) | $(DJANGO_DB_COL) |\
+	python -c 'import dj_database_url; url = input(); url = dj_database_url.parse(url); print(url["PASSWORD"])')
+DJANGO_DB_USER = $(shell $(DJANGO_DB_URL) | $(DJANGO_DB_COL) |\
+	python -c 'import dj_database_url; url = input(); url = dj_database_url.parse(url); print(url["USER"])')
+DJANGO_BACKEND_APPS_FILE := backend/apps.py
+DJANGO_CUSTOM_ADMIN_FILE := backend/admin.py
+DJANGO_FRONTEND_FILES = .babelrc .browserslistrc .eslintrc .nvmrc .stylelintrc.json frontend package-lock.json \
+	package.json postcss.config.js
+DJANGO_SETTINGS_DIR = backend/settings
+DJANGO_SETTINGS_BASE_FILE = $(DJANGO_SETTINGS_DIR)/base.py
+DJANGO_SETTINGS_DEV_FILE = $(DJANGO_SETTINGS_DIR)/dev.py
+DJANGO_SETTINGS_PROD_FILE = $(DJANGO_SETTINGS_DIR)/production.py
+DJANGO_SETTINGS_SECRET_KEY = $(shell openssl rand -base64 48)
+DJANGO_URLS_FILE = backend/urls.py
+EB_DIR_NAME := .elasticbeanstalk
+EB_ENV_NAME ?= $(PROJECT_NAME)-$(GIT_BRANCH)-$(GIT_REV)
+EB_PLATFORM ?= "Python 3.11 running on 64bit Amazon Linux 2023"
+EC2_INSTANCE_MAX ?= 1
+EC2_INSTANCE_MIN ?= 1
+EC2_INSTANCE_PROFILE ?= aws-elasticbeanstalk-ec2-role
+EC2_INSTANCE_TYPE ?= t4g.small
+EC2_LB_TYPE ?= application
+EDITOR_REVIEW = subl
+GIT_ADD := git add
+GIT_BRANCH = $(shell git branch --show-current)
+GIT_BRANCHES = $(shell git branch -a) 
+GIT_CHECKOUT = git checkout
+GIT_COMMIT_MSG = "Update $(PROJECT_NAME)"
+GIT_COMMIT = git commit
+GIT_PUSH = git push
+GIT_PUSH_FORCE = git push --force-with-lease
+GIT_REV = $(shell git rev-parse --short HEAD)
+MAKEFILE_CUSTOM_FILE := project.mk
+PACKAGE_NAME = $(shell echo $(PROJECT_NAME) | sed 's/-/_/g')
+PAGER ?= less
+PIP_ENSURE = python -m ensurepip
+PIP_INSTALL_PLONE_CONSTRAINTS = https://dist.plone.org/release/6.0.11.1/constraints.txt
+PROJECT_DIRS = backend contactpage home privacy siteuser
+PROJECT_EMAIL := aclark@aclark.net
+PROJECT_NAME = project-makefile
+RANDIR := $(shell openssl rand -base64 12 | sed 's/\///g')
+TMPDIR := $(shell mktemp -d)
+UNAME := $(shell uname)
+WAGTAIL_CLEAN_DIRS = backend contactpage dist frontend home logging_demo model_form_demo node_modules payments privacy search sitepage siteuser
+WAGTAIL_CLEAN_FILES = .babelrc .browserslistrc .dockerignore .eslintrc .gitignore .nvmrc .stylelintrc.json Dockerfile db.sqlite3 docker-compose.yml manage.py package-lock.json package.json postcss.config.js requirements-test.txt requirements.txt
+
+# --------------------------------------------------------------------------------
+# Include $(MAKEFILE_CUSTOM_FILE) if it exists
+# --------------------------------------------------------------------------------
+
+ifneq ($(wildcard $(MAKEFILE_CUSTOM_FILE)),)
+    include $(MAKEFILE_CUSTOM_FILE)
+endif
+
+# --------------------------------------------------------------------------------
+# Multi-line variables to be used in phony target rules
+# --------------------------------------------------------------------------------
+
+define DJANGO_ALLAUTH_BASE_TEMPLATE
+{% extends 'base.html' %}
+endef
+
+define DJANGO_API_SERIALIZERS
+from rest_framework import serializers
+from siteuser.models import User
+
+
+class UserSerializer(serializers.HyperlinkedModelSerializer):
+    class Meta:
+        model = User
+        fields = ["url", "username", "email", "is_staff"]
+endef
+
+define DJANGO_API_VIEWS
+from ninja import NinjaAPI
+from rest_framework import viewsets
+from siteuser.models import User
+from .serializers import UserSerializer
+
+api = NinjaAPI()
+
+
+@api.get("/hello")
+def hello(request):
+    return "Hello world"
+
+
+class UserViewSet(viewsets.ModelViewSet):
+    queryset = User.objects.all()
+    serializer_class = UserSerializer
+endef
+
+define DJANGO_APP_TESTS
+from django.test import TestCase
+from django.urls import reverse
+from .models import YourModel
+from .forms import YourForm
+
+
+class YourModelTest(TestCase):
+    def setUp(self):
+        self.instance = YourModel.objects.create(field1="value1", field2="value2")
+
+    def test_instance_creation(self):
+        self.assertIsInstance(self.instance, YourModel)
+        self.assertEqual(self.instance.field1, "value1")
+        self.assertEqual(self.instance.field2, "value2")
+
+    def test_str_method(self):
+        self.assertEqual(str(self.instance), "Expected String Representation")
+
+
+class YourViewTest(TestCase):
+    def setUp(self):
+        self.instance = YourModel.objects.create(field1="value1", field2="value2")
+
+    def test_view_url_exists_at_desired_location(self):
+        response = self.client.get("/your-url/")
+        self.assertEqual(response.status_code, 200)
+
+    def test_view_url_accessible_by_name(self):
+        response = self.client.get(reverse("your-view-name"))
+        self.assertEqual(response.status_code, 200)
+
+    def test_view_uses_correct_template(self):
+        response = self.client.get(reverse("your-view-name"))
+        self.assertEqual(response.status_code, 200)
+        self.assertTemplateUsed(response, "your_template.html")
+
+    def test_view_context(self):
+        response = self.client.get(reverse("your-view-name"))
+        self.assertEqual(response.status_code, 200)
+        self.assertIn("context_variable", response.context)
+
+
+class YourFormTest(TestCase):
+    def test_form_valid_data(self):
+        form = YourForm(data={"field1": "value1", "field2": "value2"})
+        self.assertTrue(form.is_valid())
+
+    def test_form_invalid_data(self):
+        form = YourForm(data={"field1": "", "field2": "value2"})
+        self.assertFalse(form.is_valid())
+        self.assertIn("field1", form.errors)
+
+    def test_form_save(self):
+        form = YourForm(data={"field1": "value1", "field2": "value2"})
+        if form.is_valid():
+            instance = form.save()
+            self.assertEqual(instance.field1, "value1")
+            self.assertEqual(instance.field2, "value2")
+endef
+
+define DJANGO_BACKEND_APPS
+from django.contrib.admin.apps import AdminConfig
+
+
+class CustomAdminConfig(AdminConfig):
+    default_site = "backend.admin.CustomAdminSite"
+endef
+
+define DJANGO_BASE_TEMPLATE
+{% load static webpack_loader %}
+<!DOCTYPE html>
+<html lang="en"
+      class="h-100"
+      data-bs-theme="{{ request.user.user_theme_preference|default:'light' }}">
+    <head>
+        <meta charset="utf-8" />
+        <title>
+            {% block title %}{% endblock %}
+            {% block title_suffix %}{% endblock %}
+        </title>
+        <meta name="viewport" content="width=device-width, initial-scale=1" />
+        {% stylesheet_pack 'app' %}
+        {% block extra_css %}{# Override this in templates to add extra stylesheets #}{% endblock %}
+        <style>
+            .success {
+                background-color: #d4edda;
+                border-color: #c3e6cb;
+                color: #155724;
+            }
+
+            .info {
+                background-color: #d1ecf1;
+                border-color: #bee5eb;
+                color: #0c5460;
+            }
+
+            .warning {
+                background-color: #fff3cd;
+                border-color: #ffeeba;
+                color: #856404;
+            }
+
+            .danger {
+                background-color: #f8d7da;
+                border-color: #f5c6cb;
+                color: #721c24;
+            }
+        </style>
+        {% include 'favicon.html' %}
+        {% csrf_token %}
+    </head>
+    <body class="{% block body_class %}{% endblock %} d-flex flex-column h-100">
+        <main class="flex-shrink-0">
+            <div id="app"></div>
+            {% include 'header.html' %}
+            {% if messages %}
+                <div class="messages container">
+                    {% for message in messages %}
+                        <div class="alert {{ message.tags }} alert-dismissible fade show"
+                             role="alert">
+                            {{ message }}
+                            <button type="button"
+                                    class="btn-close"
+                                    data-bs-dismiss="alert"
+                                    aria-label="Close"></button>
+                        </div>
+                    {% endfor %}
+                </div>
+            {% endif %}
+            <div class="container">
+                {% block content %}{% endblock %}
+            </div>
+        </main>
+        {% include 'footer.html' %}
+        {% include 'offcanvas.html' %}
+        {% javascript_pack 'app' %}
+        {% block extra_js %}{# Override this in templates to add extra javascript #}{% endblock %}
+    </body>
+</html>
+endef
+
+define DJANGO_CUSTOM_ADMIN
+from django.contrib.admin import AdminSite
+
+
+class CustomAdminSite(AdminSite):
+    site_header = "Project Makefile"
+    site_title = "Project Makefile"
+    index_title = "Project Makefile"
+
+
+custom_admin_site = CustomAdminSite(name="custom_admin")
+endef
+
+define DJANGO_DOCKERCOMPOSE
+version: '3'
+
+services:
+  db:
+    image: postgres:latest
+    volumes:
+      - postgres_data:/var/lib/postgresql/data
+    environment:
+      POSTGRES_DB: project
+      POSTGRES_USER: admin
+      POSTGRES_PASSWORD: admin
+
+  web:
+    build: .
+    command: sh -c "python manage.py migrate && gunicorn project.wsgi:application -b 0.0.0.0:8000"
+    volumes:
+      - .:/app
+    ports:
+      - "8000:8000"
+    depends_on:
+      - db
+    environment:
+      DATABASE_URL: postgres://admin:admin@db:5432/project
+
+volumes:
+  postgres_data:
+endef
+
+define DJANGO_DOCKERFILE
+FROM amazonlinux:2023
+RUN dnf install -y shadow-utils python3.11 python3.11-pip make nodejs20-npm nodejs postgresql15 postgresql15-server
+USER postgres
+RUN initdb -D /var/lib/pgsql/data
+USER root
+RUN useradd wagtail
+EXPOSE 8000
+ENV PYTHONUNBUFFERED=1 PORT=8000
+COPY requirements.txt /
+RUN python3.11 -m pip install -r /requirements.txt
+WORKDIR /app
+RUN chown wagtail:wagtail /app
+COPY --chown=wagtail:wagtail . .
+USER wagtail
+RUN npm-20 install; npm-20 run build
+RUN python3.11 manage.py collectstatic --noinput --clear
+CMD set -xe; pg_ctl -D /var/lib/pgsql/data -l /tmp/logfile start; python3.11 manage.py migrate --noinput; gunicorn backend.wsgi:application
+endef
+
+define DJANGO_FAVICON_TEMPLATE
+{% load static %}
+<link href="{% static 'wagtailadmin/images/favicon.ico' %}" rel="icon">
+endef
+
+define DJANGO_FOOTER_TEMPLATE
+<footer class="footer mt-auto py-3 bg-body-tertiary pt-5 text-center text-small">
+    <p class="mb-1">&copy; {% now "Y" %} {{ current_site.site_name|default:"Project Makefile" }}</p>
+    <ul class="list-inline">
+        <li class="list-inline-item">
+            <a class="text-secondary text-decoration-none {% if request.path == '/' %}active{% endif %}"
+               href="/">Home</a>
+        </li>
+        {% for child in current_site.root_page.get_children %}
+            <li class="list-inline-item">
+                <a class="text-secondary text-decoration-none {% if request.path == child.url %}active{% endif %}"
+                   href="{{ child.url }}">{{ child }}</a>
+            </li>
+        {% endfor %}
+    </ul>
+</footer>
+endef
+
+define DJANGO_FRONTEND_APP
+import React from 'react';
+import { createRoot } from 'react-dom/client';
+import 'bootstrap';
+import '@fortawesome/fontawesome-free/js/fontawesome';
+import '@fortawesome/fontawesome-free/js/solid';
+import '@fortawesome/fontawesome-free/js/regular';
+import '@fortawesome/fontawesome-free/js/brands';
+import getDataComponents from '../dataComponents';
+import UserContextProvider from '../context';
+import * as components from '../components';
+import "../styles/index.scss";
+import "../styles/theme-blue.scss";
+import "./config";
+
+const { ErrorBoundary } = components;
+const dataComponents = getDataComponents(components);
+const container = document.getElementById('app');
+const root = createRoot(container);
+const App = () => (
+    <ErrorBoundary>
+      <UserContextProvider>
+        {dataComponents}
+      </UserContextProvider>
+    </ErrorBoundary>
+);
+root.render(<App />);
+endef
+
+define DJANGO_FRONTEND_APP_CONFIG
+import '../utils/themeToggler.js';
+// import '../utils/tinymce.js';
+endef
+
+define DJANGO_FRONTEND_BABELRC
+{
+  "presets": [
+    [
+      "@babel/preset-react",
+    ],
+    [
+      "@babel/preset-env",
+      {
+        "useBuiltIns": "usage",
+        "corejs": "3.0.0"
+      }
+    ]
+  ],
+  "plugins": [
+    "@babel/plugin-syntax-dynamic-import",
+    "@babel/plugin-transform-class-properties"
+  ]
+}
+endef
+
+define DJANGO_FRONTEND_COMPONENTS
+export { default as ErrorBoundary } from './ErrorBoundary';
+export { default as UserMenu } from './UserMenu';
+endef
+
+define DJANGO_FRONTEND_COMPONENT_CLOCK
+// Via ChatGPT
+import React, { useState, useEffect, useCallback, useRef } from 'react';
+import PropTypes from 'prop-types';
+
+const Clock = ({ color = '#fff' }) => {
+  const [date, setDate] = useState(new Date());
+  const [blink, setBlink] = useState(true);
+  const timerID = useRef();
+
+  const tick = useCallback(() => {
+    setDate(new Date());
+    setBlink(prevBlink => !prevBlink);
+  }, []);
+
+  useEffect(() => {
+    timerID.current = setInterval(() => tick(), 1000);
+
+    // Return a cleanup function to be run on component unmount
+    return () => clearInterval(timerID.current);
+  }, [tick]);
+
+  const formattedDate = date.toLocaleDateString(undefined, {
+    weekday: 'short',
+    year: 'numeric',
+    month: 'short',
+    day: 'numeric',
+  });
+
+  const formattedTime = date.toLocaleTimeString(undefined, {
+    hour: 'numeric',
+    minute: 'numeric',
+  });
+
+  return (
+    <> 
+      <div style={{ animation: blink ? 'blink 1s infinite' : 'none' }}><span className='me-2'>{formattedDate}</span> {formattedTime}</div>
+    </>
+  );
+};
+
+Clock.propTypes = {
+  color: PropTypes.string,
+};
+
+export default Clock;
+endef
+
+define DJANGO_FRONTEND_COMPONENT_ERROR
+import { Component } from 'react';
+import PropTypes from 'prop-types';
+
+class ErrorBoundary extends Component {
+  constructor (props) {
+    super(props);
+    this.state = { hasError: false };
+  }
+
+  static getDerivedStateFromError () {
+    return { hasError: true };
+  }
+
+  componentDidCatch (error, info) {
+    const { onError } = this.props;
+    console.error(error);
+    onError && onError(error, info);
+  }
+
+  render () {
+    const { children = null } = this.props;
+    const { hasError } = this.state;
+
+    return hasError ? null : children;
+  }
+}
+
+ErrorBoundary.propTypes = {
+  onError: PropTypes.func,
+  children: PropTypes.node,
+};
+
+export default ErrorBoundary;
+endef
+
+define DJANGO_FRONTEND_COMPONENT_USER_MENU
+// UserMenu.js
+import React from 'react';
+import PropTypes from 'prop-types';
+
+function handleLogout() {
+    window.location.href = '/accounts/logout';
+}
+
+const UserMenu = ({ isAuthenticated, isSuperuser, textColor }) => {
+  return (
+    <div> 
+      {isAuthenticated ? (
+        <li className="nav-item dropdown">
+          <a className="nav-link dropdown-toggle" type="button" data-bs-toggle="dropdown" aria-expanded="false">
+              <i className="fa-solid fa-circle-user"></i>
+          </a>
+          <ul className="dropdown-menu">
+            <li><a className="dropdown-item" href="/user/profile/">Profile</a></li>
+            <li><a className="dropdown-item" href="/model-form-demo/">Model Form Demo</a></li>
+            <li><a className="dropdown-item" href="/logging-demo/">Logging Demo</a></li>
+            <li><a className="dropdown-item" href="/payments/">Payments Demo</a></li>
+            {isSuperuser ? (
+              <>
+                <li><hr className="dropdown-divider"></hr></li>
+                <li><a className="dropdown-item" href="/django" target="_blank">Django admin</a></li>
+                <li><a className="dropdown-item" href="/api" target="_blank">Django API</a></li>
+                <li><a className="dropdown-item" href="/wagtail" target="_blank">Wagtail admin</a></li>
+                <li><a className="dropdown-item" href="/explorer" target="_blank">SQL Explorer</a></li>
+              </>
+            ) : null}
+            <li><hr className="dropdown-divider"></hr></li>
+            <li><a className="dropdown-item" href="/accounts/logout">Logout</a></li>
+          </ul>
+        </li>
+      ) : (
+        <li className="nav-item">
+          <a className={`nav-link text-$${textColor}`} href="/accounts/login"><i className="fa-solid fa-circle-user"></i></a>
+        </li>
+      )}
+    </div>
+  );
+};
+
+UserMenu.propTypes = {
+  isAuthenticated: PropTypes.bool.isRequired,
+  isSuperuser: PropTypes.bool.isRequired,
+  textColor: PropTypes.string,
+};
+
+export default UserMenu;
+endef
+
+define DJANGO_FRONTEND_CONTEXT_INDEX
+export { UserContextProvider as default } from './UserContextProvider';
+endef
+
+define DJANGO_FRONTEND_CONTEXT_USER_PROVIDER
+// UserContextProvider.js
+import React, { createContext, useContext, useState } from 'react';
+import PropTypes from 'prop-types';
+
+const UserContext = createContext();
+
+export const UserContextProvider = ({ children }) => {
+  const [isAuthenticated, setIsAuthenticated] = useState(false);
+
+  const login = () => {
+    try {
+      // Add logic to handle login, set isAuthenticated to true
+      setIsAuthenticated(true);
+    } catch (error) {
+      console.error('Login error:', error);
+      // Handle error, e.g., show an error message to the user
+    }
+  };
+
+  const logout = () => {
+    try {
+      // Add logic to handle logout, set isAuthenticated to false
+      setIsAuthenticated(false);
+    } catch (error) {
+      console.error('Logout error:', error);
+      // Handle error, e.g., show an error message to the user
+    }
+  };
+
+  return (
+    <UserContext.Provider value={{ isAuthenticated, login, logout }}>
+      {children}
+    </UserContext.Provider>
+  );
+};
+
+UserContextProvider.propTypes = {
+  children: PropTypes.node.isRequired,
+};
+
+export const useUserContext = () => {
+  const context = useContext(UserContext);
+
+  if (!context) {
+    throw new Error('useUserContext must be used within a UserContextProvider');
+  }
+
+  return context;
+};
+
+// Add PropTypes for the return value of useUserContext
+useUserContext.propTypes = {
+  isAuthenticated: PropTypes.bool.isRequired,
+  login: PropTypes.func.isRequired,
+  logout: PropTypes.func.isRequired,
+};
+endef
+
+define DJANGO_FRONTEND_ESLINTRC
+{
+    "env": {
+        "browser": true,
+        "es2021": true,
+        "node": true
+    },
+    "extends": [
+        "eslint:recommended",
+        "plugin:react/recommended"
+    ],
+    "overrides": [
+        {
+            "env": {
+                "node": true
+            },
+            "files": [
+                ".eslintrc.{js,cjs}"
+            ],
+            "parserOptions": {
+                "sourceType": "script"
+            }
+        }
+    ],
+    "parserOptions": {
+        "ecmaVersion": "latest",
+        "sourceType": "module"
+    },
+    "plugins": [
+        "react"
+    ],
+    "rules": {
+        "no-unused-vars": "off"
+    },
+    settings: {
+      react: {
+        version: 'detect',
+      },
+    },
+}
+endef
+
+define DJANGO_FRONTEND_OFFCANVAS_TEMPLATE
+<div class="offcanvas offcanvas-start bg-dark"
+     tabindex="-1"
+     id="offcanvasExample"
+     aria-labelledby="offcanvasExampleLabel">
+    <div class="offcanvas-header">
+        <a class="offcanvas-title text-light h5 text-decoration-none"
+           id="offcanvasExampleLabel"
+           href="/">{{ current_site.site_name|default:"Project Makefile" }}</a>
+        <button type="button"
+                class="btn-close bg-light"
+                data-bs-dismiss="offcanvas"
+                aria-label="Close"></button>
+    </div>
+    <div class="offcanvas-body bg-dark">
+        <ul class="navbar-nav justify-content-end flex-grow-1 pe-3">
+            <li class="nav-item">
+                <a class="nav-link text-light active" aria-current="page" href="/">Home</a>
+            </li>
+            {% for child in current_site.root_page.get_children %}
+                <li class="nav-item">
+                    <a class="nav-link text-light" href="{{ child.url }}">{{ child }}</a>
+                </li>
+            {% endfor %}
+            <li class="nav-item"
+                id="{% if request.user.is_authenticated %}theme-toggler-authenticated{% else %}theme-toggler-anonymous{% endif %}">
+                <span class="nav-link text-light"
+                      data-bs-toggle="tooltip"
+                      title="Toggle dark mode">
+                    <i class="fas fa-circle-half-stroke"></i>
+                </span>
+            </li>
+            <div data-component="UserMenu"
+                 data-text-color="light"
+                 data-is-authenticated="{{ request.user.is_authenticated }}"
+                 data-is-superuser="{{ request.user.is_superuser }}"></div>
+        </ul>
+    </div>
+</div>
+endef
+
+define DJANGO_FRONTEND_PORTAL
+// Via pwellever
+import React from 'react';
+import { createPortal } from 'react-dom';
+
+const parseProps = data => Object.entries(data).reduce((result, [key, value]) => {
+  if (value.toLowerCase() === 'true') {
+    value = true;
+  } else if (value.toLowerCase() === 'false') {
+    value = false;
+  } else if (value.toLowerCase() === 'null') {
+    value = null;
+  } else if (!isNaN(parseFloat(value)) && isFinite(value)) {
+    // Parse numeric value
+    value = parseFloat(value);
+  } else if (
+    (value[0] === '[' && value.slice(-1) === ']') || (value[0] === '{' && value.slice(-1) === '}')
+  ) {
+    // Parse JSON strings
+    value = JSON.parse(value);
+  }
+
+  result[key] = value;
+  return result;
+}, {});
+
+// This method of using portals instead of calling ReactDOM.render on individual components
+// ensures that all components are mounted under a single React tree, and are therefore able
+// to share context.
+
+export default function getPageComponents (components) {
+  const getPortalComponent = domEl => {
+    // The element's "data-component" attribute is used to determine which component to render.
+    // All other "data-*" attributes are passed as props.
+    const { component: componentName, ...rest } = domEl.dataset;
+    const Component = components[componentName];
+    if (!Component) {
+      console.error(`Component "$${componentName}" not found.`);
+      return null;
+    }
+    const props = parseProps(rest);
+    domEl.innerHTML = '';
+
+    // eslint-disable-next-line no-unused-vars
+    const { ErrorBoundary } = components;
+    return createPortal(
+      <ErrorBoundary>
+        <Component {...props} />
+      </ErrorBoundary>,
+      domEl,
+    );
+  };
+
+  return Array.from(document.querySelectorAll('[data-component]')).map(getPortalComponent);
+}
+endef
+
+define DJANGO_FRONTEND_STYLES
+// If you comment out code below, bootstrap will use red as primary color
+// and btn-primary will become red
+
+// $primary: red;
+
+@import "~bootstrap/scss/bootstrap.scss";
+
+.jumbotron {
+  // should be relative path of the entry scss file
+  background-image: url("../../vendors/images/sample.jpg");
+  background-size: cover;
+}
+
+#theme-toggler-authenticated:hover {
+    cursor: pointer; /* Change cursor to pointer on hover */
+    color: #007bff; /* Change color on hover */
+}
+
+#theme-toggler-anonymous:hover {
+    cursor: pointer; /* Change cursor to pointer on hover */
+    color: #007bff; /* Change color on hover */
+}
+endef
+
+define DJANGO_FRONTEND_THEME_BLUE
+@import "~bootstrap/scss/bootstrap.scss";
+
+[data-bs-theme="blue"] {
+  --bs-body-color: var(--bs-white);
+  --bs-body-color-rgb: #{to-rgb($$white)};
+  --bs-body-bg: var(--bs-blue);
+  --bs-body-bg-rgb: #{to-rgb($$blue)};
+  --bs-tertiary-bg: #{$$blue-600};
+
+  .dropdown-menu {
+    --bs-dropdown-bg: #{color-mix($$blue-500, $$blue-600)};
+    --bs-dropdown-link-active-bg: #{$$blue-700};
+  }
+
+  .btn-secondary {
+    --bs-btn-bg: #{color-mix($gray-600, $blue-400, .5)};
+    --bs-btn-border-color: #{rgba($$white, .25)};
+    --bs-btn-hover-bg: #{color-adjust(color-mix($gray-600, $blue-400, .5), 5%)};
+    --bs-btn-hover-border-color: #{rgba($$white, .25)};
+    --bs-btn-active-bg: #{color-adjust(color-mix($gray-600, $blue-400, .5), 10%)};
+    --bs-btn-active-border-color: #{rgba($$white, .5)};
+    --bs-btn-focus-border-color: #{rgba($$white, .5)};
+
+    // --bs-btn-focus-box-shadow: 0 0 0 .25rem rgba(255, 255, 255, 20%);
+  }
+}
+endef
+
+define DJANGO_FRONTEND_THEME_TOGGLER
+document.addEventListener('DOMContentLoaded', function () {
+    const rootElement = document.documentElement;
+    const anonThemeToggle = document.getElementById('theme-toggler-anonymous');
+    const authThemeToggle = document.getElementById('theme-toggler-authenticated');
+    if (authThemeToggle) {
+        localStorage.removeItem('data-bs-theme');
+    }
+    const anonSavedTheme = localStorage.getItem('data-bs-theme');
+    if (anonSavedTheme) {
+        rootElement.setAttribute('data-bs-theme', anonSavedTheme);
+    }
+    if (anonThemeToggle) {
+        anonThemeToggle.addEventListener('click', function () {
+            const currentTheme = rootElement.getAttribute('data-bs-theme') || 'light';
+            const newTheme = currentTheme === 'light' ? 'dark' : 'light';
+            rootElement.setAttribute('data-bs-theme', newTheme);
+            localStorage.setItem('data-bs-theme', newTheme);
+        });
+    }
+    if (authThemeToggle) {
+        const csrfToken = document.querySelector('[name=csrfmiddlewaretoken]').value;
+        authThemeToggle.addEventListener('click', function () {
+            const currentTheme = rootElement.getAttribute('data-bs-theme') || 'light';
+            const newTheme = currentTheme === 'light' ? 'dark' : 'light';
+            fetch('/user/update_theme_preference/', {
+                method: 'POST',
+                headers: {
+                    'Content-Type': 'application/json',
+                    'X-CSRFToken': csrfToken, // Include the CSRF token in the headers
+                },
+                body: JSON.stringify({ theme: newTheme }),
+            })
+            .then(response => response.json())
+            .then(data => {
+                rootElement.setAttribute('data-bs-theme', newTheme);
+            })
+            .catch(error => {
+                console.error('Error updating theme preference:', error);
+            });
+        });
+    }
+});
+endef
+
+define DJANGO_HEADER_TEMPLATE
+<div class="app-header">
+    <div class="container py-4 app-navbar">
+        <nav class="navbar navbar-transparent navbar-padded navbar-expand-md">
+            <a class="navbar-brand me-auto" href="/">{{ current_site.site_name|default:"Project Makefile" }}</a>
+            <button class="navbar-toggler"
+                    type="button"
+                    data-bs-toggle="offcanvas"
+                    data-bs-target="#offcanvasExample"
+                    aria-controls="offcanvasExample"
+                    aria-expanded="false"
+                    aria-label="Toggle navigation">
+                <span class="navbar-toggler-icon"></span>
+            </button>
+            <div class="d-none d-md-block">
+                <ul class="navbar-nav">
+                    <li class="nav-item">
+                        <a id="home-nav"
+                           class="nav-link {% if request.path == '/' %}active{% endif %}"
+                           aria-current="page"
+                           href="/">Home</a>
+                    </li>
+                    {% for child in current_site.root_page.get_children %}
+                        {% if child.show_in_menus %}
+                            <li class="nav-item">
+                                <a class="nav-link {% if request.path == child.url %}active{% endif %}"
+                                   aria-current="page"
+                                   href="{{ child.url }}">{{ child }}</a>
+                            </li>
+                        {% endif %}
+                    {% endfor %}
+                    <div data-component="UserMenu"
+                         data-is-authenticated="{{ request.user.is_authenticated }}"
+                         data-is-superuser="{{ request.user.is_superuser }}"></div>
+                    <li class="nav-item"
+                        id="{% if request.user.is_authenticated %}theme-toggler-authenticated{% else %}theme-toggler-anonymous{% endif %}">
+                        <span class="nav-link" data-bs-toggle="tooltip" title="Toggle dark mode">
+                            <i class="fas fa-circle-half-stroke"></i>
+                        </span>
+                    </li>
+                    <li class="nav-item">
+                        <form class="form" action="/search">
+                            <div class="row">
+                                <div class="col-8">
+                                    <input class="form-control"
+                                           type="search"
+                                           name="query"
+                                           {% if search_query %}value="{{ search_query }}"{% endif %}>
+                                </div>
+                                <div class="col-4">
+                                    <input type="submit" value="Search" class="form-control">
+                                </div>
+                            </div>
+                        </form>
+                    </li>
+                </ul>
+            </div>
+        </nav>
+    </div>
+</div>
+endef 
+
+define DJANGO_HOME_PAGE_ADMIN
+from django.contrib import admin  # noqa
+
+# Register your models here.
+endef
+
+define DJANGO_HOME_PAGE_MODELS
+from django.db import models  # noqa
+
+# Create your models here.
+endef
+
+define DJANGO_HOME_PAGE_TEMPLATE
+{% extends "base.html" %}
+{% block content %}
+    <main class="{% block main_class %}{% endblock %}">
+    </main>
+{% endblock %}
+endef
+
+define DJANGO_HOME_PAGE_URLS
+from django.urls import path
+from .views import HomeView
+
+urlpatterns = [path("", HomeView.as_view(), name="home")]
+endef
+
+define DJANGO_HOME_PAGE_VIEWS
+from django.views.generic import TemplateView
+
+
+class HomeView(TemplateView):
+    template_name = "home.html"
+endef
+
+define DJANGO_LOGGING_DEMO_ADMIN
+# Register your models here.
+endef
+
+define DJANGO_LOGGING_DEMO_MODELS
+from django.db import models  # noqa
+
+# Create your models here.
+endef
+
+define DJANGO_LOGGING_DEMO_SETTINGS
+INSTALLED_APPS.append("logging_demo")  # noqa
+endef
+
+define DJANGO_LOGGING_DEMO_URLS
+from django.urls import path
+from .views import logging_demo
+
+urlpatterns = [
+    path("", logging_demo, name="logging_demo"),
+]
+endef
+
+define DJANGO_LOGGING_DEMO_VIEWS
+from django.http import HttpResponse
+import logging
+
+logger = logging.getLogger(__name__)
+
+
+def logging_demo(request):
+    logger.debug("Hello, world!")
+    return HttpResponse("Hello, world!")
+endef
+
+define DJANGO_MANAGE_PY
+#!/usr/bin/env python
+"""Django's command-line utility for administrative tasks."""
+
+import os
+import sys
+
+
+def main():
+    """Run administrative tasks."""
+    os.environ.setdefault("DJANGO_SETTINGS_MODULE", "backend.settings.dev")
+    try:
+        from django.core.management import execute_from_command_line
+    except ImportError as exc:
+        raise ImportError(
+            "Couldn't import Django. Are you sure it's installed and "
+            "available on your PYTHONPATH environment variable? Did you "
+            "forget to activate a virtual environment?"
+        ) from exc
+    execute_from_command_line(sys.argv)
+
+
+if __name__ == "__main__":
+    main()
+endef
+
+define DJANGO_MODEL_FORM_DEMO_ADMIN
+from django.contrib import admin
+from .models import ModelFormDemo
+
+
+@admin.register(ModelFormDemo)
+class ModelFormDemoAdmin(admin.ModelAdmin):
+    pass
+endef
+
+define DJANGO_MODEL_FORM_DEMO_FORMS
+from django import forms
+from .models import ModelFormDemo
+
+
+class ModelFormDemoForm(forms.ModelForm):
+    class Meta:
+        model = ModelFormDemo
+        fields = ["name", "email", "age", "is_active"]
+endef
+
+define DJANGO_MODEL_FORM_DEMO_MODEL
+from django.db import models
+from django.shortcuts import reverse
+
+
+class ModelFormDemo(models.Model):
+    name = models.CharField(max_length=100, blank=True, null=True)
+    email = models.EmailField(blank=True, null=True)
+    age = models.IntegerField(blank=True, null=True)
+    is_active = models.BooleanField(default=True)
+    created_at = models.DateTimeField(auto_now_add=True)
+
+    def __str__(self):
+        return self.name or f"test-model-{self.pk}"
+
+    def get_absolute_url(self):
+        return reverse("model_form_demo_detail", kwargs={"pk": self.pk})
+endef
+
+define DJANGO_MODEL_FORM_DEMO_TEMPLATE_DETAIL
+{% extends 'base.html' %}
+{% block content %}
+    <h1>Test Model Detail: {{ model_form_demo.name }}</h1>
+    <p>Name: {{ model_form_demo.name }}</p>
+    <p>Email: {{ model_form_demo.email }}</p>
+    <p>Age: {{ model_form_demo.age }}</p>
+    <p>Active: {{ model_form_demo.is_active }}</p>
+    <p>Created At: {{ model_form_demo.created_at }}</p>
+    <a href="{% url 'model_form_demo_update' model_form_demo.pk %}">Edit Test Model</a>
+{% endblock %}
+endef
+
+define DJANGO_MODEL_FORM_DEMO_TEMPLATE_FORM
+{% extends 'base.html' %}
+{% block content %}
+    <h1>
+        {% if form.instance.pk %}
+            Update Test Model
+        {% else %}
+            Create Test Model
+        {% endif %}
+    </h1>
+    <form method="post">
+        {% csrf_token %}
+        {{ form.as_p }}
+        <button type="submit">Save</button>
+    </form>
+{% endblock %}
+endef
+
+define DJANGO_MODEL_FORM_DEMO_TEMPLATE_LIST
+{% extends 'base.html' %}
+{% block content %}
+    <h1>Test Models List</h1>
+    <ul>
+        {% for model_form_demo in model_form_demos %}
+            <li>
+                <a href="{% url 'model_form_demo_detail' model_form_demo.pk %}">{{ model_form_demo.name }}</a>
+            </li>
+        {% endfor %}
+    </ul>
+    <a href="{% url 'model_form_demo_create' %}">Create New Test Model</a>
+{% endblock %}
+endef
+
+define DJANGO_MODEL_FORM_DEMO_URLS
+from django.urls import path
+from .views import (
+    ModelFormDemoListView,
+    ModelFormDemoCreateView,
+    ModelFormDemoUpdateView,
+    ModelFormDemoDetailView,
+)
+
+urlpatterns = [
+    path("", ModelFormDemoListView.as_view(), name="model_form_demo_list"),
+    path("create/", ModelFormDemoCreateView.as_view(), name="model_form_demo_create"),
+    path(
+        "<int:pk>/update/",
+        ModelFormDemoUpdateView.as_view(),
+        name="model_form_demo_update",
+    ),
+    path("<int:pk>/", ModelFormDemoDetailView.as_view(), name="model_form_demo_detail"),
+]
+endef
+
+define DJANGO_MODEL_FORM_DEMO_VIEWS
+from django.views.generic import ListView, CreateView, UpdateView, DetailView
+from .models import ModelFormDemo
+from .forms import ModelFormDemoForm
+
+
+class ModelFormDemoListView(ListView):
+    model = ModelFormDemo
+    template_name = "model_form_demo_list.html"
+    context_object_name = "model_form_demos"
+
+
+class ModelFormDemoCreateView(CreateView):
+    model = ModelFormDemo
+    form_class = ModelFormDemoForm
+    template_name = "model_form_demo_form.html"
+
+    def form_valid(self, form):
+        form.instance.created_by = self.request.user
+        return super().form_valid(form)
+
+
+class ModelFormDemoUpdateView(UpdateView):
+    model = ModelFormDemo
+    form_class = ModelFormDemoForm
+    template_name = "model_form_demo_form.html"
+
+
+class ModelFormDemoDetailView(DetailView):
+    model = ModelFormDemo
+    template_name = "model_form_demo_detail.html"
+    context_object_name = "model_form_demo"
+endef
+
+define DJANGO_PAYMENTS_ADMIN
+from django.contrib import admin
+from .models import Product, Order
+
+admin.site.register(Product)
+admin.site.register(Order)
+endef
+
+define DJANGO_PAYMENTS_FORM
+from django import forms
+
+
+class PaymentsForm(forms.Form):
+    stripeToken = forms.CharField(widget=forms.HiddenInput())
+    amount = forms.DecimalField(
+        max_digits=10, decimal_places=2, widget=forms.HiddenInput()
+    )
+endef
+
+define DJANGO_PAYMENTS_MIGRATION_0002
+from django.db import migrations
+import os
+import secrets
+import logging
+
+logger = logging.getLogger(__name__)
+
+
+def generate_default_key():
+    return "sk_test_" + secrets.token_hex(24)
+
+
+def set_stripe_api_keys(apps, schema_editor):
+    # Get the Stripe API Key model
+    APIKey = apps.get_model("djstripe", "APIKey")
+
+    # Fetch the keys from environment variables or generate default keys
+    test_secret_key = os.environ.get("STRIPE_TEST_SECRET_KEY", generate_default_key())
+    live_secret_key = os.environ.get("STRIPE_LIVE_SECRET_KEY", generate_default_key())
+
+    logger.info("STRIPE_TEST_SECRET_KEY: %s", test_secret_key)
+    logger.info("STRIPE_LIVE_SECRET_KEY: %s", live_secret_key)
+
+    # Check if the keys are not already in the database
+    if not APIKey.objects.filter(secret=test_secret_key).exists():
+        APIKey.objects.create(secret=test_secret_key, livemode=False)
+        logger.info("Added test secret key to the database.")
+    else:
+        logger.info("Test secret key already exists in the database.")
+
+    if not APIKey.objects.filter(secret=live_secret_key).exists():
+        APIKey.objects.create(secret=live_secret_key, livemode=True)
+        logger.info("Added live secret key to the database.")
+    else:
+        logger.info("Live secret key already exists in the database.")
+
+
+class Migration(migrations.Migration):
+
+    dependencies = [
+        ("payments", "0001_initial"),
+    ]
+
+    operations = [
+        migrations.RunPython(set_stripe_api_keys),
+    ]
+endef
+
+define DJANGO_PAYMENTS_MIGRATION_0003
+from django.db import migrations
+
+
+def create_initial_products(apps, schema_editor):
+    Product = apps.get_model("payments", "Product")
+    Product.objects.create(name="T-shirt", description="A cool T-shirt", price=20.00)
+    Product.objects.create(name="Mug", description="A nice mug", price=10.00)
+    Product.objects.create(name="Hat", description="A stylish hat", price=15.00)
+
+
+class Migration(migrations.Migration):
+    dependencies = [
+        (
+            "payments",
+            "0002_set_stripe_api_keys",
+        ),
+    ]
+
+    operations = [
+        migrations.RunPython(create_initial_products),
+    ]
+endef
+
+define DJANGO_PAYMENTS_MODELS
+from django.db import models
+
+
+class Product(models.Model):
+    name = models.CharField(max_length=100)
+    description = models.TextField()
+    price = models.DecimalField(max_digits=10, decimal_places=2)
+
+    def __str__(self):
+        return self.name
+
+
+class Order(models.Model):
+    product = models.ForeignKey(Product, on_delete=models.CASCADE)
+    created_at = models.DateTimeField(auto_now_add=True)
+    stripe_checkout_session_id = models.CharField(max_length=200)
+
+    def __str__(self):
+        return f"Order {self.id} for {self.product.name}"
+endef
+
+define DJANGO_PAYMENTS_TEMPLATE_CANCEL
+{% extends "base.html" %}
+{% block title %}Cancel{% endblock %}
+{% block content %}
+    <h1>Payment Cancelled</h1>
+    <p>Your payment was cancelled.</p>
+{% endblock %}
+endef
+
+define DJANGO_PAYMENTS_TEMPLATE_CHECKOUT
+{% extends "base.html" %}
+{% block title %}Checkout{% endblock %}
+{% block content %}
+    <h1>Checkout</h1>
+    <form action="{% url 'checkout' %}" method="post">
+        {% csrf_token %}
+        <button type="submit">Pay</button>
+    </form>
+{% endblock %}
+endef
+
+define DJANGO_PAYMENTS_TEMPLATE_PRODUCT_DETAIL
+{% extends "base.html" %}
+{% block title %}{{ product.name }}{% endblock %}
+{% block content %}
+    <h1>{{ product.name }}</h1>
+    <p>{{ product.description }}</p>
+    <p>Price: ${{ product.price }}</p>
+    <form action="{% url 'checkout' %}" method="post">
+        {% csrf_token %}
+        <input type="hidden" name="product_id" value="{{ product.id }}">
+        <button type="submit">Buy Now</button>
+    </form>
+{% endblock %}
+endef
+
+define DJANGO_PAYMENTS_TEMPLATE_PRODUCT_LIST
+{% extends "base.html" %}
+{% block title %}Products{% endblock %}
+{% block content %}
+    <h1>Products</h1>
+    <ul>
+        {% for product in products %}
+            <li>
+                <a href="{% url 'product_detail' product.pk %}">{{ product.name }} - {{ product.price }}</a>
+            </li>
+        {% endfor %}
+    </ul>
+{% endblock %}
+endef
+
+define DJANGO_PAYMENTS_TEMPLATE_SUCCESS
+{% extends "base.html" %}
+{% block title %}Success{% endblock %}
+{% block content %}
+    <h1>Payment Successful</h1>
+    <p>Thank you for your purchase!</p>
+{% endblock %}
+endef
+
+define DJANGO_PAYMENTS_URLS
+from django.urls import path
+from .views import (
+    CheckoutView,
+    SuccessView,
+    CancelView,
+    ProductListView,
+    ProductDetailView,
+)
+
+urlpatterns = [
+    path("", ProductListView.as_view(), name="product_list"),
+    path("product/<int:pk>/", ProductDetailView.as_view(), name="product_detail"),
+    path("checkout/", CheckoutView.as_view(), name="checkout"),
+    path("success/", SuccessView.as_view(), name="success"),
+    path("cancel/", CancelView.as_view(), name="cancel"),
+]
+endef
+
+define DJANGO_PAYMENTS_VIEW
+from django.conf import settings
+from django.shortcuts import render, redirect, get_object_or_404
+from django.views.generic import TemplateView, View, ListView, DetailView
+import stripe
+from .models import Product, Order
+
+stripe.api_key = settings.STRIPE_TEST_SECRET_KEY
+
+
+class ProductListView(ListView):
+    model = Product
+    template_name = "payments/product_list.html"
+    context_object_name = "products"
+
+
+class ProductDetailView(DetailView):
+    model = Product
+    template_name = "payments/product_detail.html"
+    context_object_name = "product"
+
+
+class CheckoutView(View):
+    template_name = "payments/checkout.html"
+
+    def get(self, request, *args, **kwargs):
+        products = Product.objects.all()
+        return render(request, self.template_name, {"products": products})
+
+    def post(self, request, *args, **kwargs):
+        product_id = request.POST.get("product_id")
+        product = get_object_or_404(Product, id=product_id)
+
+        session = stripe.checkout.Session.create(
+            payment_method_types=["card"],
+            line_items=[
+                {
+                    "price_data": {
+                        "currency": "usd",
+                        "product_data": {
+                            "name": product.name,
+                        },
+                        "unit_amount": int(product.price * 100),
+                    },
+                    "quantity": 1,
+                }
+            ],
+            mode="payment",
+            success_url="http://localhost:8000/payments/success/",
+            cancel_url="http://localhost:8000/payments/cancel/",
+        )
+
+        Order.objects.create(product=product, stripe_checkout_session_id=session.id)
+        return redirect(session.url, code=303)
+
+
+class SuccessView(TemplateView):
+
+    template_name = "payments/success.html"
+
+
+class CancelView(TemplateView):
+
+    template_name = "payments/cancel.html"
+endef
+
+define DJANGO_SEARCH_FORMS
+from django import forms
+
+
+class SearchForm(forms.Form):
+    query = forms.CharField(max_length=100, required=True, label="Search")
+
+endef
+
+define DJANGO_SEARCH_SETTINGS
+SEARCH_MODELS = [
+    # Add search models here.
+]
+endef
+
+define DJANGO_SEARCH_TEMPLATE
+{% extends "base.html" %}
+{% block body_class %}template-searchresults{% endblock %}
+{% block title %}Search{% endblock %}
+{% block content %}
+    <h1>Search</h1>
+    <form action="{% url 'search' %}" method="get">
+        <input type="text"
+               name="query"
+               {% if search_query %}value="{{ search_query }}"{% endif %}>
+        <input type="submit" value="Search" class="button">
+    </form>
+    {% if search_results %}
+        <ul>
+            {% for result in search_results %}
+                <li>
+                    <h4>
+                        <a href="{% pageurl result %}">{{ result }}</a>
+                    </h4>
+                    {% if result.search_description %}{{ result.search_description }}{% endif %}
+                </li>
+            {% endfor %}
+        </ul>
+        {% if search_results.has_previous %}
+            <a href="{% url 'search' %}?query={{ search_query|urlencode }}&amp;page={{ search_results.previous_page_number }}">Previous</a>
+        {% endif %}
+        {% if search_results.has_next %}
+            <a href="{% url 'search' %}?query={{ search_query|urlencode }}&amp;page={{ search_results.next_page_number }}">Next</a>
+        {% endif %}
+    {% elif search_query %}
+        No results found
+	{% else %}
+		No results found. Try a <a href="?query=test">test query</a>?
+    {% endif %}
+{% endblock %}
+endef
+
+define DJANGO_SEARCH_URLS
+from django.urls import path
+from .views import SearchView
+
+urlpatterns = [
+    path("search/", SearchView.as_view(), name="search"),
+]
+endef
+
+define DJANGO_SEARCH_UTILS
+from django.apps import apps
+from django.conf import settings
+
+def get_search_models():
+    models = []
+    for model_path in settings.SEARCH_MODELS:
+        app_label, model_name = model_path.split(".")
+        model = apps.get_model(app_label, model_name)
+        models.append(model)
+    return models
+endef
+
+define DJANGO_SEARCH_VIEWS
+from django.views.generic import ListView
+from django.db import models
+from django.db.models import Q 
+from .forms import SearchForm
+from .utils import get_search_models
+
+
+class SearchView(ListView):
+    template_name = "your_app/search_results.html"
+    context_object_name = "results"
+    paginate_by = 10
+
+    def get_queryset(self):
+        form = SearchForm(self.request.GET)
+        query = None
+        results = []
+
+        if form.is_valid():
+            query = form.cleaned_data["query"]
+            search_models = get_search_models()
+
+            for model in search_models:
+                fields = [f.name for f in model._meta.fields if isinstance(f, (models.CharField, models.TextField))]
+                queries = [Q(**{f"{field}__icontains": query}) for field in fields]
+                model_results = model.objects.filter(queries.pop())
+
+                for item in queries:
+                    model_results = model_results.filter(item)
+
+                results.extend(model_results)
+
+        return results
+
+    def get_context_data(self, **kwargs):
+        context = super().get_context_data(**kwargs)
+        context["form"] = SearchForm(self.request.GET)
+        context["query"] = self.request.GET.get("query", "")
+        return context
+endef
+
+define DJANGO_SETTINGS_AUTHENTICATION_BACKENDS
+AUTHENTICATION_BACKENDS = [
+    "django.contrib.auth.backends.ModelBackend",
+    "allauth.account.auth_backends.AuthenticationBackend",
+]
+endef
+
+define DJANGO_SETTINGS_BASE
+# $(PROJECT_NAME)
+#
+# Uncomment next two lines to enable custom admin
+# INSTALLED_APPS = [app for app in INSTALLED_APPS if app != 'django.contrib.admin']
+# INSTALLED_APPS.append('backend.apps.CustomAdminConfig')
+import os  # noqa
+import dj_database_url  # noqa
+
+DEFAULT_AUTO_FIELD = "django.db.models.BigAutoField"
+EXPLORER_CONNECTIONS = {"Default": "default"}
+EXPLORER_DEFAULT_CONNECTION = "default"
+LOGIN_REDIRECT_URL = "/"
+PROJECT_DIR = os.path.dirname(os.path.dirname(os.path.abspath(__file__)))
+SILENCED_SYSTEM_CHECKS = ["django_recaptcha.recaptcha_test_key_error"]
+BASE_DIR = os.path.dirname(PROJECT_DIR)
+STATICFILES_DIRS = []
+WEBPACK_LOADER = {
+    "MANIFEST_FILE": os.path.join(BASE_DIR, "frontend/build/manifest.json"),
+}
+STATICFILES_DIRS.append(os.path.join(BASE_DIR, "frontend/build"))
+TEMPLATES[0]["DIRS"].append(os.path.join(PROJECT_DIR, "templates"))
+endef
+
+define DJANGO_SETTINGS_BASE_MINIMAL
+# $(PROJECT_NAME)
+import os  # noqa
+import dj_database_url  # noqa
+
+INSTALLED_APPS.append("debug_toolbar")
+INSTALLED_APPS.append("webpack_boilerplate")
+PROJECT_DIR = os.path.dirname(os.path.dirname(os.path.abspath(__file__)))
+BASE_DIR = os.path.dirname(PROJECT_DIR)
+STATICFILES_DIRS = []
+STATICFILES_DIRS.append(os.path.join(BASE_DIR, "frontend/build"))
+TEMPLATES[0]["DIRS"].append(os.path.join(PROJECT_DIR, "templates"))
+WEBPACK_LOADER = {
+    "MANIFEST_FILE": os.path.join(BASE_DIR, "frontend/build/manifest.json"),
+}
+endef
+
+define DJANGO_SETTINGS_CRISPY_FORMS
+CRISPY_TEMPLATE_PACK = "bootstrap5"
+CRISPY_ALLOWED_TEMPLATE_PACKS = "bootstrap5"
+endef
+
+define DJANGO_SETTINGS_DATABASE
+DATABASE_URL = os.environ.get("DATABASE_URL", "postgres://:@:/$(PROJECT_NAME)")
+DATABASES["default"] = dj_database_url.parse(DATABASE_URL)
+endef
+
+define DJANGO_SETTINGS_DEV
+from .base import *  # noqa
+
+# SECURITY WARNING: don't run with debug turned on in production!
+DEBUG = True
+
+# SECURITY WARNING: define the correct hosts in production!
+ALLOWED_HOSTS = ["*"]
+
+EMAIL_BACKEND = "django.core.mail.backends.console.EmailBackend"
+
+try:
+    from .local import *  # noqa
+except ImportError:
+    pass
+
+LOGGING = {
+    "version": 1,
+    "disable_existing_loggers": False,
+    "formatters": {
+        "verbose": {
+            "format": "{levelname} {asctime} {module} {message}",
+            "style": "{",
+        },
+        "simple": {
+            "format": "{levelname} {message}",
+            "style": "{",
+        },
+    },
+    "handlers": {
+        "console": {
+            "level": "DEBUG",
+            "class": "logging.StreamHandler",
+            "formatter": "verbose",
+        },
+    },
+    "loggers": {
+        "django": {
+            "handlers": ["console"],
+            "level": "DEBUG",
+            "propagate": True,
+        },
+    },
+}
+
+INTERNAL_IPS = [
+    "127.0.0.1",
+]
+
+MIDDLEWARE.append("debug_toolbar.middleware.DebugToolbarMiddleware")  # noqa
+MIDDLEWARE.append("hijack.middleware.HijackUserMiddleware")  # noqa
+INSTALLED_APPS.append("django.contrib.admindocs")  # noqa
+SECRET_KEY = "$(DJANGO_SETTINGS_SECRET_KEY)"
+endef
+
+
+define DJANGO_SETTINGS_HOME_PAGE
+INSTALLED_APPS.append("home")
+endef
+
+define DJANGO_SETTINGS_INSTALLED_APPS
+INSTALLED_APPS.append("allauth")
+INSTALLED_APPS.append("allauth.account")
+INSTALLED_APPS.append("allauth.socialaccount")
+INSTALLED_APPS.append("crispy_bootstrap5")
+INSTALLED_APPS.append("crispy_forms")
+INSTALLED_APPS.append("debug_toolbar")
+INSTALLED_APPS.append("django_extensions")
+INSTALLED_APPS.append("django_recaptcha")
+INSTALLED_APPS.append("rest_framework")
+INSTALLED_APPS.append("rest_framework.authtoken")
+INSTALLED_APPS.append("webpack_boilerplate")
+INSTALLED_APPS.append("explorer")
+endef
+
+define DJANGO_SETTINGS_MIDDLEWARE
+MIDDLEWARE.append("allauth.account.middleware.AccountMiddleware")
+endef
+
+define DJANGO_SETTINGS_MODEL_FORM_DEMO
+INSTALLED_APPS.append("model_form_demo")  # noqa
+endef
+
+define DJANGO_SETTINGS_PAYMENTS
+DJSTRIPE_FOREIGN_KEY_TO_FIELD = "id"
+DJSTRIPE_WEBHOOK_VALIDATION = "retrieve_event"
+STRIPE_PUBLISHABLE_KEY = os.environ.get("STRIPE_PUBLISHABLE_KEY")
+STRIPE_SECRET_KEY = os.environ.get("STRIPE_SECRET_KEY")
+STRIPE_TEST_SECRET_KEY = os.environ.get("STRIPE_TEST_SECRET_KEY")
+INSTALLED_APPS.append("payments")  # noqa
+INSTALLED_APPS.append("djstripe")  # noqa
+endef
+
+define DJANGO_SETTINGS_REST_FRAMEWORK
+REST_FRAMEWORK = {
+    # Use Django's standard `django.contrib.auth` permissions,
+    # or allow read-only access for unauthenticated users.
+    "DEFAULT_PERMISSION_CLASSES": [
+        "rest_framework.permissions.DjangoModelPermissionsOrAnonReadOnly"
+    ]
+}
+endef
+
+define DJANGO_SETTINGS_SITEUSER
+INSTALLED_APPS.append("siteuser")  # noqa
+AUTH_USER_MODEL = "siteuser.User"
+endef
+
+define DJANGO_SETTINGS_PROD
+from .base import *  # noqa
+from backend.utils import get_ec2_metadata
+
+DEBUG = False
+
+try:
+    from .local import *  # noqa
+except ImportError:
+    pass
+
+LOCAL_IPV4 = get_ec2_metadata()
+ALLOWED_HOSTS.append(LOCAL_IPV4)  # noqa
+endef
+
+define DJANGO_SETTINGS_THEMES
+THEMES = [
+    ("light", "Light Theme"),
+    ("dark", "Dark Theme"),
+]
+endef
+
+define DJANGO_SITEUSER_ADMIN
+from django.contrib.auth.admin import UserAdmin
+from django.contrib import admin
+
+from .models import User
+
+admin.site.register(User, UserAdmin)
+endef
+
+define DJANGO_SITEUSER_EDIT_TEMPLATE
+{% extends 'base.html' %}
+{% load crispy_forms_tags %}
+{% block content %}
+    <h2>Edit User</h2>
+    {% crispy form %}
+{% endblock %}
+endef
+
+define DJANGO_SITEUSER_FORM
+from django import forms
+from django.contrib.auth.forms import UserChangeForm
+from crispy_forms.helper import FormHelper
+from crispy_forms.layout import Layout, Fieldset, ButtonHolder, Submit
+from .models import User
+
+
+class SiteUserForm(UserChangeForm):
+    bio = forms.CharField(widget=forms.Textarea(attrs={"id": "editor"}), required=False)
+
+    class Meta(UserChangeForm.Meta):
+        model = User
+        fields = ("username", "user_theme_preference", "bio", "rate")
+
+    def __init__(self, *args, **kwargs):
+        super().__init__(*args, **kwargs)
+        self.helper = FormHelper()
+        self.helper.form_method = "post"
+        self.helper.layout = Layout(
+            Fieldset(
+                "Edit Your Profile",
+                "username",
+                "user_theme_preference",
+                "bio",
+                "rate",
+            ),
+            ButtonHolder(Submit("submit", "Save", css_class="btn btn-primary")),
+        )
+endef
+
+define DJANGO_SITEUSER_MODEL
+from django.db import models
+from django.contrib.auth.models import AbstractUser, Group, Permission
+from django.conf import settings
+
+
+class User(AbstractUser):
+    groups = models.ManyToManyField(Group, related_name="siteuser_set", blank=True)
+    user_permissions = models.ManyToManyField(
+        Permission, related_name="siteuser_set", blank=True
+    )
+
+    user_theme_preference = models.CharField(
+        max_length=10, choices=settings.THEMES, default="light"
+    )
+
+    bio = models.TextField(blank=True, null=True)
+    rate = models.FloatField(blank=True, null=True)
+endef
+
+define DJANGO_SITEUSER_URLS
+from django.urls import path
+from .views import UserProfileView, UpdateThemePreferenceView, UserEditView
+
+urlpatterns = [
+    path("profile/", UserProfileView.as_view(), name="user-profile"),
+    path(
+        "update_theme_preference/",
+        UpdateThemePreferenceView.as_view(),
+        name="update_theme_preference",
+    ),
+    path("<int:pk>/edit/", UserEditView.as_view(), name="user-edit"),
+]
+endef
+
+define DJANGO_SITEUSER_VIEW
+import json
+
+from django.contrib.auth.mixins import LoginRequiredMixin
+from django.http import JsonResponse
+from django.utils.decorators import method_decorator
+from django.views import View
+from django.views.decorators.csrf import csrf_exempt
+from django.views.generic import DetailView
+from django.views.generic.edit import UpdateView
+from django.urls import reverse_lazy
+
+from .models import User
+from .forms import SiteUserForm
+
+
+class UserProfileView(LoginRequiredMixin, DetailView):
+    model = User
+    template_name = "profile.html"
+
+    def get_object(self, queryset=None):
+        return self.request.user
+
+
+@method_decorator(csrf_exempt, name="dispatch")
+class UpdateThemePreferenceView(View):
+    def post(self, request, *args, **kwargs):
+        try:
+            data = json.loads(request.body.decode("utf-8"))
+            new_theme = data.get("theme")
+            user = request.user
+            user.user_theme_preference = new_theme
+            user.save()
+            response_data = {"theme": new_theme}
+            return JsonResponse(response_data)
+        except json.JSONDecodeError as e:
+            return JsonResponse({"error": e}, status=400)
+
+    def http_method_not_allowed(self, request, *args, **kwargs):
+        return JsonResponse({"error": "Invalid request method"}, status=405)
+
+
+class UserEditView(LoginRequiredMixin, UpdateView):
+    model = User
+    template_name = "user_edit.html"  # Create this template in your templates folder
+    form_class = SiteUserForm
+
+    def get_success_url(self):
+        # return reverse_lazy("user-profile", kwargs={"pk": self.object.pk})
+        return reverse_lazy("user-profile")
+endef
+
+define DJANGO_SITEUSER_VIEW_TEMPLATE
+{% extends 'base.html' %}
+{% block content %}
+    <h2>User Profile</h2>
+    <div class="d-flex justify-content-end">
+        <a class="btn btn-outline-secondary"
+           href="{% url 'user-edit' pk=user.id %}">Edit</a>
+    </div>
+    <p>Username: {{ user.username }}</p>
+    <p>Theme: {{ user.user_theme_preference }}</p>
+    <p>Bio: {{ user.bio|default:""|safe }}</p>
+    <p>Rate: {{ user.rate|default:"" }}</p>
+{% endblock %}
+endef
+
+define DJANGO_URLS
+from django.contrib import admin
+from django.urls import path, include
+from django.conf import settings
+
+urlpatterns = [
+    path("django/", admin.site.urls),
+]
+endef
+
+define DJANGO_URLS_ALLAUTH
+urlpatterns += [path("accounts/", include("allauth.urls"))]
+endef
+
+define DJANGO_URLS_API
+from rest_framework import routers  # noqa
+from .api import UserViewSet, api  # noqa
+
+router = routers.DefaultRouter()
+router.register(r"users", UserViewSet)
+# urlpatterns += [path("api/", include(router.urls))]
+urlpatterns += [path("api/", api.urls)]
+endef
+
+define DJANGO_URLS_DEBUG_TOOLBAR
+if settings.DEBUG:
+    urlpatterns += [path("__debug__/", include("debug_toolbar.urls"))]
+endef
+
+define DJANGO_URLS_HOME_PAGE
+urlpatterns += [path("", include("home.urls"))]
+endef
+
+define DJANGO_URLS_LOGGING_DEMO
+urlpatterns += [path("logging-demo/", include("logging_demo.urls"))]
+endef
+
+define DJANGO_URLS_MODEL_FORM_DEMO
+urlpatterns += [path("model-form-demo/", include("model_form_demo.urls"))]
+endef
+
+define DJANGO_URLS_PAYMENTS
+urlpatterns += [path("payments/", include("payments.urls"))]
+endef
+
+define DJANGO_URLS_SITEUSER
+urlpatterns += [path("user/", include("siteuser.urls"))]
+endef
+
+define DJANGO_UTILS
+from django.urls import URLResolver
+import requests
+
+
+def get_ec2_metadata():
+    try:
+        # Step 1: Get the token
+        token_url = "http://169.254.169.254/latest/api/token"
+        headers = {"X-aws-ec2-metadata-token-ttl-seconds": "21600"}
+        response = requests.put(token_url, headers=headers)
+        response.raise_for_status()  # Raise an error for bad responses
+
+        token = response.text
+
+        # Step 2: Use the token to get the instance metadata
+        metadata_url = "http://169.254.169.254/latest/meta-data/local-ipv4"
+        headers = {"X-aws-ec2-metadata-token": token}
+        response = requests.get(metadata_url, headers=headers)
+        response.raise_for_status()  # Raise an error for bad responses
+
+        metadata = response.text
+        return metadata
+    except requests.RequestException as e:
+        print(f"Error retrieving EC2 metadata: {e}")
+        return None
+
+
+# Function to remove a specific URL pattern based on its route (including catch-all)
+def remove_urlpattern(urlpatterns, route_to_remove):
+    urlpatterns[:] = [
+        urlpattern
+        for urlpattern in urlpatterns
+        if not (
+            isinstance(urlpattern, URLResolver)
+            and urlpattern.pattern._route == route_to_remove
+        )
+    ]
+endef
+
+define EB_CUSTOM_ENV_EC2_USER
+files:
+    "/home/ec2-user/.bashrc":
+        mode: "000644"
+        owner: ec2-user
+        group: ec2-user
+        content: |
+            # .bashrc
+
+            # Source global definitions
+            if [ -f /etc/bashrc ]; then
+                    . /etc/bashrc
+            fi
+
+            # User specific aliases and functions
+            set -o vi
+
+            source <(sed -E -n 's/[^#]+/export &/ p' /opt/elasticbeanstalk/deployment/custom_env_var)
+endef
+
+define EB_CUSTOM_ENV_VAR_FILE
+#!/bin/bash
+
+# Via https://aws.amazon.com/premiumsupport/knowledge-center/elastic-beanstalk-env-variables-linux2/
+
+#Create a copy of the environment variable file.
+cat /opt/elasticbeanstalk/deployment/env | perl -p -e 's/(.*)=(.*)/export $$1="$$2"/;' > /opt/elasticbeanstalk/deployment/custom_env_var
+
+#Set permissions to the custom_env_var file so this file can be accessed by any user on the instance. You can restrict permissions as per your requirements.
+chmod 644 /opt/elasticbeanstalk/deployment/custom_env_var
+
+# add the virtual env path in.
+VENV=/var/app/venv/`ls /var/app/venv`
+cat <<EOF >> /opt/elasticbeanstalk/deployment/custom_env_var
+VENV=$$ENV
+EOF
+
+#Remove duplicate files upon deployment.
+rm -f /opt/elasticbeanstalk/deployment/*.bak
+endef
+
+define GIT_IGNORE
+__pycache__
+*.pyc
+dist/
+node_modules/
+_build/
+.elasticbeanstalk/
+db.sqlite3
+static/
+backend/var
+endef
+
+define JENKINS_FILE
+pipeline {
+    agent any
+    stages {
+        stage('') {
+            steps {
+                echo ''
+            }
+        }
+    }
+}
+endef
+
+define MAKEFILE_CUSTOM
+# Custom Makefile
+# Add your custom makefile commands here
+#
+# PROJECT_NAME := my-new-project
+endef
+
+define PIP_INSTALL_REQUIREMENTS_TEST
+pytest
+pytest-runner
+coverage
+pytest-mock
+pytest-cov
+hypothesis
+selenium
+pytest-django
+factory-boy
+flake8
+tox
+endef
+
+define PROGRAMMING_INTERVIEW
+from rich import print as rprint
+from rich.console import Console
+from rich.panel import Panel
+
+import argparse
+import locale
+import math
+import time
+
+import code  # noqa
+import readline  # noqa
+import rlcompleter  # noqa
+
+
+locale.setlocale(locale.LC_ALL, "en_US.UTF-8")
+
+
+class DataStructure:
+    # Data Structure: Binary Tree
+    class TreeNode:
+        def __init__(self, value=0, left=None, right=None):
+            self.value = value
+            self.left = left
+            self.right = right
+
+    # Data Structure: Stack
+    class Stack:
+        def __init__(self):
+            self.items = []
+
+        def push(self, item):
+            self.items.append(item)
+
+        def pop(self):
+            if not self.is_empty():
+                return self.items.pop()
+            return None
+
+        def peek(self):
+            if not self.is_empty():
+                return self.items[-1]
+            return None
+
+        def is_empty(self):
+            return len(self.items) == 0
+
+        def size(self):
+            return len(self.items)
+
+    # Data Structure: Queue
+    class Queue:
+        def __init__(self):
+            self.items = []
+
+        def enqueue(self, item):
+            self.items.append(item)
+
+        def dequeue(self):
+            if not self.is_empty():
+                return self.items.pop(0)
+            return None
+
+        def is_empty(self):
+            return len(self.items) == 0
+
+        def size(self):
+            return len(self.items)
+
+    # Data Structure: Linked List
+    class ListNode:
+        def __init__(self, value=0, next=None):
+            self.value = value
+            self.next = next
+
+
+class Interview(DataStructure):
+
+    # Protected methods for factorial calculation
+    def _factorial_recursive(self, n):
+        if n == 0:
+            return 1
+        return n * self._factorial_recursive(n - 1)
+
+    def _factorial_divide_and_conquer(self, low, high):
+        if low > high:
+            return 1
+        if low == high:
+            return low
+        mid = (low + high) // 2
+        return self._factorial_divide_and_conquer(
+            low, mid
+        ) * self._factorial_divide_and_conquer(mid + 1, high)
+
+    # Recursive Factorial with Timing
+    def factorial_recursive(self, n):
+        start_time = time.time()  # Start timing
+        result = self._factorial_recursive(n)  # Calculate factorial
+        end_time = time.time()  # End timing
+        elapsed_time = end_time - start_time
+        return f"  Factorial: {locale.format_string("%.2f", result, grouping=True)}  Elapsed time: {elapsed_time:.6f}"
+
+    # Iterative Factorial with Timing
+    def factorial_iterative(self, n):
+        start_time = time.time()  # Start timing
+        result = 1
+        for i in range(1, n + 1):
+            result *= i
+        end_time = time.time()  # End timing
+        elapsed_time = end_time - start_time
+        return f"  Factorial: {locale.format_string("%.2f", result, grouping=True)}  Elapsed time: {elapsed_time:.6f}"
+
+    # Divide and Conquer Factorial with Timing
+    def factorial_divide_and_conquer(self, n):
+        start_time = time.time()  # Start timing
+        result = self._factorial_divide_and_conquer(1, n)  # Calculate factorial
+        end_time = time.time()  # End timing
+        elapsed_time = end_time - start_time
+        return f"  Factorial: {locale.format_string("%.2f", result, grouping=True)}  Elapsed time: {elapsed_time:.6f}"
+
+    # Built-in Factorial with Timing
+    def factorial_builtin(self, n):
+        start_time = time.time()  # Start timing
+        result = math.factorial(n)  # Calculate factorial using built-in
+        end_time = time.time()  # End timing
+
+        # Calculate elapsed time
+        elapsed_time = end_time - start_time
+
+        # Print complexity and runtime
+        return f"  Factorial: {locale.format_string("%.2f", result, grouping=True)}  Elapsed time: {elapsed_time:.6f}"
+
+    # Recursion: Fibonacci
+    def fibonacci_recursive(self, n):
+        if n <= 1:
+            return n
+        return self.fibonacci_recursive(n - 1) + self.fibonacci_recursive(n - 2)
+
+    # Iteration: Fibonacci
+    def fibonacci_iterative(self, n):
+        if n <= 1:
+            return n
+        a, b = 0, 1
+        for _ in range(n - 1):
+            a, b = b, a + b
+        return b
+
+    # Searching: Linear Search
+    def linear_search(self, arr, target):
+        for i, value in enumerate(arr):
+            if value == target:
+                return i
+        return -1
+
+    # Searching: Binary Search
+    def binary_search(self, arr, target):
+        left, right = 0, len(arr) - 1
+        while left <= right:
+            mid = (left + right) // 2
+            if arr[mid] == target:
+                return mid
+            elif arr[mid] < target:
+                left = mid + 1
+            else:
+                right = mid - 1
+        return -1
+
+    # Sorting: Bubble Sort
+    def bubble_sort(self, arr):
+        n = len(arr)
+        for i in range(n):
+            for j in range(0, n - i - 1):
+                if arr[j] > arr[j + 1]:
+                    arr[j], arr[j + 1] = arr[j + 1], arr[j]
+        return arr
+
+    # Sorting: Merge Sort
+    def merge_sort(self, arr):
+        if len(arr) > 1:
+            mid = len(arr) // 2
+            left_half = arr[:mid]
+            right_half = arr[mid:]
+
+            self.merge_sort(left_half)
+            self.merge_sort(right_half)
+
+            i = j = k = 0
+
+            while i < len(left_half) and j < len(right_half):
+                if left_half[i] < right_half[j]:
+                    arr[k] = left_half[i]
+                    i += 1
+                else:
+                    arr[k] = right_half[j]
+                    j += 1
+                k += 1
+
+            while i < len(left_half):
+                arr[k] = left_half[i]
+                i += 1
+                k += 1
+
+            while j < len(right_half):
+                arr[k] = right_half[j]
+                j += 1
+                k += 1
+        return arr
+
+    def insert_linked_list(self, head, value):
+        new_node = self.ListNode(value)
+        if not head:
+            return new_node
+        current = head
+        while current.next:
+            current = current.next
+        current.next = new_node
+        return head
+
+    def print_linked_list(self, head):
+        current = head
+        while current:
+            print(current.value, end=" -> ")
+            current = current.next
+        print("None")
+
+    def inorder_traversal(self, root):
+        return (
+            self.inorder_traversal(root.left)
+            + [root.value]
+            + self.inorder_traversal(root.right)
+            if root
+            else []
+        )
+
+    def preorder_traversal(self, root):
+        return (
+            [root.value]
+            + self.preorder_traversal(root.left)
+            + self.preorder_traversal(root.right)
+            if root
+            else []
+        )
+
+    def postorder_traversal(self, root):
+        return (
+            self.postorder_traversal(root.left)
+            + self.postorder_traversal(root.right)
+            + [root.value]
+            if root
+            else []
+        )
+
+    # Graph Algorithms: Depth-First Search
+    def dfs(self, graph, start):
+        visited, stack = set(), [start]
+        while stack:
+            vertex = stack.pop()
+            if vertex not in visited:
+                visited.add(vertex)
+                stack.extend(set(graph[vertex]) - visited)
+        return visited
+
+    # Graph Algorithms: Breadth-First Search
+    def bfs(self, graph, start):
+        visited, queue = set(), [start]
+        while queue:
+            vertex = queue.pop(0)
+            if vertex not in visited:
+                visited.add(vertex)
+                queue.extend(set(graph[vertex]) - visited)
+        return visited
+
+
+def setup_readline(local):
+
+    # Enable tab completion
+    readline.parse_and_bind("tab: complete")
+    # Optionally, you can set the completer function manually
+    readline.set_completer(rlcompleter.Completer(local).complete)
+
+
+def main():
+
+    console = Console()
+    interview = Interview()
+
+    parser = argparse.ArgumentParser(description="Programming Interview Questions")
+
+    parser.add_argument(
+        "-f", "--factorial", type=int, help="Factorial algorithm examples"
+    )
+    parser.add_argument("--fibonacci", type=int, help="Fibonacci algorithm examples")
+    parser.add_argument(
+        "--search", action="store_true", help="Search algorithm examples"
+    )
+    parser.add_argument("--sort", action="store_true", help="Search algorithm examples")
+    parser.add_argument("--stack", action="store_true", help="Stack algorithm examples")
+    parser.add_argument("--queue", action="store_true", help="Queue algorithm examples")
+    parser.add_argument(
+        "--list", action="store_true", help="Linked List algorithm examples"
+    )
+    parser.add_argument(
+        "--tree", action="store_true", help="Tree traversal algorithm examples"
+    )
+    parser.add_argument("--graph", action="store_true", help="Graph algorithm examples")
+    parser.add_argument(
+        "-i", "--interactive", action="store_true", help="Interactive mode"
+    )
+
+    args = parser.parse_args()
+
+    if args.factorial:
+        # Factorial examples
+        console.rule("Factorial Examples")
+        rprint(
+            Panel(
+                "[bold cyan]Recursive Factorial - Time Complexity: O(n)[/bold cyan]\n"
+                + str(interview.factorial_recursive(args.factorial)),
+                title="Factorial Recursive",
+            )
+        )
+        rprint(
+            Panel(
+                "[bold cyan]Iterative Factorial - Time Complexity: O(n)[/bold cyan]\n"
+                + str(interview.factorial_iterative(args.factorial)),
+                title="Factorial Iterative",
+            )
+        )
+        rprint(
+            Panel(
+                "[bold cyan]Built-in Factorial - Time Complexity: O(n)[/bold cyan]\n"
+                + str(interview.factorial_builtin(args.factorial)),
+                title="Factorial Built-in",
+            )
+        )
+        rprint(
+            Panel(
+                "[bold cyan]Divide and Conquer Factorial - Time Complexity: O(n log n)[/bold cyan]\n"
+                + str(interview.factorial_divide_and_conquer(args.factorial)),
+                title="Factorial Divide and Conquer",
+            )
+        )
+        exit()
+
+    if args.fibonacci:
+        # Fibonacci examples
+        console.rule("Fibonacci Examples")
+        rprint(
+            Panel(
+                str(interview.fibonacci_recursive(args.fibonacci)),
+                title="Fibonacci Recursive",
+            )
+        )
+        rprint(
+            Panel(
+                str(interview.fibonacci_iterative(args.fibonacci)),
+                title="Fibonacci Iterative",
+            )
+        )
+        exit()
+
+    if args.search:
+        # Searching examples
+        console.rule("Searching Examples")
+        array = [1, 3, 5, 7, 9]
+        rprint(Panel(str(interview.linear_search(array, 5)), title="Linear Search"))
+        rprint(Panel(str(interview.binary_search(array, 5)), title="Binary Search"))
+        exit()
+
+    if args.sort:
+        # Sorting examples
+        console.rule("Sorting Examples")
+        unsorted_array = [64, 34, 25, 12, 22, 11, 90]
+        rprint(
+            Panel(
+                str(interview.bubble_sort(unsorted_array.copy())), title="Bubble Sort"
+            )
+        )
+        rprint(
+            Panel(str(interview.merge_sort(unsorted_array.copy())), title="Merge Sort")
+        )
+        exit()
+
+    if args.stack:
+        # Stack example
+        console.rule("Stack Example")
+        stack = interview.Stack()
+        stack.push(1)
+        stack.push(2)
+        stack.push(3)
+        rprint(Panel(str(stack.pop()), title="Stack Pop"))
+        rprint(Panel(str(stack.peek()), title="Stack Peek"))
+        rprint(Panel(str(stack.size()), title="Stack Size"))
+
+    if args.queue:
+        # Queue example
+        console.rule("Queue Example")
+        queue = interview.Queue()
+        queue.enqueue(1)
+        queue.enqueue(2)
+        queue.enqueue(3)
+        rprint(Panel(str(queue.dequeue()), title="Queue Dequeue"))
+        rprint(Panel(str(queue.is_empty()), title="Queue Is Empty"))
+        rprint(Panel(str(queue.size()), title="Queue Size"))
+
+    if args.list:
+        # Linked List example
+        console.rule("Linked List Example")
+        head = None
+        head = interview.insert_linked_list(head, 1)
+        head = interview.insert_linked_list(head, 2)
+        head = interview.insert_linked_list(head, 3)
+        interview.print_linked_list(head)  # Output: 1 -> 2 -> 3 -> None
+
+    if args.tree:
+        # Tree Traversal example
+        console.rule("Tree Traversal Example")
+        root = interview.TreeNode(1)
+        root.left = interview.TreeNode(2)
+        root.right = interview.TreeNode(3)
+        root.left.left = interview.TreeNode(4)
+        root.left.right = interview.TreeNode(5)
+        rprint(Panel(str(interview.inorder_traversal(root)), title="Inorder Traversal"))
+        rprint(
+            Panel(str(interview.preorder_traversal(root)), title="Preorder Traversal")
+        )
+        rprint(
+            Panel(str(interview.postorder_traversal(root)), title="Postorder Traversal")
+        )
+
+    if args.graph:
+        # Graph Algorithms example
+        console.rule("Graph Algorithms Example")
+        graph = {
+            "A": ["B", "C"],
+            "B": ["A", "D", "E"],
+            "C": ["A", "F"],
+            "D": ["B"],
+            "E": ["B", "F"],
+            "F": ["C", "E"],
+        }
+        rprint(Panel(str(interview.dfs(graph, "A")), title="DFS"))
+        rprint(Panel(str(interview.bfs(graph, "A")), title="BFS"))
+
+    if args.interactive:
+        # Starting interactive session with tab completion
+        setup_readline(locals())
+        banner = "Interactive programming interview session started. Type 'exit()' or 'Ctrl-D' to exit."
+        code.interact(
+            banner=banner,
+            local=locals(),
+            exitmsg="Great interview!",
+        )
+
+
+if __name__ == "__main__":
+    main()
+
+endef
+
+define PYTHON_CI_YAML
+name: Build Wheels
+endef
+
+define PYTHON_LICENSE_TXT
+MIT License
+
+Copyright (c) [YEAR] [OWNER NAME]
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.
+endef
+
+define PYTHON_PROJECT_TOML
+[build-system]
+endef
+
+define SEPARATOR
+.==========================================================================================================================================.
+|                                                                                                                                          |  
+| _|_|_|                        _|                        _|          _|      _|            _|                      _|_|  _|  _|           | 
+| _|    _|  _|  _|_|    _|_|          _|_|      _|_|_|  _|_|_|_|      _|_|  _|_|    _|_|_|  _|  _|      _|_|      _|          _|    _|_|   |
+| _|_|_|    _|_|      _|    _|  _|  _|_|_|_|  _|          _|          _|  _|  _|  _|    _|  _|_|      _|_|_|_|  _|_|_|_|  _|  _|  _|_|_|_| |
+| _|        _|        _|    _|  _|  _|        _|          _|          _|      _|  _|    _|  _|  _|    _|          _|      _|  _|  _|       |
+| _|        _|          _|_|    _|    _|_|_|    _|_|_|      _|_|      _|      _|    _|_|_|  _|    _|    _|_|_|    _|      _|  _|    _|_|_| |
+|                               _|                                                                                                         |
+|                             _|                                                                                                           |
+`=========================================================================================================================================='
+endef
+
+define TINYMCE_JS
+import tinymce from 'tinymce';
+import 'tinymce/icons/default';
+import 'tinymce/themes/silver';
+import 'tinymce/skins/ui/oxide/skin.css';
+import 'tinymce/plugins/advlist';
+import 'tinymce/plugins/code';
+import 'tinymce/plugins/emoticons';
+import 'tinymce/plugins/emoticons/js/emojis';
+import 'tinymce/plugins/link';
+import 'tinymce/plugins/lists';
+import 'tinymce/plugins/table';
+import 'tinymce/models/dom';
+
+tinymce.init({
+  selector: 'textarea#editor',
+  plugins: 'advlist code emoticons link lists table',
+  toolbar: 'bold italic | bullist numlist | link emoticons',
+  skin: false,
+  content_css: false,
+});
+endef
+
+define WAGTAIL_BASE_TEMPLATE
+{% load static wagtailcore_tags wagtailuserbar webpack_loader %}
+<!DOCTYPE html>
+<html lang="en"
+      class="h-100"
+      data-bs-theme="{{ request.user.user_theme_preference|default:'light' }}">
+    <head>
+        <meta charset="utf-8" />
+        <title>
+            {% block title %}
+                {% if page.seo_title %}
+                    {{ page.seo_title }}
+                {% else %}
+                    {{ page.title }}
+                {% endif %}
+            {% endblock %}
+            {% block title_suffix %}
+                {% wagtail_site as current_site %}
+                {% if current_site and current_site.site_name %}- {{ current_site.site_name }}{% endif %}
+            {% endblock %}
+        </title>
+        {% if page.search_description %}<meta name="description" content="{{ page.search_description }}" />{% endif %}
+        <meta name="viewport" content="width=device-width, initial-scale=1" />
+        {# Force all links in the live preview panel to be opened in a new tab #}
+        {% if request.in_preview_panel %}<base target="_blank">{% endif %}
+        {% stylesheet_pack 'app' %}
+        {% block extra_css %}{# Override this in templates to add extra stylesheets #}{% endblock %}
+        <style>
+            .success {
+                background-color: #d4edda;
+                border-color: #c3e6cb;
+                color: #155724;
+            }
+
+            .info {
+                background-color: #d1ecf1;
+                border-color: #bee5eb;
+                color: #0c5460;
+            }
+
+            .warning {
+                background-color: #fff3cd;
+                border-color: #ffeeba;
+                color: #856404;
+            }
+
+            .danger {
+                background-color: #f8d7da;
+                border-color: #f5c6cb;
+                color: #721c24;
+            }
+        </style>
+        {% include 'favicon.html' %}
+        {% csrf_token %}
+    </head>
+    <body class="{% block body_class %}{% endblock %} d-flex flex-column h-100">
+        <main class="flex-shrink-0">
+            {% wagtailuserbar %}
+            <div id="app"></div>
+            {% include 'header.html' %}
+            {% if messages %}
+                <div class="messages container">
+                    {% for message in messages %}
+                        <div class="alert {{ message.tags }} alert-dismissible fade show"
+                             role="alert">
+                            {{ message }}
+                            <button type="button"
+                                    class="btn-close"
+                                    data-bs-dismiss="alert"
+                                    aria-label="Close"></button>
+                        </div>
+                    {% endfor %}
+                </div>
+            {% endif %}
+            <div class="container">
+                {% block content %}{% endblock %}
+            </div>
+        </main>
+        {% include 'footer.html' %}
+        {% include 'offcanvas.html' %}
+        {% javascript_pack 'app' %}
+        {% block extra_js %}{# Override this in templates to add extra javascript #}{% endblock %}
+    </body>
+</html>
+endef
+
+define WAGTAIL_BLOCK_CAROUSEL
+<div id="carouselExampleCaptions" class="carousel slide">
+    <div class="carousel-indicators">
+        {% for image in block.value.images %}
+            <button type="button"
+                    data-bs-target="#carouselExampleCaptions"
+                    data-bs-slide-to="{{ forloop.counter0 }}"
+                    {% if forloop.first %}class="active" aria-current="true"{% endif %}
+                    aria-label="Slide {{ forloop.counter }}"></button>
+        {% endfor %}
+    </div>
+    <div class="carousel-inner">
+        {% for image in block.value.images %}
+            <div class="carousel-item {% if forloop.first %}active{% endif %}">
+                <img src="{{ image.file.url }}" class="d-block w-100" alt="...">
+                <div class="carousel-caption d-none d-md-block">
+                    <h5>{{ image.title }}</h5>
+                </div>
+            </div>
+        {% endfor %}
+    </div>
+    <button class="carousel-control-prev"
+            type="button"
+            data-bs-target="#carouselExampleCaptions"
+            data-bs-slide="prev">
+        <span class="carousel-control-prev-icon" aria-hidden="true"></span>
+        <span class="visually-hidden">Previous</span>
+    </button>
+    <button class="carousel-control-next"
+            type="button"
+            data-bs-target="#carouselExampleCaptions"
+            data-bs-slide="next">
+        <span class="carousel-control-next-icon" aria-hidden="true"></span>
+        <span class="visually-hidden">Next</span>
+    </button>
+</div>
+endef
+
+define WAGTAIL_BLOCK_MARKETING
+{% load wagtailcore_tags %}
+<div class="{{ self.block_class }}">
+    {% if block.value.images.0 %}
+        {% include 'blocks/carousel_block.html' %}
+    {% else %}
+        {{ self.title }}
+        {{ self.content }}
+    {% endif %}
+</div>
+endef
+
+define WAGTAIL_CONTACT_PAGE_LANDING
+{% extends 'base.html' %}
+{% block content %}<div class="container"><h1>Thank you!</h1></div>{% endblock %}
+endef
+
+define WAGTAIL_CONTACT_PAGE_MODEL
+from django.db import models
+from modelcluster.fields import ParentalKey
+from wagtail.admin.panels import (
+    FieldPanel, FieldRowPanel,
+    InlinePanel, MultiFieldPanel
+)
+from wagtail.fields import RichTextField
+from wagtail.contrib.forms.models import AbstractEmailForm, AbstractFormField
+
+
+class FormField(AbstractFormField):
+    page = ParentalKey('ContactPage', on_delete=models.CASCADE, related_name='form_fields')
+
+
+class ContactPage(AbstractEmailForm):
+    intro = RichTextField(blank=True)
+    thank_you_text = RichTextField(blank=True)
+
+    content_panels = AbstractEmailForm.content_panels + [
+        FieldPanel('intro'),
+        InlinePanel('form_fields', label="Form fields"),
+        FieldPanel('thank_you_text'),
+        MultiFieldPanel([
+            FieldRowPanel([
+                FieldPanel('from_address', classname="col6"),
+                FieldPanel('to_address', classname="col6"),
+            ]),
+            FieldPanel('subject'),
+        ], "Email"),
+    ]
+
+    class Meta:
+        verbose_name = "Contact Page"
+endef
+
+define WAGTAIL_CONTACT_PAGE_TEMPLATE
+{% extends 'base.html' %}
+{% load crispy_forms_tags static wagtailcore_tags %}
+{% block content %}
+        <h1>{{ page.title }}</h1>
+        {{ page.intro|richtext }}
+        <form action="{% pageurl page %}" method="POST">
+            {% csrf_token %}
+            {{ form.as_p }}
+            <input type="submit">
+        </form>
+{% endblock %}
+endef
+
+define WAGTAIL_CONTACT_PAGE_TEST
+from django.test import TestCase
+from wagtail.test.utils import WagtailPageTestCase
+from wagtail.models import Page
+
+from contactpage.models import ContactPage, FormField
+
+class ContactPageTest(TestCase, WagtailPageTestCase):
+    def test_contact_page_creation(self):
+        # Create a ContactPage instance
+        contact_page = ContactPage(
+            title='Contact',
+            intro='Welcome to our contact page!',
+            thank_you_text='Thank you for reaching out.'
+        )
+
+        # Save the ContactPage instance
+        self.assertEqual(contact_page.save_revision().publish().get_latest_revision_as_page(), contact_page)
+
+    def test_form_field_creation(self):
+        # Create a ContactPage instance
+        contact_page = ContactPage(
+            title='Contact',
+            intro='Welcome to our contact page!',
+            thank_you_text='Thank you for reaching out.'
+        )
+        # Save the ContactPage instance
+        contact_page_revision = contact_page.save_revision()
+        contact_page_revision.publish()
+
+        # Create a FormField associated with the ContactPage
+        form_field = FormField(
+            page=contact_page,
+            label='Your Name',
+            field_type='singleline',
+            required=True
+        )
+        form_field.save()
+
+        # Retrieve the ContactPage from the database
+        contact_page_from_db = Page.objects.get(id=contact_page.id).specific
+
+        # Check if the FormField is associated with the ContactPage
+        self.assertEqual(contact_page_from_db.form_fields.first(), form_field)
+
+    def test_contact_page_form_submission(self):
+        # Create a ContactPage instance
+        contact_page = ContactPage(
+            title='Contact',
+            intro='Welcome to our contact page!',
+            thank_you_text='Thank you for reaching out.'
+        )
+        # Save the ContactPage instance
+        contact_page_revision = contact_page.save_revision()
+        contact_page_revision.publish()
+
+        # Simulate a form submission
+        form_data = {
+            'your_name': 'John Doe',
+            # Add other form fields as needed
+        }
+
+        response = self.client.post(contact_page.url, form_data)
+
+        # Check if the form submission is successful (assuming a 302 redirect)
+        self.assertEqual(response.status_code, 302)
+        
+        # You may add more assertions based on your specific requirements
+endef
+
+define WAGTAIL_HEADER_PREFIX
+{% load wagtailcore_tags %}
+{% wagtail_site as current_site %}
+endef 
+
+define WAGTAIL_HOME_PAGE_MODEL
+from wagtail.models import Page
+from wagtail.fields import StreamField
+from wagtail import blocks
+from wagtail.admin.panels import FieldPanel
+from wagtail.images.blocks import ImageChooserBlock
+
+
+class MarketingBlock(blocks.StructBlock):
+    title = blocks.CharBlock(required=False, help_text="Enter the block title")
+    content = blocks.RichTextBlock(required=False, help_text="Enter the block content")
+    images = blocks.ListBlock(
+        ImageChooserBlock(required=False),
+        help_text="Select one or two images for column display. Select three or more images for carousel display.",
+    )
+    image = ImageChooserBlock(
+        required=False, help_text="Select one image for background display."
+    )
+    block_class = blocks.CharBlock(
+        required=False,
+        help_text="Enter a CSS class for styling the marketing block",
+        classname="full title",
+        default="vh-100 bg-secondary",
+    )
+    image_class = blocks.CharBlock(
+        required=False,
+        help_text="Enter a CSS class for styling the column display image(s)",
+        classname="full title",
+        default="img-thumbnail p-5",
+    )
+    layout_class = blocks.CharBlock(
+        required=False,
+        help_text="Enter a CSS class for styling the layout.",
+        classname="full title",
+        default="d-flex flex-row",
+    )
+
+    class Meta:
+        icon = "placeholder"
+        template = "blocks/marketing_block.html"
+
+
+class HomePage(Page):
+    template = "home/home_page.html"  # Create a template for rendering the home page
+
+    marketing_blocks = StreamField(
+        [
+            ("marketing_block", MarketingBlock()),
+        ],
+        blank=True,
+        null=True,
+        use_json_field=True,
+    )
+    content_panels = Page.content_panels + [
+        FieldPanel("marketing_blocks"),
+    ]
+
+    class Meta:
+        verbose_name = "Home Page"
+endef
+
+define WAGTAIL_HOME_PAGE_TEMPLATE
+{% extends "base.html" %}
+{% load wagtailcore_tags %}
+{% block content %}
+    <main class="{% block main_class %}{% endblock %}">
+        {% for block in page.marketing_blocks %}
+            {% include_block block %}
+        {% endfor %}
+    </main>
+{% endblock %}
+endef
+
+define WAGTAIL_PRIVACY_PAGE_MODEL
+from wagtail.models import Page
+from wagtail.admin.panels import FieldPanel
+from wagtailmarkdown.fields import MarkdownField
+
+
+class PrivacyPage(Page):
+    """
+    A Wagtail Page model for the Privacy Policy page.
+    """
+
+    template = "privacy_page.html"
+
+    body = MarkdownField()
+
+    content_panels = Page.content_panels + [
+        FieldPanel("body", classname="full"),
+    ]
+
+    class Meta:
+        verbose_name = "Privacy Page"
+endef
+
+define WAGTAIL_PRIVACY_PAGE_TEMPLATE
+{% extends 'base.html' %}
+{% load wagtailmarkdown %}
+{% block content %}<div class="container">{{ page.body|markdown }}</div>{% endblock %}
+endef
+
+define WAGTAIL_SEARCH_TEMPLATE
+{% extends "base.html" %}
+{% load static wagtailcore_tags %}
+{% block body_class %}template-searchresults{% endblock %}
+{% block title %}Search{% endblock %}
+{% block content %}
+    <h1>Search</h1>
+    <form action="{% url 'search' %}" method="get">
+        <input type="text"
+               name="query"
+               {% if search_query %}value="{{ search_query }}"{% endif %}>
+        <input type="submit" value="Search" class="button">
+    </form>
+    {% if search_results %}
+        <ul>
+            {% for result in search_results %}
+                <li>
+                    <h4>
+                        <a href="{% pageurl result %}">{{ result }}</a>
+                    </h4>
+                    {% if result.search_description %}{{ result.search_description }}{% endif %}
+                </li>
+            {% endfor %}
+        </ul>
+        {% if search_results.has_previous %}
+            <a href="{% url 'search' %}?query={{ search_query|urlencode }}&amp;page={{ search_results.previous_page_number }}">Previous</a>
+        {% endif %}
+        {% if search_results.has_next %}
+            <a href="{% url 'search' %}?query={{ search_query|urlencode }}&amp;page={{ search_results.next_page_number }}">Next</a>
+        {% endif %}
+    {% elif search_query %}
+        No results found
+    {% else %}
+        No results found. Try a <a href="?query=test">test query</a>?
+    {% endif %}
+{% endblock %}
+endef
+
+define WAGTAIL_SEARCH_URLS
+from django.urls import path
+from .views import search
+
+urlpatterns = [path("", search, name="search")]
+endef
+
+define WAGTAIL_SETTINGS
+INSTALLED_APPS.append("wagtail_color_panel")
+INSTALLED_APPS.append("wagtail_modeladmin")
+INSTALLED_APPS.append("wagtail.contrib.settings")
+INSTALLED_APPS.append("wagtailmarkdown")
+INSTALLED_APPS.append("wagtailmenus")
+INSTALLED_APPS.append("wagtailseo")
+TEMPLATES[0]["OPTIONS"]["context_processors"].append(
+    "wagtail.contrib.settings.context_processors.settings"
+)
+TEMPLATES[0]["OPTIONS"]["context_processors"].append(
+    "wagtailmenus.context_processors.wagtailmenus"
+)
+endef
+
+define WAGTAIL_SITEPAGE_MODEL
+from wagtail.models import Page
+
+
+class SitePage(Page):
+    template = "sitepage/site_page.html"
+
+    class Meta:
+        verbose_name = "Site Page"
+endef
+
+define WAGTAIL_SITEPAGE_TEMPLATE
+{% extends 'base.html' %}
+{% block content %}
+    <h1>{{ page.title }}</h1>
+{% endblock %}
+endef
+
+define WAGTAIL_URLS
+from django.conf import settings
+from django.urls import include, path
+from django.contrib import admin
+
+from wagtail.admin import urls as wagtailadmin_urls
+from wagtail.documents import urls as wagtaildocs_urls
+
+from search import views as search_views
+
+urlpatterns = [
+    path("django/", admin.site.urls),
+    path("wagtail/", include(wagtailadmin_urls)),
+    path("documents/", include(wagtaildocs_urls)),
+    path("search/", search_views.search, name="search"),
+]
+
+if settings.DEBUG:
+    from django.conf.urls.static import static
+    from django.contrib.staticfiles.urls import staticfiles_urlpatterns
+
+    # Serve static and media files from development server
+    urlpatterns += staticfiles_urlpatterns()
+    urlpatterns += static(settings.MEDIA_URL, document_root=settings.MEDIA_ROOT)
+endef
+
+define WAGTAIL_URLS_HOME
+urlpatterns += [
+    # For anything not caught by a more specific rule above, hand over to
+    # Wagtail's page serving mechanism. This should be the last pattern in
+    # the list:
+    path("", include("wagtail.urls")),
+    # Alternatively, if you want Wagtail pages to be served from a subpath
+    # of your site, rather than the site root:
+    #    path("pages/", include("wagtail.urls"),
+]
+endef
+
+define WEBPACK_CONFIG_JS
+const path = require('path');
+
+module.exports = {
+  mode: 'development',
+  entry: './src/index.js',
+  output: {
+    filename: 'bundle.js',
+    path: path.resolve(__dirname, 'dist'),
+  },
+};
+endef
+
+define WEBPACK_INDEX_HTML
+<!DOCTYPE html>
+<html lang="en">
+<head>
+  <meta charset="UTF-8">
+  <meta name="viewport" content="width=device-width, initial-scale=1.0">
+  <title>Hello, Webpack!</title>
+</head>
+<body>
+  <script src="dist/bundle.js"></script>
+</body>
+</html>
+endef
+
+define WEBPACK_INDEX_JS
+const message = "Hello, World!";
+console.log(message);
+endef
+
+define WEBPACK_REVEAL_CONFIG_JS
+const path = require('path');
+const MiniCssExtractPlugin = require('mini-css-extract-plugin');
+
+module.exports = {
+  mode: 'development',
+  entry: './src/index.js',
+  output: {
+    filename: 'bundle.js',
+    path: path.resolve(__dirname, 'dist'),
+  },
+  module: {
+    rules: [
+      {
+        test: /\.css$$/,
+        use: [MiniCssExtractPlugin.loader, 'css-loader'],
+      },
+    ],
+  },
+  plugins: [
+    new MiniCssExtractPlugin({
+      filename: 'bundle.css',
+    }),
+  ],
+};
+endef
+
+define WEBPACK_REVEAL_INDEX_HTML
+<!DOCTYPE html>
+<html>
+    <head>
+        <meta charset="UTF-8">
+        <meta name="viewport" content="width=device-width, initial-scale=1.0">
+        <title>Project Makefile</title>
+        <link rel="stylesheet" href="dist/bundle.css">
+    </head>
+    <div class="reveal">
+        <div class="slides">
+            <section>
+                Slide 1: Draw some circles
+            </section>
+            <section>
+                Slide 2: Draw the rest of the owl
+            </section>
+        </div>
+    </div>
+    <script src="dist/bundle.js"></script>
+</html>
+endef
+
+define WEBPACK_REVEAL_INDEX_JS
+import 'reveal.js/dist/reveal.css';
+import 'reveal.js/dist/theme/black.css';
+import Reveal from 'reveal.js';
+import RevealNotes from 'reveal.js/plugin/notes/notes.js';
+Reveal.initialize({ slideNumber: true, plugins: [ RevealNotes ]});
+endef
+
+# ------------------------------------------------------------------------------  
+# Export variables used by phony target rules
+# ------------------------------------------------------------------------------  
+
+export DJANGO_ALLAUTH_BASE_TEMPLATE
+export DJANGO_API_SERIALIZERS
+export DJANGO_API_VIEWS
+export DJANGO_APP_TESTS
+export DJANGO_BACKEND_APPS
+export DJANGO_BASE_TEMPLATE
+export DJANGO_CUSTOM_ADMIN
+export DJANGO_DOCKERCOMPOSE
+export DJANGO_DOCKERFILE
+export DJANGO_FAVICON_TEMPLATE
+export DJANGO_FOOTER_TEMPLATE
+export DJANGO_FRONTEND_APP
+export DJANGO_FRONTEND_APP_CONFIG
+export DJANGO_FRONTEND_BABELRC
+export DJANGO_FRONTEND_COMPONENTS
+export DJANGO_FRONTEND_COMPONENT_CLOCK
+export DJANGO_FRONTEND_COMPONENT_ERROR
+export DJANGO_FRONTEND_COMPONENT_USER_MENU
+export DJANGO_FRONTEND_CONTEXT_INDEX
+export DJANGO_FRONTEND_CONTEXT_USER_PROVIDER
+export DJANGO_FRONTEND_ESLINTRC
+export DJANGO_FRONTEND_OFFCANVAS_TEMPLATE
+export DJANGO_FRONTEND_PORTAL
+export DJANGO_FRONTEND_STYLES
+export DJANGO_FRONTEND_THEME_BLUE
+export DJANGO_FRONTEND_THEME_TOGGLER
+export DJANGO_HEADER_TEMPLATE
+export DJANGO_HOME_PAGE_ADMIN
+export DJANGO_HOME_PAGE_MODELS
+export DJANGO_HOME_PAGE_TEMPLATE
+export DJANGO_HOME_PAGE_URLS
+export DJANGO_HOME_PAGE_VIEWS
+export DJANGO_LOGGING_DEMO_ADMIN
+export DJANGO_LOGGING_DEMO_MODELS
+export DJANGO_LOGGING_DEMO_SETTINGS
+export DJANGO_LOGGING_DEMO_URLS
+export DJANGO_LOGGING_DEMO_VIEWS
+export DJANGO_MANAGE_PY
+export DJANGO_MODEL_FORM_DEMO_ADMIN
+export DJANGO_MODEL_FORM_DEMO_FORMS
+export DJANGO_MODEL_FORM_DEMO_MODEL
+export DJANGO_MODEL_FORM_DEMO_TEMPLATE_DETAIL
+export DJANGO_MODEL_FORM_DEMO_TEMPLATE_FORM
+export DJANGO_MODEL_FORM_DEMO_TEMPLATE_LIST
+export DJANGO_MODEL_FORM_DEMO_URLS
+export DJANGO_MODEL_FORM_DEMO_VIEWS
+export DJANGO_PAYMENTS_ADMIN
+export DJANGO_PAYMENTS_FORM
+export DJANGO_PAYMENTS_MIGRATION_0002
+export DJANGO_PAYMENTS_MIGRATION_0003
+export DJANGO_PAYMENTS_MODELS
+export DJANGO_PAYMENTS_TEMPLATE_CANCEL
+export DJANGO_PAYMENTS_TEMPLATE_CHECKOUT
+export DJANGO_PAYMENTS_TEMPLATE_PRODUCT_DETAIL
+export DJANGO_PAYMENTS_TEMPLATE_PRODUCT_LIST
+export DJANGO_PAYMENTS_TEMPLATE_SUCCESS
+export DJANGO_PAYMENTS_URLS
+export DJANGO_PAYMENTS_VIEW
+export DJANGO_SEARCH_FORMS
+export DJANGO_SEARCH_SETTINGS
+export DJANGO_SEARCH_TEMPLATE
+export DJANGO_SEARCH_URLS
+export DJANGO_SEARCH_UTILS
+export DJANGO_SEARCH_VIEWS
+export DJANGO_SETTINGS_AUTHENTICATION_BACKENDS
+export DJANGO_SETTINGS_BASE
+export DJANGO_SETTINGS_BASE_MINIMAL
+export DJANGO_SETTINGS_CRISPY_FORMS
+export DJANGO_SETTINGS_DATABASE
+export DJANGO_SETTINGS_DEV
+export DJANGO_SETTINGS_HOME_PAGE
+export DJANGO_SETTINGS_INSTALLED_APPS
+export DJANGO_SETTINGS_MIDDLEWARE
+export DJANGO_SETTINGS_MODEL_FORM_DEMO
+export DJANGO_SETTINGS_PAYMENTS
+export DJANGO_SETTINGS_PROD
+export DJANGO_SETTINGS_REST_FRAMEWORK
+export DJANGO_SETTINGS_SITEUSER
+export DJANGO_SETTINGS_THEMES
+export DJANGO_SITEUSER_ADMIN
+export DJANGO_SITEUSER_EDIT_TEMPLATE
+export DJANGO_SITEUSER_FORM
+export DJANGO_SITEUSER_MODEL
+export DJANGO_SITEUSER_URLS
+export DJANGO_SITEUSER_VIEW
+export DJANGO_SITEUSER_VIEW_TEMPLATE
+export DJANGO_URLS
+export DJANGO_URLS_ALLAUTH
+export DJANGO_URLS_API
+export DJANGO_URLS_DEBUG_TOOLBAR
+export DJANGO_URLS_HOME_PAGE
+export DJANGO_URLS_LOGGING_DEMO
+export DJANGO_URLS_MODEL_FORM_DEMO
+export DJANGO_URLS_SITEUSER
+export DJANGO_UTILS
+export EB_CUSTOM_ENV_EC2_USER
+export EB_CUSTOM_ENV_VAR_FILE
+export GIT_IGNORE
+export JENKINS_FILE
+export MAKEFILE_CUSTOM
+export PIP_INSTALL_REQUIREMENTS_TEST
+export PROGRAMMING_INTERVIEW
+export PYTHON_CI_YAML
+export PYTHON_LICENSE_TXT
+export PYTHON_PROJECT_TOML
+export SEPARATOR
+export TINYMCE_JS
+export WAGTAIL_BASE_TEMPLATE
+export WAGTAIL_BLOCK_CAROUSEL
+export WAGTAIL_BLOCK_MARKETING
+export WAGTAIL_CONTACT_PAGE_LANDING
+export WAGTAIL_CONTACT_PAGE_MODEL
+export WAGTAIL_CONTACT_PAGE_TEMPLATE
+export WAGTAIL_CONTACT_PAGE_TEST
+export WAGTAIL_HOME_PAGE_MODEL
+export WAGTAIL_HOME_PAGE_TEMPLATE
+export WAGTAIL_HOME_PAGE_URLS
+export WAGTAIL_HOME_PAGE_VIEWS
+export WAGTAIL_PRIVACY_PAGE_MODEL
+export WAGTAIL_PRIVACY_PAGE_MODEL
+export WAGTAIL_PRIVACY_PAGE_TEMPLATE
+export WAGTAIL_SEARCH_TEMPLATE
+export WAGTAIL_SEARCH_URLS
+export WAGTAIL_SETTINGS
+export WAGTAIL_SITEPAGE_MODEL
+export WAGTAIL_SITEPAGE_TEMPLATE
+export WAGTAIL_URLS
+export WAGTAIL_URLS_HOME
+export WEBPACK_CONFIG_JS
+export WEBPACK_INDEX_HTML
+export WEBPACK_INDEX_JS
+export WEBPACK_REVEAL_CONFIG_JS
+export WEBPACK_REVEAL_INDEX_HTML
+export WEBPACK_REVEAL_INDEX_JS
+
+# ------------------------------------------------------------------------------
+# Multi-line phony target rules
+# ------------------------------------------------------------------------------
+
+.PHONY: aws-check-env-profile-default
+aws-check-env-profile-default:
+ifndef AWS_PROFILE
+	$(error AWS_PROFILE is undefined)
+endif
+
+.PHONY: aws-check-env-region-default
+aws-check-env-region-default:
+ifndef AWS_REGION
+	$(error AWS_REGION is undefined)
+endif
+
+.PHONY: aws-secret-default
+aws-secret-default: aws-check-env
+	@SECRET_KEY=$$(openssl rand -base64 48); aws ssm put-parameter --name "SECRET_KEY" --value "$$SECRET_KEY" --type String
+
+.PHONY: aws-sg-default
+aws-sg-default: aws-check-env
+	aws ec2 describe-security-groups $(AWS_OPTS)
+
+.PHONY: aws-ssm-default
+aws-ssm-default: aws-check-env
+	aws ssm describe-parameters $(AWS_OPTS)
+	@echo "Get parameter values with: aws ssm getparameter --name <Name>."
+
+.PHONY: aws-subnet-default
+aws-subnet-default: aws-check-env
+	aws ec2 describe-subnets $(AWS_OPTS)
+
+.PHONY: aws-vol-available-default
+aws-vol-available-default: aws-check-env
+	aws ec2 describe-volumes --filters Name=status,Values=available --query "Volumes[*].{ID:VolumeId,Size:Size}" --output table
+
+.PHONY: aws-vol-default
+aws-vol-default: aws-check-env
+	aws ec2 describe-volumes --output table
+
+.PHONY: aws-vpc-default
+aws-vpc-default: aws-check-env
+	aws ec2 describe-vpcs $(AWS_OPTS)
+
+.PHONY: db-import-default
+db-import-default:
+	@psql $(DJANGO_DB_NAME) < $(DJANGO_DB_NAME).sql
+
+.PHONY: db-init-default
+db-init-default:
+	-dropdb $(PROJECT_NAME)
+	-createdb $(PROJECT_NAME)
+
+.PHONY: db-init-mysql-default
+db-init-mysql-default:
+	-mysqladmin -u root drop $(PROJECT_NAME)
+	-mysqladmin -u root create $(PROJECT_NAME)
+
+.PHONY: db-init-test-default
+db-init-test-default:
+	-dropdb test_$(PROJECT_NAME)
+	-createdb test_$(PROJECT_NAME)
+
+.PHONY: django-allauth-default
+django-allauth-default:
+	$(ADD_DIR) backend/templates/allauth/layouts
+	@echo "$$DJANGO_ALLAUTH_BASE_TEMPLATE" > backend/templates/allauth/layouts/base.html
+	@echo "$$DJANGO_URLS_ALLAUTH" >> $(DJANGO_URLS_FILE)
+	-$(GIT_ADD) backend/templates/allauth/layouts/base.html
+
+.PHONY: django-app-tests-default
+django-app-tests-default:
+	@echo "$$DJANGO_APP_TESTS" > $(APP_DIR)/tests.py
+
+.PHONY: django-base-template-default
+django-base-template-default:
+	@$(ADD_DIR) backend/templates
+	@echo "$$DJANGO_BASE_TEMPLATE" > backend/templates/base.html
+	-$(GIT_ADD) backend/templates/base.html
+
+.PHONY: django-custom-admin-default
+django-custom-admin-default:
+	@echo "$$DJANGO_CUSTOM_ADMIN" > $(DJANGO_CUSTOM_ADMIN_FILE)
+	@echo "$$DJANGO_BACKEND_APPS" > $(DJANGO_BACKEND_APPS_FILE)
+	-$(GIT_ADD) backend/*.py
+
+.PHONY: django-db-shell-default
+django-db-shell-default:
+	python manage.py dbshell
+
+.PHONY: django-dockerfile-default
+django-dockerfile-default:
+	@echo "$$DJANGO_DOCKERFILE" > Dockerfile
+	-$(GIT_ADD) Dockerfile
+	@echo "$$DJANGO_DOCKERCOMPOSE" > docker-compose.yml
+	-$(GIT_ADD) docker-compose.yml
+
+.PHONY: django-favicon-default
+django-favicon-default:
+	@echo "$$DJANGO_FAVICON_TEMPLATE" > backend/templates/favicon.html
+	-$(GIT_ADD) backend/templates/favicon.html
+
+.PHONY: django-footer-template-default
+django-footer-template-default:
+	@echo "$$DJANGO_FOOTER_TEMPLATE" > backend/templates/footer.html
+	-$(GIT_ADD) backend/templates/footer.html
+
+.PHONY: django-frontend-default
+django-frontend-default: python-webpack-init
+	$(ADD_DIR) frontend/src/context
+	$(ADD_DIR) frontend/src/images
+	$(ADD_DIR) frontend/src/utils
+	@echo "$$DJANGO_FRONTEND_APP" > frontend/src/application/app.js
+	@echo "$$DJANGO_FRONTEND_APP_CONFIG" > frontend/src/application/config.js
+	@echo "$$DJANGO_FRONTEND_BABELRC" > frontend/.babelrc
+	@echo "$$DJANGO_FRONTEND_COMPONENT_CLOCK" > frontend/src/components/Clock.js
+	@echo "$$DJANGO_FRONTEND_COMPONENT_ERROR" > frontend/src/components/ErrorBoundary.js
+	@echo "$$DJANGO_FRONTEND_CONTEXT_INDEX" > frontend/src/context/index.js
+	@echo "$$DJANGO_FRONTEND_CONTEXT_USER_PROVIDER" > frontend/src/context/UserContextProvider.js
+	@echo "$$DJANGO_FRONTEND_COMPONENT_USER_MENU" > frontend/src/components/UserMenu.js
+	@echo "$$DJANGO_FRONTEND_COMPONENTS" > frontend/src/components/index.js
+	@echo "$$DJANGO_FRONTEND_ESLINTRC" > frontend/.eslintrc
+	@echo "$$DJANGO_FRONTEND_PORTAL" > frontend/src/dataComponents.js
+	@echo "$$DJANGO_FRONTEND_STYLES" > frontend/src/styles/index.scss
+	@echo "$$DJANGO_FRONTEND_THEME_BLUE" > frontend/src/styles/theme-blue.scss
+	@echo "$$DJANGO_FRONTEND_THEME_TOGGLER" > frontend/src/utils/themeToggler.js
+	# @echo "$$TINYMCE_JS" > frontend/src/utils/tinymce.js
+	@$(MAKE) npm-install-django
+	@$(MAKE) npm-install-django-dev
+	-$(GIT_ADD) $(DJANGO_FRONTEND_FILES)
+
+.PHONY: django-graph-default
+django-graph-default:
+	python manage.py graph_models -a -o $(PROJECT_NAME).png
+
+.PHONY: django-header-template-default
+django-header-template-default:
+	@echo "$$DJANGO_HEADER_TEMPLATE" > backend/templates/header.html
+	-$(GIT_ADD) backend/templates/header.html
+
+.PHONY: django-home-default
+django-home-default:
+	python manage.py startapp home
+	$(ADD_DIR) home/templates
+	@echo "$$DJANGO_HOME_PAGE_ADMIN" > home/admin.py
+	@echo "$$DJANGO_HOME_PAGE_MODELS" > home/models.py
+	@echo "$$DJANGO_HOME_PAGE_TEMPLATE" > home/templates/home.html
+	@echo "$$DJANGO_HOME_PAGE_VIEWS" > home/views.py
+	@echo "$$DJANGO_HOME_PAGE_URLS" > home/urls.py
+	@echo "$$DJANGO_URLS_HOME_PAGE" >> $(DJANGO_URLS_FILE)
+	@echo "$$DJANGO_SETTINGS_HOME_PAGE" >> $(DJANGO_SETTINGS_BASE_FILE)
+	export APP_DIR="home"; $(MAKE) django-app-tests
+	-$(GIT_ADD) home/templates
+	-$(GIT_ADD) home/*.py
+	-$(GIT_ADD) home/migrations/*.py
+
+.PHONY: django-init-default
+django-init-default: separator \
+	db-init \
+	django-install \
+	django-project \
+	django-utils \
+	pip-freeze \
+	pip-init-test \
+	django-settings-directory \
+	django-custom-admin \
+	django-dockerfile \
+	django-offcanvas-template \
+	django-header-template \
+	django-footer-template \
+	django-base-template \
+	django-manage-py \
+	django-urls \
+	django-urls-debug-toolbar \
+	django-allauth \
+	django-favicon \
+	git-ignore \
+	django-settings-base \
+	django-settings-dev \
+	django-settings-prod \
+	django-siteuser \
+	django-home \
+	django-rest-serializers \
+	django-rest-views \
+	django-urls-api \
+	django-frontend \
+	django-migrate \
+	django-su
+
+.PHONY: django-init-minimal-default
+django-init-minimal-default: separator \
+	db-init \
+	django-install-minimal \
+	django-project \
+	django-settings-directory \
+	django-settings-base-minimal \
+	django-settings-dev \
+	pip-freeze \
+	pip-init-test \
+	django-custom-admin \
+	django-dockerfile \
+	django-offcanvas-template \
+	django-header-template \
+	django-footer-template \
+	django-base-template \
+	django-manage-py \
+	django-urls \
+	django-urls-debug-toolbar \
+	django-favicon \
+	django-settings-prod \
+	django-home \
+	django-utils \
+	django-frontend \
+	django-migrate \
+	git-ignore \
+	django-su
+
+.PHONY: django-init-wagtail-default
+django-init-wagtail-default: separator \
+	db-init \
+	django-install \
+	wagtail-install \
+	wagtail-project \
+	django-utils \
+	pip-freeze \
+	pip-init-test \
+        django-custom-admin \
+        django-dockerfile \
+	django-offcanvas-template \
+	wagtail-header-prefix-template \
+	django-header-template \
+	wagtail-base-template \
+	django-footer-template \
+	django-manage-py \
+	wagtail-home \
+	wagtail-urls \
+	django-urls-debug-toolbar \
+	django-allauth \
+	django-favicon \
+	git-ignore \
+	wagtail-search \
+	django-settings-base \
+	django-settings-dev \
+	django-settings-prod \
+	wagtail-settings \
+	django-siteuser \
+	django-model-form-demo \
+	django-logging-demo \
+	django-payments-demo-default \
+	django-rest-serializers \
+	django-rest-views \
+	django-urls-api \
+	wagtail-urls-home \
+	django-frontend \
+	django-migrate \
+	django-su
+
+.PHONY: django-install-default
+django-install-default:
+	$(PIP_ENSURE)
+	python -m pip install \
+	Django \
+        Faker \
+        boto3 \
+        crispy-bootstrap5 \
+        djangorestframework \
+        django-allauth \
+        django-after-response \
+        django-ckeditor \
+        django-colorful \
+        django-cors-headers \
+        django-countries \
+        django-crispy-forms \
+        django-debug-toolbar \
+        django-extensions \
+        django-hijack \
+        django-honeypot \
+        django-imagekit \
+        django-import-export \
+        django-ipware \
+        django-multiselectfield \
+        django-ninja \
+        django-phonenumber-field \
+        django-recurrence \
+        django-recaptcha \
+        django-registration \
+        django-richtextfield \
+        django-sendgrid-v5 \
+        django-social-share \
+        django-sql-explorer \
+        django-storages \
+        django-tables2 \
+        django-timezone-field \
+	django-widget-tweaks \
+        dj-database-url \
+        dj-rest-auth \
+        dj-stripe \
+        docutils \
+        enmerkar \
+        gunicorn \
+        html2docx \
+        icalendar \
+        mailchimp-marketing \
+        mailchimp-transactional \
+        phonenumbers \
+        pipdeptree \
+        psycopg2-binary \
+        pydotplus \
+        python-webpack-boilerplate \
+        python-docx \
+        reportlab \
+        texttable
+
+.PHONY: django-install-minimal-default
+django-install-minimal-default:
+	$(PIP_ENSURE)
+	python -m pip install \
+	Django \
+	dj-database-url \
+	django-debug-toolbar \
+	python-webpack-boilerplate
+
+.PHONY: django-lint-default
+django-lint-default:
+	-ruff format -v
+	-djlint --reformat --format-css --format-js .
+	-ruff check -v --fix
+
+.PHONY: django-loaddata-default
+django-loaddata-default:
+	python manage.py loaddata
+
+.PHONY: django-logging-demo-default
+django-logging-demo-default:
+	python manage.py startapp logging_demo
+	@echo "$$DJANGO_LOGGING_DEMO_ADMIN" > logging_demo/admin.py
+	@echo "$$DJANGO_LOGGING_DEMO_MODELS" > logging_demo/models.py
+	@echo "$$DJANGO_LOGGING_DEMO_SETTINGS" >> $(DJANGO_SETTINGS_BASE_FILE)
+	@echo "$$DJANGO_LOGGING_DEMO_URLS" > logging_demo/urls.py
+	@echo "$$DJANGO_LOGGING_DEMO_VIEWS" > logging_demo/views.py
+	@echo "$$DJANGO_URLS_LOGGING_DEMO" >> $(DJANGO_URLS_FILE)
+	export APP_DIR="logging_demo"; $(MAKE) django-app-tests
+	-$(GIT_ADD) logging_demo/*.py
+	-$(GIT_ADD) logging_demo/migrations/*.py
+
+.PHONY: django-manage-py-default
+django-manage-py-default:
+	@echo "$$DJANGO_MANAGE_PY" > manage.py
+	-$(GIT_ADD) manage.py
+
+.PHONY: django-migrate-default
+django-migrate-default:
+	python manage.py migrate
+
+.PHONY: django-migrations-make-default
+django-migrations-make-default:
+	python manage.py makemigrations
+
+.PHONY: django-migrations-show-default
+django-migrations-show-default:
+	python manage.py showmigrations
+
+.PHONY: django-model-form-demo-default
+django-model-form-demo-default:
+	python manage.py startapp model_form_demo
+	@echo "$$DJANGO_MODEL_FORM_DEMO_ADMIN" > model_form_demo/admin.py
+	@echo "$$DJANGO_MODEL_FORM_DEMO_FORMS" > model_form_demo/forms.py
+	@echo "$$DJANGO_MODEL_FORM_DEMO_MODEL" > model_form_demo/models.py
+	@echo "$$DJANGO_MODEL_FORM_DEMO_URLS" > model_form_demo/urls.py
+	@echo "$$DJANGO_MODEL_FORM_DEMO_VIEWS" > model_form_demo/views.py
+	$(ADD_DIR) model_form_demo/templates
+	@echo "$$DJANGO_MODEL_FORM_DEMO_TEMPLATE_DETAIL" > model_form_demo/templates/model_form_demo_detail.html
+	@echo "$$DJANGO_MODEL_FORM_DEMO_TEMPLATE_FORM" > model_form_demo/templates/model_form_demo_form.html
+	@echo "$$DJANGO_MODEL_FORM_DEMO_TEMPLATE_LIST" > model_form_demo/templates/model_form_demo_list.html
+	@echo "$$DJANGO_SETTINGS_MODEL_FORM_DEMO" >> $(DJANGO_SETTINGS_BASE_FILE)
+	@echo "$$DJANGO_URLS_MODEL_FORM_DEMO" >> $(DJANGO_URLS_FILE)
+	export APP_DIR="model_form_demo"; $(MAKE) django-app-tests
+	python manage.py makemigrations
+	-$(GIT_ADD) model_form_demo/*.py
+	-$(GIT_ADD) model_form_demo/templates
+	-$(GIT_ADD) model_form_demo/migrations
+
+.PHONY: django-offcanvas-template-default
+django-offcanvas-template-default:
+	-$(ADD_DIR) backend/templates
+	@echo "$$DJANGO_FRONTEND_OFFCANVAS_TEMPLATE" > backend/templates/offcanvas.html
+	-$(GIT_ADD) backend/templates/offcanvas.html
+
+.PHONY: django-open-default
+django-open-default:
+ifeq ($(UNAME), Linux)
+	@echo "Opening on Linux."
+	xdg-open http://0.0.0.0:8000
+else ifeq ($(UNAME), Darwin)
+	@echo "Opening on macOS (Darwin)."
+	open http://0.0.0.0:8000
+else
+	@echo "Unable to open on: $(UNAME)"
+endif
+
+.PHONY: django-payments-demo-default
+django-payments-demo-default:
+	python manage.py startapp payments
+	@echo "$$DJANGO_PAYMENTS_FORM" > payments/forms.py
+	@echo "$$DJANGO_PAYMENTS_MODELS" > payments/models.py
+	@echo "$$DJANGO_PAYMENTS_ADMIN" > payments/admin.py
+	@echo "$$DJANGO_PAYMENTS_VIEW" > payments/views.py
+	@echo "$$DJANGO_PAYMENTS_URLS" > payments/urls.py
+	$(ADD_DIR) payments/templates/payments
+	$(ADD_DIR) payments/management/commands
+	@echo "$$DJANGO_PAYMENTS_TEMPLATE_CANCEL" > payments/templates/payments/cancel.html
+	@echo "$$DJANGO_PAYMENTS_TEMPLATE_CHECKOUT" > payments/templates/payments/checkout.html
+	@echo "$$DJANGO_PAYMENTS_TEMPLATE_SUCCESS" > payments/templates/payments/success.html
+	@echo "$$DJANGO_PAYMENTS_TEMPLATE_PRODUCT_LIST" > payments/templates/payments/product_list.html
+	@echo "$$DJANGO_PAYMENTS_TEMPLATE_PRODUCT_DETAIL" > payments/templates/payments/product_detail.html
+	@echo "$$DJANGO_SETTINGS_PAYMENTS" >> $(DJANGO_SETTINGS_BASE_FILE)
+	@echo "$$DJANGO_URLS_PAYMENTS" >> $(DJANGO_URLS_FILE)
+	export APP_DIR="payments"; $(MAKE) django-app-tests
+	python manage.py makemigrations payments
+	@echo "$$DJANGO_PAYMENTS_MIGRATION_0002" > payments/migrations/0002_set_stripe_api_keys.py
+	@echo "$$DJANGO_PAYMENTS_MIGRATION_0003" > payments/migrations/0003_create_initial_products.py
+	-$(GIT_ADD) payments/
+
+.PHONY: django-project-default
+django-project-default:
+	django-admin startproject backend .
+	-$(GIT_ADD) backend
+
+.PHONY: django-rest-serializers-default
+django-rest-serializers-default:
+	@echo "$$DJANGO_API_SERIALIZERS" > backend/serializers.py
+	-$(GIT_ADD) backend/serializers.py
+
+.PHONY: django-rest-views-default
+django-rest-views-default:
+	@echo "$$DJANGO_API_VIEWS" > backend/api.py
+	-$(GIT_ADD) backend/api.py
+
+.PHONY: django-search-default
+django-search-default:
+	python manage.py startapp search
+	$(ADD_DIR) search/templates
+	@echo "$$DJANGO_SEARCH_TEMPLATE" > search/templates/search.html
+	@echo "$$DJANGO_SEARCH_FORMS" > search/forms.py
+	@echo "$$DJANGO_SEARCH_URLS" > search/urls.py
+	@echo "$$DJANGO_SEARCH_UTILS" > search/utils.py
+	@echo "$$DJANGO_SEARCH_VIEWS" > search/views.py
+	@echo "$$DJANGO_SEARCH_SETTINGS" >> $(DJANGO_SETTINGS_BASE_FILE)
+	@echo "INSTALLED_APPS.append('search')" >> $(DJANGO_SETTINGS_BASE_FILE)
+	@echo "urlpatterns += [path('search/', include('search.urls'))]" >> $(DJANGO_URLS_FILE)
+	-$(GIT_ADD) search/templates
+	-$(GIT_ADD) search/*.py
+
+.PHONY: django-secret-key-default
+django-secret-key-default:
+	@python -c "from secrets import token_urlsafe; print(token_urlsafe(50))"
+
+.PHONY: django-serve-default
+django-serve-default:
+	npm run watch &
+	python manage.py runserver 0.0.0.0:8000
+
+.PHONY: django-settings-base-default
+django-settings-base-default:
+	@echo "$$DJANGO_SETTINGS_BASE" >> $(DJANGO_SETTINGS_BASE_FILE)
+	@echo "$$DJANGO_SETTINGS_AUTHENTICATION_BACKENDS" >> $(DJANGO_SETTINGS_BASE_FILE)
+	@echo "$$DJANGO_SETTINGS_REST_FRAMEWORK" >> $(DJANGO_SETTINGS_BASE_FILE)
+	@echo "$$DJANGO_SETTINGS_THEMES" >> $(DJANGO_SETTINGS_BASE_FILE)
+	@echo "$$DJANGO_SETTINGS_DATABASE" >> $(DJANGO_SETTINGS_BASE_FILE)
+	@echo "$$DJANGO_SETTINGS_INSTALLED_APPS" >> $(DJANGO_SETTINGS_BASE_FILE)
+	@echo "$$DJANGO_SETTINGS_MIDDLEWARE" >> $(DJANGO_SETTINGS_BASE_FILE)
+	@echo "$$DJANGO_SETTINGS_CRISPY_FORMS" >> $(DJANGO_SETTINGS_BASE_FILE)
+
+.PHONY: django-settings-base-minimal-default
+django-settings-base-minimal-default:
+	@echo "$$DJANGO_SETTINGS_BASE_MINIMAL" >> $(DJANGO_SETTINGS_BASE_FILE)
+
+.PHONY: django-settings-dev-default
+django-settings-dev-default:
+	@echo "# $(PROJECT_NAME)" > $(DJANGO_SETTINGS_DEV_FILE)
+	@echo "$$DJANGO_SETTINGS_DEV" >> backend/settings/dev.py
+	-$(GIT_ADD) $(DJANGO_SETTINGS_DEV_FILE)
+
+.PHONY: django-settings-directory-default
+django-settings-directory-default:
+	@$(ADD_DIR) $(DJANGO_SETTINGS_DIR)
+	@$(COPY_FILE) backend/settings.py backend/settings/base.py
+	@$(DEL_FILE) backend/settings.py
+	-$(GIT_ADD) backend/settings/*.py
+
+.PHONY: django-settings-prod-default
+django-settings-prod-default:
+	@echo "$$DJANGO_SETTINGS_PROD" > $(DJANGO_SETTINGS_PROD_FILE)
+	-$(GIT_ADD) $(DJANGO_SETTINGS_PROD_FILE)
+
+.PHONY: django-shell-default
+django-shell-default:
+	python manage.py shell
+
+.PHONY: django-siteuser-default
+django-siteuser-default:
+	python manage.py startapp siteuser
+	$(ADD_DIR) siteuser/templates/
+	@echo "$$DJANGO_SITEUSER_FORM" > siteuser/forms.py
+	@echo "$$DJANGO_SITEUSER_MODEL" > siteuser/models.py
+	@echo "$$DJANGO_SITEUSER_ADMIN" > siteuser/admin.py
+	@echo "$$DJANGO_SITEUSER_VIEW" > siteuser/views.py
+	@echo "$$DJANGO_SITEUSER_URLS" > siteuser/urls.py
+	@echo "$$DJANGO_SITEUSER_VIEW_TEMPLATE" > siteuser/templates/profile.html
+	@echo "$$DJANGO_SITEUSER_TEMPLATE" > siteuser/templates/user.html
+	@echo "$$DJANGO_SITEUSER_EDIT_TEMPLATE" > siteuser/templates/user_edit.html
+	@echo "$$DJANGO_URLS_SITEUSER" >> $(DJANGO_URLS_FILE)
+	@echo "$$DJANGO_SETTINGS_SITEUSER" >> $(DJANGO_SETTINGS_BASE_FILE)
+	export APP_DIR="siteuser"; $(MAKE) django-app-tests
+	-$(GIT_ADD) siteuser/templates
+	-$(GIT_ADD) siteuser/*.py
+	python manage.py makemigrations siteuser
+	-$(GIT_ADD) siteuser/migrations/*.py
+
+.PHONY: django-static-default
+django-static-default:
+	python manage.py collectstatic --noinput
+
+.PHONY: django-su-default
+django-su-default:
+	DJANGO_SUPERUSER_PASSWORD=admin python manage.py createsuperuser --noinput --username=admin --email=$(PROJECT_EMAIL)
+
+.PHONY: django-test-default
+django-test-default: npm-install django-static
+	-$(MAKE) pip-install-test
+	python manage.py test
+
+.PHONY: django-urls-api-default
+django-urls-api-default:
+	@echo "$$DJANGO_URLS_API" >> $(DJANGO_URLS_FILE)
+	-$(GIT_ADD) $(DJANGO_URLS_FILE)
+
+.PHONY: django-urls-debug-toolbar-default
+django-urls-debug-toolbar-default:
+	@echo "$$DJANGO_URLS_DEBUG_TOOLBAR" >> $(DJANGO_URLS_FILE)
+
+.PHONY: django-urls-default
+django-urls-default:
+	@echo "$$DJANGO_URLS" > $(DJANGO_URLS_FILE)
+	-$(GIT_ADD) $(DJANGO_URLS_FILE)
+
+.PHONY: django-urls-show-default
+django-urls-show-default:
+	python manage.py show_urls
+
+.PHONY: django-user-default
+django-user-default:
+	python manage.py shell -c "from django.contrib.auth.models import User; \
+        User.objects.create_user('user', '', 'user')"
+
+.PHONY: django-utils-default
+django-utils-default:
+	@echo "$$DJANGO_UTILS" > backend/utils.py
+	-$(GIT_ADD) backend/utils.py
+
+.PHONY: docker-build-default
+docker-build-default:
+	podman build -t $(PROJECT_NAME) .
+
+.PHONY: docker-compose-default
+docker-compose-default:
+	podman compose up
+
+.PHONY: docker-list-default
+docker-list-default:
+	podman container list --all
+	podman images --all
+
+.PHONY: docker-run-default
+docker-run-default:
+	podman run $(PROJECT_NAME)
+
+.PHONY: docker-serve-default
+docker-serve-default:
+	podman run -p 8000:8000 $(PROJECT_NAME)
+
+.PHONY: docker-shell-default
+docker-shell-default:
+	podman run -it $(PROJECT_NAME) /bin/bash
+
+.PHONY: eb-check-env-default
+eb-check-env-default:  # https://stackoverflow.com/a/4731504/185820
+ifndef EB_SSH_KEY
+	$(error EB_SSH_KEY is undefined)
+endif
+ifndef VPC_ID
+	$(error VPC_ID is undefined)
+endif
+ifndef VPC_SG
+	$(error VPC_SG is undefined)
+endif
+ifndef VPC_SUBNET_EC2
+	$(error VPC_SUBNET_EC2 is undefined)
+endif
+ifndef VPC_SUBNET_ELB
+	$(error VPC_SUBNET_ELB is undefined)
+endif
+
+.PHONY: eb-create-default
+eb-create-default: aws-check-env eb-check-env
+	eb create $(EB_ENV_NAME) \
+         -im $(EC2_INSTANCE_MIN) \
+         -ix $(EC2_INSTANCE_MAX) \
+         -ip $(EC2_INSTANCE_PROFILE) \
+         -i $(EC2_INSTANCE_TYPE) \
+         -k $(EB_SSH_KEY) \
+         -p $(EB_PLATFORM) \
+         --elb-type $(EC2_LB_TYPE) \
+         --vpc \
+         --vpc.id $(VPC_ID) \
+         --vpc.elbpublic \
+         --vpc.publicip \
+         --vpc.ec2subnets $(VPC_SUBNET_EC2) \
+         --vpc.elbsubnets $(VPC_SUBNET_ELB) \
+         --vpc.securitygroups $(VPC_SG)
+
+.PHONY: eb-custom-env-default
+eb-custom-env-default:
+	$(ADD_DIR) .ebextensions
+	@echo "$$EB_CUSTOM_ENV_EC2_USER" > .ebextensions/bash.config
+	-$(GIT_ADD) .ebextensions/bash.config
+	$(ADD_DIR) .platform/hooks/postdeploy
+	@echo "$$EB_CUSTOM_ENV_VAR_FILE" > .platform/hooks/postdeploy/setenv.sh
+	-$(GIT_ADD) .platform/hooks/postdeploy/setenv.sh
+
+.PHONY: eb-deploy-default
+eb-deploy-default:
+	eb deploy
+
+.PHONY: eb-export-default
+eb-export-default:
+	@if [ ! -d $(EB_DIR_NAME) ]; then \
+        echo "Directory $(EB_DIR_NAME) does not exist"; \
+        else \
+        echo "Directory $(EB_DIR_NAME) does exist!"; \
+        eb ssh --quiet -c "export PGPASSWORD=$(DJANGO_DB_PASS); pg_dump -U $(DJANGO_DB_USER) -h $(DJANGO_DB_HOST) $(DJANGO_DB_NAME)" > $(DJANGO_DB_NAME).sql; \
+        echo "Wrote $(DJANGO_DB_NAME).sql"; \
+        fi
+
+.PHONY: eb-restart-default
+eb-restart-default:
+	eb ssh -c "systemctl restart web"
+
+.PHONY: eb-rebuild-default
+eb-rebuild-default:
+	aws elasticbeanstalk rebuild-environment --environment-name $(ENV_NAME)
+
+.PHONY: eb-upgrade-default
+eb-upgrade-default:
+	eb upgrade
+
+.PHONY: eb-init-default
+eb-init-default: aws-check-env-profile
+	eb init --profile=$(AWS_PROFILE)
+
+.PHONY: eb-list-default
+eb-list-platforms-default:
+	aws elasticbeanstalk list-platform-versions
+
+.PHONY: eb-list-databases-default
+eb-list-databases-default:
+	@eb ssh --quiet -c "export PGPASSWORD=$(DJANGO_DB_PASS); psql -l -U $(DJANGO_DB_USER) -h $(DJANGO_DB_HOST) $(DJANGO_DB_NAME)"
+
+.PHONY: eb-logs-default
+eb-logs-default:
+	eb logs
+
+.PHONY: eb-print-env-default
+eb-print-env-default:
+	eb printenv
+
+.PHONY: favicon-default
+favicon-init-default:
+	dd if=/dev/urandom bs=64 count=1 status=none | base64 | convert -size 16x16 -depth 8 -background none -fill white label:@- favicon.png
+	convert favicon.png favicon.ico
+	-$(GIT_ADD) favicon.ico
+	$(DEL_FILE) favicon.png
+
+.PHONY: git-ignore-default
+git-ignore-default:
+	@echo "$$GIT_IGNORE" > .gitignore
+	-$(GIT_ADD) .gitignore
+
+.PHONY: git-branches-default
+git-branches-default:
+	-for i in $(GIT_BRANCHES) ; do \
+        -@$(GIT_CHECKOUT) -t $$i ; done
+
+.PHONY: git-commit-message-clean-default
+git-commit-message-clean-default:
+	-@$(GIT_COMMIT) -a -m "Clean"
+
+.PHONY: git-commit-message-default
+git-commit-message-default:
+	-@$(GIT_COMMIT) -a -m $(GIT_COMMIT_MSG)
+
+.PHONY: git-commit-message-empty-default
+git-commit-message-empty-default:
+	-@$(GIT_COMMIT) --allow-empty -m "Empty-Commit"
+
+.PHONY: git-commit-message-init-default
+git-commit-message-init-default:
+	-@$(GIT_COMMIT) -a -m "Init"
+
+.PHONY: git-commit-message-last-default
+git-commit-message-last-default:
+	git log -1 --pretty=%B > $(TMPDIR)/commit.txt
+	-$(GIT_COMMIT) -a -F $(TMPDIR)/commit.txt
+
+.PHONY: git-commit-message-lint-default
+git-commit-message-lint-default:
+	-@$(GIT_COMMIT) -a -m "Lint"
+
+.PHONY: git-commit-message-mk-default
+git-commit-message-mk-default:
+	-@$(GIT_COMMIT) project.mk -m "Add/update $(MAKEFILE_CUSTOM_FILE)"
+
+.PHONY: git-commit-message-rename-default
+git-commit-message-rename-default:
+	-@$(GIT_COMMIT) -a -m "Rename"
+
+.PHONY: git-commit-message-sort-default
+git-commit-message-sort-default:
+	-@$(GIT_COMMIT) -a -m "Sort"
+
+.PHONY: git-push-default
+git-push-default:
+	-@$(GIT_PUSH)
+
+.PHONY: git-push-force-default
+git-push-force-default:
+	-@$(GIT_PUSH_FORCE)
+
+.PHONY: git-commit-edit-default
+git-commit-edit-default:
+	-$(GIT_COMMIT) -a
+
+.PHONY: git-prune-default
+git-prune-default:
+	git remote update origin --prune
+
+.PHONY: git-set-upstream-default
+git-set-upstream-default:
+	git push --set-upstream origin main
+
+.PHONY: git-set-default-default
+git-set-default-default:
+	gh repo set-default
+
+.PHONY: git-short-default
+git-short-default:
+	@echo $(GIT_REV)
+
+.PHONY: help-default
+help-default:
+	@echo "Project Makefile 🤷"
+	@echo "Usage: make [options] [target] ..."
+	@echo "Examples:"
+	@echo "   make help                   Print this message"
+	@echo "   make list-defines  list all defines in the Makefile"
+	@echo "   make list-commands  list all targets in the Makefile"
+
+.PHONY: jenkins-init-default
+jenkins-init-default:
+	@echo "$$JENKINS_FILE" > Jenkinsfile
+
+.PHONY: makefile-list-commands-default
+makefile-list-commands-default:
+	@for makefile in $(MAKEFILE_LIST); do \
+        echo "Commands from $$makefile:"; \
+        $(MAKE) -pRrq -f $$makefile : 2>/dev/null | \
+        awk -v RS= -F: '/^# File/,/^# Finished Make data base/ { \
+            if ($$1 !~ "^[#.]") { sub(/-default$$/, "", $$1); print $$1 } }' | \
+        egrep -v -e '^[^[:alnum:]]' -e '^$@$$' | \
+        tr ' ' '\n' | \
+        sort | \
+        awk '{print $$0}' ; \
+        echo; \
+    	done | $(PAGER)
+
+.PHONY: makefile-list-defines-default
+makefile-list-defines-default:
+	@grep '^define [A-Za-z_][A-Za-z0-9_]*' Makefile
+
+.PHONY: makefile-list-exports-default
+makefile-list-exports-default:
+	@grep '^export [A-Z][A-Z_]*' Makefile
+
+.PHONY: makefile-list-targets-default
+makefile-list-targets-default:
+	@perl -ne 'print if /^\s*\.PHONY:/ .. /^[a-zA-Z0-9_-]+:/;' Makefile | grep -v .PHONY
+
+.PHONY: make-default
+make-default:
+	-$(GIT_ADD) Makefile
+	-$(GIT_COMMIT) Makefile -m "Add/update project-makefile files"
+	-git push
+
+.PHONY: npm-init-default
+npm-init-default:
+	npm init -y
+	-$(GIT_ADD) package.json
+	-$(GIT_ADD) package-lock.json
+
+.PHONY: npm-build-default
+npm-build-default:
+	npm run build
+
+.PHONY: npm-install-default
+npm-install-default:
+	npm install
+	-$(GIT_ADD) package-lock.json
+
+.PHONY: npm-install-django-default
+npm-install-django-default:
+	npm install \
+        @fortawesome/fontawesome-free \
+        @fortawesome/fontawesome-svg-core \
+        @fortawesome/free-brands-svg-icons \
+        @fortawesome/free-solid-svg-icons \
+        @fortawesome/react-fontawesome \
+        	bootstrap \
+        camelize \
+        date-fns \
+        history \
+        mapbox-gl \
+        query-string \
+        react-animate-height \
+        react-chartjs-2 \
+        react-copy-to-clipboard \
+        react-date-range \
+        react-dom \
+        react-dropzone \
+        react-hook-form \
+        react-image-crop \
+        react-map-gl \
+        react-modal \
+        react-resize-detector \
+        react-select \
+        react-swipeable \
+        snakeize \
+        striptags \
+        url-join \
+        viewport-mercator-project
+
+.PHONY: npm-install-django-dev-default
+npm-install-django-dev-default:
+	npm install \
+        eslint-plugin-react \
+        eslint-config-standard \
+        eslint-config-standard-jsx \
+        @babel/core \
+        @babel/preset-env \
+        @babel/preset-react \
+        --save-dev
+
+.PHONY: npm-serve-default
+npm-serve-default:
+	npm run start
+
+.PHONY: npm-test-default
+npm-test-default:
+	npm run test
+
+.PHONY: pip-deps-default
+pip-deps-default:
+	$(PIP_ENSURE)
+	python -m pip install pipdeptree
+	python -m pipdeptree
+	pipdeptree
+
+.PHONY: pip-freeze-default
+pip-freeze-default:
+	$(PIP_ENSURE)
+	python -m pip freeze | sort > $(TMPDIR)/requirements.txt
+	mv -f $(TMPDIR)/requirements.txt .
+	-$(GIT_ADD) requirements.txt
+
+.PHONY: pip-init-default
+pip-init-default:
+	touch requirements.txt
+	-$(GIT_ADD) requirements.txt
+
+.PHONY: pip-init-test-default
+pip-init-test-default:
+	@echo "$$PIP_INSTALL_REQUIREMENTS_TEST" > requirements-test.txt
+	-$(GIT_ADD) requirements-test.txt
+
+.PHONY: pip-install-default
+pip-install-default:
+	$(PIP_ENSURE)
+	$(MAKE) pip-upgrade
+	python -m pip install wheel
+	python -m pip install -r requirements.txt
+
+.PHONY: pip-install-dev-default
+pip-install-dev-default:
+	$(PIP_ENSURE)
+	python -m pip install -r requirements-dev.txt
+
+.PHONY: pip-install-test-default
+pip-install-test-default:
+	$(PIP_ENSURE)
+	python -m pip install -r requirements-test.txt
+
+.PHONY: pip-install-upgrade-default
+pip-install-upgrade-default:
+	cat requirements.txt | awk -F\= '{print $$1}' > $(TMPDIR)/requirements.txt
+	mv -f $(TMPDIR)/requirements.txt .
+	$(PIP_ENSURE)
+	python -m pip install -U -r requirements.txt
+	python -m pip freeze | sort > $(TMPDIR)/requirements.txt
+	mv -f $(TMPDIR)/requirements.txt .
+
+.PHONY: pip-upgrade-default
+pip-upgrade-default:
+	$(PIP_ENSURE)
+	python -m pip install -U pip
+
+.PHONY: pip-uninstall-default
+pip-uninstall-default:
+	$(PIP_ENSURE)
+	python -m pip freeze | xargs python -m pip uninstall -y
+
+.PHONY: plone-clean-default
+plone-clean-default:
+	$(DEL_DIR) $(PROJECT_NAME)
+	$(DEL_DIR) $(PACKAGE_NAME)
+
+.PHONY: plone-init-default
+plone-init-default: git-ignore plone-install plone-instance plone-serve
+
+.PHONY: plone-install-default
+plone-install-default:
+	$(PIP_ENSURE)
+	python -m pip install plone -c $(PIP_INSTALL_PLONE_CONSTRAINTS)
+
+.PHONY: plone-instance-default
+plone-instance-default:
+	mkwsgiinstance -d backend -u admin:admin
+	cat backend/etc/zope.ini | sed -e 's/host = 127.0.0.1/host = 0.0.0.0/; s/port = 8080/port = 8000/' > $(TMPDIR)/zope.ini
+	mv -f $(TMPDIR)/zope.ini backend/etc/zope.ini
+	-$(GIT_ADD) backend/etc/site.zcml
+	-$(GIT_ADD) backend/etc/zope.conf
+	-$(GIT_ADD) backend/etc/zope.ini
+
+.PHONY: plone-serve-default
+plone-serve-default:
+	runwsgi backend/etc/zope.ini
+
+.PHONY: plone-build-default
+plone-build-default:
+	buildout
+
+.PHONY: programming-interview-default
+programming-interview-default:
+	@echo "$$PROGRAMMING_INTERVIEW" > interview.py
+	@echo "Created interview.py!"
+	-@$(GIT_ADD) interview.py > /dev/null 2>&1
+
+# .NOT_PHONY!
+$(MAKEFILE_CUSTOM_FILE):
+	@echo "$$MAKEFILE_CUSTOM" > $(MAKEFILE_CUSTOM_FILE)
+	-$(GIT_ADD) $(MAKEFILE_CUSTOM_FILE)
+
+.PHONY: python-license-default
+python-license-default:
+	@echo "$(PYTHON_LICENSE_TXT)" > LICENSE.txt
+	-$(GIT_ADD) LICENSE.txt
+
+.PHONY: python-project-default
+python-project-default:
+	@echo "$(PYTHON_PROJECT_TOML)" > pyproject.toml
+	-$(GIT_ADD) pyproject.toml
+
+.PHONY: python-serve-default
+python-serve-default:
+	@echo "\n\tServing HTTP on http://0.0.0.0:8000\n"
+	python3 -m http.server
+
+.PHONY: python-sdist-default
+python-sdist-default:
+	$(PIP_ENSURE)
+	python setup.py sdist --format=zip
+
+.PHONY: python-webpack-init-default
+python-webpack-init-default:
+	python manage.py webpack_init --no-input
+
+.PHONY: python-ci-default
+python-ci-default:
+	$(ADD_DIR) .github/workflows
+	@echo "$(PYTHON_CI_YAML)" > .github/workflows/build_wheels.yml
+	-$(GIT_ADD) .github/workflows/build_wheels.yml
+
+.PHONY: rand-default
+rand-default:
+	@openssl rand -base64 12 | sed 's/\///g'
+
+.PHONY: readme-init-default
+readme-init-default:
+	@echo "# $(PROJECT_NAME)" > README.md
+	-$(GIT_ADD) README.md
+
+.PHONY: readme-edit-default
+readme-edit-default:
+	$(EDITOR) README.md
+
+.PHONY: reveal-init-default
+reveal-init-default: webpack-init-reveal
+	npm install \
+	css-loader \
+	mini-css-extract-plugin \
+	reveal.js \
+	style-loader
+	jq '.scripts += {"build": "webpack"}' package.json > \
+	$(TMPDIR)/tmp.json && mv $(TMPDIR)/tmp.json package.json
+	jq '.scripts += {"start": "webpack serve --mode development --port 8000 --static"}' package.json > \
+	$(TMPDIR)/tmp.json && mv $(TMPDIR)/tmp.json package.json
+	jq '.scripts += {"watch": "webpack watch --mode development"}' package.json > \
+	$(TMPDIR)/tmp.json && mv $(TMPDIR)/tmp.json package.json
+
+.PHONY: reveal-serve-default
+reveal-serve-default:
+	npm run watch &
+	python -m http.server
+
+.PHONY: review-default
+review-default:
+ifeq ($(UNAME), Darwin)
+	$(EDITOR_REVIEW) `find backend/ -name \*.py` `find backend/ -name \*.html` `find frontend/ -name \*.js` `find frontend/ -name \*.js`
+else
+	@echo "Unsupported"
+endif
+
+.PHONY: separator-default
+separator-default:
+	@echo "$$SEPARATOR"
+
+.PHONY: sphinx-init-default
+sphinx-init-default: sphinx-install
+	sphinx-quickstart -q -p $(PROJECT_NAME) -a $(USER) -v 0.0.1 $(RANDIR)
+	$(COPY_DIR) $(RANDIR)/* .
+	$(DEL_DIR) $(RANDIR)
+	-$(GIT_ADD) index.rst
+	-$(GIT_ADD) conf.py
+	$(DEL_FILE) make.bat
+	-@$(GIT_CHECKOUT) Makefile
+	$(MAKE) git-ignore
+
+.PHONY: sphinx-theme-init-default
+sphinx-theme-init-default:
+	export DJANGO_FRONTEND_THEME_NAME=$(PROJECT_NAME)_theme; \
+	$(ADD_DIR) $$DJANGO_FRONTEND_THEME_NAME ; \
+	$(ADD_FILE) $$DJANGO_FRONTEND_THEME_NAME/__init__.py ; \
+	-$(GIT_ADD) $$DJANGO_FRONTEND_THEME_NAME/__init__.py ; \
+	$(ADD_FILE) $$DJANGO_FRONTEND_THEME_NAME/theme.conf ; \
+	-$(GIT_ADD) $$DJANGO_FRONTEND_THEME_NAME/theme.conf ; \
+	$(ADD_FILE) $$DJANGO_FRONTEND_THEME_NAME/layout.html ; \
+	-$(GIT_ADD) $$DJANGO_FRONTEND_THEME_NAME/layout.html ; \
+	$(ADD_DIR) $$DJANGO_FRONTEND_THEME_NAME/static/css ; \
+	$(ADD_FILE) $$DJANGO_FRONTEND_THEME_NAME/static/css/style.css ; \
+	$(ADD_DIR) $$DJANGO_FRONTEND_THEME_NAME/static/js ; \
+	$(ADD_FILE) $$DJANGO_FRONTEND_THEME_NAME/static/js/script.js ; \
+	-$(GIT_ADD) $$DJANGO_FRONTEND_THEME_NAME/static
+
+.PHONY: sphinx-install-default
+sphinx-install-default:
+	echo "Sphinx\n" > requirements.txt
+	@$(MAKE) pip-install
+	@$(MAKE) pip-freeze
+	-$(GIT_ADD) requirements.txt
+
+.PHONY: sphinx-build-default
+sphinx-build-default:
+	sphinx-build -b html -d _build/doctrees . _build/html
+	sphinx-build -b rinoh . _build/rinoh
+
+.PHONY: sphinx-serve-default
+sphinx-serve-default:
+	cd _build/html;python3 -m http.server
+
+.PHONY: wagtail-base-template-default
+wagtail-base-template-default:
+	@echo "$$WAGTAIL_BASE_TEMPLATE" > backend/templates/base.html
+
+.PHONY: wagtail-clean-default
+wagtail-clean-default:
+	-@for dir in $(shell echo "$(WAGTAIL_CLEAN_DIRS)"); do \
+		echo "Cleaning $$dir"; \
+		$(DEL_DIR) $$dir >/dev/null 2>&1; \
+	done
+	-@for file in $(shell echo "$(WAGTAIL_CLEAN_FILES)"); do \
+		echo "Cleaning $$file"; \
+		$(DEL_FILE) $$file >/dev/null 2>&1; \
+	done
+
+.PHONY: wagtail-contactpage-default
+wagtail-contactpage-default:
+	python manage.py startapp contactpage
+	@echo "$$WAGTAIL_CONTACT_PAGE_MODEL" > contactpage/models.py
+	@echo "$$WAGTAIL_CONTACT_PAGE_TEST" > contactpage/tests.py
+	$(ADD_DIR) contactpage/templates/contactpage/
+	@echo "$$WAGTAIL_CONTACT_PAGE_TEMPLATE" > contactpage/templates/contactpage/contact_page.html
+	@echo "$$WAGTAIL_CONTACT_PAGE_LANDING" > contactpage/templates/contactpage/contact_page_landing.html
+	@echo "INSTALLED_APPS.append('contactpage')" >> $(DJANGO_SETTINGS_BASE_FILE)
+	python manage.py makemigrations contactpage
+	-$(GIT_ADD) contactpage/templates
+	-$(GIT_ADD) contactpage/*.py
+	-$(GIT_ADD) contactpage/migrations/*.py
+
+.PHONY: wagtail-header-prefix-template-default
+wagtail-header-prefix-template-default:
+	@echo "$$WAGTAIL_HEADER_PREFIX" > backend/templates/header.html
+
+.PHONY: wagtail-home-default
+wagtail-home-default:
+	@echo "$$WAGTAIL_HOME_PAGE_MODEL" > home/models.py
+	@echo "$$WAGTAIL_HOME_PAGE_TEMPLATE" > home/templates/home/home_page.html
+	$(ADD_DIR) home/templates/blocks
+	@echo "$$WAGTAIL_BLOCK_MARKETING" > home/templates/blocks/marketing_block.html
+	@echo "$$WAGTAIL_BLOCK_CAROUSEL" > home/templates/blocks/carousel_block.html
+	-$(GIT_ADD) home/templates
+	-$(GIT_ADD) home/*.py
+	python manage.py makemigrations home
+	-$(GIT_ADD) home/migrations/*.py
+
+.PHONY: wagtail-install-default
+wagtail-install-default:
+	$(PIP_ENSURE)
+	python -m pip install \
+        wagtail \
+        wagtailmenus \
+        wagtail-color-panel \
+        wagtail-django-recaptcha \
+        wagtail-markdown \
+        wagtail-modeladmin \
+        wagtail-seo \
+        weasyprint \
+        whitenoise \
+        xhtml2pdf
+
+.PHONY: wagtail-private-default
+wagtail-privacy-default:
+	python manage.py startapp privacy
+	@echo "$$WAGTAIL_PRIVACY_PAGE_MODEL" > privacy/models.py
+	$(ADD_DIR) privacy/templates
+	@echo "$$WAGTAIL_PRIVACY_PAGE_TEMPLATE" > privacy/templates/privacy_page.html
+	@echo "INSTALLED_APPS.append('privacy')" >> $(DJANGO_SETTINGS_BASE_FILE)
+	python manage.py makemigrations privacy
+	-$(GIT_ADD) privacy/templates
+	-$(GIT_ADD) privacy/*.py
+	-$(GIT_ADD) privacy/migrations/*.py
+
+.PHONY: wagtail-project-default
+wagtail-project-default:
+	wagtail start backend .
+	$(DEL_FILE) home/templates/home/welcome_page.html
+	-$(GIT_ADD) backend/
+	-$(GIT_ADD) .dockerignore
+	-$(GIT_ADD) Dockerfile
+	-$(GIT_ADD) manage.py
+	-$(GIT_ADD) requirements.txt
+
+.PHONY: wagtail-search-default
+wagtail-search-default:
+	@echo "$$WAGTAIL_SEARCH_TEMPLATE" > search/templates/search/search.html
+	@echo "$$WAGTAIL_SEARCH_URLS" > search/urls.py
+	-$(GIT_ADD) search/templates
+	-$(GIT_ADD) search/*.py
+
+.PHONY: wagtail-settings-default
+wagtail-settings-default:
+	@echo "$$WAGTAIL_SETTINGS" >> $(DJANGO_SETTINGS_BASE_FILE)
+
+.PHONY: wagtail-sitepage-default
+wagtail-sitepage-default:
+	python manage.py startapp sitepage
+	@echo "$$WAGTAIL_SITEPAGE_MODEL" > sitepage/models.py
+	$(ADD_DIR) sitepage/templates/sitepage/
+	@echo "$$WAGTAIL_SITEPAGE_TEMPLATE" > sitepage/templates/sitepage/site_page.html
+	@echo "INSTALLED_APPS.append('sitepage')" >> $(DJANGO_SETTINGS_BASE_FILE)
+	python manage.py makemigrations sitepage
+	-$(GIT_ADD) sitepage/templates
+	-$(GIT_ADD) sitepage/*.py
+	-$(GIT_ADD) sitepage/migrations/*.py
+
+.PHONY: wagtail-urls-default
+wagtail-urls-default:
+	@echo "$$WAGTAIL_URLS" > $(DJANGO_URLS_FILE)
+
+.PHONY: wagtail-urls-home-default
+wagtail-urls-home-default:
+	@echo "$$WAGTAIL_URLS_HOME" >> $(DJANGO_URLS_FILE)
+
+.PHONY: webpack-init-default
+webpack-init-default: npm-init
+	@echo "$$WEBPACK_CONFIG_JS" > webpack.config.js
+	-$(GIT_ADD) webpack.config.js
+	npm install --save-dev webpack webpack-cli webpack-dev-server
+	$(ADD_DIR) src/
+	@echo "$$WEBPACK_INDEX_JS" > src/index.js
+	-$(GIT_ADD) src/index.js
+	@echo "$$WEBPACK_INDEX_HTML" > index.html
+	-$(GIT_ADD) index.html
+	$(MAKE) git-ignore
+
+.PHONY: webpack-init-reveal-default
+webpack-init-reveal-default: npm-init
+	@echo "$$WEBPACK_REVEAL_CONFIG_JS" > webpack.config.js
+	-$(GIT_ADD) webpack.config.js
+	npm install --save-dev webpack webpack-cli webpack-dev-server
+	$(ADD_DIR) src/
+	@echo "$$WEBPACK_REVEAL_INDEX_JS" > src/index.js
+	-$(GIT_ADD) src/index.js
+	@echo "$$WEBPACK_REVEAL_INDEX_HTML" > index.html
+	-$(GIT_ADD) index.html
+	$(MAKE) git-ignore
+
+# --------------------------------------------------------------------------------
+# Single-line phony target rules
+# --------------------------------------------------------------------------------
+
+.PHONY: aws-check-env-default
+aws-check-env-default: aws-check-env-profile aws-check-env-region
+
+.PHONY: ce-default
+ce-default: git-commit-edit git-push
+
+.PHONY: clean-default
+clean-default: wagtail-clean
+
+.PHONY: cp-default
+cp-default: git-commit-message git-push
+
+.PHONY: db-dump-default
+db-dump-default: eb-export
+
+.PHONY: dbshell-default
+dbshell-default: django-db-shell
+
+.PHONY: deploy-default
+deploy-default: eb-deploy
+
+.PHONY: d-default
+d-default: eb-deploy
+
+.PHONY: deps-default
+deps-default: pip-deps
+
+.PHONY: e-default
+e-default: edit
+
+.PHONY: edit-default
+edit-default: readme-edit
+
+.PHONY: empty-default
+empty-default: git-commit-message-empty git-push
+
+.PHONY: fp-default
+fp-default: git-push-force
+
+.PHONY: freeze-default
+freeze-default: pip-freeze git-push
+
+.PHONY: git-commit-default
+git-commit-default: git-commit-message git-push
+
+.PHONY: git-commit-clean-default
+git-commit-clean-default: git-commit-message-clean git-push
+
+.PHONY: git-commit-init-default
+git-commit-init-default: git-commit-message-init git-push
+
+.PHONY: git-commit-lint-default
+git-commit-lint-default: git-commit-message-lint git-push
+
+.PHONY: gitignore-default
+gitignore-default: git-ignore
+
+.PHONY: h-default
+h-default: help
+
+.PHONY: init-default
+init-default: django-init-wagtail django-serve
+
+.PHONY: init-wagtail-default
+init-wagtail-default: django-init-wagtail
+
+.PHONY: install-default
+install-default: pip-install
+
+.PHONY: l-default
+l-default: makefile-list-commands
+
+.PHONY: last-default
+last-default: git-commit-message-last git-push
+
+.PHONY: lint-default
+lint-default: django-lint
+
+.PHONY: list-commands-default
+list-commands-default: makefile-list-commands
+
+.PHONY: list-defines-default
+list-defines-default: makefile-list-defines
+
+.PHONY: list-exports-default
+list-exports-default: makefile-list-exports
+
+.PHONY: list-targets-default
+list-targets-default: makefile-list-targets
+
+.PHONY: migrate-default
+migrate-default: django-migrate
+
+.PHONY: migrations-default
+migrations-default: django-migrations-make
+
+.PHONY: migrations-show-default
+migrations-show-default: django-migrations-show
+
+.PHONY: mk-default
+mk-default: project.mk git-commit-message-mk git-push
+
+.PHONY: open-default
+open-default: django-open
+
+.PHONY: o-default
+o-default: django-open
+
+.PHONY: readme-default
+readme-default: readme-init
+
+.PHONY: rename-default
+rename-default: git-commit-message-rename git-push
+
+.PHONY: s-default
+s-default: django-serve
+
+.PHONY: shell-default
+shell-default: django-shell
+
+.PHONY: serve-default
+serve-default: django-serve
+
+.PHONY: static-default
+static-default: django-static
+
+.PHONY: sort-default
+sort-default: git-commit-message-sort git-push
+
+.PHONY: su-default
+su-default: django-su
+
+.PHONY: test-default
+test-default: django-test
+
+.PHONY: t-default
+t-default: django-test
+
+.PHONY: u-default
+u-default: help
+
+.PHONY: urls-default
+urls-default: django-urls-show
+
+# --------------------------------------------------------------------------------
+# Allow customizing rules defined in this Makefile with rules defined in
+# $(MAKEFILE_CUSTOM_FILE)
+# --------------------------------------------------------------------------------
+
+%: %-default  # https://stackoverflow.com/a/49804748
+	@ true

From 776eb9e9b7b4406767a45523cc833f7fbc20100b Mon Sep 17 00:00:00 2001
From: Jeffrey 'Alex' Clark <aclark@aclark.net>
Date: Wed, 21 Aug 2024 16:08:26 -0400
Subject: [PATCH 0944/1178] Add/update project-makefile files

---
 Makefile | 28 ++++++++++++++--------------
 1 file changed, 14 insertions(+), 14 deletions(-)

diff --git a/Makefile b/Makefile
index 4200f95dafd..b5fbff2c944 100644
--- a/Makefile
+++ b/Makefile
@@ -4521,21 +4521,21 @@ db-dump-default: eb-export
 .PHONY: dbshell-default
 dbshell-default: django-db-shell
 
+.PHONY: d-default
+d-default: deploy
+
 .PHONY: deploy-default
 deploy-default: eb-deploy
 
-.PHONY: d-default
-d-default: eb-deploy
-
 .PHONY: deps-default
 deps-default: pip-deps
 
-.PHONY: e-default
-e-default: edit
-
 .PHONY: edit-default
 edit-default: readme-edit
 
+.PHONY: e-default
+e-default: edit
+
 .PHONY: empty-default
 empty-default: git-commit-message-empty git-push
 
@@ -4605,12 +4605,12 @@ migrations-show-default: django-migrations-show
 .PHONY: mk-default
 mk-default: project.mk git-commit-message-mk git-push
 
-.PHONY: open-default
-open-default: django-open
-
 .PHONY: o-default
 o-default: django-open
 
+.PHONY: open-default
+open-default: open
+
 .PHONY: readme-default
 readme-default: readme-init
 
@@ -4618,14 +4618,14 @@ readme-default: readme-init
 rename-default: git-commit-message-rename git-push
 
 .PHONY: s-default
-s-default: django-serve
-
-.PHONY: shell-default
-shell-default: django-shell
+s-default: serve
 
 .PHONY: serve-default
 serve-default: django-serve
 
+.PHONY: shell-default
+shell-default: django-shell
+
 .PHONY: static-default
 static-default: django-static
 
@@ -4639,7 +4639,7 @@ su-default: django-su
 test-default: django-test
 
 .PHONY: t-default
-t-default: django-test
+t-default: test
 
 .PHONY: u-default
 u-default: help

From 837af6420d40fe772bcd910d9c531c2ca8fe980e Mon Sep 17 00:00:00 2001
From: Jeffrey 'Alex' Clark <aclark@aclark.net>
Date: Wed, 21 Aug 2024 16:43:28 -0400
Subject: [PATCH 0945/1178] Add/update project-makefile files

---
 Makefile | 14 ++++++++++++++
 1 file changed, 14 insertions(+)

diff --git a/Makefile b/Makefile
index b5fbff2c944..d8e621c6c60 100644
--- a/Makefile
+++ b/Makefile
@@ -3980,6 +3980,10 @@ git-commit-message-default:
 git-commit-message-empty-default:
 	-@$(GIT_COMMIT) --allow-empty -m "Empty-Commit"
 
+.PHONY: git-commit-message-ignore-default
+git-commit-message-ignore-default:
+	-@$(GIT_COMMIT) -a -m "Ignore"
+
 .PHONY: git-commit-message-init-default
 git-commit-message-init-default:
 	-@$(GIT_COMMIT) -a -m "Init"
@@ -4225,6 +4229,7 @@ plone-instance-default:
 	-$(GIT_ADD) backend/etc/site.zcml
 	-$(GIT_ADD) backend/etc/zope.conf
 	-$(GIT_ADD) backend/etc/zope.ini
+	-$(GIT_ADD) backend/inituser
 
 .PHONY: plone-serve-default
 plone-serve-default:
@@ -4530,6 +4535,9 @@ deploy-default: eb-deploy
 .PHONY: deps-default
 deps-default: pip-deps
 
+.PHONY: dump-default
+dump-default: db-dump
+
 .PHONY: edit-default
 edit-default: readme-edit
 
@@ -4551,6 +4559,9 @@ git-commit-default: git-commit-message git-push
 .PHONY: git-commit-clean-default
 git-commit-clean-default: git-commit-message-clean git-push
 
+.PHONY: git-commit-ignore-default
+git-commit-ignore-default: git-commit-message-ignore git-push
+
 .PHONY: git-commit-init-default
 git-commit-init-default: git-commit-message-init git-push
 
@@ -4563,6 +4574,9 @@ gitignore-default: git-ignore
 .PHONY: h-default
 h-default: help
 
+.PHONY: ignore-default
+ignore-default: git-commit-message-ignore git-push
+
 .PHONY: init-default
 init-default: django-init-wagtail django-serve
 

From 575fad24726fe25d06ea985ca59eb9126e26a00b Mon Sep 17 00:00:00 2001
From: Jeffrey 'Alex' Clark <aclark@aclark.net>
Date: Wed, 21 Aug 2024 17:02:53 -0400
Subject: [PATCH 0946/1178] Add/update project-makefile files

---
 Makefile | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/Makefile b/Makefile
index d8e621c6c60..a16a18055db 100644
--- a/Makefile
+++ b/Makefile
@@ -1996,6 +1996,7 @@ _build/
 .elasticbeanstalk/
 db.sqlite3
 static/
+backend/inituser
 backend/var
 endef
 
@@ -4229,7 +4230,6 @@ plone-instance-default:
 	-$(GIT_ADD) backend/etc/site.zcml
 	-$(GIT_ADD) backend/etc/zope.conf
 	-$(GIT_ADD) backend/etc/zope.ini
-	-$(GIT_ADD) backend/inituser
 
 .PHONY: plone-serve-default
 plone-serve-default:

From 132663a881bfe2bfc5265e7e05de7113f06501a5 Mon Sep 17 00:00:00 2001
From: Andrew Murray <radarhere@users.noreply.github.com>
Date: Thu, 22 Aug 2024 07:36:52 +1000
Subject: [PATCH 0947/1178] Updated error message for invalid width or height

---
 Tests/test_file_webp.py | 8 ++++++++
 src/_webp.c             | 7 ++++++-
 2 files changed, 14 insertions(+), 1 deletion(-)

diff --git a/Tests/test_file_webp.py b/Tests/test_file_webp.py
index 6ccd489bb47..ad08da364c0 100644
--- a/Tests/test_file_webp.py
+++ b/Tests/test_file_webp.py
@@ -157,6 +157,14 @@ def test_write_encoding_error_message(self, tmp_path: Path) -> None:
             im.save(temp_file, method=0)
         assert str(e.value) == "encoding error 6"
 
+    @pytest.mark.skipif(sys.maxsize <= 2**32, reason="Requires 64-bit system")
+    def test_write_encoding_error_bad_dimension(self, tmp_path: Path) -> None:
+        temp_file = str(tmp_path / "temp.webp")
+        im = Image.new("L", (16384, 16384))
+        with pytest.raises(ValueError) as e:
+            im.save(temp_file)
+        assert str(e.value) == "encoding error 5: Image size exceeds WebP limit"
+
     def test_WebPEncode_with_invalid_args(self) -> None:
         """
         Calling encoder functions with no arguments should result in an error.
diff --git a/src/_webp.c b/src/_webp.c
index d1943b3e0a5..0d2d6f023f8 100644
--- a/src/_webp.c
+++ b/src/_webp.c
@@ -672,7 +672,12 @@ WebPEncode_wrapper(PyObject *self, PyObject *args) {
 
     WebPPictureFree(&pic);
     if (!ok) {
-        PyErr_Format(PyExc_ValueError, "encoding error %d", (&pic)->error_code);
+        int error_code = (&pic)->error_code;
+        const char *message = "";
+        if (error_code == VP8_ENC_ERROR_BAD_DIMENSION) {
+            message = ": Image size exceeds WebP limit";
+        }
+        PyErr_Format(PyExc_ValueError, "encoding error %d%s", error_code, message);
         return NULL;
     }
     output = writer.mem;

From 0f64d08e64e2a1d8bedf280626006a95cbb2b086 Mon Sep 17 00:00:00 2001
From: Jeffrey 'Alex' Clark <aclark@aclark.net>
Date: Wed, 21 Aug 2024 21:16:02 -0400
Subject: [PATCH 0948/1178] Revert "Add/update project-makefile files"

This reverts commit 575fad24726fe25d06ea985ca59eb9126e26a00b.

Sorry for the noise (1/4)!
---
 Makefile | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/Makefile b/Makefile
index a16a18055db..d8e621c6c60 100644
--- a/Makefile
+++ b/Makefile
@@ -1996,7 +1996,6 @@ _build/
 .elasticbeanstalk/
 db.sqlite3
 static/
-backend/inituser
 backend/var
 endef
 
@@ -4230,6 +4229,7 @@ plone-instance-default:
 	-$(GIT_ADD) backend/etc/site.zcml
 	-$(GIT_ADD) backend/etc/zope.conf
 	-$(GIT_ADD) backend/etc/zope.ini
+	-$(GIT_ADD) backend/inituser
 
 .PHONY: plone-serve-default
 plone-serve-default:

From e19841afa486c33673d9ff6cb8330761414f91de Mon Sep 17 00:00:00 2001
From: Jeffrey 'Alex' Clark <aclark@aclark.net>
Date: Wed, 21 Aug 2024 21:16:35 -0400
Subject: [PATCH 0949/1178] Revert "Add/update project-makefile files"

This reverts commit 837af6420d40fe772bcd910d9c531c2ca8fe980e.

Sorry for the noise (2/4)!
---
 Makefile | 14 --------------
 1 file changed, 14 deletions(-)

diff --git a/Makefile b/Makefile
index d8e621c6c60..b5fbff2c944 100644
--- a/Makefile
+++ b/Makefile
@@ -3980,10 +3980,6 @@ git-commit-message-default:
 git-commit-message-empty-default:
 	-@$(GIT_COMMIT) --allow-empty -m "Empty-Commit"
 
-.PHONY: git-commit-message-ignore-default
-git-commit-message-ignore-default:
-	-@$(GIT_COMMIT) -a -m "Ignore"
-
 .PHONY: git-commit-message-init-default
 git-commit-message-init-default:
 	-@$(GIT_COMMIT) -a -m "Init"
@@ -4229,7 +4225,6 @@ plone-instance-default:
 	-$(GIT_ADD) backend/etc/site.zcml
 	-$(GIT_ADD) backend/etc/zope.conf
 	-$(GIT_ADD) backend/etc/zope.ini
-	-$(GIT_ADD) backend/inituser
 
 .PHONY: plone-serve-default
 plone-serve-default:
@@ -4535,9 +4530,6 @@ deploy-default: eb-deploy
 .PHONY: deps-default
 deps-default: pip-deps
 
-.PHONY: dump-default
-dump-default: db-dump
-
 .PHONY: edit-default
 edit-default: readme-edit
 
@@ -4559,9 +4551,6 @@ git-commit-default: git-commit-message git-push
 .PHONY: git-commit-clean-default
 git-commit-clean-default: git-commit-message-clean git-push
 
-.PHONY: git-commit-ignore-default
-git-commit-ignore-default: git-commit-message-ignore git-push
-
 .PHONY: git-commit-init-default
 git-commit-init-default: git-commit-message-init git-push
 
@@ -4574,9 +4563,6 @@ gitignore-default: git-ignore
 .PHONY: h-default
 h-default: help
 
-.PHONY: ignore-default
-ignore-default: git-commit-message-ignore git-push
-
 .PHONY: init-default
 init-default: django-init-wagtail django-serve
 

From 1143bffe1a0a5fe6b7d58dd2c3660f91299cff8d Mon Sep 17 00:00:00 2001
From: Jeffrey 'Alex' Clark <aclark@aclark.net>
Date: Wed, 21 Aug 2024 21:17:06 -0400
Subject: [PATCH 0950/1178] Revert "Add/update project-makefile files"

This reverts commit 776eb9e9b7b4406767a45523cc833f7fbc20100b.

Sorry for the noise (3/4)!
---
 Makefile | 28 ++++++++++++++--------------
 1 file changed, 14 insertions(+), 14 deletions(-)

diff --git a/Makefile b/Makefile
index b5fbff2c944..4200f95dafd 100644
--- a/Makefile
+++ b/Makefile
@@ -4521,21 +4521,21 @@ db-dump-default: eb-export
 .PHONY: dbshell-default
 dbshell-default: django-db-shell
 
-.PHONY: d-default
-d-default: deploy
-
 .PHONY: deploy-default
 deploy-default: eb-deploy
 
+.PHONY: d-default
+d-default: eb-deploy
+
 .PHONY: deps-default
 deps-default: pip-deps
 
-.PHONY: edit-default
-edit-default: readme-edit
-
 .PHONY: e-default
 e-default: edit
 
+.PHONY: edit-default
+edit-default: readme-edit
+
 .PHONY: empty-default
 empty-default: git-commit-message-empty git-push
 
@@ -4605,12 +4605,12 @@ migrations-show-default: django-migrations-show
 .PHONY: mk-default
 mk-default: project.mk git-commit-message-mk git-push
 
+.PHONY: open-default
+open-default: django-open
+
 .PHONY: o-default
 o-default: django-open
 
-.PHONY: open-default
-open-default: open
-
 .PHONY: readme-default
 readme-default: readme-init
 
@@ -4618,14 +4618,14 @@ readme-default: readme-init
 rename-default: git-commit-message-rename git-push
 
 .PHONY: s-default
-s-default: serve
-
-.PHONY: serve-default
-serve-default: django-serve
+s-default: django-serve
 
 .PHONY: shell-default
 shell-default: django-shell
 
+.PHONY: serve-default
+serve-default: django-serve
+
 .PHONY: static-default
 static-default: django-static
 
@@ -4639,7 +4639,7 @@ su-default: django-su
 test-default: django-test
 
 .PHONY: t-default
-t-default: test
+t-default: django-test
 
 .PHONY: u-default
 u-default: help

From d6cfebd016db25549d05a9c5caa2ef3b53cff5c5 Mon Sep 17 00:00:00 2001
From: Jeffrey 'Alex' Clark <aclark@aclark.net>
Date: Wed, 21 Aug 2024 21:17:29 -0400
Subject: [PATCH 0951/1178] Revert "Add/update project-makefile files"

This reverts commit 388fc78e36e60f45a9b5ff0cd3223e3b8bc2c307.

Sorry for the noise (4/4)!
---
 Makefile | 4781 ++----------------------------------------------------
 1 file changed, 125 insertions(+), 4656 deletions(-)

diff --git a/Makefile b/Makefile
index 4200f95dafd..94f7565d826 100644
--- a/Makefile
+++ b/Makefile
@@ -1,4656 +1,125 @@
-# Project Makefile
-#
-# A makefile to automate setup of a Wagtail CMS project and related tasks.
-#
-# https://github.com/aclark4life/project-makefile
-#
-# --------------------------------------------------------------------------------
-# Set the default goal to be `git commit -a -m $(GIT_MESSAGE)` and `git push`
-# --------------------------------------------------------------------------------
-
-.DEFAULT_GOAL := git-commit
-
-# --------------------------------------------------------------------------------
-# Single line variables to be used by phony target rules
-# --------------------------------------------------------------------------------
-
-ADD_DIR := mkdir -pv
-ADD_FILE := touch
-AWS_OPTS := --no-cli-pager --output table
-COPY_DIR := cp -rv
-COPY_FILE := cp -v
-DEL_DIR := rm -rv
-DEL_FILE := rm -v
-DJANGO_DB_COL = awk -F\= '{print $$2}'
-DJANGO_DB_URL = eb ssh -c "source /opt/elasticbeanstalk/deployment/custom_env_var; env | grep DATABASE_URL"
-DJANGO_DB_HOST = $(shell $(DJANGO_DB_URL) | $(DJANGO_DB_COL) |\
-	python -c 'import dj_database_url; url = input(); url = dj_database_url.parse(url); print(url["HOST"])')
-DJANGO_DB_NAME = $(shell $(DJANGO_DB_URL) | $(DJANGO_DB_COL) |\
-	python -c 'import dj_database_url; url = input(); url = dj_database_url.parse(url); print(url["NAME"])')
-DJANGO_DB_PASS = $(shell $(DJANGO_DB_URL) | $(DJANGO_DB_COL) |\
-	python -c 'import dj_database_url; url = input(); url = dj_database_url.parse(url); print(url["PASSWORD"])')
-DJANGO_DB_USER = $(shell $(DJANGO_DB_URL) | $(DJANGO_DB_COL) |\
-	python -c 'import dj_database_url; url = input(); url = dj_database_url.parse(url); print(url["USER"])')
-DJANGO_BACKEND_APPS_FILE := backend/apps.py
-DJANGO_CUSTOM_ADMIN_FILE := backend/admin.py
-DJANGO_FRONTEND_FILES = .babelrc .browserslistrc .eslintrc .nvmrc .stylelintrc.json frontend package-lock.json \
-	package.json postcss.config.js
-DJANGO_SETTINGS_DIR = backend/settings
-DJANGO_SETTINGS_BASE_FILE = $(DJANGO_SETTINGS_DIR)/base.py
-DJANGO_SETTINGS_DEV_FILE = $(DJANGO_SETTINGS_DIR)/dev.py
-DJANGO_SETTINGS_PROD_FILE = $(DJANGO_SETTINGS_DIR)/production.py
-DJANGO_SETTINGS_SECRET_KEY = $(shell openssl rand -base64 48)
-DJANGO_URLS_FILE = backend/urls.py
-EB_DIR_NAME := .elasticbeanstalk
-EB_ENV_NAME ?= $(PROJECT_NAME)-$(GIT_BRANCH)-$(GIT_REV)
-EB_PLATFORM ?= "Python 3.11 running on 64bit Amazon Linux 2023"
-EC2_INSTANCE_MAX ?= 1
-EC2_INSTANCE_MIN ?= 1
-EC2_INSTANCE_PROFILE ?= aws-elasticbeanstalk-ec2-role
-EC2_INSTANCE_TYPE ?= t4g.small
-EC2_LB_TYPE ?= application
-EDITOR_REVIEW = subl
-GIT_ADD := git add
-GIT_BRANCH = $(shell git branch --show-current)
-GIT_BRANCHES = $(shell git branch -a) 
-GIT_CHECKOUT = git checkout
-GIT_COMMIT_MSG = "Update $(PROJECT_NAME)"
-GIT_COMMIT = git commit
-GIT_PUSH = git push
-GIT_PUSH_FORCE = git push --force-with-lease
-GIT_REV = $(shell git rev-parse --short HEAD)
-MAKEFILE_CUSTOM_FILE := project.mk
-PACKAGE_NAME = $(shell echo $(PROJECT_NAME) | sed 's/-/_/g')
-PAGER ?= less
-PIP_ENSURE = python -m ensurepip
-PIP_INSTALL_PLONE_CONSTRAINTS = https://dist.plone.org/release/6.0.11.1/constraints.txt
-PROJECT_DIRS = backend contactpage home privacy siteuser
-PROJECT_EMAIL := aclark@aclark.net
-PROJECT_NAME = project-makefile
-RANDIR := $(shell openssl rand -base64 12 | sed 's/\///g')
-TMPDIR := $(shell mktemp -d)
-UNAME := $(shell uname)
-WAGTAIL_CLEAN_DIRS = backend contactpage dist frontend home logging_demo model_form_demo node_modules payments privacy search sitepage siteuser
-WAGTAIL_CLEAN_FILES = .babelrc .browserslistrc .dockerignore .eslintrc .gitignore .nvmrc .stylelintrc.json Dockerfile db.sqlite3 docker-compose.yml manage.py package-lock.json package.json postcss.config.js requirements-test.txt requirements.txt
-
-# --------------------------------------------------------------------------------
-# Include $(MAKEFILE_CUSTOM_FILE) if it exists
-# --------------------------------------------------------------------------------
-
-ifneq ($(wildcard $(MAKEFILE_CUSTOM_FILE)),)
-    include $(MAKEFILE_CUSTOM_FILE)
-endif
-
-# --------------------------------------------------------------------------------
-# Multi-line variables to be used in phony target rules
-# --------------------------------------------------------------------------------
-
-define DJANGO_ALLAUTH_BASE_TEMPLATE
-{% extends 'base.html' %}
-endef
-
-define DJANGO_API_SERIALIZERS
-from rest_framework import serializers
-from siteuser.models import User
-
-
-class UserSerializer(serializers.HyperlinkedModelSerializer):
-    class Meta:
-        model = User
-        fields = ["url", "username", "email", "is_staff"]
-endef
-
-define DJANGO_API_VIEWS
-from ninja import NinjaAPI
-from rest_framework import viewsets
-from siteuser.models import User
-from .serializers import UserSerializer
-
-api = NinjaAPI()
-
-
-@api.get("/hello")
-def hello(request):
-    return "Hello world"
-
-
-class UserViewSet(viewsets.ModelViewSet):
-    queryset = User.objects.all()
-    serializer_class = UserSerializer
-endef
-
-define DJANGO_APP_TESTS
-from django.test import TestCase
-from django.urls import reverse
-from .models import YourModel
-from .forms import YourForm
-
-
-class YourModelTest(TestCase):
-    def setUp(self):
-        self.instance = YourModel.objects.create(field1="value1", field2="value2")
-
-    def test_instance_creation(self):
-        self.assertIsInstance(self.instance, YourModel)
-        self.assertEqual(self.instance.field1, "value1")
-        self.assertEqual(self.instance.field2, "value2")
-
-    def test_str_method(self):
-        self.assertEqual(str(self.instance), "Expected String Representation")
-
-
-class YourViewTest(TestCase):
-    def setUp(self):
-        self.instance = YourModel.objects.create(field1="value1", field2="value2")
-
-    def test_view_url_exists_at_desired_location(self):
-        response = self.client.get("/your-url/")
-        self.assertEqual(response.status_code, 200)
-
-    def test_view_url_accessible_by_name(self):
-        response = self.client.get(reverse("your-view-name"))
-        self.assertEqual(response.status_code, 200)
-
-    def test_view_uses_correct_template(self):
-        response = self.client.get(reverse("your-view-name"))
-        self.assertEqual(response.status_code, 200)
-        self.assertTemplateUsed(response, "your_template.html")
-
-    def test_view_context(self):
-        response = self.client.get(reverse("your-view-name"))
-        self.assertEqual(response.status_code, 200)
-        self.assertIn("context_variable", response.context)
-
-
-class YourFormTest(TestCase):
-    def test_form_valid_data(self):
-        form = YourForm(data={"field1": "value1", "field2": "value2"})
-        self.assertTrue(form.is_valid())
-
-    def test_form_invalid_data(self):
-        form = YourForm(data={"field1": "", "field2": "value2"})
-        self.assertFalse(form.is_valid())
-        self.assertIn("field1", form.errors)
-
-    def test_form_save(self):
-        form = YourForm(data={"field1": "value1", "field2": "value2"})
-        if form.is_valid():
-            instance = form.save()
-            self.assertEqual(instance.field1, "value1")
-            self.assertEqual(instance.field2, "value2")
-endef
-
-define DJANGO_BACKEND_APPS
-from django.contrib.admin.apps import AdminConfig
-
-
-class CustomAdminConfig(AdminConfig):
-    default_site = "backend.admin.CustomAdminSite"
-endef
-
-define DJANGO_BASE_TEMPLATE
-{% load static webpack_loader %}
-<!DOCTYPE html>
-<html lang="en"
-      class="h-100"
-      data-bs-theme="{{ request.user.user_theme_preference|default:'light' }}">
-    <head>
-        <meta charset="utf-8" />
-        <title>
-            {% block title %}{% endblock %}
-            {% block title_suffix %}{% endblock %}
-        </title>
-        <meta name="viewport" content="width=device-width, initial-scale=1" />
-        {% stylesheet_pack 'app' %}
-        {% block extra_css %}{# Override this in templates to add extra stylesheets #}{% endblock %}
-        <style>
-            .success {
-                background-color: #d4edda;
-                border-color: #c3e6cb;
-                color: #155724;
-            }
-
-            .info {
-                background-color: #d1ecf1;
-                border-color: #bee5eb;
-                color: #0c5460;
-            }
-
-            .warning {
-                background-color: #fff3cd;
-                border-color: #ffeeba;
-                color: #856404;
-            }
-
-            .danger {
-                background-color: #f8d7da;
-                border-color: #f5c6cb;
-                color: #721c24;
-            }
-        </style>
-        {% include 'favicon.html' %}
-        {% csrf_token %}
-    </head>
-    <body class="{% block body_class %}{% endblock %} d-flex flex-column h-100">
-        <main class="flex-shrink-0">
-            <div id="app"></div>
-            {% include 'header.html' %}
-            {% if messages %}
-                <div class="messages container">
-                    {% for message in messages %}
-                        <div class="alert {{ message.tags }} alert-dismissible fade show"
-                             role="alert">
-                            {{ message }}
-                            <button type="button"
-                                    class="btn-close"
-                                    data-bs-dismiss="alert"
-                                    aria-label="Close"></button>
-                        </div>
-                    {% endfor %}
-                </div>
-            {% endif %}
-            <div class="container">
-                {% block content %}{% endblock %}
-            </div>
-        </main>
-        {% include 'footer.html' %}
-        {% include 'offcanvas.html' %}
-        {% javascript_pack 'app' %}
-        {% block extra_js %}{# Override this in templates to add extra javascript #}{% endblock %}
-    </body>
-</html>
-endef
-
-define DJANGO_CUSTOM_ADMIN
-from django.contrib.admin import AdminSite
-
-
-class CustomAdminSite(AdminSite):
-    site_header = "Project Makefile"
-    site_title = "Project Makefile"
-    index_title = "Project Makefile"
-
-
-custom_admin_site = CustomAdminSite(name="custom_admin")
-endef
-
-define DJANGO_DOCKERCOMPOSE
-version: '3'
-
-services:
-  db:
-    image: postgres:latest
-    volumes:
-      - postgres_data:/var/lib/postgresql/data
-    environment:
-      POSTGRES_DB: project
-      POSTGRES_USER: admin
-      POSTGRES_PASSWORD: admin
-
-  web:
-    build: .
-    command: sh -c "python manage.py migrate && gunicorn project.wsgi:application -b 0.0.0.0:8000"
-    volumes:
-      - .:/app
-    ports:
-      - "8000:8000"
-    depends_on:
-      - db
-    environment:
-      DATABASE_URL: postgres://admin:admin@db:5432/project
-
-volumes:
-  postgres_data:
-endef
-
-define DJANGO_DOCKERFILE
-FROM amazonlinux:2023
-RUN dnf install -y shadow-utils python3.11 python3.11-pip make nodejs20-npm nodejs postgresql15 postgresql15-server
-USER postgres
-RUN initdb -D /var/lib/pgsql/data
-USER root
-RUN useradd wagtail
-EXPOSE 8000
-ENV PYTHONUNBUFFERED=1 PORT=8000
-COPY requirements.txt /
-RUN python3.11 -m pip install -r /requirements.txt
-WORKDIR /app
-RUN chown wagtail:wagtail /app
-COPY --chown=wagtail:wagtail . .
-USER wagtail
-RUN npm-20 install; npm-20 run build
-RUN python3.11 manage.py collectstatic --noinput --clear
-CMD set -xe; pg_ctl -D /var/lib/pgsql/data -l /tmp/logfile start; python3.11 manage.py migrate --noinput; gunicorn backend.wsgi:application
-endef
-
-define DJANGO_FAVICON_TEMPLATE
-{% load static %}
-<link href="{% static 'wagtailadmin/images/favicon.ico' %}" rel="icon">
-endef
-
-define DJANGO_FOOTER_TEMPLATE
-<footer class="footer mt-auto py-3 bg-body-tertiary pt-5 text-center text-small">
-    <p class="mb-1">&copy; {% now "Y" %} {{ current_site.site_name|default:"Project Makefile" }}</p>
-    <ul class="list-inline">
-        <li class="list-inline-item">
-            <a class="text-secondary text-decoration-none {% if request.path == '/' %}active{% endif %}"
-               href="/">Home</a>
-        </li>
-        {% for child in current_site.root_page.get_children %}
-            <li class="list-inline-item">
-                <a class="text-secondary text-decoration-none {% if request.path == child.url %}active{% endif %}"
-                   href="{{ child.url }}">{{ child }}</a>
-            </li>
-        {% endfor %}
-    </ul>
-</footer>
-endef
-
-define DJANGO_FRONTEND_APP
-import React from 'react';
-import { createRoot } from 'react-dom/client';
-import 'bootstrap';
-import '@fortawesome/fontawesome-free/js/fontawesome';
-import '@fortawesome/fontawesome-free/js/solid';
-import '@fortawesome/fontawesome-free/js/regular';
-import '@fortawesome/fontawesome-free/js/brands';
-import getDataComponents from '../dataComponents';
-import UserContextProvider from '../context';
-import * as components from '../components';
-import "../styles/index.scss";
-import "../styles/theme-blue.scss";
-import "./config";
-
-const { ErrorBoundary } = components;
-const dataComponents = getDataComponents(components);
-const container = document.getElementById('app');
-const root = createRoot(container);
-const App = () => (
-    <ErrorBoundary>
-      <UserContextProvider>
-        {dataComponents}
-      </UserContextProvider>
-    </ErrorBoundary>
-);
-root.render(<App />);
-endef
-
-define DJANGO_FRONTEND_APP_CONFIG
-import '../utils/themeToggler.js';
-// import '../utils/tinymce.js';
-endef
-
-define DJANGO_FRONTEND_BABELRC
-{
-  "presets": [
-    [
-      "@babel/preset-react",
-    ],
-    [
-      "@babel/preset-env",
-      {
-        "useBuiltIns": "usage",
-        "corejs": "3.0.0"
-      }
-    ]
-  ],
-  "plugins": [
-    "@babel/plugin-syntax-dynamic-import",
-    "@babel/plugin-transform-class-properties"
-  ]
-}
-endef
-
-define DJANGO_FRONTEND_COMPONENTS
-export { default as ErrorBoundary } from './ErrorBoundary';
-export { default as UserMenu } from './UserMenu';
-endef
-
-define DJANGO_FRONTEND_COMPONENT_CLOCK
-// Via ChatGPT
-import React, { useState, useEffect, useCallback, useRef } from 'react';
-import PropTypes from 'prop-types';
-
-const Clock = ({ color = '#fff' }) => {
-  const [date, setDate] = useState(new Date());
-  const [blink, setBlink] = useState(true);
-  const timerID = useRef();
-
-  const tick = useCallback(() => {
-    setDate(new Date());
-    setBlink(prevBlink => !prevBlink);
-  }, []);
-
-  useEffect(() => {
-    timerID.current = setInterval(() => tick(), 1000);
-
-    // Return a cleanup function to be run on component unmount
-    return () => clearInterval(timerID.current);
-  }, [tick]);
-
-  const formattedDate = date.toLocaleDateString(undefined, {
-    weekday: 'short',
-    year: 'numeric',
-    month: 'short',
-    day: 'numeric',
-  });
-
-  const formattedTime = date.toLocaleTimeString(undefined, {
-    hour: 'numeric',
-    minute: 'numeric',
-  });
-
-  return (
-    <> 
-      <div style={{ animation: blink ? 'blink 1s infinite' : 'none' }}><span className='me-2'>{formattedDate}</span> {formattedTime}</div>
-    </>
-  );
-};
-
-Clock.propTypes = {
-  color: PropTypes.string,
-};
-
-export default Clock;
-endef
-
-define DJANGO_FRONTEND_COMPONENT_ERROR
-import { Component } from 'react';
-import PropTypes from 'prop-types';
-
-class ErrorBoundary extends Component {
-  constructor (props) {
-    super(props);
-    this.state = { hasError: false };
-  }
-
-  static getDerivedStateFromError () {
-    return { hasError: true };
-  }
-
-  componentDidCatch (error, info) {
-    const { onError } = this.props;
-    console.error(error);
-    onError && onError(error, info);
-  }
-
-  render () {
-    const { children = null } = this.props;
-    const { hasError } = this.state;
-
-    return hasError ? null : children;
-  }
-}
-
-ErrorBoundary.propTypes = {
-  onError: PropTypes.func,
-  children: PropTypes.node,
-};
-
-export default ErrorBoundary;
-endef
-
-define DJANGO_FRONTEND_COMPONENT_USER_MENU
-// UserMenu.js
-import React from 'react';
-import PropTypes from 'prop-types';
-
-function handleLogout() {
-    window.location.href = '/accounts/logout';
-}
-
-const UserMenu = ({ isAuthenticated, isSuperuser, textColor }) => {
-  return (
-    <div> 
-      {isAuthenticated ? (
-        <li className="nav-item dropdown">
-          <a className="nav-link dropdown-toggle" type="button" data-bs-toggle="dropdown" aria-expanded="false">
-              <i className="fa-solid fa-circle-user"></i>
-          </a>
-          <ul className="dropdown-menu">
-            <li><a className="dropdown-item" href="/user/profile/">Profile</a></li>
-            <li><a className="dropdown-item" href="/model-form-demo/">Model Form Demo</a></li>
-            <li><a className="dropdown-item" href="/logging-demo/">Logging Demo</a></li>
-            <li><a className="dropdown-item" href="/payments/">Payments Demo</a></li>
-            {isSuperuser ? (
-              <>
-                <li><hr className="dropdown-divider"></hr></li>
-                <li><a className="dropdown-item" href="/django" target="_blank">Django admin</a></li>
-                <li><a className="dropdown-item" href="/api" target="_blank">Django API</a></li>
-                <li><a className="dropdown-item" href="/wagtail" target="_blank">Wagtail admin</a></li>
-                <li><a className="dropdown-item" href="/explorer" target="_blank">SQL Explorer</a></li>
-              </>
-            ) : null}
-            <li><hr className="dropdown-divider"></hr></li>
-            <li><a className="dropdown-item" href="/accounts/logout">Logout</a></li>
-          </ul>
-        </li>
-      ) : (
-        <li className="nav-item">
-          <a className={`nav-link text-$${textColor}`} href="/accounts/login"><i className="fa-solid fa-circle-user"></i></a>
-        </li>
-      )}
-    </div>
-  );
-};
-
-UserMenu.propTypes = {
-  isAuthenticated: PropTypes.bool.isRequired,
-  isSuperuser: PropTypes.bool.isRequired,
-  textColor: PropTypes.string,
-};
-
-export default UserMenu;
-endef
-
-define DJANGO_FRONTEND_CONTEXT_INDEX
-export { UserContextProvider as default } from './UserContextProvider';
-endef
-
-define DJANGO_FRONTEND_CONTEXT_USER_PROVIDER
-// UserContextProvider.js
-import React, { createContext, useContext, useState } from 'react';
-import PropTypes from 'prop-types';
-
-const UserContext = createContext();
-
-export const UserContextProvider = ({ children }) => {
-  const [isAuthenticated, setIsAuthenticated] = useState(false);
-
-  const login = () => {
-    try {
-      // Add logic to handle login, set isAuthenticated to true
-      setIsAuthenticated(true);
-    } catch (error) {
-      console.error('Login error:', error);
-      // Handle error, e.g., show an error message to the user
-    }
-  };
-
-  const logout = () => {
-    try {
-      // Add logic to handle logout, set isAuthenticated to false
-      setIsAuthenticated(false);
-    } catch (error) {
-      console.error('Logout error:', error);
-      // Handle error, e.g., show an error message to the user
-    }
-  };
-
-  return (
-    <UserContext.Provider value={{ isAuthenticated, login, logout }}>
-      {children}
-    </UserContext.Provider>
-  );
-};
-
-UserContextProvider.propTypes = {
-  children: PropTypes.node.isRequired,
-};
-
-export const useUserContext = () => {
-  const context = useContext(UserContext);
-
-  if (!context) {
-    throw new Error('useUserContext must be used within a UserContextProvider');
-  }
-
-  return context;
-};
-
-// Add PropTypes for the return value of useUserContext
-useUserContext.propTypes = {
-  isAuthenticated: PropTypes.bool.isRequired,
-  login: PropTypes.func.isRequired,
-  logout: PropTypes.func.isRequired,
-};
-endef
-
-define DJANGO_FRONTEND_ESLINTRC
-{
-    "env": {
-        "browser": true,
-        "es2021": true,
-        "node": true
-    },
-    "extends": [
-        "eslint:recommended",
-        "plugin:react/recommended"
-    ],
-    "overrides": [
-        {
-            "env": {
-                "node": true
-            },
-            "files": [
-                ".eslintrc.{js,cjs}"
-            ],
-            "parserOptions": {
-                "sourceType": "script"
-            }
-        }
-    ],
-    "parserOptions": {
-        "ecmaVersion": "latest",
-        "sourceType": "module"
-    },
-    "plugins": [
-        "react"
-    ],
-    "rules": {
-        "no-unused-vars": "off"
-    },
-    settings: {
-      react: {
-        version: 'detect',
-      },
-    },
-}
-endef
-
-define DJANGO_FRONTEND_OFFCANVAS_TEMPLATE
-<div class="offcanvas offcanvas-start bg-dark"
-     tabindex="-1"
-     id="offcanvasExample"
-     aria-labelledby="offcanvasExampleLabel">
-    <div class="offcanvas-header">
-        <a class="offcanvas-title text-light h5 text-decoration-none"
-           id="offcanvasExampleLabel"
-           href="/">{{ current_site.site_name|default:"Project Makefile" }}</a>
-        <button type="button"
-                class="btn-close bg-light"
-                data-bs-dismiss="offcanvas"
-                aria-label="Close"></button>
-    </div>
-    <div class="offcanvas-body bg-dark">
-        <ul class="navbar-nav justify-content-end flex-grow-1 pe-3">
-            <li class="nav-item">
-                <a class="nav-link text-light active" aria-current="page" href="/">Home</a>
-            </li>
-            {% for child in current_site.root_page.get_children %}
-                <li class="nav-item">
-                    <a class="nav-link text-light" href="{{ child.url }}">{{ child }}</a>
-                </li>
-            {% endfor %}
-            <li class="nav-item"
-                id="{% if request.user.is_authenticated %}theme-toggler-authenticated{% else %}theme-toggler-anonymous{% endif %}">
-                <span class="nav-link text-light"
-                      data-bs-toggle="tooltip"
-                      title="Toggle dark mode">
-                    <i class="fas fa-circle-half-stroke"></i>
-                </span>
-            </li>
-            <div data-component="UserMenu"
-                 data-text-color="light"
-                 data-is-authenticated="{{ request.user.is_authenticated }}"
-                 data-is-superuser="{{ request.user.is_superuser }}"></div>
-        </ul>
-    </div>
-</div>
-endef
-
-define DJANGO_FRONTEND_PORTAL
-// Via pwellever
-import React from 'react';
-import { createPortal } from 'react-dom';
-
-const parseProps = data => Object.entries(data).reduce((result, [key, value]) => {
-  if (value.toLowerCase() === 'true') {
-    value = true;
-  } else if (value.toLowerCase() === 'false') {
-    value = false;
-  } else if (value.toLowerCase() === 'null') {
-    value = null;
-  } else if (!isNaN(parseFloat(value)) && isFinite(value)) {
-    // Parse numeric value
-    value = parseFloat(value);
-  } else if (
-    (value[0] === '[' && value.slice(-1) === ']') || (value[0] === '{' && value.slice(-1) === '}')
-  ) {
-    // Parse JSON strings
-    value = JSON.parse(value);
-  }
-
-  result[key] = value;
-  return result;
-}, {});
-
-// This method of using portals instead of calling ReactDOM.render on individual components
-// ensures that all components are mounted under a single React tree, and are therefore able
-// to share context.
-
-export default function getPageComponents (components) {
-  const getPortalComponent = domEl => {
-    // The element's "data-component" attribute is used to determine which component to render.
-    // All other "data-*" attributes are passed as props.
-    const { component: componentName, ...rest } = domEl.dataset;
-    const Component = components[componentName];
-    if (!Component) {
-      console.error(`Component "$${componentName}" not found.`);
-      return null;
-    }
-    const props = parseProps(rest);
-    domEl.innerHTML = '';
-
-    // eslint-disable-next-line no-unused-vars
-    const { ErrorBoundary } = components;
-    return createPortal(
-      <ErrorBoundary>
-        <Component {...props} />
-      </ErrorBoundary>,
-      domEl,
-    );
-  };
-
-  return Array.from(document.querySelectorAll('[data-component]')).map(getPortalComponent);
-}
-endef
-
-define DJANGO_FRONTEND_STYLES
-// If you comment out code below, bootstrap will use red as primary color
-// and btn-primary will become red
-
-// $primary: red;
-
-@import "~bootstrap/scss/bootstrap.scss";
-
-.jumbotron {
-  // should be relative path of the entry scss file
-  background-image: url("../../vendors/images/sample.jpg");
-  background-size: cover;
-}
-
-#theme-toggler-authenticated:hover {
-    cursor: pointer; /* Change cursor to pointer on hover */
-    color: #007bff; /* Change color on hover */
-}
-
-#theme-toggler-anonymous:hover {
-    cursor: pointer; /* Change cursor to pointer on hover */
-    color: #007bff; /* Change color on hover */
-}
-endef
-
-define DJANGO_FRONTEND_THEME_BLUE
-@import "~bootstrap/scss/bootstrap.scss";
-
-[data-bs-theme="blue"] {
-  --bs-body-color: var(--bs-white);
-  --bs-body-color-rgb: #{to-rgb($$white)};
-  --bs-body-bg: var(--bs-blue);
-  --bs-body-bg-rgb: #{to-rgb($$blue)};
-  --bs-tertiary-bg: #{$$blue-600};
-
-  .dropdown-menu {
-    --bs-dropdown-bg: #{color-mix($$blue-500, $$blue-600)};
-    --bs-dropdown-link-active-bg: #{$$blue-700};
-  }
-
-  .btn-secondary {
-    --bs-btn-bg: #{color-mix($gray-600, $blue-400, .5)};
-    --bs-btn-border-color: #{rgba($$white, .25)};
-    --bs-btn-hover-bg: #{color-adjust(color-mix($gray-600, $blue-400, .5), 5%)};
-    --bs-btn-hover-border-color: #{rgba($$white, .25)};
-    --bs-btn-active-bg: #{color-adjust(color-mix($gray-600, $blue-400, .5), 10%)};
-    --bs-btn-active-border-color: #{rgba($$white, .5)};
-    --bs-btn-focus-border-color: #{rgba($$white, .5)};
-
-    // --bs-btn-focus-box-shadow: 0 0 0 .25rem rgba(255, 255, 255, 20%);
-  }
-}
-endef
-
-define DJANGO_FRONTEND_THEME_TOGGLER
-document.addEventListener('DOMContentLoaded', function () {
-    const rootElement = document.documentElement;
-    const anonThemeToggle = document.getElementById('theme-toggler-anonymous');
-    const authThemeToggle = document.getElementById('theme-toggler-authenticated');
-    if (authThemeToggle) {
-        localStorage.removeItem('data-bs-theme');
-    }
-    const anonSavedTheme = localStorage.getItem('data-bs-theme');
-    if (anonSavedTheme) {
-        rootElement.setAttribute('data-bs-theme', anonSavedTheme);
-    }
-    if (anonThemeToggle) {
-        anonThemeToggle.addEventListener('click', function () {
-            const currentTheme = rootElement.getAttribute('data-bs-theme') || 'light';
-            const newTheme = currentTheme === 'light' ? 'dark' : 'light';
-            rootElement.setAttribute('data-bs-theme', newTheme);
-            localStorage.setItem('data-bs-theme', newTheme);
-        });
-    }
-    if (authThemeToggle) {
-        const csrfToken = document.querySelector('[name=csrfmiddlewaretoken]').value;
-        authThemeToggle.addEventListener('click', function () {
-            const currentTheme = rootElement.getAttribute('data-bs-theme') || 'light';
-            const newTheme = currentTheme === 'light' ? 'dark' : 'light';
-            fetch('/user/update_theme_preference/', {
-                method: 'POST',
-                headers: {
-                    'Content-Type': 'application/json',
-                    'X-CSRFToken': csrfToken, // Include the CSRF token in the headers
-                },
-                body: JSON.stringify({ theme: newTheme }),
-            })
-            .then(response => response.json())
-            .then(data => {
-                rootElement.setAttribute('data-bs-theme', newTheme);
-            })
-            .catch(error => {
-                console.error('Error updating theme preference:', error);
-            });
-        });
-    }
-});
-endef
-
-define DJANGO_HEADER_TEMPLATE
-<div class="app-header">
-    <div class="container py-4 app-navbar">
-        <nav class="navbar navbar-transparent navbar-padded navbar-expand-md">
-            <a class="navbar-brand me-auto" href="/">{{ current_site.site_name|default:"Project Makefile" }}</a>
-            <button class="navbar-toggler"
-                    type="button"
-                    data-bs-toggle="offcanvas"
-                    data-bs-target="#offcanvasExample"
-                    aria-controls="offcanvasExample"
-                    aria-expanded="false"
-                    aria-label="Toggle navigation">
-                <span class="navbar-toggler-icon"></span>
-            </button>
-            <div class="d-none d-md-block">
-                <ul class="navbar-nav">
-                    <li class="nav-item">
-                        <a id="home-nav"
-                           class="nav-link {% if request.path == '/' %}active{% endif %}"
-                           aria-current="page"
-                           href="/">Home</a>
-                    </li>
-                    {% for child in current_site.root_page.get_children %}
-                        {% if child.show_in_menus %}
-                            <li class="nav-item">
-                                <a class="nav-link {% if request.path == child.url %}active{% endif %}"
-                                   aria-current="page"
-                                   href="{{ child.url }}">{{ child }}</a>
-                            </li>
-                        {% endif %}
-                    {% endfor %}
-                    <div data-component="UserMenu"
-                         data-is-authenticated="{{ request.user.is_authenticated }}"
-                         data-is-superuser="{{ request.user.is_superuser }}"></div>
-                    <li class="nav-item"
-                        id="{% if request.user.is_authenticated %}theme-toggler-authenticated{% else %}theme-toggler-anonymous{% endif %}">
-                        <span class="nav-link" data-bs-toggle="tooltip" title="Toggle dark mode">
-                            <i class="fas fa-circle-half-stroke"></i>
-                        </span>
-                    </li>
-                    <li class="nav-item">
-                        <form class="form" action="/search">
-                            <div class="row">
-                                <div class="col-8">
-                                    <input class="form-control"
-                                           type="search"
-                                           name="query"
-                                           {% if search_query %}value="{{ search_query }}"{% endif %}>
-                                </div>
-                                <div class="col-4">
-                                    <input type="submit" value="Search" class="form-control">
-                                </div>
-                            </div>
-                        </form>
-                    </li>
-                </ul>
-            </div>
-        </nav>
-    </div>
-</div>
-endef 
-
-define DJANGO_HOME_PAGE_ADMIN
-from django.contrib import admin  # noqa
-
-# Register your models here.
-endef
-
-define DJANGO_HOME_PAGE_MODELS
-from django.db import models  # noqa
-
-# Create your models here.
-endef
-
-define DJANGO_HOME_PAGE_TEMPLATE
-{% extends "base.html" %}
-{% block content %}
-    <main class="{% block main_class %}{% endblock %}">
-    </main>
-{% endblock %}
-endef
-
-define DJANGO_HOME_PAGE_URLS
-from django.urls import path
-from .views import HomeView
-
-urlpatterns = [path("", HomeView.as_view(), name="home")]
-endef
-
-define DJANGO_HOME_PAGE_VIEWS
-from django.views.generic import TemplateView
-
-
-class HomeView(TemplateView):
-    template_name = "home.html"
-endef
-
-define DJANGO_LOGGING_DEMO_ADMIN
-# Register your models here.
-endef
-
-define DJANGO_LOGGING_DEMO_MODELS
-from django.db import models  # noqa
-
-# Create your models here.
-endef
-
-define DJANGO_LOGGING_DEMO_SETTINGS
-INSTALLED_APPS.append("logging_demo")  # noqa
-endef
-
-define DJANGO_LOGGING_DEMO_URLS
-from django.urls import path
-from .views import logging_demo
-
-urlpatterns = [
-    path("", logging_demo, name="logging_demo"),
-]
-endef
-
-define DJANGO_LOGGING_DEMO_VIEWS
-from django.http import HttpResponse
-import logging
-
-logger = logging.getLogger(__name__)
-
-
-def logging_demo(request):
-    logger.debug("Hello, world!")
-    return HttpResponse("Hello, world!")
-endef
-
-define DJANGO_MANAGE_PY
-#!/usr/bin/env python
-"""Django's command-line utility for administrative tasks."""
-
-import os
-import sys
-
-
-def main():
-    """Run administrative tasks."""
-    os.environ.setdefault("DJANGO_SETTINGS_MODULE", "backend.settings.dev")
-    try:
-        from django.core.management import execute_from_command_line
-    except ImportError as exc:
-        raise ImportError(
-            "Couldn't import Django. Are you sure it's installed and "
-            "available on your PYTHONPATH environment variable? Did you "
-            "forget to activate a virtual environment?"
-        ) from exc
-    execute_from_command_line(sys.argv)
-
-
-if __name__ == "__main__":
-    main()
-endef
-
-define DJANGO_MODEL_FORM_DEMO_ADMIN
-from django.contrib import admin
-from .models import ModelFormDemo
-
-
-@admin.register(ModelFormDemo)
-class ModelFormDemoAdmin(admin.ModelAdmin):
-    pass
-endef
-
-define DJANGO_MODEL_FORM_DEMO_FORMS
-from django import forms
-from .models import ModelFormDemo
-
-
-class ModelFormDemoForm(forms.ModelForm):
-    class Meta:
-        model = ModelFormDemo
-        fields = ["name", "email", "age", "is_active"]
-endef
-
-define DJANGO_MODEL_FORM_DEMO_MODEL
-from django.db import models
-from django.shortcuts import reverse
-
-
-class ModelFormDemo(models.Model):
-    name = models.CharField(max_length=100, blank=True, null=True)
-    email = models.EmailField(blank=True, null=True)
-    age = models.IntegerField(blank=True, null=True)
-    is_active = models.BooleanField(default=True)
-    created_at = models.DateTimeField(auto_now_add=True)
-
-    def __str__(self):
-        return self.name or f"test-model-{self.pk}"
-
-    def get_absolute_url(self):
-        return reverse("model_form_demo_detail", kwargs={"pk": self.pk})
-endef
-
-define DJANGO_MODEL_FORM_DEMO_TEMPLATE_DETAIL
-{% extends 'base.html' %}
-{% block content %}
-    <h1>Test Model Detail: {{ model_form_demo.name }}</h1>
-    <p>Name: {{ model_form_demo.name }}</p>
-    <p>Email: {{ model_form_demo.email }}</p>
-    <p>Age: {{ model_form_demo.age }}</p>
-    <p>Active: {{ model_form_demo.is_active }}</p>
-    <p>Created At: {{ model_form_demo.created_at }}</p>
-    <a href="{% url 'model_form_demo_update' model_form_demo.pk %}">Edit Test Model</a>
-{% endblock %}
-endef
-
-define DJANGO_MODEL_FORM_DEMO_TEMPLATE_FORM
-{% extends 'base.html' %}
-{% block content %}
-    <h1>
-        {% if form.instance.pk %}
-            Update Test Model
-        {% else %}
-            Create Test Model
-        {% endif %}
-    </h1>
-    <form method="post">
-        {% csrf_token %}
-        {{ form.as_p }}
-        <button type="submit">Save</button>
-    </form>
-{% endblock %}
-endef
-
-define DJANGO_MODEL_FORM_DEMO_TEMPLATE_LIST
-{% extends 'base.html' %}
-{% block content %}
-    <h1>Test Models List</h1>
-    <ul>
-        {% for model_form_demo in model_form_demos %}
-            <li>
-                <a href="{% url 'model_form_demo_detail' model_form_demo.pk %}">{{ model_form_demo.name }}</a>
-            </li>
-        {% endfor %}
-    </ul>
-    <a href="{% url 'model_form_demo_create' %}">Create New Test Model</a>
-{% endblock %}
-endef
-
-define DJANGO_MODEL_FORM_DEMO_URLS
-from django.urls import path
-from .views import (
-    ModelFormDemoListView,
-    ModelFormDemoCreateView,
-    ModelFormDemoUpdateView,
-    ModelFormDemoDetailView,
-)
-
-urlpatterns = [
-    path("", ModelFormDemoListView.as_view(), name="model_form_demo_list"),
-    path("create/", ModelFormDemoCreateView.as_view(), name="model_form_demo_create"),
-    path(
-        "<int:pk>/update/",
-        ModelFormDemoUpdateView.as_view(),
-        name="model_form_demo_update",
-    ),
-    path("<int:pk>/", ModelFormDemoDetailView.as_view(), name="model_form_demo_detail"),
-]
-endef
-
-define DJANGO_MODEL_FORM_DEMO_VIEWS
-from django.views.generic import ListView, CreateView, UpdateView, DetailView
-from .models import ModelFormDemo
-from .forms import ModelFormDemoForm
-
-
-class ModelFormDemoListView(ListView):
-    model = ModelFormDemo
-    template_name = "model_form_demo_list.html"
-    context_object_name = "model_form_demos"
-
-
-class ModelFormDemoCreateView(CreateView):
-    model = ModelFormDemo
-    form_class = ModelFormDemoForm
-    template_name = "model_form_demo_form.html"
-
-    def form_valid(self, form):
-        form.instance.created_by = self.request.user
-        return super().form_valid(form)
-
-
-class ModelFormDemoUpdateView(UpdateView):
-    model = ModelFormDemo
-    form_class = ModelFormDemoForm
-    template_name = "model_form_demo_form.html"
-
-
-class ModelFormDemoDetailView(DetailView):
-    model = ModelFormDemo
-    template_name = "model_form_demo_detail.html"
-    context_object_name = "model_form_demo"
-endef
-
-define DJANGO_PAYMENTS_ADMIN
-from django.contrib import admin
-from .models import Product, Order
-
-admin.site.register(Product)
-admin.site.register(Order)
-endef
-
-define DJANGO_PAYMENTS_FORM
-from django import forms
-
-
-class PaymentsForm(forms.Form):
-    stripeToken = forms.CharField(widget=forms.HiddenInput())
-    amount = forms.DecimalField(
-        max_digits=10, decimal_places=2, widget=forms.HiddenInput()
-    )
-endef
-
-define DJANGO_PAYMENTS_MIGRATION_0002
-from django.db import migrations
-import os
-import secrets
-import logging
-
-logger = logging.getLogger(__name__)
-
-
-def generate_default_key():
-    return "sk_test_" + secrets.token_hex(24)
-
-
-def set_stripe_api_keys(apps, schema_editor):
-    # Get the Stripe API Key model
-    APIKey = apps.get_model("djstripe", "APIKey")
-
-    # Fetch the keys from environment variables or generate default keys
-    test_secret_key = os.environ.get("STRIPE_TEST_SECRET_KEY", generate_default_key())
-    live_secret_key = os.environ.get("STRIPE_LIVE_SECRET_KEY", generate_default_key())
-
-    logger.info("STRIPE_TEST_SECRET_KEY: %s", test_secret_key)
-    logger.info("STRIPE_LIVE_SECRET_KEY: %s", live_secret_key)
-
-    # Check if the keys are not already in the database
-    if not APIKey.objects.filter(secret=test_secret_key).exists():
-        APIKey.objects.create(secret=test_secret_key, livemode=False)
-        logger.info("Added test secret key to the database.")
-    else:
-        logger.info("Test secret key already exists in the database.")
-
-    if not APIKey.objects.filter(secret=live_secret_key).exists():
-        APIKey.objects.create(secret=live_secret_key, livemode=True)
-        logger.info("Added live secret key to the database.")
-    else:
-        logger.info("Live secret key already exists in the database.")
-
-
-class Migration(migrations.Migration):
-
-    dependencies = [
-        ("payments", "0001_initial"),
-    ]
-
-    operations = [
-        migrations.RunPython(set_stripe_api_keys),
-    ]
-endef
-
-define DJANGO_PAYMENTS_MIGRATION_0003
-from django.db import migrations
-
-
-def create_initial_products(apps, schema_editor):
-    Product = apps.get_model("payments", "Product")
-    Product.objects.create(name="T-shirt", description="A cool T-shirt", price=20.00)
-    Product.objects.create(name="Mug", description="A nice mug", price=10.00)
-    Product.objects.create(name="Hat", description="A stylish hat", price=15.00)
-
-
-class Migration(migrations.Migration):
-    dependencies = [
-        (
-            "payments",
-            "0002_set_stripe_api_keys",
-        ),
-    ]
-
-    operations = [
-        migrations.RunPython(create_initial_products),
-    ]
-endef
-
-define DJANGO_PAYMENTS_MODELS
-from django.db import models
-
-
-class Product(models.Model):
-    name = models.CharField(max_length=100)
-    description = models.TextField()
-    price = models.DecimalField(max_digits=10, decimal_places=2)
-
-    def __str__(self):
-        return self.name
-
-
-class Order(models.Model):
-    product = models.ForeignKey(Product, on_delete=models.CASCADE)
-    created_at = models.DateTimeField(auto_now_add=True)
-    stripe_checkout_session_id = models.CharField(max_length=200)
-
-    def __str__(self):
-        return f"Order {self.id} for {self.product.name}"
-endef
-
-define DJANGO_PAYMENTS_TEMPLATE_CANCEL
-{% extends "base.html" %}
-{% block title %}Cancel{% endblock %}
-{% block content %}
-    <h1>Payment Cancelled</h1>
-    <p>Your payment was cancelled.</p>
-{% endblock %}
-endef
-
-define DJANGO_PAYMENTS_TEMPLATE_CHECKOUT
-{% extends "base.html" %}
-{% block title %}Checkout{% endblock %}
-{% block content %}
-    <h1>Checkout</h1>
-    <form action="{% url 'checkout' %}" method="post">
-        {% csrf_token %}
-        <button type="submit">Pay</button>
-    </form>
-{% endblock %}
-endef
-
-define DJANGO_PAYMENTS_TEMPLATE_PRODUCT_DETAIL
-{% extends "base.html" %}
-{% block title %}{{ product.name }}{% endblock %}
-{% block content %}
-    <h1>{{ product.name }}</h1>
-    <p>{{ product.description }}</p>
-    <p>Price: ${{ product.price }}</p>
-    <form action="{% url 'checkout' %}" method="post">
-        {% csrf_token %}
-        <input type="hidden" name="product_id" value="{{ product.id }}">
-        <button type="submit">Buy Now</button>
-    </form>
-{% endblock %}
-endef
-
-define DJANGO_PAYMENTS_TEMPLATE_PRODUCT_LIST
-{% extends "base.html" %}
-{% block title %}Products{% endblock %}
-{% block content %}
-    <h1>Products</h1>
-    <ul>
-        {% for product in products %}
-            <li>
-                <a href="{% url 'product_detail' product.pk %}">{{ product.name }} - {{ product.price }}</a>
-            </li>
-        {% endfor %}
-    </ul>
-{% endblock %}
-endef
-
-define DJANGO_PAYMENTS_TEMPLATE_SUCCESS
-{% extends "base.html" %}
-{% block title %}Success{% endblock %}
-{% block content %}
-    <h1>Payment Successful</h1>
-    <p>Thank you for your purchase!</p>
-{% endblock %}
-endef
-
-define DJANGO_PAYMENTS_URLS
-from django.urls import path
-from .views import (
-    CheckoutView,
-    SuccessView,
-    CancelView,
-    ProductListView,
-    ProductDetailView,
-)
-
-urlpatterns = [
-    path("", ProductListView.as_view(), name="product_list"),
-    path("product/<int:pk>/", ProductDetailView.as_view(), name="product_detail"),
-    path("checkout/", CheckoutView.as_view(), name="checkout"),
-    path("success/", SuccessView.as_view(), name="success"),
-    path("cancel/", CancelView.as_view(), name="cancel"),
-]
-endef
-
-define DJANGO_PAYMENTS_VIEW
-from django.conf import settings
-from django.shortcuts import render, redirect, get_object_or_404
-from django.views.generic import TemplateView, View, ListView, DetailView
-import stripe
-from .models import Product, Order
-
-stripe.api_key = settings.STRIPE_TEST_SECRET_KEY
-
-
-class ProductListView(ListView):
-    model = Product
-    template_name = "payments/product_list.html"
-    context_object_name = "products"
-
-
-class ProductDetailView(DetailView):
-    model = Product
-    template_name = "payments/product_detail.html"
-    context_object_name = "product"
-
-
-class CheckoutView(View):
-    template_name = "payments/checkout.html"
-
-    def get(self, request, *args, **kwargs):
-        products = Product.objects.all()
-        return render(request, self.template_name, {"products": products})
-
-    def post(self, request, *args, **kwargs):
-        product_id = request.POST.get("product_id")
-        product = get_object_or_404(Product, id=product_id)
-
-        session = stripe.checkout.Session.create(
-            payment_method_types=["card"],
-            line_items=[
-                {
-                    "price_data": {
-                        "currency": "usd",
-                        "product_data": {
-                            "name": product.name,
-                        },
-                        "unit_amount": int(product.price * 100),
-                    },
-                    "quantity": 1,
-                }
-            ],
-            mode="payment",
-            success_url="http://localhost:8000/payments/success/",
-            cancel_url="http://localhost:8000/payments/cancel/",
-        )
-
-        Order.objects.create(product=product, stripe_checkout_session_id=session.id)
-        return redirect(session.url, code=303)
-
-
-class SuccessView(TemplateView):
-
-    template_name = "payments/success.html"
-
-
-class CancelView(TemplateView):
-
-    template_name = "payments/cancel.html"
-endef
-
-define DJANGO_SEARCH_FORMS
-from django import forms
-
-
-class SearchForm(forms.Form):
-    query = forms.CharField(max_length=100, required=True, label="Search")
-
-endef
-
-define DJANGO_SEARCH_SETTINGS
-SEARCH_MODELS = [
-    # Add search models here.
-]
-endef
-
-define DJANGO_SEARCH_TEMPLATE
-{% extends "base.html" %}
-{% block body_class %}template-searchresults{% endblock %}
-{% block title %}Search{% endblock %}
-{% block content %}
-    <h1>Search</h1>
-    <form action="{% url 'search' %}" method="get">
-        <input type="text"
-               name="query"
-               {% if search_query %}value="{{ search_query }}"{% endif %}>
-        <input type="submit" value="Search" class="button">
-    </form>
-    {% if search_results %}
-        <ul>
-            {% for result in search_results %}
-                <li>
-                    <h4>
-                        <a href="{% pageurl result %}">{{ result }}</a>
-                    </h4>
-                    {% if result.search_description %}{{ result.search_description }}{% endif %}
-                </li>
-            {% endfor %}
-        </ul>
-        {% if search_results.has_previous %}
-            <a href="{% url 'search' %}?query={{ search_query|urlencode }}&amp;page={{ search_results.previous_page_number }}">Previous</a>
-        {% endif %}
-        {% if search_results.has_next %}
-            <a href="{% url 'search' %}?query={{ search_query|urlencode }}&amp;page={{ search_results.next_page_number }}">Next</a>
-        {% endif %}
-    {% elif search_query %}
-        No results found
-	{% else %}
-		No results found. Try a <a href="?query=test">test query</a>?
-    {% endif %}
-{% endblock %}
-endef
-
-define DJANGO_SEARCH_URLS
-from django.urls import path
-from .views import SearchView
-
-urlpatterns = [
-    path("search/", SearchView.as_view(), name="search"),
-]
-endef
-
-define DJANGO_SEARCH_UTILS
-from django.apps import apps
-from django.conf import settings
-
-def get_search_models():
-    models = []
-    for model_path in settings.SEARCH_MODELS:
-        app_label, model_name = model_path.split(".")
-        model = apps.get_model(app_label, model_name)
-        models.append(model)
-    return models
-endef
-
-define DJANGO_SEARCH_VIEWS
-from django.views.generic import ListView
-from django.db import models
-from django.db.models import Q 
-from .forms import SearchForm
-from .utils import get_search_models
-
-
-class SearchView(ListView):
-    template_name = "your_app/search_results.html"
-    context_object_name = "results"
-    paginate_by = 10
-
-    def get_queryset(self):
-        form = SearchForm(self.request.GET)
-        query = None
-        results = []
-
-        if form.is_valid():
-            query = form.cleaned_data["query"]
-            search_models = get_search_models()
-
-            for model in search_models:
-                fields = [f.name for f in model._meta.fields if isinstance(f, (models.CharField, models.TextField))]
-                queries = [Q(**{f"{field}__icontains": query}) for field in fields]
-                model_results = model.objects.filter(queries.pop())
-
-                for item in queries:
-                    model_results = model_results.filter(item)
-
-                results.extend(model_results)
-
-        return results
-
-    def get_context_data(self, **kwargs):
-        context = super().get_context_data(**kwargs)
-        context["form"] = SearchForm(self.request.GET)
-        context["query"] = self.request.GET.get("query", "")
-        return context
-endef
-
-define DJANGO_SETTINGS_AUTHENTICATION_BACKENDS
-AUTHENTICATION_BACKENDS = [
-    "django.contrib.auth.backends.ModelBackend",
-    "allauth.account.auth_backends.AuthenticationBackend",
-]
-endef
-
-define DJANGO_SETTINGS_BASE
-# $(PROJECT_NAME)
-#
-# Uncomment next two lines to enable custom admin
-# INSTALLED_APPS = [app for app in INSTALLED_APPS if app != 'django.contrib.admin']
-# INSTALLED_APPS.append('backend.apps.CustomAdminConfig')
-import os  # noqa
-import dj_database_url  # noqa
-
-DEFAULT_AUTO_FIELD = "django.db.models.BigAutoField"
-EXPLORER_CONNECTIONS = {"Default": "default"}
-EXPLORER_DEFAULT_CONNECTION = "default"
-LOGIN_REDIRECT_URL = "/"
-PROJECT_DIR = os.path.dirname(os.path.dirname(os.path.abspath(__file__)))
-SILENCED_SYSTEM_CHECKS = ["django_recaptcha.recaptcha_test_key_error"]
-BASE_DIR = os.path.dirname(PROJECT_DIR)
-STATICFILES_DIRS = []
-WEBPACK_LOADER = {
-    "MANIFEST_FILE": os.path.join(BASE_DIR, "frontend/build/manifest.json"),
-}
-STATICFILES_DIRS.append(os.path.join(BASE_DIR, "frontend/build"))
-TEMPLATES[0]["DIRS"].append(os.path.join(PROJECT_DIR, "templates"))
-endef
-
-define DJANGO_SETTINGS_BASE_MINIMAL
-# $(PROJECT_NAME)
-import os  # noqa
-import dj_database_url  # noqa
-
-INSTALLED_APPS.append("debug_toolbar")
-INSTALLED_APPS.append("webpack_boilerplate")
-PROJECT_DIR = os.path.dirname(os.path.dirname(os.path.abspath(__file__)))
-BASE_DIR = os.path.dirname(PROJECT_DIR)
-STATICFILES_DIRS = []
-STATICFILES_DIRS.append(os.path.join(BASE_DIR, "frontend/build"))
-TEMPLATES[0]["DIRS"].append(os.path.join(PROJECT_DIR, "templates"))
-WEBPACK_LOADER = {
-    "MANIFEST_FILE": os.path.join(BASE_DIR, "frontend/build/manifest.json"),
-}
-endef
-
-define DJANGO_SETTINGS_CRISPY_FORMS
-CRISPY_TEMPLATE_PACK = "bootstrap5"
-CRISPY_ALLOWED_TEMPLATE_PACKS = "bootstrap5"
-endef
-
-define DJANGO_SETTINGS_DATABASE
-DATABASE_URL = os.environ.get("DATABASE_URL", "postgres://:@:/$(PROJECT_NAME)")
-DATABASES["default"] = dj_database_url.parse(DATABASE_URL)
-endef
-
-define DJANGO_SETTINGS_DEV
-from .base import *  # noqa
-
-# SECURITY WARNING: don't run with debug turned on in production!
-DEBUG = True
-
-# SECURITY WARNING: define the correct hosts in production!
-ALLOWED_HOSTS = ["*"]
-
-EMAIL_BACKEND = "django.core.mail.backends.console.EmailBackend"
-
-try:
-    from .local import *  # noqa
-except ImportError:
-    pass
-
-LOGGING = {
-    "version": 1,
-    "disable_existing_loggers": False,
-    "formatters": {
-        "verbose": {
-            "format": "{levelname} {asctime} {module} {message}",
-            "style": "{",
-        },
-        "simple": {
-            "format": "{levelname} {message}",
-            "style": "{",
-        },
-    },
-    "handlers": {
-        "console": {
-            "level": "DEBUG",
-            "class": "logging.StreamHandler",
-            "formatter": "verbose",
-        },
-    },
-    "loggers": {
-        "django": {
-            "handlers": ["console"],
-            "level": "DEBUG",
-            "propagate": True,
-        },
-    },
-}
-
-INTERNAL_IPS = [
-    "127.0.0.1",
-]
-
-MIDDLEWARE.append("debug_toolbar.middleware.DebugToolbarMiddleware")  # noqa
-MIDDLEWARE.append("hijack.middleware.HijackUserMiddleware")  # noqa
-INSTALLED_APPS.append("django.contrib.admindocs")  # noqa
-SECRET_KEY = "$(DJANGO_SETTINGS_SECRET_KEY)"
-endef
-
-
-define DJANGO_SETTINGS_HOME_PAGE
-INSTALLED_APPS.append("home")
-endef
-
-define DJANGO_SETTINGS_INSTALLED_APPS
-INSTALLED_APPS.append("allauth")
-INSTALLED_APPS.append("allauth.account")
-INSTALLED_APPS.append("allauth.socialaccount")
-INSTALLED_APPS.append("crispy_bootstrap5")
-INSTALLED_APPS.append("crispy_forms")
-INSTALLED_APPS.append("debug_toolbar")
-INSTALLED_APPS.append("django_extensions")
-INSTALLED_APPS.append("django_recaptcha")
-INSTALLED_APPS.append("rest_framework")
-INSTALLED_APPS.append("rest_framework.authtoken")
-INSTALLED_APPS.append("webpack_boilerplate")
-INSTALLED_APPS.append("explorer")
-endef
-
-define DJANGO_SETTINGS_MIDDLEWARE
-MIDDLEWARE.append("allauth.account.middleware.AccountMiddleware")
-endef
-
-define DJANGO_SETTINGS_MODEL_FORM_DEMO
-INSTALLED_APPS.append("model_form_demo")  # noqa
-endef
-
-define DJANGO_SETTINGS_PAYMENTS
-DJSTRIPE_FOREIGN_KEY_TO_FIELD = "id"
-DJSTRIPE_WEBHOOK_VALIDATION = "retrieve_event"
-STRIPE_PUBLISHABLE_KEY = os.environ.get("STRIPE_PUBLISHABLE_KEY")
-STRIPE_SECRET_KEY = os.environ.get("STRIPE_SECRET_KEY")
-STRIPE_TEST_SECRET_KEY = os.environ.get("STRIPE_TEST_SECRET_KEY")
-INSTALLED_APPS.append("payments")  # noqa
-INSTALLED_APPS.append("djstripe")  # noqa
-endef
-
-define DJANGO_SETTINGS_REST_FRAMEWORK
-REST_FRAMEWORK = {
-    # Use Django's standard `django.contrib.auth` permissions,
-    # or allow read-only access for unauthenticated users.
-    "DEFAULT_PERMISSION_CLASSES": [
-        "rest_framework.permissions.DjangoModelPermissionsOrAnonReadOnly"
-    ]
-}
-endef
-
-define DJANGO_SETTINGS_SITEUSER
-INSTALLED_APPS.append("siteuser")  # noqa
-AUTH_USER_MODEL = "siteuser.User"
-endef
-
-define DJANGO_SETTINGS_PROD
-from .base import *  # noqa
-from backend.utils import get_ec2_metadata
-
-DEBUG = False
-
-try:
-    from .local import *  # noqa
-except ImportError:
-    pass
-
-LOCAL_IPV4 = get_ec2_metadata()
-ALLOWED_HOSTS.append(LOCAL_IPV4)  # noqa
-endef
-
-define DJANGO_SETTINGS_THEMES
-THEMES = [
-    ("light", "Light Theme"),
-    ("dark", "Dark Theme"),
-]
-endef
-
-define DJANGO_SITEUSER_ADMIN
-from django.contrib.auth.admin import UserAdmin
-from django.contrib import admin
-
-from .models import User
-
-admin.site.register(User, UserAdmin)
-endef
-
-define DJANGO_SITEUSER_EDIT_TEMPLATE
-{% extends 'base.html' %}
-{% load crispy_forms_tags %}
-{% block content %}
-    <h2>Edit User</h2>
-    {% crispy form %}
-{% endblock %}
-endef
-
-define DJANGO_SITEUSER_FORM
-from django import forms
-from django.contrib.auth.forms import UserChangeForm
-from crispy_forms.helper import FormHelper
-from crispy_forms.layout import Layout, Fieldset, ButtonHolder, Submit
-from .models import User
-
-
-class SiteUserForm(UserChangeForm):
-    bio = forms.CharField(widget=forms.Textarea(attrs={"id": "editor"}), required=False)
-
-    class Meta(UserChangeForm.Meta):
-        model = User
-        fields = ("username", "user_theme_preference", "bio", "rate")
-
-    def __init__(self, *args, **kwargs):
-        super().__init__(*args, **kwargs)
-        self.helper = FormHelper()
-        self.helper.form_method = "post"
-        self.helper.layout = Layout(
-            Fieldset(
-                "Edit Your Profile",
-                "username",
-                "user_theme_preference",
-                "bio",
-                "rate",
-            ),
-            ButtonHolder(Submit("submit", "Save", css_class="btn btn-primary")),
-        )
-endef
-
-define DJANGO_SITEUSER_MODEL
-from django.db import models
-from django.contrib.auth.models import AbstractUser, Group, Permission
-from django.conf import settings
-
-
-class User(AbstractUser):
-    groups = models.ManyToManyField(Group, related_name="siteuser_set", blank=True)
-    user_permissions = models.ManyToManyField(
-        Permission, related_name="siteuser_set", blank=True
-    )
-
-    user_theme_preference = models.CharField(
-        max_length=10, choices=settings.THEMES, default="light"
-    )
-
-    bio = models.TextField(blank=True, null=True)
-    rate = models.FloatField(blank=True, null=True)
-endef
-
-define DJANGO_SITEUSER_URLS
-from django.urls import path
-from .views import UserProfileView, UpdateThemePreferenceView, UserEditView
-
-urlpatterns = [
-    path("profile/", UserProfileView.as_view(), name="user-profile"),
-    path(
-        "update_theme_preference/",
-        UpdateThemePreferenceView.as_view(),
-        name="update_theme_preference",
-    ),
-    path("<int:pk>/edit/", UserEditView.as_view(), name="user-edit"),
-]
-endef
-
-define DJANGO_SITEUSER_VIEW
-import json
-
-from django.contrib.auth.mixins import LoginRequiredMixin
-from django.http import JsonResponse
-from django.utils.decorators import method_decorator
-from django.views import View
-from django.views.decorators.csrf import csrf_exempt
-from django.views.generic import DetailView
-from django.views.generic.edit import UpdateView
-from django.urls import reverse_lazy
-
-from .models import User
-from .forms import SiteUserForm
-
-
-class UserProfileView(LoginRequiredMixin, DetailView):
-    model = User
-    template_name = "profile.html"
-
-    def get_object(self, queryset=None):
-        return self.request.user
-
-
-@method_decorator(csrf_exempt, name="dispatch")
-class UpdateThemePreferenceView(View):
-    def post(self, request, *args, **kwargs):
-        try:
-            data = json.loads(request.body.decode("utf-8"))
-            new_theme = data.get("theme")
-            user = request.user
-            user.user_theme_preference = new_theme
-            user.save()
-            response_data = {"theme": new_theme}
-            return JsonResponse(response_data)
-        except json.JSONDecodeError as e:
-            return JsonResponse({"error": e}, status=400)
-
-    def http_method_not_allowed(self, request, *args, **kwargs):
-        return JsonResponse({"error": "Invalid request method"}, status=405)
-
-
-class UserEditView(LoginRequiredMixin, UpdateView):
-    model = User
-    template_name = "user_edit.html"  # Create this template in your templates folder
-    form_class = SiteUserForm
-
-    def get_success_url(self):
-        # return reverse_lazy("user-profile", kwargs={"pk": self.object.pk})
-        return reverse_lazy("user-profile")
-endef
-
-define DJANGO_SITEUSER_VIEW_TEMPLATE
-{% extends 'base.html' %}
-{% block content %}
-    <h2>User Profile</h2>
-    <div class="d-flex justify-content-end">
-        <a class="btn btn-outline-secondary"
-           href="{% url 'user-edit' pk=user.id %}">Edit</a>
-    </div>
-    <p>Username: {{ user.username }}</p>
-    <p>Theme: {{ user.user_theme_preference }}</p>
-    <p>Bio: {{ user.bio|default:""|safe }}</p>
-    <p>Rate: {{ user.rate|default:"" }}</p>
-{% endblock %}
-endef
-
-define DJANGO_URLS
-from django.contrib import admin
-from django.urls import path, include
-from django.conf import settings
-
-urlpatterns = [
-    path("django/", admin.site.urls),
-]
-endef
-
-define DJANGO_URLS_ALLAUTH
-urlpatterns += [path("accounts/", include("allauth.urls"))]
-endef
-
-define DJANGO_URLS_API
-from rest_framework import routers  # noqa
-from .api import UserViewSet, api  # noqa
-
-router = routers.DefaultRouter()
-router.register(r"users", UserViewSet)
-# urlpatterns += [path("api/", include(router.urls))]
-urlpatterns += [path("api/", api.urls)]
-endef
-
-define DJANGO_URLS_DEBUG_TOOLBAR
-if settings.DEBUG:
-    urlpatterns += [path("__debug__/", include("debug_toolbar.urls"))]
-endef
-
-define DJANGO_URLS_HOME_PAGE
-urlpatterns += [path("", include("home.urls"))]
-endef
-
-define DJANGO_URLS_LOGGING_DEMO
-urlpatterns += [path("logging-demo/", include("logging_demo.urls"))]
-endef
-
-define DJANGO_URLS_MODEL_FORM_DEMO
-urlpatterns += [path("model-form-demo/", include("model_form_demo.urls"))]
-endef
-
-define DJANGO_URLS_PAYMENTS
-urlpatterns += [path("payments/", include("payments.urls"))]
-endef
-
-define DJANGO_URLS_SITEUSER
-urlpatterns += [path("user/", include("siteuser.urls"))]
-endef
-
-define DJANGO_UTILS
-from django.urls import URLResolver
-import requests
-
-
-def get_ec2_metadata():
-    try:
-        # Step 1: Get the token
-        token_url = "http://169.254.169.254/latest/api/token"
-        headers = {"X-aws-ec2-metadata-token-ttl-seconds": "21600"}
-        response = requests.put(token_url, headers=headers)
-        response.raise_for_status()  # Raise an error for bad responses
-
-        token = response.text
-
-        # Step 2: Use the token to get the instance metadata
-        metadata_url = "http://169.254.169.254/latest/meta-data/local-ipv4"
-        headers = {"X-aws-ec2-metadata-token": token}
-        response = requests.get(metadata_url, headers=headers)
-        response.raise_for_status()  # Raise an error for bad responses
-
-        metadata = response.text
-        return metadata
-    except requests.RequestException as e:
-        print(f"Error retrieving EC2 metadata: {e}")
-        return None
-
-
-# Function to remove a specific URL pattern based on its route (including catch-all)
-def remove_urlpattern(urlpatterns, route_to_remove):
-    urlpatterns[:] = [
-        urlpattern
-        for urlpattern in urlpatterns
-        if not (
-            isinstance(urlpattern, URLResolver)
-            and urlpattern.pattern._route == route_to_remove
-        )
-    ]
-endef
-
-define EB_CUSTOM_ENV_EC2_USER
-files:
-    "/home/ec2-user/.bashrc":
-        mode: "000644"
-        owner: ec2-user
-        group: ec2-user
-        content: |
-            # .bashrc
-
-            # Source global definitions
-            if [ -f /etc/bashrc ]; then
-                    . /etc/bashrc
-            fi
-
-            # User specific aliases and functions
-            set -o vi
-
-            source <(sed -E -n 's/[^#]+/export &/ p' /opt/elasticbeanstalk/deployment/custom_env_var)
-endef
-
-define EB_CUSTOM_ENV_VAR_FILE
-#!/bin/bash
-
-# Via https://aws.amazon.com/premiumsupport/knowledge-center/elastic-beanstalk-env-variables-linux2/
-
-#Create a copy of the environment variable file.
-cat /opt/elasticbeanstalk/deployment/env | perl -p -e 's/(.*)=(.*)/export $$1="$$2"/;' > /opt/elasticbeanstalk/deployment/custom_env_var
-
-#Set permissions to the custom_env_var file so this file can be accessed by any user on the instance. You can restrict permissions as per your requirements.
-chmod 644 /opt/elasticbeanstalk/deployment/custom_env_var
-
-# add the virtual env path in.
-VENV=/var/app/venv/`ls /var/app/venv`
-cat <<EOF >> /opt/elasticbeanstalk/deployment/custom_env_var
-VENV=$$ENV
-EOF
-
-#Remove duplicate files upon deployment.
-rm -f /opt/elasticbeanstalk/deployment/*.bak
-endef
-
-define GIT_IGNORE
-__pycache__
-*.pyc
-dist/
-node_modules/
-_build/
-.elasticbeanstalk/
-db.sqlite3
-static/
-backend/var
-endef
-
-define JENKINS_FILE
-pipeline {
-    agent any
-    stages {
-        stage('') {
-            steps {
-                echo ''
-            }
-        }
-    }
-}
-endef
-
-define MAKEFILE_CUSTOM
-# Custom Makefile
-# Add your custom makefile commands here
-#
-# PROJECT_NAME := my-new-project
-endef
-
-define PIP_INSTALL_REQUIREMENTS_TEST
-pytest
-pytest-runner
-coverage
-pytest-mock
-pytest-cov
-hypothesis
-selenium
-pytest-django
-factory-boy
-flake8
-tox
-endef
-
-define PROGRAMMING_INTERVIEW
-from rich import print as rprint
-from rich.console import Console
-from rich.panel import Panel
-
-import argparse
-import locale
-import math
-import time
-
-import code  # noqa
-import readline  # noqa
-import rlcompleter  # noqa
-
-
-locale.setlocale(locale.LC_ALL, "en_US.UTF-8")
-
-
-class DataStructure:
-    # Data Structure: Binary Tree
-    class TreeNode:
-        def __init__(self, value=0, left=None, right=None):
-            self.value = value
-            self.left = left
-            self.right = right
-
-    # Data Structure: Stack
-    class Stack:
-        def __init__(self):
-            self.items = []
-
-        def push(self, item):
-            self.items.append(item)
-
-        def pop(self):
-            if not self.is_empty():
-                return self.items.pop()
-            return None
-
-        def peek(self):
-            if not self.is_empty():
-                return self.items[-1]
-            return None
-
-        def is_empty(self):
-            return len(self.items) == 0
-
-        def size(self):
-            return len(self.items)
-
-    # Data Structure: Queue
-    class Queue:
-        def __init__(self):
-            self.items = []
-
-        def enqueue(self, item):
-            self.items.append(item)
-
-        def dequeue(self):
-            if not self.is_empty():
-                return self.items.pop(0)
-            return None
-
-        def is_empty(self):
-            return len(self.items) == 0
-
-        def size(self):
-            return len(self.items)
-
-    # Data Structure: Linked List
-    class ListNode:
-        def __init__(self, value=0, next=None):
-            self.value = value
-            self.next = next
-
-
-class Interview(DataStructure):
-
-    # Protected methods for factorial calculation
-    def _factorial_recursive(self, n):
-        if n == 0:
-            return 1
-        return n * self._factorial_recursive(n - 1)
-
-    def _factorial_divide_and_conquer(self, low, high):
-        if low > high:
-            return 1
-        if low == high:
-            return low
-        mid = (low + high) // 2
-        return self._factorial_divide_and_conquer(
-            low, mid
-        ) * self._factorial_divide_and_conquer(mid + 1, high)
-
-    # Recursive Factorial with Timing
-    def factorial_recursive(self, n):
-        start_time = time.time()  # Start timing
-        result = self._factorial_recursive(n)  # Calculate factorial
-        end_time = time.time()  # End timing
-        elapsed_time = end_time - start_time
-        return f"  Factorial: {locale.format_string("%.2f", result, grouping=True)}  Elapsed time: {elapsed_time:.6f}"
-
-    # Iterative Factorial with Timing
-    def factorial_iterative(self, n):
-        start_time = time.time()  # Start timing
-        result = 1
-        for i in range(1, n + 1):
-            result *= i
-        end_time = time.time()  # End timing
-        elapsed_time = end_time - start_time
-        return f"  Factorial: {locale.format_string("%.2f", result, grouping=True)}  Elapsed time: {elapsed_time:.6f}"
-
-    # Divide and Conquer Factorial with Timing
-    def factorial_divide_and_conquer(self, n):
-        start_time = time.time()  # Start timing
-        result = self._factorial_divide_and_conquer(1, n)  # Calculate factorial
-        end_time = time.time()  # End timing
-        elapsed_time = end_time - start_time
-        return f"  Factorial: {locale.format_string("%.2f", result, grouping=True)}  Elapsed time: {elapsed_time:.6f}"
-
-    # Built-in Factorial with Timing
-    def factorial_builtin(self, n):
-        start_time = time.time()  # Start timing
-        result = math.factorial(n)  # Calculate factorial using built-in
-        end_time = time.time()  # End timing
-
-        # Calculate elapsed time
-        elapsed_time = end_time - start_time
-
-        # Print complexity and runtime
-        return f"  Factorial: {locale.format_string("%.2f", result, grouping=True)}  Elapsed time: {elapsed_time:.6f}"
-
-    # Recursion: Fibonacci
-    def fibonacci_recursive(self, n):
-        if n <= 1:
-            return n
-        return self.fibonacci_recursive(n - 1) + self.fibonacci_recursive(n - 2)
-
-    # Iteration: Fibonacci
-    def fibonacci_iterative(self, n):
-        if n <= 1:
-            return n
-        a, b = 0, 1
-        for _ in range(n - 1):
-            a, b = b, a + b
-        return b
-
-    # Searching: Linear Search
-    def linear_search(self, arr, target):
-        for i, value in enumerate(arr):
-            if value == target:
-                return i
-        return -1
-
-    # Searching: Binary Search
-    def binary_search(self, arr, target):
-        left, right = 0, len(arr) - 1
-        while left <= right:
-            mid = (left + right) // 2
-            if arr[mid] == target:
-                return mid
-            elif arr[mid] < target:
-                left = mid + 1
-            else:
-                right = mid - 1
-        return -1
-
-    # Sorting: Bubble Sort
-    def bubble_sort(self, arr):
-        n = len(arr)
-        for i in range(n):
-            for j in range(0, n - i - 1):
-                if arr[j] > arr[j + 1]:
-                    arr[j], arr[j + 1] = arr[j + 1], arr[j]
-        return arr
-
-    # Sorting: Merge Sort
-    def merge_sort(self, arr):
-        if len(arr) > 1:
-            mid = len(arr) // 2
-            left_half = arr[:mid]
-            right_half = arr[mid:]
-
-            self.merge_sort(left_half)
-            self.merge_sort(right_half)
-
-            i = j = k = 0
-
-            while i < len(left_half) and j < len(right_half):
-                if left_half[i] < right_half[j]:
-                    arr[k] = left_half[i]
-                    i += 1
-                else:
-                    arr[k] = right_half[j]
-                    j += 1
-                k += 1
-
-            while i < len(left_half):
-                arr[k] = left_half[i]
-                i += 1
-                k += 1
-
-            while j < len(right_half):
-                arr[k] = right_half[j]
-                j += 1
-                k += 1
-        return arr
-
-    def insert_linked_list(self, head, value):
-        new_node = self.ListNode(value)
-        if not head:
-            return new_node
-        current = head
-        while current.next:
-            current = current.next
-        current.next = new_node
-        return head
-
-    def print_linked_list(self, head):
-        current = head
-        while current:
-            print(current.value, end=" -> ")
-            current = current.next
-        print("None")
-
-    def inorder_traversal(self, root):
-        return (
-            self.inorder_traversal(root.left)
-            + [root.value]
-            + self.inorder_traversal(root.right)
-            if root
-            else []
-        )
-
-    def preorder_traversal(self, root):
-        return (
-            [root.value]
-            + self.preorder_traversal(root.left)
-            + self.preorder_traversal(root.right)
-            if root
-            else []
-        )
-
-    def postorder_traversal(self, root):
-        return (
-            self.postorder_traversal(root.left)
-            + self.postorder_traversal(root.right)
-            + [root.value]
-            if root
-            else []
-        )
-
-    # Graph Algorithms: Depth-First Search
-    def dfs(self, graph, start):
-        visited, stack = set(), [start]
-        while stack:
-            vertex = stack.pop()
-            if vertex not in visited:
-                visited.add(vertex)
-                stack.extend(set(graph[vertex]) - visited)
-        return visited
-
-    # Graph Algorithms: Breadth-First Search
-    def bfs(self, graph, start):
-        visited, queue = set(), [start]
-        while queue:
-            vertex = queue.pop(0)
-            if vertex not in visited:
-                visited.add(vertex)
-                queue.extend(set(graph[vertex]) - visited)
-        return visited
-
-
-def setup_readline(local):
-
-    # Enable tab completion
-    readline.parse_and_bind("tab: complete")
-    # Optionally, you can set the completer function manually
-    readline.set_completer(rlcompleter.Completer(local).complete)
-
-
-def main():
-
-    console = Console()
-    interview = Interview()
-
-    parser = argparse.ArgumentParser(description="Programming Interview Questions")
-
-    parser.add_argument(
-        "-f", "--factorial", type=int, help="Factorial algorithm examples"
-    )
-    parser.add_argument("--fibonacci", type=int, help="Fibonacci algorithm examples")
-    parser.add_argument(
-        "--search", action="store_true", help="Search algorithm examples"
-    )
-    parser.add_argument("--sort", action="store_true", help="Search algorithm examples")
-    parser.add_argument("--stack", action="store_true", help="Stack algorithm examples")
-    parser.add_argument("--queue", action="store_true", help="Queue algorithm examples")
-    parser.add_argument(
-        "--list", action="store_true", help="Linked List algorithm examples"
-    )
-    parser.add_argument(
-        "--tree", action="store_true", help="Tree traversal algorithm examples"
-    )
-    parser.add_argument("--graph", action="store_true", help="Graph algorithm examples")
-    parser.add_argument(
-        "-i", "--interactive", action="store_true", help="Interactive mode"
-    )
-
-    args = parser.parse_args()
-
-    if args.factorial:
-        # Factorial examples
-        console.rule("Factorial Examples")
-        rprint(
-            Panel(
-                "[bold cyan]Recursive Factorial - Time Complexity: O(n)[/bold cyan]\n"
-                + str(interview.factorial_recursive(args.factorial)),
-                title="Factorial Recursive",
-            )
-        )
-        rprint(
-            Panel(
-                "[bold cyan]Iterative Factorial - Time Complexity: O(n)[/bold cyan]\n"
-                + str(interview.factorial_iterative(args.factorial)),
-                title="Factorial Iterative",
-            )
-        )
-        rprint(
-            Panel(
-                "[bold cyan]Built-in Factorial - Time Complexity: O(n)[/bold cyan]\n"
-                + str(interview.factorial_builtin(args.factorial)),
-                title="Factorial Built-in",
-            )
-        )
-        rprint(
-            Panel(
-                "[bold cyan]Divide and Conquer Factorial - Time Complexity: O(n log n)[/bold cyan]\n"
-                + str(interview.factorial_divide_and_conquer(args.factorial)),
-                title="Factorial Divide and Conquer",
-            )
-        )
-        exit()
-
-    if args.fibonacci:
-        # Fibonacci examples
-        console.rule("Fibonacci Examples")
-        rprint(
-            Panel(
-                str(interview.fibonacci_recursive(args.fibonacci)),
-                title="Fibonacci Recursive",
-            )
-        )
-        rprint(
-            Panel(
-                str(interview.fibonacci_iterative(args.fibonacci)),
-                title="Fibonacci Iterative",
-            )
-        )
-        exit()
-
-    if args.search:
-        # Searching examples
-        console.rule("Searching Examples")
-        array = [1, 3, 5, 7, 9]
-        rprint(Panel(str(interview.linear_search(array, 5)), title="Linear Search"))
-        rprint(Panel(str(interview.binary_search(array, 5)), title="Binary Search"))
-        exit()
-
-    if args.sort:
-        # Sorting examples
-        console.rule("Sorting Examples")
-        unsorted_array = [64, 34, 25, 12, 22, 11, 90]
-        rprint(
-            Panel(
-                str(interview.bubble_sort(unsorted_array.copy())), title="Bubble Sort"
-            )
-        )
-        rprint(
-            Panel(str(interview.merge_sort(unsorted_array.copy())), title="Merge Sort")
-        )
-        exit()
-
-    if args.stack:
-        # Stack example
-        console.rule("Stack Example")
-        stack = interview.Stack()
-        stack.push(1)
-        stack.push(2)
-        stack.push(3)
-        rprint(Panel(str(stack.pop()), title="Stack Pop"))
-        rprint(Panel(str(stack.peek()), title="Stack Peek"))
-        rprint(Panel(str(stack.size()), title="Stack Size"))
-
-    if args.queue:
-        # Queue example
-        console.rule("Queue Example")
-        queue = interview.Queue()
-        queue.enqueue(1)
-        queue.enqueue(2)
-        queue.enqueue(3)
-        rprint(Panel(str(queue.dequeue()), title="Queue Dequeue"))
-        rprint(Panel(str(queue.is_empty()), title="Queue Is Empty"))
-        rprint(Panel(str(queue.size()), title="Queue Size"))
-
-    if args.list:
-        # Linked List example
-        console.rule("Linked List Example")
-        head = None
-        head = interview.insert_linked_list(head, 1)
-        head = interview.insert_linked_list(head, 2)
-        head = interview.insert_linked_list(head, 3)
-        interview.print_linked_list(head)  # Output: 1 -> 2 -> 3 -> None
-
-    if args.tree:
-        # Tree Traversal example
-        console.rule("Tree Traversal Example")
-        root = interview.TreeNode(1)
-        root.left = interview.TreeNode(2)
-        root.right = interview.TreeNode(3)
-        root.left.left = interview.TreeNode(4)
-        root.left.right = interview.TreeNode(5)
-        rprint(Panel(str(interview.inorder_traversal(root)), title="Inorder Traversal"))
-        rprint(
-            Panel(str(interview.preorder_traversal(root)), title="Preorder Traversal")
-        )
-        rprint(
-            Panel(str(interview.postorder_traversal(root)), title="Postorder Traversal")
-        )
-
-    if args.graph:
-        # Graph Algorithms example
-        console.rule("Graph Algorithms Example")
-        graph = {
-            "A": ["B", "C"],
-            "B": ["A", "D", "E"],
-            "C": ["A", "F"],
-            "D": ["B"],
-            "E": ["B", "F"],
-            "F": ["C", "E"],
-        }
-        rprint(Panel(str(interview.dfs(graph, "A")), title="DFS"))
-        rprint(Panel(str(interview.bfs(graph, "A")), title="BFS"))
-
-    if args.interactive:
-        # Starting interactive session with tab completion
-        setup_readline(locals())
-        banner = "Interactive programming interview session started. Type 'exit()' or 'Ctrl-D' to exit."
-        code.interact(
-            banner=banner,
-            local=locals(),
-            exitmsg="Great interview!",
-        )
-
-
-if __name__ == "__main__":
-    main()
-
-endef
-
-define PYTHON_CI_YAML
-name: Build Wheels
-endef
-
-define PYTHON_LICENSE_TXT
-MIT License
-
-Copyright (c) [YEAR] [OWNER NAME]
-
-Permission is hereby granted, free of charge, to any person obtaining a copy
-of this software and associated documentation files (the "Software"), to deal
-in the Software without restriction, including without limitation the rights
-to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
-copies of the Software, and to permit persons to whom the Software is
-furnished to do so, subject to the following conditions:
-
-The above copyright notice and this permission notice shall be included in all
-copies or substantial portions of the Software.
-
-THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
-IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
-FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
-AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
-LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
-OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
-SOFTWARE.
-endef
-
-define PYTHON_PROJECT_TOML
-[build-system]
-endef
-
-define SEPARATOR
-.==========================================================================================================================================.
-|                                                                                                                                          |  
-| _|_|_|                        _|                        _|          _|      _|            _|                      _|_|  _|  _|           | 
-| _|    _|  _|  _|_|    _|_|          _|_|      _|_|_|  _|_|_|_|      _|_|  _|_|    _|_|_|  _|  _|      _|_|      _|          _|    _|_|   |
-| _|_|_|    _|_|      _|    _|  _|  _|_|_|_|  _|          _|          _|  _|  _|  _|    _|  _|_|      _|_|_|_|  _|_|_|_|  _|  _|  _|_|_|_| |
-| _|        _|        _|    _|  _|  _|        _|          _|          _|      _|  _|    _|  _|  _|    _|          _|      _|  _|  _|       |
-| _|        _|          _|_|    _|    _|_|_|    _|_|_|      _|_|      _|      _|    _|_|_|  _|    _|    _|_|_|    _|      _|  _|    _|_|_| |
-|                               _|                                                                                                         |
-|                             _|                                                                                                           |
-`=========================================================================================================================================='
-endef
-
-define TINYMCE_JS
-import tinymce from 'tinymce';
-import 'tinymce/icons/default';
-import 'tinymce/themes/silver';
-import 'tinymce/skins/ui/oxide/skin.css';
-import 'tinymce/plugins/advlist';
-import 'tinymce/plugins/code';
-import 'tinymce/plugins/emoticons';
-import 'tinymce/plugins/emoticons/js/emojis';
-import 'tinymce/plugins/link';
-import 'tinymce/plugins/lists';
-import 'tinymce/plugins/table';
-import 'tinymce/models/dom';
-
-tinymce.init({
-  selector: 'textarea#editor',
-  plugins: 'advlist code emoticons link lists table',
-  toolbar: 'bold italic | bullist numlist | link emoticons',
-  skin: false,
-  content_css: false,
-});
-endef
-
-define WAGTAIL_BASE_TEMPLATE
-{% load static wagtailcore_tags wagtailuserbar webpack_loader %}
-<!DOCTYPE html>
-<html lang="en"
-      class="h-100"
-      data-bs-theme="{{ request.user.user_theme_preference|default:'light' }}">
-    <head>
-        <meta charset="utf-8" />
-        <title>
-            {% block title %}
-                {% if page.seo_title %}
-                    {{ page.seo_title }}
-                {% else %}
-                    {{ page.title }}
-                {% endif %}
-            {% endblock %}
-            {% block title_suffix %}
-                {% wagtail_site as current_site %}
-                {% if current_site and current_site.site_name %}- {{ current_site.site_name }}{% endif %}
-            {% endblock %}
-        </title>
-        {% if page.search_description %}<meta name="description" content="{{ page.search_description }}" />{% endif %}
-        <meta name="viewport" content="width=device-width, initial-scale=1" />
-        {# Force all links in the live preview panel to be opened in a new tab #}
-        {% if request.in_preview_panel %}<base target="_blank">{% endif %}
-        {% stylesheet_pack 'app' %}
-        {% block extra_css %}{# Override this in templates to add extra stylesheets #}{% endblock %}
-        <style>
-            .success {
-                background-color: #d4edda;
-                border-color: #c3e6cb;
-                color: #155724;
-            }
-
-            .info {
-                background-color: #d1ecf1;
-                border-color: #bee5eb;
-                color: #0c5460;
-            }
-
-            .warning {
-                background-color: #fff3cd;
-                border-color: #ffeeba;
-                color: #856404;
-            }
-
-            .danger {
-                background-color: #f8d7da;
-                border-color: #f5c6cb;
-                color: #721c24;
-            }
-        </style>
-        {% include 'favicon.html' %}
-        {% csrf_token %}
-    </head>
-    <body class="{% block body_class %}{% endblock %} d-flex flex-column h-100">
-        <main class="flex-shrink-0">
-            {% wagtailuserbar %}
-            <div id="app"></div>
-            {% include 'header.html' %}
-            {% if messages %}
-                <div class="messages container">
-                    {% for message in messages %}
-                        <div class="alert {{ message.tags }} alert-dismissible fade show"
-                             role="alert">
-                            {{ message }}
-                            <button type="button"
-                                    class="btn-close"
-                                    data-bs-dismiss="alert"
-                                    aria-label="Close"></button>
-                        </div>
-                    {% endfor %}
-                </div>
-            {% endif %}
-            <div class="container">
-                {% block content %}{% endblock %}
-            </div>
-        </main>
-        {% include 'footer.html' %}
-        {% include 'offcanvas.html' %}
-        {% javascript_pack 'app' %}
-        {% block extra_js %}{# Override this in templates to add extra javascript #}{% endblock %}
-    </body>
-</html>
-endef
-
-define WAGTAIL_BLOCK_CAROUSEL
-<div id="carouselExampleCaptions" class="carousel slide">
-    <div class="carousel-indicators">
-        {% for image in block.value.images %}
-            <button type="button"
-                    data-bs-target="#carouselExampleCaptions"
-                    data-bs-slide-to="{{ forloop.counter0 }}"
-                    {% if forloop.first %}class="active" aria-current="true"{% endif %}
-                    aria-label="Slide {{ forloop.counter }}"></button>
-        {% endfor %}
-    </div>
-    <div class="carousel-inner">
-        {% for image in block.value.images %}
-            <div class="carousel-item {% if forloop.first %}active{% endif %}">
-                <img src="{{ image.file.url }}" class="d-block w-100" alt="...">
-                <div class="carousel-caption d-none d-md-block">
-                    <h5>{{ image.title }}</h5>
-                </div>
-            </div>
-        {% endfor %}
-    </div>
-    <button class="carousel-control-prev"
-            type="button"
-            data-bs-target="#carouselExampleCaptions"
-            data-bs-slide="prev">
-        <span class="carousel-control-prev-icon" aria-hidden="true"></span>
-        <span class="visually-hidden">Previous</span>
-    </button>
-    <button class="carousel-control-next"
-            type="button"
-            data-bs-target="#carouselExampleCaptions"
-            data-bs-slide="next">
-        <span class="carousel-control-next-icon" aria-hidden="true"></span>
-        <span class="visually-hidden">Next</span>
-    </button>
-</div>
-endef
-
-define WAGTAIL_BLOCK_MARKETING
-{% load wagtailcore_tags %}
-<div class="{{ self.block_class }}">
-    {% if block.value.images.0 %}
-        {% include 'blocks/carousel_block.html' %}
-    {% else %}
-        {{ self.title }}
-        {{ self.content }}
-    {% endif %}
-</div>
-endef
-
-define WAGTAIL_CONTACT_PAGE_LANDING
-{% extends 'base.html' %}
-{% block content %}<div class="container"><h1>Thank you!</h1></div>{% endblock %}
-endef
-
-define WAGTAIL_CONTACT_PAGE_MODEL
-from django.db import models
-from modelcluster.fields import ParentalKey
-from wagtail.admin.panels import (
-    FieldPanel, FieldRowPanel,
-    InlinePanel, MultiFieldPanel
-)
-from wagtail.fields import RichTextField
-from wagtail.contrib.forms.models import AbstractEmailForm, AbstractFormField
-
-
-class FormField(AbstractFormField):
-    page = ParentalKey('ContactPage', on_delete=models.CASCADE, related_name='form_fields')
-
-
-class ContactPage(AbstractEmailForm):
-    intro = RichTextField(blank=True)
-    thank_you_text = RichTextField(blank=True)
-
-    content_panels = AbstractEmailForm.content_panels + [
-        FieldPanel('intro'),
-        InlinePanel('form_fields', label="Form fields"),
-        FieldPanel('thank_you_text'),
-        MultiFieldPanel([
-            FieldRowPanel([
-                FieldPanel('from_address', classname="col6"),
-                FieldPanel('to_address', classname="col6"),
-            ]),
-            FieldPanel('subject'),
-        ], "Email"),
-    ]
-
-    class Meta:
-        verbose_name = "Contact Page"
-endef
-
-define WAGTAIL_CONTACT_PAGE_TEMPLATE
-{% extends 'base.html' %}
-{% load crispy_forms_tags static wagtailcore_tags %}
-{% block content %}
-        <h1>{{ page.title }}</h1>
-        {{ page.intro|richtext }}
-        <form action="{% pageurl page %}" method="POST">
-            {% csrf_token %}
-            {{ form.as_p }}
-            <input type="submit">
-        </form>
-{% endblock %}
-endef
-
-define WAGTAIL_CONTACT_PAGE_TEST
-from django.test import TestCase
-from wagtail.test.utils import WagtailPageTestCase
-from wagtail.models import Page
-
-from contactpage.models import ContactPage, FormField
-
-class ContactPageTest(TestCase, WagtailPageTestCase):
-    def test_contact_page_creation(self):
-        # Create a ContactPage instance
-        contact_page = ContactPage(
-            title='Contact',
-            intro='Welcome to our contact page!',
-            thank_you_text='Thank you for reaching out.'
-        )
-
-        # Save the ContactPage instance
-        self.assertEqual(contact_page.save_revision().publish().get_latest_revision_as_page(), contact_page)
-
-    def test_form_field_creation(self):
-        # Create a ContactPage instance
-        contact_page = ContactPage(
-            title='Contact',
-            intro='Welcome to our contact page!',
-            thank_you_text='Thank you for reaching out.'
-        )
-        # Save the ContactPage instance
-        contact_page_revision = contact_page.save_revision()
-        contact_page_revision.publish()
-
-        # Create a FormField associated with the ContactPage
-        form_field = FormField(
-            page=contact_page,
-            label='Your Name',
-            field_type='singleline',
-            required=True
-        )
-        form_field.save()
-
-        # Retrieve the ContactPage from the database
-        contact_page_from_db = Page.objects.get(id=contact_page.id).specific
-
-        # Check if the FormField is associated with the ContactPage
-        self.assertEqual(contact_page_from_db.form_fields.first(), form_field)
-
-    def test_contact_page_form_submission(self):
-        # Create a ContactPage instance
-        contact_page = ContactPage(
-            title='Contact',
-            intro='Welcome to our contact page!',
-            thank_you_text='Thank you for reaching out.'
-        )
-        # Save the ContactPage instance
-        contact_page_revision = contact_page.save_revision()
-        contact_page_revision.publish()
-
-        # Simulate a form submission
-        form_data = {
-            'your_name': 'John Doe',
-            # Add other form fields as needed
-        }
-
-        response = self.client.post(contact_page.url, form_data)
-
-        # Check if the form submission is successful (assuming a 302 redirect)
-        self.assertEqual(response.status_code, 302)
-        
-        # You may add more assertions based on your specific requirements
-endef
-
-define WAGTAIL_HEADER_PREFIX
-{% load wagtailcore_tags %}
-{% wagtail_site as current_site %}
-endef 
-
-define WAGTAIL_HOME_PAGE_MODEL
-from wagtail.models import Page
-from wagtail.fields import StreamField
-from wagtail import blocks
-from wagtail.admin.panels import FieldPanel
-from wagtail.images.blocks import ImageChooserBlock
-
-
-class MarketingBlock(blocks.StructBlock):
-    title = blocks.CharBlock(required=False, help_text="Enter the block title")
-    content = blocks.RichTextBlock(required=False, help_text="Enter the block content")
-    images = blocks.ListBlock(
-        ImageChooserBlock(required=False),
-        help_text="Select one or two images for column display. Select three or more images for carousel display.",
-    )
-    image = ImageChooserBlock(
-        required=False, help_text="Select one image for background display."
-    )
-    block_class = blocks.CharBlock(
-        required=False,
-        help_text="Enter a CSS class for styling the marketing block",
-        classname="full title",
-        default="vh-100 bg-secondary",
-    )
-    image_class = blocks.CharBlock(
-        required=False,
-        help_text="Enter a CSS class for styling the column display image(s)",
-        classname="full title",
-        default="img-thumbnail p-5",
-    )
-    layout_class = blocks.CharBlock(
-        required=False,
-        help_text="Enter a CSS class for styling the layout.",
-        classname="full title",
-        default="d-flex flex-row",
-    )
-
-    class Meta:
-        icon = "placeholder"
-        template = "blocks/marketing_block.html"
-
-
-class HomePage(Page):
-    template = "home/home_page.html"  # Create a template for rendering the home page
-
-    marketing_blocks = StreamField(
-        [
-            ("marketing_block", MarketingBlock()),
-        ],
-        blank=True,
-        null=True,
-        use_json_field=True,
-    )
-    content_panels = Page.content_panels + [
-        FieldPanel("marketing_blocks"),
-    ]
-
-    class Meta:
-        verbose_name = "Home Page"
-endef
-
-define WAGTAIL_HOME_PAGE_TEMPLATE
-{% extends "base.html" %}
-{% load wagtailcore_tags %}
-{% block content %}
-    <main class="{% block main_class %}{% endblock %}">
-        {% for block in page.marketing_blocks %}
-            {% include_block block %}
-        {% endfor %}
-    </main>
-{% endblock %}
-endef
-
-define WAGTAIL_PRIVACY_PAGE_MODEL
-from wagtail.models import Page
-from wagtail.admin.panels import FieldPanel
-from wagtailmarkdown.fields import MarkdownField
-
-
-class PrivacyPage(Page):
-    """
-    A Wagtail Page model for the Privacy Policy page.
-    """
-
-    template = "privacy_page.html"
-
-    body = MarkdownField()
-
-    content_panels = Page.content_panels + [
-        FieldPanel("body", classname="full"),
-    ]
-
-    class Meta:
-        verbose_name = "Privacy Page"
-endef
-
-define WAGTAIL_PRIVACY_PAGE_TEMPLATE
-{% extends 'base.html' %}
-{% load wagtailmarkdown %}
-{% block content %}<div class="container">{{ page.body|markdown }}</div>{% endblock %}
-endef
-
-define WAGTAIL_SEARCH_TEMPLATE
-{% extends "base.html" %}
-{% load static wagtailcore_tags %}
-{% block body_class %}template-searchresults{% endblock %}
-{% block title %}Search{% endblock %}
-{% block content %}
-    <h1>Search</h1>
-    <form action="{% url 'search' %}" method="get">
-        <input type="text"
-               name="query"
-               {% if search_query %}value="{{ search_query }}"{% endif %}>
-        <input type="submit" value="Search" class="button">
-    </form>
-    {% if search_results %}
-        <ul>
-            {% for result in search_results %}
-                <li>
-                    <h4>
-                        <a href="{% pageurl result %}">{{ result }}</a>
-                    </h4>
-                    {% if result.search_description %}{{ result.search_description }}{% endif %}
-                </li>
-            {% endfor %}
-        </ul>
-        {% if search_results.has_previous %}
-            <a href="{% url 'search' %}?query={{ search_query|urlencode }}&amp;page={{ search_results.previous_page_number }}">Previous</a>
-        {% endif %}
-        {% if search_results.has_next %}
-            <a href="{% url 'search' %}?query={{ search_query|urlencode }}&amp;page={{ search_results.next_page_number }}">Next</a>
-        {% endif %}
-    {% elif search_query %}
-        No results found
-    {% else %}
-        No results found. Try a <a href="?query=test">test query</a>?
-    {% endif %}
-{% endblock %}
-endef
-
-define WAGTAIL_SEARCH_URLS
-from django.urls import path
-from .views import search
-
-urlpatterns = [path("", search, name="search")]
-endef
-
-define WAGTAIL_SETTINGS
-INSTALLED_APPS.append("wagtail_color_panel")
-INSTALLED_APPS.append("wagtail_modeladmin")
-INSTALLED_APPS.append("wagtail.contrib.settings")
-INSTALLED_APPS.append("wagtailmarkdown")
-INSTALLED_APPS.append("wagtailmenus")
-INSTALLED_APPS.append("wagtailseo")
-TEMPLATES[0]["OPTIONS"]["context_processors"].append(
-    "wagtail.contrib.settings.context_processors.settings"
-)
-TEMPLATES[0]["OPTIONS"]["context_processors"].append(
-    "wagtailmenus.context_processors.wagtailmenus"
-)
-endef
-
-define WAGTAIL_SITEPAGE_MODEL
-from wagtail.models import Page
-
-
-class SitePage(Page):
-    template = "sitepage/site_page.html"
-
-    class Meta:
-        verbose_name = "Site Page"
-endef
-
-define WAGTAIL_SITEPAGE_TEMPLATE
-{% extends 'base.html' %}
-{% block content %}
-    <h1>{{ page.title }}</h1>
-{% endblock %}
-endef
-
-define WAGTAIL_URLS
-from django.conf import settings
-from django.urls import include, path
-from django.contrib import admin
-
-from wagtail.admin import urls as wagtailadmin_urls
-from wagtail.documents import urls as wagtaildocs_urls
-
-from search import views as search_views
-
-urlpatterns = [
-    path("django/", admin.site.urls),
-    path("wagtail/", include(wagtailadmin_urls)),
-    path("documents/", include(wagtaildocs_urls)),
-    path("search/", search_views.search, name="search"),
-]
-
-if settings.DEBUG:
-    from django.conf.urls.static import static
-    from django.contrib.staticfiles.urls import staticfiles_urlpatterns
-
-    # Serve static and media files from development server
-    urlpatterns += staticfiles_urlpatterns()
-    urlpatterns += static(settings.MEDIA_URL, document_root=settings.MEDIA_ROOT)
-endef
-
-define WAGTAIL_URLS_HOME
-urlpatterns += [
-    # For anything not caught by a more specific rule above, hand over to
-    # Wagtail's page serving mechanism. This should be the last pattern in
-    # the list:
-    path("", include("wagtail.urls")),
-    # Alternatively, if you want Wagtail pages to be served from a subpath
-    # of your site, rather than the site root:
-    #    path("pages/", include("wagtail.urls"),
-]
-endef
-
-define WEBPACK_CONFIG_JS
-const path = require('path');
-
-module.exports = {
-  mode: 'development',
-  entry: './src/index.js',
-  output: {
-    filename: 'bundle.js',
-    path: path.resolve(__dirname, 'dist'),
-  },
-};
-endef
-
-define WEBPACK_INDEX_HTML
-<!DOCTYPE html>
-<html lang="en">
-<head>
-  <meta charset="UTF-8">
-  <meta name="viewport" content="width=device-width, initial-scale=1.0">
-  <title>Hello, Webpack!</title>
-</head>
-<body>
-  <script src="dist/bundle.js"></script>
-</body>
-</html>
-endef
-
-define WEBPACK_INDEX_JS
-const message = "Hello, World!";
-console.log(message);
-endef
-
-define WEBPACK_REVEAL_CONFIG_JS
-const path = require('path');
-const MiniCssExtractPlugin = require('mini-css-extract-plugin');
-
-module.exports = {
-  mode: 'development',
-  entry: './src/index.js',
-  output: {
-    filename: 'bundle.js',
-    path: path.resolve(__dirname, 'dist'),
-  },
-  module: {
-    rules: [
-      {
-        test: /\.css$$/,
-        use: [MiniCssExtractPlugin.loader, 'css-loader'],
-      },
-    ],
-  },
-  plugins: [
-    new MiniCssExtractPlugin({
-      filename: 'bundle.css',
-    }),
-  ],
-};
-endef
-
-define WEBPACK_REVEAL_INDEX_HTML
-<!DOCTYPE html>
-<html>
-    <head>
-        <meta charset="UTF-8">
-        <meta name="viewport" content="width=device-width, initial-scale=1.0">
-        <title>Project Makefile</title>
-        <link rel="stylesheet" href="dist/bundle.css">
-    </head>
-    <div class="reveal">
-        <div class="slides">
-            <section>
-                Slide 1: Draw some circles
-            </section>
-            <section>
-                Slide 2: Draw the rest of the owl
-            </section>
-        </div>
-    </div>
-    <script src="dist/bundle.js"></script>
-</html>
-endef
-
-define WEBPACK_REVEAL_INDEX_JS
-import 'reveal.js/dist/reveal.css';
-import 'reveal.js/dist/theme/black.css';
-import Reveal from 'reveal.js';
-import RevealNotes from 'reveal.js/plugin/notes/notes.js';
-Reveal.initialize({ slideNumber: true, plugins: [ RevealNotes ]});
-endef
-
-# ------------------------------------------------------------------------------  
-# Export variables used by phony target rules
-# ------------------------------------------------------------------------------  
-
-export DJANGO_ALLAUTH_BASE_TEMPLATE
-export DJANGO_API_SERIALIZERS
-export DJANGO_API_VIEWS
-export DJANGO_APP_TESTS
-export DJANGO_BACKEND_APPS
-export DJANGO_BASE_TEMPLATE
-export DJANGO_CUSTOM_ADMIN
-export DJANGO_DOCKERCOMPOSE
-export DJANGO_DOCKERFILE
-export DJANGO_FAVICON_TEMPLATE
-export DJANGO_FOOTER_TEMPLATE
-export DJANGO_FRONTEND_APP
-export DJANGO_FRONTEND_APP_CONFIG
-export DJANGO_FRONTEND_BABELRC
-export DJANGO_FRONTEND_COMPONENTS
-export DJANGO_FRONTEND_COMPONENT_CLOCK
-export DJANGO_FRONTEND_COMPONENT_ERROR
-export DJANGO_FRONTEND_COMPONENT_USER_MENU
-export DJANGO_FRONTEND_CONTEXT_INDEX
-export DJANGO_FRONTEND_CONTEXT_USER_PROVIDER
-export DJANGO_FRONTEND_ESLINTRC
-export DJANGO_FRONTEND_OFFCANVAS_TEMPLATE
-export DJANGO_FRONTEND_PORTAL
-export DJANGO_FRONTEND_STYLES
-export DJANGO_FRONTEND_THEME_BLUE
-export DJANGO_FRONTEND_THEME_TOGGLER
-export DJANGO_HEADER_TEMPLATE
-export DJANGO_HOME_PAGE_ADMIN
-export DJANGO_HOME_PAGE_MODELS
-export DJANGO_HOME_PAGE_TEMPLATE
-export DJANGO_HOME_PAGE_URLS
-export DJANGO_HOME_PAGE_VIEWS
-export DJANGO_LOGGING_DEMO_ADMIN
-export DJANGO_LOGGING_DEMO_MODELS
-export DJANGO_LOGGING_DEMO_SETTINGS
-export DJANGO_LOGGING_DEMO_URLS
-export DJANGO_LOGGING_DEMO_VIEWS
-export DJANGO_MANAGE_PY
-export DJANGO_MODEL_FORM_DEMO_ADMIN
-export DJANGO_MODEL_FORM_DEMO_FORMS
-export DJANGO_MODEL_FORM_DEMO_MODEL
-export DJANGO_MODEL_FORM_DEMO_TEMPLATE_DETAIL
-export DJANGO_MODEL_FORM_DEMO_TEMPLATE_FORM
-export DJANGO_MODEL_FORM_DEMO_TEMPLATE_LIST
-export DJANGO_MODEL_FORM_DEMO_URLS
-export DJANGO_MODEL_FORM_DEMO_VIEWS
-export DJANGO_PAYMENTS_ADMIN
-export DJANGO_PAYMENTS_FORM
-export DJANGO_PAYMENTS_MIGRATION_0002
-export DJANGO_PAYMENTS_MIGRATION_0003
-export DJANGO_PAYMENTS_MODELS
-export DJANGO_PAYMENTS_TEMPLATE_CANCEL
-export DJANGO_PAYMENTS_TEMPLATE_CHECKOUT
-export DJANGO_PAYMENTS_TEMPLATE_PRODUCT_DETAIL
-export DJANGO_PAYMENTS_TEMPLATE_PRODUCT_LIST
-export DJANGO_PAYMENTS_TEMPLATE_SUCCESS
-export DJANGO_PAYMENTS_URLS
-export DJANGO_PAYMENTS_VIEW
-export DJANGO_SEARCH_FORMS
-export DJANGO_SEARCH_SETTINGS
-export DJANGO_SEARCH_TEMPLATE
-export DJANGO_SEARCH_URLS
-export DJANGO_SEARCH_UTILS
-export DJANGO_SEARCH_VIEWS
-export DJANGO_SETTINGS_AUTHENTICATION_BACKENDS
-export DJANGO_SETTINGS_BASE
-export DJANGO_SETTINGS_BASE_MINIMAL
-export DJANGO_SETTINGS_CRISPY_FORMS
-export DJANGO_SETTINGS_DATABASE
-export DJANGO_SETTINGS_DEV
-export DJANGO_SETTINGS_HOME_PAGE
-export DJANGO_SETTINGS_INSTALLED_APPS
-export DJANGO_SETTINGS_MIDDLEWARE
-export DJANGO_SETTINGS_MODEL_FORM_DEMO
-export DJANGO_SETTINGS_PAYMENTS
-export DJANGO_SETTINGS_PROD
-export DJANGO_SETTINGS_REST_FRAMEWORK
-export DJANGO_SETTINGS_SITEUSER
-export DJANGO_SETTINGS_THEMES
-export DJANGO_SITEUSER_ADMIN
-export DJANGO_SITEUSER_EDIT_TEMPLATE
-export DJANGO_SITEUSER_FORM
-export DJANGO_SITEUSER_MODEL
-export DJANGO_SITEUSER_URLS
-export DJANGO_SITEUSER_VIEW
-export DJANGO_SITEUSER_VIEW_TEMPLATE
-export DJANGO_URLS
-export DJANGO_URLS_ALLAUTH
-export DJANGO_URLS_API
-export DJANGO_URLS_DEBUG_TOOLBAR
-export DJANGO_URLS_HOME_PAGE
-export DJANGO_URLS_LOGGING_DEMO
-export DJANGO_URLS_MODEL_FORM_DEMO
-export DJANGO_URLS_SITEUSER
-export DJANGO_UTILS
-export EB_CUSTOM_ENV_EC2_USER
-export EB_CUSTOM_ENV_VAR_FILE
-export GIT_IGNORE
-export JENKINS_FILE
-export MAKEFILE_CUSTOM
-export PIP_INSTALL_REQUIREMENTS_TEST
-export PROGRAMMING_INTERVIEW
-export PYTHON_CI_YAML
-export PYTHON_LICENSE_TXT
-export PYTHON_PROJECT_TOML
-export SEPARATOR
-export TINYMCE_JS
-export WAGTAIL_BASE_TEMPLATE
-export WAGTAIL_BLOCK_CAROUSEL
-export WAGTAIL_BLOCK_MARKETING
-export WAGTAIL_CONTACT_PAGE_LANDING
-export WAGTAIL_CONTACT_PAGE_MODEL
-export WAGTAIL_CONTACT_PAGE_TEMPLATE
-export WAGTAIL_CONTACT_PAGE_TEST
-export WAGTAIL_HOME_PAGE_MODEL
-export WAGTAIL_HOME_PAGE_TEMPLATE
-export WAGTAIL_HOME_PAGE_URLS
-export WAGTAIL_HOME_PAGE_VIEWS
-export WAGTAIL_PRIVACY_PAGE_MODEL
-export WAGTAIL_PRIVACY_PAGE_MODEL
-export WAGTAIL_PRIVACY_PAGE_TEMPLATE
-export WAGTAIL_SEARCH_TEMPLATE
-export WAGTAIL_SEARCH_URLS
-export WAGTAIL_SETTINGS
-export WAGTAIL_SITEPAGE_MODEL
-export WAGTAIL_SITEPAGE_TEMPLATE
-export WAGTAIL_URLS
-export WAGTAIL_URLS_HOME
-export WEBPACK_CONFIG_JS
-export WEBPACK_INDEX_HTML
-export WEBPACK_INDEX_JS
-export WEBPACK_REVEAL_CONFIG_JS
-export WEBPACK_REVEAL_INDEX_HTML
-export WEBPACK_REVEAL_INDEX_JS
-
-# ------------------------------------------------------------------------------
-# Multi-line phony target rules
-# ------------------------------------------------------------------------------
-
-.PHONY: aws-check-env-profile-default
-aws-check-env-profile-default:
-ifndef AWS_PROFILE
-	$(error AWS_PROFILE is undefined)
-endif
-
-.PHONY: aws-check-env-region-default
-aws-check-env-region-default:
-ifndef AWS_REGION
-	$(error AWS_REGION is undefined)
-endif
-
-.PHONY: aws-secret-default
-aws-secret-default: aws-check-env
-	@SECRET_KEY=$$(openssl rand -base64 48); aws ssm put-parameter --name "SECRET_KEY" --value "$$SECRET_KEY" --type String
-
-.PHONY: aws-sg-default
-aws-sg-default: aws-check-env
-	aws ec2 describe-security-groups $(AWS_OPTS)
-
-.PHONY: aws-ssm-default
-aws-ssm-default: aws-check-env
-	aws ssm describe-parameters $(AWS_OPTS)
-	@echo "Get parameter values with: aws ssm getparameter --name <Name>."
-
-.PHONY: aws-subnet-default
-aws-subnet-default: aws-check-env
-	aws ec2 describe-subnets $(AWS_OPTS)
-
-.PHONY: aws-vol-available-default
-aws-vol-available-default: aws-check-env
-	aws ec2 describe-volumes --filters Name=status,Values=available --query "Volumes[*].{ID:VolumeId,Size:Size}" --output table
-
-.PHONY: aws-vol-default
-aws-vol-default: aws-check-env
-	aws ec2 describe-volumes --output table
-
-.PHONY: aws-vpc-default
-aws-vpc-default: aws-check-env
-	aws ec2 describe-vpcs $(AWS_OPTS)
-
-.PHONY: db-import-default
-db-import-default:
-	@psql $(DJANGO_DB_NAME) < $(DJANGO_DB_NAME).sql
-
-.PHONY: db-init-default
-db-init-default:
-	-dropdb $(PROJECT_NAME)
-	-createdb $(PROJECT_NAME)
-
-.PHONY: db-init-mysql-default
-db-init-mysql-default:
-	-mysqladmin -u root drop $(PROJECT_NAME)
-	-mysqladmin -u root create $(PROJECT_NAME)
-
-.PHONY: db-init-test-default
-db-init-test-default:
-	-dropdb test_$(PROJECT_NAME)
-	-createdb test_$(PROJECT_NAME)
-
-.PHONY: django-allauth-default
-django-allauth-default:
-	$(ADD_DIR) backend/templates/allauth/layouts
-	@echo "$$DJANGO_ALLAUTH_BASE_TEMPLATE" > backend/templates/allauth/layouts/base.html
-	@echo "$$DJANGO_URLS_ALLAUTH" >> $(DJANGO_URLS_FILE)
-	-$(GIT_ADD) backend/templates/allauth/layouts/base.html
-
-.PHONY: django-app-tests-default
-django-app-tests-default:
-	@echo "$$DJANGO_APP_TESTS" > $(APP_DIR)/tests.py
-
-.PHONY: django-base-template-default
-django-base-template-default:
-	@$(ADD_DIR) backend/templates
-	@echo "$$DJANGO_BASE_TEMPLATE" > backend/templates/base.html
-	-$(GIT_ADD) backend/templates/base.html
-
-.PHONY: django-custom-admin-default
-django-custom-admin-default:
-	@echo "$$DJANGO_CUSTOM_ADMIN" > $(DJANGO_CUSTOM_ADMIN_FILE)
-	@echo "$$DJANGO_BACKEND_APPS" > $(DJANGO_BACKEND_APPS_FILE)
-	-$(GIT_ADD) backend/*.py
-
-.PHONY: django-db-shell-default
-django-db-shell-default:
-	python manage.py dbshell
-
-.PHONY: django-dockerfile-default
-django-dockerfile-default:
-	@echo "$$DJANGO_DOCKERFILE" > Dockerfile
-	-$(GIT_ADD) Dockerfile
-	@echo "$$DJANGO_DOCKERCOMPOSE" > docker-compose.yml
-	-$(GIT_ADD) docker-compose.yml
-
-.PHONY: django-favicon-default
-django-favicon-default:
-	@echo "$$DJANGO_FAVICON_TEMPLATE" > backend/templates/favicon.html
-	-$(GIT_ADD) backend/templates/favicon.html
-
-.PHONY: django-footer-template-default
-django-footer-template-default:
-	@echo "$$DJANGO_FOOTER_TEMPLATE" > backend/templates/footer.html
-	-$(GIT_ADD) backend/templates/footer.html
-
-.PHONY: django-frontend-default
-django-frontend-default: python-webpack-init
-	$(ADD_DIR) frontend/src/context
-	$(ADD_DIR) frontend/src/images
-	$(ADD_DIR) frontend/src/utils
-	@echo "$$DJANGO_FRONTEND_APP" > frontend/src/application/app.js
-	@echo "$$DJANGO_FRONTEND_APP_CONFIG" > frontend/src/application/config.js
-	@echo "$$DJANGO_FRONTEND_BABELRC" > frontend/.babelrc
-	@echo "$$DJANGO_FRONTEND_COMPONENT_CLOCK" > frontend/src/components/Clock.js
-	@echo "$$DJANGO_FRONTEND_COMPONENT_ERROR" > frontend/src/components/ErrorBoundary.js
-	@echo "$$DJANGO_FRONTEND_CONTEXT_INDEX" > frontend/src/context/index.js
-	@echo "$$DJANGO_FRONTEND_CONTEXT_USER_PROVIDER" > frontend/src/context/UserContextProvider.js
-	@echo "$$DJANGO_FRONTEND_COMPONENT_USER_MENU" > frontend/src/components/UserMenu.js
-	@echo "$$DJANGO_FRONTEND_COMPONENTS" > frontend/src/components/index.js
-	@echo "$$DJANGO_FRONTEND_ESLINTRC" > frontend/.eslintrc
-	@echo "$$DJANGO_FRONTEND_PORTAL" > frontend/src/dataComponents.js
-	@echo "$$DJANGO_FRONTEND_STYLES" > frontend/src/styles/index.scss
-	@echo "$$DJANGO_FRONTEND_THEME_BLUE" > frontend/src/styles/theme-blue.scss
-	@echo "$$DJANGO_FRONTEND_THEME_TOGGLER" > frontend/src/utils/themeToggler.js
-	# @echo "$$TINYMCE_JS" > frontend/src/utils/tinymce.js
-	@$(MAKE) npm-install-django
-	@$(MAKE) npm-install-django-dev
-	-$(GIT_ADD) $(DJANGO_FRONTEND_FILES)
-
-.PHONY: django-graph-default
-django-graph-default:
-	python manage.py graph_models -a -o $(PROJECT_NAME).png
-
-.PHONY: django-header-template-default
-django-header-template-default:
-	@echo "$$DJANGO_HEADER_TEMPLATE" > backend/templates/header.html
-	-$(GIT_ADD) backend/templates/header.html
-
-.PHONY: django-home-default
-django-home-default:
-	python manage.py startapp home
-	$(ADD_DIR) home/templates
-	@echo "$$DJANGO_HOME_PAGE_ADMIN" > home/admin.py
-	@echo "$$DJANGO_HOME_PAGE_MODELS" > home/models.py
-	@echo "$$DJANGO_HOME_PAGE_TEMPLATE" > home/templates/home.html
-	@echo "$$DJANGO_HOME_PAGE_VIEWS" > home/views.py
-	@echo "$$DJANGO_HOME_PAGE_URLS" > home/urls.py
-	@echo "$$DJANGO_URLS_HOME_PAGE" >> $(DJANGO_URLS_FILE)
-	@echo "$$DJANGO_SETTINGS_HOME_PAGE" >> $(DJANGO_SETTINGS_BASE_FILE)
-	export APP_DIR="home"; $(MAKE) django-app-tests
-	-$(GIT_ADD) home/templates
-	-$(GIT_ADD) home/*.py
-	-$(GIT_ADD) home/migrations/*.py
-
-.PHONY: django-init-default
-django-init-default: separator \
-	db-init \
-	django-install \
-	django-project \
-	django-utils \
-	pip-freeze \
-	pip-init-test \
-	django-settings-directory \
-	django-custom-admin \
-	django-dockerfile \
-	django-offcanvas-template \
-	django-header-template \
-	django-footer-template \
-	django-base-template \
-	django-manage-py \
-	django-urls \
-	django-urls-debug-toolbar \
-	django-allauth \
-	django-favicon \
-	git-ignore \
-	django-settings-base \
-	django-settings-dev \
-	django-settings-prod \
-	django-siteuser \
-	django-home \
-	django-rest-serializers \
-	django-rest-views \
-	django-urls-api \
-	django-frontend \
-	django-migrate \
-	django-su
-
-.PHONY: django-init-minimal-default
-django-init-minimal-default: separator \
-	db-init \
-	django-install-minimal \
-	django-project \
-	django-settings-directory \
-	django-settings-base-minimal \
-	django-settings-dev \
-	pip-freeze \
-	pip-init-test \
-	django-custom-admin \
-	django-dockerfile \
-	django-offcanvas-template \
-	django-header-template \
-	django-footer-template \
-	django-base-template \
-	django-manage-py \
-	django-urls \
-	django-urls-debug-toolbar \
-	django-favicon \
-	django-settings-prod \
-	django-home \
-	django-utils \
-	django-frontend \
-	django-migrate \
-	git-ignore \
-	django-su
-
-.PHONY: django-init-wagtail-default
-django-init-wagtail-default: separator \
-	db-init \
-	django-install \
-	wagtail-install \
-	wagtail-project \
-	django-utils \
-	pip-freeze \
-	pip-init-test \
-        django-custom-admin \
-        django-dockerfile \
-	django-offcanvas-template \
-	wagtail-header-prefix-template \
-	django-header-template \
-	wagtail-base-template \
-	django-footer-template \
-	django-manage-py \
-	wagtail-home \
-	wagtail-urls \
-	django-urls-debug-toolbar \
-	django-allauth \
-	django-favicon \
-	git-ignore \
-	wagtail-search \
-	django-settings-base \
-	django-settings-dev \
-	django-settings-prod \
-	wagtail-settings \
-	django-siteuser \
-	django-model-form-demo \
-	django-logging-demo \
-	django-payments-demo-default \
-	django-rest-serializers \
-	django-rest-views \
-	django-urls-api \
-	wagtail-urls-home \
-	django-frontend \
-	django-migrate \
-	django-su
-
-.PHONY: django-install-default
-django-install-default:
-	$(PIP_ENSURE)
-	python -m pip install \
-	Django \
-        Faker \
-        boto3 \
-        crispy-bootstrap5 \
-        djangorestframework \
-        django-allauth \
-        django-after-response \
-        django-ckeditor \
-        django-colorful \
-        django-cors-headers \
-        django-countries \
-        django-crispy-forms \
-        django-debug-toolbar \
-        django-extensions \
-        django-hijack \
-        django-honeypot \
-        django-imagekit \
-        django-import-export \
-        django-ipware \
-        django-multiselectfield \
-        django-ninja \
-        django-phonenumber-field \
-        django-recurrence \
-        django-recaptcha \
-        django-registration \
-        django-richtextfield \
-        django-sendgrid-v5 \
-        django-social-share \
-        django-sql-explorer \
-        django-storages \
-        django-tables2 \
-        django-timezone-field \
-	django-widget-tweaks \
-        dj-database-url \
-        dj-rest-auth \
-        dj-stripe \
-        docutils \
-        enmerkar \
-        gunicorn \
-        html2docx \
-        icalendar \
-        mailchimp-marketing \
-        mailchimp-transactional \
-        phonenumbers \
-        pipdeptree \
-        psycopg2-binary \
-        pydotplus \
-        python-webpack-boilerplate \
-        python-docx \
-        reportlab \
-        texttable
-
-.PHONY: django-install-minimal-default
-django-install-minimal-default:
-	$(PIP_ENSURE)
-	python -m pip install \
-	Django \
-	dj-database-url \
-	django-debug-toolbar \
-	python-webpack-boilerplate
-
-.PHONY: django-lint-default
-django-lint-default:
-	-ruff format -v
-	-djlint --reformat --format-css --format-js .
-	-ruff check -v --fix
-
-.PHONY: django-loaddata-default
-django-loaddata-default:
-	python manage.py loaddata
-
-.PHONY: django-logging-demo-default
-django-logging-demo-default:
-	python manage.py startapp logging_demo
-	@echo "$$DJANGO_LOGGING_DEMO_ADMIN" > logging_demo/admin.py
-	@echo "$$DJANGO_LOGGING_DEMO_MODELS" > logging_demo/models.py
-	@echo "$$DJANGO_LOGGING_DEMO_SETTINGS" >> $(DJANGO_SETTINGS_BASE_FILE)
-	@echo "$$DJANGO_LOGGING_DEMO_URLS" > logging_demo/urls.py
-	@echo "$$DJANGO_LOGGING_DEMO_VIEWS" > logging_demo/views.py
-	@echo "$$DJANGO_URLS_LOGGING_DEMO" >> $(DJANGO_URLS_FILE)
-	export APP_DIR="logging_demo"; $(MAKE) django-app-tests
-	-$(GIT_ADD) logging_demo/*.py
-	-$(GIT_ADD) logging_demo/migrations/*.py
-
-.PHONY: django-manage-py-default
-django-manage-py-default:
-	@echo "$$DJANGO_MANAGE_PY" > manage.py
-	-$(GIT_ADD) manage.py
-
-.PHONY: django-migrate-default
-django-migrate-default:
-	python manage.py migrate
-
-.PHONY: django-migrations-make-default
-django-migrations-make-default:
-	python manage.py makemigrations
-
-.PHONY: django-migrations-show-default
-django-migrations-show-default:
-	python manage.py showmigrations
-
-.PHONY: django-model-form-demo-default
-django-model-form-demo-default:
-	python manage.py startapp model_form_demo
-	@echo "$$DJANGO_MODEL_FORM_DEMO_ADMIN" > model_form_demo/admin.py
-	@echo "$$DJANGO_MODEL_FORM_DEMO_FORMS" > model_form_demo/forms.py
-	@echo "$$DJANGO_MODEL_FORM_DEMO_MODEL" > model_form_demo/models.py
-	@echo "$$DJANGO_MODEL_FORM_DEMO_URLS" > model_form_demo/urls.py
-	@echo "$$DJANGO_MODEL_FORM_DEMO_VIEWS" > model_form_demo/views.py
-	$(ADD_DIR) model_form_demo/templates
-	@echo "$$DJANGO_MODEL_FORM_DEMO_TEMPLATE_DETAIL" > model_form_demo/templates/model_form_demo_detail.html
-	@echo "$$DJANGO_MODEL_FORM_DEMO_TEMPLATE_FORM" > model_form_demo/templates/model_form_demo_form.html
-	@echo "$$DJANGO_MODEL_FORM_DEMO_TEMPLATE_LIST" > model_form_demo/templates/model_form_demo_list.html
-	@echo "$$DJANGO_SETTINGS_MODEL_FORM_DEMO" >> $(DJANGO_SETTINGS_BASE_FILE)
-	@echo "$$DJANGO_URLS_MODEL_FORM_DEMO" >> $(DJANGO_URLS_FILE)
-	export APP_DIR="model_form_demo"; $(MAKE) django-app-tests
-	python manage.py makemigrations
-	-$(GIT_ADD) model_form_demo/*.py
-	-$(GIT_ADD) model_form_demo/templates
-	-$(GIT_ADD) model_form_demo/migrations
-
-.PHONY: django-offcanvas-template-default
-django-offcanvas-template-default:
-	-$(ADD_DIR) backend/templates
-	@echo "$$DJANGO_FRONTEND_OFFCANVAS_TEMPLATE" > backend/templates/offcanvas.html
-	-$(GIT_ADD) backend/templates/offcanvas.html
-
-.PHONY: django-open-default
-django-open-default:
-ifeq ($(UNAME), Linux)
-	@echo "Opening on Linux."
-	xdg-open http://0.0.0.0:8000
-else ifeq ($(UNAME), Darwin)
-	@echo "Opening on macOS (Darwin)."
-	open http://0.0.0.0:8000
-else
-	@echo "Unable to open on: $(UNAME)"
-endif
-
-.PHONY: django-payments-demo-default
-django-payments-demo-default:
-	python manage.py startapp payments
-	@echo "$$DJANGO_PAYMENTS_FORM" > payments/forms.py
-	@echo "$$DJANGO_PAYMENTS_MODELS" > payments/models.py
-	@echo "$$DJANGO_PAYMENTS_ADMIN" > payments/admin.py
-	@echo "$$DJANGO_PAYMENTS_VIEW" > payments/views.py
-	@echo "$$DJANGO_PAYMENTS_URLS" > payments/urls.py
-	$(ADD_DIR) payments/templates/payments
-	$(ADD_DIR) payments/management/commands
-	@echo "$$DJANGO_PAYMENTS_TEMPLATE_CANCEL" > payments/templates/payments/cancel.html
-	@echo "$$DJANGO_PAYMENTS_TEMPLATE_CHECKOUT" > payments/templates/payments/checkout.html
-	@echo "$$DJANGO_PAYMENTS_TEMPLATE_SUCCESS" > payments/templates/payments/success.html
-	@echo "$$DJANGO_PAYMENTS_TEMPLATE_PRODUCT_LIST" > payments/templates/payments/product_list.html
-	@echo "$$DJANGO_PAYMENTS_TEMPLATE_PRODUCT_DETAIL" > payments/templates/payments/product_detail.html
-	@echo "$$DJANGO_SETTINGS_PAYMENTS" >> $(DJANGO_SETTINGS_BASE_FILE)
-	@echo "$$DJANGO_URLS_PAYMENTS" >> $(DJANGO_URLS_FILE)
-	export APP_DIR="payments"; $(MAKE) django-app-tests
-	python manage.py makemigrations payments
-	@echo "$$DJANGO_PAYMENTS_MIGRATION_0002" > payments/migrations/0002_set_stripe_api_keys.py
-	@echo "$$DJANGO_PAYMENTS_MIGRATION_0003" > payments/migrations/0003_create_initial_products.py
-	-$(GIT_ADD) payments/
-
-.PHONY: django-project-default
-django-project-default:
-	django-admin startproject backend .
-	-$(GIT_ADD) backend
-
-.PHONY: django-rest-serializers-default
-django-rest-serializers-default:
-	@echo "$$DJANGO_API_SERIALIZERS" > backend/serializers.py
-	-$(GIT_ADD) backend/serializers.py
-
-.PHONY: django-rest-views-default
-django-rest-views-default:
-	@echo "$$DJANGO_API_VIEWS" > backend/api.py
-	-$(GIT_ADD) backend/api.py
-
-.PHONY: django-search-default
-django-search-default:
-	python manage.py startapp search
-	$(ADD_DIR) search/templates
-	@echo "$$DJANGO_SEARCH_TEMPLATE" > search/templates/search.html
-	@echo "$$DJANGO_SEARCH_FORMS" > search/forms.py
-	@echo "$$DJANGO_SEARCH_URLS" > search/urls.py
-	@echo "$$DJANGO_SEARCH_UTILS" > search/utils.py
-	@echo "$$DJANGO_SEARCH_VIEWS" > search/views.py
-	@echo "$$DJANGO_SEARCH_SETTINGS" >> $(DJANGO_SETTINGS_BASE_FILE)
-	@echo "INSTALLED_APPS.append('search')" >> $(DJANGO_SETTINGS_BASE_FILE)
-	@echo "urlpatterns += [path('search/', include('search.urls'))]" >> $(DJANGO_URLS_FILE)
-	-$(GIT_ADD) search/templates
-	-$(GIT_ADD) search/*.py
-
-.PHONY: django-secret-key-default
-django-secret-key-default:
-	@python -c "from secrets import token_urlsafe; print(token_urlsafe(50))"
-
-.PHONY: django-serve-default
-django-serve-default:
-	npm run watch &
-	python manage.py runserver 0.0.0.0:8000
-
-.PHONY: django-settings-base-default
-django-settings-base-default:
-	@echo "$$DJANGO_SETTINGS_BASE" >> $(DJANGO_SETTINGS_BASE_FILE)
-	@echo "$$DJANGO_SETTINGS_AUTHENTICATION_BACKENDS" >> $(DJANGO_SETTINGS_BASE_FILE)
-	@echo "$$DJANGO_SETTINGS_REST_FRAMEWORK" >> $(DJANGO_SETTINGS_BASE_FILE)
-	@echo "$$DJANGO_SETTINGS_THEMES" >> $(DJANGO_SETTINGS_BASE_FILE)
-	@echo "$$DJANGO_SETTINGS_DATABASE" >> $(DJANGO_SETTINGS_BASE_FILE)
-	@echo "$$DJANGO_SETTINGS_INSTALLED_APPS" >> $(DJANGO_SETTINGS_BASE_FILE)
-	@echo "$$DJANGO_SETTINGS_MIDDLEWARE" >> $(DJANGO_SETTINGS_BASE_FILE)
-	@echo "$$DJANGO_SETTINGS_CRISPY_FORMS" >> $(DJANGO_SETTINGS_BASE_FILE)
-
-.PHONY: django-settings-base-minimal-default
-django-settings-base-minimal-default:
-	@echo "$$DJANGO_SETTINGS_BASE_MINIMAL" >> $(DJANGO_SETTINGS_BASE_FILE)
-
-.PHONY: django-settings-dev-default
-django-settings-dev-default:
-	@echo "# $(PROJECT_NAME)" > $(DJANGO_SETTINGS_DEV_FILE)
-	@echo "$$DJANGO_SETTINGS_DEV" >> backend/settings/dev.py
-	-$(GIT_ADD) $(DJANGO_SETTINGS_DEV_FILE)
-
-.PHONY: django-settings-directory-default
-django-settings-directory-default:
-	@$(ADD_DIR) $(DJANGO_SETTINGS_DIR)
-	@$(COPY_FILE) backend/settings.py backend/settings/base.py
-	@$(DEL_FILE) backend/settings.py
-	-$(GIT_ADD) backend/settings/*.py
-
-.PHONY: django-settings-prod-default
-django-settings-prod-default:
-	@echo "$$DJANGO_SETTINGS_PROD" > $(DJANGO_SETTINGS_PROD_FILE)
-	-$(GIT_ADD) $(DJANGO_SETTINGS_PROD_FILE)
-
-.PHONY: django-shell-default
-django-shell-default:
-	python manage.py shell
-
-.PHONY: django-siteuser-default
-django-siteuser-default:
-	python manage.py startapp siteuser
-	$(ADD_DIR) siteuser/templates/
-	@echo "$$DJANGO_SITEUSER_FORM" > siteuser/forms.py
-	@echo "$$DJANGO_SITEUSER_MODEL" > siteuser/models.py
-	@echo "$$DJANGO_SITEUSER_ADMIN" > siteuser/admin.py
-	@echo "$$DJANGO_SITEUSER_VIEW" > siteuser/views.py
-	@echo "$$DJANGO_SITEUSER_URLS" > siteuser/urls.py
-	@echo "$$DJANGO_SITEUSER_VIEW_TEMPLATE" > siteuser/templates/profile.html
-	@echo "$$DJANGO_SITEUSER_TEMPLATE" > siteuser/templates/user.html
-	@echo "$$DJANGO_SITEUSER_EDIT_TEMPLATE" > siteuser/templates/user_edit.html
-	@echo "$$DJANGO_URLS_SITEUSER" >> $(DJANGO_URLS_FILE)
-	@echo "$$DJANGO_SETTINGS_SITEUSER" >> $(DJANGO_SETTINGS_BASE_FILE)
-	export APP_DIR="siteuser"; $(MAKE) django-app-tests
-	-$(GIT_ADD) siteuser/templates
-	-$(GIT_ADD) siteuser/*.py
-	python manage.py makemigrations siteuser
-	-$(GIT_ADD) siteuser/migrations/*.py
-
-.PHONY: django-static-default
-django-static-default:
-	python manage.py collectstatic --noinput
-
-.PHONY: django-su-default
-django-su-default:
-	DJANGO_SUPERUSER_PASSWORD=admin python manage.py createsuperuser --noinput --username=admin --email=$(PROJECT_EMAIL)
-
-.PHONY: django-test-default
-django-test-default: npm-install django-static
-	-$(MAKE) pip-install-test
-	python manage.py test
-
-.PHONY: django-urls-api-default
-django-urls-api-default:
-	@echo "$$DJANGO_URLS_API" >> $(DJANGO_URLS_FILE)
-	-$(GIT_ADD) $(DJANGO_URLS_FILE)
-
-.PHONY: django-urls-debug-toolbar-default
-django-urls-debug-toolbar-default:
-	@echo "$$DJANGO_URLS_DEBUG_TOOLBAR" >> $(DJANGO_URLS_FILE)
-
-.PHONY: django-urls-default
-django-urls-default:
-	@echo "$$DJANGO_URLS" > $(DJANGO_URLS_FILE)
-	-$(GIT_ADD) $(DJANGO_URLS_FILE)
-
-.PHONY: django-urls-show-default
-django-urls-show-default:
-	python manage.py show_urls
-
-.PHONY: django-user-default
-django-user-default:
-	python manage.py shell -c "from django.contrib.auth.models import User; \
-        User.objects.create_user('user', '', 'user')"
-
-.PHONY: django-utils-default
-django-utils-default:
-	@echo "$$DJANGO_UTILS" > backend/utils.py
-	-$(GIT_ADD) backend/utils.py
-
-.PHONY: docker-build-default
-docker-build-default:
-	podman build -t $(PROJECT_NAME) .
-
-.PHONY: docker-compose-default
-docker-compose-default:
-	podman compose up
-
-.PHONY: docker-list-default
-docker-list-default:
-	podman container list --all
-	podman images --all
-
-.PHONY: docker-run-default
-docker-run-default:
-	podman run $(PROJECT_NAME)
-
-.PHONY: docker-serve-default
-docker-serve-default:
-	podman run -p 8000:8000 $(PROJECT_NAME)
-
-.PHONY: docker-shell-default
-docker-shell-default:
-	podman run -it $(PROJECT_NAME) /bin/bash
-
-.PHONY: eb-check-env-default
-eb-check-env-default:  # https://stackoverflow.com/a/4731504/185820
-ifndef EB_SSH_KEY
-	$(error EB_SSH_KEY is undefined)
-endif
-ifndef VPC_ID
-	$(error VPC_ID is undefined)
-endif
-ifndef VPC_SG
-	$(error VPC_SG is undefined)
-endif
-ifndef VPC_SUBNET_EC2
-	$(error VPC_SUBNET_EC2 is undefined)
-endif
-ifndef VPC_SUBNET_ELB
-	$(error VPC_SUBNET_ELB is undefined)
-endif
-
-.PHONY: eb-create-default
-eb-create-default: aws-check-env eb-check-env
-	eb create $(EB_ENV_NAME) \
-         -im $(EC2_INSTANCE_MIN) \
-         -ix $(EC2_INSTANCE_MAX) \
-         -ip $(EC2_INSTANCE_PROFILE) \
-         -i $(EC2_INSTANCE_TYPE) \
-         -k $(EB_SSH_KEY) \
-         -p $(EB_PLATFORM) \
-         --elb-type $(EC2_LB_TYPE) \
-         --vpc \
-         --vpc.id $(VPC_ID) \
-         --vpc.elbpublic \
-         --vpc.publicip \
-         --vpc.ec2subnets $(VPC_SUBNET_EC2) \
-         --vpc.elbsubnets $(VPC_SUBNET_ELB) \
-         --vpc.securitygroups $(VPC_SG)
-
-.PHONY: eb-custom-env-default
-eb-custom-env-default:
-	$(ADD_DIR) .ebextensions
-	@echo "$$EB_CUSTOM_ENV_EC2_USER" > .ebextensions/bash.config
-	-$(GIT_ADD) .ebextensions/bash.config
-	$(ADD_DIR) .platform/hooks/postdeploy
-	@echo "$$EB_CUSTOM_ENV_VAR_FILE" > .platform/hooks/postdeploy/setenv.sh
-	-$(GIT_ADD) .platform/hooks/postdeploy/setenv.sh
-
-.PHONY: eb-deploy-default
-eb-deploy-default:
-	eb deploy
-
-.PHONY: eb-export-default
-eb-export-default:
-	@if [ ! -d $(EB_DIR_NAME) ]; then \
-        echo "Directory $(EB_DIR_NAME) does not exist"; \
-        else \
-        echo "Directory $(EB_DIR_NAME) does exist!"; \
-        eb ssh --quiet -c "export PGPASSWORD=$(DJANGO_DB_PASS); pg_dump -U $(DJANGO_DB_USER) -h $(DJANGO_DB_HOST) $(DJANGO_DB_NAME)" > $(DJANGO_DB_NAME).sql; \
-        echo "Wrote $(DJANGO_DB_NAME).sql"; \
-        fi
-
-.PHONY: eb-restart-default
-eb-restart-default:
-	eb ssh -c "systemctl restart web"
-
-.PHONY: eb-rebuild-default
-eb-rebuild-default:
-	aws elasticbeanstalk rebuild-environment --environment-name $(ENV_NAME)
-
-.PHONY: eb-upgrade-default
-eb-upgrade-default:
-	eb upgrade
-
-.PHONY: eb-init-default
-eb-init-default: aws-check-env-profile
-	eb init --profile=$(AWS_PROFILE)
-
-.PHONY: eb-list-default
-eb-list-platforms-default:
-	aws elasticbeanstalk list-platform-versions
-
-.PHONY: eb-list-databases-default
-eb-list-databases-default:
-	@eb ssh --quiet -c "export PGPASSWORD=$(DJANGO_DB_PASS); psql -l -U $(DJANGO_DB_USER) -h $(DJANGO_DB_HOST) $(DJANGO_DB_NAME)"
-
-.PHONY: eb-logs-default
-eb-logs-default:
-	eb logs
-
-.PHONY: eb-print-env-default
-eb-print-env-default:
-	eb printenv
-
-.PHONY: favicon-default
-favicon-init-default:
-	dd if=/dev/urandom bs=64 count=1 status=none | base64 | convert -size 16x16 -depth 8 -background none -fill white label:@- favicon.png
-	convert favicon.png favicon.ico
-	-$(GIT_ADD) favicon.ico
-	$(DEL_FILE) favicon.png
-
-.PHONY: git-ignore-default
-git-ignore-default:
-	@echo "$$GIT_IGNORE" > .gitignore
-	-$(GIT_ADD) .gitignore
-
-.PHONY: git-branches-default
-git-branches-default:
-	-for i in $(GIT_BRANCHES) ; do \
-        -@$(GIT_CHECKOUT) -t $$i ; done
-
-.PHONY: git-commit-message-clean-default
-git-commit-message-clean-default:
-	-@$(GIT_COMMIT) -a -m "Clean"
-
-.PHONY: git-commit-message-default
-git-commit-message-default:
-	-@$(GIT_COMMIT) -a -m $(GIT_COMMIT_MSG)
-
-.PHONY: git-commit-message-empty-default
-git-commit-message-empty-default:
-	-@$(GIT_COMMIT) --allow-empty -m "Empty-Commit"
-
-.PHONY: git-commit-message-init-default
-git-commit-message-init-default:
-	-@$(GIT_COMMIT) -a -m "Init"
-
-.PHONY: git-commit-message-last-default
-git-commit-message-last-default:
-	git log -1 --pretty=%B > $(TMPDIR)/commit.txt
-	-$(GIT_COMMIT) -a -F $(TMPDIR)/commit.txt
-
-.PHONY: git-commit-message-lint-default
-git-commit-message-lint-default:
-	-@$(GIT_COMMIT) -a -m "Lint"
-
-.PHONY: git-commit-message-mk-default
-git-commit-message-mk-default:
-	-@$(GIT_COMMIT) project.mk -m "Add/update $(MAKEFILE_CUSTOM_FILE)"
-
-.PHONY: git-commit-message-rename-default
-git-commit-message-rename-default:
-	-@$(GIT_COMMIT) -a -m "Rename"
-
-.PHONY: git-commit-message-sort-default
-git-commit-message-sort-default:
-	-@$(GIT_COMMIT) -a -m "Sort"
-
-.PHONY: git-push-default
-git-push-default:
-	-@$(GIT_PUSH)
-
-.PHONY: git-push-force-default
-git-push-force-default:
-	-@$(GIT_PUSH_FORCE)
-
-.PHONY: git-commit-edit-default
-git-commit-edit-default:
-	-$(GIT_COMMIT) -a
-
-.PHONY: git-prune-default
-git-prune-default:
-	git remote update origin --prune
-
-.PHONY: git-set-upstream-default
-git-set-upstream-default:
-	git push --set-upstream origin main
-
-.PHONY: git-set-default-default
-git-set-default-default:
-	gh repo set-default
-
-.PHONY: git-short-default
-git-short-default:
-	@echo $(GIT_REV)
-
-.PHONY: help-default
-help-default:
-	@echo "Project Makefile 🤷"
-	@echo "Usage: make [options] [target] ..."
-	@echo "Examples:"
-	@echo "   make help                   Print this message"
-	@echo "   make list-defines  list all defines in the Makefile"
-	@echo "   make list-commands  list all targets in the Makefile"
-
-.PHONY: jenkins-init-default
-jenkins-init-default:
-	@echo "$$JENKINS_FILE" > Jenkinsfile
-
-.PHONY: makefile-list-commands-default
-makefile-list-commands-default:
-	@for makefile in $(MAKEFILE_LIST); do \
-        echo "Commands from $$makefile:"; \
-        $(MAKE) -pRrq -f $$makefile : 2>/dev/null | \
-        awk -v RS= -F: '/^# File/,/^# Finished Make data base/ { \
-            if ($$1 !~ "^[#.]") { sub(/-default$$/, "", $$1); print $$1 } }' | \
-        egrep -v -e '^[^[:alnum:]]' -e '^$@$$' | \
-        tr ' ' '\n' | \
-        sort | \
-        awk '{print $$0}' ; \
-        echo; \
-    	done | $(PAGER)
-
-.PHONY: makefile-list-defines-default
-makefile-list-defines-default:
-	@grep '^define [A-Za-z_][A-Za-z0-9_]*' Makefile
-
-.PHONY: makefile-list-exports-default
-makefile-list-exports-default:
-	@grep '^export [A-Z][A-Z_]*' Makefile
-
-.PHONY: makefile-list-targets-default
-makefile-list-targets-default:
-	@perl -ne 'print if /^\s*\.PHONY:/ .. /^[a-zA-Z0-9_-]+:/;' Makefile | grep -v .PHONY
-
-.PHONY: make-default
-make-default:
-	-$(GIT_ADD) Makefile
-	-$(GIT_COMMIT) Makefile -m "Add/update project-makefile files"
-	-git push
-
-.PHONY: npm-init-default
-npm-init-default:
-	npm init -y
-	-$(GIT_ADD) package.json
-	-$(GIT_ADD) package-lock.json
-
-.PHONY: npm-build-default
-npm-build-default:
-	npm run build
-
-.PHONY: npm-install-default
-npm-install-default:
-	npm install
-	-$(GIT_ADD) package-lock.json
-
-.PHONY: npm-install-django-default
-npm-install-django-default:
-	npm install \
-        @fortawesome/fontawesome-free \
-        @fortawesome/fontawesome-svg-core \
-        @fortawesome/free-brands-svg-icons \
-        @fortawesome/free-solid-svg-icons \
-        @fortawesome/react-fontawesome \
-        	bootstrap \
-        camelize \
-        date-fns \
-        history \
-        mapbox-gl \
-        query-string \
-        react-animate-height \
-        react-chartjs-2 \
-        react-copy-to-clipboard \
-        react-date-range \
-        react-dom \
-        react-dropzone \
-        react-hook-form \
-        react-image-crop \
-        react-map-gl \
-        react-modal \
-        react-resize-detector \
-        react-select \
-        react-swipeable \
-        snakeize \
-        striptags \
-        url-join \
-        viewport-mercator-project
-
-.PHONY: npm-install-django-dev-default
-npm-install-django-dev-default:
-	npm install \
-        eslint-plugin-react \
-        eslint-config-standard \
-        eslint-config-standard-jsx \
-        @babel/core \
-        @babel/preset-env \
-        @babel/preset-react \
-        --save-dev
-
-.PHONY: npm-serve-default
-npm-serve-default:
-	npm run start
-
-.PHONY: npm-test-default
-npm-test-default:
-	npm run test
-
-.PHONY: pip-deps-default
-pip-deps-default:
-	$(PIP_ENSURE)
-	python -m pip install pipdeptree
-	python -m pipdeptree
-	pipdeptree
-
-.PHONY: pip-freeze-default
-pip-freeze-default:
-	$(PIP_ENSURE)
-	python -m pip freeze | sort > $(TMPDIR)/requirements.txt
-	mv -f $(TMPDIR)/requirements.txt .
-	-$(GIT_ADD) requirements.txt
-
-.PHONY: pip-init-default
-pip-init-default:
-	touch requirements.txt
-	-$(GIT_ADD) requirements.txt
-
-.PHONY: pip-init-test-default
-pip-init-test-default:
-	@echo "$$PIP_INSTALL_REQUIREMENTS_TEST" > requirements-test.txt
-	-$(GIT_ADD) requirements-test.txt
-
-.PHONY: pip-install-default
-pip-install-default:
-	$(PIP_ENSURE)
-	$(MAKE) pip-upgrade
-	python -m pip install wheel
-	python -m pip install -r requirements.txt
-
-.PHONY: pip-install-dev-default
-pip-install-dev-default:
-	$(PIP_ENSURE)
-	python -m pip install -r requirements-dev.txt
-
-.PHONY: pip-install-test-default
-pip-install-test-default:
-	$(PIP_ENSURE)
-	python -m pip install -r requirements-test.txt
-
-.PHONY: pip-install-upgrade-default
-pip-install-upgrade-default:
-	cat requirements.txt | awk -F\= '{print $$1}' > $(TMPDIR)/requirements.txt
-	mv -f $(TMPDIR)/requirements.txt .
-	$(PIP_ENSURE)
-	python -m pip install -U -r requirements.txt
-	python -m pip freeze | sort > $(TMPDIR)/requirements.txt
-	mv -f $(TMPDIR)/requirements.txt .
-
-.PHONY: pip-upgrade-default
-pip-upgrade-default:
-	$(PIP_ENSURE)
-	python -m pip install -U pip
-
-.PHONY: pip-uninstall-default
-pip-uninstall-default:
-	$(PIP_ENSURE)
-	python -m pip freeze | xargs python -m pip uninstall -y
-
-.PHONY: plone-clean-default
-plone-clean-default:
-	$(DEL_DIR) $(PROJECT_NAME)
-	$(DEL_DIR) $(PACKAGE_NAME)
-
-.PHONY: plone-init-default
-plone-init-default: git-ignore plone-install plone-instance plone-serve
-
-.PHONY: plone-install-default
-plone-install-default:
-	$(PIP_ENSURE)
-	python -m pip install plone -c $(PIP_INSTALL_PLONE_CONSTRAINTS)
-
-.PHONY: plone-instance-default
-plone-instance-default:
-	mkwsgiinstance -d backend -u admin:admin
-	cat backend/etc/zope.ini | sed -e 's/host = 127.0.0.1/host = 0.0.0.0/; s/port = 8080/port = 8000/' > $(TMPDIR)/zope.ini
-	mv -f $(TMPDIR)/zope.ini backend/etc/zope.ini
-	-$(GIT_ADD) backend/etc/site.zcml
-	-$(GIT_ADD) backend/etc/zope.conf
-	-$(GIT_ADD) backend/etc/zope.ini
-
-.PHONY: plone-serve-default
-plone-serve-default:
-	runwsgi backend/etc/zope.ini
-
-.PHONY: plone-build-default
-plone-build-default:
-	buildout
-
-.PHONY: programming-interview-default
-programming-interview-default:
-	@echo "$$PROGRAMMING_INTERVIEW" > interview.py
-	@echo "Created interview.py!"
-	-@$(GIT_ADD) interview.py > /dev/null 2>&1
-
-# .NOT_PHONY!
-$(MAKEFILE_CUSTOM_FILE):
-	@echo "$$MAKEFILE_CUSTOM" > $(MAKEFILE_CUSTOM_FILE)
-	-$(GIT_ADD) $(MAKEFILE_CUSTOM_FILE)
-
-.PHONY: python-license-default
-python-license-default:
-	@echo "$(PYTHON_LICENSE_TXT)" > LICENSE.txt
-	-$(GIT_ADD) LICENSE.txt
-
-.PHONY: python-project-default
-python-project-default:
-	@echo "$(PYTHON_PROJECT_TOML)" > pyproject.toml
-	-$(GIT_ADD) pyproject.toml
-
-.PHONY: python-serve-default
-python-serve-default:
-	@echo "\n\tServing HTTP on http://0.0.0.0:8000\n"
-	python3 -m http.server
-
-.PHONY: python-sdist-default
-python-sdist-default:
-	$(PIP_ENSURE)
-	python setup.py sdist --format=zip
-
-.PHONY: python-webpack-init-default
-python-webpack-init-default:
-	python manage.py webpack_init --no-input
-
-.PHONY: python-ci-default
-python-ci-default:
-	$(ADD_DIR) .github/workflows
-	@echo "$(PYTHON_CI_YAML)" > .github/workflows/build_wheels.yml
-	-$(GIT_ADD) .github/workflows/build_wheels.yml
-
-.PHONY: rand-default
-rand-default:
-	@openssl rand -base64 12 | sed 's/\///g'
-
-.PHONY: readme-init-default
-readme-init-default:
-	@echo "# $(PROJECT_NAME)" > README.md
-	-$(GIT_ADD) README.md
-
-.PHONY: readme-edit-default
-readme-edit-default:
-	$(EDITOR) README.md
-
-.PHONY: reveal-init-default
-reveal-init-default: webpack-init-reveal
-	npm install \
-	css-loader \
-	mini-css-extract-plugin \
-	reveal.js \
-	style-loader
-	jq '.scripts += {"build": "webpack"}' package.json > \
-	$(TMPDIR)/tmp.json && mv $(TMPDIR)/tmp.json package.json
-	jq '.scripts += {"start": "webpack serve --mode development --port 8000 --static"}' package.json > \
-	$(TMPDIR)/tmp.json && mv $(TMPDIR)/tmp.json package.json
-	jq '.scripts += {"watch": "webpack watch --mode development"}' package.json > \
-	$(TMPDIR)/tmp.json && mv $(TMPDIR)/tmp.json package.json
-
-.PHONY: reveal-serve-default
-reveal-serve-default:
-	npm run watch &
-	python -m http.server
-
-.PHONY: review-default
-review-default:
-ifeq ($(UNAME), Darwin)
-	$(EDITOR_REVIEW) `find backend/ -name \*.py` `find backend/ -name \*.html` `find frontend/ -name \*.js` `find frontend/ -name \*.js`
-else
-	@echo "Unsupported"
-endif
-
-.PHONY: separator-default
-separator-default:
-	@echo "$$SEPARATOR"
-
-.PHONY: sphinx-init-default
-sphinx-init-default: sphinx-install
-	sphinx-quickstart -q -p $(PROJECT_NAME) -a $(USER) -v 0.0.1 $(RANDIR)
-	$(COPY_DIR) $(RANDIR)/* .
-	$(DEL_DIR) $(RANDIR)
-	-$(GIT_ADD) index.rst
-	-$(GIT_ADD) conf.py
-	$(DEL_FILE) make.bat
-	-@$(GIT_CHECKOUT) Makefile
-	$(MAKE) git-ignore
-
-.PHONY: sphinx-theme-init-default
-sphinx-theme-init-default:
-	export DJANGO_FRONTEND_THEME_NAME=$(PROJECT_NAME)_theme; \
-	$(ADD_DIR) $$DJANGO_FRONTEND_THEME_NAME ; \
-	$(ADD_FILE) $$DJANGO_FRONTEND_THEME_NAME/__init__.py ; \
-	-$(GIT_ADD) $$DJANGO_FRONTEND_THEME_NAME/__init__.py ; \
-	$(ADD_FILE) $$DJANGO_FRONTEND_THEME_NAME/theme.conf ; \
-	-$(GIT_ADD) $$DJANGO_FRONTEND_THEME_NAME/theme.conf ; \
-	$(ADD_FILE) $$DJANGO_FRONTEND_THEME_NAME/layout.html ; \
-	-$(GIT_ADD) $$DJANGO_FRONTEND_THEME_NAME/layout.html ; \
-	$(ADD_DIR) $$DJANGO_FRONTEND_THEME_NAME/static/css ; \
-	$(ADD_FILE) $$DJANGO_FRONTEND_THEME_NAME/static/css/style.css ; \
-	$(ADD_DIR) $$DJANGO_FRONTEND_THEME_NAME/static/js ; \
-	$(ADD_FILE) $$DJANGO_FRONTEND_THEME_NAME/static/js/script.js ; \
-	-$(GIT_ADD) $$DJANGO_FRONTEND_THEME_NAME/static
-
-.PHONY: sphinx-install-default
-sphinx-install-default:
-	echo "Sphinx\n" > requirements.txt
-	@$(MAKE) pip-install
-	@$(MAKE) pip-freeze
-	-$(GIT_ADD) requirements.txt
-
-.PHONY: sphinx-build-default
-sphinx-build-default:
-	sphinx-build -b html -d _build/doctrees . _build/html
-	sphinx-build -b rinoh . _build/rinoh
-
-.PHONY: sphinx-serve-default
-sphinx-serve-default:
-	cd _build/html;python3 -m http.server
-
-.PHONY: wagtail-base-template-default
-wagtail-base-template-default:
-	@echo "$$WAGTAIL_BASE_TEMPLATE" > backend/templates/base.html
-
-.PHONY: wagtail-clean-default
-wagtail-clean-default:
-	-@for dir in $(shell echo "$(WAGTAIL_CLEAN_DIRS)"); do \
-		echo "Cleaning $$dir"; \
-		$(DEL_DIR) $$dir >/dev/null 2>&1; \
-	done
-	-@for file in $(shell echo "$(WAGTAIL_CLEAN_FILES)"); do \
-		echo "Cleaning $$file"; \
-		$(DEL_FILE) $$file >/dev/null 2>&1; \
-	done
-
-.PHONY: wagtail-contactpage-default
-wagtail-contactpage-default:
-	python manage.py startapp contactpage
-	@echo "$$WAGTAIL_CONTACT_PAGE_MODEL" > contactpage/models.py
-	@echo "$$WAGTAIL_CONTACT_PAGE_TEST" > contactpage/tests.py
-	$(ADD_DIR) contactpage/templates/contactpage/
-	@echo "$$WAGTAIL_CONTACT_PAGE_TEMPLATE" > contactpage/templates/contactpage/contact_page.html
-	@echo "$$WAGTAIL_CONTACT_PAGE_LANDING" > contactpage/templates/contactpage/contact_page_landing.html
-	@echo "INSTALLED_APPS.append('contactpage')" >> $(DJANGO_SETTINGS_BASE_FILE)
-	python manage.py makemigrations contactpage
-	-$(GIT_ADD) contactpage/templates
-	-$(GIT_ADD) contactpage/*.py
-	-$(GIT_ADD) contactpage/migrations/*.py
-
-.PHONY: wagtail-header-prefix-template-default
-wagtail-header-prefix-template-default:
-	@echo "$$WAGTAIL_HEADER_PREFIX" > backend/templates/header.html
-
-.PHONY: wagtail-home-default
-wagtail-home-default:
-	@echo "$$WAGTAIL_HOME_PAGE_MODEL" > home/models.py
-	@echo "$$WAGTAIL_HOME_PAGE_TEMPLATE" > home/templates/home/home_page.html
-	$(ADD_DIR) home/templates/blocks
-	@echo "$$WAGTAIL_BLOCK_MARKETING" > home/templates/blocks/marketing_block.html
-	@echo "$$WAGTAIL_BLOCK_CAROUSEL" > home/templates/blocks/carousel_block.html
-	-$(GIT_ADD) home/templates
-	-$(GIT_ADD) home/*.py
-	python manage.py makemigrations home
-	-$(GIT_ADD) home/migrations/*.py
-
-.PHONY: wagtail-install-default
-wagtail-install-default:
-	$(PIP_ENSURE)
-	python -m pip install \
-        wagtail \
-        wagtailmenus \
-        wagtail-color-panel \
-        wagtail-django-recaptcha \
-        wagtail-markdown \
-        wagtail-modeladmin \
-        wagtail-seo \
-        weasyprint \
-        whitenoise \
-        xhtml2pdf
-
-.PHONY: wagtail-private-default
-wagtail-privacy-default:
-	python manage.py startapp privacy
-	@echo "$$WAGTAIL_PRIVACY_PAGE_MODEL" > privacy/models.py
-	$(ADD_DIR) privacy/templates
-	@echo "$$WAGTAIL_PRIVACY_PAGE_TEMPLATE" > privacy/templates/privacy_page.html
-	@echo "INSTALLED_APPS.append('privacy')" >> $(DJANGO_SETTINGS_BASE_FILE)
-	python manage.py makemigrations privacy
-	-$(GIT_ADD) privacy/templates
-	-$(GIT_ADD) privacy/*.py
-	-$(GIT_ADD) privacy/migrations/*.py
-
-.PHONY: wagtail-project-default
-wagtail-project-default:
-	wagtail start backend .
-	$(DEL_FILE) home/templates/home/welcome_page.html
-	-$(GIT_ADD) backend/
-	-$(GIT_ADD) .dockerignore
-	-$(GIT_ADD) Dockerfile
-	-$(GIT_ADD) manage.py
-	-$(GIT_ADD) requirements.txt
-
-.PHONY: wagtail-search-default
-wagtail-search-default:
-	@echo "$$WAGTAIL_SEARCH_TEMPLATE" > search/templates/search/search.html
-	@echo "$$WAGTAIL_SEARCH_URLS" > search/urls.py
-	-$(GIT_ADD) search/templates
-	-$(GIT_ADD) search/*.py
-
-.PHONY: wagtail-settings-default
-wagtail-settings-default:
-	@echo "$$WAGTAIL_SETTINGS" >> $(DJANGO_SETTINGS_BASE_FILE)
-
-.PHONY: wagtail-sitepage-default
-wagtail-sitepage-default:
-	python manage.py startapp sitepage
-	@echo "$$WAGTAIL_SITEPAGE_MODEL" > sitepage/models.py
-	$(ADD_DIR) sitepage/templates/sitepage/
-	@echo "$$WAGTAIL_SITEPAGE_TEMPLATE" > sitepage/templates/sitepage/site_page.html
-	@echo "INSTALLED_APPS.append('sitepage')" >> $(DJANGO_SETTINGS_BASE_FILE)
-	python manage.py makemigrations sitepage
-	-$(GIT_ADD) sitepage/templates
-	-$(GIT_ADD) sitepage/*.py
-	-$(GIT_ADD) sitepage/migrations/*.py
-
-.PHONY: wagtail-urls-default
-wagtail-urls-default:
-	@echo "$$WAGTAIL_URLS" > $(DJANGO_URLS_FILE)
-
-.PHONY: wagtail-urls-home-default
-wagtail-urls-home-default:
-	@echo "$$WAGTAIL_URLS_HOME" >> $(DJANGO_URLS_FILE)
-
-.PHONY: webpack-init-default
-webpack-init-default: npm-init
-	@echo "$$WEBPACK_CONFIG_JS" > webpack.config.js
-	-$(GIT_ADD) webpack.config.js
-	npm install --save-dev webpack webpack-cli webpack-dev-server
-	$(ADD_DIR) src/
-	@echo "$$WEBPACK_INDEX_JS" > src/index.js
-	-$(GIT_ADD) src/index.js
-	@echo "$$WEBPACK_INDEX_HTML" > index.html
-	-$(GIT_ADD) index.html
-	$(MAKE) git-ignore
-
-.PHONY: webpack-init-reveal-default
-webpack-init-reveal-default: npm-init
-	@echo "$$WEBPACK_REVEAL_CONFIG_JS" > webpack.config.js
-	-$(GIT_ADD) webpack.config.js
-	npm install --save-dev webpack webpack-cli webpack-dev-server
-	$(ADD_DIR) src/
-	@echo "$$WEBPACK_REVEAL_INDEX_JS" > src/index.js
-	-$(GIT_ADD) src/index.js
-	@echo "$$WEBPACK_REVEAL_INDEX_HTML" > index.html
-	-$(GIT_ADD) index.html
-	$(MAKE) git-ignore
-
-# --------------------------------------------------------------------------------
-# Single-line phony target rules
-# --------------------------------------------------------------------------------
-
-.PHONY: aws-check-env-default
-aws-check-env-default: aws-check-env-profile aws-check-env-region
-
-.PHONY: ce-default
-ce-default: git-commit-edit git-push
-
-.PHONY: clean-default
-clean-default: wagtail-clean
-
-.PHONY: cp-default
-cp-default: git-commit-message git-push
-
-.PHONY: db-dump-default
-db-dump-default: eb-export
-
-.PHONY: dbshell-default
-dbshell-default: django-db-shell
-
-.PHONY: deploy-default
-deploy-default: eb-deploy
-
-.PHONY: d-default
-d-default: eb-deploy
-
-.PHONY: deps-default
-deps-default: pip-deps
-
-.PHONY: e-default
-e-default: edit
-
-.PHONY: edit-default
-edit-default: readme-edit
-
-.PHONY: empty-default
-empty-default: git-commit-message-empty git-push
-
-.PHONY: fp-default
-fp-default: git-push-force
-
-.PHONY: freeze-default
-freeze-default: pip-freeze git-push
-
-.PHONY: git-commit-default
-git-commit-default: git-commit-message git-push
-
-.PHONY: git-commit-clean-default
-git-commit-clean-default: git-commit-message-clean git-push
-
-.PHONY: git-commit-init-default
-git-commit-init-default: git-commit-message-init git-push
-
-.PHONY: git-commit-lint-default
-git-commit-lint-default: git-commit-message-lint git-push
-
-.PHONY: gitignore-default
-gitignore-default: git-ignore
-
-.PHONY: h-default
-h-default: help
-
-.PHONY: init-default
-init-default: django-init-wagtail django-serve
-
-.PHONY: init-wagtail-default
-init-wagtail-default: django-init-wagtail
-
-.PHONY: install-default
-install-default: pip-install
-
-.PHONY: l-default
-l-default: makefile-list-commands
-
-.PHONY: last-default
-last-default: git-commit-message-last git-push
-
-.PHONY: lint-default
-lint-default: django-lint
-
-.PHONY: list-commands-default
-list-commands-default: makefile-list-commands
-
-.PHONY: list-defines-default
-list-defines-default: makefile-list-defines
-
-.PHONY: list-exports-default
-list-exports-default: makefile-list-exports
-
-.PHONY: list-targets-default
-list-targets-default: makefile-list-targets
-
-.PHONY: migrate-default
-migrate-default: django-migrate
-
-.PHONY: migrations-default
-migrations-default: django-migrations-make
-
-.PHONY: migrations-show-default
-migrations-show-default: django-migrations-show
-
-.PHONY: mk-default
-mk-default: project.mk git-commit-message-mk git-push
-
-.PHONY: open-default
-open-default: django-open
-
-.PHONY: o-default
-o-default: django-open
-
-.PHONY: readme-default
-readme-default: readme-init
-
-.PHONY: rename-default
-rename-default: git-commit-message-rename git-push
-
-.PHONY: s-default
-s-default: django-serve
-
-.PHONY: shell-default
-shell-default: django-shell
-
-.PHONY: serve-default
-serve-default: django-serve
-
-.PHONY: static-default
-static-default: django-static
-
-.PHONY: sort-default
-sort-default: git-commit-message-sort git-push
-
-.PHONY: su-default
-su-default: django-su
-
-.PHONY: test-default
-test-default: django-test
-
-.PHONY: t-default
-t-default: django-test
-
-.PHONY: u-default
-u-default: help
-
-.PHONY: urls-default
-urls-default: django-urls-show
-
-# --------------------------------------------------------------------------------
-# Allow customizing rules defined in this Makefile with rules defined in
-# $(MAKEFILE_CUSTOM_FILE)
-# --------------------------------------------------------------------------------
-
-%: %-default  # https://stackoverflow.com/a/49804748
-	@ true
+.DEFAULT_GOAL := help
+
+.PHONY: clean
+clean:
+	rm src/PIL/*.so || true
+	rm -r build || true
+	find . -name __pycache__ | xargs rm -r || true
+
+.PHONY: coverage
+coverage:
+	python3 -c "import pytest" > /dev/null 2>&1 || python3 -m pip install pytest
+	python3 -m pytest -qq
+	rm -r htmlcov || true
+	python3 -c "import coverage" > /dev/null 2>&1 || python3 -m pip install coverage
+	python3 -m coverage report
+
+.PHONY: doc
+.PHONY: html
+doc html:
+	python3 -c "import PIL" > /dev/null 2>&1 || python3 -m pip install .
+	$(MAKE) -C docs html
+
+.PHONY: htmlview
+htmlview:
+	python3 -c "import PIL" > /dev/null 2>&1 || python3 -m pip install .
+	$(MAKE) -C docs htmlview
+
+.PHONY: doccheck
+doccheck:
+	$(MAKE) doc
+# Don't make our tests rely on the links in the docs being up every single build.
+# We don't control them.  But do check, and update them to the target of their redirects.
+	$(MAKE) -C docs linkcheck || true
+
+.PHONY: docserve
+docserve:
+	cd docs/_build/html && python3 -m http.server 2> /dev/null&
+
+.PHONY: help
+help:
+	@echo "Welcome to Pillow development. Please use \`make <target>\` where <target> is one of"
+	@echo "  clean              remove build products"
+	@echo "  coverage           run coverage test (in progress)"
+	@echo "  doc                make HTML docs"
+	@echo "  docserve           run an HTTP server on the docs directory"
+	@echo "  html               make HTML docs"
+	@echo "  htmlview           open the index page built by the html target in your browser"
+	@echo "  install            make and install"
+	@echo "  install-coverage   make and install with C coverage"
+	@echo "  lint               run the lint checks"
+	@echo "  lint-fix           run Ruff to (mostly) fix lint issues"
+	@echo "  release-test       run code and package tests before release"
+	@echo "  test               run tests on installed Pillow"
+
+.PHONY: install
+install:
+	python3 -m pip -v install .
+	python3 selftest.py
+
+.PHONY: install-coverage
+install-coverage:
+	CFLAGS="-coverage -Werror=implicit-function-declaration" python3 -m pip -v install .
+	python3 selftest.py
+
+.PHONY: debug
+debug:
+# make a debug version if we don't have a -dbg python. Leaves in symbols
+# for our stuff, kills optimization, and redirects to dev null so we
+# see any build failures.
+	make clean > /dev/null
+	CFLAGS='-g -O0' python3 -m pip -v install . > /dev/null
+
+.PHONY: release-test
+release-test:
+	python3 Tests/check_release_notes.py
+	python3 -m pip install -e .[tests]
+	python3 selftest.py
+	python3 -m pytest Tests
+	python3 -m pip install .
+	python3 -m pytest -qq
+	python3 -m check_manifest
+	python3 -m pyroma .
+	$(MAKE) readme
+
+.PHONY: sdist
+sdist:
+	python3 -m build --help > /dev/null 2>&1 || python3 -m pip install build
+	python3 -m build --sdist
+	python3 -m twine --help > /dev/null 2>&1 || python3 -m pip install twine
+	python3 -m twine check --strict dist/*
+
+.PHONY: test
+test:
+	python3 -c "import pytest" > /dev/null 2>&1 || python3 -m pip install pytest
+	python3 -m pytest -qq
+
+.PHONY: valgrind
+valgrind:
+	python3 -c "import pytest_valgrind" > /dev/null 2>&1 || python3 -m pip install pytest-valgrind
+	PYTHONMALLOC=malloc valgrind --suppressions=Tests/oss-fuzz/python.supp --leak-check=no \
+            --log-file=/tmp/valgrind-output \
+            python3 -m pytest --no-memcheck -vv --valgrind --valgrind-log=/tmp/valgrind-output
+
+.PHONY: readme
+readme:
+	python3 -c "import markdown2" > /dev/null 2>&1 || python3 -m pip install markdown2
+	python3 -m markdown2 README.md > .long-description.html && open .long-description.html
+
+
+.PHONY: lint
+lint:
+	python3 -c "import tox" > /dev/null 2>&1 || python3 -m pip install tox
+	python3 -m tox -e lint
+
+.PHONY: lint-fix
+lint-fix:
+	python3 -c "import black" > /dev/null 2>&1 || python3 -m pip install black
+	python3 -m black .
+	python3 -c "import ruff" > /dev/null 2>&1 || python3 -m pip install ruff
+	python3 -m ruff --fix .
+
+.PHONY: mypy
+mypy:
+	python3 -c "import tox" > /dev/null 2>&1 || python3 -m pip install tox
+	python3 -m tox -e mypy

From d49ea378115f4ae32e12f1f0c3e6146ebdc68fe0 Mon Sep 17 00:00:00 2001
From: Andrew Murray <radarhere@users.noreply.github.com>
Date: Thu, 22 Aug 2024 17:50:42 +1000
Subject: [PATCH 0952/1178] Include limit in error message

---
 Tests/test_file_webp.py | 4 +++-
 src/_webp.c             | 6 ++++--
 2 files changed, 7 insertions(+), 3 deletions(-)

diff --git a/Tests/test_file_webp.py b/Tests/test_file_webp.py
index ad08da364c0..a86757e644f 100644
--- a/Tests/test_file_webp.py
+++ b/Tests/test_file_webp.py
@@ -163,7 +163,9 @@ def test_write_encoding_error_bad_dimension(self, tmp_path: Path) -> None:
         im = Image.new("L", (16384, 16384))
         with pytest.raises(ValueError) as e:
             im.save(temp_file)
-        assert str(e.value) == "encoding error 5: Image size exceeds WebP limit"
+        assert (
+            str(e.value) == "encoding error 5: Image size exceeds WebP limit of 16383"
+        )
 
     def test_WebPEncode_with_invalid_args(self) -> None:
         """
diff --git a/src/_webp.c b/src/_webp.c
index 0d2d6f023f8..c0e1a6f6364 100644
--- a/src/_webp.c
+++ b/src/_webp.c
@@ -673,9 +673,11 @@ WebPEncode_wrapper(PyObject *self, PyObject *args) {
     WebPPictureFree(&pic);
     if (!ok) {
         int error_code = (&pic)->error_code;
-        const char *message = "";
+        char message[50] = "";
         if (error_code == VP8_ENC_ERROR_BAD_DIMENSION) {
-            message = ": Image size exceeds WebP limit";
+            sprintf(
+                message, ": Image size exceeds WebP limit of %d", WEBP_MAX_DIMENSION
+            );
         }
         PyErr_Format(PyExc_ValueError, "encoding error %d%s", error_code, message);
         return NULL;

From fed916825290cb1f45610017993c82ccca2b7843 Mon Sep 17 00:00:00 2001
From: Andrew Murray <radarhere@users.noreply.github.com>
Date: Fri, 23 Aug 2024 18:48:28 +1000
Subject: [PATCH 0953/1178] Catch defusedxml warnings

---
 Tests/test_file_webp_metadata.py | 10 +++++++++-
 Tests/test_image.py              | 10 +++++++++-
 2 files changed, 18 insertions(+), 2 deletions(-)

diff --git a/Tests/test_file_webp_metadata.py b/Tests/test_file_webp_metadata.py
index 4ef3d95f259..d9a834c7500 100644
--- a/Tests/test_file_webp_metadata.py
+++ b/Tests/test_file_webp_metadata.py
@@ -116,7 +116,15 @@ def test_read_no_exif() -> None:
 def test_getxmp() -> None:
     with Image.open("Tests/images/flower.webp") as im:
         assert "xmp" not in im.info
-        assert im.getxmp() == {}
+        if ElementTree is None:
+            with pytest.warns(
+                UserWarning,
+                match="XMP data cannot be read without defusedxml dependency",
+            ):
+                xmp = im.getxmp()
+        else:
+            xmp = im.getxmp()
+        assert xmp == {}
 
     with Image.open("Tests/images/flower2.webp") as im:
         if ElementTree is None:
diff --git a/Tests/test_image.py b/Tests/test_image.py
index 719732d127b..b1ecc6184a3 100644
--- a/Tests/test_image.py
+++ b/Tests/test_image.py
@@ -938,7 +938,15 @@ def test_exif_hide_offsets(self) -> None:
 
     def test_empty_xmp(self) -> None:
         with Image.open("Tests/images/hopper.gif") as im:
-            assert im.getxmp() == {}
+            if ElementTree is None:
+                with pytest.warns(
+                    UserWarning,
+                    match="XMP data cannot be read without defusedxml dependency",
+                ):
+                    xmp = im.getxmp()
+            else:
+                xmp = im.getxmp()
+            assert xmp == {}
 
     def test_getxmp_padded(self) -> None:
         im = Image.new("RGB", (1, 1))

From e382ebed3ad757567ce8522c41a6c704c68c16a1 Mon Sep 17 00:00:00 2001
From: Andrew Murray <radarhere@users.noreply.github.com>
Date: Fri, 23 Aug 2024 19:38:07 +1000
Subject: [PATCH 0954/1178] Remove warning if NumPy failed to raise an error
 during conversion

---
 Tests/test_image_array.py |  2 +-
 src/PIL/Image.py          | 24 ++++++------------------
 2 files changed, 7 insertions(+), 19 deletions(-)

diff --git a/Tests/test_image_array.py b/Tests/test_image_array.py
index bb606488286..38425a51588 100644
--- a/Tests/test_image_array.py
+++ b/Tests/test_image_array.py
@@ -47,7 +47,7 @@ def test_with_dtype(dtype: npt.DTypeLike) -> None:
             with pytest.raises(OSError):
                 numpy.array(im_truncated)
         else:
-            with pytest.warns(UserWarning):
+            with pytest.warns(DeprecationWarning):
                 numpy.array(im_truncated)
 
 
diff --git a/src/PIL/Image.py b/src/PIL/Image.py
index a6eefff56fc..2f1a878c182 100644
--- a/src/PIL/Image.py
+++ b/src/PIL/Image.py
@@ -724,24 +724,12 @@ def _repr_jpeg_(self) -> bytes | None:
     def __array_interface__(self) -> dict[str, str | bytes | int | tuple[int, ...]]:
         # numpy array interface support
         new: dict[str, str | bytes | int | tuple[int, ...]] = {"version": 3}
-        try:
-            if self.mode == "1":
-                # Binary images need to be extended from bits to bytes
-                # See: https://github.com/python-pillow/Pillow/issues/350
-                new["data"] = self.tobytes("raw", "L")
-            else:
-                new["data"] = self.tobytes()
-        except Exception as e:
-            if not isinstance(e, (MemoryError, RecursionError)):
-                try:
-                    import numpy
-                    from packaging.version import parse as parse_version
-                except ImportError:
-                    pass
-                else:
-                    if parse_version(numpy.__version__) < parse_version("1.23"):
-                        warnings.warn(str(e))
-            raise
+        if self.mode == "1":
+            # Binary images need to be extended from bits to bytes
+            # See: https://github.com/python-pillow/Pillow/issues/350
+            new["data"] = self.tobytes("raw", "L")
+        else:
+            new["data"] = self.tobytes()
         new["shape"], new["typestr"] = _conv_type_shape(self)
         return new
 

From 6e9518b88de595c56a955a20a7359ff93a7e9668 Mon Sep 17 00:00:00 2001
From: Andrew Murray <radarhere@users.noreply.github.com>
Date: Sat, 24 Aug 2024 19:18:25 +1000
Subject: [PATCH 0955/1178] Added type hint to example code

---
 src/PIL/Image.py | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/src/PIL/Image.py b/src/PIL/Image.py
index ffc6bec342a..37d8cb33517 100644
--- a/src/PIL/Image.py
+++ b/src/PIL/Image.py
@@ -1917,7 +1917,7 @@ def point(
            object::
 
                class Example(Image.ImagePointHandler):
-                 def point(self, data):
+                 def point(self, im: Image) -> Image:
                    # Return result
         :param mode: Output mode (default is same as input). This can only be used if
            the source image has mode "L" or "P", and the output has mode "1" or the

From 8aa58e320fd2dde581325c63d1673d6a2e3648f4 Mon Sep 17 00:00:00 2001
From: Andrew Murray <radarhere@users.noreply.github.com>
Date: Sat, 24 Aug 2024 21:25:41 +1000
Subject: [PATCH 0956/1178] Rename _E to ImagePointTransform

---
 docs/reference/Image.rst |  2 +-
 src/PIL/Image.py         | 48 ++++++++++++++++++++++++----------------
 2 files changed, 30 insertions(+), 20 deletions(-)

diff --git a/docs/reference/Image.rst b/docs/reference/Image.rst
index 02e714f20b8..bc3758218db 100644
--- a/docs/reference/Image.rst
+++ b/docs/reference/Image.rst
@@ -362,8 +362,8 @@ Classes
     :undoc-members:
     :show-inheritance:
 .. autoclass:: PIL.Image.ImagePointHandler
+.. autoclass:: PIL.Image.ImagePointTransform
 .. autoclass:: PIL.Image.ImageTransformHandler
-.. autoclass:: PIL.Image._E
 
 Protocols
 ---------
diff --git a/src/PIL/Image.py b/src/PIL/Image.py
index 37d8cb33517..5aa49b619c4 100644
--- a/src/PIL/Image.py
+++ b/src/PIL/Image.py
@@ -470,43 +470,53 @@ def _getencoder(
 # Simple expression analyzer
 
 
-class _E:
+class ImagePointTransform:
+    """
+    Used with :py:meth:`~PIL.Image.Image.point` for single band images with more than
+    8 bits, this represents an affine transformation, where the value is multiplied by
+    ``scale`` and ``offset`` is added.
+    """
+
     def __init__(self, scale: float, offset: float) -> None:
         self.scale = scale
         self.offset = offset
 
-    def __neg__(self) -> _E:
-        return _E(-self.scale, -self.offset)
+    def __neg__(self) -> ImagePointTransform:
+        return ImagePointTransform(-self.scale, -self.offset)
 
-    def __add__(self, other: _E | float) -> _E:
-        if isinstance(other, _E):
-            return _E(self.scale + other.scale, self.offset + other.offset)
-        return _E(self.scale, self.offset + other)
+    def __add__(self, other: ImagePointTransform | float) -> ImagePointTransform:
+        if isinstance(other, ImagePointTransform):
+            return ImagePointTransform(
+                self.scale + other.scale, self.offset + other.offset
+            )
+        return ImagePointTransform(self.scale, self.offset + other)
 
     __radd__ = __add__
 
-    def __sub__(self, other: _E | float) -> _E:
+    def __sub__(self, other: ImagePointTransform | float) -> ImagePointTransform:
         return self + -other
 
-    def __rsub__(self, other: _E | float) -> _E:
+    def __rsub__(self, other: ImagePointTransform | float) -> ImagePointTransform:
         return other + -self
 
-    def __mul__(self, other: _E | float) -> _E:
-        if isinstance(other, _E):
+    def __mul__(self, other: ImagePointTransform | float) -> ImagePointTransform:
+        if isinstance(other, ImagePointTransform):
             return NotImplemented
-        return _E(self.scale * other, self.offset * other)
+        return ImagePointTransform(self.scale * other, self.offset * other)
 
     __rmul__ = __mul__
 
-    def __truediv__(self, other: _E | float) -> _E:
-        if isinstance(other, _E):
+    def __truediv__(self, other: ImagePointTransform | float) -> ImagePointTransform:
+        if isinstance(other, ImagePointTransform):
             return NotImplemented
-        return _E(self.scale / other, self.offset / other)
+        return ImagePointTransform(self.scale / other, self.offset / other)
 
 
-def _getscaleoffset(expr: Callable[[_E], _E | float]) -> tuple[float, float]:
-    a = expr(_E(1, 0))
-    return (a.scale, a.offset) if isinstance(a, _E) else (0, a)
+def _getscaleoffset(
+    expr: Callable[[ImagePointTransform], ImagePointTransform | float]
+) -> tuple[float, float]:
+    a = expr(ImagePointTransform(1, 0))
+    return (a.scale, a.offset) if isinstance(a, ImagePointTransform) else (0, a)
 
 
 # --------------------------------------------------------------------
@@ -1898,7 +1908,7 @@ def point(
             Sequence[float]
             | NumpyArray
             | Callable[[int], float]
-            | Callable[[_E], _E | float]
+            | Callable[[ImagePointTransform], ImagePointTransform | float]
             | ImagePointHandler
         ),
         mode: str | None = None,

From 658b60e3a33d6bf4e3ff3a2053cb73faa466772d Mon Sep 17 00:00:00 2001
From: Andrew Murray <3112309+radarhere@users.noreply.github.com>
Date: Sat, 24 Aug 2024 21:26:56 +1000
Subject: [PATCH 0957/1178] Include units

Co-authored-by: Hugo van Kemenade <1324225+hugovk@users.noreply.github.com>
---
 Tests/test_file_webp.py | 2 +-
 src/_webp.c             | 2 +-
 2 files changed, 2 insertions(+), 2 deletions(-)

diff --git a/Tests/test_file_webp.py b/Tests/test_file_webp.py
index a86757e644f..4a048f2c2d9 100644
--- a/Tests/test_file_webp.py
+++ b/Tests/test_file_webp.py
@@ -164,7 +164,7 @@ def test_write_encoding_error_bad_dimension(self, tmp_path: Path) -> None:
         with pytest.raises(ValueError) as e:
             im.save(temp_file)
         assert (
-            str(e.value) == "encoding error 5: Image size exceeds WebP limit of 16383"
+            str(e.value) == "encoding error 5: Image size exceeds WebP limit of 16383 pixels"
         )
 
     def test_WebPEncode_with_invalid_args(self) -> None:
diff --git a/src/_webp.c b/src/_webp.c
index c0e1a6f6364..b4cf9c32937 100644
--- a/src/_webp.c
+++ b/src/_webp.c
@@ -676,7 +676,7 @@ WebPEncode_wrapper(PyObject *self, PyObject *args) {
         char message[50] = "";
         if (error_code == VP8_ENC_ERROR_BAD_DIMENSION) {
             sprintf(
-                message, ": Image size exceeds WebP limit of %d", WEBP_MAX_DIMENSION
+                message, ": Image size exceeds WebP limit of %d pixels", WEBP_MAX_DIMENSION
             );
         }
         PyErr_Format(PyExc_ValueError, "encoding error %d%s", error_code, message);

From a3e3639a59ffaf33430b08b089da1eedf04286ab Mon Sep 17 00:00:00 2001
From: "pre-commit-ci[bot]"
 <66853113+pre-commit-ci[bot]@users.noreply.github.com>
Date: Sat, 24 Aug 2024 11:27:40 +0000
Subject: [PATCH 0958/1178] [pre-commit.ci] auto fixes from pre-commit.com
 hooks

for more information, see https://pre-commit.ci
---
 Tests/test_file_webp.py | 3 ++-
 src/_webp.c             | 4 +++-
 2 files changed, 5 insertions(+), 2 deletions(-)

diff --git a/Tests/test_file_webp.py b/Tests/test_file_webp.py
index 4a048f2c2d9..247fc60217b 100644
--- a/Tests/test_file_webp.py
+++ b/Tests/test_file_webp.py
@@ -164,7 +164,8 @@ def test_write_encoding_error_bad_dimension(self, tmp_path: Path) -> None:
         with pytest.raises(ValueError) as e:
             im.save(temp_file)
         assert (
-            str(e.value) == "encoding error 5: Image size exceeds WebP limit of 16383 pixels"
+            str(e.value)
+            == "encoding error 5: Image size exceeds WebP limit of 16383 pixels"
         )
 
     def test_WebPEncode_with_invalid_args(self) -> None:
diff --git a/src/_webp.c b/src/_webp.c
index b4cf9c32937..f59ad30367b 100644
--- a/src/_webp.c
+++ b/src/_webp.c
@@ -676,7 +676,9 @@ WebPEncode_wrapper(PyObject *self, PyObject *args) {
         char message[50] = "";
         if (error_code == VP8_ENC_ERROR_BAD_DIMENSION) {
             sprintf(
-                message, ": Image size exceeds WebP limit of %d pixels", WEBP_MAX_DIMENSION
+                message,
+                ": Image size exceeds WebP limit of %d pixels",
+                WEBP_MAX_DIMENSION
             );
         }
         PyErr_Format(PyExc_ValueError, "encoding error %d%s", error_code, message);

From cfb093af39cf01fc631845d941e0bfda0bb4a52f Mon Sep 17 00:00:00 2001
From: Andrew Murray <radarhere@users.noreply.github.com>
Date: Sat, 24 Aug 2024 23:15:35 +1000
Subject: [PATCH 0959/1178] Update CHANGES.rst [ci skip]

---
 CHANGES.rst | 6 ++++++
 1 file changed, 6 insertions(+)

diff --git a/CHANGES.rst b/CHANGES.rst
index a7edc340cb6..9da76d82a12 100644
--- a/CHANGES.rst
+++ b/CHANGES.rst
@@ -5,6 +5,12 @@ Changelog (Pillow)
 11.0.0 (unreleased)
 -------------------
 
+- Updated error message when saving WebP with invalid width or height #8322
+  [radarhere, hugovk]
+
+- Remove warning if NumPy failed to raise an error during conversion #8326
+  [radarhere]
+
 - If left and right sides meet in ImageDraw.rounded_rectangle(), do not draw rectangle to fill gap #8304
   [radarhere]
 

From 53bbfea7637e5cc16d074a205784d0408f13de6e Mon Sep 17 00:00:00 2001
From: Andrew Murray <radarhere@users.noreply.github.com>
Date: Mon, 26 Aug 2024 23:49:03 +1000
Subject: [PATCH 0960/1178] Added type hints

---
 Tests/test_qt_image_qapplication.py | 42 +++++++++++++++-------
 Tests/test_qt_image_toqimage.py     |  2 +-
 pyproject.toml                      |  1 -
 src/PIL/EpsImagePlugin.py           |  2 +-
 src/PIL/Image.py                    | 10 +++---
 src/PIL/ImageQt.py                  | 54 +++++++++++++++++------------
 6 files changed, 67 insertions(+), 44 deletions(-)

diff --git a/Tests/test_qt_image_qapplication.py b/Tests/test_qt_image_qapplication.py
index 28f66891c0d..0ed9fbfa5cb 100644
--- a/Tests/test_qt_image_qapplication.py
+++ b/Tests/test_qt_image_qapplication.py
@@ -1,6 +1,7 @@
 from __future__ import annotations
 
 from pathlib import Path
+from typing import TYPE_CHECKING, Union
 
 import pytest
 
@@ -8,6 +9,20 @@
 
 from .helper import assert_image_equal_tofile, assert_image_similar, hopper
 
+if TYPE_CHECKING:
+    import PyQt6
+    import PySide6
+
+    QApplication = Union[PyQt6.QtWidgets.QApplication, PySide6.QtWidgets.QApplication]
+    QHBoxLayout = Union[PyQt6.QtWidgets.QHBoxLayout, PySide6.QtWidgets.QHBoxLayout]
+    QImage = Union[PyQt6.QtGui.QImage, PySide6.QtGui.QImage]
+    QLabel = Union[PyQt6.QtWidgets.QLabel, PySide6.QtWidgets.QLabel]
+    QPainter = Union[PyQt6.QtGui.QPainter, PySide6.QtGui.QPainter]
+    QPixmap = Union[PyQt6.QtGui.QPixmap, PySide6.QtGui.QPixmap]
+    QPoint = Union[PyQt6.QtCore.QPoint, PySide6.QtCore.QPoint]
+    QRegion = Union[PyQt6.QtGui.QRegion, PySide6.QtGui.QRegion]
+    QWidget = Union[PyQt6.QtWidgets.QWidget, PySide6.QtWidgets.QWidget]
+
 if ImageQt.qt_is_installed:
     from PIL.ImageQt import QPixmap
 
@@ -20,7 +35,7 @@
         from PySide6.QtGui import QImage, QPainter, QRegion
         from PySide6.QtWidgets import QApplication, QHBoxLayout, QLabel, QWidget
 
-    class Example(QWidget):
+    class Example(QWidget):  # type: ignore[misc]
         def __init__(self) -> None:
             super().__init__()
 
@@ -28,11 +43,12 @@ def __init__(self) -> None:
 
             qimage = ImageQt.ImageQt(img)
 
-            pixmap1 = ImageQt.QPixmap.fromImage(qimage)
+            pixmap1 = getattr(ImageQt.QPixmap, "fromImage")(qimage)
 
-            QHBoxLayout(self)  # hbox
+            # hbox
+            QHBoxLayout(self)  # type: ignore[operator]
 
-            lbl = QLabel(self)
+            lbl = QLabel(self)  # type: ignore[operator]
             # Segfault in the problem
             lbl.setPixmap(pixmap1.copy())
 
@@ -46,7 +62,7 @@ def roundtrip(expected: Image.Image) -> None:
 @pytest.mark.skipif(not ImageQt.qt_is_installed, reason="Qt bindings are not installed")
 def test_sanity(tmp_path: Path) -> None:
     # Segfault test
-    app: QApplication | None = QApplication([])
+    app: QApplication | None = QApplication([])  # type: ignore[operator]
     ex = Example()
     assert app  # Silence warning
     assert ex  # Silence warning
@@ -56,7 +72,7 @@ def test_sanity(tmp_path: Path) -> None:
         im = hopper(mode)
         data = ImageQt.toqpixmap(im)
 
-        assert isinstance(data, QPixmap)
+        assert data.__class__.__name__ == "QPixmap"
         assert not data.isNull()
 
         # Test saving the file
@@ -64,14 +80,14 @@ def test_sanity(tmp_path: Path) -> None:
         data.save(tempfile)
 
         # Render the image
-        qimage = ImageQt.ImageQt(im)
-        data = QPixmap.fromImage(qimage)
-        qt_format = QImage.Format if ImageQt.qt_version == "6" else QImage
-        qimage = QImage(128, 128, qt_format.Format_ARGB32)
-        painter = QPainter(qimage)
-        image_label = QLabel()
+        imageqt = ImageQt.ImageQt(im)
+        data = getattr(QPixmap, "fromImage")(imageqt)
+        qt_format = getattr(QImage, "Format") if ImageQt.qt_version == "6" else QImage
+        qimage = QImage(128, 128, getattr(qt_format, "Format_ARGB32"))  # type: ignore[operator]
+        painter = QPainter(qimage)  # type: ignore[operator]
+        image_label = QLabel()  # type: ignore[operator]
         image_label.setPixmap(data)
-        image_label.render(painter, QPoint(0, 0), QRegion(0, 0, 128, 128))
+        image_label.render(painter, QPoint(0, 0), QRegion(0, 0, 128, 128))  # type: ignore[operator]
         painter.end()
         rendered_tempfile = str(tmp_path / f"temp_rendered_{mode}.png")
         qimage.save(rendered_tempfile)
diff --git a/Tests/test_qt_image_toqimage.py b/Tests/test_qt_image_toqimage.py
index 6110be707f5..8cb7ffb9b40 100644
--- a/Tests/test_qt_image_toqimage.py
+++ b/Tests/test_qt_image_toqimage.py
@@ -21,7 +21,7 @@ def test_sanity(mode: str, tmp_path: Path) -> None:
     src = hopper(mode)
     data = ImageQt.toqimage(src)
 
-    assert isinstance(data, QImage)
+    assert isinstance(data, QImage)  # type: ignore[arg-type, misc]
     assert not data.isNull()
 
     # reload directly from the qimage
diff --git a/pyproject.toml b/pyproject.toml
index 9e53d4bfe34..e4ae73acf52 100644
--- a/pyproject.toml
+++ b/pyproject.toml
@@ -166,5 +166,4 @@ warn_unused_ignores = true
 exclude = [
   '^Tests/oss-fuzz/fuzz_font.py$',
   '^Tests/oss-fuzz/fuzz_pillow.py$',
-  '^Tests/test_qt_image_qapplication.py$',
 ]
diff --git a/src/PIL/EpsImagePlugin.py b/src/PIL/EpsImagePlugin.py
index 4da0cd230e2..d830ad53fd1 100644
--- a/src/PIL/EpsImagePlugin.py
+++ b/src/PIL/EpsImagePlugin.py
@@ -71,7 +71,7 @@ def Ghostscript(
     fp: IO[bytes],
     scale: int = 1,
     transparency: bool = False,
-) -> Image.Image:
+) -> Image.core.ImagingCore:
     """Render an image using Ghostscript"""
     global gs_binary
     if not has_ghostscript():
diff --git a/src/PIL/Image.py b/src/PIL/Image.py
index fbeecef0e6a..0877f779219 100644
--- a/src/PIL/Image.py
+++ b/src/PIL/Image.py
@@ -223,7 +223,7 @@ class Quantize(IntEnum):
 
     from IPython.lib.pretty import PrettyPrinter
 
-    from . import ImageFile, ImageFilter, ImagePalette, TiffImagePlugin
+    from . import ImageFile, ImageFilter, ImagePalette, ImageQt, TiffImagePlugin
     from ._typing import NumpyArray, StrOrBytesPath, TypeGuard
 ID: list[str] = []
 OPEN: dict[
@@ -2978,7 +2978,7 @@ def effect_spread(self, distance: int) -> Image:
         self.load()
         return self._new(self.im.effect_spread(distance))
 
-    def toqimage(self):
+    def toqimage(self) -> ImageQt.ImageQt:
         """Returns a QImage copy of this image"""
         from . import ImageQt
 
@@ -2987,7 +2987,7 @@ def toqimage(self):
             raise ImportError(msg)
         return ImageQt.toqimage(self)
 
-    def toqpixmap(self):
+    def toqpixmap(self) -> ImageQt.QPixmap:
         """Returns a QPixmap copy of this image"""
         from . import ImageQt
 
@@ -3314,7 +3314,7 @@ def fromarray(obj: SupportsArrayInterface, mode: str | None = None) -> Image:
     return frombuffer(mode, size, obj, "raw", rawmode, 0, 1)
 
 
-def fromqimage(im) -> ImageFile.ImageFile:
+def fromqimage(im: ImageQt.QImage) -> ImageFile.ImageFile:
     """Creates an image instance from a QImage image"""
     from . import ImageQt
 
@@ -3324,7 +3324,7 @@ def fromqimage(im) -> ImageFile.ImageFile:
     return ImageQt.fromqimage(im)
 
 
-def fromqpixmap(im) -> ImageFile.ImageFile:
+def fromqpixmap(im: ImageQt.QPixmap) -> ImageFile.ImageFile:
     """Creates an image instance from a QPixmap image"""
     from . import ImageQt
 
diff --git a/src/PIL/ImageQt.py b/src/PIL/ImageQt.py
index a2d94671414..a3d647138df 100644
--- a/src/PIL/ImageQt.py
+++ b/src/PIL/ImageQt.py
@@ -19,14 +19,23 @@
 
 import sys
 from io import BytesIO
-from typing import TYPE_CHECKING, Callable
+from typing import TYPE_CHECKING, Any, Callable, Union
 
 from . import Image
 from ._util import is_path
 
 if TYPE_CHECKING:
+    import PyQt6
+    import PySide6
+
     from . import ImageFile
 
+    QBuffer: type
+    QByteArray = Union[PyQt6.QtCore.QByteArray, PySide6.QtCore.QByteArray]
+    QIODevice = Union[PyQt6.QtCore.QIODevice, PySide6.QtCore.QIODevice]
+    QImage = Union[PyQt6.QtGui.QImage, PySide6.QtGui.QImage]
+    QPixmap = Union[PyQt6.QtGui.QPixmap, PySide6.QtGui.QPixmap]
+
 qt_version: str | None
 qt_versions = [
     ["6", "PyQt6"],
@@ -37,10 +46,6 @@
 qt_versions.sort(key=lambda version: version[1] in sys.modules, reverse=True)
 for version, qt_module in qt_versions:
     try:
-        QBuffer: type
-        QIODevice: type
-        QImage: type
-        QPixmap: type
         qRgba: Callable[[int, int, int, int], int]
         if qt_module == "PyQt6":
             from PyQt6.QtCore import QBuffer, QIODevice
@@ -65,19 +70,20 @@ def rgb(r: int, g: int, b: int, a: int = 255) -> int:
     return qRgba(r, g, b, a) & 0xFFFFFFFF
 
 
-def fromqimage(im):
+def fromqimage(im: QImage | QPixmap) -> ImageFile.ImageFile:
     """
     :param im: QImage or PIL ImageQt object
     """
     buffer = QBuffer()
+    qt_openmode: object
     if qt_version == "6":
         try:
-            qt_openmode = QIODevice.OpenModeFlag
+            qt_openmode = getattr(QIODevice, "OpenModeFlag")
         except AttributeError:
-            qt_openmode = QIODevice.OpenMode
+            qt_openmode = getattr(QIODevice, "OpenMode")
     else:
         qt_openmode = QIODevice
-    buffer.open(qt_openmode.ReadWrite)
+    buffer.open(getattr(qt_openmode, "ReadWrite"))
     # preserve alpha channel with png
     # otherwise ppm is more friendly with Image.open
     if im.hasAlphaChannel():
@@ -93,7 +99,7 @@ def fromqimage(im):
     return Image.open(b)
 
 
-def fromqpixmap(im) -> ImageFile.ImageFile:
+def fromqpixmap(im: QPixmap) -> ImageFile.ImageFile:
     return fromqimage(im)
 
 
@@ -123,7 +129,7 @@ def align8to32(bytes: bytes, width: int, mode: str) -> bytes:
     return b"".join(new_data)
 
 
-def _toqclass_helper(im):
+def _toqclass_helper(im: Image.Image | str | QByteArray) -> dict[str, Any]:
     data = None
     colortable = None
     exclusive_fp = False
@@ -135,30 +141,32 @@ def _toqclass_helper(im):
     if is_path(im):
         im = Image.open(im)
         exclusive_fp = True
+    assert isinstance(im, Image.Image)
 
-    qt_format = QImage.Format if qt_version == "6" else QImage
+    qt_format = getattr(QImage, "Format") if qt_version == "6" else QImage
     if im.mode == "1":
-        format = qt_format.Format_Mono
+        format = getattr(qt_format, "Format_Mono")
     elif im.mode == "L":
-        format = qt_format.Format_Indexed8
+        format = getattr(qt_format, "Format_Indexed8")
         colortable = [rgb(i, i, i) for i in range(256)]
     elif im.mode == "P":
-        format = qt_format.Format_Indexed8
+        format = getattr(qt_format, "Format_Indexed8")
         palette = im.getpalette()
+        assert palette is not None
         colortable = [rgb(*palette[i : i + 3]) for i in range(0, len(palette), 3)]
     elif im.mode == "RGB":
         # Populate the 4th channel with 255
         im = im.convert("RGBA")
 
         data = im.tobytes("raw", "BGRA")
-        format = qt_format.Format_RGB32
+        format = getattr(qt_format, "Format_RGB32")
     elif im.mode == "RGBA":
         data = im.tobytes("raw", "BGRA")
-        format = qt_format.Format_ARGB32
+        format = getattr(qt_format, "Format_ARGB32")
     elif im.mode == "I;16":
         im = im.point(lambda i: i * 256)
 
-        format = qt_format.Format_Grayscale16
+        format = getattr(qt_format, "Format_Grayscale16")
     else:
         if exclusive_fp:
             im.close()
@@ -174,8 +182,8 @@ def _toqclass_helper(im):
 
 if qt_is_installed:
 
-    class ImageQt(QImage):
-        def __init__(self, im) -> None:
+    class ImageQt(QImage):  # type: ignore[misc]
+        def __init__(self, im: Image.Image | str | QByteArray) -> None:
             """
             An PIL image wrapper for Qt.  This is a subclass of PyQt's QImage
             class.
@@ -199,10 +207,10 @@ def __init__(self, im) -> None:
                 self.setColorTable(im_data["colortable"])
 
 
-def toqimage(im) -> ImageQt:
+def toqimage(im: Image.Image | str | QByteArray) -> ImageQt:
     return ImageQt(im)
 
 
-def toqpixmap(im):
+def toqpixmap(im: Image.Image | str | QByteArray) -> QPixmap:
     qimage = toqimage(im)
-    return QPixmap.fromImage(qimage)
+    return getattr(QPixmap, "fromImage")(qimage)

From 65172db28db0cc965c026512546857540b0c6e20 Mon Sep 17 00:00:00 2001
From: Andrew Murray <radarhere@users.noreply.github.com>
Date: Tue, 27 Aug 2024 19:04:46 +1000
Subject: [PATCH 0961/1178] Corrected Ghostscript path

---
 .github/workflows/test-windows.yml | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/.github/workflows/test-windows.yml b/.github/workflows/test-windows.yml
index 5b34d6703af..2943bbe3138 100644
--- a/.github/workflows/test-windows.yml
+++ b/.github/workflows/test-windows.yml
@@ -87,7 +87,7 @@ jobs:
         echo "C:\Program Files\NASM" >> $env:GITHUB_PATH
 
         choco install ghostscript --version=10.3.1 --no-progress
-        echo "C:\Program Files\gs\gs10.00.0\bin" >> $env:GITHUB_PATH
+        echo "C:\Program Files\gs\gs10.03.1\bin" >> $env:GITHUB_PATH
 
         # Install extra test images
         xcopy /S /Y Tests\test-images\* Tests\images

From ae59ea4899e05146188230ddcbd11ca2e51511d5 Mon Sep 17 00:00:00 2001
From: "renovate[bot]" <29139614+renovate[bot]@users.noreply.github.com>
Date: Wed, 28 Aug 2024 00:52:05 +0000
Subject: [PATCH 0962/1178] Update dependency mypy to v1.11.2

---
 .ci/requirements-mypy.txt | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/.ci/requirements-mypy.txt b/.ci/requirements-mypy.txt
index 47fc6439994..5b09ef64c9c 100644
--- a/.ci/requirements-mypy.txt
+++ b/.ci/requirements-mypy.txt
@@ -1,4 +1,4 @@
-mypy==1.11.1
+mypy==1.11.2
 IceSpringPySideStubs-PyQt6
 IceSpringPySideStubs-PySide6
 ipython

From bdc53f6c4d499c918cc8d050ed163b8b9a178fe3 Mon Sep 17 00:00:00 2001
From: Andrew Murray <radarhere@users.noreply.github.com>
Date: Wed, 28 Aug 2024 18:33:43 +1000
Subject: [PATCH 0963/1178] Expand C image to match GIF frame image size

---
 Tests/images/test_extents_transparency.gif | Bin 0 -> 415 bytes
 Tests/test_file_gif.py                     |  37 ++++++++++++++++-----
 src/PIL/GifImagePlugin.py                  |  18 ++++++++++
 3 files changed, 47 insertions(+), 8 deletions(-)
 create mode 100644 Tests/images/test_extents_transparency.gif

diff --git a/Tests/images/test_extents_transparency.gif b/Tests/images/test_extents_transparency.gif
new file mode 100644
index 0000000000000000000000000000000000000000..739c82ad47c73560495e23c4b44bab5e1a88184f
GIT binary patch
literal 415
zcmZ?wbhEHbOkqf2Xk=jc&wv1mKUo+V7#JCJKtdpS29AXcj2to^8x|aF<`CA3Ik92k
z;dTLKuQ?tY7ai@EFwVMjV&mfD{R+-qGM<~3oSdu?yej78rlqH+8zi5a<GFd++1VDw
zukM`Oy!`xphh{EWuPrMsF7}wL6?<yS%FD|G7JJS0+PdoM>WIx*cTa6yeSLkx;VxP4
zZEJ3B&bYiP_Vl*3x3?EOJ~h{S`?|ZkD?Y!vdwTo&`}-T1x#fIzY<PIMLs&cROhkbL
QgF8X*7%><P9q(8J09oF=N&o-=

literal 0
HcmV?d00001

diff --git a/Tests/test_file_gif.py b/Tests/test_file_gif.py
index 8cefdb628e6..7c332149d62 100644
--- a/Tests/test_file_gif.py
+++ b/Tests/test_file_gif.py
@@ -1378,16 +1378,37 @@ def test_lzw_bits() -> None:
         im.load()
 
 
-def test_extents() -> None:
-    with Image.open("Tests/images/test_extents.gif") as im:
-        assert im.size == (100, 100)
+@pytest.mark.parametrize(
+    "test_file, loading_strategy",
+    (
+        ("test_extents.gif", GifImagePlugin.LoadingStrategy.RGB_AFTER_FIRST),
+        (
+            "test_extents.gif",
+            GifImagePlugin.LoadingStrategy.RGB_AFTER_DIFFERENT_PALETTE_ONLY,
+        ),
+        (
+            "test_extents_transparency.gif",
+            GifImagePlugin.LoadingStrategy.RGB_AFTER_FIRST,
+        ),
+    ),
+)
+def test_extents(test_file, loading_strategy) -> None:
+    GifImagePlugin.LOADING_STRATEGY = loading_strategy
+    try:
+        with Image.open("Tests/images/" + test_file) as im:
+            assert im.size == (100, 100)
 
-        # Check that n_frames does not change the size
-        assert im.n_frames == 2
-        assert im.size == (100, 100)
+            # Check that n_frames does not change the size
+            assert im.n_frames == 2
+            assert im.size == (100, 100)
 
-        im.seek(1)
-        assert im.size == (150, 150)
+            im.seek(1)
+            assert im.size == (150, 150)
+
+            im.load()
+            assert im.im.size == (150, 150)
+    finally:
+        GifImagePlugin.LOADING_STRATEGY = GifImagePlugin.LoadingStrategy.RGB_AFTER_FIRST
 
 
 def test_missing_background() -> None:
diff --git a/src/PIL/GifImagePlugin.py b/src/PIL/GifImagePlugin.py
index fa8137fb935..82f58905d2b 100644
--- a/src/PIL/GifImagePlugin.py
+++ b/src/PIL/GifImagePlugin.py
@@ -438,6 +438,13 @@ def load_prepare(self) -> None:
                 self.im.putpalette("RGB", *self._frame_palette.getdata())
             else:
                 self._im = None
+        if not self._prev_im and self._im is not None and self.size != self.im.size:
+            expanded_im = Image.core.fill(self.im.mode, self.size)
+            if self._frame_palette:
+                expanded_im.putpalette("RGB", *self._frame_palette.getdata())
+            expanded_im.paste(self.im, (0, 0) + self.im.size)
+
+            self.im = expanded_im
         self._mode = temp_mode
         self._frame_palette = None
 
@@ -455,6 +462,17 @@ def load_end(self) -> None:
             return
         if not self._prev_im:
             return
+        if self.size != self._prev_im.size:
+            if self._frame_transparency is not None:
+                expanded_im = Image.core.fill("RGBA", self.size)
+            else:
+                expanded_im = Image.core.fill("P", self.size)
+                expanded_im.putpalette("RGB", "RGB", self.im.getpalette())
+                expanded_im = expanded_im.convert("RGB")
+            expanded_im.paste(self._prev_im, (0, 0) + self._prev_im.size)
+
+            self._prev_im = expanded_im
+            assert self._prev_im is not None
         if self._frame_transparency is not None:
             self.im.putpalettealpha(self._frame_transparency, 0)
             frame_im = self.im.convert("RGBA")

From 0c335d239bb6f73a45795a8d814670f9ddc8aa45 Mon Sep 17 00:00:00 2001
From: Yay295 <Yay295@users.noreply.github.com>
Date: Mon, 22 Apr 2024 12:38:28 -0500
Subject: [PATCH 0964/1178] use (void) for empty function parameters

---
 src/libImaging/JpegDecode.c | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/src/libImaging/JpegDecode.c b/src/libImaging/JpegDecode.c
index 30c64f23559..2970f56d1af 100644
--- a/src/libImaging/JpegDecode.c
+++ b/src/libImaging/JpegDecode.c
@@ -48,7 +48,7 @@ char *libjpeg_turbo_version = NULL;
 #endif
 
 int
-ImagingJpegUseJCSExtensions() {
+ImagingJpegUseJCSExtensions(void) {
     int use_jcs_extensions = 0;
 #ifdef JCS_EXTENSIONS
 #if defined(LIBJPEG_TURBO_VERSION_NUMBER)

From d92603a0c6ea70d285847ece6fc800048d60646d Mon Sep 17 00:00:00 2001
From: Hugo van Kemenade <1324225+hugovk@users.noreply.github.com>
Date: Thu, 29 Aug 2024 10:58:53 +0300
Subject: [PATCH 0965/1178] Drop support for EOL PyPy3.9

---
 .ci/install.sh                     | 5 +----
 .github/workflows/test-windows.yml | 2 +-
 .github/workflows/test.yml         | 1 -
 .github/workflows/wheels.yml       | 2 --
 4 files changed, 2 insertions(+), 8 deletions(-)

diff --git a/.ci/install.sh b/.ci/install.sh
index b2d61586695..ee92d447a3e 100755
--- a/.ci/install.sh
+++ b/.ci/install.sh
@@ -53,10 +53,7 @@ if [[ $(uname) != CYGWIN* ]]; then
     fi
 
     # Pyroma uses non-isolated build and fails with old setuptools
-    if [[
-        $GHA_PYTHON_VERSION == pypy3.9
-        || $GHA_PYTHON_VERSION == 3.9
-    ]]; then
+    if [[ $GHA_PYTHON_VERSION == 3.9 ]]; then
         # To match pyproject.toml
         python3 -m pip install "setuptools>=67.8"
     fi
diff --git a/.github/workflows/test-windows.yml b/.github/workflows/test-windows.yml
index 2943bbe3138..f58e8dae3a6 100644
--- a/.github/workflows/test-windows.yml
+++ b/.github/workflows/test-windows.yml
@@ -35,7 +35,7 @@ jobs:
     strategy:
       fail-fast: false
       matrix:
-        python-version: ["pypy3.10", "pypy3.9", "3.9", "3.10", "3.11", "3.12", "3.13"]
+        python-version: ["pypy3.10", "3.9", "3.10", "3.11", "3.12", "3.13"]
 
     timeout-minutes: 30
 
diff --git a/.github/workflows/test.yml b/.github/workflows/test.yml
index 6e63333b0da..1b169db9170 100644
--- a/.github/workflows/test.yml
+++ b/.github/workflows/test.yml
@@ -42,7 +42,6 @@ jobs:
         ]
         python-version: [
           "pypy3.10",
-          "pypy3.9",
           "3.13",
           "3.12",
           "3.11",
diff --git a/.github/workflows/wheels.yml b/.github/workflows/wheels.yml
index 3ed1b5926cf..f3ed8399bd3 100644
--- a/.github/workflows/wheels.yml
+++ b/.github/workflows/wheels.yml
@@ -48,7 +48,6 @@ jobs:
       fail-fast: false
       matrix:
         python-version:
-          - pp39
           - pp310
           - cp3{9,10,11}
           - cp3{12,13}
@@ -57,7 +56,6 @@ jobs:
           - manylinux_2_28
           - musllinux
         exclude:
-          - { python-version: pp39, spec: musllinux }
           - { python-version: pp310, spec: musllinux }
 
     steps:

From d00f3656a684825569152ea1d6e74526ffa5d14b Mon Sep 17 00:00:00 2001
From: Andrew Murray <radarhere@users.noreply.github.com>
Date: Thu, 29 Aug 2024 22:51:15 +1000
Subject: [PATCH 0966/1178] Changed im.tile to never be None

---
 Tests/test_imagefile.py        | 24 +++++++++++++++++-------
 docs/example/DdsImagePlugin.py |  4 +++-
 src/PIL/BlpImagePlugin.py      |  7 +++++--
 src/PIL/BmpImagePlugin.py      |  2 +-
 src/PIL/CurImagePlugin.py      |  4 ++--
 src/PIL/DdsImagePlugin.py      |  2 +-
 src/PIL/FitsImagePlugin.py     |  2 +-
 src/PIL/FliImagePlugin.py      |  2 +-
 src/PIL/FpxImagePlugin.py      |  6 +++---
 src/PIL/FtexImagePlugin.py     |  4 ++--
 src/PIL/GdImageFile.py         |  2 +-
 src/PIL/GifImagePlugin.py      |  2 +-
 src/PIL/IcoImagePlugin.py      |  2 +-
 src/PIL/ImImagePlugin.py       | 22 ++++++++++++++++------
 src/PIL/Image.py               |  5 ++++-
 src/PIL/ImageFile.py           | 27 ++++++++++++++++++---------
 src/PIL/ImtImagePlugin.py      |  2 +-
 src/PIL/IptcImagePlugin.py     |  4 +++-
 src/PIL/Jpeg2KImagePlugin.py   |  5 +++--
 src/PIL/JpegImagePlugin.py     |  8 ++++++--
 src/PIL/McIdasImagePlugin.py   |  4 +++-
 src/PIL/MpoImagePlugin.py      |  5 ++++-
 src/PIL/MspImagePlugin.py      |  4 ++--
 src/PIL/PcdImagePlugin.py      |  2 +-
 src/PIL/PcxImagePlugin.py      |  4 +++-
 src/PIL/PixarImagePlugin.py    |  4 +++-
 src/PIL/PpmImagePlugin.py      |  4 +++-
 src/PIL/PsdImagePlugin.py      |  6 ++----
 src/PIL/QoiImagePlugin.py      |  2 +-
 src/PIL/SgiImagePlugin.py      | 15 ++++++++++++---
 src/PIL/SpiderImagePlugin.py   |  4 +++-
 src/PIL/SunImagePlugin.py      |  8 ++++++--
 src/PIL/TgaImagePlugin.py      |  4 ++--
 src/PIL/TiffImagePlugin.py     | 15 ++++++++-------
 src/PIL/WebPImagePlugin.py     |  2 +-
 src/PIL/XVThumbImagePlugin.py  |  6 +++++-
 src/PIL/XbmImagePlugin.py      |  2 +-
 src/PIL/XpmImagePlugin.py      |  4 +++-
 38 files changed, 153 insertions(+), 78 deletions(-)

diff --git a/Tests/test_imagefile.py b/Tests/test_imagefile.py
index a8bd798c12d..0985dce9cf1 100644
--- a/Tests/test_imagefile.py
+++ b/Tests/test_imagefile.py
@@ -238,7 +238,9 @@ def _open(self) -> None:
         self.rawmode = "RGBA"
         self._mode = "RGBA"
         self._size = (200, 200)
-        self.tile = [("MOCK", (xoff, yoff, xoff + xsize, yoff + ysize), 32, None)]
+        self.tile = [
+            ImageFile._Tile("MOCK", (xoff, yoff, xoff + xsize, yoff + ysize), 32, None)
+        ]
 
 
 class CodecsTest:
@@ -268,7 +270,7 @@ def test_extents_none(self) -> None:
         buf = BytesIO(b"\x00" * 255)
 
         im = MockImageFile(buf)
-        im.tile = [("MOCK", None, 32, None)]
+        im.tile = [ImageFile._Tile("MOCK", None, 32, None)]
 
         im.load()
 
@@ -281,12 +283,12 @@ def test_negsize(self) -> None:
         buf = BytesIO(b"\x00" * 255)
 
         im = MockImageFile(buf)
-        im.tile = [("MOCK", (xoff, yoff, -10, yoff + ysize), 32, None)]
+        im.tile = [ImageFile._Tile("MOCK", (xoff, yoff, -10, yoff + ysize), 32, None)]
 
         with pytest.raises(ValueError):
             im.load()
 
-        im.tile = [("MOCK", (xoff, yoff, xoff + xsize, -10), 32, None)]
+        im.tile = [ImageFile._Tile("MOCK", (xoff, yoff, xoff + xsize, -10), 32, None)]
         with pytest.raises(ValueError):
             im.load()
 
@@ -294,12 +296,20 @@ def test_oversize(self) -> None:
         buf = BytesIO(b"\x00" * 255)
 
         im = MockImageFile(buf)
-        im.tile = [("MOCK", (xoff, yoff, xoff + xsize + 100, yoff + ysize), 32, None)]
+        im.tile = [
+            ImageFile._Tile(
+                "MOCK", (xoff, yoff, xoff + xsize + 100, yoff + ysize), 32, None
+            )
+        ]
 
         with pytest.raises(ValueError):
             im.load()
 
-        im.tile = [("MOCK", (xoff, yoff, xoff + xsize, yoff + ysize + 100), 32, None)]
+        im.tile = [
+            ImageFile._Tile(
+                "MOCK", (xoff, yoff, xoff + xsize, yoff + ysize + 100), 32, None
+            )
+        ]
         with pytest.raises(ValueError):
             im.load()
 
@@ -336,7 +346,7 @@ def test_extents_none(self) -> None:
         buf = BytesIO(b"\x00" * 255)
 
         im = MockImageFile(buf)
-        im.tile = [("MOCK", None, 32, None)]
+        im.tile = [ImageFile._Tile("MOCK", None, 32, None)]
 
         fp = BytesIO()
         ImageFile._save(im, fp, [ImageFile._Tile("MOCK", None, 0, "RGB")])
diff --git a/docs/example/DdsImagePlugin.py b/docs/example/DdsImagePlugin.py
index caa852b1fe1..d8f53607697 100644
--- a/docs/example/DdsImagePlugin.py
+++ b/docs/example/DdsImagePlugin.py
@@ -246,7 +246,9 @@ def _open(self) -> None:
             msg = f"Unimplemented pixel format {repr(fourcc)}"
             raise NotImplementedError(msg)
 
-        self.tile = [(self.decoder, (0, 0) + self.size, 0, (self.mode, 0, 1))]
+        self.tile = [
+            ImageFile._Tile(self.decoder, (0, 0) + self.size, 0, (self.mode, 0, 1))
+        ]
 
     def load_seek(self, pos: int) -> None:
         pass
diff --git a/src/PIL/BlpImagePlugin.py b/src/PIL/BlpImagePlugin.py
index 1112276dc6e..8e29898dfc8 100644
--- a/src/PIL/BlpImagePlugin.py
+++ b/src/PIL/BlpImagePlugin.py
@@ -273,7 +273,7 @@ def _open(self) -> None:
             raise BLPFormatError(msg)
 
         self._mode = "RGBA" if self._blp_alpha_depth else "RGB"
-        self.tile = [(decoder, (0, 0) + self.size, 0, (self.mode, 0, 1))]
+        self.tile = [ImageFile._Tile(decoder, (0, 0) + self.size, 0, (self.mode, 0, 1))]
 
 
 class _BLPBaseDecoder(ImageFile.PyDecoder):
@@ -372,7 +372,10 @@ def _decode_jpeg_stream(self) -> None:
         Image._decompression_bomb_check(image.size)
         if image.mode == "CMYK":
             decoder_name, extents, offset, args = image.tile[0]
-            image.tile = [(decoder_name, extents, offset, (args[0], "CMYK"))]
+            assert isinstance(args, tuple)
+            image.tile = [
+                ImageFile._Tile(decoder_name, extents, offset, (args[0], "CMYK"))
+            ]
         r, g, b = image.convert("RGB").split()
         reversed_image = Image.merge("RGB", (b, g, r))
         self.set_as_raw(reversed_image.tobytes())
diff --git a/src/PIL/BmpImagePlugin.py b/src/PIL/BmpImagePlugin.py
index de441c6b5c2..e70856ffbc1 100644
--- a/src/PIL/BmpImagePlugin.py
+++ b/src/PIL/BmpImagePlugin.py
@@ -296,7 +296,7 @@ def _bitmap(self, header: int = 0, offset: int = 0) -> None:
             args.append(((file_info["width"] * file_info["bits"] + 31) >> 3) & (~3))
         args.append(file_info["direction"])
         self.tile = [
-            (
+            ImageFile._Tile(
                 decoder_name,
                 (0, 0, file_info["width"], file_info["height"]),
                 offset or self.fp.tell(),
diff --git a/src/PIL/CurImagePlugin.py b/src/PIL/CurImagePlugin.py
index 85e2145e766..c4be0cecaf8 100644
--- a/src/PIL/CurImagePlugin.py
+++ b/src/PIL/CurImagePlugin.py
@@ -17,7 +17,7 @@
 #
 from __future__ import annotations
 
-from . import BmpImagePlugin, Image
+from . import BmpImagePlugin, Image, ImageFile
 from ._binary import i16le as i16
 from ._binary import i32le as i32
 
@@ -64,7 +64,7 @@ def _open(self) -> None:
         # patch up the bitmap height
         self._size = self.size[0], self.size[1] // 2
         d, e, o, a = self.tile[0]
-        self.tile[0] = d, (0, 0) + self.size, o, a
+        self.tile[0] = ImageFile._Tile(d, (0, 0) + self.size, o, a)
 
 
 #
diff --git a/src/PIL/DdsImagePlugin.py b/src/PIL/DdsImagePlugin.py
index a57e4aea2d5..6315324701a 100644
--- a/src/PIL/DdsImagePlugin.py
+++ b/src/PIL/DdsImagePlugin.py
@@ -367,7 +367,7 @@ def _open(self) -> None:
                 mask_count = 3
 
             masks = struct.unpack(f"<{mask_count}I", header.read(mask_count * 4))
-            self.tile = [("dds_rgb", extents, 0, (bitcount, masks))]
+            self.tile = [ImageFile._Tile("dds_rgb", extents, 0, (bitcount, masks))]
             return
         elif pfflags & DDPF.LUMINANCE:
             if bitcount == 8:
diff --git a/src/PIL/FitsImagePlugin.py b/src/PIL/FitsImagePlugin.py
index 4846054b1e4..abacc5e67f2 100644
--- a/src/PIL/FitsImagePlugin.py
+++ b/src/PIL/FitsImagePlugin.py
@@ -67,7 +67,7 @@ def _open(self) -> None:
             raise ValueError(msg)
 
         offset += self.fp.tell() - 80
-        self.tile = [(decoder_name, (0, 0) + self.size, offset, args)]
+        self.tile = [ImageFile._Tile(decoder_name, (0, 0) + self.size, offset, args)]
 
     def _get_size(
         self, headers: dict[bytes, bytes], prefix: bytes
diff --git a/src/PIL/FliImagePlugin.py b/src/PIL/FliImagePlugin.py
index 52d1fce3167..666390be9ee 100644
--- a/src/PIL/FliImagePlugin.py
+++ b/src/PIL/FliImagePlugin.py
@@ -159,7 +159,7 @@ def _seek(self, frame: int) -> None:
         framesize = i32(s)
 
         self.decodermaxblock = framesize
-        self.tile = [("fli", (0, 0) + self.size, self.__offset, None)]
+        self.tile = [ImageFile._Tile("fli", (0, 0) + self.size, self.__offset, None)]
 
         self.__offset += framesize
 
diff --git a/src/PIL/FpxImagePlugin.py b/src/PIL/FpxImagePlugin.py
index 64d48635e8b..8fef51076b4 100644
--- a/src/PIL/FpxImagePlugin.py
+++ b/src/PIL/FpxImagePlugin.py
@@ -166,7 +166,7 @@ def _open_subimage(self, index: int = 1, subimage: int = 0) -> None:
 
             if compression == 0:
                 self.tile.append(
-                    (
+                    ImageFile._Tile(
                         "raw",
                         (x, y, x1, y1),
                         i32(s, i) + 28,
@@ -177,7 +177,7 @@ def _open_subimage(self, index: int = 1, subimage: int = 0) -> None:
             elif compression == 1:
                 # FIXME: the fill decoder is not implemented
                 self.tile.append(
-                    (
+                    ImageFile._Tile(
                         "fill",
                         (x, y, x1, y1),
                         i32(s, i) + 28,
@@ -205,7 +205,7 @@ def _open_subimage(self, index: int = 1, subimage: int = 0) -> None:
                     jpegmode = rawmode
 
                 self.tile.append(
-                    (
+                    ImageFile._Tile(
                         "jpeg",
                         (x, y, x1, y1),
                         i32(s, i) + 28,
diff --git a/src/PIL/FtexImagePlugin.py b/src/PIL/FtexImagePlugin.py
index 5acbb4912f7..ddb469bc332 100644
--- a/src/PIL/FtexImagePlugin.py
+++ b/src/PIL/FtexImagePlugin.py
@@ -93,9 +93,9 @@ def _open(self) -> None:
 
         if format == Format.DXT1:
             self._mode = "RGBA"
-            self.tile = [("bcn", (0, 0) + self.size, 0, 1)]
+            self.tile = [ImageFile._Tile("bcn", (0, 0) + self.size, 0, (1,))]
         elif format == Format.UNCOMPRESSED:
-            self.tile = [("raw", (0, 0) + self.size, 0, ("RGB", 0, 1))]
+            self.tile = [ImageFile._Tile("raw", (0, 0) + self.size, 0, ("RGB", 0, 1))]
         else:
             msg = f"Invalid texture compression format: {repr(format)}"
             raise ValueError(msg)
diff --git a/src/PIL/GdImageFile.py b/src/PIL/GdImageFile.py
index 88b87a22cd6..f1b4969f2c4 100644
--- a/src/PIL/GdImageFile.py
+++ b/src/PIL/GdImageFile.py
@@ -72,7 +72,7 @@ def _open(self) -> None:
         )
 
         self.tile = [
-            (
+            ImageFile._Tile(
                 "raw",
                 (0, 0) + self.size,
                 7 + true_color_offset + 4 + 256 * 4,
diff --git a/src/PIL/GifImagePlugin.py b/src/PIL/GifImagePlugin.py
index fa8137fb935..22539925fee 100644
--- a/src/PIL/GifImagePlugin.py
+++ b/src/PIL/GifImagePlugin.py
@@ -407,7 +407,7 @@ def _rgb(color: int) -> tuple[int, int, int]:
                 elif self.mode not in ("RGB", "RGBA"):
                     transparency = frame_transparency
             self.tile = [
-                (
+                ImageFile._Tile(
                     "gif",
                     (x0, y0, x1, y1),
                     self.__offset,
diff --git a/src/PIL/IcoImagePlugin.py b/src/PIL/IcoImagePlugin.py
index d0605b75a46..144fe0b6321 100644
--- a/src/PIL/IcoImagePlugin.py
+++ b/src/PIL/IcoImagePlugin.py
@@ -228,7 +228,7 @@ def frame(self, idx: int) -> Image.Image:
             # change tile dimension to only encompass XOR image
             im._size = (im.size[0], int(im.size[1] / 2))
             d, e, o, a = im.tile[0]
-            im.tile[0] = d, (0, 0) + im.size, o, a
+            im.tile[0] = ImageFile._Tile(d, (0, 0) + im.size, o, a)
 
             # figure out where AND mask image starts
             if header.bpp == 32:
diff --git a/src/PIL/ImImagePlugin.py b/src/PIL/ImImagePlugin.py
index b9416508987..f9f47348c66 100644
--- a/src/PIL/ImImagePlugin.py
+++ b/src/PIL/ImImagePlugin.py
@@ -253,7 +253,11 @@ def _open(self) -> None:
                 # use bit decoder (if necessary)
                 bits = int(self.rawmode[2:])
                 if bits not in [8, 16, 32]:
-                    self.tile = [("bit", (0, 0) + self.size, offs, (bits, 8, 3, 0, -1))]
+                    self.tile = [
+                        ImageFile._Tile(
+                            "bit", (0, 0) + self.size, offs, (bits, 8, 3, 0, -1)
+                        )
+                    ]
                     return
             except ValueError:
                 pass
@@ -263,13 +267,17 @@ def _open(self) -> None:
             # ever stumbled upon such a file ;-)
             size = self.size[0] * self.size[1]
             self.tile = [
-                ("raw", (0, 0) + self.size, offs, ("G", 0, -1)),
-                ("raw", (0, 0) + self.size, offs + size, ("R", 0, -1)),
-                ("raw", (0, 0) + self.size, offs + 2 * size, ("B", 0, -1)),
+                ImageFile._Tile("raw", (0, 0) + self.size, offs, ("G", 0, -1)),
+                ImageFile._Tile("raw", (0, 0) + self.size, offs + size, ("R", 0, -1)),
+                ImageFile._Tile(
+                    "raw", (0, 0) + self.size, offs + 2 * size, ("B", 0, -1)
+                ),
             ]
         else:
             # LabEye/IFUNC files
-            self.tile = [("raw", (0, 0) + self.size, offs, (self.rawmode, 0, -1))]
+            self.tile = [
+                ImageFile._Tile("raw", (0, 0) + self.size, offs, (self.rawmode, 0, -1))
+            ]
 
     @property
     def n_frames(self) -> int:
@@ -295,7 +303,9 @@ def seek(self, frame: int) -> None:
 
         self.fp = self._fp
 
-        self.tile = [("raw", (0, 0) + self.size, offs, (self.rawmode, 0, -1))]
+        self.tile = [
+            ImageFile._Tile("raw", (0, 0) + self.size, offs, (self.rawmode, 0, -1))
+        ]
 
     def tell(self) -> int:
         return self.frame
diff --git a/src/PIL/Image.py b/src/PIL/Image.py
index 95b4c64eef4..04f73870a29 100644
--- a/src/PIL/Image.py
+++ b/src/PIL/Image.py
@@ -3641,7 +3641,10 @@ def merge(mode: str, bands: Sequence[Image]) -> Image:
 
 def register_open(
     id: str,
-    factory: Callable[[IO[bytes], str | bytes], ImageFile.ImageFile],
+    factory: (
+        Callable[[IO[bytes], str | bytes], ImageFile.ImageFile]
+        | type[ImageFile.ImageFile]
+    ),
     accept: Callable[[bytes], bool | str] | None = None,
 ) -> None:
     """
diff --git a/src/PIL/ImageFile.py b/src/PIL/ImageFile.py
index a1c33f21974..fce1591ef5d 100644
--- a/src/PIL/ImageFile.py
+++ b/src/PIL/ImageFile.py
@@ -34,12 +34,15 @@
 import os
 import struct
 import sys
-from typing import IO, Any, NamedTuple
+from typing import IO, TYPE_CHECKING, Any, NamedTuple
 
 from . import Image
 from ._deprecate import deprecate
 from ._util import is_path
 
+if TYPE_CHECKING:
+    from ._typing import StrOrBytesPath
+
 MAXBLOCK = 65536
 
 SAFEBLOCK = 1024 * 1024
@@ -107,32 +110,34 @@ class _Tile(NamedTuple):
 class ImageFile(Image.Image):
     """Base class for image file format handlers."""
 
-    def __init__(self, fp=None, filename=None):
+    def __init__(
+        self, fp: StrOrBytesPath | IO[bytes] | None = None, filename: str | bytes | None = None
+    ) -> None:
         super().__init__()
 
         self._min_frame = 0
 
-        self.custom_mimetype = None
+        self.custom_mimetype: str | None = None
 
-        self.tile = None
+        self.tile: list[_Tile] = []
         """ A list of tile descriptors, or ``None`` """
 
         self.readonly = 1  # until we know better
 
-        self.decoderconfig = ()
+        self.decoderconfig: tuple[Any, ...] = ()
         self.decodermaxblock = MAXBLOCK
 
         if is_path(fp):
             # filename
             self.fp = open(fp, "rb")
-            self.filename = fp
+            self.filename = os.path.realpath(os.fspath(fp))
             self._exclusive_fp = True
         else:
             # stream
             self.fp = fp
-            self.filename = filename
+            self.filename = filename if filename is not None else ""
             # can be overridden
-            self._exclusive_fp = None
+            self._exclusive_fp = False
 
         try:
             try:
@@ -155,6 +160,9 @@ def __init__(self, fp=None, filename=None):
                 self.fp.close()
             raise
 
+    def _open(self) -> None:
+        pass
+
     def get_format_mimetype(self) -> str | None:
         if self.custom_mimetype:
             return self.custom_mimetype
@@ -178,7 +186,7 @@ def verify(self) -> None:
     def load(self) -> Image.core.PixelAccess | None:
         """Load image data based on tile list"""
 
-        if self.tile is None:
+        if not self.tile and self._im is None:
             msg = "cannot load this image"
             raise OSError(msg)
 
@@ -214,6 +222,7 @@ def load(self) -> Image.core.PixelAccess | None:
                 args = (args, 0, 1)
             if (
                 decoder_name == "raw"
+                and isinstance(args, tuple)
                 and len(args) >= 3
                 and args[0] == self.mode
                 and args[0] in Image._MAPMODES
diff --git a/src/PIL/ImtImagePlugin.py b/src/PIL/ImtImagePlugin.py
index abb3fb762e7..594c56513cd 100644
--- a/src/PIL/ImtImagePlugin.py
+++ b/src/PIL/ImtImagePlugin.py
@@ -58,7 +58,7 @@ def _open(self) -> None:
             if s == b"\x0C":
                 # image data begins
                 self.tile = [
-                    (
+                    ImageFile._Tile(
                         "raw",
                         (0, 0) + self.size,
                         self.fp.tell() - len(buffer),
diff --git a/src/PIL/IptcImagePlugin.py b/src/PIL/IptcImagePlugin.py
index a8cd38218f1..60ab7c83f37 100644
--- a/src/PIL/IptcImagePlugin.py
+++ b/src/PIL/IptcImagePlugin.py
@@ -147,7 +147,9 @@ def _open(self) -> None:
 
         # tile
         if tag == (8, 10):
-            self.tile = [("iptc", (0, 0) + self.size, offset, compression)]
+            self.tile = [
+                ImageFile._Tile("iptc", (0, 0) + self.size, offset, compression)
+            ]
 
     def load(self) -> Image.core.PixelAccess | None:
         if len(self.tile) != 1 or self.tile[0][0] != "iptc":
diff --git a/src/PIL/Jpeg2KImagePlugin.py b/src/PIL/Jpeg2KImagePlugin.py
index 02c2e48cfb4..cfbf7846093 100644
--- a/src/PIL/Jpeg2KImagePlugin.py
+++ b/src/PIL/Jpeg2KImagePlugin.py
@@ -286,7 +286,7 @@ def _open(self) -> None:
                 length = -1
 
         self.tile = [
-            (
+            ImageFile._Tile(
                 "jpeg2k",
                 (0, 0) + self.size,
                 0,
@@ -338,8 +338,9 @@ def load(self) -> Image.core.PixelAccess | None:
 
             # Update the reduce and layers settings
             t = self.tile[0]
+            assert isinstance(t[3], tuple)
             t3 = (t[3][0], self._reduce, self.layers, t[3][3], t[3][4])
-            self.tile = [(t[0], (0, 0) + self.size, t[2], t3)]
+            self.tile = [ImageFile._Tile(t[0], (0, 0) + self.size, t[2], t3)]
 
         return ImageFile.ImageFile.load(self)
 
diff --git a/src/PIL/JpegImagePlugin.py b/src/PIL/JpegImagePlugin.py
index bd4539be420..1f54b7e92a2 100644
--- a/src/PIL/JpegImagePlugin.py
+++ b/src/PIL/JpegImagePlugin.py
@@ -372,7 +372,9 @@ def _open(self) -> None:
                     rawmode = self.mode
                     if self.mode == "CMYK":
                         rawmode = "CMYK;I"  # assume adobe conventions
-                    self.tile = [("jpeg", (0, 0) + self.size, 0, (rawmode, ""))]
+                    self.tile = [
+                        ImageFile._Tile("jpeg", (0, 0) + self.size, 0, (rawmode, ""))
+                    ]
                     # self.__offset = self.fp.tell()
                     break
                 s = self.fp.read(1)
@@ -423,6 +425,7 @@ def draft(
         scale = 1
         original_size = self.size
 
+        assert isinstance(a, tuple)
         if a[0] == "RGB" and mode in ["L", "YCbCr"]:
             self._mode = mode
             a = mode, ""
@@ -432,6 +435,7 @@ def draft(
             for s in [8, 4, 2, 1]:
                 if scale >= s:
                     break
+            assert e is not None
             e = (
                 e[0],
                 e[1],
@@ -441,7 +445,7 @@ def draft(
             self._size = ((self.size[0] + s - 1) // s, (self.size[1] + s - 1) // s)
             scale = s
 
-        self.tile = [(d, e, o, a)]
+        self.tile = [ImageFile._Tile(d, e, o, a)]
         self.decoderconfig = (scale, 0)
 
         box = (0, 0, original_size[0] / scale, original_size[1] / scale)
diff --git a/src/PIL/McIdasImagePlugin.py b/src/PIL/McIdasImagePlugin.py
index 27972236c0a..5dd031be369 100644
--- a/src/PIL/McIdasImagePlugin.py
+++ b/src/PIL/McIdasImagePlugin.py
@@ -67,7 +67,9 @@ def _open(self) -> None:
         offset = w[34] + w[15]
         stride = w[15] + w[10] * w[11] * w[14]
 
-        self.tile = [("raw", (0, 0) + self.size, offset, (rawmode, stride, 1))]
+        self.tile = [
+            ImageFile._Tile("raw", (0, 0) + self.size, offset, (rawmode, stride, 1))
+        ]
 
 
 # --------------------------------------------------------------------
diff --git a/src/PIL/MpoImagePlugin.py b/src/PIL/MpoImagePlugin.py
index 5ed9f56a164..71f89a09a85 100644
--- a/src/PIL/MpoImagePlugin.py
+++ b/src/PIL/MpoImagePlugin.py
@@ -26,6 +26,7 @@
 
 from . import (
     Image,
+    ImageFile,
     ImageSequence,
     JpegImagePlugin,
     TiffImagePlugin,
@@ -145,7 +146,9 @@ def seek(self, frame: int) -> None:
         if self.info.get("exif") != original_exif:
             self._reload_exif()
 
-        self.tile = [("jpeg", (0, 0) + self.size, self.offset, self.tile[0][-1])]
+        self.tile = [
+            ImageFile._Tile("jpeg", (0, 0) + self.size, self.offset, self.tile[0][-1])
+        ]
         self.__frame = frame
 
     def tell(self) -> int:
diff --git a/src/PIL/MspImagePlugin.py b/src/PIL/MspImagePlugin.py
index 40e5fa435a8..c9260325499 100644
--- a/src/PIL/MspImagePlugin.py
+++ b/src/PIL/MspImagePlugin.py
@@ -70,9 +70,9 @@ def _open(self) -> None:
         self._size = i16(s, 4), i16(s, 6)
 
         if s[:4] == b"DanM":
-            self.tile = [("raw", (0, 0) + self.size, 32, ("1", 0, 1))]
+            self.tile = [ImageFile._Tile("raw", (0, 0) + self.size, 32, ("1", 0, 1))]
         else:
-            self.tile = [("MSP", (0, 0) + self.size, 32, None)]
+            self.tile = [ImageFile._Tile("MSP", (0, 0) + self.size, 32, None)]
 
 
 class MspDecoder(ImageFile.PyDecoder):
diff --git a/src/PIL/PcdImagePlugin.py b/src/PIL/PcdImagePlugin.py
index d9970405c7a..e8ea800a42c 100644
--- a/src/PIL/PcdImagePlugin.py
+++ b/src/PIL/PcdImagePlugin.py
@@ -47,7 +47,7 @@ def _open(self) -> None:
 
         self._mode = "RGB"
         self._size = 768, 512  # FIXME: not correct for rotated images!
-        self.tile = [("pcd", (0, 0) + self.size, 96 * 2048, None)]
+        self.tile = [ImageFile._Tile("pcd", (0, 0) + self.size, 96 * 2048, None)]
 
     def load_end(self) -> None:
         if self.tile_post_rotate:
diff --git a/src/PIL/PcxImagePlugin.py b/src/PIL/PcxImagePlugin.py
index c3c9dd3f137..8445d5cc740 100644
--- a/src/PIL/PcxImagePlugin.py
+++ b/src/PIL/PcxImagePlugin.py
@@ -128,7 +128,9 @@ def _open(self) -> None:
         bbox = (0, 0) + self.size
         logger.debug("size: %sx%s", *self.size)
 
-        self.tile = [("pcx", bbox, self.fp.tell(), (rawmode, planes * stride))]
+        self.tile = [
+            ImageFile._Tile("pcx", bbox, self.fp.tell(), (rawmode, planes * stride))
+        ]
 
 
 # --------------------------------------------------------------------
diff --git a/src/PIL/PixarImagePlugin.py b/src/PIL/PixarImagePlugin.py
index 887b6568bf7..36f565f1c20 100644
--- a/src/PIL/PixarImagePlugin.py
+++ b/src/PIL/PixarImagePlugin.py
@@ -61,7 +61,9 @@ def _open(self) -> None:
         # FIXME: to be continued...
 
         # create tile descriptor (assuming "dumped")
-        self.tile = [("raw", (0, 0) + self.size, 1024, (self.mode, 0, 1))]
+        self.tile = [
+            ImageFile._Tile("raw", (0, 0) + self.size, 1024, (self.mode, 0, 1))
+        ]
 
 
 #
diff --git a/src/PIL/PpmImagePlugin.py b/src/PIL/PpmImagePlugin.py
index 7bdaa9fe740..e4d745e67ff 100644
--- a/src/PIL/PpmImagePlugin.py
+++ b/src/PIL/PpmImagePlugin.py
@@ -151,7 +151,9 @@ def _open(self) -> None:
                     decoder_name = "ppm"
 
             args = rawmode if decoder_name == "raw" else (rawmode, maxval)
-        self.tile = [(decoder_name, (0, 0) + self.size, self.fp.tell(), args)]
+        self.tile = [
+            ImageFile._Tile(decoder_name, (0, 0) + self.size, self.fp.tell(), args)
+        ]
 
 
 #
diff --git a/src/PIL/PsdImagePlugin.py b/src/PIL/PsdImagePlugin.py
index cc99cd6d8cb..8ff5e39088a 100644
--- a/src/PIL/PsdImagePlugin.py
+++ b/src/PIL/PsdImagePlugin.py
@@ -277,8 +277,8 @@ def read(size: int) -> bytes:
 
 def _maketile(
     file: IO[bytes], mode: str, bbox: tuple[int, int, int, int], channels: int
-) -> list[ImageFile._Tile] | None:
-    tiles = None
+) -> list[ImageFile._Tile]:
+    tiles = []
     read = file.read
 
     compression = i16(read(2))
@@ -291,7 +291,6 @@ def _maketile(
     if compression == 0:
         #
         # raw compression
-        tiles = []
         for channel in range(channels):
             layer = mode[channel]
             if mode == "CMYK":
@@ -303,7 +302,6 @@ def _maketile(
         #
         # packbits compression
         i = 0
-        tiles = []
         bytecount = read(channels * ysize * 2)
         offset = file.tell()
         for channel in range(channels):
diff --git a/src/PIL/QoiImagePlugin.py b/src/PIL/QoiImagePlugin.py
index c81d381fb6c..eaf03140291 100644
--- a/src/PIL/QoiImagePlugin.py
+++ b/src/PIL/QoiImagePlugin.py
@@ -32,7 +32,7 @@ def _open(self) -> None:
         self._mode = "RGB" if channels == 3 else "RGBA"
 
         self.fp.seek(1, os.SEEK_CUR)  # colorspace
-        self.tile = [("qoi", (0, 0) + self._size, self.fp.tell(), None)]
+        self.tile = [ImageFile._Tile("qoi", (0, 0) + self._size, self.fp.tell(), None)]
 
 
 class QoiDecoder(ImageFile.PyDecoder):
diff --git a/src/PIL/SgiImagePlugin.py b/src/PIL/SgiImagePlugin.py
index 50d97910932..2c205a926be 100644
--- a/src/PIL/SgiImagePlugin.py
+++ b/src/PIL/SgiImagePlugin.py
@@ -109,19 +109,28 @@ def _open(self) -> None:
             pagesize = xsize * ysize * bpc
             if bpc == 2:
                 self.tile = [
-                    ("SGI16", (0, 0) + self.size, headlen, (self.mode, 0, orientation))
+                    ImageFile._Tile(
+                        "SGI16",
+                        (0, 0) + self.size,
+                        headlen,
+                        (self.mode, 0, orientation),
+                    )
                 ]
             else:
                 self.tile = []
                 offset = headlen
                 for layer in self.mode:
                     self.tile.append(
-                        ("raw", (0, 0) + self.size, offset, (layer, 0, orientation))
+                        ImageFile._Tile(
+                            "raw", (0, 0) + self.size, offset, (layer, 0, orientation)
+                        )
                     )
                     offset += pagesize
         elif compression == 1:
             self.tile = [
-                ("sgi_rle", (0, 0) + self.size, headlen, (rawmode, orientation, bpc))
+                ImageFile._Tile(
+                    "sgi_rle", (0, 0) + self.size, headlen, (rawmode, orientation, bpc)
+                )
             ]
 
 
diff --git a/src/PIL/SpiderImagePlugin.py b/src/PIL/SpiderImagePlugin.py
index 7045ab566de..075073f9fe3 100644
--- a/src/PIL/SpiderImagePlugin.py
+++ b/src/PIL/SpiderImagePlugin.py
@@ -154,7 +154,9 @@ def _open(self) -> None:
             self.rawmode = "F;32F"
         self._mode = "F"
 
-        self.tile = [("raw", (0, 0) + self.size, offset, (self.rawmode, 0, 1))]
+        self.tile = [
+            ImageFile._Tile("raw", (0, 0) + self.size, offset, (self.rawmode, 0, 1))
+        ]
         self._fp = self.fp  # FIXME: hack
 
     @property
diff --git a/src/PIL/SunImagePlugin.py b/src/PIL/SunImagePlugin.py
index 4e098474ab9..8912379ea3e 100644
--- a/src/PIL/SunImagePlugin.py
+++ b/src/PIL/SunImagePlugin.py
@@ -124,9 +124,13 @@ def _open(self) -> None:
         # (https://www.fileformat.info/format/sunraster/egff.htm)
 
         if file_type in (0, 1, 3, 4, 5):
-            self.tile = [("raw", (0, 0) + self.size, offset, (rawmode, stride))]
+            self.tile = [
+                ImageFile._Tile("raw", (0, 0) + self.size, offset, (rawmode, stride))
+            ]
         elif file_type == 2:
-            self.tile = [("sun_rle", (0, 0) + self.size, offset, rawmode)]
+            self.tile = [
+                ImageFile._Tile("sun_rle", (0, 0) + self.size, offset, rawmode)
+            ]
         else:
             msg = "Unsupported Sun Raster file type"
             raise SyntaxError(msg)
diff --git a/src/PIL/TgaImagePlugin.py b/src/PIL/TgaImagePlugin.py
index 5aea363c064..90d5b5cf4ee 100644
--- a/src/PIL/TgaImagePlugin.py
+++ b/src/PIL/TgaImagePlugin.py
@@ -137,7 +137,7 @@ def _open(self) -> None:
             if imagetype & 8:
                 # compressed
                 self.tile = [
-                    (
+                    ImageFile._Tile(
                         "tga_rle",
                         (0, 0) + self.size,
                         self.fp.tell(),
@@ -146,7 +146,7 @@ def _open(self) -> None:
                 ]
             else:
                 self.tile = [
-                    (
+                    ImageFile._Tile(
                         "raw",
                         (0, 0) + self.size,
                         self.fp.tell(),
diff --git a/src/PIL/TiffImagePlugin.py b/src/PIL/TiffImagePlugin.py
index ab23356d4f3..d05c08489a3 100644
--- a/src/PIL/TiffImagePlugin.py
+++ b/src/PIL/TiffImagePlugin.py
@@ -1298,7 +1298,7 @@ def _load_libtiff(self) -> Image.core.PixelAccess | None:
         # (self._compression, (extents tuple),
         #   0, (rawmode, self._compression, fp))
         extents = self.tile[0][1]
-        args = list(self.tile[0][3])
+        args = self.tile[0][3]
 
         # To be nice on memory footprint, if there's a
         # file descriptor, use that instead of reading
@@ -1316,11 +1316,12 @@ def _load_libtiff(self) -> Image.core.PixelAccess | None:
             fp = False
 
         if fp:
-            args[2] = fp
+            assert isinstance(args, tuple)
+            args_list = list(args)
+            args_list[2] = fp
+            args = tuple(args_list)
 
-        decoder = Image._getdecoder(
-            self.mode, "libtiff", tuple(args), self.decoderconfig
-        )
+        decoder = Image._getdecoder(self.mode, "libtiff", args, self.decoderconfig)
         try:
             decoder.setimage(self.im, extents)
         except ValueError as e:
@@ -1538,7 +1539,7 @@ def _setup(self) -> None:
             # Offset in the tile tuple is 0, we go from 0,0 to
             # w,h, and we only do this once -- eds
             a = (rawmode, self._compression, False, self.tag_v2.offset)
-            self.tile.append(("libtiff", (0, 0, xsize, ysize), 0, a))
+            self.tile.append(ImageFile._Tile("libtiff", (0, 0, xsize, ysize), 0, a))
 
         elif STRIPOFFSETS in self.tag_v2 or TILEOFFSETS in self.tag_v2:
             # striped image
@@ -1571,7 +1572,7 @@ def _setup(self) -> None:
 
                 args = (tile_rawmode, int(stride), 1)
                 self.tile.append(
-                    (
+                    ImageFile._Tile(
                         self._compression,
                         (x, y, min(x + w, xsize), min(y + h, ysize)),
                         offset,
diff --git a/src/PIL/WebPImagePlugin.py b/src/PIL/WebPImagePlugin.py
index fc8f4fc2edc..f8d6168bafd 100644
--- a/src/PIL/WebPImagePlugin.py
+++ b/src/PIL/WebPImagePlugin.py
@@ -142,7 +142,7 @@ def load(self) -> Image.core.PixelAccess | None:
             if self.fp and self._exclusive_fp:
                 self.fp.close()
             self.fp = BytesIO(data)
-            self.tile = [("raw", (0, 0) + self.size, 0, self.rawmode)]
+            self.tile = [ImageFile._Tile("raw", (0, 0) + self.size, 0, self.rawmode)]
 
         return super().load()
 
diff --git a/src/PIL/XVThumbImagePlugin.py b/src/PIL/XVThumbImagePlugin.py
index c84adaca215..5d1f201a454 100644
--- a/src/PIL/XVThumbImagePlugin.py
+++ b/src/PIL/XVThumbImagePlugin.py
@@ -73,7 +73,11 @@ def _open(self) -> None:
 
         self.palette = ImagePalette.raw("RGB", PALETTE)
 
-        self.tile = [("raw", (0, 0) + self.size, self.fp.tell(), (self.mode, 0, 1))]
+        self.tile = [
+            ImageFile._Tile(
+                "raw", (0, 0) + self.size, self.fp.tell(), (self.mode, 0, 1)
+            )
+        ]
 
 
 # --------------------------------------------------------------------
diff --git a/src/PIL/XbmImagePlugin.py b/src/PIL/XbmImagePlugin.py
index 6c2e32804e3..f3d490a840f 100644
--- a/src/PIL/XbmImagePlugin.py
+++ b/src/PIL/XbmImagePlugin.py
@@ -67,7 +67,7 @@ def _open(self) -> None:
         self._mode = "1"
         self._size = xsize, ysize
 
-        self.tile = [("xbm", (0, 0) + self.size, m.end(), None)]
+        self.tile = [ImageFile._Tile("xbm", (0, 0) + self.size, m.end(), None)]
 
 
 def _save(im: Image.Image, fp: IO[bytes], filename: str | bytes) -> None:
diff --git a/src/PIL/XpmImagePlugin.py b/src/PIL/XpmImagePlugin.py
index 8d56331e6aa..1fc6c0c39d5 100644
--- a/src/PIL/XpmImagePlugin.py
+++ b/src/PIL/XpmImagePlugin.py
@@ -101,7 +101,9 @@ def _open(self) -> None:
         self._mode = "P"
         self.palette = ImagePalette.raw("RGB", b"".join(palette))
 
-        self.tile = [("raw", (0, 0) + self.size, self.fp.tell(), ("P", 0, 1))]
+        self.tile = [
+            ImageFile._Tile("raw", (0, 0) + self.size, self.fp.tell(), ("P", 0, 1))
+        ]
 
     def load_read(self, read_bytes: int) -> bytes:
         #

From 8699f13a74f162552fa70644bfdbe9705f87f080 Mon Sep 17 00:00:00 2001
From: Andrew Murray <radarhere@users.noreply.github.com>
Date: Thu, 29 Aug 2024 22:15:43 +1000
Subject: [PATCH 0967/1178] Require fp parameter

---
 src/PIL/ImageFile.py       | 6 +++---
 src/PIL/JpegImagePlugin.py | 2 +-
 src/PIL/TiffImagePlugin.py | 2 +-
 3 files changed, 5 insertions(+), 5 deletions(-)

diff --git a/src/PIL/ImageFile.py b/src/PIL/ImageFile.py
index fce1591ef5d..69fbafd3968 100644
--- a/src/PIL/ImageFile.py
+++ b/src/PIL/ImageFile.py
@@ -34,7 +34,7 @@
 import os
 import struct
 import sys
-from typing import IO, TYPE_CHECKING, Any, NamedTuple
+from typing import IO, TYPE_CHECKING, Any, NamedTuple, cast
 
 from . import Image
 from ._deprecate import deprecate
@@ -111,7 +111,7 @@ class ImageFile(Image.Image):
     """Base class for image file format handlers."""
 
     def __init__(
-        self, fp: StrOrBytesPath | IO[bytes] | None = None, filename: str | bytes | None = None
+        self, fp: StrOrBytesPath | IO[bytes], filename: str | bytes | None = None
     ) -> None:
         super().__init__()
 
@@ -134,7 +134,7 @@ def __init__(
             self._exclusive_fp = True
         else:
             # stream
-            self.fp = fp
+            self.fp = cast(IO[bytes], fp)
             self.filename = filename if filename is not None else ""
             # can be overridden
             self._exclusive_fp = False
diff --git a/src/PIL/JpegImagePlugin.py b/src/PIL/JpegImagePlugin.py
index 1f54b7e92a2..e3372a1c2a6 100644
--- a/src/PIL/JpegImagePlugin.py
+++ b/src/PIL/JpegImagePlugin.py
@@ -848,7 +848,7 @@ def _save_cjpeg(im: Image.Image, fp: IO[bytes], filename: str | bytes) -> None:
 ##
 # Factory for making JPEG and MPO instances
 def jpeg_factory(
-    fp: IO[bytes] | None = None, filename: str | bytes | None = None
+    fp: IO[bytes], filename: str | bytes | None = None
 ) -> JpegImageFile | MpoImageFile:
     im = JpegImageFile(fp, filename)
     try:
diff --git a/src/PIL/TiffImagePlugin.py b/src/PIL/TiffImagePlugin.py
index d05c08489a3..ad898dc8e1b 100644
--- a/src/PIL/TiffImagePlugin.py
+++ b/src/PIL/TiffImagePlugin.py
@@ -1126,7 +1126,7 @@ class TiffImageFile(ImageFile.ImageFile):
 
     def __init__(
         self,
-        fp: StrOrBytesPath | IO[bytes] | None = None,
+        fp: StrOrBytesPath | IO[bytes],
         filename: str | bytes | None = None,
     ) -> None:
         self.tag_v2: ImageFileDirectory_v2

From cdadf931e36cb3816096197ce91abfbe6b11df92 Mon Sep 17 00:00:00 2001
From: Yngve Mardal Moe <yngve.m.moe@gmail.com>
Date: Fri, 30 Aug 2024 20:36:22 +0000
Subject: [PATCH 0968/1178] Improve error messages

---
 Tests/test_imagefont.py | 27 +++++++++++++++++++++++++++
 src/PIL/ImageFont.py    | 19 +++++++++++++++----
 2 files changed, 42 insertions(+), 4 deletions(-)

diff --git a/Tests/test_imagefont.py b/Tests/test_imagefont.py
index 340cc47420b..e2a7b759ad5 100644
--- a/Tests/test_imagefont.py
+++ b/Tests/test_imagefont.py
@@ -460,6 +460,17 @@ def test_free_type_font_get_mask(font: ImageFont.FreeTypeFont) -> None:
     assert mask.size == (108, 13)
 
 
+def test_load_raises_if_image_not_found(tmp_path) -> None:
+    font_path = tmp_path / "file.font"
+    font_path.write_bytes(b"")
+    with pytest.raises(OSError) as excinfo:
+        ImageFont.load(font_path)
+
+    pre = tmp_path / "file"
+    msg = f"cannot find glyph data file {pre}.{{png|gif|pbm}}"
+    assert msg in str(excinfo.value)
+
+
 def test_load_path_not_found() -> None:
     # Arrange
     filename = "somefilenamethatdoesntexist.ttf"
@@ -471,6 +482,22 @@ def test_load_path_not_found() -> None:
         ImageFont.truetype(filename)
 
 
+def test_load_path_exisitng_path(tmp_path) -> None:
+    # First, the file doens't exist, so we don't suggest `load`
+    some_path = tmp_path / "file.ttf"
+    with pytest.raises(OSError) as excinfo:
+        ImageFont.load_path(str(some_path))
+        assert str(some_path) in str(excinfo.value)
+        assert "did you mean" not in str(excinfo.value)
+
+    # The file exists, so the error message suggests to use `load` instead
+    some_path.write_bytes(b"")
+    with pytest.raises(OSError) as excinfo:
+        ImageFont.load_path(str(some_path))
+    assert str(some_path) in str(excinfo.value)
+    assert " did you mean" in str(excinfo.value)
+
+
 def test_load_non_font_bytes() -> None:
     with open("Tests/images/hopper.jpg", "rb") as f:
         with pytest.raises(OSError):
diff --git a/src/PIL/ImageFont.py b/src/PIL/ImageFont.py
index 2ab65bfefe4..072acc31f31 100644
--- a/src/PIL/ImageFont.py
+++ b/src/PIL/ImageFont.py
@@ -98,11 +98,13 @@ class ImageFont:
     def _load_pilfont(self, filename: str) -> None:
         with open(filename, "rb") as fp:
             image: ImageFile.ImageFile | None = None
+            filename_body = os.path.splitext(filename)[0]
+
             for ext in (".png", ".gif", ".pbm"):
                 if image:
                     image.close()
                 try:
-                    fullname = os.path.splitext(filename)[0] + ext
+                    fullname = filename_body + ext
                     image = Image.open(fullname)
                 except Exception:
                     pass
@@ -112,7 +114,9 @@ def _load_pilfont(self, filename: str) -> None:
             else:
                 if image:
                     image.close()
-                msg = "cannot find glyph data file"
+
+                pre = filename_body
+                msg = f"cannot find glyph data file {pre}.{{png|gif|pbm}}"
                 raise OSError(msg)
 
             self.file = fullname
@@ -224,7 +228,7 @@ def __init__(
             raise core.ex
 
         if size <= 0:
-            msg = "font size must be greater than 0"
+            msg = f"font size must be greater than 0, not {size}"
             raise ValueError(msg)
 
         self.path = font
@@ -774,6 +778,8 @@ def load(filename: str) -> ImageFont:
     :param filename: Name of font file.
     :return: A font object.
     :exception OSError: If the file could not be read.
+
+    .. seealso:: :py:func:`PIL.ImageFont.truetype`
     """
     f = ImageFont()
     f._load_pilfont(filename)
@@ -850,6 +856,8 @@ def truetype(
     :return: A font object.
     :exception OSError: If the file could not be read.
     :exception ValueError: If the font size is not greater than zero.
+
+    .. seealso:: :py:func:`PIL.ImageFont.load`
     """
 
     def freetype(font: StrOrBytesPath | BinaryIO | None) -> FreeTypeFont:
@@ -927,7 +935,10 @@ def load_path(filename: str | bytes) -> ImageFont:
             return load(os.path.join(directory, filename))
         except OSError:
             pass
-    msg = "cannot find font file"
+    msg = f"cannot find font file '{filename}' in `sys.path`"
+    if os.path.exists(filename):
+        msg += f" did you mean `ImageFont.load({filename})` instead?"
+
     raise OSError(msg)
 
 

From e47b1810841be44ca90327259a01ce9d9a71e5ad Mon Sep 17 00:00:00 2001
From: Andrew Murray <radarhere@users.noreply.github.com>
Date: Sat, 31 Aug 2024 18:48:16 +1000
Subject: [PATCH 0969/1178] Added type hints

---
 .ci/requirements-mypy.txt           |  1 +
 Tests/oss-fuzz/fuzz_font.py         |  3 +-
 Tests/oss-fuzz/fuzz_pillow.py       |  3 +-
 docs/reference/internal_modules.rst |  4 +++
 pyproject.toml                      |  4 ---
 src/PIL/BmpImagePlugin.py           |  2 +-
 src/PIL/Image.py                    |  7 ++++-
 src/PIL/ImageFile.py                |  7 +++--
 src/PIL/ImageFont.py                |  6 ++--
 src/PIL/Jpeg2KImagePlugin.py        | 10 ++++--
 src/PIL/MspImagePlugin.py           |  2 +-
 src/PIL/PngImagePlugin.py           |  4 ++-
 src/PIL/TiffImagePlugin.py          | 48 +++++++++++++++++++----------
 src/PIL/_typing.py                  |  4 ++-
 14 files changed, 70 insertions(+), 35 deletions(-)

diff --git a/.ci/requirements-mypy.txt b/.ci/requirements-mypy.txt
index 5b09ef64c9c..dcb3996e24e 100644
--- a/.ci/requirements-mypy.txt
+++ b/.ci/requirements-mypy.txt
@@ -6,6 +6,7 @@ numpy
 packaging
 pytest
 sphinx
+types-atheris
 types-defusedxml
 types-olefile
 types-setuptools
diff --git a/Tests/oss-fuzz/fuzz_font.py b/Tests/oss-fuzz/fuzz_font.py
index 8788d7021d3..f4e40ea3671 100755
--- a/Tests/oss-fuzz/fuzz_font.py
+++ b/Tests/oss-fuzz/fuzz_font.py
@@ -16,8 +16,9 @@
 
 
 import atheris
+from atheris.import_hook import instrument_imports
 
-with atheris.instrument_imports():
+with instrument_imports():
     import sys
 
     import fuzzers
diff --git a/Tests/oss-fuzz/fuzz_pillow.py b/Tests/oss-fuzz/fuzz_pillow.py
index 9137391b656..d58a6f0150d 100644
--- a/Tests/oss-fuzz/fuzz_pillow.py
+++ b/Tests/oss-fuzz/fuzz_pillow.py
@@ -14,8 +14,9 @@
 
 
 import atheris
+from atheris.import_hook import instrument_imports
 
-with atheris.instrument_imports():
+with instrument_imports():
     import sys
 
     import fuzzers
diff --git a/docs/reference/internal_modules.rst b/docs/reference/internal_modules.rst
index 2fb4ff8c018..31d60cd832e 100644
--- a/docs/reference/internal_modules.rst
+++ b/docs/reference/internal_modules.rst
@@ -33,6 +33,10 @@ Internal Modules
 Provides a convenient way to import type hints that are not available
 on some Python versions.
 
+.. py:class:: IntegralLike
+
+    Typing alias.
+
 .. py:class:: NumpyArray
 
     Typing alias.
diff --git a/pyproject.toml b/pyproject.toml
index e4ae73acf52..4042bd9ee20 100644
--- a/pyproject.toml
+++ b/pyproject.toml
@@ -163,7 +163,3 @@ follow_imports = "silent"
 warn_redundant_casts = true
 warn_unreachable = true
 warn_unused_ignores = true
-exclude = [
-  '^Tests/oss-fuzz/fuzz_font.py$',
-  '^Tests/oss-fuzz/fuzz_pillow.py$',
-]
diff --git a/src/PIL/BmpImagePlugin.py b/src/PIL/BmpImagePlugin.py
index de441c6b5c2..707fb219284 100644
--- a/src/PIL/BmpImagePlugin.py
+++ b/src/PIL/BmpImagePlugin.py
@@ -387,7 +387,7 @@ def decode(self, buffer: bytes) -> tuple[int, int]:
                     if self.fd.tell() % 2 != 0:
                         self.fd.seek(1, os.SEEK_CUR)
         rawmode = "L" if self.mode == "L" else "P"
-        self.set_as_raw(bytes(data), (rawmode, 0, self.args[-1]))
+        self.set_as_raw(bytes(data), rawmode, (0, self.args[-1]))
         return -1, 0
 
 
diff --git a/src/PIL/Image.py b/src/PIL/Image.py
index 95b4c64eef4..d27328a83fd 100644
--- a/src/PIL/Image.py
+++ b/src/PIL/Image.py
@@ -225,6 +225,11 @@ class Quantize(IntEnum):
 
     from . import ImageFile, ImageFilter, ImagePalette, ImageQt, TiffImagePlugin
     from ._typing import NumpyArray, StrOrBytesPath, TypeGuard
+
+    if sys.version_info >= (3, 13):
+        from types import CapsuleType
+    else:
+        CapsuleType = object
 ID: list[str] = []
 OPEN: dict[
     str,
@@ -1598,7 +1603,7 @@ def get_child_images(self) -> list[ImageFile.ImageFile]:
             self.fp.seek(offset)
         return child_images
 
-    def getim(self):
+    def getim(self) -> CapsuleType:
         """
         Returns a capsule that points to the internal image memory.
 
diff --git a/src/PIL/ImageFile.py b/src/PIL/ImageFile.py
index a1c33f21974..0ecc9053c7a 100644
--- a/src/PIL/ImageFile.py
+++ b/src/PIL/ImageFile.py
@@ -736,19 +736,22 @@ def decode(self, buffer: bytes) -> tuple[int, int]:
         msg = "unavailable in base decoder"
         raise NotImplementedError(msg)
 
-    def set_as_raw(self, data: bytes, rawmode=None) -> None:
+    def set_as_raw(
+        self, data: bytes, rawmode: str | None = None, extra: tuple[Any, ...] = ()
+    ) -> None:
         """
         Convenience method to set the internal image from a stream of raw data
 
         :param data: Bytes to be set
         :param rawmode: The rawmode to be used for the decoder.
             If not specified, it will default to the mode of the image
+        :param extra: Extra arguments for the decoder.
         :returns: None
         """
 
         if not rawmode:
             rawmode = self.mode
-        d = Image._getdecoder(self.mode, "raw", rawmode)
+        d = Image._getdecoder(self.mode, "raw", rawmode, extra)
         assert self.im is not None
         d.setimage(self.im, self.state.extents())
         s = d.decode(data)
diff --git a/src/PIL/ImageFont.py b/src/PIL/ImageFont.py
index 2ab65bfefe4..acc7ca1d2db 100644
--- a/src/PIL/ImageFont.py
+++ b/src/PIL/ImageFont.py
@@ -34,7 +34,7 @@
 from enum import IntEnum
 from io import BytesIO
 from types import ModuleType
-from typing import IO, TYPE_CHECKING, Any, BinaryIO, TypedDict
+from typing import IO, TYPE_CHECKING, Any, BinaryIO, TypedDict, cast
 
 from . import Image
 from ._typing import StrOrBytesPath
@@ -245,7 +245,7 @@ def __init__(
 
         self.layout_engine = layout_engine
 
-        def load_from_bytes(f) -> None:
+        def load_from_bytes(f: IO[bytes]) -> None:
             self.font_bytes = f.read()
             self.font = core.getfont(
                 "", size, index, encoding, self.font_bytes, layout_engine
@@ -267,7 +267,7 @@ def load_from_bytes(f) -> None:
                 font, size, index, encoding, layout_engine=layout_engine
             )
         else:
-            load_from_bytes(font)
+            load_from_bytes(cast(IO[bytes], font))
 
     def __getstate__(self) -> list[Any]:
         return [self.path, self.size, self.index, self.encoding, self.layout_engine]
diff --git a/src/PIL/Jpeg2KImagePlugin.py b/src/PIL/Jpeg2KImagePlugin.py
index 02c2e48cfb4..5c88ef0bb83 100644
--- a/src/PIL/Jpeg2KImagePlugin.py
+++ b/src/PIL/Jpeg2KImagePlugin.py
@@ -18,6 +18,7 @@
 import io
 import os
 import struct
+from collections.abc import Callable
 from typing import IO, cast
 
 from . import Image, ImageFile, ImagePalette, _binary
@@ -316,8 +317,13 @@ def _parse_comment(self) -> None:
             else:
                 self.fp.seek(length - 2, os.SEEK_CUR)
 
-    @property
-    def reduce(self):
+    @property  # type: ignore[override]
+    def reduce(
+        self,
+    ) -> (
+        Callable[[int | tuple[int, int], tuple[int, int, int, int] | None], Image.Image]
+        | int
+    ):
         # https://github.com/python-pillow/Pillow/issues/4343 found that the
         # new Image 'reduce' method was shadowed by this plugin's 'reduce'
         # property. This attempts to allow for both scenarios
diff --git a/src/PIL/MspImagePlugin.py b/src/PIL/MspImagePlugin.py
index 40e5fa435a8..987d20c1384 100644
--- a/src/PIL/MspImagePlugin.py
+++ b/src/PIL/MspImagePlugin.py
@@ -152,7 +152,7 @@ def decode(self, buffer: bytes) -> tuple[int, int]:
                 msg = f"Corrupted MSP file in row {x}"
                 raise OSError(msg) from e
 
-        self.set_as_raw(img.getvalue(), ("1", 0, 1))
+        self.set_as_raw(img.getvalue(), "1")
 
         return -1, 0
 
diff --git a/src/PIL/PngImagePlugin.py b/src/PIL/PngImagePlugin.py
index dc7face2f66..a87e1a625c2 100644
--- a/src/PIL/PngImagePlugin.py
+++ b/src/PIL/PngImagePlugin.py
@@ -258,7 +258,9 @@ class iTXt(str):
     tkey: str | bytes | None
 
     @staticmethod
-    def __new__(cls, text, lang=None, tkey=None):
+    def __new__(
+        cls, text: str, lang: str | None = None, tkey: str | None = None
+    ) -> iTXt:
         """
         :param cls: the class to use when creating the instance
         :param text: value for this key
diff --git a/src/PIL/TiffImagePlugin.py b/src/PIL/TiffImagePlugin.py
index ab23356d4f3..08d598f7754 100644
--- a/src/PIL/TiffImagePlugin.py
+++ b/src/PIL/TiffImagePlugin.py
@@ -61,6 +61,9 @@
 from ._util import is_path
 from .TiffTags import TYPES
 
+if TYPE_CHECKING:
+    from ._typing import IntegralLike
+
 logger = logging.getLogger(__name__)
 
 # Set these to true to force use of libtiff for reading or writing.
@@ -291,22 +294,24 @@ def _accept(prefix: bytes) -> bool:
 
 def _limit_rational(
     val: float | Fraction | IFDRational, max_val: int
-) -> tuple[float, float]:
+) -> tuple[IntegralLike, IntegralLike]:
     inv = abs(float(val)) > 1
     n_d = IFDRational(1 / val if inv else val).limit_rational(max_val)
     return n_d[::-1] if inv else n_d
 
 
-def _limit_signed_rational(val, max_val, min_val):
+def _limit_signed_rational(
+    val: IFDRational, max_val: int, min_val: int
+) -> tuple[IntegralLike, IntegralLike]:
     frac = Fraction(val)
-    n_d = frac.numerator, frac.denominator
+    n_d: tuple[IntegralLike, IntegralLike] = frac.numerator, frac.denominator
 
-    if min(n_d) < min_val:
+    if min(float(i) for i in n_d) < min_val:
         n_d = _limit_rational(val, abs(min_val))
 
-    if max(n_d) > max_val:
-        val = Fraction(*n_d)
-        n_d = _limit_rational(val, max_val)
+    n_d_float = tuple(float(i) for i in n_d)
+    if max(n_d_float) > max_val:
+        n_d = _limit_rational(n_d_float[0] / n_d_float[1], max_val)
 
     return n_d
 
@@ -318,8 +323,10 @@ def _limit_signed_rational(val, max_val, min_val):
 _write_dispatch = {}
 
 
-def _delegate(op: str):
-    def delegate(self, *args):
+def _delegate(op: str) -> Any:
+    def delegate(
+        self: IFDRational, *args: tuple[float, ...]
+    ) -> bool | float | Fraction:
         return getattr(self._val, op)(*args)
 
     return delegate
@@ -358,7 +365,10 @@ def __init__(
             self._numerator = value.numerator
             self._denominator = value.denominator
         else:
-            self._numerator = value
+            if TYPE_CHECKING:
+                self._numerator = cast(IntegralLike, value)
+            else:
+                self._numerator = value
             self._denominator = denominator
 
         if denominator == 0:
@@ -371,14 +381,14 @@ def __init__(
             self._val = Fraction(value / denominator)
 
     @property
-    def numerator(self):
+    def numerator(self) -> IntegralLike:
         return self._numerator
 
     @property
     def denominator(self) -> int:
         return self._denominator
 
-    def limit_rational(self, max_denominator: int) -> tuple[float, int]:
+    def limit_rational(self, max_denominator: int) -> tuple[IntegralLike, int]:
         """
 
         :param max_denominator: Integer, the maximum denominator value
@@ -406,14 +416,18 @@ def __eq__(self, other: object) -> bool:
             val = float(val)
         return val == other
 
-    def __getstate__(self) -> list[float | Fraction]:
+    def __getstate__(self) -> list[float | Fraction | IntegralLike]:
         return [self._val, self._numerator, self._denominator]
 
-    def __setstate__(self, state: list[float | Fraction]) -> None:
+    def __setstate__(self, state: list[float | Fraction | IntegralLike]) -> None:
         IFDRational.__init__(self, 0)
         _val, _numerator, _denominator = state
+        assert isinstance(_val, (float, Fraction))
         self._val = _val
-        self._numerator = _numerator
+        if TYPE_CHECKING:
+            self._numerator = cast(IntegralLike, _numerator)
+        else:
+            self._numerator = _numerator
         assert isinstance(_denominator, int)
         self._denominator = _denominator
 
@@ -471,8 +485,8 @@ def decorator(func: _LoaderFunc) -> _LoaderFunc:
     return decorator
 
 
-def _register_writer(idx: int):
-    def decorator(func):
+def _register_writer(idx: int) -> Callable[[Callable[..., Any]], Callable[..., Any]]:
+    def decorator(func: Callable[..., Any]) -> Callable[..., Any]:
         _write_dispatch[idx] = func  # noqa: F821
         return func
 
diff --git a/src/PIL/_typing.py b/src/PIL/_typing.py
index b6bb8d89a88..093778464da 100644
--- a/src/PIL/_typing.py
+++ b/src/PIL/_typing.py
@@ -6,6 +6,8 @@
 from typing import TYPE_CHECKING, Any, Protocol, TypeVar, Union
 
 if TYPE_CHECKING:
+    from numbers import _IntegralLike as IntegralLike
+
     try:
         import numpy.typing as npt
 
@@ -38,4 +40,4 @@ def read(self, __length: int = ...) -> _T_co: ...
 StrOrBytesPath = Union[str, bytes, "os.PathLike[str]", "os.PathLike[bytes]"]
 
 
-__all__ = ["TypeGuard", "StrOrBytesPath", "SupportsRead"]
+__all__ = ["IntegralLike", "StrOrBytesPath", "SupportsRead", "TypeGuard"]

From 95194a2050081169f0b7db02040da91b1994da5a Mon Sep 17 00:00:00 2001
From: Andrew Murray <radarhere@users.noreply.github.com>
Date: Sat, 31 Aug 2024 20:51:26 +1000
Subject: [PATCH 0970/1178] Use tempfile.NamedTemporaryFile

---
 Tests/test_imagefont.py | 45 ++++++++++++++++++++---------------------
 1 file changed, 22 insertions(+), 23 deletions(-)

diff --git a/Tests/test_imagefont.py b/Tests/test_imagefont.py
index e2a7b759ad5..80cd0d578a5 100644
--- a/Tests/test_imagefont.py
+++ b/Tests/test_imagefont.py
@@ -5,6 +5,7 @@
 import re
 import shutil
 import sys
+import tempfile
 from io import BytesIO
 from pathlib import Path
 from typing import Any, BinaryIO
@@ -460,15 +461,15 @@ def test_free_type_font_get_mask(font: ImageFont.FreeTypeFont) -> None:
     assert mask.size == (108, 13)
 
 
-def test_load_raises_if_image_not_found(tmp_path) -> None:
-    font_path = tmp_path / "file.font"
-    font_path.write_bytes(b"")
-    with pytest.raises(OSError) as excinfo:
-        ImageFont.load(font_path)
+def test_load_when_image_not_found(tmp_path: Path) -> None:
+    tmpfile = tmp_path / "file.font"
+    tmpfile.write_bytes(b"")
+    tempfile = str(tmpfile)
+    with pytest.raises(OSError) as e:
+        ImageFont.load(tempfile)
 
-    pre = tmp_path / "file"
-    msg = f"cannot find glyph data file {pre}.{{png|gif|pbm}}"
-    assert msg in str(excinfo.value)
+    root = os.path.splitext(tempfile)[0]
+    assert str(e.value) == f"cannot find glyph data file {root}.{{png|gif|pbm}}"
 
 
 def test_load_path_not_found() -> None:
@@ -476,26 +477,24 @@ def test_load_path_not_found() -> None:
     filename = "somefilenamethatdoesntexist.ttf"
 
     # Act/Assert
-    with pytest.raises(OSError):
+    with pytest.raises(OSError) as e:
         ImageFont.load_path(filename)
+
+        # The file doesn't exist, so don't suggest `load`
+        assert filename in str(e.value)
+        assert "did you mean" not in str(e.value)
     with pytest.raises(OSError):
         ImageFont.truetype(filename)
 
 
-def test_load_path_exisitng_path(tmp_path) -> None:
-    # First, the file doens't exist, so we don't suggest `load`
-    some_path = tmp_path / "file.ttf"
-    with pytest.raises(OSError) as excinfo:
-        ImageFont.load_path(str(some_path))
-        assert str(some_path) in str(excinfo.value)
-        assert "did you mean" not in str(excinfo.value)
-
-    # The file exists, so the error message suggests to use `load` instead
-    some_path.write_bytes(b"")
-    with pytest.raises(OSError) as excinfo:
-        ImageFont.load_path(str(some_path))
-    assert str(some_path) in str(excinfo.value)
-    assert " did you mean" in str(excinfo.value)
+def test_load_path_existing_path() -> None:
+    with tempfile.NamedTemporaryFile() as tmp:
+        with pytest.raises(OSError) as e:
+            ImageFont.load_path(tmp.name)
+
+        # The file exists, so the error message suggests to use `load` instead
+        assert tmp.name in str(e.value)
+    assert " did you mean" in str(e.value)
 
 
 def test_load_non_font_bytes() -> None:

From e0a75b6d695b7be82c090adb1896022e42d344ff Mon Sep 17 00:00:00 2001
From: Andrew Murray <radarhere@users.noreply.github.com>
Date: Sat, 31 Aug 2024 19:43:35 +1000
Subject: [PATCH 0971/1178] Renamed variable for first part of splitext to root

---
 src/PIL/ImageFont.py | 9 ++++-----
 1 file changed, 4 insertions(+), 5 deletions(-)

diff --git a/src/PIL/ImageFont.py b/src/PIL/ImageFont.py
index 072acc31f31..43e86a7ed25 100644
--- a/src/PIL/ImageFont.py
+++ b/src/PIL/ImageFont.py
@@ -98,13 +98,13 @@ class ImageFont:
     def _load_pilfont(self, filename: str) -> None:
         with open(filename, "rb") as fp:
             image: ImageFile.ImageFile | None = None
-            filename_body = os.path.splitext(filename)[0]
+            root = os.path.splitext(filename)[0]
 
             for ext in (".png", ".gif", ".pbm"):
                 if image:
                     image.close()
                 try:
-                    fullname = filename_body + ext
+                    fullname = root + ext
                     image = Image.open(fullname)
                 except Exception:
                     pass
@@ -115,8 +115,7 @@ def _load_pilfont(self, filename: str) -> None:
                 if image:
                     image.close()
 
-                pre = filename_body
-                msg = f"cannot find glyph data file {pre}.{{png|gif|pbm}}"
+                msg = f"cannot find glyph data file {root}.{{png|gif|pbm}}"
                 raise OSError(msg)
 
             self.file = fullname
@@ -937,7 +936,7 @@ def load_path(filename: str | bytes) -> ImageFont:
             pass
     msg = f"cannot find font file '{filename}' in `sys.path`"
     if os.path.exists(filename):
-        msg += f" did you mean `ImageFont.load({filename})` instead?"
+        msg += f", did you mean `ImageFont.load({filename})` instead?"
 
     raise OSError(msg)
 

From fcca8a3059f94640dee493164b54ec466c13ff74 Mon Sep 17 00:00:00 2001
From: Yngve Mardal Moe <yngve.m.moe@gmail.com>
Date: Sat, 31 Aug 2024 19:03:11 +0000
Subject: [PATCH 0972/1178] Fix accidental indent

---
 Tests/test_imagefont.py | 4 ++--
 1 file changed, 2 insertions(+), 2 deletions(-)

diff --git a/Tests/test_imagefont.py b/Tests/test_imagefont.py
index e2a7b759ad5..80ec7bd6b32 100644
--- a/Tests/test_imagefont.py
+++ b/Tests/test_imagefont.py
@@ -487,8 +487,8 @@ def test_load_path_exisitng_path(tmp_path) -> None:
     some_path = tmp_path / "file.ttf"
     with pytest.raises(OSError) as excinfo:
         ImageFont.load_path(str(some_path))
-        assert str(some_path) in str(excinfo.value)
-        assert "did you mean" not in str(excinfo.value)
+    assert str(some_path) in str(excinfo.value)
+    assert "did you mean" not in str(excinfo.value)
 
     # The file exists, so the error message suggests to use `load` instead
     some_path.write_bytes(b"")

From ef51e7a1c70ae684615724750c32ba3ca6923123 Mon Sep 17 00:00:00 2001
From: Yngve Mardal Moe <yngve.m.moe@gmail.com>
Date: Sun, 1 Sep 2024 19:49:44 +0000
Subject: [PATCH 0973/1178] Fix wrong indentation for assert

---
 Tests/test_imagefont.py | 6 +++---
 1 file changed, 3 insertions(+), 3 deletions(-)

diff --git a/Tests/test_imagefont.py b/Tests/test_imagefont.py
index 80cd0d578a5..66e6947c2be 100644
--- a/Tests/test_imagefont.py
+++ b/Tests/test_imagefont.py
@@ -480,9 +480,9 @@ def test_load_path_not_found() -> None:
     with pytest.raises(OSError) as e:
         ImageFont.load_path(filename)
 
-        # The file doesn't exist, so don't suggest `load`
-        assert filename in str(e.value)
-        assert "did you mean" not in str(e.value)
+    # The file doesn't exist, so don't suggest `load`
+    assert filename in str(e.value)
+    assert "did you mean" not in str(e.value)
     with pytest.raises(OSError):
         ImageFont.truetype(filename)
 

From 2303c063cb9660c8fdd4a5d757e1d971cd47dcf8 Mon Sep 17 00:00:00 2001
From: Aleksandr Karpinskii <homm86@gmail.com>
Date: Mon, 2 Sep 2024 01:24:51 +0400
Subject: [PATCH 0974/1178] Use PyCapsule in _imagingmath

---
 src/PIL/ImageMath.py |   4 +-
 src/_imagingmath.c   | 153 +++++++++++++++++++++++++++----------------
 2 files changed, 98 insertions(+), 59 deletions(-)

diff --git a/src/PIL/ImageMath.py b/src/PIL/ImageMath.py
index 191cc2a5f88..b32742657ba 100644
--- a/src/PIL/ImageMath.py
+++ b/src/PIL/ImageMath.py
@@ -65,7 +65,7 @@ def apply(
             except AttributeError as e:
                 msg = f"bad operand type for '{op}'"
                 raise TypeError(msg) from e
-            _imagingmath.unop(op, out.im.id, im_1.im.id)
+            _imagingmath.unop(op, out.im.ptr, im_1.im.ptr)
         else:
             # binary operation
             im_2 = self.__fixup(im2)
@@ -93,7 +93,7 @@ def apply(
             except AttributeError as e:
                 msg = f"bad operand type for '{op}'"
                 raise TypeError(msg) from e
-            _imagingmath.binop(op, out.im.id, im_1.im.id, im_2.im.id)
+            _imagingmath.binop(op, out.im.ptr, im_1.im.ptr, im_2.im.ptr)
         return _Operand(out)
 
     # unary operators
diff --git a/src/_imagingmath.c b/src/_imagingmath.c
index 550a1090382..eafcf1444e9 100644
--- a/src/_imagingmath.c
+++ b/src/_imagingmath.c
@@ -23,6 +23,9 @@
 #define MAX_INT32 2147483647.0
 #define MIN_INT32 -2147483648.0
 
+#define MATH_FUNC_UNOP_MAGIC "Pillow Math unary func"
+#define MATH_FUNC_BINOP_MAGIC "Pillow Math binary func"
+
 #define UNOP(name, op, type)                   \
     void name(Imaging out, Imaging im1) {      \
         int x, y;                              \
@@ -168,15 +171,28 @@ _unop(PyObject *self, PyObject *args) {
     Imaging im1;
     void (*unop)(Imaging, Imaging);
 
-    Py_ssize_t op, i0, i1;
-    if (!PyArg_ParseTuple(args, "nnn", &op, &i0, &i1)) {
+    PyObject *op, *i0, *i1;
+    if (!PyArg_ParseTuple(args, "OOO", &op, &i0, &i1)) {
         return NULL;
     }
 
-    out = (Imaging)i0;
-    im1 = (Imaging)i1;
+    if (!PyCapsule_IsValid(op, MATH_FUNC_UNOP_MAGIC)) {
+        PyErr_Format(
+            PyExc_TypeError, "Expected PyCapsule with '%s' name.", MATH_FUNC_UNOP_MAGIC
+        );
+        return NULL;
+    }
+    if (!PyCapsule_IsValid(i0, IMAGING_MAGIC) ||
+        !PyCapsule_IsValid(i1, IMAGING_MAGIC)) {
+        PyErr_Format(
+            PyExc_TypeError, "Expected PyCapsule with '%s' name.", IMAGING_MAGIC
+        );
+        return NULL;
+    }
 
-    unop = (void *)op;
+    unop = (void *)PyCapsule_GetPointer(op, MATH_FUNC_UNOP_MAGIC);
+    out = (Imaging)PyCapsule_GetPointer(i0, IMAGING_MAGIC);
+    im1 = (Imaging)PyCapsule_GetPointer(i1, IMAGING_MAGIC);
 
     unop(out, im1);
 
@@ -191,16 +207,30 @@ _binop(PyObject *self, PyObject *args) {
     Imaging im2;
     void (*binop)(Imaging, Imaging, Imaging);
 
-    Py_ssize_t op, i0, i1, i2;
-    if (!PyArg_ParseTuple(args, "nnnn", &op, &i0, &i1, &i2)) {
+    PyObject *op, *i0, *i1, *i2;
+    if (!PyArg_ParseTuple(args, "OOOO", &op, &i0, &i1, &i2)) {
         return NULL;
     }
 
-    out = (Imaging)i0;
-    im1 = (Imaging)i1;
-    im2 = (Imaging)i2;
+    if (!PyCapsule_IsValid(op, MATH_FUNC_BINOP_MAGIC)) {
+        PyErr_Format(
+            PyExc_TypeError, "Expected PyCapsule with '%s' name.", MATH_FUNC_BINOP_MAGIC
+        );
+        return NULL;
+    }
+    if (!PyCapsule_IsValid(i0, IMAGING_MAGIC) ||
+        !PyCapsule_IsValid(i1, IMAGING_MAGIC) ||
+        !PyCapsule_IsValid(i2, IMAGING_MAGIC)) {
+        PyErr_Format(
+            PyExc_TypeError, "Expected PyCapsule with '%s' name.", IMAGING_MAGIC
+        );
+        return NULL;
+    }
 
-    binop = (void *)op;
+    binop = (void *)PyCapsule_GetPointer(op, MATH_FUNC_BINOP_MAGIC);
+    out = (Imaging)PyCapsule_GetPointer(i0, IMAGING_MAGIC);
+    im1 = (Imaging)PyCapsule_GetPointer(i1, IMAGING_MAGIC);
+    im2 = (Imaging)PyCapsule_GetPointer(i2, IMAGING_MAGIC);
 
     binop(out, im1, im2);
 
@@ -213,8 +243,17 @@ static PyMethodDef _functions[] = {
 };
 
 static void
-install(PyObject *d, char *name, void *value) {
-    PyObject *v = PyLong_FromSsize_t((Py_ssize_t)value);
+install_unary(PyObject *d, char *name, void *func) {
+    PyObject *v = PyCapsule_New(func, MATH_FUNC_UNOP_MAGIC, NULL);
+    if (!v || PyDict_SetItemString(d, name, v)) {
+        PyErr_Clear();
+    }
+    Py_XDECREF(v);
+}
+
+static void
+install_binary(PyObject *d, char *name, void *func) {
+    PyObject *v = PyCapsule_New(func, MATH_FUNC_BINOP_MAGIC, NULL);
     if (!v || PyDict_SetItemString(d, name, v)) {
         PyErr_Clear();
     }
@@ -225,50 +264,50 @@ static int
 setup_module(PyObject *m) {
     PyObject *d = PyModule_GetDict(m);
 
-    install(d, "abs_I", abs_I);
-    install(d, "neg_I", neg_I);
-    install(d, "add_I", add_I);
-    install(d, "sub_I", sub_I);
-    install(d, "diff_I", diff_I);
-    install(d, "mul_I", mul_I);
-    install(d, "div_I", div_I);
-    install(d, "mod_I", mod_I);
-    install(d, "min_I", min_I);
-    install(d, "max_I", max_I);
-    install(d, "pow_I", pow_I);
-
-    install(d, "invert_I", invert_I);
-    install(d, "and_I", and_I);
-    install(d, "or_I", or_I);
-    install(d, "xor_I", xor_I);
-    install(d, "lshift_I", lshift_I);
-    install(d, "rshift_I", rshift_I);
-
-    install(d, "eq_I", eq_I);
-    install(d, "ne_I", ne_I);
-    install(d, "lt_I", lt_I);
-    install(d, "le_I", le_I);
-    install(d, "gt_I", gt_I);
-    install(d, "ge_I", ge_I);
-
-    install(d, "abs_F", abs_F);
-    install(d, "neg_F", neg_F);
-    install(d, "add_F", add_F);
-    install(d, "sub_F", sub_F);
-    install(d, "diff_F", diff_F);
-    install(d, "mul_F", mul_F);
-    install(d, "div_F", div_F);
-    install(d, "mod_F", mod_F);
-    install(d, "min_F", min_F);
-    install(d, "max_F", max_F);
-    install(d, "pow_F", pow_F);
-
-    install(d, "eq_F", eq_F);
-    install(d, "ne_F", ne_F);
-    install(d, "lt_F", lt_F);
-    install(d, "le_F", le_F);
-    install(d, "gt_F", gt_F);
-    install(d, "ge_F", ge_F);
+    install_unary(d, "abs_I", abs_I);
+    install_unary(d, "neg_I", neg_I);
+    install_binary(d, "add_I", add_I);
+    install_binary(d, "sub_I", sub_I);
+    install_binary(d, "diff_I", diff_I);
+    install_binary(d, "mul_I", mul_I);
+    install_binary(d, "div_I", div_I);
+    install_binary(d, "mod_I", mod_I);
+    install_binary(d, "min_I", min_I);
+    install_binary(d, "max_I", max_I);
+    install_binary(d, "pow_I", pow_I);
+
+    install_unary(d, "invert_I", invert_I);
+    install_binary(d, "and_I", and_I);
+    install_binary(d, "or_I", or_I);
+    install_binary(d, "xor_I", xor_I);
+    install_binary(d, "lshift_I", lshift_I);
+    install_binary(d, "rshift_I", rshift_I);
+
+    install_binary(d, "eq_I", eq_I);
+    install_binary(d, "ne_I", ne_I);
+    install_binary(d, "lt_I", lt_I);
+    install_binary(d, "le_I", le_I);
+    install_binary(d, "gt_I", gt_I);
+    install_binary(d, "ge_I", ge_I);
+
+    install_unary(d, "abs_F", abs_F);
+    install_unary(d, "neg_F", neg_F);
+    install_binary(d, "add_F", add_F);
+    install_binary(d, "sub_F", sub_F);
+    install_binary(d, "diff_F", diff_F);
+    install_binary(d, "mul_F", mul_F);
+    install_binary(d, "div_F", div_F);
+    install_binary(d, "mod_F", mod_F);
+    install_binary(d, "min_F", min_F);
+    install_binary(d, "max_F", max_F);
+    install_binary(d, "pow_F", pow_F);
+
+    install_binary(d, "eq_F", eq_F);
+    install_binary(d, "ne_F", ne_F);
+    install_binary(d, "lt_F", lt_F);
+    install_binary(d, "le_F", le_F);
+    install_binary(d, "gt_F", gt_F);
+    install_binary(d, "ge_F", ge_F);
 
     return 0;
 }

From a9798e78af90674d2983c749c2bb63af9a9e5a6f Mon Sep 17 00:00:00 2001
From: Aleksandr Karpinskii <homm86@gmail.com>
Date: Mon, 2 Sep 2024 01:32:28 +0400
Subject: [PATCH 0975/1178] Use PyCapsule in _imagingcms

---
 src/PIL/ImageCms.py |  4 ++--
 src/_imagingcms.c   | 21 ++++++++++++---------
 2 files changed, 14 insertions(+), 11 deletions(-)

diff --git a/src/PIL/ImageCms.py b/src/PIL/ImageCms.py
index ec10230f12b..5e256b0ab7f 100644
--- a/src/PIL/ImageCms.py
+++ b/src/PIL/ImageCms.py
@@ -352,7 +352,7 @@ def apply(self, im: Image.Image, imOut: Image.Image | None = None) -> Image.Imag
         im.load()
         if imOut is None:
             imOut = Image.new(self.output_mode, im.size, None)
-        self.transform.apply(im.im.id, imOut.im.id)
+        self.transform.apply(im.im.ptr, imOut.im.ptr)
         imOut.info["icc_profile"] = self.output_profile.tobytes()
         return imOut
 
@@ -361,7 +361,7 @@ def apply_in_place(self, im: Image.Image) -> Image.Image:
         if im.mode != self.output_mode:
             msg = "mode mismatch"
             raise ValueError(msg)  # wrong output mode
-        self.transform.apply(im.im.id, im.im.id)
+        self.transform.apply(im.im.ptr, im.im.ptr)
         im.info["icc_profile"] = self.output_profile.tobytes()
         return im
 
diff --git a/src/_imagingcms.c b/src/_imagingcms.c
index bafe787a743..444b6a60237 100644
--- a/src/_imagingcms.c
+++ b/src/_imagingcms.c
@@ -531,23 +531,26 @@ buildProofTransform(PyObject *self, PyObject *args) {
 
 static PyObject *
 cms_transform_apply(CmsTransformObject *self, PyObject *args) {
-    Py_ssize_t idIn;
-    Py_ssize_t idOut;
+    PyObject *i0, *i1;
     Imaging im;
     Imaging imOut;
 
-    int result;
-
-    if (!PyArg_ParseTuple(args, "nn:apply", &idIn, &idOut)) {
+    if (!PyArg_ParseTuple(args, "OO:apply", &i0, &i1)) {
         return NULL;
     }
 
-    im = (Imaging)idIn;
-    imOut = (Imaging)idOut;
+    if (!PyCapsule_IsValid(i0, IMAGING_MAGIC) ||
+        !PyCapsule_IsValid(i1, IMAGING_MAGIC)) {
+        PyErr_Format(
+            PyExc_TypeError, "Expected PyCapsule with '%s' name.", IMAGING_MAGIC
+        );
+        return NULL;
+    }
 
-    result = pyCMSdoTransform(im, imOut, self->transform);
+    im = (Imaging)PyCapsule_GetPointer(i0, IMAGING_MAGIC);
+    imOut = (Imaging)PyCapsule_GetPointer(i1, IMAGING_MAGIC);
 
-    return Py_BuildValue("i", result);
+    return Py_BuildValue("i", pyCMSdoTransform(im, imOut, self->transform));
 }
 
 /* -------------------------------------------------------------------- */

From 2fcab263d3e3aae6156a18a0180e00954f032153 Mon Sep 17 00:00:00 2001
From: Aleksandr Karpinskii <homm86@gmail.com>
Date: Mon, 2 Sep 2024 01:43:38 +0400
Subject: [PATCH 0976/1178] Use PyCapsule in _imagingmorph

---
 Tests/test_imagemorph.py |  8 +++----
 src/PIL/ImageMorph.py    |  6 ++---
 src/_imagingmorph.c      | 48 ++++++++++++++++++++++++++++++----------
 3 files changed, 43 insertions(+), 19 deletions(-)

diff --git a/Tests/test_imagemorph.py b/Tests/test_imagemorph.py
index 80d8c38155b..04860fd616c 100644
--- a/Tests/test_imagemorph.py
+++ b/Tests/test_imagemorph.py
@@ -328,13 +328,13 @@ def test_wrong_mode() -> None:
     iml = Image.new("L", (10, 10))
 
     with pytest.raises(RuntimeError):
-        _imagingmorph.apply(bytes(lut), imrgb.im.id, iml.im.id)
+        _imagingmorph.apply(bytes(lut), imrgb.im.ptr, iml.im.ptr)
 
     with pytest.raises(RuntimeError):
-        _imagingmorph.apply(bytes(lut), iml.im.id, imrgb.im.id)
+        _imagingmorph.apply(bytes(lut), iml.im.ptr, imrgb.im.ptr)
 
     with pytest.raises(RuntimeError):
-        _imagingmorph.match(bytes(lut), imrgb.im.id)
+        _imagingmorph.match(bytes(lut), imrgb.im.ptr)
 
     # Should not raise
-    _imagingmorph.match(bytes(lut), iml.im.id)
+    _imagingmorph.match(bytes(lut), iml.im.ptr)
diff --git a/src/PIL/ImageMorph.py b/src/PIL/ImageMorph.py
index 6a43983d33d..bc7ed66d3fb 100644
--- a/src/PIL/ImageMorph.py
+++ b/src/PIL/ImageMorph.py
@@ -213,7 +213,7 @@ def apply(self, image: Image.Image) -> tuple[int, Image.Image]:
             msg = "Image mode must be L"
             raise ValueError(msg)
         outimage = Image.new(image.mode, image.size, None)
-        count = _imagingmorph.apply(bytes(self.lut), image.im.id, outimage.im.id)
+        count = _imagingmorph.apply(bytes(self.lut), image.im.ptr, outimage.im.ptr)
         return count, outimage
 
     def match(self, image: Image.Image) -> list[tuple[int, int]]:
@@ -229,7 +229,7 @@ def match(self, image: Image.Image) -> list[tuple[int, int]]:
         if image.mode != "L":
             msg = "Image mode must be L"
             raise ValueError(msg)
-        return _imagingmorph.match(bytes(self.lut), image.im.id)
+        return _imagingmorph.match(bytes(self.lut), image.im.ptr)
 
     def get_on_pixels(self, image: Image.Image) -> list[tuple[int, int]]:
         """Get a list of all turned on pixels in a binary image
@@ -240,7 +240,7 @@ def get_on_pixels(self, image: Image.Image) -> list[tuple[int, int]]:
         if image.mode != "L":
             msg = "Image mode must be L"
             raise ValueError(msg)
-        return _imagingmorph.get_on_pixels(image.im.id)
+        return _imagingmorph.get_on_pixels(image.im.ptr)
 
     def load_lut(self, filename: str) -> None:
         """Load an operator from an mrl file"""
diff --git a/src/_imagingmorph.c b/src/_imagingmorph.c
index 614dfbe7fe7..c7933cc7d5e 100644
--- a/src/_imagingmorph.c
+++ b/src/_imagingmorph.c
@@ -30,15 +30,15 @@
 static PyObject *
 apply(PyObject *self, PyObject *args) {
     const char *lut;
-    PyObject *py_lut;
-    Py_ssize_t lut_len, i0, i1;
+    PyObject *py_lut, *i0, *i1;
+    Py_ssize_t lut_len;
     Imaging imgin, imgout;
     int width, height;
     int row_idx, col_idx;
     UINT8 **inrows, **outrows;
     int num_changed_pixels = 0;
 
-    if (!PyArg_ParseTuple(args, "Onn", &py_lut, &i0, &i1)) {
+    if (!PyArg_ParseTuple(args, "OOO", &py_lut, &i0, &i1)) {
         PyErr_SetString(PyExc_RuntimeError, "Argument parsing problem");
         return NULL;
     }
@@ -57,8 +57,16 @@ apply(PyObject *self, PyObject *args) {
 
     lut = PyBytes_AsString(py_lut);
 
-    imgin = (Imaging)i0;
-    imgout = (Imaging)i1;
+    if (!PyCapsule_IsValid(i0, IMAGING_MAGIC) ||
+        !PyCapsule_IsValid(i1, IMAGING_MAGIC)) {
+        PyErr_Format(
+            PyExc_TypeError, "Expected PyCapsule with '%s' name.", IMAGING_MAGIC
+        );
+        return NULL;
+    }
+
+    imgin = (Imaging)PyCapsule_GetPointer(i0, IMAGING_MAGIC);
+    imgout = (Imaging)PyCapsule_GetPointer(i1, IMAGING_MAGIC);
     width = imgin->xsize;
     height = imgin->ysize;
 
@@ -129,8 +137,8 @@ apply(PyObject *self, PyObject *args) {
 static PyObject *
 match(PyObject *self, PyObject *args) {
     const char *lut;
-    PyObject *py_lut;
-    Py_ssize_t lut_len, i0;
+    PyObject *py_lut, *i0;
+    Py_ssize_t lut_len;
     Imaging imgin;
     int width, height;
     int row_idx, col_idx;
@@ -140,7 +148,7 @@ match(PyObject *self, PyObject *args) {
         return NULL;
     }
 
-    if (!PyArg_ParseTuple(args, "On", &py_lut, &i0)) {
+    if (!PyArg_ParseTuple(args, "OO", &py_lut, &i0)) {
         Py_DECREF(ret);
         PyErr_SetString(PyExc_RuntimeError, "Argument parsing problem");
         return NULL;
@@ -161,7 +169,15 @@ match(PyObject *self, PyObject *args) {
     }
 
     lut = PyBytes_AsString(py_lut);
-    imgin = (Imaging)i0;
+
+    if (!PyCapsule_IsValid(i0, IMAGING_MAGIC)) {
+        PyErr_Format(
+            PyExc_TypeError, "Expected PyCapsule with '%s' name.", IMAGING_MAGIC
+        );
+        return NULL;
+    }
+
+    imgin = (Imaging)PyCapsule_GetPointer(i0, IMAGING_MAGIC);
 
     if (imgin->type != IMAGING_TYPE_UINT8 || imgin->bands != 1) {
         Py_DECREF(ret);
@@ -215,7 +231,7 @@ match(PyObject *self, PyObject *args) {
 */
 static PyObject *
 get_on_pixels(PyObject *self, PyObject *args) {
-    Py_ssize_t i0;
+    PyObject *i0;
     Imaging img;
     UINT8 **rows;
     int row_idx, col_idx;
@@ -225,12 +241,20 @@ get_on_pixels(PyObject *self, PyObject *args) {
         return NULL;
     }
 
-    if (!PyArg_ParseTuple(args, "n", &i0)) {
+    if (!PyArg_ParseTuple(args, "O", &i0)) {
         Py_DECREF(ret);
         PyErr_SetString(PyExc_RuntimeError, "Argument parsing problem");
         return NULL;
     }
-    img = (Imaging)i0;
+
+    if (!PyCapsule_IsValid(i0, IMAGING_MAGIC)) {
+        PyErr_Format(
+            PyExc_TypeError, "Expected PyCapsule with '%s' name.", IMAGING_MAGIC
+        );
+        return NULL;
+    }
+
+    img = (Imaging)PyCapsule_GetPointer(i0, IMAGING_MAGIC);
     rows = img->image8;
     width = img->xsize;
     height = img->ysize;

From f246be7b13867d6c85f01e38b5d14b093ace66c7 Mon Sep 17 00:00:00 2001
From: Aleksandr Karpinskii <homm86@gmail.com>
Date: Mon, 2 Sep 2024 02:00:07 +0400
Subject: [PATCH 0977/1178] Use s# in PyArg_ParseTuple

---
 src/_imagingmorph.c         | 53 ++++++++++---------------------------
 src/libImaging/ImPlatform.h |  1 +
 2 files changed, 15 insertions(+), 39 deletions(-)

diff --git a/src/_imagingmorph.c b/src/_imagingmorph.c
index c7933cc7d5e..715cccf5142 100644
--- a/src/_imagingmorph.c
+++ b/src/_imagingmorph.c
@@ -11,7 +11,6 @@
  * See the README file for information on usage and redistribution.
  */
 
-#include "Python.h"
 #include "libImaging/Imaging.h"
 
 #define LUT_SIZE (1 << 9)
@@ -30,7 +29,7 @@
 static PyObject *
 apply(PyObject *self, PyObject *args) {
     const char *lut;
-    PyObject *py_lut, *i0, *i1;
+    PyObject *i0, *i1;
     Py_ssize_t lut_len;
     Imaging imgin, imgout;
     int width, height;
@@ -38,25 +37,15 @@ apply(PyObject *self, PyObject *args) {
     UINT8 **inrows, **outrows;
     int num_changed_pixels = 0;
 
-    if (!PyArg_ParseTuple(args, "OOO", &py_lut, &i0, &i1)) {
-        PyErr_SetString(PyExc_RuntimeError, "Argument parsing problem");
+    if (!PyArg_ParseTuple(args, "s#OO", &lut, &lut_len, &i0, &i1)) {
         return NULL;
     }
 
-    if (!PyBytes_Check(py_lut)) {
-        PyErr_SetString(PyExc_RuntimeError, "The morphology LUT is not a bytes object");
-        return NULL;
-    }
-
-    lut_len = PyBytes_Size(py_lut);
-
     if (lut_len < LUT_SIZE) {
         PyErr_SetString(PyExc_RuntimeError, "The morphology LUT has the wrong size");
         return NULL;
     }
 
-    lut = PyBytes_AsString(py_lut);
-
     if (!PyCapsule_IsValid(i0, IMAGING_MAGIC) ||
         !PyCapsule_IsValid(i1, IMAGING_MAGIC)) {
         PyErr_Format(
@@ -137,39 +126,22 @@ apply(PyObject *self, PyObject *args) {
 static PyObject *
 match(PyObject *self, PyObject *args) {
     const char *lut;
-    PyObject *py_lut, *i0;
+    PyObject *i0;
     Py_ssize_t lut_len;
     Imaging imgin;
     int width, height;
     int row_idx, col_idx;
     UINT8 **inrows;
-    PyObject *ret = PyList_New(0);
-    if (ret == NULL) {
-        return NULL;
-    }
 
-    if (!PyArg_ParseTuple(args, "OO", &py_lut, &i0)) {
-        Py_DECREF(ret);
-        PyErr_SetString(PyExc_RuntimeError, "Argument parsing problem");
+    if (!PyArg_ParseTuple(args, "s#O", &lut, &lut_len, &i0)) {
         return NULL;
     }
 
-    if (!PyBytes_Check(py_lut)) {
-        Py_DECREF(ret);
-        PyErr_SetString(PyExc_RuntimeError, "The morphology LUT is not a bytes object");
-        return NULL;
-    }
-
-    lut_len = PyBytes_Size(py_lut);
-
     if (lut_len < LUT_SIZE) {
-        Py_DECREF(ret);
         PyErr_SetString(PyExc_RuntimeError, "The morphology LUT has the wrong size");
         return NULL;
     }
 
-    lut = PyBytes_AsString(py_lut);
-
     if (!PyCapsule_IsValid(i0, IMAGING_MAGIC)) {
         PyErr_Format(
             PyExc_TypeError, "Expected PyCapsule with '%s' name.", IMAGING_MAGIC
@@ -180,11 +152,15 @@ match(PyObject *self, PyObject *args) {
     imgin = (Imaging)PyCapsule_GetPointer(i0, IMAGING_MAGIC);
 
     if (imgin->type != IMAGING_TYPE_UINT8 || imgin->bands != 1) {
-        Py_DECREF(ret);
         PyErr_SetString(PyExc_RuntimeError, "Unsupported image type");
         return NULL;
     }
 
+    PyObject *ret = PyList_New(0);
+    if (ret == NULL) {
+        return NULL;
+    }
+
     inrows = imgin->image8;
     width = imgin->xsize;
     height = imgin->ysize;
@@ -236,14 +212,8 @@ get_on_pixels(PyObject *self, PyObject *args) {
     UINT8 **rows;
     int row_idx, col_idx;
     int width, height;
-    PyObject *ret = PyList_New(0);
-    if (ret == NULL) {
-        return NULL;
-    }
 
     if (!PyArg_ParseTuple(args, "O", &i0)) {
-        Py_DECREF(ret);
-        PyErr_SetString(PyExc_RuntimeError, "Argument parsing problem");
         return NULL;
     }
 
@@ -259,6 +229,11 @@ get_on_pixels(PyObject *self, PyObject *args) {
     width = img->xsize;
     height = img->ysize;
 
+    PyObject *ret = PyList_New(0);
+    if (ret == NULL) {
+        return NULL;
+    }
+
     for (row_idx = 0; row_idx < height; row_idx++) {
         UINT8 *row = rows[row_idx];
         for (col_idx = 0; col_idx < width; col_idx++) {
diff --git a/src/libImaging/ImPlatform.h b/src/libImaging/ImPlatform.h
index f6e7fb6b921..c9b7e43b425 100644
--- a/src/libImaging/ImPlatform.h
+++ b/src/libImaging/ImPlatform.h
@@ -7,6 +7,7 @@
  * Copyright (c) Fredrik Lundh 1995-2003.
  */
 
+#define PY_SSIZE_T_CLEAN
 #include "Python.h"
 
 /* Check that we have an ANSI compliant compiler */

From 7435a06cbbd0dd98319f8c55752794eb6f11aa17 Mon Sep 17 00:00:00 2001
From: Aleksandr Karpinskii <homm86@gmail.com>
Date: Mon, 2 Sep 2024 02:19:44 +0400
Subject: [PATCH 0978/1178] Deprecate ImageCore.id and ImageCore.unsafe_ptrs

---
 Tests/test_image_getim.py | 12 ++++++++++--
 docs/deprecations.rst     | 10 ++++++++++
 src/_imaging.c            | 14 ++++++++++++++
 src/libImaging/Imaging.h  |  2 +-
 4 files changed, 35 insertions(+), 3 deletions(-)

diff --git a/Tests/test_image_getim.py b/Tests/test_image_getim.py
index 9afa02b0a8b..75d97cd4451 100644
--- a/Tests/test_image_getim.py
+++ b/Tests/test_image_getim.py
@@ -1,11 +1,19 @@
 from __future__ import annotations
 
+import pytest
+
 from .helper import hopper
 
 
 def test_sanity() -> None:
     im = hopper()
-    type_repr = repr(type(im.getim()))
 
+    type_repr = repr(type(im.getim()))
     assert "PyCapsule" in type_repr
-    assert isinstance(im.im.id, int)
+
+    with pytest.warns(DeprecationWarning):
+        assert isinstance(im.im.id, int)
+
+    with pytest.warns(DeprecationWarning):
+        ptrs = dict(im.im.unsafe_ptrs)
+    assert all(k in ptrs for k in ["image8", "image32", "image"])
diff --git a/docs/deprecations.rst b/docs/deprecations.rst
index a9498d5ed5e..5bb0ebf588a 100644
--- a/docs/deprecations.rst
+++ b/docs/deprecations.rst
@@ -136,6 +136,16 @@ Specific WebP Feature Checks
 ``True`` if the WebP module is installed, until they are removed in Pillow
 12.0.0 (2025-10-15).
 
+Get Internal Pointers to Objects
+^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
+
+.. deprecated:: 11.0.0
+
+``Image.core.ImageCore.id`` and ``Image.core.ImageCore.unsafe_ptrs``
+have been deprecated and will be removed in Pillow 12 (2025-10-15).
+They were used for obtaining raw pointers to ``ImageCore`` internals. To interact with
+C code, you can use ``Image.core.ImageCore.ptr``, which returns a ``PyCapsule`` object.
+
 Removed features
 ----------------
 
diff --git a/src/_imaging.c b/src/_imaging.c
index 07d9a64ccff..a455c873b15 100644
--- a/src/_imaging.c
+++ b/src/_imaging.c
@@ -3707,6 +3707,13 @@ _getattr_bands(ImagingObject *self, void *closure) {
 
 static PyObject *
 _getattr_id(ImagingObject *self, void *closure) {
+    if (PyErr_WarnEx(
+            PyExc_DeprecationWarning,
+            "id property is deprecated and will be removed in Pillow 12.0",
+            1
+        ) < 0) {
+        return NULL;
+    }
     return PyLong_FromSsize_t((Py_ssize_t)self->image);
 }
 
@@ -3717,6 +3724,13 @@ _getattr_ptr(ImagingObject *self, void *closure) {
 
 static PyObject *
 _getattr_unsafe_ptrs(ImagingObject *self, void *closure) {
+    if (PyErr_WarnEx(
+            PyExc_DeprecationWarning,
+            "unsafe_ptrs property is deprecated and will be removed in Pillow 12.0",
+            1
+        ) < 0) {
+        return NULL;
+    }
     return Py_BuildValue(
         "(sn)(sn)(sn)",
         "image8",
diff --git a/src/libImaging/Imaging.h b/src/libImaging/Imaging.h
index 321dce988c3..870f5ed971a 100644
--- a/src/libImaging/Imaging.h
+++ b/src/libImaging/Imaging.h
@@ -61,7 +61,7 @@ typedef struct ImagingOutlineInstance *ImagingOutline;
 typedef struct ImagingPaletteInstance *ImagingPalette;
 
 /* handle magics (used with PyCObject). */
-#define IMAGING_MAGIC "PIL Imaging"
+#define IMAGING_MAGIC "Pillow Imaging"
 
 /* pixel types */
 #define IMAGING_TYPE_UINT8 0

From c69ad03af0216f1cce2d9f1c1653bec6c295e6a6 Mon Sep 17 00:00:00 2001
From: Aleksandr Karpinskii <homm86@gmail.com>
Date: Mon, 2 Sep 2024 03:45:18 +0400
Subject: [PATCH 0979/1178] Remove legacy 1-bit api, fix AttributeError

PytestUnraisableExceptionWarning: Exception ignored in: <function PhotoImage.__del__>
AttributeError: 'PhotoImage' object has no attribute '_PhotoImage__photo'
---
 src/PIL/ImageTk.py | 28 +++++-----------------------
 1 file changed, 5 insertions(+), 23 deletions(-)

diff --git a/src/PIL/ImageTk.py b/src/PIL/ImageTk.py
index a788c9d1f13..d546989eeec 100644
--- a/src/PIL/ImageTk.py
+++ b/src/PIL/ImageTk.py
@@ -35,20 +35,6 @@
 # --------------------------------------------------------------------
 # Check for Tkinter interface hooks
 
-_pilbitmap_ok = None
-
-
-def _pilbitmap_check() -> int:
-    global _pilbitmap_ok
-    if _pilbitmap_ok is None:
-        try:
-            im = Image.new("1", (1, 1))
-            tkinter.BitmapImage(data=f"PIL:{im.im.id}")
-            _pilbitmap_ok = 1
-        except tkinter.TclError:
-            _pilbitmap_ok = 0
-    return _pilbitmap_ok
-
 
 def _get_image_from_kw(kw: dict[str, Any]) -> ImageFile.ImageFile | None:
     source = None
@@ -142,6 +128,8 @@ def __init__(
             self.paste(image)
 
     def __del__(self) -> None:
+        if not hasattr(self, "__photo"):
+            return
         name = self.__photo.name
         self.__photo.name = None
         try:
@@ -225,17 +213,11 @@ def __init__(self, image: Image.Image | None = None, **kw: Any) -> None:
         self.__mode = image.mode
         self.__size = image.size
 
-        if _pilbitmap_check():
-            # fast way (requires the pilbitmap booster patch)
-            image.load()
-            kw["data"] = f"PIL:{image.im.id}"
-            self.__im = image  # must keep a reference
-        else:
-            # slow but safe way
-            kw["data"] = image.tobitmap()
-        self.__photo = tkinter.BitmapImage(**kw)
+        self.__photo = tkinter.BitmapImage(data=image.tobitmap(), **kw)
 
     def __del__(self) -> None:
+        if not hasattr(self, "__photo"):
+            return
         name = self.__photo.name
         self.__photo.name = None
         try:

From 920c4ac4479ee12636f90e281e14e8bfc89b0580 Mon Sep 17 00:00:00 2001
From: Aleksandr Karpinskii <homm86@gmail.com>
Date: Mon, 2 Sep 2024 04:29:34 +0400
Subject: [PATCH 0980/1178] Use PyCapsule in _imagingtk

---
 src/PIL/ImageTk.py | 11 +++++------
 src/Tk/tkImaging.c | 35 ++++++++++++++++++++++++++---------
 2 files changed, 31 insertions(+), 15 deletions(-)

diff --git a/src/PIL/ImageTk.py b/src/PIL/ImageTk.py
index d546989eeec..279a21716b2 100644
--- a/src/PIL/ImageTk.py
+++ b/src/PIL/ImageTk.py
@@ -48,18 +48,18 @@ def _get_image_from_kw(kw: dict[str, Any]) -> ImageFile.ImageFile | None:
 
 
 def _pyimagingtkcall(
-    command: str, photo: PhotoImage | tkinter.PhotoImage, id: int
+    command: str, photo: PhotoImage | tkinter.PhotoImage, ptr: object
 ) -> None:
     tk = photo.tk
     try:
-        tk.call(command, photo, id)
+        tk.call(command, photo, repr(ptr))
     except tkinter.TclError:
         # activate Tkinter hook
         # may raise an error if it cannot attach to Tkinter
         from . import _imagingtk
 
         _imagingtk.tkinit(tk.interpaddr())
-        tk.call(command, photo, id)
+        tk.call(command, photo, repr(ptr))
 
 
 # --------------------------------------------------------------------
@@ -181,7 +181,7 @@ def paste(self, im: Image.Image) -> None:
             block = image.new_block(self.__mode, im.size)
             image.convert2(block, image)  # convert directly between buffers
 
-        _pyimagingtkcall("PyImagingPhoto", self.__photo, block.id)
+        _pyimagingtkcall("PyImagingPhoto", self.__photo, block.ptr)
 
 
 # --------------------------------------------------------------------
@@ -255,9 +255,8 @@ def __str__(self) -> str:
 def getimage(photo: PhotoImage) -> Image.Image:
     """Copies the contents of a PhotoImage to a PIL image memory."""
     im = Image.new("RGBA", (photo.width(), photo.height()))
-    block = im.im
 
-    _pyimagingtkcall("PyImagingPhotoGet", photo, block.id)
+    _pyimagingtkcall("PyImagingPhotoGet", photo, im.im.ptr)
 
     return im
 
diff --git a/src/Tk/tkImaging.c b/src/Tk/tkImaging.c
index 727ee6bed51..b33a47d3007 100644
--- a/src/Tk/tkImaging.c
+++ b/src/Tk/tkImaging.c
@@ -56,19 +56,36 @@ static Tk_PhotoPutBlock_t TK_PHOTO_PUT_BLOCK;
 
 static Imaging
 ImagingFind(const char *name) {
-    Py_ssize_t id;
+    PyObject *capsule;
+    int direct_pointer = 0;
+    const char *expected = "capsule object \"" IMAGING_MAGIC "\" at 0x";
 
-    /* FIXME: use CObject instead? */
-#if defined(_WIN64)
-    id = _atoi64(name);
-#else
-    id = atol(name);
-#endif
-    if (!id) {
+    if (name[0] == '<') {
+        name++;
+    } else {
+        // Special case for PyPy, where the string representation of a Capsule
+        // refers directly to the pointer itself, not to the PyCapsule object.
+        direct_pointer = 1;
+    }
+
+    if (strncmp(name, expected, strlen(expected))) {
+        return NULL;
+    }
+
+    capsule = (PyObject *)strtoull(name + strlen(expected), NULL, 16);
+
+    if (direct_pointer) {
+        return (Imaging)capsule;
+    }
+
+    if (!PyCapsule_IsValid(capsule, IMAGING_MAGIC)) {
+        PyErr_Format(
+            PyExc_TypeError, "Expected PyCapsule with '%s' name.", IMAGING_MAGIC
+        );
         return NULL;
     }
 
-    return (Imaging)id;
+    return (Imaging)PyCapsule_GetPointer(capsule, IMAGING_MAGIC);
 }
 
 static int

From 147f75ee9376688560942f814a66ea0c2ad03361 Mon Sep 17 00:00:00 2001
From: Aleksandr Karpinskii <homm86@gmail.com>
Date: Mon, 2 Sep 2024 13:04:57 +0400
Subject: [PATCH 0981/1178] Use PyCapsule in _imagingft

---
 src/_imagingft.c | 8 +++-----
 1 file changed, 3 insertions(+), 5 deletions(-)

diff --git a/src/_imagingft.c b/src/_imagingft.c
index f8143e0cc32..af5d80f87ce 100644
--- a/src/_imagingft.c
+++ b/src/_imagingft.c
@@ -824,7 +824,6 @@ font_render(FontObject *self, PyObject *args) {
     unsigned char convert_scale;    /* scale factor for non-8bpp bitmaps */
     PyObject *image;
     Imaging im;
-    Py_ssize_t id;
     int mask = 0;  /* is FT_LOAD_TARGET_MONO enabled? */
     int color = 0; /* is FT_LOAD_COLOR enabled? */
     int stroke_width = 0;
@@ -923,10 +922,9 @@ font_render(FontObject *self, PyObject *args) {
         PyMem_Del(glyph_info);
         return NULL;
     }
-    PyObject *imageId = PyObject_GetAttrString(image, "id");
-    id = PyLong_AsSsize_t(imageId);
-    Py_XDECREF(imageId);
-    im = (Imaging)id;
+    PyObject *imagePtr = PyObject_GetAttrString(image, "ptr");
+    im = (Imaging)PyCapsule_GetPointer(imagePtr, IMAGING_MAGIC);
+    Py_XDECREF(imagePtr);
 
     x_offset -= stroke_width;
     y_offset -= stroke_width;

From 6b59e3822f202f475b8b5440949a5b673019286b Mon Sep 17 00:00:00 2001
From: "pre-commit-ci[bot]"
 <66853113+pre-commit-ci[bot]@users.noreply.github.com>
Date: Mon, 2 Sep 2024 17:26:20 +0000
Subject: [PATCH 0982/1178] [pre-commit.ci] pre-commit autoupdate
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit

updates:
- [github.com/astral-sh/ruff-pre-commit: v0.6.0 → v0.6.3](https://github.com/astral-sh/ruff-pre-commit/compare/v0.6.0...v0.6.3)
- [github.com/python-jsonschema/check-jsonschema: 0.29.1 → 0.29.2](https://github.com/python-jsonschema/check-jsonschema/compare/0.29.1...0.29.2)
---
 .pre-commit-config.yaml | 4 ++--
 1 file changed, 2 insertions(+), 2 deletions(-)

diff --git a/.pre-commit-config.yaml b/.pre-commit-config.yaml
index 8ab478e848a..14d75c6892e 100644
--- a/.pre-commit-config.yaml
+++ b/.pre-commit-config.yaml
@@ -1,6 +1,6 @@
 repos:
   - repo: https://github.com/astral-sh/ruff-pre-commit
-    rev: v0.6.0
+    rev: v0.6.3
     hooks:
       - id: ruff
         args: [--exit-non-zero-on-fix]
@@ -50,7 +50,7 @@ repos:
         exclude: ^.github/.*TEMPLATE|^Tests/(fonts|images)/
 
   - repo: https://github.com/python-jsonschema/check-jsonschema
-    rev: 0.29.1
+    rev: 0.29.2
     hooks:
       - id: check-github-workflows
       - id: check-readthedocs

From 55f49393af490fcfc0ef40f4790b53c54395a99f Mon Sep 17 00:00:00 2001
From: Andrew Murray <radarhere@users.noreply.github.com>
Date: Tue, 3 Sep 2024 09:55:06 +1000
Subject: [PATCH 0983/1178] Treat unknown colorspace as unspecified

---
 Tests/test_file_jpeg2k.py     | 9 +++++++++
 src/libImaging/Jpeg2KDecode.c | 5 ++---
 2 files changed, 11 insertions(+), 3 deletions(-)

diff --git a/Tests/test_file_jpeg2k.py b/Tests/test_file_jpeg2k.py
index 5e11465ca1d..53a105ca5f9 100644
--- a/Tests/test_file_jpeg2k.py
+++ b/Tests/test_file_jpeg2k.py
@@ -182,6 +182,15 @@ def test_restricted_icc_profile() -> None:
         ImageFile.LOAD_TRUNCATED_IMAGES = False
 
 
+@pytest.mark.skipif(
+    not os.path.exists(EXTRA_DIR), reason="Extra image files not installed"
+)
+def test_unknown_colorspace() -> None:
+    with Image.open(f"{EXTRA_DIR}/file8.jp2") as im:
+        im.load()
+        assert im.mode == "L"
+
+
 def test_header_errors() -> None:
     for path in (
         "Tests/images/invalid_header_length.jp2",
diff --git a/src/libImaging/Jpeg2KDecode.c b/src/libImaging/Jpeg2KDecode.c
index 5b3d7ffc424..a81a14a09c0 100644
--- a/src/libImaging/Jpeg2KDecode.c
+++ b/src/libImaging/Jpeg2KDecode.c
@@ -698,8 +698,7 @@ j2k_decode_entry(Imaging im, ImagingCodecState state) {
     }
 
     /* Check that this image is something we can handle */
-    if (image->numcomps < 1 || image->numcomps > 4 ||
-        image->color_space == OPJ_CLRSPC_UNKNOWN) {
+    if (image->numcomps < 1 || image->numcomps > 4) {
         state->errcode = IMAGING_CODEC_BROKEN;
         state->state = J2K_STATE_FAILED;
         goto quick_exit;
@@ -744,7 +743,7 @@ j2k_decode_entry(Imaging im, ImagingCodecState state) {
     /* Find the correct unpacker */
     color_space = image->color_space;
 
-    if (color_space == OPJ_CLRSPC_UNSPECIFIED) {
+    if (color_space == OPJ_CLRSPC_UNKNOWN || color_space == OPJ_CLRSPC_UNSPECIFIED) {
         switch (image->numcomps) {
             case 1:
             case 2:

From 61dade88e8ad55745c06e72561302bb8c21b490f Mon Sep 17 00:00:00 2001
From: Andrew Murray <radarhere@users.noreply.github.com>
Date: Tue, 3 Sep 2024 17:00:59 +1000
Subject: [PATCH 0984/1178] Update CHANGES.rst [ci skip]

---
 CHANGES.rst | 3 +++
 1 file changed, 3 insertions(+)

diff --git a/CHANGES.rst b/CHANGES.rst
index 9da76d82a12..4958ed7014a 100644
--- a/CHANGES.rst
+++ b/CHANGES.rst
@@ -5,6 +5,9 @@ Changelog (Pillow)
 11.0.0 (unreleased)
 -------------------
 
+- Treat unknown JPEG2000 colorspace as unspecified #8343
+  [radarhere]
+
 - Updated error message when saving WebP with invalid width or height #8322
   [radarhere, hugovk]
 

From bf11639626373bd27a80f790d56101d4b4e2f1c6 Mon Sep 17 00:00:00 2001
From: Aleksandr Karpinskii <homm86@gmail.com>
Date: Tue, 3 Sep 2024 11:54:24 +0400
Subject: [PATCH 0985/1178] rename PyCapsule -> Capsule

---
 docs/deprecations.rst |  2 +-
 src/Tk/tkImaging.c    |  4 +---
 src/_imagingcms.c     |  4 +---
 src/_imagingmath.c    | 16 ++++------------
 src/_imagingmorph.c   | 12 +++---------
 5 files changed, 10 insertions(+), 28 deletions(-)

diff --git a/docs/deprecations.rst b/docs/deprecations.rst
index 5bb0ebf588a..93bd51ef13e 100644
--- a/docs/deprecations.rst
+++ b/docs/deprecations.rst
@@ -144,7 +144,7 @@ Get Internal Pointers to Objects
 ``Image.core.ImageCore.id`` and ``Image.core.ImageCore.unsafe_ptrs``
 have been deprecated and will be removed in Pillow 12 (2025-10-15).
 They were used for obtaining raw pointers to ``ImageCore`` internals. To interact with
-C code, you can use ``Image.core.ImageCore.ptr``, which returns a ``PyCapsule`` object.
+C code, you can use ``Image.core.ImageCore.ptr``, which returns a ``Capsule`` object.
 
 Removed features
 ----------------
diff --git a/src/Tk/tkImaging.c b/src/Tk/tkImaging.c
index b33a47d3007..a36c3e0bdc4 100644
--- a/src/Tk/tkImaging.c
+++ b/src/Tk/tkImaging.c
@@ -79,9 +79,7 @@ ImagingFind(const char *name) {
     }
 
     if (!PyCapsule_IsValid(capsule, IMAGING_MAGIC)) {
-        PyErr_Format(
-            PyExc_TypeError, "Expected PyCapsule with '%s' name.", IMAGING_MAGIC
-        );
+        PyErr_Format(PyExc_TypeError, "Expected '%s' Capsule", IMAGING_MAGIC);
         return NULL;
     }
 
diff --git a/src/_imagingcms.c b/src/_imagingcms.c
index 444b6a60237..1823bcf0371 100644
--- a/src/_imagingcms.c
+++ b/src/_imagingcms.c
@@ -541,9 +541,7 @@ cms_transform_apply(CmsTransformObject *self, PyObject *args) {
 
     if (!PyCapsule_IsValid(i0, IMAGING_MAGIC) ||
         !PyCapsule_IsValid(i1, IMAGING_MAGIC)) {
-        PyErr_Format(
-            PyExc_TypeError, "Expected PyCapsule with '%s' name.", IMAGING_MAGIC
-        );
+        PyErr_Format(PyExc_TypeError, "Expected '%s' Capsule", IMAGING_MAGIC);
         return NULL;
     }
 
diff --git a/src/_imagingmath.c b/src/_imagingmath.c
index eafcf1444e9..dbe636707f4 100644
--- a/src/_imagingmath.c
+++ b/src/_imagingmath.c
@@ -177,16 +177,12 @@ _unop(PyObject *self, PyObject *args) {
     }
 
     if (!PyCapsule_IsValid(op, MATH_FUNC_UNOP_MAGIC)) {
-        PyErr_Format(
-            PyExc_TypeError, "Expected PyCapsule with '%s' name.", MATH_FUNC_UNOP_MAGIC
-        );
+        PyErr_Format(PyExc_TypeError, "Expected '%s' Capsule", MATH_FUNC_UNOP_MAGIC);
         return NULL;
     }
     if (!PyCapsule_IsValid(i0, IMAGING_MAGIC) ||
         !PyCapsule_IsValid(i1, IMAGING_MAGIC)) {
-        PyErr_Format(
-            PyExc_TypeError, "Expected PyCapsule with '%s' name.", IMAGING_MAGIC
-        );
+        PyErr_Format(PyExc_TypeError, "Expected '%s' Capsule", IMAGING_MAGIC);
         return NULL;
     }
 
@@ -213,17 +209,13 @@ _binop(PyObject *self, PyObject *args) {
     }
 
     if (!PyCapsule_IsValid(op, MATH_FUNC_BINOP_MAGIC)) {
-        PyErr_Format(
-            PyExc_TypeError, "Expected PyCapsule with '%s' name.", MATH_FUNC_BINOP_MAGIC
-        );
+        PyErr_Format(PyExc_TypeError, "Expected '%s' Capsule", MATH_FUNC_BINOP_MAGIC);
         return NULL;
     }
     if (!PyCapsule_IsValid(i0, IMAGING_MAGIC) ||
         !PyCapsule_IsValid(i1, IMAGING_MAGIC) ||
         !PyCapsule_IsValid(i2, IMAGING_MAGIC)) {
-        PyErr_Format(
-            PyExc_TypeError, "Expected PyCapsule with '%s' name.", IMAGING_MAGIC
-        );
+        PyErr_Format(PyExc_TypeError, "Expected '%s' Capsule", IMAGING_MAGIC);
         return NULL;
     }
 
diff --git a/src/_imagingmorph.c b/src/_imagingmorph.c
index 715cccf5142..637295be710 100644
--- a/src/_imagingmorph.c
+++ b/src/_imagingmorph.c
@@ -48,9 +48,7 @@ apply(PyObject *self, PyObject *args) {
 
     if (!PyCapsule_IsValid(i0, IMAGING_MAGIC) ||
         !PyCapsule_IsValid(i1, IMAGING_MAGIC)) {
-        PyErr_Format(
-            PyExc_TypeError, "Expected PyCapsule with '%s' name.", IMAGING_MAGIC
-        );
+        PyErr_Format(PyExc_TypeError, "Expected '%s' Capsule", IMAGING_MAGIC);
         return NULL;
     }
 
@@ -143,9 +141,7 @@ match(PyObject *self, PyObject *args) {
     }
 
     if (!PyCapsule_IsValid(i0, IMAGING_MAGIC)) {
-        PyErr_Format(
-            PyExc_TypeError, "Expected PyCapsule with '%s' name.", IMAGING_MAGIC
-        );
+        PyErr_Format(PyExc_TypeError, "Expected '%s' Capsule", IMAGING_MAGIC);
         return NULL;
     }
 
@@ -218,9 +214,7 @@ get_on_pixels(PyObject *self, PyObject *args) {
     }
 
     if (!PyCapsule_IsValid(i0, IMAGING_MAGIC)) {
-        PyErr_Format(
-            PyExc_TypeError, "Expected PyCapsule with '%s' name.", IMAGING_MAGIC
-        );
+        PyErr_Format(PyExc_TypeError, "Expected '%s' Capsule", IMAGING_MAGIC);
         return NULL;
     }
 

From 63b11966228717460e1e4170a009ef958e1704f2 Mon Sep 17 00:00:00 2001
From: Andrew Murray <radarhere@users.noreply.github.com>
Date: Wed, 4 Sep 2024 16:13:19 +1000
Subject: [PATCH 0986/1178] Updated harfbuzz to 9.0.0

---
 winbuild/build_prepare.py | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/winbuild/build_prepare.py b/winbuild/build_prepare.py
index 1021e4f229f..9216119e809 100644
--- a/winbuild/build_prepare.py
+++ b/winbuild/build_prepare.py
@@ -112,7 +112,7 @@ def cmd_msbuild(
     "BROTLI": "1.1.0",
     "FREETYPE": "2.13.2",
     "FRIBIDI": "1.0.15",
-    "HARFBUZZ": "8.5.0",
+    "HARFBUZZ": "9.0.0",
     "JPEGTURBO": "3.0.3",
     "LCMS2": "2.16",
     "LIBPNG": "1.6.43",

From be34a7da4bb25a660d83abee3495626f221e949d Mon Sep 17 00:00:00 2001
From: Andrew Murray <radarhere@users.noreply.github.com>
Date: Wed, 4 Sep 2024 19:19:39 +1000
Subject: [PATCH 0987/1178] Save xmp from info

---
 Tests/test_file_jpeg.py    | 6 ++++--
 src/PIL/JpegImagePlugin.py | 2 +-
 2 files changed, 5 insertions(+), 3 deletions(-)

diff --git a/Tests/test_file_jpeg.py b/Tests/test_file_jpeg.py
index f9c5fbc0bc7..c8981ce85d1 100644
--- a/Tests/test_file_jpeg.py
+++ b/Tests/test_file_jpeg.py
@@ -995,11 +995,13 @@ def test_save_xmp(self, tmp_path: Path) -> None:
         f = str(tmp_path / "temp.jpg")
         im = hopper()
         im.save(f, xmp=b"XMP test")
-
         with Image.open(f) as reloaded:
             assert reloaded.info["xmp"] == b"XMP test"
 
-        im.save(f, xmp=b"1" * 65504)
+        im.info["xmp"] = b"1" * 65504
+        im.save(f)
+        with Image.open(f) as reloaded:
+            assert reloaded.info["xmp"] == b"1" * 65504
 
         with pytest.raises(ValueError):
             im.save(f, xmp=b"1" * 65505)
diff --git a/src/PIL/JpegImagePlugin.py b/src/PIL/JpegImagePlugin.py
index 0cb50e0bfab..723165ec4bf 100644
--- a/src/PIL/JpegImagePlugin.py
+++ b/src/PIL/JpegImagePlugin.py
@@ -747,7 +747,7 @@ def validate_qtables(
     extra = info.get("extra", b"")
 
     MAX_BYTES_IN_MARKER = 65533
-    xmp = info.get("xmp")
+    xmp = info.get("xmp", im.info.get("xmp"))
     if xmp:
         overhead_len = 29  # b"http://ns.adobe.com/xap/1.0/\x00"
         max_data_bytes_in_marker = MAX_BYTES_IN_MARKER - overhead_len

From 8833548e55977493fcd21b8270ba515e0503a3df Mon Sep 17 00:00:00 2001
From: Aleksandr Karpinskii <homm86@gmail.com>
Date: Thu, 5 Sep 2024 01:04:35 +0400
Subject: [PATCH 0988/1178] Move new_block to module

---
 src/PIL/ImageTk.py | 2 +-
 src/_imaging.c     | 4 +---
 2 files changed, 2 insertions(+), 4 deletions(-)

diff --git a/src/PIL/ImageTk.py b/src/PIL/ImageTk.py
index 279a21716b2..5bad9b5462d 100644
--- a/src/PIL/ImageTk.py
+++ b/src/PIL/ImageTk.py
@@ -178,7 +178,7 @@ def paste(self, im: Image.Image) -> None:
         if image.isblock() and im.mode == self.__mode:
             block = image
         else:
-            block = image.new_block(self.__mode, im.size)
+            block = Image.core.new_block(self.__mode, im.size)
             image.convert2(block, image)  # convert directly between buffers
 
         _pyimagingtkcall("PyImagingPhoto", self.__photo, block.ptr)
diff --git a/src/_imaging.c b/src/_imaging.c
index a455c873b15..e227d8efc51 100644
--- a/src/_imaging.c
+++ b/src/_imaging.c
@@ -3674,15 +3674,12 @@ static struct PyMethodDef methods[] = {
     /* Unsharpmask extension */
     {"gaussian_blur", (PyCFunction)_gaussian_blur, METH_VARARGS},
     {"unsharp_mask", (PyCFunction)_unsharp_mask, METH_VARARGS},
-
     {"box_blur", (PyCFunction)_box_blur, METH_VARARGS},
 
     /* Special effects */
     {"effect_spread", (PyCFunction)_effect_spread, METH_VARARGS},
 
     /* Misc. */
-    {"new_block", (PyCFunction)_new_block, METH_VARARGS},
-
     {"save_ppm", (PyCFunction)_save_ppm, METH_VARARGS},
 
     {NULL, NULL} /* sentinel */
@@ -4212,6 +4209,7 @@ static PyMethodDef functions[] = {
     {"blend", (PyCFunction)_blend, METH_VARARGS},
     {"fill", (PyCFunction)_fill, METH_VARARGS},
     {"new", (PyCFunction)_new, METH_VARARGS},
+    {"new_block", (PyCFunction)_new_block, METH_VARARGS},
     {"merge", (PyCFunction)_merge, METH_VARARGS},
 
     /* Functions */

From 12700436827a06194e4b63a47c5e60585e52be59 Mon Sep 17 00:00:00 2001
From: Andrew Murray <radarhere@users.noreply.github.com>
Date: Thu, 5 Sep 2024 15:46:54 +1000
Subject: [PATCH 0989/1178] Return early if either width or height is zero

---
 Tests/test_box_blur.py   | 5 +++++
 src/libImaging/BoxBlur.c | 3 +++
 2 files changed, 8 insertions(+)

diff --git a/Tests/test_box_blur.py b/Tests/test_box_blur.py
index 1f6ed61277a..cb267b2048f 100644
--- a/Tests/test_box_blur.py
+++ b/Tests/test_box_blur.py
@@ -71,6 +71,11 @@ def test_color_modes() -> None:
         box_blur(sample.convert("YCbCr"))
 
 
+@pytest.mark.parametrize("size", ((0, 1), (1, 0)))
+def test_zero_dimension(size: tuple[int, int]) -> None:
+    assert box_blur(Image.new("L", size)).size == size
+
+
 def test_radius_0() -> None:
     assert_blur(
         sample,
diff --git a/src/libImaging/BoxBlur.c b/src/libImaging/BoxBlur.c
index 51cb7e1024e..ed91541fed4 100644
--- a/src/libImaging/BoxBlur.c
+++ b/src/libImaging/BoxBlur.c
@@ -238,6 +238,9 @@ ImagingBoxBlur(Imaging imOut, Imaging imIn, float xradius, float yradius, int n)
     int i;
     Imaging imTransposed;
 
+    if (imOut->xsize == 0 || imOut->ysize == 0) {
+        return imOut;
+    }
     if (n < 1) {
         return ImagingError_ValueError("number of passes must be greater than zero");
     }

From a56ac4faa878fef90a15d716bb57ea2917c9e4a5 Mon Sep 17 00:00:00 2001
From: Aryaz Eghbali <eghbali.aryaz@gmail.com>
Date: Thu, 5 Sep 2024 13:29:19 +0200
Subject: [PATCH 0990/1178] Canonical type checking

---
 Tests/test_image_array.py | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/Tests/test_image_array.py b/Tests/test_image_array.py
index bb606488286..c1b09c65974 100644
--- a/Tests/test_image_array.py
+++ b/Tests/test_image_array.py
@@ -24,7 +24,7 @@ def test(mode: str) -> tuple[tuple[int, ...], str, int]:
 
     def test_with_dtype(dtype: npt.DTypeLike) -> None:
         ai = numpy.array(im, dtype=dtype)
-        assert ai.dtype == dtype
+        assert ai.dtype.type is dtype
 
     # assert test("1") == ((100, 128), '|b1', 1600))
     assert test("L") == ((100, 128), "|u1", 12800)

From f7f3af799be98e453d6faafc6bd9b08f3bb18e79 Mon Sep 17 00:00:00 2001
From: Andrew Murray <radarhere@users.noreply.github.com>
Date: Thu, 5 Sep 2024 22:53:48 +1000
Subject: [PATCH 0991/1178] Update CHANGES.rst [ci skip]

---
 CHANGES.rst | 24 ++++++++++++++++++++++++
 1 file changed, 24 insertions(+)

diff --git a/CHANGES.rst b/CHANGES.rst
index 4958ed7014a..b43466833bd 100644
--- a/CHANGES.rst
+++ b/CHANGES.rst
@@ -5,6 +5,30 @@ Changelog (Pillow)
 11.0.0 (unreleased)
 -------------------
 
+- Return early from BoxBlur if either width or height is zero #8347
+  [radarhere]
+
+- Check text is either string or bytes #8308
+  [radarhere]
+
+- Added writing XMP bytes to JPEG #8286
+  [radarhere]
+
+- Support JPEG2000 RGBA palettes #8256
+  [radarhere]
+
+- Expand C image to match GIF frame image size #8237
+  [radarhere]
+
+- Allow saving I;16 images as PPM #8231
+  [radarhere]
+
+- When IFD is missing, connect get_ifd() dictionary to Exif #8230
+  [radarhere]
+
+- Skip truncated ICO mask if LOAD_TRUNCATED_IMAGES is enabled #8180
+  [radarhere]
+
 - Treat unknown JPEG2000 colorspace as unspecified #8343
   [radarhere]
 

From 31638ee29aae89452adf30acd41620d8c8d91373 Mon Sep 17 00:00:00 2001
From: Andrew Murray <radarhere@users.noreply.github.com>
Date: Thu, 5 Sep 2024 23:07:40 +1000
Subject: [PATCH 0992/1178] Added type hints

---
 Tests/test_file_gif.py    |  4 +++-
 src/PIL/PngImagePlugin.py | 46 ++++++++++++++++++++++-----------------
 2 files changed, 29 insertions(+), 21 deletions(-)

diff --git a/Tests/test_file_gif.py b/Tests/test_file_gif.py
index 7c332149d62..571fe1b9ac0 100644
--- a/Tests/test_file_gif.py
+++ b/Tests/test_file_gif.py
@@ -1392,7 +1392,9 @@ def test_lzw_bits() -> None:
         ),
     ),
 )
-def test_extents(test_file, loading_strategy) -> None:
+def test_extents(
+    test_file: str, loading_strategy: GifImagePlugin.LoadingStrategy
+) -> None:
     GifImagePlugin.LOADING_STRATEGY = loading_strategy
     try:
         with Image.open("Tests/images/" + test_file) as im:
diff --git a/src/PIL/PngImagePlugin.py b/src/PIL/PngImagePlugin.py
index a87e1a625c2..c268d7b1a28 100644
--- a/src/PIL/PngImagePlugin.py
+++ b/src/PIL/PngImagePlugin.py
@@ -370,21 +370,27 @@ def add_text(
 # PNG image stream (IHDR/IEND)
 
 
+class _RewindState(NamedTuple):
+    info: dict[str | tuple[int, int], Any]
+    tile: list[ImageFile._Tile]
+    seq_num: int | None
+
+
 class PngStream(ChunkStream):
-    def __init__(self, fp):
+    def __init__(self, fp: IO[bytes]) -> None:
         super().__init__(fp)
 
         # local copies of Image attributes
-        self.im_info = {}
-        self.im_text = {}
+        self.im_info: dict[str | tuple[int, int], Any] = {}
+        self.im_text: dict[str, str | iTXt] = {}
         self.im_size = (0, 0)
-        self.im_mode = None
-        self.im_tile = None
-        self.im_palette = None
-        self.im_custom_mimetype = None
-        self.im_n_frames = None
-        self._seq_num = None
-        self.rewind_state = None
+        self.im_mode = ""
+        self.im_tile: list[ImageFile._Tile] = []
+        self.im_palette: tuple[str, bytes] | None = None
+        self.im_custom_mimetype: str | None = None
+        self.im_n_frames: int | None = None
+        self._seq_num: int | None = None
+        self.rewind_state = _RewindState({}, [], None)
 
         self.text_memory = 0
 
@@ -398,16 +404,16 @@ def check_text_memory(self, chunklen: int) -> None:
             raise ValueError(msg)
 
     def save_rewind(self) -> None:
-        self.rewind_state = {
-            "info": self.im_info.copy(),
-            "tile": self.im_tile,
-            "seq_num": self._seq_num,
-        }
+        self.rewind_state = _RewindState(
+            self.im_info.copy(),
+            self.im_tile,
+            self._seq_num,
+        )
 
     def rewind(self) -> None:
-        self.im_info = self.rewind_state["info"].copy()
-        self.im_tile = self.rewind_state["tile"]
-        self._seq_num = self.rewind_state["seq_num"]
+        self.im_info = self.rewind_state.info.copy()
+        self.im_tile = self.rewind_state.tile
+        self._seq_num = self.rewind_state.seq_num
 
     def chunk_iCCP(self, pos: int, length: int) -> bytes:
         # ICC profile
@@ -461,11 +467,11 @@ def chunk_IHDR(self, pos: int, length: int) -> bytes:
     def chunk_IDAT(self, pos: int, length: int) -> NoReturn:
         # image data
         if "bbox" in self.im_info:
-            tile = [("zip", self.im_info["bbox"], pos, self.im_rawmode)]
+            tile = [ImageFile._Tile("zip", self.im_info["bbox"], pos, self.im_rawmode)]
         else:
             if self.im_n_frames is not None:
                 self.im_info["default_image"] = True
-            tile = [("zip", (0, 0) + self.im_size, pos, self.im_rawmode)]
+            tile = [ImageFile._Tile("zip", (0, 0) + self.im_size, pos, self.im_rawmode)]
         self.im_tile = tile
         self.im_idat = length
         msg = "image data found"

From e625f7311965abd0a88992ca215d8ad61a27715e Mon Sep 17 00:00:00 2001
From: Andrew Murray <radarhere@users.noreply.github.com>
Date: Fri, 6 Sep 2024 11:37:12 +1000
Subject: [PATCH 0993/1178] Added scale argument to IcnsImageFile load()

---
 Tests/test_file_icns.py              | 20 ++++++++----
 docs/handbook/image-file-formats.rst | 12 +++++++
 src/PIL/IcnsImagePlugin.py           | 49 ++++++++++++++--------------
 3 files changed, 49 insertions(+), 32 deletions(-)

diff --git a/Tests/test_file_icns.py b/Tests/test_file_icns.py
index 488984aef70..f37a6996fa4 100644
--- a/Tests/test_file_icns.py
+++ b/Tests/test_file_icns.py
@@ -63,8 +63,8 @@ def test_save_append_images(tmp_path: Path) -> None:
         assert_image_similar_tofile(im, temp_file, 1)
 
         with Image.open(temp_file) as reread:
-            reread.size = (16, 16, 2)
-            reread.load()
+            reread.size = (16, 16)
+            reread.load(2)
             assert_image_equal(reread, provided_im)
 
 
@@ -92,9 +92,15 @@ def test_sizes() -> None:
             assert im.mode == "RGBA"
             assert im.size == (wr, hr)
 
+            # Test using load() with scale
+            im.size = (w, h)
+            im.load(scale=r)
+            assert im.mode == "RGBA"
+            assert im.size == (wr, hr)
+
         # Check that we cannot load an incorrect size
         with pytest.raises(ValueError):
-            im.size = (1, 1)
+            im.size = (1, 2)
 
 
 def test_older_icon() -> None:
@@ -105,8 +111,8 @@ def test_older_icon() -> None:
             wr = w * r
             hr = h * r
             with Image.open("Tests/images/pillow2.icns") as im2:
-                im2.size = (w, h, r)
-                im2.load()
+                im2.size = (w, h)
+                im2.load(r)
                 assert im2.mode == "RGBA"
                 assert im2.size == (wr, hr)
 
@@ -122,8 +128,8 @@ def test_jp2_icon() -> None:
             wr = w * r
             hr = h * r
             with Image.open("Tests/images/pillow3.icns") as im2:
-                im2.size = (w, h, r)
-                im2.load()
+                im2.size = (w, h)
+                im2.load(r)
                 assert im2.mode == "RGBA"
                 assert im2.size == (wr, hr)
 
diff --git a/docs/handbook/image-file-formats.rst b/docs/handbook/image-file-formats.rst
index ca0e05eb6c0..a5fbc80533b 100644
--- a/docs/handbook/image-file-formats.rst
+++ b/docs/handbook/image-file-formats.rst
@@ -331,6 +331,18 @@ sets the following :py:attr:`~PIL.Image.Image.info` property:
     ask for ``(512, 512, 2)``, the final value of
     :py:attr:`~PIL.Image.Image.size` will be ``(1024, 1024)``).
 
+.. _icns-loading:
+
+Loading
+~~~~~~~
+
+You can call the :py:meth:`~PIL.Image.Image.load` method with the following parameter.
+
+**scale**
+    Affects the scale of the resultant image. If the size is set to ``(512, 512)``,
+    after loading at scale 2, the final value of :py:attr:`~PIL.Image.Image.size` will
+    be ``(1024, 1024)``.
+
 .. _icns-saving:
 
 Saving
diff --git a/src/PIL/IcnsImagePlugin.py b/src/PIL/IcnsImagePlugin.py
index ca66aa0fd1e..e4f486a4f77 100644
--- a/src/PIL/IcnsImagePlugin.py
+++ b/src/PIL/IcnsImagePlugin.py
@@ -281,31 +281,30 @@ def size(self):
 
     @size.setter
     def size(self, value) -> None:
-        info_size = value
-        if info_size not in self.info["sizes"] and len(info_size) == 2:
-            info_size = (info_size[0], info_size[1], 1)
-        if (
-            info_size not in self.info["sizes"]
-            and len(info_size) == 3
-            and info_size[2] == 1
-        ):
-            simple_sizes = [
-                (size[0] * size[2], size[1] * size[2]) for size in self.info["sizes"]
-            ]
-            if value in simple_sizes:
-                info_size = self.info["sizes"][simple_sizes.index(value)]
-        if info_size not in self.info["sizes"]:
-            msg = "This is not one of the allowed sizes of this image"
-            raise ValueError(msg)
-        self._size = value
-
-    def load(self) -> Image.core.PixelAccess | None:
-        if len(self.size) == 3:
-            self.best_size = self.size
-            self.size = (
-                self.best_size[0] * self.best_size[2],
-                self.best_size[1] * self.best_size[2],
-            )
+        if len(value) == 3:
+            if value in self.info["sizes"]:
+                self._size = value
+                return
+        else:
+            # Check that a matching size exists,
+            # or that there is a scale that would create a size that matches
+            for size in self.info["sizes"]:
+                simple_size = size[0] * size[2], size[1] * size[2]
+                scale = simple_size[0] // value[0]
+                if simple_size[1] / value[1] == scale:
+                    self._size = value
+                    return
+        msg = "This is not one of the allowed sizes of this image"
+        raise ValueError(msg)
+
+    def load(self, scale: int | None = None) -> Image.core.PixelAccess | None:
+        if scale is not None or len(self.size) == 3:
+            if scale is None and len(self.size) == 3:
+                scale = self.size[2]
+            assert scale is not None
+            width, height = self.size[:2]
+            self.size = width * scale, height * scale
+            self.best_size = width, height, scale
 
         px = Image.Image.load(self)
         if self._im is not None and self.im.size == self.size:

From a6f5f4dd43c95ded41da5d56c7e9782f54e8dea2 Mon Sep 17 00:00:00 2001
From: Andrew Murray <radarhere@users.noreply.github.com>
Date: Fri, 6 Sep 2024 11:42:56 +1000
Subject: [PATCH 0994/1178] Deprecate setting size to (width, height, scale)

---
 Tests/test_file_icns.py              |  3 ++-
 docs/deprecations.rst                |  8 ++++++++
 docs/handbook/image-file-formats.rst |  7 +------
 docs/releasenotes/11.0.0.rst         | 13 +++++++++++++
 src/PIL/IcnsImagePlugin.py           | 10 ++++++----
 5 files changed, 30 insertions(+), 11 deletions(-)

diff --git a/Tests/test_file_icns.py b/Tests/test_file_icns.py
index f37a6996fa4..16f6b36516d 100644
--- a/Tests/test_file_icns.py
+++ b/Tests/test_file_icns.py
@@ -87,7 +87,8 @@ def test_sizes() -> None:
         for w, h, r in im.info["sizes"]:
             wr = w * r
             hr = h * r
-            im.size = (w, h, r)
+            with pytest.warns(DeprecationWarning):
+                im.size = (w, h, r)
             im.load()
             assert im.mode == "RGBA"
             assert im.size == (wr, hr)
diff --git a/docs/deprecations.rst b/docs/deprecations.rst
index a9498d5ed5e..061f579dee9 100644
--- a/docs/deprecations.rst
+++ b/docs/deprecations.rst
@@ -109,6 +109,14 @@ ImageDraw.getdraw hints parameter
 
 The ``hints`` parameter in :py:meth:`~PIL.ImageDraw.getdraw()` has been deprecated.
 
+ICNS (width, height, scale) sizes
+^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
+
+.. deprecated:: 11.0.0
+
+Setting an ICNS image size to ``(width, height, scale)`` before loading has been
+deprecated. Instead, ``load(scale)`` can be used.
+
 ImageMath.lambda_eval and ImageMath.unsafe_eval options parameter
 ^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
 
diff --git a/docs/handbook/image-file-formats.rst b/docs/handbook/image-file-formats.rst
index a5fbc80533b..8183473e4f5 100644
--- a/docs/handbook/image-file-formats.rst
+++ b/docs/handbook/image-file-formats.rst
@@ -324,12 +324,7 @@ sets the following :py:attr:`~PIL.Image.Image.info` property:
 **sizes**
     A list of supported sizes found in this icon file; these are a
     3-tuple, ``(width, height, scale)``, where ``scale`` is 2 for a retina
-    icon and 1 for a standard icon.  You *are* permitted to use this 3-tuple
-    format for the :py:attr:`~PIL.Image.Image.size` property if you set it
-    before calling :py:meth:`~PIL.Image.Image.load`; after loading, the size
-    will be reset to a 2-tuple containing pixel dimensions (so, e.g. if you
-    ask for ``(512, 512, 2)``, the final value of
-    :py:attr:`~PIL.Image.Image.size` will be ``(1024, 1024)``).
+    icon and 1 for a standard icon.
 
 .. _icns-loading:
 
diff --git a/docs/releasenotes/11.0.0.rst b/docs/releasenotes/11.0.0.rst
index ac9237acf78..27c1bd30831 100644
--- a/docs/releasenotes/11.0.0.rst
+++ b/docs/releasenotes/11.0.0.rst
@@ -43,9 +43,20 @@ similarly removed.
 Deprecations
 ============
 
+
+ICNS (width, height, scale) sizes
+^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
+
+.. deprecated:: 11.0.0
+
+Setting an ICNS image size to ``(width, height, scale)`` before loading has been
+deprecated. Instead, ``load(scale)`` can be used.
+
 ImageMath.lambda_eval and ImageMath.unsafe_eval options parameter
 ^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
 
+.. deprecated:: 11.0.0
+
 The ``options`` parameter in :py:meth:`~PIL.ImageMath.lambda_eval()` and
 :py:meth:`~PIL.ImageMath.unsafe_eval()` has been deprecated. One or more
 keyword arguments can be used instead.
@@ -61,6 +72,8 @@ have been deprecated, and will be removed in Pillow 12 (2025-10-15).
 Specific WebP Feature Checks
 ^^^^^^^^^^^^^^^^^^^^^^^^^^^^
 
+.. deprecated:: 11.0.0
+
 ``features.check("transp_webp")``, ``features.check("webp_mux")`` and
 ``features.check("webp_anim")`` are now deprecated. They will always return
 ``True`` if the WebP module is installed, until they are removed in Pillow
diff --git a/src/PIL/IcnsImagePlugin.py b/src/PIL/IcnsImagePlugin.py
index e4f486a4f77..9757b2b142d 100644
--- a/src/PIL/IcnsImagePlugin.py
+++ b/src/PIL/IcnsImagePlugin.py
@@ -25,6 +25,7 @@
 from typing import IO
 
 from . import Image, ImageFile, PngImagePlugin, features
+from ._deprecate import deprecate
 
 enable_jpeg2k = features.check_codec("jpg_2000")
 if enable_jpeg2k:
@@ -275,15 +276,16 @@ def _open(self) -> None:
             self.best_size[1] * self.best_size[2],
         )
 
-    @property
-    def size(self):
+    @property  # type: ignore[override]
+    def size(self) -> tuple[int, int] | tuple[int, int, int]:
         return self._size
 
     @size.setter
-    def size(self, value) -> None:
+    def size(self, value: tuple[int, int] | tuple[int, int, int]) -> None:
         if len(value) == 3:
+            deprecate("Setting size to (width, height, scale)", 12, "load(scale)")
             if value in self.info["sizes"]:
-                self._size = value
+                self._size = value  # type: ignore[assignment]
                 return
         else:
             # Check that a matching size exists,

From 23c461e431e84fbfb81fca10c5a81c047884559b Mon Sep 17 00:00:00 2001
From: Andrew Murray <radarhere@users.noreply.github.com>
Date: Fri, 6 Sep 2024 11:56:06 +1000
Subject: [PATCH 0995/1178] Handle duplicate exif header

Co-authored-by: Jamil Zakirov <djamilzak@gmail.com>
---
 Tests/test_image.py | 8 ++++++++
 src/PIL/Image.py    | 2 +-
 2 files changed, 9 insertions(+), 1 deletion(-)

diff --git a/Tests/test_image.py b/Tests/test_image.py
index b0d71966779..97e97acaabd 100644
--- a/Tests/test_image.py
+++ b/Tests/test_image.py
@@ -775,6 +775,14 @@ def test_empty_exif(self) -> None:
         exif.load(b"Exif\x00\x00")
         assert not dict(exif)
 
+    def test_duplicate_exif_header(self) -> None:
+        with Image.open("Tests/images/exif.png") as im:
+            im.load()
+            im.info["exif"] = b"Exif\x00\x00" + im.info["exif"]
+
+            exif = im.getexif()
+        assert exif[274] == 1
+
     def test_empty_get_ifd(self) -> None:
         exif = Image.Exif()
         ifd = exif.get_ifd(0x8769)
diff --git a/src/PIL/Image.py b/src/PIL/Image.py
index 1c0cf293633..2fb677ead3f 100644
--- a/src/PIL/Image.py
+++ b/src/PIL/Image.py
@@ -3968,7 +3968,7 @@ def load(self, data: bytes) -> None:
         self._data.clear()
         self._hidden_data.clear()
         self._ifds.clear()
-        if data and data.startswith(b"Exif\x00\x00"):
+        while data and data.startswith(b"Exif\x00\x00"):
             data = data[6:]
         if not data:
             self._info = None

From 06c331af5d85825b7c2595ca3861730d52b22e00 Mon Sep 17 00:00:00 2001
From: Andrew Murray <radarhere@users.noreply.github.com>
Date: Fri, 6 Sep 2024 15:16:59 +1000
Subject: [PATCH 0996/1178] Added type hints to frombuffer

---
 Tests/test_file_jpeg.py        |  4 +++-
 Tests/test_imagefile.py        |  2 +-
 docs/example/DdsImagePlugin.py |  4 ++--
 src/PIL/BlpImagePlugin.py      |  2 +-
 src/PIL/BmpImagePlugin.py      |  2 +-
 src/PIL/DdsImagePlugin.py      |  2 +-
 src/PIL/FitsImagePlugin.py     |  2 +-
 src/PIL/Image.py               | 13 ++++++++++---
 src/PIL/ImageFile.py           |  2 +-
 src/PIL/MspImagePlugin.py      |  2 +-
 src/PIL/PpmImagePlugin.py      |  4 ++--
 src/PIL/QoiImagePlugin.py      |  2 +-
 src/PIL/SgiImagePlugin.py      |  2 +-
 13 files changed, 26 insertions(+), 17 deletions(-)

diff --git a/Tests/test_file_jpeg.py b/Tests/test_file_jpeg.py
index affc1862563..cde951395a7 100644
--- a/Tests/test_file_jpeg.py
+++ b/Tests/test_file_jpeg.py
@@ -1011,7 +1011,9 @@ def test_eof(self) -> None:
         # Even though this decoder never says that it is finished
         # the image should still end when there is no new data
         class InfiniteMockPyDecoder(ImageFile.PyDecoder):
-            def decode(self, buffer: bytes) -> tuple[int, int]:
+            def decode(
+                self, buffer: bytes | Image.SupportsArrayInterface
+            ) -> tuple[int, int]:
                 return 0, 0
 
         Image.register_decoder("INFINITE", InfiniteMockPyDecoder)
diff --git a/Tests/test_imagefile.py b/Tests/test_imagefile.py
index 0985dce9cf1..1ee68492630 100644
--- a/Tests/test_imagefile.py
+++ b/Tests/test_imagefile.py
@@ -210,7 +210,7 @@ def __init__(self, mode: str, *args: Any) -> None:
 
         super().__init__(mode, *args)
 
-    def decode(self, buffer: bytes) -> tuple[int, int]:
+    def decode(self, buffer: bytes | Image.SupportsArrayInterface) -> tuple[int, int]:
         # eof
         return -1, 0
 
diff --git a/docs/example/DdsImagePlugin.py b/docs/example/DdsImagePlugin.py
index d8f53607697..10828bff031 100644
--- a/docs/example/DdsImagePlugin.py
+++ b/docs/example/DdsImagePlugin.py
@@ -257,7 +257,7 @@ def load_seek(self, pos: int) -> None:
 class DXT1Decoder(ImageFile.PyDecoder):
     _pulls_fd = True
 
-    def decode(self, buffer: bytes) -> tuple[int, int]:
+    def decode(self, buffer: bytes | Image.SupportsArrayInterface) -> tuple[int, int]:
         assert self.fd is not None
         try:
             self.set_as_raw(_dxt1(self.fd, self.state.xsize, self.state.ysize))
@@ -270,7 +270,7 @@ def decode(self, buffer: bytes) -> tuple[int, int]:
 class DXT5Decoder(ImageFile.PyDecoder):
     _pulls_fd = True
 
-    def decode(self, buffer: bytes) -> tuple[int, int]:
+    def decode(self, buffer: bytes | Image.SupportsArrayInterface) -> tuple[int, int]:
         assert self.fd is not None
         try:
             self.set_as_raw(_dxt5(self.fd, self.state.xsize, self.state.ysize))
diff --git a/src/PIL/BlpImagePlugin.py b/src/PIL/BlpImagePlugin.py
index 8e29898dfc8..e5605635e55 100644
--- a/src/PIL/BlpImagePlugin.py
+++ b/src/PIL/BlpImagePlugin.py
@@ -279,7 +279,7 @@ def _open(self) -> None:
 class _BLPBaseDecoder(ImageFile.PyDecoder):
     _pulls_fd = True
 
-    def decode(self, buffer: bytes) -> tuple[int, int]:
+    def decode(self, buffer: bytes | Image.SupportsArrayInterface) -> tuple[int, int]:
         try:
             self._read_blp_header()
             self._load()
diff --git a/src/PIL/BmpImagePlugin.py b/src/PIL/BmpImagePlugin.py
index 16c8cf6ff04..bf8f29577ae 100644
--- a/src/PIL/BmpImagePlugin.py
+++ b/src/PIL/BmpImagePlugin.py
@@ -321,7 +321,7 @@ def _open(self) -> None:
 class BmpRleDecoder(ImageFile.PyDecoder):
     _pulls_fd = True
 
-    def decode(self, buffer: bytes) -> tuple[int, int]:
+    def decode(self, buffer: bytes | Image.SupportsArrayInterface) -> tuple[int, int]:
         assert self.fd is not None
         rle4 = self.args[1]
         data = bytearray()
diff --git a/src/PIL/DdsImagePlugin.py b/src/PIL/DdsImagePlugin.py
index 6315324701a..1b64082370c 100644
--- a/src/PIL/DdsImagePlugin.py
+++ b/src/PIL/DdsImagePlugin.py
@@ -481,7 +481,7 @@ def load_seek(self, pos: int) -> None:
 class DdsRgbDecoder(ImageFile.PyDecoder):
     _pulls_fd = True
 
-    def decode(self, buffer: bytes) -> tuple[int, int]:
+    def decode(self, buffer: bytes | Image.SupportsArrayInterface) -> tuple[int, int]:
         assert self.fd is not None
         bitcount, masks = self.args
 
diff --git a/src/PIL/FitsImagePlugin.py b/src/PIL/FitsImagePlugin.py
index abacc5e67f2..6bbd2641aba 100644
--- a/src/PIL/FitsImagePlugin.py
+++ b/src/PIL/FitsImagePlugin.py
@@ -126,7 +126,7 @@ def _parse_headers(
 class FitsGzipDecoder(ImageFile.PyDecoder):
     _pulls_fd = True
 
-    def decode(self, buffer: bytes) -> tuple[int, int]:
+    def decode(self, buffer: bytes | Image.SupportsArrayInterface) -> tuple[int, int]:
         assert self.fd is not None
         value = gzip.decompress(self.fd.read())
 
diff --git a/src/PIL/Image.py b/src/PIL/Image.py
index 1c0cf293633..90d028b9b4e 100644
--- a/src/PIL/Image.py
+++ b/src/PIL/Image.py
@@ -856,7 +856,10 @@ def tobitmap(self, name: str = "image") -> bytes:
         )
 
     def frombytes(
-        self, data: bytes | bytearray, decoder_name: str = "raw", *args: Any
+        self,
+        data: bytes | bytearray | SupportsArrayInterface,
+        decoder_name: str = "raw",
+        *args: Any,
     ) -> None:
         """
         Loads this image with pixel data from a bytes object.
@@ -3145,7 +3148,7 @@ def new(
 def frombytes(
     mode: str,
     size: tuple[int, int],
-    data: bytes | bytearray,
+    data: bytes | bytearray | SupportsArrayInterface,
     decoder_name: str = "raw",
     *args: Any,
 ) -> Image:
@@ -3189,7 +3192,11 @@ def frombytes(
 
 
 def frombuffer(
-    mode: str, size: tuple[int, int], data, decoder_name: str = "raw", *args: Any
+    mode: str,
+    size: tuple[int, int],
+    data: bytes | SupportsArrayInterface,
+    decoder_name: str = "raw",
+    *args: Any,
 ) -> Image:
     """
     Creates an image memory referencing pixel data in a byte buffer.
diff --git a/src/PIL/ImageFile.py b/src/PIL/ImageFile.py
index 615961ce508..b8bf0b7fe90 100644
--- a/src/PIL/ImageFile.py
+++ b/src/PIL/ImageFile.py
@@ -733,7 +733,7 @@ class PyDecoder(PyCodec):
     def pulls_fd(self) -> bool:
         return self._pulls_fd
 
-    def decode(self, buffer: bytes) -> tuple[int, int]:
+    def decode(self, buffer: bytes | Image.SupportsArrayInterface) -> tuple[int, int]:
         """
         Override to perform the decoding process.
 
diff --git a/src/PIL/MspImagePlugin.py b/src/PIL/MspImagePlugin.py
index 1363ddd1f7c..f3460a78730 100644
--- a/src/PIL/MspImagePlugin.py
+++ b/src/PIL/MspImagePlugin.py
@@ -112,7 +112,7 @@ class MspDecoder(ImageFile.PyDecoder):
 
     _pulls_fd = True
 
-    def decode(self, buffer: bytes) -> tuple[int, int]:
+    def decode(self, buffer: bytes | Image.SupportsArrayInterface) -> tuple[int, int]:
         assert self.fd is not None
 
         img = io.BytesIO()
diff --git a/src/PIL/PpmImagePlugin.py b/src/PIL/PpmImagePlugin.py
index 3bda2bf28c0..4e779df177e 100644
--- a/src/PIL/PpmImagePlugin.py
+++ b/src/PIL/PpmImagePlugin.py
@@ -284,7 +284,7 @@ def _decode_blocks(self, maxval: int) -> bytearray:
                     break
         return data
 
-    def decode(self, buffer: bytes) -> tuple[int, int]:
+    def decode(self, buffer: bytes | Image.SupportsArrayInterface) -> tuple[int, int]:
         self._comment_spans = False
         if self.mode == "1":
             data = self._decode_bitonal()
@@ -300,7 +300,7 @@ def decode(self, buffer: bytes) -> tuple[int, int]:
 class PpmDecoder(ImageFile.PyDecoder):
     _pulls_fd = True
 
-    def decode(self, buffer: bytes) -> tuple[int, int]:
+    def decode(self, buffer: bytes | Image.SupportsArrayInterface) -> tuple[int, int]:
         assert self.fd is not None
 
         data = bytearray()
diff --git a/src/PIL/QoiImagePlugin.py b/src/PIL/QoiImagePlugin.py
index eaf03140291..010d3f941e1 100644
--- a/src/PIL/QoiImagePlugin.py
+++ b/src/PIL/QoiImagePlugin.py
@@ -47,7 +47,7 @@ def _add_to_previous_pixels(self, value: bytes | bytearray) -> None:
         hash_value = (r * 3 + g * 5 + b * 7 + a * 11) % 64
         self._previously_seen_pixels[hash_value] = value
 
-    def decode(self, buffer: bytes) -> tuple[int, int]:
+    def decode(self, buffer: bytes | Image.SupportsArrayInterface) -> tuple[int, int]:
         assert self.fd is not None
 
         self._previously_seen_pixels = {}
diff --git a/src/PIL/SgiImagePlugin.py b/src/PIL/SgiImagePlugin.py
index 2c205a926be..44254b7a4b4 100644
--- a/src/PIL/SgiImagePlugin.py
+++ b/src/PIL/SgiImagePlugin.py
@@ -214,7 +214,7 @@ def _save(im: Image.Image, fp: IO[bytes], filename: str | bytes) -> None:
 class SGI16Decoder(ImageFile.PyDecoder):
     _pulls_fd = True
 
-    def decode(self, buffer: bytes) -> tuple[int, int]:
+    def decode(self, buffer: bytes | Image.SupportsArrayInterface) -> tuple[int, int]:
         assert self.fd is not None
         assert self.im is not None
 

From 94315f87c32d67c097ae8fb6eb8052bba9384af4 Mon Sep 17 00:00:00 2001
From: Andrew Murray <radarhere@users.noreply.github.com>
Date: Fri, 6 Sep 2024 19:13:35 +1000
Subject: [PATCH 0997/1178] Removed unused IFD_LEGACY_API

---
 docs/deprecations.rst        | 7 +++++++
 docs/releasenotes/11.0.0.rst | 5 +++++
 src/PIL/TiffImagePlugin.py   | 3 +--
 3 files changed, 13 insertions(+), 2 deletions(-)

diff --git a/docs/deprecations.rst b/docs/deprecations.rst
index a9498d5ed5e..cafda38032a 100644
--- a/docs/deprecations.rst
+++ b/docs/deprecations.rst
@@ -142,6 +142,13 @@ Removed features
 Deprecated features are only removed in major releases after an appropriate
 period of deprecation has passed.
 
+TiffImagePlugin IFD_LEGACY_API
+~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
+
+.. versionremoved:: 11.0.0
+
+``TiffImagePlugin.IFD_LEGACY_API`` was removed, as it was an unused setting.
+
 PSFile
 ~~~~~~
 
diff --git a/docs/releasenotes/11.0.0.rst b/docs/releasenotes/11.0.0.rst
index ac9237acf78..f0d864f6a3c 100644
--- a/docs/releasenotes/11.0.0.rst
+++ b/docs/releasenotes/11.0.0.rst
@@ -40,6 +40,11 @@ removed. Pillow's C API will now be used on PyPy instead.
 ``Image.USE_CFFI_ACCESS``, for switching from the C API to PyAccess, was
 similarly removed.
 
+TiffImagePlugin IFD_LEGACY_API
+^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
+
+An unused setting, ``TiffImagePlugin.IFD_LEGACY_API``, has been removed.
+
 Deprecations
 ============
 
diff --git a/src/PIL/TiffImagePlugin.py b/src/PIL/TiffImagePlugin.py
index 88f75ce8eef..87d9677e0dc 100644
--- a/src/PIL/TiffImagePlugin.py
+++ b/src/PIL/TiffImagePlugin.py
@@ -69,7 +69,6 @@
 # Set these to true to force use of libtiff for reading or writing.
 READ_LIBTIFF = False
 WRITE_LIBTIFF = False
-IFD_LEGACY_API = True
 STRIP_SIZE = 65536
 
 II = b"II"  # little-endian (Intel style)
@@ -1125,7 +1124,7 @@ def __getitem__(self, tag: int) -> Any:
         return val
 
 
-# undone -- switch this pointer when IFD_LEGACY_API == False
+# undone -- switch this pointer
 ImageFileDirectory = ImageFileDirectory_v1
 
 

From 93a0bf02760e6b9e1764eb5f15c69a2c12d96e00 Mon Sep 17 00:00:00 2001
From: Andrew Murray <radarhere@users.noreply.github.com>
Date: Fri, 6 Sep 2024 21:33:30 +1000
Subject: [PATCH 0998/1178] Added type hints to TiffImagePlugin _save

---
 docs/conf.py               |  2 +-
 src/PIL/TiffImagePlugin.py | 26 +++++++++++++++++++++-----
 2 files changed, 22 insertions(+), 6 deletions(-)

diff --git a/docs/conf.py b/docs/conf.py
index 41f9c0e3821..a0f5867d758 100644
--- a/docs/conf.py
+++ b/docs/conf.py
@@ -121,7 +121,7 @@
 # generating warnings in “nitpicky mode”. Note that type should include the domain name
 # if present. Example entries would be ('py:func', 'int') or
 # ('envvar', 'LD_LIBRARY_PATH').
-# nitpick_ignore = []
+nitpick_ignore = [("py:class", "_io.BytesIO")]
 
 
 # -- Options for HTML output ----------------------------------------------
diff --git a/src/PIL/TiffImagePlugin.py b/src/PIL/TiffImagePlugin.py
index 88f75ce8eef..53f6ae621c7 100644
--- a/src/PIL/TiffImagePlugin.py
+++ b/src/PIL/TiffImagePlugin.py
@@ -46,6 +46,7 @@
 import math
 import os
 import struct
+import sys
 import warnings
 from collections.abc import Iterator, MutableMapping
 from fractions import Fraction
@@ -1647,7 +1648,7 @@ def _setup(self) -> None:
 }
 
 
-def _save(im: Image.Image, fp, filename: str | bytes) -> None:
+def _save(im: Image.Image, fp: IO[bytes], filename: str | bytes) -> None:
     try:
         rawmode, prefix, photo, format, bits, extra = SAVE_INFO[im.mode]
     except KeyError as e:
@@ -1958,7 +1959,7 @@ def _save(im: Image.Image, fp, filename: str | bytes) -> None:
         setattr(im, "_debug_multipage", ifd)
 
 
-class AppendingTiffWriter:
+class AppendingTiffWriter(io.BytesIO):
     fieldSizes = [
         0,  # None
         1,  # byte
@@ -2068,6 +2069,12 @@ def tell(self) -> int:
         return self.f.tell() - self.offsetOfNewPage
 
     def seek(self, offset: int, whence: int = io.SEEK_SET) -> int:
+        """
+        :param offset: Distance to seek.
+        :param whence: Whether the distance is relative to the start,
+                       end or current position.
+        :returns: The resulting position, relative to the start.
+        """
         if whence == os.SEEK_SET:
             offset += self.offsetOfNewPage
 
@@ -2101,8 +2108,16 @@ def skipIFDs(self) -> None:
             num_tags = self.readShort()
             self.f.seek(num_tags * 12, os.SEEK_CUR)
 
-    def write(self, data: bytes) -> int | None:
-        return self.f.write(data)
+    if sys.version_info >= (3, 12):
+        from collections.abc import Buffer
+
+        def write(self, data: Buffer, /) -> int:
+            return self.f.write(data)
+
+    else:
+
+        def write(self, data: Any, /) -> int:
+            return self.f.write(data)
 
     def readShort(self) -> int:
         (value,) = struct.unpack(self.shortFmt, self.f.read(2))
@@ -2143,7 +2158,8 @@ def writeLong(self, value: int) -> None:
 
     def close(self) -> None:
         self.finalize()
-        self.f.close()
+        if self.close_fp:
+            self.f.close()
 
     def fixIFD(self) -> None:
         num_tags = self.readShort()

From d3c1d99d00b3d76d9c3dbdfc629b6278a0e38613 Mon Sep 17 00:00:00 2001
From: Hugo van Kemenade <1324225+hugovk@users.noreply.github.com>
Date: Fri, 6 Sep 2024 14:22:39 +0300
Subject: [PATCH 0999/1178] Deprecate support for FreeType 2.9.0

---
 Tests/test_imagefont.py      | 12 ++++++++++++
 docs/deprecations.rst        | 13 +++++++++++++
 docs/releasenotes/11.0.0.rst | 13 +++++++++++++
 src/PIL/ImageFont.py         | 17 ++++++++++++++++-
 4 files changed, 54 insertions(+), 1 deletion(-)

diff --git a/Tests/test_imagefont.py b/Tests/test_imagefont.py
index 953706010f6..cfadc7312a1 100644
--- a/Tests/test_imagefont.py
+++ b/Tests/test_imagefont.py
@@ -1150,3 +1150,15 @@ def test_invalid_truetype_sizes_raise_valueerror(
 ) -> None:
     with pytest.raises(ValueError):
         ImageFont.truetype(FONT_PATH, size, layout_engine=layout_engine)
+
+
+def test_freetype_deprecation(monkeypatch: pytest.MonkeyPatch) -> None:
+    # Arrange: mock features.version_module to return fake FreeType version
+    def fake_version_module(module):
+        return "2.9.0"
+
+    monkeypatch.setattr(features, "version_module", fake_version_module)
+
+    # Act / Assert
+    with pytest.warns(DeprecationWarning):
+        ImageFont.truetype(FONT_PATH, FONT_SIZE)
diff --git a/docs/deprecations.rst b/docs/deprecations.rst
index a9498d5ed5e..9a2f16cfb68 100644
--- a/docs/deprecations.rst
+++ b/docs/deprecations.rst
@@ -12,6 +12,19 @@ Deprecated features
 Below are features which are considered deprecated. Where appropriate,
 a :py:exc:`DeprecationWarning` is issued.
 
+FreeType 2.9.0
+~~~~~~~~~~~~~~
+
+.. deprecated:: 11.0.0
+
+Support for FreeType 2.9.0 is deprecated and will be removed in Pillow 12.0.0
+(2025-10-15), when FreeType 2.9.1 will be the minimum supported.
+
+We recommend upgrading to at least FreeType `2.10.4`_, which fixed a severe
+vulnerability introduced in FreeType 2.6 (:cve:`CVE-2020-15999`).
+
+.. _2.10.4: https://sourceforge.net/projects/freetype/files/freetype2/2.10.4/
+
 ImageFile.raise_oserror
 ~~~~~~~~~~~~~~~~~~~~~~~
 
diff --git a/docs/releasenotes/11.0.0.rst b/docs/releasenotes/11.0.0.rst
index ac9237acf78..99e0a292766 100644
--- a/docs/releasenotes/11.0.0.rst
+++ b/docs/releasenotes/11.0.0.rst
@@ -43,6 +43,19 @@ similarly removed.
 Deprecations
 ============
 
+FreeType 2.9.0
+^^^^^^^^^^^^^^
+
+.. deprecated:: 11.0.0
+
+Support for FreeType 2.9.0 is deprecated and will be removed in Pillow 12.0.0
+(2025-10-15), when FreeType 2.9.1 will be the minimum supported.
+
+We recommend upgrading to at least FreeType `2.10.4`_, which fixed a severe
+vulnerability introduced in FreeType 2.6 (:cve:`CVE-2020-15999`).
+
+.. _2.10.4: https://sourceforge.net/projects/freetype/files/freetype2/2.10.4/
+
 ImageMath.lambda_eval and ImageMath.unsafe_eval options parameter
 ^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
 
diff --git a/src/PIL/ImageFont.py b/src/PIL/ImageFont.py
index a82c36ba6b8..50796e132dc 100644
--- a/src/PIL/ImageFont.py
+++ b/src/PIL/ImageFont.py
@@ -36,7 +36,7 @@
 from types import ModuleType
 from typing import IO, TYPE_CHECKING, Any, BinaryIO, TypedDict, cast
 
-from . import Image
+from . import Image, features
 from ._typing import StrOrBytesPath
 from ._util import DeferredError, is_path
 
@@ -232,6 +232,21 @@ def __init__(
         self.index = index
         self.encoding = encoding
 
+        try:
+            from packaging.version import parse as parse_version
+        except ImportError:
+            pass
+        else:
+            if freetype_version := features.version_module("freetype2"):
+                if parse_version(freetype_version) < parse_version("2.9.1"):
+                    warnings.warn(
+                        "Support for FreeType 2.9.0 is deprecated and will be removed "
+                        "in Pillow 12 (2025-10-15). Please upgrade to FreeType 2.9.1 "
+                        "or newer, preferably FreeType 2.10.4 which fixes "
+                        "CVE-2020-15999.",
+                        DeprecationWarning,
+                    )
+
         if layout_engine not in (Layout.BASIC, Layout.RAQM):
             layout_engine = Layout.BASIC
             if core.HAVE_RAQM:

From de3c6fa2957cd237cea024ae558034379129362e Mon Sep 17 00:00:00 2001
From: Andrew Murray <radarhere@users.noreply.github.com>
Date: Sat, 7 Sep 2024 12:14:30 +1000
Subject: [PATCH 1000/1178] Support converting more modes to LAB by converting
 to RGBA first

---
 Tests/test_imagecms.py |  6 ++++++
 src/PIL/Image.py       | 14 ++++++++++----
 2 files changed, 16 insertions(+), 4 deletions(-)

diff --git a/Tests/test_imagecms.py b/Tests/test_imagecms.py
index 5ee5fcedf24..f062651f0c5 100644
--- a/Tests/test_imagecms.py
+++ b/Tests/test_imagecms.py
@@ -696,6 +696,12 @@ def test_rgb_lab(mode: str) -> None:
     assert value[:3] == (0, 255, 255)
 
 
+def test_cmyk_lab() -> None:
+    im = Image.new("CMYK", (1, 1))
+    converted_im = im.convert("LAB")
+    assert converted_im.getpixel((0, 0)) == (255, 128, 128)
+
+
 def test_deprecation() -> None:
     with pytest.warns(DeprecationWarning):
         assert ImageCms.DESCRIPTION.strip().startswith("pyCMS")
diff --git a/src/PIL/Image.py b/src/PIL/Image.py
index 1c0cf293633..d706d2d3352 100644
--- a/src/PIL/Image.py
+++ b/src/PIL/Image.py
@@ -1127,17 +1127,23 @@ def convert_transparency(
             return new_im
 
         if "LAB" in (self.mode, mode):
-            other_mode = mode if self.mode == "LAB" else self.mode
+            im = self
+            if mode == "LAB":
+                if im.mode not in ("RGB", "RGBA", "RGBX"):
+                    im = im.convert("RGBA")
+                other_mode = im.mode
+            else:
+                other_mode = mode
             if other_mode in ("RGB", "RGBA", "RGBX"):
                 from . import ImageCms
 
                 srgb = ImageCms.createProfile("sRGB")
                 lab = ImageCms.createProfile("LAB")
-                profiles = [lab, srgb] if self.mode == "LAB" else [srgb, lab]
+                profiles = [lab, srgb] if im.mode == "LAB" else [srgb, lab]
                 transform = ImageCms.buildTransform(
-                    profiles[0], profiles[1], self.mode, mode
+                    profiles[0], profiles[1], im.mode, mode
                 )
-                return transform.apply(self)
+                return transform.apply(im)
 
         # colorspace conversion
         if dither is None:

From 6f9128bfaf4c91a32e075847fa2c629d826c7eaf Mon Sep 17 00:00:00 2001
From: Andrew Murray <radarhere@users.noreply.github.com>
Date: Sat, 7 Sep 2024 14:28:36 +1000
Subject: [PATCH 1001/1178] Updated type hint

---
 src/PIL/Image.py   | 7 +------
 src/PIL/ImageTk.py | 5 ++++-
 src/PIL/_typing.py | 5 +++++
 3 files changed, 10 insertions(+), 7 deletions(-)

diff --git a/src/PIL/Image.py b/src/PIL/Image.py
index 1c0cf293633..871d38a83f9 100644
--- a/src/PIL/Image.py
+++ b/src/PIL/Image.py
@@ -224,12 +224,7 @@ class Quantize(IntEnum):
     from IPython.lib.pretty import PrettyPrinter
 
     from . import ImageFile, ImageFilter, ImagePalette, ImageQt, TiffImagePlugin
-    from ._typing import NumpyArray, StrOrBytesPath, TypeGuard
-
-    if sys.version_info >= (3, 13):
-        from types import CapsuleType
-    else:
-        CapsuleType = object
+    from ._typing import CapsuleType, NumpyArray, StrOrBytesPath, TypeGuard
 ID: list[str] = []
 OPEN: dict[
     str,
diff --git a/src/PIL/ImageTk.py b/src/PIL/ImageTk.py
index 5bad9b5462d..d01af364bb5 100644
--- a/src/PIL/ImageTk.py
+++ b/src/PIL/ImageTk.py
@@ -32,6 +32,9 @@
 
 from . import Image, ImageFile
 
+if TYPE_CHECKING:
+    from ._typing import CapsuleType
+
 # --------------------------------------------------------------------
 # Check for Tkinter interface hooks
 
@@ -48,7 +51,7 @@ def _get_image_from_kw(kw: dict[str, Any]) -> ImageFile.ImageFile | None:
 
 
 def _pyimagingtkcall(
-    command: str, photo: PhotoImage | tkinter.PhotoImage, ptr: object
+    command: str, photo: PhotoImage | tkinter.PhotoImage, ptr: CapsuleType
 ) -> None:
     tk = photo.tk
     try:
diff --git a/src/PIL/_typing.py b/src/PIL/_typing.py
index 093778464da..dd08cdd5042 100644
--- a/src/PIL/_typing.py
+++ b/src/PIL/_typing.py
@@ -15,6 +15,11 @@
     except (ImportError, AttributeError):
         pass
 
+if sys.version_info >= (3, 13):
+    from types import CapsuleType
+else:
+    CapsuleType = object
+
 if sys.version_info >= (3, 10):
     from typing import TypeGuard
 else:

From a6ca45aea661bd037ad0c46771fd047575ab138a Mon Sep 17 00:00:00 2001
From: Andrew Murray <radarhere@users.noreply.github.com>
Date: Sat, 7 Sep 2024 14:55:45 +1000
Subject: [PATCH 1002/1178] Use (void) to indicate no parameters

---
 src/libImaging/Access.c | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/src/libImaging/Access.c b/src/libImaging/Access.c
index bf7db281ec6..1c193710531 100644
--- a/src/libImaging/Access.c
+++ b/src/libImaging/Access.c
@@ -185,7 +185,7 @@ put_pixel_32(Imaging im, int x, int y, const void *color) {
 }
 
 void
-ImagingAccessInit() {
+ImagingAccessInit(void) {
 #define ADD(mode_, get_pixel_, put_pixel_)      \
     {                                           \
         ImagingAccess access = add_item(mode_); \

From 1105256f2b5e6817a23b6215a32bcf1d26687d60 Mon Sep 17 00:00:00 2001
From: Andrew Murray <radarhere@users.noreply.github.com>
Date: Sat, 7 Sep 2024 18:25:44 +1000
Subject: [PATCH 1003/1178] Added type hints to setup.py

---
 setup.py | 257 +++++++++++++++++++++++++++++++------------------------
 tox.ini  |   2 +-
 2 files changed, 146 insertions(+), 113 deletions(-)

diff --git a/setup.py b/setup.py
index 863d102cf85..60707083f6e 100644
--- a/setup.py
+++ b/setup.py
@@ -15,18 +15,20 @@
 import subprocess
 import sys
 import warnings
+from collections.abc import Iterator
+from typing import Any
 
 from setuptools import Extension, setup
 from setuptools.command.build_ext import build_ext
 
 
-def get_version():
+def get_version() -> str:
     version_file = "src/PIL/_version.py"
     with open(version_file, encoding="utf-8") as f:
         return f.read().split('"')[1]
 
 
-configuration = {}
+configuration: dict[str, list[str]] = {}
 
 
 PILLOW_VERSION = get_version()
@@ -143,7 +145,7 @@ class RequiredDependencyException(Exception):
 PLATFORM_MINGW = os.name == "nt" and "GCC" in sys.version
 
 
-def _dbg(s, tp=None):
+def _dbg(s: str, tp: Any = None) -> None:
     if DEBUG:
         if tp:
             print(s % tp)
@@ -151,10 +153,13 @@ def _dbg(s, tp=None):
         print(s)
 
 
-def _find_library_dirs_ldconfig():
+def _find_library_dirs_ldconfig() -> list[str]:
     # Based on ctypes.util from Python 2
 
     ldconfig = "ldconfig" if shutil.which("ldconfig") else "/sbin/ldconfig"
+    args: list[str]
+    env: dict[str, str]
+    expr: str
     if sys.platform.startswith("linux") or sys.platform.startswith("gnu"):
         if struct.calcsize("l") == 4:
             machine = os.uname()[4] + "-32"
@@ -184,13 +189,11 @@ def _find_library_dirs_ldconfig():
 
     try:
         p = subprocess.Popen(
-            args, stderr=subprocess.DEVNULL, stdout=subprocess.PIPE, env=env
+            args, stderr=subprocess.DEVNULL, stdout=subprocess.PIPE, env=env, text=True
         )
     except OSError:  # E.g. command not found
         return []
-    [data, _] = p.communicate()
-    if isinstance(data, bytes):
-        data = data.decode("latin1")
+    data = p.communicate()[0]
 
     dirs = []
     for dll in re.findall(expr, data):
@@ -200,7 +203,9 @@ def _find_library_dirs_ldconfig():
     return dirs
 
 
-def _add_directory(path, subdir, where=None):
+def _add_directory(
+    path: list[str], subdir: str | None, where: int | None = None
+) -> None:
     if subdir is None:
         return
     subdir = os.path.realpath(subdir)
@@ -216,7 +221,7 @@ def _add_directory(path, subdir, where=None):
         path.insert(where, subdir)
 
 
-def _find_include_file(self, include):
+def _find_include_file(self: pil_build_ext, include: str) -> int:
     for directory in self.compiler.include_dirs:
         _dbg("Checking for include file %s in %s", (include, directory))
         if os.path.isfile(os.path.join(directory, include)):
@@ -225,7 +230,7 @@ def _find_include_file(self, include):
     return 0
 
 
-def _find_library_file(self, library):
+def _find_library_file(self: pil_build_ext, library: str) -> str | None:
     ret = self.compiler.find_library_file(self.compiler.library_dirs, library)
     if ret:
         _dbg("Found library %s at %s", (library, ret))
@@ -234,7 +239,7 @@ def _find_library_file(self, library):
     return ret
 
 
-def _find_include_dir(self, dirname, include):
+def _find_include_dir(self: pil_build_ext, dirname: str, include: str) -> bool | str:
     for directory in self.compiler.include_dirs:
         _dbg("Checking for include file %s in %s", (include, directory))
         if os.path.isfile(os.path.join(directory, include)):
@@ -245,6 +250,7 @@ def _find_include_dir(self, dirname, include):
         if os.path.isfile(os.path.join(subdir, include)):
             _dbg("Found %s in %s", (include, subdir))
             return subdir
+    return False
 
 
 def _cmd_exists(cmd: str) -> bool:
@@ -256,7 +262,7 @@ def _cmd_exists(cmd: str) -> bool:
     )
 
 
-def _pkg_config(name):
+def _pkg_config(name: str) -> tuple[list[str], list[str]] | None:
     command = os.environ.get("PKG_CONFIG", "pkg-config")
     for keep_system in (True, False):
         try:
@@ -283,10 +289,11 @@ def _pkg_config(name):
             return libs, cflags
         except Exception:
             pass
+    return None
 
 
 class pil_build_ext(build_ext):
-    class feature:
+    class ext_feature:
         features = [
             "zlib",
             "jpeg",
@@ -301,25 +308,32 @@ class feature:
         ]
 
         required = {"jpeg", "zlib"}
-        vendor = set()
+        vendor: set[str] = set()
 
-        def __init__(self):
+        def __init__(self) -> None:
+            self._settings: dict[str, str | bool | None] = {}
             for f in self.features:
-                setattr(self, f, None)
+                self.set(f, None)
 
-        def require(self, feat):
+        def require(self, feat: str) -> bool:
             return feat in self.required
 
-        def want(self, feat):
-            return getattr(self, feat) is None
+        def get(self, feat: str) -> str | bool | None:
+            return self._settings[feat]
 
-        def want_vendor(self, feat):
+        def set(self, feat: str, value: str | bool | None) -> None:
+            self._settings[feat] = value
+
+        def want(self, feat: str) -> bool:
+            return self._settings[feat] is None
+
+        def want_vendor(self, feat: str) -> bool:
             return feat in self.vendor
 
-        def __iter__(self):
+        def __iter__(self) -> Iterator[str]:
             yield from self.features
 
-    feature = feature()
+    feature = ext_feature()
 
     user_options = (
         build_ext.user_options
@@ -337,10 +351,10 @@ def __iter__(self):
     )
 
     @staticmethod
-    def check_configuration(option, value):
+    def check_configuration(option: str, value: str) -> bool | None:
         return True if value in configuration.get(option, []) else None
 
-    def initialize_options(self):
+    def initialize_options(self) -> None:
         self.disable_platform_guessing = self.check_configuration(
             "platform-guessing", "disable"
         )
@@ -355,7 +369,7 @@ def initialize_options(self):
             self.debug = True
         self.parallel = configuration.get("parallel", [None])[-1]
 
-    def finalize_options(self):
+    def finalize_options(self) -> None:
         build_ext.finalize_options(self)
         if self.debug:
             global DEBUG
@@ -363,12 +377,16 @@ def finalize_options(self):
         if not self.parallel:
             # If --parallel (or -j) wasn't specified, we want to reproduce the same
             # behavior as before, that is, auto-detect the number of jobs.
-            try:
-                self.parallel = int(
-                    os.environ.get("MAX_CONCURRENCY", min(4, os.cpu_count()))
-                )
-            except TypeError:
-                self.parallel = None
+            self.parallel = None
+
+            cpu_count = os.cpu_count()
+            if cpu_count is not None:
+                try:
+                    self.parallel = int(
+                        os.environ.get("MAX_CONCURRENCY", min(4, cpu_count))
+                    )
+                except TypeError:
+                    pass
         for x in self.feature:
             if getattr(self, f"disable_{x}"):
                 setattr(self.feature, x, False)
@@ -402,7 +420,13 @@ def finalize_options(self):
                 _dbg("Using vendored version of %s", x)
                 self.feature.vendor.add(x)
 
-    def _update_extension(self, name, libraries, define_macros=None, sources=None):
+    def _update_extension(
+        self,
+        name: str,
+        libraries: list[str] | list[str | bool | None],
+        define_macros: list[tuple[str, str | None]] | None = None,
+        sources: list[str] | None = None,
+    ) -> None:
         for extension in self.extensions:
             if extension.name == name:
                 extension.libraries += libraries
@@ -415,13 +439,13 @@ def _update_extension(self, name, libraries, define_macros=None, sources=None):
                     extension.extra_link_args = ["--stdlib=libc++"]
                 break
 
-    def _remove_extension(self, name):
+    def _remove_extension(self, name: str) -> None:
         for extension in self.extensions:
             if extension.name == name:
                 self.extensions.remove(extension)
                 break
 
-    def get_macos_sdk_path(self):
+    def get_macos_sdk_path(self) -> str | None:
         try:
             sdk_path = (
                 subprocess.check_output(["xcrun", "--show-sdk-path"])
@@ -442,9 +466,9 @@ def get_macos_sdk_path(self):
                 sdk_path = commandlinetools_sdk_path
         return sdk_path
 
-    def build_extensions(self):
-        library_dirs = []
-        include_dirs = []
+    def build_extensions(self) -> None:
+        library_dirs: list[str] = []
+        include_dirs: list[str] = []
 
         pkg_config = None
         if _cmd_exists(os.environ.get("PKG_CONFIG", "pkg-config")):
@@ -468,19 +492,22 @@ def build_extensions(self):
             root = globals()[root_name]
 
             if root is None and root_name in os.environ:
-                prefix = os.environ[root_name]
-                root = (os.path.join(prefix, "lib"), os.path.join(prefix, "include"))
+                root_prefix = os.environ[root_name]
+                root = (
+                    os.path.join(root_prefix, "lib"),
+                    os.path.join(root_prefix, "include"),
+                )
 
             if root is None and pkg_config:
-                if isinstance(lib_name, tuple):
+                if isinstance(lib_name, str):
+                    _dbg(f"Looking for `{lib_name}` using pkg-config.")
+                    root = pkg_config(lib_name)
+                else:
                     for lib_name2 in lib_name:
                         _dbg(f"Looking for `{lib_name2}` using pkg-config.")
                         root = pkg_config(lib_name2)
                         if root:
                             break
-                else:
-                    _dbg(f"Looking for `{lib_name}` using pkg-config.")
-                    root = pkg_config(lib_name)
 
             if isinstance(root, tuple):
                 lib_root, include_root = root
@@ -660,22 +687,22 @@ def build_extensions(self):
             _dbg("Looking for zlib")
             if _find_include_file(self, "zlib.h"):
                 if _find_library_file(self, "z"):
-                    feature.zlib = "z"
+                    feature.set("zlib", "z")
                 elif sys.platform == "win32" and _find_library_file(self, "zlib"):
-                    feature.zlib = "zlib"  # alternative name
+                    feature.set("zlib", "zlib")  # alternative name
 
         if feature.want("jpeg"):
             _dbg("Looking for jpeg")
             if _find_include_file(self, "jpeglib.h"):
                 if _find_library_file(self, "jpeg"):
-                    feature.jpeg = "jpeg"
+                    feature.set("jpeg", "jpeg")
                 elif sys.platform == "win32" and _find_library_file(self, "libjpeg"):
-                    feature.jpeg = "libjpeg"  # alternative name
+                    feature.set("jpeg", "libjpeg")  # alternative name
 
-        feature.openjpeg_version = None
+        feature.set("openjpeg_version", None)
         if feature.want("jpeg2000"):
             _dbg("Looking for jpeg2000")
-            best_version = None
+            best_version: tuple[int, ...] | None = None
             best_path = None
 
             # Find the best version
@@ -705,26 +732,26 @@ def build_extensions(self):
                 # <openjpeg.h> rather than having to cope with the versioned
                 # include path
                 _add_directory(self.compiler.include_dirs, best_path, 0)
-                feature.jpeg2000 = "openjp2"
-                feature.openjpeg_version = ".".join(str(x) for x in best_version)
+                feature.set("jpeg2000", "openjp2")
+                feature.set("openjpeg_version", ".".join(str(x) for x in best_version))
 
         if feature.want("imagequant"):
             _dbg("Looking for imagequant")
             if _find_include_file(self, "libimagequant.h"):
                 if _find_library_file(self, "imagequant"):
-                    feature.imagequant = "imagequant"
+                    feature.set("imagequant", "imagequant")
                 elif _find_library_file(self, "libimagequant"):
-                    feature.imagequant = "libimagequant"
+                    feature.set("imagequant", "libimagequant")
 
         if feature.want("tiff"):
             _dbg("Looking for tiff")
             if _find_include_file(self, "tiff.h"):
                 if _find_library_file(self, "tiff"):
-                    feature.tiff = "tiff"
+                    feature.set("tiff", "tiff")
                 if sys.platform in ["win32", "darwin"] and _find_library_file(
                     self, "libtiff"
                 ):
-                    feature.tiff = "libtiff"
+                    feature.set("tiff", "libtiff")
 
         if feature.want("freetype"):
             _dbg("Looking for freetype")
@@ -745,31 +772,31 @@ def build_extensions(self):
                         freetype_version = 21
                         break
                 if freetype_version:
-                    feature.freetype = "freetype"
+                    feature.set("freetype", "freetype")
                     if subdir:
                         _add_directory(self.compiler.include_dirs, subdir, 0)
 
-        if feature.freetype and feature.want("raqm"):
+        if feature.get("freetype") and feature.want("raqm"):
             if not feature.want_vendor("raqm"):  # want system Raqm
                 _dbg("Looking for Raqm")
                 if _find_include_file(self, "raqm.h"):
                     if _find_library_file(self, "raqm"):
-                        feature.raqm = "raqm"
+                        feature.set("raqm", "raqm")
                     elif _find_library_file(self, "libraqm"):
-                        feature.raqm = "libraqm"
+                        feature.set("raqm", "libraqm")
             else:  # want to build Raqm from src/thirdparty
                 _dbg("Looking for HarfBuzz")
-                feature.harfbuzz = None
+                feature.set("harfbuzz", None)
                 hb_dir = _find_include_dir(self, "harfbuzz", "hb.h")
                 if hb_dir:
                     if isinstance(hb_dir, str):
                         _add_directory(self.compiler.include_dirs, hb_dir, 0)
                     if _find_library_file(self, "harfbuzz"):
-                        feature.harfbuzz = "harfbuzz"
-                if feature.harfbuzz:
+                        feature.set("harfbuzz", "harfbuzz")
+                if feature.get("harfbuzz"):
                     if not feature.want_vendor("fribidi"):  # want system FriBiDi
                         _dbg("Looking for FriBiDi")
-                        feature.fribidi = None
+                        feature.set("fribidi", None)
                         fribidi_dir = _find_include_dir(self, "fribidi", "fribidi.h")
                         if fribidi_dir:
                             if isinstance(fribidi_dir, str):
@@ -777,19 +804,19 @@ def build_extensions(self):
                                     self.compiler.include_dirs, fribidi_dir, 0
                                 )
                             if _find_library_file(self, "fribidi"):
-                                feature.fribidi = "fribidi"
-                                feature.raqm = True
+                                feature.set("fribidi", "fribidi")
+                                feature.set("raqm", True)
                     else:  # want to build FriBiDi shim from src/thirdparty
-                        feature.raqm = True
+                        feature.set("raqm", True)
 
         if feature.want("lcms"):
             _dbg("Looking for lcms")
             if _find_include_file(self, "lcms2.h"):
                 if _find_library_file(self, "lcms2"):
-                    feature.lcms = "lcms2"
+                    feature.set("lcms", "lcms2")
                 elif _find_library_file(self, "lcms2_static"):
                     # alternate Windows name.
-                    feature.lcms = "lcms2_static"
+                    feature.set("lcms", "lcms2_static")
 
         if feature.want("webp"):
             _dbg("Looking for webp")
@@ -803,17 +830,17 @@ def build_extensions(self):
                         _find_library_file(self, prefix + library)
                         for library in ("webp", "webpmux", "webpdemux")
                     ):
-                        feature.webp = prefix + "webp"
+                        feature.set("webp", prefix + "webp")
                         break
 
         if feature.want("xcb"):
             _dbg("Looking for xcb")
             if _find_include_file(self, "xcb/xcb.h"):
                 if _find_library_file(self, "xcb"):
-                    feature.xcb = "xcb"
+                    feature.set("xcb", "xcb")
 
         for f in feature:
-            if not getattr(feature, f) and feature.require(f):
+            if not feature.get(f) and feature.require(f):
                 if f in ("jpeg", "zlib"):
                     raise RequiredDependencyException(f)
                 raise DependencyException(f)
@@ -821,10 +848,11 @@ def build_extensions(self):
         #
         # core library
 
-        libs = self.add_imaging_libs.split()
-        defs = []
-        if feature.tiff:
-            libs.append(feature.tiff)
+        libs: list[str | bool | None] = []
+        libs.extend(self.add_imaging_libs.split())
+        defs: list[tuple[str, str | None]] = []
+        if feature.get("tiff"):
+            libs.append(feature.get("tiff"))
             defs.append(("HAVE_LIBTIFF", None))
             if sys.platform == "win32":
                 # This define needs to be defined if-and-only-if it was defined
@@ -832,22 +860,22 @@ def build_extensions(self):
                 # so we have to guess; by default it is defined in all Windows builds.
                 # See #4237, #5243, #5359 for more information.
                 defs.append(("USE_WIN32_FILEIO", None))
-        if feature.jpeg:
-            libs.append(feature.jpeg)
+        if feature.get("jpeg"):
+            libs.append(feature.get("jpeg"))
             defs.append(("HAVE_LIBJPEG", None))
-        if feature.jpeg2000:
-            libs.append(feature.jpeg2000)
+        if feature.get("jpeg2000"):
+            libs.append(feature.get("jpeg2000"))
             defs.append(("HAVE_OPENJPEG", None))
             if sys.platform == "win32" and not PLATFORM_MINGW:
                 defs.append(("OPJ_STATIC", None))
-        if feature.zlib:
-            libs.append(feature.zlib)
+        if feature.get("zlib"):
+            libs.append(feature.get("zlib"))
             defs.append(("HAVE_LIBZ", None))
-        if feature.imagequant:
-            libs.append(feature.imagequant)
+        if feature.get("imagequant"):
+            libs.append(feature.get("imagequant"))
             defs.append(("HAVE_LIBIMAGEQUANT", None))
-        if feature.xcb:
-            libs.append(feature.xcb)
+        if feature.get("xcb"):
+            libs.append(feature.get("xcb"))
             defs.append(("HAVE_XCB", None))
         if sys.platform == "win32":
             libs.extend(["kernel32", "user32", "gdi32"])
@@ -861,22 +889,22 @@ def build_extensions(self):
         #
         # additional libraries
 
-        if feature.freetype:
+        if feature.get("freetype"):
             srcs = []
             libs = ["freetype"]
             defs = []
-            if feature.raqm:
+            if feature.get("raqm"):
                 if not feature.want_vendor("raqm"):  # using system Raqm
                     defs.append(("HAVE_RAQM", None))
                     defs.append(("HAVE_RAQM_SYSTEM", None))
-                    libs.append(feature.raqm)
+                    libs.append(feature.get("raqm"))
                 else:  # building Raqm from src/thirdparty
                     defs.append(("HAVE_RAQM", None))
                     srcs.append("src/thirdparty/raqm/raqm.c")
-                    libs.append(feature.harfbuzz)
+                    libs.append(feature.get("harfbuzz"))
                     if not feature.want_vendor("fribidi"):  # using system FriBiDi
                         defs.append(("HAVE_FRIBIDI_SYSTEM", None))
-                        libs.append(feature.fribidi)
+                        libs.append(feature.get("fribidi"))
                     else:  # building FriBiDi shim from src/thirdparty
                         srcs.append("src/thirdparty/fribidi-shim/fribidi.c")
             self._update_extension("PIL._imagingft", libs, defs, srcs)
@@ -884,16 +912,17 @@ def build_extensions(self):
         else:
             self._remove_extension("PIL._imagingft")
 
-        if feature.lcms:
-            extra = []
+        if feature.get("lcms"):
+            libs = [feature.get("lcms")]
             if sys.platform == "win32":
-                extra.extend(["user32", "gdi32"])
-            self._update_extension("PIL._imagingcms", [feature.lcms] + extra)
+                libs.extend(["user32", "gdi32"])
+            self._update_extension("PIL._imagingcms", libs)
         else:
             self._remove_extension("PIL._imagingcms")
 
-        if feature.webp:
-            libs = [feature.webp, feature.webp + "mux", feature.webp + "demux"]
+        webp = feature.get("webp")
+        if isinstance(webp, str):
+            libs = [webp, webp + "mux", webp + "demux"]
             self._update_extension("PIL._webp", libs)
         else:
             self._remove_extension("PIL._webp")
@@ -908,14 +937,14 @@ def build_extensions(self):
 
         self.summary_report(feature)
 
-    def summary_report(self, feature):
+    def summary_report(self, feature: ext_feature) -> None:
         print("-" * 68)
         print("PIL SETUP SUMMARY")
         print("-" * 68)
         print(f"version      Pillow {PILLOW_VERSION}")
-        v = sys.version.split("[")
-        print(f"platform     {sys.platform} {v[0].strip()}")
-        for v in v[1:]:
+        version = sys.version.split("[")
+        print(f"platform     {sys.platform} {version[0].strip()}")
+        for v in version[1:]:
             print(f"             [{v.strip()}")
         print("-" * 68)
 
@@ -926,16 +955,20 @@ def summary_report(self, feature):
                 raqm_extra_info += ", FriBiDi shim"
 
         options = [
-            (feature.jpeg, "JPEG"),
-            (feature.jpeg2000, "OPENJPEG (JPEG2000)", feature.openjpeg_version),
-            (feature.zlib, "ZLIB (PNG/ZIP)"),
-            (feature.imagequant, "LIBIMAGEQUANT"),
-            (feature.tiff, "LIBTIFF"),
-            (feature.freetype, "FREETYPE2"),
-            (feature.raqm, "RAQM (Text shaping)", raqm_extra_info),
-            (feature.lcms, "LITTLECMS2"),
-            (feature.webp, "WEBP"),
-            (feature.xcb, "XCB (X protocol)"),
+            (feature.get("jpeg"), "JPEG"),
+            (
+                feature.get("jpeg2000"),
+                "OPENJPEG (JPEG2000)",
+                feature.get("openjpeg_version"),
+            ),
+            (feature.get("zlib"), "ZLIB (PNG/ZIP)"),
+            (feature.get("imagequant"), "LIBIMAGEQUANT"),
+            (feature.get("tiff"), "LIBTIFF"),
+            (feature.get("freetype"), "FREETYPE2"),
+            (feature.get("raqm"), "RAQM (Text shaping)", raqm_extra_info),
+            (feature.get("lcms"), "LITTLECMS2"),
+            (feature.get("webp"), "WEBP"),
+            (feature.get("xcb"), "XCB (X protocol)"),
         ]
 
         all = 1
@@ -964,7 +997,7 @@ def summary_report(self, feature):
         print("")
 
 
-def debug_build():
+def debug_build() -> bool:
     return hasattr(sys, "gettotalrefcount") or FUZZING_BUILD
 
 
diff --git a/tox.ini b/tox.ini
index 70b8bf14584..e79d8850097 100644
--- a/tox.ini
+++ b/tox.ini
@@ -36,4 +36,4 @@ deps =
 extras =
     typing
 commands =
-    mypy docs src winbuild Tests {posargs}
+    mypy conftest.py selftest.py setup.py docs src winbuild Tests {posargs}

From e14072e9738275ffe2898f32d36cbd2f3c687cf3 Mon Sep 17 00:00:00 2001
From: Andrew Murray <radarhere@users.noreply.github.com>
Date: Sat, 7 Sep 2024 19:08:07 +1000
Subject: [PATCH 1004/1178] Added further detail

---
 src/PIL/ImageFont.py | 12 +++++-------
 1 file changed, 5 insertions(+), 7 deletions(-)

diff --git a/src/PIL/ImageFont.py b/src/PIL/ImageFont.py
index 43e86a7ed25..abfa4aa80fb 100644
--- a/src/PIL/ImageFont.py
+++ b/src/PIL/ImageFont.py
@@ -771,14 +771,13 @@ def getlength(self, text: str | bytes, *args: Any, **kwargs: Any) -> float:
 
 def load(filename: str) -> ImageFont:
     """
-    Load a font file.  This function loads a font object from the given
-    bitmap font file, and returns the corresponding font object.
+    Load a font file. This function loads a font object from the given
+    bitmap font file, and returns the corresponding font object. For loading TrueType
+    or OpenType fonts instead, see :py:func:`~PIL.ImageFont.truetype`.
 
     :param filename: Name of font file.
     :return: A font object.
     :exception OSError: If the file could not be read.
-
-    .. seealso:: :py:func:`PIL.ImageFont.truetype`
     """
     f = ImageFont()
     f._load_pilfont(filename)
@@ -794,7 +793,8 @@ def truetype(
 ) -> FreeTypeFont:
     """
     Load a TrueType or OpenType font from a file or file-like object,
-    and create a font object.
+    and create a font object. For loading bitmap fonts instead,
+    see :py:func:`~PIL.ImageFont.load` and :py:func:`~PIL.ImageFont.load_path`.
     This function loads a font object from the given file or file-like
     object, and creates a font object for a font of the given size.
 
@@ -855,8 +855,6 @@ def truetype(
     :return: A font object.
     :exception OSError: If the file could not be read.
     :exception ValueError: If the font size is not greater than zero.
-
-    .. seealso:: :py:func:`PIL.ImageFont.load`
     """
 
     def freetype(font: StrOrBytesPath | BinaryIO | None) -> FreeTypeFont:

From dbe979d032afed04b93f9ce1aaa9c7f8e23542b1 Mon Sep 17 00:00:00 2001
From: Andrew Murray <radarhere@users.noreply.github.com>
Date: Sat, 7 Sep 2024 19:09:01 +1000
Subject: [PATCH 1005/1178] Sort extensions alphabetically in error message

---
 Tests/test_imagefont.py | 2 +-
 src/PIL/ImageFont.py    | 2 +-
 2 files changed, 2 insertions(+), 2 deletions(-)

diff --git a/Tests/test_imagefont.py b/Tests/test_imagefont.py
index 66e6947c2be..32cd1db8a70 100644
--- a/Tests/test_imagefont.py
+++ b/Tests/test_imagefont.py
@@ -469,7 +469,7 @@ def test_load_when_image_not_found(tmp_path: Path) -> None:
         ImageFont.load(tempfile)
 
     root = os.path.splitext(tempfile)[0]
-    assert str(e.value) == f"cannot find glyph data file {root}.{{png|gif|pbm}}"
+    assert str(e.value) == f"cannot find glyph data file {root}.{{gif|pbm|png}}"
 
 
 def test_load_path_not_found() -> None:
diff --git a/src/PIL/ImageFont.py b/src/PIL/ImageFont.py
index abfa4aa80fb..b6d69019da8 100644
--- a/src/PIL/ImageFont.py
+++ b/src/PIL/ImageFont.py
@@ -115,7 +115,7 @@ def _load_pilfont(self, filename: str) -> None:
                 if image:
                     image.close()
 
-                msg = f"cannot find glyph data file {root}.{{png|gif|pbm}}"
+                msg = f"cannot find glyph data file {root}.{{gif|pbm|png}}"
                 raise OSError(msg)
 
             self.file = fullname

From 2c02146cf4c745df531be49e6900005d7df486b7 Mon Sep 17 00:00:00 2001
From: Hugo van Kemenade <1324225+hugovk@users.noreply.github.com>
Date: Sat, 7 Sep 2024 12:32:30 +0300
Subject: [PATCH 1006/1178] Use type hints and fix CVE role

Co-authored-by: Andrew Murray <3112309+radarhere@users.noreply.github.com>
---
 Tests/test_imagefont.py      | 2 +-
 docs/deprecations.rst        | 2 +-
 docs/releasenotes/11.0.0.rst | 2 +-
 3 files changed, 3 insertions(+), 3 deletions(-)

diff --git a/Tests/test_imagefont.py b/Tests/test_imagefont.py
index cfadc7312a1..3c916db1852 100644
--- a/Tests/test_imagefont.py
+++ b/Tests/test_imagefont.py
@@ -1154,7 +1154,7 @@ def test_invalid_truetype_sizes_raise_valueerror(
 
 def test_freetype_deprecation(monkeypatch: pytest.MonkeyPatch) -> None:
     # Arrange: mock features.version_module to return fake FreeType version
-    def fake_version_module(module):
+    def fake_version_module(module: str) -> str:
         return "2.9.0"
 
     monkeypatch.setattr(features, "version_module", fake_version_module)
diff --git a/docs/deprecations.rst b/docs/deprecations.rst
index 9a2f16cfb68..8d303282778 100644
--- a/docs/deprecations.rst
+++ b/docs/deprecations.rst
@@ -21,7 +21,7 @@ Support for FreeType 2.9.0 is deprecated and will be removed in Pillow 12.0.0
 (2025-10-15), when FreeType 2.9.1 will be the minimum supported.
 
 We recommend upgrading to at least FreeType `2.10.4`_, which fixed a severe
-vulnerability introduced in FreeType 2.6 (:cve:`CVE-2020-15999`).
+vulnerability introduced in FreeType 2.6 (:cve:`2020-15999`).
 
 .. _2.10.4: https://sourceforge.net/projects/freetype/files/freetype2/2.10.4/
 
diff --git a/docs/releasenotes/11.0.0.rst b/docs/releasenotes/11.0.0.rst
index 99e0a292766..0c637cc6598 100644
--- a/docs/releasenotes/11.0.0.rst
+++ b/docs/releasenotes/11.0.0.rst
@@ -52,7 +52,7 @@ Support for FreeType 2.9.0 is deprecated and will be removed in Pillow 12.0.0
 (2025-10-15), when FreeType 2.9.1 will be the minimum supported.
 
 We recommend upgrading to at least FreeType `2.10.4`_, which fixed a severe
-vulnerability introduced in FreeType 2.6 (:cve:`CVE-2020-15999`).
+vulnerability introduced in FreeType 2.6 (:cve:`2020-15999`).
 
 .. _2.10.4: https://sourceforge.net/projects/freetype/files/freetype2/2.10.4/
 

From a3d23165b9414b17aee42239bead5034d6fa97c5 Mon Sep 17 00:00:00 2001
From: Andrew Murray <radarhere@users.noreply.github.com>
Date: Sat, 7 Sep 2024 19:40:29 +1000
Subject: [PATCH 1007/1178] Update CHANGES.rst [ci skip]

---
 CHANGES.rst | 3 +++
 1 file changed, 3 insertions(+)

diff --git a/CHANGES.rst b/CHANGES.rst
index b43466833bd..c5beebeba68 100644
--- a/CHANGES.rst
+++ b/CHANGES.rst
@@ -5,6 +5,9 @@ Changelog (Pillow)
 11.0.0 (unreleased)
 -------------------
 
+- Handle duplicate EXIF header #8350
+  [zakajd, radarhere]
+
 - Return early from BoxBlur if either width or height is zero #8347
   [radarhere]
 

From 547832fd592ee1392533be5bf935c19c690a665f Mon Sep 17 00:00:00 2001
From: Andrew Murray <radarhere@users.noreply.github.com>
Date: Sat, 7 Sep 2024 19:49:21 +1000
Subject: [PATCH 1008/1178] Use tempfile.NamedTemporaryFile

---
 Tests/test_imagefont.py | 17 +++++++++--------
 1 file changed, 9 insertions(+), 8 deletions(-)

diff --git a/Tests/test_imagefont.py b/Tests/test_imagefont.py
index 32cd1db8a70..e3d84756791 100644
--- a/Tests/test_imagefont.py
+++ b/Tests/test_imagefont.py
@@ -461,14 +461,15 @@ def test_free_type_font_get_mask(font: ImageFont.FreeTypeFont) -> None:
     assert mask.size == (108, 13)
 
 
-def test_load_when_image_not_found(tmp_path: Path) -> None:
-    tmpfile = tmp_path / "file.font"
-    tmpfile.write_bytes(b"")
-    tempfile = str(tmpfile)
+def test_load_when_image_not_found() -> None:
+    with tempfile.NamedTemporaryFile(delete=False) as tmp:
+        pass
     with pytest.raises(OSError) as e:
-        ImageFont.load(tempfile)
+        ImageFont.load(tmp.name)
 
-    root = os.path.splitext(tempfile)[0]
+    os.unlink(tmp.name)
+
+    root = os.path.splitext(tmp.name)[0]
     assert str(e.value) == f"cannot find glyph data file {root}.{{gif|pbm|png}}"
 
 
@@ -492,8 +493,8 @@ def test_load_path_existing_path() -> None:
         with pytest.raises(OSError) as e:
             ImageFont.load_path(tmp.name)
 
-        # The file exists, so the error message suggests to use `load` instead
-        assert tmp.name in str(e.value)
+    # The file exists, so the error message suggests to use `load` instead
+    assert tmp.name in str(e.value)
     assert " did you mean" in str(e.value)
 
 

From 8b3ef3784bc655e346028a72844d5c6e04083f47 Mon Sep 17 00:00:00 2001
From: Andrew Murray <radarhere@users.noreply.github.com>
Date: Sun, 8 Sep 2024 08:30:30 +1000
Subject: [PATCH 1009/1178] Moved Buffer into _typing

---
 docs/reference/internal_modules.rst |  4 ++++
 src/PIL/GifImagePlugin.py           | 17 ++++-------------
 src/PIL/TiffImagePlugin.py          | 15 +++------------
 src/PIL/_typing.py                  |  7 ++++++-
 4 files changed, 17 insertions(+), 26 deletions(-)

diff --git a/docs/reference/internal_modules.rst b/docs/reference/internal_modules.rst
index 31d60cd832e..93fd82cf9df 100644
--- a/docs/reference/internal_modules.rst
+++ b/docs/reference/internal_modules.rst
@@ -33,6 +33,10 @@ Internal Modules
 Provides a convenient way to import type hints that are not available
 on some Python versions.
 
+.. py:class:: Buffer
+
+    Typing alias.
+
 .. py:class:: IntegralLike
 
     Typing alias.
diff --git a/src/PIL/GifImagePlugin.py b/src/PIL/GifImagePlugin.py
index a27f7aae9dc..f206fbb9cef 100644
--- a/src/PIL/GifImagePlugin.py
+++ b/src/PIL/GifImagePlugin.py
@@ -29,7 +29,6 @@
 import math
 import os
 import subprocess
-import sys
 from enum import IntEnum
 from functools import cached_property
 from typing import IO, TYPE_CHECKING, Any, Literal, NamedTuple, Union
@@ -49,6 +48,7 @@
 
 if TYPE_CHECKING:
     from . import _imaging
+    from ._typing import Buffer
 
 
 class LoadingStrategy(IntEnum):
@@ -1157,18 +1157,9 @@ def getdata(
     class Collector(BytesIO):
         data = []
 
-        if sys.version_info >= (3, 12):
-            from collections.abc import Buffer
-
-            def write(self, data: Buffer) -> int:
-                self.data.append(data)
-                return len(data)
-
-        else:
-
-            def write(self, data: Any) -> int:
-                self.data.append(data)
-                return len(data)
+        def write(self, data: Buffer) -> int:
+            self.data.append(data)
+            return len(data)
 
     im.load()  # make sure raster data is available
 
diff --git a/src/PIL/TiffImagePlugin.py b/src/PIL/TiffImagePlugin.py
index 53f6ae621c7..a6b03e171e5 100644
--- a/src/PIL/TiffImagePlugin.py
+++ b/src/PIL/TiffImagePlugin.py
@@ -46,7 +46,6 @@
 import math
 import os
 import struct
-import sys
 import warnings
 from collections.abc import Iterator, MutableMapping
 from fractions import Fraction
@@ -63,7 +62,7 @@
 from .TiffTags import TYPES
 
 if TYPE_CHECKING:
-    from ._typing import IntegralLike
+    from ._typing import Buffer, IntegralLike
 
 logger = logging.getLogger(__name__)
 
@@ -2108,16 +2107,8 @@ def skipIFDs(self) -> None:
             num_tags = self.readShort()
             self.f.seek(num_tags * 12, os.SEEK_CUR)
 
-    if sys.version_info >= (3, 12):
-        from collections.abc import Buffer
-
-        def write(self, data: Buffer, /) -> int:
-            return self.f.write(data)
-
-    else:
-
-        def write(self, data: Any, /) -> int:
-            return self.f.write(data)
+    def write(self, data: Buffer, /) -> int:
+        return self.f.write(data)
 
     def readShort(self) -> int:
         (value,) = struct.unpack(self.shortFmt, self.f.read(2))
diff --git a/src/PIL/_typing.py b/src/PIL/_typing.py
index 093778464da..da49f7c5d5a 100644
--- a/src/PIL/_typing.py
+++ b/src/PIL/_typing.py
@@ -15,6 +15,11 @@
     except (ImportError, AttributeError):
         pass
 
+if sys.version_info >= (3, 12):
+    from collections.abc import Buffer
+else:
+    Buffer = Any
+
 if sys.version_info >= (3, 10):
     from typing import TypeGuard
 else:
@@ -40,4 +45,4 @@ def read(self, __length: int = ...) -> _T_co: ...
 StrOrBytesPath = Union[str, bytes, "os.PathLike[str]", "os.PathLike[bytes]"]
 
 
-__all__ = ["IntegralLike", "StrOrBytesPath", "SupportsRead", "TypeGuard"]
+__all__ = ["Buffer", "IntegralLike", "StrOrBytesPath", "SupportsRead", "TypeGuard"]

From 89c790f2b03aa44980eaabb6e9b5d312e5002fba Mon Sep 17 00:00:00 2001
From: Andrew Murray <radarhere@users.noreply.github.com>
Date: Sun, 8 Sep 2024 21:38:21 +1000
Subject: [PATCH 1010/1178] Update CHANGES.rst [ci skip]

---
 CHANGES.rst | 3 +++
 1 file changed, 3 insertions(+)

diff --git a/CHANGES.rst b/CHANGES.rst
index c5beebeba68..be94594f88c 100644
--- a/CHANGES.rst
+++ b/CHANGES.rst
@@ -5,6 +5,9 @@ Changelog (Pillow)
 11.0.0 (unreleased)
 -------------------
 
+- Removed unused TiffImagePlugin IFD_LEGACY_API #8355
+  [radarhere]
+
 - Handle duplicate EXIF header #8350
   [zakajd, radarhere]
 

From 6231453895ff9098fde1de8e4be2ddcf0574b1a8 Mon Sep 17 00:00:00 2001
From: Andrew Murray <radarhere@users.noreply.github.com>
Date: Sun, 8 Sep 2024 21:53:08 +1000
Subject: [PATCH 1011/1178] Group 11.0.0 deprecations

---
 docs/deprecations.rst | 26 +++++++++++++-------------
 1 file changed, 13 insertions(+), 13 deletions(-)

diff --git a/docs/deprecations.rst b/docs/deprecations.rst
index 8d303282778..bf290a9cda7 100644
--- a/docs/deprecations.rst
+++ b/docs/deprecations.rst
@@ -12,19 +12,6 @@ Deprecated features
 Below are features which are considered deprecated. Where appropriate,
 a :py:exc:`DeprecationWarning` is issued.
 
-FreeType 2.9.0
-~~~~~~~~~~~~~~
-
-.. deprecated:: 11.0.0
-
-Support for FreeType 2.9.0 is deprecated and will be removed in Pillow 12.0.0
-(2025-10-15), when FreeType 2.9.1 will be the minimum supported.
-
-We recommend upgrading to at least FreeType `2.10.4`_, which fixed a severe
-vulnerability introduced in FreeType 2.6 (:cve:`2020-15999`).
-
-.. _2.10.4: https://sourceforge.net/projects/freetype/files/freetype2/2.10.4/
-
 ImageFile.raise_oserror
 ~~~~~~~~~~~~~~~~~~~~~~~
 
@@ -122,6 +109,19 @@ ImageDraw.getdraw hints parameter
 
 The ``hints`` parameter in :py:meth:`~PIL.ImageDraw.getdraw()` has been deprecated.
 
+FreeType 2.9.0
+~~~~~~~~~~~~~~
+
+.. deprecated:: 11.0.0
+
+Support for FreeType 2.9.0 is deprecated and will be removed in Pillow 12.0.0
+(2025-10-15), when FreeType 2.9.1 will be the minimum supported.
+
+We recommend upgrading to at least FreeType `2.10.4`_, which fixed a severe
+vulnerability introduced in FreeType 2.6 (:cve:`2020-15999`).
+
+.. _2.10.4: https://sourceforge.net/projects/freetype/files/freetype2/2.10.4/
+
 ImageMath.lambda_eval and ImageMath.unsafe_eval options parameter
 ^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
 

From 8c738f6427c1be395921f5ef3f1e6e4aa86f4eb7 Mon Sep 17 00:00:00 2001
From: "renovate[bot]" <29139614+renovate[bot]@users.noreply.github.com>
Date: Sun, 8 Sep 2024 13:00:15 +0000
Subject: [PATCH 1012/1178] Update deadsnakes/action action to v3.2.0

---
 .github/workflows/test.yml | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/.github/workflows/test.yml b/.github/workflows/test.yml
index 1b169db9170..e0903f8869c 100644
--- a/.github/workflows/test.yml
+++ b/.github/workflows/test.yml
@@ -76,7 +76,7 @@ jobs:
           "pyproject.toml"
 
     - name: Set up Python ${{ matrix.python-version }} (free-threaded)
-      uses: deadsnakes/action@v3.1.0
+      uses: deadsnakes/action@v3.2.0
       if: "${{ matrix.disable-gil }}"
       with:
         python-version: ${{ matrix.python-version }}

From 2f13c4588d6287140a7e94bc8bc6c732610bd31e Mon Sep 17 00:00:00 2001
From: Hugo van Kemenade <1324225+hugovk@users.noreply.github.com>
Date: Sun, 8 Sep 2024 16:17:13 +0300
Subject: [PATCH 1013/1178] Fix underline

Co-authored-by: Andrew Murray <3112309+radarhere@users.noreply.github.com>
---
 docs/deprecations.rst | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/docs/deprecations.rst b/docs/deprecations.rst
index bf290a9cda7..1d2da238129 100644
--- a/docs/deprecations.rst
+++ b/docs/deprecations.rst
@@ -110,7 +110,7 @@ ImageDraw.getdraw hints parameter
 The ``hints`` parameter in :py:meth:`~PIL.ImageDraw.getdraw()` has been deprecated.
 
 FreeType 2.9.0
-~~~~~~~~~~~~~~
+^^^^^^^^^^^^^^
 
 .. deprecated:: 11.0.0
 

From fe002a72606ff33279ce798f77154f5bf8dcef17 Mon Sep 17 00:00:00 2001
From: Aleksandr Karpinskii <homm86@gmail.com>
Date: Mon, 2 Sep 2024 01:24:51 +0400
Subject: [PATCH 1014/1178] Use PyCapsule in _imagingmath

---
 src/PIL/ImageMath.py |   4 +-
 src/_imagingmath.c   | 153 +++++++++++++++++++++++++++----------------
 2 files changed, 98 insertions(+), 59 deletions(-)

diff --git a/src/PIL/ImageMath.py b/src/PIL/ImageMath.py
index 191cc2a5f88..b32742657ba 100644
--- a/src/PIL/ImageMath.py
+++ b/src/PIL/ImageMath.py
@@ -65,7 +65,7 @@ def apply(
             except AttributeError as e:
                 msg = f"bad operand type for '{op}'"
                 raise TypeError(msg) from e
-            _imagingmath.unop(op, out.im.id, im_1.im.id)
+            _imagingmath.unop(op, out.im.ptr, im_1.im.ptr)
         else:
             # binary operation
             im_2 = self.__fixup(im2)
@@ -93,7 +93,7 @@ def apply(
             except AttributeError as e:
                 msg = f"bad operand type for '{op}'"
                 raise TypeError(msg) from e
-            _imagingmath.binop(op, out.im.id, im_1.im.id, im_2.im.id)
+            _imagingmath.binop(op, out.im.ptr, im_1.im.ptr, im_2.im.ptr)
         return _Operand(out)
 
     # unary operators
diff --git a/src/_imagingmath.c b/src/_imagingmath.c
index 550a1090382..eafcf1444e9 100644
--- a/src/_imagingmath.c
+++ b/src/_imagingmath.c
@@ -23,6 +23,9 @@
 #define MAX_INT32 2147483647.0
 #define MIN_INT32 -2147483648.0
 
+#define MATH_FUNC_UNOP_MAGIC "Pillow Math unary func"
+#define MATH_FUNC_BINOP_MAGIC "Pillow Math binary func"
+
 #define UNOP(name, op, type)                   \
     void name(Imaging out, Imaging im1) {      \
         int x, y;                              \
@@ -168,15 +171,28 @@ _unop(PyObject *self, PyObject *args) {
     Imaging im1;
     void (*unop)(Imaging, Imaging);
 
-    Py_ssize_t op, i0, i1;
-    if (!PyArg_ParseTuple(args, "nnn", &op, &i0, &i1)) {
+    PyObject *op, *i0, *i1;
+    if (!PyArg_ParseTuple(args, "OOO", &op, &i0, &i1)) {
         return NULL;
     }
 
-    out = (Imaging)i0;
-    im1 = (Imaging)i1;
+    if (!PyCapsule_IsValid(op, MATH_FUNC_UNOP_MAGIC)) {
+        PyErr_Format(
+            PyExc_TypeError, "Expected PyCapsule with '%s' name.", MATH_FUNC_UNOP_MAGIC
+        );
+        return NULL;
+    }
+    if (!PyCapsule_IsValid(i0, IMAGING_MAGIC) ||
+        !PyCapsule_IsValid(i1, IMAGING_MAGIC)) {
+        PyErr_Format(
+            PyExc_TypeError, "Expected PyCapsule with '%s' name.", IMAGING_MAGIC
+        );
+        return NULL;
+    }
 
-    unop = (void *)op;
+    unop = (void *)PyCapsule_GetPointer(op, MATH_FUNC_UNOP_MAGIC);
+    out = (Imaging)PyCapsule_GetPointer(i0, IMAGING_MAGIC);
+    im1 = (Imaging)PyCapsule_GetPointer(i1, IMAGING_MAGIC);
 
     unop(out, im1);
 
@@ -191,16 +207,30 @@ _binop(PyObject *self, PyObject *args) {
     Imaging im2;
     void (*binop)(Imaging, Imaging, Imaging);
 
-    Py_ssize_t op, i0, i1, i2;
-    if (!PyArg_ParseTuple(args, "nnnn", &op, &i0, &i1, &i2)) {
+    PyObject *op, *i0, *i1, *i2;
+    if (!PyArg_ParseTuple(args, "OOOO", &op, &i0, &i1, &i2)) {
         return NULL;
     }
 
-    out = (Imaging)i0;
-    im1 = (Imaging)i1;
-    im2 = (Imaging)i2;
+    if (!PyCapsule_IsValid(op, MATH_FUNC_BINOP_MAGIC)) {
+        PyErr_Format(
+            PyExc_TypeError, "Expected PyCapsule with '%s' name.", MATH_FUNC_BINOP_MAGIC
+        );
+        return NULL;
+    }
+    if (!PyCapsule_IsValid(i0, IMAGING_MAGIC) ||
+        !PyCapsule_IsValid(i1, IMAGING_MAGIC) ||
+        !PyCapsule_IsValid(i2, IMAGING_MAGIC)) {
+        PyErr_Format(
+            PyExc_TypeError, "Expected PyCapsule with '%s' name.", IMAGING_MAGIC
+        );
+        return NULL;
+    }
 
-    binop = (void *)op;
+    binop = (void *)PyCapsule_GetPointer(op, MATH_FUNC_BINOP_MAGIC);
+    out = (Imaging)PyCapsule_GetPointer(i0, IMAGING_MAGIC);
+    im1 = (Imaging)PyCapsule_GetPointer(i1, IMAGING_MAGIC);
+    im2 = (Imaging)PyCapsule_GetPointer(i2, IMAGING_MAGIC);
 
     binop(out, im1, im2);
 
@@ -213,8 +243,17 @@ static PyMethodDef _functions[] = {
 };
 
 static void
-install(PyObject *d, char *name, void *value) {
-    PyObject *v = PyLong_FromSsize_t((Py_ssize_t)value);
+install_unary(PyObject *d, char *name, void *func) {
+    PyObject *v = PyCapsule_New(func, MATH_FUNC_UNOP_MAGIC, NULL);
+    if (!v || PyDict_SetItemString(d, name, v)) {
+        PyErr_Clear();
+    }
+    Py_XDECREF(v);
+}
+
+static void
+install_binary(PyObject *d, char *name, void *func) {
+    PyObject *v = PyCapsule_New(func, MATH_FUNC_BINOP_MAGIC, NULL);
     if (!v || PyDict_SetItemString(d, name, v)) {
         PyErr_Clear();
     }
@@ -225,50 +264,50 @@ static int
 setup_module(PyObject *m) {
     PyObject *d = PyModule_GetDict(m);
 
-    install(d, "abs_I", abs_I);
-    install(d, "neg_I", neg_I);
-    install(d, "add_I", add_I);
-    install(d, "sub_I", sub_I);
-    install(d, "diff_I", diff_I);
-    install(d, "mul_I", mul_I);
-    install(d, "div_I", div_I);
-    install(d, "mod_I", mod_I);
-    install(d, "min_I", min_I);
-    install(d, "max_I", max_I);
-    install(d, "pow_I", pow_I);
-
-    install(d, "invert_I", invert_I);
-    install(d, "and_I", and_I);
-    install(d, "or_I", or_I);
-    install(d, "xor_I", xor_I);
-    install(d, "lshift_I", lshift_I);
-    install(d, "rshift_I", rshift_I);
-
-    install(d, "eq_I", eq_I);
-    install(d, "ne_I", ne_I);
-    install(d, "lt_I", lt_I);
-    install(d, "le_I", le_I);
-    install(d, "gt_I", gt_I);
-    install(d, "ge_I", ge_I);
-
-    install(d, "abs_F", abs_F);
-    install(d, "neg_F", neg_F);
-    install(d, "add_F", add_F);
-    install(d, "sub_F", sub_F);
-    install(d, "diff_F", diff_F);
-    install(d, "mul_F", mul_F);
-    install(d, "div_F", div_F);
-    install(d, "mod_F", mod_F);
-    install(d, "min_F", min_F);
-    install(d, "max_F", max_F);
-    install(d, "pow_F", pow_F);
-
-    install(d, "eq_F", eq_F);
-    install(d, "ne_F", ne_F);
-    install(d, "lt_F", lt_F);
-    install(d, "le_F", le_F);
-    install(d, "gt_F", gt_F);
-    install(d, "ge_F", ge_F);
+    install_unary(d, "abs_I", abs_I);
+    install_unary(d, "neg_I", neg_I);
+    install_binary(d, "add_I", add_I);
+    install_binary(d, "sub_I", sub_I);
+    install_binary(d, "diff_I", diff_I);
+    install_binary(d, "mul_I", mul_I);
+    install_binary(d, "div_I", div_I);
+    install_binary(d, "mod_I", mod_I);
+    install_binary(d, "min_I", min_I);
+    install_binary(d, "max_I", max_I);
+    install_binary(d, "pow_I", pow_I);
+
+    install_unary(d, "invert_I", invert_I);
+    install_binary(d, "and_I", and_I);
+    install_binary(d, "or_I", or_I);
+    install_binary(d, "xor_I", xor_I);
+    install_binary(d, "lshift_I", lshift_I);
+    install_binary(d, "rshift_I", rshift_I);
+
+    install_binary(d, "eq_I", eq_I);
+    install_binary(d, "ne_I", ne_I);
+    install_binary(d, "lt_I", lt_I);
+    install_binary(d, "le_I", le_I);
+    install_binary(d, "gt_I", gt_I);
+    install_binary(d, "ge_I", ge_I);
+
+    install_unary(d, "abs_F", abs_F);
+    install_unary(d, "neg_F", neg_F);
+    install_binary(d, "add_F", add_F);
+    install_binary(d, "sub_F", sub_F);
+    install_binary(d, "diff_F", diff_F);
+    install_binary(d, "mul_F", mul_F);
+    install_binary(d, "div_F", div_F);
+    install_binary(d, "mod_F", mod_F);
+    install_binary(d, "min_F", min_F);
+    install_binary(d, "max_F", max_F);
+    install_binary(d, "pow_F", pow_F);
+
+    install_binary(d, "eq_F", eq_F);
+    install_binary(d, "ne_F", ne_F);
+    install_binary(d, "lt_F", lt_F);
+    install_binary(d, "le_F", le_F);
+    install_binary(d, "gt_F", gt_F);
+    install_binary(d, "ge_F", ge_F);
 
     return 0;
 }

From 56bc6a1a71da0d51666689c9d89a21615edfc757 Mon Sep 17 00:00:00 2001
From: Aleksandr Karpinskii <homm86@gmail.com>
Date: Mon, 2 Sep 2024 01:32:28 +0400
Subject: [PATCH 1015/1178] Use PyCapsule in _imagingcms

---
 src/PIL/ImageCms.py |  4 ++--
 src/_imagingcms.c   | 21 ++++++++++++---------
 2 files changed, 14 insertions(+), 11 deletions(-)

diff --git a/src/PIL/ImageCms.py b/src/PIL/ImageCms.py
index ec10230f12b..5e256b0ab7f 100644
--- a/src/PIL/ImageCms.py
+++ b/src/PIL/ImageCms.py
@@ -352,7 +352,7 @@ def apply(self, im: Image.Image, imOut: Image.Image | None = None) -> Image.Imag
         im.load()
         if imOut is None:
             imOut = Image.new(self.output_mode, im.size, None)
-        self.transform.apply(im.im.id, imOut.im.id)
+        self.transform.apply(im.im.ptr, imOut.im.ptr)
         imOut.info["icc_profile"] = self.output_profile.tobytes()
         return imOut
 
@@ -361,7 +361,7 @@ def apply_in_place(self, im: Image.Image) -> Image.Image:
         if im.mode != self.output_mode:
             msg = "mode mismatch"
             raise ValueError(msg)  # wrong output mode
-        self.transform.apply(im.im.id, im.im.id)
+        self.transform.apply(im.im.ptr, im.im.ptr)
         im.info["icc_profile"] = self.output_profile.tobytes()
         return im
 
diff --git a/src/_imagingcms.c b/src/_imagingcms.c
index bafe787a743..444b6a60237 100644
--- a/src/_imagingcms.c
+++ b/src/_imagingcms.c
@@ -531,23 +531,26 @@ buildProofTransform(PyObject *self, PyObject *args) {
 
 static PyObject *
 cms_transform_apply(CmsTransformObject *self, PyObject *args) {
-    Py_ssize_t idIn;
-    Py_ssize_t idOut;
+    PyObject *i0, *i1;
     Imaging im;
     Imaging imOut;
 
-    int result;
-
-    if (!PyArg_ParseTuple(args, "nn:apply", &idIn, &idOut)) {
+    if (!PyArg_ParseTuple(args, "OO:apply", &i0, &i1)) {
         return NULL;
     }
 
-    im = (Imaging)idIn;
-    imOut = (Imaging)idOut;
+    if (!PyCapsule_IsValid(i0, IMAGING_MAGIC) ||
+        !PyCapsule_IsValid(i1, IMAGING_MAGIC)) {
+        PyErr_Format(
+            PyExc_TypeError, "Expected PyCapsule with '%s' name.", IMAGING_MAGIC
+        );
+        return NULL;
+    }
 
-    result = pyCMSdoTransform(im, imOut, self->transform);
+    im = (Imaging)PyCapsule_GetPointer(i0, IMAGING_MAGIC);
+    imOut = (Imaging)PyCapsule_GetPointer(i1, IMAGING_MAGIC);
 
-    return Py_BuildValue("i", result);
+    return Py_BuildValue("i", pyCMSdoTransform(im, imOut, self->transform));
 }
 
 /* -------------------------------------------------------------------- */

From f916b5dc87664b89603f413c179f1ccc6aeab95a Mon Sep 17 00:00:00 2001
From: Aleksandr Karpinskii <homm86@gmail.com>
Date: Mon, 2 Sep 2024 01:43:38 +0400
Subject: [PATCH 1016/1178] Use PyCapsule in _imagingmorph

---
 Tests/test_imagemorph.py |  8 +++----
 src/PIL/ImageMorph.py    |  6 ++---
 src/_imagingmorph.c      | 48 ++++++++++++++++++++++++++++++----------
 3 files changed, 43 insertions(+), 19 deletions(-)

diff --git a/Tests/test_imagemorph.py b/Tests/test_imagemorph.py
index 80d8c38155b..04860fd616c 100644
--- a/Tests/test_imagemorph.py
+++ b/Tests/test_imagemorph.py
@@ -328,13 +328,13 @@ def test_wrong_mode() -> None:
     iml = Image.new("L", (10, 10))
 
     with pytest.raises(RuntimeError):
-        _imagingmorph.apply(bytes(lut), imrgb.im.id, iml.im.id)
+        _imagingmorph.apply(bytes(lut), imrgb.im.ptr, iml.im.ptr)
 
     with pytest.raises(RuntimeError):
-        _imagingmorph.apply(bytes(lut), iml.im.id, imrgb.im.id)
+        _imagingmorph.apply(bytes(lut), iml.im.ptr, imrgb.im.ptr)
 
     with pytest.raises(RuntimeError):
-        _imagingmorph.match(bytes(lut), imrgb.im.id)
+        _imagingmorph.match(bytes(lut), imrgb.im.ptr)
 
     # Should not raise
-    _imagingmorph.match(bytes(lut), iml.im.id)
+    _imagingmorph.match(bytes(lut), iml.im.ptr)
diff --git a/src/PIL/ImageMorph.py b/src/PIL/ImageMorph.py
index 6a43983d33d..bc7ed66d3fb 100644
--- a/src/PIL/ImageMorph.py
+++ b/src/PIL/ImageMorph.py
@@ -213,7 +213,7 @@ def apply(self, image: Image.Image) -> tuple[int, Image.Image]:
             msg = "Image mode must be L"
             raise ValueError(msg)
         outimage = Image.new(image.mode, image.size, None)
-        count = _imagingmorph.apply(bytes(self.lut), image.im.id, outimage.im.id)
+        count = _imagingmorph.apply(bytes(self.lut), image.im.ptr, outimage.im.ptr)
         return count, outimage
 
     def match(self, image: Image.Image) -> list[tuple[int, int]]:
@@ -229,7 +229,7 @@ def match(self, image: Image.Image) -> list[tuple[int, int]]:
         if image.mode != "L":
             msg = "Image mode must be L"
             raise ValueError(msg)
-        return _imagingmorph.match(bytes(self.lut), image.im.id)
+        return _imagingmorph.match(bytes(self.lut), image.im.ptr)
 
     def get_on_pixels(self, image: Image.Image) -> list[tuple[int, int]]:
         """Get a list of all turned on pixels in a binary image
@@ -240,7 +240,7 @@ def get_on_pixels(self, image: Image.Image) -> list[tuple[int, int]]:
         if image.mode != "L":
             msg = "Image mode must be L"
             raise ValueError(msg)
-        return _imagingmorph.get_on_pixels(image.im.id)
+        return _imagingmorph.get_on_pixels(image.im.ptr)
 
     def load_lut(self, filename: str) -> None:
         """Load an operator from an mrl file"""
diff --git a/src/_imagingmorph.c b/src/_imagingmorph.c
index 614dfbe7fe7..c7933cc7d5e 100644
--- a/src/_imagingmorph.c
+++ b/src/_imagingmorph.c
@@ -30,15 +30,15 @@
 static PyObject *
 apply(PyObject *self, PyObject *args) {
     const char *lut;
-    PyObject *py_lut;
-    Py_ssize_t lut_len, i0, i1;
+    PyObject *py_lut, *i0, *i1;
+    Py_ssize_t lut_len;
     Imaging imgin, imgout;
     int width, height;
     int row_idx, col_idx;
     UINT8 **inrows, **outrows;
     int num_changed_pixels = 0;
 
-    if (!PyArg_ParseTuple(args, "Onn", &py_lut, &i0, &i1)) {
+    if (!PyArg_ParseTuple(args, "OOO", &py_lut, &i0, &i1)) {
         PyErr_SetString(PyExc_RuntimeError, "Argument parsing problem");
         return NULL;
     }
@@ -57,8 +57,16 @@ apply(PyObject *self, PyObject *args) {
 
     lut = PyBytes_AsString(py_lut);
 
-    imgin = (Imaging)i0;
-    imgout = (Imaging)i1;
+    if (!PyCapsule_IsValid(i0, IMAGING_MAGIC) ||
+        !PyCapsule_IsValid(i1, IMAGING_MAGIC)) {
+        PyErr_Format(
+            PyExc_TypeError, "Expected PyCapsule with '%s' name.", IMAGING_MAGIC
+        );
+        return NULL;
+    }
+
+    imgin = (Imaging)PyCapsule_GetPointer(i0, IMAGING_MAGIC);
+    imgout = (Imaging)PyCapsule_GetPointer(i1, IMAGING_MAGIC);
     width = imgin->xsize;
     height = imgin->ysize;
 
@@ -129,8 +137,8 @@ apply(PyObject *self, PyObject *args) {
 static PyObject *
 match(PyObject *self, PyObject *args) {
     const char *lut;
-    PyObject *py_lut;
-    Py_ssize_t lut_len, i0;
+    PyObject *py_lut, *i0;
+    Py_ssize_t lut_len;
     Imaging imgin;
     int width, height;
     int row_idx, col_idx;
@@ -140,7 +148,7 @@ match(PyObject *self, PyObject *args) {
         return NULL;
     }
 
-    if (!PyArg_ParseTuple(args, "On", &py_lut, &i0)) {
+    if (!PyArg_ParseTuple(args, "OO", &py_lut, &i0)) {
         Py_DECREF(ret);
         PyErr_SetString(PyExc_RuntimeError, "Argument parsing problem");
         return NULL;
@@ -161,7 +169,15 @@ match(PyObject *self, PyObject *args) {
     }
 
     lut = PyBytes_AsString(py_lut);
-    imgin = (Imaging)i0;
+
+    if (!PyCapsule_IsValid(i0, IMAGING_MAGIC)) {
+        PyErr_Format(
+            PyExc_TypeError, "Expected PyCapsule with '%s' name.", IMAGING_MAGIC
+        );
+        return NULL;
+    }
+
+    imgin = (Imaging)PyCapsule_GetPointer(i0, IMAGING_MAGIC);
 
     if (imgin->type != IMAGING_TYPE_UINT8 || imgin->bands != 1) {
         Py_DECREF(ret);
@@ -215,7 +231,7 @@ match(PyObject *self, PyObject *args) {
 */
 static PyObject *
 get_on_pixels(PyObject *self, PyObject *args) {
-    Py_ssize_t i0;
+    PyObject *i0;
     Imaging img;
     UINT8 **rows;
     int row_idx, col_idx;
@@ -225,12 +241,20 @@ get_on_pixels(PyObject *self, PyObject *args) {
         return NULL;
     }
 
-    if (!PyArg_ParseTuple(args, "n", &i0)) {
+    if (!PyArg_ParseTuple(args, "O", &i0)) {
         Py_DECREF(ret);
         PyErr_SetString(PyExc_RuntimeError, "Argument parsing problem");
         return NULL;
     }
-    img = (Imaging)i0;
+
+    if (!PyCapsule_IsValid(i0, IMAGING_MAGIC)) {
+        PyErr_Format(
+            PyExc_TypeError, "Expected PyCapsule with '%s' name.", IMAGING_MAGIC
+        );
+        return NULL;
+    }
+
+    img = (Imaging)PyCapsule_GetPointer(i0, IMAGING_MAGIC);
     rows = img->image8;
     width = img->xsize;
     height = img->ysize;

From 7f48567002a74a9f102dc3b183f872846e2925b3 Mon Sep 17 00:00:00 2001
From: Aleksandr Karpinskii <homm86@gmail.com>
Date: Mon, 2 Sep 2024 02:00:07 +0400
Subject: [PATCH 1017/1178] Use s# in PyArg_ParseTuple

---
 src/_imagingmorph.c         | 53 ++++++++++---------------------------
 src/libImaging/ImPlatform.h |  1 +
 2 files changed, 15 insertions(+), 39 deletions(-)

diff --git a/src/_imagingmorph.c b/src/_imagingmorph.c
index c7933cc7d5e..715cccf5142 100644
--- a/src/_imagingmorph.c
+++ b/src/_imagingmorph.c
@@ -11,7 +11,6 @@
  * See the README file for information on usage and redistribution.
  */
 
-#include "Python.h"
 #include "libImaging/Imaging.h"
 
 #define LUT_SIZE (1 << 9)
@@ -30,7 +29,7 @@
 static PyObject *
 apply(PyObject *self, PyObject *args) {
     const char *lut;
-    PyObject *py_lut, *i0, *i1;
+    PyObject *i0, *i1;
     Py_ssize_t lut_len;
     Imaging imgin, imgout;
     int width, height;
@@ -38,25 +37,15 @@ apply(PyObject *self, PyObject *args) {
     UINT8 **inrows, **outrows;
     int num_changed_pixels = 0;
 
-    if (!PyArg_ParseTuple(args, "OOO", &py_lut, &i0, &i1)) {
-        PyErr_SetString(PyExc_RuntimeError, "Argument parsing problem");
+    if (!PyArg_ParseTuple(args, "s#OO", &lut, &lut_len, &i0, &i1)) {
         return NULL;
     }
 
-    if (!PyBytes_Check(py_lut)) {
-        PyErr_SetString(PyExc_RuntimeError, "The morphology LUT is not a bytes object");
-        return NULL;
-    }
-
-    lut_len = PyBytes_Size(py_lut);
-
     if (lut_len < LUT_SIZE) {
         PyErr_SetString(PyExc_RuntimeError, "The morphology LUT has the wrong size");
         return NULL;
     }
 
-    lut = PyBytes_AsString(py_lut);
-
     if (!PyCapsule_IsValid(i0, IMAGING_MAGIC) ||
         !PyCapsule_IsValid(i1, IMAGING_MAGIC)) {
         PyErr_Format(
@@ -137,39 +126,22 @@ apply(PyObject *self, PyObject *args) {
 static PyObject *
 match(PyObject *self, PyObject *args) {
     const char *lut;
-    PyObject *py_lut, *i0;
+    PyObject *i0;
     Py_ssize_t lut_len;
     Imaging imgin;
     int width, height;
     int row_idx, col_idx;
     UINT8 **inrows;
-    PyObject *ret = PyList_New(0);
-    if (ret == NULL) {
-        return NULL;
-    }
 
-    if (!PyArg_ParseTuple(args, "OO", &py_lut, &i0)) {
-        Py_DECREF(ret);
-        PyErr_SetString(PyExc_RuntimeError, "Argument parsing problem");
+    if (!PyArg_ParseTuple(args, "s#O", &lut, &lut_len, &i0)) {
         return NULL;
     }
 
-    if (!PyBytes_Check(py_lut)) {
-        Py_DECREF(ret);
-        PyErr_SetString(PyExc_RuntimeError, "The morphology LUT is not a bytes object");
-        return NULL;
-    }
-
-    lut_len = PyBytes_Size(py_lut);
-
     if (lut_len < LUT_SIZE) {
-        Py_DECREF(ret);
         PyErr_SetString(PyExc_RuntimeError, "The morphology LUT has the wrong size");
         return NULL;
     }
 
-    lut = PyBytes_AsString(py_lut);
-
     if (!PyCapsule_IsValid(i0, IMAGING_MAGIC)) {
         PyErr_Format(
             PyExc_TypeError, "Expected PyCapsule with '%s' name.", IMAGING_MAGIC
@@ -180,11 +152,15 @@ match(PyObject *self, PyObject *args) {
     imgin = (Imaging)PyCapsule_GetPointer(i0, IMAGING_MAGIC);
 
     if (imgin->type != IMAGING_TYPE_UINT8 || imgin->bands != 1) {
-        Py_DECREF(ret);
         PyErr_SetString(PyExc_RuntimeError, "Unsupported image type");
         return NULL;
     }
 
+    PyObject *ret = PyList_New(0);
+    if (ret == NULL) {
+        return NULL;
+    }
+
     inrows = imgin->image8;
     width = imgin->xsize;
     height = imgin->ysize;
@@ -236,14 +212,8 @@ get_on_pixels(PyObject *self, PyObject *args) {
     UINT8 **rows;
     int row_idx, col_idx;
     int width, height;
-    PyObject *ret = PyList_New(0);
-    if (ret == NULL) {
-        return NULL;
-    }
 
     if (!PyArg_ParseTuple(args, "O", &i0)) {
-        Py_DECREF(ret);
-        PyErr_SetString(PyExc_RuntimeError, "Argument parsing problem");
         return NULL;
     }
 
@@ -259,6 +229,11 @@ get_on_pixels(PyObject *self, PyObject *args) {
     width = img->xsize;
     height = img->ysize;
 
+    PyObject *ret = PyList_New(0);
+    if (ret == NULL) {
+        return NULL;
+    }
+
     for (row_idx = 0; row_idx < height; row_idx++) {
         UINT8 *row = rows[row_idx];
         for (col_idx = 0; col_idx < width; col_idx++) {
diff --git a/src/libImaging/ImPlatform.h b/src/libImaging/ImPlatform.h
index f6e7fb6b921..c9b7e43b425 100644
--- a/src/libImaging/ImPlatform.h
+++ b/src/libImaging/ImPlatform.h
@@ -7,6 +7,7 @@
  * Copyright (c) Fredrik Lundh 1995-2003.
  */
 
+#define PY_SSIZE_T_CLEAN
 #include "Python.h"
 
 /* Check that we have an ANSI compliant compiler */

From 5428e3568e09d69241b03827eecb08d7b5dc9ea9 Mon Sep 17 00:00:00 2001
From: Aleksandr Karpinskii <homm86@gmail.com>
Date: Mon, 2 Sep 2024 02:19:44 +0400
Subject: [PATCH 1018/1178] Deprecate ImageCore.id and ImageCore.unsafe_ptrs

---
 Tests/test_image_getim.py | 12 ++++++++++--
 docs/deprecations.rst     | 10 ++++++++++
 src/_imaging.c            | 14 ++++++++++++++
 src/libImaging/Imaging.h  |  2 +-
 4 files changed, 35 insertions(+), 3 deletions(-)

diff --git a/Tests/test_image_getim.py b/Tests/test_image_getim.py
index 9afa02b0a8b..75d97cd4451 100644
--- a/Tests/test_image_getim.py
+++ b/Tests/test_image_getim.py
@@ -1,11 +1,19 @@
 from __future__ import annotations
 
+import pytest
+
 from .helper import hopper
 
 
 def test_sanity() -> None:
     im = hopper()
-    type_repr = repr(type(im.getim()))
 
+    type_repr = repr(type(im.getim()))
     assert "PyCapsule" in type_repr
-    assert isinstance(im.im.id, int)
+
+    with pytest.warns(DeprecationWarning):
+        assert isinstance(im.im.id, int)
+
+    with pytest.warns(DeprecationWarning):
+        ptrs = dict(im.im.unsafe_ptrs)
+    assert all(k in ptrs for k in ["image8", "image32", "image"])
diff --git a/docs/deprecations.rst b/docs/deprecations.rst
index cafda38032a..abb902c88eb 100644
--- a/docs/deprecations.rst
+++ b/docs/deprecations.rst
@@ -136,6 +136,16 @@ Specific WebP Feature Checks
 ``True`` if the WebP module is installed, until they are removed in Pillow
 12.0.0 (2025-10-15).
 
+Get Internal Pointers to Objects
+^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
+
+.. deprecated:: 11.0.0
+
+``Image.core.ImageCore.id`` and ``Image.core.ImageCore.unsafe_ptrs``
+have been deprecated and will be removed in Pillow 12 (2025-10-15).
+They were used for obtaining raw pointers to ``ImageCore`` internals. To interact with
+C code, you can use ``Image.core.ImageCore.ptr``, which returns a ``PyCapsule`` object.
+
 Removed features
 ----------------
 
diff --git a/src/_imaging.c b/src/_imaging.c
index 07d9a64ccff..a455c873b15 100644
--- a/src/_imaging.c
+++ b/src/_imaging.c
@@ -3707,6 +3707,13 @@ _getattr_bands(ImagingObject *self, void *closure) {
 
 static PyObject *
 _getattr_id(ImagingObject *self, void *closure) {
+    if (PyErr_WarnEx(
+            PyExc_DeprecationWarning,
+            "id property is deprecated and will be removed in Pillow 12.0",
+            1
+        ) < 0) {
+        return NULL;
+    }
     return PyLong_FromSsize_t((Py_ssize_t)self->image);
 }
 
@@ -3717,6 +3724,13 @@ _getattr_ptr(ImagingObject *self, void *closure) {
 
 static PyObject *
 _getattr_unsafe_ptrs(ImagingObject *self, void *closure) {
+    if (PyErr_WarnEx(
+            PyExc_DeprecationWarning,
+            "unsafe_ptrs property is deprecated and will be removed in Pillow 12.0",
+            1
+        ) < 0) {
+        return NULL;
+    }
     return Py_BuildValue(
         "(sn)(sn)(sn)",
         "image8",
diff --git a/src/libImaging/Imaging.h b/src/libImaging/Imaging.h
index 321dce988c3..870f5ed971a 100644
--- a/src/libImaging/Imaging.h
+++ b/src/libImaging/Imaging.h
@@ -61,7 +61,7 @@ typedef struct ImagingOutlineInstance *ImagingOutline;
 typedef struct ImagingPaletteInstance *ImagingPalette;
 
 /* handle magics (used with PyCObject). */
-#define IMAGING_MAGIC "PIL Imaging"
+#define IMAGING_MAGIC "Pillow Imaging"
 
 /* pixel types */
 #define IMAGING_TYPE_UINT8 0

From cb3a4e6a00fd41e42afa78b4289e5e1056fc0e81 Mon Sep 17 00:00:00 2001
From: Aleksandr Karpinskii <homm86@gmail.com>
Date: Mon, 2 Sep 2024 03:45:18 +0400
Subject: [PATCH 1019/1178] Remove legacy 1-bit api, fix AttributeError

PytestUnraisableExceptionWarning: Exception ignored in: <function PhotoImage.__del__>
AttributeError: 'PhotoImage' object has no attribute '_PhotoImage__photo'
---
 src/PIL/ImageTk.py | 28 +++++-----------------------
 1 file changed, 5 insertions(+), 23 deletions(-)

diff --git a/src/PIL/ImageTk.py b/src/PIL/ImageTk.py
index a788c9d1f13..d546989eeec 100644
--- a/src/PIL/ImageTk.py
+++ b/src/PIL/ImageTk.py
@@ -35,20 +35,6 @@
 # --------------------------------------------------------------------
 # Check for Tkinter interface hooks
 
-_pilbitmap_ok = None
-
-
-def _pilbitmap_check() -> int:
-    global _pilbitmap_ok
-    if _pilbitmap_ok is None:
-        try:
-            im = Image.new("1", (1, 1))
-            tkinter.BitmapImage(data=f"PIL:{im.im.id}")
-            _pilbitmap_ok = 1
-        except tkinter.TclError:
-            _pilbitmap_ok = 0
-    return _pilbitmap_ok
-
 
 def _get_image_from_kw(kw: dict[str, Any]) -> ImageFile.ImageFile | None:
     source = None
@@ -142,6 +128,8 @@ def __init__(
             self.paste(image)
 
     def __del__(self) -> None:
+        if not hasattr(self, "__photo"):
+            return
         name = self.__photo.name
         self.__photo.name = None
         try:
@@ -225,17 +213,11 @@ def __init__(self, image: Image.Image | None = None, **kw: Any) -> None:
         self.__mode = image.mode
         self.__size = image.size
 
-        if _pilbitmap_check():
-            # fast way (requires the pilbitmap booster patch)
-            image.load()
-            kw["data"] = f"PIL:{image.im.id}"
-            self.__im = image  # must keep a reference
-        else:
-            # slow but safe way
-            kw["data"] = image.tobitmap()
-        self.__photo = tkinter.BitmapImage(**kw)
+        self.__photo = tkinter.BitmapImage(data=image.tobitmap(), **kw)
 
     def __del__(self) -> None:
+        if not hasattr(self, "__photo"):
+            return
         name = self.__photo.name
         self.__photo.name = None
         try:

From ee65b305b1fd041b679382003b4ce727bb03392d Mon Sep 17 00:00:00 2001
From: Aleksandr Karpinskii <homm86@gmail.com>
Date: Mon, 2 Sep 2024 04:29:34 +0400
Subject: [PATCH 1020/1178] Use PyCapsule in _imagingtk

---
 src/PIL/ImageTk.py | 11 +++++------
 src/Tk/tkImaging.c | 35 ++++++++++++++++++++++++++---------
 2 files changed, 31 insertions(+), 15 deletions(-)

diff --git a/src/PIL/ImageTk.py b/src/PIL/ImageTk.py
index d546989eeec..279a21716b2 100644
--- a/src/PIL/ImageTk.py
+++ b/src/PIL/ImageTk.py
@@ -48,18 +48,18 @@ def _get_image_from_kw(kw: dict[str, Any]) -> ImageFile.ImageFile | None:
 
 
 def _pyimagingtkcall(
-    command: str, photo: PhotoImage | tkinter.PhotoImage, id: int
+    command: str, photo: PhotoImage | tkinter.PhotoImage, ptr: object
 ) -> None:
     tk = photo.tk
     try:
-        tk.call(command, photo, id)
+        tk.call(command, photo, repr(ptr))
     except tkinter.TclError:
         # activate Tkinter hook
         # may raise an error if it cannot attach to Tkinter
         from . import _imagingtk
 
         _imagingtk.tkinit(tk.interpaddr())
-        tk.call(command, photo, id)
+        tk.call(command, photo, repr(ptr))
 
 
 # --------------------------------------------------------------------
@@ -181,7 +181,7 @@ def paste(self, im: Image.Image) -> None:
             block = image.new_block(self.__mode, im.size)
             image.convert2(block, image)  # convert directly between buffers
 
-        _pyimagingtkcall("PyImagingPhoto", self.__photo, block.id)
+        _pyimagingtkcall("PyImagingPhoto", self.__photo, block.ptr)
 
 
 # --------------------------------------------------------------------
@@ -255,9 +255,8 @@ def __str__(self) -> str:
 def getimage(photo: PhotoImage) -> Image.Image:
     """Copies the contents of a PhotoImage to a PIL image memory."""
     im = Image.new("RGBA", (photo.width(), photo.height()))
-    block = im.im
 
-    _pyimagingtkcall("PyImagingPhotoGet", photo, block.id)
+    _pyimagingtkcall("PyImagingPhotoGet", photo, im.im.ptr)
 
     return im
 
diff --git a/src/Tk/tkImaging.c b/src/Tk/tkImaging.c
index 727ee6bed51..b33a47d3007 100644
--- a/src/Tk/tkImaging.c
+++ b/src/Tk/tkImaging.c
@@ -56,19 +56,36 @@ static Tk_PhotoPutBlock_t TK_PHOTO_PUT_BLOCK;
 
 static Imaging
 ImagingFind(const char *name) {
-    Py_ssize_t id;
+    PyObject *capsule;
+    int direct_pointer = 0;
+    const char *expected = "capsule object \"" IMAGING_MAGIC "\" at 0x";
 
-    /* FIXME: use CObject instead? */
-#if defined(_WIN64)
-    id = _atoi64(name);
-#else
-    id = atol(name);
-#endif
-    if (!id) {
+    if (name[0] == '<') {
+        name++;
+    } else {
+        // Special case for PyPy, where the string representation of a Capsule
+        // refers directly to the pointer itself, not to the PyCapsule object.
+        direct_pointer = 1;
+    }
+
+    if (strncmp(name, expected, strlen(expected))) {
+        return NULL;
+    }
+
+    capsule = (PyObject *)strtoull(name + strlen(expected), NULL, 16);
+
+    if (direct_pointer) {
+        return (Imaging)capsule;
+    }
+
+    if (!PyCapsule_IsValid(capsule, IMAGING_MAGIC)) {
+        PyErr_Format(
+            PyExc_TypeError, "Expected PyCapsule with '%s' name.", IMAGING_MAGIC
+        );
         return NULL;
     }
 
-    return (Imaging)id;
+    return (Imaging)PyCapsule_GetPointer(capsule, IMAGING_MAGIC);
 }
 
 static int

From 882ac783eb67a13c1ff8afba9369d1603328718e Mon Sep 17 00:00:00 2001
From: Aleksandr Karpinskii <homm86@gmail.com>
Date: Mon, 2 Sep 2024 13:04:57 +0400
Subject: [PATCH 1021/1178] Use PyCapsule in _imagingft

---
 src/_imagingft.c | 8 +++-----
 1 file changed, 3 insertions(+), 5 deletions(-)

diff --git a/src/_imagingft.c b/src/_imagingft.c
index 5c446e641f5..c539ec2672c 100644
--- a/src/_imagingft.c
+++ b/src/_imagingft.c
@@ -830,7 +830,6 @@ font_render(FontObject *self, PyObject *args) {
     unsigned char convert_scale;    /* scale factor for non-8bpp bitmaps */
     PyObject *image;
     Imaging im;
-    Py_ssize_t id;
     int mask = 0;  /* is FT_LOAD_TARGET_MONO enabled? */
     int color = 0; /* is FT_LOAD_COLOR enabled? */
     int stroke_width = 0;
@@ -929,10 +928,9 @@ font_render(FontObject *self, PyObject *args) {
         PyMem_Del(glyph_info);
         return NULL;
     }
-    PyObject *imageId = PyObject_GetAttrString(image, "id");
-    id = PyLong_AsSsize_t(imageId);
-    Py_XDECREF(imageId);
-    im = (Imaging)id;
+    PyObject *imagePtr = PyObject_GetAttrString(image, "ptr");
+    im = (Imaging)PyCapsule_GetPointer(imagePtr, IMAGING_MAGIC);
+    Py_XDECREF(imagePtr);
 
     x_offset -= stroke_width;
     y_offset -= stroke_width;

From 934ae12ed5e98b7d2ec14d1946fad3bce6a42924 Mon Sep 17 00:00:00 2001
From: Aleksandr Karpinskii <homm86@gmail.com>
Date: Tue, 3 Sep 2024 11:54:24 +0400
Subject: [PATCH 1022/1178] rename PyCapsule -> Capsule

---
 docs/deprecations.rst |  2 +-
 src/Tk/tkImaging.c    |  4 +---
 src/_imagingcms.c     |  4 +---
 src/_imagingmath.c    | 16 ++++------------
 src/_imagingmorph.c   | 12 +++---------
 5 files changed, 10 insertions(+), 28 deletions(-)

diff --git a/docs/deprecations.rst b/docs/deprecations.rst
index abb902c88eb..dd271a97f7c 100644
--- a/docs/deprecations.rst
+++ b/docs/deprecations.rst
@@ -144,7 +144,7 @@ Get Internal Pointers to Objects
 ``Image.core.ImageCore.id`` and ``Image.core.ImageCore.unsafe_ptrs``
 have been deprecated and will be removed in Pillow 12 (2025-10-15).
 They were used for obtaining raw pointers to ``ImageCore`` internals. To interact with
-C code, you can use ``Image.core.ImageCore.ptr``, which returns a ``PyCapsule`` object.
+C code, you can use ``Image.core.ImageCore.ptr``, which returns a ``Capsule`` object.
 
 Removed features
 ----------------
diff --git a/src/Tk/tkImaging.c b/src/Tk/tkImaging.c
index b33a47d3007..a36c3e0bdc4 100644
--- a/src/Tk/tkImaging.c
+++ b/src/Tk/tkImaging.c
@@ -79,9 +79,7 @@ ImagingFind(const char *name) {
     }
 
     if (!PyCapsule_IsValid(capsule, IMAGING_MAGIC)) {
-        PyErr_Format(
-            PyExc_TypeError, "Expected PyCapsule with '%s' name.", IMAGING_MAGIC
-        );
+        PyErr_Format(PyExc_TypeError, "Expected '%s' Capsule", IMAGING_MAGIC);
         return NULL;
     }
 
diff --git a/src/_imagingcms.c b/src/_imagingcms.c
index 444b6a60237..1823bcf0371 100644
--- a/src/_imagingcms.c
+++ b/src/_imagingcms.c
@@ -541,9 +541,7 @@ cms_transform_apply(CmsTransformObject *self, PyObject *args) {
 
     if (!PyCapsule_IsValid(i0, IMAGING_MAGIC) ||
         !PyCapsule_IsValid(i1, IMAGING_MAGIC)) {
-        PyErr_Format(
-            PyExc_TypeError, "Expected PyCapsule with '%s' name.", IMAGING_MAGIC
-        );
+        PyErr_Format(PyExc_TypeError, "Expected '%s' Capsule", IMAGING_MAGIC);
         return NULL;
     }
 
diff --git a/src/_imagingmath.c b/src/_imagingmath.c
index eafcf1444e9..dbe636707f4 100644
--- a/src/_imagingmath.c
+++ b/src/_imagingmath.c
@@ -177,16 +177,12 @@ _unop(PyObject *self, PyObject *args) {
     }
 
     if (!PyCapsule_IsValid(op, MATH_FUNC_UNOP_MAGIC)) {
-        PyErr_Format(
-            PyExc_TypeError, "Expected PyCapsule with '%s' name.", MATH_FUNC_UNOP_MAGIC
-        );
+        PyErr_Format(PyExc_TypeError, "Expected '%s' Capsule", MATH_FUNC_UNOP_MAGIC);
         return NULL;
     }
     if (!PyCapsule_IsValid(i0, IMAGING_MAGIC) ||
         !PyCapsule_IsValid(i1, IMAGING_MAGIC)) {
-        PyErr_Format(
-            PyExc_TypeError, "Expected PyCapsule with '%s' name.", IMAGING_MAGIC
-        );
+        PyErr_Format(PyExc_TypeError, "Expected '%s' Capsule", IMAGING_MAGIC);
         return NULL;
     }
 
@@ -213,17 +209,13 @@ _binop(PyObject *self, PyObject *args) {
     }
 
     if (!PyCapsule_IsValid(op, MATH_FUNC_BINOP_MAGIC)) {
-        PyErr_Format(
-            PyExc_TypeError, "Expected PyCapsule with '%s' name.", MATH_FUNC_BINOP_MAGIC
-        );
+        PyErr_Format(PyExc_TypeError, "Expected '%s' Capsule", MATH_FUNC_BINOP_MAGIC);
         return NULL;
     }
     if (!PyCapsule_IsValid(i0, IMAGING_MAGIC) ||
         !PyCapsule_IsValid(i1, IMAGING_MAGIC) ||
         !PyCapsule_IsValid(i2, IMAGING_MAGIC)) {
-        PyErr_Format(
-            PyExc_TypeError, "Expected PyCapsule with '%s' name.", IMAGING_MAGIC
-        );
+        PyErr_Format(PyExc_TypeError, "Expected '%s' Capsule", IMAGING_MAGIC);
         return NULL;
     }
 
diff --git a/src/_imagingmorph.c b/src/_imagingmorph.c
index 715cccf5142..637295be710 100644
--- a/src/_imagingmorph.c
+++ b/src/_imagingmorph.c
@@ -48,9 +48,7 @@ apply(PyObject *self, PyObject *args) {
 
     if (!PyCapsule_IsValid(i0, IMAGING_MAGIC) ||
         !PyCapsule_IsValid(i1, IMAGING_MAGIC)) {
-        PyErr_Format(
-            PyExc_TypeError, "Expected PyCapsule with '%s' name.", IMAGING_MAGIC
-        );
+        PyErr_Format(PyExc_TypeError, "Expected '%s' Capsule", IMAGING_MAGIC);
         return NULL;
     }
 
@@ -143,9 +141,7 @@ match(PyObject *self, PyObject *args) {
     }
 
     if (!PyCapsule_IsValid(i0, IMAGING_MAGIC)) {
-        PyErr_Format(
-            PyExc_TypeError, "Expected PyCapsule with '%s' name.", IMAGING_MAGIC
-        );
+        PyErr_Format(PyExc_TypeError, "Expected '%s' Capsule", IMAGING_MAGIC);
         return NULL;
     }
 
@@ -218,9 +214,7 @@ get_on_pixels(PyObject *self, PyObject *args) {
     }
 
     if (!PyCapsule_IsValid(i0, IMAGING_MAGIC)) {
-        PyErr_Format(
-            PyExc_TypeError, "Expected PyCapsule with '%s' name.", IMAGING_MAGIC
-        );
+        PyErr_Format(PyExc_TypeError, "Expected '%s' Capsule", IMAGING_MAGIC);
         return NULL;
     }
 

From d29fa73ea608449f86082dc312eb132a10901fd0 Mon Sep 17 00:00:00 2001
From: Aleksandr Karpinskii <homm86@gmail.com>
Date: Thu, 5 Sep 2024 01:04:35 +0400
Subject: [PATCH 1023/1178] Move new_block to module

---
 src/PIL/ImageTk.py | 2 +-
 src/_imaging.c     | 4 +---
 2 files changed, 2 insertions(+), 4 deletions(-)

diff --git a/src/PIL/ImageTk.py b/src/PIL/ImageTk.py
index 279a21716b2..5bad9b5462d 100644
--- a/src/PIL/ImageTk.py
+++ b/src/PIL/ImageTk.py
@@ -178,7 +178,7 @@ def paste(self, im: Image.Image) -> None:
         if image.isblock() and im.mode == self.__mode:
             block = image
         else:
-            block = image.new_block(self.__mode, im.size)
+            block = Image.core.new_block(self.__mode, im.size)
             image.convert2(block, image)  # convert directly between buffers
 
         _pyimagingtkcall("PyImagingPhoto", self.__photo, block.ptr)
diff --git a/src/_imaging.c b/src/_imaging.c
index a455c873b15..e227d8efc51 100644
--- a/src/_imaging.c
+++ b/src/_imaging.c
@@ -3674,15 +3674,12 @@ static struct PyMethodDef methods[] = {
     /* Unsharpmask extension */
     {"gaussian_blur", (PyCFunction)_gaussian_blur, METH_VARARGS},
     {"unsharp_mask", (PyCFunction)_unsharp_mask, METH_VARARGS},
-
     {"box_blur", (PyCFunction)_box_blur, METH_VARARGS},
 
     /* Special effects */
     {"effect_spread", (PyCFunction)_effect_spread, METH_VARARGS},
 
     /* Misc. */
-    {"new_block", (PyCFunction)_new_block, METH_VARARGS},
-
     {"save_ppm", (PyCFunction)_save_ppm, METH_VARARGS},
 
     {NULL, NULL} /* sentinel */
@@ -4212,6 +4209,7 @@ static PyMethodDef functions[] = {
     {"blend", (PyCFunction)_blend, METH_VARARGS},
     {"fill", (PyCFunction)_fill, METH_VARARGS},
     {"new", (PyCFunction)_new, METH_VARARGS},
+    {"new_block", (PyCFunction)_new_block, METH_VARARGS},
     {"merge", (PyCFunction)_merge, METH_VARARGS},
 
     /* Functions */

From 0a8e6dbedb84b50ca2ca8762ae1279a66c385bad Mon Sep 17 00:00:00 2001
From: Aleksandr Karpinskii <homm86@gmail.com>
Date: Sat, 31 Aug 2024 20:41:37 +0400
Subject: [PATCH 1024/1178] Use im.has_transparency_data for webp._save_all

Also:
remove _VALID_WEBP_MODES and _VALID_WEBP_LEGACY_MODES consts
RGBX is not faster RGB since demands more bandwidth
Do not convert to str paths in tests
---
 Tests/test_file_webp.py    | 27 ++++++++++++---------------
 src/PIL/WebPImagePlugin.py | 25 +++++--------------------
 2 files changed, 17 insertions(+), 35 deletions(-)

diff --git a/Tests/test_file_webp.py b/Tests/test_file_webp.py
index e75e3ddd272..719831db9fb 100644
--- a/Tests/test_file_webp.py
+++ b/Tests/test_file_webp.py
@@ -72,7 +72,7 @@ def test_read_rgb(self) -> None:
     def _roundtrip(
         self, tmp_path: Path, mode: str, epsilon: float, args: dict[str, Any] = {}
     ) -> None:
-        temp_file = str(tmp_path / "temp.webp")
+        temp_file = tmp_path / "temp.webp"
 
         hopper(mode).save(temp_file, **args)
         with Image.open(temp_file) as image:
@@ -116,7 +116,7 @@ def test_write_method(self, tmp_path: Path) -> None:
         assert buffer_no_args.getbuffer() != buffer_method.getbuffer()
 
     def test_save_all(self, tmp_path: Path) -> None:
-        temp_file = str(tmp_path / "temp.webp")
+        temp_file = tmp_path / "temp.webp"
         im = Image.new("RGB", (1, 1))
         im2 = Image.new("RGB", (1, 1), "#f00")
         im.save(temp_file, save_all=True, append_images=[im2])
@@ -151,18 +151,16 @@ def test_write_unsupported_mode_P(self, tmp_path: Path) -> None:
 
     @pytest.mark.skipif(sys.maxsize <= 2**32, reason="Requires 64-bit system")
     def test_write_encoding_error_message(self, tmp_path: Path) -> None:
-        temp_file = str(tmp_path / "temp.webp")
         im = Image.new("RGB", (15000, 15000))
         with pytest.raises(ValueError) as e:
-            im.save(temp_file, method=0)
+            im.save(tmp_path / "temp.webp", method=0)
         assert str(e.value) == "encoding error 6"
 
     @pytest.mark.skipif(sys.maxsize <= 2**32, reason="Requires 64-bit system")
     def test_write_encoding_error_bad_dimension(self, tmp_path: Path) -> None:
-        temp_file = str(tmp_path / "temp.webp")
         im = Image.new("L", (16384, 16384))
         with pytest.raises(ValueError) as e:
-            im.save(temp_file)
+            im.save(tmp_path / "temp.webp")
         assert (
             str(e.value)
             == "encoding error 5: Image size exceeds WebP limit of 16383 pixels"
@@ -187,9 +185,8 @@ def test_WebPAnimDecoder_with_invalid_args(self) -> None:
     def test_no_resource_warning(self, tmp_path: Path) -> None:
         file_path = "Tests/images/hopper.webp"
         with Image.open(file_path) as image:
-            temp_file = str(tmp_path / "temp.webp")
             with warnings.catch_warnings():
-                image.save(temp_file)
+                image.save(tmp_path / "temp.webp")
 
     def test_file_pointer_could_be_reused(self) -> None:
         file_path = "Tests/images/hopper.webp"
@@ -204,15 +201,16 @@ def test_file_pointer_could_be_reused(self) -> None:
     def test_invalid_background(
         self, background: int | tuple[int, ...], tmp_path: Path
     ) -> None:
-        temp_file = str(tmp_path / "temp.webp")
+        temp_file = tmp_path / "temp.webp"
         im = hopper()
         with pytest.raises(OSError):
             im.save(temp_file, save_all=True, append_images=[im], background=background)
 
     def test_background_from_gif(self, tmp_path: Path) -> None:
+        out_webp = tmp_path / "temp.webp"
+        
         # Save L mode GIF with background
         with Image.open("Tests/images/no_palette_with_background.gif") as im:
-            out_webp = str(tmp_path / "temp.webp")
             im.save(out_webp, save_all=True)
 
         # Save P mode GIF with background
@@ -220,11 +218,10 @@ def test_background_from_gif(self, tmp_path: Path) -> None:
             original_value = im.convert("RGB").getpixel((1, 1))
 
             # Save as WEBP
-            out_webp = str(tmp_path / "temp.webp")
             im.save(out_webp, save_all=True)
 
         # Save as GIF
-        out_gif = str(tmp_path / "temp.gif")
+        out_gif = tmp_path / "temp.gif"
         with Image.open(out_webp) as im:
             im.save(out_gif)
 
@@ -234,10 +231,10 @@ def test_background_from_gif(self, tmp_path: Path) -> None:
         assert difference < 5
 
     def test_duration(self, tmp_path: Path) -> None:
+        out_webp = tmp_path / "temp.webp"
+
         with Image.open("Tests/images/dispose_bgnd.gif") as im:
             assert im.info["duration"] == 1000
-
-            out_webp = str(tmp_path / "temp.webp")
             im.save(out_webp, save_all=True)
 
         with Image.open(out_webp) as reloaded:
@@ -245,7 +242,7 @@ def test_duration(self, tmp_path: Path) -> None:
             assert reloaded.info["duration"] == 1000
 
     def test_roundtrip_rgba_palette(self, tmp_path: Path) -> None:
-        temp_file = str(tmp_path / "temp.webp")
+        temp_file = tmp_path / "temp.webp"
         im = Image.new("RGBA", (1, 1)).convert("P")
         assert im.mode == "P"
         assert im.palette is not None
diff --git a/src/PIL/WebPImagePlugin.py b/src/PIL/WebPImagePlugin.py
index f8d6168bafd..3754d784ac3 100644
--- a/src/PIL/WebPImagePlugin.py
+++ b/src/PIL/WebPImagePlugin.py
@@ -13,10 +13,6 @@
     SUPPORTED = False
 
 
-_VALID_WEBP_MODES = {"RGBX": True, "RGBA": True, "RGB": True}
-
-_VALID_WEBP_LEGACY_MODES = {"RGB": True, "RGBA": True}
-
 _VP8_MODES_BY_IDENTIFIER = {
     b"VP8 ": "RGB",
     b"VP8X": "RGBA",
@@ -247,27 +243,16 @@ def _save_all(im: Image.Image, fp: IO[bytes], filename: str | bytes) -> None:
 
                 # Make sure image mode is supported
                 frame = ims
-                rawmode = ims.mode
-                if ims.mode not in _VALID_WEBP_MODES:
-                    alpha = (
-                        "A" in ims.mode
-                        or "a" in ims.mode
-                        or (ims.mode == "P" and "A" in ims.im.getpalettemode())
-                    )
-                    rawmode = "RGBA" if alpha else "RGB"
-                    frame = ims.convert(rawmode)
-
-                if rawmode == "RGB":
-                    # For faster conversion, use RGBX
-                    rawmode = "RGBX"
+                if frame.mode not in ("RGBX", "RGBA", "RGB"):
+                    frame = frame.convert("RGBA" if im.has_transparency_data else "RGB")
 
                 # Append the frame to the animation encoder
                 enc.add(
-                    frame.tobytes("raw", rawmode),
+                    frame.tobytes(),
                     round(timestamp),
                     frame.size[0],
                     frame.size[1],
-                    rawmode,
+                    frame.mode,
                     lossless,
                     quality,
                     alpha_quality,
@@ -310,7 +295,7 @@ def _save(im: Image.Image, fp: IO[bytes], filename: str | bytes) -> None:
     method = im.encoderinfo.get("method", 4)
     exact = 1 if im.encoderinfo.get("exact") else 0
 
-    if im.mode not in _VALID_WEBP_LEGACY_MODES:
+    if im.mode not in ("RGB", "RGBA"):
         im = im.convert("RGBA" if im.has_transparency_data else "RGB")
 
     data = _webp.WebPEncode(

From 8bb3134b1d2fa2a13111a6555e09bbc26b96ff7a Mon Sep 17 00:00:00 2001
From: Aleksandr Karpinskii <homm86@gmail.com>
Date: Sun, 1 Sep 2024 19:41:45 +0400
Subject: [PATCH 1025/1178] call _webp.WebPEncode with ptr

---
 src/PIL/WebPImagePlugin.py |  7 +---
 src/_webp.c                | 75 ++++++++++++++++++++++++--------------
 2 files changed, 50 insertions(+), 32 deletions(-)

diff --git a/src/PIL/WebPImagePlugin.py b/src/PIL/WebPImagePlugin.py
index 3754d784ac3..3eeba9400f5 100644
--- a/src/PIL/WebPImagePlugin.py
+++ b/src/PIL/WebPImagePlugin.py
@@ -295,17 +295,14 @@ def _save(im: Image.Image, fp: IO[bytes], filename: str | bytes) -> None:
     method = im.encoderinfo.get("method", 4)
     exact = 1 if im.encoderinfo.get("exact") else 0
 
-    if im.mode not in ("RGB", "RGBA"):
+    if im.mode not in ("RGBX", "RGBA", "RGB"):
         im = im.convert("RGBA" if im.has_transparency_data else "RGB")
 
     data = _webp.WebPEncode(
-        im.tobytes(),
-        im.size[0],
-        im.size[1],
+        im.im.ptr,
         lossless,
         float(quality),
         float(alpha_quality),
-        im.mode,
         icc_profile,
         method,
         exact,
diff --git a/src/_webp.c b/src/_webp.c
index f59ad30367b..bfd9de5c0a5 100644
--- a/src/_webp.c
+++ b/src/_webp.c
@@ -566,32 +566,65 @@ static PyTypeObject WebPAnimDecoder_Type = {
     0,                                 /*tp_getset*/
 };
 
+/* -------------------------------------------------------------------- */
+/* Frame import                                                         */
+/* -------------------------------------------------------------------- */
+
+static int
+import_frame_libwebp(WebPPicture *frame, Imaging im) {
+    UINT32 mask = 0;
+
+    if (strcmp(im->mode, "RGBA") && strcmp(im->mode, "RGB") && strcmp(im->mode, "RGBX")) {
+        PyErr_SetString(PyExc_ValueError, "unsupported image mode");
+        return -1;
+    }
+
+    if (strcmp(im->mode, "RGBA")) {
+        mask = MASK_UINT32_CHANNEL_3;
+    }
+
+    frame->width = im->xsize;
+    frame->height = im->ysize;
+    frame->use_argb = 1;  // Don't convert RGB pixels to YUV
+
+    if (!WebPPictureAlloc(frame)) {
+        PyErr_SetString(PyExc_MemoryError, "can't allocate picture frame");
+        return -2;
+    }
+
+    for (int y = 0; y < im->ysize; ++y) {
+        UINT8 *src = (UINT8 *)im->image32[y];
+        UINT32 *dst = frame->argb + frame->argb_stride * y;
+        for (int x = 0; x < im->xsize; ++x) {
+            UINT32 pix = MAKE_UINT32(src[x * 4 + 2], src[x * 4 + 1], src[x * 4], src[x * 4 + 3]);
+            dst[x] = pix | mask;
+        }
+    }
+
+    return 0;
+}
+
 /* -------------------------------------------------------------------- */
 /* Legacy WebP Support                                                  */
 /* -------------------------------------------------------------------- */
 
 PyObject *
 WebPEncode_wrapper(PyObject *self, PyObject *args) {
-    int width;
-    int height;
     int lossless;
     float quality_factor;
     float alpha_quality_factor;
     int method;
     int exact;
-    uint8_t *rgb;
+    Imaging im;
+    PyObject *i0;
     uint8_t *icc_bytes;
     uint8_t *exif_bytes;
     uint8_t *xmp_bytes;
     uint8_t *output;
-    char *mode;
-    Py_ssize_t size;
     Py_ssize_t icc_size;
     Py_ssize_t exif_size;
     Py_ssize_t xmp_size;
     size_t ret_size;
-    int rgba_mode;
-    int channels;
     int ok;
     ImagingSectionCookie cookie;
     WebPConfig config;
@@ -600,15 +633,11 @@ WebPEncode_wrapper(PyObject *self, PyObject *args) {
 
     if (!PyArg_ParseTuple(
             args,
-            "y#iiiffss#iis#s#",
-            (char **)&rgb,
-            &size,
-            &width,
-            &height,
+            "Oiffs#iis#s#",
+            &i0,
             &lossless,
             &quality_factor,
             &alpha_quality_factor,
-            &mode,
             &icc_bytes,
             &icc_size,
             &method,
@@ -621,15 +650,12 @@ WebPEncode_wrapper(PyObject *self, PyObject *args) {
         return NULL;
     }
 
-    rgba_mode = strcmp(mode, "RGBA") == 0;
-    if (!rgba_mode && strcmp(mode, "RGB") != 0) {
-        Py_RETURN_NONE;
+    if (!PyCapsule_IsValid(i0, IMAGING_MAGIC)) {
+        PyErr_Format(PyExc_TypeError, "Expected '%s' Capsule", IMAGING_MAGIC);
+        return NULL;
     }
 
-    channels = rgba_mode ? 4 : 3;
-    if (size < width * height * channels) {
-        Py_RETURN_NONE;
-    }
+    im = (Imaging)PyCapsule_GetPointer(i0, IMAGING_MAGIC);
 
     // Setup config for this frame
     if (!WebPConfigInit(&config)) {
@@ -652,14 +678,9 @@ WebPEncode_wrapper(PyObject *self, PyObject *args) {
         PyErr_SetString(PyExc_ValueError, "could not initialise picture");
         return NULL;
     }
-    pic.width = width;
-    pic.height = height;
-    pic.use_argb = 1;  // Don't convert RGB pixels to YUV
 
-    if (rgba_mode) {
-        WebPPictureImportRGBA(&pic, rgb, channels * width);
-    } else {
-        WebPPictureImportRGB(&pic, rgb, channels * width);
+    if (import_frame_libwebp(&pic, im)) {
+        return NULL;
     }
 
     WebPMemoryWriterInit(&writer);

From 0962b468b71ea9cdb99417d091c75e86c29f768a Mon Sep 17 00:00:00 2001
From: Aleksandr Karpinskii <homm86@gmail.com>
Date: Tue, 3 Sep 2024 13:47:31 +0400
Subject: [PATCH 1026/1178] ImagingSectionEnter for WebPAnimEncoder

---
 src/_webp.c | 8 ++++++--
 1 file changed, 6 insertions(+), 2 deletions(-)

diff --git a/src/_webp.c b/src/_webp.c
index bfd9de5c0a5..ede261df655 100644
--- a/src/_webp.c
+++ b/src/_webp.c
@@ -190,6 +190,7 @@ _anim_encoder_add(PyObject *self, PyObject *args) {
     float quality_factor;
     float alpha_quality_factor;
     int method;
+    ImagingSectionCookie cookie;
     WebPConfig config;
     WebPAnimEncoderObject *encp = (WebPAnimEncoderObject *)self;
     WebPAnimEncoder *enc = encp->enc;
@@ -246,8 +247,11 @@ _anim_encoder_add(PyObject *self, PyObject *args) {
         WebPPictureImportRGB(frame, rgb, 3 * width);
     }
 
-    // Add the frame to the encoder
-    if (!WebPAnimEncoderAdd(enc, frame, timestamp, &config)) {
+    ImagingSectionEnter(&cookie);
+    int ok = WebPAnimEncoderAdd(enc, frame, timestamp, &config);
+    ImagingSectionLeave(&cookie);
+
+    if (!ok) {
         PyErr_SetString(PyExc_RuntimeError, WebPAnimEncoderGetError(enc));
         return NULL;
     }

From 4d271c8ec87355962e0345a00d9e4032007a13c5 Mon Sep 17 00:00:00 2001
From: Aleksandr Karpinskii <homm86@gmail.com>
Date: Tue, 3 Sep 2024 13:58:40 +0400
Subject: [PATCH 1027/1178] import_frame for anim_encoder_add

---
 src/PIL/WebPImagePlugin.py |   7 +--
 src/_webp.c                | 114 ++++++++++++++++++-------------------
 2 files changed, 56 insertions(+), 65 deletions(-)

diff --git a/src/PIL/WebPImagePlugin.py b/src/PIL/WebPImagePlugin.py
index 3eeba9400f5..8251316d3d4 100644
--- a/src/PIL/WebPImagePlugin.py
+++ b/src/PIL/WebPImagePlugin.py
@@ -248,11 +248,8 @@ def _save_all(im: Image.Image, fp: IO[bytes], filename: str | bytes) -> None:
 
                 # Append the frame to the animation encoder
                 enc.add(
-                    frame.tobytes(),
+                    frame.im.ptr,
                     round(timestamp),
-                    frame.size[0],
-                    frame.size[1],
-                    frame.mode,
                     lossless,
                     quality,
                     alpha_quality,
@@ -270,7 +267,7 @@ def _save_all(im: Image.Image, fp: IO[bytes], filename: str | bytes) -> None:
         im.seek(cur_idx)
 
     # Force encoder to flush frames
-    enc.add(None, round(timestamp), 0, 0, "", lossless, quality, alpha_quality, 0)
+    enc.add(None, round(timestamp), lossless, quality, alpha_quality, 0)
 
     # Get the final output from the encoder
     data = enc.assemble(icc_profile, exif, xmp)
diff --git a/src/_webp.c b/src/_webp.c
index ede261df655..9717b9bc0d1 100644
--- a/src/_webp.c
+++ b/src/_webp.c
@@ -83,6 +83,46 @@ HandleMuxError(WebPMuxError err, char *chunk) {
     return NULL;
 }
 
+/* -------------------------------------------------------------------- */
+/* Frame import                                                         */
+/* -------------------------------------------------------------------- */
+
+static int
+import_frame_libwebp(WebPPicture *frame, Imaging im) {
+    UINT32 mask = 0;
+
+    if (strcmp(im->mode, "RGBA") && strcmp(im->mode, "RGB") &&
+        strcmp(im->mode, "RGBX")) {
+        PyErr_SetString(PyExc_ValueError, "unsupported image mode");
+        return -1;
+    }
+
+    if (strcmp(im->mode, "RGBA")) {
+        mask = MASK_UINT32_CHANNEL_3;
+    }
+
+    frame->width = im->xsize;
+    frame->height = im->ysize;
+    frame->use_argb = 1;  // Don't convert RGB pixels to YUV
+
+    if (!WebPPictureAlloc(frame)) {
+        PyErr_SetString(PyExc_MemoryError, "can't allocate picture frame");
+        return -2;
+    }
+
+    for (int y = 0; y < im->ysize; ++y) {
+        UINT8 *src = (UINT8 *)im->image32[y];
+        UINT32 *dst = frame->argb + frame->argb_stride * y;
+        for (int x = 0; x < im->xsize; ++x) {
+            UINT32 pix =
+                MAKE_UINT32(src[x * 4 + 2], src[x * 4 + 1], src[x * 4], src[x * 4 + 3]);
+            dst[x] = pix | mask;
+        }
+    }
+
+    return 0;
+}
+
 /* -------------------------------------------------------------------- */
 /* WebP Animation Support                                               */
 /* -------------------------------------------------------------------- */
@@ -180,12 +220,9 @@ _anim_encoder_dealloc(PyObject *self) {
 
 PyObject *
 _anim_encoder_add(PyObject *self, PyObject *args) {
-    uint8_t *rgb;
-    Py_ssize_t size;
+    PyObject *i0;
+    Imaging im;
     int timestamp;
-    int width;
-    int height;
-    char *mode;
     int lossless;
     float quality_factor;
     float alpha_quality_factor;
@@ -198,13 +235,9 @@ _anim_encoder_add(PyObject *self, PyObject *args) {
 
     if (!PyArg_ParseTuple(
             args,
-            "z#iiisiffi",
-            (char **)&rgb,
-            &size,
+            "Oiiffi",
+            &i0,
             &timestamp,
-            &width,
-            &height,
-            &mode,
             &lossless,
             &quality_factor,
             &alpha_quality_factor,
@@ -214,11 +247,18 @@ _anim_encoder_add(PyObject *self, PyObject *args) {
     }
 
     // Check for NULL frame, which sets duration of final frame
-    if (!rgb) {
+    if (i0 == Py_None) {
         WebPAnimEncoderAdd(enc, NULL, timestamp, NULL);
         Py_RETURN_NONE;
     }
 
+    if (!PyCapsule_IsValid(i0, IMAGING_MAGIC)) {
+        PyErr_Format(PyExc_TypeError, "Expected '%s' Capsule", IMAGING_MAGIC);
+        return NULL;
+    }
+
+    im = (Imaging)PyCapsule_GetPointer(i0, IMAGING_MAGIC);
+
     // Setup config for this frame
     if (!WebPConfigInit(&config)) {
         PyErr_SetString(PyExc_RuntimeError, "failed to initialize config!");
@@ -235,16 +275,8 @@ _anim_encoder_add(PyObject *self, PyObject *args) {
         return NULL;
     }
 
-    // Populate the frame with raw bytes passed to us
-    frame->width = width;
-    frame->height = height;
-    frame->use_argb = 1;  // Don't convert RGB pixels to YUV
-    if (strcmp(mode, "RGBA") == 0) {
-        WebPPictureImportRGBA(frame, rgb, 4 * width);
-    } else if (strcmp(mode, "RGBX") == 0) {
-        WebPPictureImportRGBX(frame, rgb, 4 * width);
-    } else {
-        WebPPictureImportRGB(frame, rgb, 3 * width);
+    if (import_frame_libwebp(frame, im)) {
+        return NULL;
     }
 
     ImagingSectionEnter(&cookie);
@@ -570,44 +602,6 @@ static PyTypeObject WebPAnimDecoder_Type = {
     0,                                 /*tp_getset*/
 };
 
-/* -------------------------------------------------------------------- */
-/* Frame import                                                         */
-/* -------------------------------------------------------------------- */
-
-static int
-import_frame_libwebp(WebPPicture *frame, Imaging im) {
-    UINT32 mask = 0;
-
-    if (strcmp(im->mode, "RGBA") && strcmp(im->mode, "RGB") && strcmp(im->mode, "RGBX")) {
-        PyErr_SetString(PyExc_ValueError, "unsupported image mode");
-        return -1;
-    }
-
-    if (strcmp(im->mode, "RGBA")) {
-        mask = MASK_UINT32_CHANNEL_3;
-    }
-
-    frame->width = im->xsize;
-    frame->height = im->ysize;
-    frame->use_argb = 1;  // Don't convert RGB pixels to YUV
-
-    if (!WebPPictureAlloc(frame)) {
-        PyErr_SetString(PyExc_MemoryError, "can't allocate picture frame");
-        return -2;
-    }
-
-    for (int y = 0; y < im->ysize; ++y) {
-        UINT8 *src = (UINT8 *)im->image32[y];
-        UINT32 *dst = frame->argb + frame->argb_stride * y;
-        for (int x = 0; x < im->xsize; ++x) {
-            UINT32 pix = MAKE_UINT32(src[x * 4 + 2], src[x * 4 + 1], src[x * 4], src[x * 4 + 3]);
-            dst[x] = pix | mask;
-        }
-    }
-
-    return 0;
-}
-
 /* -------------------------------------------------------------------- */
 /* Legacy WebP Support                                                  */
 /* -------------------------------------------------------------------- */

From 608a5e83c067baa91e555b24b3cc577c3704153c Mon Sep 17 00:00:00 2001
From: Andrew Murray <radarhere@users.noreply.github.com>
Date: Mon, 9 Sep 2024 12:56:28 +1000
Subject: [PATCH 1028/1178] Updated harfbuzz to 9.0.0, except on manylinux2014

---
 .github/workflows/wheels-dependencies.sh | 47 +++++++++++++++++-------
 1 file changed, 34 insertions(+), 13 deletions(-)

diff --git a/.github/workflows/wheels-dependencies.sh b/.github/workflows/wheels-dependencies.sh
index 97f70ed84e9..c25e1a27d94 100755
--- a/.github/workflows/wheels-dependencies.sh
+++ b/.github/workflows/wheels-dependencies.sh
@@ -16,7 +16,11 @@ ARCHIVE_SDIR=pillow-depends-main
 
 # Package versions for fresh source builds
 FREETYPE_VERSION=2.13.2
-HARFBUZZ_VERSION=8.5.0
+if [[ "$MB_ML_VER" != 2014 ]]; then
+    HARFBUZZ_VERSION=9.0.0
+else
+    HARFBUZZ_VERSION=8.5.0
+fi
 LIBPNG_VERSION=1.6.43
 JPEGTURBO_VERSION=3.0.3
 OPENJPEG_VERSION=2.5.2
@@ -40,7 +44,7 @@ BROTLI_VERSION=1.1.0
 
 if [[ -n "$IS_MACOS" ]] && [[ "$CIBW_ARCHS" == "x86_64" ]]; then
     function build_openjpeg {
-        local out_dir=$(fetch_unpack https://github.com/uclouvain/openjpeg/archive/v${OPENJPEG_VERSION}.tar.gz openjpeg-${OPENJPEG_VERSION}.tar.gz)
+        local out_dir=$(fetch_unpack https://github.com/uclouvain/openjpeg/archive/v$OPENJPEG_VERSION.tar.gz openjpeg-$OPENJPEG_VERSION.tar.gz)
         (cd $out_dir \
             && cmake -DCMAKE_INSTALL_PREFIX=$BUILD_PREFIX -DCMAKE_INSTALL_NAME_DIR=$BUILD_PREFIX/lib . \
             && make install)
@@ -50,7 +54,7 @@ fi
 
 function build_brotli {
     local cmake=$(get_modern_cmake)
-    local out_dir=$(fetch_unpack https://github.com/google/brotli/archive/v$BROTLI_VERSION.tar.gz brotli-1.1.0.tar.gz)
+    local out_dir=$(fetch_unpack https://github.com/google/brotli/archive/v$BROTLI_VERSION.tar.gz brotli-$BROTLI_VERSION.tar.gz)
     (cd $out_dir \
         && $cmake -DCMAKE_INSTALL_PREFIX=$BUILD_PREFIX -DCMAKE_INSTALL_NAME_DIR=$BUILD_PREFIX/lib . \
         && make install)
@@ -60,6 +64,25 @@ function build_brotli {
     fi
 }
 
+function build_harfbuzz {
+    if [[ "$HARFBUZZ_VERSION" == 8.5.0 ]]; then
+        export FREETYPE_LIBS=-lfreetype
+        export FREETYPE_CFLAGS=-I/usr/local/include/freetype2/
+        build_simple harfbuzz $HARFBUZZ_VERSION https://github.com/harfbuzz/harfbuzz/releases/download/$HARFBUZZ_VERSION tar.xz --with-freetype=yes --with-glib=no
+        export FREETYPE_LIBS=""
+        export FREETYPE_CFLAGS=""
+    else
+        local out_dir=$(fetch_unpack https://github.com/harfbuzz/harfbuzz/releases/download/$HARFBUZZ_VERSION/$HARFBUZZ_VERSION.tar.xz harfbuzz-$HARFBUZZ_VERSION.tar.xz)
+        (cd $out_dir \
+            && meson setup build --buildtype=release -Dfreetype=enabled -Dglib=disabled)
+        (cd $out_dir/build \
+            && meson install)
+        if [[ "$MB_ML_LIBC" == "manylinux" ]]; then
+            cp /usr/local/lib64/libharfbuzz* /usr/local/lib
+        fi
+    fi
+}
+
 function build {
     if [[ -n "$IS_MACOS" ]] && [[ "$CIBW_ARCHS" == "arm64" ]]; then
         sudo chown -R runner /usr/local
@@ -109,15 +132,7 @@ function build {
         build_freetype
     fi
 
-    if [ -z "$IS_MACOS" ]; then
-        export FREETYPE_LIBS=-lfreetype
-        export FREETYPE_CFLAGS=-I/usr/local/include/freetype2/
-    fi
-    build_simple harfbuzz $HARFBUZZ_VERSION https://github.com/harfbuzz/harfbuzz/releases/download/$HARFBUZZ_VERSION tar.xz --with-freetype=yes --with-glib=no
-    if [ -z "$IS_MACOS" ]; then
-        export FREETYPE_LIBS=""
-        export FREETYPE_CFLAGS=""
-    fi
+    build_harfbuzz
 }
 
 # Any stuff that you need to do before you start building the wheels
@@ -140,7 +155,13 @@ if [[ -n "$IS_MACOS" ]]; then
     brew remove --ignore-dependencies webp
   fi
 
-  brew install pkg-config
+  brew install meson pkg-config
+elif [[ "$MB_ML_LIBC" == "manylinux" ]]; then
+  if [[ "$HARFBUZZ_VERSION" != 8.5.0 ]]; then
+    yum install -y meson
+  fi
+else
+  apk add meson
 fi
 
 wrap_wheel_builder build

From c9dc34ae8d90e632d90a685857c80c516b1668f9 Mon Sep 17 00:00:00 2001
From: Andrew Murray <radarhere@users.noreply.github.com>
Date: Mon, 9 Sep 2024 13:19:37 +1000
Subject: [PATCH 1029/1178] Update CHANGES.rst [ci skip]

---
 CHANGES.rst | 3 +++
 1 file changed, 3 insertions(+)

diff --git a/CHANGES.rst b/CHANGES.rst
index be94594f88c..15da95e0909 100644
--- a/CHANGES.rst
+++ b/CHANGES.rst
@@ -5,6 +5,9 @@ Changelog (Pillow)
 11.0.0 (unreleased)
 -------------------
 
+- Deprecate support for FreeType 2.9.0 #8356
+  [hugovk, radarhere]
+
 - Removed unused TiffImagePlugin IFD_LEGACY_API #8355
   [radarhere]
 

From be01d536c652f2224351ad0803c92067394db1bb Mon Sep 17 00:00:00 2001
From: Andrew Murray <radarhere@users.noreply.github.com>
Date: Mon, 9 Sep 2024 15:22:27 +1000
Subject: [PATCH 1030/1178] Update CHANGES.rst [ci skip]

---
 CHANGES.rst | 3 +++
 1 file changed, 3 insertions(+)

diff --git a/CHANGES.rst b/CHANGES.rst
index 15da95e0909..e217c9b82be 100644
--- a/CHANGES.rst
+++ b/CHANGES.rst
@@ -5,6 +5,9 @@ Changelog (Pillow)
 11.0.0 (unreleased)
 -------------------
 
+- Support converting more modes to LAB by converting to RGBA first #8358
+  [radarhere]
+
 - Deprecate support for FreeType 2.9.0 #8356
   [hugovk, radarhere]
 

From d25d12f792c88b3bae881c9090b13d2a9f0e3d84 Mon Sep 17 00:00:00 2001
From: Andrew Murray <radarhere@users.noreply.github.com>
Date: Tue, 10 Sep 2024 11:29:52 +1000
Subject: [PATCH 1031/1178] Removed custom build_openjpeg

---
 .github/workflows/wheels-dependencies.sh | 10 ----------
 1 file changed, 10 deletions(-)

diff --git a/.github/workflows/wheels-dependencies.sh b/.github/workflows/wheels-dependencies.sh
index 97f70ed84e9..9e92e416e1d 100755
--- a/.github/workflows/wheels-dependencies.sh
+++ b/.github/workflows/wheels-dependencies.sh
@@ -38,16 +38,6 @@ BZIP2_VERSION=1.0.8
 LIBXCB_VERSION=1.17.0
 BROTLI_VERSION=1.1.0
 
-if [[ -n "$IS_MACOS" ]] && [[ "$CIBW_ARCHS" == "x86_64" ]]; then
-    function build_openjpeg {
-        local out_dir=$(fetch_unpack https://github.com/uclouvain/openjpeg/archive/v${OPENJPEG_VERSION}.tar.gz openjpeg-${OPENJPEG_VERSION}.tar.gz)
-        (cd $out_dir \
-            && cmake -DCMAKE_INSTALL_PREFIX=$BUILD_PREFIX -DCMAKE_INSTALL_NAME_DIR=$BUILD_PREFIX/lib . \
-            && make install)
-        touch openjpeg-stamp
-    }
-fi
-
 function build_brotli {
     local cmake=$(get_modern_cmake)
     local out_dir=$(fetch_unpack https://github.com/google/brotli/archive/v$BROTLI_VERSION.tar.gz brotli-1.1.0.tar.gz)

From e0845f06d8d063fbf78708dd20a692041b60596c Mon Sep 17 00:00:00 2001
From: Andrew Murray <radarhere@users.noreply.github.com>
Date: Tue, 10 Sep 2024 16:20:52 +1000
Subject: [PATCH 1032/1178] Deprecate isImageType

---
 Tests/test_image.py          |  4 ++++
 docs/deprecations.rst        |  8 ++++++++
 docs/releasenotes/11.0.0.rst |  8 ++++++++
 src/PIL/Image.py             | 17 +++++++----------
 4 files changed, 27 insertions(+), 10 deletions(-)

diff --git a/Tests/test_image.py b/Tests/test_image.py
index 97e97acaabd..cf5b5a710cc 100644
--- a/Tests/test_image.py
+++ b/Tests/test_image.py
@@ -1117,6 +1117,10 @@ def test_close_graceful(self, caplog: pytest.LogCaptureFixture) -> None:
             assert len(caplog.records) == 0
             assert im.fp is None
 
+    def test_deprecation(self) -> None:
+        with pytest.warns(DeprecationWarning):
+            assert not Image.isImageType(None)
+
 
 class TestImageBytes:
     @pytest.mark.parametrize("mode", Image.MODES + ["BGR;15", "BGR;16", "BGR;24"])
diff --git a/docs/deprecations.rst b/docs/deprecations.rst
index 8d1537a5dd5..57f7f5b5c3b 100644
--- a/docs/deprecations.rst
+++ b/docs/deprecations.rst
@@ -122,6 +122,14 @@ vulnerability introduced in FreeType 2.6 (:cve:`2020-15999`).
 
 .. _2.10.4: https://sourceforge.net/projects/freetype/files/freetype2/2.10.4/
 
+Image isImageType()
+^^^^^^^^^^^^^^^^^^^
+
+.. deprecated:: 11.0.0
+
+``Image.isImageType(im)`` has been deprecated. Use ``isinstance(im, Image.Image)``
+instead.
+
 ImageMath.lambda_eval and ImageMath.unsafe_eval options parameter
 ^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
 
diff --git a/docs/releasenotes/11.0.0.rst b/docs/releasenotes/11.0.0.rst
index dd19c4b7f85..e0be1169070 100644
--- a/docs/releasenotes/11.0.0.rst
+++ b/docs/releasenotes/11.0.0.rst
@@ -61,6 +61,14 @@ vulnerability introduced in FreeType 2.6 (:cve:`2020-15999`).
 
 .. _2.10.4: https://sourceforge.net/projects/freetype/files/freetype2/2.10.4/
 
+Image isImageType()
+^^^^^^^^^^^^^^^^^^^
+
+.. deprecated:: 11.0.0
+
+``Image.isImageType(im)`` has been deprecated. Use ``isinstance(im, Image.Image)``
+instead.
+
 ImageMath.lambda_eval and ImageMath.unsafe_eval options parameter
 ^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
 
diff --git a/src/PIL/Image.py b/src/PIL/Image.py
index e6d9047f5b9..8f16eef94cf 100644
--- a/src/PIL/Image.py
+++ b/src/PIL/Image.py
@@ -133,6 +133,7 @@ def isImageType(t: Any) -> TypeGuard[Image]:
     :param t: object to check if it's an image
     :returns: True if the object is an image
     """
+    deprecate("Image.isImageType(im)", 12, "isinstance(im, Image.Image)")
     return hasattr(t, "im")
 
 
@@ -1823,23 +1824,22 @@ def paste(
         :param mask: An optional mask image.
         """
 
-        if isImageType(box):
+        if isinstance(box, Image):
             if mask is not None:
                 msg = "If using second argument as mask, third argument must be None"
                 raise ValueError(msg)
             # abbreviated paste(im, mask) syntax
             mask = box
             box = None
-        assert not isinstance(box, Image)
 
         if box is None:
             box = (0, 0)
 
         if len(box) == 2:
             # upper left corner given; get size from image or mask
-            if isImageType(im):
+            if isinstance(im, Image):
                 size = im.size
-            elif isImageType(mask):
+            elif isinstance(mask, Image):
                 size = mask.size
             else:
                 # FIXME: use self.size here?
@@ -1852,17 +1852,15 @@ def paste(
             from . import ImageColor
 
             source = ImageColor.getcolor(im, self.mode)
-        elif isImageType(im):
+        elif isinstance(im, Image):
             im.load()
             if self.mode != im.mode:
                 if self.mode != "RGB" or im.mode not in ("LA", "RGBA", "RGBa"):
                     # should use an adapter for this!
                     im = im.convert(self.mode)
             source = im.im
-        elif isinstance(im, tuple):
-            source = im
         else:
-            source = cast(float, im)
+            source = im
 
         self._ensure_mutable()
 
@@ -2023,7 +2021,7 @@ def putalpha(self, alpha: Image | int) -> None:
         else:
             band = 3
 
-        if isImageType(alpha):
+        if isinstance(alpha, Image):
             # alpha layer
             if alpha.mode not in ("1", "L"):
                 msg = "illegal image mode"
@@ -2033,7 +2031,6 @@ def putalpha(self, alpha: Image | int) -> None:
                 alpha = alpha.convert("L")
         else:
             # constant alpha
-            alpha = cast(int, alpha)  # see python/typing#1013
             try:
                 self.im.fillband(band, alpha)
             except (AttributeError, ValueError):

From adb691821476eed08bbefe2478794c5dbd94b527 Mon Sep 17 00:00:00 2001
From: Andrew Murray <radarhere@users.noreply.github.com>
Date: Tue, 10 Sep 2024 11:38:56 +1000
Subject: [PATCH 1033/1178] Use isinstance to detect Image instances

---
 src/PIL/ImageMath.py | 4 ++--
 1 file changed, 2 insertions(+), 2 deletions(-)

diff --git a/src/PIL/ImageMath.py b/src/PIL/ImageMath.py
index 191cc2a5f88..191ca8524cc 100644
--- a/src/PIL/ImageMath.py
+++ b/src/PIL/ImageMath.py
@@ -268,7 +268,7 @@ def lambda_eval(
     args.update(options)
     args.update(kw)
     for k, v in args.items():
-        if hasattr(v, "im"):
+        if isinstance(v, Image.Image):
             args[k] = _Operand(v)
 
     out = expression(args)
@@ -319,7 +319,7 @@ def unsafe_eval(
     args.update(options)
     args.update(kw)
     for k, v in args.items():
-        if hasattr(v, "im"):
+        if isinstance(v, Image.Image):
             args[k] = _Operand(v)
 
     compiled_code = compile(expression, "<string>", "eval")

From d522e0a5c03f87b653ab25a23116d9f685aa0c1e Mon Sep 17 00:00:00 2001
From: Andrew Murray <radarhere@users.noreply.github.com>
Date: Tue, 10 Sep 2024 18:50:06 +1000
Subject: [PATCH 1034/1178] Improved handling of RGBA palettes when saving GIF
 images

---
 Tests/test_file_gif.py    | 18 ++++++++++++++++++
 src/PIL/GifImagePlugin.py | 17 ++++++++++++++---
 src/PIL/Image.py          |  5 ++++-
 3 files changed, 36 insertions(+), 4 deletions(-)

diff --git a/Tests/test_file_gif.py b/Tests/test_file_gif.py
index 571fe1b9ac0..16c8466f331 100644
--- a/Tests/test_file_gif.py
+++ b/Tests/test_file_gif.py
@@ -1429,3 +1429,21 @@ def test_saving_rgba(tmp_path: Path) -> None:
     with Image.open(out) as reloaded:
         reloaded_rgba = reloaded.convert("RGBA")
         assert reloaded_rgba.load()[0, 0][3] == 0
+
+
+def test_optimizing_p_rgba(tmp_path: Path) -> None:
+    out = str(tmp_path / "temp.gif")
+
+    im1 = Image.new("P", (100, 100))
+    d = ImageDraw.Draw(im1)
+    d.ellipse([(40, 40), (60, 60)], fill=1)
+    data = [0, 0, 0, 0, 0, 0, 0, 255] + [0, 0, 0, 0] * 254
+    im1.putpalette(data, "RGBA")
+
+    im2 = Image.new("P", (100, 100))
+    im2.putpalette(data, "RGBA")
+
+    im1.save(out, save_all=True, append_images=[im2])
+
+    with Image.open(out) as reloaded:
+        assert reloaded.n_frames == 2
diff --git a/src/PIL/GifImagePlugin.py b/src/PIL/GifImagePlugin.py
index f206fbb9cef..57c29179273 100644
--- a/src/PIL/GifImagePlugin.py
+++ b/src/PIL/GifImagePlugin.py
@@ -553,7 +553,9 @@ def _normalize_palette(
 
     if im.mode == "P":
         if not source_palette:
-            source_palette = im.im.getpalette("RGB")[:768]
+            im_palette = im.getpalette(None)
+            assert im_palette is not None
+            source_palette = bytearray(im_palette)
     else:  # L-mode
         if not source_palette:
             source_palette = bytearray(i // 3 for i in range(768))
@@ -629,7 +631,10 @@ def _write_single_frame(
 def _getbbox(
     base_im: Image.Image, im_frame: Image.Image
 ) -> tuple[Image.Image, tuple[int, int, int, int] | None]:
-    if _get_palette_bytes(im_frame) != _get_palette_bytes(base_im):
+    palette_bytes = [
+        bytes(im.palette.palette) if im.palette else b"" for im in (base_im, im_frame)
+    ]
+    if palette_bytes[0] != palette_bytes[1]:
         im_frame = im_frame.convert("RGBA")
         base_im = base_im.convert("RGBA")
     delta = ImageChops.subtract_modulo(im_frame, base_im)
@@ -984,7 +989,13 @@ def _get_palette_bytes(im: Image.Image) -> bytes:
     :param im: Image object
     :returns: Bytes, len<=768 suitable for inclusion in gif header
     """
-    return bytes(im.palette.palette) if im.palette else b""
+    if not im.palette:
+        return b""
+
+    palette = bytes(im.palette.palette)
+    if im.palette.mode == "RGBA":
+        palette = b"".join(palette[i * 4 : i * 4 + 3] for i in range(len(palette) // 3))
+    return palette
 
 
 def _get_background(
diff --git a/src/PIL/Image.py b/src/PIL/Image.py
index e6d9047f5b9..a7a158d35c7 100644
--- a/src/PIL/Image.py
+++ b/src/PIL/Image.py
@@ -1066,7 +1066,7 @@ def convert_transparency(
                     trns_im = new(self.mode, (1, 1))
                     if self.mode == "P":
                         assert self.palette is not None
-                        trns_im.putpalette(self.palette)
+                        trns_im.putpalette(self.palette, self.palette.mode)
                         if isinstance(t, tuple):
                             err = "Couldn't allocate a palette color for transparency"
                             assert trns_im.palette is not None
@@ -2182,6 +2182,9 @@ def remap_palette(
                 source_palette = self.im.getpalette(palette_mode, palette_mode)
             else:  # L-mode
                 source_palette = bytearray(i // 3 for i in range(768))
+        elif len(source_palette) > 768:
+            bands = 4
+            palette_mode = "RGBA"
 
         palette_bytes = b""
         new_positions = [0] * 256

From 8d508406ad8917919c5da084bf0e543146643522 Mon Sep 17 00:00:00 2001
From: Andrew Murray <radarhere@users.noreply.github.com>
Date: Tue, 10 Sep 2024 20:55:34 +1000
Subject: [PATCH 1035/1178] Update CHANGES.rst [ci skip]

---
 CHANGES.rst | 3 +++
 1 file changed, 3 insertions(+)

diff --git a/CHANGES.rst b/CHANGES.rst
index e217c9b82be..3e4a99be77f 100644
--- a/CHANGES.rst
+++ b/CHANGES.rst
@@ -5,6 +5,9 @@ Changelog (Pillow)
 11.0.0 (unreleased)
 -------------------
 
+- Deprecate isImageType #8364
+  [radarhere]
+
 - Support converting more modes to LAB by converting to RGBA first #8358
   [radarhere]
 

From 54c5b532c54759d9a66541e8bb6ba0893b3c8cf6 Mon Sep 17 00:00:00 2001
From: Andrew Murray <radarhere@users.noreply.github.com>
Date: Tue, 10 Sep 2024 21:32:20 +1000
Subject: [PATCH 1036/1178] Added release notes for #8286

---
 docs/releasenotes/11.0.0.rst | 14 +++++++++++---
 1 file changed, 11 insertions(+), 3 deletions(-)

diff --git a/docs/releasenotes/11.0.0.rst b/docs/releasenotes/11.0.0.rst
index e0be1169070..22dd5313bdd 100644
--- a/docs/releasenotes/11.0.0.rst
+++ b/docs/releasenotes/11.0.0.rst
@@ -103,10 +103,18 @@ TODO
 API Additions
 =============
 
-TODO
-^^^^
+Writing XMP bytes to JPEG and MPO
+^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
 
-TODO
+XMP data can now be saved to JPEG files using an ``xmp`` argument::
+
+    im.save("out.jpg", xmp=b"test")
+
+The data can also be set  through :py:attr:`~PIL.Image.Image.info`, for use when saving
+either JPEG or MPO images::
+
+    im.info["xmp"] = b"test"
+    im.save("out.jpg")
 
 Other Changes
 =============

From fea3e0dd5facd07c9133b1b5dbb7b97452d62411 Mon Sep 17 00:00:00 2001
From: Andrew Murray <radarhere@users.noreply.github.com>
Date: Tue, 10 Sep 2024 21:22:03 +1000
Subject: [PATCH 1037/1178] Added release notes for #8213

---
 docs/releasenotes/11.0.0.rst | 5 +++++
 1 file changed, 5 insertions(+)

diff --git a/docs/releasenotes/11.0.0.rst b/docs/releasenotes/11.0.0.rst
index 22dd5313bdd..a83e3f2e947 100644
--- a/docs/releasenotes/11.0.0.rst
+++ b/docs/releasenotes/11.0.0.rst
@@ -45,6 +45,11 @@ TiffImagePlugin IFD_LEGACY_API
 
 An unused setting, ``TiffImagePlugin.IFD_LEGACY_API``, has been removed.
 
+WebP 0.4
+^^^^^^^^
+
+Support for WebP 0.4 and earlier has been removed; WebP 0.5 is the minimum supported.
+
 Deprecations
 ============
 

From 5c67178c952560c8992c2eaac4d62a5ca278f83d Mon Sep 17 00:00:00 2001
From: Andrew Murray <radarhere@users.noreply.github.com>
Date: Tue, 10 Sep 2024 21:30:48 +1000
Subject: [PATCH 1038/1178] Added release notes for #8199

---
 docs/releasenotes/11.0.0.rst | 2 ++
 1 file changed, 2 insertions(+)

diff --git a/docs/releasenotes/11.0.0.rst b/docs/releasenotes/11.0.0.rst
index a83e3f2e947..376130499c9 100644
--- a/docs/releasenotes/11.0.0.rst
+++ b/docs/releasenotes/11.0.0.rst
@@ -133,6 +133,8 @@ of 3.13.0 final (2024-10-01, :pep:`719`).
 
 Pillow 11.0.0 now officially supports Python 3.13.
 
+Support has also been added for the experimental free-threaded mode of :pep:`703`.
+
 C-level Flags
 ^^^^^^^^^^^^^
 

From bc4c57e9ea3089d168ac85b0f8c4e92db48e669d Mon Sep 17 00:00:00 2001
From: Andrew Murray <radarhere@users.noreply.github.com>
Date: Tue, 10 Sep 2024 22:39:47 +1000
Subject: [PATCH 1039/1178] Update CHANGES.rst [ci skip]

---
 CHANGES.rst | 6 ++++++
 1 file changed, 6 insertions(+)

diff --git a/CHANGES.rst b/CHANGES.rst
index 3e4a99be77f..af292f7a135 100644
--- a/CHANGES.rst
+++ b/CHANGES.rst
@@ -5,6 +5,12 @@ Changelog (Pillow)
 11.0.0 (unreleased)
 -------------------
 
+- Deprecate ICNS (width, height, scale) sizes in favour of load(scale) #8352
+  [radarhere]
+
+- Improved handling of RGBA palettes when saving GIF images #8366
+  [radarhere]
+
 - Deprecate isImageType #8364
   [radarhere]
 

From 6ade6873dec23cb6c411f1b1e8a405ada8b85a35 Mon Sep 17 00:00:00 2001
From: Andrew Murray <radarhere@users.noreply.github.com>
Date: Wed, 11 Sep 2024 08:13:41 +1000
Subject: [PATCH 1040/1178] Removed libffi-dev

---
 .ci/install.sh | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/.ci/install.sh b/.ci/install.sh
index ee92d447a3e..7e3a691e566 100755
--- a/.ci/install.sh
+++ b/.ci/install.sh
@@ -21,7 +21,7 @@ set -e
 
 if [[ $(uname) != CYGWIN* ]]; then
     sudo apt-get -qq install libfreetype6-dev liblcms2-dev python3-tk\
-                             ghostscript libffi-dev libjpeg-turbo-progs libopenjp2-7-dev\
+                             ghostscript libjpeg-turbo-progs libopenjp2-7-dev\
                              cmake meson imagemagick libharfbuzz-dev libfribidi-dev\
                              sway wl-clipboard libopenblas-dev
 fi

From d2efd7dd5fcd19b7cb7768fc90ffa51676ff5e7a Mon Sep 17 00:00:00 2001
From: Yngve Mardal Moe <yngve.m.moe@gmail.com>
Date: Wed, 11 Sep 2024 10:32:42 +0200
Subject: [PATCH 1041/1178] Update src/PIL/ImageFont.py

Co-authored-by: Andrew Murray <3112309+radarhere@users.noreply.github.com>
---
 src/PIL/ImageFont.py | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/src/PIL/ImageFont.py b/src/PIL/ImageFont.py
index b6d69019da8..7ee3aaa55ec 100644
--- a/src/PIL/ImageFont.py
+++ b/src/PIL/ImageFont.py
@@ -934,7 +934,7 @@ def load_path(filename: str | bytes) -> ImageFont:
             pass
     msg = f"cannot find font file '{filename}' in `sys.path`"
     if os.path.exists(filename):
-        msg += f", did you mean `ImageFont.load({filename})` instead?"
+        msg += f", did you mean `ImageFont.load(\"{filename}\")` instead?"
 
     raise OSError(msg)
 

From e4f13020e16925f1dcfe738218e4d03a3c3992bb Mon Sep 17 00:00:00 2001
From: "pre-commit-ci[bot]"
 <66853113+pre-commit-ci[bot]@users.noreply.github.com>
Date: Wed, 11 Sep 2024 08:33:09 +0000
Subject: [PATCH 1042/1178] [pre-commit.ci] auto fixes from pre-commit.com
 hooks

for more information, see https://pre-commit.ci
---
 src/PIL/ImageFont.py | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/src/PIL/ImageFont.py b/src/PIL/ImageFont.py
index 7ee3aaa55ec..55ab6195184 100644
--- a/src/PIL/ImageFont.py
+++ b/src/PIL/ImageFont.py
@@ -934,7 +934,7 @@ def load_path(filename: str | bytes) -> ImageFont:
             pass
     msg = f"cannot find font file '{filename}' in `sys.path`"
     if os.path.exists(filename):
-        msg += f", did you mean `ImageFont.load(\"{filename}\")` instead?"
+        msg += f', did you mean `ImageFont.load("{filename}")` instead?'
 
     raise OSError(msg)
 

From 01ba1e2252bb6fab3bdee4ee0b2952746d919270 Mon Sep 17 00:00:00 2001
From: Andrew Murray <radarhere@users.noreply.github.com>
Date: Wed, 11 Sep 2024 19:53:52 +1000
Subject: [PATCH 1043/1178] Accept float stroke widths

---
 Tests/images/imagedraw_stroke_float.png | Bin 0 -> 1509 bytes
 Tests/test_imagedraw.py                 |  14 ++++++++++++++
 src/_imagingft.c                        |  18 +++++++++---------
 3 files changed, 23 insertions(+), 9 deletions(-)
 create mode 100644 Tests/images/imagedraw_stroke_float.png

diff --git a/Tests/images/imagedraw_stroke_float.png b/Tests/images/imagedraw_stroke_float.png
new file mode 100644
index 0000000000000000000000000000000000000000..a590f8af0b616852c8d54e591d04265dea90447b
GIT binary patch
literal 1509
zcma)+dpi>f0Eb7mn8{^mF&s3vgt;u2C}ZZ<np>7!A38(GopOnZ9cH6qE+N-r71fmL
zkz`~j<T7EENJdyha~SIQ0OybMJn!%QeS<d_kHboVmB0W1K+4I{-hKa*_eT;J-M6Up
zZ6N>vY;v-<^-QkdSNMhcV&r?T<vQKw)+=6u7UzwJH=&0e@J`3L;95GDAuk)&+*~c4
z_ZQ)Z+npYb@aER^YB#(LrUBoiWKU5mg2|#~J`5YyjTG+nMU|gPOw$Ql?O)MKTCGf3
zogUmq8d_P!@jeD6@=g(X20D4Q|C6mCkzJ4kEQ{1olsUw>bN@@SobhJcmaC<VAnttq
z`@CWlA+V<~#7tkRGvesvw?)-H0`h2oHxDqtF1@lw;adpfg(geb#~3Q+!g95g;tLZl
zSh+f8DOlucjk0P?h-lp-P<rd)yl=4dSGeX0kt9I0Cv6eluF7nT`CHY!#SS|I2PAef
zcJ(9#BW=n7mg?$c{#%a#GrMz%@n~QxvE!y+S<chZ&x$k4eJ80VF8RnEvi>8Hn=PkN
zzerpf&46-HeRZoeb0Q=&%}6(H{ShMi)jeAJ;W`1r96?c`b&i?GQPuT2bk8-7i&xbL
zc})(n%PNfw6nfGS&YMc4t4WM1c9{>1{;7m?1pz)45y~$DhnIXbnBNd<_i9^12X8ud
zS<hN16K%5E;Wa0Q2)_=L#v^Nvk+ke=)b2DplaVPQH5L#eA6iA57K73Xf(;a(Wf^J2
znWC+&tl5+8uQAO;YMBpE;OhJ5&xv>6^`63@I9FhTqem}l${p+<<Nf3EmMw39jBVcb
zN`Sm^E6dD&usj|4y3`YYm`Gi@dotA*C$NMeH8^?<$}nO+TJAkPEQrhY1188S<?D>T
znpcwuxCqOwtUi>ATq$DB$4p9Q8&iKO-@|Eg#<u-wuiZigA;jBE7f;(XIt8Mz`@-9U
z+M~hYqbjB7fsM4|v2<9r_seqU?uB)TD^PGAl&=uMl)iMIf?>F1KVFdG7t;4y-aQ+H
zI$Rg}OIEQfKCv4f3OXWfhy$F@K5M2!9OWIJ7-t)mQp0RxWAF!CVbi)LEQ!UNKSD1<
zx(bXNje3ECbh|viOa1E(SJns_nsoi%f(@$L^PWLW<;VzAhLh>4BHb661WKGTu@PBC
z58Z%D+D2}$e;*MBHq6a^+hP}5@4O9yRxI~9b<4q?P1r*SVfI|KW3Gh`Bf#{#cFrvx
zz4}4+@7l$AbdO~CTgt4Z@(a1k1I^+B?e$UbzHg44f>Q@jURX_tZI<Q&tUZz`lBKdf
zzG(UpOeRGzH751COY7E>JCCR96r{yH(w<Q~MzUis#oKlspY~mOgDu7~49!GKKh-?3
z;)ml}ejXF^>e?{wxN&{QF6<xR+?n6s@my;Dt@SVy)@~NLKX$I9D4UKiH;}ZlY_t1?
zuodaZXi^w^j0B_^H{yFpLhHHFiAeRQ9pmOtRK%HrwbIM*u0!M<hp0N)UpSUP-Esyb
zsnX)+|Ex6QpNqKR`dJqp^H`-Bri_Ys?&{ajmgMmHs#Y&U#-O(vs5ZI|l%sb6zf)<6
zdi!|=);>E{s|{Y$s)+q+%7VHj%gK|aq?UPp_x~WsLT&lk%aE6{kzXUYDZ(SkTJG1H
zm@fW8XV#|U-jshaiQ67<BYQ(5A<PXZxnz8(iaQGmt@1f-hyp{pJrGO0nWONGVAa%k
zymS%^Oz^Djl+lla6HPmDy|*z}whpF~RIf#e^<fLwf0VS{D$IeL<ad)V8i`BHNj0~)
zgGSfxw$hkyj<XXx<K74-vGM%~)>&sXc~G@n#oJOCn?j^ms0mlYQ?M&$(G3U>gP8G=
zy;$!r<g4aOtx*r#V;639Oi}DvRvinA^7&nMHmRYRb12@T{7UP4WRz~OGXZ#l<$m_V
zCVUsTGi$${P|0CkeJ)yl((7Hf4E(zPwW$A2V{!j)cZm@N$@oCne!c-t7@YkBbRg+p
D;oj7s

literal 0
HcmV?d00001

diff --git a/Tests/test_imagedraw.py b/Tests/test_imagedraw.py
index e852b847188..ed50dfbedf3 100644
--- a/Tests/test_imagedraw.py
+++ b/Tests/test_imagedraw.py
@@ -1368,6 +1368,20 @@ def test_stroke() -> None:
         )
 
 
+@skip_unless_feature("freetype2")
+def test_stroke_float() -> None:
+    # Arrange
+    im = Image.new("RGB", (120, 130))
+    draw = ImageDraw.Draw(im)
+    font = ImageFont.truetype("Tests/fonts/FreeMono.ttf", 120)
+
+    # Act
+    draw.text((12, 12), "A", "#f00", font, stroke_width=0.5)
+
+    # Assert
+    assert_image_similar_tofile(im, "Tests/images/imagedraw_stroke_float.png", 3.1)
+
+
 @skip_unless_feature("freetype2")
 def test_stroke_descender() -> None:
     # Arrange
diff --git a/src/_imagingft.c b/src/_imagingft.c
index 5c446e641f5..8bef45baf87 100644
--- a/src/_imagingft.c
+++ b/src/_imagingft.c
@@ -833,7 +833,7 @@ font_render(FontObject *self, PyObject *args) {
     Py_ssize_t id;
     int mask = 0;  /* is FT_LOAD_TARGET_MONO enabled? */
     int color = 0; /* is FT_LOAD_COLOR enabled? */
-    int stroke_width = 0;
+    float stroke_width = 0;
     PY_LONG_LONG foreground_ink_long = 0;
     unsigned int foreground_ink;
     const char *mode = NULL;
@@ -853,7 +853,7 @@ font_render(FontObject *self, PyObject *args) {
 
     if (!PyArg_ParseTuple(
             args,
-            "OO|zzOzizLffO:render",
+            "OO|zzOzfzLffO:render",
             &string,
             &fill,
             &mode,
@@ -919,8 +919,8 @@ font_render(FontObject *self, PyObject *args) {
         return NULL;
     }
 
-    width += stroke_width * 2 + ceil(x_start);
-    height += stroke_width * 2 + ceil(y_start);
+    width += ceil(stroke_width * 2 + x_start);
+    height += ceil(stroke_width * 2 + y_start);
     image = PyObject_CallFunction(fill, "ii", width, height);
     if (image == Py_None) {
         PyMem_Del(glyph_info);
@@ -934,8 +934,8 @@ font_render(FontObject *self, PyObject *args) {
     Py_XDECREF(imageId);
     im = (Imaging)id;
 
-    x_offset -= stroke_width;
-    y_offset -= stroke_width;
+    x_offset = round(x_offset - stroke_width);
+    y_offset = round(y_offset - stroke_width);
     if (count == 0 || width == 0 || height == 0) {
         PyMem_Del(glyph_info);
         return Py_BuildValue("N(ii)", image, x_offset, y_offset);
@@ -950,7 +950,7 @@ font_render(FontObject *self, PyObject *args) {
 
         FT_Stroker_Set(
             stroker,
-            (FT_Fixed)stroke_width * 64,
+            (FT_Fixed)round(stroke_width * 64),
             FT_STROKER_LINECAP_ROUND,
             FT_STROKER_LINEJOIN_ROUND,
             0
@@ -988,8 +988,8 @@ font_render(FontObject *self, PyObject *args) {
     }
 
     /* set pen position to text origin */
-    x = (-x_min + stroke_width + x_start) * 64;
-    y = (-y_max + (-stroke_width) - y_start) * 64;
+    x = round((-x_min + stroke_width + x_start) * 64);
+    y = round((-y_max + (-stroke_width) - y_start) * 64);
 
     if (stroker == NULL) {
         load_flags |= FT_LOAD_RENDER;

From 4a284a78c58e6952f4adc7230a4349defe38dcae Mon Sep 17 00:00:00 2001
From: Aleksandr Karpinskii <homm86@gmail.com>
Date: Sun, 1 Sep 2024 20:40:04 +0400
Subject: [PATCH 1044/1178] Remove weird comments

---
 src/encode.c                  | 7 -------
 src/libImaging/Jpeg2K.h       | 7 -------
 src/libImaging/Jpeg2KDecode.c | 7 -------
 src/libImaging/Jpeg2KEncode.c | 7 -------
 4 files changed, 28 deletions(-)

diff --git a/src/encode.c b/src/encode.c
index 529982dadc5..1a4cd489da2 100644
--- a/src/encode.c
+++ b/src/encode.c
@@ -1411,10 +1411,3 @@ PyImaging_Jpeg2KEncoderNew(PyObject *self, PyObject *args) {
 }
 
 #endif
-
-/*
- * Local Variables:
- * c-basic-offset: 4
- * End:
- *
- */
diff --git a/src/libImaging/Jpeg2K.h b/src/libImaging/Jpeg2K.h
index e8d92f7b6bc..6fbbf7311a1 100644
--- a/src/libImaging/Jpeg2K.h
+++ b/src/libImaging/Jpeg2K.h
@@ -104,10 +104,3 @@ typedef struct {
     int plt;
 
 } JPEG2KENCODESTATE;
-
-/*
- * Local Variables:
- * c-basic-offset: 4
- * End:
- *
- */
diff --git a/src/libImaging/Jpeg2KDecode.c b/src/libImaging/Jpeg2KDecode.c
index a81a14a09c0..fc927d2f0c0 100644
--- a/src/libImaging/Jpeg2KDecode.c
+++ b/src/libImaging/Jpeg2KDecode.c
@@ -979,10 +979,3 @@ ImagingJpeg2KVersion(void) {
 }
 
 #endif /* HAVE_OPENJPEG */
-
-/*
- * Local Variables:
- * c-basic-offset: 4
- * End:
- *
- */
diff --git a/src/libImaging/Jpeg2KEncode.c b/src/libImaging/Jpeg2KEncode.c
index cb21a186c0b..d30ccde603e 100644
--- a/src/libImaging/Jpeg2KEncode.c
+++ b/src/libImaging/Jpeg2KEncode.c
@@ -652,10 +652,3 @@ ImagingJpeg2KEncodeCleanup(ImagingCodecState state) {
 }
 
 #endif /* HAVE_OPENJPEG */
-
-/*
- * Local Variables:
- * c-basic-offset: 4
- * End:
- *
- */

From 77503156b17a8314652dcd69941cbdb222dd7bcf Mon Sep 17 00:00:00 2001
From: Yngve Mardal Moe <yngve.m.moe@gmail.com>
Date: Wed, 11 Sep 2024 14:22:45 +0200
Subject: [PATCH 1045/1178] Update src/PIL/ImageFont.py

Co-authored-by: Hugo van Kemenade <1324225+hugovk@users.noreply.github.com>
---
 src/PIL/ImageFont.py | 4 ++--
 1 file changed, 2 insertions(+), 2 deletions(-)

diff --git a/src/PIL/ImageFont.py b/src/PIL/ImageFont.py
index 55ab6195184..0fccee32ff5 100644
--- a/src/PIL/ImageFont.py
+++ b/src/PIL/ImageFont.py
@@ -932,9 +932,9 @@ def load_path(filename: str | bytes) -> ImageFont:
             return load(os.path.join(directory, filename))
         except OSError:
             pass
-    msg = f"cannot find font file '{filename}' in `sys.path`"
+    msg = f"cannot find font file '{filename}' in sys.path"
     if os.path.exists(filename):
-        msg += f', did you mean `ImageFont.load("{filename}")` instead?'
+        msg += f', did you mean ImageFont.load("{filename}") instead?'
 
     raise OSError(msg)
 

From 32c514d24ccac400b025c981bb27b48d6e78b2b6 Mon Sep 17 00:00:00 2001
From: Yngve Mardal Moe <yngve.m.moe@gmail.com>
Date: Wed, 11 Sep 2024 14:54:53 +0200
Subject: [PATCH 1046/1178] Update src/PIL/ImageFont.py

Co-authored-by: Andrew Murray <3112309+radarhere@users.noreply.github.com>
---
 src/PIL/ImageFont.py | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/src/PIL/ImageFont.py b/src/PIL/ImageFont.py
index 0fccee32ff5..89efe5bd8cc 100644
--- a/src/PIL/ImageFont.py
+++ b/src/PIL/ImageFont.py
@@ -932,7 +932,7 @@ def load_path(filename: str | bytes) -> ImageFont:
             return load(os.path.join(directory, filename))
         except OSError:
             pass
-    msg = f"cannot find font file '{filename}' in sys.path"
+    msg = f'cannot find font file "{filename}" in sys.path'
     if os.path.exists(filename):
         msg += f', did you mean ImageFont.load("{filename}") instead?'
 

From a2988da0d2e0057726687c8030b5f2ea2b007f8f Mon Sep 17 00:00:00 2001
From: Alexander Karpinsky <homm86@gmail.com>
Date: Wed, 11 Sep 2024 19:55:07 +0400
Subject: [PATCH 1047/1178] =?UTF-8?q?ImageCore=20=E2=86=92=20ImagingCore?=
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit

Co-authored-by: Andrew Murray <3112309+radarhere@users.noreply.github.com>
---
 docs/deprecations.rst | 8 ++++----
 1 file changed, 4 insertions(+), 4 deletions(-)

diff --git a/docs/deprecations.rst b/docs/deprecations.rst
index dd271a97f7c..af6de2f927e 100644
--- a/docs/deprecations.rst
+++ b/docs/deprecations.rst
@@ -141,10 +141,10 @@ Get Internal Pointers to Objects
 
 .. deprecated:: 11.0.0
 
-``Image.core.ImageCore.id`` and ``Image.core.ImageCore.unsafe_ptrs``
-have been deprecated and will be removed in Pillow 12 (2025-10-15).
-They were used for obtaining raw pointers to ``ImageCore`` internals. To interact with
-C code, you can use ``Image.core.ImageCore.ptr``, which returns a ``Capsule`` object.
+``Image.core.ImagingCore.id`` and ``Image.core.ImagingCore.unsafe_ptrs`` have been
+deprecated and will be removed in Pillow 12 (2025-10-15). They were used for obtaining
+raw pointers to ``ImagingCore`` internals. To interact with C code, you can use
+``Image.core.ImagingCore.ptr``, which returns a ``Capsule`` object.
 
 Removed features
 ----------------

From aa7dfe3a56380a4ba98a7b439fbc3085603beae4 Mon Sep 17 00:00:00 2001
From: Andrew Murray <radarhere@users.noreply.github.com>
Date: Thu, 12 Sep 2024 16:16:21 +1000
Subject: [PATCH 1048/1178] Update CHANGES.rst [ci skip]

---
 CHANGES.rst | 3 +++
 1 file changed, 3 insertions(+)

diff --git a/CHANGES.rst b/CHANGES.rst
index af292f7a135..f23ec609fa4 100644
--- a/CHANGES.rst
+++ b/CHANGES.rst
@@ -5,6 +5,9 @@ Changelog (Pillow)
 11.0.0 (unreleased)
 -------------------
 
+- Accept float stroke widths #8369
+  [radarhere]
+
 - Deprecate ICNS (width, height, scale) sizes in favour of load(scale) #8352
   [radarhere]
 

From fab19b0af822128f305f8ffedd0645f33160f5d8 Mon Sep 17 00:00:00 2001
From: Andrew Murray <radarhere@users.noreply.github.com>
Date: Thu, 12 Sep 2024 16:57:28 +1000
Subject: [PATCH 1049/1178] Windows wheels are now grouped with the others

---
 wheels/README.md | 9 +++------
 1 file changed, 3 insertions(+), 6 deletions(-)

diff --git a/wheels/README.md b/wheels/README.md
index 8b412b7fe32..1175616e147 100644
--- a/wheels/README.md
+++ b/wheels/README.md
@@ -1,11 +1,11 @@
 README
 ------
 
-[cibuildwheel](https://github.com/pypa/cibuildwheel) is used to build macOS and Linux
-wheels for tagged versions of Pillow.
+[cibuildwheel](https://github.com/pypa/cibuildwheel) is used to build wheels for tagged
+versions of Pillow.
 
 This directory contains [multibuild](https://github.com/multi-build/multibuild) to
-build dependencies for the wheels, and dependency licenses to be included.
+build dependencies for macOS and Linux wheels, and dependency licenses to be included.
 
 Archives
 --------
@@ -30,6 +30,3 @@ Wheels
 
 Wheels are
 [GitHub Actions artifacts created for tags, relevant changes or manual builds](https://github.com/python-pillow/Pillow/actions/workflows/wheels.yml).
-
-Windows wheels are created separately. They are
-[GitHub Actions artifacts created on each run of the Windows workflow](https://github.com/python-pillow/Pillow/actions/workflows/test-windows.yml?query=branch%3Amain).

From 8336852b610f3a2b83c1d0706c0d76998526c709 Mon Sep 17 00:00:00 2001
From: Andrew Murray <radarhere@users.noreply.github.com>
Date: Thu, 12 Sep 2024 18:52:07 +1000
Subject: [PATCH 1050/1178] Install NumPy from PyPI for free threaded job

---
 .ci/install.sh | 7 +------
 1 file changed, 1 insertion(+), 6 deletions(-)

diff --git a/.ci/install.sh b/.ci/install.sh
index 7e3a691e566..e85e6bdc575 100755
--- a/.ci/install.sh
+++ b/.ci/install.sh
@@ -38,12 +38,7 @@ python3 -m pip install -U pytest-timeout
 python3 -m pip install pyroma
 
 if [[ $(uname) != CYGWIN* ]]; then
-    # TODO Update condition when NumPy supports free-threading
-    if [[ "$PYTHON_GIL" == "0" ]]; then
-        python3 -m pip install numpy --index-url https://pypi.anaconda.org/scientific-python-nightly-wheels/simple
-    else
-        python3 -m pip install numpy
-    fi
+    python3 -m pip install numpy
 
     # PyQt6 doesn't support PyPy3
     if [[ $GHA_PYTHON_VERSION == 3.* ]]; then

From c9f88890a56882ca43a5e00fb6ed1892f706eaa0 Mon Sep 17 00:00:00 2001
From: Lysandros Nikolaou <lisandrosnik@gmail.com>
Date: Thu, 12 Sep 2024 14:52:24 +0300
Subject: [PATCH 1051/1178] Install numpy from PyPI when testing wheels

---
 .github/workflows/wheels-test.sh | 6 +-----
 1 file changed, 1 insertion(+), 5 deletions(-)

diff --git a/.github/workflows/wheels-test.sh b/.github/workflows/wheels-test.sh
index 023a338244e..eebfd5c55ea 100755
--- a/.github/workflows/wheels-test.sh
+++ b/.github/workflows/wheels-test.sh
@@ -15,11 +15,7 @@ fi
 
 if [ "${AUDITWHEEL_POLICY::9}" != "musllinux" ]; then
   # TODO Update condition when NumPy supports free-threading
-  if [ $(python3 -c "import sysconfig;print(sysconfig.get_config_var('Py_GIL_DISABLED'))") == "1" ]; then
-    python3 -m pip install numpy --index-url https://pypi.anaconda.org/scientific-python-nightly-wheels/simple
-  else
-    python3 -m pip install numpy
-  fi
+  python3 -m pip install numpy
 fi
 
 if [ ! -d "test-images-main" ]; then

From 1ead7791c697d5ea76c299156680a3cdd2fa7f14 Mon Sep 17 00:00:00 2001
From: Lysandros Nikolaou <lisandrosnik@gmail.com>
Date: Thu, 12 Sep 2024 16:34:29 +0300
Subject: [PATCH 1052/1178] Remove comment

---
 .github/workflows/wheels-test.sh | 1 -
 1 file changed, 1 deletion(-)

diff --git a/.github/workflows/wheels-test.sh b/.github/workflows/wheels-test.sh
index eebfd5c55ea..bdf0caffa61 100755
--- a/.github/workflows/wheels-test.sh
+++ b/.github/workflows/wheels-test.sh
@@ -14,7 +14,6 @@ else
 fi
 
 if [ "${AUDITWHEEL_POLICY::9}" != "musllinux" ]; then
-  # TODO Update condition when NumPy supports free-threading
   python3 -m pip install numpy
 fi
 

From fea929bf10dbf0c77cffd1375a5542d40d24b2f5 Mon Sep 17 00:00:00 2001
From: Andrew Murray <radarhere@users.noreply.github.com>
Date: Fri, 13 Sep 2024 07:34:56 +1000
Subject: [PATCH 1053/1178] Test NumPy with musllinux wheels

---
 .github/workflows/wheels-test.sh | 4 +---
 1 file changed, 1 insertion(+), 3 deletions(-)

diff --git a/.github/workflows/wheels-test.sh b/.github/workflows/wheels-test.sh
index bdf0caffa61..b30b1725f94 100755
--- a/.github/workflows/wheels-test.sh
+++ b/.github/workflows/wheels-test.sh
@@ -13,9 +13,7 @@ else
     yum install -y fribidi
 fi
 
-if [ "${AUDITWHEEL_POLICY::9}" != "musllinux" ]; then
-  python3 -m pip install numpy
-fi
+python3 -m pip install numpy
 
 if [ ! -d "test-images-main" ]; then
     curl -fsSL -o pillow-test-images.zip https://github.com/python-pillow/test-images/archive/main.zip

From 5d8e891387cfd2313d021578b9a049a057980726 Mon Sep 17 00:00:00 2001
From: Andrew Murray <radarhere@users.noreply.github.com>
Date: Fri, 13 Sep 2024 10:52:36 +1000
Subject: [PATCH 1054/1178] Updated libpng to 1.6.44

---
 .github/workflows/wheels-dependencies.sh | 2 +-
 winbuild/build_prepare.py                | 2 +-
 2 files changed, 2 insertions(+), 2 deletions(-)

diff --git a/.github/workflows/wheels-dependencies.sh b/.github/workflows/wheels-dependencies.sh
index c25e1a27d94..f87ace4c609 100755
--- a/.github/workflows/wheels-dependencies.sh
+++ b/.github/workflows/wheels-dependencies.sh
@@ -21,7 +21,7 @@ if [[ "$MB_ML_VER" != 2014 ]]; then
 else
     HARFBUZZ_VERSION=8.5.0
 fi
-LIBPNG_VERSION=1.6.43
+LIBPNG_VERSION=1.6.44
 JPEGTURBO_VERSION=3.0.3
 OPENJPEG_VERSION=2.5.2
 XZ_VERSION=5.4.5
diff --git a/winbuild/build_prepare.py b/winbuild/build_prepare.py
index 423aaa96607..6d7d5dcdf20 100644
--- a/winbuild/build_prepare.py
+++ b/winbuild/build_prepare.py
@@ -115,7 +115,7 @@ def cmd_msbuild(
     "HARFBUZZ": "9.0.0",
     "JPEGTURBO": "3.0.3",
     "LCMS2": "2.16",
-    "LIBPNG": "1.6.43",
+    "LIBPNG": "1.6.44",
     "LIBWEBP": "1.4.0",
     "OPENJPEG": "2.5.2",
     "TIFF": "4.6.0",

From 0f67dfc380a460eb2b4d2bcd43e54b59240006b8 Mon Sep 17 00:00:00 2001
From: Andrew Murray <radarhere@users.noreply.github.com>
Date: Fri, 13 Sep 2024 15:31:37 +1000
Subject: [PATCH 1055/1178] Change macos-14 to macos-latest

---
 .github/workflows/test.yml   | 4 ++--
 .github/workflows/wheels.yml | 2 +-
 2 files changed, 3 insertions(+), 3 deletions(-)

diff --git a/.github/workflows/test.yml b/.github/workflows/test.yml
index e0903f8869c..6576292b5e4 100644
--- a/.github/workflows/test.yml
+++ b/.github/workflows/test.yml
@@ -37,7 +37,7 @@ jobs:
       fail-fast: false
       matrix:
         os: [
-          "macos-14",
+          "macos-latest",
           "ubuntu-latest",
         ]
         python-version: [
@@ -56,7 +56,7 @@ jobs:
         # M1 only available for 3.10+
         - { os: "macos-13", python-version: "3.9" }
         exclude:
-        - { os: "macos-14", python-version: "3.9" }
+        - { os: "macos-latest", python-version: "3.9" }
 
     runs-on: ${{ matrix.os }}
     name: ${{ matrix.os }} Python ${{ matrix.python-version }} ${{ matrix.disable-gil && 'free-threaded' || '' }}
diff --git a/.github/workflows/wheels.yml b/.github/workflows/wheels.yml
index f3ed8399bd3..e208417e126 100644
--- a/.github/workflows/wheels.yml
+++ b/.github/workflows/wheels.yml
@@ -107,7 +107,7 @@ jobs:
             cibw_arch: x86_64
             macosx_deployment_target: "10.10"
           - name: "macOS arm64"
-            os: macos-14
+            os: macos-latest
             cibw_arch: arm64
             macosx_deployment_target: "11.0"
           - name: "manylinux2014 and musllinux x86_64"

From 1557f7e36f134979ee607e7583185f8b3adc2212 Mon Sep 17 00:00:00 2001
From: Andrew Murray <radarhere@users.noreply.github.com>
Date: Fri, 13 Sep 2024 23:41:03 +1000
Subject: [PATCH 1056/1178] Removed unused variable

---
 src/path.c | 1 -
 1 file changed, 1 deletion(-)

diff --git a/src/path.c b/src/path.c
index b96e8b78a70..f4f4287f388 100644
--- a/src/path.c
+++ b/src/path.c
@@ -44,7 +44,6 @@ PyImaging_GetBuffer(PyObject *buffer, Py_buffer *view);
 typedef struct {
     PyObject_HEAD Py_ssize_t count;
     double *xy;
-    int index; /* temporary use, e.g. in decimate */
 } PyPathObject;
 
 static PyTypeObject PyPathType;

From 6921f83629242d199eaab87af55da6279588a8e0 Mon Sep 17 00:00:00 2001
From: Alexander Karpinsky <homm86@gmail.com>
Date: Fri, 13 Sep 2024 22:54:16 +0200
Subject: [PATCH 1057/1178] Update docs/deprecations.rst

Co-authored-by: Andrew Murray <3112309+radarhere@users.noreply.github.com>
---
 docs/deprecations.rst | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/docs/deprecations.rst b/docs/deprecations.rst
index af6de2f927e..bfe9849da25 100644
--- a/docs/deprecations.rst
+++ b/docs/deprecations.rst
@@ -144,7 +144,7 @@ Get Internal Pointers to Objects
 ``Image.core.ImagingCore.id`` and ``Image.core.ImagingCore.unsafe_ptrs`` have been
 deprecated and will be removed in Pillow 12 (2025-10-15). They were used for obtaining
 raw pointers to ``ImagingCore`` internals. To interact with C code, you can use
-``Image.core.ImagingCore.ptr``, which returns a ``Capsule`` object.
+``Image.Image.getim()``, which returns a ``Capsule`` object.
 
 Removed features
 ----------------

From 57131599682b1c6a54748006ccda4abfd0f2615e Mon Sep 17 00:00:00 2001
From: "renovate[bot]" <29139614+renovate[bot]@users.noreply.github.com>
Date: Fri, 13 Sep 2024 23:52:11 +0000
Subject: [PATCH 1058/1178] Update dependency cibuildwheel to v2.21.0

---
 .ci/requirements-cibw.txt | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/.ci/requirements-cibw.txt b/.ci/requirements-cibw.txt
index b8e6c39473e..210f29d3a0c 100644
--- a/.ci/requirements-cibw.txt
+++ b/.ci/requirements-cibw.txt
@@ -1 +1 @@
-cibuildwheel==2.20.0
+cibuildwheel==2.21.0

From a3d9529f045af093eb964bf264064b261714b127 Mon Sep 17 00:00:00 2001
From: Andrew Murray <radarhere@users.noreply.github.com>
Date: Sat, 14 Sep 2024 11:23:09 +1000
Subject: [PATCH 1059/1178] Updated macOS deployment target for Python >= 3.12
 on Intel to 10.13

---
 .github/workflows/wheels.yml | 10 ++++++++--
 1 file changed, 8 insertions(+), 2 deletions(-)

diff --git a/.github/workflows/wheels.yml b/.github/workflows/wheels.yml
index e208417e126..11564c14256 100644
--- a/.github/workflows/wheels.yml
+++ b/.github/workflows/wheels.yml
@@ -102,10 +102,16 @@ jobs:
       fail-fast: false
       matrix:
         include:
-          - name: "macOS x86_64"
+          - name: "macOS 10.10 x86_64"
             os: macos-13
             cibw_arch: x86_64
+            build: "pp310* cp3{9,10,11}*"
             macosx_deployment_target: "10.10"
+          - name: "macOS 10.13 x86_64"
+            os: macos-13
+            cibw_arch: x86_64
+            build: "cp3{12,13}*"
+            macosx_deployment_target: "10.13"
           - name: "macOS arm64"
             os: macos-latest
             cibw_arch: arm64
@@ -145,7 +151,7 @@ jobs:
 
       - uses: actions/upload-artifact@v4
         with:
-          name: dist-${{ matrix.os }}-${{ matrix.cibw_arch }}${{ matrix.manylinux && format('-{0}', matrix.manylinux) }}
+          name: dist-${{ matrix.os }}${{ matrix.macosx_deployment_target && format('-{0}', matrix.macosx_deployment_target) }}-${{ matrix.cibw_arch }}${{ matrix.manylinux && format('-{0}', matrix.manylinux) }}
           path: ./wheelhouse/*.whl
 
   windows:

From 10c118bb5c2dca0343d1e6e733de51e519f0374a Mon Sep 17 00:00:00 2001
From: Andrew Murray <radarhere@users.noreply.github.com>
Date: Sat, 14 Sep 2024 19:58:57 +1000
Subject: [PATCH 1060/1178] Added release notes for #8379

---
 docs/releasenotes/11.0.0.rst | 9 +++++++++
 1 file changed, 9 insertions(+)

diff --git a/docs/releasenotes/11.0.0.rst b/docs/releasenotes/11.0.0.rst
index 5f90348ad46..1b84076361d 100644
--- a/docs/releasenotes/11.0.0.rst
+++ b/docs/releasenotes/11.0.0.rst
@@ -23,6 +23,13 @@ Python 3.8
 Pillow has dropped support for Python 3.8,
 which reached end-of-life in October 2024.
 
+Python 3.12 on macOS < 10.13
+^^^^^^^^^^^^^^^^^^^^^^^^^^^^
+
+The latest version of Python 3.12 no longer supports macOS versions earlier than 10.13,
+and so Pillow has also updated the deployment target for its prebuilt Python 3.12
+wheels.
+
 PSFile
 ^^^^^^
 
@@ -147,6 +154,8 @@ Pillow 11.0.0 now officially supports Python 3.13.
 
 Support has also been added for the experimental free-threaded mode of :pep:`703`.
 
+Python 3.13 does not support macOS versions earlier than 10.13.
+
 C-level Flags
 ^^^^^^^^^^^^^
 

From ad0091096f4c653c88a98a03e1323d855152bb81 Mon Sep 17 00:00:00 2001
From: Andrew Murray <3112309+radarhere@users.noreply.github.com>
Date: Sat, 14 Sep 2024 20:52:49 +1000
Subject: [PATCH 1061/1178] Describe supported OS versions instead of
 unsupported

Co-authored-by: Hugo van Kemenade <1324225+hugovk@users.noreply.github.com>
---
 docs/releasenotes/11.0.0.rst | 8 ++++----
 1 file changed, 4 insertions(+), 4 deletions(-)

diff --git a/docs/releasenotes/11.0.0.rst b/docs/releasenotes/11.0.0.rst
index 1b84076361d..36334e39f5e 100644
--- a/docs/releasenotes/11.0.0.rst
+++ b/docs/releasenotes/11.0.0.rst
@@ -23,10 +23,10 @@ Python 3.8
 Pillow has dropped support for Python 3.8,
 which reached end-of-life in October 2024.
 
-Python 3.12 on macOS < 10.13
-^^^^^^^^^^^^^^^^^^^^^^^^^^^^
+Python 3.12 on macOS <= 10.12
+^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
 
-The latest version of Python 3.12 no longer supports macOS versions earlier than 10.13,
+The latest version of Python 3.12 only supports macOS versions 10.13 and later,
 and so Pillow has also updated the deployment target for its prebuilt Python 3.12
 wheels.
 
@@ -154,7 +154,7 @@ Pillow 11.0.0 now officially supports Python 3.13.
 
 Support has also been added for the experimental free-threaded mode of :pep:`703`.
 
-Python 3.13 does not support macOS versions earlier than 10.13.
+Python 3.13 only supports macOS versions 10.13 and later.
 
 C-level Flags
 ^^^^^^^^^^^^^

From 88b3265a9cb86ffd8a7c43c1afa8dae1b78cf035 Mon Sep 17 00:00:00 2001
From: Andrew Murray <radarhere@users.noreply.github.com>
Date: Sat, 14 Sep 2024 20:59:02 +1000
Subject: [PATCH 1062/1178] Lint: Run PT016

---
 Tests/test_image.py     | 15 +++++----------
 Tests/test_imageshow.py |  2 +-
 pyproject.toml          |  1 -
 3 files changed, 6 insertions(+), 12 deletions(-)

diff --git a/Tests/test_image.py b/Tests/test_image.py
index cf5b5a710cc..9b65041f4b4 100644
--- a/Tests/test_image.py
+++ b/Tests/test_image.py
@@ -1086,22 +1086,17 @@ def test_overrun(self, path: str) -> None:
         valgrind pytest -qq Tests/test_image.py::TestImage::test_overrun | grep decode.c
         """
         with Image.open(os.path.join("Tests/images", path)) as im:
-            try:
+            with pytest.raises(OSError) as e:
                 im.load()
-                pytest.fail()
-            except OSError as e:
-                buffer_overrun = str(e) == "buffer overrun when reading image file"
-                truncated = "image file is truncated" in str(e)
+        buffer_overrun = str(e.value) == "buffer overrun when reading image file"
+        truncated = "image file is truncated" in str(e.value)
 
-                assert buffer_overrun or truncated
+        assert buffer_overrun or truncated
 
     def test_fli_overrun2(self) -> None:
         with Image.open("Tests/images/fli_overrun2.bin") as im:
-            try:
+            with pytest.raises(OSError, match="buffer overrun when reading image file"):
                 im.seek(1)
-                pytest.fail()
-            except OSError as e:
-                assert str(e) == "buffer overrun when reading image file"
 
     def test_exit_fp(self) -> None:
         with Image.new("L", (1, 1)) as im:
diff --git a/Tests/test_imageshow.py b/Tests/test_imageshow.py
index a4f7e5cc5b4..67c32783fc5 100644
--- a/Tests/test_imageshow.py
+++ b/Tests/test_imageshow.py
@@ -115,7 +115,7 @@ def test_ipythonviewer() -> None:
             test_viewer = viewer
             break
     else:
-        pytest.fail()
+        pytest.fail("IPythonViewer not found")
 
     im = hopper()
     assert test_viewer.show(im) == 1
diff --git a/pyproject.toml b/pyproject.toml
index 4042bd9ee20..228c344e864 100644
--- a/pyproject.toml
+++ b/pyproject.toml
@@ -125,7 +125,6 @@ lint.ignore = [
   "PT007",  # pytest-parametrize-values-wrong-type
   "PT011",  # pytest-raises-too-broad
   "PT012",  # pytest-raises-with-multiple-statements
-  "PT016",  # pytest-fail-without-message
   "PT017",  # pytest-assert-in-except
   "PYI026", # flake8-pyi: typing.TypeAlias added in Python 3.10
   "PYI034", # flake8-pyi: typing.Self added in Python 3.11

From c01d2d05772dd52e316ccd0b868a1c7b560cc391 Mon Sep 17 00:00:00 2001
From: Andrew Murray <radarhere@users.noreply.github.com>
Date: Sun, 15 Sep 2024 21:57:45 +1000
Subject: [PATCH 1063/1178] Updated libjpeg-turbo to 3.0.4

---
 .github/workflows/wheels-dependencies.sh | 2 +-
 winbuild/build_prepare.py                | 2 +-
 2 files changed, 2 insertions(+), 2 deletions(-)

diff --git a/.github/workflows/wheels-dependencies.sh b/.github/workflows/wheels-dependencies.sh
index d1e87899fee..4d40f7fabfc 100755
--- a/.github/workflows/wheels-dependencies.sh
+++ b/.github/workflows/wheels-dependencies.sh
@@ -22,7 +22,7 @@ else
     HARFBUZZ_VERSION=8.5.0
 fi
 LIBPNG_VERSION=1.6.44
-JPEGTURBO_VERSION=3.0.3
+JPEGTURBO_VERSION=3.0.4
 OPENJPEG_VERSION=2.5.2
 XZ_VERSION=5.6.2
 TIFF_VERSION=4.6.0
diff --git a/winbuild/build_prepare.py b/winbuild/build_prepare.py
index b478c1c6b7a..e2022d28337 100644
--- a/winbuild/build_prepare.py
+++ b/winbuild/build_prepare.py
@@ -113,7 +113,7 @@ def cmd_msbuild(
     "FREETYPE": "2.13.3",
     "FRIBIDI": "1.0.15",
     "HARFBUZZ": "9.0.0",
-    "JPEGTURBO": "3.0.3",
+    "JPEGTURBO": "3.0.4",
     "LCMS2": "2.16",
     "LIBPNG": "1.6.44",
     "LIBWEBP": "1.4.0",

From 8a086edbe965bff4d89fc3b189e021f0b1a2b322 Mon Sep 17 00:00:00 2001
From: Andrew Murray <radarhere@users.noreply.github.com>
Date: Mon, 16 Sep 2024 08:22:58 +1000
Subject: [PATCH 1064/1178] Cast handle to int

---
 Tests/test_imagewin.py | 12 ++++++++++++
 src/PIL/ImageWin.py    | 19 +++++++++++--------
 2 files changed, 23 insertions(+), 8 deletions(-)

diff --git a/Tests/test_imagewin.py b/Tests/test_imagewin.py
index a836bb90b6e..e7af160ddd2 100644
--- a/Tests/test_imagewin.py
+++ b/Tests/test_imagewin.py
@@ -60,6 +60,18 @@ def test_dib_mode_string(self) -> None:
         with pytest.raises(ValueError):
             ImageWin.Dib(mode)
 
+    def test_dib_hwnd(self) -> None:
+        mode = "RGBA"
+        size = (128, 128)
+        wnd = 0
+
+        dib = ImageWin.Dib(mode, size)
+        hwnd = ImageWin.HWND(wnd)
+
+        dib.expose(hwnd)
+        dib.draw(hwnd, (0, 0) + size)
+        assert isinstance(dib.query_palette(hwnd), int)
+
     def test_dib_paste(self) -> None:
         # Arrange
         im = hopper()
diff --git a/src/PIL/ImageWin.py b/src/PIL/ImageWin.py
index 6fc7cfaf528..98c28f29f1d 100644
--- a/src/PIL/ImageWin.py
+++ b/src/PIL/ImageWin.py
@@ -98,14 +98,15 @@ def expose(self, handle: int | HDC | HWND) -> None:
                        HDC or HWND instance.  In PythonWin, you can use
                        ``CDC.GetHandleAttrib()`` to get a suitable handle.
         """
+        handle_int = int(handle)
         if isinstance(handle, HWND):
-            dc = self.image.getdc(handle)
+            dc = self.image.getdc(handle_int)
             try:
                 self.image.expose(dc)
             finally:
-                self.image.releasedc(handle, dc)
+                self.image.releasedc(handle_int, dc)
         else:
-            self.image.expose(handle)
+            self.image.expose(handle_int)
 
     def draw(
         self,
@@ -124,14 +125,15 @@ def draw(
         """
         if src is None:
             src = (0, 0) + self.size
+        handle_int = int(handle)
         if isinstance(handle, HWND):
-            dc = self.image.getdc(handle)
+            dc = self.image.getdc(handle_int)
             try:
                 self.image.draw(dc, dst, src)
             finally:
-                self.image.releasedc(handle, dc)
+                self.image.releasedc(handle_int, dc)
         else:
-            self.image.draw(handle, dst, src)
+            self.image.draw(handle_int, dst, src)
 
     def query_palette(self, handle: int | HDC | HWND) -> int:
         """
@@ -148,14 +150,15 @@ def query_palette(self, handle: int | HDC | HWND) -> int:
         :return: The number of entries that were changed (if one or more entries,
                  this indicates that the image should be redrawn).
         """
+        handle_int = int(handle)
         if isinstance(handle, HWND):
-            handle = self.image.getdc(handle)
+            handle = self.image.getdc(handle_int)
             try:
                 result = self.image.query_palette(handle)
             finally:
                 self.image.releasedc(handle, handle)
         else:
-            result = self.image.query_palette(handle)
+            result = self.image.query_palette(handle_int)
         return result
 
     def paste(

From 1f3fe6f73350aa9630b236a9f16370aa0c71258d Mon Sep 17 00:00:00 2001
From: Andrew Murray <radarhere@users.noreply.github.com>
Date: Mon, 16 Sep 2024 10:21:17 +1000
Subject: [PATCH 1065/1178] Use getim()

---
 Tests/test_imagemorph.py | 8 ++++----
 src/PIL/ImageCms.py      | 4 ++--
 src/PIL/ImageMath.py     | 5 ++---
 src/PIL/ImageMorph.py    | 6 +++---
 src/PIL/ImageTk.py       | 2 +-
 src/PIL/_imagingcms.pyi  | 4 +++-
 6 files changed, 15 insertions(+), 14 deletions(-)

diff --git a/Tests/test_imagemorph.py b/Tests/test_imagemorph.py
index 04860fd616c..9da32aa0124 100644
--- a/Tests/test_imagemorph.py
+++ b/Tests/test_imagemorph.py
@@ -328,13 +328,13 @@ def test_wrong_mode() -> None:
     iml = Image.new("L", (10, 10))
 
     with pytest.raises(RuntimeError):
-        _imagingmorph.apply(bytes(lut), imrgb.im.ptr, iml.im.ptr)
+        _imagingmorph.apply(bytes(lut), imrgb.getim(), iml.getim())
 
     with pytest.raises(RuntimeError):
-        _imagingmorph.apply(bytes(lut), iml.im.ptr, imrgb.im.ptr)
+        _imagingmorph.apply(bytes(lut), iml.getim(), imrgb.getim())
 
     with pytest.raises(RuntimeError):
-        _imagingmorph.match(bytes(lut), imrgb.im.ptr)
+        _imagingmorph.match(bytes(lut), imrgb.getim())
 
     # Should not raise
-    _imagingmorph.match(bytes(lut), iml.im.ptr)
+    _imagingmorph.match(bytes(lut), iml.getim())
diff --git a/src/PIL/ImageCms.py b/src/PIL/ImageCms.py
index 5e256b0ab7f..f028f177533 100644
--- a/src/PIL/ImageCms.py
+++ b/src/PIL/ImageCms.py
@@ -352,7 +352,7 @@ def apply(self, im: Image.Image, imOut: Image.Image | None = None) -> Image.Imag
         im.load()
         if imOut is None:
             imOut = Image.new(self.output_mode, im.size, None)
-        self.transform.apply(im.im.ptr, imOut.im.ptr)
+        self.transform.apply(im.getim(), imOut.getim())
         imOut.info["icc_profile"] = self.output_profile.tobytes()
         return imOut
 
@@ -361,7 +361,7 @@ def apply_in_place(self, im: Image.Image) -> Image.Image:
         if im.mode != self.output_mode:
             msg = "mode mismatch"
             raise ValueError(msg)  # wrong output mode
-        self.transform.apply(im.im.ptr, im.im.ptr)
+        self.transform.apply(im.getim(), im.getim())
         im.info["icc_profile"] = self.output_profile.tobytes()
         return im
 
diff --git a/src/PIL/ImageMath.py b/src/PIL/ImageMath.py
index b32742657ba..ff3014a8d5a 100644
--- a/src/PIL/ImageMath.py
+++ b/src/PIL/ImageMath.py
@@ -65,7 +65,7 @@ def apply(
             except AttributeError as e:
                 msg = f"bad operand type for '{op}'"
                 raise TypeError(msg) from e
-            _imagingmath.unop(op, out.im.ptr, im_1.im.ptr)
+            _imagingmath.unop(op, out.getim(), im_1.getim())
         else:
             # binary operation
             im_2 = self.__fixup(im2)
@@ -87,13 +87,12 @@ def apply(
                     im_2 = im_2.crop((0, 0) + size)
             out = Image.new(mode or im_1.mode, im_1.size, None)
             im_1.load()
-            im_2.load()
             try:
                 op = getattr(_imagingmath, f"{op}_{im_1.mode}")
             except AttributeError as e:
                 msg = f"bad operand type for '{op}'"
                 raise TypeError(msg) from e
-            _imagingmath.binop(op, out.im.ptr, im_1.im.ptr, im_2.im.ptr)
+            _imagingmath.binop(op, out.getim(), im_1.getim(), im_2.getim())
         return _Operand(out)
 
     # unary operators
diff --git a/src/PIL/ImageMorph.py b/src/PIL/ImageMorph.py
index bc7ed66d3fb..f0a066b5bd8 100644
--- a/src/PIL/ImageMorph.py
+++ b/src/PIL/ImageMorph.py
@@ -213,7 +213,7 @@ def apply(self, image: Image.Image) -> tuple[int, Image.Image]:
             msg = "Image mode must be L"
             raise ValueError(msg)
         outimage = Image.new(image.mode, image.size, None)
-        count = _imagingmorph.apply(bytes(self.lut), image.im.ptr, outimage.im.ptr)
+        count = _imagingmorph.apply(bytes(self.lut), image.getim(), outimage.getim())
         return count, outimage
 
     def match(self, image: Image.Image) -> list[tuple[int, int]]:
@@ -229,7 +229,7 @@ def match(self, image: Image.Image) -> list[tuple[int, int]]:
         if image.mode != "L":
             msg = "Image mode must be L"
             raise ValueError(msg)
-        return _imagingmorph.match(bytes(self.lut), image.im.ptr)
+        return _imagingmorph.match(bytes(self.lut), image.getim())
 
     def get_on_pixels(self, image: Image.Image) -> list[tuple[int, int]]:
         """Get a list of all turned on pixels in a binary image
@@ -240,7 +240,7 @@ def get_on_pixels(self, image: Image.Image) -> list[tuple[int, int]]:
         if image.mode != "L":
             msg = "Image mode must be L"
             raise ValueError(msg)
-        return _imagingmorph.get_on_pixels(image.im.ptr)
+        return _imagingmorph.get_on_pixels(image.getim())
 
     def load_lut(self, filename: str) -> None:
         """Load an operator from an mrl file"""
diff --git a/src/PIL/ImageTk.py b/src/PIL/ImageTk.py
index d01af364bb5..c36cf9b8473 100644
--- a/src/PIL/ImageTk.py
+++ b/src/PIL/ImageTk.py
@@ -259,7 +259,7 @@ def getimage(photo: PhotoImage) -> Image.Image:
     """Copies the contents of a PhotoImage to a PIL image memory."""
     im = Image.new("RGBA", (photo.width(), photo.height()))
 
-    _pyimagingtkcall("PyImagingPhotoGet", photo, im.im.ptr)
+    _pyimagingtkcall("PyImagingPhotoGet", photo, im.getim())
 
     return im
 
diff --git a/src/PIL/_imagingcms.pyi b/src/PIL/_imagingcms.pyi
index 2abd6d0f7a9..ddcf93ab1eb 100644
--- a/src/PIL/_imagingcms.pyi
+++ b/src/PIL/_imagingcms.pyi
@@ -2,6 +2,8 @@ import datetime
 import sys
 from typing import Literal, SupportsFloat, TypedDict
 
+from ._typing import CapsuleType
+
 littlecms_version: str | None
 
 _Tuple3f = tuple[float, float, float]
@@ -108,7 +110,7 @@ class CmsProfile:
     def is_intent_supported(self, intent: int, direction: int, /) -> int: ...
 
 class CmsTransform:
-    def apply(self, id_in: int, id_out: int) -> int: ...
+    def apply(self, id_in: CapsuleType, id_out: CapsuleType) -> int: ...
 
 def profile_open(profile: str, /) -> CmsProfile: ...
 def profile_frombytes(profile: bytes, /) -> CmsProfile: ...

From d8ef314205ff65e6aeeefe3092414cc45e7349eb Mon Sep 17 00:00:00 2001
From: Aleksandr Karpinskii <homm86@gmail.com>
Date: Mon, 16 Sep 2024 10:39:14 +0200
Subject: [PATCH 1066/1178] Remove extra load() calls

---
 src/PIL/ImageCms.py  | 2 --
 src/PIL/ImageMath.py | 2 --
 2 files changed, 4 deletions(-)

diff --git a/src/PIL/ImageCms.py b/src/PIL/ImageCms.py
index f028f177533..b6c5de5b36f 100644
--- a/src/PIL/ImageCms.py
+++ b/src/PIL/ImageCms.py
@@ -349,7 +349,6 @@ def point(self, im: Image.Image) -> Image.Image:
         return self.apply(im)
 
     def apply(self, im: Image.Image, imOut: Image.Image | None = None) -> Image.Image:
-        im.load()
         if imOut is None:
             imOut = Image.new(self.output_mode, im.size, None)
         self.transform.apply(im.getim(), imOut.getim())
@@ -357,7 +356,6 @@ def apply(self, im: Image.Image, imOut: Image.Image | None = None) -> Image.Imag
         return imOut
 
     def apply_in_place(self, im: Image.Image) -> Image.Image:
-        im.load()
         if im.mode != self.output_mode:
             msg = "mode mismatch"
             raise ValueError(msg)  # wrong output mode
diff --git a/src/PIL/ImageMath.py b/src/PIL/ImageMath.py
index ff3014a8d5a..773147b5343 100644
--- a/src/PIL/ImageMath.py
+++ b/src/PIL/ImageMath.py
@@ -59,7 +59,6 @@ def apply(
         if im2 is None:
             # unary operation
             out = Image.new(mode or im_1.mode, im_1.size, None)
-            im_1.load()
             try:
                 op = getattr(_imagingmath, f"{op}_{im_1.mode}")
             except AttributeError as e:
@@ -86,7 +85,6 @@ def apply(
                 if im_2.size != size:
                     im_2 = im_2.crop((0, 0) + size)
             out = Image.new(mode or im_1.mode, im_1.size, None)
-            im_1.load()
             try:
                 op = getattr(_imagingmath, f"{op}_{im_1.mode}")
             except AttributeError as e:

From d1f40a94ffe783aceb7050d85fa5c17ecc4961a7 Mon Sep 17 00:00:00 2001
From: Aleksandr Karpinskii <homm86@gmail.com>
Date: Mon, 16 Sep 2024 10:52:06 +0200
Subject: [PATCH 1067/1178] Use Image.getim() instead of ImagingCore.ptr

---
 src/PIL/WebPImagePlugin.py | 5 ++---
 1 file changed, 2 insertions(+), 3 deletions(-)

diff --git a/src/PIL/WebPImagePlugin.py b/src/PIL/WebPImagePlugin.py
index 8251316d3d4..ab545563f7f 100644
--- a/src/PIL/WebPImagePlugin.py
+++ b/src/PIL/WebPImagePlugin.py
@@ -239,7 +239,6 @@ def _save_all(im: Image.Image, fp: IO[bytes], filename: str | bytes) -> None:
 
             for idx in range(nfr):
                 ims.seek(idx)
-                ims.load()
 
                 # Make sure image mode is supported
                 frame = ims
@@ -248,7 +247,7 @@ def _save_all(im: Image.Image, fp: IO[bytes], filename: str | bytes) -> None:
 
                 # Append the frame to the animation encoder
                 enc.add(
-                    frame.im.ptr,
+                    frame.getim(),
                     round(timestamp),
                     lossless,
                     quality,
@@ -296,7 +295,7 @@ def _save(im: Image.Image, fp: IO[bytes], filename: str | bytes) -> None:
         im = im.convert("RGBA" if im.has_transparency_data else "RGB")
 
     data = _webp.WebPEncode(
-        im.im.ptr,
+        im.getim(),
         lossless,
         float(quality),
         float(alpha_quality),

From 31d36e6b70e1e835bcc6d70f363cda49d3bc9e98 Mon Sep 17 00:00:00 2001
From: Aleksandr Karpinskii <homm86@gmail.com>
Date: Mon, 16 Sep 2024 11:04:00 +0200
Subject: [PATCH 1068/1178] Use current frame for transparency detection

---
 Tests/test_file_webp.py    | 2 +-
 src/PIL/WebPImagePlugin.py | 4 +++-
 2 files changed, 4 insertions(+), 2 deletions(-)

diff --git a/Tests/test_file_webp.py b/Tests/test_file_webp.py
index 719831db9fb..e7c88727966 100644
--- a/Tests/test_file_webp.py
+++ b/Tests/test_file_webp.py
@@ -208,7 +208,7 @@ def test_invalid_background(
 
     def test_background_from_gif(self, tmp_path: Path) -> None:
         out_webp = tmp_path / "temp.webp"
-        
+
         # Save L mode GIF with background
         with Image.open("Tests/images/no_palette_with_background.gif") as im:
             im.save(out_webp, save_all=True)
diff --git a/src/PIL/WebPImagePlugin.py b/src/PIL/WebPImagePlugin.py
index ab545563f7f..1a714d7ea34 100644
--- a/src/PIL/WebPImagePlugin.py
+++ b/src/PIL/WebPImagePlugin.py
@@ -243,7 +243,9 @@ def _save_all(im: Image.Image, fp: IO[bytes], filename: str | bytes) -> None:
                 # Make sure image mode is supported
                 frame = ims
                 if frame.mode not in ("RGBX", "RGBA", "RGB"):
-                    frame = frame.convert("RGBA" if im.has_transparency_data else "RGB")
+                    frame = frame.convert(
+                        "RGBA" if frame.has_transparency_data else "RGB"
+                    )
 
                 # Append the frame to the animation encoder
                 enc.add(

From bc973690397a075b94f694ee1cb3f3392fff9cdc Mon Sep 17 00:00:00 2001
From: Aleksandr Karpinskii <homm86@gmail.com>
Date: Mon, 16 Sep 2024 15:45:34 +0200
Subject: [PATCH 1069/1178] Increase reference to the image while capsule is
 alive

---
 src/_imaging.c | 11 ++++++++++-
 1 file changed, 10 insertions(+), 1 deletion(-)

diff --git a/src/_imaging.c b/src/_imaging.c
index e227d8efc51..9422c42bfaf 100644
--- a/src/_imaging.c
+++ b/src/_imaging.c
@@ -3714,9 +3714,18 @@ _getattr_id(ImagingObject *self, void *closure) {
     return PyLong_FromSsize_t((Py_ssize_t)self->image);
 }
 
+static void
+_ptr_destructor(PyObject *capsule) {
+    PyObject *self = (PyObject *)PyCapsule_GetContext(capsule);
+    Py_DECREF(self);
+}
+
 static PyObject *
 _getattr_ptr(ImagingObject *self, void *closure) {
-    return PyCapsule_New(self->image, IMAGING_MAGIC, NULL);
+    PyObject *capsule = PyCapsule_New(self->image, IMAGING_MAGIC, _ptr_destructor);
+    Py_INCREF(self);
+    PyCapsule_SetContext(capsule, self);
+    return capsule;
 }
 
 static PyObject *

From 1d5b330758c1e9210a8c00c457b03a1f19903939 Mon Sep 17 00:00:00 2001
From: Aleksandr Karpinskii <homm86@gmail.com>
Date: Mon, 16 Sep 2024 15:37:57 +0200
Subject: [PATCH 1070/1178] Move common conversion in _convert_frame

---
 src/PIL/WebPImagePlugin.py | 17 +++++++++--------
 1 file changed, 9 insertions(+), 8 deletions(-)

diff --git a/src/PIL/WebPImagePlugin.py b/src/PIL/WebPImagePlugin.py
index 1a714d7ea34..64188f28cb3 100644
--- a/src/PIL/WebPImagePlugin.py
+++ b/src/PIL/WebPImagePlugin.py
@@ -149,6 +149,13 @@ def tell(self) -> int:
         return self.__logical_frame
 
 
+def _convert_frame(im: Image.Image) -> Image.Image:
+    # Make sure image mode is supported
+    if im.mode not in ("RGBX", "RGBA", "RGB"):
+        im = im.convert("RGBA" if im.has_transparency_data else "RGB")
+    return im
+
+
 def _save_all(im: Image.Image, fp: IO[bytes], filename: str | bytes) -> None:
     encoderinfo = im.encoderinfo.copy()
     append_images = list(encoderinfo.get("append_images", []))
@@ -240,12 +247,7 @@ def _save_all(im: Image.Image, fp: IO[bytes], filename: str | bytes) -> None:
             for idx in range(nfr):
                 ims.seek(idx)
 
-                # Make sure image mode is supported
-                frame = ims
-                if frame.mode not in ("RGBX", "RGBA", "RGB"):
-                    frame = frame.convert(
-                        "RGBA" if frame.has_transparency_data else "RGB"
-                    )
+                frame = _convert_frame(ims)
 
                 # Append the frame to the animation encoder
                 enc.add(
@@ -293,8 +295,7 @@ def _save(im: Image.Image, fp: IO[bytes], filename: str | bytes) -> None:
     method = im.encoderinfo.get("method", 4)
     exact = 1 if im.encoderinfo.get("exact") else 0
 
-    if im.mode not in ("RGBX", "RGBA", "RGB"):
-        im = im.convert("RGBA" if im.has_transparency_data else "RGB")
+    im = _convert_frame(im)
 
     data = _webp.WebPEncode(
         im.getim(),

From a988750595af555e07af0e937ab6f6697a5bb1e1 Mon Sep 17 00:00:00 2001
From: Aleksandr Karpinskii <homm86@gmail.com>
Date: Mon, 16 Sep 2024 16:37:39 +0200
Subject: [PATCH 1071/1178] Try fix bigendian

---
 src/_webp.c | 22 +++++++++++++---------
 1 file changed, 13 insertions(+), 9 deletions(-)

diff --git a/src/_webp.c b/src/_webp.c
index 9717b9bc0d1..92d5c20fec5 100644
--- a/src/_webp.c
+++ b/src/_webp.c
@@ -89,7 +89,7 @@ HandleMuxError(WebPMuxError err, char *chunk) {
 
 static int
 import_frame_libwebp(WebPPicture *frame, Imaging im) {
-    UINT32 mask = 0;
+    int drop_alpha = strcmp(im->mode, "RGBA");
 
     if (strcmp(im->mode, "RGBA") && strcmp(im->mode, "RGB") &&
         strcmp(im->mode, "RGBX")) {
@@ -97,10 +97,6 @@ import_frame_libwebp(WebPPicture *frame, Imaging im) {
         return -1;
     }
 
-    if (strcmp(im->mode, "RGBA")) {
-        mask = MASK_UINT32_CHANNEL_3;
-    }
-
     frame->width = im->xsize;
     frame->height = im->ysize;
     frame->use_argb = 1;  // Don't convert RGB pixels to YUV
@@ -113,10 +109,18 @@ import_frame_libwebp(WebPPicture *frame, Imaging im) {
     for (int y = 0; y < im->ysize; ++y) {
         UINT8 *src = (UINT8 *)im->image32[y];
         UINT32 *dst = frame->argb + frame->argb_stride * y;
-        for (int x = 0; x < im->xsize; ++x) {
-            UINT32 pix =
-                MAKE_UINT32(src[x * 4 + 2], src[x * 4 + 1], src[x * 4], src[x * 4 + 3]);
-            dst[x] = pix | mask;
+        if (drop_alpha) {
+            for (int x = 0; x < im->xsize; ++x) {
+                dst[x] =
+                    ((UINT32)(src[x * 4 + 2]) | ((UINT32)(src[x * 4 + 1]) << 8) |
+                     ((UINT32)(src[x * 4]) << 16) | (0xff << 24));
+            }
+        } else {
+            for (int x = 0; x < im->xsize; ++x) {
+                dst[x] =
+                    ((UINT32)(src[x * 4 + 2]) | ((UINT32)(src[x * 4 + 1]) << 8) |
+                     ((UINT32)(src[x * 4]) << 16) | ((UINT32)(src[x * 4 + 3]) << 24));
+            }
         }
     }
 

From 75e4d5a10d171b9f101f09a671826f3f302139cb Mon Sep 17 00:00:00 2001
From: "renovate[bot]" <29139614+renovate[bot]@users.noreply.github.com>
Date: Tue, 17 Sep 2024 06:12:03 +0000
Subject: [PATCH 1072/1178] Update dependency cibuildwheel to v2.21.1

---
 .ci/requirements-cibw.txt | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/.ci/requirements-cibw.txt b/.ci/requirements-cibw.txt
index 210f29d3a0c..7dc3a53fe4d 100644
--- a/.ci/requirements-cibw.txt
+++ b/.ci/requirements-cibw.txt
@@ -1 +1 @@
-cibuildwheel==2.21.0
+cibuildwheel==2.21.1

From f1e86965f6f791bf1af57f4d202a0c342221190b Mon Sep 17 00:00:00 2001
From: Andrew Murray <radarhere@users.noreply.github.com>
Date: Wed, 18 Sep 2024 20:26:06 +1000
Subject: [PATCH 1073/1178] Use transposed size after opening for TIFF images

---
 Tests/test_image_copy.py      |  2 ++
 Tests/test_image_resize.py    |  4 +---
 Tests/test_image_thumbnail.py |  8 +++-----
 Tests/test_numpy.py           |  4 +++-
 src/PIL/Image.py              | 20 +++++---------------
 src/PIL/ImageFile.py          |  2 +-
 src/PIL/TiffImagePlugin.py    | 16 +++++++++++++++-
 7 files changed, 30 insertions(+), 26 deletions(-)

diff --git a/Tests/test_image_copy.py b/Tests/test_image_copy.py
index 027e5338b7a..a0b829cc565 100644
--- a/Tests/test_image_copy.py
+++ b/Tests/test_image_copy.py
@@ -49,5 +49,7 @@ def test_copy_zero() -> None:
 @skip_unless_feature("libtiff")
 def test_deepcopy() -> None:
     with Image.open("Tests/images/g4_orientation_5.tif") as im:
+        assert im.size == (590, 88)
+
         out = copy.deepcopy(im)
     assert out.size == (590, 88)
diff --git a/Tests/test_image_resize.py b/Tests/test_image_resize.py
index c9e3045121f..d9ddf500913 100644
--- a/Tests/test_image_resize.py
+++ b/Tests/test_image_resize.py
@@ -300,9 +300,7 @@ def resize(mode: str, size: tuple[int, int] | list[int]) -> None:
                 im.resize((10, 10), "unknown")
 
     @skip_unless_feature("libtiff")
-    def test_load_first(self) -> None:
-        # load() may change the size of the image
-        # Test that resize() is calling it before getting the size
+    def test_transposed(self) -> None:
         with Image.open("Tests/images/g4_orientation_5.tif") as im:
             im = im.resize((64, 64))
             assert im.size == (64, 64)
diff --git a/Tests/test_image_thumbnail.py b/Tests/test_image_thumbnail.py
index bdbf09c407e..01bd4b1d76b 100644
--- a/Tests/test_image_thumbnail.py
+++ b/Tests/test_image_thumbnail.py
@@ -92,15 +92,13 @@ def test_no_resize() -> None:
 
 
 @skip_unless_feature("libtiff")
-def test_load_first() -> None:
-    # load() may change the size of the image
-    # Test that thumbnail() is calling it before performing size calculations
+def test_transposed() -> None:
     with Image.open("Tests/images/g4_orientation_5.tif") as im:
+        assert im.size == (590, 88)
+
         im.thumbnail((64, 64))
         assert im.size == (64, 10)
 
-    # Test thumbnail(), without draft(),
-    # on an image that is large enough once load() has changed the size
     with Image.open("Tests/images/g4_orientation_5.tif") as im:
         im.thumbnail((590, 88), reducing_gap=None)
         assert im.size == (590, 88)
diff --git a/Tests/test_numpy.py b/Tests/test_numpy.py
index 312e32e0ca7..040472d69e3 100644
--- a/Tests/test_numpy.py
+++ b/Tests/test_numpy.py
@@ -238,8 +238,10 @@ def test_zero_size() -> None:
 
 
 @skip_unless_feature("libtiff")
-def test_load_first() -> None:
+def test_transposed() -> None:
     with Image.open("Tests/images/g4_orientation_5.tif") as im:
+        assert im.size == (590, 88)
+
         a = numpy.array(im)
         assert a.shape == (88, 590)
 
diff --git a/src/PIL/Image.py b/src/PIL/Image.py
index f88cdf6e2f7..3f94cef3892 100644
--- a/src/PIL/Image.py
+++ b/src/PIL/Image.py
@@ -2332,7 +2332,6 @@ def resize(
             msg = "reducing_gap must be 1.0 or greater"
             raise ValueError(msg)
 
-        self.load()
         if box is None:
             box = (0, 0) + self.size
 
@@ -2781,27 +2780,18 @@ def round_aspect(number: float, key: Callable[[int], float]) -> int:
                 )
             return x, y
 
+        preserved_size = preserve_aspect_ratio()
+        if preserved_size is None:
+            return
+        final_size = preserved_size
+
         box = None
-        final_size: tuple[int, int]
         if reducing_gap is not None:
-            preserved_size = preserve_aspect_ratio()
-            if preserved_size is None:
-                return
-            final_size = preserved_size
-
             res = self.draft(
                 None, (int(size[0] * reducing_gap), int(size[1] * reducing_gap))
             )
             if res is not None:
                 box = res[1]
-        if box is None:
-            self.load()
-
-            # load() may have changed the size of the image
-            preserved_size = preserve_aspect_ratio()
-            if preserved_size is None:
-                return
-            final_size = preserved_size
 
         if self.size != final_size:
             im = self.resize(final_size, resample, box=box, reducing_gap=reducing_gap)
diff --git a/src/PIL/ImageFile.py b/src/PIL/ImageFile.py
index b8bf0b7fe90..721319fd7bf 100644
--- a/src/PIL/ImageFile.py
+++ b/src/PIL/ImageFile.py
@@ -322,7 +322,7 @@ def load(self) -> Image.core.PixelAccess | None:
 
     def load_prepare(self) -> None:
         # create image memory if necessary
-        if self._im is None or self.im.mode != self.mode or self.im.size != self.size:
+        if self._im is None or self.im.mode != self.mode:
             self.im = Image.core.new(self.mode, self.size)
         # create palette (optional)
         if self.mode == "P":
diff --git a/src/PIL/TiffImagePlugin.py b/src/PIL/TiffImagePlugin.py
index cc16cbfb083..28e50474471 100644
--- a/src/PIL/TiffImagePlugin.py
+++ b/src/PIL/TiffImagePlugin.py
@@ -1275,6 +1275,11 @@ def load(self) -> Image.core.PixelAccess | None:
             return self._load_libtiff()
         return super().load()
 
+    def load_prepare(self) -> None:
+        if self._im is None and self._will_be_transposed:
+            self.im = Image.core.new(self.mode, self.size[::-1])
+        ImageFile.ImageFile.load_prepare(self)
+
     def load_end(self) -> None:
         # allow closing if we're on the first frame, there's no next
         # This is the ImageFile.load path only, libtiff specific below.
@@ -1416,7 +1421,16 @@ def _setup(self) -> None:
         if not isinstance(xsize, int) or not isinstance(ysize, int):
             msg = "Invalid dimensions"
             raise ValueError(msg)
-        self._size = xsize, ysize
+        self._will_be_transposed = self.tag_v2.get(ExifTags.Base.Orientation) in (
+            5,
+            6,
+            7,
+            8,
+        )
+        if self._will_be_transposed:
+            self._size = ysize, xsize
+        else:
+            self._size = xsize, ysize
 
         logger.debug("- size: %s", self.size)
 

From 84e275d90629bfdf508f81a1142eddd5d5ea46e4 Mon Sep 17 00:00:00 2001
From: Andrew Murray <radarhere@users.noreply.github.com>
Date: Wed, 18 Sep 2024 20:27:35 +1000
Subject: [PATCH 1074/1178] Loading does not change mode

---
 src/PIL/ImageFile.py | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/src/PIL/ImageFile.py b/src/PIL/ImageFile.py
index 721319fd7bf..d69d8456850 100644
--- a/src/PIL/ImageFile.py
+++ b/src/PIL/ImageFile.py
@@ -322,7 +322,7 @@ def load(self) -> Image.core.PixelAccess | None:
 
     def load_prepare(self) -> None:
         # create image memory if necessary
-        if self._im is None or self.im.mode != self.mode:
+        if self._im is None:
             self.im = Image.core.new(self.mode, self.size)
         # create palette (optional)
         if self.mode == "P":

From 9135fd0fb24607510f38b5fa4b1b4d279974363a Mon Sep 17 00:00:00 2001
From: Andrew Murray <radarhere@users.noreply.github.com>
Date: Wed, 18 Sep 2024 20:56:55 +1000
Subject: [PATCH 1075/1178] Mention limit in error message

---
 src/PIL/PngImagePlugin.py | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/src/PIL/PngImagePlugin.py b/src/PIL/PngImagePlugin.py
index c268d7b1a28..28ade293e96 100644
--- a/src/PIL/PngImagePlugin.py
+++ b/src/PIL/PngImagePlugin.py
@@ -140,7 +140,7 @@ def _safe_zlib_decompress(s: bytes) -> bytes:
     dobj = zlib.decompressobj()
     plaintext = dobj.decompress(s, MAX_TEXT_CHUNK)
     if dobj.unconsumed_tail:
-        msg = "Decompressed Data Too Large"
+        msg = "Decompressed data too large for PngImagePlugin.MAX_TEXT_CHUNK"
         raise ValueError(msg)
     return plaintext
 

From a859695d9a0bf9d9dc20ef7c053909658a12df6a Mon Sep 17 00:00:00 2001
From: Andrew Murray <3112309+radarhere@users.noreply.github.com>
Date: Wed, 18 Sep 2024 21:17:49 +1000
Subject: [PATCH 1076/1178] Rearranged code

Co-authored-by: Alexander Karpinsky <homm86@gmail.com>
---
 src/PIL/TiffImagePlugin.py | 8 ++------
 1 file changed, 2 insertions(+), 6 deletions(-)

diff --git a/src/PIL/TiffImagePlugin.py b/src/PIL/TiffImagePlugin.py
index 28e50474471..437f7d98bd7 100644
--- a/src/PIL/TiffImagePlugin.py
+++ b/src/PIL/TiffImagePlugin.py
@@ -1421,12 +1421,8 @@ def _setup(self) -> None:
         if not isinstance(xsize, int) or not isinstance(ysize, int):
             msg = "Invalid dimensions"
             raise ValueError(msg)
-        self._will_be_transposed = self.tag_v2.get(ExifTags.Base.Orientation) in (
-            5,
-            6,
-            7,
-            8,
-        )
+        orientation = self.tag_v2.get(ExifTags.Base.Orientation)
+        self._will_be_transposed = orientation in (5, 6, 7, 8)
         if self._will_be_transposed:
             self._size = ysize, xsize
         else:

From a92dca66bdeb26106447079fcf2d36bc397298c2 Mon Sep 17 00:00:00 2001
From: Andrew Murray <radarhere@users.noreply.github.com>
Date: Wed, 18 Sep 2024 21:22:59 +1000
Subject: [PATCH 1077/1178] Use raw size for striped tiles

---
 src/PIL/TiffImagePlugin.py | 6 +++---
 1 file changed, 3 insertions(+), 3 deletions(-)

diff --git a/src/PIL/TiffImagePlugin.py b/src/PIL/TiffImagePlugin.py
index 437f7d98bd7..c024e57fce4 100644
--- a/src/PIL/TiffImagePlugin.py
+++ b/src/PIL/TiffImagePlugin.py
@@ -1569,7 +1569,7 @@ def _setup(self) -> None:
             if STRIPOFFSETS in self.tag_v2:
                 offsets = self.tag_v2[STRIPOFFSETS]
                 h = self.tag_v2.get(ROWSPERSTRIP, ysize)
-                w = self.size[0]
+                w = xsize
             else:
                 # tiled image
                 offsets = self.tag_v2[TILEOFFSETS]
@@ -1603,9 +1603,9 @@ def _setup(self) -> None:
                     )
                 )
                 x = x + w
-                if x >= self.size[0]:
+                if x >= xsize:
                     x, y = 0, y + h
-                    if y >= self.size[1]:
+                    if y >= ysize:
                         x = y = 0
                         layer += 1
         else:

From 629f5be52eb9043d70b5d5467f10a07ad3a68cdf Mon Sep 17 00:00:00 2001
From: Andrew Murray <radarhere@users.noreply.github.com>
Date: Wed, 18 Sep 2024 22:56:29 +1000
Subject: [PATCH 1078/1178] In seek(), create core image at size needed for
 loading

---
 src/PIL/TiffImagePlugin.py | 12 ++++++------
 1 file changed, 6 insertions(+), 6 deletions(-)

diff --git a/src/PIL/TiffImagePlugin.py b/src/PIL/TiffImagePlugin.py
index c024e57fce4..14e6ea2786e 100644
--- a/src/PIL/TiffImagePlugin.py
+++ b/src/PIL/TiffImagePlugin.py
@@ -1194,8 +1194,8 @@ def seek(self, frame: int) -> None:
         # Create a new core image object on second and
         # subsequent frames in the image. Image may be
         # different size/mode.
-        Image._decompression_bomb_check(self.size)
-        self.im = Image.core.new(self.mode, self.size)
+        Image._decompression_bomb_check(self._tile_size)
+        self.im = Image.core.new(self.mode, self._tile_size)
 
     def _seek(self, frame: int) -> None:
         self.fp = self._fp
@@ -1276,8 +1276,8 @@ def load(self) -> Image.core.PixelAccess | None:
         return super().load()
 
     def load_prepare(self) -> None:
-        if self._im is None and self._will_be_transposed:
-            self.im = Image.core.new(self.mode, self.size[::-1])
+        if self._im is None:
+            self.im = Image.core.new(self.mode, self._tile_size)
         ImageFile.ImageFile.load_prepare(self)
 
     def load_end(self) -> None:
@@ -1421,9 +1421,9 @@ def _setup(self) -> None:
         if not isinstance(xsize, int) or not isinstance(ysize, int):
             msg = "Invalid dimensions"
             raise ValueError(msg)
+        self._tile_size = xsize, ysize
         orientation = self.tag_v2.get(ExifTags.Base.Orientation)
-        self._will_be_transposed = orientation in (5, 6, 7, 8)
-        if self._will_be_transposed:
+        if orientation in (5, 6, 7, 8):
             self._size = ysize, xsize
         else:
             self._size = xsize, ysize

From 9adb476f37f28cd4a27bb66c6242e4d11925b53b Mon Sep 17 00:00:00 2001
From: Andrew Murray <3112309+radarhere@users.noreply.github.com>
Date: Wed, 18 Sep 2024 23:58:23 +1000
Subject: [PATCH 1079/1178] Rearranged text

---
 src/PIL/ImageFont.py | 8 ++++----
 1 file changed, 4 insertions(+), 4 deletions(-)

diff --git a/src/PIL/ImageFont.py b/src/PIL/ImageFont.py
index 70cd57de7be..b694b817e65 100644
--- a/src/PIL/ImageFont.py
+++ b/src/PIL/ImageFont.py
@@ -808,10 +808,10 @@ def truetype(
 ) -> FreeTypeFont:
     """
     Load a TrueType or OpenType font from a file or file-like object,
-    and create a font object. For loading bitmap fonts instead,
-    see :py:func:`~PIL.ImageFont.load` and :py:func:`~PIL.ImageFont.load_path`.
-    This function loads a font object from the given file or file-like
-    object, and creates a font object for a font of the given size.
+    and create a font object. This function loads a font object from the given
+    file or file-like object, and creates a font object for a font of the given
+    size. For loading bitmap fonts instead, see :py:func:`~PIL.ImageFont.load`
+    and :py:func:`~PIL.ImageFont.load_path`.
 
     Pillow uses FreeType to open font files. On Windows, be aware that FreeType
     will keep the file open as long as the FreeTypeFont object exists. Windows

From e33d8bb32bd04c5b29afa3dca52bce9cb2bbffbd Mon Sep 17 00:00:00 2001
From: Hugo van Kemenade <1324225+hugovk@users.noreply.github.com>
Date: Wed, 18 Sep 2024 18:19:53 +0300
Subject: [PATCH 1080/1178] Generate and upload attestations to PyPI

---
 .github/workflows/wheels.yml | 2 ++
 1 file changed, 2 insertions(+)

diff --git a/.github/workflows/wheels.yml b/.github/workflows/wheels.yml
index 11564c14256..35ea0496d89 100644
--- a/.github/workflows/wheels.yml
+++ b/.github/workflows/wheels.yml
@@ -296,3 +296,5 @@ jobs:
           merge-multiple: true
       - name: Publish to PyPI
         uses: pypa/gh-action-pypi-publish@release/v1
+        with:
+          attestations: true

From 362ffaf9b7f063609bcd02ef30b1288e16e99cd1 Mon Sep 17 00:00:00 2001
From: Yay295 <Yay295@gmail.com>
Date: Sun, 18 Aug 2024 20:39:14 -0500
Subject: [PATCH 1081/1178] implement tiff exif multistrip support

---
 Tests/test_file_tiff.py          |  3 ++-
 Tests/test_file_tiff_metadata.py | 22 ++++++++++++++++++++++
 src/PIL/TiffImagePlugin.py       |  8 +++++---
 3 files changed, 29 insertions(+), 4 deletions(-)

diff --git a/Tests/test_file_tiff.py b/Tests/test_file_tiff.py
index 190f83f40fc..44da25295ef 100644
--- a/Tests/test_file_tiff.py
+++ b/Tests/test_file_tiff.py
@@ -108,7 +108,8 @@ def test_bigtiff(self, tmp_path: Path) -> None:
             assert_image_equal_tofile(im, "Tests/images/hopper.tif")
 
         with Image.open("Tests/images/hopper_bigtiff.tif") as im:
-            # multistrip support not yet implemented
+            # The data type of this file's StripOffsets tag is LONG8,
+            # which is not yet supported for offset data when saving multiple frames.
             del im.tag_v2[273]
 
             outfile = str(tmp_path / "temp.tif")
diff --git a/Tests/test_file_tiff_metadata.py b/Tests/test_file_tiff_metadata.py
index 1e0310001a5..00fe745cf59 100644
--- a/Tests/test_file_tiff_metadata.py
+++ b/Tests/test_file_tiff_metadata.py
@@ -181,6 +181,28 @@ def test_change_stripbytecounts_tag_type(tmp_path: Path) -> None:
         assert reloaded.tag_v2.tagtype[TiffImagePlugin.STRIPBYTECOUNTS] == TiffTags.LONG
 
 
+def test_save_multiple_stripoffsets() -> None:
+    ifd = TiffImagePlugin.ImageFileDirectory_v2()
+    ifd[TiffImagePlugin.STRIPOFFSETS] = (123, 456)
+    assert ifd.tagtype[TiffImagePlugin.STRIPOFFSETS] == TiffTags.LONG
+
+    # all values are in little-endian
+    assert ifd.tobytes() == (
+        # number of tags == 1
+        b"\x01\x00"
+        # tag id (2 bytes), type (2 bytes), count (4 bytes), value (4 bytes)
+        # == 273, 4, 2, 18
+        # == TiffImagePlugin.STRIPOFFSETS, TiffTags.LONG, 2, 18
+        # the value is the index of the tag data
+        b"\x11\x01\x04\x00\x02\x00\x00\x00\x12\x00\x00\x00"
+        # end of tags marker
+        b"\x00\x00\x00\x00"
+        # tag data == (149, 482) == (123 + 26, 456 + 26)
+        # 26 is the number of bytes before this data
+        b"\x95\x00\x00\x00\xe2\x01\x00\x00"
+    )
+
+
 def test_no_duplicate_50741_tag() -> None:
     assert TAG_IDS["MakerNoteSafety"] == 50741
     assert TAG_IDS["BestQualityScale"] == 50780
diff --git a/src/PIL/TiffImagePlugin.py b/src/PIL/TiffImagePlugin.py
index 14e6ea2786e..d4c46a79778 100644
--- a/src/PIL/TiffImagePlugin.py
+++ b/src/PIL/TiffImagePlugin.py
@@ -991,9 +991,11 @@ def tobytes(self, offset: int = 0) -> bytes:
         if stripoffsets is not None:
             tag, typ, count, value, data = entries[stripoffsets]
             if data:
-                msg = "multistrip support not yet implemented"
-                raise NotImplementedError(msg)
-            value = self._pack("L", self._unpack("L", value)[0] + offset)
+                size, handler = self._load_dispatch[typ]
+                values = [val + offset for val in handler(self, data, self.legacy_api)]
+                data = self._write_dispatch[typ](self, *values)
+            else:
+                value = self._pack("L", self._unpack("L", value)[0] + offset)
             entries[stripoffsets] = tag, typ, count, value, data
 
         # pass 2: write entries to file

From 1392eab89b9c7e6bbc1fa5a1d3af2434bcb04e5d Mon Sep 17 00:00:00 2001
From: Andrew Murray <radarhere@users.noreply.github.com>
Date: Thu, 19 Sep 2024 09:21:23 +1000
Subject: [PATCH 1082/1178] Updated Ghostscript to 10.4.0

---
 .appveyor.yml                      | 4 ++--
 .github/workflows/test-windows.yml | 4 ++--
 2 files changed, 4 insertions(+), 4 deletions(-)

diff --git a/.appveyor.yml b/.appveyor.yml
index f490561cdcd..de5e527422d 100644
--- a/.appveyor.yml
+++ b/.appveyor.yml
@@ -34,8 +34,8 @@ install:
 - xcopy /S /Y c:\test-images-main\* c:\pillow\tests\images
 - curl -fsSL -o nasm-win64.zip https://raw.githubusercontent.com/python-pillow/pillow-depends/main/nasm-2.16.03-win64.zip
 - 7z x nasm-win64.zip -oc:\
-- choco install ghostscript --version=10.3.1
-- path c:\nasm-2.16.03;C:\Program Files\gs\gs10.03.1\bin;%PATH%
+- choco install ghostscript --version=10.4.0
+- path c:\nasm-2.16.03;C:\Program Files\gs\gs10.04.0\bin;%PATH%
 - cd c:\pillow\winbuild\
 - ps: |
         c:\python39\python.exe c:\pillow\winbuild\build_prepare.py -v --depends=C:\pillow-depends\
diff --git a/.github/workflows/test-windows.yml b/.github/workflows/test-windows.yml
index f58e8dae3a6..13147d86ba5 100644
--- a/.github/workflows/test-windows.yml
+++ b/.github/workflows/test-windows.yml
@@ -86,8 +86,8 @@ jobs:
         choco install nasm --no-progress
         echo "C:\Program Files\NASM" >> $env:GITHUB_PATH
 
-        choco install ghostscript --version=10.3.1 --no-progress
-        echo "C:\Program Files\gs\gs10.03.1\bin" >> $env:GITHUB_PATH
+        choco install ghostscript --version=10.4.0 --no-progress
+        echo "C:\Program Files\gs\gs10.04.0\bin" >> $env:GITHUB_PATH
 
         # Install extra test images
         xcopy /S /Y Tests\test-images\* Tests\images

From 0f47ecd4325268156c27fa86799d31829f31fcea Mon Sep 17 00:00:00 2001
From: Andrew Murray <radarhere@users.noreply.github.com>
Date: Thu, 19 Sep 2024 15:07:06 +1000
Subject: [PATCH 1083/1178] Update CHANGES.rst [ci skip]

---
 CHANGES.rst | 12 ++++++++++++
 1 file changed, 12 insertions(+)

diff --git a/CHANGES.rst b/CHANGES.rst
index f23ec609fa4..4ab9eaf2bd8 100644
--- a/CHANGES.rst
+++ b/CHANGES.rst
@@ -5,6 +5,18 @@ Changelog (Pillow)
 11.0.0 (unreleased)
 -------------------
 
+- Use transposed size after opening for TIFF images #8390
+  [radarhere, homm]
+
+- Improve ImageFont error messages #8338
+  [yngvem, radarhere, hugovk]
+
+- Mention MAX_TEXT_CHUNK limit in PNG error message #8391
+  [radarhere]
+
+- Cast Dib handle to int #8385
+  [radarhere]
+
 - Accept float stroke widths #8369
   [radarhere]
 

From 46f2fa17be9768ec2647988b0446dd848b833a5b Mon Sep 17 00:00:00 2001
From: PavlNekrasov <95914807+PavlNekrasov@users.noreply.github.com>
Date: Thu, 19 Sep 2024 22:53:45 +0300
Subject: [PATCH 1084/1178] fix dereference before checking for NULL  in the
 `ImagingTransformAffine` function

The `imIn` pointer is checked for `NULL`, but it seems to be dereferenced before this check. You must first make sure that the pointer is not `NULL` before using it.
---
 src/libImaging/Geometry.c | 8 ++++----
 1 file changed, 4 insertions(+), 4 deletions(-)

diff --git a/src/libImaging/Geometry.c b/src/libImaging/Geometry.c
index 2bfeed7b6c6..264c7d1691f 100644
--- a/src/libImaging/Geometry.c
+++ b/src/libImaging/Geometry.c
@@ -1035,6 +1035,10 @@ ImagingTransformAffine(
     double xx, yy;
     double xo, yo;
 
+    if (!imOut || !imIn || strcmp(imIn->mode, imOut->mode) != 0) {
+        return (Imaging)ImagingError_ModeError();
+    }    
+
     if (filterid || imIn->type == IMAGING_TYPE_SPECIAL) {
         return ImagingGenericTransform(
             imOut, imIn, x0, y0, x1, y1, affine_transform, a, filterid, fill
@@ -1046,10 +1050,6 @@ ImagingTransformAffine(
         return ImagingScaleAffine(imOut, imIn, x0, y0, x1, y1, a, fill);
     }
 
-    if (!imOut || !imIn || strcmp(imIn->mode, imOut->mode) != 0) {
-        return (Imaging)ImagingError_ModeError();
-    }
-
     if (x0 < 0) {
         x0 = 0;
     }

From 9424b1a8920201b52086c0b06b5148db33255668 Mon Sep 17 00:00:00 2001
From: "pre-commit-ci[bot]"
 <66853113+pre-commit-ci[bot]@users.noreply.github.com>
Date: Thu, 19 Sep 2024 19:59:08 +0000
Subject: [PATCH 1085/1178] [pre-commit.ci] auto fixes from pre-commit.com
 hooks

for more information, see https://pre-commit.ci
---
 src/libImaging/Geometry.c | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/src/libImaging/Geometry.c b/src/libImaging/Geometry.c
index 264c7d1691f..84aa442f067 100644
--- a/src/libImaging/Geometry.c
+++ b/src/libImaging/Geometry.c
@@ -1037,7 +1037,7 @@ ImagingTransformAffine(
 
     if (!imOut || !imIn || strcmp(imIn->mode, imOut->mode) != 0) {
         return (Imaging)ImagingError_ModeError();
-    }    
+    }
 
     if (filterid || imIn->type == IMAGING_TYPE_SPECIAL) {
         return ImagingGenericTransform(

From 693a68b2bb7fdf01bbafb7070320c16ec57ca78d Mon Sep 17 00:00:00 2001
From: Andrew Murray <radarhere@users.noreply.github.com>
Date: Fri, 20 Sep 2024 18:46:47 +1000
Subject: [PATCH 1086/1178] Updated link to OSS Fuzz issues

---
 README.md      | 2 +-
 docs/index.rst | 2 +-
 2 files changed, 2 insertions(+), 2 deletions(-)

diff --git a/README.md b/README.md
index b4c6d2987ff..5bbebaccb4a 100644
--- a/README.md
+++ b/README.md
@@ -51,7 +51,7 @@ As of 2019, Pillow development is
             <a href="https://app.codecov.io/gh/python-pillow/Pillow"><img
                 alt="Code coverage"
                 src="https://codecov.io/gh/python-pillow/Pillow/branch/main/graph/badge.svg"></a>
-            <a href="https://bugs.chromium.org/p/oss-fuzz/issues/list?sort=-opened&can=1&q=proj:pillow"><img
+            <a href="https://issues.oss-fuzz.com/issues?q=title:pillow"><img
                 alt="Fuzzing Status"
                 src="https://oss-fuzz-build-logs.storage.googleapis.com/badges/pillow.svg"></a>
         </td>
diff --git a/docs/index.rst b/docs/index.rst
index 3a12953f08b..18f5c3d13e7 100644
--- a/docs/index.rst
+++ b/docs/index.rst
@@ -54,7 +54,7 @@ Pillow for enterprise is available via the Tidelift Subscription. `Learn more <h
    :alt: Tidelift
 
 .. image:: https://oss-fuzz-build-logs.storage.googleapis.com/badges/pillow.svg
-   :target: https://bugs.chromium.org/p/oss-fuzz/issues/list?sort=-opened&can=1&q=proj:pillow
+   :target: https://issues.oss-fuzz.com/issues?q=title:pillow
    :alt: Fuzzing Status
 
 .. image:: https://img.shields.io/pypi/v/pillow.svg

From e57da68190ee685ae8aac898623d3c52963816d2 Mon Sep 17 00:00:00 2001
From: Andrew Murray <radarhere@users.noreply.github.com>
Date: Fri, 20 Sep 2024 19:20:53 +1000
Subject: [PATCH 1087/1178] Check image value before use

---
 src/libImaging/Geometry.c | 8 ++++----
 1 file changed, 4 insertions(+), 4 deletions(-)

diff --git a/src/libImaging/Geometry.c b/src/libImaging/Geometry.c
index 84aa442f067..1e2abd7e75c 100644
--- a/src/libImaging/Geometry.c
+++ b/src/libImaging/Geometry.c
@@ -791,15 +791,15 @@ ImagingGenericTransform(
     char *out;
     double xx, yy;
 
+    if (!imOut || !imIn || strcmp(imIn->mode, imOut->mode) != 0) {
+        return (Imaging)ImagingError_ModeError();
+    }
+
     ImagingTransformFilter filter = getfilter(imIn, filterid);
     if (!filter) {
         return (Imaging)ImagingError_ValueError("bad filter number");
     }
 
-    if (!imOut || !imIn || strcmp(imIn->mode, imOut->mode) != 0) {
-        return (Imaging)ImagingError_ModeError();
-    }
-
     ImagingCopyPalette(imOut, imIn);
 
     ImagingSectionEnter(&cookie);

From 8b6fa92cc885cbd1d7b0beb60aaad9ab47298cbf Mon Sep 17 00:00:00 2001
From: Yay295 <Yay295@users.noreply.github.com>
Date: Fri, 20 Sep 2024 08:39:11 -0500
Subject: [PATCH 1088/1178] rewrite some comments

Co-authored-by: Andrew Murray <3112309+radarhere@users.noreply.github.com>
---
 Tests/test_file_tiff_metadata.py | 13 +++++++------
 1 file changed, 7 insertions(+), 6 deletions(-)

diff --git a/Tests/test_file_tiff_metadata.py b/Tests/test_file_tiff_metadata.py
index 00fe745cf59..36aabf4f82c 100644
--- a/Tests/test_file_tiff_metadata.py
+++ b/Tests/test_file_tiff_metadata.py
@@ -191,14 +191,15 @@ def test_save_multiple_stripoffsets() -> None:
         # number of tags == 1
         b"\x01\x00"
         # tag id (2 bytes), type (2 bytes), count (4 bytes), value (4 bytes)
-        # == 273, 4, 2, 18
-        # == TiffImagePlugin.STRIPOFFSETS, TiffTags.LONG, 2, 18
-        # the value is the index of the tag data
+        # TiffImagePlugin.STRIPOFFSETS, TiffTags.LONG, 2, 18
+        # where STRIPOFFSETS is 273, LONG is 4
+        # and 18 is the offset of the tag data
         b"\x11\x01\x04\x00\x02\x00\x00\x00\x12\x00\x00\x00"
-        # end of tags marker
+        # end of entries
         b"\x00\x00\x00\x00"
-        # tag data == (149, 482) == (123 + 26, 456 + 26)
-        # 26 is the number of bytes before this data
+        # 26 is the total number of bytes output,
+        # the offset for any auxiliary strip data that will then be appended
+        # (123 + 26, 456 + 26) == (149, 482)
         b"\x95\x00\x00\x00\xe2\x01\x00\x00"
     )
 

From 83c7043471df575e446c44a4d384df56cd76538b Mon Sep 17 00:00:00 2001
From: Andrew Murray <radarhere@users.noreply.github.com>
Date: Sat, 21 Sep 2024 15:54:27 +1000
Subject: [PATCH 1089/1178] Rename variable, since alpha channel is not dropped

---
 src/_webp.c | 5 ++---
 1 file changed, 2 insertions(+), 3 deletions(-)

diff --git a/src/_webp.c b/src/_webp.c
index 92d5c20fec5..dfda7048de4 100644
--- a/src/_webp.c
+++ b/src/_webp.c
@@ -89,8 +89,6 @@ HandleMuxError(WebPMuxError err, char *chunk) {
 
 static int
 import_frame_libwebp(WebPPicture *frame, Imaging im) {
-    int drop_alpha = strcmp(im->mode, "RGBA");
-
     if (strcmp(im->mode, "RGBA") && strcmp(im->mode, "RGB") &&
         strcmp(im->mode, "RGBX")) {
         PyErr_SetString(PyExc_ValueError, "unsupported image mode");
@@ -106,10 +104,11 @@ import_frame_libwebp(WebPPicture *frame, Imaging im) {
         return -2;
     }
 
+    int ignore_fourth_channel = strcmp(im->mode, "RGBA");
     for (int y = 0; y < im->ysize; ++y) {
         UINT8 *src = (UINT8 *)im->image32[y];
         UINT32 *dst = frame->argb + frame->argb_stride * y;
-        if (drop_alpha) {
+        if (ignore_fourth_channel) {
             for (int x = 0; x < im->xsize; ++x) {
                 dst[x] =
                     ((UINT32)(src[x * 4 + 2]) | ((UINT32)(src[x * 4 + 1]) << 8) |

From 75cb1c1b87ae4be028f3e15141c14c28dd0d04a0 Mon Sep 17 00:00:00 2001
From: Andrew Murray <radarhere@users.noreply.github.com>
Date: Sat, 21 Sep 2024 16:02:23 +1000
Subject: [PATCH 1090/1178] Test unsupported image mode

---
 Tests/test_file_webp.py | 5 +++++
 1 file changed, 5 insertions(+)

diff --git a/Tests/test_file_webp.py b/Tests/test_file_webp.py
index e7c88727966..79f6bb4e0e4 100644
--- a/Tests/test_file_webp.py
+++ b/Tests/test_file_webp.py
@@ -127,6 +127,11 @@ def test_save_all(self, tmp_path: Path) -> None:
             reloaded.seek(1)
             assert_image_similar(im2, reloaded, 1)
 
+    def test_unsupported_image_mode(self) -> None:
+        im = Image.new("1", (1, 1))
+        with pytest.raises(ValueError):
+            _webp.WebPEncode(im.getim(), False, 0, 0, "", 4, 0, b"", "")
+
     def test_icc_profile(self, tmp_path: Path) -> None:
         self._roundtrip(tmp_path, self.rgb_mode, 12.5, {"icc_profile": None})
         self._roundtrip(

From aa22b241690e0c0084523bc7e4ea137d3596ee93 Mon Sep 17 00:00:00 2001
From: Andrew Murray <radarhere@users.noreply.github.com>
Date: Sat, 21 Sep 2024 16:22:50 +1000
Subject: [PATCH 1091/1178] Load before trying to catch exceptions

---
 Tests/test_imagemorph.py | 12 ++++++------
 1 file changed, 6 insertions(+), 6 deletions(-)

diff --git a/Tests/test_imagemorph.py b/Tests/test_imagemorph.py
index 9da32aa0124..6180a7b5d90 100644
--- a/Tests/test_imagemorph.py
+++ b/Tests/test_imagemorph.py
@@ -324,17 +324,17 @@ def test_set_lut() -> None:
 
 def test_wrong_mode() -> None:
     lut = ImageMorph.LutBuilder(op_name="corner").build_lut()
-    imrgb = Image.new("RGB", (10, 10))
-    iml = Image.new("L", (10, 10))
+    imrgb_ptr = Image.new("RGB", (10, 10)).getim()
+    iml_ptr = Image.new("L", (10, 10)).getim()
 
     with pytest.raises(RuntimeError):
-        _imagingmorph.apply(bytes(lut), imrgb.getim(), iml.getim())
+        _imagingmorph.apply(bytes(lut), imrgb_ptr, iml_ptr)
 
     with pytest.raises(RuntimeError):
-        _imagingmorph.apply(bytes(lut), iml.getim(), imrgb.getim())
+        _imagingmorph.apply(bytes(lut), iml_ptr, imrgb_ptr)
 
     with pytest.raises(RuntimeError):
-        _imagingmorph.match(bytes(lut), imrgb.getim())
+        _imagingmorph.match(bytes(lut), imrgb_ptr)
 
     # Should not raise
-    _imagingmorph.match(bytes(lut), iml.getim())
+    _imagingmorph.match(bytes(lut), iml_ptr)

From 5d430eab25a7695cdba79ddf250c40e1e10832da Mon Sep 17 00:00:00 2001
From: Andrew Murray <radarhere@users.noreply.github.com>
Date: Sat, 21 Sep 2024 16:24:54 +1000
Subject: [PATCH 1092/1178] Added release notes

---
 docs/releasenotes/11.0.0.rst | 10 ++++++++++
 1 file changed, 10 insertions(+)

diff --git a/docs/releasenotes/11.0.0.rst b/docs/releasenotes/11.0.0.rst
index 36334e39f5e..3194f1a5299 100644
--- a/docs/releasenotes/11.0.0.rst
+++ b/docs/releasenotes/11.0.0.rst
@@ -73,6 +73,16 @@ vulnerability introduced in FreeType 2.6 (:cve:`2020-15999`).
 
 .. _2.10.4: https://sourceforge.net/projects/freetype/files/freetype2/2.10.4/
 
+Get Internal Pointers to Objects
+^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
+
+.. deprecated:: 11.0.0
+
+``Image.core.ImagingCore.id`` and ``Image.core.ImagingCore.unsafe_ptrs`` have been
+deprecated and will be removed in Pillow 12 (2025-10-15). They were used for obtaining
+raw pointers to ``ImagingCore`` internals. To interact with C code, you can use
+``Image.Image.getim()``, which returns a ``Capsule`` object.
+
 ICNS (width, height, scale) sizes
 ^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
 

From 9f409e823b0914b18b0a5447e93bb5f40c0e0c4c Mon Sep 17 00:00:00 2001
From: Andrew Murray <radarhere@users.noreply.github.com>
Date: Sat, 21 Sep 2024 16:44:39 +1000
Subject: [PATCH 1093/1178] Use getim()

---
 src/PIL/ImageTk.py | 9 ++++-----
 1 file changed, 4 insertions(+), 5 deletions(-)

diff --git a/src/PIL/ImageTk.py b/src/PIL/ImageTk.py
index c36cf9b8473..72fa798ebd4 100644
--- a/src/PIL/ImageTk.py
+++ b/src/PIL/ImageTk.py
@@ -176,15 +176,14 @@ def paste(self, im: Image.Image) -> None:
                    the bitmap image.
         """
         # convert to blittable
-        im.load()
+        ptr = im.getim()
         image = im.im
-        if image.isblock() and im.mode == self.__mode:
-            block = image
-        else:
+        if not image.isblock() or im.mode != self.__mode:
             block = Image.core.new_block(self.__mode, im.size)
             image.convert2(block, image)  # convert directly between buffers
+            ptr = block.ptr
 
-        _pyimagingtkcall("PyImagingPhoto", self.__photo, block.ptr)
+        _pyimagingtkcall("PyImagingPhoto", self.__photo, ptr)
 
 
 # --------------------------------------------------------------------

From 11bcd5aaa9c35d7f8557b0f5abf899b0adf0cecf Mon Sep 17 00:00:00 2001
From: Aleksandr Karpinskii <homm86@gmail.com>
Date: Sun, 22 Sep 2024 13:39:22 +0400
Subject: [PATCH 1094/1178] Fix hasattr for ImageTk.PhotoImage.__del__

---
 src/PIL/ImageTk.py | 5 +++--
 1 file changed, 3 insertions(+), 2 deletions(-)

diff --git a/src/PIL/ImageTk.py b/src/PIL/ImageTk.py
index 72fa798ebd4..c817ab09ced 100644
--- a/src/PIL/ImageTk.py
+++ b/src/PIL/ImageTk.py
@@ -131,9 +131,10 @@ def __init__(
             self.paste(image)
 
     def __del__(self) -> None:
-        if not hasattr(self, "__photo"):
+        try:
+            name = self.__photo.name
+        except AttributeError:
             return
-        name = self.__photo.name
         self.__photo.name = None
         try:
             self.__photo.tk.call("image", "delete", name)

From 8fa5ba844361536135d3d6cb67e3a3f4a1a651f4 Mon Sep 17 00:00:00 2001
From: Yay295 <Yay295@gmail.com>
Date: Thu, 19 Sep 2024 11:05:52 -0500
Subject: [PATCH 1095/1178] add common windows ci test script

---
 .appveyor.yml                      | 5 ++---
 .ci/test.cmd                       | 3 +++
 .github/workflows/test-windows.yml | 4 ++--
 3 files changed, 7 insertions(+), 5 deletions(-)
 create mode 100644 .ci/test.cmd

diff --git a/.appveyor.yml b/.appveyor.yml
index f490561cdcd..7d45e11ee5c 100644
--- a/.appveyor.yml
+++ b/.appveyor.yml
@@ -53,9 +53,8 @@ test_script:
 - cd c:\pillow
 - '%PYTHON%\%EXECUTABLE% -m pip install pytest pytest-cov pytest-timeout defusedxml ipython numpy olefile pyroma'
 - c:\"Program Files (x86)"\"Windows Kits"\10\Debuggers\x86\gflags.exe /p /enable %PYTHON%\%EXECUTABLE%
-- '%PYTHON%\%EXECUTABLE% -c "from PIL import Image"'
-- '%PYTHON%\%EXECUTABLE% -m pytest -vx --cov PIL --cov Tests --cov-report term --cov-report xml Tests'
-#- '%PYTHON%\%EXECUTABLE% test-installed.py -v -s %TEST_OPTIONS%' TODO TEST_OPTIONS with pytest?
+- path %PYTHON%;%PATH%
+- .ci\test.cmd
 
 after_test:
 - curl -Os https://uploader.codecov.io/latest/windows/codecov.exe
diff --git a/.ci/test.cmd b/.ci/test.cmd
new file mode 100644
index 00000000000..aafc9290c80
--- /dev/null
+++ b/.ci/test.cmd
@@ -0,0 +1,3 @@
+python.exe -c "from PIL import Image"
+IF ERRORLEVEL 1 EXIT /B
+python.exe -bb -m pytest -v -x -W always --cov PIL --cov Tests --cov-report term --cov-report xml Tests
diff --git a/.github/workflows/test-windows.yml b/.github/workflows/test-windows.yml
index f58e8dae3a6..e36dc05fd09 100644
--- a/.github/workflows/test-windows.yml
+++ b/.github/workflows/test-windows.yml
@@ -190,8 +190,8 @@ jobs:
 
     - name: Test Pillow
       run: |
-        path %GITHUB_WORKSPACE%\\winbuild\\build\\bin;%PATH%
-        python.exe -m pytest -vx -W always --cov PIL --cov Tests --cov-report term --cov-report xml Tests
+        path %GITHUB_WORKSPACE%\winbuild\build\bin;%PATH%
+        .ci\test.cmd
       shell: cmd
 
     - name: Prepare to upload errors

From be3192ecd41581761a78913950ec3fb4be4dd981 Mon Sep 17 00:00:00 2001
From: Yay295 <Yay295@gmail.com>
Date: Thu, 19 Sep 2024 12:08:34 -0500
Subject: [PATCH 1096/1178] use .ci/test.sh in test-mingw.yml

---
 .ci/test.sh                      | 2 +-
 .github/workflows/test-mingw.yml | 3 +--
 2 files changed, 2 insertions(+), 3 deletions(-)

diff --git a/.ci/test.sh b/.ci/test.sh
index 8ff7c5f6483..3f0ddc350a9 100755
--- a/.ci/test.sh
+++ b/.ci/test.sh
@@ -4,4 +4,4 @@ set -e
 
 python3 -c "from PIL import Image"
 
-python3 -bb -m pytest -v -x -W always --cov PIL --cov Tests --cov-report term Tests $REVERSE
+python3 -bb -m pytest -v -x -W always --cov PIL --cov Tests --cov-report term --cov-report xml Tests $REVERSE
diff --git a/.github/workflows/test-mingw.yml b/.github/workflows/test-mingw.yml
index e5e1ec32e2b..c7a73439ca9 100644
--- a/.github/workflows/test-mingw.yml
+++ b/.github/workflows/test-mingw.yml
@@ -80,8 +80,7 @@ jobs:
       - name: Test Pillow
         run: |
           python3 selftest.py --installed
-          python3 -c "from PIL import Image"
-          python3 -m pytest -vx --cov PIL --cov Tests --cov-report term --cov-report xml Tests
+          .ci/test.sh
 
       - name: Upload coverage
         uses: codecov/codecov-action@v4

From 6081640aa5b68a177ed54cfd03e4ae6a748e8be8 Mon Sep 17 00:00:00 2001
From: Nulano <nulano@nulano.eu>
Date: Sun, 22 Sep 2024 22:46:35 +0200
Subject: [PATCH 1097/1178] winbuild: Build freetype.vcxproj to fix passing in
 custom parameters.

---
 winbuild/build_prepare.py | 8 ++++++--
 1 file changed, 6 insertions(+), 2 deletions(-)

diff --git a/winbuild/build_prepare.py b/winbuild/build_prepare.py
index e2022d28337..d350e2575a5 100644
--- a/winbuild/build_prepare.py
+++ b/winbuild/build_prepare.py
@@ -292,8 +292,12 @@ def cmd_msbuild(
         },
         "build": [
             cmd_rmdir("objs"),
-            cmd_msbuild("MSBuild.sln", "Release Static", "Clean"),
-            cmd_msbuild("MSBuild.sln", "Release Static", "Build"),
+            cmd_msbuild(
+                r"builds\windows\vc2010\freetype.vcxproj", "Release Static", "Clean"
+            ),
+            cmd_msbuild(
+                r"builds\windows\vc2010\freetype.vcxproj", "Release Static", "Build"
+            ),
             cmd_xcopy("include", "{inc_dir}"),
         ],
         "libs": [r"objs\{msbuild_arch}\Release Static\freetype.lib"],

From 8adf15a6ee1bab667a0e7b76d19ea0f26b29ce85 Mon Sep 17 00:00:00 2001
From: Andrew Murray <radarhere@users.noreply.github.com>
Date: Mon, 23 Sep 2024 09:29:16 +1000
Subject: [PATCH 1098/1178] Updated raqm to 0.10.2

---
 depends/install_raqm.sh | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/depends/install_raqm.sh b/depends/install_raqm.sh
index 070ba23a178..5d862403ee0 100755
--- a/depends/install_raqm.sh
+++ b/depends/install_raqm.sh
@@ -2,7 +2,7 @@
 # install raqm
 
 
-archive=libraqm-0.10.1
+archive=libraqm-0.10.2
 
 ./download-and-extract.sh $archive https://raw.githubusercontent.com/python-pillow/pillow-depends/main/$archive.tar.gz
 

From 9fe014876ab3dbc2a765ae1175659cc0d7bc7e42 Mon Sep 17 00:00:00 2001
From: Andrew Murray <radarhere@users.noreply.github.com>
Date: Sun, 22 Sep 2024 22:42:39 +1000
Subject: [PATCH 1099/1178] Shared libraries may be located within usr/lib64

---
 depends/install_imagequant.sh | 7 ++++++-
 1 file changed, 6 insertions(+), 1 deletion(-)

diff --git a/depends/install_imagequant.sh b/depends/install_imagequant.sh
index 867b31e4d19..060d9840ec9 100755
--- a/depends/install_imagequant.sh
+++ b/depends/install_imagequant.sh
@@ -23,7 +23,12 @@ else
     cargo cinstall --prefix=/usr --destdir=.
 
     # Copy into place
-    sudo cp usr/lib/libimagequant.so* /usr/lib/
+    if [ -d "usr/lib64" ]; then
+        lib="lib64"
+    else
+        lib="lib"
+    fi
+    sudo cp usr/$lib/libimagequant.so* /usr/lib/
     sudo cp usr/include/libimagequant.h /usr/include/
 
     if [ -n "$GITHUB_ACTIONS" ]; then

From 3f8b496431c3eb2f0cedad35669e725fd3be45e0 Mon Sep 17 00:00:00 2001
From: Andrew Murray <radarhere@users.noreply.github.com>
Date: Tue, 24 Sep 2024 09:54:26 +1000
Subject: [PATCH 1100/1178] Updated harfbuzz to 10.0.0

---
 .github/workflows/wheels-dependencies.sh | 2 +-
 winbuild/build_prepare.py                | 2 +-
 2 files changed, 2 insertions(+), 2 deletions(-)

diff --git a/.github/workflows/wheels-dependencies.sh b/.github/workflows/wheels-dependencies.sh
index 4d40f7fabfc..92e9ad5af9a 100755
--- a/.github/workflows/wheels-dependencies.sh
+++ b/.github/workflows/wheels-dependencies.sh
@@ -17,7 +17,7 @@ ARCHIVE_SDIR=pillow-depends-main
 # Package versions for fresh source builds
 FREETYPE_VERSION=2.13.2
 if [[ "$MB_ML_VER" != 2014 ]]; then
-    HARFBUZZ_VERSION=9.0.0
+    HARFBUZZ_VERSION=10.0.0
 else
     HARFBUZZ_VERSION=8.5.0
 fi
diff --git a/winbuild/build_prepare.py b/winbuild/build_prepare.py
index d350e2575a5..db592d23c4e 100644
--- a/winbuild/build_prepare.py
+++ b/winbuild/build_prepare.py
@@ -112,7 +112,7 @@ def cmd_msbuild(
     "BROTLI": "1.1.0",
     "FREETYPE": "2.13.3",
     "FRIBIDI": "1.0.15",
-    "HARFBUZZ": "9.0.0",
+    "HARFBUZZ": "10.0.0",
     "JPEGTURBO": "3.0.4",
     "LCMS2": "2.16",
     "LIBPNG": "1.6.44",

From 61c83a882cc0a1b78f2e8f1e3ce38616f95c6f3e Mon Sep 17 00:00:00 2001
From: Andrew Murray <radarhere@users.noreply.github.com>
Date: Wed, 25 Sep 2024 00:00:22 +1000
Subject: [PATCH 1101/1178] Updated macOS version to 10.15 for PyPy x86-64

---
 .github/workflows/wheels.yml | 7 ++++++-
 1 file changed, 6 insertions(+), 1 deletion(-)

diff --git a/.github/workflows/wheels.yml b/.github/workflows/wheels.yml
index 11564c14256..d3c2ac44c80 100644
--- a/.github/workflows/wheels.yml
+++ b/.github/workflows/wheels.yml
@@ -105,13 +105,18 @@ jobs:
           - name: "macOS 10.10 x86_64"
             os: macos-13
             cibw_arch: x86_64
-            build: "pp310* cp3{9,10,11}*"
+            build: "cp3{9,10,11}*"
             macosx_deployment_target: "10.10"
           - name: "macOS 10.13 x86_64"
             os: macos-13
             cibw_arch: x86_64
             build: "cp3{12,13}*"
             macosx_deployment_target: "10.13"
+          - name: "macOS 10.15 x86_64"
+            os: macos-13
+            cibw_arch: x86_64
+            build: "pp310*"
+            macosx_deployment_target: "10.15"
           - name: "macOS arm64"
             os: macos-latest
             cibw_arch: arm64

From 72144ec5300d92bfffd029ccfb52e4d087a0bd95 Mon Sep 17 00:00:00 2001
From: Andrew Murray <radarhere@users.noreply.github.com>
Date: Wed, 25 Sep 2024 08:33:18 +1000
Subject: [PATCH 1102/1178] Updated harfbuzz to 10.0.1

---
 .github/workflows/wheels-dependencies.sh | 2 +-
 winbuild/build_prepare.py                | 2 +-
 2 files changed, 2 insertions(+), 2 deletions(-)

diff --git a/.github/workflows/wheels-dependencies.sh b/.github/workflows/wheels-dependencies.sh
index 92e9ad5af9a..b5fbdc4215e 100755
--- a/.github/workflows/wheels-dependencies.sh
+++ b/.github/workflows/wheels-dependencies.sh
@@ -17,7 +17,7 @@ ARCHIVE_SDIR=pillow-depends-main
 # Package versions for fresh source builds
 FREETYPE_VERSION=2.13.2
 if [[ "$MB_ML_VER" != 2014 ]]; then
-    HARFBUZZ_VERSION=10.0.0
+    HARFBUZZ_VERSION=10.0.1
 else
     HARFBUZZ_VERSION=8.5.0
 fi
diff --git a/winbuild/build_prepare.py b/winbuild/build_prepare.py
index db592d23c4e..84ad6417e50 100644
--- a/winbuild/build_prepare.py
+++ b/winbuild/build_prepare.py
@@ -112,7 +112,7 @@ def cmd_msbuild(
     "BROTLI": "1.1.0",
     "FREETYPE": "2.13.3",
     "FRIBIDI": "1.0.15",
-    "HARFBUZZ": "10.0.0",
+    "HARFBUZZ": "10.0.1",
     "JPEGTURBO": "3.0.4",
     "LCMS2": "2.16",
     "LIBPNG": "1.6.44",

From 0a99d63028ebcc92d950cd63cd805eb558a5131c Mon Sep 17 00:00:00 2001
From: Andrew Murray <radarhere@users.noreply.github.com>
Date: Fri, 20 Sep 2024 22:31:00 +1000
Subject: [PATCH 1103/1178] Use field size in AppendingTiffWriter

---
 src/PIL/TiffImagePlugin.py | 69 ++++++++++++++++++++++----------------
 1 file changed, 41 insertions(+), 28 deletions(-)

diff --git a/src/PIL/TiffImagePlugin.py b/src/PIL/TiffImagePlugin.py
index d4c46a79778..0fe55e426bb 100644
--- a/src/PIL/TiffImagePlugin.py
+++ b/src/PIL/TiffImagePlugin.py
@@ -2121,13 +2121,24 @@ def skipIFDs(self) -> None:
     def write(self, data: Buffer, /) -> int:
         return self.f.write(data)
 
-    def readShort(self) -> int:
-        (value,) = struct.unpack(self.shortFmt, self.f.read(2))
+    def _fmt(self, field_size: int) -> str:
+        try:
+            return {2: "H", 4: "L"}[field_size]
+        except KeyError:
+            msg = "offset is not supported"
+            raise RuntimeError(msg)
+
+    def _read(self, field_size: int) -> int:
+        (value,) = struct.unpack(
+            self.endian + self._fmt(field_size), self.f.read(field_size)
+        )
         return value
 
+    def readShort(self) -> int:
+        return self._read(2)
+
     def readLong(self) -> int:
-        (value,) = struct.unpack(self.longFmt, self.f.read(4))
-        return value
+        return self._read(4)
 
     @staticmethod
     def _verify_bytes_written(bytes_written: int | None, expected: int) -> None:
@@ -2140,15 +2151,18 @@ def rewriteLastShortToLong(self, value: int) -> None:
         bytes_written = self.f.write(struct.pack(self.longFmt, value))
         self._verify_bytes_written(bytes_written, 4)
 
+    def _rewriteLast(self, value: int, field_size: int) -> None:
+        self.f.seek(-field_size, os.SEEK_CUR)
+        bytes_written = self.f.write(
+            struct.pack(self.endian + self._fmt(field_size), value)
+        )
+        self._verify_bytes_written(bytes_written, field_size)
+
     def rewriteLastShort(self, value: int) -> None:
-        self.f.seek(-2, os.SEEK_CUR)
-        bytes_written = self.f.write(struct.pack(self.shortFmt, value))
-        self._verify_bytes_written(bytes_written, 2)
+        return self._rewriteLast(value, 2)
 
     def rewriteLastLong(self, value: int) -> None:
-        self.f.seek(-4, os.SEEK_CUR)
-        bytes_written = self.f.write(struct.pack(self.longFmt, value))
-        self._verify_bytes_written(bytes_written, 4)
+        return self._rewriteLast(value, 4)
 
     def writeShort(self, value: int) -> None:
         bytes_written = self.f.write(struct.pack(self.shortFmt, value))
@@ -2180,32 +2194,22 @@ def fixIFD(self) -> None:
                 cur_pos = self.f.tell()
 
                 if is_local:
-                    self.fixOffsets(
-                        count, isShort=(field_size == 2), isLong=(field_size == 4)
-                    )
+                    self._fixOffsets(count, field_size)
                     self.f.seek(cur_pos + 4)
                 else:
                     self.f.seek(offset)
-                    self.fixOffsets(
-                        count, isShort=(field_size == 2), isLong=(field_size == 4)
-                    )
+                    self._fixOffsets(count, field_size)
                     self.f.seek(cur_pos)
 
             elif is_local:
                 # skip the locally stored value that is not an offset
                 self.f.seek(4, os.SEEK_CUR)
 
-    def fixOffsets(
-        self, count: int, isShort: bool = False, isLong: bool = False
-    ) -> None:
-        if not isShort and not isLong:
-            msg = "offset is neither short nor long"
-            raise RuntimeError(msg)
-
+    def _fixOffsets(self, count: int, field_size: int) -> None:
         for i in range(count):
-            offset = self.readShort() if isShort else self.readLong()
+            offset = self._read(field_size)
             offset += self.offsetOfNewPage
-            if isShort and offset >= 65536:
+            if field_size == 2 and offset >= 65536:
                 # offset is now too large - we must convert shorts to longs
                 if count != 1:
                     msg = "not implemented"
@@ -2217,10 +2221,19 @@ def fixOffsets(
                 self.f.seek(-10, os.SEEK_CUR)
                 self.writeShort(TiffTags.LONG)  # rewrite the type to LONG
                 self.f.seek(8, os.SEEK_CUR)
-            elif isShort:
-                self.rewriteLastShort(offset)
             else:
-                self.rewriteLastLong(offset)
+                self._rewriteLast(offset, field_size)
+
+    def fixOffsets(
+        self, count: int, isShort: bool = False, isLong: bool = False
+    ) -> None:
+        if isShort:
+            field_size = 2
+        elif isLong:
+            field_size = 4
+        else:
+            field_size = 0
+        return self._fixOffsets(count, field_size)
 
 
 def _save_all(im: Image.Image, fp: IO[bytes], filename: str | bytes) -> None:

From 24e9961c4f68bdc676a5e7a2dde02460f8bd62c1 Mon Sep 17 00:00:00 2001
From: Andrew Murray <radarhere@users.noreply.github.com>
Date: Wed, 25 Sep 2024 18:45:16 +1000
Subject: [PATCH 1104/1178] Support writing LONG8 offsets

---
 Tests/test_file_tiff.py    | 4 ----
 src/PIL/TiffImagePlugin.py | 2 +-
 2 files changed, 1 insertion(+), 5 deletions(-)

diff --git a/Tests/test_file_tiff.py b/Tests/test_file_tiff.py
index 44da25295ef..6d76ccca627 100644
--- a/Tests/test_file_tiff.py
+++ b/Tests/test_file_tiff.py
@@ -108,10 +108,6 @@ def test_bigtiff(self, tmp_path: Path) -> None:
             assert_image_equal_tofile(im, "Tests/images/hopper.tif")
 
         with Image.open("Tests/images/hopper_bigtiff.tif") as im:
-            # The data type of this file's StripOffsets tag is LONG8,
-            # which is not yet supported for offset data when saving multiple frames.
-            del im.tag_v2[273]
-
             outfile = str(tmp_path / "temp.tif")
             im.save(outfile, save_all=True, append_images=[im], tiffinfo=im.tag_v2)
 
diff --git a/src/PIL/TiffImagePlugin.py b/src/PIL/TiffImagePlugin.py
index 0fe55e426bb..a655bb741e7 100644
--- a/src/PIL/TiffImagePlugin.py
+++ b/src/PIL/TiffImagePlugin.py
@@ -2123,7 +2123,7 @@ def write(self, data: Buffer, /) -> int:
 
     def _fmt(self, field_size: int) -> str:
         try:
-            return {2: "H", 4: "L"}[field_size]
+            return {2: "H", 4: "L", 8: "Q"}[field_size]
         except KeyError:
             msg = "offset is not supported"
             raise RuntimeError(msg)

From 5d16eb73eb658daceb7b0af9f8d29cca96888a48 Mon Sep 17 00:00:00 2001
From: Andrew Murray <radarhere@users.noreply.github.com>
Date: Wed, 25 Sep 2024 19:07:32 +1000
Subject: [PATCH 1105/1178] Update CHANGES.rst [ci skip]

---
 CHANGES.rst | 9 +++++++++
 1 file changed, 9 insertions(+)

diff --git a/CHANGES.rst b/CHANGES.rst
index 4ab9eaf2bd8..ae7370a79b4 100644
--- a/CHANGES.rst
+++ b/CHANGES.rst
@@ -5,6 +5,15 @@ Changelog (Pillow)
 11.0.0 (unreleased)
 -------------------
 
+- Fixed writing multiple StripOffsets to TIFF #8317
+  [Yay295, radarhere]
+
+- Shared imagequant libraries may be located within usr/lib64 #8407
+  [radarhere]
+
+- Fix dereference before checking for NULL in ImagingTransformAffine #8398
+  [PavlNekrasov]
+
 - Use transposed size after opening for TIFF images #8390
   [radarhere, homm]
 

From 7cf351cfc50dcbda82270c80e44e32643688a7a9 Mon Sep 17 00:00:00 2001
From: Andrew Murray <radarhere@users.noreply.github.com>
Date: Wed, 25 Sep 2024 20:37:41 +1000
Subject: [PATCH 1106/1178] Added additional test

---
 Tests/test_file_tiff.py | 14 ++++++++++++++
 1 file changed, 14 insertions(+)

diff --git a/Tests/test_file_tiff.py b/Tests/test_file_tiff.py
index 6d76ccca627..af766022b5c 100644
--- a/Tests/test_file_tiff.py
+++ b/Tests/test_file_tiff.py
@@ -728,6 +728,20 @@ def im_generator(ims: list[Image.Image]) -> Generator[Image.Image, None, None]:
         with Image.open(mp) as reread:
             assert reread.n_frames == 3
 
+    def test_fixoffsets(self) -> None:
+        b = BytesIO(b"II\x2a\x00\x00\x00\x00\x00")
+        with TiffImagePlugin.AppendingTiffWriter(b) as a:
+            b.seek(0)
+            a.fixOffsets(1, isShort=True)
+
+            b.seek(0)
+            a.fixOffsets(1, isLong=True)
+
+            # Neither short nor long
+            b.seek(0)
+            with pytest.raises(RuntimeError):
+                a.fixOffsets(1)
+
     def test_saving_icc_profile(self, tmp_path: Path) -> None:
         # Tests saving TIFF with icc_profile set.
         # At the time of writing this will only work for non-compressed tiffs

From d8e3572caad2f3dce65db6951909f161a4021687 Mon Sep 17 00:00:00 2001
From: Andrew Murray <radarhere@users.noreply.github.com>
Date: Thu, 26 Sep 2024 08:52:29 +1000
Subject: [PATCH 1107/1178] Updated fribidi to 1.0.16

---
 winbuild/build_prepare.py | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/winbuild/build_prepare.py b/winbuild/build_prepare.py
index 84ad6417e50..026d9d30695 100644
--- a/winbuild/build_prepare.py
+++ b/winbuild/build_prepare.py
@@ -111,7 +111,7 @@ def cmd_msbuild(
 V = {
     "BROTLI": "1.1.0",
     "FREETYPE": "2.13.3",
-    "FRIBIDI": "1.0.15",
+    "FRIBIDI": "1.0.16",
     "HARFBUZZ": "10.0.1",
     "JPEGTURBO": "3.0.4",
     "LCMS2": "2.16",

From b9d176856135b581bd503e04ab2407318cbe7689 Mon Sep 17 00:00:00 2001
From: Alexander Karpinsky <homm86@gmail.com>
Date: Thu, 26 Sep 2024 16:27:55 +0400
Subject: [PATCH 1108/1178] Catch AttributeError for BitmapImage.__photo

Co-authored-by: Andrew Murray <3112309+radarhere@users.noreply.github.com>
---
 src/PIL/ImageTk.py | 5 +++--
 1 file changed, 3 insertions(+), 2 deletions(-)

diff --git a/src/PIL/ImageTk.py b/src/PIL/ImageTk.py
index c817ab09ced..bf29fdba54c 100644
--- a/src/PIL/ImageTk.py
+++ b/src/PIL/ImageTk.py
@@ -219,9 +219,10 @@ def __init__(self, image: Image.Image | None = None, **kw: Any) -> None:
         self.__photo = tkinter.BitmapImage(data=image.tobitmap(), **kw)
 
     def __del__(self) -> None:
-        if not hasattr(self, "__photo"):
+        try:
+            name = self.__photo.name
+        except AttributeError:
             return
-        name = self.__photo.name
         self.__photo.name = None
         try:
             self.__photo.tk.call("image", "delete", name)

From 4ca2b92503ed0250d7e48bf4c187c4fd1dbbdc54 Mon Sep 17 00:00:00 2001
From: Andrew Murray <radarhere@users.noreply.github.com>
Date: Fri, 27 Sep 2024 14:59:27 +1000
Subject: [PATCH 1109/1178] Use $IS_ALPINE instead of $MB_ML_LIBC

---
 .github/workflows/wheels-dependencies.sh | 8 +++-----
 1 file changed, 3 insertions(+), 5 deletions(-)

diff --git a/.github/workflows/wheels-dependencies.sh b/.github/workflows/wheels-dependencies.sh
index b5fbdc4215e..5175a2a9228 100755
--- a/.github/workflows/wheels-dependencies.sh
+++ b/.github/workflows/wheels-dependencies.sh
@@ -156,12 +156,10 @@ if [[ -n "$IS_MACOS" ]]; then
   fi
 
   brew install meson pkg-config
-elif [[ "$MB_ML_LIBC" == "manylinux" ]]; then
-  if [[ "$HARFBUZZ_VERSION" != 8.5.0 ]]; then
-    yum install -y meson
-  fi
-else
+elif [[ -n "$IS_ALPINE" ]]; then
   apk add meson
+elif [[ "$HARFBUZZ_VERSION" != 8.5.0 ]]; then
+  yum install -y meson
 fi
 
 wrap_wheel_builder build

From 71da6d8952c174fa0a465fa6caf98989d6eff9c9 Mon Sep 17 00:00:00 2001
From: Andrew Murray <radarhere@users.noreply.github.com>
Date: Fri, 27 Sep 2024 16:37:10 +1000
Subject: [PATCH 1110/1178] Downgrade harfbuzz on OSS Fuzz

---
 .github/workflows/wheels-dependencies.sh | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/.github/workflows/wheels-dependencies.sh b/.github/workflows/wheels-dependencies.sh
index 5175a2a9228..4289afdf3a5 100755
--- a/.github/workflows/wheels-dependencies.sh
+++ b/.github/workflows/wheels-dependencies.sh
@@ -16,7 +16,7 @@ ARCHIVE_SDIR=pillow-depends-main
 
 # Package versions for fresh source builds
 FREETYPE_VERSION=2.13.2
-if [[ "$MB_ML_VER" != 2014 ]]; then
+if [[ "$MB_ML_VER" != 2014 ]] && [[ -z "$SANITIZER" ]]; then
     HARFBUZZ_VERSION=10.0.1
 else
     HARFBUZZ_VERSION=8.5.0

From fb8db83122a2f942958fc93103ad7b043cca3a3b Mon Sep 17 00:00:00 2001
From: Andrew Murray <radarhere@users.noreply.github.com>
Date: Fri, 27 Sep 2024 17:35:06 +1000
Subject: [PATCH 1111/1178] Updated harfbuzz to 10.0.1 on macOS

---
 .github/workflows/wheels-dependencies.sh | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/.github/workflows/wheels-dependencies.sh b/.github/workflows/wheels-dependencies.sh
index 4289afdf3a5..bb0f8a307e3 100755
--- a/.github/workflows/wheels-dependencies.sh
+++ b/.github/workflows/wheels-dependencies.sh
@@ -16,7 +16,7 @@ ARCHIVE_SDIR=pillow-depends-main
 
 # Package versions for fresh source builds
 FREETYPE_VERSION=2.13.2
-if [[ "$MB_ML_VER" != 2014 ]] && [[ -z "$SANITIZER" ]]; then
+if [[ -n "$IS_MACOS" ]] || ([[ "$MB_ML_VER" != 2014 ]] && [[ -z "$SANITIZER" ]]); then
     HARFBUZZ_VERSION=10.0.1
 else
     HARFBUZZ_VERSION=8.5.0

From 485a062010d0942f88686dbf7ece6a765d329e53 Mon Sep 17 00:00:00 2001
From: Andrew Murray <radarhere@users.noreply.github.com>
Date: Fri, 27 Sep 2024 23:13:03 +1000
Subject: [PATCH 1112/1178] Update CHANGES.rst [ci skip]

---
 CHANGES.rst | 3 +++
 1 file changed, 3 insertions(+)

diff --git a/CHANGES.rst b/CHANGES.rst
index ae7370a79b4..6ff35ea4f98 100644
--- a/CHANGES.rst
+++ b/CHANGES.rst
@@ -5,6 +5,9 @@ Changelog (Pillow)
 11.0.0 (unreleased)
 -------------------
 
+- Use Capsule for WebP saving #8386
+  [homm, radarhere]
+
 - Fixed writing multiple StripOffsets to TIFF #8317
   [Yay295, radarhere]
 

From bda62c1ac52f6a843263d2e195025d204a094f78 Mon Sep 17 00:00:00 2001
From: Andrew Murray <radarhere@users.noreply.github.com>
Date: Fri, 27 Sep 2024 22:11:03 +1000
Subject: [PATCH 1113/1178] Revert "Temporarily disable cifuzz"

This reverts commit 31469407166026ec6d74d2df07196ef2d4e32ab4.
---
 .github/workflows/cifuzz.yml | 2 --
 1 file changed, 2 deletions(-)

diff --git a/.github/workflows/cifuzz.yml b/.github/workflows/cifuzz.yml
index 033ff98ce74..eb73fc6a7cd 100644
--- a/.github/workflows/cifuzz.yml
+++ b/.github/workflows/cifuzz.yml
@@ -24,8 +24,6 @@ concurrency:
 
 jobs:
   Fuzzing:
-    # Disabled until google/oss-fuzz#11419 upgrades Python to 3.9+
-    if: false
     runs-on: ubuntu-latest
     steps:
     - name: Build Fuzzers

From 04a00d273c6fe72f8a2f4099950831deb8ad5407 Mon Sep 17 00:00:00 2001
From: Andrew Murray <radarhere@users.noreply.github.com>
Date: Sat, 28 Sep 2024 14:27:40 +1000
Subject: [PATCH 1114/1178] Support all resampling filters when resizing I;16*
 images

---
 Tests/test_image_resize.py | 16 ++++++--
 src/_imaging.c             | 10 ++---
 src/libImaging/Resample.c  | 84 +++++++++++++++++++++++++++++++++++++-
 3 files changed, 99 insertions(+), 11 deletions(-)

diff --git a/Tests/test_image_resize.py b/Tests/test_image_resize.py
index d9ddf500913..1cd9c380048 100644
--- a/Tests/test_image_resize.py
+++ b/Tests/test_image_resize.py
@@ -44,9 +44,19 @@ def test_convolution_modes(self) -> None:
             self.resize(hopper("1"), (15, 12), Image.Resampling.BILINEAR)
         with pytest.raises(ValueError):
             self.resize(hopper("P"), (15, 12), Image.Resampling.BILINEAR)
-        with pytest.raises(ValueError):
-            self.resize(hopper("I;16"), (15, 12), Image.Resampling.BILINEAR)
-        for mode in ["L", "I", "F", "RGB", "RGBA", "CMYK", "YCbCr"]:
+        for mode in [
+            "L",
+            "I",
+            "I;16",
+            "I;16L",
+            "I;16B",
+            "I;16N",
+            "F",
+            "RGB",
+            "RGBA",
+            "CMYK",
+            "YCbCr",
+        ]:
             im = hopper(mode)
             r = self.resize(im, (15, 12), Image.Resampling.BILINEAR)
             assert r.mode == mode
diff --git a/src/_imaging.c b/src/_imaging.c
index 07d9a64ccff..42603633560 100644
--- a/src/_imaging.c
+++ b/src/_imaging.c
@@ -1579,16 +1579,12 @@ _putdata(ImagingObject *self, PyObject *args) {
                 int bigendian = 0;
                 if (image->type == IMAGING_TYPE_SPECIAL) {
                     // I;16*
-                    if (strcmp(image->mode, "I;16N") == 0) {
+                    if (strcmp(image->mode, "I;16B") == 0
 #ifdef WORDS_BIGENDIAN
-                        bigendian = 1;
-#else
-                        bigendian = 0;
+                        || strcmp(image->mode, "I;16N") == 0
 #endif
-                    } else if (strcmp(image->mode, "I;16B") == 0) {
+                    ) {
                         bigendian = 1;
-                    } else {
-                        bigendian = 0;
                     }
                 }
                 for (i = x = y = 0; i < n; i++) {
diff --git a/src/libImaging/Resample.c b/src/libImaging/Resample.c
index 222d6bca433..f5e386dc2ba 100644
--- a/src/libImaging/Resample.c
+++ b/src/libImaging/Resample.c
@@ -460,6 +460,83 @@ ImagingResampleVertical_8bpc(
     ImagingSectionLeave(&cookie);
 }
 
+void
+ImagingResampleHorizontal_16bpc(
+    Imaging imOut, Imaging imIn, int offset, int ksize, int *bounds, double *kk
+) {
+    ImagingSectionCookie cookie;
+    double ss;
+    int xx, yy, x, xmin, xmax, ss_int;
+    double *k;
+
+    int bigendian = 0;
+    if (strcmp(imIn->mode, "I;16N") == 0
+#ifdef WORDS_BIGENDIAN
+        || strcmp(imIn->mode, "I;16B") == 0
+#endif
+    ) {
+        bigendian = 1;
+    }
+
+    ImagingSectionEnter(&cookie);
+    for (yy = 0; yy < imOut->ysize; yy++) {
+        for (xx = 0; xx < imOut->xsize; xx++) {
+            xmin = bounds[xx * 2 + 0];
+            xmax = bounds[xx * 2 + 1];
+            k = &kk[xx * ksize];
+            ss = 0.0;
+            for (x = 0; x < xmax; x++) {
+                ss += (imIn->image8[yy + offset][(x + xmin) * 2 + (bigendian ? 1 : 0)] +
+                       (imIn->image8[yy + offset][(x + xmin) * 2 + (bigendian ? 0 : 1)]
+                        << 8)) *
+                      k[x];
+            }
+            ss_int = ROUND_UP(ss);
+            imOut->image8[yy][xx * 2 + (bigendian ? 1 : 0)] = CLIP8(ss_int % 256);
+            imOut->image8[yy][xx * 2 + (bigendian ? 0 : 1)] = CLIP8(ss_int >> 8);
+        }
+    }
+    ImagingSectionLeave(&cookie);
+}
+
+void
+ImagingResampleVertical_16bpc(
+    Imaging imOut, Imaging imIn, int offset, int ksize, int *bounds, double *kk
+) {
+    ImagingSectionCookie cookie;
+    double ss;
+    int xx, yy, y, ymin, ymax, ss_int;
+    double *k;
+
+    int bigendian = 0;
+    if (strcmp(imIn->mode, "I;16N") == 0
+#ifdef WORDS_BIGENDIAN
+        || strcmp(imIn->mode, "I;16B") == 0
+#endif
+    ) {
+        bigendian = 1;
+    }
+
+    ImagingSectionEnter(&cookie);
+    for (yy = 0; yy < imOut->ysize; yy++) {
+        ymin = bounds[yy * 2 + 0];
+        ymax = bounds[yy * 2 + 1];
+        k = &kk[yy * ksize];
+        for (xx = 0; xx < imOut->xsize; xx++) {
+            ss = 0.0;
+            for (y = 0; y < ymax; y++) {
+                ss += (imIn->image8[y + ymin][xx * 2 + (bigendian ? 1 : 0)] +
+                       (imIn->image8[y + ymin][xx * 2 + (bigendian ? 0 : 1)] << 8)) *
+                      k[y];
+            }
+            ss_int = ROUND_UP(ss);
+            imOut->image8[yy][xx * 2 + (bigendian ? 1 : 0)] = CLIP8(ss_int % 256);
+            imOut->image8[yy][xx * 2 + (bigendian ? 0 : 1)] = CLIP8(ss_int >> 8);
+        }
+    }
+    ImagingSectionLeave(&cookie);
+}
+
 void
 ImagingResampleHorizontal_32bpc(
     Imaging imOut, Imaging imIn, int offset, int ksize, int *bounds, double *kk
@@ -574,7 +651,12 @@ ImagingResample(Imaging imIn, int xsize, int ysize, int filter, float box[4]) {
     }
 
     if (imIn->type == IMAGING_TYPE_SPECIAL) {
-        return (Imaging)ImagingError_ModeError();
+        if (strncmp(imIn->mode, "I;16", 4) == 0) {
+            ResampleHorizontal = ImagingResampleHorizontal_16bpc;
+            ResampleVertical = ImagingResampleVertical_16bpc;
+        } else {
+            return (Imaging)ImagingError_ModeError();
+        }
     } else if (imIn->image8) {
         ResampleHorizontal = ImagingResampleHorizontal_8bpc;
         ResampleVertical = ImagingResampleVertical_8bpc;

From e306546bf18b01c9bfa68ea397f2f5d5690113e0 Mon Sep 17 00:00:00 2001
From: Andrew Murray <radarhere@users.noreply.github.com>
Date: Sat, 28 Sep 2024 15:10:16 +1000
Subject: [PATCH 1115/1178] Use ruff check

---
 Makefile | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/Makefile b/Makefile
index 94f7565d826..ec415962740 100644
--- a/Makefile
+++ b/Makefile
@@ -117,7 +117,7 @@ lint-fix:
 	python3 -c "import black" > /dev/null 2>&1 || python3 -m pip install black
 	python3 -m black .
 	python3 -c "import ruff" > /dev/null 2>&1 || python3 -m pip install ruff
-	python3 -m ruff --fix .
+	python3 -m ruff check --fix .
 
 .PHONY: mypy
 mypy:

From 2e73ffe7034457461b13da71b05645999dd3c0ef Mon Sep 17 00:00:00 2001
From: Andrew Murray <radarhere@users.noreply.github.com>
Date: Sat, 28 Sep 2024 15:29:09 +1000
Subject: [PATCH 1116/1178] Exclude multibuild from black and ruff

---
 pyproject.toml | 6 +++++-
 1 file changed, 5 insertions(+), 1 deletion(-)

diff --git a/pyproject.toml b/pyproject.toml
index 228c344e864..0d0a6f17084 100644
--- a/pyproject.toml
+++ b/pyproject.toml
@@ -97,9 +97,13 @@ config-settings = "raqm=enable raqm=vendor fribidi=vendor imagequant=disable"
 test-command = "cd {project} && .github/workflows/wheels-test.sh"
 test-extras = "tests"
 
+[tool.black]
+exclude = "wheels/multibuild"
+
 [tool.ruff]
-fix = true
+exclude = [ "wheels/multibuild" ]
 
+fix = true
 lint.select = [
   "C4",     # flake8-comprehensions
   "E",      # pycodestyle errors

From d33270ab51f6b62710b227394f2dadf913370d96 Mon Sep 17 00:00:00 2001
From: Andrew Murray <radarhere@users.noreply.github.com>
Date: Sat, 28 Sep 2024 15:35:42 +1000
Subject: [PATCH 1117/1178] Set default resize sampling for I;16* images to
 BICUBIC

---
 Tests/test_image_resize.py   | 8 ++++----
 docs/releasenotes/11.0.0.rst | 7 ++++---
 src/PIL/Image.py             | 8 ++++----
 3 files changed, 12 insertions(+), 11 deletions(-)

diff --git a/Tests/test_image_resize.py b/Tests/test_image_resize.py
index 1cd9c380048..8548fb5da3b 100644
--- a/Tests/test_image_resize.py
+++ b/Tests/test_image_resize.py
@@ -315,14 +315,14 @@ def test_transposed(self) -> None:
             im = im.resize((64, 64))
             assert im.size == (64, 64)
 
-    @pytest.mark.parametrize("mode", ("L", "RGB", "I", "F"))
+    @pytest.mark.parametrize(
+        "mode", ("L", "RGB", "I", "I;16", "I;16L", "I;16B", "I;16N", "F")
+    )
     def test_default_filter_bicubic(self, mode: str) -> None:
         im = hopper(mode)
         assert im.resize((20, 20), Image.Resampling.BICUBIC) == im.resize((20, 20))
 
-    @pytest.mark.parametrize(
-        "mode", ("1", "P", "I;16", "I;16L", "I;16B", "BGR;15", "BGR;16")
-    )
+    @pytest.mark.parametrize("mode", ("1", "P", "BGR;15", "BGR;16"))
     def test_default_filter_nearest(self, mode: str) -> None:
         im = hopper(mode)
         assert im.resize((20, 20), Image.Resampling.NEAREST) == im.resize((20, 20))
diff --git a/docs/releasenotes/11.0.0.rst b/docs/releasenotes/11.0.0.rst
index 36334e39f5e..1218c50142b 100644
--- a/docs/releasenotes/11.0.0.rst
+++ b/docs/releasenotes/11.0.0.rst
@@ -119,10 +119,11 @@ Specific WebP Feature Checks
 API Changes
 ===========
 
-TODO
-^^^^
+Default resampling filter for I;16* image modes
+^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
 
-TODO
+The default resampling filter for I;16, I;16L, I;16B and I;16N has been changed from
+``Image.NEAREST`` to ``Image.BICUBIC``, to match the majority of modes.
 
 API Additions
 =============
diff --git a/src/PIL/Image.py b/src/PIL/Image.py
index 3f94cef3892..bf9079f8bbc 100644
--- a/src/PIL/Image.py
+++ b/src/PIL/Image.py
@@ -2278,8 +2278,8 @@ def resize(
            :py:data:`Resampling.BILINEAR`, :py:data:`Resampling.HAMMING`,
            :py:data:`Resampling.BICUBIC` or :py:data:`Resampling.LANCZOS`.
            If the image has mode "1" or "P", it is always set to
-           :py:data:`Resampling.NEAREST`. If the image mode specifies a number
-           of bits, such as "I;16", then the default filter is
+           :py:data:`Resampling.NEAREST`. If the image mode is "BGR;15",
+           "BGR;16" or "BGR;24", then the default filter is
            :py:data:`Resampling.NEAREST`. Otherwise, the default filter is
            :py:data:`Resampling.BICUBIC`. See: :ref:`concept-filters`.
         :param box: An optional 4-tuple of floats providing
@@ -2302,8 +2302,8 @@ def resize(
         """
 
         if resample is None:
-            type_special = ";" in self.mode
-            resample = Resampling.NEAREST if type_special else Resampling.BICUBIC
+            bgr = self.mode.startswith("BGR;")
+            resample = Resampling.NEAREST if bgr else Resampling.BICUBIC
         elif resample not in (
             Resampling.NEAREST,
             Resampling.BILINEAR,

From 30fca7a1d62a8b41f3536adb35355f5aa81c6a2f Mon Sep 17 00:00:00 2001
From: Andrew Murray <radarhere@users.noreply.github.com>
Date: Sat, 28 Sep 2024 18:38:45 +1000
Subject: [PATCH 1118/1178] Install meson through pip

---
 .github/workflows/wheels-dependencies.sh | 36 ++++++++----------------
 1 file changed, 11 insertions(+), 25 deletions(-)

diff --git a/.github/workflows/wheels-dependencies.sh b/.github/workflows/wheels-dependencies.sh
index bb0f8a307e3..b3996d5a110 100755
--- a/.github/workflows/wheels-dependencies.sh
+++ b/.github/workflows/wheels-dependencies.sh
@@ -16,11 +16,7 @@ ARCHIVE_SDIR=pillow-depends-main
 
 # Package versions for fresh source builds
 FREETYPE_VERSION=2.13.2
-if [[ -n "$IS_MACOS" ]] || ([[ "$MB_ML_VER" != 2014 ]] && [[ -z "$SANITIZER" ]]); then
-    HARFBUZZ_VERSION=10.0.1
-else
-    HARFBUZZ_VERSION=8.5.0
-fi
+HARFBUZZ_VERSION=10.0.1
 LIBPNG_VERSION=1.6.44
 JPEGTURBO_VERSION=3.0.4
 OPENJPEG_VERSION=2.5.2
@@ -65,21 +61,15 @@ function build_brotli {
 }
 
 function build_harfbuzz {
-    if [[ "$HARFBUZZ_VERSION" == 8.5.0 ]]; then
-        export FREETYPE_LIBS=-lfreetype
-        export FREETYPE_CFLAGS=-I/usr/local/include/freetype2/
-        build_simple harfbuzz $HARFBUZZ_VERSION https://github.com/harfbuzz/harfbuzz/releases/download/$HARFBUZZ_VERSION tar.xz --with-freetype=yes --with-glib=no
-        export FREETYPE_LIBS=""
-        export FREETYPE_CFLAGS=""
-    else
-        local out_dir=$(fetch_unpack https://github.com/harfbuzz/harfbuzz/releases/download/$HARFBUZZ_VERSION/$HARFBUZZ_VERSION.tar.xz harfbuzz-$HARFBUZZ_VERSION.tar.xz)
-        (cd $out_dir \
-            && meson setup build --buildtype=release -Dfreetype=enabled -Dglib=disabled)
-        (cd $out_dir/build \
-            && meson install)
-        if [[ "$MB_ML_LIBC" == "manylinux" ]]; then
-            cp /usr/local/lib64/libharfbuzz* /usr/local/lib
-        fi
+    python3 -m pip install meson ninja
+
+    local out_dir=$(fetch_unpack https://github.com/harfbuzz/harfbuzz/releases/download/$HARFBUZZ_VERSION/$HARFBUZZ_VERSION.tar.xz harfbuzz-$HARFBUZZ_VERSION.tar.xz)
+    (cd $out_dir \
+        && meson setup build --buildtype=release -Dfreetype=enabled -Dglib=disabled)
+    (cd $out_dir/build \
+        && meson install)
+    if [[ "$MB_ML_LIBC" == "manylinux" ]]; then
+        cp /usr/local/lib64/libharfbuzz* /usr/local/lib
     fi
 }
 
@@ -155,11 +145,7 @@ if [[ -n "$IS_MACOS" ]]; then
     brew remove --ignore-dependencies webp
   fi
 
-  brew install meson pkg-config
-elif [[ -n "$IS_ALPINE" ]]; then
-  apk add meson
-elif [[ "$HARFBUZZ_VERSION" != 8.5.0 ]]; then
-  yum install -y meson
+  brew install pkg-config
 fi
 
 wrap_wheel_builder build

From e976096c2eda0a41c49e0f06e6f84f6b3d0c99b0 Mon Sep 17 00:00:00 2001
From: Andrew Murray <radarhere@users.noreply.github.com>
Date: Sat, 28 Sep 2024 20:39:04 +1000
Subject: [PATCH 1119/1178] Allow libimagequant shared library path to change

---
 depends/install_imagequant.sh | 9 ++-------
 1 file changed, 2 insertions(+), 7 deletions(-)

diff --git a/depends/install_imagequant.sh b/depends/install_imagequant.sh
index 060d9840ec9..8d62d5ac733 100755
--- a/depends/install_imagequant.sh
+++ b/depends/install_imagequant.sh
@@ -23,19 +23,14 @@ else
     cargo cinstall --prefix=/usr --destdir=.
 
     # Copy into place
-    if [ -d "usr/lib64" ]; then
-        lib="lib64"
-    else
-        lib="lib"
-    fi
-    sudo cp usr/$lib/libimagequant.so* /usr/lib/
+    sudo find usr -name libimagequant.so* -exec cp {} /usr/lib/ \;
     sudo cp usr/include/libimagequant.h /usr/include/
 
     if [ -n "$GITHUB_ACTIONS" ]; then
         # Copy to cache
         rm -rf ~/cache-$archive_name
         mkdir ~/cache-$archive_name
-        cp usr/lib/libimagequant.so* ~/cache-$archive_name/
+        find usr -name libimagequant.so* -exec cp {} ~/cache-$archive_name/ \;
         cp usr/include/libimagequant.h ~/cache-$archive_name/
     fi
 

From ed143f5fec816c7164ff2d8a76deef6a8abfaf77 Mon Sep 17 00:00:00 2001
From: Andrew Murray <radarhere@users.noreply.github.com>
Date: Sun, 29 Sep 2024 06:40:50 +1000
Subject: [PATCH 1120/1178] Update CHANGES.rst [ci skip]

---
 CHANGES.rst | 6 +++---
 1 file changed, 3 insertions(+), 3 deletions(-)

diff --git a/CHANGES.rst b/CHANGES.rst
index 6ff35ea4f98..b4644c541ef 100644
--- a/CHANGES.rst
+++ b/CHANGES.rst
@@ -5,15 +5,15 @@ Changelog (Pillow)
 11.0.0 (unreleased)
 -------------------
 
+- Improved copying imagequant libraries #8420
+  [radarhere]
+
 - Use Capsule for WebP saving #8386
   [homm, radarhere]
 
 - Fixed writing multiple StripOffsets to TIFF #8317
   [Yay295, radarhere]
 
-- Shared imagequant libraries may be located within usr/lib64 #8407
-  [radarhere]
-
 - Fix dereference before checking for NULL in ImagingTransformAffine #8398
   [PavlNekrasov]
 

From 3a734b5d4b2ee9d602e4d7d3e89530498bac5e68 Mon Sep 17 00:00:00 2001
From: "renovate[bot]" <29139614+renovate[bot]@users.noreply.github.com>
Date: Sun, 29 Sep 2024 05:19:39 +0000
Subject: [PATCH 1121/1178] Update scientific-python/upload-nightly-action
 action to v0.6.0

---
 .github/workflows/wheels.yml | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/.github/workflows/wheels.yml b/.github/workflows/wheels.yml
index d3c2ac44c80..ee0c331660a 100644
--- a/.github/workflows/wheels.yml
+++ b/.github/workflows/wheels.yml
@@ -278,7 +278,7 @@ jobs:
           path: dist
           merge-multiple: true
       - name: Upload wheels to scientific-python-nightly-wheels
-        uses: scientific-python/upload-nightly-action@b67d7fcc0396e1128a474d1ab2b48aa94680f9fc # 0.5.0
+        uses: scientific-python/upload-nightly-action@ccf29c805b5d0c1dc31fa97fcdb962be074cade3 # 0.6.0
         with:
           artifacts_path: dist
           anaconda_nightly_upload_token: ${{ secrets.ANACONDA_ORG_UPLOAD_TOKEN }}

From 21ab53e0c0f81427c45e4b4205d5d6d07008ee81 Mon Sep 17 00:00:00 2001
From: Andrew Murray <radarhere@users.noreply.github.com>
Date: Mon, 30 Sep 2024 12:38:13 +1000
Subject: [PATCH 1122/1178] Updated test environment documentation

---
 docs/installation/platform-support.rst | 2 +-
 winbuild/README.md                     | 2 +-
 2 files changed, 2 insertions(+), 2 deletions(-)

diff --git a/docs/installation/platform-support.rst b/docs/installation/platform-support.rst
index f2ef9cacb13..9216248a0e0 100644
--- a/docs/installation/platform-support.rst
+++ b/docs/installation/platform-support.rst
@@ -48,7 +48,7 @@ These platforms are built and tested for every change.
 | Ubuntu Linux 24.04 LTS (Noble)   | 3.12                       | x86-64, ppc64le,    |
 |                                  |                            | s390x               |
 +----------------------------------+----------------------------+---------------------+
-| Windows Server 2016              | 3.9                        | x86-64              |
+| Windows Server 2019              | 3.9                        | x86-64              |
 +----------------------------------+----------------------------+---------------------+
 | Windows Server 2022              | 3.9, 3.10, 3.11,           | x86-64              |
 |                                  | 3.12, 3.13, PyPy3          |                     |
diff --git a/winbuild/README.md b/winbuild/README.md
index c8048bcc94a..f6111c79b0e 100644
--- a/winbuild/README.md
+++ b/winbuild/README.md
@@ -11,7 +11,7 @@ For more extensive info, see the [Windows build instructions](build.rst).
 * Requires Microsoft Visual Studio 2017 or newer with C++ component.
 * Requires NASM for libjpeg-turbo, a required dependency when using this script.
 * Requires CMake 3.15 or newer (available as Visual Studio component).
-* Tested on Windows Server 2016 with Visual Studio 2017 Community, and Windows Server 2019 with Visual Studio 2022 Community (AppVeyor).
+* Tested on Windows Server 2019 with Visual Studio 2019 Community and Visual Studio 2022 Community (AppVeyor).
 * Tested on Windows Server 2022 with Visual Studio 2022 Enterprise (GitHub Actions).
 
 The following is a simplified version of the script used on AppVeyor:

From 7a62c788edb77e6c0c11f31a180018411d3955f6 Mon Sep 17 00:00:00 2001
From: Andrew Murray <radarhere@users.noreply.github.com>
Date: Mon, 30 Sep 2024 12:42:39 +1000
Subject: [PATCH 1123/1178] Updated tested Python versions

---
 docs/installation/platform-support.rst | 6 +++---
 1 file changed, 3 insertions(+), 3 deletions(-)

diff --git a/docs/installation/platform-support.rst b/docs/installation/platform-support.rst
index 9216248a0e0..4cd3f2814c9 100644
--- a/docs/installation/platform-support.rst
+++ b/docs/installation/platform-support.rst
@@ -17,13 +17,13 @@ These platforms are built and tested for every change.
 +----------------------------------+----------------------------+---------------------+
 | Operating system                 | Tested Python versions     | Tested architecture |
 +==================================+============================+=====================+
-| Alpine                           | 3.9                        | x86-64              |
+| Alpine                           | 3.12                       | x86-64              |
 +----------------------------------+----------------------------+---------------------+
 | Amazon Linux 2                   | 3.9                        | x86-64              |
 +----------------------------------+----------------------------+---------------------+
 | Amazon Linux 2023                | 3.9                        | x86-64              |
 +----------------------------------+----------------------------+---------------------+
-| Arch                             | 3.9                        | x86-64              |
+| Arch                             | 3.12                       | x86-64              |
 +----------------------------------+----------------------------+---------------------+
 | CentOS Stream 9                  | 3.9                        | x86-64              |
 +----------------------------------+----------------------------+---------------------+
@@ -33,7 +33,7 @@ These platforms are built and tested for every change.
 +----------------------------------+----------------------------+---------------------+
 | Fedora 40                        | 3.12                       | x86-64              |
 +----------------------------------+----------------------------+---------------------+
-| Gentoo                           | 3.9                        | x86-64              |
+| Gentoo                           | 3.12                       | x86-64              |
 +----------------------------------+----------------------------+---------------------+
 | macOS 13 Ventura                 | 3.9                        | x86-64              |
 +----------------------------------+----------------------------+---------------------+

From b94c5c5e3474f915e817d77cd984f62f8fd4399b Mon Sep 17 00:00:00 2001
From: Andrew Murray <radarhere@users.noreply.github.com>
Date: Mon, 30 Sep 2024 19:32:21 +1000
Subject: [PATCH 1124/1178] Updated macOS tested Pillow versions

---
 docs/installation/platform-support.rst | 2 ++
 1 file changed, 2 insertions(+)

diff --git a/docs/installation/platform-support.rst b/docs/installation/platform-support.rst
index f2ef9cacb13..28f74986768 100644
--- a/docs/installation/platform-support.rst
+++ b/docs/installation/platform-support.rst
@@ -75,6 +75,8 @@ These platforms have been reported to work at the versions mentioned.
 | Operating system                 | | Tested Python            | | Latest tested  | | Tested     |
 |                                  | | versions                 | | Pillow version | | processors |
 +==================================+============================+==================+==============+
+| macOS 15 Sequoia                 | 3.8, 3.9, 3.10, 3.11, 3.12 | 10.4.0           |arm           |
++----------------------------------+----------------------------+------------------+--------------+
 | macOS 14 Sonoma                  | 3.8, 3.9, 3.10, 3.11, 3.12 | 10.4.0           |arm           |
 +----------------------------------+----------------------------+------------------+--------------+
 | macOS 13 Ventura                 | 3.8, 3.9, 3.10, 3.11       | 10.0.1           |arm           |

From cc0b6b9de94e7c632efb0a10cf985dd7aab74e2a Mon Sep 17 00:00:00 2001
From: Andrew Murray <radarhere@users.noreply.github.com>
Date: Tue, 24 Sep 2024 07:56:45 +1000
Subject: [PATCH 1125/1178] Cast int before potentially exceeding INT_MAX

---
 src/libImaging/SgiRleDecode.c | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/src/libImaging/SgiRleDecode.c b/src/libImaging/SgiRleDecode.c
index a8db11740af..a4ee2e10d04 100644
--- a/src/libImaging/SgiRleDecode.c
+++ b/src/libImaging/SgiRleDecode.c
@@ -183,7 +183,7 @@ ImagingSgiRleDecode(Imaging im, ImagingCodecState state, UINT8 *buf, Py_ssize_t
        each with 4 bytes per element of tablen
        Check here before we allocate any memory
     */
-    if (c->bufsize < 8 * c->tablen) {
+    if (c->bufsize < 8 * (int64_t)c->tablen) {
         state->errcode = IMAGING_CODEC_OVERRUN;
         return -1;
     }

From fc65e437cfc6ccc381792ca1f35c6afb44c66ec3 Mon Sep 17 00:00:00 2001
From: Andrew Murray <radarhere@users.noreply.github.com>
Date: Mon, 23 Sep 2024 23:25:42 +1000
Subject: [PATCH 1126/1178] Prevent division by zero

---
 src/libImaging/FliDecode.c | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/src/libImaging/FliDecode.c b/src/libImaging/FliDecode.c
index 6b2518d35ce..130ecb7f75d 100644
--- a/src/libImaging/FliDecode.c
+++ b/src/libImaging/FliDecode.c
@@ -224,7 +224,7 @@ ImagingFliDecode(Imaging im, ImagingCodecState state, UINT8 *buf, Py_ssize_t byt
                 break;
             case 16:
                 /* COPY chunk */
-                if (INT32_MAX / state->xsize < state->ysize) {
+                if (INT32_MAX < (uint64_t)state->xsize * state->ysize) {
                     /* Integer overflow, bail */
                     state->errcode = IMAGING_CODEC_OVERRUN;
                     return -1;

From 851449edfc1746a3ad63260db825ab3a2b23d331 Mon Sep 17 00:00:00 2001
From: Andrew Murray <radarhere@users.noreply.github.com>
Date: Tue, 24 Sep 2024 19:14:26 +1000
Subject: [PATCH 1127/1178] Free memory on early return

---
 src/libImaging/SgiRleDecode.c | 1 +
 1 file changed, 1 insertion(+)

diff --git a/src/libImaging/SgiRleDecode.c b/src/libImaging/SgiRleDecode.c
index a8db11740af..c285637dda2 100644
--- a/src/libImaging/SgiRleDecode.c
+++ b/src/libImaging/SgiRleDecode.c
@@ -195,6 +195,7 @@ ImagingSgiRleDecode(Imaging im, ImagingCodecState state, UINT8 *buf, Py_ssize_t
     }
     _imaging_seek_pyFd(state->fd, SGI_HEADER_SIZE, SEEK_SET);
     if (_imaging_read_pyFd(state->fd, (char *)ptr, c->bufsize) != c->bufsize) {
+        free(ptr);
         state->errcode = IMAGING_CODEC_UNKNOWN;
         return -1;
     }

From a99361a38f4c0830205ccbe5d58f1f0ba6c7312c Mon Sep 17 00:00:00 2001
From: Andrew Murray <radarhere@users.noreply.github.com>
Date: Fri, 13 Sep 2024 23:21:35 +1000
Subject: [PATCH 1128/1178] Raise an error if path is compacted during mapping

---
 Tests/test_imagepath.py | 11 +++++++++++
 src/path.c              |  9 +++++++++
 2 files changed, 20 insertions(+)

diff --git a/Tests/test_imagepath.py b/Tests/test_imagepath.py
index cda2584e77b..76bdf1e5f6e 100644
--- a/Tests/test_imagepath.py
+++ b/Tests/test_imagepath.py
@@ -204,6 +204,17 @@ def test_overflow_segfault() -> None:
             x[i] = b"0" * 16
 
 
+def test_compact_within_map() -> None:
+    p = ImagePath.Path([0, 1])
+
+    def map_func(x: float, y: float) -> tuple[float, float]:
+        p.compact()
+        return 0, 0
+
+    with pytest.raises(ValueError):
+        p.map(map_func)
+
+
 class Evil:
     def __init__(self) -> None:
         self.corrupt = Image.core.path(0x4000000000000000)
diff --git a/src/path.c b/src/path.c
index f4f4287f388..067f42f62de 100644
--- a/src/path.c
+++ b/src/path.c
@@ -44,6 +44,7 @@ PyImaging_GetBuffer(PyObject *buffer, Py_buffer *view);
 typedef struct {
     PyObject_HEAD Py_ssize_t count;
     double *xy;
+    int mapping;
 } PyPathObject;
 
 static PyTypeObject PyPathType;
@@ -91,6 +92,7 @@ path_new(Py_ssize_t count, double *xy, int duplicate) {
 
     path->count = count;
     path->xy = xy;
+    path->mapping = 0;
 
     return path;
 }
@@ -276,6 +278,10 @@ path_compact(PyPathObject *self, PyObject *args) {
 
     double cityblock = 2.0;
 
+    if (self->mapping) {
+        PyErr_SetString(PyExc_ValueError, "Path compacted during mapping");
+        return NULL;
+    }
     if (!PyArg_ParseTuple(args, "|d:compact", &cityblock)) {
         return NULL;
     }
@@ -393,11 +399,13 @@ path_map(PyPathObject *self, PyObject *args) {
     xy = self->xy;
 
     /* apply function to coordinate set */
+    self->mapping = 1;
     for (i = 0; i < self->count; i++) {
         double x = xy[i + i];
         double y = xy[i + i + 1];
         PyObject *item = PyObject_CallFunction(function, "dd", x, y);
         if (!item || !PyArg_ParseTuple(item, "dd", &x, &y)) {
+            self->mapping = 0;
             Py_XDECREF(item);
             return NULL;
         }
@@ -405,6 +413,7 @@ path_map(PyPathObject *self, PyObject *args) {
         xy[i + i + 1] = y;
         Py_DECREF(item);
     }
+    self->mapping = 0;
 
     Py_INCREF(Py_None);
     return Py_None;

From c6b08ef32c39dc6517e9140c92dde7e10999da5e Mon Sep 17 00:00:00 2001
From: Andrew Murray <radarhere@users.noreply.github.com>
Date: Mon, 30 Sep 2024 22:13:24 +1000
Subject: [PATCH 1129/1178] Update CHANGES.rst [ci skip]

---
 CHANGES.rst | 3 +++
 1 file changed, 3 insertions(+)

diff --git a/CHANGES.rst b/CHANGES.rst
index b4644c541ef..08c2f26bc26 100644
--- a/CHANGES.rst
+++ b/CHANGES.rst
@@ -5,6 +5,9 @@ Changelog (Pillow)
 11.0.0 (unreleased)
 -------------------
 
+- Check image value before use #8400
+  [radarhere]
+
 - Improved copying imagequant libraries #8420
   [radarhere]
 

From 6fe4375f28015f0c1a7c3cb6fbc9ea3c4f405679 Mon Sep 17 00:00:00 2001
From: Yay295 <Yay295@gmail.com>
Date: Sat, 3 Aug 2024 11:13:38 -0500
Subject: [PATCH 1130/1178] move eps test images to their own folder

Co-authored-by: Andrew Murray <radarhere@users.noreply.github.com>
---
 Tests/images/{ => eps}/1.eps                  | Bin
 Tests/images/{ => eps}/binary_preview_map.eps | Bin
 Tests/images/{ => eps}/create_eps.gnuplot     |   0
 Tests/images/{ => eps}/illu10_no_preview.eps  |   0
 Tests/images/{ => eps}/illu10_preview.eps     | Bin
 Tests/images/{ => eps}/illuCS6_no_preview.eps |   0
 Tests/images/{ => eps}/illuCS6_preview.eps    | Bin
 Tests/images/{ => eps}/non_zero_bb.eps        |   0
 Tests/images/{ => eps}/non_zero_bb.png        | Bin
 Tests/images/{ => eps}/non_zero_bb_scale2.png | Bin
 Tests/images/{ => eps}/pil_sample_cmyk.eps    |   0
 Tests/images/{ => eps}/reqd_showpage.eps      |   0
 Tests/images/{ => eps}/reqd_showpage.png      | Bin
 .../{ => eps}/reqd_showpage_transparency.png  | Bin
 ...75703545fee17acab56e5fec644c19979175de.eps | Bin
 Tests/images/{ => eps}/zero_bb.eps            |   0
 Tests/images/{ => eps}/zero_bb.png            | Bin
 Tests/images/{ => eps}/zero_bb_emptyline.eps  |   0
 .../zero_bb_eof_before_boundingbox.eps        |   0
 Tests/images/{ => eps}/zero_bb_scale2.png     | Bin
 Tests/images/{ => eps}/zero_bb_trailer.eps    |   0
 Tests/test_file_eps.py                        |  48 +++++++++---------
 Tests/test_pickle.py                          |   8 +--
 23 files changed, 29 insertions(+), 27 deletions(-)
 rename Tests/images/{ => eps}/1.eps (100%)
 rename Tests/images/{ => eps}/binary_preview_map.eps (100%)
 rename Tests/images/{ => eps}/create_eps.gnuplot (100%)
 rename Tests/images/{ => eps}/illu10_no_preview.eps (100%)
 rename Tests/images/{ => eps}/illu10_preview.eps (100%)
 rename Tests/images/{ => eps}/illuCS6_no_preview.eps (100%)
 rename Tests/images/{ => eps}/illuCS6_preview.eps (100%)
 rename Tests/images/{ => eps}/non_zero_bb.eps (100%)
 rename Tests/images/{ => eps}/non_zero_bb.png (100%)
 rename Tests/images/{ => eps}/non_zero_bb_scale2.png (100%)
 rename Tests/images/{ => eps}/pil_sample_cmyk.eps (100%)
 rename Tests/images/{ => eps}/reqd_showpage.eps (100%)
 rename Tests/images/{ => eps}/reqd_showpage.png (100%)
 rename Tests/images/{ => eps}/reqd_showpage_transparency.png (100%)
 rename Tests/images/{ => eps}/timeout-d675703545fee17acab56e5fec644c19979175de.eps (100%)
 rename Tests/images/{ => eps}/zero_bb.eps (100%)
 rename Tests/images/{ => eps}/zero_bb.png (100%)
 rename Tests/images/{ => eps}/zero_bb_emptyline.eps (100%)
 rename Tests/images/{ => eps}/zero_bb_eof_before_boundingbox.eps (100%)
 rename Tests/images/{ => eps}/zero_bb_scale2.png (100%)
 rename Tests/images/{ => eps}/zero_bb_trailer.eps (100%)

diff --git a/Tests/images/1.eps b/Tests/images/eps/1.eps
similarity index 100%
rename from Tests/images/1.eps
rename to Tests/images/eps/1.eps
diff --git a/Tests/images/binary_preview_map.eps b/Tests/images/eps/binary_preview_map.eps
similarity index 100%
rename from Tests/images/binary_preview_map.eps
rename to Tests/images/eps/binary_preview_map.eps
diff --git a/Tests/images/create_eps.gnuplot b/Tests/images/eps/create_eps.gnuplot
similarity index 100%
rename from Tests/images/create_eps.gnuplot
rename to Tests/images/eps/create_eps.gnuplot
diff --git a/Tests/images/illu10_no_preview.eps b/Tests/images/eps/illu10_no_preview.eps
similarity index 100%
rename from Tests/images/illu10_no_preview.eps
rename to Tests/images/eps/illu10_no_preview.eps
diff --git a/Tests/images/illu10_preview.eps b/Tests/images/eps/illu10_preview.eps
similarity index 100%
rename from Tests/images/illu10_preview.eps
rename to Tests/images/eps/illu10_preview.eps
diff --git a/Tests/images/illuCS6_no_preview.eps b/Tests/images/eps/illuCS6_no_preview.eps
similarity index 100%
rename from Tests/images/illuCS6_no_preview.eps
rename to Tests/images/eps/illuCS6_no_preview.eps
diff --git a/Tests/images/illuCS6_preview.eps b/Tests/images/eps/illuCS6_preview.eps
similarity index 100%
rename from Tests/images/illuCS6_preview.eps
rename to Tests/images/eps/illuCS6_preview.eps
diff --git a/Tests/images/non_zero_bb.eps b/Tests/images/eps/non_zero_bb.eps
similarity index 100%
rename from Tests/images/non_zero_bb.eps
rename to Tests/images/eps/non_zero_bb.eps
diff --git a/Tests/images/non_zero_bb.png b/Tests/images/eps/non_zero_bb.png
similarity index 100%
rename from Tests/images/non_zero_bb.png
rename to Tests/images/eps/non_zero_bb.png
diff --git a/Tests/images/non_zero_bb_scale2.png b/Tests/images/eps/non_zero_bb_scale2.png
similarity index 100%
rename from Tests/images/non_zero_bb_scale2.png
rename to Tests/images/eps/non_zero_bb_scale2.png
diff --git a/Tests/images/pil_sample_cmyk.eps b/Tests/images/eps/pil_sample_cmyk.eps
similarity index 100%
rename from Tests/images/pil_sample_cmyk.eps
rename to Tests/images/eps/pil_sample_cmyk.eps
diff --git a/Tests/images/reqd_showpage.eps b/Tests/images/eps/reqd_showpage.eps
similarity index 100%
rename from Tests/images/reqd_showpage.eps
rename to Tests/images/eps/reqd_showpage.eps
diff --git a/Tests/images/reqd_showpage.png b/Tests/images/eps/reqd_showpage.png
similarity index 100%
rename from Tests/images/reqd_showpage.png
rename to Tests/images/eps/reqd_showpage.png
diff --git a/Tests/images/reqd_showpage_transparency.png b/Tests/images/eps/reqd_showpage_transparency.png
similarity index 100%
rename from Tests/images/reqd_showpage_transparency.png
rename to Tests/images/eps/reqd_showpage_transparency.png
diff --git a/Tests/images/timeout-d675703545fee17acab56e5fec644c19979175de.eps b/Tests/images/eps/timeout-d675703545fee17acab56e5fec644c19979175de.eps
similarity index 100%
rename from Tests/images/timeout-d675703545fee17acab56e5fec644c19979175de.eps
rename to Tests/images/eps/timeout-d675703545fee17acab56e5fec644c19979175de.eps
diff --git a/Tests/images/zero_bb.eps b/Tests/images/eps/zero_bb.eps
similarity index 100%
rename from Tests/images/zero_bb.eps
rename to Tests/images/eps/zero_bb.eps
diff --git a/Tests/images/zero_bb.png b/Tests/images/eps/zero_bb.png
similarity index 100%
rename from Tests/images/zero_bb.png
rename to Tests/images/eps/zero_bb.png
diff --git a/Tests/images/zero_bb_emptyline.eps b/Tests/images/eps/zero_bb_emptyline.eps
similarity index 100%
rename from Tests/images/zero_bb_emptyline.eps
rename to Tests/images/eps/zero_bb_emptyline.eps
diff --git a/Tests/images/zero_bb_eof_before_boundingbox.eps b/Tests/images/eps/zero_bb_eof_before_boundingbox.eps
similarity index 100%
rename from Tests/images/zero_bb_eof_before_boundingbox.eps
rename to Tests/images/eps/zero_bb_eof_before_boundingbox.eps
diff --git a/Tests/images/zero_bb_scale2.png b/Tests/images/eps/zero_bb_scale2.png
similarity index 100%
rename from Tests/images/zero_bb_scale2.png
rename to Tests/images/eps/zero_bb_scale2.png
diff --git a/Tests/images/zero_bb_trailer.eps b/Tests/images/eps/zero_bb_trailer.eps
similarity index 100%
rename from Tests/images/zero_bb_trailer.eps
rename to Tests/images/eps/zero_bb_trailer.eps
diff --git a/Tests/test_file_eps.py b/Tests/test_file_eps.py
index d54deb5158e..89471fb5a34 100644
--- a/Tests/test_file_eps.py
+++ b/Tests/test_file_eps.py
@@ -19,18 +19,18 @@
 HAS_GHOSTSCRIPT = EpsImagePlugin.has_ghostscript()
 
 # Our two EPS test files (they are identical except for their bounding boxes)
-FILE1 = "Tests/images/zero_bb.eps"
-FILE2 = "Tests/images/non_zero_bb.eps"
+FILE1 = "Tests/images/eps/zero_bb.eps"
+FILE2 = "Tests/images/eps/non_zero_bb.eps"
 
 # Due to palletization, we'll need to convert these to RGB after load
-FILE1_COMPARE = "Tests/images/zero_bb.png"
-FILE1_COMPARE_SCALE2 = "Tests/images/zero_bb_scale2.png"
+FILE1_COMPARE = "Tests/images/eps/zero_bb.png"
+FILE1_COMPARE_SCALE2 = "Tests/images/eps/zero_bb_scale2.png"
 
-FILE2_COMPARE = "Tests/images/non_zero_bb.png"
-FILE2_COMPARE_SCALE2 = "Tests/images/non_zero_bb_scale2.png"
+FILE2_COMPARE = "Tests/images/eps/non_zero_bb.png"
+FILE2_COMPARE_SCALE2 = "Tests/images/eps/non_zero_bb_scale2.png"
 
 # EPS test files with binary preview
-FILE3 = "Tests/images/binary_preview_map.eps"
+FILE3 = "Tests/images/eps/binary_preview_map.eps"
 
 # Three unsigned 32bit little-endian values:
 #   0xC6D3D0C5 magic number
@@ -187,7 +187,7 @@ def test_load_long_binary_data(prefix: bytes) -> None:
 )
 @pytest.mark.skipif(not HAS_GHOSTSCRIPT, reason="Ghostscript not available")
 def test_cmyk() -> None:
-    with Image.open("Tests/images/pil_sample_cmyk.eps") as cmyk_image:
+    with Image.open("Tests/images/eps/pil_sample_cmyk.eps") as cmyk_image:
         assert cmyk_image.mode == "CMYK"
         assert cmyk_image.size == (100, 100)
         assert cmyk_image.format == "EPS"
@@ -204,8 +204,8 @@ def test_cmyk() -> None:
 @pytest.mark.skipif(not HAS_GHOSTSCRIPT, reason="Ghostscript not available")
 def test_showpage() -> None:
     # See https://github.com/python-pillow/Pillow/issues/2615
-    with Image.open("Tests/images/reqd_showpage.eps") as plot_image:
-        with Image.open("Tests/images/reqd_showpage.png") as target:
+    with Image.open("Tests/images/eps/reqd_showpage.eps") as plot_image:
+        with Image.open("Tests/images/eps/reqd_showpage.png") as target:
             # should not crash/hang
             plot_image.load()
             # fonts could be slightly different
@@ -214,11 +214,11 @@ def test_showpage() -> None:
 
 @pytest.mark.skipif(not HAS_GHOSTSCRIPT, reason="Ghostscript not available")
 def test_transparency() -> None:
-    with Image.open("Tests/images/reqd_showpage.eps") as plot_image:
+    with Image.open("Tests/images/eps/reqd_showpage.eps") as plot_image:
         plot_image.load(transparency=True)
         assert plot_image.mode == "RGBA"
 
-        with Image.open("Tests/images/reqd_showpage_transparency.png") as target:
+        with Image.open("Tests/images/eps/reqd_showpage_transparency.png") as target:
             # fonts could be slightly different
             assert_image_similar(plot_image, target, 6)
 
@@ -246,7 +246,7 @@ def test_bytesio_object() -> None:
 
 
 def test_1_mode() -> None:
-    with Image.open("Tests/images/1.eps") as im:
+    with Image.open("Tests/images/eps/1.eps") as im:
         assert im.mode == "1"
 
 
@@ -302,7 +302,9 @@ def test_render_scale2() -> None:
 
 
 @pytest.mark.skipif(not HAS_GHOSTSCRIPT, reason="Ghostscript not available")
-@pytest.mark.parametrize("filename", (FILE1, FILE2, "Tests/images/illu10_preview.eps"))
+@pytest.mark.parametrize(
+    "filename", (FILE1, FILE2, "Tests/images/eps/illu10_preview.eps")
+)
 def test_resize(filename: str) -> None:
     with Image.open(filename) as im:
         new_size = (100, 100)
@@ -344,10 +346,10 @@ def test_readline(prefix: bytes, line_ending: bytes) -> None:
 @pytest.mark.parametrize(
     "filename",
     (
-        "Tests/images/illu10_no_preview.eps",
-        "Tests/images/illu10_preview.eps",
-        "Tests/images/illuCS6_no_preview.eps",
-        "Tests/images/illuCS6_preview.eps",
+        "Tests/images/eps/illu10_no_preview.eps",
+        "Tests/images/eps/illu10_preview.eps",
+        "Tests/images/eps/illuCS6_no_preview.eps",
+        "Tests/images/eps/illuCS6_preview.eps",
     ),
 )
 def test_open_eps(filename: str) -> None:
@@ -359,7 +361,7 @@ def test_open_eps(filename: str) -> None:
 @pytest.mark.skipif(not HAS_GHOSTSCRIPT, reason="Ghostscript not available")
 def test_emptyline() -> None:
     # Test file includes an empty line in the header data
-    emptyline_file = "Tests/images/zero_bb_emptyline.eps"
+    emptyline_file = "Tests/images/eps/zero_bb_emptyline.eps"
 
     with Image.open(emptyline_file) as image:
         image.load()
@@ -371,7 +373,7 @@ def test_emptyline() -> None:
 @pytest.mark.timeout(timeout=5)
 @pytest.mark.parametrize(
     "test_file",
-    ["Tests/images/timeout-d675703545fee17acab56e5fec644c19979175de.eps"],
+    ["Tests/images/eps/timeout-d675703545fee17acab56e5fec644c19979175de.eps"],
 )
 def test_timeout(test_file: str) -> None:
     with open(test_file, "rb") as f:
@@ -384,7 +386,7 @@ def test_bounding_box_in_trailer() -> None:
     # Check bounding boxes are parsed in the same way
     # when specified in the header and the trailer
     with (
-        Image.open("Tests/images/zero_bb_trailer.eps") as trailer_image,
+        Image.open("Tests/images/eps/zero_bb_trailer.eps") as trailer_image,
         Image.open(FILE1) as header_image,
     ):
         assert trailer_image.size == header_image.size
@@ -392,12 +394,12 @@ def test_bounding_box_in_trailer() -> None:
 
 def test_eof_before_bounding_box() -> None:
     with pytest.raises(OSError):
-        with Image.open("Tests/images/zero_bb_eof_before_boundingbox.eps"):
+        with Image.open("Tests/images/eps/zero_bb_eof_before_boundingbox.eps"):
             pass
 
 
 def test_invalid_data_after_eof() -> None:
-    with open("Tests/images/illuCS6_preview.eps", "rb") as f:
+    with open("Tests/images/eps/illuCS6_preview.eps", "rb") as f:
         img_bytes = io.BytesIO(f.read() + b"\r\n%" + (b" " * 255))
 
     with Image.open(img_bytes) as img:
diff --git a/Tests/test_pickle.py b/Tests/test_pickle.py
index be143e9c6f0..d250ba36965 100644
--- a/Tests/test_pickle.py
+++ b/Tests/test_pickle.py
@@ -56,10 +56,10 @@ def helper_pickle_string(protocol: int, test_file: str, mode: str | None) -> Non
         ),
         ("Tests/images/hopper.tif", None),
         ("Tests/images/test-card.png", None),
-        ("Tests/images/zero_bb.png", None),
-        ("Tests/images/zero_bb_scale2.png", None),
-        ("Tests/images/non_zero_bb.png", None),
-        ("Tests/images/non_zero_bb_scale2.png", None),
+        ("Tests/images/eps/zero_bb.png", None),
+        ("Tests/images/eps/zero_bb_scale2.png", None),
+        ("Tests/images/eps/non_zero_bb.png", None),
+        ("Tests/images/eps/non_zero_bb_scale2.png", None),
         ("Tests/images/p_trns_single.png", None),
         ("Tests/images/pil123p.png", None),
         ("Tests/images/itxt_chunks.png", None),

From 283b41afa033c64ce5baf9643356599240ff6367 Mon Sep 17 00:00:00 2001
From: Yay295 <Yay295@gmail.com>
Date: Sat, 3 Aug 2024 11:47:34 -0500
Subject: [PATCH 1131/1178] test 1.eps size and data

---
 Tests/images/eps/1.bmp | Bin 0 -> 1202 bytes
 Tests/test_file_eps.py |   6 ++++--
 2 files changed, 4 insertions(+), 2 deletions(-)
 create mode 100644 Tests/images/eps/1.bmp

diff --git a/Tests/images/eps/1.bmp b/Tests/images/eps/1.bmp
new file mode 100644
index 0000000000000000000000000000000000000000..194c85784c51ac3e30ea62381102eeca429fe63e
GIT binary patch
literal 1202
zcmZ|PZERCj7zgnGIlJA?O3~Y{V_O;Vu5@!VzEn35gb%0fWo&GkZt!8mC3a&%L`cAw
z1RcgpH?TFE>7*Jn&33my7z%Mgqr{h_4ieBQ8H?zQi7CbpMh&1W;e#yoIc59k={>jS
z_dL(ZxjpBm;m6Nt$hSD%_fYSl9-+?Yqgrq=uf}|_1G%M3g>&J}?a!;hVv|b)`u@Lh
zz9g5+AzgDm72)2kpOgz`P;_7dVXhsT9<6leYq;=)k=*&2tGlEmND;rgC2p1%Ze9D*
zRH-TmYa(_)9A0<cn}J2<@oi0M*7o+1y_%+M4bB#J3^m>5`1VXA5z^^6B(}_LI(p%m
zVoCNl6^sjC`zujrc9qK8kPfYR;$)yQtB4Fu=`8rwbK`hwmn1tehLNB%J+=N#wH+w7
zMTy?A{~9Z<>etENz$n8bT6*l(I>RP2Lqy82W$O9#Ss3IM7CX&fJ$i{HSBHr3OIWe%
zK41G;bD6RWiDZq-SND41zGKQCjk&uj%zrM*i9~}kEWNAh#d|LItgL-sQB={bbM5ua
zTW^S{vd+ZkBJxFlKtv@OhHhMCqq!a2UOLJCHul<F-O9e*2Bl4))f?P!;o|)xFR1eJ
zTHWpGdii#bFas)2ZMoTe_3OVIH+HDs#{g}zrut@fq@JeI<It4tv#u}a(~Y`8=8$e~
zxRyWg;Ik(t$>72<Xy|1N$9W*8%rKvn?9txp6?~sEu<d)hXzu0@LjjxM7l8&(#gz@0
zH%@Ghkx|I>(i!K6KPQHs%PIr9Bf>{-ub1y;2om(3L|qHsOC@$nWg&jA+QaVd?4R8m
z%^Tb4AfE31VECZQOK5V9zIs>oPxRVkhPr_r=6!$s_)~~alEHY&m(Wk$FhhO8yftC|
z((=TW-%c`18C-taQuJ?8Vrax73A#K7!w&^MKKG<f)=(HpBp+)&FvAAbdek;mTMOe~
zokObvgWJOH)3-`fJ{T$h4?GX={L3`>y?1Of`JKlZN2vRbA$`Tu<0-`3Evk+i91Sz`
zEkRiIMCf)wlbvC$63naCqw{gKkF9Z9IA+;oX&_W~YFRbqYKe$LIDGFF_{q9*Y@i!;
z&fzXX-jYGzkKu%bNaq6(JORy1rFlB&kKw7{Dvj(=^Mlmm=$Fz$g>n|bBNpv4H9bEe
z8L|Z4F-2Ij3<_rG5d}w;VX3nK+73sxIiP{!w3R@Y1-%1(l~Jmb<QQ$Z7gJG6sx|Q+
DTKM^6

literal 0
HcmV?d00001

diff --git a/Tests/test_file_eps.py b/Tests/test_file_eps.py
index 89471fb5a34..f0f235f8145 100644
--- a/Tests/test_file_eps.py
+++ b/Tests/test_file_eps.py
@@ -8,6 +8,7 @@
 from PIL import EpsImagePlugin, Image, UnidentifiedImageError, features
 
 from .helper import (
+    assert_image_equal_tofile,
     assert_image_similar,
     assert_image_similar_tofile,
     hopper,
@@ -245,9 +246,10 @@ def test_bytesio_object() -> None:
         assert_image_similar(img, image1_scale1_compare, 5)
 
 
-def test_1_mode() -> None:
+@pytest.mark.skipif(not HAS_GHOSTSCRIPT, reason="Ghostscript not available")
+def test_1() -> None:
     with Image.open("Tests/images/eps/1.eps") as im:
-        assert im.mode == "1"
+        assert_image_equal_tofile(im, "Tests/images/eps/1.bmp")
 
 
 def test_image_mode_not_supported(tmp_path: Path) -> None:

From 3ccecd91cea6625612ef7e05d485058a7783bf07 Mon Sep 17 00:00:00 2001
From: Yay295 <Yay295@gmail.com>
Date: Sat, 3 Aug 2024 18:04:05 -0500
Subject: [PATCH 1132/1178] convert eps using pnmraw instead of ppmraw This
 lets Ghostscript choose the best device to use (pbmraw, pgmraw, ppmraw) based
 on the image data.

---
 Tests/test_file_eps.py    | 2 +-
 src/PIL/EpsImagePlugin.py | 8 +++++++-
 2 files changed, 8 insertions(+), 2 deletions(-)

diff --git a/Tests/test_file_eps.py b/Tests/test_file_eps.py
index f0f235f8145..bca516a7864 100644
--- a/Tests/test_file_eps.py
+++ b/Tests/test_file_eps.py
@@ -178,7 +178,7 @@ def test_load_long_binary_data(prefix: bytes) -> None:
     data = io.BytesIO(prefix + b"\n".join(simple_eps_file_with_long_binary_data))
     with Image.open(data) as img:
         img.load()
-        assert img.mode == "RGB"
+        assert img.mode == "1"
         assert img.size == (100, 100)
         assert img.format == "EPS"
 
diff --git a/src/PIL/EpsImagePlugin.py b/src/PIL/EpsImagePlugin.py
index dd6ae4a774c..f6c1ea2a596 100644
--- a/src/PIL/EpsImagePlugin.py
+++ b/src/PIL/EpsImagePlugin.py
@@ -121,7 +121,13 @@ def Ghostscript(
                 lengthfile -= len(s)
                 f.write(s)
 
-    device = "pngalpha" if transparency else "ppmraw"
+    if transparency:
+        # "RGBA"
+        device = "pngalpha"
+    else:
+        # "pnmraw" automatically chooses between
+        # PBM ("1"), PGM ("L"), and PPM ("RGB").
+        device = "pnmraw"
 
     # Build Ghostscript command
     command = [

From 00bbd4a5b99447aad9def172a05ab768fe428dd6 Mon Sep 17 00:00:00 2001
From: Yay295 <Yay295@gmail.com>
Date: Sun, 4 Aug 2024 00:48:12 -0500
Subject: [PATCH 1133/1178] use "with Image" instead of closing manually

---
 src/PIL/EpsImagePlugin.py | 9 +++------
 1 file changed, 3 insertions(+), 6 deletions(-)

diff --git a/src/PIL/EpsImagePlugin.py b/src/PIL/EpsImagePlugin.py
index f6c1ea2a596..cbf48de1852 100644
--- a/src/PIL/EpsImagePlugin.py
+++ b/src/PIL/EpsImagePlugin.py
@@ -157,8 +157,9 @@ def Ghostscript(
             startupinfo = subprocess.STARTUPINFO()
             startupinfo.dwFlags |= subprocess.STARTF_USESHOWWINDOW
         subprocess.check_call(command, startupinfo=startupinfo)
-        out_im = Image.open(outfile)
-        out_im.load()
+        with Image.open(outfile) as out_im:
+            out_im.load()
+            return out_im.im.copy()
     finally:
         try:
             os.unlink(outfile)
@@ -167,10 +168,6 @@ def Ghostscript(
         except OSError:
             pass
 
-    im = out_im.im.copy()
-    out_im.close()
-    return im
-
 
 def _accept(prefix: bytes) -> bool:
     return prefix[:4] == b"%!PS" or (len(prefix) >= 4 and i32(prefix) == 0xC6D3D0C5)

From 6b168a3e2bafe1c957de8e9705ec9a17dd62fd84 Mon Sep 17 00:00:00 2001
From: Yay295 <Yay295@gmail.com>
Date: Tue, 6 Aug 2024 21:02:46 -0500
Subject: [PATCH 1134/1178] add EPS test for image with ImageData and
 BoundingBox (atend)

---
 Tests/images/eps/1_atend.eps | Bin 0 -> 45867 bytes
 Tests/test_file_eps.py       |  40 +++++++++++++--------
 src/PIL/EpsImagePlugin.py    |  65 ++++++++++++++++++++++-------------
 3 files changed, 66 insertions(+), 39 deletions(-)
 create mode 100644 Tests/images/eps/1_atend.eps

diff --git a/Tests/images/eps/1_atend.eps b/Tests/images/eps/1_atend.eps
new file mode 100644
index 0000000000000000000000000000000000000000..08f8c4681a90908a2ca3d7695d19f150a5787816
GIT binary patch
literal 45867
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

literal 0
HcmV?d00001

diff --git a/Tests/test_file_eps.py b/Tests/test_file_eps.py
index bca516a7864..94ab5d327e7 100644
--- a/Tests/test_file_eps.py
+++ b/Tests/test_file_eps.py
@@ -127,6 +127,15 @@ def test_binary_header_only() -> None:
         EpsImagePlugin.EpsImageFile(data)
 
 
+@pytest.mark.parametrize("prefix", (b"", simple_binary_header))
+def test_simple_eps_file(prefix: bytes) -> None:
+    data = io.BytesIO(prefix + b"\n".join(simple_eps_file))
+    with Image.open(data) as img:
+        assert img.mode == "RGB"
+        assert img.size == (100, 100)
+        assert img.format == "EPS"
+
+
 @pytest.mark.parametrize("prefix", (b"", simple_binary_header))
 def test_missing_version_comment(prefix: bytes) -> None:
     data = io.BytesIO(prefix + b"\n".join(simple_eps_file_without_version))
@@ -142,23 +151,19 @@ def test_missing_boundingbox_comment(prefix: bytes) -> None:
 
 
 @pytest.mark.parametrize("prefix", (b"", simple_binary_header))
-def test_invalid_boundingbox_comment(prefix: bytes) -> None:
-    data = io.BytesIO(prefix + b"\n".join(simple_eps_file_with_invalid_boundingbox))
+@pytest.mark.parametrize(
+    "file_lines",
+    (
+        simple_eps_file_with_invalid_boundingbox,
+        simple_eps_file_with_invalid_boundingbox_valid_imagedata,
+    ),
+)
+def test_invalid_boundingbox_comment(prefix: bytes, file_lines: list[bytes]) -> None:
+    data = io.BytesIO(prefix + b"\n".join(file_lines))
     with pytest.raises(OSError, match="cannot determine EPS bounding box"):
         EpsImagePlugin.EpsImageFile(data)
 
 
-@pytest.mark.parametrize("prefix", (b"", simple_binary_header))
-def test_invalid_boundingbox_comment_valid_imagedata_comment(prefix: bytes) -> None:
-    data = io.BytesIO(
-        prefix + b"\n".join(simple_eps_file_with_invalid_boundingbox_valid_imagedata)
-    )
-    with Image.open(data) as img:
-        assert img.mode == "RGB"
-        assert img.size == (100, 100)
-        assert img.format == "EPS"
-
-
 @pytest.mark.parametrize("prefix", (b"", simple_binary_header))
 def test_ascii_comment_too_long(prefix: bytes) -> None:
     data = io.BytesIO(prefix + b"\n".join(simple_eps_file_with_long_ascii_comment))
@@ -247,8 +252,13 @@ def test_bytesio_object() -> None:
 
 
 @pytest.mark.skipif(not HAS_GHOSTSCRIPT, reason="Ghostscript not available")
-def test_1() -> None:
-    with Image.open("Tests/images/eps/1.eps") as im:
+@pytest.mark.parametrize(
+    # These images have an "ImageData" descriptor.
+    "filename",
+    ("Tests/images/eps/1.eps", "Tests/images/eps/1_atend.eps"),
+)
+def test_1(filename: str) -> None:
+    with Image.open(filename) as im:
         assert_image_equal_tofile(im, "Tests/images/eps/1.bmp")
 
 
diff --git a/src/PIL/EpsImagePlugin.py b/src/PIL/EpsImagePlugin.py
index cbf48de1852..ce8e54908a8 100644
--- a/src/PIL/EpsImagePlugin.py
+++ b/src/PIL/EpsImagePlugin.py
@@ -194,6 +194,11 @@ def _open(self) -> None:
 
         self._mode = "RGB"
 
+        # When reading header comments, the first comment is used.
+        # When reading trailer comments, the last comment is used.
+        bounding_box: list[int] | None = None
+        imagedata_size: tuple[int, int] | None = None
+
         byte_arr = bytearray(255)
         bytes_mv = memoryview(byte_arr)
         bytes_read = 0
@@ -214,8 +219,8 @@ def check_required_header_comments() -> None:
                 msg = 'EPS header missing "%%BoundingBox" comment'
                 raise SyntaxError(msg)
 
-        def _read_comment(s: str) -> bool:
-            nonlocal reading_trailer_comments
+        def read_comment(s: str) -> bool:
+            nonlocal bounding_box, reading_trailer_comments
             try:
                 m = split.match(s)
             except re.error as e:
@@ -230,18 +235,12 @@ def _read_comment(s: str) -> bool:
             if k == "BoundingBox":
                 if v == "(atend)":
                     reading_trailer_comments = True
-                elif not self.tile or (trailer_reached and reading_trailer_comments):
+                elif not bounding_box or (trailer_reached and reading_trailer_comments):
                     try:
                         # Note: The DSC spec says that BoundingBox
                         # fields should be integers, but some drivers
                         # put floating point values there anyway.
-                        box = [int(float(i)) for i in v.split()]
-                        self._size = box[2] - box[0], box[3] - box[1]
-                        self.tile = [
-                            ImageFile._Tile(
-                                "eps", (0, 0) + self.size, offset, (length, box)
-                            )
-                        ]
+                        bounding_box = [int(float(i)) for i in v.split()]
                     except Exception:
                         pass
             return True
@@ -292,7 +291,7 @@ def _read_comment(s: str) -> bool:
                     continue
 
                 s = str(bytes_mv[:bytes_read], "latin-1")
-                if not _read_comment(s):
+                if not read_comment(s):
                     m = field.match(s)
                     if m:
                         k = m.group(1)
@@ -326,32 +325,50 @@ def _read_comment(s: str) -> bool:
                     int(value) for value in image_data_values[:4]
                 )
 
-                if bit_depth == 1:
-                    self._mode = "1"
-                elif bit_depth == 8:
-                    try:
-                        self._mode = self.mode_map[mode_id]
-                    except ValueError:
-                        break
-                else:
-                    break
+                if not imagedata_size:
+                    imagedata_size = columns, rows
 
-                self._size = columns, rows
-                return
+                    if bit_depth == 1:
+                        self._mode = "1"
+                    elif bit_depth == 8:
+                        try:
+                            self._mode = self.mode_map[mode_id]
+                        except ValueError:
+                            pass
             elif bytes_mv[:5] == b"%%EOF":
                 break
             elif trailer_reached and reading_trailer_comments:
                 # Load EPS trailer
                 s = str(bytes_mv[:bytes_read], "latin-1")
-                _read_comment(s)
+                read_comment(s)
             elif bytes_mv[:9] == b"%%Trailer":
                 trailer_reached = True
             bytes_read = 0
 
-        if not self.tile:
+        # A "BoundingBox" is always required,
+        # even if an "ImageData" descriptor size exists.
+        if not bounding_box:
             msg = "cannot determine EPS bounding box"
             raise OSError(msg)
 
+        # An "ImageData" size takes precedence over the "BoundingBox".
+        if imagedata_size:
+            self._size = imagedata_size
+        else:
+            self._size = (
+                bounding_box[2] - bounding_box[0],
+                bounding_box[3] - bounding_box[1],
+            )
+
+        self.tile = [
+            ImageFile._Tile(
+                codec_name="eps",
+                extents=(0, 0) + self._size,
+                offset=offset,
+                args=(length, bounding_box),
+            )
+        ]
+
     def _find_offset(self, fp: IO[bytes]) -> tuple[int, int]:
         s = fp.read(4)
 

From 56e4ad0dea6bcfcfa5ce8e0af07a512fd7f5a392 Mon Sep 17 00:00:00 2001
From: Yay295 <Yay295@gmail.com>
Date: Mon, 19 Aug 2024 19:24:30 -0500
Subject: [PATCH 1135/1178] don't name positional arguments

---
 src/PIL/EpsImagePlugin.py | 7 +------
 1 file changed, 1 insertion(+), 6 deletions(-)

diff --git a/src/PIL/EpsImagePlugin.py b/src/PIL/EpsImagePlugin.py
index ce8e54908a8..44391fcb194 100644
--- a/src/PIL/EpsImagePlugin.py
+++ b/src/PIL/EpsImagePlugin.py
@@ -361,12 +361,7 @@ def read_comment(s: str) -> bool:
             )
 
         self.tile = [
-            ImageFile._Tile(
-                codec_name="eps",
-                extents=(0, 0) + self._size,
-                offset=offset,
-                args=(length, bounding_box),
-            )
+            ImageFile._Tile("eps", (0, 0) + self._size, offset, (length, bounding_box))
         ]
 
     def _find_offset(self, fp: IO[bytes]) -> tuple[int, int]:

From f3fe22d2f2345ed0e3eed9dc89a0cd1df728af9e Mon Sep 17 00:00:00 2001
From: Andrew Murray <radarhere@users.noreply.github.com>
Date: Tue, 3 Sep 2024 23:22:35 +1000
Subject: [PATCH 1136/1178] Break if the bit depth or mode id are unknown

---
 src/PIL/EpsImagePlugin.py | 23 ++++++++++++++---------
 1 file changed, 14 insertions(+), 9 deletions(-)

diff --git a/src/PIL/EpsImagePlugin.py b/src/PIL/EpsImagePlugin.py
index 44391fcb194..c7b1f216494 100644
--- a/src/PIL/EpsImagePlugin.py
+++ b/src/PIL/EpsImagePlugin.py
@@ -320,21 +320,26 @@ def read_comment(s: str) -> bool:
                 # binary/ascii (1: binary, 2: ascii)
                 # data start identifier (the image data follows after a single line
                 #   consisting only of this quoted value)
+                if imagedata_size:
+                    bytes_read = 0
+                    continue
+
                 image_data_values = byte_arr[11:bytes_read].split(None, 7)
                 columns, rows, bit_depth, mode_id = (
                     int(value) for value in image_data_values[:4]
                 )
 
-                if not imagedata_size:
-                    imagedata_size = columns, rows
+                if bit_depth == 1:
+                    self._mode = "1"
+                elif bit_depth == 8:
+                    try:
+                        self._mode = self.mode_map[mode_id]
+                    except ValueError:
+                        break
+                else:
+                    break
 
-                    if bit_depth == 1:
-                        self._mode = "1"
-                    elif bit_depth == 8:
-                        try:
-                            self._mode = self.mode_map[mode_id]
-                        except ValueError:
-                            pass
+                imagedata_size = columns, rows
             elif bytes_mv[:5] == b"%%EOF":
                 break
             elif trailer_reached and reading_trailer_comments:

From 75286a4e408f363ee8befc36d0ba082fa25fbd32 Mon Sep 17 00:00:00 2001
From: Yay295 <Yay295@gmail.com>
Date: Tue, 3 Sep 2024 09:03:37 -0500
Subject: [PATCH 1137/1178] add some comments

---
 src/PIL/EpsImagePlugin.py | 12 ++++++++----
 1 file changed, 8 insertions(+), 4 deletions(-)

diff --git a/src/PIL/EpsImagePlugin.py b/src/PIL/EpsImagePlugin.py
index c7b1f216494..da0bf31533a 100644
--- a/src/PIL/EpsImagePlugin.py
+++ b/src/PIL/EpsImagePlugin.py
@@ -310,6 +310,12 @@ def read_comment(s: str) -> bool:
                 # Check for an "ImageData" descriptor
                 # https://www.adobe.com/devnet-apps/photoshop/fileformatashtml/#50577413_pgfId-1035096
 
+                # If we've already read an "ImageData" descriptor,
+                # don't read another one.
+                if imagedata_size:
+                    bytes_read = 0
+                    continue
+
                 # Values:
                 # columns
                 # rows
@@ -320,10 +326,6 @@ def read_comment(s: str) -> bool:
                 # binary/ascii (1: binary, 2: ascii)
                 # data start identifier (the image data follows after a single line
                 #   consisting only of this quoted value)
-                if imagedata_size:
-                    bytes_read = 0
-                    continue
-
                 image_data_values = byte_arr[11:bytes_read].split(None, 7)
                 columns, rows, bit_depth, mode_id = (
                     int(value) for value in image_data_values[:4]
@@ -339,6 +341,8 @@ def read_comment(s: str) -> bool:
                 else:
                     break
 
+                # Read the columns and rows after checking the bit depth and mode
+                # in case the bit depth and/or mode are invalid.
                 imagedata_size = columns, rows
             elif bytes_mv[:5] == b"%%EOF":
                 break

From 782f0e8a5a8e61073ea2686e722e0575bbe09b6b Mon Sep 17 00:00:00 2001
From: Yay295 <Yay295@users.noreply.github.com>
Date: Tue, 10 Sep 2024 08:31:01 -0500
Subject: [PATCH 1138/1178] change "Read" to "Parse" in comment

Co-authored-by: Andrew Murray <3112309+radarhere@users.noreply.github.com>
---
 src/PIL/EpsImagePlugin.py | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/src/PIL/EpsImagePlugin.py b/src/PIL/EpsImagePlugin.py
index da0bf31533a..1c1b6e0b567 100644
--- a/src/PIL/EpsImagePlugin.py
+++ b/src/PIL/EpsImagePlugin.py
@@ -341,7 +341,7 @@ def read_comment(s: str) -> bool:
                 else:
                     break
 
-                # Read the columns and rows after checking the bit depth and mode
+                # Parse the columns and rows after checking the bit depth and mode
                 # in case the bit depth and/or mode are invalid.
                 imagedata_size = columns, rows
             elif bytes_mv[:5] == b"%%EOF":

From 4bfc77a1b12198d1f8b688fc2037e26059f80ab3 Mon Sep 17 00:00:00 2001
From: "renovate[bot]" <29139614+renovate[bot]@users.noreply.github.com>
Date: Mon, 30 Sep 2024 20:19:02 +0000
Subject: [PATCH 1139/1178] Update scientific-python/upload-nightly-action
 action to v0.6.1

---
 .github/workflows/wheels.yml | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/.github/workflows/wheels.yml b/.github/workflows/wheels.yml
index ee0c331660a..1f5265bf580 100644
--- a/.github/workflows/wheels.yml
+++ b/.github/workflows/wheels.yml
@@ -278,7 +278,7 @@ jobs:
           path: dist
           merge-multiple: true
       - name: Upload wheels to scientific-python-nightly-wheels
-        uses: scientific-python/upload-nightly-action@ccf29c805b5d0c1dc31fa97fcdb962be074cade3 # 0.6.0
+        uses: scientific-python/upload-nightly-action@82396a2ed4269ba06c6b2988bb4fd568ef3c3d6b # 0.6.1
         with:
           artifacts_path: dist
           anaconda_nightly_upload_token: ${{ secrets.ANACONDA_ORG_UPLOAD_TOKEN }}

From 749bec097ca48bb70f12bf3b5a78cd4d64e91fc9 Mon Sep 17 00:00:00 2001
From: Andrew Murray <radarhere@users.noreply.github.com>
Date: Tue, 1 Oct 2024 07:11:24 +1000
Subject: [PATCH 1140/1178] Do not convert image unnecessarily

---
 src/PIL/ImageEnhance.py | 18 ++++++++++++------
 1 file changed, 12 insertions(+), 6 deletions(-)

diff --git a/src/PIL/ImageEnhance.py b/src/PIL/ImageEnhance.py
index d7e99a96815..0e7e6dd8ae6 100644
--- a/src/PIL/ImageEnhance.py
+++ b/src/PIL/ImageEnhance.py
@@ -55,7 +55,9 @@ def __init__(self, image: Image.Image) -> None:
         if "A" in image.getbands():
             self.intermediate_mode = "LA"
 
-        self.degenerate = image.convert(self.intermediate_mode).convert(image.mode)
+        if self.intermediate_mode != image.mode:
+            image = image.convert(self.intermediate_mode).convert(image.mode)
+        self.degenerate = image
 
 
 class Contrast(_Enhance):
@@ -68,11 +70,15 @@ class Contrast(_Enhance):
 
     def __init__(self, image: Image.Image) -> None:
         self.image = image
-        mean = int(ImageStat.Stat(image.convert("L")).mean[0] + 0.5)
-        self.degenerate = Image.new("L", image.size, mean).convert(image.mode)
-
-        if "A" in image.getbands():
-            self.degenerate.putalpha(image.getchannel("A"))
+        if image.mode != "L":
+            image = image.convert("L")
+        mean = int(ImageStat.Stat(image).mean[0] + 0.5)
+        self.degenerate = Image.new("L", image.size, mean)
+        if self.degenerate.mode != self.image.mode:
+            self.degenerate = self.degenerate.convert(self.image.mode)
+
+        if "A" in self.image.getbands():
+            self.degenerate.putalpha(self.image.getchannel("A"))
 
 
 class Brightness(_Enhance):

From 84b167dfd53fe726a61953040ddbfa0e4e3e3359 Mon Sep 17 00:00:00 2001
From: Andrew Murray <radarhere@users.noreply.github.com>
Date: Tue, 1 Oct 2024 21:11:56 +1000
Subject: [PATCH 1141/1178] Update CHANGES.rst [ci skip]

---
 CHANGES.rst | 9 +++++++++
 1 file changed, 9 insertions(+)

diff --git a/CHANGES.rst b/CHANGES.rst
index 08c2f26bc26..36266421acb 100644
--- a/CHANGES.rst
+++ b/CHANGES.rst
@@ -5,6 +5,15 @@ Changelog (Pillow)
 11.0.0 (unreleased)
 -------------------
 
+- Support all resampling filters when resizing I;16* images #8422
+  [radarhere]
+
+- Free memory on early return #8413
+  [radarhere]
+
+- Cast int before potentially exceeding INT_MAX #8402
+  [radarhere]
+
 - Check image value before use #8400
   [radarhere]
 

From c0d04e8b34f759797e45bccac74f49bddfaa7a41 Mon Sep 17 00:00:00 2001
From: Yay295 <Yay295@users.noreply.github.com>
Date: Tue, 1 Oct 2024 09:33:33 -0500
Subject: [PATCH 1142/1178] use .size instead of ._size

Co-authored-by: Andrew Murray <3112309+radarhere@users.noreply.github.com>
---
 src/PIL/EpsImagePlugin.py | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/src/PIL/EpsImagePlugin.py b/src/PIL/EpsImagePlugin.py
index 1c1b6e0b567..27582f2a84f 100644
--- a/src/PIL/EpsImagePlugin.py
+++ b/src/PIL/EpsImagePlugin.py
@@ -370,7 +370,7 @@ def read_comment(s: str) -> bool:
             )
 
         self.tile = [
-            ImageFile._Tile("eps", (0, 0) + self._size, offset, (length, bounding_box))
+            ImageFile._Tile("eps", (0, 0) + self.size, offset, (length, bounding_box))
         ]
 
     def _find_offset(self, fp: IO[bytes]) -> tuple[int, int]:

From f9c69deaae2e029601dddba48268fadf630a18eb Mon Sep 17 00:00:00 2001
From: Yay295 <Yay295@users.noreply.github.com>
Date: Tue, 1 Oct 2024 09:35:22 -0500
Subject: [PATCH 1143/1178] simplify setting self._size

Co-authored-by: Andrew Murray <3112309+radarhere@users.noreply.github.com>
---
 src/PIL/EpsImagePlugin.py | 11 ++++-------
 1 file changed, 4 insertions(+), 7 deletions(-)

diff --git a/src/PIL/EpsImagePlugin.py b/src/PIL/EpsImagePlugin.py
index 27582f2a84f..fb1e301c084 100644
--- a/src/PIL/EpsImagePlugin.py
+++ b/src/PIL/EpsImagePlugin.py
@@ -361,13 +361,10 @@ def read_comment(s: str) -> bool:
             raise OSError(msg)
 
         # An "ImageData" size takes precedence over the "BoundingBox".
-        if imagedata_size:
-            self._size = imagedata_size
-        else:
-            self._size = (
-                bounding_box[2] - bounding_box[0],
-                bounding_box[3] - bounding_box[1],
-            )
+        self._size = imagedata_size or (
+            bounding_box[2] - bounding_box[0],
+            bounding_box[3] - bounding_box[1],
+        )
 
         self.tile = [
             ImageFile._Tile("eps", (0, 0) + self.size, offset, (length, bounding_box))

From baf2d8160a5c1ec0c1ce1c64ea70ded2e5581495 Mon Sep 17 00:00:00 2001
From: Andrew Murray <radarhere@users.noreply.github.com>
Date: Wed, 2 Oct 2024 09:48:09 +1000
Subject: [PATCH 1144/1178] Updated xz to 5.6.3

---
 .github/workflows/wheels-dependencies.sh | 2 +-
 winbuild/build_prepare.py                | 8 ++++----
 2 files changed, 5 insertions(+), 5 deletions(-)

diff --git a/.github/workflows/wheels-dependencies.sh b/.github/workflows/wheels-dependencies.sh
index b3996d5a110..19eb91cbbf4 100755
--- a/.github/workflows/wheels-dependencies.sh
+++ b/.github/workflows/wheels-dependencies.sh
@@ -20,7 +20,7 @@ HARFBUZZ_VERSION=10.0.1
 LIBPNG_VERSION=1.6.44
 JPEGTURBO_VERSION=3.0.4
 OPENJPEG_VERSION=2.5.2
-XZ_VERSION=5.6.2
+XZ_VERSION=5.6.3
 TIFF_VERSION=4.6.0
 LCMS2_VERSION=2.16
 if [[ -n "$IS_MACOS" ]]; then
diff --git a/winbuild/build_prepare.py b/winbuild/build_prepare.py
index 026d9d30695..a21fbef9148 100644
--- a/winbuild/build_prepare.py
+++ b/winbuild/build_prepare.py
@@ -119,7 +119,7 @@ def cmd_msbuild(
     "LIBWEBP": "1.4.0",
     "OPENJPEG": "2.5.2",
     "TIFF": "4.6.0",
-    "XZ": "5.6.2",
+    "XZ": "5.6.3",
     "ZLIB": "1.3.1",
 }
 V["LIBPNG_DOTLESS"] = V["LIBPNG"].replace(".", "")
@@ -185,7 +185,7 @@ def cmd_msbuild(
             cmd_copy(r"src\liblzma\api\lzma\*.h", r"{inc_dir}\lzma"),
         ],
         "headers": [r"src\liblzma\api\lzma.h"],
-        "libs": [r"liblzma.lib"],
+        "libs": [r"lzma.lib"],
     },
     "libwebp": {
         "url": f"http://downloads.webmproject.org/releases/webp/libwebp-{V['LIBWEBP']}.tar.gz",
@@ -216,8 +216,8 @@ def cmd_msbuild(
         "license": "LICENSE.md",
         "patch": {
             r"libtiff\tif_lzma.c": {
-                # link against liblzma.lib
-                "#ifdef LZMA_SUPPORT": '#ifdef LZMA_SUPPORT\n#pragma comment(lib, "liblzma.lib")',  # noqa: E501
+                # link against lzma.lib
+                "#ifdef LZMA_SUPPORT": '#ifdef LZMA_SUPPORT\n#pragma comment(lib, "lzma.lib")',  # noqa: E501
             },
             r"libtiff\tif_webp.c": {
                 # link against libwebp.lib

From 547e7dcc5df0e9bbd05119c9accc9295bfaa0cec Mon Sep 17 00:00:00 2001
From: Andrew Murray <radarhere@users.noreply.github.com>
Date: Wed, 2 Oct 2024 19:17:13 +1000
Subject: [PATCH 1145/1178] Test cifuzz when wheel dependencies change

---
 .github/workflows/cifuzz.yml | 2 ++
 1 file changed, 2 insertions(+)

diff --git a/.github/workflows/cifuzz.yml b/.github/workflows/cifuzz.yml
index eb73fc6a7cd..0456bbaba3c 100644
--- a/.github/workflows/cifuzz.yml
+++ b/.github/workflows/cifuzz.yml
@@ -6,11 +6,13 @@ on:
       - "**"
     paths:
       - ".github/workflows/cifuzz.yml"
+      - ".github/workflows/wheels-dependencies.sh"
       - "**.c"
       - "**.h"
   pull_request:
     paths:
       - ".github/workflows/cifuzz.yml"
+      - ".github/workflows/wheels-dependencies.sh"
       - "**.c"
       - "**.h"
   workflow_dispatch:

From 33f065eb5e458724cdd76dc6074445b4fad9fd7f Mon Sep 17 00:00:00 2001
From: "renovate[bot]" <29139614+renovate[bot]@users.noreply.github.com>
Date: Thu, 3 Oct 2024 00:41:31 +0000
Subject: [PATCH 1146/1178] Update dependency cibuildwheel to v2.21.2

---
 .ci/requirements-cibw.txt | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/.ci/requirements-cibw.txt b/.ci/requirements-cibw.txt
index 7dc3a53fe4d..a1424ecc098 100644
--- a/.ci/requirements-cibw.txt
+++ b/.ci/requirements-cibw.txt
@@ -1 +1 @@
-cibuildwheel==2.21.1
+cibuildwheel==2.21.2

From 07be6fca17fc31b3df87bc8b577822ed5b1de51c Mon Sep 17 00:00:00 2001
From: Andrew Murray <radarhere@users.noreply.github.com>
Date: Fri, 4 Oct 2024 23:26:54 +1000
Subject: [PATCH 1147/1178] Corrected check for BuiltinFilter

---
 Tests/test_image_filter.py | 9 +++++++--
 1 file changed, 7 insertions(+), 2 deletions(-)

diff --git a/Tests/test_image_filter.py b/Tests/test_image_filter.py
index 412ab44c3c1..5a22738a95c 100644
--- a/Tests/test_image_filter.py
+++ b/Tests/test_image_filter.py
@@ -36,9 +36,14 @@
     ),
 )
 @pytest.mark.parametrize("mode", ("L", "I", "RGB", "CMYK"))
-def test_sanity(filter_to_apply: ImageFilter.Filter, mode: str) -> None:
+def test_sanity(
+    filter_to_apply: ImageFilter.Filter | type[ImageFilter.Filter], mode: str
+) -> None:
     im = hopper(mode)
-    if mode != "I" or isinstance(filter_to_apply, ImageFilter.BuiltinFilter):
+    if mode != "I" or (
+        callable(filter_to_apply)
+        and issubclass(filter_to_apply, ImageFilter.BuiltinFilter)
+    ):
         out = im.filter(filter_to_apply)
         assert out.mode == im.mode
         assert out.size == im.size

From 418ae7caa28d3ecb88f6cfaf1fb1a27b544794a8 Mon Sep 17 00:00:00 2001
From: Andrew Murray <radarhere@users.noreply.github.com>
Date: Sat, 5 Oct 2024 01:12:51 +1000
Subject: [PATCH 1148/1178] Support BuiltinFilter for I;16* images

---
 Tests/test_image_filter.py |  18 +++++--
 src/libImaging/Filter.c    | 106 ++++++++++++++++++++++++++++++++-----
 2 files changed, 105 insertions(+), 19 deletions(-)

diff --git a/Tests/test_image_filter.py b/Tests/test_image_filter.py
index 5a22738a95c..e566cd0557a 100644
--- a/Tests/test_image_filter.py
+++ b/Tests/test_image_filter.py
@@ -35,12 +35,14 @@
         ImageFilter.UnsharpMask(10),
     ),
 )
-@pytest.mark.parametrize("mode", ("L", "I", "RGB", "CMYK"))
+@pytest.mark.parametrize(
+    "mode", ("L", "I", "I;16", "I;16L", "I;16B", "I;16N", "RGB", "CMYK")
+)
 def test_sanity(
     filter_to_apply: ImageFilter.Filter | type[ImageFilter.Filter], mode: str
 ) -> None:
     im = hopper(mode)
-    if mode != "I" or (
+    if mode[0] != "I" or (
         callable(filter_to_apply)
         and issubclass(filter_to_apply, ImageFilter.BuiltinFilter)
     ):
@@ -49,7 +51,9 @@ def test_sanity(
         assert out.size == im.size
 
 
-@pytest.mark.parametrize("mode", ("L", "I", "RGB", "CMYK"))
+@pytest.mark.parametrize(
+    "mode", ("L", "I", "I;16", "I;16L", "I;16B", "I;16N", "RGB", "CMYK")
+)
 def test_sanity_error(mode: str) -> None:
     im = hopper(mode)
     with pytest.raises(TypeError):
@@ -150,7 +154,9 @@ def test_kernel_not_enough_coefficients() -> None:
         ImageFilter.Kernel((3, 3), (0, 0))
 
 
-@pytest.mark.parametrize("mode", ("L", "LA", "I", "RGB", "CMYK"))
+@pytest.mark.parametrize(
+    "mode", ("L", "LA", "I", "I;16", "I;16L", "I;16B", "I;16N", "RGB", "CMYK")
+)
 def test_consistency_3x3(mode: str) -> None:
     with Image.open("Tests/images/hopper.bmp") as source:
         with Image.open("Tests/images/hopper_emboss.bmp") as reference:
@@ -166,7 +172,9 @@ def test_consistency_3x3(mode: str) -> None:
             assert_image_equal(source.filter(kernel), reference)
 
 
-@pytest.mark.parametrize("mode", ("L", "LA", "I", "RGB", "CMYK"))
+@pytest.mark.parametrize(
+    "mode", ("L", "LA", "I", "I;16", "I;16L", "I;16B", "I;16N", "RGB", "CMYK")
+)
 def test_consistency_5x5(mode: str) -> None:
     with Image.open("Tests/images/hopper.bmp") as source:
         with Image.open("Tests/images/hopper_emboss_more.bmp") as reference:
diff --git a/src/libImaging/Filter.c b/src/libImaging/Filter.c
index fbd6b425f12..7b7b2e4292d 100644
--- a/src/libImaging/Filter.c
+++ b/src/libImaging/Filter.c
@@ -26,6 +26,8 @@
 
 #include "Imaging.h"
 
+#define ROUND_UP(f) ((int)((f) >= 0.0 ? (f) + 0.5F : (f) - 0.5F))
+
 static inline UINT8
 clip8(float in) {
     if (in <= 0.0) {
@@ -105,6 +107,22 @@ ImagingExpand(Imaging imIn, int xmargin, int ymargin) {
     return imOut;
 }
 
+float
+kernel_i16(int size, UINT8 *in0, int x, const float *kernel, int bigendian) {
+    int i;
+    float result = 0;
+    int half_size = (size - 1) / 2;
+    for (i = 0; i < size; i++) {
+        int x1 = x + i - half_size;
+        result += _i2f(
+                      in0[x1 * 2 + (bigendian ? 1 : 0)] +
+                      (in0[x1 * 2 + (bigendian ? 0 : 1)] >> 8)
+                  ) *
+                  kernel[i];
+    }
+    return result;
+}
+
 void
 ImagingFilter3x3(Imaging imOut, Imaging im, const float *kernel, float offset) {
 #define KERNEL1x3(in0, x, kernel, d)                               \
@@ -135,6 +153,16 @@ ImagingFilter3x3(Imaging imOut, Imaging im, const float *kernel, float offset) {
                 out[x] = in0[x];
             }
         } else {
+            int bigendian = 0;
+            if (im->type == IMAGING_TYPE_SPECIAL) {
+                if (strcmp(im->mode, "I;16B") == 0
+#ifdef WORDS_BIGENDIAN
+                    || strcmp(im->mode, "I;16N") == 0
+#endif
+                ) {
+                    bigendian = 1;
+                }
+            }
             for (y = 1; y < im->ysize - 1; y++) {
                 UINT8 *in_1 = (UINT8 *)im->image[y - 1];
                 UINT8 *in0 = (UINT8 *)im->image[y];
@@ -142,14 +170,31 @@ ImagingFilter3x3(Imaging imOut, Imaging im, const float *kernel, float offset) {
                 UINT8 *out = (UINT8 *)imOut->image[y];
 
                 out[0] = in0[0];
+                if (im->type == IMAGING_TYPE_SPECIAL) {
+                    out[1] = in0[1];
+                }
                 for (x = 1; x < im->xsize - 1; x++) {
                     float ss = offset;
-                    ss += KERNEL1x3(in1, x, &kernel[0], 1);
-                    ss += KERNEL1x3(in0, x, &kernel[3], 1);
-                    ss += KERNEL1x3(in_1, x, &kernel[6], 1);
-                    out[x] = clip8(ss);
+                    if (im->type == IMAGING_TYPE_SPECIAL) {
+                        ss += kernel_i16(3, in1, x, &kernel[0], bigendian);
+                        ss += kernel_i16(3, in0, x, &kernel[3], bigendian);
+                        ss += kernel_i16(3, in_1, x, &kernel[6], bigendian);
+                        int ss_int = ROUND_UP(ss);
+                        out[x * 2 + (bigendian ? 1 : 0)] = clip8(ss_int % 256);
+                        out[x * 2 + (bigendian ? 0 : 1)] = clip8(ss_int >> 8);
+                    } else {
+                        ss += KERNEL1x3(in1, x, &kernel[0], 1);
+                        ss += KERNEL1x3(in0, x, &kernel[3], 1);
+                        ss += KERNEL1x3(in_1, x, &kernel[6], 1);
+                        out[x] = clip8(ss);
+                    }
+                }
+                if (im->type == IMAGING_TYPE_SPECIAL) {
+                    out[x * 2] = in0[x * 2];
+                    out[x * 2 + 1] = in0[x * 2 + 1];
+                } else {
+                    out[x] = in0[x];
                 }
-                out[x] = in0[x];
             }
         }
     } else {
@@ -261,6 +306,16 @@ ImagingFilter5x5(Imaging imOut, Imaging im, const float *kernel, float offset) {
                 out[x + 1] = in0[x + 1];
             }
         } else {
+            int bigendian = 0;
+            if (im->type == IMAGING_TYPE_SPECIAL) {
+                if (strcmp(im->mode, "I;16B") == 0
+#ifdef WORDS_BIGENDIAN
+                    || strcmp(im->mode, "I;16N") == 0
+#endif
+                ) {
+                    bigendian = 1;
+                }
+            }
             for (y = 2; y < im->ysize - 2; y++) {
                 UINT8 *in_2 = (UINT8 *)im->image[y - 2];
                 UINT8 *in_1 = (UINT8 *)im->image[y - 1];
@@ -271,17 +326,39 @@ ImagingFilter5x5(Imaging imOut, Imaging im, const float *kernel, float offset) {
 
                 out[0] = in0[0];
                 out[1] = in0[1];
+                if (im->type == IMAGING_TYPE_SPECIAL) {
+                    out[2] = in0[2];
+                    out[3] = in0[3];
+                }
                 for (x = 2; x < im->xsize - 2; x++) {
                     float ss = offset;
-                    ss += KERNEL1x5(in2, x, &kernel[0], 1);
-                    ss += KERNEL1x5(in1, x, &kernel[5], 1);
-                    ss += KERNEL1x5(in0, x, &kernel[10], 1);
-                    ss += KERNEL1x5(in_1, x, &kernel[15], 1);
-                    ss += KERNEL1x5(in_2, x, &kernel[20], 1);
-                    out[x] = clip8(ss);
+                    if (im->type == IMAGING_TYPE_SPECIAL) {
+                        ss += kernel_i16(5, in2, x, &kernel[0], bigendian);
+                        ss += kernel_i16(5, in1, x, &kernel[5], bigendian);
+                        ss += kernel_i16(5, in0, x, &kernel[10], bigendian);
+                        ss += kernel_i16(5, in_1, x, &kernel[15], bigendian);
+                        ss += kernel_i16(5, in_2, x, &kernel[20], bigendian);
+                        int ss_int = ROUND_UP(ss);
+                        out[x * 2 + (bigendian ? 1 : 0)] = clip8(ss_int % 256);
+                        out[x * 2 + (bigendian ? 0 : 1)] = clip8(ss_int >> 8);
+                    } else {
+                        ss += KERNEL1x5(in2, x, &kernel[0], 1);
+                        ss += KERNEL1x5(in1, x, &kernel[5], 1);
+                        ss += KERNEL1x5(in0, x, &kernel[10], 1);
+                        ss += KERNEL1x5(in_1, x, &kernel[15], 1);
+                        ss += KERNEL1x5(in_2, x, &kernel[20], 1);
+                        out[x] = clip8(ss);
+                    }
+                }
+                if (im->type == IMAGING_TYPE_SPECIAL) {
+                    out[x * 2 + 0] = in0[x * 2 + 0];
+                    out[x * 2 + 1] = in0[x * 2 + 1];
+                    out[x * 2 + 2] = in0[x * 2 + 2];
+                    out[x * 2 + 3] = in0[x * 2 + 3];
+                } else {
+                    out[x + 0] = in0[x + 0];
+                    out[x + 1] = in0[x + 1];
                 }
-                out[x + 0] = in0[x + 0];
-                out[x + 1] = in0[x + 1];
             }
         }
     } else {
@@ -383,7 +460,8 @@ ImagingFilter(Imaging im, int xsize, int ysize, const FLOAT32 *kernel, FLOAT32 o
     Imaging imOut;
     ImagingSectionCookie cookie;
 
-    if (im->type != IMAGING_TYPE_UINT8 && im->type != IMAGING_TYPE_INT32) {
+    if (im->type == IMAGING_TYPE_FLOAT32 ||
+        (im->type == IMAGING_TYPE_SPECIAL && im->bands != 1)) {
         return (Imaging)ImagingError_ModeError();
     }
 

From 8e6d518ea89035077fb4a855f61f3b5bab26a9c4 Mon Sep 17 00:00:00 2001
From: Yay295 <Yay295@users.noreply.github.com>
Date: Sat, 5 Oct 2024 08:05:00 -0500
Subject: [PATCH 1149/1178] change parameter type from list to tuple

Co-authored-by: Andrew Murray <3112309+radarhere@users.noreply.github.com>
---
 Tests/test_file_eps.py | 4 +++-
 1 file changed, 3 insertions(+), 1 deletion(-)

diff --git a/Tests/test_file_eps.py b/Tests/test_file_eps.py
index 94ab5d327e7..7ae0900fd46 100644
--- a/Tests/test_file_eps.py
+++ b/Tests/test_file_eps.py
@@ -158,7 +158,9 @@ def test_missing_boundingbox_comment(prefix: bytes) -> None:
         simple_eps_file_with_invalid_boundingbox_valid_imagedata,
     ),
 )
-def test_invalid_boundingbox_comment(prefix: bytes, file_lines: list[bytes]) -> None:
+def test_invalid_boundingbox_comment(
+    prefix: bytes, file_lines: tuple[bytes, ...]
+) -> None:
     data = io.BytesIO(prefix + b"\n".join(file_lines))
     with pytest.raises(OSError, match="cannot determine EPS bounding box"):
         EpsImagePlugin.EpsImageFile(data)

From d4fedc852c2a78b9dc93b67f93d6211f7337ca43 Mon Sep 17 00:00:00 2001
From: Andrew Murray <radarhere@users.noreply.github.com>
Date: Sat, 5 Oct 2024 15:21:42 +1000
Subject: [PATCH 1150/1178] Rename test image

---
 ..._atend.eps => 1_boundingbox_after_imagedata.eps} | Bin
 Tests/test_file_eps.py                              |   2 +-
 2 files changed, 1 insertion(+), 1 deletion(-)
 rename Tests/images/eps/{1_atend.eps => 1_boundingbox_after_imagedata.eps} (100%)

diff --git a/Tests/images/eps/1_atend.eps b/Tests/images/eps/1_boundingbox_after_imagedata.eps
similarity index 100%
rename from Tests/images/eps/1_atend.eps
rename to Tests/images/eps/1_boundingbox_after_imagedata.eps
diff --git a/Tests/test_file_eps.py b/Tests/test_file_eps.py
index 7ae0900fd46..0a69ee6e539 100644
--- a/Tests/test_file_eps.py
+++ b/Tests/test_file_eps.py
@@ -257,7 +257,7 @@ def test_bytesio_object() -> None:
 @pytest.mark.parametrize(
     # These images have an "ImageData" descriptor.
     "filename",
-    ("Tests/images/eps/1.eps", "Tests/images/eps/1_atend.eps"),
+    ("Tests/images/eps/1.eps", "Tests/images/eps/1_boundingbox_after_imagedata.eps"),
 )
 def test_1(filename: str) -> None:
     with Image.open(filename) as im:

From a9cbf6d5a71013124305f05d09b344e3698f2c0c Mon Sep 17 00:00:00 2001
From: Hugo van Kemenade <1324225+hugovk@users.noreply.github.com>
Date: Sun, 18 Aug 2024 20:41:01 +0300
Subject: [PATCH 1151/1178] Test Python 3.13 on AppVeyor

---
 .appveyor.yml | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/.appveyor.yml b/.appveyor.yml
index 41a5725b22b..781ad4a4b1d 100644
--- a/.appveyor.yml
+++ b/.appveyor.yml
@@ -18,7 +18,7 @@ environment:
   TEST_OPTIONS:
   DEPLOY: YES
   matrix:
-  - PYTHON: C:/Python312
+  - PYTHON: C:/Python313
     ARCHITECTURE: x86
     APPVEYOR_BUILD_WORKER_IMAGE: Visual Studio 2022
   - PYTHON: C:/Python39-x64

From 1b57b32caf99f7fb5b9c6b83e439832f5a55dc83 Mon Sep 17 00:00:00 2001
From: Andrew Murray <radarhere@users.noreply.github.com>
Date: Sun, 6 Oct 2024 08:02:17 +1100
Subject: [PATCH 1152/1178] Test ignoring second ImageData

---
 Tests/images/eps/1_second_imagedata.eps | Bin 0 -> 45834 bytes
 Tests/test_file_eps.py                  |   6 +++++-
 2 files changed, 5 insertions(+), 1 deletion(-)
 create mode 100644 Tests/images/eps/1_second_imagedata.eps

diff --git a/Tests/images/eps/1_second_imagedata.eps b/Tests/images/eps/1_second_imagedata.eps
new file mode 100644
index 0000000000000000000000000000000000000000..e6309a3b4ede316d83a2bb84388f1d29140b433f
GIT binary patch
literal 45834
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

literal 0
HcmV?d00001

diff --git a/Tests/test_file_eps.py b/Tests/test_file_eps.py
index 0a69ee6e539..672c04a4d4f 100644
--- a/Tests/test_file_eps.py
+++ b/Tests/test_file_eps.py
@@ -257,7 +257,11 @@ def test_bytesio_object() -> None:
 @pytest.mark.parametrize(
     # These images have an "ImageData" descriptor.
     "filename",
-    ("Tests/images/eps/1.eps", "Tests/images/eps/1_boundingbox_after_imagedata.eps"),
+    (
+        "Tests/images/eps/1.eps",
+        "Tests/images/eps/1_boundingbox_after_imagedata.eps",
+        "Tests/images/eps/1_second_imagedata.eps",
+    ),
 )
 def test_1(filename: str) -> None:
     with Image.open(filename) as im:

From e2f996e2bd9b933a7a88b9ed47e6065a6d5a28b8 Mon Sep 17 00:00:00 2001
From: Andrew Murray <radarhere@users.noreply.github.com>
Date: Sun, 6 Oct 2024 08:55:15 +1100
Subject: [PATCH 1153/1178] Updated CI target

---
 docs/installation/platform-support.rst | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/docs/installation/platform-support.rst b/docs/installation/platform-support.rst
index 0e46ef0c752..00dec41d165 100644
--- a/docs/installation/platform-support.rst
+++ b/docs/installation/platform-support.rst
@@ -53,7 +53,7 @@ These platforms are built and tested for every change.
 | Windows Server 2022              | 3.9, 3.10, 3.11,           | x86-64              |
 |                                  | 3.12, 3.13, PyPy3          |                     |
 |                                  +----------------------------+---------------------+
-|                                  | 3.12                       | x86                 |
+|                                  | 3.13                       | x86                 |
 |                                  +----------------------------+---------------------+
 |                                  | 3.9 (MinGW)                | x86-64              |
 |                                  +----------------------------+---------------------+

From b77cd009e210cefae9424206f80ed5dc65b53fdf Mon Sep 17 00:00:00 2001
From: Andrew Murray <radarhere@users.noreply.github.com>
Date: Sun, 6 Oct 2024 11:30:27 +1100
Subject: [PATCH 1154/1178] Use transparency when combining P frames

---
 Tests/test_file_apng.py   | 4 ++--
 src/PIL/PngImagePlugin.py | 6 ++++++
 2 files changed, 8 insertions(+), 2 deletions(-)

diff --git a/Tests/test_file_apng.py b/Tests/test_file_apng.py
index e95850212a5..ee6c867c3ca 100644
--- a/Tests/test_file_apng.py
+++ b/Tests/test_file_apng.py
@@ -258,8 +258,8 @@ def test_apng_mode() -> None:
         assert im.mode == "P"
         im.seek(im.n_frames - 1)
         im = im.convert("RGBA")
-        assert im.getpixel((0, 0)) == (255, 0, 0, 0)
-        assert im.getpixel((64, 32)) == (255, 0, 0, 0)
+        assert im.getpixel((0, 0)) == (0, 255, 0, 255)
+        assert im.getpixel((64, 32)) == (0, 255, 0, 255)
 
     with Image.open("Tests/images/apng/mode_palette_1bit_alpha.png") as im:
         assert im.mode == "P"
diff --git a/src/PIL/PngImagePlugin.py b/src/PIL/PngImagePlugin.py
index 28ade293e96..4e12272041d 100644
--- a/src/PIL/PngImagePlugin.py
+++ b/src/PIL/PngImagePlugin.py
@@ -1063,6 +1063,12 @@ def load_end(self) -> None:
                         "RGBA", self.info["transparency"]
                     )
                 else:
+                    if self.im.mode == "P" and "transparency" in self.info:
+                        t = self.info["transparency"]
+                        if isinstance(t, bytes):
+                            updated.putpalettealphas(t)
+                        elif isinstance(t, int):
+                            updated.putpalettealpha(t)
                     mask = updated.convert("RGBA")
                 self._prev_im.paste(updated, self.dispose_extent, mask)
                 self.im = self._prev_im

From 27c1bb265432cb5a1138e39165f0610e2d8a4e94 Mon Sep 17 00:00:00 2001
From: Andrew Murray <radarhere@users.noreply.github.com>
Date: Mon, 7 Oct 2024 07:48:32 +1100
Subject: [PATCH 1155/1178] Update CHANGES.rst [ci skip]

---
 CHANGES.rst | 6 ++++++
 1 file changed, 6 insertions(+)

diff --git a/CHANGES.rst b/CHANGES.rst
index 36266421acb..cc891ed1d84 100644
--- a/CHANGES.rst
+++ b/CHANGES.rst
@@ -5,6 +5,12 @@ Changelog (Pillow)
 11.0.0 (unreleased)
 -------------------
 
+- Updated EPS mode when opening images without transparency #8281
+  [Yay295, radarhere]
+
+- Use transparency when combining P frames from APNGs #8443
+  [radarhere]
+
 - Support all resampling filters when resizing I;16* images #8422
   [radarhere]
 

From feeceb9ae629199b69361d698154076734e3902a Mon Sep 17 00:00:00 2001
From: Andrew Murray <radarhere@users.noreply.github.com>
Date: Mon, 7 Oct 2024 15:34:28 +1100
Subject: [PATCH 1156/1178] Simplified code

---
 src/_imagingmorph.c | 7 ++-----
 1 file changed, 2 insertions(+), 5 deletions(-)

diff --git a/src/_imagingmorph.c b/src/_imagingmorph.c
index 614dfbe7fe7..fc35107b5eb 100644
--- a/src/_imagingmorph.c
+++ b/src/_imagingmorph.c
@@ -62,11 +62,8 @@ apply(PyObject *self, PyObject *args) {
     width = imgin->xsize;
     height = imgin->ysize;
 
-    if (imgin->type != IMAGING_TYPE_UINT8 || imgin->bands != 1) {
-        PyErr_SetString(PyExc_RuntimeError, "Unsupported image type");
-        return NULL;
-    }
-    if (imgout->type != IMAGING_TYPE_UINT8 || imgout->bands != 1) {
+    if (imgin->type != IMAGING_TYPE_UINT8 || imgin->bands != 1 ||
+        imgout->type != IMAGING_TYPE_UINT8 || imgout->bands != 1) {
         PyErr_SetString(PyExc_RuntimeError, "Unsupported image type");
         return NULL;
     }

From 76dd669e6bbe186f7362917b004ad2560d8b5368 Mon Sep 17 00:00:00 2001
From: Andrew Murray <radarhere@users.noreply.github.com>
Date: Mon, 7 Oct 2024 16:50:05 +1100
Subject: [PATCH 1157/1178] Fixed unclosed file warning

---
 Tests/test_imageshow.py | 4 ++--
 1 file changed, 2 insertions(+), 2 deletions(-)

diff --git a/Tests/test_imageshow.py b/Tests/test_imageshow.py
index 67c32783fc5..7a2f5876757 100644
--- a/Tests/test_imageshow.py
+++ b/Tests/test_imageshow.py
@@ -117,5 +117,5 @@ def test_ipythonviewer() -> None:
     else:
         pytest.fail("IPythonViewer not found")
 
-    im = hopper()
-    assert test_viewer.show(im) == 1
+    with hopper() as im:
+        assert test_viewer.show(im) == 1

From 8de66597f967baab1d4e4eaf487b0fdb4949abbb Mon Sep 17 00:00:00 2001
From: Andrew Murray <radarhere@users.noreply.github.com>
Date: Mon, 7 Oct 2024 19:17:59 +1100
Subject: [PATCH 1158/1178] Removed unused code

---
 src/_imagingft.c | 5 +----
 1 file changed, 1 insertion(+), 4 deletions(-)

diff --git a/src/_imagingft.c b/src/_imagingft.c
index 8bef45baf87..3b30e268b2e 100644
--- a/src/_imagingft.c
+++ b/src/_imagingft.c
@@ -922,10 +922,7 @@ font_render(FontObject *self, PyObject *args) {
     width += ceil(stroke_width * 2 + x_start);
     height += ceil(stroke_width * 2 + y_start);
     image = PyObject_CallFunction(fill, "ii", width, height);
-    if (image == Py_None) {
-        PyMem_Del(glyph_info);
-        return Py_BuildValue("N(ii)", image, 0, 0);
-    } else if (image == NULL) {
+    if (image == NULL) {
         PyMem_Del(glyph_info);
         return NULL;
     }

From 8e332eb3b06812adaa497463f0de97f9ec84d1cb Mon Sep 17 00:00:00 2001
From: Alexander Karpinsky <homm86@gmail.com>
Date: Mon, 7 Oct 2024 12:51:44 +0400
Subject: [PATCH 1159/1178] Apply suggestions from code review

Co-authored-by: Andrew Murray <3112309+radarhere@users.noreply.github.com>
---
 Tests/test_image_getim.py | 2 +-
 src/_imaging.c            | 5 +++--
 src/_imagingmorph.c       | 4 ++--
 src/libImaging/Imaging.h  | 2 +-
 4 files changed, 7 insertions(+), 6 deletions(-)

diff --git a/Tests/test_image_getim.py b/Tests/test_image_getim.py
index 75d97cd4451..fa58492fc76 100644
--- a/Tests/test_image_getim.py
+++ b/Tests/test_image_getim.py
@@ -16,4 +16,4 @@ def test_sanity() -> None:
 
     with pytest.warns(DeprecationWarning):
         ptrs = dict(im.im.unsafe_ptrs)
-    assert all(k in ptrs for k in ["image8", "image32", "image"])
+    assert ptrs.keys() == {"image8", "image32", "image"}
diff --git a/src/_imaging.c b/src/_imaging.c
index 9422c42bfaf..d5eb69314e8 100644
--- a/src/_imaging.c
+++ b/src/_imaging.c
@@ -3706,7 +3706,7 @@ static PyObject *
 _getattr_id(ImagingObject *self, void *closure) {
     if (PyErr_WarnEx(
             PyExc_DeprecationWarning,
-            "id property is deprecated and will be removed in Pillow 12.0",
+            "id property is deprecated and will be removed in Pillow 12 (2025-10-15)",
             1
         ) < 0) {
         return NULL;
@@ -3732,7 +3732,8 @@ static PyObject *
 _getattr_unsafe_ptrs(ImagingObject *self, void *closure) {
     if (PyErr_WarnEx(
             PyExc_DeprecationWarning,
-            "unsafe_ptrs property is deprecated and will be removed in Pillow 12.0",
+            "unsafe_ptrs property is deprecated and will be removed in Pillow 12 "
+            "(2025-10-15)",
             1
         ) < 0) {
         return NULL;
diff --git a/src/_imagingmorph.c b/src/_imagingmorph.c
index 637295be710..b4da47b7766 100644
--- a/src/_imagingmorph.c
+++ b/src/_imagingmorph.c
@@ -29,8 +29,8 @@
 static PyObject *
 apply(PyObject *self, PyObject *args) {
     const char *lut;
-    PyObject *i0, *i1;
     Py_ssize_t lut_len;
+    PyObject *i0, *i1;
     Imaging imgin, imgout;
     int width, height;
     int row_idx, col_idx;
@@ -124,8 +124,8 @@ apply(PyObject *self, PyObject *args) {
 static PyObject *
 match(PyObject *self, PyObject *args) {
     const char *lut;
-    PyObject *i0;
     Py_ssize_t lut_len;
+    PyObject *i0;
     Imaging imgin;
     int width, height;
     int row_idx, col_idx;
diff --git a/src/libImaging/Imaging.h b/src/libImaging/Imaging.h
index 870f5ed971a..31052c68a97 100644
--- a/src/libImaging/Imaging.h
+++ b/src/libImaging/Imaging.h
@@ -60,7 +60,7 @@ typedef struct ImagingHistogramInstance *ImagingHistogram;
 typedef struct ImagingOutlineInstance *ImagingOutline;
 typedef struct ImagingPaletteInstance *ImagingPalette;
 
-/* handle magics (used with PyCObject). */
+/* handle magics (used with PyCapsule). */
 #define IMAGING_MAGIC "Pillow Imaging"
 
 /* pixel types */

From a227f22fd979c86d8d2ae8b9bdb0a393fb2e386c Mon Sep 17 00:00:00 2001
From: Alexander Karpinsky <homm86@gmail.com>
Date: Mon, 7 Oct 2024 14:35:25 +0400
Subject: [PATCH 1160/1178] Apply suggestions from code review [ci skip]

Co-authored-by: Hugo van Kemenade <1324225+hugovk@users.noreply.github.com>
---
 docs/deprecations.rst        | 2 +-
 docs/releasenotes/11.0.0.rst | 2 +-
 2 files changed, 2 insertions(+), 2 deletions(-)

diff --git a/docs/deprecations.rst b/docs/deprecations.rst
index 3934f059de8..25607e27c3b 100644
--- a/docs/deprecations.rst
+++ b/docs/deprecations.rst
@@ -165,7 +165,7 @@ Specific WebP Feature Checks
 ``True`` if the WebP module is installed, until they are removed in Pillow
 12.0.0 (2025-10-15).
 
-Get Internal Pointers to Objects
+Get internal pointers to objects
 ^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
 
 .. deprecated:: 11.0.0
diff --git a/docs/releasenotes/11.0.0.rst b/docs/releasenotes/11.0.0.rst
index 3194f1a5299..fde11662e99 100644
--- a/docs/releasenotes/11.0.0.rst
+++ b/docs/releasenotes/11.0.0.rst
@@ -73,7 +73,7 @@ vulnerability introduced in FreeType 2.6 (:cve:`2020-15999`).
 
 .. _2.10.4: https://sourceforge.net/projects/freetype/files/freetype2/2.10.4/
 
-Get Internal Pointers to Objects
+Get internal pointers to objects
 ^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
 
 .. deprecated:: 11.0.0

From 7097a9a3b869f2cf8d335aeb1a6a77c1b31378dc Mon Sep 17 00:00:00 2001
From: Andrew Murray <radarhere@users.noreply.github.com>
Date: Mon, 7 Oct 2024 22:12:41 +1100
Subject: [PATCH 1161/1178] Update CHANGES.rst [ci skip]

---
 CHANGES.rst | 3 +++
 1 file changed, 3 insertions(+)

diff --git a/CHANGES.rst b/CHANGES.rst
index cc891ed1d84..4e940d7ffe7 100644
--- a/CHANGES.rst
+++ b/CHANGES.rst
@@ -5,6 +5,9 @@ Changelog (Pillow)
 11.0.0 (unreleased)
 -------------------
 
+- Use ImagingCore.ptr instead of ImagingCore.id #8341
+  [homm, radarhere, hugovk]
+
 - Updated EPS mode when opening images without transparency #8281
   [Yay295, radarhere]
 

From ef47d6e5e53c68c0018755d0dc23924d0e03c8ba Mon Sep 17 00:00:00 2001
From: "pre-commit-ci[bot]"
 <66853113+pre-commit-ci[bot]@users.noreply.github.com>
Date: Mon, 7 Oct 2024 17:55:54 +0000
Subject: [PATCH 1162/1178] [pre-commit.ci] pre-commit autoupdate
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit

updates:
- [github.com/astral-sh/ruff-pre-commit: v0.6.3 → v0.6.9](https://github.com/astral-sh/ruff-pre-commit/compare/v0.6.3...v0.6.9)
- [github.com/PyCQA/bandit: 1.7.9 → 1.7.10](https://github.com/PyCQA/bandit/compare/1.7.9...1.7.10)
- [github.com/pre-commit/mirrors-clang-format: v18.1.8 → v19.1.1](https://github.com/pre-commit/mirrors-clang-format/compare/v18.1.8...v19.1.1)
- [github.com/pre-commit/pre-commit-hooks: v4.6.0 → v5.0.0](https://github.com/pre-commit/pre-commit-hooks/compare/v4.6.0...v5.0.0)
- [github.com/python-jsonschema/check-jsonschema: 0.29.2 → 0.29.3](https://github.com/python-jsonschema/check-jsonschema/compare/0.29.2...0.29.3)
- [github.com/sphinx-contrib/sphinx-lint: v0.9.1 → v1.0.0](https://github.com/sphinx-contrib/sphinx-lint/compare/v0.9.1...v1.0.0)
- [github.com/tox-dev/pyproject-fmt: 2.2.1 → 2.2.4](https://github.com/tox-dev/pyproject-fmt/compare/2.2.1...2.2.4)
- [github.com/abravalheri/validate-pyproject: v0.19 → v0.20.2](https://github.com/abravalheri/validate-pyproject/compare/v0.19...v0.20.2)
- [github.com/tox-dev/tox-ini-fmt: 1.3.1 → 1.4.1](https://github.com/tox-dev/tox-ini-fmt/compare/1.3.1...1.4.1)
---
 .pre-commit-config.yaml | 18 +++++++++---------
 1 file changed, 9 insertions(+), 9 deletions(-)

diff --git a/.pre-commit-config.yaml b/.pre-commit-config.yaml
index 14d75c6892e..bdc335f329d 100644
--- a/.pre-commit-config.yaml
+++ b/.pre-commit-config.yaml
@@ -1,6 +1,6 @@
 repos:
   - repo: https://github.com/astral-sh/ruff-pre-commit
-    rev: v0.6.3
+    rev: v0.6.9
     hooks:
       - id: ruff
         args: [--exit-non-zero-on-fix]
@@ -11,7 +11,7 @@ repos:
       - id: black
 
   - repo: https://github.com/PyCQA/bandit
-    rev: 1.7.9
+    rev: 1.7.10
     hooks:
     - id: bandit
       args: [--severity-level=high]
@@ -24,7 +24,7 @@ repos:
         exclude: (Makefile$|\.bat$|\.cmake$|\.eps$|\.fits$|\.gd$|\.opt$)
 
   - repo: https://github.com/pre-commit/mirrors-clang-format
-    rev: v18.1.8
+    rev: v19.1.1
     hooks:
       - id: clang-format
         types: [c]
@@ -36,7 +36,7 @@ repos:
       - id: rst-backticks
 
   - repo: https://github.com/pre-commit/pre-commit-hooks
-    rev: v4.6.0
+    rev: v5.0.0
     hooks:
       - id: check-executables-have-shebangs
       - id: check-shebang-scripts-are-executable
@@ -50,29 +50,29 @@ repos:
         exclude: ^.github/.*TEMPLATE|^Tests/(fonts|images)/
 
   - repo: https://github.com/python-jsonschema/check-jsonschema
-    rev: 0.29.2
+    rev: 0.29.3
     hooks:
       - id: check-github-workflows
       - id: check-readthedocs
       - id: check-renovate
 
   - repo: https://github.com/sphinx-contrib/sphinx-lint
-    rev: v0.9.1
+    rev: v1.0.0
     hooks:
       - id: sphinx-lint
 
   - repo: https://github.com/tox-dev/pyproject-fmt
-    rev: 2.2.1
+    rev: 2.2.4
     hooks:
       - id: pyproject-fmt
 
   - repo: https://github.com/abravalheri/validate-pyproject
-    rev: v0.19
+    rev: v0.20.2
     hooks:
       - id: validate-pyproject
 
   - repo: https://github.com/tox-dev/tox-ini-fmt
-    rev: 1.3.1
+    rev: 1.4.1
     hooks:
       - id: tox-ini-fmt
 

From a609d65b33b659d5bbdd7ff09c6464d7b1028754 Mon Sep 17 00:00:00 2001
From: "pre-commit-ci[bot]"
 <66853113+pre-commit-ci[bot]@users.noreply.github.com>
Date: Mon, 7 Oct 2024 17:56:20 +0000
Subject: [PATCH 1163/1178] [pre-commit.ci] auto fixes from pre-commit.com
 hooks

for more information, see https://pre-commit.ci
---
 src/libImaging/QuantOctree.c | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/src/libImaging/QuantOctree.c b/src/libImaging/QuantOctree.c
index 7e02ebf65bc..ec60b214ef1 100644
--- a/src/libImaging/QuantOctree.c
+++ b/src/libImaging/QuantOctree.c
@@ -188,7 +188,7 @@ create_sorted_color_palette(const ColorCube cube) {
         buckets,
         cube->size,
         sizeof(struct _ColorBucket),
-        (int (*)(void const *, void const *)) & compare_bucket_count
+        (int (*)(void const *, void const *))&compare_bucket_count
     );
 
     return buckets;

From a9b9a63614c7838be9efe421062252c1c8c0546a Mon Sep 17 00:00:00 2001
From: Andrew Murray <radarhere@users.noreply.github.com>
Date: Tue, 8 Oct 2024 20:48:32 +1100
Subject: [PATCH 1164/1178] Do not create core image in seek(), when load()
 might not run

---
 src/PIL/TiffImagePlugin.py | 11 ++++++-----
 1 file changed, 6 insertions(+), 5 deletions(-)

diff --git a/src/PIL/TiffImagePlugin.py b/src/PIL/TiffImagePlugin.py
index d4c46a79778..f3571fda3c8 100644
--- a/src/PIL/TiffImagePlugin.py
+++ b/src/PIL/TiffImagePlugin.py
@@ -1193,11 +1193,11 @@ def seek(self, frame: int) -> None:
         if not self._seek_check(frame):
             return
         self._seek(frame)
-        # Create a new core image object on second and
-        # subsequent frames in the image. Image may be
-        # different size/mode.
-        Image._decompression_bomb_check(self._tile_size)
-        self.im = Image.core.new(self.mode, self._tile_size)
+        if self._im is not None and (
+            self.im.size != self._tile_size or self.im.mode != self.mode
+        ):
+            # The core image will no longer be used
+            self._im = None
 
     def _seek(self, frame: int) -> None:
         self.fp = self._fp
@@ -1279,6 +1279,7 @@ def load(self) -> Image.core.PixelAccess | None:
 
     def load_prepare(self) -> None:
         if self._im is None:
+            Image._decompression_bomb_check(self._tile_size)
             self.im = Image.core.new(self.mode, self._tile_size)
         ImageFile.ImageFile.load_prepare(self)
 

From e37209ace5bc9aaf3683dfaf25b6c6c75a23ba0f Mon Sep 17 00:00:00 2001
From: "renovate[bot]" <29139614+renovate[bot]@users.noreply.github.com>
Date: Wed, 9 Oct 2024 09:11:46 +0000
Subject: [PATCH 1165/1178] Update dependency cibuildwheel to v2.21.3

---
 .ci/requirements-cibw.txt | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/.ci/requirements-cibw.txt b/.ci/requirements-cibw.txt
index a1424ecc098..c4511439ccb 100644
--- a/.ci/requirements-cibw.txt
+++ b/.ci/requirements-cibw.txt
@@ -1 +1 @@
-cibuildwheel==2.21.2
+cibuildwheel==2.21.3

From ff245fcb4084a0bb61c14e0c416c048c63da78cf Mon Sep 17 00:00:00 2001
From: Andrew Murray <radarhere@users.noreply.github.com>
Date: Thu, 10 Oct 2024 19:43:11 +1100
Subject: [PATCH 1166/1178] Revert "Skip QEMU-emulated wheels on workflow
 dispatch event"

This reverts commit f39ca5db5a39c2c82e62fbee1ebf95d5b61bdfba.
---
 .github/workflows/wheels.yml | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/.github/workflows/wheels.yml b/.github/workflows/wheels.yml
index 2a4c86cd735..837e5ea91fe 100644
--- a/.github/workflows/wheels.yml
+++ b/.github/workflows/wheels.yml
@@ -41,7 +41,7 @@ env:
 
 jobs:
   build-1-QEMU-emulated-wheels:
-    if: github.event_name != 'schedule' && github.event_name != 'workflow_dispatch'
+    if: github.event_name != 'schedule'
     name: aarch64 ${{ matrix.python-version }} ${{ matrix.spec }}
     runs-on: ubuntu-latest
     strategy:

From 97438cb8fd51f016117953072a7a68c2f74ccc74 Mon Sep 17 00:00:00 2001
From: Andrew Murray <radarhere@users.noreply.github.com>
Date: Thu, 10 Oct 2024 22:50:26 +1100
Subject: [PATCH 1167/1178] Update CHANGES.rst [ci skip]

---
 CHANGES.rst | 3 +++
 1 file changed, 3 insertions(+)

diff --git a/CHANGES.rst b/CHANGES.rst
index 4e940d7ffe7..277a57f0c51 100644
--- a/CHANGES.rst
+++ b/CHANGES.rst
@@ -5,6 +5,9 @@ Changelog (Pillow)
 11.0.0 (unreleased)
 -------------------
 
+- Support ImageFilter.BuiltinFilter for I;16* images #8438
+  [radarhere]
+
 - Use ImagingCore.ptr instead of ImagingCore.id #8341
   [homm, radarhere, hugovk]
 

From fdd5d0c0fba5864d914044a8046e9916e2f0e1eb Mon Sep 17 00:00:00 2001
From: Hugo van Kemenade <1324225+hugovk@users.noreply.github.com>
Date: Thu, 10 Oct 2024 21:35:48 +0300
Subject: [PATCH 1168/1178] Use CVE and CWE roles from Sphinx 8.1

---
 Makefile       | 2 --
 docs/Makefile  | 2 +-
 docs/conf.py   | 4 +---
 pyproject.toml | 2 +-
 4 files changed, 3 insertions(+), 7 deletions(-)

diff --git a/Makefile b/Makefile
index ec415962740..53164b08a90 100644
--- a/Makefile
+++ b/Makefile
@@ -17,12 +17,10 @@ coverage:
 .PHONY: doc
 .PHONY: html
 doc html:
-	python3 -c "import PIL" > /dev/null 2>&1 || python3 -m pip install .
 	$(MAKE) -C docs html
 
 .PHONY: htmlview
 htmlview:
-	python3 -c "import PIL" > /dev/null 2>&1 || python3 -m pip install .
 	$(MAKE) -C docs htmlview
 
 .PHONY: doccheck
diff --git a/docs/Makefile b/docs/Makefile
index 8f13f1aea1c..e90af0519c6 100644
--- a/docs/Makefile
+++ b/docs/Makefile
@@ -46,7 +46,7 @@ clean:
 	-rm -rf $(BUILDDIR)/*
 
 install-sphinx:
-	$(PYTHON) -m pip install --quiet furo olefile sphinx sphinx-copybutton sphinx-inline-tabs sphinxext-opengraph
+	$(PYTHON) -m pip install -e ..[docs]
 
 .PHONY: html
 html:
diff --git a/docs/conf.py b/docs/conf.py
index a0f5867d758..bcdc18b2023 100644
--- a/docs/conf.py
+++ b/docs/conf.py
@@ -22,7 +22,7 @@
 # -- General configuration ------------------------------------------------
 
 # If your documentation needs a minimal Sphinx version, state it here.
-needs_sphinx = "7.3"
+needs_sphinx = "8.1"
 
 # Add any Sphinx extension module names here, as strings. They can be
 # extensions coming with Sphinx (named 'sphinx.ext.*') or your custom
@@ -338,8 +338,6 @@
 # https://www.sphinx-doc.org/en/master/usage/extensions/extlinks.html
 _repo = "https://github.com/python-pillow/Pillow/"
 extlinks = {
-    "cve": ("https://www.cve.org/CVERecord?id=CVE-%s", "CVE-%s"),
-    "cwe": ("https://cwe.mitre.org/data/definitions/%s.html", "CWE-%s"),
     "issue": (_repo + "issues/%s", "#%s"),
     "pr": (_repo + "pull/%s", "#%s"),
     "pypi": ("https://pypi.org/project/%s/", "%s"),
diff --git a/pyproject.toml b/pyproject.toml
index 0d0a6f17084..132030c99de 100644
--- a/pyproject.toml
+++ b/pyproject.toml
@@ -43,7 +43,7 @@ dynamic = [
 optional-dependencies.docs = [
   "furo",
   "olefile",
-  "sphinx>=7.3",
+  "sphinx>=8.1",
   "sphinx-copybutton",
   "sphinx-inline-tabs",
   "sphinxext-opengraph",

From 7edf9528328f64bf7b299babe2fc3d9e79afdc18 Mon Sep 17 00:00:00 2001
From: Andrew Murray <radarhere@users.noreply.github.com>
Date: Fri, 11 Oct 2024 19:37:56 +1100
Subject: [PATCH 1169/1178] Do not close provided file handles with libtiff

---
 src/PIL/TiffImagePlugin.py  |  7 +------
 src/libImaging/TiffDecode.c | 26 ++++++++++++++++++++++----
 2 files changed, 23 insertions(+), 10 deletions(-)

diff --git a/src/PIL/TiffImagePlugin.py b/src/PIL/TiffImagePlugin.py
index d4c46a79778..2dbd3c601d0 100644
--- a/src/PIL/TiffImagePlugin.py
+++ b/src/PIL/TiffImagePlugin.py
@@ -1864,7 +1864,7 @@ def _save(im: Image.Image, fp: IO[bytes], filename: str | bytes) -> None:
         if hasattr(fp, "fileno"):
             try:
                 fp.seek(0)
-                _fp = os.dup(fp.fileno())
+                _fp = fp.fileno()
             except io.UnsupportedOperation:
                 pass
 
@@ -1943,11 +1943,6 @@ def _save(im: Image.Image, fp: IO[bytes], filename: str | bytes) -> None:
                 fp.write(data)
             if errcode:
                 break
-        if _fp:
-            try:
-                os.close(_fp)
-            except OSError:
-                pass
         if errcode < 0:
             msg = f"encoder error {errcode} when writing image file"
             raise OSError(msg)
diff --git a/src/libImaging/TiffDecode.c b/src/libImaging/TiffDecode.c
index 18a54f63305..e4da9162dc9 100644
--- a/src/libImaging/TiffDecode.c
+++ b/src/libImaging/TiffDecode.c
@@ -780,7 +780,7 @@ ImagingLibTiffDecode(
 decode_err:
     // TIFFClose in libtiff calls tif_closeproc and TIFFCleanup
     if (clientstate->fp) {
-        // Pillow will manage the closing of the file rather than libtiff
+        // Python will manage the closing of the file rather than libtiff
         // So only call TIFFCleanup
         TIFFCleanup(tiff);
     } else {
@@ -1008,7 +1008,17 @@ ImagingLibTiffEncode(Imaging im, ImagingCodecState state, UINT8 *buffer, int byt
                 ) == -1) {
                 TRACE(("Encode Error, row %d\n", state->y));
                 state->errcode = IMAGING_CODEC_BROKEN;
-                TIFFClose(tiff);
+
+                // TIFFClose in libtiff calls tif_closeproc and TIFFCleanup
+                if (clientstate->fp) {
+                    // Python will manage the closing of the file rather than libtiff
+                    // So only call TIFFCleanup
+                    TIFFCleanup(tiff);
+                } else {
+                    // When tif_closeproc refers to our custom _tiffCloseProc though,
+                    // that is fine, as it does not close the file
+                    TIFFClose(tiff);
+                }
                 if (!clientstate->fp) {
                     free(clientstate->data);
                 }
@@ -1025,14 +1035,22 @@ ImagingLibTiffEncode(Imaging im, ImagingCodecState state, UINT8 *buffer, int byt
                 TRACE(("Error flushing the tiff"));
                 // likely reason is memory.
                 state->errcode = IMAGING_CODEC_MEMORY;
-                TIFFClose(tiff);
+                if (clientstate->fp) {
+                    TIFFCleanup(tiff);
+                } else {
+                    TIFFClose(tiff);
+                }
                 if (!clientstate->fp) {
                     free(clientstate->data);
                 }
                 return -1;
             }
             TRACE(("Closing \n"));
-            TIFFClose(tiff);
+            if (clientstate->fp) {
+                TIFFCleanup(tiff);
+            } else {
+                TIFFClose(tiff);
+            }
             // reset the clientstate metadata to use it to read out the buffer.
             clientstate->loc = 0;
             clientstate->size = clientstate->eof;  // redundant?

From afbf45055a8e938aacb28cb412cad125a1e29a4f Mon Sep 17 00:00:00 2001
From: Andrew Murray <radarhere@users.noreply.github.com>
Date: Fri, 11 Oct 2024 20:59:15 +1100
Subject: [PATCH 1170/1178] Always raise warnings for deprecated feature checks

---
 Tests/test_features.py | 6 +++---
 src/PIL/features.py    | 3 ++-
 2 files changed, 5 insertions(+), 4 deletions(-)

diff --git a/Tests/test_features.py b/Tests/test_features.py
index 80778284773..ed792997376 100644
--- a/Tests/test_features.py
+++ b/Tests/test_features.py
@@ -56,17 +56,17 @@ def test(name: str, function: Callable[[str], str | None]) -> None:
 
 def test_webp_transparency() -> None:
     with pytest.warns(DeprecationWarning):
-        assert features.check("transp_webp") == features.check_module("webp")
+        assert (features.check("transp_webp") or False) == features.check_module("webp")
 
 
 def test_webp_mux() -> None:
     with pytest.warns(DeprecationWarning):
-        assert features.check("webp_mux") == features.check_module("webp")
+        assert (features.check("webp_mux") or False) == features.check_module("webp")
 
 
 def test_webp_anim() -> None:
     with pytest.warns(DeprecationWarning):
-        assert features.check("webp_anim") == features.check_module("webp")
+        assert (features.check("webp_anim") or False) == features.check_module("webp")
 
 
 @skip_unless_feature("libjpeg_turbo")
diff --git a/src/PIL/features.py b/src/PIL/features.py
index 24c5ee978b3..75d59e01c40 100644
--- a/src/PIL/features.py
+++ b/src/PIL/features.py
@@ -146,10 +146,11 @@ def check_feature(feature: str) -> bool | None:
 
     module, flag, ver = features[feature]
 
+    if isinstance(flag, bool):
+        deprecate(f'check_feature("{feature}")', 12)
     try:
         imported_module = __import__(module, fromlist=["PIL"])
         if isinstance(flag, bool):
-            deprecate(f'check_feature("{feature}")', 12)
             return flag
         return getattr(imported_module, flag)
     except ModuleNotFoundError:

From e93dcc15780d29af45fa64cf54ff6b11c2c27c46 Mon Sep 17 00:00:00 2001
From: Andrew Murray <radarhere@users.noreply.github.com>
Date: Fri, 11 Oct 2024 21:09:52 +1100
Subject: [PATCH 1171/1178] Update CHANGES.rst [ci skip]

---
 CHANGES.rst | 3 +++
 1 file changed, 3 insertions(+)

diff --git a/CHANGES.rst b/CHANGES.rst
index 277a57f0c51..c965d60a6ee 100644
--- a/CHANGES.rst
+++ b/CHANGES.rst
@@ -5,6 +5,9 @@ Changelog (Pillow)
 11.0.0 (unreleased)
 -------------------
 
+- Do not close provided file handles with libtiff when saving #8458
+  [radarhere]
+
 - Support ImageFilter.BuiltinFilter for I;16* images #8438
   [radarhere]
 

From 00c5989d4ed963f9d39568c6212969bafe84e4d2 Mon Sep 17 00:00:00 2001
From: Andrew Murray <radarhere@users.noreply.github.com>
Date: Sat, 12 Oct 2024 13:44:48 +1100
Subject: [PATCH 1172/1178] Use MAXBLOCK

---
 src/PIL/TiffImagePlugin.py | 3 +--
 1 file changed, 1 insertion(+), 2 deletions(-)

diff --git a/src/PIL/TiffImagePlugin.py b/src/PIL/TiffImagePlugin.py
index 2dbd3c601d0..a05cd0f1738 100644
--- a/src/PIL/TiffImagePlugin.py
+++ b/src/PIL/TiffImagePlugin.py
@@ -1937,8 +1937,7 @@ def _save(im: Image.Image, fp: IO[bytes], filename: str | bytes) -> None:
         encoder = Image._getencoder(im.mode, "libtiff", a, encoderconfig)
         encoder.setimage(im.im, (0, 0) + im.size)
         while True:
-            # undone, change to self.decodermaxblock:
-            errcode, data = encoder.encode(16 * 1024)[1:]
+            errcode, data = encoder.encode(ImageFile.MAXBLOCK)[1:]
             if not _fp:
                 fp.write(data)
             if errcode:

From b5e1115bf2646f7ce5eb1b9409e4540fee3b9f49 Mon Sep 17 00:00:00 2001
From: Andrew Murray <radarhere@users.noreply.github.com>
Date: Sat, 12 Oct 2024 21:10:47 +1100
Subject: [PATCH 1173/1178] Update CHANGES.rst [ci skip]

---
 CHANGES.rst | 9 +++++++++
 1 file changed, 9 insertions(+)

diff --git a/CHANGES.rst b/CHANGES.rst
index c965d60a6ee..0a170366855 100644
--- a/CHANGES.rst
+++ b/CHANGES.rst
@@ -5,6 +5,15 @@ Changelog (Pillow)
 11.0.0 (unreleased)
 -------------------
 
+- Conditionally define ImageCms type hint to avoid requiring core #8197
+  [radarhere]
+
+- Support writing LONG8 offsets in AppendingTiffWriter #8417
+  [radarhere]
+
+- Use ImageFile.MAXBLOCK when saving TIFF images #8461
+  [radarhere]
+
 - Do not close provided file handles with libtiff when saving #8458
   [radarhere]
 

From e74994ed370a668c8f3e6045278de5a5eb3f47ab Mon Sep 17 00:00:00 2001
From: Hugo van Kemenade <1324225+hugovk@users.noreply.github.com>
Date: Fri, 11 Oct 2024 16:28:41 +0300
Subject: [PATCH 1174/1178] Update licence to MIT-CMU

---
 .pre-commit-config.yaml | 1 +
 pyproject.toml          | 4 ++--
 2 files changed, 3 insertions(+), 2 deletions(-)

diff --git a/.pre-commit-config.yaml b/.pre-commit-config.yaml
index bdc335f329d..6254b89416f 100644
--- a/.pre-commit-config.yaml
+++ b/.pre-commit-config.yaml
@@ -70,6 +70,7 @@ repos:
     rev: v0.20.2
     hooks:
       - id: validate-pyproject
+        additional_dependencies: [trove-classifiers>=2024.10.12]
 
   - repo: https://github.com/tox-dev/tox-ini-fmt
     rev: 1.4.1
diff --git a/pyproject.toml b/pyproject.toml
index 132030c99de..c55be769341 100644
--- a/pyproject.toml
+++ b/pyproject.toml
@@ -14,14 +14,14 @@ readme = "README.md"
 keywords = [
   "Imaging",
 ]
-license = { text = "HPND" }
+license = { text = "MIT-CMU" }
 authors = [
   { name = "Jeffrey A. Clark", email = "aclark@aclark.net" },
 ]
 requires-python = ">=3.9"
 classifiers = [
   "Development Status :: 6 - Mature",
-  "License :: OSI Approved :: Historical Permission Notice and Disclaimer (HPND)",
+  "License :: OSI Approved :: CMU License (MIT-CMU)",
   "Programming Language :: Python :: 3 :: Only",
   "Programming Language :: Python :: 3.9",
   "Programming Language :: Python :: 3.10",

From a60610c93f1a7fb2738156470d613793e5fa7a89 Mon Sep 17 00:00:00 2001
From: Andrew Murray <radarhere@users.noreply.github.com>
Date: Sun, 13 Oct 2024 07:42:17 +1100
Subject: [PATCH 1175/1178] Added type hints

---
 src/PIL/ImageMath.py | 4 ++--
 1 file changed, 2 insertions(+), 2 deletions(-)

diff --git a/src/PIL/ImageMath.py b/src/PIL/ImageMath.py
index 15464947d65..484797f912c 100644
--- a/src/PIL/ImageMath.py
+++ b/src/PIL/ImageMath.py
@@ -173,10 +173,10 @@ def __rshift__(self, other: _Operand | float) -> _Operand:
         return self.apply("rshift", self, other)
 
     # logical
-    def __eq__(self, other):
+    def __eq__(self, other: _Operand | float) -> _Operand:  # type: ignore[override]
         return self.apply("eq", self, other)
 
-    def __ne__(self, other):
+    def __ne__(self, other: _Operand | float) -> _Operand:  # type: ignore[override]
         return self.apply("ne", self, other)
 
     def __lt__(self, other: _Operand | float) -> _Operand:

From c3d81d6375d2d78301a40d0e55ece746cf41502f Mon Sep 17 00:00:00 2001
From: Hugo van Kemenade <1324225+hugovk@users.noreply.github.com>
Date: Sat, 12 Oct 2024 23:52:57 +0300
Subject: [PATCH 1176/1178] Update Python 3.13 release date

---
 docs/releasenotes/11.0.0.rst | 15 +--------------
 1 file changed, 1 insertion(+), 14 deletions(-)

diff --git a/docs/releasenotes/11.0.0.rst b/docs/releasenotes/11.0.0.rst
index d5f5934f429..c3f18140f42 100644
--- a/docs/releasenotes/11.0.0.rst
+++ b/docs/releasenotes/11.0.0.rst
@@ -1,19 +1,6 @@
 11.0.0
 ------
 
-Security
-========
-
-TODO
-^^^^
-
-TODO
-
-:cve:`YYYY-XXXXX`: TODO
-^^^^^^^^^^^^^^^^^^^^^^^
-
-TODO
-
 Backwards Incompatible Changes
 ==============================
 
@@ -159,7 +146,7 @@ Python 3.13
 
 Pillow 10.4.0 had wheels built against Python 3.13 beta, available as a preview to help
 others prepare for 3.13, and to ensure Pillow could be used immediately at the release
-of 3.13.0 final (2024-10-01, :pep:`719`).
+of 3.13.0 final (2024-10-07, :pep:`719`).
 
 Pillow 11.0.0 now officially supports Python 3.13.
 

From f2cc87b1f0627dfce07ab2867e29ba07e5055f33 Mon Sep 17 00:00:00 2001
From: Andrew Murray <radarhere@users.noreply.github.com>
Date: Sun, 13 Oct 2024 11:19:41 +1100
Subject: [PATCH 1177/1178] Update CHANGES.rst [ci skip]

---
 CHANGES.rst | 3 +++
 1 file changed, 3 insertions(+)

diff --git a/CHANGES.rst b/CHANGES.rst
index 0a170366855..fcc8c324f41 100644
--- a/CHANGES.rst
+++ b/CHANGES.rst
@@ -5,6 +5,9 @@ Changelog (Pillow)
 11.0.0 (unreleased)
 -------------------
 
+- Update licence to MIT-CMU #8460
+  [hugovk]
+
 - Conditionally define ImageCms type hint to avoid requiring core #8197
   [radarhere]
 

From 204aae6682fc936f5350b3fe70335776f81480a7 Mon Sep 17 00:00:00 2001
From: Hugo van Kemenade <1324225+hugovk@users.noreply.github.com>
Date: Tue, 15 Oct 2024 08:55:00 +0300
Subject: [PATCH 1178/1178] 11.0.0 version bump

---
 CHANGES.rst         | 2 +-
 src/PIL/_version.py | 2 +-
 2 files changed, 2 insertions(+), 2 deletions(-)

diff --git a/CHANGES.rst b/CHANGES.rst
index fcc8c324f41..8a20fe16a92 100644
--- a/CHANGES.rst
+++ b/CHANGES.rst
@@ -2,7 +2,7 @@
 Changelog (Pillow)
 ==================
 
-11.0.0 (unreleased)
+11.0.0 (2024-10-15)
 -------------------
 
 - Update licence to MIT-CMU #8460
diff --git a/src/PIL/_version.py b/src/PIL/_version.py
index c4a72ad7ede..963d8c906dc 100644
--- a/src/PIL/_version.py
+++ b/src/PIL/_version.py
@@ -1,4 +1,4 @@
 # Master version for Pillow
 from __future__ import annotations
 
-__version__ = "11.0.0.dev0"
+__version__ = "11.0.0"